前言¶
DeepSeek Harness 使用追加日誌存儲對話。普通的“撤回”操作僅重置上下文，artifact 文件的狀態並不會隨之改變。dsh-retrace 將對話與其 artifact 版本綁定，確保每一次回溯都是合法的，不會破壞日誌結構，也不會產生 token-meter 配對債務。
插件簡介¶
- 名稱: dsh-retrace
- 定位: DeepSeek Harness 客戶端插件，支持 Web 和 Desktop 端
- 核心價值: 爲對話提供 Recall（撤回）、Resend（重發）和 Regenerate（重新生成）功能，並提供 Artifact 版本管理與回滾能力
- 維護者: yamingmou
- 許可證: MIT
核心功能¶
該插件在對話界面提供了三種基礎操作以及一套版本管理機制：
-
Recall (↩)
- 懸停在任意助手回覆上，或用戶消息下方的行上即可觸發。
- 操作前會彈出確認框（這是一次破壞性操作，會移除該消息及其之後的所有內容）。
- 確認後，插件會先通過官方接口暫停當前運行的 Agent，等待（有超時限制）。
- 移除本輪對話（包括輸入文本、助手回覆、工具調用行）。
- 輸入文本會回顯到編輯器中，允許用戶重新提問或編輯。
-
Resend (✎)
- 懸停在任意用戶消息下方的行上即可觸發。
- 主要含義是“從此處重新開始”：重置該消息及之後的所有內容，並在新時間線上繼續對話。
- 如果範圍過大導致無法原地重寫，系統會提供備選方案（僅修改該條消息文本，保留後續內容）。
-
Regenerate (↻)
- 懸停在任意助手回覆上即可觸發。
- 隱藏該回復及之後的所有內容，並重新發送原始 Prompt，讓 Agent 重新回答。
-
Checkpoints & Artifact Rollback
- 每次回溯都會記錄爲 Checkpoint，並在對話視圖中提供 Checkpoints 標籤頁，以大綱形式展示嵌套的歷史記錄。
- 支持 Artifact Rollback，可選擇僅回滾上下文、僅回滾 Artifact 或兩者都回滾，並支持 Dry-run 預覽。
- 支持從 Checkpoint 一鍵跳轉回對話指定位置。
安裝與啓用¶
命令行安裝¶
需要安裝 DeepSeek Harness 的 dsh CLI。安裝後必須重啓 DSH 應用（當前運行的進程不支持熱重載）。
dsh plugin --profile desktop add dsh-retrace
圖形界面安裝¶
如果沒有命令行環境，可以安裝社區插件市場插件，然後在設置中查找並安裝：
dsh plugin --profile desktop add dshmarket
安裝完成後，在 Settings -> Plugin Market 中找到 dsh-retrace 並點擊安裝。
典型用法¶
- 撤回與重新生成: 鼠標懸停在助手回覆上，點擊 ↩ 或 ↻。
- 重發: 鼠標懸停在用戶消息上，點擊 ✎。
注意事項¶
- 重啓要求: 安裝後必須重啓 DSH 應用才能生效。
- 舊版本標記: 對於已經包含舊版本單段標記的會話，已知存在設計債務。在進行
/compact操作前，建議運行配套的check和fix --remove-markers清理這些標記，否則主機自身的預壓縮自檢會阻止壓縮操作。 - 許可協議: 本插件採用 MIT 許可證。
結語¶
dsh-retrace 旨在爲 DeepSeek Harness 提供生產級的對話版本控制能力。若需瞭解更多細節或查看源碼，請訪問其 GitHub 倉庫。
