前言¶
在 DSH 的插件化工作流中，進入一個陌生倉庫後，常見的第一步是判斷項目語言棧、測試設置、文檔、git、Docker 與數據庫線索，再決定後續需要哪些 DSH 技能插件、MCP 服務器和衛生文件。dsh-repo-setup 是 gongyijie85 維護的 DSH 插件，定位是“倉庫體檢引導插件”，也是 Anthropic claude-code-setup 的 DeepSeek Harness 版。它註冊一個只讀工具 repo_setup_scan，在項目目錄中做只讀探測，輸出 Markdown 報告與建議，不修改任何內容。
這是什麼¶
dsh-repo-setup 是一個 DSH 插件。它解決的問題是：在開始修改倉庫前，先快速拿到一份基於倉庫現狀的設置建議。插件會給出應安裝的 DSH 技能插件、MCP 服務器與應補的衛生文件建議，但本身只負責掃描與報告，不執行安裝，也不寫入倉庫。
核心功能¶
1、註冊一個只讀工具 repo_setup_scan。
2、掃描項目目錄的語言棧、測試設置、文檔、git、Docker 與數據庫線索。
3、輸出 Markdown 報告，報告包含 Detected stack、Repo hygiene 與 Recommended installs。
4、給出應安裝的 DSH 技能插件、MCP 服務器與應補的衛生文件建議。
5、保持只讀探測，絕不修改任何內容。
安裝與啓用¶
README 聲明支持的 DSH 版本爲 >=0.1.1-rc.2，並說明已在上線版本驗證，兼容更高版本。
使用 npm 安裝命令：
dsh plugin --profile web add dsh-repo-setup
安裝後需要重啓 profile：
dsh web
工具參數¶
repo_setup_scan 提供一個 path 參數，用於指定要掃描的項目目錄；缺省爲當前工作目錄。
典型用法¶
安裝並重啓 profile 後，模型會在進入新/陌生倉庫時自動調用 repo_setup_scan。也可以在對話裏直接要求：
掃描這個倉庫怎麼配置
如果希望只針對某個目錄，可以要求模型將 path 參數指向該目錄。
本地驗證¶
在本地驗證時，可以先做語法檢查：
node --check lib/index.js
再跑一次功能冒煙：
node scripts/verify-tool.mjs
依賴與許可證¶
該插件採用 MIT 許可證。
README 說明零運行時依賴：除 harness 注入的 @deepseek-ai/dsh-tools peer 依賴外只用 Node 內置模塊。package.json 同時聲明 peerDependencies：
{
"@deepseek-ai/dsh-tools": ">=0.0.1-rc.1 <0.2.0",
"@deepseek-ai/cordis": "^4.0.1"
}
適用場景與注意¶
它適合希望在 DSH 中先做倉庫體檢、再決定是否安裝其他插件或 MCP 服務器的場景。需要注意的是，DSH 插件會隨當前 dsh 進程權限運行；即使是隻讀掃描插件，安裝前也應檢查源碼、許可證與版本要求。
鏈接¶
目錄頁（來自插件線索）：
https://www.skillhub.cn/plugins/gongyijie85/dsh-repo-setup
