ChainlessChain 文档

主题

Agent Platform 发布与升级指南 ​

2026-10-13 最新发布与升级 ​

2026-10-13：CLI 0.166.100 与 Open VSX 0.37.144 已公开，发行源码 6a8db627c8，文档核对主线 283634169a。JetBrains 0.4.162 已上传，公开上架与下载待核验；已核验公开 0.4.161 推荐 CLI .99。Session Core 0.3.19、Kernel 0.1.9、SDK 0.2.14、PDH 0.4.64 与产品 v5.0.3.140 保持独立版本。

安装 chainlesschain@0.166.100 与 Open VSX .144 后，重启聊天宿主并运行 Doctor。JetBrains .162 已上传，公开上架与下载尚待核验，不能把宿主门禁通过当作 Marketplace 已公开；已核验 .161 的推荐 CLI 为 .99。详见逐步升级与故障排查及本轮设计。

本轮包含有界流式重试、可见输出防重放、Chat 回调传递、工作树登记重读及 IDE 刷新修复；还承接 .97–.99 的私有存储诊断、任务交付和文件字节保护。CLI 与 Open VSX 已完成准确发行源码的 Actions 门禁、发布和公开制品核对。Session Core .19 / Kernel .9 使用已发布子包，SDK、PDH 和产品 .140 不因此重新发行。

正式 36+9 保持 NOT_RUN，完整 native review 为 NOT_ADMITTED，自动晋升 HOLD；预算 PR #436 未进入本次发行，仍为 NOT_PAID_READY。 原始失败和历史诊断仍保留，局部真实模型 smoke 不作为正式样本或完整费用结论。

2026-10-10 发布与升级（历史快照） ​

2026-10-10 公开回读：CLI 0.166.96、Agent SDK 0.2.14、Open VSX 0.37.140、JetBrains 0.4.158 已公开，两个 IDE 均推荐 CLI 0.166.96，准确发行提交 da91e730d8。Session Core 0.3.18、Context/Memory Kernel 0.1.8、PDH 0.4.64 保持独立版本；产品 v5.0.3.140 仍来自 f733f92cb9。源码核对至 main@2650447476。本轮改善并发权限设置、JetBrains 审批卡片布局与失败诊断，补齐 Windows 私有工具链和清理取证；正式 36+9 评测保持 NOT_RUN，完整 native review 保持 NOT_ADMITTED，自动晋升 HOLD。

安装 chainlesschain@0.166.96（官方 registry），核对 cc --version 与 cc doctor，升级 Open VSX 0.37.140 或 JetBrains 0.4.158 后重启聊天宿主。详见逐步升级与故障排查及本轮设计。SDK 0.2.14 先于 CLI 经过既有 OIDC 发布；.95 复用检查失败没有发布，失败标签保留。

发行提交的 CLI CI 71/71、Strict 5/5、IDE 18 成功/1 条件跳过、ARM64 10/10 已归档；后续文档头 Windows Scheduler 非必需 smoke 曾失败，根因未确认，不能用发行通过记录覆盖。正式 36+9、完整 native review 与长时验收保持开放。

2026-10-08 发布与升级（历史快照） ​

2026-10-08 最新回读：公开 CLI 0.166.93、Open VSX 0.37.138、JetBrains 0.4.156，IDE 推荐 CLI 0.166.93；Session Core 0.3.18、Context/Memory Kernel 0.1.8、PDH 0.4.64。CLI/IDE 发行提交 65e8c21d3a；独立产品 v5.0.3.140 来自 f733f92cb9，已公开桌面、Android 与 iOS 制品。源码核对至 1e5477aebe。组织目标、授权记忆、站内通知、IDE 调查恢复与 RRSI 有界读取已进入本轮对应制品；后续 Windows 冻结工具链及 Node runtime 验证仍是实验，未获生产准入。

组件公开版本核验状态
npm CLI0.166.93准确提交 CLI CI 71 成功、Strict 5/5、OIDC；公开归档 SRI 和包身份通过
Session Core / Memory Kernel / PDH0.3.18 / 0.1.8 / 0.4.64公开归档可获取；CLI 精确依赖已对齐
Open VSX / JetBrains0.37.138 / 0.4.156官方 API 与实际归档回读；均推荐 CLI .93
Desktop / Android / iOSv5.0.3.140全平台公开资产；原生签名与渠道独立核验
  1. 关闭客户端并备份持久数据，SQLite 与其 WAL / SHM 文件一并保留。
  2. 执行 npm i -g chainlesschain@0.166.93 --registry https://registry.npmjs.org，再用 cc --version 核对实际版本。
  3. 升级 Open VSX 0.37.138 或 JetBrains 0.4.156，重启聊天宿主并通过 Doctor 检查实际 CLI 路径。Microsoft Marketplace 状态独立。
  4. 从产品 .140 下载页安装对应平台客户端。Android 提供三种 APK 和 AAB；AAB 用于商店提交。iOS ad hoc IPA 仅适用于描述文件授权设备，App Store / TestFlight 另行审核。

桌面 Windows / macOS 公开资产沿用未代码签名分发，macOS 未公证；Android release 签名和 iOS ad hoc 签名不代表桌面代码签名。发布流程继续使用 GitHub Actions OIDC，产品标签不触发 workspace npm 发布。

CLI CI、Strict与OIDC来自同一 65e8c21d3a。产品经 Actions 最终发布 37745138373 复核来源及完整资产后成功公开。原 Release 与中间恢复失败记录保留，不能写为原工作流全绿；最终发布未替换制品或移动产品标签。

本次公开回读核对四个 npm 归档、实际 VSIX / ZIP、IDE 版本配对和产品清单；没有重新执行全套产品安装或业务回归。Windows runtime 胶囊仅为源码实验，RRSI 效果实验和自动晋升保持 NOT_RUN / HOLD。见最新设计。

前次核对（.92 / .139 历史快照） ​

2026-10-07 核对：CLI 0.166.92、Session Core 0.3.17、Context Memory Kernel 0.1.7 已按子包 → CLI 顺序通过 GitHub Actions OIDC 发布，公开归档、精确依赖和签名来源均已回读。Open VSX 0.37.137 与 JetBrains 0.4.155 已公开并完成实际制品下载与 CLI 0.166.92 配对核验。本轮四个标签均指向 e812a89952；产品 v5.0.3.139 已公开 Windows、macOS、Linux、Android 与 iOS 制品。当前状态见本轮公开回读记录。

