ECC 2.2.1 修复安全与安装问题

ECC 2.2.1 是针对 ECC 2.2 的缺陷与安全补丁，发布说明将其描述为已准备的补丁，并说明发布与签名证据另行在发布检查清单中跟踪；v2.2.0 的历史保持不可变。

安全与数据保护

• GateGuard 与治理捕获现在能识别破坏性 PowerShell 命令，包括原生 PowerShell 工具路径；动态命令处理避免后续变量赋值掩盖此前未解析的调用（#2961）。
• 相对 GateGuard 豁免 glob 被限制在项目根目录内，显式绝对路径豁免仍受支持（#2921）。
• 安装器写入会拒绝与未被跟踪的用户自有文件发生冲突；安装失败时只刷新实际写入文件的归属哈希，未触碰的受管文件保留原哈希（#2964）。
• 引导式设置在归属过滤前重新校验预览，若预览与应用之间出现文件则要求重试，而非误报成功；相同的既有用户文件仍不在 ECC 归属范围内。
• 卸载遵循 ECC_DRY_RUN=1，包括旧版 Codex 路径，并拒绝无效的 dry-run 取值，而不是静默允许删除（#2952）。
• Observer 分析在未成功或未确认的处理上保留观察记录，仅退出码为零不再允许归档（#2971）。
• Yarn lockfile 将 toml 更新至 4.3.0，与 npm lockfile 一致，移除受影响的旧解析。

Hooks 与安装

• 手动 Claude 安装会在 Claude 设置中注册 ECC 所有的 hook 条目；修复、同意变更和卸载会协调这些条目并保留无关设置，原子设置更新会检查目录身份并重试检测到的并发编辑（#2992）。
• 直接 hook 入口以有界、UTF-8 安全的方式读取更大的 JSON 负载，不再静默截断有效输入；既有生产包装器限制不变（#2924）。
• Pi 适配器选择实际的 Node 运行时，而不是将编译后的 OMP host 递归当作 Node 执行（#2909）。
• 安装器列表与控制面板帮助避免急切加载第三方依赖，缺少运行时包的功能会明确报告缺失依赖（#2994）。
• 自主 harness 设置文档用有记录的接口替换不存在的包名与不支持的 CLI 标志，并区分会话调度与持久外部调度器（#2957）。

安装文档与发布面加固

公开与打包安装文档统一指向已发布的 ecc-universal 命令，AdaL 适配器文档使用 npx ecc-universal doctor --target adal。Claude 设置在供应商相关操作前预检 git，缺失前置条件会快速失败。引导式 dry run 使用隔离的 HOME、配置、XDG、临时与 Windows 应用数据根目录，避免宿主环境状态干扰审查或测试。打包产物的生命周期覆盖扩展到 Claude 与 Kimi 的设置、更新、doctor、重复安装、卸载和 dry-run 流程，并新增标识符回归覆盖，阻止过期命令重新出现在用户文档中。

文档与来源边界

标准 Itô 工作流文档新增 ecc ito accept <ticket-id> 与 ito_accept MCP 工具说明；接受操作明确限定为买方权限路由，将当前 desk 报价送交人工审核，并不声称执行交易。

说明指出 v2.2.1 计划为指向绿色 main 的签名附注标签，v2.2.0 保持为无签名的历史例外，该标签不应移动、重建或复用。

范围与限制

插件依赖处理不捆绑或自动安装缺失模块；数据库与 schema 校验功能需要其声明的运行时依赖。归属保护覆盖未跟踪冲突和安装失败检查点，成功升级仍沿用替换此前受管文件的既有约定，升级前应备份有意的修改。此补丁不引入新的 harness 平台，也不声称解决所有开放的社区 issue。

升级方式

发布工作流发布 2.2.1 并验证注册表完整性后，可安装或更新，再运行既有的 ECC 命令路径；在发布完成前，精确版本命令会返回 E404。

npm install -g ecc-universal@2.2.1
ecc doctor

首次或引导式终端设置使用 npx ecc-universal setup；原生 Claude marketplace 路径仍受支持。来源时间为 2026-09-08。