前言¶
在使用 DeepSeek Harness (DSH) 进行开发时，管理 Pull Request 的反馈与审查状态容易分散。遗漏重要的代码审查意见或 CI 失败信息会降低开发效率。dsh-pr-guardian 是一个专门用于管理 PR 反馈的收件箱工具，它由 Harzva 维护，旨在解决反馈遗漏和状态追踪的问题。
插件简介¶
这是一个针对 DSH 的 PR 管理收件箱，支持与 Codex 共享进度状态，并提供对 GitHub 开放 PR 的只读集合管理。它将 GitHub 上的评论、审查和线程转化为结构化的反馈数据，帮助开发者优先处理关键任务。
安装与启用¶
安装前请确保环境满足以下要求：
* 已认证的 GitHub CLI (gh auth status)
* Git
* Node.js 24+
* 兼容的 DSH 版本：0.1.1-rc.2
* 兼容的 Cordis 版本：4.0.1
* 兼容的 React 版本：18.2.0
执行以下命令安装插件并启动 DSH：
dsh plugin --profile web add https://github.com/Harzva/dsh-pr-guardian/releases/download/v0.2.0-alpha.1/dsh-pr-guardian-0.2.0-alpha.1.tgz
dsh --profile web
安装完成后，在 DSH 的侧边栏中打开 PR Guardian，刷新 GitHub 即可同步数据。
核心功能¶
- 反馈面板：侧边栏提供可搜索的反馈面板，支持分页显示普通评论、正式审查和审查线程（包括嵌套评论）。
- PR 发现：自动发现当前活动
gh账户撰写的开放 PR。 - 优先级处理：支持优先处理人类反馈、收藏项、CI 失败和冲突。
- 状态管理：本地版本绑定状态管理。已编辑的反馈会变为待处理状态。收藏和待处理/已调查/等待用户等状态在重启后保留。已解决的线程和被取代的审查会被区分。
- 安全隔离：管理 API 不包含任何 GitHub 写入操作，仅进行只读数据收集。
典型用法¶
插件提供了管理 CLI 工具，默认位于 $DSH_HOME/dsh-pr-guardian/management 目录（可通过 --state-dir 指定）。
- 同步与列表
先同步最新的 PR 和评论数据，然后列出所有待处理的反馈：
node bin/guardian-management.mjs sync
node bin/guardian-management.mjs list
- 标记收藏
通过 CLI 命令对特定的 PR 进行收藏操作：
node bin/guardian-management.mjs action '{"kind":"favorite","caseId":"owner/repo#123","favorite":true}'
- 本地诊断与监控
检查本地环境状态，或进行单次监控扫描：
node bin/dsh-pr-guardian.mjs doctor
node bin/dsh-pr-guardian.mjs monitor --once
- 生成报告
生成最近 7 天的报告：
node bin/dsh-pr-guardian.mjs report --days 7
适用场景与注意事项¶
- 状态共享：若需在 Codex 和 DSH 之间共享进度，请使用相同的
stateDirectory路径。 - 搜索限制：搜索范围限制为当前账户撰写的 1,000 个开放 PR。
- 推送限制：
--push标志受全局和仓库开关限制，且需要满足“七日门”要求才能启用。当前版本默认禁用推送功能。 - 文件锁：状态文件使用独占写入锁。若遇到
WRITER_BUSY错误，请检查并清理writer.lock文件。
生态链接¶
- GitHub 仓库: https://github.com/Harzva/dsh-pr-guardian
- 目录页: https://www.skillhub.cn/plugins/Harzva/dsh-pr-guardian
