dsh-continuum：DeepSeek Harness 持久化項目狀態與檢查點引擎

前言¶

DeepSeek Harness (DSH) 的核心設計理念是將一切作爲插件。在構建多智能體協作或長時間運行的工作流時，智能體進程本身是臨時的，這意味着上下文窗口耗盡、進程崩潰或超時都會導致狀態丟失。dsh-continuum 旨在解決這一問題，它將 DSH 從一個無狀態的提示運行器轉變爲一個具備持久化項目記憶和容錯能力的工程環境。

插件介紹¶

dsh-continuum 是 DeepSeek Harness (DSH) 的一個生產級市場插件，由開發者 QuantumKuba 維護，採用 MIT 許可證。

它主要解決以下痛點：
* 上下文窗口限制導致的上下文擦除。
* 子智能體崩潰導致的關鍵推理和未提交發現丟失。
* 智能體重複執行昂貴的研究工作。
* 多智能體之間工作內容未協調或相互覆蓋。

核心能力¶

該插件提供以下核心功能：

Deterministic Event Sourcing (events.l)
將所有狀態變化（項目創建、任務聲明、發現、決策、證據）建模爲不可變、嚴格單調排序的事件。系統狀態通過重放事件日誌來推導。
Crash Resilience & Partial Line Recovery
主機進程在寫入過程中崩潰（SIGKILL 或斷電）時，系統能自動檢測不完整的 JSON 片段，安全截斷到上次提交的事件，並繼續操作而不丟失數據。
Liveness-Checked Cooperative Locking
使用帶有防禦性 PID 存在驗證（process.kill(pid, 0)）的協作鎖文件來序列化併發進程寫入。能夠安全地打破已終止進程的鎖，無需危險的超時配置。
Optimistic Concurrency Control (OCC)
實體更新強制嚴格的版本匹配（expectedVersion）。使用過期假設的併發寫入會被拒絕，並拋出類型化的 VersionConflictError，而非靜默覆蓋狀態。
Strict Mutation Idempotency
具有相同 idempotencyKey 的工具調用（網絡故障或重放）返回緩存結果，而不會產生副作用。不同操作的意外鍵衝突會立即觸發 IdempotencyMismatchError。
Renewable Execution Leases
智能體獲取任務時會發放有界租約（例如 10 分鐘）。如果智能體崩潰或放棄任務且未續租，系統會自動將任務釋放回 ready 狀態並增加重試計數。
Four-Eyes Separation of Duty
可配置的任務驗證策略（independent, dual, redteam）從數學上禁止實現任務的智能體對任務進行自我驗證。
Deterministic 10-Tier Context Budgeting
使用嚴格的優先級排名（活躍任務 -> 北極星 -> 阻塞衝突 -> 關鍵發現 -> 最近交接）構建 Token 限制的系統提示。大輸出（>10KB）自動溢出到磁盤。
Untrusted Content Encapsulation
外部網絡抓取、用戶輸入和發現內容會被淨化並封裝在嚴格的 <continuum:untrusted-finding> 邊界內，防止提示注入攻擊。
Cryptographic Backup & Verified Restore
將整個項目導出爲自包含的 .continuum-backup 歸檔，包含 SHA-256 完整性驗證。

安裝與配置¶

可以通過 DSH 插件命令直接安裝：

dsh plugin --profile web add dsh-continuum

插件支持通過 settings.yaml 進行配置。在 DSH Web UI 的 Plugin configuration 中也可實時配置以下項：

dsh-continuum:
  autoInjectContext: true        # 自動將 Context Pack 注入系統提示
  maxContextPackTokens: 8000     # Context Pack 的最大 Token 預算
  defaultLeaseTtlMinutes: 10     # 任務執行租約的 TTL
  storageMode: workspace         # 存儲模式：'workspace' (.continuum/) | 'home' (~/.continuum/) | 'custom'
  customStoragePath: ""          # 如果 storageMode 爲 custom，指定自定義目錄

安裝包包含 cordis.patch.yml，可用於自動配置配置文件中的默認值。

典型用法¶

dsh-continuum 暴露了 7 個第一方工具，定義在 @deepseek-ai/dsh-tools 中。開發者可根據需要調用這些工具管理項目狀態：

工具名稱	常用操作選項	功能描述
`continuum_project`	`init`, `get`, `status`, `history`, `export`	初始化項目、更新北極星需求、導出備份包
`continuum_task`	`create`, `claim`, `renew_lease`, `submit`, `verify`	管理任務全生命週期、續租、提交、四眼驗證
`continuum_memory`	`record_finding`, `record_decision`, `raise_conflict`	記錄事實、架構決策、衝突，附帶證據
`continuum_checkpoint`	`create`, `list`	創建和列出里程碑快照
`continuum_handoff`	`create`, `get_latest`	在智能體角色間安全移交狀態
`continuum_context`	`render`	檢查或重新渲染當前的 Token 限制上下文包
`continuum_status`	`check`	診斷鎖狀態、租約過期情況和事件日誌健康度

併發與安全：
* Actor 身份（id, role）從 exec.agent.id 和運行時上下文安全派生，調用者無法僞造身份。
* 安全的讀取操作（get, history, render, check）需聲明 isConcurrencySafe: true，而修改操作則是串行的。

注意事項¶

Node 版本要求：插件依賴 Node.js 版本 >= 22.19.0。
運行權限：插件以當前 DSH 進程權限運行。在安裝前，請務必檢查源碼與許可證，確保符合安全合規要求。
存儲位置：根據 storageMode 的不同，數據將存儲在項目根目錄的 .continuum/、用戶主目錄的 ~/.continuum/ 或自定義路徑中。

結語¶

dsh-continuum 通過事件溯源、樂觀併發控制和嚴格的上下文預算管理，爲 DSH 提供了類似數據庫的持久化和一致性保證。它讓智能體開發能夠從“一次性腳本”轉向“連續工程”。