前言¶
DeepSeek Harness（dsh）采用「一切皆插件」的架构，允许开发者通过插件扩展适配器和运行时行为。在本地开发或使用 Paseo Agent 平台时，接入 Agnes AI 模型网关通常需要手动修改适配器配置并编写 ACP（Agent Communication Protocol）桥接脚本。
dsh-agnes-paseo 插件通过 bundle patch 在 llm-pi-ai 适配器上声明 agnes provider 路由，并自动将 dsh --profile headless 包装为 ACP agent，从而实现一键注册 Paseo provider。
插件信息¶
- 名称：dsh-agnes-paseo
- 维护者：vvlife
- 许可证：MIT
- 核心价值：接入 Agnes AI 模型网关，一键把 dsh 注册为 Paseo 的 provider。
安装¶
安装命令如下：
dsh plugin --profile headless add github:vvlife/dsh-agnes-paseo
安装后，通过 --dump-config 校验默认模型是否已切换到 agnes/agnes-2.5-flash：
dsh --profile headless --dump-config | grep -A3 agent-default-model
初始化与配置¶
安装完成后，需要在 dsh 的 headless profile 目录下运行初始化脚本。
- 进入 profile 目录：
cd ~/.dsh/profiles/headless
- 执行 setup 脚本并传入 Agnes API Key：
pnpm exec dsh-agnes-paseo-setup --key sk-你的AgnesKey
也可以不传 --key，直接使用环境变量 AGNES_API_KEY 或在交互式提示中输入。Key 需在 platform.agnes-ai.com 创建。
初始化脚本会完成以下工作：
1. 将 API Key 写入 ~/.dsh/.credentials.yaml（权限 0600）。
2. 复制零依赖的 ACP 桥 dsh-acp-bridge.mjs 到 ~/.dsh/paseo-bridge/。
3. 修改 ~/.paseo/config.json，添加 DeepSeek Harness provider 配置：
"deepseek": {
"extends": "acp",
"label": "DeepSeek Harness",
"command": ["~/.dsh/paseo-bridge/dsh-acp-bridge.mjs"]
}
- 重启 Paseo daemon 并验证 provider 状态：
paseo daemon restart
paseo provider ls
此时 `deepseek` 应显示为 available。
在 Paseo 中新建 agent，选择 DeepSeek Harness，模型下拉列表中即可看到 agnes-2.5-flash、agnes-2.5-pro 和 agnes-2.0-flash。
可用模型¶
agnes-2.5-flash：默认模型，速度优先。agnes-2.5-pro：推理能力更强，速度较慢。agnes-2.0-flash：上一代快速模型。
注意事项¶
- 无状态运行：每个 Paseo prompt 回合是一次独立的
dsh --profile headless运行，插件不保留对话上下文。 - ACP 桥路径探测：ACP 桥在启动时会依次探测
/opt/homebrew/bin/dsh、/usr/local/bin/dsh以及系统 PATH。如果需要指定其他路径，可设置环境变量DSH_BIN。 - 卸载：卸载插件后，dsh 会恢复原有的默认模型配置。Paseo 的 provider 条目需手动从
~/.paseo/config.json删除并重启 daemon。 - 依赖：插件本身无运行时依赖，但需要 Node.js 环境支持（要求 >= 18.17）。
总结¶
dsh-agnes-paseo 通过自动化配置解决了接入 Agnes AI 的繁琐步骤。它将 dsh 的 headless 模式转化为 Paseo 可识别的 ACP agent，开发者无需手动编写适配器或桥接脚本即可在 Paseo 中使用 Agnes 推理模型。
