DeepSeek Harness (DSH) 的插件化架構允許用戶通過插件擴展功能。對於智能體開發者而言,實驗性預設(如 dsh-anchored-standard)提供了不同的行爲模板,但手動複製目錄到預設根目錄既繁瑣又容易出錯。dsh-anchored-preset-installer 插件通過自動將實驗性預設材料化到用戶預設根目錄,省去了手動 cp 的步驟。
插件定位¶
dsh-anchored-preset-installer 是一個 DSH 插件,旨在提供一鍵交付 dsh-anchored-standard 實驗性預設的能力。它由維護者 kirkchinese 開發,許可證爲 MIT。
核心功能¶
- 預設目錄寫入:將預設目錄寫入用戶預設根目錄(通常爲
$DSH_HOME/.agent-presets)。 - 預設選項展示:在會話的預設選擇器中顯示預設選項。
- 純淨運行:無網絡請求、無遙測、無運行時監聽;應用後插件處於惰性狀態。
安裝與啓用¶
使用官方命令安裝:
dsh plugin --profile web add -w github:kirkchinese/dsh-anchored-preset-installer
如果沒有全局 dsh 二進制文件,可以使用 npx 執行:
npx @deepseek-ai/dsh plugin --profile web add -w github:kirkchinese/dsh-anchored-preset-installer
安裝完成後,重啓 DeepSeek Harness(先按 Ctrl+C,然後執行 dsh web 或 npx @deepseek-ai/dsh web)。
典型用法¶
- 選擇預設:重啓後,創建一個空白會話。在會話預設選擇器中,選擇「Anchored Standard (experimental)」、「Zero-Anchored Standard (experimental)」或「Whoami Standard (experimental)」。
- 驗證安裝:在終端執行以下命令驗證插件是否生效:
npx @deepseek-ai/dsh --profile web --dump-config | grep -A2 anchored-preset-installer
在重啓前,該命令應返回包含 `id: anchored-preset-installer` 的行。重啓後,預設選擇器應列出所有三個預設,且目錄中包含標記文件。
適用場景與注意¶
- 目錄限制:插件僅寫入用戶信任的預設根目錄(通常爲
$DSH_HOME/.agent-presets),不會寫入其他位置。 - Create-only 機制:如果預設目錄已存在,插件會跳過創建,保留用戶現有的編輯。預設目錄被創建後,用戶對其的修改不會被覆蓋。
- 故障隔離:每個預設的失敗會被隔離並記錄,插件行不會導致配置文件啓動失敗。
- 維護與源碼:預設文件是上游倉庫的複製版本,用戶在應用插件後,插件本身不再產生網絡請求或運行時監聽。
該插件簡化了實驗性預設的部署流程。源代碼與文檔可在 GitHub 上獲取。