前言¶
DeepSeek Harness（DSH）的會話是追加型的事件日誌。當調度器在工具調用期間拋出異常，且 tool/call 被持久化但 tool/result 未被記錄時，會話會產生“提供者可見的轉錄缺陷”。後續的模型請求會因協議錯誤（如缺少工具結果）而失敗，且單純發送新消息無法修復這種已損壞的歷史記錄。需要一種機制來診斷這些缺陷，並從安全的邊界繼續。
插件定位¶
dsh-session-integrity 是一個用於診斷 DeepSeek Harness 會話完整性故障並提供非破壞性恢復的插件。它旨在區分提供者可見的轉錄缺陷與已被壓縮隱藏的原始執行缺口，並找到安全的恢復邊界。
- 名稱：dsh-session-integrity
- 所有者：DON738110198
- 類別：工作流
- 許可證：MIT
核心功能¶
該插件提供以下能力：
- 會話掃描：在會話加載時以及在回合結束時掃描實時會話。
- 離線診斷：通過 CLI 檢查導出的 JSON 或未壓縮的 JSONL，無需啓動模型請求。
- 缺陷分離：將提供者可見的轉錄缺陷與已被壓縮隱藏的原始執行缺口區分開。
- 隱私報告：使用哈希引用報告，省略提示詞、工具參數和工具結果。
- 恢復規劃：找到最新已完成的前綴，該前綴仍可安全發送給提供者。
- Web 集成：在 Web 插件中爲歷史助手回合添加“從這裏繼續”。它創建一個分叉（fork）會話，同時保留原始會話。
- 安全操作：分析器和規劃器爲只讀。恢復使用 Harness 的公共 Fork API，而不是重寫持久化歷史記錄。
- 安全契約：永不突變、破壞、刪除或替換源會話中的事件。恢復通過 Fork API 創建子會話。它從不重試工具，也不聲稱外部副作用已回滾。
安裝與啓用¶
通過官方插件命令安裝。安裝後，插件會在會話加載時檢查會話，並在回合結束時再次檢查。
dsh plugin --profile web add github:DON738110198/dsh-session-integrity#v0.2.1
dsh --profile web --dump-config
dsh --profile web
典型用法¶
插件通過 CLI 執行，支持掃描和恢復模式。
掃描會話完整性：
dsh plugin --profile web exec dsh-session-integrity ./session.l
dsh plugin --profile web exec dsh-session-integrity ./session.l -- > integrity-report.
生成恢復計劃：
dsh plugin --profile web exec dsh-session-integrity recover ./session.l -- > recovery-plan.
dsh plugin --profile web exec dsh-session-integrity recover ./session.l --at 42
注意：恢復命令輸出計劃，不修改源文件或實時會話。
適用場景與注意事項¶
- 適用場景：當模型請求因協議錯誤（如缺少工具結果）而失敗，且懷疑是會話歷史被破壞時。
- 注意事項：
- 插件以當前 DSH 進程權限運行。
- 插件不實現硬刪除；當前公共持久化服務沒有後端獨立的會話刪除操作。
- 包未發佈到 npm；因此不支持
npx dsh-session-integrity。 - Zstandard 日誌未獨立解碼；使用 Harness 導出或未壓縮後端。
- 該插件通過 Harness 的 Fork API 創建子會話，而非重寫歷史記錄，因此不承諾回滾外部副作用。
生態背景¶
DeepSeek Harness 理念是“一切皆插件”。社區目錄（如 SkillHub）提供了插件索引，但與 DeepSeek 或幻方無官方從屬關係。外部貢獻目前通過 Discussions、插件和社區支持路由，而非外部 Pull Requests。
短結尾¶
dsh-session-integrity 提供了診斷會話缺陷和生成安全恢復計劃的原語，無需修改源會話。它通過 Fork API 將風險降至最低，確保原始數據保持完整。更多細節請參考 GitHub 倉庫。
