前言¶
DeepSeek Harness (DSH) 採用“一切皆插件”的架構,這意味着爲特定任務(如數學研究、數據分析、LaTeX 編輯)配置插件組合需要手動搜索、覈驗版本和安裝,流程繁瑣且容易出錯。
dsh-autocompose 插件用於解決這一問題。它根據任務描述自動搜索 npm 上的 DSH 插件,覈驗版本與兼容性,並自動完成安裝。在 DSH Desktop 中,它會打開一個獨立的 DSH 客戶端窗口供繼續對話;也可以將插件安裝到當前主環境,供後續任務複用。
安裝與啓用¶
當前版本適配 DSH 0.2.0-rc.2,要求 Node.js >=22.19。
在 DSH Desktop 的插件管理頁輸入包名安裝:
dsh-autocompose@0.5.0
或使用命令行:
dsh plugin --profile desktop add dsh-autocompose@0.5.0 --save-exact --ignore-scripts
Web 宿主用戶將 desktop 替換爲 web,安裝後刷新頁面或重啓,打開側邊欄的“自組裝”。
核心能力¶
任務感知與插件搜索¶
插件根據中文或英文任務描述搜索 npm。它主要檢索帶有 dsh-plugin 和 deepseek-harness 標籤的包。搜索關鍵詞、候選數量和排除原因會保存在方案中,便於後續查看和審計。
自動組裝與環境管理¶
組裝過程僅使用已有插件,不生成插件代碼。它支持兩種主要運行模式:
- 獨立窗口:在 DSH Desktop 中啓動新的客戶端實例,每個環境有獨立的插件目錄、會話和數據。適合需要持續對話的任務。
- 主環境安裝:將插件直接安裝到當前運行 AutoCompose 的 profile(Desktop 爲
desktop,Web 爲web),適合長期使用。
隔離執行與無模型開銷¶
生成方案和安裝插件的過程不調用模型。只有實際執行任務時纔會調用模型。獨立環境默認只讀任務目錄,主環境中的插件使用宿主權限。
使用方式¶
Web 界面操作¶
- 輸入任務描述和工作目錄。
- 選擇“自動組裝並打開客戶端”以啓動獨立窗口,或選擇“自動查找並安裝到主環境”。
- 在獨立窗口中繼續對話,或在主環境查看安裝結果。
命令行調用¶
在對話中直接調用工具:
調用 autocompose 的 assemble,爲數學研究自動查找兼容插件並安裝到當前環境。
調用 autocompose 的 assemble,destination 設爲 window,爲數學研究組裝一個可持續對話的獨立環境,直接打開 DSH 客戶端。
注意事項與常見問題¶
權限與隔離¶
插件聲明的權限僅用於展示和檢查,不是對第三方代碼的操作系統級隔離。臨時任務的“只讀”設置不限制主環境插件。
版本與兼容性¶
當前版本適配 DSH 0.2.0-rc.2。安裝公開的 AutoCompose 包不需要 npm Token。
常見錯誤¶
- ERR_PNPM_GIT_DEP_PREPARE_NOT_ALLOWED:通常來自固定到 0.2.0 的舊 Git 提交。建議使用 npm 包名或當前倉庫地址安裝。
- Failed to replace env in config: ${NPM_TOKEN}:這是 npm 配置變量提示,安裝公開包無需處理。
總結¶
dsh-autocompose 通過自動化的方案生成和安裝流程,簡化了 DSH 插件組合的搭建。它專注於組裝已有生態,通過獨立窗口或主環境安裝兩種模式,兼顧了臨時任務的隔離性與長期使用的便捷性。
更多細節請參考 GitHub 倉庫 或 SkillHub 目錄。