前言¶
在 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
