前言¶
在 DeepSeek Harness（DSH）里，Agent 通过 present 或研究报告插件把文件交给用户，常见问题不是「有没有交付」，而是「交付之后怎么验收」。口头说「看过」没有可复核记录；文件事后一改，之前的通过状态是否仍成立也不清楚。Review Outbox（dsh-review-outbox）针对的是成果处置：把待审文件放进本地队列，研究报告走四项必填证据检查，通过或退回时记下 SHA-256，并导出可独立打开的 HTML 验收单。它不替代审批流、问题单或通知类插件，也不自动向外部平台发布。
这是什么¶
Review Outbox 是维护者 zjukop3 发布的 DSH 工作流类插件，npm 包名 dsh-review-outbox，当前资料记载的应用内索引版本为 0.1.10（项目处于 0.1.x 验证阶段）。一句话定位：本地优先的成果审阅台——监听官方交付事件，可选对接 dsh-research-report 的密封报告，在侧栏完成预览、证据填写、通过/退回/归档，并生成带文件指纹的验收单。
分类与简介与目录一致：Evidence-based deliverable review，含研究验收清单、修订（revision）跟踪、依托宿主打开 DOCX/PDF，以及独立 SHA-256 验收单。
核心功能¶
证据门与验收包¶
研究报告默认附带「研究报告验收」包，须核对四项：结论证据、引用可复核、数据口径、方法限制（复现材料为可选）。表格类成果资料记载核三项：来源口径、字段单位、抽样核对。仅勾选不够，必须填写证据文字才能通过；证据不足时不能点通过。
密封研究报告安装插件后，界面会显示类似 必填证据 0/4 的进度；四项补齐后才可通过并下载验收单。空队列时也可先生成示例成果，走通「预览 → 证据门 → 通过 → 验收单」链路（README 指向 docs/e2e/ 下的结构化记录与示例 HTML）。
队列、修订与历史¶
- 监听官方
deliverables/presented，记录交付文件、来源会话、轮次、调用与 revision。 - 同时启用
dsh-research-report时，成功research_report的report.md与manifest.json可自动入队，无需额外present。 - 启动时通过官方
sessionPersistence有界回填历史交付与可配对的密封研究结果；同一路径再次交付形成新 revision，已审阅状态不会被无变化重复发现重置。 - 支持通过、退回、归档、重新打开；保存审阅意见与完整处理历史。退回可先写修改意见，并可「复制意见并打开原会话」（不会自动向会话发消息）。
预览与文档查看¶
文本与常见图片可在插件内预览；工作区在官方 workspaceChanges 可用时展示变更 diff。PDF、DOCX 等不内嵌渲染器，而是恢复来源 Session 后调用官方 sidebarRight 文档 Viewer（复用宿主 Office 转 PDF 与 PDF.js）。预览仅接受已登记成果，默认限制在记录的工作区内。
SHA-256 验收单¶
通过或退回时记录文件 SHA-256。导出的独立 HTML 验收单包含检查证据、revision、意见与历史；若审阅后文件字节变化，验收单会明确提示需重新审阅，而不是维持无效的「通过」假象。验收单默认本地导出，资料说明不包含绝对路径或会话原文。
持久化与边界¶
状态写入本地 JSON（原子写入，损坏时只读保护），默认路径：
$DSH_HOME/review-outbox/items.json
未设置 DSH_HOME 时为 ~/.dsh/review-outbox/items.json，权限 0600。
明确不处理：普通问题、工具审批与通知（避免与 DeepCanary 等重叠）。历史回填有界：默认扫描最新 50 个 Session、每 Session 末尾最多 5000 事件等，上限与失败会在 backfill 状态中显示。可选接入 dsh-better-sidebar 底部标签；服务未安装时不影响原生侧栏。
安装与启用¶
目标宿主：DeepSeek Harness >=0.2.2-rc.1 <0.3.0-0；Node.js >=22.19。插件运行时零依赖、无安装脚本。
从 npm 安装（常用）¶
dsh plugin --profile web add dsh-review-outbox
dsh web
资料记载 npm 包为 dsh-review-outbox@0.1.10。注意 DSH 插件安装对发布不满 24 小时的新版有 minimumReleaseAge 冷却（默认 1440 分钟）；需钉版本时可用 dsh-review-outbox@0.1.10。写成 ^ 范围会在冷却后自动升级，精确 @0.1.10 则不会自动更新。
应用内「发现」安装¶
在插件设置中启用「自定义插件索引」，添加索引源后搜索 Review Outbox 或 研究报告：
https://zjukop3.github.io/dsh-review-outbox/plugins.json
确认版本与提交后安装，再在「已安装」中启用。应用内网络不可用时，资料给出对公开提交 0.1.10 的 CLI 回退：
dsh plugin --profile web add 'github:zjukop3/dsh-review-outbox#6000c13c2b0ebd34701d8c66b8123e06beee8530'
dsh web
其他安装方式¶
Awesome 目录条目提供的命令（资料实测可解析到指定提交）：
dsh plugin --profile web add github:zjukop3/dsh-review-outbox
dsh web
或直接使用 GitHub URL：
dsh plugin --profile web add https://github.com/zjukop3/dsh-review-outbox
dsh web
也可下载 Pages 上的 0.1.0 tarball 校验 SHA-256 后本地安装。桌面端请用应用内插件界面，勿直接改桌面 Profile。
安装前请自行查看仓库源码与 MIT 许可证；插件以当前 DSH 进程权限运行，可访问其配置下的工作区与本地状态文件。
典型用法¶
经过上面的安装与启用，可按 README 中的主流程操作：
- 让 Agent 通过官方
present交付文件，或使用dsh-research-report生成密封研究报告。 - 打开侧栏 成果审阅 / Review Outbox。
- 在「待审」中选择成果，预览内容或变更；研究报告逐项填写验收证据，也可更换或清除验收包。
- 选择「通过」「退回」或「归档」；退回须先写清修改意见。
- 通过后点击「导出验收单」，得到可单独打开的 HTML；若文件已变，验收单会提示。
- 需继续改稿时，「复制意见并打开原会话」，在新消息中粘贴继续。
与 dsh-research-report@0.3.32 的联合互操作在资料中有单独验证章节；研究报告清单与证据示例见仓库文档 docs/packs/research-report.md，在线验收清单见 zjukop3.github.io/dsh-review-outbox/research-report/。
HTTP API（均需 DSH Connection 鉴权）包括健康检查、按状态列出成果等，路径前缀为 /review-outbox/api/；完整表见 GitHub README。
适用场景与注意¶
适合谁： 需要在 DSH Web 侧对 Agent 交付物做结构化验收的团队或个人，尤其是研究报告需要「结论—引用—口径—方法限制」留痕、且希望验收单可离线分享、可检测文件事后篡改的场景。
不适合当作： 通用工单、审批网关或自动发布管道；研究报告包只做人工证据记录，不自动访问引用或冒充事实核查。
版本与生态： 当前 GitHub Release 尚未发布，目录收录不等于广泛采用。界面中文优先，英文宿主下侧栏入口中英双语，完整 i18n 仍待需求。社区插件目录（如 Awesome DSH Plugin）为独立站点，与 DeepSeek / 幻方无官方从属关系。
结尾¶
Review Outbox 把 DSH 成果从「交付即结束」延伸为「证据门 + 修订历史 + SHA-256 验收单」的本地工作流，与官方 present、会话回填及研究报告插件对齐，边界写得清楚。进一步了解可看目录页与仓库 README。
