前言¶

DeepSeek Harness (DSH) 的核心理念是“一切皆插件”。在桌面端开发智能体时，生图功能通常需要外部面板或手动切换视图。dsh-tool-imagegen 旨在解决这一问题：它允许模型在对话中自动调用 generate_image 工具，生成的图片直接内联显示在对话框中，无需额外的操作步骤。

核心功能¶

本插件提供以下核心能力：

• 自动工具调用：模型听到生成请求时自动调用 generate_image，参数由模型组织。
• 对话内联显示：生成的图片以卡片形式出现在对话流中，支持全屏查看、下载、本地打开和修改。
• 纯文本输入支持：支持纯文本输入，包含上传参考图和图生图。模型侧通过自定义 generated-image / uploaded-image 块展示图片，对模型不可见，确保纯文本模型也能安全使用。
• 网络容错：支持网络自动重试（指数退避，最多 3 次），但不重试 4xx 错误（如模型不存在）。
• 双模型兼容：兼容纯文本模型和图像输入模型。
• 设置与安全：设置页可配置接口地址、API 密钥、模型名、默认尺寸等。密钥仅保存在本地 settings.yaml 中，不回显，且使用 loopback 围栏限制访问。

安装与启用¶

插件安装后，需要将其挂载到桌面 profile。

1. 复制插件目录到 DSH 插件目录：

    cp -r dsh-tool-imagegen C:/Users/CJX/.dsh/plugins/

2. 进入桌面 profile 目录，安装依赖：

    cd C:/Users/CJX/.dsh/profiles/desktop
    pnpm install

3. 完全退出 DSH 后重新启动。

典型用法¶

用户可以通过自然语言触发生图：

• “生成一个猫咪的图片”
• “把这张图改成…”
• “基于这张图改…”

对于纯文本模型，需确保设置页“向模型告知能力”已开启。已生成的图片支持点击“修改”按钮，将其作为参考图进行连续修改（图生图）。

注意事项¶

• 图生图限制：图生图功能需要上游接口支持 OpenAI 兼容的 /images/edits 接口。如果上游只实现了 /images/generations，图生图将失败。
• 错误处理：4xx 错误（如模型不存在）不会触发重试。5xx 错误或网络抖动会自动重试。
• 输出格式：当前输出格式和风格与网关可能不兼容。
• 存储清理：在设置页可配置“生图存储”卡片，用于清理不被任何会话引用的孤儿文件。
• 安全与权限：插件以当前 DSH 进程权限运行，安装前请检查源码与许可证。