ChainlessChain 设计文档

📐

87+ 模块设计

覆盖知识库、社交、交易、AI引擎、安全、企业、去中心化基础设施、Web3、低代码平台、自进化AI、CLI分发系统、CLI高级功能、AI媒体创作、AI文档创作、Web管理界面、Personal Data Hub、iOS Phase 1-6、远程操控 Plan A/B/C、MTC v0.11 联邦等全部子系统的详细设计

🏗️

架构设计

系统整体架构、技术栈选型、数据库设计、IPC通信协议、安全机制等基础架构文档

🔐

安全机制

U盾/SIMKey硬件安全、PQC后量子密码、门限签名、FIDO2、生物识别等安全设计

🤖

AI引擎设计

多代理协作、自主开发、技术学习、推理网络、技能市场等AI子系统架构

🌐

去中心化协议

DID身份、P2P通信、ActivityPub/Nostr/Matrix多协议融合、抗审查网络设计

🏢

企业级功能

RBAC权限、SOC2合规、SCIM用户配置、DLP数据防泄漏、SIEM安全信息管理

快速导航

按角色

角色	推荐阅读
新人开发者	系统设计主文档 → 知识库模块 → 社交模块
安全工程师	安全机制设计 → 统一密钥系统 → 数据防泄漏系统
AI工程师	AI优化系统 → 多代理系统 → 推理网络
运维工程师	生产强化 → 基础设施编排 → SIEM
产品经理	系统设计主文档 → 实施总结
v5.0.0 新模块	IPC域分割 → A2A协议 → 零知识证明 → 低代码平台 → 自进化AI
v5.0.1 新模块	CLI分发系统 → CLI高级功能

角色

推荐阅读

新人开发者

系统设计主文档 → 知识库模块 → 社交模块

安全工程师

安全机制设计 → 统一密钥系统 → 数据防泄漏系统

AI工程师

AI优化系统 → 多代理系统 → 推理网络

运维工程师

生产强化 → 基础设施编排 → SIEM

产品经理

系统设计主文档 → 实施总结

v5.0.0 新模块

IPC域分割 → A2A协议 → 零知识证明 → 低代码平台 → 自进化AI

v5.0.1 新模块

CLI分发系统 → CLI高级功能

版本演进

