在 DeepSeek Harness (DSH) 中进行代码审查时,核心问题往往是管理 PR 队列。GitHub 原生界面无法明确告诉你:“作者在你提出修改意见后刚刚推送了新提交,现在又该你出手了”。dsh-pr-board 是一个维护者 PR 看板插件,它将你参与的每个 PR 归入五种状态,并检测 PR 回到你手上的时刻。
安装¶
在终端中执行以下命令安装插件。安装完成后,重启 web profile 并刷新页面即可使用。
dsh plugin --profile web add github:delock/dsh-pr-board
核心功能¶
五种状态跟踪¶
插件将 PR 划分为五种状态,帮助你快速定位需要处理的任务:
- 等我行动:你请求了审查但尚未发表实质性评论;或在你上次行动后作者推送了新代码/回复;或在你批准后新提交 landed。
- 等作者行动:你或其他人请求了修改意见,且作者保持沉默;或你已批准但 PR 为草稿或存在冲突。
- 可合并:
reviewDecision = APPROVED,PR 可合并且非草稿(或在合并队列中,或自动合并已就绪)。 - 已合并:最近合并的 PR(你曾参与审查)。
- 新 PR 待分诊:最新的、未被领取的 Open PR。
Issue 看板¶
每个被监控的仓库会在侧边栏增加一行缩进的计数器(iss 标签)。点击该行可打开 Issue 看板,包含三列:
* 等我行动:报告者在你评论后回复,或你被分配/提及但无动作。
* 等报告者:你发表了最后一条评论。
* 最近关闭:14 天内关闭的 Issue(用于回归观察)。
* 注:只有报告者的回复会将线程拉回“等我”;第三方评论不会。
交互与通知¶
- 侧边栏计数器与全屏看板:侧边栏实时显示各仓库的 PR 状态计数。点击侧边栏底部的 PR Board 小部件(或按
Alt+P)可进入全屏看板。 - 轮询与提醒:插件通过轮询保持看板数据更新(间隔 1-30 分钟可配置)。当 PR 从“等作者”切换回“等我”(作者回复或重新请求审查)时,你会收到 Toast 提醒,且侧边栏小部件会闪烁。
配置与使用¶
添加仓库¶
首次打开看板或点击小部件头部的 + 按钮,输入 owner/name 格式添加仓库。看板标签栏支持通过 + 按钮添加更多仓库,鼠标悬停在标签上可点击 × 停止监控。
账号与会话¶
- GitHub 用户名:在设置中填写 GitHub 用户名。留空则自动使用
gh登录账号。 - Review Workspace:在设置中为每个仓库配置 Review Workspace。设置后,点击 PR 卡片会直接在 DSH 中打开或创建对应的对话会话(通过本地 PR→会话绑定表或标题搜索
repo#N匹配);未设置或通过卡片上的↗按钮则跳转至 GitHub。 - 配置共享:账号级配置(仓库列表、用户名、Workspace、自动 Prompt 等)会同步到宿主机 (
~/.dsh/pr-board.config.json),实现跨设备共享。
依赖与隐私¶
- 依赖:宿主机需安装并登录 GitHub CLI (
gh)。插件通过gh的 Search 和 GraphQL 查询获取数据,遵循ghtoken 的速率限制。 - 隐私:所有查询在本地通过
ghCLI 执行,无第三方服务或遥测,数据仅通过 GitHub API 传输。
许可¶
MIT