Review Outbox · 成果审阅与研究报告验收

中文 | English

一个本地优先的 DeepSeek Harness 成果审阅插件：把 Agent 交付的文件集中起来，完成预览、场景化证据检查、通过、退回、归档和复盘，并可导出无需安装即可查看的独立 HTML 验收单。

它处理的是成果处置，不是普通问题、审批或通知。通过只表示你已完成审阅，插件不会自动向外部平台发布，也不会自动改写原会话。

当前范围

• 监听官方 deliverables/presented，逐项记录交付文件、来源会话、轮次、调用和 revision。
• 在官方 workspaceChanges 服务可用时接收 workspace/changes，按需读取变更对比。
• 文本与常见图片预览；工作区变更在官方仍提供数据时显示 diff。
• PDF、DOCX 等成果可恢复来源 Session 并调用官方 sidebarRight 文档 Viewer，复用宿主 Office 转 PDF 和 PDF.js 能力。
• 通过、退回、归档、重新打开，保存审阅意见和完整处理历史。
• 研究报告验收包：核心结论证据、引用复核、数据口径、方法限制为必填检查，复现材料为可选检查；必须勾选并填写证据才能通过。
• 通过和退回时记录文件 SHA-256；独立 HTML 验收单包含检查证据、revision、意见和历史，导出时检测文件是否在审阅后变化。
• 启动时从官方 sessionPersistence 有界回填历史 deliverables/presented，安装前的交付也能进入审阅队列。
• 同一路径再次交付形成新 revision；已审阅状态不会被无变化的重新发现或重复回填重置。
• 本地 JSON 原子写入，损坏时进入只读保护。
• 可以复制退回意见并打开来源会话；不会自动向会话发送内容。
• 可选接入 dsh-better-sidebar 底部标签页；服务未安装时不影响原生侧栏，服务替换或移除时同步清理注册。

明确边界

• 普通问题、工具审批和通知不进入此列表，避免与 DeepCanary 等产品重叠。
• 历史回填只读取 deliverables/presented，默认扫描最新 50 个 Session、每个最多读取末尾 5000 个事件、每轮最多入库 1000 项；达到上限或单个 Session 读取失败会在 backfill 状态中明确显示。
• workspace/changes 仍只接收插件启用后观察到的事件，其摘要和 diff 主要服务仍存活的会话；重启后保留本插件的成果元数据与审阅状态，但不承诺旧 diff 仍可读取。
• 预览只接受已登记成果，并默认限制在记录的工作区内；不支持任意本地路径读取。
• 本面板不内嵌 Office/PDF 渲染器；可点击「在宿主 Viewer 打开」，先恢复来源 Session 再进入官方预览。实际格式支持以宿主 Viewer 为准。
• 研究报告包记录人工检查证据，不自动访问引用，也不冒充自动事实核查。
• 验收单默认在本地导出，不自动上传；不包含绝对路径或会话内容，检查证据和审阅意见按用户填写内容导出。
• 项目仍处于 0.1.0 验证阶段；GitHub 源码与 Pages 清单已公开，npm、GitHub Release 和社区目录尚未发布。新生成的验收单默认链接到本仓库。

安装

目标宿主：DeepSeek Harness >=0.2.2-rc.1 <0.3.0-0；Node.js >=22.19。实测范围见兼容矩阵，tarball 安装、备份、升级与损坏恢复见安装恢复指南。

下载 tarball

下载 Review Outbox 0.1.0 和对应的 SHA-256 文件，在安装目录执行 shasum -a 256 -c dsh-review-outbox-0.1.0.tgz.sha256，然后安装到独立 Web Profile：

dsh plugin --profile web add /absolute/path/dsh-review-outbox-0.1.0.tgz
dsh web

也可以从本地源码目录安装：

dsh plugin --profile web add /absolute/path/dsh-review-outbox
dsh web

桌面端请使用应用管理的插件安装界面，不直接修改桌面 Profile。

使用

研究报告的完整清单、证据示例和独立验收单说明见研究报告验收包。

