evolcore 0.0.1 → 0.0.2

package/CHANGELOG.md

@@ -0,0 +1,813 @@
+## v3.6.4 (2026-07-13)
+
+### Security Fixes
+
+- **Menu 控制协议关联拒绝** — `menu.*` 在业务 handler 前完成字段校验和全局访问鉴权；拒绝统一返回保留原 `id/name` 的 `menu.response.error`，缺失 ID 静默丢弃，控制请求不再触发 owner 自动绑定或聊天错误。
+- **CLI 执行加固** — Menu CLI 仅执行已识别且获准的命令意图，严格限制 argv，旧 `args.command` 仅作无 shell 的安全兼容；移除完整 argv/stdout/stderr 日志，统一超时和基础设施错误码。
+
+### Improvements
+
+- **控制请求幂等** — 按 transport、scope、sender 和 request ID 提供 30 秒去重窗口；并发重复只执行一次，不同 payload 复用同 ID 返回 `CONFLICT`。
+- **文件关联结果** — file fetch 返回 `{ accepted: true }`，AUN 文件控制结果使用 `result.file`、`correlation_id`、文件名、MIME 和附件元数据，P2P/group 保持原作用域。
+- **协议响应归一化** — 成功与失败响应由统一 helper 构造，稳定映射 `INVALID_ARGUMENT`、`NOT_SUPPORTED`、`EXECUTION_TIMEOUT`、`INTERNAL_ERROR` 等错误码，并在类型层保证 `data/error` 互斥。
+
+### Testing
+
+- 补充全局拒绝零副作用、malformed、未知方法、异常归一化、重复/冲突、group 隔离、CLI allowlist/参数和文件双响应契约测试。
+
+## v3.6.0 (2026-06-26)
+
+### New Features
+
+- **ec fs 统一文件入口** — 新增 `ec fs` 命令，统一个人空间和群空间文件访问入口；对齐 Python aun fs / aun group fs 已实现能力，补齐 mv、mkdir、rm -r、ln、chmod、mount、find 等命令；按 AID 的 agent.md type 自动路由 personal storage 或 group fs，group 缺失能力明确返回 UNSUPPORTED
+- **Trigger V3 Daemon 级升级** — 引入 DaemonChannel 捕获 trigger 执行回复，切换到 V3 execution/feedback schema；将 `__upgrade-check` 创建到 daemon/control AID 下；启动时覆盖 daemon 级系统触发器并删除旧 agent 级系统触发器
+
+### Improvements
+
+- **权限系统重构** — 区分绝对禁止命令（shutdown、mkfs、dd、reboot 等系统级破坏操作）和危险操作（rm -rf、sudo、chmod 777、reg delete 等）；`checkBlacklist` 仅拒绝绝对禁止命令，`checkDangerousCommand` 标记危险操作需用户审批；auto 模式下危险命令自动拒绝
+- **错误处理增强** — 错误字典支持路径自动回退（`src/utils/error-dict.json` → `dist/utils/error-dict.json`），避免构建窗口丢失重试规则；Claude/Codex runner 完善错误处理流程
+- **消息队列状态管理** — 重构队列状态管理，支持多队列并发状态隔离；优化 proactive 模式响应处理
+
+### Code Refactoring
+
+- **目录结构优化** — 移动 `gateway-config-handler.ts` 到 `config/gateway-config.ts`（配置管理不应在 message/ 目录下）；重命名 `bind.ts` 为 `aid-bind.ts`（更清晰地表达 AID 绑定用途）；移动 `model-prices.jsonl` 到 `utils/`（统一工具文件位置）
+- **文档清理** — 删除源码中的 6 个 README.md（不应发布到 npm 包）；移动 `gateway-env-sync-feature.md` 到 `docs/`；更新 package.json files 字段，仅包含 README.md、LICENSE、CHANGELOG.md
+
+### Documentation
+
+- **Baseagent 集成研究** — 新增 OpenCode (Claude Code) 与 Codex 的特性对比、集成方案研究、验证结果文档
+- **Trigger Daemon 迁移** — 记录 Trigger 系统从 agent 级迁移到 daemon 级的完整对话过程
+- **ec fs 实现计划** — 详细设计文档覆盖命令路由、能力对齐、错误处理
+
+### Testing
+
+- **权限测试更新** — 更新 162 个测试文件以反映新的权限系统设计；修复 `auto` 模式下危险命令检查；更新 vitest.config.ts 排除外部项目目录（openclaw/、hermes-agent/）
+
+### Internal
+
+- **npm 包优化** — 文件数 257（从 3.5.9 的 255 增加 2 个），大小 816.5 KB（解压 3.2 MB）；不含 TypeScript 源文件、测试文件、实验性功能
+## v3.5.9 (2026-06-25)
+
+### Security Fixes
+
+- **EVOLCORE_ISSUER 环境变量校验** — `resolveControlIssuer()` 新增严格校验：域名格式正则、禁止 localhost/本地域名（`localhost`/`.localhost`/`127.*`/`0.*`）、长度上限 253，非法值降级回 `agentid.pub`。防止环境变量注入污染控制 AID 的 issuer。
+- **AUN topicName 输入净化** — AUN channel 提取话题名时新增净化处理：去首尾空白、剔除控制字符（`\x00-\x1F\x7F`）、长度上限 200，非法值丢弃。新增 `sanitizeTopicName()` helper 统一 P2P 与群聊两处提取逻辑，防止不可信 payload 经 metadata 透传。
+
+## v3.5.8 (2026-06-25)
+
+### Bug Fixes
+
+- **Thread session 创建时 topicName 提取** — 修复 AUN channel 在首条消息被动创建 thread session 时，未从 `payload.topicName` 提取话题显示名的问题（之前用写死的兜底文案「话题会话」）。现在按协议 v2.4 §6.4/§12.1 正确提取：优先 `payload.topicName`，兼容 `replyContext.title`/`replyContext.metadata.topicName`。影响范围：AUN 群聊和私聊的话题会话创建。
+
+## v3.5.7 (2026-06-24)
+
+### Bug Fixes
+
+- **逻辑队列与贪心合并同步** — 修复响应系统重构引入的消息队列 bug：`reorderPhysical` 提前从逻辑队列 dequeue，但 `dequeueGreedy` 会合并多条消息，导致逻辑队列与物理队列不同步、群聊消息错乱。改为 peek 而非 dequeue，并新增 `removeProcessed` 在合并后批量清理逻辑队列。
+- **`[SEND_FILE:...]` 文件标记处理** — 恢复 `ResponseEngine` 中缺失的 `[SEND_FILE:...]` 标记处理逻辑（重构后只剩 `FILE_MARKER:` 格式）：包含 Windows 盘符白名单校验（`C:`/`D:` 不被误认为 channel）、channelType 映射查找、跨通道路由与权限校验。
+- **Trigger 事件字段补齐** — 修复 `trigger:failed`/`trigger:completed`/`trigger:skipped` 事件缺失 `runId`/`originTriggerId` 必填字段导致的类型错误。
+
+### Improvements
+
+- **`selected model is at capacity` 错误识别** — 错误字典新增该匹配项，命中时提示「当前模型繁忙，请稍后重试」。
+- **命令查询不隐式建会话** — `/perm`、`/ask`、`/resume`、`/setmodel` 等命令改为查询现有会话，不再隐式创建空会话。
+- **AUN payload 清理** — 新增 `stripUndefinedDeep` 递归清理出站 payload 中的 `undefined` 字段，避免序列化问题。
+
+### Misc
+
+- **纳入 ecweb 前端监控服务** — 将 ecweb（evolcore web 管理界面）源码纳入主仓库跟踪。
+
+## v3.5.6 (2026-06-24)
+
+### New Features
+
+- **Agent Bootstrap Service** — 新增 `core/bootstrap-service.ts`，统一 agent 初始化流程：发送欢迎消息、上传 agent.md、发送绑定凭证；支持三态生命周期（created → bootstrapping → active）
+- **Agent 配置 Schema v2** — 新增 `lifecycle` 字段（created/bootstrapping/active），替代旧的 `initialized` 布尔值；支持配置版本迁移与向后兼容
+- **命令处理器分离** — 将命令处理分为 Menu Protocol（`menu-handler.ts`）和 Slash Command（`slash-handler.ts`）双轨：Menu 提供结构化协议（query/update/action），Slash 保留文本命令兼容性
+- **Avatar 上传功能** — 新增 `utils/avatar-upload.ts`，支持通过 AUN storage 上传 agent 头像
+- **控制面双轨鉴权** — 新增 `gateControlScope()` 闸门：进程级操作（/system、/gateway、/config）仅控制 channel 可执行；跨 agent 操作仅控制 channel 可执行
+
+### Improvements
+
+- **Lifecycle Hooks** — 新增 `config/lifecycle.ts`，提供配置生命周期转换函数（`normalizeAgentLifecycle`、`withLifecycleForWrite`），解耦配置迁移逻辑
+- **Menu Protocol 增强** — `execMenuForEcweb()` 和 `execMenuForControl()` 分别处理 ECWeb 和控制 AID 的 menu 请求，支持进程级配置查询和修改
+- **Gateway 配置管理** — 新增 `/gateway` 命令支持网关配置的查询、更新、测试、模型列表、价格设置、环境变量同步
+- **AUN Payload 体积优化** — 优化大型响应的传输策略，避免超过 AUN 协议限制
+
+### Documentation
+
+- **Menu Protocol 开发指南 v2.4** — 完整文档化 Menu Protocol 的设计、实现、测试策略
+- **Agent Bootstrap 生命周期设计** — 详细说明 agent 初始化流程和状态转换
+- **Avatar 上传实现文档** — 记录头像上传的技术实现和集成方式
+- **Baseagent 集成研究** — 探索多 baseagent 集成的架构模式
+
+## v3.5.2 (2026-06-19)
+
+### New Features
+
+- **云部署非交互式 init** — `ec init --non-interactive --owner <aid> --format json`，无 TTY 环境完成容器初始化，输出结构化 JSON + 稳定错误码。
+
+### Bug Fixes
+
+- **/effort 命令模型解析** — 修复多 baseagent 切换时取到错误模型的问题。
+
+### Improvements
+
+- **autoCompact 阈值统一 180000** — 移除 1M 模型 900000 的特别处理。
+
+## v3.5.1 (2026-06-18)
+
+### Bug Fixes
+
+- **模型命令作用域修复** — `/model`、`/effort`、菜单查询/更新统一按当前会话 baseagent 和配置作用域解析，避免 Claude 会话误用 Codex/GPT 模型配置
+- **Claude Read 参数兼容** — 清理 `Read` 工具输入中的空 `pages` 字段，避免非 Claude 模型透传空字符串触发 SDK 校验错误
+
+## v3.5.0 (2026-06-18)
+
+### New Features
+
+- **Evol App 扫码绑定** — 新增 Bind 协议（`utils/bind.ts`）：生成二维码绑定任务，校验 Evol App 扫码 token，支持 `append`/`replace` owner 模式；IPC 新增 `bind.begin`/`bind.status`/`bind.cancel`；owner 配置默认走扫码，手动输入兜底；响应区分 daemon（返回 baseagent 列表）/ agent（返回 agentInfo）两种格式
+- **Trigger 系统重构** — 拆分为 types/state/validation/audit/feedback/script-executor 六模块；scheduler 支持脚本执行、并发策略（drop/queue/cancel-running）、miss 策略（skip/fire-once）；运行统计从审计日志按需汇总（不再存 trigger.json）；`/trigger` CLI 支持 list/show/create/update/enable/disable/cancel/run/template
+- **消息队列持久化 + /queue 命令** — `MessageQueue` 任务变更原子写入 `queue-state.json`，重启后恢复未完成消息；新增 `dequeueGreedy()` 合并连续群聊消息；`/queue` 查看各 agent 队列摘要，`/queue <agent>` 看详情，`/queue clear` 清空
+- **Config 体系 v2** — 新增 `config/` 模块（ConfigManager 单一合并点、深合并、schema 注册表、配置快照、启动日志）；两条独立覆盖链：H 链三级（defaults → agent/config → relation/config）、HA 链含角色层（agent/behavior → role → relation/behavior）；`ec config` 命令（show/validate/diff/reset）；新增 `kits/schemas/` JSON Schema；model/effort/permissionMode 独立解析
+- **AUN Service Proxy** — `aun/service-proxy.ts` 通过控制 AID 将本地服务（如 ECWeb）暴露到 AUN 网络，WebSocket 隧道转发 HTTP；ECWeb 支持 `x-forwarded-prefix` 动态适配路径前缀
+- **Proactive 模式策略强化** — runner 新增首次工具调用拦截：proactive 下首个动作非 `ctl send` 时，将违规错误作为 `tool_result` 注入模型（不泄露系统提示词）；新增 `pre_tool_1stmsgchk` / `tool_use_reminder` 配置开关
+- **欢迎消息模块** — 新增 `utils/welcome.ts`，AUN 连接时主动推送、IM 渠道首次交互时发送，内容来自 ECK `welcome` fragment
+- **File 菜单目录分页** — `menu-handler` 新增 `action=list` 目录浏览，每页 20 项 + `prev`/`next` 翻页，分页状态编码在按钮 value
+- **AUN 加密状态透传** — `InboundMessage.encrypted` 经 `MessageBridge` → `Session.metadata.encrypted` 全链路透传
+
+### Improvements
+
+- **Baseagent 错误处理增强** — runner 不可用时抛明确 `BaseagentRunnerUnavailableError`，不再静默 fallback 到 primary；启动时 `alignSessionBaseagent()` 自动修复 session 绑定的失效 baseagent
+- **Slash 命令容错** — `SlashHandler` 改为懒加载 Agent（`getActiveAgentIfAvailable()` 返回 undefined 而非抛异常），避免 session 错配时卡住 `/baseagent` 等恢复命令
+- **Settings.json 彻底保护** — `writeUserSettings()` 不再落盘；删除 `EVOLCORE_ALLOW_SETTINGS_WRITE` 环境变量与 `baseagent-seed.ts`（不再从 `~/.claude/settings.json` 导入配置）
+- **渠道启动改为后台非阻塞** — `onConnected`/`onFailed` 回调非阻塞调用；AUN gateway 发现交还 SDK，缩短启动耗时
+- **Trigger 权限与可见性** — `/trigger` 按 channel 解析所属 agent 的 scheduler，不再走 primary 兜底；user 只见自己创建的 trigger，admin 可见全部（`--all`）
+- **Permission 增强** — thread `permissionMode` 改为 per-call 参数实时解析；readonly check 日志增强（记录 channel/session/peer 上下文）
+- **`ec agent list` 新增 Personal 列** — 显示 agent 的 personal name（取自 `channels.aun.name`）
+- **模块路径重构** — `core/stats/*` → `stats/*`、`core/trigger/*` → `trigger/*`、`model-scope.ts` → `config-scope.ts`、`error-dict.json` → `utils/`、`command-handler-gateway-control.ts` → `gateway-config-handler.ts`、`core/bind.ts` → `utils/bind.ts`
+- **showActivities 简化** — 移除 `dm-only`/`owner-dm-only`，简化为 `all`/`none`（旧值自动迁移）
+
+### Bug Fixes
+
+- **启动期凭证硬校验移除** — `resolveAnthropicConfig()` 不再在缺 apiKey 时抛异常，改为运行时（首次 API 调用）检测，防止缺 key 时启动崩溃
+- **Trigger 失败通知去重** — 同一 trigger 连续失败只通知一次（`lastNotifyHash`），避免重复 Feishu 告警
+- **Trigger schedulerAid 补全** — `Trigger` 新增 `schedulerAid` 字段，各管理路径入口校验存在性；移除 primary fallback，通过 `targetChannel` 解析所属 agent 的 scheduler
+- **Agent 自重启修复** — `sessionMode` 硬编码规则修复；agent 重启自己时不再误报 "agent busy"，并精确报告哪个 session 在处理哪条消息
+- **AUN 群聊 sender_aid fallback** — 按 `from_aid` → `from` → `peerId` 三级 fallback，修复部分群消息发送方解析为空
+- **统计 System 列** — `ec stats` 新增 System 列，单独统计 trigger/config/stats 类系统调用消耗
+- **Type 错误修复** — `writeUserSettings` 返回类型统一为 `{ success: boolean; error?: string }`（移除 `skipped` 字段）
+
+### Security
+
+- **文件权限加固** — `gateway-config-handler` 写入价格文件时显式用 `0o600`（owner-only），避免受进程 umask 影响对其他用户可读
+- **绑定 Token 强度提升** — `generatePublicToken()` 从 12 字节增加到 16 字节（96 → 128 bits）
+
+### Breaking Changes
+
+- **删除 baseagent-seed.ts** — 不再从 `~/.claude/settings.json` 导入 `baseUrl`/`apiKey`；需手动配置 `daemon.json` 的 `agents.claude` 字段
+- **Settings.json 写入彻底禁用** — 移除 `EVOLCORE_ALLOW_SETTINGS_WRITE`；所有 model/effort 配置写入 agent `config.json`
+- **Config 体系 v2** — 两条独立覆盖链：H 链三级（defaults → agent/config → relation/config）、HA 链含角色层（agent/behavior → role → relation/behavior）；`showActivities` 的 `dm-only`/`owner-dm-only` 值废弃（自动迁移为 `all`）
+- **模块路径变更** — `core/stats/*` → `stats/*`、`core/trigger/*` → `trigger/*`、`core/bind` → `utils/bind`、`model-scope` → `config-scope`、`command-handler-gateway-control` → `gateway-config-handler`；外部引用需同步更新
+
+### Dependency Updates
+
+- `@agentunion/fastaun`: `^0.4.x` → `^0.5.0`
+- `@anthropic-ai/claude-agent-sdk`: 保持 `^0.3.170`
+- 删除 `package-lock.json`（不再提交到仓库）
+
+### Package Changes
+
+- 新增文件（trigger 9、stats 9、config 5、kits/schemas 6、utils 4、cli 3、core 2）
+- 删除/移动 15 个文件（重构移动 12，删除 ecweb-launch/ecweb-pair/baseagent-seed 3 个）
+- 190 个文件 → 218 个文件，净增 28 个
+
+
+## v3.4.0 (2026-06-12)
+
+### New Features
+
+- **CLI 模块化** — 将4640行 `command-handler.ts` 和5131行 `cli/index.ts` 拆分为8个专注模块（`command/`、`cli/`子目录），claude-agent-sdk 升级至 ^0.3.170，净减约10000行
+- **ECWeb Monitor 视图** — 新增实时监控页面：进程级 CPU/内存采样（1s 后台循环）、全局统计、per-agent 摘要；IPC 新增 `monitor-snapshot` 处理器
+- **Agent 运行时控制** — ECWeb 支持对每个 agent 执行 start/stop/mute/unmute/queue-clear，stop 中断进行中的模型调用，mute 暂停队列消费同时保留入队消息
+- **`ec watch logs` 多选** — 新增日志类型多选菜单，支持按类型（session/tool/error等）筛选实时聚合日志；`watch.logTypes` 配置默认可选集
+- **AUN 结构化出站 payload** — task status 改走 `notify`（`event/app.task.status`）不入消息历史；activity 逐条结构化（`type:'activity'` + `item`）；notice/error 结构化；`ref_message_id`/`initiator`/`thread_id` 统一透传
+- **Context-aware auto-compact** — 根据 DB 中上次 model call 的实际 context token 记录决策压缩时机，在下一任务开始前执行；DB 新增 `context_tokens`/`max_tokens`/`auto_compact_tokens` 字段
+- **Codex Edit events 统一 diff** — fileChange 映射为 `Edit` tool_use 事件并附带 unified diff，permission 层直接渲染，不重新计算
+- **AUN 群命令 mention 过滤** — broadcast 指令强制要求 @ 触发；`action_card_reply` 归属由消息上下文精确判定
+- **群话题创建权限** — 由 AUN `group.get_admins` 实时查询，仅 owner/admin 可建话题，fail-closed；无权时静默丢弃避免 agent 互相拒绝循环
+- **`/baseagent scope` 参数** — 支持 `session`/`default`/`both` 三档控制切换范围
+- **Session topic rename** — 支持 `/rename` 重命名当前话题会话
+- **ec-web 自动升级** — ECWeb 启动时检测并自动升级新版本，对标 fastaun 升级机制
+- **Agent displayName 解析** — 从 agent.md 本地缓存 + 异步网络拉取 displayName，ECWeb 展示更友好
+
+### Improvements
+
+- **用户中断归类** — 新消息/`/stop`/撤回触发的流中断独立为 `task:interrupted` 事件，不计入 `task:error`
+- **统一出站响应投递** — AUN 渠道所有出站路径收敛到 `adapter.send`，消除渠道间重复分支
+- **Feishu Pin→CheckMark 两阶段 ack** — 收到消息先加 Pin（排队中），runner 开始时升级为 CheckMark 并移除 Pin，视觉无空窗
+- **dispatchModeOverride 分离** — 动态覆盖与持久化 `dispatchMode` 解耦，避免一次性覆盖污染会话配置
+- **ECWeb token TTL 延长至30天** — 支持滑动续期；端口被占时杀旧进程而非漂移到 port+1
+- **`ec status` 展示 ECWeb** — 状态命令新增 ECWeb 进程与 HTTP 就绪状态
+
+### Bug Fixes
+
+- **话题回复上下文丢失** — `ctl send/file` 在 Feishu 话题内未透传 `replyToMessageId`/`replyInThread`，回复落到主会话气泡
+- **文件标记提前暴露** — 定时 flush（非最终）触发时 `[SEND_FILE:...]` 未过滤，原样发给用户
+- **AUN inbound replyContext 缺字段** — 入站消息未填充 `peerId`/`replyToMessageId`，导致 task.status `initiator` 为空
+- **Codex SSE idle 重连误报错** — SSE 超时重连的空 error 事件被当作任务错误处理
+- **JSON parse error 自动重试** — API 返回 JSON 解析异常时触发指数退避重试
+- **ECWeb 启动就绪检测** — HTTP 探测根路径判断就绪，避免进程存活但 HTTP 未就绪的误判
+
+## v3.3.0 (2026-06-10)
+
+### New Features
+
+- **Thread 会话继承 baseagent** — 创建 thread 会话时自动继承父会话的 `agentId` 及 baseagent 配置，多线程场景无需重新切换
+- **Codex runner 增强** — 新增 CLI 版本检测、streaming delta 支持、server 可用性检查；codex-app-server-client 补充类型定义
+- **Menu 话题管理** — command-handler 新增话题菜单的权限判定（`canReadTopics`/`canDeleteTopic`）与格式化（`buildTopicMenuItem`/`resolveMenuChatType`）
+
+### Improvements
+
+- **Channel plugin 接口统一** — `ChannelPlugin` 从 `isEnabled/createChannel/createChannels` 收敛为单一 `createInstance(inst, ctx)` 单实例模型，新增 `ChannelBuildContext` 与 `showActivities` 共享策略；六个渠道（aun/feishu/wechat/dingtalk/qqbot/wecom）同步迁移
+- **ECWeb 控制台重构** — control source 拆分为 `system`（evolcore/fastaun/ec-web 三包版本与健康检查）和 `triggers`（定时任务管理），前端联动更新
+- **Trigger 失败统计** — Trigger 新增 `failCount`/`lastResult` 字段，scheduler/manager/parser 同步
+- **Runner 类型模块化** — 抽出 `runner-types.ts` 统一共享类型，消除各 runner 重复声明
+- **Agent AID 展示** — `AgentInfo` 新增 `aid` 字段，`ec agent` 命令展示 agent AID
+- **缓存模块更名** — `read-cache` 重命名为 `daemon-file-cache`，语义更清晰
+
+## v3.2.0 (2026-06-05)
+
+### New Features
+
+- **控制 AID（control AID）** — 进程级控制身份，启动时以 `pureIdentity` 模式连接 AUN（跳过 evolagent onboarding）。生成采用 `ec+5位数字` 候选 + PKI 权威查重 + fail-fast；缺失时进入 init（TTY 守卫，headless 仅告警）。`ec status` 新增控制 AID 连接状态展示
+- **Menu 协议 / agent 控制面** — `/system`、`/agent` 迁移到 owners 鉴权；trigger 接入菜单协议（直连 manager/scheduler，无文本拼装）；agent 创建支持 accepted-return + 构建进度（`create-status.json` + `onPhase` 回调 + model/chatmode）；新增 agent query/options 与 project 兜底
+- **进程级 owners 配置层** — 新增 `daemon.json` 进程级配置，`config.json` 合并入 `daemon.json`（弃用 `ProcessConfig`）；process-level owners 从 `defaults.json` 迁移到 `daemon.json`；新增 `isProcessLevelOwner` 鉴权辅助
+- **Observer 模式重构** — AUN owner 间消息互转发；`ec init aun` 简化为 owner-only 配置；`mergeForAgent` 输出补全 `dispatch`/`observable`
+
+### Improvements
+
+- **统一 FileCache** — 新增 mtime-gated 统一文件缓存，迁移 relation prefs、manifest+fragment、persona/working 读取与 model-scope 缓存；新增 Cache watch 视图监控缓存命中
+- **消息信封渲染补全** — @AID 列表与群名补全，修复 proximity 信息丢失
+- **Idle 监控解耦** — idle notify/warn 改为事件总线发布（`runner:idle-notify`/`runner:idle-warn`，携带 idleSec/事件数/工具名），与通道发送解耦；超时诊断信息下沉到事件 payload
+
+### Bug Fixes
+
+- **多 agent 群广播去重** — 消息队列改按 `sessionKey:messageId` 去重，允许同一消息广播给多个 agent
+- **AUN owner 入站转发** — owner 来源的入站消息正确转发给其它 owners
+- **单 agent reload 缓存失效** — reload 时失效 identity 层缓存
+- **CLI /slist 过滤** — 过滤掉程序化 SDK session，不在 `/slist` 显示
+- **控制 AID 查重走 GET** — 改用 `store.resolve`（GET）替代 `store.exists`（HEAD），规避部分 Gateway 对 HEAD 空响应断连导致的误判
+- **启动门控修复** — gate 直接调 `initTail` 而非完整 `cmdInit`；AID 生成失败时跳过 owners 提示；抑制控制 AID gate 路径的 SDK keystore 日志
+
+## v3.1.11 (2026-06-04)
+
+### Improvements
+
+- **统一入站图片识别** — 新增 `bufferToInboundImage()`，AUN/飞书/微信共用 magic-bytes → 元数据 → 后缀判定链，消除各通道重复实现的 `detectImageMime`
+- **AUN 附件处理重构** — 抽出 `processAttachments()`，私聊/群聊统一处理；图片注入视觉通道不再追加冗余 `[文件: …]` 文本行
+- **入站去抖** — bridge 默认 inbound debounce 2s → 0（消息即处理）
+- **Windows npm 安装** — `npmInstallGlobal` 改用 `cmd /c`，消除 Node 22 的 `shell:true` 弃用警告
+
+### Bug Fixes
+
+- **截断图片缓冲** — `validateImage` 捕获 image-type 的 EndOfStreamError，避免短/截断 buffer 抛异常
+- **ec-web 退出容错** — `evolcore web` 容忍前台进程信号终止（SIGINT/SIGKILL）/非零退出，不再向用户打印堆栈
+
+## v3.1.10 (2026-06-04)
+
+### Bug Fixes
+
+- **Windows `ec watch web` 仍 ENOENT（续 3.1.9）** — `where` 会列出同名的全部文件，npm 全局 bin 同时生成无后缀 sh 包装脚本和 `.cmd`/`.ps1`；3.1.9 取首行恰好选中无法在 Windows 执行的 sh 包装。改为优先选 PATHEXT 可执行后缀（`.cmd`/`.exe`/`.bat`/`.com`）。另外 Node 18.20+/20+/22 起 `execFile` 拒绝直接 spawn `.cmd`/`.bat`（CVE-2024-27980），改为 `shell:true` + 引号包裹参数执行
+
+## v3.1.9 (2026-06-04)
+
+### Bug Fixes
+
+- **Windows `ec watch web` 启动失败（ENOENT）** — Windows 上全局 bin 是 `ec-web.cmd`，`execFileSync('ec-web')` 不补 `.cmd` 后缀导致 spawn ENOENT。新增 `resolveCommandPath()` 通过 `where`/`which` 解析可执行文件真实绝对路径（不缓存，刚安装的命令会重新探测）再执行；定位失败时给出"重开终端"提示
+
+## v3.1.8 (2026-06-04)
+
+### Bug Fixes
+
+- **npm 包瘦身** — 移除误入 npm 包的 10 个多余文件：`assets/wechat-group-qr.jpeg`（232 KB 运营素材，代码零引用）+ `dist/cli/watch-web/` 的 9 个陈旧构建产物（源码已迁出为独立 `ec-web` 包，但旧 `.js` 残留在 dist）。包大小 729 KB → 493 KB（-236 KB），文件数 168 → 159
+- **build 脚本清理 dist** — `tsc` 前先 `rm -rf dist`，避免源码删除后陈旧 `.js` 残留被打包
+
+## v3.1.7 (2026-06-04)
+
+### New Features
+
+- **观察者模式（observable）** — `AgentConfig.observable` 开启后，AUN 入站/出站消息各转发一份给顶层 `owners[]`（`observer.forward` 格式），便于 owner 旁路监听 agent 会话
+
+### Improvements
+
+- **Trigger channelType 运行时解析** — 移除存储的 `Trigger.targetChannelType`，`buildSyntheticMessage` 改为运行时从 channel key 解析；trigger scheduler 注入与 `__upgrade-check` 播种移到 channel 注册之后，确保 `channelTypeMap` 完整
+
+### Bug Fixes
+
+- **watch 插件定名为 ec-web** — 独立监控面板统一以 `ec-web` 包和命令发布；`ec watch` 的安装/调用引用同步更新
+- **cron trigger 紧密循环** — 定时器提前 ~1ms 唤醒（如 `0 9 * * *` 在 08:59:59.999 触发）会使下次触发落入 `now+50` 窗口被同轮重复触发；`nextCronFireAt` 从窗口外重算，循环守卫改读实时时钟确保收敛
+
+## v3.1.6 (2026-06-03)
+
+### New Features
+
+- **AUN 图片附件支持** — AUN 私聊/群聊附件中的图片自动检测（元数据/文件名/magic bytes 三重检测），base64 编码后直接传给 Agent，不再要求 Read 工具读取
+- **selfAID session 注入** — 从 channel key 解析 selfAID，透传至 MessageBridge → CommandHandler → `getOrCreateSession`，修复 AUN 多身份场景 session 归属错误
+- **watch-web 单实例保护** — 启动前清理旧实例（按 instance 文件 + 端口兜底），端口冲突时自动切换并提示；前端新增 token 失效自动回配对页、退出按钮、配对码过期刷新
+
+### Improvements
+
+- **init 流程优化** — `cmdInit` 一次性写入所有可用 baseagents（不只写选中的那个）；新增 projects 默认目录询问步骤；默认项目路径改为 `EVOLCORE_HOME/projects`；取消 init 后自动进入 `agent new`，改为打印提示
+- **1M 上下文窗口** — `claude-opus-4-8` / `claude-sonnet-4-6` 自动追加 `[1m]` 后缀，`autoCompactWindow` 随之调整为 900000
+- **上下文用量追踪** — complete 事件新增 `contextUsage`（totalTokens/maxTokens/percentage），`usage` 字段重命名为 `tokenUsage`，随 `status.completed` 元数据下发
+- **模型别名缓存 TTL** — 从 1h 缩短至 5min
+- **`/cli` 远程透传** — 经消息通道远程执行 CLI，仅 owner 可用，白名单只读+配置命令，spawn 无 shell，15s 超时 + 128KB 截断
+- **proximity ECK 注入** — `same_device/same_network/same_egress_ip` 从 V2 E2EE 解密结果提取，注入 venue.md 条件块渲染
+- **fastaun 0.4.9** — 含 SPKI 双格式指纹匹配（0.4.8）和 watch-web 单实例相关修复（0.4.9）
+
+### Bug Fixes
+
+- **Feishu merge_forward 内容重复** — 直接转发时丢弃 quotedText，避免内容重复
+- **Feishu seenMsg 文件写入** — 仅在有记录被 GC 清理时才重写文件；seenMessages 清空时改为 unlink
+- **peer-identity 验签** — 新增 `agentmd-unverified` 来源；缓存命中时从 `verify_status` 恢复验签状态，修复 source 误降级
+- **process-introspect** — 改用 `/proc/stat btime`（绝对 epoch）替代 uptime 计算进程启动时间，修复长时间运行后 PID 复用误判
+- **evolagent.load IPC 超时** — AUN WebSocket 冷启动常 >3s，IPC 超时从默认值调整为 30s
+- **交互路由 markWaiting/unmarkWaiting** — 新增提前占位方法，适配异步发卡片场景的等待计数
+
+## v3.1.5 (2026-06-02)
+
+### New Features
+
+- **Web 监控面板（watch-web）** — 全新 `ec watch` Web 面板：实时会话视图、对话视图、AID 状态、消息流，含上下文大小与费用估算；新增 `src/cli/watch-web/` server + 静态前端 + session/msg/aid 数据源
+- **CLI model 命令** — 新增 `src/cli/model.ts`：动态模型目录管理，`/models` 端点拉取（1h 缓存）+ 静态表 fallback，注入已验证但未上线 API 的模型
+- **飞书交互卡片 JSON 2.0 + 表单** — `FeishuCardManager` 管理 CardKit 实体生命周期，`buildActionCardV2()` 表单卡片，动态输入框追加（card.element.create API）
+- **proactive→interactive 模式切换提示** — 模式切换时注入提示信息
+
+### Improvements
+
+- **AUN/AID 三主体模型重构** — fastaun 0.3.3 → 0.4.7 大版本跨越：适配三主体模型与 slot 隔离键，`createAid` 拆分为 `registerAid` + `authenticate`，新增 `AIDStore`，`uploadAgentMd` 迁移至 AIDStore
+- **ECK 上下文组装体系对齐** — 四阶段改造：channelKey 第二段 `selfPeerId`→`selfAID`，sessions 目录统一三层化 `<channelType>/<selfAID>/<channelId>/`，新增 `peer-key.ts` helper，ECK manifest 诊断输出
+- **Session 持久化重构** — 统一 `persistSession(session, intent, opts)` 原语替代 `writeSessionIfChanged`/快照模式，内置去重，`markProcessing`/`clearProcessing` 不再扫描全部 chat 目录
+- **idle-check 消息队列可靠性** — 提升空闲检测与消息队列稳定性
+- **飞书卡片 schema 2.0 统一** — 交互卡片统一为 schema 2.0 inline，用户交互期间暂停 idle monitor，修复 V2 卡片回调 schema 不一致（error 200830/200810）
+- **IPC 出站统计** — 新增 `aun-aid-stats-record-outbound` IPC handler，p2p/group/thought.put 出站消息统计追踪
+- **/model 列表逻辑简化** — `listModels` 走缓存，model 显示标签同时展示完整 ID 与短别名
+- **清理冗余日志与代码** — 移除过时诊断日志和未使用的 skills 代码
+
+### Bug Fixes
+
+- **Trigger channelType 传播** — Trigger 新增 `targetChannelType` 字段，`buildSyntheticMessage` 正确填充 `channelType`，修复触发器消息无法创建 session
+- **session selfAID/channelType 注入** — 修复 session 创建时 selfAID 与 channelType 注入缺失
+- **/model 短别名解析** — `/model sonnet` 等短别名正确解析为完整 model ID
+- **aidCreate 成功路径泄漏 AIDStore** — 修复 AID 创建成功后 AIDStore 资源泄漏
+- **peer-identity type 解析** — 修复对端身份类型解析错误
+- **飞书卡片标题重复 emoji** — 修复 resolved card 标题与 checkers summary 中的双 emoji
+- **消息可靠性与 session 迁移** — 提升消息投递可靠性，改进 session 迁移逻辑
+- **session-mapper 过滤 channelName** — `sessionToFile` 不再将 `channelName` 写入 metadata
+- **resolveChatDirFromSession 严格校验** — 缺失 `channelType` 时抛出明确错误而非静默 fallback
+- **test 脚本修复** — `package.json` test 脚本改为 `vitest run`
+
+## v3.1.4 (2026-05-27)
+
+### New Features
+
+- **CLI help 系统重构 + ECK 注入** — 全新 help 子命令体系，ECK（EvolCore Kit）注入机制重构，AID identity 管理命令
+- **Menu 协议五动词拆分** — menu 协议拆分为 list/query/options/update/action 五个动词，命令收敛至 baseagent/session
+
+### Improvements
+
+- **npm-ops 去 CLI 依赖** — checkLatestVersion 改用 HTTP fetch 直接查 registry API，去除对 npm CLI 的运行时依赖
+- **agent.md 适配 SDK 0.3.3** — 统一 aun_path 到 EVOLCORE_HOME，适配最新 SDK 版本
+
+### Bug Fixes
+
+- **Session channelType 缺失修复** — 修复 channelType 缺失导致 chat dir 无法解析 + isBackgroundSession 同步化
+- **SessionManager 查询路径 NPE** — 修复缺失 channelType 时的空指针异常
+
+## v3.1.3 (2026-05-26)
+
+### New Features
+
+- **Menu 协议拆分为 5 动词** — `menu.list` / `menu.query` / `menu.options` / `menu.update` / `menu.action`，response 统一 `error.code` 透传（`NO_ACTIVE_SESSION` / `MISSING_VALUE` / ...），`name → cmd` 由 bridge 内部映射，AUN 白名单接纳全部 `menu.*` 类型
+- **xhigh effort 档位** — Claude/Codex 新增 `xhigh` 推理强度档位，Codex 通过 `codex debug models` 动态拉取模型目录与各模型支持的 effort 列表
+- **结构化 menu options 字段** — session 子菜单返回 `preview`（首条消息预览）/ `lastActive` / `agentSessionId` / `turns` 扩展字段，所有可选项菜单返回 `selected` 标记当前值
+
+### Improvements
+
+- **命令收敛** — 移除 `/plist` `/project` `/bind` `/agentmd` `/p` 别名；`/agent` 改为 EvolAgent 管理命令；baseagent 切换统一为 `/baseagent`（别名 `/base`）；`/aid` `/rpc` `/storage` `/evolagent` 改为 ctl 专属
+- **execMenu 拆分** — `command-handler` 拆出 `execMenuQuery` / `execMenuUpdate` / `execMenuAction` 三入口，无活跃会话时多项 fallback 到 evolagent config（`/pwd` / `/chatmode` / `/dispatch` 等）
+- **EvolAgent 持久化方法** — 新增 `setActiveBaseagent` / `setChatmodePrivate` / `setDispatch`，配置变更直接落盘
+- **Codex 实例每次重建** — 通过 env 注入 `EVOLCORE_SESSION_ID`，仅首轮拼接 `systemPromptAppend`，避免 resume 时重复污染历史
+- **Agent plugin 启用判定** — `isEnabled` 改为按 `baseagents.<name>` 配置启用，Codex 额外检测 `@openai/codex-sdk` 是否可用，`init` / `agent new` CLI 同步该判定
+- **context-too-long 提示文案** — 按 agent 是否支持 compact 区分提示，retry 后仍超长时清理 renderer 中混入的错误文本（新增 `IMRenderer.stripContextError`）
+
+### Bug Fixes
+
+- **Codex resume 历史污染** — systemPromptAppend 在 resume 轮次重复拼接到 prompt 头部，导致系统提示被反复写入对话历史
+
+## v3.1.2 (2026-05-25)
+
+### Improvements
+
+- **`ec status` 输出版本号** — status 显示 evolcore 版本、fastaun 版本、PID
+- **EvolAgent 热重载增强** — `loadNewAgent` 增加 channel fingerprint 冲突检测；支持 disabled↔enabled 状态转换的热重载
+- **`ec init` / `agent new` 体验** — 单 baseagent 自动选中跳过交互；agent.md 上传失败自动重试 3 次；defaults 已存在选 N 时不再强退；无 agent 时自动衔接 `agent new` 复用 readline；SDK 日志静默
+
+### Bug Fixes
+
+- **session 路径尾斜杠致 sessionId 丢失** — agent 配置 `projects.defaultPath` 带尾斜杠时，每条消息触发 `Invalid session file` 重置 sessionId，多轮对话失效；`encodePath` 编码前剥离尾随分隔符，`loadAgent` 自动 normalize 路径
+- **EvolAgent reload 误断 AUN 连接** — reload 计算 newChannels 时未包含隐式 AUN，导致每次 reload 都把 AUN channel 归入 toRemove 断开
+- **trigger 路由修复** — `/trigger` 命令现在从消息所属 agent 获取 scheduler/manager（而非固定 `runnableAgents()[0]`）。修复了通过 A agent 渠道创建的 trigger 被存到 B agent 目录的问题
+- **飞书卡片回调 chatType 误判** — 卡片回调不再用 `oc_` 前缀盲推 chatType，由 session 继承；`card-trigger` 来源 chatType 置空避免覆盖
+- **AUN interactive 模式重复发送** — interactive 模式不再重复 `thought.put`，只写入消息历史
+- **npm 包文件缺失** — `package.json` files 字段改为 `*.md`（排除 CLAUDE.md），确保 CTL.md/TRIGGER.md/SKILLS.md 随包发布
+- **测试稳定性** — wechat-media AES-ECB 错误密钥测试间歇性失败修复
+
+## v3.1.1 (2026-05-24)
+
+### New Features
+
+- **status.progress 事件系统** — 新增实时进度事件，包含 activityType 和 outputTokens 元数据，支持工具调用进度追踪
+- **/trigger update 命令** — 支持修改已有触发器配置
+
+### Improvements
+
+- **CLI 工具优化** — watch session/msg/aid 命令增强，agent list 表头国际化和动态列宽对齐
+- **chatmode 机制增强** — 群聊强制 proactive 模式，PeerIdentityCache 初始化时创建 agentDir
+- **消息流程梳理** — 优化消息监控和 AID 追踪，完善 task_id 诊断日志
+
+### Bug Fixes
+
+- **渠道 status.progress 处理** — 修复 Feishu、DingTalk、QQBot、WeCom、WeChat 五个渠道缺失 status.progress 事件处理
+- **Feishu post 格式降级** — post 格式发送失败时自动降级为纯文本重试
+- **im-renderer 错误抑制** — 抑制 context-too-long 错误输出
+- **AUN agent 间消息 chatmode** — 修复 agent 间消息 chatmode 显示错误
+- **turn counting 去重** — 修复 turn 计数重复，正确传递 outputTokens 到 tool_call progress
+- **plan mode 显示优化** — 修复计划内容显示 + notice emoji 去重 + 命令输出精简
+
+## v3.1.0 (2026-05-23)
+
+### New Features
+
+- **ECK 上下文系统重构** — 引入 `kit-renderer.ts` 替代旧 `templates.ts`，系统 prompt 按片段动态组装（baseagent/channel/identity/relation/runtime/venue）；新增 `eck_manifest.json` 声明 kit 结构，支持参数动态注入
+- **`/upgrade` 命令** — 一键升级 evolcore 到 npm latest，AUN SDK 同步自动升级
+- **Feishu merge_forward 消息支持** — 合并转发消息类型解析，自动展开为多条消息内容
+- **AUN quote 附件支持** — quote 消息携带附件时正确解析并传递给 Agent
+- **CTL 白名单扩展** — `/trigger`、`/chatmode`、`/dispatch`、`/activity` 加入 `ctl` 可调用命令列表
+- **agent.md description 保留** — AID 重初始化时保留用户自定义 description，不再覆盖为默认值
+- **启动版本信息** — `ec start` 成功后显示 evolcore 版本号和 fastaun 版本号
+
+### Improvements
+
+- **`ec` 命令** — 新增 `bin/ec.js` 快捷入口，`link-rules` 命令调优
+- **`ec watch-msg`** — 优化消息监控命令，支持更多过滤选项
+- **`ec bench`** — 性能测试命令完善
+- **`agent/aid --help`** — 支持 `--help`、`-h` 标志，不再只识别 `help` 子命令
+- **task_id 诊断日志** — 新增 task_id 追踪日志，便于消息关联排查
+- **activity 工具摘要统一** — Bash desc 与工具摘要显示格式统一
+
+### Bug Fixes
+
+- **proactive chatMode 持久化** — AI peer 的 proactive chatMode 跨会话正确持久化，session 写入去重
+- **permission timeout 修复** — 权限超时处理 + agent context 全局 chatmode fallback
+- **error-utils 字典路径修复** — bundled dict fallback 路径修正
+- **AUN CommandCard 群聊点击身份丢失** — 群聊卡片点击时 initiator 身份正确传递
+- **AUN group.send message_id 提取** — 所有路径完整提取 message_id
+- **context-too-long 检测增强** — 新增文本 fallback 触发 compact，避免漏检
+- **session activeTask 保留** — updateSession 写入时不再丢失 activeTask 状态
+- **permission diff 渲染** — 使用 Unicode diff 标记和真实行号，Feishu 渲染正确
+- **activity 多行工具描述** — 标题单独一行渲染，不再与内容混排
+
+---
+
+## v3.0.0 (2026-05-20)
+
+> Major release: 重构存储后端、统一出站消息协议、引入触发器与交互卡片体系。
+> 旧 SQLite 时代代码归档于仓库 `evolcore_db`（tag `v2.8.3-db-final`，commit `a7c5e19`）。
+
+### Breaking Changes
+
+- **Session 存储后端切换** — 从 SQLite 迁移到文件系统：`data/sessions/<channelType>/<encoded-id>/` 目录布局，每个 chat 含 `active.json` + `meta_*.jsonl` + `messages.jsonl` + `health.jsonl` + `_threads/`。`sessions.db` 已弃用，启动时 warn 提示用户手动删除。
+- **Config key rename**（v2.7.0 起逐步推进）— `daemon.json` 中 `agents.{anthropic,openai,google}` 重命名为 `agents.{claude,codex,gemini}`，启动时自动迁移并回写
+- **Channel-level sessionMode 字段废弃** — 改由 `config.chatmode.{private,group}` 全局控制
+- **AUN channel 隐式化** — 不再需要在 `channels[]` 中显式声明 AUN，从 agent.aid 自动派生
+- **`daemon.pid` 文件淘汰** — 替换为 `data/instance/main-<pid>.json` 实例登记机制
+
+### New Features
+
+- **触发器系统** — Agent 可自主设置延迟 / 定时 / 周期任务（`/trigger` 命令），支持 cron 表达式；触发器在独立 silent session 中执行，发布 `trigger:completed` 事件
+- **交互卡片二分体系** — `CommandCard`（按钮直接触发 slash 命令）+ `ActionInteraction`（按钮回写 InteractionRouter）；Feishu 与 AUN 统一支持，旧卡片新卡发送时自动作废为"已过期"灰色卡片
+- **EvolAgent 重构** — v2.8.3 引入的 EvolAgent 在 v3.0.0 大幅扩展：完整热重载（drain → disconnect → reconnect → route-update + rollback on failure）；per-agent runner 实例 + per-agent credentials 真正隔离；channel fingerprint 跨实例冲突检测
+- **出站消息统一协议** — 命令回显 / 系统通知 / interaction 全部走 `adapter.send` 统一入口，`OutboundPayload` 结构化
+- **/dispatch 命令** — 群聊分发模式切换：`mention`（仅@响应）/ `all`（广播响应）；proactive 模式 mention 过滤统一由 dispatchMode 决定
+- **AUN write-ahead outbox** — `data/outbox/<aid>.jsonl` 写前持久化（每 AID 上限 20 条 / TTL 5min），断网期间消息不丢，重连后 drainOutbox
+- **`ec watch` 命令** — 聚合 tail 所有 `*.log`，颜色区分文件、JSON 行特殊渲染、AUN 多格式 JSON 解析（消息/事件/trace）、ESC 退出
+- **`ec status` 扩展** — 新增 🔑 AUN AIDs 表格（per-AID 连接状态 via IPC）+ orphan session 总数
+- **AUN 群聊 proactive 入站白名单** — proactive 模式下仅放行规范 payload 类型，且必须显式 @ 自己或 @all
+- **AUN quote 消息支持** — quote 类型自动拼接被引用内容到正文前
+- **`/restart` 优雅关闭** — 改用 SIGTERM 让 Feishu WebSocket 正常关闭，避免服务端重推未 ack 消息
+
+### Improvements
+
+- **CommandHandler 结构化输出** — 返回 `OutboundPayload` 替代字符串，`thought` 结构化聚合替代格式化文本
+- **ChannelAdapter 接口收敛** — 删除旧出站方法，统一 `adapter.send`
+- **channel 消息桥接下沉** — 从 index.ts 下沉到插件 `registerBridge`，新增 channel 模板化
+- **src/ 目录结构整理** — `cli/` 收拢、`aun/` 工具归位、`config-store.ts` 替代 `config.ts`，小文件合并
+- **身份维度拆分** — Session/Message/InboundMessage 新增 `channelType` + `selfId` + `groupId`，channel 字段固定为实例名；`SessionMetadata.peerId` 含义统一
+- **每个 chat 消息日志** — `messages.jsonl` 用于 audit/replay
+- **Feishu 过期消息丢弃** — 超过阈值的旧消息直接丢弃
+- **`/activity /chatmode /dispatch` UI 改进** — 改用交互卡片，无参数时弹出按钮列表
+- **日志轮转** — `evolcore-YYYYMMDD-HH.log` 按小时切片，`logs`/`watch` 命令自动检测最新文件并无缝切换
+- **统一日志管理** — 所有模块走 `utils/logger.ts`，`utils/log-writer.ts` 处理 rotation
+- **孤儿进程检测** — `ec status` 检测残留 node 进程
+- **AUN reconnect 重写** — SDK 跑无限退避，TS 层只在 flap（短命连接 ≥3 次）和被踢类 terminal_failed 时接管（5min 退避）；新增 `connect.extra_info` 自描述身份
+- **fastaun 升级** — `@agentunion/fastaun` 升至 ^0.2.20
+
+### Bug Fixes
+
+- **proactive 模式 mention 过滤** — 统一交给 dispatchMode，避免无差别介入群聊
+- **多 channel 并发时 AskUserQuestion 路由修复** — `sendPromptFn` 改为 per-session 构造，避免被全局单例覆盖
+- **Windows 实时日志** — 改用 `fs.watchFile` 轮询替代 `fs.watch`，解决跨进程 append 不滚屏问题
+- **Windows 终端闪烁** — 减少不必要的 stdout flush
+- **Feishu 回复上下文** — `replyContext` 仅在话题消息中设置，避免普通消息误带 thread 回复
+- **EvolAgent runner 隔离** — per-EvolAgent runner 实例 + per-agent credentials，避免多 agent 凭证混淆
+- **AUN 加密状态透传** — `ReplyContext.metadata.encrypted` 透传到出站，逐消息镜像加密态
+- **echo 防链式爆炸** — 超过 2 行丢弃
+
+---
+
+## v2.8.3 (2026-05-14)
+
+### New Features
+
+- **EvolAgent Mode** — 一等 agent 实体：一个 JSON 文件自包含 channels + baseagent + project + chatmode。多 agent 并发运行，各自独占 channel 资源
+  - `ec agent` CLI：list / show / new / reload
+  - Channel fingerprint 冲突检测（启动时 + 热重载时）
+  - 完整热重载：drain → disconnect → reconnect → route-update + rollback on failure
+  - 凭证变更检测：kept channel 配置变化自动重连
+  - Owner 自动绑定写回 agent.json
+  - 命令拦截：agent-owned channel 上 /project /bind /plist /agent-switch 禁用
+  - DefaultAgent 兜底处理 daemon.json channels
+  - AgentRegistryHandle 类型接口（IPC/MessageProcessor/CommandHandler 类型安全）
+  - Real drain via MessageQueue.isChannelProcessing（30s timeout + 100ms poll）
+
+### Improvements
+
+- **Channel Fingerprint** — `{type}:{primaryKey}` 统一格式，启动时检测 daemon.json 内重复凭证
+- **ChannelLoader 幂性** — 验证 createAll 可安全多次调用（evolagent multi-source 基础）
+- **Orphan session 检测** — `ec status` 显示孤儿 session 总数
+- **baseagent key 统一** — config.agents.{anthropic,openai,google} → {claude,codex,gemini}，启动时自动迁移
+
+---
+
+## v2.8.0 (2026-05-13)
+
+### New Features
+
+- **交互式 `/ask` 命令** — AskUserQuestion / ExitPlanMode 不再自动选第一个选项，注册到 `interactionRouter` 等待用户通过 `/ask` 回复；proactive 模式下系统提示明确禁用这两个工具
+- **AUN 群聊 proactive 入站白名单** — proactive 模式下，仅放行规范 payload 类型（text/quote/image/video/voice/file/json/merge/link/location/personal_card），且必须显式 @ 自己或 @ all；其它消息直接 ack 丢弃，避免无差别介入群聊
+- **E2EE 加密状态透传** — 入站 E2EE 加密状态通过 `ReplyContext.metadata.encrypted` 透传到出站发送，AUN 通道逐消息镜像加密态（包括 `thought.put`，不再硬编码 `encrypt=true`）
+- **`execMenu()` 结构化菜单执行** — 为 `/perm`、`/chatmode` 等命令提供结构化查询 / 更新接口，便于 Agent 程序化改配置
+
+### Improvements
+
+- **`processing_state` 持久化 taskId** — Session 级保存当前处理任务的 `taskId`，`ec ctl send` 可从上下文自动恢复
+- **fastaun 依赖升级** — `@agentunion/fastaun` 从 0.2.15 升至 0.2.17
+
+---
+
+## v2.7.3 (2026-05-13)
+
+### Bug Fixes
+
+- **多 channel 并发时 AskUserQuestion 路由修复** — `sendPromptFn` 是全局单例，多 channel 同时活跃时会被覆盖导致提示发到错误 channel；现改为从 `permCtx.adapter/channelId` 构造 per-session 发送函数，确保交互卡片始终路由到正确 channel
+
+## v2.7.2 (2026-05-13)
+
+### Bug Fixes
+
+- **`/stop` 命令对所有角色开放** — guest/AUN Agent 现在可以中断自己的任务，不再被权限拦截
+- **`/perm` 显示修复** — 新会话的默认权限模式显示统一为 bypass，不再因角色不同而显示 auto
+
+## v2.7.1 (2026-05-13)
+
+### Bug Fixes
+
+- **默认权限模式统一为 bypass** — 所有角色（owner/admin/guest）新建会话时默认使用 bypass 模式，避免 SDK AI 分类器拦截 `ec ctl send` 等命令
+- **Windows 实时日志修复** — `ec logs` 在 Windows 上改用 `fs.watchFile` 轮询替代 `fs.watch`，解决跨进程 append 场景下日志不滚屏的问题
+- **Feishu 回复上下文修复** — `replyContext` 仅在话题消息中设置，避免普通消息误带 thread 回复上下文
+
+## v2.7.0 (2026-05-13)
+
+### Breaking Changes
+
+- **Config key rename** — `daemon.json` 的 `agents.anthropic` / `agents.openai` / `agents.google` 重命名为 `agents.claude` / `agents.codex` / `agents.gemini`，与 runner name 对齐。启动时 `loadConfig` 自动迁移旧 key 并回写 daemon.json，用户无需手动修改；同时 warn 日志提示迁移已发生。
+- **Channel-level sessionMode 移除** — 通道实例配置中的 `sessionMode` 字段废弃，改由全局 `config.chatmode.{private,group}` 统一控制（不设时默认 `interactive`）。原先 AUN 群聊"默认 proactive"的硬编码逻辑也一并移除，需要的用户显式设置 `chatmode.group = "proactive"`。
+
+### New Features
+
+- **`chatmode` 全局配置** — `config.chatmode.private` / `config.chatmode.group` 分别控制单聊/群聊的默认会话模式，替代通道级 `sessionMode` 锁定
+- **`debug.logLevel` 配置项** — 日志级别优先级：`config.debug.logLevel → LOG_LEVEL 环境变量 → 'INFO'`，无需重启即可通过 reload config 调整
+- **orphan session 统计** — `ec status` 显示通道已下线但会话仍残留的条数（按通道分组），帮助识别配置变更后的陈旧数据
+- **通道指纹去重检测** — 启动时检测 Feishu/QQBot/WeCom 等通道的 `appId` 是否跨实例重复配置，冲突时输出 warn 日志（跨通道类型不算冲突）
+- **`projects.autoCreate` 生效于 `/bind`** — 配置开启时，`/bind <path>` 遇到不存在的目录自动创建
+
+### Improvements
+
+- **`ec ctl send/file` 全权限放行** — Claude Runner 在任何权限模式（含 readonly/noask/auto）下都不拦截这两个命令，proactive 模式 agent 可靠发送消息的前提
+- **默认权限模式收敛** — guest/admin 统一为 `auto`（原 guest 为 `noask`），owner 仍为 `bypass`；`/perm` 无参查询和 MessageProcessor 初始化同步
+- **AUN RPC 统一 trace** — 新增 `callAndTrace` 包装所有 `client.call`，成对记录 `OUT`/`OUT.ok`/`OUT.error`；auth.authenticate、client.connect、client.close、storage.create_download_ticket 全部走统一链路
+- **AUN 日志分级** — `message.received` / `group.message_created` 等高频 DIAG 日志从 info 降为 debug；新增 `P2P dispatched` / `Group dispatched` / `Group missed` 等结构化关键路径日志
+- **单 agent/channel 推断** — `validateConfigIntegrity` 在只有一个 agent 或 channel 时不再要求显式 `defaultAgent`/`defaultChannel`
+- **SDK fallback 消息兜底** — 识别 Claude SDK 本地拦截的 "Unknown skill: xxx" 等预处理消息，proactive 模式下主动发送给用户，避免无反馈
+- **命令快速路径补全** — `/rewind`、`/rw`、`/activity`、`/chatmode`、`/aid`、`/agentmd` 加入 quick command prefix 白名单，确保不进入消息队列
+- **`/perm` 切换后自动刷新** — 切换权限模式成功后重新发交互卡片（自动 invalidate 旧卡片），UI 状态实时一致
+
+### Bug Fixes
+
+- **config validation 误报** — 多 agent 场景下的 `defaultAgent` 校验逻辑修正，避免对仅有一个 agent 的最简配置误报
+- **通道指纹重复告警守卫** — 仅在 `duplicates.length > 0` 时输出 warn，避免日志噪音
+
+---
+
+## v2.6.4 (2026-05-11)
+
+### New Features
+
+- **Prompt 模板化** — 系统提示从硬编码迁移到模板文件（`src/templates/prompts.md`），支持用户级覆盖（`{EVOLCORE_HOME}/data/prompts.md`）；`runtime`/`group`/`proactive` 三段分别控制，支持 `{{var}}` 变量和 `{{?cond}}…{{/}}` 条件段
+- **Gemini noask 模式** — 映射到 `--approval-mode=default`，Gemini CLI 现支持静默模式
+
+### Improvements
+
+- **Readonly 模式暂时禁用** — 所有 Agent 后端（Claude/Codex/Gemini）下线 `readonly` 权限模式，与 proactive 模式系统提示词语义冲突；READONLY_WRITE_PATTERNS 未覆盖 `ec ctl send/file`，契约不稳固
+- **默认权限模式调整** — 新逻辑：`owner → bypass / admin → auto / guest → noask`（历史会话 `readonly` 自动迁移至 `noask`）
+- **日志可观测性增强** — MessageProcessor 事件日志附带 text/tool 摘要；AUN `thought.put` 成功/失败、`task.status` 发送均有结构化日志；ThoughtEmitter 创建时记录 channel/task/chatmode
+
+---
+
+## v2.6.3 (2026-05-11)
+
+### New Features
+
+- **AUN E2EE 自适应降级** — 发送消息时自动探测对端加密能力：首次尝试 E2EE，遇 `E2EEError` 自动降级明文重发并缓存结果（10min TTL），后续直接走明文通道
+- **命令权限读写分离** — `/model`、`/agent`、`/effort`、`/perm`、`/activity` 等命令无参查询对所有人开放，带参切换仍需管理员权限；guest 在群聊/私聊中可查看运行状态
+- **出站 payload 统一 task_id/chatmode** — 所有出站消息（text/file/thought/status）统一携带 `task_id` 和 `chatmode` 字段，便于客户端关联同一任务的全部消息
+
+### Improvements
+
+- **AUN SDK 日志开关** — 新增 `aunSdkLog` 配置项，控制 SDK 内部日志写入（默认开启）
+- **AUN undecryptable 事件监听** — 监听 `message.undecryptable` / `group.message_undecryptable` 事件并记录告警
+- **AUN init gateway 自动发现** — `createAidSilent` 和 `setupAunAid` 使用 `GatewayDiscovery` well-known 自动解析网关 URL，移除手动端口输入
+- **交互卡片 idle 守卫** — 会话忙碌时不发送交互卡片（降级为文本），已弹卡片被点击时二次校验忙碌状态
+- **idle 检查精细化** — 仅对写/破坏性命令要求 idle，纯读无参形态始终放行
+- **AUN selfName 暴露** — adapter 新增 `_selfName()` 方法，系统提示可展示 Agent 自身名称
+- **AUN send 结果校验** — `message.send` / `group.send` 返回值缺少 `message_id` 时记录告警
+
+---
+
+## v2.6.2 (2026-05-11)
+
+### Improvements
+
+- **AUN 群组 ID 新格式** — 支持 `group.{issuer}/{group_no}` 和纯数字群号格式，兼容旧 `grp_`/`g-` 前缀
+- **AUN 群消息明文传输** — 群聊消息禁用 E2EE（`encrypt: false`），对齐协议规范
+- **AUN welcome 消息持久化** — 首次欢迎消息使用 `persist_required: true` + 3s PKI 延迟，确保 Owner 证书就绪后可靠送达
+- **`/chatmode` 权限下放** — 查看模式对所有人开放；群聊设置仍限管理员，单聊任何角色可设置
+- **`/status` 显示会话模式** — 输出当前 interactive/proactive 状态及通道锁定标记
+- **系统提示 self/peer identity** — 注入 Agent 自身名称+AID 和对端名称+ID，增强上下文感知
+- **Thought ctl 命令可观测** — `ec ctl send/file` 在 thought 中显示完整命令内容
+
+---
+
+## v2.6.1 (2026-05-11)
+
+### Improvements
+
+- **Thought 协议对齐 task_id** — `ChannelAdapter.putThought` / `sendProcessingStatus` 由 `replyToMessageId` 改为 `taskId`，对齐服务端 selector 协议（`context: {type: 'task', id}`）；同一次任务处理的所有 thought / 状态事件共享一个 `task-{10hex}`，replies/history 查询更精确
+- **AUN dispatch_mode 分派** — 群聊接收服务端下发的 `dispatch_mode`：`mention` 模式仅在 @ 时响应，`broadcast` 模式响应全部消息；@mentions 字段也精简为只在 mention 命中时回填
+- **SKILLS.md 实时刷新** — `data/SKILLS.md` 提示不再在进程内缓存，每次从磁盘读取；用户编辑 SKILLS.md 后立即生效，无需重启
+- **AUN SDK 升级** — `@agentunion/fastaun` 0.2.14 → 0.2.15
+- **event-bus 精简** — 移除 `message:new-inbound` 事件（task_id 取代了动态切换 replyTo 的需求）
+
+### Bug Fixes
+
+- **Thought 重复摘要** — proactive 模式下，流式 text 已推送过 thought 时，complete.result 不再重复发送最终 summary
+- **Tool 结果空值** — `ToolResult` 返回内容为空时只输出 `✅ toolName`，不再拼接空字符串
+
+---
+
+## v2.6.0 (2026-05-08)
+
+### New Features
+
+- **Proactive session mode** — AUN 群聊支持主动会话模式，Agent 可主动发起对话而非仅响应
+- **Menu protocol v2** — 服务端多级菜单协议，支持嵌套菜单结构和动态菜单生成
+- **ExitPlanMode approval** — Plan 模式新增审批流程，移除超时机制，改为显式确认
+- **AUN welcome message** — 首次连接 AUN 网络时自动向 Owner 发送欢迎消息并初始化 agent.md
+- **CLI --version flag** — `ec --version` / `-v` / `-V` 输出版本号
+- **pathToClaudeCodeExecutable** — 支持在配置中显式指定 Claude Code CLI 路径（SDK 自动发现失败时的 escape hatch）
+
+### Improvements
+
+- **Windows IPC named pipe** — Windows 下 IPC 从 Unix socket 切换为 named pipe（`\\.\pipe\evolcore-<hash>`），解决 EACCES 权限问题，支持多实例隔离
+- **AUN init 全链路健壮性** — CA 下载与 agent.md 写入解耦；重建 client 显式传 `root_ca_path` + `aid`；本地写入后 existsSync 校验
+- **Channel SDK 按需加载** — 重型渠道 SDK 移入 optionalDependencies，未安装时优雅跳过
+- **`/send` → `/file` 重命名** — 文件发送命令统一为 `/file`，语义更清晰
+- **AUN agent display name** — 从 owner 的 agent.md 派生显示名，而非 AID 前缀
+
+### Bug Fixes
+
+- **AUN init CA verification** — 修复首次 init 时 uploadAgentMd 报 "no trusted roots available"（SDK 需显式 root_ca_path）
+- **AUN init identity** — 修复重建 client 后 uploadAgentMd 报 "no local identity found"（需传 aid 参数）
+- **Feishu empty config** — appId/appSecret 均为空时不再输出无意义的验证警告
+- **Message recall interrupt** — 消息撤回事件正确触发 'recalled' 中断类型
+- **CLI unknown channel** — `ec init <unknown>` 现在报错并列出支持的渠道，而非静默失败
+
+---
+
+## v2.5.0 (2026-04-28)
+
+### New Features
+
+- **DingTalk channel** — 钉钉 Stream 模式集成，支持文本/图片/文件收发，自动去重，Markdown 转纯文本
+- **QQBot channel** — QQ 频道机器人集成（pure-qqbot SDK），支持文本/图片/文件收发，自动去重
+- **WeCom channel** — 企业微信 AI Bot 集成，完整 channel plugin 支持（624 行，`ec init wecom` 配置）
+- **Agent self-management (ctl)** — Agent 可通过 `ec ctl <cmd>` 管理运行时：切换模型、调整推理强度、查看状态、压缩上下文、管理权限、发送文件、重启渠道。命令白名单 + 路径沙箱保护
+- **Session rewind** — `/rewind <turn>` 回退会话到指定轮次，支持文件快照恢复（dryRun 预览 + 实际回退）
+- **Admin role** — 新增 admin 角色（owner 之下），支持分级权限控制（user/admin/owner）
+- **AUN file attachments** — AUN 私聊/群聊支持文件附件收发，SHA256 校验，自动下载到项目 `.evolcore/uploads/`
+- **AUN protocol v2** — 结构化 payload 格式 `{type, text, thread_id}` 替代扁平 text+task_id；事件化处理状态；通过 agent.md 解析 peer info（30min TTL 缓存）
+- **`/agentmd` command** — 查看、发布、管理 AUN 网络上的 agent.md（`/agentmd`、`/agentmd put`、`/agentmd set <内容>`）
+- **Message recall → interrupt** — 撤回消息现在会中断正在执行的任务（所有渠道，不仅飞书）
+- **AskUserQuestion action cards** — 问题卡片从表单模式升级为 action card（按钮模式），已解决卡片保留正文
+
+### Improvements
+
+- **Permission refinements** — `/check` 提升为 user 级（guest 看摘要，admin 看详情）；`/activity` 查看降为 admin（切换仍需 owner）；`/restart <channel>` 重连渠道（admin+），`/restart` 重启服务（owner only）
+- **SKILLS.md global placement** — 从项目级 `.evolcore/` 迁移到全局 `{EVOLCORE_HOME}/data/SKILLS.md`，懒加载 + semver 版本管理 + trigger 字段提供更好的 agent 上下文
+- **AUN peer info display** — `peerType` 字段独立于 `peerName`（不再是 "name (type)" 格式）；仅在 peerType 非 'unknown' 时显示到系统提示
+- **System prompt optimization** — 提取 SKILLS.md frontmatter description 生成简洁 ctl 提示；记录 systemPromptAppend 预览（前 100 字符）
+- **AUN SDK upgrades** — 升级到 aun-core 0.2.9，强化群聊回声去重 + SDK 兼容性；well-known discovery 用于网关 URL 解析
+- **AUN CLI enhancements** — 静默模式（`-s`）、文件管理（`//sendfile`、`//history`）、群组管理（`//qid`）、AID 快速切换（`//aid`）
+- **Post-interrupt error suppression** — 用户主动中断后的 SDK telemetry 噪音不再记录为错误
+- **`/rewind` improvements** — DryRun 预览 + 实际回退，改进日志和错误消息
+- **Dynamic error handling** — 运行时错误字典（`data/error-dict.json`），支持热更新和模式匹配
+
+### Bug Fixes
+
+- **AUN CLI unread count** — 切换目标时自动 mark_read；自动补全中隐藏当前目标未读数；移除底部工具栏冗余未读计数
+- **AUN CLI message dedup** — 内存级去重（500 条 LRU 缓存）防止 SDK 重复触发竞争窗口
+- **AUN tests async** — 群聊/私聊消息处理测试加 async/await（fetchPeerInfo 是异步的）
+- **Tests version control** — 从 `.gitignore` 移除 `tests/`（测试应纳入版本控制）
+
+---
+
+## v2.4.0 (2026-04-18)
+
+### New Features
+
+- **AUN CLI overhaul** — 全面重构 AUN 命令行客户端：文件传输（`//sendfile`）、消息历史（`//history`）、群组管理（`//qid`）、AID 快速切换（`//aid`）、数据日志查看器（`aun --log N`，支持 JSON 高亮和跨天轮转）
+- **AUN SDK monkey-patches** — 修复 E2EEManager 三个 bug：`clean_expired_caches` 缺失、GroupE2EEManager `_prekey_cache` 引用错误、`sender_fingerprint` 错误 fallback 到 SPKI
+- **AUN group ID format** — 支持 `g-xxx.agentid.pub` 格式的群组 ID 识别
+- **AUN @mention extraction** — 群聊中支持 `@aid` mention 补全和提取
+
+### Improvements
+
+- **Interactive card lifecycle** — 发送新交互卡片时自动作废旧卡片（PATCH 置灰 + 取消回调），统一 `sendInteractionCard` 流程
+- **`patchInteractionCard` adapter** — ChannelAdapter 和 FeishuChannel 新增卡片 PATCH 能力，`sendInteraction` 返回 `message_id`
+- **Reply context per-message** — `replyContext` 从 session 级改为 message 级（跟着任务走），修复中断后回复上下文丢失和话题路由问题
+- **`ec logs` enhanced** — 彩色日志渲染、`--level`/`--module` 过滤、`--raw` 原始模式、长消息自动截断（200 字符）
+- **StreamFlusher `hasText`** — 仅在含真实文字时消费 `replyToMessageId`，避免纯工具活动消息占用引用
+- **Permission mode at creation** — 会话创建时即写入默认权限模式（owner → bypass，guest → readonly），无需运行时推断
+- **`/effort` quick command** — `/effort` 加入快速命令路径，不再进入消息队列
+- **`/project` `/agent` idle guard** — 加入 `requiresIdle` 列表，处理中不允许切换
+- **AUN dep version check** — 依赖检查从缺失检测升级为版本比对（`aun-core>=0.2.4`），版本过低自动升级
+- **AUN group commands simplified** — 群命令表从 20+ 扁平命令精简为 7 个分类入口（list/info/user/join/setup/group/quit）
+- **AUN send result stripping** — 精简 SDK send 返回值，剔除 E2EE 密文 payload 和重复 event 块
+
+### Bug Fixes
+
+- **Vitest external project exclusion** — 排除 `projects/**` 外部项目测试，避免缺失依赖导致测试失败
+- **AUN acknowledge behavior** — acknowledge 不再发送 RPC `message.ack`（网关自动 delivery-ack 已足够），避免发送端重复"已送达"
+
+---
+
+## v2.3.0 (2026-04-15)
+
+### New Features
+
+- **Interactive card UI** — `/perm`、`/model`、`/effort`、`/agent`、`/plist`、`/slist` 命令在飞书中以交互卡片呈现，支持一键操作，不支持卡片的渠道自动降级为纯文本
+- **`/effort` command** — 独立的推理强度控制命令（从 `/model` 拆出），支持交互卡片选择
+- **Readonly permission mode** — 只读权限模式，拦截所有写入操作（文件写入仅允许 `.evolcore/tmp/`，Bash 写入命令黑名单）
+- **Multi-instance channel support** — 同一渠道类型可配置多个实例（如多个飞书 bot），每个实例独立会话和配置
+- **CLI session listing** — `/slist cli` 列出未导入的 CLI 会话，支持卡片一键导入
+- **Gemini session resume** — Gemini 后端支持会话恢复（`-r sessionId`）
+
+### Improvements
+
+- **Card lifecycle management** — 发送新卡片时自动作废旧卡片（PATCH 置灰 + 取消回调），避免过期卡片误操作
+- **Permission mode defaults** — 会话创建时即写入默认权限模式（owner → bypass，guest → readonly），无需运行时推断
+- **Reply quote precision** — StreamFlusher 仅在含真实文字时消费 replyToMessageId，避免纯工具活动消息占用引用
+- **InteractionRouter** — 通用交互路由器，管理卡片回调注册、超时清理、会话级取消
+- **Channel routing refactor** — session.channel 存储实例名（非渠道类型），多实例场景精确路由