前言¶
在 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/