dsh-gh-search
> English · 中文
面向 DeepSeek Harness 的 GitHub issue/PR 搜索与查看工具,底层调用 GitHub CLI(gh)。
> ⚠️ 个人 / 非官方。 这是一个个人插件,移植自 oh-my-pi 的 gh-search / gh-view(经由 pi-gh 扩展)。它不是 DeepSeek 官方插件,也刻意不重复实现完整的 gh CLI——只为在 agent 会话里把"搜索 + 查看"这两个操作封装得顺手一些。
注册两个工具:
| 工具 | 作用 |
|---|---|
gh_search | 用 GitHub 搜索语法搜索 issues / PRs / commits / repos / code |
gh_view | 查看单个 issue / PR 详情(标题、状态、正文、作者、标签、评论) |
依赖
- 无第三方 npm 运行时依赖。 唯一的
peerDependencies(@deepseek-ai/dsh-tools、@deepseek-ai/cordis)由已加载本插件的 DSH 环境解析——无需额外安装任何东西。 - 系统依赖: 需要安装并登录 GitHub CLI(
gh):
winget install GitHub.cli
gh auth logingh 通过 GITHUB_TOKEN / GH_TOKEN 环境变量鉴权。本插件会从子进程环境里删掉这两个变量,让 gh 回退到存储的登录态(并尊重 PI_GH_TOKEN,若设置了则显式覆盖)。
工具
gh_search
query(string,必填)— GitHub 搜索语法,如repo:owner/name is:open label:bug。searchType(string)—issues\|prs\|commits\|repos\|code(默认issues)。limit(integer)— 结果数上限(默认 10,最大 50)。
gh_view
identifier(string,必填)— issue/PR 编号、owner/repo#N、或完整 URL。objectType(string)—issue\|pr(默认自动识别)。repo(string)—identifier用裸编号时指定owner/repo。includeComments(boolean)— 是否包含评论(默认 true)。
安装
已在 web profile 中接入为 file:./plugins/dsh-gh-search(dsh.profile.bundles + dependencies)。全新 profile 重新安装:
dsh plugin --profile web install若添加到已运行的 profile,需要一次 dsh web 重启才能加载(之后可用 dsh-reload 的 /reload dsh-gh-search 热挂载新改动,无需重启)。
许可证
MIT —— 移植自 pi-gh(MIT,© ASUS),其灵感来自 oh-my-pi 的 gh-search / gh-view(MIT,© Mario Zechner, Can Bölük)。原始版权声明保留在 [LICENSE](LICENSE)。