版本	Phase	核心内容
v1.0.0	1-41	核心功能 + EvoMap
v1.1.0	42-56	企业增强 + 安全扩展
v2.0.0	57-61	生产加固
v3.0.0	62-64	自主AI开发
v3.1.0-v3.4.0	65-77	去中心化AI市场 + 硬件安全生态 + 全球社交 + EvoMap进化
v5.0.0	78-100	架构重构 + AI Agent 2.0 + Web3深化 + 企业平台 + 自进化AI
v5.0.1	101-102	CLI分发系统 + 6维Context Engineering + Autonomous Agent + EvoMap + 10 LLM Providers + 3 Proxy Relays + Task Model Selector + 2009测试
v5.0.2	—	CLI技能包系统(9包) + AI音视频创作模板 + AI文档创作模板 + 5030+测试
v5.0.2.2	—	Web管理界面(chainlesschain ui) + 浏览器端项目/全局AI对话 + 5130+测试
v5.0.2.10	—	Coding Agent Phase 5 + 去中心化社交协议矩阵 + PQC SLH-DSA + MCP HTTP/SSE + CutClaw 视频剪辑 Agent
v5.0.2.34	—	V2 规范层第 1-8 批（SSO / Workflow / Router / Hook / MCP / Coord / A2A / DAO / ZKP / DLP / BI / EvoMap / AP / Matrix / Nostr / Browse / CrossChain / Consol 等 62+ 管家治理表面） + CLI 0.136.0 + 109 命令 + 11700+ 测试
v5.0.2.34 (iter16-21)	—	CLI V2 规范层 iter16-iter21：156+ 治理表面，覆盖 audit / kg / sandbox / sla / stress / terraform / reputation / marketplace / chat / claude-code-bridge / compliance / cowork-learning / cowork-workflow / privacy / token-incentive / hardening / aiops / multimodal / instinct / tenant / quantization / trust / nl-programming / perception / code-agent / collaboration / community / did / sso / org / scim / sync / agent-network / browser / dlp / evomap / federation / ipfs / p2p / wallet / activitypub / matrix / nostr / bi / memory / session / hook / workflow，统一 4-state profile + 5-state lifecycle + auto-suspend-idle + auto-fail-stuck，CLI 0.151.0 + 14255+ 单元 / 696 集成 / 565 e2e
v5.0.2.43 (web-panel A+B)	—	web-panel V5→Web 全量化迁移：Phase A（DID / Knowledge Graph / Project Settings 端到端落地）+ Phase B（Community / Marketplace / Cross-chain / AIOps / Compliance 5 件套全量上线）。每件遵循机械模板 = `<feature>-parser.js`（pure，共享 `stripCliNoise`）+ `<Feature>.vue` + router/sidebar 接线 + parser unit tests + new-pages 路由计数 +1 + 路径断言。配套：侧边栏改为 `<a-sub-menu>` 8 组 + `localStorage` 持久化 + 独立滚动，SPA fallback 测试覆盖率 23 → 34，新增 19 集成测试每命令实跑 `cc serve`。Web Panel 单元测试 27 → 809。Phase B commits: `260787c99` / `792b211e1` / `8f7d87ede` / `30cf3b6ab` / `04c57237d` / `7ee1985c5` / `d43e43a93`
v5.0.2.34 (iter22-28)	—	CLI V2 规范层 iter22-iter28：再增 80 lib-level 治理表面（augov / shgov / dv2gov / kexpgov / kimpgov / llmgov / pqcgov / smgov / rcgov / techgov / rtgov / ntgov / pmgov / pfgov / dbevogov / digov / rcmdgov / mcpgov / ecogov / sklgov / toktgov / devgov / tigov / uebgov / cttgov / ctmgov / clibgov / argov / saregov / todogov / ebgov / evfedgov / plannergov / ctxenggov / sactxgov / iagov / wfexgov / padgov / hlgov / webuigov / dlgov / smcpgov / cmcpgov / stixgov / sapgov / cobsgov / pmgrgov / wscgov / evcligov / poptgov / scsgov / smgrgov / ceadgov / pstrmgov / cohtgov / cadpgov / a2apgov / acrdgov / aecogov / autagov / ccoregov / cmpmgov / crchgov / crygov / daomgov / esysgov / emgrgov / hmemgov / infnetgov / kggov / pipogov / pmodegov），共 220+ V2 治理表面，CLI 0.156.0 + ~5,984 V2 单元测试
v5.0.2.34 (V6 Shell)	—	桌面版 V6 Chat-First Shell（P0–P6 全量落地）：Electron `/v2` 路由 + 三区布局（ShellSidebar / ConversationStream / ArtifactPanel / ShellStatusBar）+ 7 类 UI 扩展点 + 5 类企业 Provider + P6 分发器与 Widget 注册表 + AdminConsole（`Ctrl+Shift+A` / `/admin`）+ 13 个 first-party 内置插件 + `.ccprofile` 签名 + MDM 推送三路径企业定制，22 单测 + 集成全绿
v5.0.2.43	—	SFC 大拆分 + 启动流程拆 Critical/Deferred + Shell 接入真实 LLM：`SystemSettings.vue` 6 级拆分（3444→1070 行 −69%）、`ChatPanel.vue` 工具外提 + `useMemoryLeakGuard`（4057→3788）、`MainLayout.vue` 6 级拆分（3203→1943 −39%）、`DIDManagement.vue` 3 级拆分（1390→543 −61%）；主进程启动拆 `bootstrapCritical` / `bootstrapDeferred`；V6 Preview 壳 ShellComposer 接入 `llm-preview-bridge` 流式真发；600/600 store 单测
v5.0.2.49 → v5.0.2.53	—	`cc pack` 项目打包 + OTA 自更新：`cc pack` 命令首发（基于 @yao-pkg/pkg 单文件可执行）+ `--project` 模式 Phase 2a-3b 全量（BAKED 项目内容 / sanitizeProjectName / Commander 子命令白名单 / 自动 persona / manifest sidecar / `GET /api/skills` 实接线 + smoke-runner 实断言）+ OTA 三段（5a check-update / 5b SHA-256 校验 / 5c POSIX rename + Windows sidecar 自替换）+ Linux x64 流水线 + core-db sql.js WASM ABI probe + V6 Preview 工具/任务 Widget + 全量 v-html / renderMarkdown XSS 收口（DOMPurify）+ 7 个 IPC 契约测试集锁定，CLI 0.156.6→0.156.7
v5.0.3.1 (web-panel A+B+C+D 收官)	—	Web Panel V5→Web 全量化迁移完成 — Phase A (3) + B (10) + C (5) + D (5) = 23 ports，router 28 → 50 (+22)，单元测试 27 → 1489 全绿。Phase A：`/did` + `/knowledge` + `/project-settings`。Phase B：`/community` + `/marketplace` + `/crosschain` + `/aiops` + `/compliance` + `/privacy` + `/inference` + `/nlprog` + `/tenant` + `/pipeline`。Phase C 治理与可观测：`/governance` + `/audit` + `/reputation` + `/recommend` + `/sla`。Phase D 收尾：`/codegen` + `/search` + `/tokens` + `/trust` + `/federation`。每件遵循机械模板 = `<feature>-parser.js`（含共享 `stripCliNoise`）+ `<Feature>.vue` + router/sidebar 接线 + parser unit tests + new-pages 路由计数 +1 + 路径断言。从此 `cc ui` 浏览器端与桌面 Electron 端功能对等。CLI 三次 bundle release `0.157.7` (Phase B done) → `0.157.8` (Phase C done) → `0.157.9` (Phase D done)，每次 `dist/` 资产 hash 同步刷新（`de3da1fd7` / `dc44c91b8` / `589a7acd8` / `1faa9e11f`）。Phase D commits: `fa8479d49` / `da852045d` / `6e1941beb` / `6b7ac0985` / `a7909b8a6`
v5.0.3.2	—	MTC v0.4 + Phase 1.6 SLH-DSA + Phase 4 V6 widget：`cc mtc publish-skills` marketplace publisher（JCS-canonical + SHA-256 fingerprint diff + 自动 seq + 状态文件原子写）；`cc audit mtc` 8 子命令双轨脚手架（每事件实时 Ed25519 + 关批 Merkle inclusion proof，60s/3600s 双合规路径预留）；Phase 1.6 SLH-DSA real signing hard-flip（`--alg slh-dsa-128f` opt-in，FIPS 205 后量子）；Phase 4 V6 preview MTC 状态 widget。`assembleBatch` 抽到 `core-mtc/lib/batch.js` 公用，CLI mtc / audit / 未来发布路径同一条装配代码。222 测试全绿（core-mtc 147 + CLI 64 + V6 widget 11）。CLI 0.159.0
v5.0.3.3	—	MTC v0.5 — Phase 3 federation 全套 + libp2p auto-discovery：Phase 3.1 多签 landmark + `cc mtc federation {join,leave,status}` 本地 registry（atomic write、`wx` race-safe）；Phase 3.2 `cc mtc batch* / publish-skills --federation <id> --threshold <M>` 多签发布；Phase 3.3 `--transport filesystem` 跨进程 drop-zone 发现（NFS/Syncthing/SMB/USB）+ self-signed announce schema `mtc-federation-announce/v1` + TTL-evicting 名册；Phase 3.4 `--transport libp2p` 真 P2P gossipsub topic `mtc-federation/v1/<id>` auto-discovery，`Libp2pTransport` 加 `publishRaw / subscribeRaw` 通用 pubsub（与 landmark 通道隔离）。Backend Q-ENG-2 `OperationLogService` 桥接 `cc audit mtc emit` 写回 `audit_mtc_event_id`（V013 migration），web-panel `Audit.vue` 加 4 态 MTC 列徽章。476 MTC 测试全绿（core-mtc 182 + CLI 89 + desktop 33 + web-panel 153 + backend 19）跨 6 层覆盖。CLI 0.160.0
v5.0.3.4	—	Web Panel i18n M3 全覆盖 + V6 LanguageSwitcher + web-shell opt-out + projects folder picker：i18n M3 一波收 ~25 个视图（Speech/Analytics/Cron/Security/Templates/Search/Audit/McpTools/Backup/Tokens/Mtc/WebAuthn/Community/Wallet/Inference/Organization/Recommend/Federation/Reputation/AIOps/Projects 等），全部接入 vue-i18n 中英双语字典；V6 preview topbar 接入 `LanguageSwitcher`（commit `645b19f30`）；web-shell 加 `--no-web-shell` dev opt-out + settings-authoritative precedence（`9119bdec1`）；projects 加 folder picker 走 `cc init --cwd` 完成"打开已有文件夹"流（`c935a95d4`）。CLI 0.160.1
v5.0.3.135（P2-14 / P2-16 收口）	—	CLI 0.162.189 + IDE 协作控制正式发布：P2-14 在 Process Broker 管理的声明 workspace writer 范围内提供持久 checkpoint、分层 coverage 与失败/取消/超时后的 fenced rollback/recovery；P2-16 完成本地 v6 authority、分布式 queue v1、团队预算、lease/CAS fencing、wall lifecycle fence、两阶段 worktree 清理、交互式裁决/安全恢复及三平台长期 soak。VS Code 0.37.37 与 JetBrains 0.4.76 以只读投影呈现 Agent Team 状态，所有权威变更继续由 CLI 执行。CLI release SHA `2607af0dad`；IDE release SHA `33e4d512d3`。

