Continuity Plane

Continuity Plane 是面向长期 AI 辅助软件工作的 provider-neutral 控制面。它把任务、 决定、约束、证据、checkpoint、上下文组合和协作状态放在聊天窗口之外，支持压缩、 任务切换、进程崩溃和多人交接后的确定性恢复。

English README

你可能遇到的事故

已测结果

这些是匹配任务和当前 fixture 的场景级结果，不能合成为所有用户的统一节省率。 用户 token、窗口有效利用率和两次压缩之间的有效工作量，按 accepted Work 归一化， 并在 host trace 可见时计量。完整方法和限制。

架构概览

Agent / IDE / CI / 人类控制台
              |
              v
       Execution Packet
              |
     +--------+---------+
     |                  |
 Typed State        Evidence index
 revision + CAS     hash + validity
     |                  |
     +--------+---------+
              |
      append-only events
              |
      checkpoint + replay canary
              |
          SQLite 默认

Memory、检索系统、代码图和 reviewer 只能提供候选信息；active task、完成状态和外部 副作用必须经过 State MCP 的 authorization、expected revision/CAS 和 validator。

快速开始

要求 Python 3.11 或更高版本。在目标项目目录执行：

python -m pip install .
continuity init --root . --project-id my-project --display-name "My Project"
continuity verify --root .
continuity doctor --root .
continuity state show --root .

初始化会创建 .continuity/、SQLite 状态库以及项目自己的 MASTER.md、STATUS.md 和英文模板。项目应自行决定 project_id 与 display_name。

安装模式

默认路径是 local-embedded。PostgreSQL、Docmost 和 shared-strong 都是可选增强。

权威边界

• Typed State：当前任务、owner、revision、决定、约束和门禁；
• Event Log：append-only 状态变化、supersedes 和 hash chain；
• Checkpoint：压缩、切换、交接和崩溃后的恢复点；
• Evidence：当前源码、标准、官方文档和测试的 provenance；
• MASTER.md：项目级治理意图；STATUS.md：当前恢复路由；
• Docmost：可选的人类控制台，动作受 State MCP 约束；
• Obsidian：生成的只读视图；
• SQLite：默认本地 authority；PostgreSQL：显式选择的 adapter。

文档

• 完整使用教程
• 架构说明
• 配置说明
• Python API
• 实测方法
• 使用场景
• 大型项目视图
• Docmost 与 Obsidian 图形化产品计划
• English README
• 贡献指南
• 安全策略

Release 与许可证

当前 alpha 通过 GitHub Releases 提供 wheel、source archive 和 SHA256SUMS。PyPI Trusted Publishing 尚未配置，因此 当前不要使用 pip install continuity-plane；详见 发布说明。

Continuity Plane 使用 Apache-2.0。badge、README 署名、应用 UI 标签和 telemetry 都是可选的，法律归属以 LICENSE 和 NOTICE 为准。

当前状态

Linux x86_64 已完成 clean-room 安装和本地 alpha 验证。Windows/macOS 原生矩阵、 完整 Docmost connector、Obsidian Canvas/Bases 和 shared-strong 部署仍在后续计划中。