前次 2026-10-08 源码核对与升级范围 ​

2026-10-08 核对：公开 CLI 0.166.92、Open VSX 0.37.137、JetBrains 0.4.155，两个 IDE 均推荐 CLI 0.166.92；Session Core 0.3.17、Context/Memory Kernel 0.1.7、PDH 0.4.64。发行提交 e812a89952，产品 v5.0.3.139 已公开。主线核对至 381f8018ef：产品已包含个人目标巡检/动作/独立验收与组织任务工作台；个人记忆面板、组织转移/风险/共享目标/巡检/验收/记忆、站内通知和 IDE 调查循环恢复属于后续源码。

共享目标/通知和循环恢复尚未进入以上公开制品。产品 .139 已包含个人目标巡检/动作/验收和组织任务工作台；个人记忆核心存在但没有操作面板。主线还新增组织转移、风险、目标与共享记忆 UI。实际能力需核对安装包发行树或源码宿主，不能由版本数字推断。

公共回读重新检查 npm 归档 SRI、精确子包依赖、公开商店和准确发行提交的 GitHub Actions；后续源码未因此取得发行资格。详见设计增量。

2026-10-07 本轮发布状态 ​

下表逐组件列出实际发布状态与签名方式。各渠道的公开制品、版本配对和产品构建结果分别核对。

组件本轮版本已验证状态与证据
Session Core0.3.17OIDC 发布、公开归档下载及精确提交签名来源核验通过
Context/Memory Kernel0.1.7三平台 CI、OIDC 发布、公开归档及精确提交签名来源核验通过
npm CLI0.166.92CLI CI 70 成功 / 1 条件跳过、Strict 5/5；公开字节、来源与精确子包依赖核验通过
VS Code / VSCodium0.37.137Open VSX 已公开、可下载；本地与公开 VSIX SHA256 一致
JetBrains0.4.155Marketplace 已审核公开；公开 ZIP 版本、plugin ID 与推荐 CLI 0.166.92 核验通过
产品 / Desktop5.0.3.139 / 5.0.3-alpha.139Windows / macOS / Linux 制品已公开；Windows、macOS 未代码签名，macOS 未公证
Android5.0.3.139，versionCode 503139release 签名 arm64、armeabi、通用 APK 与 AAB 已公开
iOS5.0.3，build 139ad hoc 签名 ChainlessChain.ipa 已公开，设备须在描述文件授权范围内

发布顺序为子 npm 包 → CLI → IDE 插件 → 移动端和桌面端。每个 npm 包通过 GitHub Actions OIDC 发布后，先核对公开下载及下游精确依赖，再进入下一阶段。桌面与移动端排在 IDE 插件之后，按独立产品流程核对构建、签名与制品；App Store、Google Play 和 TestFlight 状态另行列示。

精确发行提交的 CLI CI、Strict Sandbox 和 npm OIDC 发布 已成功。Open VSX 与 JetBrains 发布及官方回读成功，产品进度见独立 Release 流程。

本轮修复包括 Session Core 调度数据库在 Windows WAL/SHM 文件权限保护前完成实际初始化，以及 record/replay 对规范摘要的 PII 误报处理；捕获内容仍接受密钥和 PII 扫描。桌面打包与 RRSI 证据夹具的验证修复不代表新增用户功能已获得独立验收。JetBrains 安装 ZIP 测试宿主关闭开发自动插件重载，精确发行提交的 Linux、macOS、Windows 真实宿主与重启验证已通过。

RRSI 目录和 marker 文件保留完整 64 位物理身份，修复 Windows 大整数被舍入后将不同对象判为同一对象的问题；身份不匹配仍会 HOLD，不会自动改写已认证记录。产品发布流程在所有平台构建前核验独立发布的 CLI 与公开可下载子包，已移除 npm token 回退路径；依赖缺失时停止并先完成 OIDC npm 发布。

CLI 0.166.92、Open VSX 0.37.137 与 JetBrains 0.4.155 已公开，可按以下顺序升级：

  1. 如涉及存储迁移，先备份并停止旧 writer；旧 Memory v2 reader 可能拒绝新索引 descriptor，降级须使用兼容快照，默认 shadow 不触发迁移。
  2. 安装 npm i -g chainlesschain@0.166.92 --registry https://registry.npmjs.org，通过 cc --version 核对实际 CLI。
  3. 安装对应的 Open VSX 0.37.137 或 JetBrains 0.4.155，重启聊天宿主或 IDE，并通过 Doctor 核对运行时身份与能力。版本配对不能替代实际能力观察。
  4. 从产品下载页选择对应的桌面或移动端安装包，核对原生应用与其实际使用的 CLI 版本。复制 SQLite 数据前先关闭桌面客户端，并保留 WAL/SHM 文件。Windows、macOS 制品未代码签名，macOS 未公证；Android 使用 release 签名。iOS 本轮使用 ad hoc 签名 IPA，安装设备须在描述文件授权范围内，App Store 与 TestFlight 是独立分发渠道。

CLI 0.166.91 历史公开版与当时主线范围（2026-10-07） ​

安装 npm i -g chainlesschain@0.166.91 --registry https://registry.npmjs.org，核对 cc --version，升级 IDE 后重启聊天宿主。Open VSX 0.37.136、JetBrains 0.4.154 均推荐该版本；Microsoft Marketplace 未发行。

CLI 发行 SHA 为 23afea300b，其 CLI CI 70 成功/1 条件跳过、Strict 5/5、OIDC 发布成功。子包 Session Core 0.3.16、PDH 0.4.64 先行发布，公开归档 SRI、版本、CLI 精确依赖及 provenance 声明已回读。IDE SHA 5b78b8d828 的 宿主门 18 成功/1 条件跳过；双市场发布工作流成功，JetBrains API 确认公开批准。

主线新增目标/巡检/验收和 RRSI 合同不在上述 CLI/IDE 制品内；桌面新工作区需运行源码，v5.0.3.138 安装包独立。见目标操作、RRSI及公开回读证据。下面的 0.166.90 段落是上一轮发布记录。

概述 ​

