dsh-agnes-paseo

Readme

# 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 配置。

## 安装

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

校验挂载成功：

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

## 初始化（凭据 + Paseo 注册）

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

也可以不设 `--key`，用环境变量 `AGNES_API_KEY` 或交互式输入。Key 在 [platform.agnes-ai.com](https://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`）：

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

然后：

```sh
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