前言¶

在使用 DeepSeek Harness（DSH）與智能體協作時，Agent 每一輪輸出往往包含多個文件的修改。當前 DSH 的內置 ui-deliverables 只提供改動卡片概覽，缺少行級差異對比和撤銷能力。dsh-file-review-tab 將 left0ver/dsh-file-review 的「改動審查」能力移植到 dsh-better-sidebar 的側邊欄 Tab，並在對話尾部復刻內置卡片的外觀，提供行級紅綠 diff、撤銷/重新應用、深鏈跳轉等能力。

插件定位¶

whybebabo/dsh-file-review-tab 是一個客戶端插件，將文件改動審查能力擴展爲兩個入口：

• 對話尾部審查行：與 DSH 內置 ui-deliverables 同款外觀，帶撤銷與審查按鈕
• 側邊欄 Tab「文件審查」：按輪次分組展示改動文件，展開查看行級 diff

本倉庫是 Lzh3070/dsh-file-review-tab 的 fork 鏡像，針對 DSH 0.2.0-rc.2 進行了適配與增強。

核心功能¶

對話尾部審查行¶

每輪對話結束後，會在對話尾部出現「已編輯 N 個文件 +M −K」卡片。卡片外觀與 DSH 內置 ui-deliverables 改動卡片逐像素對齊，包括 60px 頭部、40px 文件類型圖標塊、13px 標題、等寬字體文件行、超過 4 行摺疊爲「全部 N 個文件」等細節。內置卡片標題欄沒有插槽，本插件自渲染同款卡片以容納兩個按鈕：

• 撤銷：撤銷本輪改動（撤銷後可點「重新應用」）
• 審查：在側邊欄 Tab 中展開對應文件的 diff 並定位到該輪分組頂部

鼠標懸停 500ms 後彈出該文件的 diff 預覽；點擊「審查」或單個文件名，會深鏈打開側邊欄 Tab。

側邊欄 Tab「文件審查」¶

在 dsh-better-sidebar 的側邊欄「+」菜單中打開「文件審查」Tab，按輪次分組列出本會話改動文件。點擊展開行級紅綠 diff，支持撤銷本輪 / 單文件撤銷 / 重新應用。Tab 角標實時顯示改動文件數。表頭是與原生同款的 38px 對照條（文件選擇器 + 統計），工具行提供「分欄 / 換行 / 刷新」三個可切換/可用的控件，每個都帶 500ms 提示氣泡。

刪除文件可見¶

DSH 沒有刪除文件的工具，刪除通常發生在終端命令中。本插件解析 rm 族命令的字面路徑參數（rm / rmdir / unlink / shred / trash / Remove-Item / del / rd / erase 等），將被刪文件以「已刪除」標記出現在兩個入口（內容已不存在，故無行級 diff、不可撤銷）。帶通配符或命令替換的刪除命令不識別。

自動歸檔¶

主列表只保留最近 5 輪（進行中的輪次永不歸檔），更早的已完成輪次沉入底部「已歸檔 N 輪」摺疊區。摺疊時歸檔內容零渲染，展開後每頁加載 10 輪（「加載更多」續頁），diff 行另有懶掛載——長會話不再一次性掛載幾十個 diff 組。深鏈跳到已歸檔輪次會自動展開並定位；展開狀態按會話記憶；角標只統計主列表。

PTC / Code Mode 支持¶

run_code 程序內部的 edit/write 子調用也會被捕獲——Host 端快照完整 before/after，瀏覽器端重建帶行號的行級 hunks 併入所屬輪次；diff 查看、狀態檢查、撤銷/重做均可用。標準模式行爲不變（對話尾部審查行仍只覆蓋標準模式輪次）。

安裝與啓用¶

前置依賴：
- DeepSeek Harness web（0.2.0-rc.2+，已在 0.2.0-rc.2 上驗證）
- dsh-better-sidebar（≥ 0.19.1，已在 0.24.1 上驗證）

安裝本倉庫的發佈版：

dsh plugin --profile web add @whybebabo/dsh-file-review-tab

或直接從本倉庫的 GitHub 源安裝：

dsh plugin --profile web add github:whybebabo/dsh-file-review-tab

上游版本（DSH 0.1.5）：

dsh plugin --profile web add dsh-file-review-tab@0.5.0

裝好後重啓 dsh web，在 better-sidebar 側邊欄「+」菜單打開「文件審查」即可。dsh-better-sidebar 需另行安裝。

注意：裸名 dsh-file-review-tab 在 npm 上由上游作者持有，dsh plugin --profile web add dsh-file-review-tab 裝到的是上游版本，不是本倉庫的 0.7.1。要裝本 fork 的版本必須使用 scoped 包名或 GitHub 源。

版本對應¶

• @whybebabo/dsh-file-review-tab@0.7.x：面向 DSH 0.2.0-rc.2，使用嚴格 TypertCodec.create() 工廠、turnTail 加法列表槽、原生 ui-deliverables 同款外觀
• 上游 dsh-file-review-tab@0.5.x：面向 DSH 0.1.5
• 上游 0.4.1：面向 DSH 0.1.2 / 0.1.1

注意事項¶

• 不要同時安裝本倉庫與上游版本：兩者註冊同一個 turnTail 槽位與同一個 ui-deliverables 補丁，共裝會出現重複卡片
• 安裝前應檢查源碼與許可證（MIT）
• 剛發佈的版本可能被 pnpm 的 minimumReleaseAge 擋下，可使用精確版本繞過

總結¶

dsh-file-review-tab 將文件改動審查能力擴展爲對話尾部審查行與側邊欄 Tab 兩個入口，提供行級 diff、撤銷/重新應用、深鏈跳轉、刪除文件可見、自動歸檔、PTC 支持、會話隔離等能力，適合需要在 DSH 中審查和回滾 Agent 生成的文件改動的開發者。

• 目錄頁：https://www.skillhub.cn/plugins/whybebabo/dsh-file-review-tab
• GitHub：https://github.com/whybebabo/dsh-file-review-tab