前言¶
DeepSeek Harness (DSH) 的核心理念是“一切皆插件”。在利用智能體進行代碼生成與修改的場景中，單次交互可能涉及大量文件的變更和命令的執行。當某一步驟出現錯誤，開發者急需清晰的答案：具體修改了哪些文件？哪個命令失敗了？如何在不丟失後續工作或無關代碼的前提下回滾？
dsh-turnscope 針對這些痛點，爲 DSH coding sessions 提供了逐輪的文件差異分析、確定性安全警告以及“預覽優先”的安全回溯機制。
插件介紹¶
zhaolianghz/dsh-turnscope 是一個 DeepSeek Harness 插件。它通過原生集成 conversation.view，在 DSH 的界面中展示詳細的逐輪時間線。該插件不僅提供文件差異和指標統計，還通過“預覽-應用”流程實現安全的回滾操作。
核心能力¶
-
逐輪時間線與狀態
插件提供運行、完成、失敗或輸出限制等狀態。每輪展示持續時間、工具調用次數、錯誤次數及活動列表，幫助開發者快速定位問題節點。 -
文件變更明細
提供每輪的命令結果、變更文件摘要及具體的文件 Diff，支持查看本輪開始時已髒的文件。 -
安全回溯
- Preview：起草變更計劃，不進行工作區寫入。
- Apply：提交變更計劃，使用原子重命名和文件日誌，並在應用過程中崩潰時，在下次啓動時自動回滾到應用前的字節狀態。
-
漂移防護
Drift Guard 會防止在預覽後工作區發生變化時進行不安全的操作。 -
隱私與存儲
採用本地存儲（管理模式 root，權限 0o600），無遙測數據，不執行git reset --hard操作。
安裝與啓用¶
當前未發現標準的 dsh plugin add 安裝命令，需通過源碼構建本地加載。插件要求 Node.js 22.19 或更新版本，以及 pnpm 11.7。
環境準備¶
corepack enable
pnpm install
pnpm build
驗證與加載¶
構建完成後，使用 DSH 0.2.0-rc.2 進行本地加載。GitHub 提供了 smoke:dsh 腳本用於快速驗證安裝：
pnpm smoke:dsh
典型用法¶
在 DSH 的對話視圖中，該插件會渲染出 Turns 面板。
- 查看當前輪次的文件變更摘要和 Diff。
- 點擊 Preview 按鈕，查看即將應用的變更計劃，此時工作區不會發生實際修改。
- 確認無誤後，點擊 Apply 按鈕，系統將提交變更。
- 若在 Apply 過程中發生崩潰，重啓 DSH 時，文件會自動回滾到 Apply 之前的字節狀態。
適用場景與注意¶
該插件適合需要精細控制代碼變更過程、關注審計與安全回滾的開發者。
- 環境要求：需要 Node.js 22.19+、pnpm 11.7 及 DSH 0.2.0-rc.2。
- 權限注意：插件以當前 DSH 進程權限運行，安裝前請檢查源碼。
- 限制：目前版本不支持 Forked retry（計劃於 V0.3），且僅支持瀏覽器端只讀行爲。
- 許可證：未覈實具體許可證名稱，僅確認存在 LICENSE 文件。
結語¶
dsh-turnscope 通過提供確定性的安全警告和基於預覽的回滾機制，降低了智能體代碼修改的風險。如需瞭解更多細節或獲取源碼，請訪問插件目錄或 GitHub 倉庫。
