evolcore 0.0.23 → 0.0.25

package/CHANGELOG.md

@@ -1,516 +1,583 @@
-# Changelog
-
-本文件记录 EvolCore 的重要变更。EvolClaw 版本线的历史记录已归档至
-[`docs/_archive/CHANGELOG-evolclaw.md`](docs/_archive/CHANGELOG-evolclaw.md)。
-
-## 0.0.23 (2026-09-08)
-
-### 会话、Trigger 与 Codex 运行时
-
-- 完善 Codex 子代理的上下文继承、权限传递和任务生命周期收敛，并贯通工具调用标识与授权审计。
-- 为受信任的 root Fullaccess Claude 会话显式设置沙箱标记，并限制复杂 PowerShell carrier 的摘要解包范围。
-- 确保 daemon Trigger 在错误已经渲染后仍发送明确终态，并传播中断生命周期元数据、统一中断结果分类。
-- 完善话题续接、会话后端身份校验和跨客户端线程释放，降低重启、续接与并发操作造成的旧任务串入风险。
-
-### Windows、AUN 与配置安全
-
-- 统一 Windows IPC 端点路径规范和跨进程命名管道连接，修复实例 socket 路径在不同运行入口间不一致的问题。
-- 修复 Windows 配置与联系人数据的锁竞争，支持安全识别并回收损坏或遗留锁文件。
-- 强化 Windows Shell 签名信任校验，在允许受信任命令执行的同时收紧受管命令边界。
-- 增加受保护的 AUN Menu 客户端和 daemon 诊断入口，补充 E2EE 请求校验、EC Web token 授权与日志查询边界。
-- 校验并恢复 WeChat 增量同步游标，遇到无效游标时隔离本地状态并自动重试。
-- 升级 `@agentunion/fastaun` 至 `0.5.13`；`ec group invite` 改用定向邀请生命周期，并新增邀请类型与接受/拒绝/撤回命令。
-
-### EC Web 与监控
-
-- 完善 EC Web 认证恢复、Trigger 管理和操作授权审计上下文。
-- EC Web Monitor 按客户端订阅生命周期启停进程树采样，避免无订阅时持续采集。
-
-## 0.0.22 (2026-09-04)
-
-### 话题续接与触发任务
-
-- 完善话题 `/renew` 的并发屏障、后端身份校验和辅助模型配置迁移，避免续接期间旧任务或旧后端结果串入新话题。
-- 完善 Fullaccess Trigger 的持久授权、批准状态、CLI 参数和调度运行时，统一 daemon-owner 身份与审计关联。
-
-### Bootstrap、会话与消息队列
-
-- 增强 Agent 创建规划、Bootstrap 完成鉴权和欢迎消息投递，补齐生命周期门禁、事件记录与失败恢复。
-- 完善消息队列、会话恢复、跨会话 Handoff 和响应引擎的状态收敛，降低重启、续接与并发操作造成的消息丢失或重复处理。
-
-### 服务配置与消息管理
-
-- 统一本机服务和 AUN Service Proxy 的配置读取、schema 与旧版迁移，并贯通 Agent 启动和 IPC 管理链路。
-- 完善 `ec msg history` 按渠道实例和原生对端 ID 查询历史的参数传递、权限校验与结果处理。
-
-### AUN 投递、联系人与观察者
-
-- 完善 Outbox 投递状态、消息回执、永久失败诊断和路由变更保护，避免迟到结果误删已调整路由的待发消息。
-- 强化联系人申请、Owner 审核以及托管私聊入站/出站准入，补齐拒绝原因与审计信息。
-- 修复 Observer 消息转发的异步时序，并按群成员关系过滤重复通知。
-
-### Codex 权限与跨平台安全
-
-- 强化 Codex Shell 命令解析、委派校验、工具摘要和受保护路径策略，明确受管运行身份与权限决策证据。
-- 修复 Windows Codex managed hook 的动态 IPC 校验与安装配置，统一 proactive hook 可用性检查并保持 H-class/L-class 保护边界。
-- 修正 Codex Windows 文件系统 glob 规则，改善受管临时目录和锁目录的跨平台匹配。
-- 统一 BaseAgent 请求地址和身份请求头传递，完善 Codex 会话启动、重连与错误诊断。
-
-## 0.0.21 (2026-09-03)
-
-### 话题与权限控制
-
-- 新增话题 `/renew`，支持在空闲状态下安全续接话题后端会话，并强化并发操作与异常恢复处理。
-- 新增 `/fa`、`/fullaccess` 和持久 Fullaccess Trigger，统一 daemon-owner 授权、可信运行身份与审计记录。
-
-### 服务与消息管理
-
-- 统一本机服务和 AUN Service Proxy 的配置与旧版迁移，支持按实例配置本机服务及代理。
-- `ec msg history` 支持按完整渠道实例和原生对端 ID 查询已落盘的非 AUN 私聊历史。
-
-### AUN 投递与联系人
-
-- 完善 AUN Outbox 投递与回执处理，覆盖排队、重试、过期和永久失败等状态。
-- 新增联系人申请与 Owner 审核流程，并将联系人策略应用到托管私聊的入站和出站准入。
-
-### 安全与运行兼容
-
-- 加固 Codex Shell 载体解析、受管权限校验和受保护路径沙箱边界，并将受保护路径策略归入权限模块。
-- 统一 BaseAgent 请求地址和身份请求头处理，升级 AUN SDK 至 0.5.10，并兼容 Node.js 22.16.0。
-
-## 0.0.20 (2026-08-28)
-
-### AUN 网关与投递可靠性
-
-- 接入 SDK 网关发现结果，校验消息 ID、投递状态和显式路由，区分永久失败与可重试失败。
-- Outbox 保留永久失败诊断，并以路由条件更新避免并发投递覆盖修正后的目标。
-
-### Bootstrap 与配置生命周期
-
-- 收紧 Bootstrap 消息路由和 Agent 生命周期门禁，补充配置兼容校验及 `ec init` 的 ecagent 配置交互。
-- 增加 Agent、Daemon 和默认配置 schema 版本，权限审计记录命中的策略路径。
-
-### 观察者模式
-
-- 观察者模式默认开启，显式设置 `false` 才关闭并持久化覆盖。
-
-### 跨平台运行与安装
-
-- 统一运行时根目录解析，延长 Windows Daemon IPC 优雅关闭等待，并完善 Codex 受管目录安装准备。
-
-## 0.0.19 (2026-08-27)
-
-### PowerShell EC 命令安全
-
-- 支持 PowerShell `pwsh`/`powershell` 受管命令载体解析，拒绝拼接、展开和重定向。
-- 统一 Codex EC 命令委派与预检解析，补充 PowerShell 引号、展开和错误指引。
-
-### Bootstrap 与运行时控制
-
-- Bootstrap 阶段保留 Menu 与斜杠协议处理，普通模型任务继续按生命周期门禁。
-- 命令意外泄漏至响应引擎时统一丢弃并记录失败审计，避免进入 Agent 执行。
-
-### 跨平台安装与诊断
-
-- Windows 数据迁移固定调用系统 `bsdtar`，避免 Git Bash GNU tar 误解析 Windows 绝对路径。
-- Linux 公开安装器与 npm 全局安装/升级均幂等创建真实 `/etc/codex` 目录；root 历史实例可在启动任务时自愈缺失目录，同名文件和符号链接仍被拒绝。
-- 统一数据根解析，仅使用 `EVOLCORE_HOME` 或 `~/.evolcore`，避免因启动目录不同误用数据目录。
-- `ec start` 已运行提示新增 Daemon 持续运行时长，并支持 IPC uptime 回退探测。
-
-## 0.0.18 (2026-08-27)
-
-### DaemonOwner 与受管 Agent 操作
-
-- 新增 `daemon-owner` 进程角色，仅由 `daemon.json.owners` 的控制 AID 解析。
-- 进程操作、跨 Agent Trigger 与内部 Trigger 目录统一要求 DaemonOwner。
-- Agent channel 保持仅能操作自身；拒绝结果附带原因码与下一步指引。
-- 受管任务通过委派 IPC 执行授权的 `ec agent` 查询、非交互创建和生命周期操作。
-
-### 任务暂停与 Bootstrap 门禁
-
-- 新增 `/pause`、`/resume`，在下一次工具调用前暂停或恢复当前任务。
-- Codex、Claude 与 ecagent 的工具边界均接入暂停门禁；任务结束自动解除。
-- Agent 仅在 `active`、`bootstrapping` 生命周期运行，不再回退默认 Runner。
-- Bootstrap 隔离普通任务与上下文，仅允许受限的 `agent.md` 确认、发布和 ready。
-- 首次欢迎消息按实际私聊或群聊路由持久化投递。
-
-### AUN 投递与连接可靠性
-
-- 群消息恢复支持有界多页补拉，避免尾部同步后遗留大积压。
-- 适配新版 AUN 连接状态事件，隔离旧客户端事件并记录传输/入站时间。
-- 受管沙箱发送 AUN 消息改经配置存储读取超时和默认加密设置。
-
-### 审计、安全与跨平台运行
-
-- 菜单响应新增 `processing_ms` 与独立的协议业务流日志。
-- 工具与授权审计新增生命周期键、执行状态和敏感参数脱敏。
-- 统一 Codex 受管 `PreToolUse` Hook，强化 Bubblewrap 挂载与失败熔断诊断。
-- 原子写入保留正式文件并刷新热备，避免受保护状态挂载竞态。
-- `ec stop`、`ec restart` 优先经 IPC 请求守护进程优雅退出并校验 PID。
-- Windows 自启增加计划任务校验、用户级 Run 回退和非 EvolCore 配置保护。
-
-## 0.0.17 (2026-08-25)
-
-### Claude 与任务边界
-
-- 统一识别 Claude 启动参数过长错误，记录结构化能力不可用审计并以明确终态结束任务，避免无效重试和敏感启动参数泄露。
-
-### Codex 与 AUN 消息兼容
-
-- 将运行时 BaseAgent 信息传入任务上下文，仅对 Codex AUN 私聊/群聊文本载荷解码一层 `\\n`/`\\r`/`\\t` 转义，保持其它 Runner 和原始换行不变。
-
-### 临时目录与跨平台稳定性
-
-- 改进受管临时目录创建根路径解析，在拒绝不可信 TMPDIR 时使用固定系统回退并兼容 macOS `/var` 实路径，强化跨平台私有目录校验。
-
-## 0.0.16 (2026-08-25)
-
-### 任务与消息可靠性
-
-- 统一任务总执行时限与 AUN 附件投递重试边界，补充可恢复失败的退避与错误上下文，避免无配置时误设总超时。
-- 优化会话响应、事件总线和守护进程生命周期，完善任务结束、重试和清理时的状态收敛。
-
-### Windows 与运行兼容性
-
-- 强化 Windows 进程识别、登录自启状态探测和命令输出解码，避免误识别其它 Node 服务并改善失败诊断。
-- 修正 Windows Claude 沙箱 settings 的受管临时文件生命周期，收紧运行目录校验，并为过长的 Unix socket 路径提供隔离的短路径回退。
-
-### 审计与权限边界
-
-- 增强结构化日志完整性检查、生命周期关联和重复记录识别，统一工具错误分类与审计上下文。
-- 收紧只读诊断、受保护路径和运行时锁访问策略，仅允许显式授权的有界源码诊断。
-
-## 0.0.15 (2026-08-25)
-
-### Codex 文件授权
-
-- 文件变更的临时授权按 canonical 化后的完整目标文件集合匹配，变更内容或顺序调整不再扩大授权范围。
-- 统一 Codex 文件授权的交互反馈，明确区分同文件临时授权与同操作临时授权，并收紧跨会话授权契约。
-
-### 运行安全与审计
-
-- 为 Claude、Codex 和 ecagent 的工具预检拒绝统一补充结构化授权审计，便于追踪策略、请求和会话上下文。
-- 规范 Codex 审批命令与委派校验，拒绝无法规范化的复合命令和空字节输入，并修正 Windows 受管临时目录的私有性校验。
-
-## 0.0.14 (2026-08-24)
-
-### Codex 受管运行与安全
-
-- 强化 Codex proactive 模式的受管 PreToolUse 校验，Linux 使用隔离运行时，Windows 支持受管 Hook 安装、加载检查和 fail-closed 启动。
-- 隔离会话临时目录并统一运行时锁管理，收紧 Shell、文件访问和受控 EC 命令解析，扩展群文件 ACL 操作及权限校验。
-- 完善工具审批、委派票据和工具结果关联审计，避免未成功发送或未完成授权的操作推进主动模式状态。
-- 为 Claude、Codex、ecagent 的工具预检拒绝补充统一结构化授权审计，记录策略码、请求/任务及会话上下文，便于跨 Runner 追踪拦截原因。
-- 规范 Codex EC 审批命令与委派校验，拒绝无法规范化的命令、复合命令和空字节输入；允许触发器正文安全使用受管临时目录标记。
-
-### AUN 消息与授权
-
-- 贯通 AUN 消息路由、会话上下文和授权审计关联信息，补齐请求、工具调用和结果之间的 correlation ID。
-- 统一结构化日志字段，改进异常、策略拦截和拒绝结果的可追踪性。
-
-## 0.0.13 (2026-08-20)
-
-### AUN 消息与文件
-
-- 显式区分 AUN 私聊与群聊投递路由，强化入站去重、顺序处理、消息队列持久化和失败恢复。
-- 统一 AUN RPC 与存储客户端，扩展群文件写入与下载能力，收敛文件操作和载荷处理边界。
-- 增加群文件下载票据校验和内容哈希验证，补齐短连接 RPC、存储上传及启动期角色配置迁移能力。
-
-### 权限与关系
-
-- 收敛角色迁移、权限作用域和最小能力模式，强化 Owner、关系范围与工具执行审计边界。
-- 贯通会话投递元数据和跨会话授权校验，避免托管操作越过当前 Agent、会话或关系范围。
-- 强化受管 `$TMPDIR`、群规则读取和群文件上传的路径隔离，拒绝符号链接、越界目录及不符合权限/所有者要求的路径。
-- 完善菜单授权审计的请求与会话关联信息，扩展只读 Shell 查询、配置批量读取和委派有效期校验。
-
-### 会话与运行时
-
-- 完善消息撤回隔离、错误回传、菜单交互、重启命令和 Trigger 反馈的上下文校验。
-- 简化 Agent 运行器与启动流程，修正系统重启路径并清理托管会话凭据。
-- 为 Codex app-server 请求增加 request ID 与载荷指纹重放防护，使重复请求复用结果、冲突请求拒绝；会话重试按至多执行一次处理。
-- 统一 EC Web 守护进程的发现、接管、健康检查和退出清理，修正 Linux 进程启动时间计算，并改进 Codex 初始化/升级探测与 Web 消息路由展示。
-
-## 0.0.12 (2026-08-19)
-
-### AUN 通信
-
-- 规范结构化提及在消息收发、队列和响应链路中的传递，完善 @all、目标校验和非法载荷处理。
-- 增强入站去重、断线重投和错误回传，避免消息重复处理与错误循环。
-
-### 会话与 Agent
-
-- 串行化 Codex 会话的继续、压缩、分叉和回滚操作，完善 app-server 进程管理和安全清理。
-- 优化 proactive 会话、Handoff 和 Bootstrap 的生命周期处理，隔离并发会话上下文。
-
-### 权限与菜单
-
-- 收敛菜单执行上下文和托管命令授权，强化 EC shell 与 Codex 命令解析边界。
-- 完善菜单批量查询、关系上下文、联系人状态和工具拦截审计。
-
-### 运行兼容性
-
-- 统一跨平台子进程启动和 Windows 窗口处理，改进升级监控与内置 AUN SDK 管理。
-- 统一 Claude、Codex 的技能发现和运行时上下文注入。
-
-## 0.0.11 (2026-08-11)
-
-### Agent 初始化与引导
-
-- `ec init` 支持在任意交互步骤连续按两次 Esc 或使用 Ctrl+C 安全退出，并完善二维码超时后的重新生成、手动绑定与取消清理流程。
-- 重新设计 Agent bootstrap 引导消息，在 Agent 完成初始化后可靠投递，并通过持久化和去重避免断线重试造成消息丢失或重复。
-
-### 权限与消息可靠性
-
-- 扩展安全只读 Shell 查询和环境变量解析能力，统一工具授权、危险命令识别与审批边界。
-- 完善 AUN 关键消息的持久化、去重和日志落盘，提升断线恢复与异常重试时的一致性。
-
-### 请求身份与模型目录
-
-- 模型请求统一携带 EvolCore 版本、Agent AID 和 BaseAgent 类型，便于网关进行来源识别、审计和问题定位。
-- Claude 元数据请求复用 Agent 自定义请求头，同时隔离公共模型目录请求中的 API Key、租户头和 Agent 身份信息。
-
-### 热重载
-
-- 同一 Agent 的重载操作改为串行执行；任务繁忙时默认拒绝重载，也可通过 `--force` 清理队列并等待运行中任务中断。
-- 为 runner 与渠道重载建立明确的提交边界和失败回滚，完善 resync 下线清理，避免重载失败后残留旧实例或半更新状态。
-
-## 0.0.10 (2026-08-06)
-
-### 数据迁移
-
-- 修复联系人审计在多 Agent 场景下重复迁移的问题，审计记录改为写入各 Agent 自身数据目录。
-- 迁移支持增量合并并复用已完成的迁移证明，同时校验来源内容变化，避免内容已改动时被错误跳过。
-
-## 0.0.9 (2026-08-06)
-
-### 安装与自启
-
-- 支持在安装或初始化时配置登录自启，Windows 与 macOS 开机登录后自动拉起 EvolCore。
-- 已完成初始化的安装可单独开关登录自启，无需重跑初始化流程。
-
-### AUN 通信
-
-- 出站消息默认加密，可通过配置调整；观察者转发与回执一并遵循该设置。
-- 未连接时的图片与消息发送进入待发队列，连接恢复后按序重投，不再直接丢弃。
-- 完善图片上传的类型识别与结构化内容处理。
-
-### BaseAgent 配置
-
-- 支持为 BaseAgent 自定义请求头和查询参数，便于对接需要额外标识的网关。
-- 统一各 BaseAgent 的推理强度配置项，旧字段仍可识别。
-
-### 运行可靠性
-
-- 修复 Agent 在启动阶段被中断时的状态残留。
-- EC Web 版本过低时拒绝启动并提示升级命令，避免新旧组件搭配下的异常行为。
-- 完善菜单协议的权限校验，并修正系统信息查询。
-
-## 0.0.8 (2026-08-04)
-
-### AID 与域名管理
-
-- 支持通过配置控制 AID 所属域名，并可在变更后自动迁移已有身份记录。
-
-### 运行稳定性
-
-- 完善数据迁移的归档与收尾清理逻辑，降低目录结构演进带来的遗留数据风险。
-- 增强 daemon 启停流程与运行状态诊断，异常时定位信息更准确。
-- 完善 Agent 运行时在失败场景下的状态标记与回退行为。
-- 修复 Windows 下 Codex CLI 的命令解析与进程启动兼容问题。
-
-### 交互体验
-
-- AUN 交互卡片有效期延长至 24 小时，与实际使用节奏匹配。
-- 修复 Web 控制台触发器视图中 daemon 控制触发器无处归属的问题，升级检查触发器包名一并修正。
-- 优化 EC Web 网关状态展示。
-
-## 0.0.7 (2026-08-03)
-
-### 运行可靠性
-
-- 修复 restart-monitor 直接重启 daemon 时未同步拉起 ECWeb 的问题，避免依赖反向隧道的服务在自愈重启后失联。
-
-## 0.0.6 (2026-08-03)
-
-### 跨渠道消息与会话迁移
-
-- 扩展消息历史查询支持所有渠道（AUN、飞书、微信、钉钉、QQ 频道、企业微信），统一历史查询接口。
-- 增强数据迁移机制应对会话目录结构演进，支持实例隔离与显式迁移。
-- 压平 Agent 会话目录为 channelSessionKey，统一会话扫描与 AUN 消息查看路径。
-- 完善 channelSessionKey 的跨平台编码和边界校验，排除旧布局父目录被误识别为会话。
-- 完善 Trigger 会话历史回溯能力，迁移 Trigger 持久化数据至 Agent 目录并收紧访问边界。
-
-### 任务调度与模型降级
-
-- 统一任务级重试调度策略，完善模型不可用时的受控降级与恢复探测。
-- 支持备用模型采用自身默认推理强度，限制备用模型链仅在全局默认配置中定义。
-- 修正静默成功的协议提交判定，使 API 退避等待可被会话中断立即取消。
-
-### 上下文与可靠性
-
-- 修正上下文窗口与压缩阈值，支持上下文超限连续恢复。
-- 保留触发任务失败审计信息，优化模型调用上下文统计。
-- 完善上游异常重试提示。
-
-### 操作卡片与热重载
-
-- 完善操作卡片自由输入校验、审计与客户端兼容。
-- 为无副作用的零工作协议失败增加安全重放，避免误判已计费空响应。
-- 允许管理员通过控制通道热重载当前 Agent。
-
-### 管理界面
-
-- 修复 ECWeb 对新会话目录的扫描与消息读取。
-- 确保会话迁移来源选择确定并兼容非规范目录。
-
-### 基座 Agent 扩展
-
-- 内嵌 ecagent 运行时，作为第四个可选基座 Agent（claude / codex / gemini / ecagent），npm 主包直接提供源码与编译产物，无需单独安装。
-
-### 运行与安全
-
-- 完善用户数据迁移的启停校验，阻止源码旧编译产物启动服务。
-- 完善 Codex 命令授权兼容性，清理过期静态资源。
-- 合并远程角色菜单协议更新。
-
-## 0.0.5 (2026-07-31)
-
-### 消息准入
-
-- 群聊准入统一为开放、联系人、Owner 三种行为，移除额外的渠道白名单配置。
-- 访问策略的修改权限收归 Agent Owner。
-- 完善联系人准入、拉黑与 Owner 权限边界的判定。
-- Connect 群组入口展示实时群组数量。
-
-### 运行可靠性
-
-- 修复旧版本遗留的 AUN 会话目录身份恢复：可唯一判定身份时安全迁移，无法判定时保持原样并告警。
-- 修正 Linux 容器内进程启动时间与运行时长的计算偏差。
-
-### 初始化体验
-
-- 优化初始化向导的目录输入，支持家目录简写、错误重试与显式跳过。
-- 未完成初始化时自动运行向导，完成后继续启动服务。
-- 未配置 self-agent 时按实际可用入口给出创建提示。
-
-## 0.0.4 (2026-07-30)
-
-### 联系人身份与消息准入
-
-- 联系人身份绑定统一扩展到飞书、微信、钉钉、QQ 和企业微信渠道，收敛为显式 `/bind` 命令。
-- 支持通过 AUN 私聊自助申请绑定码，并可在保留机器人配置时单独重绑渠道联系人。
-- 新增私聊入站消息准入链路，覆盖联系人申请、审批、拦截与过期处理。
-- 新增联系人请求服务，申请与状态流转改为原子操作，避免并发请求产生不一致。
-- 限制单实例和进程级待绑定请求数量，并限制无效绑定码的连续尝试次数。
-- 拒绝对不存在的联系人执行身份绑定和状态变更。
-- 群聊准入按 `access.policyMode` 分级：`open` 对所有已配置渠道开放，`contacts` 将 Agent 已加入并接收到的
-  群聊视为授权，`owners` 仅 Owner 消息开放。
-
-### 菜单与授权
-
-- 新增群组菜单协议，支持群列表查询、群级 @ 提及和群规则加载策略的查询与更新。
-- 群操作纳入权限目录、角色能力判定和审计约束，菜单与斜杠命令的可见性统一走运行时授权检查。
-- 群级策略通过版本比对和原子写入避免并发覆盖。
-- AUN 菜单增加 Evol 最低版本门禁和加密访问令牌校验。
-- 菜单令牌改为持久化哈希存储并按空闲时间失效，且不再进入追踪日志和观察转发。
-- Connect 菜单准入策略的校验与写入收敛为原子操作，补齐策略域、操作目录和内置角色的授权边界。
-
-### 跨会话协作
-
-- 跨会话消息必须显式声明 `return none` 或 `required`，Trigger 禁止使用 `required` 等待回流。
-- 聚合同一目标会话的待处理请求和同一来源身份的返回结果，避免重复触发模型轮次。
-- `ec handoff list` 输出新增 `RETURN_POLICY` 列。
-- Trigger 创建必须显式指定 `--exec script|trigger-session|target-session`，不再隐式推断。
-- 新增 `--prompt-file <path>` 承载多行或超长 prompt，与 `--prompt`、`--file` 互斥。
-
-### 安全边界
-
-- AUN keystore `encryptionSeed` 收口为内置常量，发现自定义配置立即失败关闭。
-- 为 Codex 受控命令绑定一次性委托票据，任务或会话撤销时同步清理。
-- 收紧 EC 字面量解析，按空命令、控制字符、未转义展开、引号错误和命令组合分类失败关闭。
-- Agent 角色目录从不可读 H 类调整为只读 L 类，RoleService 为唯一修改入口。
-- L-class 扩展对 `grep`、`rg`、`find`、`sed` 的安全只读支持。
-
-### 运行可靠性
-
-- 守护进程退出时冻结消息队列、关闭任务终态、等待中断屏障并保留可恢复主消息。
-- Trigger 持久化执行检查点与会话绑定，支持重启续跑、期限继承及启动并发去重。
-- 微信渠道区分连接、断开和重新认证状态，令牌刷新后重试待发送消息。
-- API 重试增加单次无事件超时，中断卡住的 runner 后继续退避重试。
-- Session Renew 判定模型改由响应模式桶的 `auxiliaryModel`/`auxiliaryEffort` 决定。
-- 直连推理凭据改为整对解析，`apiKey` 与 `baseUrl` 必须来自同一来源。
-- 入队前写入最终会话 ID 与已解析身份，执行阶段不再重新计算角色。
-- Claude Agent SDK 固定到 `0.3.220`，Codex 自动压缩阈值调整为 185000 token。
-
-### 管理界面
-
-- 会话列表新增类型徽标与筛选，消息视图展示 Agent 显示名。
-- 用量视图的模型与粒度筛选改为变更即查询，模型访问明细默认停留在“全部”。
-- 补全联系人及 AUN 群名、渠道色彩、Runner 子任务展示和 Trigger 模型归属提示。
-
-### 修复
-
-- 规范 Group Menu 非法请求的协议错误码映射。
-- 保留私聊和群聊 menu 请求的加密状态、话题信息与传输回复上下文。
-- 关联文件统一发送为标准 file 载荷，先返回 `menu.response` 再执行文件发送。
-- 统一 `agent.md` 展示名称解析与缓存，`identity` fragment 仅在名称存在时渲染 `selfName`。
-- 飞书私聊出站补齐 `replyContext.peerId` 与 `routeId` 关联。
-
-## 0.0.3 (2026-07-25)
-
-### 多渠道交互
-
-- 钉钉新增可靠消息路由、媒体收发、处理状态表情、交互卡片回调及联系人身份绑定。
-- 企业微信新增连接状态管理、消息去重、引用与媒体处理、流式回复、交互卡片及身份绑定。
-- 飞书统一文本、文件和图片发送回执，完善处理中、成功和失败状态表情的生命周期。
-- 统一渠道发送回执、交互失效和任务中断终态，避免重复输出及遗留处理中状态。
-
-### 联系人与授权
-
-- 新增 `/connect` 菜单协议，统一管理联系人、群组、角色分配、管理员授权及拉黑状态。
-- 收敛联系人身份与角色授权边界，补充跨会话权限校验和授权审计。
-- 交互问题支持多选，并校验交互发起人身份。
-
-### 运行与迁移
-
-- 增强会话目录迁移、渠道初始化和安装版/源码版运行模式切换。
-- Trigger 命令兼容 `set` 创建别名，完善无人值守任务的交互降级处理。
-- Claude 权限拒绝事件按调用 ID 去重，并在原始工具结果缺失时保留终态兜底。
-- Codex app-server 在工具完成通知缺失时补齐失败终态，避免遗留悬空工具调用。
-- 收紧 npm 发布白名单，排除不参与运行的品牌设计资产。
-
-## 0.0.2 (2026-07-23)
-
-EvolCore 首个正式代码版本。
-
-### 主要变更
-
-- 产品、npm 包、源码标识和运行时文案由 EvolClaw 全面更名为 EvolCore。
-- 主 npm 包更名为 `evolcore`，版本线从 `0.0.2` 重新开始。
-- Web 控制台包更名为 `ec-web`，当前兼容版本为 `0.0.3`。
-- CLI 统一为 `ec`，废弃 `evolclaw` 命令入口。
-- 主配置文件由 `evolclaw.json` 更名为与产品名无关的 `daemon.json`。
-- 默认用户数据目录切换为 `~/.evolcore`，源码开发运行根切换为 EvolCore 仓库目录。
-- 阿里云代码仓库切换为 `evolcore.git`；不发布 GitHub 仓库。
-
-### 开发模式
-
-- 新增隐藏的 `ec mode` 开发命令，用于查看和切换源码构建版与 npm 安装版。
-- 支持 `ec mode dev [源码路径]` 和 `ec mode pkg [版本]`。
-- npm 安装包不包含 `mode.js`；安装版执行 `ec mode` 时按无效指令退出。
-
-### 迁移
-
-- 新增 `scripts/migrate-evolclaw-to-evolcore.sh`，默认仅预检，传入 `--apply` 后执行迁移。
-- 迁移 AID、agent、CA、daemon 配置、设备标识、种子和环境配置，并更新 agent 默认项目路径。
-- 保留旧目录且不覆盖新目录已有文件，不迁移 PID、socket、旧日志等实例状态。
-- 支持 Linux、Git Bash、MSYS2 和 Cygwin，并兼容 Windows 盘符路径。
-
-### 兼容性说明
-
-- EvolClaw `3.x` 与 EvolCore `0.0.x` 是两条独立版本线，版本号不连续。
-- 已存在的历史会话会保留创建时的 `projectPath`；新建会话采用迁移后的 agent 默认项目路径。
-- `aliyun_db` 等既有内部标识保持不变。
-
-## 0.0.1 (2026-07-23)
-
-- npm 包名占位版本，不对应 EvolCore 的正式代码基线。
+# Changelog
+
+本文件记录 EvolCore 的重要变更。EvolClaw 版本线的历史记录已归档至
+[`docs/_archive/CHANGELOG-evolclaw.md`](docs/_archive/CHANGELOG-evolclaw.md)。
+
+## 0.0.25 (2026-09-15)
+
+### Agent 资料与头像
+
+- 新增 `ec aid avatar` 和菜单头像上传入口，支持本地图片与 HTTPS 图片地址，校验图片格式、大小、尺寸和宽高比，并广播头像更新事件。
+- 新增 `ec agent persona` 读写命令，支持在初始化过程中由 owner 确认可选人格设置。
+- 自动加载 `personal.md` 个人资料，并为 owner 会话配置各运行器的文件访问权限。
+- Agent 创建支持传入 tags，统一校验标签内容、数量并去重。
+
+### 权限、配置与运行时
+
+- 规范 owner 列表的校验与替换语义，保护最后一个 owner，避免清空管理权限。
+- 允许管理角色查询其他 Agent 的非敏感配置，并开放合法 AID 的公开查询与名片读取。
+- 恢复已认证远程 EC Web 请求的基础设置读写能力，敏感信息继续按需读取。
+- 加强 Windows 临时路径校验，限制临时写入在当前会话的托管目录内。
+- 升级 `@agentunion/fastaun` 至 `0.5.14`。
+
+## 0.0.24 (2026-09-14)
+
+### Windows 与 Codex 运行时
+
+- 启动、重启前统一检查 Codex managed hook；
+  缺失时自动安装并验证，异常时保持失败关闭。
+- managed hook 按 thread 凭据分流；
+  非托管 Codex 不再受机器级策略误伤。
+- 凭据可跨 daemon 重启恢复；
+  失效或伪造凭据继续保持失败关闭。
+- 修复 Windows ACL、npm 子进程和安全输出解析；
+  兼容 cmd.exe 包装与跨平台可执行文件查找。
+- 修复 Windows Codex 沙箱配置；
+  提升自启动任务的运行权限。
+- 将 Windows Hook 启动探针并入 `ec diagnose --codex-hook`；
+  不再增加 Hook 热路径入口。
+- 恢复 Codex 会话共享策略并保留 Agent 描述；
+  修复单 runner 与直接 backend key 的解析。
+- Codex 首轮会话在 rollout 可恢复后绑定；
+  审批请求、响应和终态统一记录生命周期审计。
+
+### Agent、AID 与生命周期
+
+- 新增受权限约束的 AID 查询、展示和管理能力。
+- 新增 Agent 创建、委托创建和创建进度管理；
+  统一创建参数与 Base Agent 探测。
+- 完善 Agent 生命周期、Bootstrap、Owner Welcome；
+  收敛会话交接与主会话切换行为。
+- Claude 会话恢复增加 transcript 就绪校验；
+  失效话题提供 `/renew` 恢复提示。
+- 统一 Agent outbox 的 canonical 路径；
+  旧布局首次读写时执行去重导入。
+- 推理心跳与空闲通知状态隔离；
+  修复话题会话命令的回复路由。
+- `ec stats` 支持托管任务和关系角色范围；
+  `ec msg history` 支持管理角色跨对端查询。
+- 自动安装插件，并修复 Evol App 的 Menu 兼容访问。
+
+### AUN、权限与模型
+
+- 增强 AUN 消息可靠投递、去重恢复和群消息处理。
+- 统一远程配对、token 鉴权和 Menu 命令权限边界。
+- 主机支持查询 Base Agent 模型列表；
+  统一模型目录与推理强度回退。
+- 合并模型价格与能力参数表；
+  统一维护价格、上下文窗口和模型能力。
+- `max_tokens` 改用模型真实 `context_window`；
+  未知模型继续使用兼容性默认值。
+- 重启与升级流程改为事务化；
+  编译失败时回滚并保持服务运行。
+## 0.0.23 (2026-09-08)
+
+### 会话、Trigger 与 Codex 运行时
+
+- 完善 Codex 子代理的上下文继承、权限传递和任务生命周期收敛，并贯通工具调用标识与授权审计。
+- 为受信任的 root Fullaccess Claude 会话显式设置沙箱标记，并限制复杂 PowerShell carrier 的摘要解包范围。
+- 确保 daemon Trigger 在错误已经渲染后仍发送明确终态，并传播中断生命周期元数据、统一中断结果分类。
+- 完善话题续接、会话后端身份校验和跨客户端线程释放，降低重启、续接与并发操作造成的旧任务串入风险。
+
+### Windows、AUN 与配置安全
+
+- 统一 Windows IPC 端点路径规范和跨进程命名管道连接，修复实例 socket 路径在不同运行入口间不一致的问题。
+- 修复 Windows 配置与联系人数据的锁竞争，支持安全识别并回收损坏或遗留锁文件。
+- 强化 Windows Shell 签名信任校验，在允许受信任命令执行的同时收紧受管命令边界。
+- 增加受保护的 AUN Menu 客户端和 daemon 诊断入口，补充 E2EE 请求校验、EC Web token 授权与日志查询边界。
+- 校验并恢复 WeChat 增量同步游标，遇到无效游标时隔离本地状态并自动重试。
+- 升级 `@agentunion/fastaun` 至 `0.5.13`；`ec group invite` 改用定向邀请生命周期，并新增邀请类型与接受/拒绝/撤回命令。
+
+### EC Web 与监控
+
+- 完善 EC Web 认证恢复、Trigger 管理和操作授权审计上下文。
+- EC Web Monitor 按客户端订阅生命周期启停进程树采样，避免无订阅时持续采集。
+
+## 0.0.22 (2026-09-04)
+
+### 话题续接与触发任务
+
+- 完善话题 `/renew` 的并发屏障、后端身份校验和辅助模型配置迁移，避免续接期间旧任务或旧后端结果串入新话题。
+- 完善 Fullaccess Trigger 的持久授权、批准状态、CLI 参数和调度运行时，统一 daemon-owner 身份与审计关联。
+
+### Bootstrap、会话与消息队列
+
+- 增强 Agent 创建规划、Bootstrap 完成鉴权和欢迎消息投递，补齐生命周期门禁、事件记录与失败恢复。
+- 完善消息队列、会话恢复、跨会话 Handoff 和响应引擎的状态收敛，降低重启、续接与并发操作造成的消息丢失或重复处理。
+
+### 服务配置与消息管理
+
+- 统一本机服务和 AUN Service Proxy 的配置读取、schema 与旧版迁移，并贯通 Agent 启动和 IPC 管理链路。
+- 完善 `ec msg history` 按渠道实例和原生对端 ID 查询历史的参数传递、权限校验与结果处理。
+
+### AUN 投递、联系人与观察者
+
+- 完善 Outbox 投递状态、消息回执、永久失败诊断和路由变更保护，避免迟到结果误删已调整路由的待发消息。
+- 强化联系人申请、Owner 审核以及托管私聊入站/出站准入，补齐拒绝原因与审计信息。
+- 修复 Observer 消息转发的异步时序，并按群成员关系过滤重复通知。
+
+### Codex 权限与跨平台安全
+
+- 强化 Codex Shell 命令解析、委派校验、工具摘要和受保护路径策略，明确受管运行身份与权限决策证据。
+- 修复 Windows Codex managed hook 的动态 IPC 校验与安装配置，统一 proactive hook 可用性检查并保持 H-class/L-class 保护边界。
+- 修正 Codex Windows 文件系统 glob 规则，改善受管临时目录和锁目录的跨平台匹配。
+- 统一 BaseAgent 请求地址和身份请求头传递，完善 Codex 会话启动、重连与错误诊断。
+
+## 0.0.21 (2026-09-03)
+
+### 话题与权限控制
+
+- 新增话题 `/renew`，支持在空闲状态下安全续接话题后端会话，并强化并发操作与异常恢复处理。
+- 新增 `/fa`、`/fullaccess` 和持久 Fullaccess Trigger，统一 daemon-owner 授权、可信运行身份与审计记录。
+
+### 服务与消息管理
+
+- 统一本机服务和 AUN Service Proxy 的配置与旧版迁移，支持按实例配置本机服务及代理。
+- `ec msg history` 支持按完整渠道实例和原生对端 ID 查询已落盘的非 AUN 私聊历史。
+
+### AUN 投递与联系人
+
+- 完善 AUN Outbox 投递与回执处理，覆盖排队、重试、过期和永久失败等状态。
+- 新增联系人申请与 Owner 审核流程，并将联系人策略应用到托管私聊的入站和出站准入。
+
+### 安全与运行兼容
+
+- 加固 Codex Shell 载体解析、受管权限校验和受保护路径沙箱边界，并将受保护路径策略归入权限模块。
+- 统一 BaseAgent 请求地址和身份请求头处理，升级 AUN SDK 至 0.5.10，并兼容 Node.js 22.16.0。
+
+## 0.0.20 (2026-08-28)
+
+### AUN 网关与投递可靠性
+
+- 接入 SDK 网关发现结果，校验消息 ID、投递状态和显式路由，区分永久失败与可重试失败。
+- Outbox 保留永久失败诊断，并以路由条件更新避免并发投递覆盖修正后的目标。
+
+### Bootstrap 与配置生命周期
+
+- 收紧 Bootstrap 消息路由和 Agent 生命周期门禁，补充配置兼容校验及 `ec init` 的 ecagent 配置交互。
+- 增加 Agent、Daemon 和默认配置 schema 版本，权限审计记录命中的策略路径。
+
+### 观察者模式
+
+- 观察者模式默认开启，显式设置 `false` 才关闭并持久化覆盖。
+
+### 跨平台运行与安装
+
+- 统一运行时根目录解析，延长 Windows Daemon IPC 优雅关闭等待，并完善 Codex 受管目录安装准备。
+
+## 0.0.19 (2026-08-27)
+
+### PowerShell EC 命令安全
+
+- 支持 PowerShell `pwsh`/`powershell` 受管命令载体解析，拒绝拼接、展开和重定向。
+- 统一 Codex EC 命令委派与预检解析，补充 PowerShell 引号、展开和错误指引。
+
+### Bootstrap 与运行时控制
+
+- Bootstrap 阶段保留 Menu 与斜杠协议处理，普通模型任务继续按生命周期门禁。
+- 命令意外泄漏至响应引擎时统一丢弃并记录失败审计，避免进入 Agent 执行。
+
+### 跨平台安装与诊断
+
+- Windows 数据迁移固定调用系统 `bsdtar`，避免 Git Bash GNU tar 误解析 Windows 绝对路径。
+- Linux 公开安装器与 npm 全局安装/升级均幂等创建真实 `/etc/codex` 目录；root 历史实例可在启动任务时自愈缺失目录，同名文件和符号链接仍被拒绝。
+- 统一数据根解析，仅使用 `EVOLCORE_HOME` 或 `~/.evolcore`，避免因启动目录不同误用数据目录。
+- `ec start` 已运行提示新增 Daemon 持续运行时长，并支持 IPC uptime 回退探测。
+
+## 0.0.18 (2026-08-27)
+
+### DaemonOwner 与受管 Agent 操作
+
+- 新增 `daemon-owner` 进程角色，仅由 `daemon.json.owners` 的控制 AID 解析。
+- 进程操作、跨 Agent Trigger 与内部 Trigger 目录统一要求 DaemonOwner。
+- Agent channel 保持仅能操作自身；拒绝结果附带原因码与下一步指引。
+- 受管任务通过委派 IPC 执行授权的 `ec agent` 查询、非交互创建和生命周期操作。
+
+### 任务暂停与 Bootstrap 门禁
+
+- 新增 `/pause`、`/resume`，在下一次工具调用前暂停或恢复当前任务。
+- Codex、Claude 与 ecagent 的工具边界均接入暂停门禁；任务结束自动解除。
+- Agent 仅在 `active`、`bootstrapping` 生命周期运行，不再回退默认 Runner。
+- Bootstrap 隔离普通任务与上下文，仅允许受限的 `agent.md` 确认、发布和 ready。
+- 首次欢迎消息按实际私聊或群聊路由持久化投递。
+
+### AUN 投递与连接可靠性
+
+- 群消息恢复支持有界多页补拉，避免尾部同步后遗留大积压。
+- 适配新版 AUN 连接状态事件，隔离旧客户端事件并记录传输/入站时间。
+- 受管沙箱发送 AUN 消息改经配置存储读取超时和默认加密设置。
+
+### 审计、安全与跨平台运行
+
+- 菜单响应新增 `processing_ms` 与独立的协议业务流日志。
+- 工具与授权审计新增生命周期键、执行状态和敏感参数脱敏。
+- 统一 Codex 受管 `PreToolUse` Hook，强化 Bubblewrap 挂载与失败熔断诊断。
+- 原子写入保留正式文件并刷新热备，避免受保护状态挂载竞态。
+- `ec stop`、`ec restart` 优先经 IPC 请求守护进程优雅退出并校验 PID。
+- Windows 自启增加计划任务校验、用户级 Run 回退和非 EvolCore 配置保护。
+
+## 0.0.17 (2026-08-25)
+
+### Claude 与任务边界
+
+- 统一识别 Claude 启动参数过长错误，记录结构化能力不可用审计并以明确终态结束任务，避免无效重试和敏感启动参数泄露。
+
+### Codex 与 AUN 消息兼容
+
+- 将运行时 BaseAgent 信息传入任务上下文，仅对 Codex AUN 私聊/群聊文本载荷解码一层 `\\n`/`\\r`/`\\t` 转义，保持其它 Runner 和原始换行不变。
+
+### 临时目录与跨平台稳定性
+
+- 改进受管临时目录创建根路径解析，在拒绝不可信 TMPDIR 时使用固定系统回退并兼容 macOS `/var` 实路径，强化跨平台私有目录校验。
+
+## 0.0.16 (2026-08-25)
+
+### 任务与消息可靠性
+
+- 统一任务总执行时限与 AUN 附件投递重试边界，补充可恢复失败的退避与错误上下文，避免无配置时误设总超时。
+- 优化会话响应、事件总线和守护进程生命周期，完善任务结束、重试和清理时的状态收敛。
+
+### Windows 与运行兼容性
+
+- 强化 Windows 进程识别、登录自启状态探测和命令输出解码，避免误识别其它 Node 服务并改善失败诊断。
+- 修正 Windows Claude 沙箱 settings 的受管临时文件生命周期，收紧运行目录校验，并为过长的 Unix socket 路径提供隔离的短路径回退。
+
+### 审计与权限边界
+
+- 增强结构化日志完整性检查、生命周期关联和重复记录识别，统一工具错误分类与审计上下文。
+- 收紧只读诊断、受保护路径和运行时锁访问策略，仅允许显式授权的有界源码诊断。
+
+## 0.0.15 (2026-08-25)
+
+### Codex 文件授权
+
+- 文件变更的临时授权按 canonical 化后的完整目标文件集合匹配，变更内容或顺序调整不再扩大授权范围。
+- 统一 Codex 文件授权的交互反馈，明确区分同文件临时授权与同操作临时授权，并收紧跨会话授权契约。
+
+### 运行安全与审计
+
+- 为 Claude、Codex 和 ecagent 的工具预检拒绝统一补充结构化授权审计，便于追踪策略、请求和会话上下文。
+- 规范 Codex 审批命令与委派校验，拒绝无法规范化的复合命令和空字节输入，并修正 Windows 受管临时目录的私有性校验。
+
+## 0.0.14 (2026-08-24)
+
+### Codex 受管运行与安全
+
+- 强化 Codex proactive 模式的受管 PreToolUse 校验，Linux 使用隔离运行时，Windows 支持受管 Hook 安装、加载检查和 fail-closed 启动。
+- 隔离会话临时目录并统一运行时锁管理，收紧 Shell、文件访问和受控 EC 命令解析，扩展群文件 ACL 操作及权限校验。
+- 完善工具审批、委派票据和工具结果关联审计，避免未成功发送或未完成授权的操作推进主动模式状态。
+- 为 Claude、Codex、ecagent 的工具预检拒绝补充统一结构化授权审计，记录策略码、请求/任务及会话上下文，便于跨 Runner 追踪拦截原因。
+- 规范 Codex EC 审批命令与委派校验，拒绝无法规范化的命令、复合命令和空字节输入；允许触发器正文安全使用受管临时目录标记。
+
+### AUN 消息与授权
+
+- 贯通 AUN 消息路由、会话上下文和授权审计关联信息，补齐请求、工具调用和结果之间的 correlation ID。
+- 统一结构化日志字段，改进异常、策略拦截和拒绝结果的可追踪性。
+
+## 0.0.13 (2026-08-20)
+
+### AUN 消息与文件
+
+- 显式区分 AUN 私聊与群聊投递路由，强化入站去重、顺序处理、消息队列持久化和失败恢复。
+- 统一 AUN RPC 与存储客户端，扩展群文件写入与下载能力，收敛文件操作和载荷处理边界。
+- 增加群文件下载票据校验和内容哈希验证，补齐短连接 RPC、存储上传及启动期角色配置迁移能力。
+
+### 权限与关系
+
+- 收敛角色迁移、权限作用域和最小能力模式，强化 Owner、关系范围与工具执行审计边界。
+- 贯通会话投递元数据和跨会话授权校验，避免托管操作越过当前 Agent、会话或关系范围。
+- 强化受管 `$TMPDIR`、群规则读取和群文件上传的路径隔离，拒绝符号链接、越界目录及不符合权限/所有者要求的路径。
+- 完善菜单授权审计的请求与会话关联信息，扩展只读 Shell 查询、配置批量读取和委派有效期校验。
+
+### 会话与运行时
+
+- 完善消息撤回隔离、错误回传、菜单交互、重启命令和 Trigger 反馈的上下文校验。
+- 简化 Agent 运行器与启动流程，修正系统重启路径并清理托管会话凭据。
+- 为 Codex app-server 请求增加 request ID 与载荷指纹重放防护，使重复请求复用结果、冲突请求拒绝；会话重试按至多执行一次处理。
+- 统一 EC Web 守护进程的发现、接管、健康检查和退出清理，修正 Linux 进程启动时间计算，并改进 Codex 初始化/升级探测与 Web 消息路由展示。
+
+## 0.0.12 (2026-08-19)
+
+### AUN 通信
+
+- 规范结构化提及在消息收发、队列和响应链路中的传递，完善 @all、目标校验和非法载荷处理。
+- 增强入站去重、断线重投和错误回传，避免消息重复处理与错误循环。
+
+### 会话与 Agent
+
+- 串行化 Codex 会话的继续、压缩、分叉和回滚操作，完善 app-server 进程管理和安全清理。
+- 优化 proactive 会话、Handoff 和 Bootstrap 的生命周期处理，隔离并发会话上下文。
+
+### 权限与菜单
+
+- 收敛菜单执行上下文和托管命令授权，强化 EC shell 与 Codex 命令解析边界。
+- 完善菜单批量查询、关系上下文、联系人状态和工具拦截审计。
+
+### 运行兼容性
+
+- 统一跨平台子进程启动和 Windows 窗口处理，改进升级监控与内置 AUN SDK 管理。
+- 统一 Claude、Codex 的技能发现和运行时上下文注入。
+
+## 0.0.11 (2026-08-11)
+
+### Agent 初始化与引导
+
+- `ec init` 支持在任意交互步骤连续按两次 Esc 或使用 Ctrl+C 安全退出，并完善二维码超时后的重新生成、手动绑定与取消清理流程。
+- 重新设计 Agent bootstrap 引导消息，在 Agent 完成初始化后可靠投递，并通过持久化和去重避免断线重试造成消息丢失或重复。
+
+### 权限与消息可靠性
+
+- 扩展安全只读 Shell 查询和环境变量解析能力，统一工具授权、危险命令识别与审批边界。
+- 完善 AUN 关键消息的持久化、去重和日志落盘，提升断线恢复与异常重试时的一致性。
+
+### 请求身份与模型目录
+
+- 模型请求统一携带 EvolCore 版本、Agent AID 和 BaseAgent 类型，便于网关进行来源识别、审计和问题定位。
+- Claude 元数据请求复用 Agent 自定义请求头，同时隔离公共模型目录请求中的 API Key、租户头和 Agent 身份信息。
+
+### 热重载
+
+- 同一 Agent 的重载操作改为串行执行；任务繁忙时默认拒绝重载，也可通过 `--force` 清理队列并等待运行中任务中断。
+- 为 runner 与渠道重载建立明确的提交边界和失败回滚，完善 resync 下线清理，避免重载失败后残留旧实例或半更新状态。
+
+## 0.0.10 (2026-08-06)
+
+### 数据迁移
+
+- 修复联系人审计在多 Agent 场景下重复迁移的问题，审计记录改为写入各 Agent 自身数据目录。
+- 迁移支持增量合并并复用已完成的迁移证明，同时校验来源内容变化，避免内容已改动时被错误跳过。
+
+## 0.0.9 (2026-08-06)
+
+### 安装与自启
+
+- 支持在安装或初始化时配置登录自启，Windows 与 macOS 开机登录后自动拉起 EvolCore。
+- 已完成初始化的安装可单独开关登录自启，无需重跑初始化流程。
+
+### AUN 通信
+
+- 出站消息默认加密，可通过配置调整；观察者转发与回执一并遵循该设置。
+- 未连接时的图片与消息发送进入待发队列，连接恢复后按序重投，不再直接丢弃。
+- 完善图片上传的类型识别与结构化内容处理。
+
+### BaseAgent 配置
+
+- 支持为 BaseAgent 自定义请求头和查询参数，便于对接需要额外标识的网关。
+- 统一各 BaseAgent 的推理强度配置项，旧字段仍可识别。
+
+### 运行可靠性
+
+- 修复 Agent 在启动阶段被中断时的状态残留。
+- EC Web 版本过低时拒绝启动并提示升级命令，避免新旧组件搭配下的异常行为。
+- 完善菜单协议的权限校验，并修正系统信息查询。
+
+## 0.0.8 (2026-08-04)
+
+### AID 与域名管理
+
+- 支持通过配置控制 AID 所属域名，并可在变更后自动迁移已有身份记录。
+
+### 运行稳定性
+
+- 完善数据迁移的归档与收尾清理逻辑，降低目录结构演进带来的遗留数据风险。
+- 增强 daemon 启停流程与运行状态诊断，异常时定位信息更准确。
+- 完善 Agent 运行时在失败场景下的状态标记与回退行为。
+- 修复 Windows 下 Codex CLI 的命令解析与进程启动兼容问题。
+
+### 交互体验
+
+- AUN 交互卡片有效期延长至 24 小时，与实际使用节奏匹配。
+- 修复 Web 控制台触发器视图中 daemon 控制触发器无处归属的问题，升级检查触发器包名一并修正。
+- 优化 EC Web 网关状态展示。
+
+## 0.0.7 (2026-08-03)
+
+### 运行可靠性
+
+- 修复 restart-monitor 直接重启 daemon 时未同步拉起 ECWeb 的问题，避免依赖反向隧道的服务在自愈重启后失联。
+
+## 0.0.6 (2026-08-03)
+
+### 跨渠道消息与会话迁移
+
+- 扩展消息历史查询支持所有渠道（AUN、飞书、微信、钉钉、QQ 频道、企业微信），统一历史查询接口。
+- 增强数据迁移机制应对会话目录结构演进，支持实例隔离与显式迁移。
+- 压平 Agent 会话目录为 channelSessionKey，统一会话扫描与 AUN 消息查看路径。
+- 完善 channelSessionKey 的跨平台编码和边界校验，排除旧布局父目录被误识别为会话。
+- 完善 Trigger 会话历史回溯能力，迁移 Trigger 持久化数据至 Agent 目录并收紧访问边界。
+
+### 任务调度与模型降级
+
+- 统一任务级重试调度策略，完善模型不可用时的受控降级与恢复探测。
+- 支持备用模型采用自身默认推理强度，限制备用模型链仅在全局默认配置中定义。
+- 修正静默成功的协议提交判定，使 API 退避等待可被会话中断立即取消。
+
+### 上下文与可靠性
+
+- 修正上下文窗口与压缩阈值，支持上下文超限连续恢复。
+- 保留触发任务失败审计信息，优化模型调用上下文统计。
+- 完善上游异常重试提示。
+
+### 操作卡片与热重载
+
+- 完善操作卡片自由输入校验、审计与客户端兼容。
+- 为无副作用的零工作协议失败增加安全重放，避免误判已计费空响应。
+- 允许管理员通过控制通道热重载当前 Agent。
+
+### 管理界面
+
+- 修复 ECWeb 对新会话目录的扫描与消息读取。
+- 确保会话迁移来源选择确定并兼容非规范目录。
+
+### 基座 Agent 扩展
+
+- 内嵌 ecagent 运行时，作为第四个可选基座 Agent（claude / codex / gemini / ecagent），npm 主包直接提供源码与编译产物，无需单独安装。
+
+### 运行与安全
+
+- 完善用户数据迁移的启停校验，阻止源码旧编译产物启动服务。
+- 完善 Codex 命令授权兼容性，清理过期静态资源。
+- 合并远程角色菜单协议更新。
+
+## 0.0.5 (2026-07-31)
+
+### 消息准入
+
+- 群聊准入统一为开放、联系人、Owner 三种行为，移除额外的渠道白名单配置。
+- 访问策略的修改权限收归 Agent Owner。
+- 完善联系人准入、拉黑与 Owner 权限边界的判定。
+- Connect 群组入口展示实时群组数量。
+
+### 运行可靠性
+
+- 修复旧版本遗留的 AUN 会话目录身份恢复：可唯一判定身份时安全迁移，无法判定时保持原样并告警。
+- 修正 Linux 容器内进程启动时间与运行时长的计算偏差。
+
+### 初始化体验
+
+- 优化初始化向导的目录输入，支持家目录简写、错误重试与显式跳过。
+- 未完成初始化时自动运行向导，完成后继续启动服务。
+- 未配置 self-agent 时按实际可用入口给出创建提示。
+
+## 0.0.4 (2026-07-30)
+
+### 联系人身份与消息准入
+
+- 联系人身份绑定统一扩展到飞书、微信、钉钉、QQ 和企业微信渠道，收敛为显式 `/bind` 命令。
+- 支持通过 AUN 私聊自助申请绑定码，并可在保留机器人配置时单独重绑渠道联系人。
+- 新增私聊入站消息准入链路，覆盖联系人申请、审批、拦截与过期处理。
+- 新增联系人请求服务，申请与状态流转改为原子操作，避免并发请求产生不一致。
+- 限制单实例和进程级待绑定请求数量，并限制无效绑定码的连续尝试次数。
+- 拒绝对不存在的联系人执行身份绑定和状态变更。
+- 群聊准入按 `access.policyMode` 分级：`open` 对所有已配置渠道开放，`contacts` 将 Agent 已加入并接收到的
+  群聊视为授权，`owners` 仅 Owner 消息开放。
+
+### 菜单与授权
+
+- 新增群组菜单协议，支持群列表查询、群级 @ 提及和群规则加载策略的查询与更新。
+- 群操作纳入权限目录、角色能力判定和审计约束，菜单与斜杠命令的可见性统一走运行时授权检查。
+- 群级策略通过版本比对和原子写入避免并发覆盖。
+- AUN 菜单增加 Evol 最低版本门禁和加密访问令牌校验。
+- 菜单令牌改为持久化哈希存储并按空闲时间失效，且不再进入追踪日志和观察转发。
+- Connect 菜单准入策略的校验与写入收敛为原子操作，补齐策略域、操作目录和内置角色的授权边界。
+
+### 跨会话协作
+
+- 跨会话消息必须显式声明 `return none` 或 `required`，Trigger 禁止使用 `required` 等待回流。
+- 聚合同一目标会话的待处理请求和同一来源身份的返回结果，避免重复触发模型轮次。
+- `ec handoff list` 输出新增 `RETURN_POLICY` 列。
+- Trigger 创建必须显式指定 `--exec script|trigger-session|target-session`，不再隐式推断。
+- 新增 `--prompt-file <path>` 承载多行或超长 prompt，与 `--prompt`、`--file` 互斥。
+
+### 安全边界
+
+- AUN keystore `encryptionSeed` 收口为内置常量，发现自定义配置立即失败关闭。
+- 为 Codex 受控命令绑定一次性委托票据，任务或会话撤销时同步清理。
+- 收紧 EC 字面量解析，按空命令、控制字符、未转义展开、引号错误和命令组合分类失败关闭。
+- Agent 角色目录从不可读 H 类调整为只读 L 类，RoleService 为唯一修改入口。
+- L-class 扩展对 `grep`、`rg`、`find`、`sed` 的安全只读支持。
+
+### 运行可靠性
+
+- 守护进程退出时冻结消息队列、关闭任务终态、等待中断屏障并保留可恢复主消息。
+- Trigger 持久化执行检查点与会话绑定，支持重启续跑、期限继承及启动并发去重。
+- 微信渠道区分连接、断开和重新认证状态，令牌刷新后重试待发送消息。
+- API 重试增加单次无事件超时，中断卡住的 runner 后继续退避重试。
+- Session Renew 判定模型改由响应模式桶的 `auxiliaryModel`/`auxiliaryEffort` 决定。
+- 直连推理凭据改为整对解析，`apiKey` 与 `baseUrl` 必须来自同一来源。
+- 入队前写入最终会话 ID 与已解析身份，执行阶段不再重新计算角色。
+- Claude Agent SDK 固定到 `0.3.220`，Codex 自动压缩阈值调整为 185000 token。
+
+### 管理界面
+
+- 会话列表新增类型徽标与筛选，消息视图展示 Agent 显示名。
+- 用量视图的模型与粒度筛选改为变更即查询，模型访问明细默认停留在“全部”。
+- 补全联系人及 AUN 群名、渠道色彩、Runner 子任务展示和 Trigger 模型归属提示。
+
+### 修复
+
+- 规范 Group Menu 非法请求的协议错误码映射。
+- 保留私聊和群聊 menu 请求的加密状态、话题信息与传输回复上下文。
+- 关联文件统一发送为标准 file 载荷，先返回 `menu.response` 再执行文件发送。
+- 统一 `agent.md` 展示名称解析与缓存，`identity` fragment 仅在名称存在时渲染 `selfName`。
+- 飞书私聊出站补齐 `replyContext.peerId` 与 `routeId` 关联。
+
+## 0.0.3 (2026-07-25)
+
+### 多渠道交互
+
+- 钉钉新增可靠消息路由、媒体收发、处理状态表情、交互卡片回调及联系人身份绑定。
+- 企业微信新增连接状态管理、消息去重、引用与媒体处理、流式回复、交互卡片及身份绑定。
+- 飞书统一文本、文件和图片发送回执，完善处理中、成功和失败状态表情的生命周期。
+- 统一渠道发送回执、交互失效和任务中断终态，避免重复输出及遗留处理中状态。
+
+### 联系人与授权
+
+- 新增 `/connect` 菜单协议，统一管理联系人、群组、角色分配、管理员授权及拉黑状态。
+- 收敛联系人身份与角色授权边界，补充跨会话权限校验和授权审计。
+- 交互问题支持多选，并校验交互发起人身份。
+
+### 运行与迁移
+
+- 增强会话目录迁移、渠道初始化和安装版/源码版运行模式切换。
+- Trigger 命令兼容 `set` 创建别名，完善无人值守任务的交互降级处理。
+- Claude 权限拒绝事件按调用 ID 去重，并在原始工具结果缺失时保留终态兜底。
+- Codex app-server 在工具完成通知缺失时补齐失败终态，避免遗留悬空工具调用。
+- 收紧 npm 发布白名单，排除不参与运行的品牌设计资产。
+
+## 0.0.2 (2026-07-23)
+
+EvolCore 首个正式代码版本。
+
+### 主要变更
+
+- 产品、npm 包、源码标识和运行时文案由 EvolClaw 全面更名为 EvolCore。
+- 主 npm 包更名为 `evolcore`，版本线从 `0.0.2` 重新开始。
+- Web 控制台包更名为 `ec-web`，当前兼容版本为 `0.0.3`。
+- CLI 统一为 `ec`，废弃 `evolclaw` 命令入口。
+- 主配置文件由 `evolclaw.json` 更名为与产品名无关的 `daemon.json`。
+- 默认用户数据目录切换为 `~/.evolcore`，源码开发运行根切换为 EvolCore 仓库目录。
+- 阿里云代码仓库切换为 `evolcore.git`；不发布 GitHub 仓库。
+
+### 开发模式
+
+- 新增隐藏的 `ec mode` 开发命令，用于查看和切换源码构建版与 npm 安装版。
+- 支持 `ec mode dev [源码路径]` 和 `ec mode pkg [版本]`。
+- npm 安装包不包含 `mode.js`；安装版执行 `ec mode` 时按无效指令退出。
+
+### 迁移
+
+- 新增 `scripts/migrate-evolclaw-to-evolcore.sh`，默认仅预检，传入 `--apply` 后执行迁移。
+- 迁移 AID、agent、CA、daemon 配置、设备标识、种子和环境配置，并更新 agent 默认项目路径。
+- 保留旧目录且不覆盖新目录已有文件，不迁移 PID、socket、旧日志等实例状态。
+- 支持 Linux、Git Bash、MSYS2 和 Cygwin，并兼容 Windows 盘符路径。
+
+### 兼容性说明
+
+- EvolClaw `3.x` 与 EvolCore `0.0.x` 是两条独立版本线，版本号不连续。
+- 已存在的历史会话会保留创建时的 `projectPath`；新建会话采用迁移后的 agent 默认项目路径。
+- `aliyun_db` 等既有内部标识保持不变。
+
+## 0.0.1 (2026-07-23)
+
+- npm 包名占位版本，不对应 EvolCore 的正式代码基线。