本指南分别列出公共 npm、IDE 商店与桌面产品的安装状态，提供升级和本轮新增功能的使用入口。

0.166.90 历史公开版本 ​

组件当时公开版本来源与配对
npm CLI0.166.90v-npm-0-166-90 → 28cff6adc8
VS Code / VSCodiumOpen VSX 0.37.135推荐 CLI 0.166.90；同一发行提交
JetBrainsMarketplace 0.4.153已批准公开；推荐 CLI 0.166.90；同一发行提交
Session Core / SDK / PDH0.3.15 / 0.2.13 / 0.4.63OIDC 发布及公开归档核验成功
Desktop / Android / iOSv5.0.3.138独立产品发行

准确发行提交 28cff6adc8 的 CLI CI（70 成功）、Strict Sandbox（5/5）和 IDE 宿主门（18 成功）通过；条件跳过项不计为通过。质量与安全（9/9）、npm OIDC 发布及 Open VSX 发布成功。PDH 原生完整测试在 Linux、Windows、macOS 各 4482 项通过、0 失败，125 项显式停用的历史用例跳过；Session Core 各 709 项、SDK 各 83 项通过且无跳过。CLI 公开归档精确依赖 Session Core 0.3.15 与 PDH 0.4.63，签名来源绑定本次标签、提交和发布工作流。

JetBrains 0.4.153 的标签发布成功；公共 API 确认 approve/listed=true、hidden=false。独立下载 ZIP 的版本和 plugin ID 已核验，CI 归档原始文件内容全部与公开 ZIP 一致；压缩归档的整体字节不同，不据此声称作者签名已配置。Microsoft Marketplace 未发行；官方 VS Code 从 Open VSX 下载 VSIX 后使用“从 VSIX 安装”。

0.166.90 升级步骤 ​

bash
npm i -g chainlesschain@0.166.90 --registry https://registry.npmjs.org
cc --version

Open VSX 用户升级插件至 0.37.135，然后重启 IDE 聊天宿主。在 Diagnose Bridge 核对实际 CLI 身份与会话能力；静态版本匹配不能替代运行时观察。JetBrains 用户升级插件至 0.4.153，与 CLI 0.166.90 配对后重启宿主。

旧 Memory v2 reader 可能拒绝新索引 descriptor。切换前备份、停止旧 writer；降级需兼容快照。默认 shadow 不触发迁移。

核心特性 ​

  • PDH 公开版：实体与投影意图同事务保存，KG/BM25 分别确认；支持积压查询、分批重试及退休临时 consumer 回执维护。当前宿主使用内存索引，没有连接向量目的地；未知 running 不自动重放。
  • CLI 公开版：新增离线项目风险评估和任务描述预览，不认证 JSON 身份、不执行真实任务动作。结构化审计脱敏和 RAG 更新/删除顺序已加固。
  • 桌面源码：个人项目待办描述支持预览、原生确认和原子回执；风险只检查逾期与直接依赖。该工作区尚未随公开 v5.0.3.138 安装包发行。自动化模拟、低代码设计发布和不支持的 SCIM 出站分别显示真实状态。
  • IDE：Open VSX 0.37.135 已公开流式诊断范围、选区替换与过期帧修复；JetBrains 0.4.153 的标签发布与公共审批回读均已完成。Microsoft Marketplace 未发行。

公开版继续包含 Memory v2 索引分页、冻结评估、Linux cgroup2 恢复、会话能力 Doctor 与慢初始化草稿保护。协议/UI 采集默认关闭；显式采集的原始材料可能包含任务、工具和模型输出。初始化最多等待 120 秒，超时保留草稿并取消本次发送，迟到 init 不补发。

显式 Linux 权限宿主与恢复 ​

持久权限宿主须管理员配置私有持久域、固定描述符及官方 writer，普通 CLI 不默认开启。跨进程/Worker 撤销按 100 ms 轮询，清理成功才发停止回执；恢复规则不复活旧许可。cgroup2 恢复重验 boot/inode/所有权，清理确认的遗留进程后才准入，不重放原命令。见受控宿主说明。

发布证据与验收边界 ​

本轮按子 npm 包 → CLI → IDE 顺序执行，公共 CLI 精确锁定 Session Core 0.3.15 与 PDH 0.4.63。SDK 0.2.13 升级 Vitest 4.1.11，工作区 proxy-addr 升级至 2.0.8。失败或取消的历史候选不授予本轮发行资格；这里引用的是 28cff6adc8 的完整门禁和发布结果。

正式 36+9 样本、真实账号/费用、独立人工签核、真人辅助技术与 8h/24h SLO 仍开放；自动 active Skill 晋升保持 HOLD。静态文档部署不等于 npm、IDE 或桌面产品发版。详细操作见用户指南与增量设计，公共观察见发布后记录。

0.166.84 历史：作用域权限同步撤销 ​

2026-10-02 公开 CLI 为 0.166.84@d93c9c9766，当时配套 Open VSX 0.37.126 与 JetBrains 0.4.146 均推荐 0.166.84。scoped 官方写口在同一运行时、落盘前撤销旧许可；该历史验收不能替代当前源码的持久跨进程/Docker 验收。

0.166.83 继承的运行时修复 ​

WS 宿主 owner/revision 与 ABA 变化、文本/JSON/JSONL/stream/REPL 无人值守入口、首次异步检查前冻结的配置及父子工具上限、官方 settings addRule() 同步撤销均已进入公开版。launcher 存储根在 settings 环境应用前固定；非法 plugin 环境名称被拒绝，保留变量不会被默认配置覆盖。只读加载不会提前建立 ESM 写桥；Windows 原生 ACL 验证保留完整目录检查与足够预算。

0.166.84 历史：设置来源观察与事务基础 ​

严格只读观察包含完整有序候选、缺失文件、别名、未贡献权限的来源、文件身份与摘要，不创建文件、外锚、generation 或权限。显式 Linux settings-authority API 已具备外部目录绑定、guard/prepared/ready 事务与按 transactionId 恢复，但尚未接入默认 permission admission 或官方 settings writer，也没有普通用户启用开关。该基础不能视为默认跨进程权限闭环，Windows 等平台尚未提供等价持久屏障。详见增量设计。

0.166.82 继承的调查恢复 ​

