前言¶

在 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。