前言¶
在 DSH 里写代码、跑智能体时，「有没有该我处理的 Pull Request」会隔一段时间又冒出来。常见做法是切到浏览器，打开 GitHub，在 Notifications 和各个仓库的 Pull requests 页之间来回翻，还要自己记哪些仓库跟自己有关。GitHub 的通知（网页、邮件、桌面）是全站级别的：推送、issue、CI 失败和真正等你 review 的两三条混在一起，PR 相关项很容易被淹没。
dsh-pr-inbox 把这件事挪回你正在用的 DSH 环境：在右侧栏增加 PR 页签，按「我提的 / 待我审 / 我合并的」三桶列出与当前工作区仓库相关的 GitHub PR，复用本机已登录的 gh CLI，只读、不存凭据。下面介绍它是什么、能做什么、如何安装与使用，以及适用边界。
这是什么¶
dsh-pr-inbox 是社区维护的 DeepSeek Harness（DSH）插件，仓库 omdsh-dev/dsh-pr-inbox，在插件目录 skillhub.cn 中归类为联网工具。一句话定位：侧边栏里的 GitHub PR 收件箱，自动绑定当前会话工作区对应的仓库，用三个动作语义分桶展示 PR，点开可在面板内读正文、评论与评审摘要、改动文件清单。
与 GitHub 全站通知或编辑器里「绑在当前文件 / diff」的 GitHub 集成不同，这里切的是「当前工作区 + 与我相关」这一层；代价是需要本机已安装并登录 gh，且仅支持 github.com。
核心功能¶
工作区绑定¶
不用手动选仓库：会话在哪个 Git 仓库，面板就展示该仓库的 PR。远程解析顺序为 upstream 优先，其次 origin，再退到第一个 remote；fork 布局会绑到主仓而不是你的 fork。会话尚未确定工作目录时，面板会提示先产生一次工具调用或打开文件，以便绑定到某个仓库。
三桶列表¶
| 桶 | 语义 | 取数要点（来自 README） |
|---|---|---|
| 我提的 | 我该跟进 | author:@me，开着的 PR |
| 待我审 | 等我的动作 | review-requested:@me；计数会变色 |
| 我合并的 | 我刚做的事是否落地 | is:merged author:@me，最近 20 条，按合并时间倒序 |
列表支持简洁档（单行 28px）与详细档（两行 50px）切换，选择会记住；分区块滚动时区名与计数贴在上沿，可点击区头折叠。顶部有搜索框，在标题、编号、作者、标签上过滤，仅在已加载的行内过滤，不会去 GitHub 全量搜索。
详情与只读边界¶
点击一行在面板内打开完整 PR：正文（Markdown 渲染）、评论与评审摘要（如 APPROVED / CHANGES_REQUESTED）、改动文件清单（状态色标与增删行数）。返回列表 会恢复原来的滚动位置与行焦点；详情页按 Esc 也可返回。行内 ↗ 可在 GitHub 打开对应 PR。
插件只读：不评论、不 approve、不 merge。详情不含 diff、行内 review 评论与 CI/checks；要看改动本身或行内意见，仍需打开 GitHub。
凭据与数据路径¶
不申请 token、不填 PAT、不落盘凭据。列表走 gh api search/issues，详情走 gh api。缺 gh 或未登录时，面板给出可操作提示（安装 gh / gh auth login），而不是空白列表。gh 的速率限制与超时会如实反映在面板上。
界面与宿主¶
PR 页签挂在 dsh-better-sidebar 的右栏，界面文案随 DSH 语言（中/英）与深浅主题。底部状态行常显绑定的仓库、当前 gh 账号与数据读取时间。
安装与启用¶
前置条件：
- DSH 已安装。
- 本机
gh已登录（gh auth login）。 - 已安装页签宿主 dsh-better-sidebar。README 写明：dsh 0.2.1 线需要 better-sidebar ≥ 0.28.0；若使用 0.26.x 的
inject仍依赖 0.2.1 已移除的webRuntime，页签可能永久 pending、界面上没有入口。
按顺序执行官方安装命令：
① 安装页签宿主
dsh plugin --profile web add dsh-better-sidebar
② 安装 dsh-pr-inbox
dsh plugin --profile web add "github:omdsh-dev/dsh-pr-inbox"
需要钉版本时，在 git 源后加标签，例如 ...#v0.1.1（与 package.json 中当前发布版本一致）。仓库已提交 lib/ 构建产物，git 源安装不需要本机构建授权。
装完后刷新页面（或按 DSH 提示重启 web）。展开右侧栏，在页签列表中选择 PR。
装/卸/启停可用：dsh plugin --profile web add|remove <包>。已装插件在侧边栏 Plugins 页查看；各插件配置挂在对应包页上（Settings 里的「插件」为只读清单）。
典型用法¶
- 在已绑定 Git 仓库的 DSH 工作区打开会话，展开右栏，进入
PR页签。 - 在「待我审」区扫一眼计数与列表；需要上下文时切换到详细档，或用搜索框在已加载行里过滤。
- 点击某条 PR 在面板内读描述、时间线评论与文件列表；若要看 diff 或行内 review，点
↗跳到 GitHub。 - 处理完一批后点刷新；底部状态行可核对当前绑定的仓库与 gh 账号。
README 中的界面示意包括三桶简洁列表、详细档、深色主题与详情页（正文 / 时间线 / 文件清单），可在仓库 docs/preview/ 查看。
适用场景与注意¶
适合谁：经常在 DSH 里针对某个 GitHub 仓库写代码或驱动智能体，希望少切浏览器、快速确认「我提的 / 待我审 / 我合并的」三类 PR 的开发者。
环境与限制（摘自 README）：
- 仅支持
github.com；其它 Git 托管会在列表或详情中提示不支持。 - 「我合并的」固定为最近 20 条，不是时间窗；搜索只在已加载行内生效。
- 正文图片：仓库内相对路径经插件路由代理；外链图片由浏览器直接加载，受限网络下可能无法显示。
- 未装 better-sidebar 时，宿主逻辑可能仍半常运行，但界面上没有
PR入口（有意不静默失败）。
安全与权限：插件以当前 DSH 进程权限运行，并通过本机 gh 访问你有权看到的仓库数据。安装前建议查看 源码与 MIT 许可证，确认符合你的合规要求。
兼容性参考：README 记录 0.2.1-rc.1 + better-sidebar 0.28.0 与 0.2.0-rc.2 + better-sidebar 0.26.x 的验证情况；其它 DSH 版本未验证。升级后若右栏没有 PR 页签或面板长期空白，可先确认 better-sidebar 版本是否满足 0.2.1 线要求。
结尾¶
dsh-pr-inbox 把「当前工作区里与我相关的 GitHub PR」收进 DSH 右侧栏，三桶分面、面板内可读详情，并复用已有 gh 登录，避免再维护一套 PAT。它是 DSH「一切皆插件」生态中的联网工具类组件；社区目录 skillhub.cn 与官方 DeepSeek / 幻方无从属关系，安装与使用以仓库 README 为准。
- 目录页：https://www.skillhub.cn/plugins/omdsh-dev/dsh-pr-inbox
- GitHub：https://github.com/omdsh-dev/dsh-pr-inbox
