前言¶

在 DeepSeek Harness（DSH）里做智能体时，若需要文生图，常见做法是自接各家 OpenAPI、自己管凭据和落盘路径。社区插件 dsh-ustc-image 把范围收窄到一件事：注册单个工具 generate_image，背后走中国科学技术大学（USTC）模型网关上的 qwen-image-2.1。没有 provider 列表、没有设置页、没有多模型路由，适合只要「会话里要一张图」的场景。

这是什么¶

dsh-ustc-image 由维护者 AsterionZephyr 发布，在 SkillHub 插件目录 中归类为模型推理；源码与说明见 GitHub 仓库。当前包版本为 0.1.0，许可证 MIT。

插件类型为极简 DSH 插件：仅向 Harness 暴露一个图像生成工具，调用 POST https://api.llm.ustc.edu.cn/v1/images/generations，模型固定为 qwen-image-2.1。

核心功能¶

工具名：generate_image。

1. 入参
   - prompt：必填，图像描述。
   - size：可选，支持 1024x1024、512x512、768x1024，默认 1024x1024。

2. 网关行为
   - 请求强制 response_format: "b64_json"。README 说明该网关返回的 data[0].url 下载会 404，因此只能走 base64 解码，不能依赖 URL 拉取。

3. 落盘与展示
   - 图片写入当前会话工作目录：<会话 cwd>/assets/images/ustc/qwen-image-<时间戳>.png。
   - 通过 ctx.get('attachments').saveImage() 回传，在对话中内嵌显示。

4. 运行环境
   - package.json 要求 Node >=22.19.0，依赖 @deepseek-ai/cordis 与 @deepseek-ai/dsh-tools（peer）。

README 中记载的实测（供预期耗时参考，非承诺 SLA）：

前置条件与凭据¶

1. 准备一个能访问 USTC 网关的 API key。
2. 将 key 写入 DSH 凭据文件 refs 段，键名为 USTC_API_KEY。插件启动时不读环境变量，每次调用会现读该文件，修改 key 后无需重启 DSH。

# ~/.dsh/.credentials.yaml
refs:
  USTC_API_KEY: <your-key>

3. 确认网关已开放 qwen-image-2.1（GET /v1/models 能查到该模型）。

安装与启用¶

从 GitHub 安装（需本机 pnpm 能解析 git 依赖）：

dsh plugin --profile desktop add github:AsterionZephyr/dsh-ustc-image

本地开发可使用路径安装：

dsh plugin --profile desktop add /path/to/dsh-ustc-image

装完后重启 DSH 才会挂载插件（插件仅在启动时加载）。

卸载：

dsh plugin --profile desktop remove dsh-ustc-image

典型用法¶

安装并配置 USTC_API_KEY 后，在已启用该插件的 DSH 会话中，让模型调用 generate_image，传入 prompt 与可选的 size 即可。无需在插件内切换模型或打开额外设置页；生成结果会落在当前会话 assets/images/ustc/ 下，并在对话里以附件形式展示。

适用场景与注意¶

适合谁

• 已能使用 USTC LLM 网关、且需要 qwen-image-2.1 出图的 DSH 桌面侧用户。
• 希望工具面尽量小、不想维护多 provider 路由的集成方式。

应注意

• 尺寸仅限 README 列出的三种方形或竖版组合；1280x720 等网关在测中会 500，插件 deliberately 未开放。
• DSH 插件以当前 dsh 进程权限运行，安装前建议自行审阅 仓库源码 与 MIT 许可证。
• SkillHub 等为社区目录，与 DeepSeek / 幻方无官方从属关系；星标与目录信息以站点与 GitHub 为准。

结尾¶

dsh-ustc-image 的价值在于把 USTC 网关文生图收成 DSH 里的单工具路径：凭据进 ~/.dsh/.credentials.yaml，出图进会话 assets，对话内直接看图。进一步说明与 issue 见 GitHub，目录索引见 SkillHub。