版本

Phase

核心内容

v1.0.0

1-41

核心功能 + EvoMap

v1.1.0

42-56

企业增强 + 安全扩展

v2.0.0

57-61

生产加固

v3.0.0

62-64

自主AI开发

v3.1.0-v3.4.0

65-77

去中心化AI市场 + 硬件安全生态 + 全球社交 + EvoMap进化

v5.0.0

78-100

架构重构 + AI Agent 2.0 + Web3深化 + 企业平台 + 自进化AI

v5.0.1

101-102

CLI分发系统 + 6维Context Engineering + Autonomous Agent + EvoMap + 10 LLM Providers + 3 Proxy Relays + Task Model Selector + 2009测试

v5.0.2

—

CLI技能包系统(9包) + AI音视频创作模板 + AI文档创作模板 + 5030+测试

v5.0.2.2

—

Web管理界面(chainlesschain ui) + 浏览器端项目/全局AI对话 + 5130+测试

v5.0.2.10

—

Coding Agent Phase 5 + 去中心化社交协议矩阵 + PQC SLH-DSA + MCP HTTP/SSE + CutClaw 视频剪辑 Agent

v5.0.2.34

—

V2 规范层第 1-8 批（SSO / Workflow / Router / Hook / MCP / Coord / A2A / DAO / ZKP / DLP / BI / EvoMap / AP / Matrix / Nostr / Browse / CrossChain / Consol 等 62+ 管家治理表面） + CLI 0.136.0 + 109 命令 + 11700+ 测试

