只读仓库体检引导工具(repo_setup_scan):识别技术栈/测试/文档/git/数据库线索,给出插件、MCP 与卫生文件的安装建议。
安装
# npm 包(预构建)
dsh plugin --profile web add dsh-repo-setup
# GitHub 源码(首次需按提示配置 allowBuilds 构建授权后重试)
dsh plugin --profile web add github:gongyijie85/dsh-repo-setup
装任何插件都等于在你的机器上跑第三方代码,权限和你本人一样大——能读你的文件、用你的凭据、访问网络,工具审批管不到它。GitHub 来源的插件还会在安装时执行构建脚本——pnpm 默认拦截,所以安装可能停在 ERR_PNPM_GIT_DEP_PREPARE_NOT_ALLOWED 或 ERR_PNPM_IGNORED_BUILDS;dsh 会打印出需要添加的确切键名,把它加进该 profile 的 pnpm-workspace.yaml 的 allowBuilds 下,重跑一次即可装上。放行构建本身就是一次信任判断:请只安装可信来源,并尽量锁定 commit(github:owner/repo#sha)。
README
English | 简体中文
仓库体检引导插件 —— Anthropic claude-code-setup 的 DeepSeek Harness 版。
注册一个只读工具 repo_setup_scan:扫描项目目录的语言栈、测试设置、
文档、git、Docker 与数据库线索,然后给出设置建议:该装哪些 DSH 技能插件、
该挂哪些 MCP 服务器、该补哪些卫生文件。绝不修改任何东西。
安装
支持的 DSH 版本:>=0.1.0-rc.6(已在上线版本验证,兼容更高版本)。
# 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。
链接
同类插件
Tencent/WeKnora#dsh-weknora★ 31292
把 WeKnora 知识库接入 dsh 的四个只读工具:列出知识库、混合检索原文片段、按顺序还原单篇文档,以及直接取用 WeKnora 自己带引用的 RAG 或 ReAct agent 回答(含可续聊的 session id)。
superdesigndev/treg★ 3854
给 Agent 的工具目录:按「要做的事」检索约 2,600 个外部接口(SEO 与 SERP、外链、社交、人物与公司信息补全、广告库、抓取),查看参数与单次调用价格后直接调用,凭据由服务端注入。附带技能,MCP 行在未设置 TREG_TOKEN 前保持禁用。
TencentCloudBase/CloudBase-AI-Toolkit#dsh-plugin★ 1128
把腾讯云 CloudBase 后端接入 DeepSeek Harness——在对话里搭好并部署全栈应用,查询结果渲染为表格卡片(分页、排序、导出 CSV),部署后可预览真实域名,并提供 CloudBase MCP 工具集(`mcp__cloudbase__*`),登录走 device-code 流程。
gitroomhq/postiz-agent#dsh-postiz★ 499
通过 MCP 将 DeepSeek Harness 连接到 Postiz:列出已连接的社交媒体渠道、获取各平台发帖规则,并向 X、LinkedIn、Instagram、Facebook、Threads、TikTok、YouTube、Reddit、Bluesky、Mastodon、Discord、Slack、Telegram 等平台排期、存草稿或发布帖子;附带 postiz 工作流技能。
EthanYoQ/Invoice-Downloader#dsh-invoice-downloader★ 474
面向 DeepSeek Harness 的本地 IMAP 发票下载、OCR 识别、归档与 Excel 报销汇总。
anysearch-team/anysearch-dsh★ 438
基于 AnySearch 的实时网页与垂直搜索插件,为 DeepSeek Harness 提供搜索工具。
社区评论
评论公开保存在 GitHub Discussions。加载评论会连接 GitHub 和 Giscus;发表内容需要 GitHub 账号。