Issue 查询、artifact 下载和保存日志解析统一计入调查预算。同一 Issue 跨网页、CLI/API 读取共享目标，关联 PR 与 workflow run 保持独立。失败断言、源码位置和 suite verdict 在压缩、重启及任务交接中保留；日志下载成功不会改写失败结论。调查停滞时保留 Issue、PR、run ID 与失败断言，围绕实际断言做定向复现。

0.166.79–0.166.80 Docker 出站增量 ​

docker-egress 是 Agent shell 的显式可选后端，只支持 Linux x64/arm64。settings 中须提供 sandbox.engine: "docker-egress"、sandbox.network.allowedDomains 或 deniedDomains 的明确域名规则，以及按 SHA-256 摘要固定的 image 和 relayImage；启动时另需显式开启 --sandbox-network。不能与 strict 模式、排除命令或细粒度额外文件路径组合。CLI 仍先完成命令审批，再在无网络容器与独立策略代理之间建立受限通道。代理不可用或策略身份变化时失败闭合，撤销运行中的连接和 shell；结果或清理无法确认时不要自动重试。macOS/Windows、普通 Docker 引擎和所有网络协议均不在此域名出站承诺内。配置细节与源码限制见运行时增量设计。

公开 Open VSX 0.37.126 已继承 Agent 初始化超时回收修复和模式选择器；上下文校准与真实 provider 轨迹仍是工程诊断证据，不能外推正式质量或全部 provider 验证。

0.166.73–0.166.78 历史增量 ​

增量用户可见行为
PM 效果证据先冻结对照计划和 cohort 槽位，复算报告与签名证据；缺失/失败不能从分母删除
Eval 启动准入管理员可在 suite resolver 前接入签名、Ledger CAS 与耐久回读，并绑定 cohort 登记
调查循环恢复Git/CI 查询和日志解析统一计入进展，压缩后保留已收集证据；Windows Bash 经 stdin 执行
评测导入修复无依赖合同模块避免循环导入读取尚未初始化的 attestation purpose
文件锁交接修复保留接替 owner 的锁，已提交事务不再因交接清理误报 ownership 丢失
Skill 决策边界请求/响应各限 256 KiB；未知模型用量不产生建议，恢复同一会话也阻断后续决策调用
会话与宿主恢复CLI/IDE 分页读取已提交历史并恢复草稿；Stop 与重启后重新对齐权威记录，后台进程清理有界

上述范围按提交记录描述，不代表每个中间版本都完成 npm 发行；本节保留 0.166.90 的历史范围，当前安装版本请参照页首公开版说明。逐槽签名 PM 回执对账已进入公开 CLI 源码，但仅校验提交给接口的回执；完整启动覆盖、真实收益与总成本仍未认证。离线操作见 PM 效果评测指南，实现与限制见增量设计。

v5.0.3.138 桌面与移动端产品发行 ​

GitHub Release v5.0.3.138 已公开，标签对应 eb48ffa31139a826796f4e292135493cd93d88d0。产品发行工作流完成 Windows Setup/Portable、macOS Intel/Apple Silicon DMG、Linux AppImage/deb/rpm、Android release 签名的三种 APK 与 AAB，以及签名 iOS ad-hoc IPA，共 18 个资产。Windows、macOS、Linux 的公开自动更新清单已回读为 5.0.3-alpha.138。产品工作流还重新验证了 CLI 0.166.72 的 npm provenance、标签及精确提交 CI 门禁，但产品标签不能替代独立 npm/IDE 发行身份。

Android 用户应从 GitHub Release 选择对应架构的 APK；AAB 仅供开发者提交 Google Play，本次没有商店上架证明。iOS IPA 通过 ad-hoc 证书导出，只能安装到 provisioning profile 已登记的设备；未通过 App Store 或 TestFlight 分发。Android 应用版本为 5.0.3.138，内置 cc-cli.tgz 仍固定到 binariesVersion=20260711 的内部二进制清单，不等同于独立安装的 npm CLI 0.166.72。桌面安装包公开也不意味着生产 KMS/PKI、独立 witness/grader 或 automatic active Skill 晋升已具备。

0.166.72 历史增量 ​

本地 Skill 决策截止与离线评测 ​

本地决策请求达到配置的截止时间时，CLI 记录 provider-timeout、未知用量和观察事件，并保留原有 Skill 路由。用户取消和账本结算失败仍会终止请求。离线评测对误建议率使用单侧 95% 精确二项上界，缺少有效分母不能通过质量门。上述工程修复不等于模型效果合格，--decision-mode 默认仍为 off。

Laya 本地真实权重联调记录显示，完整 CLI 请求的英文候选元数据会让短中文任务路由到英文权重；该 CPU 环境热请求约需 7–11 秒，超过默认 800 ms 截止。TypeSafe 真实 API、冻结数据集质量、目标环境延迟与费用评测仍未完成。

0.166.71 历史增量 ​

可选择的 Skill 决策提供方 ​

cc agent 支持 --decision-provider typesafe|laya|system-one、--decision-mode off|shadow|suggest、--decision-model、--decision-base-url 与 --decision-timeout-ms。非 off 模式只接受耐久、单 prompt、headless 会话，不能与 --ephemeral、交互 REPL 或 --input-format stream-json 组合。

现有 Skill 检索与准入先执行，再将最多五个已准入候选的有界摘要交给所选 /v1/systemone provider。shadow 只持久记录对照观察；suggest 仅附加 routing.decisionSuggestion，不替换原 selectedDigest，也不加载或执行 Skill。TypeSafe 从 TYPESAFE_API_KEY 或受管 credential transport 读取凭据；Laya 与通用 System One 服务需要认证时可使用 DECISION_API_KEY，不会读取 TypeSafe 凭据。Laya 仅接受 loopback 地址，其他提供方只接受 HTTPS 或 loopback。

当前维护环境尚未完成真实 TypeSafe API 联调，也未完成任何模型在冻结数据集上的质量、目标环境延迟或费用评测，因此默认继续为 off。Laya 单题本地联调只验证真实权重路径，并暴露中文路由与 CPU 截止问题。先按Skill 决策层用户指南使用 shadow 收集证据；拟议放量门和 IDE 不扩权边界见模块 114。

0.166.68 历史增量 ​

浏览器动作与下载隔离 ​

