ChainlessChain去中心化个人 AI 管理平台

2026-04-08 更新：文档站已对齐 CLI Agent Runtime 重构、统一 runtime event、session record、后台任务增强、Worktree 合并助手、压缩观测、会话迁移，以及 Coding Agent Phase 5 最小 Harness + 真实 interrupt。

当前验证结果 ​

• CLI 定向单元（含 agent-core / ws-agent-handler / interaction-adapter / abort-utils 真实 interrupt 主线）：175/175
• CLI ws-session-workflow 集成：20/20
• CLI coding-agent-envelope-roundtrip E2E：7/7
• Desktop Coding Agent 主链路（bridge / ipc-v3 / session-service / permission-gate / tool-adapter / 集成 / store / AIChatPage）：9 files, 197/197
• Phase 5 最小 harness 定向回归：5 files, 84/84
• AIChatPage harness 面板 + dot-case 事件页面回归：69/69
• Web Panel 定向单元测试：27/27
• Web Panel 构建：通过
• Docs Site 构建：通过

2026-04-08 文档对齐回归（修改文件全量定向）：

快速开始 ​

方式一：CLI 安装 ​

npm install -g chainlesschain
chainlesschain setup
chainlesschain start

方式二：源码运行 ​

git clone https://github.com/chainlesschain/chainlesschain.git
cd chainlesschain
npm install
npm run dev:desktop-vue

文档导航 ​

• 产品概览
• 快速开始
• CLI 文档
• Agent 架构优化
• Web 管理界面
• WebSocket 服务
• 设计文档索引

当前推荐阅读 ​

如果你是从本轮 Runtime / Web Panel / 协议演进切入，建议优先看下面几页：

• WebSocket 服务
• Web 管理界面
• Agent 架构优化
• 设计模块 69：WebSocket 服务器接口
• 设计模块 73：Web 管理界面
• 设计模块 75：Web 管理面板
• 设计模块 78：CLI Agent Runtime 重构计划
• 设计模块 79：Coding Agent 系统
• Coding Agent 用户文档
• Minimal Coding Agent 实施计划

本轮重点能力 ​

CLI Agent Runtime 重构 ​

• 命令入口正在统一收口到 Runtime / Gateway / Harness 分层。
• WebSocket 协议处理已拆到 gateways/ws，由 dispatcher 统一分发。
• Web Panel 已通过 onRuntimeEvent() 开始消费统一 runtime event。
• session-created、session-resumed、session-list-result 现在都带标准 record。

后台任务增强 ​

• 支持任务历史分页查询、任务详情输出摘要和多节点恢复策略基础能力。
• 任务完成后通过 task:notification 实时推送到 Web Panel。

Worktree 合并助手 ​

• 支持 worktree-diff 预览、worktree-merge 一键合并。
• 冲突结果包含文件级摘要、自动化候选项和预览入口。

压缩策略观测 ​

• 支持 windowMs、provider、model 三个维度筛选。
• Dashboard 展示命中率、节省 Token、策略分布和变体分布。

会话迁移 ​

• 支持旧 JSON 会话迁移到 JSONL。
• 支持 dry-run 报告、抽样校验和失败重试。

Coding Agent Phase 5 最小 Harness 与真实 Interrupt ​

• coding-agent:interrupt 已从 close-session 别名收口为真实中断语义：CLI runtime 通过共享 abort-utils.js + AbortController 终止当前正在执行的 turn，同时保留 session 可继续使用。
• CodingAgentSessionService.getHarnessStatus() 一次性聚合 sessions / worktrees / backgroundTasks 三类概览。
• 新增五条 IPC：harness-status / list-background-tasks / get-background-task / get-background-task-history / stop-background-task，Desktop main → bridge → IPC v3 → preload → renderer store 全链路打通。
• Desktop 聊天页 (AIChatPage.vue) 新增 Coding Agent Harness 面板，展示会话 / worktree / 后台任务概览，支持 Refresh、View Details（详情 + 历史）、Stop Task。
• AIChatPage 已迁移到点分小写事件协议：tool.call.* / assistant.final / approval.* / approval.high-risk.*。

当前架构主线 ​

本轮文档已经把下面这条主线补齐到可阅读状态：

• CLI 入口正在统一收口到 Runtime / Gateway / Harness
• WebSocket 层从“大一统消息处理器”演进为 gateways/ws
• Web Panel 主干页面开始通过 onRuntimeEvent() 消费统一事件
• session / task / worktree / telemetry 开始共享标准 record

如果你想从设计层继续深入，可以直接进入 设计文档索引，再顺着 69、73、75、78 四个模块继续看。