前言¶
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 推理模型。