浏览器 observation、navigation、tab creation、history traversal、keyboard action 和 download 分别通过显式 action authority。只读观察授权不能自动升级为导航、按键或下载权限，恢复轮次也不能从旧结果推导新授权。

下载内容以流方式进入耐久 filesystem quarantine，不会直接落入可信工作区。隔离记录绑定来源、摘要、创建/到期时间与 custody 状态；跨进程锁、认证 retain/revoke、崩溃恢复、到期 sweep 和可审计 dispose 防止同一下载被重复裁决或在结果未知时误用。管理员应先审查并明确保留，之后再把文件移动到项目目录。

PM 隔离与发布顺序 ​

PM exploration runner、reviewer 与 grader 运行在有界子进程中，输入摘要、预算、egress decision、recovery snapshot、benchmark receipt 和退出状态都绑定本轮 governed execution context。该变化不把本地/合成证据升级为生产 authority，Desktop readiness 与 automatic promotion HOLD 不变。

发布工作流先构建确定性生成物，再逐一审计 13 个子 npm 包。源码变化但版本未递增、公共 tarball 漂移、标签/Git tree/provenance 不闭合时会在 CLI publish 前停止。本轮先发布 Session Core 0.3.13、Context/Memory Kernel 0.1.5、Personal Data Hub 0.4.62，完成公共回读后再发布 CLI 0.166.68。

精确 SHA 的完整 CLI CI 与 Strict Sandbox 可由发布标签复用，因此不重复执行整套测试；本地、部分矩阵、超时、取消或旧提交结果不能满足发布门。IDE 必须在 CLI 公共回读后发布。ARM64 failed-job rerun 聚合会按矩阵单元选择最新 attempt，同时保留其他单元在早先 attempt 的成功证据。

0.166.64–0.166.65 本次增量 ​

0.166.64 允许恢复中的 read_file 对已知目标使用显式 offset 与最多 80 行的 limit，避免恢复指引要求“定位后读取”却又被全局恢复暂停拦截。它不允许重新整文件转储，也不开放未知目标。

0.166.65 将 CC_TOOL_RECOVERY_PAUSED 等合成控制结果与真实工具观察分开：暂停轮次不会推进重复文件读取、远端相同大输出或失败重试计数；下一次模型请求可按恢复建议继续。全局无进展上限与六次真实尝试上限保留，已知远端目标只能在自身较窄 guard 下继续，无关发现继续暂停。

0.166.63 受治理 PM 证据与恢复链 ​

PM 场景现在具备训练分区投影、Broad 分支与 Deep 串行轮次、宿主强制 token/tool/墙钟预算，以及 execution/grader/merge/evaluator 四角色 Ed25519 回执。Volcengine adapter 以供应商返回 usage 计量并生成脱敏费用 settlement；settlement 必须经外部 durability retain/resolve 后才能进入签名 execution receipt、evidence bundle 与 PM Ledger。独立业务 grader 回读本轮新建文件或品牌化 Desktop outcome source，不接受模型自评。

Desktop outcome reader 只执行绑定 plan/environment/task、签名数据库路径与 source digest 的固定参数化 SELECT。每轮先核对 SQLite backup seal，成功后绑定 execution/grader receipt 与 post-run seal，失败后捕获 failure seal 并永久 taint 当前 host。窄化 transition committer 要求认证、耐久、回读确认；重启时固定 recovery 端口重建最后链头。snapshot-backed 路径先保留并精确回读成功 post-run 或失败 pre-run SQLite backup，再提交绑定快照确认的迁移。

公开 Desktop readiness 继续固定 readyForExecution:false、runtimeVerified:false、authenticated:false、qualifiesForPromotion:false。测试使用本地或合成 durability authority，不能替代生产 PKI/KMS、远端故障域、workspace snapshot、原子 restore、真实 Electron DID/RBAC PM E2E 或物理断电验收。详见受治理 Skill 演进。

Windows 运行时规范化恢复临时路径、保留存活状态锁，并对 ACL 查询/设置的瞬态超时做有界重试；调度 soak lease 改为有界窗口，避免慢平台因租约提前失效产生误报。这些可靠性修复不扩大 sandbox、promotion 或 Desktop 安装包的发布范围。

Context/Memory Kernel 将任务目标、文件证据、失败、修改、计划和压缩边界写入带 session、revision 与 digest 的权威检查点。CLI 将已验证状态投影为 .chainlesschain/sessions/<session-id>/WORKLOG.md；Markdown 缺失或被修改时可以重建，不能通过手工编辑获得权限或覆盖权威状态。

VS Code 标签栏 ↗ / 命令 Continue in New Conversation with Task Notes 与 JetBrains Continue in new chat 会先等待完整工具边界并保存记录，再打开独立会话。接力只传递已校验记录引用，不复制完整聊天、不继承临时权限或未完成工具；加载失败时不调用模型。使用步骤见IDE 任务记录与新会话接力。

TaskCheckpoint 已同步到 Agent Protocol 0.1.11、TypeScript Agent SDK 0.2.11、Python Agent SDK 0.2.9 及生成的 Kotlin/Swift 投影。

0.166.51–0.166.56 历史增量 ​

请求级容量按实际 provider、model、endpoint 与 contextMemoryModelWindowTokens 覆盖解析，并让 planner、自动压缩器、会话 ledger、REPL、cc context --json 与 IDE 指示条复用同一上下文窗口。主指示只消费主模型调用；子 Agent 或语义压缩调用不会覆盖它。IDE 有真实请求用量时显示 input/output/cache read/cache write，没有时明确标记 transcript estimated。大窗口主要按 token 压力压缩，小窗口仍保留消息数保护。

Evolution 部署新增 init-test 和 replace-test，可在正式 PKI/KMS 未到位时创建明确标记的本机 TEST 环境，再用受限 root-rotation proof 原子切换为正式 descriptor/trust root。macOS 凭据目录使用实体路径，不受 /var//private/var 别名影响。TEST 部署不提供审核、发布、witness 或 grader authority；完整命令和替换步骤见受治理 Skill 演进。

升级或固定安装：

bash
npm i -g chainlesschain@0.166.84 --registry https://registry.npmjs.org
cc --version
cc evolution deployment status --json

2026-09-13 主分支新增能力与使用方式 ​

