前言¶
在 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。
