dsh-github

把 GitHub 接入 DeepSeek Harness。

创建 PR · 后台审查 PR · 读取 issue —— 每个写操作都经人类审批，token 永不离开凭证层。

=24">

dsh-github 是 DeepSeek Harness（dsh，"一切皆插件"的 agent 框架）的 bundle 插件。它填补了 dsh 相对 Claude Code（gh claude / claude-code-action）与 Codex（@codex review / Autofix CI）的 GitHub 集成空白：agent 能看 PR、审 PR、开 PR——写操作由人类审批，token 全程保密。

🛠 5 个工具 —— pr_create · gh_review · gh_issue · review_post · issue_open，全部经 defineTool 返回规范 JSON
⌨️ 3 族命令 —— /pr create · /review（启动/停止/发布）· /issue open
🔒 写操作审批 —— 每个 GitHub 写操作都经 ctx.approval（默认 ask，fail-closed）
🗝 token 保密 —— credentials seam → 环境变量 → gh CLI 三级解析，逐操作执行，绝不进日志/事件/渲染/错误
⏱ 后台审查 job —— /review 跑在上，复用宿主自带 / / 工具面

领域	你能得到什么
创建 PR	`/pr create [标题]` 读取 git 状态（分支、变更文件、未推送提交），把草稿交给 agent；`pr_create` 创建 PR 并返回 URL
审查 PR	`gh_review` 汇总元数据、截断 diff、评论、CI 状态与静态发现；`/review` 跑完整后台 job
发布审查	`/review post` 发布 job 草拟的评论——经人类审批后
读取 issue	`gh_issue` 支持 list / get / comments；`issue_open` 创建（审批门控）
审批	`tools/pre-execute` 对每个写操作向 `ctx.approval` 发起 `ask`；`allowedActions` 白名单在询问前拒绝
密钥安全	token 只存在于凭证层与 Authorization 头；专项测试断言它不出现在任何可见输出中
韧性	按 `Retry-After`/`x-ratelimit-reset` 退避重试 429；读工具并发安全；所有调用尊重取消信号
可观测	模型可见 ⟺ 已记录：模型看到的一切都经宿主自有会话事件（`tool/result`、`user/message`、`command/run`、`approval/asked`…）

通道	命令	说明
npm tarball	`dsh plugin --profile add ./dsh-github-0.1.0.tgz`	自带构建好的 `lib/`——无需构建许可
git 源	`dsh plugin --profile add "github:PerryLink/dsh-github#"`	需 `prepare` + `allowBuilds`（见下）；请钉住 commit
本地 link	`pnpm link --dir .` 后 `dsh plugin add dsh-github`	开发用

键	默认值	含义
`tokenSource`	`auto`	`auto`（credentials → env → gh）或指定 `credentials` / `env` / `gh`
`tokenRef`	`GITHUB_TOKEN`	credentials seam 引用名 / 环境变量名
`defaultOwnerRepo`	—	调用未指定且 git 无 origin 时的兜底 `owner/repo`
`autoCommit`	`false`	`/pr create` 是否允许指示模型先 commit+push
`maxDiffChars`	`8000`	审查读取 PR diff 的上限
`maxComments`	`20`	`gh_review` 列出 PR 评论的上限
`reviewJobTimeoutMs`	`600000`	单个后台审查 job 的截止时间（超时以 `timeout` 失败）
`maxRetries`	`3`	单请求的 429 重试次数
`retryBaseMs`	`500`	重试退避基数（逐次翻倍）
`retryMaxWaitMs`	`60000`	重试退避上限
`apiBaseUrl`	`https://api.github.com`	GitHub REST 基地址（GitHub Enterprise）
`allowedActions`	`['pr.create','review.post','issue.create']`	写动作白名单；名单外直接拒绝
`workspaceDir`	进程 cwd	只读 git 检查的工作目录

命令	效果
`/pr create [标题]`	读取 git 状态并为模型排队 `pr_create` 指令（描述草稿、默认值；除非 `autoCommit`，否则不 commit/push）。创建 PR 需审批。
`/review
`	启动后台审查 job 并打印 job id；完成后宿主会通知，用 `job_output` 读取。
`/review stop`	取消 job（本地控制，非 GitHub 写操作）。
`/review post`	为模型排队 `review_post` 指令；发布需审批。
`/issue open`	为模型排队 `issue_open` 指令；创建需审批。

dsh-github

安装

说明文档

📚 目录

🚀 快速上手

✨ 特性

📦 安装

⚙️ 配置

🛠 工具

⌨️ 命令

🏗 架构

🔒 安全边界

⚠️ 已知局限

🧪 开发

🗂 目录结构

🏷 Topics

许可证

工具	类型	参数	返回
`pr_create`	写	`title*`、`body?`、`base?`、`head?`、`draft?`、`ownerRepo?`	`{status:'created', url, number, title, state, draft, base, head}` 或结构化错误
`gh_review`	读	`pr*`（数字 / `#n` / `o/r#n` / URL）、`fields?`、`maxDiffChars?`	元数据、截断 diff + 摘要 + 逐文件统计、评论、CI、静态发现、配额
`gh_issue`	读	`action*`（`list`/`get`/`comments`）、`ownerRepo?`、`issueNumber?`、`state?`、`limit?`	归一化 issue 列表 + 配额
`review_post`	写	`jobId*`	`{status:'posted', url, commentId, findings}` 或结构化错误
`issue_open`	写	`title*`、`body?`、`labels?`、`ownerRepo?`	`{status:'created', url, number, title}` 或结构化错误