前言¶

在 DeepSeek Harness（DSH）里做智能体或自动化流程时，常需要在同一会话里生成或改图，并把结果挂回对话上下文。若自行接 HTTP、落盘、再注册附件，步骤分散且容易和 Harness 的 Cordis 上下文脱节。社区插件 dsh-agnes-image（维护者 foolfu86，分类：模型推理）向 Host 暴露单一工具 agnes_image，对接 Agnes 图像接口，并把输出写入 Session 工作目录、注册为附件，便于在对话中内联展示。

这是什么¶

dsh-agnes-image 是面向 DeepSeek Harness 的插件：增加 Host 工具 agnes_image，用于基于 Agnes Image 2.5 Flash 的图像生成与图像编辑。实现上刻意无额外依赖：仅使用 Node 内置模块，通过注入的 Cordis 上下文（ctx.tools、ctx.credentials、ctx.attachments、ctx.workingDirectory）工作；无构建步骤、无 @deepseek-ai/* 对等依赖，按官方说明通过 git 安装时无需 allowBuilds 审批。

生态上 DSH 主张「一切皆插件」；目录页位于社区站点 skillhub.cn，与 DeepSeek / 幻方无官方从属关系，下文安装与配置均以仓库 README 为准。

核心功能¶

agnes_image 调用 Agnes 图像端点，将结果保存到 Session 工作目录（默认子目录 agnes-images/），注册为附件以便在会话中内联显示，并返回持久化文件路径。

默认参数（每次调用均可覆盖）如下：

支持传入本地参考图（png / jpg / jpeg / webp / gif），用于编辑与多图合成。

仓库布局：package.json 声明 dsh.bundle.patch；cordis.patch.yml 将 bundle 插入 profile 层栈；index.js 实现 agnes_image 工具。许可证为 MIT（package.json 版本 1.1.0）。

安装与启用¶

下面以 README 中的 demo profile 为例；请按你的实际 profile 替换 --profile 参数。

1、添加插件：

dsh plugin --profile demo add github:foolfu86/dsh-agnes-image

2、确认配置层已出现插件片段：

dsh --profile demo --dump-config     # expect a "# == dsh-agnes-image" layer

3、使用该 profile 启动 DSH：

dsh --profile demo

卸载：

dsh plugin --profile demo remove dsh-agnes-image

凭证配置¶

插件运行时需要 Agnes API Key。运行时查找凭证引用 AGNES_API_KEY（先 process.env，再 profile 的 credential store）。仓库不保存任何密钥，需自行配置，例如：

export AGNES_API_KEY=your_key_here

或写入 ~/.dsh/.credentials.yaml。

典型用法¶

安装并完成凭证配置后，在已加载该插件的 DSH 会话中，由模型或编排逻辑调用 Host 工具 agnes_image：纯文生图时传入提示与可选的 model / size / ratio 等；编辑或合成时传入本地参考图路径。工具完成后可在对话中通过附件查看图片，并使用返回的持久路径做后续步骤。

具体参数字段与调用形态以 GitHub README 及当前 index.js 为准；本文不列举未在资料中给出的示例请求体。

适用场景与注意¶

适合希望在 DSH 内统一完成「调 Agnes 生图 / 改图 → 落盘 → 会话附件」链路的开发者，尤其是希望避免单独维护 SDK 与构建流程的场景。

安装前建议阅读插件源码与 MIT 许可证。插件以当前 dsh 进程权限 运行，会访问你配置的 API Key、工作目录与本地参考图路径；仅安装你信任的社区插件。

结尾¶

dsh-agnes-image 用单一 Host 工具把 Agnes Image 2.5 Flash 接入 DSH 会话工作流，依赖面小、与 Cordis 附件机制对齐。更多信息见目录页 foolfu86/dsh-agnes-image 与源码仓库 github.com/foolfu86/dsh-agnes-image。