DSH FHL Image 0.2.2

DSH FHL Image 0.2.2

0.2.1 之后的第一个发布版本。0.2.1 与本次之间开发过的两个版本号从未对外发布，因此这三部分改动合并为 0.2.2 一个版本。没有新增、删除或重命名任何工具，可直接替换 0.2.1。

安装包：fhl-plugins-dsh-fhl-image-0.2.2.tgz
SHA-256：0010803b343e0ed99da2fb9f5066cf0d484bcc981ec5a6eae085e5ec9e0b176b

新增

• 生成的图片现在会显示在会话里。 两个生图工具一直返回持久的 image 内容块，但 Tool 客户端只为内置的 read_image 画图（imageCardModel 对其他工具名一律返回 null），所以 fhl_image_generate / fhl_image_edit 的结果此前只有一行 "Generated 2 image(s) at 1152x2048"，看不到图。bundle 现在提供 exports["./ui"] 并声明 dsh.client，为两个工具名各注册一个 tool.call.toolview 条目，通过会话授权的 loadImage 加载器展示全部图片，并在画廊下方保留结果文本。
• fhl_image_configure 有了自己的行。 显示它报告的 Worker 数量，Worker 集合为空时给出一句提示（可以在聊天里发 Key 重新配置）。这一行还解决了一个图片行无法解决的诊断问题：图片行只能靠加载图片来证明自己，所以空白行分不清是"浏览器半从未挂载"还是"画廊没画出来"，而这一行只靠结果文本就能画出来。

修复

• 多参考图编辑不再丢弃第一张之后的参考图。 编辑表单给第一张参考图用 image、其余用 image[]，而 FHL 不会把两种字段名合并成同一个参考图数组，于是第二张及以后的参考图虽然上传成功，但其身份特征从未到达模型：多图合成时取自图 2 的面相、眼镜、发型和服装会丢失。现在每张参考图都用重复的 image 字段，与 Codex 插件 0.2.2 的修复一致——该修复已在真实链路上确认。

已验证

• pnpm typecheck、pnpm test（10 文件 / 78 用例）、pnpm build、pnpm pack。
• GitHub Actions CI 在 Node 22.19 与 24 上跑同一套闸门：typecheck、test、build、pack，并扫描发布包中的类 Key 文本与本机绝对路径，以及所有相对模块导入是否随包发布。
• 发布包 46 个文件；敏感扫描干净（无 sk-…、无 /Users/、无 C:\Users\）；打包内 7 个模块的相对导入图完整，无缺失 chunk。
• 桌面 profile 实测升级：先 remove 再 add 0.2.2；安装副本含 EDIT_SOURCE_FIELD 且不含 image[]，其余插件（dshmarket、dsh-orb、dsh-workbuddy-connect、dsh-h3-motion-transfer）未受影响。

尚未宣称完成

• 参考图字段标号属于协议变更，尚未在本插件的真实 FHL 接口上复验，目前只有单元测试覆盖；Codex 插件 0.2.2 已在其自身真实链路上复验等效请求。
• 会话内的图片行尚无桌面端实测记录（客户端那一半只在启动时加载，验收需要完全退出、重开并新建会话）。
• 跨重启后省略 sources 的行为仍有意不宣称。
• 无 Windows 桌面版实测记录。

升级提示

同名的同版本包已安装时重复安装会报 ambiguous-install；升级请先移除旧版本再安装新 tarball。桌面 App 安装后需完全退出并重新打开才会加载新版本。

v0.1.0 与 v0.2.1 标签未移动、未强推。

DSH FHL Image 0.2.1

DSH FHL Image 0.2.1

桌面版 DSH 0.2.0-rc.2 包线上的兼容性与质量升级。没有新增、删除或重命名任何工具，可直接替换 0.2.0。

安装包：fhl-plugins-dsh-fhl-image-0.2.1.tgz
SHA-256：d90bcebc5b430c00c28ba2e8b19acd307d54896eda6ba3e0ec83a437a8d113f4

修复

