前言¶
DeepSeek Harness（DSH）把对话、工具和工作区绑在一起：模型可以调用插件暴露的能力，结果落在当前会话的工作区里。若你希望在 Harness 里直接说「画一张 XXX」就能出图，而不是自己写脚本调 API、再手动下载链接，就需要一个面向 DSH 的生图工具插件。
社区维护的 dsh-ark-image（XN-H）走这条路：对接火山方舟 Seedream（豆包） 文生图 API，注册工具 ark_generate_image，生成后立刻把图片写入工作区并在对话里展示。插件为零依赖纯 JavaScript，无需构建步骤；非官方社区插件，与 DeepSeek、火山引擎无隶属关系，MIT 许可。
这是什么¶
dsh-ark-image 是给 DeepSeek Harness 增加「文生图」能力的插件包，维护者为 XN-H，在插件目录中归类为模型推理。
范围很明确：一个工具、仅文生图。不支持图生图、图片编辑，也没有图库或画布。默认模型为 doubao-seedream-5-0-pro-260628，可通过配置项 model 更换（须已在火山方舟控制台开通对应模型）。
核心功能¶
插件向 Harness 暴露工具 ark_generate_image。模型根据你的自然语言描述调用它，典型行为如下：
- 按提示词调用火山方舟 Seedream 生成图片。
- 立即下载并保存到当前会话工作区（方舟返回的图片 URL 约 24 小时后失效，因此必须转存）。
- 在对话中内联显示图片，而不是只返回路径。
- 按日期分子目录存放，例如
generated-images/2026-09-30/a-vast-open-sea-085550.jpg，避免文件堆在同一层。
调用时可由模型自动填参，也可在对话里指定。文档中列出的主要参数包括：
| 参数 | 说明 | 默认 |
|---|---|---|
prompt |
画面描述（必填） | — |
model |
模型 ID | doubao-seedream-5-0-pro-260628 |
size |
1K/2K/3K/4K 或如 1024x1024 |
2K |
n |
生成张数（1–4） | 1 |
watermark |
是否加水印 | false |
outputName |
文件名（不含扩展名） | 由提示词与时间生成 |
可选模型 ID（须控制台已开通）包括：doubao-seedream-5-0-pro-260628（默认，单张精修）、doubao-seedream-5-0-260128、doubao-seedream-5-0-lite-260128、doubao-seedream-4-5-251128、doubao-seedream-4-0-250828 等，详见项目 README。
安装与启用¶
前置条件¶
-
DeepSeek Harness
- 桌面版：从 deepseek.com/harness 安装（Windows / macOS）。
- 命令行版：安装 Node.js（^22.19.0或>= 24）后执行npx @deepseek-ai/dsh web。
桌面版与命令行版可共存、会话记录共用，插件需分别在对应 profile 下安装。 -
火山方舟 API Key
在 火山方舟控制台 创建 Key（ark-开头），并在「开通管理」中开通 Doubao-Seedream 模型。
安装插件¶
入口一：桌面版图形界面（推荐）
- 打开 Harness → 左侧 「插件」 → 「+ 添加插件」。
- 输入框填写
dsh-ark-image（npm 包名；填github:地址会在安装前信息查询阶段失败）。 - 点击 「安装」，完成后完全退出 Harness 再重新打开（点窗口 X 往往只是最小化到托盘，需右键托盘图标 → 退出）。
入口二：命令行
# 从 npm 安装（推荐）
dsh plugin --profile <你的profile> add dsh-ark-image
# 或从 GitHub 源码安装
dsh plugin --profile <你的profile> add github:XN-H/dsh-ark-image
<你的profile> 常见为 desktop 或 web。查看或卸载示例：
dsh plugin --profile desktop list
dsh plugin --profile desktop remove dsh-ark-image
配置 API Key¶
读取优先级：插件配置 apiKey → 环境变量 ARK_API_KEY。设置环境变量后须重启 Harness（进程只在启动时读环境变量）。
Windows 示例：
setx ARK_API_KEY "你的Key"
macOS / Linux 可将 export ARK_API_KEY="你的Key" 写入 shell 配置文件。
或在 profile 的 cordis.patch.yml 中配置：
- id: ark-image
name: dsh-ark-image
config:
apiKey: 你的Key
完整可覆盖项示例：
- id: ark-image
name: dsh-ark-image
config:
baseUrl: https://ark.cn-beijing.volces.com/api/v3
model: doubao-seedream-5-0-pro-260628
outputDir: generated-images
timeoutMs: 180000
apiKey: ''
outputDir 可为相对会话工作区的路径或绝对路径。
典型用法¶
安装、配置 Key 并重启后，无需记 CLI，直接对模型描述画面即可，例如：
画一张：山脊上空的银河，长曝光，不要文字
模型会调用 ark_generate_image 并填参。若生成偏慢，文档说明多数耗时在 API 侧；需要更快时可尝试 size 设为 1K。
适用场景与注意¶
适合谁： 已在用 DSH 做对话式开发或写作，希望把 Seedream 文生图嵌进同一工作流、图片自动落盘并出现在对话里的用户。
权限与安全： 插件以当前 DSH 进程权限运行，会访问网络（火山方舟 API）并写入工作区文件。安装前建议查看 GitHub 仓库 源码与 MIT 许可证；仅对可信来源授权；apiKey 勿提交到版本库。
常见问题速查： 插件列表看不到条目或未激活 → 重新安装并完全退出再开；Ark API key is missing → 检查 Key 配置并重启；401/403 → Key 错误；404 → 模型未开通；429 → 限流，稍后重试。
生态说明： DSH 采用「一切皆插件」的扩展方式；SkillHub 等社区目录为独立站点，并非 DeepSeek 官方应用商店。
结尾¶
dsh-ark-image 把火山方舟 Seedream 文生图收成 Harness 里的一个工具：零依赖、免构建，图会转存到会话工作区并在对话中展示。需要浏览摘要或从目录页跳转时，可访问 SkillHub 插件页 与 GitHub：XN-H/dsh-ark-image。
