mirror of https://git.openapi.site/https://github.com/desirecore/market.git synced 2026-06-06 05:50:41 +08:00

Files

xyx 954891f9c2 fix(dashscope-image-gen): 移除硬编码 provider，改用 serviceType 自动发现 (#23 )

## Summary

- 移除 `media-proxy` curl 命令中硬编码的 `"provider": "dashscope"`，改为仅传
`"serviceType": "image_gen"` 让系统自动匹配已启用的供应商
- 修改 frontmatter `provider: dashscope` → `provider: auto`
- 更新前置条件和错误处理描述，不再要求配置 DashScope 专用 Provider
- Bump version 1.1.1 → 1.2.0

## Background

之前技能硬编码了 `"provider": "dashscope"`，导致使用中转 key（如 DesireCore Cloud /
鹏耀科技）时 `findProvider` 按 slug 匹配不到已启用的供应商，文生图功能无法使用。

改为 `serviceType: "image_gen"` 自动发现后，`findProvider` 会在所有已启用的 provider
中查找支持 `image_gen` 服务类型的供应商，兼容直连和中转场景。

## Changes

| File | Change |
|------|--------|
| `SKILL.md` | 去掉 curl 中 `"provider": "dashscope"`；更新 prerequisites /
error handling |
| `SKILL.zh-CN.md` | 同步中文版修改 |

## Test plan

- [ ] 使用 DesireCore Cloud（鹏耀科技）默认算力，发送「画一幅小狗」验证技能触发和图片生成
- [ ] 使用独立 DashScope API Key 配置，验证兼容性

2026-06-05 18:03:50 +08:00

4.8 KiB

Raw Permalink Blame History

dashscope-image-gen 技能

强制规则（违反将导致功能失败）

必须用 HTTPS 访问 agent-service — https://127.0.0.1:${PORT} 加 -k 跳过证书验证
必须通过 /api/media/upload 上传到 media-store — 禁止保存到本地路径
必须使用 dc-media:// 协议展示图片 — 唯一能让前端正确渲染的方式
全程使用 Bash curl — 不要使用 HttpRequest 工具或 Python
使用 compatible-mode（/chat/completions） — 同步调用，响应直接包含图片 URL

模型选择指南

模型	特点	适用场景
wan2.7-image-pro	旗舰，4K 分辨率，thinking_mode	用户要求最高画质、4K、细节丰富
wan2.7-image	标准高画质，thinking_mode	默认首选，无特殊要求时使用

默认规则：用户未指定模型时，使用 wan2.7-image。

完整执行流程（严格按此两步执行）

前置条件

至少有一个已启用的算力供应商支持 image_gen 服务类型（如 DashScope 或默认的 DesireCore Cloud 供应商）
agent-service 正在运行

第一步：调用文生图 API（同步）

通过 media-proxy 的 compatible-mode 端点生成图片，响应直接包含图片 URL：

PORT=$(cat ${DESIRECORE_ROOT}/agent-service.port)
curl -sk -X POST "https://127.0.0.1:${PORT}/api/media-proxy" \
  -H "Content-Type: application/json" \
  -d '{
    "serviceType": "image_gen",
    "endpoint": "/chat/completions",
    "body": {
      "model": "wan2.7-image",
      "messages": [
        {
          "role": "user",
          "content": [
            {"type": "text", "text": "这里替换为图片描述（建议英文效果更好）"}
          ]
        }
      ]
    },
    "responseType": "json"
  }'

响应示例：

{
  "success": true,
  "data": {
    "request_id": "...",
    "output": {
      "choices": [
        {
          "message": {
            "role": "assistant",
            "content": [
              {
                "type": "image",
                "image": "https://dashscope-result.oss.aliyuncs.com/..."
              }
            ]
          },
          "finish_reason": "stop"
        }
      ]
    }
  },
  "statusCode": 200
}

从 data.output.choices[0].message.content 中找到 type: "image" 的项，提取其 image URL。

第二步：下载并上传到 media-store

图片 URL 有时效，必须立即下载并保存到本地 media-store：

PORT=$(cat ${DESIRECORE_ROOT}/agent-service.port)
IMAGE_URL="第一步响应中的 image URL"
curl -sL "$IMAGE_URL" -o /tmp/dashscope-gen.png && \
curl -sk -X POST "https://127.0.0.1:${PORT}/api/media/upload" \
  -F "file=@/tmp/dashscope-gen.png;type=image/png"

从 JSON 响应中提取 mediaId 字段（格式如 xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.png）。

第三步：用 dc-media 协议展示图片

在你的回复文本中直接写 Markdown 图片语法：

![图片描述](dc-media://这里替换为mediaId)

例如：![森林中的白色狐狸](dc-media://a1b2c3d4-e5f6-47a8-b9c0-d1e2f3a4b5c6.png)

前端会自动将 dc-media:// 转为可访问的图片 URL 并渲染出来。

参数映射

尺寸选择

通义万相通过 compatible-mode 调用时，尺寸通过 size 参数传入（放在请求体顶层）：

{
  "model": "wan2.7-image",
  "size": "1024x1024",
  "messages": [...]
}

用户意图	size 参数
正方形/头像/默认	"1024x1024"
横版/风景/壁纸	"1792x1024"
竖版/手机/海报	"1024x1792"

可选参数（加入请求体顶层）

参数	说明
`n`	生成数量 1-4，默认 1
`size`	图片尺寸，如 "1024x1024"

多图生成

当 n > 1 时，choices 数组会有多个元素，每个 message.content 中都有一张图片。需要为每张图片执行下载+上传，然后逐一展示：

![图片1描述](dc-media://mediaId1)
![图片2描述](dc-media://mediaId2)

错误处理

success: false + error: "未找到匹配的供应商"：没有已启用的供应商支持 image_gen 服务类型
success: false + error: "未配置 API Key"：未填写 API Key
statusCode: 401：API Key 无效或已过期
statusCode: 429：频率限制，稍后重试
statusCode: 400 + InvalidParameter：参数错误（如尺寸不支持）
statusCode: 403 + AccessDenied.Unpurchased：模型未开通，需要在阿里云控制台开通

注意事项

通过 compatible-mode 调用是同步的，通常 10-60 秒返回（wan2.7-image-pro 可能更长）
结果图片 URL 有时效，必须及时下载
提示词建议用英文以获得最佳效果，中文也支持
如果用户未明确要求模型/尺寸，默认使用 wan2.7-image + 1024x1024

4.8 KiB Raw Permalink Blame History Unescape Escape