delock/dsh-pr-board

dsh-pr-board

为 DeepSeek Harness（DSH）打造的维护者 PR 审查队列看板。
它回答一个问题：现在哪些 PR 在等我？

一个为 DeepSeek Harness 做的维护者 PR 看板：回答一个问题——现在哪些 PR 在等我？

Why / 解决什么问题

审查 PR 本质是队列管理。GitHub 原生界面无法直接告诉你：
"作者刚在你 request changes 之后推了新提交——又该你出手了"。
本看板把你参与的每个 PR 归入五种状态，并在 PR 回到你手上的一刻检测到。

Review PR 本质是队列管理。GitHub 原生界面无法直接告诉你"作者刚在你 request changes
之后推了新提交，又该你出手了"。本插件把你参与的每个 PR 归入五种状态，并在 PR
回到你手上的一刻提醒你。

The five states / 五种状态

| Column / 列 | Meaning / 含义 | How it's decided / 判定依据 |
| --- | --- | --- |
| Waiting on me 等我行动 | Your move / 该你出手 | Review requested; or the author pushed/replied after your last review; or new commits landed after your approval |
| Waiting on author 等作者行动 | Their move / 等作者 | You (or another maintainer) requested changes and the author has been quiet since; approved but draft or conflicting |
| Ready to merge 可合并 | Green light / 绿灯 | reviewDecision = APPROVED, mergeable, not draft — or in a merge queue, or auto-merge armed with nothing blocking (blocked auto-merge waits on the author) |
| Merged 已合并 | Done / 完成 | Recently merged PRs you reviewed |
| Inbox 新 PR 待分诊 | New & unclaimed | Newest open PRs you haven't touched — one click ("我来 review") adds you as reviewer |

状态迁移检测：当 PR 从作者 → 你（作者回复，或重新 request 你 review）时，
你会收到 toast 提醒，侧边栏小部件闪烁。
状态轮询保持看板新鲜（间隔可配置：1–30 分钟）。

Issue board / Issue 看板

每个被监控的仓库在侧边栏多一行（缩进，iss 标签），显示 issue
计数；点击它会打开一个三列 issue 看板：等我行动
（报告者在你最后一条评论后回复了，或者你被指派/提及
但还没有任何来自你的内容）、等报告者（你持有最后发言权）、
以及 最近关闭（14 天内关闭，回归监控）。第三方
评论不会把线程拉回给你——只有报告者的会。点击卡片会
像 PR 卡片一样打开或启动审查会话。

每个监控仓库在侧边栏多一行缩进的 issue 计数（iss 标签），点开是三列 issue
看板：等我行动 / 等报告者 / 最近关闭。只有报告者的回复会把线程拉回
"等我"；第三方评论不会。点卡片同样进入/新建对应会话。

状态迁移检测：当 PR 从"等作者"切到"等你"（作者回复 / 重新 request 你 review）时弹
toast 提醒、侧边栏小部件闪烁；轮询间隔 1–30 分钟可配。

Requirements / 依赖

- DSH 宿主机上安装了 GitHub CLI（gh）
并已认证（gh auth login）。插件通过 shell 调用 gh
进行搜索 + GraphQL 查询，因此会遵循你的 gh token 权限范围和 GitHub 的
速率限制。如果 gh 缺失或未登录，看板会显示设置提示
而不是原始错误。
- DSH web profile（GUI）。此插件是 web-profile 客户端插件。

DSH 宿主机上需安装并登录 gh；插件通过 gh 的 search + GraphQL 查询取数，
速率限制遵循你 gh token 的配额。若 gh 缺失或未登录，看板会显示安装/登录
指引而不是原始报错。

Install / 安装

dsh plugin --profile web add github:delock/dsh-pr-board

（或发布到 npm 后执行 dsh plugin --profile web add dsh-pr-board）

然后重启 web profile 并刷新页面。

Configure / 配置

1. 点击侧边栏底部的 PR Board 小组件（或按 Alt+P）。首次打开时会提示你添加一个仓库
（owner/name，例如 octocat/hello-world）。
2. 多个仓库：该小组件会列出每个被监控的仓库及其各自的 Me / Author / Ready / Inbox 计数。小组件标题栏中的 + 按钮
（或看板标签栏上的 +）可添加另一个仓库；在看板中悬停某个标签会显示 × 以停止监控它（移除操作仅存在于看板内）。
仓库以短名称标识，当两个被监控的仓库同名时回退到完整的 owner/name。
3. GitHub 用户名 —— 通过 Settings 设置；留空则自动使用
gh 登录账号（所有仓库共用一个身份）。
4. Review workspaces —— 同样在 Settings 中，按仓库配置，没有
全局默认值：每个仓库都带有一个显式 workspace，没有 workspace 的仓库
会在 GitHub 上打开其卡片。设置后，点击 PR 卡片
会跳转到 DSH 内匹配的对话。会话首先通过本地 PR→会话绑定表匹配，
然后通过标题搜索匹配
（repo#N，一旦会话的 LLM 生成标题存在即可生效）；未命中时会在配置的 workspace 中创建新会话，绑定它，并且——
除非自动 prompt 关闭——向它发送一条首条消息，其中包含 PR 名称以及
看板自身的快照（状态、CI、标记），要求它总结该 PR 上最近发生的情况
（事件和现状，而非代码走查），然后询问你想做什么。这条首条消息
也是生成会话标题的来源。未设置 workspace 时（或通过
每张卡片的 ↗ 按钮），卡片会在 GitHub 中打开。
5. 配置跨设备共享：账号级字段（仓库列表、用户名、
review workspace、自动 prompt、不活跃窗口）同步到 host
（~/.dsh/pr-board.config.json）；每个浏览器只保留自己的轮询
间隔。新设备在首次加载时继承配置；改动在每次轮询时收敛。

配置跨设备共享：账号级字段（仓库列表、用户名、review workspace、自动
prompt、不活跃天数）同步到 host（~/.dsh/pr-board.config.json），每个浏览器
只保留自己的轮询间隔。新设备首次打开即继承配置，改动在每次轮询时收敛。

How states are computed / 状态如何计算

对于每个你已 review / 评论 / 被请求 review 的 open PR，host
通过 GraphQL 获取：reviewDecision、mergeable、draft 标记、最后提交时间，
以及完整的 review + 评论时间线。然后：

- 你的最后操作时间 vs 作者的最后活动时间 → 谁最后有动作
- 你的 approval 时间戳 vs 最后提交时间戳 → 在你 OK 之后是否有新代码合入
- 其他维护者的 change request 也计入“等待作者”

对每个你参与过的 open PR，host 端经 GraphQL 取 reviewDecision、mergeable、
draft 标记、最后提交时间及完整 review/评论时间线，据此计算"双方最后动作"、
"批准后有无新提交"、"其他 maintainer 是否提过修改意见"等，得出最终分类。

隐私

所有查询均通过你自己的 gh CLI 在本地运行。无第三方服务、无
遥测，除 GitHub API 调用外，无数据离开你的机器。

所有查询经本机 gh CLI 完成，无第三方服务、无遥测。

许可

MIT