前言¶
DeepSeek Harness (DSH) 的設計理念是「一切皆插件」。在開發智能體時，追蹤行爲與成就（Achievements）通常需要編寫重複邏輯或依賴特定環境。agpa-dsh-plugin 插件旨在解決跨工具共享成就引擎的問題，無需在 DSH 側重新實現成就邏輯，而是通過橋接現有的 AGPA 引擎，實現統一的成就數據存儲與跨代理觸發。
插件概況¶
- 名稱：agpa-dsh-plugin
- 作者：eiainano
- 許可證：MIT
- 核心價值：爲 DSH 提供原生的
achievement_*工具外殼，直接調用 AGPA MCP 引擎，並自動從 DSH 會話事件中捕獲數據。
核心功能¶
- 原生
achievement_*工具外殼
插件註冊了 7 個原生工具，如achievement_stats。這些工具僅作爲薄外殼，將參數原樣轉發至 AGPA MCP 服務器。 - MCP 橋接
插件包含一個零運行時依賴的 MCP-over-stdio 客戶端（src/agpa-bridge.ts），用於連接 AGPA 引擎。 - 自動事件跟蹤
訂閱 DSH 的session/event，將file.create、file.write、command.run、tool.complete等事件規範化，並自動觸發agpa-hook auto進行處理。 - 跨代理成就支持
由於 AGPA 引擎和數據存儲（~/.agent-achievements）是共享的，在 DSH 中觸發的成就也會在 Claude Code 等其他工具中生效。 - 模型工作流手冊
插件附帶skills/agpa/SKILL.md，指導模型何時進行跟蹤、輪詢或宣佈解鎖。
安裝與啓用¶
- 添加插件到配置文件
dsh plugin --profile web add agpa-dsh-plugin
- 安裝模型工作流手冊
cp -r ~/.dsh/profiles/web/node_modules/agpa-dsh-plugin/skills/agpa ~/.agents/skills/
- 驗證安裝
重啓 DSH 後，檢查配置樹中是否出現agpa行：
dsh --profile web --dump-config | grep -A3 agpa
典型用法¶
- 獲取 AGPA 統計信息：
achievement_stats tool_source=dsh
- 事件標記：
通過 DSH 觸發的事件會被標記爲tool_source:'dsh'，存儲在共享的~/.agent-achievements中。 - 關聯鍵：
事件跟蹤的關聯鍵位於result.data.message.source.callId。
環境變量配置¶
插件依賴以下環境變量進行配置與調試：
AGPA_MCP_CMD：AGPA MCP 啓動命令（默認：npx -y -p @eiainano/agpa@0.1.10 agpa-mcp）。AGPA_AUTOTRACK=1：啓用自動事件跟蹤，每個規範化事件會啓動一個agpa-hook auto進程。AGPA_HOOK_CMD：覆蓋 ingest 命令（默認：npx -y -p @eiainano/agpa@0.1.10 agpa-hook auto）。AGPA_DEBUG=1：打印調試信息（MCP stderr、事件類型、規範化載荷）。DSH_AGENTS_HOME：技能根目錄（默認：~/.agents）。
適用場景與注意事項¶
- 運行環境：需要 Node.js 版本 >= 22。
- 當前狀態：Phase 1（工具外殼 + 橋接）和 Phase 2（自動事件跟蹤）已驗證並實現；Phase 3（可選的客戶端組件）尚未實現。
- 權限注意：插件以當前 DSH 進程的權限運行，安裝前請檢查源碼與許可證。
- Node 版本管理：Managed Node 運行時版本更新可能會影響全局安裝，需注意路徑配置。
總結¶
該插件通過橋接 AGPA 引擎，實現了 DSH 與其他智能體工具之間的成就數據互通，減少了重複開發。更多細節與源碼請訪問：GitHub。