以下增量已经进入 v-npm-0-166-47 的提交祖先链。CLI、IDE 与 Desktop 仍按各自制品验证，不能把 npm 发布证明外推到原生客户端。

能力操作与行为保留边界
模型能力诊断cc llm capabilities --json 显示窗口、输出预算、目录版本与 digest不访问凭据、不联网、不写配置；runtimeVerified:false 是静态诊断的预期状态
原生 Responses精确官方 endpoint 与目录明确标记的模型由 profile 选择协议第三方兼容网关保留 Chat Completions；不代表真实账号认证
延后回答偏好和补充信息问题可保持 pending，Agent 继续独立工作独立 Headless 问题可跨进程重启恢复；决定/授权仍需等待，答案一次消费且过期不授权
中文记忆召回Context Memory Kernel 新增受治理中文词法检索召回仍按作用域和治理状态过滤
沙箱能力报告cc sandbox capabilities --no-probe --json查询时 applied 为空；成功启动子进程后才报告实际应用
插件评测与容量control/candidate 绑定评测；持久 Memory/后台状态基准已有有界分页索引与权威全扫回退；不自动激活插件，不构成性能 SLO

新建 Volcengine 文本配置延续 DeepSeek V4 Flash GA 默认值；已有配置不迁移。Responses 使用 store:false，不完整工具调用不会进入执行器，加密 reasoning item 仅用于协议连续性。

普通聊天报 CC_AGENT_EVOLUTION_INGRESS_FAILED 时先确认已升级 0.166.84；若配置了治理部署，应检查描述符、trust root、摘要及授权范围。不要为普通聊天部署测试 authority。普通 Docker/bubblewrap 沙箱不提供可强制执行的域名级 allow/deny；新增 Linux docker-egress 路径要求显式配置与固定镜像，仍不支持细粒度文件规则或命令排除。

完整源码边界见运行时增量设计。

核心特性 ​

  • 统一 Agent ingress 持久化 UserPrompt、工具调用和真实终态。
  • Skill 变更坚持 candidate-first，并以评估、证据、人工复核、lease/CAS 与 release registry 约束晋升。
  • Wiki Maintainer、四层结构化 Memory、PostCompact 与 policy/semantic receipt 共用耐久账本。
  • 旧 candidate/release/state/ledger 可迁移、可对账，异常身份或不完整证据会失败闭合。
  • Workbench 可列出候选、比较版本并提交 approve/reject/rollback 请求；客户端没有 mutation authority。
  • cc skill search 使用 canonical digest、索引 witness、可选独立向量和 verified outcome evidence 排序。
  • 加密知识冲突只暴露删节投影，认证 merge plan 经 trust ledger、撤销依赖结算和持久发布恢复后生效。
  • cc llm configure 从有界 stdin JSON 原子保存模型连接，凭据不进入 argv；cc llm test 按 OpenAI-compatible、Anthropic、Gemini 与 Ollama 原生协议探测。
  • Workbench 默认打开状态总览与版本列表，Skill Library 提供只读筛选与分页；长任务在持续探索无交付时进入聚焦恢复。
  • CLI direct stream、意图识别、WebSocket chat、Hub 分析/Skill/实体解析共享宿主注入的治理 Run；模型身份漂移、不完整 stream 或治理失败均失败闭合。
  • Evolution witness 使用不可变 256 条分段和有界 tail，authority trust epoch 改变时 verified summary 失效。
  • VS Code/JetBrains 在显示保存成功前重新读取脱敏配置；推理模型连接测试使用有界 1,024-token 输出预算。

系统架构 ​

text
REPL / headless / stream / AgentRuntime
                  │
                  ▼
       EvolutionRun composition
        ├─ Candidate + Eval
        ├─ Evidence + Ledger
        ├─ Human review registry
        ├─ Wiki + Memory producers
        ├─ Workbench + Skill Retrieval
        ├─ Governed knowledge merge
        └─ Release / LKG / rollback
                  │
                  ▼
       host-owned policy and authority

客户端只能提交有界意图。candidate、证据或 capability 都不能自行成为 active writer；最终状态转换必须由宿主拥有的 policy 与 authority 完成。

历史公开组合（2026-09-09） ​

下表保留 0.166.38 发布时点记录；当前 CLI 安装使用 0.166.90，IDE 与其他组件的商店版本需按各自发布渠道核对。

组件公开版本获取渠道
CLI0.166.38npm
Core DB0.1.5npm
Context/Memory Kernel0.1.1npm
Session Core0.3.12npm
Agent Protocol0.1.9npm
TypeScript Agent SDK0.2.9npm
Python Agent SDK0.2.8PyPI
VS Code IDE Bridge0.37.92Open VSX
JetBrains IDE Bridge0.4.119JetBrains Marketplace
Personal Data Hub0.4.60npm

Open VSX 0.37.92 与 JetBrains Marketplace 0.4.119 已公开并推荐 CLI 0.166.38。Microsoft VS Code Marketplace 尚未公开该扩展，stock VS Code 用户应从 Open VSX 下载 VSIX。