v5.0.2.34 (iter16-21)

—

CLI V2 规范层 iter16-iter21：156+ 治理表面，覆盖 audit / kg / sandbox / sla / stress / terraform / reputation / marketplace / chat / claude-code-bridge / compliance / cowork-learning / cowork-workflow / privacy / token-incentive / hardening / aiops / multimodal / instinct / tenant / quantization / trust / nl-programming / perception / code-agent / collaboration / community / did / sso / org / scim / sync / agent-network / browser / dlp / evomap / federation / ipfs / p2p / wallet / activitypub / matrix / nostr / bi / memory / session / hook / workflow，统一 4-state profile + 5-state lifecycle + auto-suspend-idle + auto-fail-stuck，CLI 0.151.0 + 14255+ 单元 / 696 集成 / 565 e2e

v5.0.2.43 (web-panel A+B)

—

web-panel V5→Web 全量化迁移：Phase A（DID / Knowledge Graph / Project Settings 端到端落地）+ Phase B（Community / Marketplace / Cross-chain / AIOps / Compliance 5 件套全量上线）。每件遵循机械模板 = <feature>-parser.js（pure，共享 stripCliNoise）+ <Feature>.vue + router/sidebar 接线 + parser unit tests + new-pages 路由计数 +1 + 路径断言。配套：侧边栏改为 <a-sub-menu> 8 组 + localStorage 持久化 + 独立滚动，SPA fallback 测试覆盖率 23 → 34，新增 19 集成测试每命令实跑 cc serve。Web Panel 单元测试 27 → 809。Phase B commits: 260787c99 / 792b211e1 / 8f7d87ede / 30cf3b6ab / 04c57237d / 7ee1985c5 / d43e43a93

