前言¶
在 DeepSeek Harness（DSH）里做竞品或开源生态调研时，常见做法是手动在 GitHub 上换关键词、翻几页结果，再凭印象拼一份名单。泛词容易被大库淹没，简介里没写清楚但 README 里详述的项目也容易漏掉。下面介绍维护者 121212165 的联网工具插件 dsh-plugin-deep-scan：用一条可复现的链路，把口语化的赛道需求变成带通道标注的候选仓库榜单。
这是什么¶
dsh-plugin-deep-scan 是 DSH 插件，定位为「GitHub 赛道深度扫描器」。它把「多词搜索 → 从命中结果挖词 → 迭代 → 边际收益止损」串成固定流程，适合回答：某个赛道有哪些开源项目或竞品、产品该卡哪个位、有没有漏网的大仓库。
插件在 SkillHub 目录 归类为联网工具；源码与说明见 GitHub 仓库。当前 package 版本为 0.1.0，许可证 MIT，运行需 Node >= 22.18。
核心链路¶
用户或 agent 给出若干搜索词（建议 2–4 个同义词或中英文变体，词内可带 GitHub 限定符如 pushed:>2025-06-01）。插件按轮次执行：
- 首轮（每词 × 四通道并行）
- 短语（phrase）："词"精确短语，精准度最高。
- 泛搜（loose）：词匹配名字、简介、topic，按 star 排序。
- 正文（readme）：词 in:readme，捞简介未写但 README 详述的仓库。
- 赛道（topic）：topic:x，从精准命中里扩展标签横扫。 - 挖词：统计精准命中池里 topics 的高频标签（过滤 ai/llm 等噪声、排除已搜词，出现 ≥2 次才入选）。
- 第 2..N 轮：用挖出的
topic:xxx作为新搜索词，重复上述链路。 - 止损：某轮新发现占比低于
newKeepRatio（默认 25%），或挖不出新词则结束；默认mineRounds: 2（首轮之后最多再迭代 2 轮，即合计最多 3 轮）。 - 排序与输出：通道优先级为短语 > 泛搜 > 正文 > 赛道，同通道按 star；对 Top N 仓库补 README 摘要，并附完整候选池，标注命中通道与匹配词。
/deep-scan 返回的是排序后的候选池，而不是固定页数的原始列表。GitHub Search API 单次查询上限为 1000 条；跨行业通用词会进入噪声较多的通道，但设计上噪声会沉在泛搜/正文底部，不影响深挖区排序。
安装与启用¶
安装步骤在 README 中写明，实测环境为 @deepseek-ai/dsh@0.1.7-alpha.1，且需 pnpm 在 PATH 中。
① 安装到 profile
dsh plugin --profile web add github:121212165/dsh-plugin-deep-scan
dsh plugin 会把参数转发给 pnpm；git 包会自动执行 prepare 构建 lib/。
② 合并 cordis 补丁
将仓库根目录 cordis.patch.yml 的内容合并进 $DSH_HOME/profiles/web/cordis.patch.yml。默认文件为 []，应整份替换或把 insert 条目并进同一数组；不要直接追加，否则会出现两个 YAML 文档，启动报错 failed to parse overlay ... end of the stream or a document separator is expected。
③ 重启 DSH
配置层与 client 均需重启后生效；浏览器硬刷新不足以加载新 rev。
自检：
dsh --profile web --dump-config | grep dsh-plugin-deep-scan
应能看到该插件条目。
插件在 当前 dsh 进程权限 下运行，安装前请自行查看源码与 MIT 许可证，并妥善配置 GitHub token（见下节）。
配置项¶
| 字段 | 默认 | 说明 |
|---|---|---|
tokenEnv |
[GITHUB_TOKEN, GH_TOKEN] |
GitHub token；无 token 时搜索约 10 次/分钟，建议设置 |
perChannel |
30 |
每通道每词拉取条数 |
mineRounds |
2 |
首轮之后自动挖词迭代轮数 |
deep |
5 |
深挖（README 摘要）的仓库数 |
newKeepRatio |
0.25 |
一轮新发现占比低于此值则止损 |
典型用法¶
斜杠命令（多词用 | 分隔，支持全角 ｜，上限 6 个）：
/deep-scan 写小说|网文|AI novel
Agent 工具 deep_scan：
{ "queries": "写小说|网文|AI novel", "language": "...", "minStars": 0 }
language、minStars 为可选；超大赛道可用 minStars 收窄结果。
搜索词宜具体，避免过泛的行业词（如单独「审稿 / 续写 / 工作流」）主导噪声通道。挖词仅基于 topics 标签；简介里的功能词需 agent 阅读报告后自行追加搜索——插件负责可复现链路，语义跳转由 agent 完成。
适用场景与注意¶
适合：需要在 GitHub 上系统扫某一细分赛道、做开源竞品清单或发现「简介漏写但 README 很厚」仓库的 DSH 用户与智能体工作流。
边界（README 已说明）：
- 无 token 限流明显；有 token 仍受 API 1000 条/查询上限约束。
- 跨行业通用词会带进部分噪声，但排序会把高精准通道与 star 前置。
- 社区目录 SkillHub 为独立站点，与 DeepSeek / 幻方无官方从属关系；DSH 生态理念是「一切皆插件」，本插件属于 121212165 的 dsh 插件家族之一。
结尾¶
dsh-plugin-deep-scan 把 GitHub 多通道搜索、topic 挖词迭代和边际止损写进一条 /deep-scan 链路，输出带通道与匹配词标注的榜单，便于在 agent 对话里做赛道级仓库发现。安装命令与补丁合并方式以仓库 README 为准；进一步细节与 issue 见 GitHub：121212165/dsh-plugin-deep-scan，目录入口见 SkillHub 插件页。
