mackwan84/dsh-ui-mockup--packages-image2

@mackwan84/dsh-image

图像生成 capability 的 Service Definition:UI 草图生成/编辑的抽象契约与错误码

AI 분석

核心用途是定义统一的图像生成与编辑服务接口规范。作为底层契约包,适合开发或对接自定义图像生成 Provider 的技术人员。

패키지
@mackwan84/dsh-image
버전
0.1.2
라이선스
MIT
최근 업데이트
2026. 8. 31.

설치

검증된 bundle이 없거나 호환성 검사에 실패했습니다. 먼저 저장소 설명을 읽어 주세요. 전체 README 읽기 ↗

@mackwan84/dsh-image

图像生成 capability 的 Service Definition:为 UI 草图生成/编辑提供跨提供方的统一抽象契约。

  • ImageGenerationService:抽象服务基类,实现类加载即注册为 ctx.image
  • ImageGenerateSpec / ImageEditSpec / ImageGenerateResult:请求与结果类型;
  • ImageProviderError:统一错误(MISSING_CREDENTIAL / RATE_LIMITED / TASK_FAILED / TIMEOUT / NOT_IMPLEMENTED / HTTP_ERROR / BAD_RESPONSE / INVALID_PARAMETER)。

语义约定

  • 实现只对基础设施失败 reject;业务失败以 ImageProviderError 携带错误码;
  • 结果 URL 有有效期,Consumer 须立即下载保存;
  • 实现必须尊重 AbortSignal(中断请求与轮询)。

Model Experience

本包无模型可见内容;它是 Provider 与 Consumer 之间的契约层。