CLI Runtime 当前实现核对(Agent Platform 0.166.30)
更新时间:2026-09-07。完整门禁的生产推荐版与 npm
latest均为 Agent Platform0.166.30,绑定不可变 tagv-npm-0-166-30的精确 SHA87ddf8b12625086e9666fedb054f0d67a7b8038d。该 SHA 的 Linux/Windows/macOS CLI CI、Strict Sandbox、IDE、Trusted Publishing 与公共安装回读均已闭环。TypeScript/Python Agent SDK0.2.8、Agent Protocol0.1.8、Session Core0.3.12、Open VSX0.37.87与 JetBrains Marketplace0.4.113已公开。
2026-09-07 增量:原子模型配置、页面化工作台与聚焦恢复
cc llm configure 通过有界 stdin JSON 原子保存 provider、model、base URL、vision model 与密钥,密钥不进入 argv;端点改变时不会复用旧密钥,并可选择 auto、keychain 或 file 存储。OpenAI-compatible、Anthropic、Gemini 与 Ollama 使用原生协议探测,拒绝重定向并在 20 秒后超时。
VS Code 0.37.87 提供页面优先的 Workbench 总览/版本列表、可分页筛选的只读 Skill Library 与自定义连接入口;JetBrains 0.4.113 已公开并内置推荐 CLI 0.166.29。CLI 同时承接读取游标恢复、重复输出抑制、长时间探索后的聚焦恢复和可靠 Stop。
当前 main@5db62db246 还包含 Desktop 受治理模型入口及 trust-epoch witness 验签缓存。这是 0.166.30 之后的源码增量,不属于 npm tarball 或已公开 Desktop 安装包。
2026-09-06 增量:长任务与治理恢复
交互式流式 Agent 不再因默认 50 次模型调用上限中断长任务;显式轮次、费用和会话预算继续生效,无人值守任务仍保留默认上限。大文件读取按字节/行游标分页,压缩后保留最新读取位置,未变化页避免重复注入;慢命令期间 IDE 会话继续保活。
受治理演进补齐持久 Workbench 审核/回滚与启动恢复、知识候选独立隔离/拒绝、跨 Wiki 多级来源撤销和 tombstone 恢复、Skill/Prompt/Hook 制品发布与受控市场候选安装。启动仅补记已发生的效果,未执行计划保持待处理;候选安装不会直接激活 Skill。真实身份、签名、策略、KMS/PKI、witness、grader 和目标环境验收仍由部署方提供。
Open VSX 0.37.84 已公开,新增 chainlesschain.chat.maxTurns(0 跟随 CLI 交互默认;正整数限制每条消息的模型轮次)。JetBrains Marketplace 0.4.111 已公开,其内置 CLI 推荐仍为 0.166.22;源码中的 v2 批审回执支持尚未随新的 JetBrains 制品发布。Session Core 0.3.12、Core DB 0.1.5 已公开,TS/Python SDK 0.2.8 与 Protocol 0.1.8 保持独立版本。
版本与证据边界
0.166.30是当前生产推荐与 npmlatest。v-npm-0-166-30精确指向87ddf8b12625086e9666fedb054f0d67a7b8038d;同一发布提交的三平台 CLI CI34079589530、CLI Strict Sandbox34079589387、npm Trusted Publishing/public-install34079589427与 IDE Extensions34085825725均成功。@chainlesschain/agent-sdk@0.2.8、chainlesschain-agent-sdk==0.2.8与@chainlesschain/agent-protocol@0.1.8已公开;SDK 与 Protocol 保持独立安装和发版边界。Session Core0.3.12与 Context/Memory Kernel0.1.0也已完成 npm 回读。0.162.200是上一完整门禁基线,并完整承接上传前失败的0.162.199候选;v-npm-0-162-199保持不可变,不移动或伪造成已发布版本。0.162.193继续作为非权威发布历史审计记录保留。0.163.2完整承接0.163.1,并公开显式 MCP runtime identity、Linux descriptor-bound 固定 npm/Node capsule、Windows 一次性 restricted-token/AppContainer authority、macOS 无法证明原子 image binding 时的类型化失败闭合,以及恶意宿主证据 v4。unsigned 六目标原生 validation 仍不等于签名 Desktop/native 发行完成。0.163.3进一步公开默认后台 worktree、generation/token-fenced supervisor、grammar-safe detached argv、MCP source policy/cwd authority、Linux plugin 全树逐文件封存与 Windows adapter artifact 安全回收;其剩余边界不外推为任意 shared-library closure、macOS atomic exec、远端 revoke 或签名 native 发行。0.163.5公开 host-ownedSchedulerRuntime,并把 Routine manual/cron/once、Agenda wakeup/cron 与 Cowork Cron 接到统一内核;durable microcompact checkpoint 同时进入发布。terminal evidence 可以在崩溃后安全补结算,start-only 或副作用后持久化失败固定为 outcome-unknown,不外推为全局 exactly-once。0.163.6完成 Agenda monitor、Loop、Automation cron、Routine GitHub、channel event 与 standalone daemon 的 adapter 迁移,并统一权限/预算 authority 及 Agenda/Cowork 的 timezone/DST/missed-run 语义。0.163.7正式公开 outcome-unknown 人工裁决、五域 migration journal 与受治理回滚、因果交付报告、call-ledger 预算和后台恢复权威加固。裁决与回滚均依赖精确证据/CAS;它们不扩张为跨独立存储的原子事务或语义因果证明。0.163.8正式承接确定性 scheduler disk-fault matrix、checkpoint-aware Automation pause/resume、incident retry/cancel、受治理多 Agent merge review、只读 MCP resource templates 与 transaction-time lease clock。首个 formal soak run31807830251因 Windows worker 提前退出而无效;后继 exact-main run31821080101三平台及 aggregate 全部成功并定义新T0,正式计数为1/4,其余三个 segment 与 72 小时 campaign verifier 尚未完成。0.164.0正式包含原生/paste-image、作用域权限/副作用证据、执行位置与 workflow definition identity、受治理插件市场、后台 keeper 与 MCP capsule 证据加固。Linux dynamic-native 与 macOS signed launcher 仍是有限声明/禁用候选,不外推为任意 shared-library closure 或签名 native 发行闭环。0.166.0完整承接既有回环默认 Remote Control、Marketplace/Artifact/会话/MCP/沙箱契约,并新增 canonical Agent Protocol、多语言 codegen、CC App Server、统一 Agent Kernel 接入、durable Graph Kernel、Graph trace/eval、cc execfacade、Record & Replay 原型与 Webhook 验签。0.166.1协同公开 Agent SDK0.2.1与 Agent Protocol0.1.1,继续分离 CLI、SDK、Protocol 的安装和发布证据。0.166.2为真实cc team --agent子进程注入宿主私有team_send、team_receive、team_ack、team_followup工具;TeamMailbox v3 提供稳定 consumer、至少一次投递、幂等、read/processed/dead-letter 与--statecheckpoint。桥接调用重验 holder/task/attempt/lease/fence,凭据不进入 prompt 且不可继承。0.166.4在 custody handoff、SessionMessageFabric 与结构化审批之上,公开 37 类 canonical Agent stream discriminator、typed envelope 与严格 validator;协议与两套 SDK 协调升级为0.1.4/0.2.3。0.166.5公开 37 类事件的 payload discriminated union、四语言/主要客户端消费、跨端 causal conformance、Desktop/VS Code 固定能力 App Server pilot 与实验 WebSocket;协议与两套 SDK 升级为0.1.5/0.2.4。- npm
0.166.6进一步有界化 Agent IPC 全局/per-agent 数量、stdio frame/queue 和 timeout,以及旧 WS/MCP/browser/P2P/permission/media/signing backlog;其精确发布闭环已完成,并由0.166.7承接。 0.166.7在上述边界上完成 entry-scoped Graph store、cutover ledger、migration/canary gate 与跨平台真实 journey;已切换 CLI 入口的 legacy mutation 失败闭合,authority、revision、lease/fence 与恢复证据由 canonical Graph writer 结算。0.166.8是未单独发布的源码候选,增加耐久 Graph history、quorum HumanTask、definition migration/retirement evidence、Team fairness、temporal message reliability 与跨端审批 single-winner CAS;全部由公开0.166.9承接。0.166.9新增真实 Playwright UI replay 与三平台 network-escape probe;可选 Codex App Server adapter 改为 exact-version allow-list,未知/预发布版本在 turn admission 前回退codex exec --json。同一 exact SHA 的 Record Replay、Codex compatibility 与 Desktop signed-Skill qualification 专项门均成功。0.166.12公开 Context/Memory Kernel、耐久 rollout store 与 Hooks v2 收敛;0.166.13关闭 renderer IPC、默认 sandbox/审批与高风险进程审计的 P0 绕过;0.166.14恢复 Windows Docker-optional 普通启动并保持显式隔离失败闭合;0.166.15再统一 formal quality control/candidate 的冻结文件工具上限,同时保留失败证据与完整 soak 时长。main@458b342f5f的瞬态审计读取重试、Windows formal quality Agent 独立 HOME/config/cache、CI 清理稳定性和最终1.65平台时延比上限晚于v-npm-0-166-15。固定 SHAdb53dc2da4的 run33411796790未变为成功,也没有最终 SHA 的三平台 aggregate success/OIDC attestation;发布负责人依据 Windows1.6379980224 <= 1.65、全部功能/安全指标通过及离线加权 aggregate0.6008293973 < 1.5显式接受剩余证据风险并关闭 P2-3。该关闭不继承0.166.15发布授权,也不构成通用豁免先例。cc serve --app-server默认以 stdio JSON-RPC 暴露 initialize、thread start/read/resume/fork、turn start/interrupt、item/approval 通知;默认 JSONL rollout,SQLite 由运行时能力门控,有界队列在过载时失败闭合。--app-server-websocket是强制 token、远程 TLS 与固定子协议的实验入口。cc team graph inspect|diff|eval从 append-only GraphRun 事件生成 Agent/Task/Artifact/Message/Effect/Timeline 投影、time travel、blocked root 与阈值报告;默认不输出 Message/HumanTask 内容。- IDE 当前公开版本为 Open VSX
0.37.87与 JetBrains Marketplace0.4.113;VS Code 提供页面化 Workbench、只读 Skill Library 与自定义模型连接,双端仍保持 CLI-authoritative 投影。微软 VS Code Marketplace 仍未发布。 - CLI/SDK/Protocol 当前公开组合为
0.166.30/0.2.8 TS + 0.2.8 Python/0.1.8。Desktop 签名/Skill 资格、真实 UI replay、Codex compatibility 与当前 Desktop 模型入口源码都有各自证据边界,不能替代公共 native 分发、生产 relay 或真实 provider 验收。
2026-09-04 受治理 Skill 与知识 evolution 公开基线
早期 source-only 快照已由 0.166.21 的持久组合取代:
createAgentEvolutionRuntimeComposition()显式组合 encrypted Raw、evidence projector、ArtifactPorts、EvolutionRunLedgerAdapter、真实文件 Ledger 与 durable witness;测试密钥、环境变量和客户端 payload 不能隐式启用。- 交互 REPL、单轮/stream headless 与
AgentRuntime已接 branded ingress;canonical Graph 和 legacy WebSocket Agent 提供宿主 factory 接线缝。 - Wiki revision、四层 Memory、human-review packet/decision 与 Candidate/Eval/HumanTask registry transition 共用 ArtifactPorts + Ledger,并覆盖 response-loss、进程重启和 commit/settlement crash recovery。
- legacy candidate/release/state ledger 具有 tenant migration、journal、baseline/current projection、启动 reconciliation 和四阶段 fault matrix。
- 不可达 simulator/IPC 已退役,公式 learning 路径保持 metrics-only。
- Evolution Workbench、digest-bound Skill Retrieval、governed knowledge conflict/merge 与持久 trust ledger 已接 canonical host;客户端只提交 exact intent。
仓库闭环仍不等于目标环境已配置生产 KMS/PKI/identity/policy/witness/scheduler/transition authority,也不等于真实跨平台 grader、最终用户 review/promote/rollback UI 或 unattended active promotion 已开放。
当前边界
CLI 运行时由命令分发、会话生命周期、受控执行与回滚、Agent Team authority、扩展运行时、事件总线和可观测出口共同组成。
cc entry
├─ command manifest + lazy dispatch
├─ foreground / background agent runtime
│ ├─ local attach transport (NDJSON / TCP fallback)
│ ├─ canonical transcript / compaction / resource-budget authority
│ └─ interactive clipboard-image adapter → bounded vision content
├─ process-execution-broker
│ ├─ platform sandbox + native execution attestation
│ ├─ credential agent
│ └─ managed workspace transaction + checkpoint restore saga/recovery
├─ plugin runtime
│ ├─ manifest capability + sandbox policy
│ ├─ hooks / MCP / LSP / monitors / native bins
│ └─ lifecycle + signature / SBOM / source provenance
├─ controlled Skill boundary
│ └─ isolated child → read_file / search_files / list_dir only
├─ durable event + interaction journal
├─ scheduler kernel
│ ├─ versioned SQLite contract + revision-CAS jobs/occurrences/history
│ ├─ host-owned runtime + owner/fence claims + lease heartbeat
│ ├─ adapters: Routine / Agenda / Cowork / Automation / Loop
│ ├─ shared authority: exact capabilities + revision-bound budgets
│ ├─ adjudication + migration/rollback: evidence CAS + monotonic decisions
│ └─ source-only runtime recovery: checkpoint pause/resume + incident requeue
├─ Agent Team authority
│ ├─ local state v6 + distributed queue v1
│ ├─ budget / lease / worktree / adjudication fences
│ └─ merge-review: file/hunk decision + atomic publish/rollback evidence
├─ bounded usage + retry attribution
├─ MCP ws/wss + uncertain-outcome recovery authority
│ ├─ stdio runtime identity + source policy/workspace authority → Broker
│ └─ bounded resources + resource-template discovery cache
├─ Auto mode safety classifier
├─ OTLP traces + metrics exporter
└─ session hooks (Setup / Notification / lifecycle)0.162.198 → 0.164.0 发布增量
交互输出与发布可移植性:REPL、headless streaming、provider pacing 与 TTY writer 在输出饱和时等待 drain,并在完成、中断和会话切换时清理监听器;Windows path alias、状态路径、Skill metadata、POSIX executable bit 与兼容 shim 夹具已对齐三平台 CLI CI / Strict Sandbox。
Canonical Workbench 路由:CLI-owned session projection 与有界 reply/action route 支持 VS Code / JetBrains Workbench 和 rewind journey,同时保持所有持久 mutation 的 CLI authority。
观察基线:
0.162.198是包含当前 OTLP 接线的首个明确公开命令生命周期观察基线。下面的配置、MCP、session/budget、native update 与 checkpoint 能力继承自0.162.197,并随本版本继续公开。0.162.200会话与 MCP 权威:canonical session host lease、transcript witness、anti-rollback anchor、CAS 持久化与有界清理已经公开;npm-backed MCP launcher 固定到精确版本和完整传递闭包,物化为受守护、内容寻址的 Node capsule;Windows/POSIX 原生更新恢复保持 generation、锁与路径身份。0.163.0macOS PTY 与原生宿主:postinstall 只对窄范围解析出的 regular-filenode-ptyhelper 修复并验证执行位,拒绝 symlink;六个 Linux/Windows/macOS x64/ARM64 目标使用匹配架构 runner 并要求产物在自身架构执行。0.163.1可靠性与打包:公开有界长会话压缩、live session tail durable-witness 竞态修复、Windows MCP 原子启动、可复现 Web Panel 构建、Node 22 standalone 基座、跨平台可靠性探针和原生发行凭据 preflight。0.163.2MCP capsule:stdio 配置显式声明 runtime kind;Linux descriptor-bound capsule、Windows 一次性 Broker-private authority 与 macOS typed fail-closed boundary 分别记录真实平台能力,不把 pathname snapshot 冒充原子 code identity。0.163.3后台 Agent 隔离:干净 Git checkout 的非stream-json后台运行默认从 committedHEAD创建 worktree;--worktree使用同一路径,--no-worktree才共享 checkout。版本化脱敏 launch profile、worker generation claim、terminal-absorbing update、durable turn intent 与 stop/cleanup fence 共同约束状态与回收。0.163.3MCP/插件平台边界:source-requiredfilesystem/network与可信 workspace/cwd 贯通 Broker;Linux strict plugin/native 树逐目录 FD 遍历后把普通文件封为独立 sealed snapshot;Windows helper/cache/test artifact 绑定经 canonical/reparse/identity 复验的 run-owned root,未知项失败闭合并保留现场。0.163.4capsule build/evidence:exact-package 输入进入 immutable WASM VFS,builder 受内存上限约束;平台 live gate 把 runtime/entry/native asset、sandbox capability 与 trace context 绑定到同一证据链。scheduler-kernel v1 store 提供版本化 schema、expected-revision CAS、logical occurrence 去重、durable claim 与 history。0.163.5scheduler runtime:统一 runtime 注册按 kind 隔离的 adapter,执行前复验 snapshot-bound authority,领取 owner/fence lease 并心跳续租,以有界 retry/dead-letter/terminal settlement 结束 occurrence。Routine manual/cron/once、Agenda wakeup/cron 和 Cowork Cron 已进入正式契约。0.163.5durable microcompact:持久化前移除瞬态 runtime marker,保存 compact checkpoint,并在 REPL/Agent 恢复时重建状态且保持 Process Broker trace 传播。0.163.6调度收敛:Agenda monitor、Loop、Automation cron、Routine GitHub、scope-checked channel event 与 standalone daemon 进入共享 scheduler service;Agenda/Cowork cron 持久化规范 IANA timezone,并对 DST gap/repeated minute 与停机错过触发采用一致且有界的处理。0.163.6authority 与控制面:Agenda、Routine、Cowork、Automation、Loop 对 exact capability policy revision 进行执行前复验,并用同一事务 reservation/settlement 约束 run/unit 预算;Automation Center 的 flow/Routine 动作必须经过 CLI-owned projection、preflight 与 revision CAS。0.163.7migration/rollback:五域迁移以 schema-v5 journal 绑定 source locator、source/target digest、retirement fence 与恢复阶段;回滚先停止或恢复 target,再按最新 evidence digest、交互 TTY 和 exact typed challenge 恢复 legacy source。Windows/UNC identity、Automation 原生 SQLite 与 Loop retirement marker 均失败闭合。0.163.7裁决与因果观测:*_OUTCOME_UNKNOWN只在停 host、排空 dispatch、外部核验后接受 evidence digest + attempt + fence CAS;confirmed_applied不重放,confirmed_not_applied只放行一次有界 claim。delivery report 绑定 transcript head/event count 与 diff/gate/artifact/PR/merge revision,call-ledger 对未知 token/cost/retry/tool-latency 不按零处理。0.163.8恢复与持久化:Agenda/Cowork 写入使用 private temp、完整 short-write、file/directory fsync 与 atomic rename;Automation runtime/incident mutation 绑定 exact fence、control revision、capability 和 dead-letter evidence。claim、renew、settlement 的 lease clock 在写事务内读取,避免排队时间污染裁决。0.163.8Agent Team merge review:cc team merge-review preview|show|apply|rollback把候选 branch、base identity、稳定 file/hunk id、选择、actor/reason、revision、plan/evidence digest 与冲突持久化到仓库外 owner-only 状态。发布使用受控临时 branch 与原子引用更新;Git hook/config/env、branch 漂移、选择超限和旧 revision 都失败闭合。0.163.8MCP resource templates:连接阶段把 server resource templates 纳入有界只读 discovery cache,并向模型暴露list_mcp_resource_templates {server?}。模型必须先选择并实例化具体 URI,再进入既有read_mcp_resource边界;不会自动展开 URI、订阅资源或产生隐式网络请求。0.164.0执行与上下文权威:permissions activity|scoped|revoke把实际资源、副作用、恢复覆盖、decision source、workspace binding、TTL 与 revision-CAS 纳入同一 CLI-owned 投影;session location current|show|compare|handoff和 workflow definition manifest/preflight/run 使用版本化 identity,不依赖环境猜测。0.164.0受治理插件市场:plugin catalog|select|impact|evidence绑定精确 registry 集合、publisher、digest、signature、SBOM、license、capability、dependency 与 policy/approval evidence;安装/升级不能用搜索结果或旧 impact 投影代替当前 authority。0.164.0keeper 与 capsule:后台 bootstrap barrier 让 sibling keeper 在用户代码前取得 Worker/后代 PID 清理权威;MCP capsule 把 Node builtin allowlist 与新 execution context 的 OS sandbox 要求绑定到正式证据。Linux dynamic-native 只声明 pathname-visible loader input,macOS signed launcher 默认禁用,均不构成通用 native closure。第二观察周期:
0.163.0开启命令生命周期的第二个 minor cycle;达到0.164.0removal floor 仍不能代替代表性 opt-in collector cohort、三平台 coverage 与逐命令样本下限,25 个兼容 alias 因此全部保留。配置与 sandbox 默认值:schema secret 不允许经普通
config set写入,必须使用隐藏 TTY/stdin 与 OS store/owner-only fallback 的config set-secret;显式workspace-write/strict以及 managed-required sandbox 在能力缺失时失败闭合。mcp add默认 local scope,常规status使用有界 quick probe,完整 Docker Compose 细节改由--deep请求。MCP 恢复权威:
ws/wsstransport、可信动态 header 与 timeout notification 已接线;REPL、stream、Cowork/host 与 WebSocket 使用共享的持久恢复记录。结果不明确时必须 verification/adjudication,不能盲目重放可能已有外部副作用的调用。Canonical session 与预算:REPL、stream、WebSocket、headless 使用可验证 transcript projection、事务化 summary/compaction 与 stale/corrupt resume 拒绝。持久 token/USD/wall-clock 预算已接入后台与 Team adapter,但尚不是跨所有宿主的统一预算 authority。
Agent 工作流控制:plan/todo revision 与 authority ceiling、受控 Skill 子 Agent、后台 launch profile、semantic handoff、
/btw临时旁路、manifest-driven help 与确定性 shell completion 已进入当前树。原生更新恢复:不可变 release identity、签名 updater rollback chain、下载替换恢复与跨平台 cleanup/recovery fence 已落地;真实签名、平台 notarization/Authenticode 与最终发布矩阵仍由 release gate 决定。
Checkpoint restore saga:直接恢复与 timeline restore 共享 workspace prestate binding、生命周期锁、Git/copy 不可变目标、安全 checkpoint、hash-chained CAS journal 和 transaction-fenced settlement。
cc checkpoint recovery list|show|abort|resume|rollback|release只允许 live owner 或已验证 owner absence 加 exact seq/head fence 后的 eligible 动作;resume仅结算已完成状态,rollback仅反转已验证的部分文件变更。边界:checkpoint recovery 不是通用多资源原子事务、断电证明或 checkpoint GA。网络、数据库、消息、部署、支付等外部副作用仍需各自幂等键、事务日志与结果核验。
2026-08-08 0.163.1 发布闭环
- 有界长会话压缩:既有 durable summary 和 compacted tool record 会折入下一份摘要,不再作为永久累积的 system message;2,000 turn 回归验证状态有界,同时保留 checkpoint 等可信 host provenance。
- live session tail 竞态失败闭合:transcript 在路径检查与异步
stat/open之间被删除或恢复时,follow 操作通过 durable session witness 重新分类为受治理的 deleted / unverified-transcript 错误,不再向上泄漏平台相关的原始ENOENT。 - Windows MCP 原子启动:严格沙箱从挂起进程 image 创建起持有已验证 runtime/entry identity,恢复执行前再次复核;真实路径替换竞态在不可信 entry code 执行前失败闭合。
- 真实跨平台可靠性探针:正式矩阵加入 EROFS/ENOSPC session、bounded pipe consumer、原生 TTY screen-reader、多语言键盘、Windows/macOS Unicode 剪贴板、localhost SSH 断线、超大 MCP 输出、并发 Agent 与两小时资源核算。
- Native 凭据 preflight:六目标原生 workflow 在 Linux signing、Windows Authenticode、macOS signing/notarization 或 updater key 缺失时拒绝构建;这不等于相关原生发行链已完成。
- 可复现 Web Panel 与 standalone 基座:CLI pack 从干净、lockfile 驱动的 Web Panel 依赖图构建;Vite/Rollup/Intlify 运行链固定,Rollup 文件并发有界,Node 22 standalone 基座在 Linux、Windows、macOS 的 x64/ARM64 验证宿主上保持确定性。
- 发布闭环:
v-npm-0-163-1精确指向e3f56b11e27ae1bd5d19ad8638434843c244aa68。同 SHA 的 CLI CI31240892299、CLI Strict Sandbox31240892177、unsigned 六目标原生验证31240927257、三系统两小时可靠性门31240943985与 npm release31246063305均成功;正式发布完成 immutable tarball、CycloneDX SBOM、Trusted Publishing、SLSA provenance、registry bytes 与 npmmirror 回读。 - 原生边界不变:六目标 validation 固定记录
signed=false、releaseEligible=false。Windows Authenticode、macOS signing/notarization、updater key 与公开 fresh install/upgrade/rollback 回读仍未闭环,npm 发布成功不能替代这些证据。IDE ARM64 在后续0.37.47/0.4.83的独立发布门中闭环,不属于 CLI native 签名发行。
2026-08-09 0.163.2 发布闭环
- runtime identity:
runtimeKind仅接受native、node、python、posix-shell、powershell、java、dotnet。已识别 runtime 不能通过错误标签改变语义;改名或自定义 executable 必须先声明语义,字段贯穿 local/project/managed、Skill 与 Cowork 来源。 - Linux capsule:固定 npm/Node server 的 runtime descriptor、entry descriptor 与 passthrough argv 绑定到同一次启动;direct inherited-FD 与
bwrap路径都校验 exact runtime/entry/arguments,并拒绝路径穿越、歧义 separator、mixed evidence 与 pathname replacement。 - Windows capsule:restricted-token/AppContainer plan 只由 production adapter 发行并只由内建 Broker 消费;一次性 capability 绑定 contract、helper payload、环境、stdio handles 与 post-spawn closure,验证/收尾均 delete-before-use,重放、注入 adapter 和废弃 plan 均失败闭合。
- macOS capsule:公共 Darwin API 不能原子地把已验证 descriptor 绑定到最终 exec image,因此严格 MCP capsule 返回类型化 fail-closed;root-owned/signed broker 或等价 atomic exec 仍是独立路线图项。
- 权威发布:tag
v-npm-0-163-2、CLI CI31277578939、CLI Strict Sandbox31277578889、两小时可靠性/恶意 MCP 门31271803404、npm release31277578900与公网 readback31278310621均绑定2d6f19aea2并成功。
2026-08-10 0.163.3 发布闭环
- 默认后台 worktree:干净 Git checkout 中的非
stream-jsoncc agent --bg默认从 committedHEAD创建隔离 worktree;--worktree显式请求同一路径,--no-worktree才共享 checkout。dirty tracked/untracked source 拒绝启动,避免用户误以为未提交内容进入快照。 - 所有权与 argv fence:locked atomic state、不可变 worktree/profile identity、worker generation claim、terminal-absorbing update、durable turn intent 与 cleanup fence 阻止 stale worker 复活或删除 live work。detached 参数保留 option value 与
--literal,把 prompt 固定为单个--print=<text>token,并确定性归一 resume/continue/fork/session。 - MCP source policy:
mcp-sandbox-policy.js与mcp-stdio-workspace-authority.js把 source-requiredfilesystem/network和可信cwd从 local/project/user/managed、Skill、Cowork 定义贯通 Broker。Proxy、accessor、未知字段、非支持 boundary、越权 cwd 直接拒绝;高优先级无效定义保留名称,低层同名 source 不能绕过策略。 - 平台文件封存:Linux strict native/plugin 路径逐目录 FD 遍历,拒绝 link、跨 device/mount、special file、hardlink 与超限树,并把每个普通文件复制到独立匿名 sealed snapshot。Windows adapter artifact 只在可信 run-owned root 内物化、复验和非递归回收;无法证明的对象保留并使清理失败。
- 权威发布:tag
v-npm-0-163-3、CLI CI31329476135、CLI Strict Sandbox31329476020、两小时可靠性/恶意 MCP 门31329539092、npm release31335579227与公网 readback31336362525均绑定17fcf6aa79并成功。 - 剩余边界:native spawn 至 PID commit 的 hard-kill 窗口、无可复验 PID 的 detached descendant、macOS runtime atomic exec、任意 native/shared-library 递归闭包、远端 revoke/distributed authority、受信 Node builtin 的最终跨平台隔离和签名 native 发行仍未关闭。
- 后续归属:
d2fcbddc99的宿主四边界地板已由后续0.163.4发布链承接,不再标为当前未发布增量。
2026-08-11 0.163.4 / 0.163.5 调度发布闭环
- 存储与 runtime 分层:
0.163.4先发布 strict schema、jobs/occurrences/history、revision CAS、logical-occurrence dedup 与 durable claim;0.163.5再发布SchedulerRuntime,负责 adapter 注册、claim 后 authority/snapshot 复验、heartbeat 续租、attempt 上限、retry/dead-letter 和 terminal settlement。 - Routine adapter:manual trigger 与 cron/once 使用不同 channel/job id;occurrence 生成确定性
run-scheduler-*id,并把 occurrence/snapshot digest 写入既有runs.jsonl。已存在终态 run evidence 时只恢复结算,不再次执行 Agent;只存在 start 时拒绝重放。 - Agenda adapter:只迁移 wakeup 与 cron;完整
runPolicy进入 snapshot,legacy JSONL claim 与 scheduler claim 双向 fencing。已知的 pre-effect 失败可以有限重试,terminal evidence 可以恢复;monitor 仍走旧路径且不在本次承诺内。 - Cowork Cron adapter:snapshot 只含定义字段,恢复 claim 按 workspace 隔离;新旧 driver 共享 delivery id/lease/fence,六字段 cron 自动使用一秒轮询。start-only、terminal JSONL 替换失败或 outcome 不可证明时死信,不盲目重放 Cowork task。
0.163.5正式边界:Agenda monitor、Automation、Loop、Routine GitHub、standalone scheduler daemon/liveness、共享权限/预算 resolver、IANA timezone/DST/missed-run、迁移/回滚、磁盘故障与长期 soak 尚未进入该版本;这些已交付项由后续0.163.6承接。
2026-08-12 0.163.6 统一 authority 与 Automation 控制面发布闭环
- 适配器收敛:Agenda monitor、Loop iteration、Automation cron、Routine GitHub polling、Webhook/Telegram scoped channel event 与 standalone scheduler daemon 使用共享 job/occurrence、definition snapshot、owner/fence lease、recovery fence 和 bounded retry/dead-letter 语义。
- 时区与错过触发:Agenda/Cowork cron 保存规范 IANA timezone;spring-forward gap 不制造不存在的 civil minute,fall-back repeated minute 映射到两个真实 instant,停机追赶折叠到最近一个到期 occurrence,避免 replay storm。
- 共享 permission/budget authority:五个 domain 绑定 exact capability policy revision,并经同一事务 reservation/settlement 处理
maxRuns/maxUnits。缺失、过期、停用、耗尽或不一致的策略失败闭合;retry 复用原 reservation,不重复计费。 - Automation 双层复验:scheduler authority 与 flow creator、connector RBAC、live revocation、per-flow run/action budget 分别核验;其中任一证据失效都拒绝 unattended execution。
- Governed Automation Center:CLI 生成 versioned projection 与 exact argv;VS Code
0.37.50/ JetBrains0.4.86展示 scope、preflight、history,支持 run-now、失败重试、pause/resume、disable/delete,并以 bounded JSON stdin + revision CAS 创建/编辑 cron、once、webhook、GitHub Routine。IDE 不直接写权威存储。 - 诚实剩余边界:
0.163.6本身不含 scheduler outcome-unknown 人工裁决;完整 mixed-version migration/rollback、scheduler disk-fault closure 与三系统长期 soak 未完成。本发布不宣称全局 exactly-once 或 Desktop/native 签名发行。
2026-08-14 0.163.7:scheduler outcome-unknown 人工裁决
c7d49beaa1 在 scheduler store schema v3 中新增单调裁决记录,并把 Agenda、Routine、Cowork Cron、Automation cron/event 与 Loop 的恢复适配器接入同一协议。它只接受状态为 dead_letter 且错误码匹配 *_OUTCOME_UNKNOWN 的 occurrence。
outcome-unknown dead letter
→ stop every scheduler host
→ drain already-dispatched work
→ verify the external system
→ read evidenceDigest + attempt + fence
→ interactive typed challenge + reason/operator digest
├─ confirmed_applied → settle from evidence; never replay
└─ confirmed_not_applied → authorize exactly one bounded claim裁决以 occurrence、authority、payload、reservation outcome、attempt 与 fence 生成 evidence digest;写入时逐项 CAS 复验。旧 evidence、非交互终端、重复裁决、已变化 fence 或不支持裁决的 adapter 全部失败闭合。数据库只保存 reason/operator 的摘要,不保存理由明文。typed challenge 是操作证据,不是机器范围进程租约,因此停机、排空与外部核验仍是操作员前置责任。
该能力已随 0.163.7 的精确发布 SHA 3e997168621c53708a1682868c6cc4edc9baf15b 进入稳定安装契约;typed challenge 仍只是操作证据,不是机器范围锁,不能跳过停 host、排空和外部核验。
2026-08-14 0.163.7:五域迁移、回滚与因果观测
- Agenda、Cowork Cron、Routine、Automation 与 Loop 共享 schema-v5 migration journal;source locator、source/target digest、retirement fence 与阶段状态持久绑定,恢复幂等且冲突/歧义失败闭合。
cc daemon scheduler migration list|show|rollback只暴露脱敏状态和 blocker。rollback 必须带最新 evidence digest,在交互式 TTY 完成 exact typed challenge;target-first 顺序防止 legacy source 与新 target 同时重新持有权威。- 会话因果观测把精确 transcript head/event count 绑定到 delivery graph,覆盖 diff、gate、artifact、PR 和 merge;workspace/team/policy filter 属于范围选择,不是身份、成员或语义因果证明。
call-ledger@1覆盖 model、retry、compaction、subagent、isolated Skill 与 tool call;严格预算在 settlement 缺失或不可评估时拒绝,不把未知量记为零。
2026-08-14 0.163.8:可靠性、恢复、merge review 与 MCP templates
- 磁盘故障闭环(PR #186):Agenda/Cowork 权威 JSONL 使用 private exclusive temp、完整 short-write loop、file fsync、atomic rename 与 POSIX directory fsync,并区分
not-committed和 post-renameunknown。矩阵覆盖 ENOSPC、partial write、file/directory fsync、rename、损坏记录、原生 SQLiteSQLITE_FULL事务回滚、Automation source 原子恢复、数据库截断与 reopen fail-closed。 - 受治理 runtime recovery(PR #187):
center-projection投影可控 occurrence、exact fence/control revision 与声明的checkpoint_v1safe point;center-runtime-action只允许 running→pause-request→paused→resume 的合作式转换。能力变化、旧 fence/revision、终态或不支持的 job kind 全部失败闭合。 - Automation incident(PR #187):schedule/event 失败形成 revisioned incident;
center-incident-action <id> retry|cancel --expected-revision中,retry 必须再次匹配 occurrence/job/run/fence/error code 才能做幂等 requeue,manual incident 因无法证明外部副作用而禁止 retry。IDE 只消费脱敏投影与 exact argv,不读取 authority/boundary/detail evidence。 - 三平台 soak(PR #188/#197):真实 Linux/Windows/macOS worker 验证 contention、higher-fence recovery、stale settlement、outcome-unknown no-replay、heartbeat、DST、backlog、SQLite quick-check、descendant retirement 与 RSS/FD/handle/orphan 趋势。campaign gate 要求绑定 exact release/control-plane SHA,至少 72 小时、至少 4 个 formal segment、最大段间隔 30 小时。首次正式 run
31807830251的 Windows worker 在第 4 轮提前退出,Ubuntu/macOS 随后取消;该 run 不计数。后继main@7d3120fc1e的 run31821080101三平台及 aggregate 全部成功,定义新T0并把正式样本推进到1/4;不得把这一段外推为完整 campaign 已通过。 - 多 Agent merge review(PR #191):
preview从精确 base 与候选 branch 生成稳定 file/hunk 选择;apply必须匹配 revision、plan digest、选择、actor 与 reason,先 prepare 再以受控 ref transaction 发布;rollback还要求当前 evidence digest 与完整 review id 二次确认。默认状态位于CHAINLESSCHAIN_HOME/team-merge-reviews,显式--state-dir必须位于 agent 可写仓库之外。 - MCP resource templates:templates-only server 可以注册既有 resource surface。
list_mcp_resource_templates只读 discovery cache,可按 server 过滤;订阅、peer logging、completion 与 sampling 仍未进入公开契约。 - 剩余边界:soak 工作流、formal segment 和 verifier 已合并,首个 exact-main 三平台正式 segment 已成功;当前仍为
1/4,尚缺其余三个 segment、至少 72 小时观察与最终 campaign verifier,因此长期 soak 仍是 P2-4 唯一未关闭项。以上基础能力已经进入不可变0.163.8tarball,后继修复与首段证据位于发布后main。
2026-08-14 main@affafa7f0f:原生剪贴板图片发布谱系
- 交互式 Agent REPL 自动探测受支持宿主;用户把图片复制到系统剪贴板后运行
/paste-image,图片会以本地 data-image block 排入下一轮视觉模型消息。该入口不把剪贴板内容解释为命令或远程 URL。 - Windows 仅使用可信系统目录内的 Windows PowerShell,找不到时才从受控
PATH解析pwsh;macOS 固定/usr/bin/osascript并用 AppKit/ImageIO 把 PNG/TIFF 安全归一;Linux 在真实 Wayland/X11 display 下使用wl-paste/xclip,无 display 或工具时明确报告不可用。 - 支持 PNG/JPEG/GIF/WebP 并校验 magic bytes。单图最多 20 MiB,每轮最多 4 张、总计 40 MiB,读取最多 10 秒;macOS 额外限制 TIFF 源、像素数、尺寸、行字节与解码预算,临时目录/文件要求 owner-private 并在使用后清理。
- PR #190 最终 merge SHA 的专用原生 host workflow
31813967006已通过 Linux、Windows、macOS 与 aggregate,CLI CI31810849262和 CLI Strict Sandbox31810848956也已通过。该能力最初晚于v-npm-0-163-8,现已由后续v-npm-0-164-0的 exact-SHA 发布与公网回读纳入稳定安装契约。
2026-08-16 0.164.0:执行权威、受治理市场与原生隔离
- 作用域权限与副作用中心:CLI-owned authority store 为 workspace-scoped allow/ask/deny 规则记录 generation、revision、TTL 和原因;activity projection 只展示有界的实际资源、filesystem/network/process/credential-name 副作用、irreversibility、call chain 与 recovery coverage。IDE 只能消费版本匹配的投影和 exact mutation argv。
- 执行位置与 workflow identity:Local/WSL/SSH/Container/Cloud 的 capability/identity 由
session_start锚定;handoff 只生成无密钥、失败闭合的预览。Cowork workflow 保存不可变 definition version/digest,preflight 与 run 都绑定 execution-authority session、权限、sandbox、scale 和 cost gate。 - 受治理市场:catalog 在多个 registry 上生成版本化候选投影;selection 的优先级和 version tie 必须绑定精确 registry set。impact 在升级前比较 source/integrity/license/capability/dependency;evidence 从已安装 bytes 回读 manifest、license、signature 与 payload SBOM。任何 partial/changed evidence 在 strict 或 mutation 路径失败闭合。
- 后台 hard-kill keeper:
1724f05300在 native child 进入用户代码前建立 bootstrap barrier,并由 sibling keeper 在 supervisor PID commit 前持有 process-tree cleanup authority;0edc932aa5增加 20-Agent、7200 秒、1000-cycle 的三平台 exact-SHA formal workflow。实现已进入0.164.0,但三平台 formal keeper aggregate 尚未成为 P1-2 完成证据。 - Node capsule builtin policy:
b22e65d1e9将构建期静态 external builtin 集绑定为最终 allowlist,并同时约束Module._load、Module._resolveFilename、process.getBuiltinModule、internal bindings 与process.dlopen。2d4dff4052进一步把worker_threads/child_process等新执行上下文显式归入强制 OS sandbox contract;缺少所需 execution-context boundary 时失败闭合。 - Linux dynamic-native / macOS launcher 边界:Linux 把 Plugin/runtime/DSO/loader cache 逐文件 descriptor-pin 并放进只读 synthetic namespace,声明范围只到 pathname-visible loader input,
sharedLibraryClosure=false且排除匿名 JIT/custom loader;packed Linux runtime 仍失败闭合。macOS fixed signed/root helper contract 默认禁用,必须等 Developer ID signing、notarization、root package installation 与完整 live race matrix 才能启用。 - 权威发布:tag
v-npm-0-164-0、CLI CI31912844177、CLI Strict Sandbox31912844034、npm release31912844032与公网 readback31913903124均绑定313dec85cf并成功。该证据不关闭 scheduler/keeper 长期 campaign 或 Desktop/native 签名发行。
2026-08-17 0.165.1:运行准入、远程权威与后台任务收口
- 远程成员权威:Android、iOS、Web Panel 与 CLI relay 绑定 durable membership epoch、审批 fingerprint 与幂等 command ledger;重连会对账丢失 join,relay 在 ack 前提交成员状态。过期、撤销、不可用或跨成员响应失败闭合;不宣称分布式共识或全局 revoke closure。
- workflow 运行准入:
c5f14a2105让 Cowork workflow 在真正运行时重新验证 immutable definition digest、execution-authority session、权限、sandbox、scale 与 cost gate,不复用过期 preflight authority。 - canonical workspace authority:
c64bb4e787让run_shellbackground sandbox 与 plugin-bin 路径比较 canonical workspace root,避免词法 alias 静默扩大已批准路径。26ba98bd71进一步规范化缺省 permission ruleset 并隔离 E2E runtime home,4dfaf64f37/97458c91cf让 Windows 临时目录夹具先解析真实文件系统身份,避免 lexical/canonical path 差异扰动门禁。 - delivery 仓库权威:
e21eb31b4e在 GitHub delivery push 前解析配置 remote 的 push URL,并验证它与权威github.repo一致;不再把origin当作环境事实,remote 不匹配时失败闭合。 - zombie-safe supervisor lock:
1a716dae31让后台 Agent 状态变更使用 execution-state probe;已停止的 POSIX zombie 不再因kill(pid, 0)假存活而继续占有临界区锁,未知进程状态仍保持失败闭合。 - IDE 发布门:
73e63b5d25/ba474c288d增加可信 Remote-SSH/container journey 与 marketplace artifact 回读;9f6d37bec7/c54423e16c/f2cab6ae0b保留失败 trace/remote host 日志,并以 canonical path 验证 extension cwd 位于 remote home;86aef45d94/bc1cd699e9/99f5bf8214将顶层与嵌套 evidence root 的 containment 比较统一到真实路径并覆盖 alias 回归。相关 CLI 修复已由0.165.1承接,IDE 维护版0.37.55/0.4.91从最新主线重新认证。 - 依赖与发布闭环:CLI 固定
js-yaml3.15.1,PDH0.4.58固定adm-zip0.6.0。v-npm-0-165-0因 SBOM 试图提前解析尚未发布的内部 PDH 候选而在 registry write 前停止;0.165.1改为从 exact-SHA 内部 package tarball 解析 SBOM并完成正式发布。 - 权威发布:tag
v-npm-0-165-1、CLI CI32038591204、CLI Strict Sandbox32038590960、npm release32038590940与公网 readback32039659372均绑定1a10ed7c8f并成功。该证据不关闭 Scheduler campaign、跨进程插件事务或 Desktop/native 签名发行。
2026-08-17 PR #215:Marketplace 激活生命周期源码增量
- Payload authority:远程 catalog expectation、已安装
.plugin-source.json与 canonical payload SBOM 使用一致语义绑定;partial、降级或已漂移证据不能授权 install、upgrade 或 pointer-only activation。 - 统一 activation gate:
plugin use、版本卸载 fallback、普通与 pointer-only update 均验证目录/祖先安全性、manifest name/version identity、严格 provenance、fresh payload、source switch 与 downgrade 审批。公共 direct API 默认执行同一门禁。 - 事务恢复 namespace:同 name/scope 的
.install-*/.uninstall-*串行化 mutation 并阻断 runtime discovery;inventory/doctor 暴露runtimeBlocked、inspection version 与 recovery path。已提交事务原子退役到 inert.cleanup-*后再 best-effort 删除。 - 精确恢复:rollback 核对 pointer generation、candidate/predecessor payload 和 source digest;组合 I/O 失败保留可重试 topology,不让被拒 payload 暴露给 runtime。无法安全判断时,整名卸载后从可信来源重装是显式修复边界。
- 剩余边界:实现主提交
7592c0d5bd只关闭单进程、同 name/scope 串行子门。PR #215 已在 exact head89c498cc46完成门禁并合入主线;跨进程 OS lock/durable journal/owner token/CAS、跨 scope effective authority、legacy migration、publisher/组织 trust root、private registry 与长期供应链故障矩阵仍未关闭,且后续发布仍须在自身 exact SHA 重新完成权威门。
2026-08-18 至 2026-08-20 0.165.2 → 0.165.4:耐久工作流、Artifact 治理与可移植安装
- 耐久 workflow authority:provider request/settlement、nested/parallel tool effect、child/descendant call、semantic compaction 与 timeout outcome 使用 identity-bound receipt;stage input、取消与 terminal checkpoint recovery 使用持久 fence,response loss 不再自动重放不明确副作用。
- 会话预算权威:REPL、headless 与 WebSocket 使用同一 durable session budget root,核算 turn/token/USD/tool time/wall time;未知 provider usage 会停止继续执行并要求显式
cc session budget status|recover|receipts裁决,而不是按零计费。 - 远端结果回收:execution-location target 返回有界 result bundle,source 端固定传输、验证、持久保存并先做 content-free review;只有显式
result-preview、result-import或绑定 review digest/apply id 的result-apply才暴露或应用内容,apply 走可恢复 workspace transaction。 - Artifact 治理:
artifacts access|access-log在暴露路径/字节前复核唯一索引、文件身份、大小、SHA-256 与 lineage 并写 content-free audit;remove --deletion-id与clean --cleanup-id使用 prepared/terminal ledger 支持 response-loss 重试,删除仅保证 managed copy 不存在,不宣称安全擦除外部硬链接、备份或快照。 - 插件与 keeper:PR #215 的 semantic payload/activation lifecycle 已由
0.165.2+正式承接;keeper retirement、死 owner lock reclaim、bootstrap release replay 与 Windows health probe 在0.165.3收口。 - 首次安装:
0.165.4/ PDH0.4.59将 native SQLite addon 设为 optional;禁用 native prebuild 且无 Python/node-gyp 工具链时,全局安装仍能启动cc/chainlesschain并使用内置sql.jsWASM fallback。
2026-08-20 发布后源码快照 HEAD@f2fbf331da46
- MCP materialized npm capsule 在构建期拒绝 package
.node,并在运行期以不可改写 guard 拒绝process.dlopen;Windows/macOS strict native plugin 在无法证明 platform-specific loader closure 时于 spawn 前类型化失败闭合,不把 Node/V8/host runtime TCB 误写为已关闭。 - IDE 源码新增 durable workflow 控制、pending interaction 恢复与 orphan Artifact recovery;Desktop 新增 returned-artifact review workbench;iOS 新增 transient remote session 恢复。它们仍须各自 exact-SHA 发布门与市场/应用产物回读,当前只记为源码实现。
- P1-5 新增 Ubuntu 24.04、macOS 15、Windows 2025 × private-registry TLS、explicit proxy、PAC、air-gapped cache 的十二格 Marketplace 供应链 workflow;实现把每格 100 次 journey、签名 install/upgrade/rollback、24 类故障拒绝和 content-free aggregate 写成硬门。本机缩小 campaign 与单格 100/100 已记录,但
f2fbf331da46尚无十二格 exact-head Actions aggregate,整体继续为部分完成 / NO-GO。 - Scheduler campaign 已记录到第三段,但未完成最终 72 小时/全部 segment verifier;签名 native、跨宿主 revoke 和外部 Marketplace 产品化继续开放。
2026-08-21 发布闭环
- 上述 CLI native-addon policy、durable workflow/orphan Artifact recovery 已由
v-npm-0-165-5与 Open VSX0.37.59的 exact SHA11aef634aa正式承接;JetBrains0.4.94同 SHA 上传成功并等待 Marketplace 审核。 - 同一 SHA 的 P1-5 Marketplace 三系统十二格矩阵与 IDE ARM64 host aggregate 已成功,因此
f2fbf331da46时点的 aggregate NO-GO 已关闭。Desktop/iOS 应用发行、签名 native、跨宿主 revoke 与完整 Scheduler campaign 不随本闭环外推。
2026-08-21 0.165.6 与 IDE 补丁发布
v-npm-0-165-6在 exact SHAef4324349f完成三平台 CLI CI/Strict、npm 发布和独立回读,正式承接 Remote Control 安全默认值、受治理 Marketplace 来源/归档、跨会话消息、MCP 生命周期恢复与交互模式增量。- Open VSX
0.37.61是0.37.60运行时的 changelog 修复重发;JetBrains0.4.95已审核、listed 并公开。两者公开 secure Remote Control、跨会话消息投影和 transcript 可访问性。 - 后续 PR #252 的 session group/Focus View、diagnostics/mention scale、browser canonical evidence、MCP lifecycle 与 execution-location drain 仍是发布后源码增量;相同 package version 字符串不等于相同发布字节。
已落地能力
1. 命令分发
- 命令注册以
packages/cli/src/command-manifest.json为索引。 - 启动阶段只解析当前命令需要的模块,lazy dispatch 会保留
--help、命令过滤和别名行为。 - Windows 下 hook 输出清理、命令参数处理和 Node.js 22 JSON import 语法已完成兼容性修复。
- 当前顶层命令数保持 175,本轮主要是分发稳定性和启动路径修复,没有扩大命令面。
1.1 统一 Scheduler Kernel
contract.js规范 job、occurrence、authority、claim 与 history JSON;store.js以 SQLite 版本表和 strict schema 管理 revision-CAS 更新、logical key 去重以及 owner/fence lease。runtime.js只执行与 adapter kind 匹配的 occurrence。每次 execute 前重新读取 job/occurrence、验证 authority 与 snapshot,运行中续租,结算时继续要求同一 owner/fence,避免 stale worker 完成别人的 claim。- Routine、Agenda 与 Cowork adapter 保留各自兼容存储作为定义/用户历史或恢复证据;统一 SQLite 不是把既有 JSONL 静默迁走,而是提供跨 driver 的调度权威与历史。
0.163.6的 Automation/Loop/monitor/GitHub 适配器已发布;0.163.7进一步发布五域 migration journal 与受治理回滚。它们协调 legacy source 与 scheduler target 的权威切换,但不宣称跨独立存储/文件系统的单一原子事务。
2. 后台 Agent 与交互 attach
cc agent --bg启动独立 worker,并持久化状态、心跳、日志与 phase。- 在干净 Git checkout 中,非
stream-json后台运行默认创建 committedHEAD的隔离 worktree;--no-worktree是显式共享 checkout 的风险接受开关。 cc attach <id>在本地控制通道可用时支持发送 follow-up prompt、停止和查看状态;不可用时退化为日志跟随。- 提问、审批和副作用确认写入 durable interaction journal,并绑定会话、回合、请求与操作指纹;重连或恢复后继续等待原问题,不会被错误降级为普通 idle 或重复执行。
- 控制通道优先使用本机 IPC;TCP 传输用于跨平台或 IPC 不可用的场景,仍需本地会话凭据握手。
- supervisor 对自杀 PID、死 PID 和孤儿 worker 有保护,停止操作不会误杀当前 CLI 或被 PID 复用的进程树。
- IDE 发起的隔离任务可由后台 Agent 持有 worktree,并持久化 owner/session、权限模式、资源预算、生命周期与有界副作用计数。
- team/batch 协作单元也持久化同一组有界治理字段,但不保存 prompt、argv、工具参数、输出或凭据;IDE 可以把它们显示为 managed collaboration record,却不能借此授予后台 attach/stop 等进程控制能力。
3. 执行安全
process-execution-broker统一前台、后台、IPC、hook、MCP、monitor、LSP、PTY 与插件 bin 的进程执行入口,跨平台 sandbox 与 credential agent 默认接入。- 带策略的插件 bin 在 async/background 启动中继续携带钉住的执行身份;通用后台任务、CLI PTY 与桌面项目 PTY 进入同一套失败闭合的 Linux 文件系统/网络边界,不再存在“直接执行已隔离、后台或 PTY 旁路”的分叉。
- production
run_skill不会在 CLI 主进程 importhandler.js,也不向 Skill 注入 MCP client、process broker 或 Node.jschild_process。非隔离 handler 固定返回CC_SKILL_DIRECT_HANDLER_BLOCKED;隔离 Skill 只获得与父级 ceiling 相交后的read_file、search_files、list_dir。 capabilities: [shell-exec]当前只是历史 descriptor/template 元数据,不产生 runtime authority。无 production consumer 的skill-process-brokerfaçade 已删除,避免后续代码在没有完整进程树、可执行身份和宿主 dispose 证明时误接回休眠执行权限。- CLI-Anything、CLI Pack 与
init ai-*-creator仍可生成 legacyhandler.js供显式外部迁移/检查,但 productionrun_skill不执行它们;这些模板中的processBroker调用不能作为当前可运行能力或安全边界证据。若未来恢复 handler 执行,必须重新通过 source/digest approval、可执行字节身份、OS process-tree ownership、fixed deadline、host-owned dispose 与三平台真实回归,不能复活已删除 façade。 - 凭据代理向子进程提供受控占位符,避免把长效凭据直接暴露给 agent 工具链。
- 非秘密运行标识使用显式 allowlist:
CC_SESSION_ID、CLAUDE_CODE_SESSION_ID可以跨 broker 边界;未知*_SESSION与凭据型变量仍默认过滤。这样既不破坏会话关联,也不放宽通用环境透传。 - 插件 manifest 可以声明所需 sandbox 边界;未声明、策略不允许、宿主能力不足或证明不匹配时,hook、MCP、LSP、monitor、PTY、Python 发现、
run_code、bang command 与后台任务均失败闭合。 - Linux 原生插件执行只接受当前架构、显式非可执行栈的受支持静态 ELF;解析、探测与启动绑定同一插件树/文件描述符,并在固定 bubblewrap 文件系统与网络策略内执行。每个实际 bind source 必须证明 private mount propagation,无法证明时保持失败闭合;父进程持有的 pinned descriptor 在 spawn 后关闭。动态 loader、畸形 segment、复制/重放/过期 contract 或可变宿主路径都会在启动前被拒绝。
- Windows AppContainer 路径保留 resolver 发出的目标句柄、受信环境与策略摘要,跨 probe、spawn、IPC 和 detached 边界复核目标及插件身份;未继承需要的句柄或摘要不一致时拒绝降级执行。
- 桌面项目根只在本机来源、owner 与路径证明通过后获得 PTY authority;历史未证明根进入 quarantine,远端 init/sync metadata 和外部 cache 都不能写入或提升本机执行根。
4. 路径与会话隔离
getHomeDir()的默认值为~/.chainlesschain。CHAINLESSCHAIN_HOME是完整运行目录覆盖值,而不是用户 home 的父目录;设置为/tmp/cc-run时,会话位于/tmp/cc-run/sessions/,不会写入/tmp/cc-run/.chainlesschain/sessions/。- 配置、状态、服务、日志、缓存和 JSONL 会话共享这条目录契约。单元、集成和 E2E 夹具必须设置独立的
CHAINLESSCHAIN_HOME,不得写入开发者真实 home。 cc session export默认经过 secret scan/redaction;--no-redact是显式可信备份开关。
5. Process Broker 受控 checkpoint 与回滚(P2-14)
- Process Broker 在接受受控 workspace writer 执行前建立持久 workspace transaction,记录声明范围内的文件内容、mode 与毫秒级 mtime;执行成功后提交,失败、取消或超时后按 fenced authority 回滚。
- crash recovery 只有在 owner/lock 精确匹配、相关 execution 全部 settled 且具备可信 process-tree proof 时才自动回滚;证据不足时返回
recovery_required,不会把不确定状态伪装成恢复成功。 - coverage 分为
full、partial与none。full还要求受控 writer 完整接线和writerIsolation=exclusive-workspace;部分入口、并发未知 writer 或外部副作用只能报告较弱 coverage。 - 完成口径只覆盖 Process Broker 管理且位于声明 workspace 范围内的 writer,不表示捕获宿主机上的全部文件写入。网络、数据库、消息、部署、支付以及其它外部副作用不在回滚承诺内。
- workspace root 的 canonical path、device/inode identity、state binding 与可信父目录共同参与恢复校验。Node.js 不提供
openat/ handle-relative authority,无法声称消除完整 ABA;Windows native spawn 仍存在检查到创建之间的有限 TOCTOU,相关路径保持失败闭合或降级为显式恢复。 - 当前源码进一步把 direct/timeline restore 统一进持久 saga:原始 checkpoint 与自动建立的 full-safety checkpoint、选定 Git/copy engine、目标 identity、workspace prestate、owner digest、seq/head hash 均进入可验证 projection。
- 恢复 CLI 先用
recovery show取得 live mutation fence;abort|resume|rollback|release都要求--yes和匹配的--expected-seq、--expected-head-hash,存在 retained live owner 时还要求--expected-owner-digest。任何 stale projection 或 eligibility 变化都会拒绝执行。
6. 大规模 Agent Teams(P2-16)
- TeamRunner 使用 indexed scheduler、依赖 bookkeeping、有界 mailbox/backpressure 与 per-task tightened contract;单进程内已验证 10,000 task / 64 个异步 worker 的调度规模。
- 本地状态以 schema v6 为当前 authority;v5 只允许由
team run --resume执行一次 CLI-owned 迁移,v2-v4 被拒。分布式协作使用独立 queue schema v1,不能把两类状态文件混写或由 IDE 直接修改。 - 分布式 queue 以 state/queue authority digest、lease、compare-and-swap 与完成发布尾部 fencing 协调多个进程。它依赖共享且可信的本地文件系统,不是带复制、共识或网络分区容错的分布式数据库。
TeamBudget同时限制maxTasks、maxTokens、maxUsd与maxWallMs。启用 token/USD cap 时,usage 缺失或远端模型无法定价会失败闭合;恢复只允许收紧 cap,不能抹去已经消费的预算。- 本地 active wall time 不计算进程停机时间;分布式全局 wall 从第一次 acquire 开始并包含 worker 停机时间。executor 返回、checkpoint、commit 和完成发布尾部都会重新 fencing,超限后的迟到结果不能发布为成功。
- worktree 按任务隔离并执行 prepare → persist → remove → persist 两阶段清理。崩溃后的不确定外部副作用进入交互式 adjudication;只有 dry-run、明确
retrySafe或具有可接受 committed evidence 的任务才能按相应路径安全恢复。 0.166.3的公共契约不是顶层cc team send子命令,而是仅向真实cc team --agent子进程注入的私有team_send|receive|ack|followup|handoff宿主工具。工具受 lease/fence 与 credential-capability 约束;普通 shell worker、prompt 文本和 IDE 均不获得消息 authority。- idle followup wake、custody handoff 和 SessionMessageFabric 已公开,但 Desktop/IDE UI 与其他产品 adapter 仍不得在 authoritative cutover 前宣称自己具有同等持久语义。
- Agent Team checkpoint authority 当前为
coverageTarget=partial、writerIsolation=unknown、externalSideEffects=true。三平台长期 soak 使用 2 个真实 OS worker 验证跨进程 DAG、故障与恢复;它与单进程 64-worker 规模测试是两项不同证据。
7. Hooks 与进程生命周期
Setup在命令执行前触发,可注入受控环境变量。Notification支持把会话状态转发到配置的通知适配器。- hooks 输出会经过统一清理;异常输出不会破坏命令 dispatch 或污染后续会话。
- 未注册 hooks 时保持兼容路径,默认不改变既有输出。
- 异步 hooks 受并发上限、去重和单 hook timeout 约束。停止或超时时必须回收 shell 与真实命令形成的整棵进程树,不能只杀 shell 留下孤儿任务。
- POSIX 通过独立进程组和负 PID 信号回收;Windows 优先
taskkill /T /F。为处理策略限制下taskkill非零退出,supervisor 会在终止前一次性读取进程表、构造目标后代树,并按叶子优先顺序兜底终止。 - raw PTY master 在 close、error 或 native failure 后立即失效并清空排队写入,阻止 FD reuse 把旧会话数据写进新进程;attached session 停止时回收完整 POSIX process group 或 Windows process tree。
- Hooks v2 在 headless、stream、REPL 与 WebSocket 回合中把 canonical host root 绑定为 generation-aware opaque durable identity,旧 generation、跨宿主或未证明 binding 不能恢复本机 authority。
- hook 子进程已完成时,Node 晚到的 stdin
EPIPE被解释为 transport 收尾:status 0 输出和 status 2 block 协议继续保留;缺失 exit status 或其它 spawn error 仍失败闭合。 - 默认 Hooks runtime 通过显式 event sink 注册到 Broker,不再反向同步加载第二份 ESM 模块图;首次执行后只保留一个 CredentialTransport worker/listener,重复后台执行相对预热基线保持稳态 FD 零增长。
- WMIC 不存在时才使用 PowerShell/CIM,避免在权限拒绝场景重复做高延迟探测。受管沙箱同时禁止进程枚举与树终止时,真实树测试按能力跳过,解析和 fallback 行为由可注入单元测试覆盖。
8. 插件生命周期、归因与 IDE 运行时
cc plugin的安装、分 scope 启停、source-aware 升级、回滚和 live-session reload 由 CLI runtime 持有;IDE 只呈现命令结果,不自行绕过组织策略。- 插件升级先进入 staging,重新校验 manifest 与签名 SBOM,再原子激活。复制、load check、post-install 或 capability widening 被拒时恢复旧 active version;强制重装同版本也保留并恢复原字节。CLI 对外只返回受控的
activated / rolled_back / unchanged结果。 - 插件管理面显示签名、SBOM、来源、托管策略及 registry/Git/local 元数据的脱敏摘要。来源字符串不会作为 shell 命令执行,工作区目录也不会参与可执行文件探测。
- compact transcript 与
cc session usage可按插件 id/version 归因 plugin-bin 和插件提供的 MCP 调用,并记录有界工具耗时、同轮观测重试与脱敏的流式 LLM retry 原因/实际 provider/model;不持久化工具参数、输出或凭据。 - VS Code 与 JetBrains 通过
cc-ide-quality/v1提供有界的测试、覆盖率和调试器快照,并携带 Context v2 freshness 元数据;Notebook 执行使用真实 notebook 上下文。 - IDE 公开版 Open VSX
0.37.87/ JetBrains Marketplace0.4.113只在插件升级结果为activated后重载 live session;capability widening 必须先展示新增能力并由用户显式批准,rolled_back或不可读结果保持失败闭合。 - 两个 IDE 只读观察本地 Agent Team schema v6 与分布式 queue schema v1。takeover、managed checkpoint recovery 和 side-effect adjudication 必须携带精确 authority digest、lease/evidence fence,并通过解析出的 CLI 执行;文件监听与刷新只更新投影,不能绕开 CLI-owned compare-and-swap authority。
- IDE 还把 CLI-owned session graph 投影到 Sessions Workbench,并提供受 projection revision 约束的 resume/attach、可恢复 GitHub/Gitee/remote/manual delivery,以及绑定 session/workspace/repository/checkpoint/manifest digest 的 rewind/branch timeline。过期按钮与 projection 必须失败闭合。
- Open VSX 当前公开
0.37.87;JetBrains Marketplace 当前公开0.4.113。双端消费 Schema 生成 payload union 并保留未知未来事件,延续 Context Center、权限/副作用证据、Automation Center、durable workflow/Artifact recovery 与无正文协作投影;VS Code 新增页面化 Workbench/Skill Library 与自定义模型连接。Microsoft VS Code Marketplace 仍未发布。 - Installation Doctor 同时报告 Node/Java、managed CLI 和插件 registry 的离线恢复状态;恢复建议不把不可信工作区加入命令搜索路径。
9. Auto mode 安全分类与标准 OTLP 出口
- Auto mode 安全分类器使用版本化、不可变的离线评测语料识别 workspace 越界、秘密外传、生产部署、force push、未审合并和未隔离第三方 Agent 等危险意图。评测器不执行语料命令,也不在报告中回显原始参数。
- 分类结果只是一道附加风险信号,不能降低 shell hard deny、managed deny、credential guard、Process Broker 或 OS sandbox 的既有结论;尚未进入统一 preflight 的 Git、MCP、Hook、第三方工具与 Agent Team 路径不能被宣传为已受分类器全面保护。
- OTLP exporter 支持 traces/metrics 的 OTLP/HTTP JSON、OTLP/HTTP protobuf 与 OTLP/gRPC,读取标准全局及 per-signal endpoint、protocol、header、timeout、compression、service/resource 配置,并支持自定义 CA 与 mTLS。
- exporter 使用有界 batching、queue-pressure 计数、
Retry-After/ 指数重试、永久失败与 drop 指标、原子 crash spool 和退出前 final flush。prompt、response 与工具参数默认不出站,所有字符串属性和事件继续经过秘密脱敏。
关键入口
| 领域 | 实现 |
|---|---|
| 命令分发 | packages/cli/src/lazy-dispatch.js、command-manifest.json |
| 后台监督 | packages/cli/src/lib/background-agent-supervisor.js |
| 交互协议 | packages/cli/src/lib/ipc-attach-protocol.js、background-session-transport.js |
| 执行安全 | packages/cli/src/lib/process-execution-broker/ |
| 受控事务与回滚 | packages/cli/src/lib/process-execution-broker/workspace-transaction.js、commands/checkpoint-managed.js |
| Restore saga | packages/cli/src/lib/checkpoint-restore-saga.js、checkpoint-restore-recovery*.js、commands/checkpoint-restore-recovery.js |
| 会话与资源预算 | packages/cli/src/lib/session-*.js、session-resource-budget.js、session-host-runtime.js |
| MCP 恢复 | packages/cli/src/lib/mcp-call-recovery*.js、harness/mcp-client.js |
| MCP source 策略 | packages/cli/src/lib/mcp-sandbox-policy.js、mcp-stdio-workspace-authority.js、runtime/mcp-config.js |
| Agent Team | packages/cli/src/lib/agent-team/、commands/team.js、commands/team-distributed.js |
| Agent Protocol | packages/agent-protocol/schema/、scripts/generate.mjs、generated/ |
| CC App Server | packages/cli/src/lib/app-server/、commands/serve.js、packages/agent-sdk/src/app-server-client.ts |
| Agent Kernel | packages/cli/src/runtime/{runtime-factory,agent-runtime,agent-core,headless-runner,headless-stream,output-backpressure}.js |
| Graph Kernel | packages/cli/src/lib/graph-kernel/、commands/graph.js、commands/team.js |
| Auto 安全分类 | packages/cli/src/lib/auto-mode-safety-classifier.js、lib/auto-mode-safety-eval.js、commands/auto-mode.js |
| OTLP 出口 | packages/cli/src/lib/otlp-exporter.js、lib/observability/otlp-exporter.js |
| 插件沙箱策略 | packages/cli/src/lib/plugin-runtime/sandbox-policy.js |
| 插件生命周期 | packages/cli/src/lib/plugin-runtime/install.js、commands/plugin.js |
| 插件用量归因 | packages/cli/src/lib/plugin-usage-attribution.js、lib/session-usage.js |
| 技能执行边界 | packages/cli/src/lib/skill-loader.js、runtime/agent-core.js |
| 技能生成入口 | packages/cli/src/lib/cli-anything-bridge.js、lib/skill-packs/generator.js |
| 技能注入入口 | packages/cli/src/commands/skill.js、runtime/agent-core.js |
| 路径契约 | packages/cli/src/lib/paths.js、harness/jsonl-session-store.js |
| 异步 hook 回收 | packages/cli/src/lib/async-hook-supervisor.cjs |
| hooks | packages/cli/src/lib/session-hooks.js、hook-manager.js |
| IDE 运行时接线 | packages/vscode-extension/src/runtime-environment.js、packages/jetbrains-plugin/src/main/java/com/chainlesschain/ide/RuntimeEnvironment.java |
验证口径
发布前应分别执行三个层级,不能只用默认 npm test 代替:
cd packages/cli
npm run test:unit
npm run test:integration
npm run test:e2e0.166.30 的精确正式发布提交为 87ddf8b12625086e9666fedb054f0d67a7b8038d。同一提交的 Linux/Windows/macOS CLI CI run 34079589530、Strict Sandbox run 34079589387、Trusted Publishing/public-install run 34079589427和IDE Extensions run 34085825725均成功。Agent Protocol 0.1.8、TS/Python SDK 0.2.8、Open VSX 0.37.87 与 JetBrains 0.4.113 均已公开回读。
后续版本仍必须在各自 final exact SHA 上重新完成权威门;当前 main 与 v-npm-0-166-21 都指向本次 SHA,也不能让 npm tarball、Open VSX VSIX、JetBrains ZIP 与 Desktop/native 合并为同一制品身份,仍必须分别按公共回读证据处理。
平台专项还应覆盖 Linux bubblewrap 的 fd 绑定、private mount topology、静态 ELF/架构/segment/栈校验、通用后台/PTY 强边界与网络隔离,以及 Windows .cmd 启动、AppContainer 目标句柄/策略摘要、后台 attach、停止自 PID 记录、hook 输出清理和进程树能力探测。P2-14 专项必须区分 full / partial / none,验证 crash recovery 在证据不足时进入 recovery_required;P2-16 专项必须分别覆盖单进程规模测试、真实跨进程短门和三平台长期 soak。Hooks 专项需覆盖 stdin EPIPE 的 status 0/2 协议、单一 CredentialTransport listener 与 teardown 后 FD 零增长。TCP attach 需要运行对应的 IPC/transport 回归测试。真实系统能力不可用时,测试必须明确跳过并由注入测试补齐,不得把权限拒绝伪装成功。