历史增量（0.166.38） ​

  • 模型入口治理：direct stream、intent、legacy/canonical WebSocket 与 Hub 模型调用在 provider I/O 前绑定认证 Run、provider 和 model；终态与证据持久化完成后才报告成功。

  • Desktop Hub IPC：源码 8c1772ba6c 将 resolver drain 与分析 Skill 绑定到主进程 opaque host；每次调用创建 scoped wrapper，不向 renderer 暴露 composition factory，也不改写缓存 Hub 的全局模型 client。

  • Desktop Web Shell 与后台入口：源码 1fd9e684f2 把内嵌 Web Shell 的 WebSocket server 绑定到同一 main-process-only factory；5e3ee29808 / 4f61109dcf 完成并记录后台入口审计；22b23a0335 固定 Desktop Coding Agent bridge 对部署环境的继承测试。CLI-owned background、Agenda、Routine、detached worker 和该 cc serve bridge 均经 canonical CLI 入口，但不外推到第三方命令或自行直连 provider 的 SDK worker。

  • Legacy ImageGen 入口：源码 a238e6c245 使 15 个 Desktop ImageGen IPC 的内容调用在缓存、provider 选择和 fallback 前失败闭合；管理器、Stable Diffusion 与 DALL·E client 不会在拒绝后继续发起内容请求。

  • 失败不降级：不完整 provider stream、模型身份变化和治理错误不会被 Skill commentary、intent fallback 或 Hub fallback 吞掉。

  • witness 分段：历史 witness 前缀固化为 256 条不可变 segment，只重写有界 tail；读取重验 segment hash，trust epoch 改变时清除已验证摘要。

  • 可靠模型配置：IDE 原子提交连接并用脱敏 readback 比对 provider、endpoint 与 text/vision model；连接测试给 reasoning model 足够但有界的输出预算。

  • 子包协调发布：Agent Protocol 0.1.9 增加知识撤销 prepare/publish schema 与 Kotlin/Swift binding；Context Memory Kernel 0.1.1 把 LLM selector 纳入 writer inventory。

  • 大网页只下载一次：web_fetch 将 10 MB 原始下载预算与默认 20,000 字符返回预算分离；完整但过长的提取文本写入有界本地快照，可按 snapshotId、nextOffset 继续读取。

  • 长文本检索：web_search 负责关键词发现；已保存网页和本地长文本由隔离 worker 流式搜索，返回位置、上下文和续读游标，正则、并发与输出均有上限。

  • 结构化失败：HTTP、超时、响应超限、验证挑战和不完整下载明确标记，IDE 保留错误码与恢复建议，不把前缀或部分下载称为完整页面。

  • 最低 Node 兼容：恢复 Node.js 22.12.0 下使用项目自带 SQLite 驱动的完整发布套件，并保留并发恢复失败诊断。

  • 原子模型连接：cc llm configure 同一把锁内绑定 provider、Base URL、模型与 credential，切换目标地址时不复用旧密钥；stdin 最大 32 KiB，远程 HTTP 需显式确认，URL 不接受内嵌凭据、query 或 fragment。

  • 原生协议探测：cc llm test 对 OpenAI-compatible、Anthropic、Gemini、Ollama 构造各自协议请求，拒绝 redirect，20 秒超时且必须取得非空模型文本。

  • 页面化 IDE：VS Code 0.37.87 的 Workbench 先展示状态与版本列表，Skill Library 支持筛选/分页；决定仍要求 capability 与 fresh-state 复核。自定义连接页面不回显密钥，先保存再测试。

  • 任务恢复：0.166.25–0.166.29 保留跨压缩读取位置，避免重复整页/整段输出，在长期探索没有实现进展时收敛到搜索、编辑和验证；IDE Stop 先中断，5 秒无响应后终止，再次 Stop 立即终止。

  • 长任务聊天：交互式流式 Agent 不再因默认 50 次模型调用上限中断长任务；显式轮次、费用和会话预算继续生效，无人值守任务仍保留默认上限。大文件读取按字节/行游标分页，压缩后保留最新读取位置，未变化页避免重复注入；慢命令期间 IDE 会话继续保活。

  • 治理恢复：受治理演进补齐持久 Workbench 审核/回滚与启动恢复、知识候选独立隔离/拒绝、跨 Wiki 多级来源撤销和 tombstone 恢复、Skill/Prompt/Hook 制品发布与受控市场候选安装。启动仅补记已发生的效果，未执行计划保持待处理；候选安装不会直接激活 Skill。真实身份、签名、策略、KMS/PKI、witness、grader 和目标环境验收仍由部署方提供。

  • 依赖安装：Session Core 0.3.12 补齐 evolvable-artifact 出口，Core DB 0.1.5 修复命名参数绑定；CLI 固定对应依赖。

  • Node 兼容：沙箱与独立 Eval 子进程按 Node 22.12 支持的权限标志启动。

  • 公共安装启动修复：cc、cc agent 和 cc agent --capabilities 可从官方 npm 的全新安装加载完整命令图。

  • 持久 Agent ingress：交互 REPL、单轮 headless、stream headless 与 AgentRuntime 可由可信宿主注入 EvolutionRun composition；UserPrompt、tool request/result 和真实终态在继续执行前持久确认。

  • 受治理 Skill 生命周期：candidate、目标矩阵 Eval、认证 evidence、human-review quorum、tenant release、lease/CAS promotion、LKG 与 rollback 共同约束 active 变化。

  • Wiki 与 Memory：Wiki revision、四层结构化 Memory、PostCompact、promotion/policy/semantic receipt 使用 ArtifactPorts + Ledger，支持响应丢失幂等和新实例恢复。

  • 旧状态迁移：legacy candidate/release/state ledger 通过计划、journal、baseline/current projection 和启动 reconciliation 迁移；歧义或认证失败时保留现场并失败关闭。

  • registry transition：Candidate/Eval/HumanTask request/attempt/settlement 事件驱动 evaluated + human-reviewed control plane；capability 不进入持久状态，commit/settlement crash 可恢复。

  • Evolution Workbench：list、compare、review 与精确 from→to rollback 只通过 branded trusted deployment host 执行；Desktop 和 IDE 消费同一有界投影。

  • Skill Retrieval：四类来源统一进入 canonical router；digest、索引 witness、向量 authority 与 invocation outcome 证据不一致时 abstain。

  • 加密知识治理：持久冲突、认证人工 merge、AES-256-GCM/Ed25519、RBAC、trust ledger、撤销依赖处置和 response-loss/crash recovery 组成完整事务链。

  • 旧壳退役：不可达 Phase 100 simulator 和未注册 IPC 已移除；公式训练路径只保留 metrics。

上述能力不代表默认开启无人值守 active promotion。Workbench/Knowledge UI 是受信宿主的有界审阅面，不是 authority 本身；目标环境 KMS/HSM/PKI/identity/policy/witness/scheduler/transition authority、真实跨平台 grader、kill-switch/canary 运营和生产灾备演练仍是部署条件。

使用示例 ​

全新安装后先核对版本与能力面，再按需进入交互 Agent：

bash
npm install --global chainlesschain@0.166.90 --registry https://registry.npmjs.org
cc --version
cc agent --capabilities
cc agent

安装与升级 ​

CLI ​

bash
npm install --global chainlesschain@0.166.90 --registry https://registry.npmjs.org
cc --version
cc agent --capabilities

cc --version 预期输出 0.166.90。cc agent --capabilities 应能执行，但其中某项显示 disabled/unavailable 可能只是当前宿主没有注入生产 authority，不应以测试密钥或环境变量绕过。

