dsh-plugin-deep-scan
EN · Iterative GitHub deep search: four channels (exact phrase, broad match, README body, topic expansion), new keywords mined out of the previous round, and a diminishing-returns stop rule instead of a fixed page count. /deep-scan returns a ranked pool annotating which channel found each hit and which words matched. · Limits: the search API caps at 1,000 results per query; generic cross-industry words sink to the noisy channels.
DeepSeek Harness (dsh) 插件：GitHub 赛道深度扫描器。一条链路跑完"多词搜索 → 挖词 → 迭代 → 止损"，自动把一个口语化的赛道需求变成几百个候选仓库的精准榜单。
适合回答："这个赛道有哪些开源项目/竞品？我下一个产品该卡哪个位？哪个是漏网大鱼？"
同系列：price-aware · cost-ledger · relay-quota · transcript · transcript-search · obsidian-push · session-insights · eco-scan。
链路
词1|词2|词3
└─ 第1轮：每词 × 四通道并行搜索
短语(phrase) "词" 精确短语匹配 —— 精准度最高
泛搜(loose) 词 名字/简介/topic —— 按 star 排
正文(readme) 词 in:readme —— 挖简介没写但 README 详述的
赛道(topic) topic:x —— 从精准命中挖出的标签横扫
└─ 挖词：统计精准命中池的 topics 高频标签（滤掉 ai/llm 等噪声标签，
排除已搜过的词，出现≥2次才入选）
└─ 第2..N轮：用挖出的 topic:xxx 当新一轮搜索词，重复上述链路
└─ 止损：某轮新发现占比 < newKeepRatio(默认25%)，或挖不出新词 → 收
└─ 排序：通道精准度优先（短语>泛搜>正文>赛道），同通道按 star
└─ 深挖：Top N 仓库补 README 摘要，尾部附完整候选池（标注命中通道+词）
设计依据（AI 小说赛道实测）：泛词必被巨库淹没（搜"AI 小说"出来的是 LangChain）；精确短语一击命中真竞品；in:readme 捞回简介漏写的大鱼（AI_NovelGenerator 6.1k★ 靠"伏笔"命中）；第 3 轮起边际收益明显下降——所以默认 mineRounds: 2（最多 3 轮）。
用法
/deep-scan 写小说|网文|AI novel：多词用 | 分隔（含全角），上限 6 个deep_scan 工具（给 agent 用）：{ queries: "写小说|网文|AI novel", language?, minStars? }
搜索词要具体：给 2-4 个同义词/中英文变体。词内可带 GitHub 限定符（pushed:>2025-06-01）。
配置
| 字段 | 默认 | 说明 |
|---|
tokenEnv | [GITHUB_TOKEN, GH_TOKEN] | GitHub token（无 token 搜索限流 10 次/分，建议设置） |
perChannel | 30 | 每通道每词拉取条数 |
mineRounds | 2 | 首轮之后自动挖词迭代几轮 |
deep | 5 | 深挖（README 摘要）的仓库数 |
newKeepRatio | 0.25 | 一轮新发现占比低于此值 → 止损 |
已知边界
- 挖词只走 topics 标签（确定性可测），简介里的功能词（如"去AI味/拆文"）由 agent 看完报告后自行追加搜索——这是分工：插件负责可复现的链路，agent 负责语义跳转
- 跨行业通用词（审稿/续写/工作流）会漏噪声进池，但噪声沉在泛搜/正文通道底部，不动摇深挖区
- GitHub 搜索 API 上限 1000 条/查询，超大赛道建议加
minStars 收窄
安装
三步，实测于 @deepseek-ai/dsh@0.1.7-alpha.1（需 pnpm 在 PATH 上）：
# ① 装进 profile：dsh plugin 把参数原样转发给 pnpm，git 包会自动跑 prepare 构建 lib/
dsh plugin --profile web add github:121212165/dsh-plugin-deep-scan
② 把本仓库根目录 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 半都要重启才生效（客户端按 boot 时算出的内容 rev 下发，硬刷新浏览器没用）。
自检挂载：dsh --profile web --dump-config | grep dsh-plugin-deep-scan，应看到该条目。
