dsh-agnes-paseo

dsh-agnes-paseo

DeepSeek Harness（dsh）插件：接入 Agnes AI 模型网关，并一键把 dsh 注册为 Paseo 的 provider。

• dsh 侧：通过 bundle patch 在 llm-pi-ai 适配器上声明 agnes provider 路由（OpenAI 兼容，https://apihub.agnes-ai.com/v1），并把默认模型切到 agnes/agnes-2.5-flash。纯配置，无构建、无运行时依赖。
• Paseo 侧：自带一个零依赖的 ACP 桥（dsh-acp-bridge），把 dsh --profile headless 包装成 ACP agent；setup 脚本自动写入 Paseo provider 配置。

安装

dsh plugin --profile headless add github:vvlife/dsh-agnes-paseo
# 如用 dsh web，也装一份到 web profile：
dsh plugin --profile web add github:vvlife/dsh-agnes-paseo

校验挂载成功：

dsh --profile headless --dump-config | grep -A3 agent-default-model
#   provider: agnes
#   model: agnes-2.5-flash

初始化（凭据 + Paseo 注册）

# 在 profile 目录里执行（或直接给绝对路径）
cd ~/.dsh/profiles/headless
pnpm exec dsh-agnes-paseo-setup --key sk-你的AgnesKey

也可以不设 --key，用环境变量 AGNES_API_KEY 或交互式输入。Key 在 platform.agnes-ai.com 创建。

setup 会做三件事：

1. AGNES_API_KEY 写入 ~/.dsh/.credentials.yaml（0600）
2. ACP 桥复制到 ~/.dsh/paseo-bridge/dsh-acp-bridge.mjs
3. ~/.paseo/config.json 写入 provider（原文件备份为 .bak）：

"deepseek": {
  "extends": "acp",
  "label": "DeepSeek Harness",
  "command": ["~/.dsh/paseo-bridge/dsh-acp-bridge.mjs"]
}

然后：

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	上一代

Agnes 是推理模型，默认 reasoning_effort: low（速度优先）。

注意

• 每个 Paseo prompt 回合是一次独立的 dsh --profile headless 运行，回合间不保留对话上下文（dsh headless 无 resume）。
• ACP 桥 spawn 的 dsh 依次探测 /opt/homebrew/bin/dsh、/usr/local/bin/dsh、PATH；可用环境变量 DSH_BIN 指定。
• 卸载插件（dsh plugin --profile headless remove dsh-agnes-paseo）后，dsh 恢复原默认模型；Paseo provider 需手动从 ~/.paseo/config.json 删除 deepseek 条目并 paseo daemon restart。
• Agnes API 文档：https://wiki.agnes-ai.com。

License

MIT