v5.0.2.34 (iter22-28)

—

CLI V2 规范层 iter22-iter28：再增 80 lib-level 治理表面（augov / shgov / dv2gov / kexpgov / kimpgov / llmgov / pqcgov / smgov / rcgov / techgov / rtgov / ntgov / pmgov / pfgov / dbevogov / digov / rcmdgov / mcpgov / ecogov / sklgov / toktgov / devgov / tigov / uebgov / cttgov / ctmgov / clibgov / argov / saregov / todogov / ebgov / evfedgov / plannergov / ctxenggov / sactxgov / iagov / wfexgov / padgov / hlgov / webuigov / dlgov / smcpgov / cmcpgov / stixgov / sapgov / cobsgov / pmgrgov / wscgov / evcligov / poptgov / scsgov / smgrgov / ceadgov / pstrmgov / cohtgov / cadpgov / a2apgov / acrdgov / aecogov / autagov / ccoregov / cmpmgov / crchgov / crygov / daomgov / esysgov / emgrgov / hmemgov / infnetgov / kggov / pipogov / pmodegov），共 220+ V2 治理表面，CLI 0.156.0 + ~5,984 V2 单元测试

v5.0.2.34 (V6 Shell)

—

桌面版 V6 Chat-First Shell（P0–P6 全量落地）：Electron /v2 路由 + 三区布局（ShellSidebar / ConversationStream / ArtifactPanel / ShellStatusBar）+ 7 类 UI 扩展点 + 5 类企业 Provider + P6 分发器与 Widget 注册表 + AdminConsole（Ctrl+Shift+A / /admin）+ 13 个 first-party 内置插件 + .ccprofile 签名 + MDM 推送三路径企业定制，22 单测 + 集成全绿

v5.0.2.43

—

SFC 大拆分 + 启动流程拆 Critical/Deferred + Shell 接入真实 LLM：SystemSettings.vue 6 级拆分（3444→1070 行 −69%）、ChatPanel.vue 工具外提 + useMemoryLeakGuard（4057→3788）、MainLayout.vue 6 级拆分（3203→1943 −39%）、DIDManagement.vue 3 级拆分（1390→543 −61%）；主进程启动拆 bootstrapCritical / bootstrapDeferred；V6 Preview 壳 ShellComposer 接入 llm-preview-bridge 流式真发；600/600 store 单测

v5.0.2.49 → v5.0.2.53

—

cc pack 项目打包 + OTA 自更新：cc pack 命令首发（基于 @yao-pkg/pkg 单文件可执行）+ --project 模式 Phase 2a-3b 全量（BAKED 项目内容 / sanitizeProjectName / Commander 子命令白名单 / 自动 persona / manifest sidecar / GET /api/skills 实接线 + smoke-runner 实断言）+ OTA 三段（5a check-update / 5b SHA-256 校验 / 5c POSIX rename + Windows sidecar 自替换）+ Linux x64 流水线 + core-db sql.js WASM ABI probe + V6 Preview 工具/任务 Widget + 全量 v-html / renderMarkdown XSS 收口（DOMPurify）+ 7 个 IPC 契约测试集锁定，CLI 0.156.6→0.156.7

v5.0.3.1 (web-panel A+B+C+D 收官)

—

Web Panel V5→Web 全量化迁移完成 — Phase A (3) + B (10) + C (5) + D (5) = 23 ports，router 28 → 50 (+22)，单元测试 27 → 1489 全绿。Phase A：/did + /knowledge + /project-settings。Phase B：/community + /marketplace + /crosschain + /aiops + /compliance + /privacy + /inference + /nlprog + /tenant + /pipeline。Phase C 治理与可观测：/governance + /audit + /reputation + /recommend + /sla。Phase D 收尾：/codegen + /search + /tokens + /trust + /federation。每件遵循机械模板 = <feature>-parser.js（含共享 stripCliNoise）+ <Feature>.vue + router/sidebar 接线 + parser unit tests + new-pages 路由计数 +1 + 路径断言。从此 cc ui 浏览器端与桌面 Electron 端功能对等。CLI 三次 bundle release 0.157.7 (Phase B done) → 0.157.8 (Phase C done) → 0.157.9 (Phase D done)，每次 dist/ 资产 hash 同步刷新（de3da1fd7 / dc44c91b8 / 589a7acd8 / 1faa9e11f）。Phase D commits: fa8479d49 / da852045d / 6e1941beb / 6b7ac0985 / a7909b8a6

