dsh-repo-setup
English | 简体中文
仓库体检引导插件 —— Anthropic claude-code-setup 的 DeepSeek Harness 版。
注册一个只读工具 repo_setup_scan:扫描项目目录的语言栈、测试设置、 文档、git、Docker 与数据库线索,然后给出设置建议:该装哪些 DSH 技能插件、 该挂哪些 MCP 服务器、该补哪些卫生文件。绝不修改任何东西。
安装
支持的 DSH 版本：>=0.1.1-rc.2（已在上线版本验证，兼容更高版本）。
# npm
dsh plugin --profile web add dsh-repo-setup
# GitHub
dsh plugin --profile web add github:gongyijie85/dsh-repo-setup
# 本地开发
dsh plugin --profile web add D:\plugins\dsh-repo-setup装完重启 profile(dsh web),模型会在进入新/陌生仓库时自动调用 repo_setup_scan(也可在对话里直接要求"扫描这个仓库怎么配置")。
工具:repo_setup_scan
| 参数 | 说明 |
|---|---|
path | 要扫描的项目目录;缺省为当前工作目录 |
输出 Markdown 报告:
- Detected stack — package.json / pyproject.toml / Cargo.toml / go.mod /
Dockerfile 等标记识别的技术栈(含前端框架与测试运行器探测)
- Repo hygiene — AGENTS.md 缺失、git 未初始化、无测试、数据库线索
- Recommended installs — 一键命令:
mattpocock-skills-dsh(grilling/to-spec/to-tickets/tdd/code-review 工作流)mattpocock-skills-dsh-zh(中文技能版,与英文版二选一)superpowers-dsh(规划→TDD→评审方法论)dsh-ponytail-skills(防过度工程)dsh-ecc-skills(ECC 273 技能:模式/编排/垂直领域)dsh-claude-mem(可选:跨会话记忆)dsh-mcp-manager(挂载下方 MCP 用)- MCP:context7(库文档)、playwright(前端)、postgres、github(按检测结果)
工作原理
- Bundle 层 ——
cordis.patch.yml在 dsh-base 层插入插件行。 - 工具 ——
lib/index.js用@deepseek-ai/dsh-tools的defineTool注册
repo_setup_scan,只读探测(读有限个已知文件 + 顶层目录列表),不做任何写入。
- 零运行时依赖 —— 除 harness 注入的
@deepseek-ai/dsh-toolspeer 依赖外
只用 Node 内置模块。
开发验证
node --check lib/index.js
# 功能冒烟(伪 ctx 注册 + 直接调 scanRepo 逻辑见 scripts/verify-tool.mjs)
node scripts/verify-tool.mjs许可证
MIT。见 LICENSE。
