在 DeepSeek Harness 的工作流中，圖像生成通常只是靜態輸出。如果需要對結果進行微調，開發者通常需要保存文件，在本地編輯，然後再上傳。dsh-image-studio 插件將這一流程改寫爲對話內的即時操作。
插件定位¶
dsh-image-studio 是一個由 wu81313-lab 維護的客戶端插件，它爲生成的圖像卡片增加了一個編輯按鈕。通過標註、擦除或調整尺寸，用戶可以直接在對話中修改圖像，插件會將修改後的文件路徑和遮罩信息回傳給智能體，使其在下一輪對話中繼續處理。
核心功能¶
插件提供以下能力：
- 內聯圖像卡片：在對話流中展示生成的圖像，底部左側固定顯示編輯按鈕。
- 編輯工具：
- 標註：支持自由線條、矩形、箭頭，可調節顏色、筆觸寬度、撤銷和清空。
- 擦除：通過繪製透明區域生成 RGBA 遮罩。
- 調整尺寸：通過拖拽裁剪框，支持自由比例及常見比例預設（1:1、16:9 等），並限制輸出尺寸符合 PackyAPI 規則。
- 工作流閉環：用戶點擊生成後，插件將編輯結果寫入磁盤（PNG 格式），並通過路由返回文件路徑，智能體在下一輪即可讀取並處理這些修改後的文件。
安裝與啓用¶
安裝插件需要 DeepSeek Harness 的 Web GUI 環境。使用 Web profile 進行安裝：
dsh plugin --profile web add github:wu81313-lab/dsh-image-studio
安裝後，插件會被註冊到 dependencies 和 dsh.profile.bundles 中。由於插件在啓動時加載，安裝完成後需要重啓 DSH 並刷新瀏覽器頁面，以確保客戶端和宿主端的組件都正確掛載。
典型用法¶
工具調用¶
智能體在生成圖像後，通過調用 sunburst_image_card 工具觸發卡片展示。該工具接收以下參數：
sunburst_image_card(path="<the path the script printed>", prompt="<the prompt used>",
model="gpt-image-2.5-sunburst", size="3840x2160")
路由與數據流¶
- 獲取圖像：通過
GET /dsh-image-studio/image?path=…路由流式傳輸圖像字節，不經過 RPC 傳輸 Base64。 - 提交編輯：用戶在編輯器中操作後，點擊生成。此時調用
POST /dsh-image-studio/stage，插件將編輯結果（標註圖、遮罩圖或裁剪圖）寫入磁盤，並返回包含文件路徑和操作說明的消息給智能體。
適用場景與注意¶
此插件適用於任何需要對話式圖像編輯的場景，特別是配合圖像生成技能使用時。
注意事項：
* 遮罩尺寸限制：擦除功能生成的遮罩（RGBA PNG）必須與原始圖像尺寸完全一致。因此，插件不支持將“裁剪”與“擦除”合併爲一步，必須分別進行。
* Body Cap：POST /dsh-image-studio/stage 接口的請求體大小限制爲 128 MiB。
* 權限要求：插件以當前 DSH 進程權限運行，請檢查源碼與許可證後再部署。