v5.0.3.2

—

MTC v0.4 + Phase 1.6 SLH-DSA + Phase 4 V6 widget：cc mtc publish-skills marketplace publisher（JCS-canonical + SHA-256 fingerprint diff + 自动 seq + 状态文件原子写）；cc audit mtc 8 子命令双轨脚手架（每事件实时 Ed25519 + 关批 Merkle inclusion proof，60s/3600s 双合规路径预留）；Phase 1.6 SLH-DSA real signing hard-flip（--alg slh-dsa-128f opt-in，FIPS 205 后量子）；Phase 4 V6 preview MTC 状态 widget。assembleBatch 抽到 core-mtc/lib/batch.js 公用，CLI mtc / audit / 未来发布路径同一条装配代码。222 测试全绿（core-mtc 147 + CLI 64 + V6 widget 11）。CLI 0.159.0

v5.0.3.3

—

MTC v0.5 — Phase 3 federation 全套 + libp2p auto-discovery：Phase 3.1 多签 landmark + cc mtc federation {join,leave,status} 本地 registry（atomic write、wx race-safe）；Phase 3.2 cc mtc batch* / publish-skills --federation <id> --threshold <M> 多签发布；Phase 3.3 --transport filesystem 跨进程 drop-zone 发现（NFS/Syncthing/SMB/USB）+ self-signed announce schema mtc-federation-announce/v1 + TTL-evicting 名册；Phase 3.4 --transport libp2p 真 P2P gossipsub topic mtc-federation/v1/<id> auto-discovery，Libp2pTransport 加 publishRaw / subscribeRaw 通用 pubsub（与 landmark 通道隔离）。Backend Q-ENG-2 OperationLogService 桥接 cc audit mtc emit 写回 audit_mtc_event_id（V013 migration），web-panel Audit.vue 加 4 态 MTC 列徽章。476 MTC 测试全绿（core-mtc 182 + CLI 89 + desktop 33 + web-panel 153 + backend 19）跨 6 层覆盖。CLI 0.160.0

v5.0.3.4

—

Web Panel i18n M3 全覆盖 + V6 LanguageSwitcher + web-shell opt-out + projects folder picker：i18n M3 一波收 ~25 个视图（Speech/Analytics/Cron/Security/Templates/Search/Audit/McpTools/Backup/Tokens/Mtc/WebAuthn/Community/Wallet/Inference/Organization/Recommend/Federation/Reputation/AIOps/Projects 等），全部接入 vue-i18n 中英双语字典；V6 preview topbar 接入 LanguageSwitcher（commit 645b19f30）；web-shell 加 --no-web-shell dev opt-out + settings-authoritative precedence（9119bdec1）；projects 加 folder picker 走 cc init --cwd 完成"打开已有文件夹"流（c935a95d4）。CLI 0.160.1

v5.0.3.135（P2-14 / P2-16 收口）

—

CLI 0.162.189 + IDE 协作控制正式发布：P2-14 在 Process Broker 管理的声明 workspace writer 范围内提供持久 checkpoint、分层 coverage 与失败/取消/超时后的 fenced rollback/recovery；P2-16 完成本地 v6 authority、分布式 queue v1、团队预算、lease/CAS fencing、wall lifecycle fence、两阶段 worktree 清理、交互式裁决/安全恢复及三平台长期 soak。VS Code 0.37.37 与 JetBrains 0.4.76 以只读投影呈现 Agent Team 状态，所有权威变更继续由 CLI 执行。CLI release SHA 2607af0dad；IDE release SHA 33e4d512d3。

源文件位于 docs/design/，本站点通过同步脚本自动构建

ChainlessChain系统设计文档