前言¶
在 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 插件頁。
