前言¶

DeepSeek Harness（DSH）把对话 Agent 和可扩展工具绑在一起。若要在会话里直接出图、用多张参考图做编辑，通常要自己接 HTTP API、管凭据和附件回传。DSH FHL Image 是社区维护的独立插件（MIT），在 DSH 里挂上 FHL Images 的生图、编辑、Worker 池，以及可在聊天里配置的凭据流程。它不是官方 DeepSeek 或 FHL 产品；使用前需已安装并能启动 DSH。

这是什么¶

• 名称与包名：DSH FHL Image，npm 包 @fhl-plugins/dsh-fhl-image，当前插件版本 0.2.2。
• 维护者：supart，源码与发行在 GitHub。
• 分类：模型推理（社区目录 SkillHub 条目）。
• 版本对应：0.2.2 面向官方桌面版 DSH 0.2.0-rc.2 包线；engines.dsh 为 >=0.2.0-rc.2 <0.3.0-0。安装或启动时 DSH 会校验 peer 范围，不匹配会报 incompatible-version，应换对应插件版本而非强行豁免。

核心功能¶

插件向 Agent 暴露三个工具（名称以会话工具列表为准）：

1. fhl_image_configure：在用户明确要求时，用聊天里提供的 Key 配置最多十个 Worker；成功后只回报脱敏的 Worker 数量。
2. fhl_image_generate：经 FHL Images API 生成一至九张图。
3. fhl_image_edit：用一至十张有序参考图做编辑或组合，可产出一至四个独立变体。

其它行为（README 已写明）：最多十个 Worker，凭据经 DSH credential provider 以 FHL_IMAGE_API_KEY 至 FHL_IMAGE_API_KEY_10 引用；支持 Worker 冷却重试、按 Worker 隔离鉴权、取消、有界响应与凭据脱敏；生成结果经 DSH 附件服务回到对话。

安装与启用¶

安装包是 Release 附件 fhl-plugins-dsh-fhl-image-0.2.2.tgz（.tgz 是插件包，不能双击运行）。必须用以 .tgz 结尾的下载直链；仓库 URL 或 releases/latest 会被当成 git 源，但仓库不含构建产物 lib/，也无法从 npm 安装 @fhl-plugins/dsh-fhl-image。

下载直链：

https://github.com/supart/DSH-FHL-Image-Plugin/releases/download/v0.2.2/fhl-plugins-dsh-fhl-image-0.2.2.tgz

一条提示词安装（推荐）：在 DSH 会话里发送下面整段，让 Agent 用插件管理工具安装：

请用插件管理工具安装这个 FHL 图像插件包：
https://github.com/supart/DSH-FHL-Image-Plugin/releases/download/v0.2.2/fhl-plugins-dsh-fhl-image-0.2.2.tgz

安装完成后打开它的启用开关，然后让我完全退出并重新打开 App。
之后新建会话，确认工具列表里有 fhl_image_configure、fhl_image_generate、fhl_image_edit。

安装会改写 desktop profile 的 package.json、pnpm-lock.yaml 与 node_modules/，需要 danger-full-access 或当次授权。桌面 App 独占 desktop profile，不要在外部 shell 对它执行 dsh plugin。

图形界面：把 tarball 放到不含空格的目录，在侧边栏「插件」页用绝对路径安装 → 打开启用开关 → 完全退出并重启 App → 新建会话核对三个工具。

命令行版 DSH（进阶，自定义 profile）：

dsh plugin --profile fhl-image add /绝对路径/fhl-plugins-dsh-fhl-image-0.2.2.tgz
dsh --profile fhl-image --dump-config
dsh --profile fhl-image

若工具未出现：确认已启用、重启 App 或 Host、新建会话；改插件或重装后旧进程可能仍暴露旧工具目录，必须重启。

典型用法¶

聊天配置 Worker¶

新建会话并确认三个工具存在后，可先配置 API（配置阶段不要调用生图工具）：

我想配置 FHL 生图专用 API。请使用 fhl_image_configure 工具，并先告诉我需要如何提供一个或多个 Worker Key；不要调用生图工具。

按 Agent 提示把 Key 粘贴到聊天框，每个 Key 一行。原始 Key 会随用户消息经过当前模型，并可能留在 DSH 会话历史中。若不能接受，应改用 DSH 凭据机制直接写入 FHL_IMAGE_API_KEY、FHL_IMAGE_API_KEY_2 等引用名；配置项 apiKeyEnv 只是这些引用名的前缀，不是环境变量。

生图¶

请使用 FHL 生图工具生成一张极简现代建筑的全彩效果图，生成 1 张，比例 16:9，2K。

编辑¶

把参考图拖入聊天框，例如：

请使用这张参考图进行编辑，保留主体特征，生成一张全彩效果图。

省略 sources 时，插件依次尝试：当前消息里的图 → 更早的用户上传 → 同会话同进程内本插件最近一张生成图。重启 App 后第三条会失效，需显式传入上次结果中的 attachmentId。

覆盖插件配置¶

默认在 bundle 层，不读环境变量。可在 profile 补丁层覆盖，例如：

# ~/.dsh/profiles/desktop/cordis.patch.yml
- id: fhl-image
  name: '@fhl-plugins/dsh-fhl-image'
  config:
    baseURL: https://www.fhl.mom
    timeoutMs: 180000
    workerCooldownMs: 60000

适用场景与注意¶

适合已在用 DSH 桌面版 0.2.0-rc.2 线、需要 FHL Images 生图与多参考编辑、并希望用 Worker 池分担请求的场景。插件以当前 DSH 进程权限运行；安装前应阅读源码与 MIT 许可证，自行评估 API Key 与网络出站风险。社区目录 SkillHub 与 DeepSeek / 幻方无官方从属关系，本文事实以项目 README 与 Release 为准。

链接¶

• 社区目录：https://www.skillhub.cn/plugins/supart/DSH-FHL-Image-Plugin
• 源码与文档：https://github.com/supart/DSH-FHL-Image-Plugin