dsh-github-bot

dsh-github-bot

让 agent 直接处理 GitHub 的 PR、审查、issue 与 CI——每个写操作都必须先拿到人类批准，token 永不落日志。

面向 DeepSeek Harness 的 GitHub 集成插件：创建、审查、合并与搜索 PR，读写 issue，附带 CI 复合动作、轮询式审查机器人与状态检查门禁。

[安装](#三步上手) · [配置](#配置) · [FAQ](#faq) · [简体中文](README.md) · [English](README.en.md) · [Español](README.es.md) · [Português](README.pt.md) · [हिन्दी](README.hi.md)

dsh plugin --profile  add dsh-github-bot

社区插件，与 DeepSeek 官方无关。唯一仓库：（Gitee 为镜像）。原名 @perrylink/dsh-github，旧 scoped 包已弃用。

它是什么

dsh-github-bot 把 GitHub 接进 agent 的完整回路：读操作（仓库元数据、文件、PR diff、评论、CI 检查、issue/PR 搜索）直接可用；写操作（创建/更新/合并 PR、发布审查、开/评论/关 issue、跑 CI 审查）一律经 ctx.approval——默认 ask，没有应答者就拒绝。GitHub token 逐操作从凭证接缝解析，只出现在 Authorization 头里，不进日志、渲染、事件或错误。审查引擎默认是确定性静态分析器，零 token、可复现；要模型审查时 reviewMode: "model" 走宿主的 subagents 接缝。仓库另附 CI 复合动作、轮询式审查机器人与状态检查门禁，让同一套判定在 CI 里也成立。

结构：信任边界双侧 —— 读通道直穿到 api.github.com；写通道停在竖立的 tools/pre-execute 闸门上，allowedActions 先否决，CI driver 经 ci.autoApprove 放行，其余 ask 交给 ctx.approval，无应答者即拒绝；后台审查 job 与 CI 支线都从下方回到同一道闸。

目录

• [它是什么](#它是什么)
• [三步上手](#三步上手)
• [核心能力](#核心能力)
• [配置](#配置)
• [FAQ](#faq)
• [安全边界](#安全边界)
• [权限与数据](#权限与数据)
• [已知限制](#已知限制)
• [与其他 DSH 插件的互操作性](#与其他-dsh-插件的互操作性)
• [兼容性](#兼容性)
• [生态与质量](#生态与质量)
• [开发](#开发)
• [家族与致谢](#家族与致谢)
• [License](#license)

三步上手

1. 安装（三选一）：

   # git 通道（最新 main；等价于 git+https://github.com/PerryLink/dsh-github-bot.git）
   dsh plugin --profile web add github:PerryLink/dsh-github-bot
   # npm 通道（已发布版本）
   dsh plugin --profile web add dsh-github-bot
   # tarball 通道：本仓库 pnpm pack 后
   dsh plugin --profile web add ./dsh-github-bot-.tgz

git 通道的 prepare 脚本只以生产依赖构建；安装后无需再手动 build。

> npm 包名是 dsh-github-bot；裸名 dsh-github 属于另一个无关项目，装它不会装到本插件。

2. 配置 token（三选一；tokenSource: auto 按 credentials → env → gh 的顺序解析）：

   # 推荐：写进 dsh 凭证文件（$DSH_HOME/.credentials.yaml），键名与 tokenRef 一致
   # 或：同名环境变量
   export GITHUB_TOKEN=ghp_…
   # 或：gh CLI 已登录
   gh auth login

3. 验证已挂载：

   dsh --profile web --dump-config | grep -A3 'id: dsh-github-bot'

卸载：dsh plugin --profile web remove dsh-github-bot（或从 profile patch 删掉该行）。

核心能力

dsh-github-bot 补上 dsh 与 Claude Code、Codex 等工具之间的 GitHub 空白：agent 能读取、审查、打开、更新与合并 pull request，读取仓库元数据与文件，评论与关闭 issue，以及搜索——同时每个写操作都由人类审批，token 全程保密。

• 15 个工具 —— pr_create、pr_merge、pr_update、gh_review、review_post、gh_issue、issue_open、issue_comment、issue_close、gh_search、gh_repo、gh_file、gh_repo_search、gh_checks，全部经 defineTool 返回规范 JSON；ci.enabled 打开时再加一次性 ci_run。
• 4 族命令 —— /pr create、/review（start/stop/post）、/issue open，以及仅在 ci.enabled 时注册的 /ci（scan/status/start/stop/run ）。
• 完整 PR 生命周期 —— 创建 → 审查 → 更新（标题/正文/状态/目标分支）→ 合并（merge/squash/rebase，可选合并后删源分支）。
• 行级审查 —— review_post 可发布单条汇总评论，或按行锚定 PR head commit 的行级审查评论。
• 写操作审批 —— 每个 GitHub 写操作都经 ctx.approval（默认 ask，fail-closed）；审批理由预览标题、正文长度与评论覆盖内容。
• token 保密 —— 凭证接缝 → 环境变量 → gh CLI，逐操作解析，绝不进日志、事件、渲染或错误。
• 后台审查 job —— /review 跑在 ctx.jobs 上，复用宿主自带的 job_list / job_output / job_kill 工具面。
• 韧性 —— 按 Retry-After/x-ratelimit-reset 退避重试 429；读工具并发安全；所有调用尊重取消信号。
• CI 界面 —— 一次性 ci_run 工具、轮询式审查机器人与状态检查门禁（复合动作 action.yml）。

命令与工具面

| 表面 | 类型 | 说明 |

|---|---|---|

| pr_create | 工具 | 创建 pull request（写；审批门控） |

| pr_merge | 工具 | 合并 PR（merge/squash/rebase，可选删源分支） |

| pr_update | 工具 | 更新 PR（标题/正文/状态/目标分支） |

| gh_review | 工具 | 读取 PR：元数据、截断 diff、评论、CI、静态发现 |

| review_post | 工具 | 发布审查评论（汇总或行级锚定） |

| gh_issue | 工具 | 列出 / 获取 / 评论 issue（PR 标记为 kind: "pr"） |

| issue_open | 工具 | 创建 issue |

| issue_comment | 工具 | 评论 issue 或 PR |

| issue_close | 工具 | 关闭 issue（可选关闭原因） |

| gh_search | 工具 | 搜索 issue 与 PR（独立搜索配额） |

| gh_repo | 工具 | 读取仓库元数据 |

| gh_file | 工具 | 按分支/tag/commit 读取单个文件 |

| gh_repo_search | 工具 | GraphQL 仓库搜索（独立搜索配额） |

| gh_checks | 工具 | GraphQL PR 状态检查（check runs + commit statuses） |

| /pr create | 命令 | 读取 git 状态并排队一条 pr_create 指令 |

| /review | 命令 | 启动 / 停止 / 发布后台审查 job |