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 提供了类似数据库的持久化和一致性保证。它让智能体开发能够从“一次性脚本”转向“连续工程”。