前言¶
在 DeepSeek Harness(DSH)裏做技術調研時,常見做法是臨時寫腳本、手動打開 GitHub 或各包管理站查信息,再把結果貼回對話。步驟分散,也容易撞上 API 限流。若希望智能體在一次會話裏直接查倉庫、Issue、發佈記錄、包依賴或社區討論,需要一套統一的只讀工具層。
下面介紹社區插件 dsh-github-intelligence(維護者 zoahdev)。它把 GitHub 及 16 個外部開發者生態的查詢能力打包進 DSH,當前版本註冊 201 個只讀工具,並內置限流友好的 TTL 緩存。
這是什麼¶
dsh-github-intelligence 是 DSH 的聯網工具類插件,定位爲「開發者情報」集成:覆蓋 GitHub、GitLab、Gitee、npm、PyPI、crates.io、Docker Hub、Hugging Face、Hacker News、Stack Overflow、Reddit、dev.to、RubyGems、NuGet、Go、ArXiv,以及 DSH 插件註冊表本身。公開接口無需 API Key;帶 Token 時可提高 GitHub 限額並啓用通知類工具。
插件以 MIT 許可證發佈,當前 npm 版本爲 2.10.0,在 GitHub 上約 10 stars。完整工具目錄見:https://zoahdev.github.io/dsh-github-intelligence/
核心功能¶
GitHub 側¶
README 列出的代表性工具如下:
| 工具名 | 作用 |
|---|---|
github_repo |
倉庫概覽:星標、Fork、Issue、語言、許可證、主題、默認分支等 |
github_releases |
近期 Release,含標籤、日期、預發佈標記 |
github_issues |
按狀態列出 Issue(自動排除 Pull Request) |
github_pulls |
按狀態列出 Pull Request 及合併狀態 |
github_contributors |
按提交數列出主要貢獻者 |
github_search |
按星標或最近更新搜索倉庫 |
github_repo_report |
一次性深度報告:概覽、最新 Release、開放 Issue、近期提交、主要貢獻者 |
github_compare |
兩個倉庫的並排對比及數值差 |
github_trending |
按星標排序的新建熱門倉庫(可選語言過濾) |
github_user_repos |
某用戶按星標排序的倉庫 |
github_weekly_digest |
可配置回溯窗口內的 Release、合併 PR、新 Issue、提交摘要 |
github_notifications |
需認證的維護者收件箱:@ 提及、Review 請求、指派、自己發起的線程等 |
github_repo_health |
帶證據的倉庫健康評分、風險項與改進建議(非安全審計) |
github_help |
列出其餘約 200 個工具的目錄,不確定用哪個時可先調用 |
多生態與通用能力¶
除 GitHub 外,同一安裝包還提供 GitLab、Gitee、npm、PyPI、crates.io、Docker Hub、Hugging Face、Hacker News、Stack Overflow、Reddit、dev.to、RubyGems、NuGet、Go、ArXiv 等生態的查詢工具,以及 DSH 註冊表統計。所有請求支持取消信號(exec.signal),響應默認走內存 TTL 緩存;組合型工具(如 github_repo_report)會複用子調用的緩存,減少重複 HTTP 請求。
v2.10.0 新增的兩個重點工具是 github_notifications 與 github_repo_health。前者把認證用戶的 GitHub 通知按類型分組;後者給出 100 分制的維護啓發式評分,並附證據與具體建議。
安裝與啓用¶
官方安裝命令如下。先在 DSH 中執行添加,再重啓 dsh web。
dsh plugin --profile web add dsh-github-intelligence
若直接使用上游 CLI,可用:
pnpm dlx @deepseek-ai/dsh plugin --profile web add dsh-github-intelligence
也可全局安裝獨立 CLI(工具目錄相同,供人工調試):
npm install -g dsh-github-intelligence
安裝後重啓 dsh web,在對話中讓智能體調用上述工具即可。README 註明在 dsh 0.1.0-rc.6、Node 24 / pnpm 11 環境下做過測試。
可選配置¶
在 cordis.yml 中可設置以下可選項:
| 配置項 | 類型 | 默認值 | 說明 |
|---|---|---|---|
githubToken |
string | 無 | GitHub Token,用於提高限額;具備通知讀權限時可啓用 github_notifications。勿提交到版本庫。 |
timeoutMs |
number | 10000 |
請求超時(毫秒) |
defaultLimit |
number | 5 |
模型未指定 limit 時的默認條數 |
bodyPreviewChars |
number | 500 |
Release 正文預覽最大字符數 |
cacheTtlMs |
number | 60000 |
內存緩存 TTL(毫秒) |
userAgent |
string | dsh-github-intelligence/2.10.0 |
發往 GitHub API 的 User-Agent |
典型用法¶
README 給出的示例提示詞可直接復現:
- “Give me a full report on
deepseek-ai/deepseek-harness.” - “What open issues does
ollama/ollamahave right now?” - “Who are the top contributors of
openai/openai-python?” - “Find the top 5 TypeScript agent frameworks and compare their stars.”
- “What needs my attention on GitHub right now?”
- “Audit the repository health of
owner/repoand tell me exactly what to fix.”
對應關係大致爲:倉庫深度報告、開放 Issue 查詢、貢獻者統計、跨倉庫對比、認證通知收件箱、倉庫健康審計。不確定工具名時,可先讓智能體調用 github_help 瀏覽完整目錄。
適用場景與注意¶
適合誰
- 需要在 DSH 對話中查開源倉庫狀態、Release、Issue/PR、貢獻者或跨平臺包信息的開發者。
- 維護多個 GitHub 倉庫、希望智能體彙總待處理通知或做倉庫健康自查的維護者。
- 做技術選型、依賴調研,希望一次安裝覆蓋多個開發者生態查詢的場景。
使用注意
- 插件以當前
dsh進程權限運行,安裝前建議閱讀源碼與 MIT 許可證,確認可接受其網絡訪問範圍。 - 公開工具雖無需 Key,但匿名訪問仍受各平臺限流約束;遇 429 時插件會返回可操作的錯誤信息。配置
githubToken可緩解 GitHub 側限額。 github_repo_health是維護啓發式評分,README 明確說明不是安全審計,不宜替代專門的安全掃描。- 部分來源對雲端 IP 有限制(如 README 提到 Reddit 可能攔截雲 IP,住宅網絡下更穩定)。
- DSH 插件目錄 SkillHub 是社區站點,與 DeepSeek / 幻方無官方從屬關係;插件列表與 GitHub 倉庫以維護者發佈爲準。
結尾¶
dsh-github-intelligence 把分散在多平臺的開發者情報查詢收斂爲一套只讀工具:廣度覆蓋 16 個外部生態與 GitHub 深度能力,組合報告與緩存設計面向限流場景。若你正在擴展 DSH 的聯網調研能力,可從目錄頁瞭解概況,再到 GitHub 查看安裝說明與完整工具表。
- 目錄頁:https://www.skillhub.cn/plugins/zoahdev/dsh-github-intelligence
- GitHub:https://github.com/zoahdev/dsh-github-intelligence
- 在線工具目錄:https://zoahdev.github.io/dsh-github-intelligence/