在 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 进程权限运行，请检查源码与许可证后再部署。