SDK 与协议 ​

bash
npm install @chainlesschain/agent-sdk@0.2.13
npm install @chainlesschain/agent-protocol@0.1.12
python -m pip install chainlesschain-agent-sdk==0.2.9

IDE ​

  • Open VSX：在扩展页选择当前公开的 chainlesschain.chainlesschain-ide 版本。
  • 官方 VS Code：从 Open VSX 扩展页 下载 VSIX，运行 Extensions: Install from VSIX...。
  • JetBrains 2024.2+：在 Marketplace 搜索 ChainlessChain IDE，按公开版本安装。不要把源码版本当作商店已发布版本。

配置参考 ​

目标配置或命令当前边界
普通本地 Agentcc agent默认禁网 workspace-write，不探测 Docker
显式容器隔离CLI flag、settings 或 managed policy引擎不可用时失败关闭
Skill 候选合成cc learning synthesize --json缺可信 LLM/store/evaluator/active roots 时 unavailable
Workbenchcc evolution workbench ...缺 trusted deployment host 时 unavailable
知识冲突审核cc evolution knowledge ...只返回删节投影；merge 由宿主复核
Skill 检索cc skill search ...命中不等于安装或晋升
Jev 决策试点cc agent --session <id> --decision-mode shadow -p ...默认关闭；需要 TypeSafe 凭据；shadow 不改变路由
Agent 能力cc agent --capabilities显示能力不等于 production composition 已启用
IDE 安装Open VSX / JetBrains MarketplaceOpen VSX 0.37.135 推荐 CLI 0.166.90；JetBrains 公开 0.4.153 推荐 0.166.90
更新检查npm view chainlesschain version应从官方 npm registry 回读
  • candidate 创建、Wiki 更新或 Memory 接受都不授予 active 写权限。
  • 客户端 option、环境变量和本地测试密钥不能创建 production composition。
  • Ledger 断链、witness 不一致、receipt substitution、陈旧 revision 或跨 tenant 输入会阻止 mutation。
  • npm CLI 包不包含 Electron Desktop 字节；历史 Desktop qualification 不等于当前 native fresh-install/upgrade/rollback 已发行。

性能指标 ​

本版本不把本地单测耗时或 CI wall time 承诺为用户 SLA。运行时保持有界队列、容量限制、超时、lease/fence 和恢复语义；生产部署应按目标 provider、存储、网络与 grader 重新建立延迟、吞吐和恢复时间基线。

测试覆盖 ​

当前公开 CLI 0.166.90@28cff6adc8 已完成准确提交的完整矩阵与 OIDC 发布：

门禁Actions / 公共渠道状态
CLI CI37407644585三平台全矩阵；70 成功，条件跳过单独记录
Strict Sandbox37407644409Linux x64/ARM64、Windows、macOS 15/latest；5/5
IDE 宿主门3740768684718 成功，标签专用步骤按条件跳过
质量与安全374076443859/9；依赖安全更新通过
npm OIDC 发布37413002340子包、CLI 发布与公开归档核验成功
Open VSX374143596830.37.135 已公开；推荐 CLI 0.166.90
JetBrains374143703650.4.153 发布成功且批准公开；推荐 CLI 0.166.90

PDH 三平台各 4482 项通过、0 失败，125 项显式停用的历史测试跳过；Session Core 各 709 项、SDK 各 83 项通过且无跳过。公开 CLI 的签名来源绑定 28cff6adc8、本次 npm 标签及发布工作流。npm、IDE、桌面产品仍分别验收。

安全考虑 ​

  • 保持默认禁网 workspace-write；不要以测试密钥、环境变量或 UI 输入伪造生产 authority。
  • promotion、rollback、kill-switch 与 canary 必须复核 tenant、candidate、active revision、policy 和 evidence binding。
  • Ledger 断链、witness 分歧、陈旧 lease、receipt substitution 或迁移歧义都应中止状态变更并保留现场。
  • Desktop、IDE、SDK 和 CLI 是不同发布制品；一个渠道的成功证据不能授权另一个渠道。

故障排查 ​

unknown command 'agent'：这通常是旧版公共安装与 Session Core 导出不匹配。升级到 0.166.90，再运行 cc agent --capabilities。

npm 镜像返回 E404：显式使用官方 registry：

bash
npm install --global chainlesschain@0.166.90 --registry https://registry.npmjs.org

官方 VS Code 搜不到扩展：Microsoft Marketplace 尚未公开；从 Open VSX 下载 0.37.135 VSIX。

JetBrains 版本过旧：Marketplace 当前公开 0.4.153；若本机搜索仍显示旧版，刷新插件列表并确认 IDE 版本至少为 2024.2。

普通启动仍检查 Docker：确认 cc --version 为 0.166.90，再检查 CLI flag、settings 或 managed policy 是否显式选择容器隔离。

Workbench/Knowledge 提示 trusted deployment host required：当前进程未接入部署治理宿主。保持失败闭合，由管理员配置 identity/policy/ledger/KMS authority；不要回退到本地直写。

能力显示 unavailable：这通常表示宿主没有配置可信 adapter 或 authority。保持失败关闭，由管理员按部署设计补齐，不要复制 candidate 到 active 目录。

关键文件 ​

  • packages/cli/package.json：CLI 公共版本与打包入口。
  • packages/session-core/package.json：Session Core 版本与导出边界。
  • packages/cli/src/lib/agent-evolution-runtime-composition.js：受治理进化的组合入口。
  • packages/cli/src/lib/evolution-run-store.js：耐久 EvolutionRun 状态。
  • packages/cli/src/lib/evolution-ledger.js：防篡改事件账本。
  • packages/cli/src/lib/decision-layer/：Jev 类型化请求、provider、runtime 与 benchmark。
  • docs/design/modules/114-jev-decision-layer-design.md：Jev 决策层架构、评测门和 IDE 边界。
  • docs/design/modules/112-governed-skill-evolution-design.md：完整设计与生产缺口。
  • docs/design/modules/113-governed-desktop-model-ingress-design.md：Desktop 模型入口、失败闭合和缓存/witness 设计。

相关文档 ​

基于 MIT 许可发布

Copyright © 2024-2026 ChainlessChain Team