• fhl_image_configure 现在是整体替换。 0.2.0 只会写入、从不删除，先配 10 个 Key 再配 1 个时，第 2–10 号槽位仍留着已撤销的 Key 并被继续调度，而结果却报告只配了 1 个。现在超出本次 Key 数量的槽位会被清除。
• 确定性错误不再重试整池 Worker。 本地参数校验此前与传输错误共用可重试错误码，空 prompt 会向每个 Worker 重试（一次调用最多 9 × 10 次无意义请求），最后报"所有 Worker 都失败了"，掩盖真实原因。
• 省略 sources 时只取最近一张图。 此前会把最近一次生成的全部变体（最多 9 张）一起当作编辑参考，而提示词和文档一直承诺"最近一张图"。
• 接受真实世界的 base64：不带填充、base64url、带 data-URI 前缀的响应都能解码，不再因为可解码的变体报 invalid-image 并触发上面的重试风暴。
• 错误响应体不再整份缓冲：只读有界前缀并立即取消流，不再先读到 64 MiB 上限再截断成 512 字符。
• 脱敏覆盖最后一跳：task-fatal 分支此前会原样抛出错误，第三方 fetch/undici 消息可能带着 Worker Key 到达模型。同时覆盖带空白的 Key 形态。
• skipped 现在与提示文案一致（包含重复项）。

工程改进

• 测试从 20 个增加到 71 个，新增 worker-pool 测试套件（23 个用例，此前这个并发核心零覆盖）、工具执行体测试、构建产物入口测试和客户端边界用例。
• 测试文件现在会被类型检查（tsconfig.test.json）。此前只检查 src；接入后立刻暴露并修复了 4 个真实类型错误。
• 新增 GitHub Actions CI：Node 22.19 与 24 上跑 typecheck / test / build / pack，并扫描发布包中的类 Key 文本、本机绝对路径，以及所有相对模块导入是否随包发布。
• 发布包现在包含 README 引用的六份中文文档（此前只带 docs/assets，装完后 README 文档链接全是死链）。
• 补齐 publishConfig / homepage / bugs；@deepseek-ai/cordis peer 由精确 4.0.4 放宽为 ~4.0.4。
• 加入 .gitattributes，仓库统一 LF 行尾。
• 产品限制收敛到单一常量表，工具描述由常量生成。

已验证

• pnpm typecheck、pnpm test（9 文件 / 71 用例）、pnpm build、pnpm pack。
• 从干净克隆跑完整闸门，并打出逐字节相同的 SHA-256（构建可复现）。
• 发布包 42 个文件，无凭据、无本机路径。
• 复刻 evaluatePluginCompatibility 对 0.2.0-rc.2 校验：7 个 dsh peer 全部满足（含 prerelease）。
• 桌面 profile 实测升级：安装副本与 tarball 逐字节一致，dsh-orb 与既有补丁未受影响，未申请版本豁免。
• 真实生图验收：通过真实 Worker Key 调用 fhl_image_generate 成功出图并由 DSH 附件服务落盘，工具结果不含 Key —— 补上了 0.2.0 遗留的最后一个验收空白。

尚未宣称完成

• 真实链路只验收了生成；编辑工具的真实请求与计费状态未单独验收。
• 跨重启后省略 sources 的行为仍有意不宣称。
• 无 Windows 桌面版实测记录。
• 编辑请求的 multipart 字段名（首图 image、其余 image[]）已由测试固定但未改动——改动属于协议变更，需对真实接口验证。

升级提示

同名的同版本包已安装时重复安装会报 ambiguous-install；升级请先移除旧版本再安装新 tarball。桌面 App 安装后需完全退出并重新打开才会加载新版本。

v0.1.0 标签未移动、未强推。

DSH FHL Image 0.1.0

DSH FHL Image 0.1.0

Independent MIT-licensed DeepSeek Harness community plugin for FHL Images generation, editing, worker pools, and chat-configured credentials.

第一次使用 / First-time users

Windows 新用户请下载 DSH-FHL-Image-Plugin-0.1.0-Windows-User-Bundle.zip，解压后先阅读 README-FIRST.zh-CN.md，再双击根目录的 install-fhl-image-plugin.cmd。

This is a DSH plugin, not a standalone application. Install DeepSeek Harness first and confirm dsh --help works. Do not double-click the .tgz file.

Included

• hl_image_configure, hl_image_generate, and hl_image_edit.
• Windows installation helper for paths containing spaces.
• Chinese installation, chat configuration, troubleshooting, security, and development guides.
• Real usage illustrations in the bilingual README.

Verification

• TypeScript, offline tests, build, pack and sensitive scans passed.
• Clean temporary DSH profile installation and bundle inspection passed.
• The user confirmed FHL Worker API configuration through hl_image_configure.
• Post-restart persistence and real image generation are separate follow-up checks.
• No API key, user session, or image base64 is included.

This is an independent community project. It is not an official DeepSeek or FHL product.