1. 让 Agent 正常完成任务并交付文件。
2. 打开侧栏「成果审阅」。
3. 在「待审」中选择成果，检查内容或变更；研究报告可选择「研究报告验收」，逐项填写证据。
4. 选择「通过」「退回」或「归档」。退回时先写明修改意见；场景包必填证据不足时不能通过。
5. 通过后点击「导出验收单」，得到可独立打开和随成果分享的 HTML；如果文件审阅后变化，验收单会明确提示。
6. 需要继续修改时，点击「复制意见并打开原会话」，在新消息中粘贴并继续。

状态、revision、意见和历史保存在：

$DSH_HOME/review-outbox/items.json

未设置 DSH_HOME 时默认是 ~/.dsh/review-outbox/items.json。文件权限为 0600，目录按当前系统用户创建。

开发

pnpm install --ignore-scripts
pnpm test
pnpm run build

• src/events.js：官方事件到成果记录的纯转换。
• src/backfill.js：最新 Session 优先的有界读取、单会话故障隔离和句柄释放。
• src/store.js：串行状态变更、验收包、revision、历史和原子持久化。
• src/packs.js：研究报告检查项、证据进度与 Host 通过约束。
• src/evidence.js：受工作区约束的文件 SHA-256 证据。
• src/receipt.js：无脚本、无外部依赖的独立 HTML 验收单。
• src/preview.js：工作区约束、文本/图片预览与大小限制。
• src/host.js：Host 事件监听和经 Connection 鉴权的 HTTP API。
• client/：侧栏主面板、审阅交互与 native-open.js 官方文档 Viewer 路由。
• test/：数据层、Host 集成、状态与预览测试。

合成示例

export DSH_HOME=/tmp/dsh-review-outbox-e2e
export DSH_REVIEW_OUTBOX_DEMO_DIR=/absolute/path/dsh-review-outbox/demo
dsh plugin --profile web add /absolute/path/dsh-review-outbox
dsh web --no-open --port 43177

示例只读取 demo/ 下的合成文件，不扫描其他目录。正常安装不包含示例数据。

浏览器验证

启动上面的隔离实例后，将打印出的完整 URL 传入：

export DSH_E2E_URL='http://127.0.0.1:43177/?token=<token>'
node scripts/e2e-browser.mjs

脚本使用本机 Chrome，处理首次启动的预览说明和可选登录模态，验证侧栏、选择成果、预览、点击通过以及 API 状态回写。截图和结果保存在 docs/e2e/。

完整检查

pnpm run check

当前单元、Host 与官方工具集成测试共 38 项。其中 test/official-present.test.js 直接执行官方 present，经生产默认的 Zstandard JSONL 落盘、关闭写入上下文、冷读后进入回填；另一测试从同一 JSONL Session 恢复，以不同 callId 再次交付并验证只形成一条 revision 历史。真实挂载和浏览器验证记录见 验证文档。

API

所有路由都要求 DSH Connection 鉴权，不提供无鉴权端点。

方法	路径	用途
GET	/review-outbox/api/health	健康检查与当前统计
GET	/review-outbox/api/items?status=pending	按状态列出成果与验收包进度
GET	/review-outbox/api/packs	可用场景验收包及检查定义
GET	/review-outbox/api/item?id=<id>	单项元数据
GET	/review-outbox/api/preview?id=<id>	文本或图片预览
GET	/review-outbox/api/diff?id=<id>	官方仍可用时的变更对比
GET	/review-outbox/api/receipt?id=<id>	下载独立 HTML 验收单并复核当前文件摘要
POST	/review-outbox/api/pack	选择或清除场景验收包
POST	/review-outbox/api/check	保存检查勾选和证据说明
POST	/review-outbox/api/backfill	按既定上限重新执行历史回填并返回状态
POST	/review-outbox/api/action	approve / return / archive / reopen

动作请求：

{"id":"presented:...","action":"return","note":"请补充来源与复现步骤"}

参与方向

北极星指标是每周被真正审阅并处置的成果数，不是安装量。自然获客不依赖维护者持续发帖，而是通过可搜索的场景验收包、随成果分享且无需安装即可查看的独立验收单，以及官方 present 的零配置接入形成增长环。详见 长期路线。

License

MIT