aws-runtime-bridge 1.9.185 → 1.9.189

package/CHANGELOG.md

@@ -1,1640 +1,1767 @@
-# Changelog
-
-本文件记录 aws-runtime-bridge 各版本的发布说明，随 npm 包一并分发（package.json
-files 白名单），供调度中心「查看本次更新内容」弹窗按 `## v<version>` 精确切片
-展示。发布新版本时须在仓库中先写好 `## v<version>` 段（prepack-guard 校验缺段
-即阻断发布）；Bridge 自更新成功后的运行时追加仅作为包内缺段时的兜底。
-
-## v1.9.185
-
-_发布日期：2026-11-04_
-
-### 修复：已配对机器重启不再自毁配对（面板实例消失的根因）
-
-已配对机器（machineToken 自持凭据）优雅关闭时曾无条件调用 `/api/instances/unregister`
-注销实例，而 server 端该路径会整行删除登记行——`machineToken` 的 hash 就存在这一行上，
-行被删掉配对即被永久摧毁：重启后机器凭据注册被拒（invalid or revoked），面板上的实例
-也随之消失。本次两端同修：
-
-- Bridge：注销时识别机器凭据目标（machineToken / credentialType=MACHINE_TOKEN），
-  **跳过自删登记行**——配对身份必须跨重启存活；Agent 离线由隧道断开与服务端重启同步兜底，
-  真正下线机器请用管理页删除（Bearer 路径，带租户/负责人校验）；
-- Server：runtime token 自注销路径拒绝删除 MACHINE_TOKEN 行并返回明确错误
-  （兼容尚未升级的旧版 bridge，防止其重启时再毁配对）；token 无效时不提前泄露
-  实例的存在性与凭据类型，仍按既有路径走登录态校验。
-
-### 修复：票据里填写的实例名写回不再被旧主机名顶掉
-
-server 配对响应的实例名以票据建议名为权威，但 bridge 写回配置用的是
-`target.instanceName = target.instanceName || instanceName`——本机已有同址旧 target
-（instanceName 为历史主机名，如此前用 API Key 注册过）时票据名永远写不进本地配置；
-下次注册（配对后立即重注册或重启）机器上报旧主机名，server 又按请求名覆盖登记行，
-用户在票据里填写的实例名就丢了。本次改为**无条件写回 server 响应名**，票据名在
-本地配置与面板登记行之间保持一致。
-
-## v1.9.184
-
-_发布日期：2026-11-03_
-
-### 调整：后台命令上限 20 个，满额报错可操作并回显剩余名额
-
-后台命令名额此前只有 16 个，且满额报错只有一句「Kill or wait」——agent 不知道还剩多少名额，
-也不知道怎么腾位，本地命令通道因此被整段卡死（只能干等保留期过期）。本次把名额管理做成
-可见、可操作：
-
-- 单 agent 后台命令上限 16 → 20（运行中与 5 分钟保留期内已完成的命令都占名额）；
-- 满额时新命令明确失败（status=not_executed，不自动杀任务）：报错带 `20/20 slots in use`
-  实况与 `kill_background_command` 腾位指引，agent 按指引停止现有命令后重试即可继续；
-- `kill_background_command` 停止/清理命令**立即释放名额**（此前须等 5 分钟保留期淘汰），
-  「停止现有后台命令来执行新的」当场兑现；对已终态条目即清理占位，终态与输出不改写；
-  重复停止同一条目经磁盘记录幂等返回，「重置状态」重试不报错；
-- 每次 Bash 命令结果新增 `remainingBackgroundCommandSlots` / `backgroundCommandLimit`
-  （当前可执行的后台命令数），agent 随时可见剩余名额，提前腾位不再盲跑撞墙。
-
-### 修复：休眠唤醒在时间线上始终有「休眠恢复」凭证
-
-唤醒时按进度摘要接续上下文的三条路径此前在时间线上完全无卡片——`importTranscript`
-重放失败（降级摘要通道）、旧构建 runtime 不支持重放、休眠时仅存下摘要（无完整记录）。
-用户无法区分「唤醒了」和「全新启动」。本次适配层在带休眠上下文启动但正常重放卡片
-未发出时，自动补发一条「休眠恢复」兜底卡片（`transcript-replay-fallback-*`），
-文案按实际通道区分「重放未完成，已按进度摘要接续」与「已按进度摘要接续」。
-
-### 修复：机器级操作伪 agent 归属未登记时自动自愈，「AI 配置选中后立即回弹」
-
-`machine-*` 伪 agent（机器级管理操作如应用 AI 配置、工具安装）的目录可能早于多租户
-归属改造创建而没有 owner.json，归属校验 fail-closed 会让这类请求永久 403——前端表现为
-「AI 配置选中后立即回弹为未选择」。本次对**归属从未登记**的 `machine-*` 伪 agent 首次
-触达时按当前权威 scope 自动登记（登记后放行）；已登记归属（本人或他人）与真实 agent
-实例不适用自愈，他人实例仍 403，归属变更只能走受信入口。
-
-### 修复：插件卸载后不再「复活」，并发部署/移除不再互相覆盖
-
-共享插件清单此前是整表读-改-写：卸载写在旧快照上会把遗留层同名条目原样带回（卸载的
-插件下次部署对账时复活），并发部署与卸载互相覆盖丢改动。本次清单写入改为合并视图保真：
-
-- 卸载在遗留只读层仍登记同名条目时写入**移除墓碑**压制复活，展示/运行时链接/对账
-  一律走过滤墓碑后的活动视图；重新部署同名插件时整条替换墓碑自然清除；
-- 读-改-写持有 manifest 锁，并发部署/移除串行化，墓碑不再在写回时丢失；
-- 部署条目 `zipFile` 缺失时按空串消毒，不再抛异常。
-
-### 新增：崩溃自动休眠——运行上下文落盘保护，中断后下次启动自动接续
-
-运行中实例崩溃（进程死/机器睡/bridge 被杀）此前上下文全丢——对话只存在进程内存里。
-本次为 acode 实例引入休眠 journal（`~/.acode/hibernation/{agentId}.json`，与待办同区）：
-
-- **运行中节流落盘**：每个 turn 结束（≥10s 间隔）+ 长 turn 期间每 30s 由存活看门狗
-  补写一次完整对话与 token 用量；崩溃后磁盘上自然留存最近一次现场（可能丢最近几条）；
-- **启动自动接续**：启动时若 Java 未下发休眠快照且本机 journal 存在，自动重放上下文，
-  并在系统块最后注入中断提示（「遇到中断导致你进入了休眠，部分工作状态可能已经丢失，
-  请继续工作！」）；时间线先落「休眠唤醒中」卡，重放成功后出现「休眠恢复」卡；
-- **干净退出收尾**：正常停止/批量停止/bridge 优雅关闭在终止前做一次 clean 完整落盘
-  （零丢失）；`/runtime/stop` 新增 `discardContext` 参数，true 时删除 journal
-  （用户显式选择「停止（丢弃上下文）」）；journal 默认保留 7 天，启动时清扫超期文件。
-
-## v1.9.183
-
-_发布日期：2026-11-02_
-
-### 调整：voice 结果新增 protocol，agent 可感知情绪指令是否真的生效
-
-云端 TTS 现支持双 OpenAI 兼容协议：`/audio/speech`（CosyVoice2 等，指令级情绪）与
-`/chat/completions`（MiMo 等对话式音频输出，协议限制不支持情绪指令——指令会被当正文
-念出来）。两者的差异 agent 此前无法感知，`voice.emotion` 恒回显请求值，容易误以为
-情绪已经传达。
-
-- 发送工具结果 `voice` 新增 `protocol` 字段：`speech`（指令级情绪生效）/
-  `chat`（暂不支持情绪指令）/ `local`（本地兜底，仅语速与停顿）；
-- `voice` 新增 `emotionApplied`：情绪是否真实作用于本条语音的最终事实
-  （chat 与 local 为 false）；
-- `voice.emotion` 参数说明改为按 protocol 区分语义，agent 发送后即可判断
-  「这条语音到底有没有带上情绪」；
-- 会话 profile 注入全局提示词的语音能力说明由服务端按当前配置实时生成
-  （协议状态、字数上限、emotion 是否生效），agent 会话创建即知道能力边界，
-  不依赖工具描述里的静态说明；配置中途变更由逐条发送结果自我校正；
-- 语音消息载荷（`voice.protocol`）同步写入，前端/排查可定位音质来源；
-- 协议类型由站点「语音合成」配置显式指定（speech/chat），不再按接口路径猜测。
-
-## v1.9.182
-
-_发布日期：2026-11-01_
-
-### 新增：配对成功即生效，无需重启 Bridge
-
-`awsb pair` 成功写盘后，CLI 会调用本机运行中 Bridge 的回环端点
-`POST /runtime/pair-applied`，让它立即用磁盘上的最新配置重新注册并重建隧道。
-此前配对只写盘、长期运行的 Bridge 只在启动时注册，不重启就永远显示「隧道未连接」。
-
-- 端点只认回环来源（与 `/binding/request-token` 同口径），并做单飞防抖：
-  上一轮注册未结束时直接复用，不会并发跑两趟 autoRegister；
-- 立即应答、注册在后台进行（含重试可能耗时数秒），面板「等待连接」轮询如实反映结果；
-- Bridge 未运行（首次安装尚未启动服务）或是旧版本（404）时通知静默失败，
-  CLI 回落为原有的 `awsb service restart` 提示。
-
-### 修复：transcribe_voice 工具有声明无分发
-
-`aws-client-agent-mcp` 早已声明 `transcribe_voice` 工具，但 `mcp-server` 的分发
-分支漏接，调用一律落到 Unknown tool。ASR 推理在服务端容器执行，这里补上
-`callAgentScopedTool` 转发（自动注入 agentId），agent 侧语音复听/转写校验恢复可用。
-
-### 调整：voice.emotion 说明对齐云端指令级情绪
-
-工具描述从「只影响语速与句间停顿」改为区分链路：云端合成按自然语言指令真正
-改变语气（开心/兴奋/平静/低落/郑重），本地兜底只有语速与句间停顿。
-
-## v1.9.181
-
-_发布日期：2026-11-01_
-
-### 修复：插件等用户路由 403（agent-ownership-mismatch）
-
-`requireUserScope` 的解析优先级纠正：validateToken 已按凭据
-（connectionKey / runtime token）解析出的 `req.userScope` 必须原样保留，
-不再被请求头/体无条件覆盖。此前有两个问题：
-
-1. 携带合法凭据、但没带 `X-Tenant-Id` / `X-User-Id` 头的服务端调用
-   （如调度中心的插件代理）会被降级成 binding.json 的本机用户
-   `{tenantId:"_local"}`，与实例 owner.json 登记的真实归属永不相等，
-   `requireAgentOwnership` 一律拒绝——表现为插件面板一打开就报 403。
-2. 更严重的是「凭据决定的权威 scope」可被「请求自称的 scope」替换，
-   伪造请求头即可跨 target / 跨租户写入别人的用户命名空间。
-
-现在头/体身份仅服务于「无 target 凭据」的本机面板 / MCP 子进程链路，
-凭据解析出的 scope 拥有最高优先级。
-
-配套调度中心侧：`PluginProxyController` 发往 bridge 的代理请求补注
-`X-Tenant-Id` / `X-User-Id`（按 agent owner，与 RuntimeBridgeService
-同口径），本机面板/子进程链路不再缺身份头；插件面板错误提示优先透出
-bridge 返回的真实原因，不再被 "Request failed with status code 403"
-之类的 HTTP 概括语吞掉。
-
-## v1.9.180
-
-_发布日期：2026-11-01_
-
-### 功能：累计消耗 token（从 Agent 启动起）全链路
-
-此前面板只有「当前上下文」口径的输入/输出 token（覆盖式，压缩/清空会回落），
-没有「从启动到此刻一共烧了多少」的累计口径。本次打通 runtime → adapter →
-调度中心的全链路：
-
-1. **acode runtime 累计消耗**：新增 `totalInputTokens` / `totalOutputTokens`
-   累计字段（Σ 各次请求 provider 真实上报的 prompt/completion tokens，输入含
-   缓存命中），跨迭代、跨 turn 只增不减，压缩/清空不影响；与缓存命中计数同
-   口径——只累计真实上报值，文本长度兜底不计入，压缩摘要 LLM 请求（独立
-   fetch）不计入。`turn_complete` / `iteration_usage` 的 usage 覆盖式携带累计
-   快照，前端无需自行累加。
-2. **休眠唤醒跨快照延续**：休眠导出的 tokenUsage 快照（含累计与缓存四字段）
-   由调度中心落库，唤醒启动时经 `resumeTokenUsage` 回灌，runtime `start()`
-   重建 state 时以 `config.initialTokenUsage` 为累计初值——唤醒后继续累计而非
-   清零。普通启动缺省从 0 起；旧快照（无累计字段）按无 seed 处理，不阻断启动。
-3. **adapter / 终端路由透传**：`toUsage` 逐字段解析累计值（独立于 0/0 丢弃与
-   fallback 判定，不参与文本长度兜底）；`totalUsage` 字段级 presence 覆盖
-   （旧版 runtime 不带累计字段时保留现值，不清零不回落）；`resolveStatusChangeUsage`
-   在 input/output 为 0（如 seed 后、首个请求前）但累计已有值时也照常传出。
-   `getTotalUsage`（休眠导出通道）一并带出累计与缓存快照。
-
-配套调度中心侧：状态回调透传累计字段、AgentContextPanel 新增「累计消耗」区块、
-休眠快照表补列（cache_hit/miss + total_input/output tokens）。
-
-### 修复：唤醒请求的累计 token seed 解析
-
-`parseResumeTokenUsage`（与 `parseResumeTranscript` 同模式）只接受四个累计字段，
-非法/缺失字段丢弃、全部非法返回 undefined（累计从 0 起，不阻断启动），
-JSON 文本异常不会让唤醒流程失败。
-
-## v1.9.179
-
-_发布日期：2026-10-27_
-
-### 修复：注册成功后立刻拆掉自己的隧道并退出进程
-
-现象：日志依次出现「隧道客户端已启动」→「目标已不在配置中，停止旧隧道」→
-「未捕获异常: {}」→ 优雅关闭 → 注销实例。机器明明注册成功却连不上。
-
-三个叠加缺陷：
-
-1. **`instanceId` 预声明用了对象展开重绑定**（`config = {...config, instanceId}`）。
-   `autoRegisterAll` 用同一个 `config` 对象数组构造隧道「保留集」，重绑定后外层
-   仍持有旧对象，后续补上的 `credentialId` 传不出去。
-2. **`credentialId` 同样只改了局部变量**。于是一边按 `credentialId` 启动隧道、
-   一边按 `userKey 指纹` 计算保留集，键不一致 → 刚建的隧道被判定为「已不在配置
-   中」而拆除。两处均改为原地写回。
-3. **`teardownConnection` 先 `removeAllListeners()` 再 `close()`**。对仍在
-   `CONNECTING` 的 socket 调 `close()`，`ws` 会异步 emit `'error'`
-   （"WebSocket was closed before the connection was established"）；此时已无任何
-   error 监听，EventEmitter 把它抛成未捕获异常 → 进程级 `uncaughtException` →
-   整个 bridge 优雅关闭。现在保留一个忽略用的 `error` 监听。
-
-### 修复：未捕获异常日志只打印 `{}`
-
-`Error` 的 `message` / `stack` 是非可枚举属性，`JSON.stringify(error)` 只得到
-`"{}"`，此前根本看不出崩溃原因。日志格式化现在显式展开
-`name [code]: message` 与 `stack`。
-
-### 代码质量：lint 全量清零
-
-`npm run lint`（`eslint src --max-warnings 0`）从 89 error / 34 warning 降到 0 / 0：
-清理未使用导入与变量、修正 `import/order` 与重复导入；测试文件中的非空断言
-（`!`）按惯例在 eslint 配置里对 `**/*.test.ts` 放宽，避免为消除告警引入无意义判空。
-
-## v1.9.178
-
-_发布日期：2026-10-27_
-
-### 目标身份升级为 `credentialId`：轮换 Key 不再断链
-
-上一版用 `serverUrl + userKey 指纹` 作目标身份，解决了同址多账号并行；但**轮换
-API Key 会改变指纹**，导致 runtime token、隧道、注册状态、instanceId 全部重新开始
-（表现为换 Key 后 agent 找不到实例）。本版把身份锚点换成服务端下发的稳定凭据 ID：
-
-- `config.json` 的 target 新增 `credentialId` / `credentialType`，注册成功时由
-  服务端回填并持久化（与 instanceId 同一条回写路径）。
-- `targetKeyOfConfig` 改为 `buildTargetKey(serverUrl, credentialId ?? userKey)`：
-  有 credentialId 时身份不随 Key 变化；旧配置无该字段时仍回退 userKey 指纹，平滑迁移。
-- runtime token 存储、隧道槽位、注册重试、instanceId 反查统一用
-  `identityKeyOfConfig(config)`（credentialId 优先）。
-- **删除隧道鉴权的 userKey 兜底**：此前取不到 runtime token 时会把 userKey 当
-  token 发出去，服务端只认 hash 匹配必然 401，却掩盖了「未注册/注册失败」的真实
-  原因。现在明确报错并提示重新注册。
-
-### 同一调度中心地址支持多账号/多租户并行注册
-
-（承接 v1.9.177）身份模型继续保证：同一 `serverUrl` 下不同凭据各自独立隧道、
-独立 runtime token、独立 instanceId，互不覆盖。
-
-## v1.9.177
-
-_发布日期：2026-10-26_
-
-### 同一调度中心地址支持多账号/多租户并行注册
-
-同一用户加入多个组织（租户）时，同一台机器往往需要连接**同一个调度中心地址**、
-但使用**不同的 API Key** 各自注册一个实例。此前桥内以归一化 `serverUrl` 作为唯一
-身份键，同址两行会互相覆盖（隧道被拆、runtime token 串用、instanceId 写乱），
-面板因此直接拒绝保存第二行。
-
-本次把桥内身份模型从「地址」升级为「目标身份」＝ `归一化 serverUrl + userKey 指纹`：
-
-- 新增 `utils/target-identity`：`buildTargetKey(serverUrl, userKey)`，形如
-  `http://host:port#a1b2c3d4`（sha256 前 8 位，不落明文；可读、可作 properties 键）。
-  地址归一化（尾斜杠/协议大小写/`ws→http`/`localhost→127.0.0.1`/重复端口）抽到
-  `utils/scheduler-url`，由 `config`、`runtime-binding`、`target-identity` 共用一份实现。
-- **runtime token 存储**：`runtime-tokens.properties` 的键由 `md5(serverUrl)` 改为
-  目标身份键，同址多账号各存各的 token。旧键自动兼容读取；未指定 `userKey` 且该地址
-  只有一个身份时仍可命中（单目标老调用点无需改动），多身份时必须显式指定，避免串用
-  别的账号 token 造成「注册成功但回调 401」。新增 `listScopedRuntimeAccessTokens`。
-- **隧道**：`tunnels` Map 改按目标身份键控；同址不同账号各自一条隧道并存。
-  新增 `stopTunnelClientForTarget(serverUrl, userKey)` 精确停止单个身份；
-  `stopTunnelClientsExcept` 改为接收身份键集合；`stopTunnelClientForServer` 保留，
-  语义改为「停该地址下所有账号」。
-- **注册状态**：`registrationState.registrations` 键改为目标身份键，instanceId 互不覆盖；
-  新增 `resolveInstanceIdForTarget`。注销只清理本身份的 token/隧道/记录，其余身份保持注册。
-- **instanceId 回写**：只回写与本次注册身份匹配的那一行（此前按地址会把所有同址行写成
-  同一个 instanceId）。
-- **注册重试**：后台重试定时器按身份键去重，同址两个账号各自独立重试。
-- **面板去重规则**：由「同址即重复」改为「同址 + 同一 API Key」才是重复；同址不同 Key
-  属合法配置。去重校验移到「继承原配置」之后，因为编辑行留空 userKey 时真实身份要等
-  继承完成才确定。
-- **面板交互**：列表每行显示 API Key 掩码与租户 ID，便于区分同址多行；编辑行新增
-  `originalTargetKey` 精确指代被编辑的那一行（同址多行时仅靠地址无法定位），两行都留空
-  userKey 时按写入顺序逐条认领旧身份继承。
-- **目标解析**：`resolveSchedulerBaseUrlFrom` 返回值新增 `userKey`；歧义判定改用
-  「目标身份数量」而非「去重后 URL 数量」——否则同址多账号会被误判为单目标而静默选中
-  其中一个账号。新增 `resolveTargetIdentityFromToken` 按 token 反查身份（含地址与
-  userKey），供入站回调确定该用哪个账号的凭据。
-
-> **兼容**：单地址单账号的既有配置行为不变；旧 token 文件（md5 键）继续可读。
-> 无需改动 `config.json`。
-
-## v1.9.176
-
-_发布日期：2026-10-25_
-
-### 工作区代码导航：语言服务 + 语法索引兜底
-
-- `/ws/lsp` 从「仅 TypeScript 单进程」升级为多语言模型：按
-  `工作区 + provider + clientId` 隔离进程，同一会话内跨文件复用；不同浏览器
-  标签/面板使用不同 `clientId`（tsserver、pyright 都不支持多客户端共享文档状态）。
-  进程池设并发上限（`AWS_LSP_MAX_PROCESSES`，默认 6）并按最久未用淘汰，断连后
-  保活 60s 供快速重连复用。
-- 新增 provider 注册表（`services/lsp/provider-registry`），覆盖 15 个语言服务：
-  TypeScript/JavaScript、Vue、Python、JSON、CSS、HTML、YAML、Bash、Dockerfile、
-  PHP、Java、Go、Rust、clangd、C#、Ruby。按扩展名推断 provider，统一
-  `languageId` 归并与启动参数拼装；新增 `services/lsp/uri-rewrite` 处理客户端与
-  服务端路径形态差异（Windows 盘符大小写、`file://` 编码）。
-- 新增 `GET /runtime/lsp/providers`、`POST .../install`、`POST .../uninstall`、
-  `GET .../task/:id`、`GET /runtime/lsp/processes`：npm provider 按需安装到
-  `.aws-bridge/lsp-servers`，安装进度可轮询，进程列表供排障。
-- 新增工作区语法索引（`services/workspace-index`）：以 tree-sitter 抽取声明与
-  导入，覆盖 12 种语言（TypeScript/JavaScript、Python、Go、Rust、Java、C、C++、
-  Ruby、PHP、Lua、Bash），提供定义/引用/符号/大纲查询。LSP 不可用时前端回退到
-  该索引，不因语言服务缺失而失去跳转能力。端点挂在
-  `/api/workspace-index/{status,build,query,drop}`，索引随工作区切换释放。
-
-> **兼容**：旧前端只带 `file`/`language`（无 `provider`/`clientId`）时按扩展名
-> 推断 provider、`clientId` 视为 `default`，行为与历史版本一致。
-
-### 桌面控制人工治理：急停与动作审计
-
-- 新增 `POST /runtime/desktop-control/:agentId/pause`（急停/恢复）与
-  `GET .../state`（控制状态 + 最近动作审计）。急停后所有 `desktop_*` 工具
-  一律拒绝（含读类），并产生 `rejected` 事件而非静默失败。
-- 动作事件流：`desktop_*` 调用映射为 `started`/`done`/`error`/`rejected`
-  四态事件，按 agent 维护 100 条环形审计缓冲，经远程桌面 WS 实时推送，
-  每个 agent 独立自增 `seq` 供前端排序与去重。
-- **坐标陈旧性校验**：截图成功后记录「坐标依据」（截图文件 + 时刻 + 可重放参数）；
-  带坐标的动作执行前，若依据超过 `AWS_DESKTOP_STALE_WARN_MS`（默认 60s），
-  用记忆参数重截一次并做内容比对——画面已变则在结果尾部追加警告（不阻断，
-  LLM 读到后自行重截），未变则静默刷新依据时刻。5s 内结果缓存，连续动作不重复校验；
-  sharp 不可用/截屏失败时退化为时间戳警告（安全方向）。
-- 状态为进程级内存态：Bridge 重启即自动解除急停（重启本身会终止桌面 MCP，
-  等效急停，无需持久化）。
-
-### 桌面安装包 sidecar 模式
-
-- 新增 `AWS_BRIDGE_APP_MODE=desktop` 与 `AWS_BRIDGE_LISTEN_HOST`：桌面态只监听
-  回环，不暴露局域网；未显式配置注册地址时默认走隧道（回环地址对外不可达）。
-- 端口探测改为「探测形态 = listen 形态」：指定 host 时只探测该 host，避免把
-  「别的进程占了通配、但 127.0.0.1 仍可绑定」误判为冲突导致端口无谓顺延。
-- 未设置这两个变量时行为与既有一致（通配绑定、服务器部署语义不变）。
-
-### Bridge 面板
-
-- 面板 HTML 拆分为独立模块（`routes/dashboard-theme`、`routes/dashboard-icon`），
-  主题令牌与图标不再内联在巨型模板字符串里，便于维护与复用。
-
-### 子 Agent 与工具组
-
-- `SubAgentManager` 等待结果时，store 查询失败不再让该项从结果中静默消失：
-  超时后按 `settled` 集合补报未终态项，避免「部分子 agent 结果莫名丢失」。
-- 工具组：新增命名分组与 `tools/list` 名称对齐校验（`named-group-tool-names-alignment`），
-  防止分组配置与实际暴露的工具名漂移。
-- `aws-client-agent-mcp` 补齐邮箱工具组（`send_email`/`list_emails`/`read_email`/
-  `reply_email`/`ack_email`）与 `list_project_members` 的转发分支，全部经
-  `callAgentScopedTool` 注入 agentId（防越权）。
-
-### 发布链路修复
-
-- **修复 `npm publish` 被自身守卫误拦**：`verify-dist-minified` 原先用
-  `code.includes("/**")` 判断「未混淆」。但本仓库把 HTML/CSS/内联脚本放在模板
-  字符串里（`DASHBOARD_HTML`、`THEME_CSS`），压缩后字符串内的 `/** ... */`
-  会原样保留（那是要发给浏览器的页面源码，不是 JSDoc），导致
-  `dist/routes/dashboard.js` 被误判并直接阻断发布。
-  新增 `scripts/source-comments.mjs`，基于 TypeScript AST + 字面量区间排除
-  判定「代码区注释」；`minify-dist.mjs` 的 .d.ts 注释剥离同步切到同一口径，
-  避免「剥干净了却仍被判为脏」。守卫对真实未压缩文件仍然拦截（已验证）。
-
-> **验证**：`npm run typecheck` 与 `npm test` 通过（137 files、1915 passed、
-> 3 skipped）；`npm pack` 端到端通过（780 files / 6.6MB，postpack 正确还原）。
-> 新增/覆盖 `workspace-index`、`provider-registry`、`uri-rewrite`、`lsp`、
-> `desktop-control`、`desktop-staleness`、`desktop-mode`、`sub-agent-manager`、
-> `named-group-tool-names-alignment`、`mcp-tools` 等用例。
-
-## v1.9.175
-
-_发布日期：2026-10-23_
-
-### 技术栈自动识别：扫描工作区生成启动项候选
-
-- 新增端点 `POST /runtime/tech-stack/scan`（body `{ workspacePath }`）：只读扫描
-  工作区标记文件，返回可直接创建的启动项候选（名称/类型/命令/工作目录/依据）。
-- 识别范围：`pom.xml`/`build.gradle(.kts)`（Spring Boot 走 `spring-boot:run`/`bootRun`，
-  有 wrapper 优先 `mvnw`/`gradlew`）、`package.json`（按 `pnpm-lock.yaml`/`yarn.lock`/
-  `bun.lockb` 推断包管理器，脚本按 dev>develop>serve>start 取）、`manage.py`、
-  `pyproject.toml`/`requirements.txt`（FastAPI 出 `uvicorn main:app --reload`，
-  uv/poetry 项目自动加 `uv run`/`poetry run` 前缀）、`go.mod`（根 `main.go` 出
-  `go run .`，否则展开 `cmd/*/main.go`）、`composer.json`（Laravel `php artisan serve`、
-  Symfony `php -S localhost:8000 -t public`），以及 `Cargo.toml`/`deno.json`/
-  `docker-compose.yml` 兜底为 generic。
-- 遍历全层级且尊重 `.gitignore`（规则引擎抽到 `services/gitignore.ts`，与文件浏览器
-  目录树共用同一实现）；依赖/构建/版本库目录（`node_modules`/`target`/`dist`/
-  `.venv`/`.git` 等）恒跳过。目录预算 4000，超限返回 `truncated` 并保留已识别结果。
-- 命中标记文件才读内容，单文件读取上限 64KB；候选 id 为「相对目录+技术栈+命令」
-  的稳定哈希，重复扫描结果一致。
-
-> **验证**：bridge `npm run typecheck` 通过；新增 `tech-stack-scanner.test.ts`
-> （16 passed）覆盖 Spring Boot/wrapper 平台分支、Maven 回退、Node 包管理器推断、
-> monorepo 子包、Django/FastAPI/uv 前缀、Go 单入口与 `cmd/*` 展开、Laravel/Symfony、
-> Cargo 可运行 crate 判定与 lib crate 排除、compose 兜底、.gitignore 排除、
-> 同目录多栈、id 稳定性。
-
-### Git 提交历史分页与快照保留策略
-
-- `POST /runtime/git/commits` 支持 `skip`/`limit` 分页：新增 `resolveCommitPageLimit`
-  / `resolveCommitPageSkip` / `sliceCommitPage`，一次抓取多取一条用于判定 `hasMore`，
-  避免整段历史一次性返回；保留不传 `skip` 的旧单页响应形状。
-- 全分支图按 `--branches --remotes --tags` 收敛引用范围，内部引用（如 cline
-  checkpoint）不再混入提交图；detached HEAD 通过显式 revision 保留。
-- 新增工作区快照保留策略（`snapshot-retention`）：默认不清理，面板下发保留天数后
-  按 mtime 删除过期快照；与 change-cache 复用同一节流（写缓存时 1h + 24h 兜底扫描），
-  配置变更立即执行一次。面板显式下发的值不会被迟到的 `config.json` 覆盖。
-
-### 终端与隧道稳定性
-
-- 隧道请求体分帧：请求体超过单帧上限（2MB WS 文本帧）时，server 改为 `req` 头帧
-  + `reqchunk` 数据帧 + `reqend` 收尾，bridge 侧按 id 归集拼装后转发本地服务；
-  半包请求带 5 分钟空闲超时，连接断开时清理残留缓冲。
-- 终端 SDK 作答/取消：新增取消作答链路（含可选原因），与回答共用幂等与回执；
-  `compaction_summary` 走独立推送通道，不进 `sdkOutputQueueBySession` 串行队列，
-  摘要流与主输出流互不阻塞。
-- 修复时间线重复卡片：仅刷新用量的 `status-change`（`iteration_usage` 等）不再
-  重放上一次 `ai_request` 动作；抽为 `isUsageOnlyStatusChange` 便于单测覆盖。
-- 终端「等待输入」判定抽到 `lastOutputLine` + `listWaitingForInput`：只取输出末行
-  做启发式匹配，纯读不消费输出游标，供压缩后重建资源快照给出「哪些终端卡在提示符上」。
-
-### Bridge 面板
-
-- 仪表盘时间统一按面板当前语言（中/英）与浏览器本地时区渲染，修复切换语言后
-  日期仍按系统语言、以及直接切 ISO 字符串导致显示 UTC 挂钟值的问题。
-- 自更新前增加确认弹窗，明确「更新会重启 Bridge、运行中的实例会停止、进行中的
-  任务会中断」。
-
-> **验证**：`npm run typecheck` 与 `npm test` 通过（130 files、1827 passed、
-> 6 skipped）；`git-commits-page.test.ts`（4 passed）、`tech-stack.test.ts`、
-> `snapshot-retention.test.ts`、`tunnel-client.test.ts`、`terminal.sdk-answer.test.ts`
-> 均通过。
-
-## v1.9.174
-
-_发布日期：2026-10-21_
-
-### 私信附件「存到对方机器」：bridge 临时文件通道
-
-- 新增 bridge 临时文件通道：上传的文件直接落到**接收方实例所在机器**的
-  `<系统临时目录>/aw-temp/ATT/YYYYMMDD/{uuid}{扩展名}`，服务端不落盘，
-  按天归档并在写入时顺带清理超过 7 天的旧目录。
-- 新增端点：`POST /api/bridge-temp-files/upload`（multipart 上传）、
-  `POST /api/bridge-temp-files/read`（按绝对路径读回字节）、
-  `POST /api/bridge-temp-files/delete`（删除临时文件）。
-- 落盘文件名用 uuid 而非原始文件名（原始名只回传展示，规避文件名注入）；
-  扩展名由原始名清洗而来，保留原扩展名便于 agent 判断读取方式。
-- 回传路径统一为正斜杠：Windows 的 `path.resolve` 接受正斜杠，跨平台一致，
-  且正文标记进 JSON 载荷时不会被反斜杠转义弄乱。
-- 修正 multipart 文件名在部分代理链路被 latin1 解读导致的中文乱码
-  （与工作区上传同一口径）。
-- 读/删接口做路径越界校验：只允许访问 `aw-temp/ATT` 目录树内的文件，
-  越界与不存在统一返回 404，不向调用方泄露目录结构。
-- 上传超限（>512MB）返回 413 与明确错误码，不落成 HTML 500。
-
-> **验证**：bridge `npm run typecheck` 通过；新增 `bridge-temp-files.test.ts`
-> （10 passed）覆盖上传落盘/扩展名保留/读回/越界 404/删除/正斜杠跨平台往返。
-## v1.9.173
-
-_发布日期：2026-10-21_
-
-### 上下文压缩后补齐「运行时资源事实」，修复命令失忆
-
-- 压缩后重建的运行时资源快照新增「当前打开的文档」一类：画布（pencil）、
-  绘图（draw）、Office 文档各自登记**面板当前开着的那一份**。此前快照只列
-  「存在哪些文档」，压缩后 agent 不知道用户正看着哪份文档，容易重复 open
-  或对着已被取代的版本继续改。
-- 打开状态由 bridge 侧按 agentId 维护（`open-doc-registry`）：依据工具调用流
-  登记 / 清除，随会话结束清理；识别直调与收纳态 `call_tool` 中转两种形态。
-- 终端快照补「waiting for input」状态：停在 ssh 密码提示等交互提示上的会话
-  单独标出（判定只取输出末行，历史输出里的旧提示符不误判）。
-- 浏览器条目补 `browserId`：同 agent 可有多个独立 chromium 实例，缺 id 时
-  agent 无法分辨「已开的那一个」。
-- 修复两条漏掉重建快照的路径：`resetContext`（对话还原到启动基线但真实资源
-  并未消失）与休眠恢复 `importTranscript`（预压缩同样会丢弃资源事实）。
-
-- 修复「面板事件顺序与真实运行态相悖」：LLM 同一轮声明 `poll_message` + 兄弟工具
-  （如 `get_profile`）时，`call_tool` 事件原在**准备阶段**按声明序发出，但 blocking
-  工具会被调度器排到**批尾串行**执行 —— 于是 poll_message 的「调用中」卡片先落库、
-  实际先跑完的兄弟工具后落库，面板最后一条停在 `get_profile`，而 agent 正阻塞在
-  poll_message。现改为「工具真正开始执行时」才发 `call_tool`，事件顺序即真实执行顺序。
-- poll_message 阻塞期间新增**面板事件矫正**：以 runtime 内部的阻塞型调用计数
-  （`hasActiveBlockingToolCall`，经 bridge `GET /runtime/sessions/:agentId/current-action`
-  暴露）为权威判据。该判据是运行时事实、不经事件流派生，故不会被兄弟工具的完成
-  事件覆盖；发现权威状态与本地 tag 不一致时补发一次 poll_message 事件矫正面板，
-  并保留 30s 冷却避免刷屏。无法判定（查不到会话/查询失败/无阻塞调用在飞）时一律
-  不矫正，宁可保持现状也不凭猜测改写面板。
-
-> **验证**：bridge `npm run typecheck` 与 `npm test` 通过（123 files、
-> 1775 passed、2 skipped）；`package/acode` legacy 套件 175 passed / 0 failed、
-> vitest 828 passed。事件顺序修复另行验证：`package/acode` 新增
-> `call-tool-event-order.test.ts`（3 passed）、`aws-client-agent-mcp` 新增
-> 面板矫正用例（mcp-server 162 passed / 0 failed）、bridge `npm test`
-> 1775 passed / 0 failed。
-
-## v1.9.172
-
-_发布日期：2026-10-21_
-
-### 上下文压缩重构、提问取消作答与消息中心体验收敛
-
-- ACode 上下文压缩改为「高保真级联」统一策略（完整摘要 → 降级 → 截断），不再由
-  前端勾选压缩类别；移除 `compaction-preview` 与「先行压缩」配置弹窗，输入区入口
-  直接启用开关，压缩范围由运行时决定。
-- 压缩摘要改为流式上报：runtime 逐 chunk 发射 `compaction_summary`，bridge 按
-  120 字符 / 120ms 积攒后推送，时间线实时滚动展示；摘要正文不落库（bridge 本地
-  环 Buffer、per-agent 事件存储、Java 事件表与运行日志全部跳过），刷新后不复活。
-- 修复压缩摘要与思考卡片互相打断、摘要尾部落到压缩结束事件之后、长摘要不跟随
-  滚动的问题；压缩摘要使用独立琥珀色卡片样式。
-- 修复 token 用量显示：启动/恢复/压缩后的估算值与 provider 真实值用
-  `usageEstimated` 显式区分，真实 usage 变小时不再被 20% 启发式误判为 fallback；
-  provider 未上报 input tokens 时不再把上下文清零。
-- 修复时间线重复卡片：`iteration_usage` 等 usage-only 状态变更不再重放上一次
-  `ai_request` 动作；工具结果先于调用到达时不再覆盖已完成的同名工具卡片。
-- 支持「取消作答」：提问卡片新增取消入口与可选原因，Java / bridge / ACODE runtime
-  全链路解除 Agent 阻塞并把取消结果回传模型；回答与取消共用幂等与回执持久化，
-  刷新后展示「已取消」只读态。
-- `read_file` 图片 URL 读取：以魔数为权威格式判据（签名 URL 的
-  `application/octet-stream` 不再被误拒），发送最小浏览器请求头规避图床 403/406，
-  URL 只保留 origin+path 写调试日志；运行时提示明确「URL 直接读，不要先 curl 落盘」。
-- dashboard：消息通知弹层新增提示音开关（Web Audio 合成、首次手势解锁、静音持久化）；
-  桌面通知权限入口移至消息通知弹层；移动端弹框最小化新增「飞向收纳按钮」动画；
-  普通终端打开期间按钮转圈防重复点击；长文本粘贴统一转为 txt 附件；文件引用图标与
-  工作区文件树同源；引用图标视觉修正。
-- 邮件：新增 `imapInternalHost` / `smtpInternalHost` 等后端内网连接地址（留空回退
-  客户端展示地址），配置自检展示实际生效地址；compose 为 James 增加
-  `mail.<mailDomain>` 网络别名，避免容器经公网/NAT 回环；邮箱别名改用 James
-  typed alias 路由 `/address/aliases/{目标}/sources/{别名}`，修复旧路由稳定 404。
-- 消息协作：`send_dm` 的 `replyToCallId` 未命中调用式消息时降级为普通私信并回传
-  warning（不再静默丢内容）；自动关联 pending call 失败时同样降级发送。
-- 修复 `sendOutput` 在 `skipLocalPersist` 路径于 `finally` 中 `return` 吞掉异常，
-  导致上层重试队列收不到失败信号的问题。
-- 内置 `db_connect_client_mcp` 源码随仓库提交（能力市场包仍以 esbuild 单文件
-  bundle 发布）。
-
-> **验证**：bridge `npm run typecheck`、`npm test`（121 files、1747 passed、
-> 2 skipped）与 `package/acode`（827 passed）、`package/aws-client-agent-mcp`
-> （561 passed）测试通过；Java `mvn test`（2057 passed）通过；dashboard
-> `npm run lint`、`npm run type-check` 与全部 `test:*` 脚本通过。
-
-## v1.9.171
-
-_发布日期：2026-10-20_
-
-### 消息协作、邮箱别名、同事观察与日志治理
-
-- 消息中心：发送改为乐观上屏（本地「发送中」→ 服务端 `sent`），网络/5xx/429
-  自动退避重试 3 次，失败气泡保留并支持「重试 / 编辑」；WS 回显按发送者+正文+
-  时间窗认领本地待发气泡；私信/群聊发送携带客户端幂等键，服务端按
-  `(sender, clientMessageId)` 去重，HTTP 响应丢失后的自动重试不会产生重复消息。
-- 群聊支持 @所有人（后端展开为房间/项目实际成员，提及记录与未读口径一致）、
-  结构化引用提醒（回表校验被引用消息作者，拒绝客户端伪造 `senderId`），并补充
-  引用提醒系统通知。
-- 新增角色实例邮箱「人类只读查看」（收件箱 / 已发送 / 详情，不改变 IMAP 已读
-  状态）与邮箱别名设置；别名更新改为「先建新远端映射、再删旧映射」，任一步失败
-  不会让旧别名提前失效，失败时补偿恢复远端状态。
-- 同事协作：`get_colleague` 增加在线状态、当前动作、工作区路径与邮箱概要；
-  新增 `list_colleague_events` 分页查看同事行为时间线（摘要视图，剥离工具输入/
-  结果原文），由 `collaboration.agentObserve` 能力开关控制（默认收纳）。
-- ACode 收口：AI 配置 / MCP 模板 / 终端 CLI 仅保留 ACode，移除 ClaudeCode、
-  Codex、OpenCode 的配置入口与文案。
-- 修复：`RuntimeBridgeService` / `RuntimeGlobalSettingsService` 保存 MCP 时补回
-  `instantiate` / `packageUrl` / `packageSha256` 字段，避免包型 MCP 初始化丢失。
-- 修复：清空角色实例邮箱别名改为显式 `SET address_alias = NULL`（MyBatis-Plus
-  `updateById` 会忽略 null 字段）；恢复心跳超时后的 Agent 异常离线告警。
-- bridge 日志治理：新增统一日志保留策略（lifecycle、MCP 子进程、AI 配置调试
-  日志，最长保留 7 天），启动即清理 + 每 6h 周期清理，面板下发值夹取到 1..7 天；
-  Java Debug 日志清理同步收敛为最长 7 天。
-- bridge 启动记忆加载抽为独立服务并复用；provider 请求体非法（确定性 4xx）时
-  落盘完整对话上下文快照（去重 + 保留最近 20 份），便于事后复现工具调用配对问题。
-- dashboard 接入标签页未读标题 / PWA 应用角标；页面隐藏时按私信、群聊 @、系统
-  通知弹桌面通知（同会话 4s 合并、点击跳转会话），权限申请放在个人菜单。
-
-> **验证**：bridge `npm run typecheck` 与 `npm test` 通过
-> （120 files、1724 passed、2 skipped）；Java `mvn -q test` 通过；
-> dashboard `npm run lint`、`npm run type-check` 与 99 个 `test:*` 脚本
-> 全部通过。
-
-## v1.9.170
-
-_发布日期：2026-10-17_
-
-### 能力市场与插件运行时落地，并发一致性与调试挂载修复
-
-- 新增能力市场：Java 侧 `AbilityMarketService` / `AbilityMarketController` 提供
-  模板上架、安装、卸载与“我的能力”清单，安装态以 `RuntimeGlobalSettings`
-  全局设置持久化；bridge 侧配套能力市场工具与 MCP 包探测、部署链路
-  （`mcp-package.ts`、`mcp-probe-client.ts`、`ability-market-tools.ts`）。
-- bridge 插件体系重构为 manifest / loader / runtime / listener-runner 分层，
-  统一插件清单校验、持久化目录部署与监听器生命周期，并补充插件开发指南与
-  插件系统设计文档。
-- dashboard 新增能力市场管理页与安装弹窗（含环境变量占位符校验）、Agent 状态
-  重置与上下文压缩弹窗，会话操作菜单抽取为 `chat-message-actions`。
-- 新增调试挂载（debug-mount）能力：会话建立时按需挂载调试资源，会话销毁
-  （含 SDK 会话清理各出口）统一调用 `clearDebugMounts`，避免残留。
-- 修复：`AbilityMarketService` 安装 / 卸载回滚快照在同一写锁内捕获，消除并发
-  写下的回滚竞态；`mcp-deploy` 增加名称合法性校验（拒绝 `.`、`..` 与非 basename）
-  并改用原子 rename 交换，清单 `fileName` 以实际下载文件名为准。
-- 修复：插件部署仅在全部候选迁移成功时才清理旧 `shared/` 目录，legacy
-  `zipFile` 经 `sanitizeArchiveFileName` 收敛，重命名失败不再误删目标目录；
-  插件处理器在启用 shell 且命令含 `{{...}}` 插值时改为 fail-closed 拒绝执行。
-- 修复：`package/acode` 运行时 `removeMcpServer` 同步清理 stderr 缓冲；手动
-  compact 优先级高于自动 `shouldCompact`，避免手动压缩计划被丢弃。
-
-> **验证**：bridge `tsc --noEmit` 与 `vitest run` 通过（1687 passed；仅
-> `src/browser/page-listener-nav.smoke.test.ts` 偶发 hook 超时，重跑通过，该目录
-> 未改动）；`package/acode` `tsc --noEmit`、`runtime.test.ts` 与 `compaction.test.ts`
-> 通过；Java `mvn compile` 通过，`AbilityMarketServiceTest`（31）、
-> `RuntimeBridgeServiceTest`（79）通过；dashboard `npm run lint`、`npm run type-check`
-> 以及 i18n / ability-market / dialogQueue 相关测试通过。
-
-## v1.9.169
-
-_发布日期：2026-10-12_
-
-### 多语言与消息协作增强，环境变量、邮箱与流程线能力整合
-
-- dashboard 接入 `vue-i18n`，提供简体中文与英文的自动识别、持久化、运行期切换
-  和 Element Plus 文案联动，并补充完整开发指南与语言资源测试。
-- 消息中心补齐消息复制、引用流、附件下载与反馈队列体验；能力范围、时间线顺序、
-  浏览器面板适配和会话分组等交互稳定性同步收敛。
-- dashboard 侧接通项目 / 角色 / Agent 三层环境变量配置、能力开关与邮箱管理界面，
-  并补充项目关系图导入、流程线交付物下载 / 回放 / 指派标签等能力。
-- bridge 启动测试统一跨平台命令进程 PID mock 输出，稳定 Linux CI 端口探测时序，
-  避免发布流水线因平台差异产生偶发失败。
-- 更新 Docker Compose 与邮箱部署、跨项目角色冲突、环境变量分层等文档。
-
-> **验证**：dashboard `npm run lint`、`npm run type-check` 与 `npm run build` 通过；
-> dashboard 新增 34 个测试脚本全部通过；bridge `npm test` 通过
-> （114 files、1621 passed、2 skipped）。
-
-## v1.9.168
-
-_发布日期：2026-10-11_
-
-### 发版稳定性：测试兼容、任务通知与连接生命周期修复
-
-本版本主要为发版验证中暴露的兼容性与稳定性问题收敛，既有功能契约保持不变：
-
-- `aws-client-agent-mcp` 的 `initialize` 返回完整工具组清单，能力开关三态
-  （`disabled` / `collapsed` / `expanded`）契约与 Java 侧保持一致。
-- `pipeline_task_assigned` 的 `SYSTEM_NOTIFY` 与持久化任务通知增加强制任务域
-  hydrate，首次落空时自动重试，避免重启或长轮询窗口内遗漏流程任务。
-- `.agentswork` 记忆目录搜索增加项目根与 Git 仓库边界，避免相邻项目目录串用；
-  `MemoryStore` 增加 domain 写入缓存，修复大量 domain 场景测试超时。
-- WebSocket 手动断开与异步 token 刷新重连之间的竞态修复，断开后不再重新排程
-  重连，非 CLOSED 连接句柄会被终止。
-- `RuntimeBridgeService` 的 SSE 客户端改为首次使用时初始化；同步迁移版本数、
-  `reply_to` 测试 schema 与 Direct/Group Message 控制器测试签名。
-- 测试命令增加 Node 测试进程强制退出兼容项，确保 CI 收尾不被子进程管道句柄
-  阻塞。
-- 修复 Linux CI 启动项端口探测用例的 shell PID / 命令进程 PID 替换竞态，
-  避免发布流水线因平台进程发现时序产生偶发失败。
-
-> **验证**：Java 后端 `mvn test`（1873 tests）、bridge 根目录测试、ACode 测试与
-> `aws-client-agent-mcp` 测试全部通过；`npm run build:all`、`npm run build`
-> 和 `npm run typecheck` 均通过。
-
-## v1.9.167
-
-_发布日期：2026-10-07_
-
-### Word 格式管控：OOXML 版式底座 + 信任机制（自动备份 / 保护区域 / 报告聚合）
-
-面向「生成复杂排版文档并严格把控」这一目标，分两条线补强 office 工具链。
-Java 侧新增 3 个 OOXML 助手并扩展 5 个，bridge 侧补齐备份、参数透传与工具契约。
-
-#### 1. 写盘前自动备份（改坏了能回滚）
-
-`office_edit` / `office_format(fix)` / `office_apply_profile` / `office_generate_from_template`
-直接改写用户文档，此前改错只能靠事先手动 copy。现在覆盖写盘前自动留一份
-`<基名>-backup-<时间戳><扩展名>`，滚动保留最近 5 份；回执透出 `backupPath` + `backupHint`。
-**另存到已有文件**同样先备份（等价于覆盖）。备份失败不阻断写盘（磁盘满/权限异常时
-不带该字段）；只清理严格匹配时间戳命名的文件，不会误删 `报告-backup-未命名.docx` 这类同名文件。
-
-#### 2. 保护区域：封面/题注/代码块不被正文规则触碰
-
-规则新增 `exclude`（支持 `/body/p[1]-p[14]` 区间简写与 `{path/from/to/style/contains/role}` 对象）
-与 `excludeByRole`，**check 与 fix 同源生效**。`summary.excludedParagraphs` 透出命中段数。
-`office_format` 另提供顶层 `exclude` 便捷入口（preset 场景下也能一次排除封面）；
-实现上复制 rules 再写入，不原地修改 preset 共享实例（否则会污染后续所有调用）。
-
-#### 3. 三套规则系统打通：profile 可直接当 rules
-
-`office_view(mode=profile)` 的产物此前**无法**直接喂给 `office_format`——启发式识别出的
-角色其 `match` 为空对象，`RoleMatcher.matches()` 恒为 false 且不回落到内置判定。
-现空 `match` 回落内置启发式，并新增 `unmatchedRoles`/`unmatchedRolesHint` 显式报出
-「既无 match 又非内置角色名」的规则（此前这类规则静默失效，是「配了规则却没反应」的根因）。
-推荐链路：模板 `view(profile)` → `office_format(rules=profile, exclude=[封面范围], action=check)` → `action=fix`。
-
-#### 4. 报告可读性：106 条平铺 → 可定位
-
-- 每条违规新增 `textDigest`（段落文字摘要），不必再按 path 反查原文；
-- `summary.byRole`（按角色聚合降序）、`summary.paragraphs`（按段落聚合，含该段问题属性列表）、
-  `summary.topIssue`（一句话摘要）。
-- 阅读顺序：`topIssue` → `byRole` → `paragraphs` → 需要细节时再读 `violations`。
-
-#### 5. `office_format(action=dryRun)` 与 `office_view(paths=[...])`
-
-- **dryRun**：按 fix 逻辑算出将改哪些项，返回 `willModify` + `nextStep`，不写盘、不返回字节
-  （bridge 侧即使服务端意外带回字节也直接丢弃）。注意 dryRun **不产生 `converged`**——
-  未真正修正就不能声称收敛。
-- **paths**：段落白名单（`/body/p[7]`、区间 `/body/p[5]-p[11]`），仅对 `styles`/`profile`/`selfcheck`
-  生效。大文档（几百段）下排查局部时把返回量从整篇压到几段。`profile` 的 `page`/`numbering`
-  来自文档级部件仍按整篇提取；`selfcheck` 的 `pageNo` 仍为真实页码。无法解析的 `paths`
-  一律回退为「不过滤」，避免空结果误导。
-
-#### 6. OOXML 版式能力补齐 + 4 个 P0 缺陷修复
-
-新增 `DocxLayoutOps`（分栏/页码分区/文档网格/titlePg/分页控制/中文排版开关/动态版心宽）、
-`DocxRunFormatExtras`（双删除线/小型大写/字符缩放/复杂文种字号/字体 hint）、
-`DocxFootnoteOps`（脚注尾注）；扩展 `DocxStyleOps`（样式创建**与改写**、字符样式）、
-`DocxNumberingOps`（多级编号/样式绑定/一键编号）、`DocxTableOps`（行高/cantSplit/表格布局/边框）、
-`DocxPaths`（`/body/table[T]/row[R]`、`/body/style[ID]`）。
-
-修复的 P0：
-
-| 缺陷 | 影响 | 修复 |
-|---|---|---|
-| `pageBreakBefore` 进规则但不被下游识别 | 标记 `fixable=true` 却写不进去 → **check 永不收敛** | `applyParagraphExtras` 委托 `DocxLayoutOps.applyParagraphLayout` |
-| `applyProfile` 编号硬编码 `numId=2` | 文档已占用 numId=2 时挂错编号定义 | 改用 `createStyleBoundHeadingNumbering` 返回值 |
-| bridge 从不读 `outputFile` | 描述承诺「标注版不覆盖原件」落空 | 接上 `outputFile`，缺省自动派生 `<原名>-标注版.docx` |
-| `fontSize` 走 `intProp` + `setFontSize(int)` | **10.5pt 被截断为 10pt**（论文图题/表题标准字号） | 按双精度写 `w:sz`+`w:szCs`（半磅精度） |
-
-另：`keywordCount`/`refCount` 角色级聚合断言从「只在描述里」补成真实实现
-（此前按描述配置会静默零违规）；selfcheck 分页识别补齐「显式分页符 + 段前分页 + 分节符」并修正
-**文本归属页**（段前分页段的文本此前被算进上一页）；标题级别判定兼容中文样式名「标题 N」与纯 `outlineLvl`。
-
-#### 7. 颜色值序列化：`STHexColor` 联合类型陷阱
-
-`w:color/@w:val` 的类型是 XMLBeans **联合类型** `STHexColor`——RGB 分支存 3 字节 `byte[]`，
-另一分支存字符串 `"auto"`，因此 `CTColor.getVal()` 返回 `Object`。
-`DocxStyleResolver` 直接 `String.valueOf(getVal())`，RGB 被渲染成 `[B@74a239d7`。
-
-**不只是显示乱码**：`OfficeRuleEngine.compareColor` 拿这个值跟期望值比对，
-任何带 `color` 期望的规则**都不可能收敛**（fix 写完复检仍报违规，`converged` 永远 false）。
-读取改走 `xgetVal().getStringValue()`（两类分支都正确），字节分支兜底手写十六进制。
-
-同根因的写入侧缺陷：颜色归一化一律 `toUpperCase()`，把合法的 `auto` 变成非法的 `AUTO`，
-被 XMLBeans 以「union value 'AUTO' does not match any members」拒绝
-（传 `color="auto"` 清色直接报错）。归一化统一收敛到 `OfficeArgs.normalizeColor` 单点权威
-（命名色表 + `auto` 保留小写），`OfficeDocService` 与 `OfficeRuleEngine` 都委托它；
-xlsx/pptx 无 `auto` 概念，走新增的 `rgbColorOf` 显式拒绝并给可读提示。
-
-顺带修复 `office_view(outline)` 两处同源缺陷：标题判定只认 `styleId` 以 `heading` 开头
-（中文模板「标题 1」与纯 `outlineLvl` 标题全部漏检）；表格节点只有行列数，现附加题注文本
-（先取表格前一段、再取后一段，按「表 X-Y」文本特征或题注样式判定，都不中则回退）。
-
-> **升级须知**：本版本无破坏性变更。`office_format` 的 `action` 枚举新增 `dryRun`，
-> 旧调用方不受影响；备份文件会在文档同目录产生额外的 `<基名>-backup-*` 文件，
-> 若不希望出现在工作区索引中，可在 `.gitignore` 加 `*-backup-????????-??????.*`。
-
-## v1.9.166
-
-_发布日期：2026-10-05_
-
-### 修复：submit_task_result 丢参导致循环节点恒被拒绝提交
-
-`handleSubmitTaskResult` 只向 `agentClient.submitTaskResult` 透传了
-`nodeId / outputPayload / changeLog`，而工具 schema 早已声明、服务端也早已消费的
-**`handoverNote` 与 `deliverables` 在这一层被静默丢弃**。后果：
-
-- 位于循环路径（模板 `require_handover=true`）的节点，Agent 即便按描述传入
-  `handoverNote`，抵达 Java 侧时仍为 null，`validateHandoverNoteIfRequired`
-  恒定抛「必须提供交接经验」拒绝提交 —— 表现为「nodeId 能识别、handoverNote 却
-  永远缺失」的固定失败，Agent 侧穷尽调用通道与字段命名均无法绕过；
-- 结束节点的 `requiredDeliverables` 同理永远收不到交付物，必填项必然判缺。
-
-修复内容：
-
-- **补齐 5 参透传**：`handoverNote`（`getOptionalString`）与 `deliverables` 一并
-  下发到 `agentClient.submitTaskResult(nodeId, outputPayload, changeLog,
-  handoverNote, deliverables)`。
-- **新增 `prepareDeliverables`**：逐项归一化交付物，文件类（`path`）复用
-  `uploadAttachmentFiles` 换取 `url/mediaType/size` 后回传，文本类（`text`）原样
-  透传；无 key 项与空数组安全忽略。服务端 `parseDeliverablesArg` 可直接消费。
-- **changeLog 放宽形态**：数组（MCP 已解析）与 JSON 字符串两种形态均透传，
-  原先只认数组、字符串形态被吞（服务端 `parseChangeLog` 本就两种都支持）。
-
-### 错误结构化：errorCode / field 回传给 Agent
-
-服务端校验失败原先只回 `{"error":"<纯文本>"}`，Agent 只能从中文长句里猜原因。
-现新增 `McpToolError`（携带 `errorCode` / `field`），`callTool` 抛出时保留，
-`McpToolError` 经 MCP 错误响应原样透出：
-
-```json
-{"error":"该节点位于循环路径…","errorCode":"HANDOVER_REQUIRED","field":"handoverNote"}
-```
-
-仅新增字段、不改 `error` 语义，向后兼容；Agent 可据此直接补齐入参重试。
-
-> **回归锁定**：`mcp-server.test.ts` 的 `submit_task_result` 分发断言原先只校验
-> 3 个位置参数（`["node-1","...",undefined]`），恰好把丢参行为固化，导致测试全绿
-> 而线上必然失败。现改为 5 参断言，并新增 handoverNote / text 交付物 / file 交付物
-> （打桩上传）/ changeLog 字符串形态四条用例。
-
-> **兼容性**：MCP 工具 schema 未变更，仅修复「声明了却不转发」的实现缺口；
-> 新旧服务端均可对接（服务端本就接受这两个可选字段）。
-
-## v1.9.165
-
-_发布日期：2026-10-03_
-
-### 浏览器画质档位：原画改为无损 PNG，高清 80 / 流畅 60
-
-原先三档都是 JPEG，所谓「原画」实为 JPEG q80；且 tile 差量路径把 CDP 帧解码后
-**再按同一质量重编码一次**，同一区域反复变化时有损伪影逐次累积。
-
-- **档位参数改为格式驱动**（`QUALITY_PRESETS` 新增 `format` 字段）：
-  - `original`：无损 PNG，像素级还原（`quality` 不生效）；
-  - `hd`：JPEG 80；
-  - `smooth`：JPEG 60。
-- **tile 重编码跟随档位格式**（新增 `frame-encode.ts` 统一编码入口）：
-  无损档位下增量块同样输出 PNG，不再被二次有损压缩；整帧与 tile 两条路径
-  共用同一实现，避免只改一半造成「整帧无损、增量有损」的错配。
-- **CDP 参数修正**：`Page.startScreencast` 仅在 jpeg 格式下携带 `quality`，
-  png 格式传 0 会被 CDP 判为非法参数。
-- **默认格式由默认档位派生**：原先 `DEFAULT_FORMAT` 写死 `'jpeg'`，与默认档位
-  `original` 冲突，会让会话初始状态变成「UI 显示原画、实际下发 JPEG q0」。
-- **单帧上限 2MB → 6MB**（`WS_DEFAULT_MAX_SEND_BYTES`）：1280×720 的无损 PNG
-  整帧可达 3.5MB 量级，沿用 2MB 会让高熵内容的整帧被静默丢弃，
-  表现为画面冻结并反复 resync。
-- **切换档位时丢弃差分参考帧**：格式变化会改变参考帧的编码语义，
-  沿用旧基准会把新格式首帧差分成跨格式 tile。
-
-前端同步：`createImageBitmap` 不再声明 `image/jpeg`（原画档位是 PNG，
-声明错误的 MIME 会选错解码路径，改由内容嗅探）；画质下拉文案标注「原画（无损）」。
-
-> **兼容性**：帧协议未变更（`createImageBitmap` 按内容嗅探格式），
-> 新旧前端均可解码；但旧 bridge + 新前端会失去无损能力（仍为 JPEG）。
-
-## v1.9.164
-
-_发布日期：2026-09-26_
-
-### 项目级 / 角色级能力层（inherited 层）：bridge 侧落地
-
-能力配置由「全局默认 + 实例覆盖」两级升级为**四层逐键覆盖链**
-（角色实例 > 角色 > 项目 > 全局默认），本版本承接 bridge 侧全部落地。
-解析权威仍在 Java（`AgentCapabilityService.buildInheritedLayers` 产出「项目 ⊕ 角色」的
-增量层），bridge 只负责存储与逐键取用：
-
-- **能力布尔（MCP / Skill / 插件）**：per-agent 文件由「平铺 map」升级为
-  `{ overrides, inherited }` 双子对象；旧平铺文件读作 `overrides`，向后兼容。
-  取值链 `overrides > inherited > 共享默认(config) > deployedDefault > false`。
-  新增整表替换端点 `POST /runtime/{skills|mcp|plugins}/deployed/inherited`
-  （`{ agentId, inherited }`，null/缺省 = 清空本层），由 Java fan-out 推送。
-- **工具三态（disabled / collapsed / expanded）**：新增内存层
-  `inheritedFeaturesByAgent`，`getFeatureState` 改为
-  `实例显式 > inherited > 内置默认` 逐键解析；**分组父门禁**在合并视图上判定
-  （父主开关 `disabled` 则子能力一律未授权），与 Java `AgentAbilitySwitchService`
-  同口径。
-- **分层推送互不覆盖**：全局改动只动共享默认、项目/角色改动只推 inherited、
-  实例改动只推 overrides —— 因此删掉本层键即可自然露出下层值，
-  「恢复跟随上层」得以正确工作。
-- `/runtime/start` 与 `POST /instances/:id/features` 同步接收 `inheritedFeatures` /
-  `capabilitiesInherited` 字段（undefined = 不改动，避免误清空其它实例的推送值）。
-
-> **升级须知（重要）**：低于本版本的 bridge 不认识 inherited 层，会回退到
-> 「缺名 = 启用」的迁移期路径，导致**上层已禁用的能力仍被启用**。因此本版本要求
-> bridge 与 Java 端同批升级；环境变量四层链（v1.9.163 起）不涉 bridge 存储，滚动安全。
-
-### 工具批次归组：阻塞型通讯工具移出「并行执行工具」
-
-`poll_message` / `create_meeting` 这类核心阻塞型通讯工具不再进入工具批次：
-
-- **移出批次**（不进批次根事件、不带 `batchId`、不计入 `tool_batch_metrics` 的
-  `toolCount`/`traces`），时间线上按普通工具扁平展示；执行本身不变，仍由调度器排到
-  批尾串行（`poll_message` 的 while(true) 阻塞等待语义不受影响）。
-- 动因：这两者与本批其他工具毫无并行收益，归进「并行执行工具」卡片会造成双重误导——
-  卡片名宣称并行、实测 `speedup` 恒为 1.00x；`poll_message` 的阻塞等待也会被错觉为
-  批次成员。之前的批调用把 `search_memory` 与 `poll_message` 并列，既无加速、又难看懂。
-- 批次成立条件收紧为「**批次成员**数 > 1」：若排除后成员不足 2 个（如
-  `poll_message` + 单个 `write_file`），则不发根事件与指标，时间线完全扁平。
-- 运行时新增 `isMcpBatchExcludedToolName`（`mcpToolNames.ts`）作为批次排除判据；
-  与「MCP 超时策略」集合 `isMcpBlockingToolName` 语义分离。
-
-配套 Java 侧（同批发布）：`ProjectCapabilityOverrideService` 项目层存储（
-`project_capability_overrides:{tenant}:{projectId}`）、`AgentCapabilityService`
-四层解析与 source 细化（agent/role/project/bridge）、`AgentAbilitySwitchService`
-三态四层 + 分组门禁、`RuntimeBridgeService` inherited 推送与 fan-out、
-项目/角色能力配置接口与新建项目草稿落库。
-
-### 修复：Agent 回到 waiting_input 后长时间"空闲"（每次任务后约 10min 死区）
-
-现象：角色实例状态徽章长时间显示"空闲"，而时间线最新事件停在"编辑文件"；
-期间私信/流程线任务完全不消费，约 10 分钟后才自行恢复。
-
-根因（`AcodeSdkAdapter`）：`turn_complete` 的"用户消息轮调用了工作工具"分支
-（`!autoPollActive && observedAnyTool && !observedPollingTool`）原本只做 `return`——
-既不派发空闲提示词、也放弃了重臂。而 `waiting_input` 下 turn 级看门狗不计时，
-会话遂无任何定时器在看守，只能等 10min 会话存活看门狗兜底。
-且重试轮（`retryFailedRequest`，`autoPollActive=false`）同样命中该分支，
-而该路径不重置观察标记，上一失败轮残留的 `observedAnyTool` 使分支必然成立 →
-**每次任务结束都固定触发约 10min 死区**。
-
-修复（保留"不立即派发"的节流意图，改为**延迟重臂**）：
-- 新增 `ACODE_DEFERRED_IDLE_REARM_MS`（默认 3s，env 可覆盖）与
-  `scheduleDeferredIdleRearm()`：分支 2 不立即派发空闲提示词，但延迟后重臂监听，
-  把死区从 10min 压到 3s。刻意走 `scheduleAutoPoll` 而非 `armIdleLoopOrAutoPoll`，
-  避免配置了 polling 类 idle 命令时被 `IdlePollLoop`（0ms）架空延迟。
-- `armIdleLoopOrAutoPoll` 重臂前清除待触发的延迟定时器（只清 timer、不动退避档位），
-  防止延迟重臂与正常重臂双发。
-- `retryFailedRequest` 与其它提交入口对齐，重置 `autoPollObserved*` 三标记，
-  消除跨轮污染导致的"重试轮被误判为用户消息轮"。
-
-## v1.9.163
-
-_发布日期：2026-09-25_
-
-### 三级环境变量（全局 / 项目 / 角色实例）→ 工具子进程 + MCP 配置
-
-环境变量由单一「面板全局层」升级为**三级合并**（角色实例 > 项目 > 全局，择近优先），
-合并结果随 `/runtime/start` 下发，作用于 bridge 管理的工具子进程与 MCP stdio 服务器配置。
-Java 侧 `EnvVarResolver` 为唯一权威计算点，本版本承接 bridge 侧全部落地：
-
-- **per-agent 环境变量存储**：`panel-env` 由进程级单例改为按 agentId 键控。此前最后启动的
-  实例会覆盖整个 bridge 的环境变量（多实例静默串味）；现在各实例独立，桌面工具子进程按
-  调用方实例取值，切换实例时经 env 签名检测触发重启应用新值（`ownerAgentId` 记录归属）。
-- **MCP stdio spec 注入**：MCP 子进程**不继承 bridge 的 `process.env`**（MCP SDK 的
-  `StdioClientTransport` 只带 HOME/PATH 等少数键），故新增 `mcp-env-injector` 把有效环境变量
-  写入每个 stdio server 的 `env`。优先级：**server 自身 env > 三级合并结果 > SDK 默认继承项**；
-  内置 `agents-work-studio` 与 sse/http 服务器跳过。acode（per-instance acode.json 装配）
-  与 Claude SDK 两条适配器路径均已接入。
-- **`${VAR}` 占位符展开**：stdio spec 的 `env` 值与远程 spec 的 `url` / `headers` 值中的
-  `${变量名}` 按该实例有效环境变量展开（如 `Authorization: "Bearer ${API_KEY}"`）；
-  未命中的占位符保持原样，便于在 MCP 启动失败信息中定位拼写错误。
-- **子进程 env 安全名单**：新增 `utils/env-safety.ts`，把原 plugin-manager 的
-  `BLOCKED_ENV_KEYS` 集中为单点权威并新增 `sanitizeEnvForChild`，在面板环境变量入站、
-  MCP spec 注入、桌面子进程显式覆盖层三处统一把关（挡掉 `NODE_OPTIONS` / `LD_PRELOAD` /
-  `PATH` 等执行流劫持与宿主关键路径键）。
-
-配套 Java 侧（同批发布）：`EnvVarResolver` 三级合并与「空串=屏蔽」解析、`t_agent.env_overrides`
-实例层存储、项目级 `project_env_vars:*` 存储与掩码读写、有效值预览接口、三级配置 UI。
-
-## v1.9.162
-
-_发布日期：2026-09-24_
-
-### 工具懒加载：browser / desktop 收纳态展开链路打通（关键修复）
-
-v1.9.153 起 browser / desktop 改为**收纳态不注入会话工具列表**（缓存稳定化的
-前提：LLM 请求的 tools 前缀字节级不变，provider 前缀缓存全程命中），工具定义改由
-`expand_tools` 结果下发、执行经 `call_tool` 回传。但回传链路在重构中被删除且未补回，
-导致收纳态（默认档）下：
-
-- `expand_tools({group:"browser"})` 从本地 `exposedTools` 取 manifests → 收纳态下
-  必然为空（工具按设计就没注入），agent 拿到 0 个工具定义；
-- `call_tool({name:"browser_navigate"})` 找不到工具名 → 直接报「未知工具」；
-- bridge 侧 `POST /sessions/:agentId/capability-tools[/call]` 端点恢复后**没有任何调用方**
-  （原 MCP Server 中继 `setBridgeCapabilityTools` / `handleExpandTools` 已随重构移除）。
-
-本次以**同进程中继**补齐（不改 tools/list 载荷，缓存稳定性不回退）：
-
-- ACode 新增 `CapabilityToolRelay` 契约（`tool-group-manager.ts`）+ 运行时配置
-  `capabilityToolRelay`（`types.ts`），`expand_tools` / `call_tool` 的桥接组分支经其
-  回传；本地组（pencil / draw / office / launch / hire / task / meeting / debug /
-  fileHistory）路径完全不变。
-  - 展开：先中继（`setBuiltInCapabilityTools(expand)` 刷新定义缓存并授予调度授权、
-    返回 manifests），成功后才置本地展开态 —— 中继失败可重试，不留半展开态；
-  - `group="all"`：桥接组经中继拉 manifests，`disabled` 静默跳过、单组失败不阻断其余组
-    （该组 `call_tool` 会被拒并提示重新 expand，自愈）；收起时桥接授权全部回收；
-  - 调度：`findTool` 落空且工具名归 bridge 托管时，按 `call_tool` 三道闸同口径的
-    本地预检（`disabled` 拒绝 / 未展开引导 expand）后执行 `callBuiltInCapabilityTool`。
-- `AcodeSdkAdapter` 会话启动时注入中继（同进程直连，无 HTTP、无 token 依赖；
-  HTTP 端点 `capability-tools[/call]` 保留供外部/兼容调用）。无 `agentId` 时不注入，
-  退化为本地查找（与启动注入的缺省兜底一致）。
-
-配套测试：acode `tool-group-manager.test.ts` 新增「capabilityToolRelay」12 项（展开
-manifests 来自中继、幂等、失败不留状态且可重试、disabled 不触中继、group=all 混合
-本地+桥接+disabled、收起回收、调度透传参数/未展开拒绝/disabled 拒绝/错误透传/
-非桥接未知工具不触中继）；bridge `AcodeSdkAdapter.test.ts` 新增端到端用例
-（启动注入中继 → `expand` 下发 manifests 且不注入 exposedTools → `call` 执行 →
-`collapse` 后调度被拒）。bridge 套件 1473 通过 + 4 跳过、acode 743 通过。
-
-### 工具组：ACode 短 key ↔ 能力 featureKey 错位修复
-
-`collaboration.*`（流程任务 / 会议 / 调试日志 / 文件变更历史）与 `agentSys.launchItem` /
-`agentSys.hire` 的工具组短 key（`task` / `meeting` / `debug` / `fileHistory` / `launch` /
-`hire`）与完整 featureKey 不一致，ACode 侧把「收纳」误判为「禁用」（实测确认）：
-系统提示词把已授权能力显示为未开启、`expand_tools` 直接拒绝。本次新增
-`GROUP_KEY_TO_FEATURE` 映射与 `resolveGroupFeatureKey()`（`instance-features.ts`），
-`capabilityState` 回调先归一再取三态；同时补齐父门禁级联
-（`collaboration` / `agentSys` 主开关 `disabled` 时其子能力一律 `disabled`），
-与前端清除子键、Java 门禁传播同口径。
-
-工具组归属推断同时加固（`tool-group-manager.ts`）：不再只认 `key_` 前缀，注册的
-精确 `toolNames` 先于前缀命中，`listToolManifests` 忽略 MCP 的 `serverName__` 命名空间
-取裸名匹配 —— `my_task` / `create_meeting` / `query_debug_logs` /
-`query_file_changes_history` 等非前缀命名的 MCP 工具组据此正确归组与下发定义。
-
-### 协作能力分组：默认收纳 + 父门禁级联
-
-`instance-features.ts` 新增 `collaboration` 主开关与 `collaboration.task` /
-`collaboration.meeting` / `collaboration.debug` / `collaboration.fileHistory` 四个子能力
-（默认收纳），ACode 侧注册同名工具组；四个分组在收纳态下不进 LLM 工具列表，经
-`expand_tools` 展开后由 `call_tool` 调度。
-
-### 工具并发执行（资源驱动调度）
-
-新增 `tool-concurrency/` 子系统（`types` / `resource-lock` / `scheduler` /
-`observability`），ACode 一条 LLM 响应返回多个 `tool_calls` 时按**资源冲突关系**
-并发而非按工具类型分组，并新增运行时配置 `toolConcurrency`
-（`enabled` 默认 true、`maxReadOnly` 默认 8、`maxBash` 默认 0=不限）：
-
-- 资源键层级（`file:` / 目录前缀 / `bash:` 等）与祖先-后代判定；区间重叠即冲突；
-- 同资源读写按读写锁串行，写-写互斥；未声明并发策略的工具（如 bridge 注入的
-  `browser_` / `desktop_`）默认独占串行 —— 关闭 `enabled` 即退化为旧的串行行为；
-- `ToolTraceRecorder` 记录每个工具的 waiting_resource / running / completed 时序并聚合
-  批次度量（墙钟、并行度、等锁总时长、竞争次数、加速比），`ConcurrencyLimiter` 提供
-  只读 / Bash 并发上限；
-- 文件工具声明资源键（`buildFileResourceKey` / `fileResourceClaim`），读 `read`、
-  写 `write`。
-
-### 文件写入 stale guard（陈旧写入拒绝）
-
-新增 `read-file-state.ts`：`read_file` 记录 mtime / size / 内容快照，`edit_file` /
-`write_file` 落盘前比对，文件在上次读取后被外部修改（且内容与快照不匹配）时拒绝写入
-并提示模型重读，避免并发会话/外部编辑器改动被静默覆盖。运行时开关
-`enableStaleFileGuard`（缺省启用，`false` 关闭比对；状态仅存内存，`stop()` 清空）。
-
-### 工具权限：新增 `fileModificationOutside` 档位
-
-「限制操作」新增工作区外文件修改权限（`fileModificationOutside`），
-`resolveAgentToolPermissions` 全 allow 兜底值同步补齐，热推路径显式下发默认值以
-清除历史限制。
-
-### 会话启动令牌吊销与运行时钟强化
-
-- `RuntimeGlobalSettingsService` 启动时吊销历史运行令牌，避免重启后旧令牌继续可用。
-- `terminal.ts` 抽出 `isIdleStatusChangeRetryable()`：`waiting_input` 纯状态切换
-  （`turn_complete` 仅带 usage、不带 `actionType`）也纳入 idle 串行重试队列，
-  修复该类状态切换漏到零重试路径的问题；原 `!params.actionInfo` 空判改为
-  `!params.actionInfo?.actionType`。
-
-### LTR 临时文件读取端点
-
-`POST /api/ltr/read`：按绝对路径返回 LTR 临时文本内容，安全校验拒绝 `LTR_ROOT`
-目录树之外的路径（防路径穿越），文件不存在 404、非文件 400、上限 512KB。
-
-### Agent Todo 重置与 acode-todos 路由
-
-`AgentTodoService` / `routes/acode-todos.ts` 支持重置（清空）会话待办列表，
-配套 `acode-todos.test.ts` 覆盖重置语义。
-
-### 空闲监听指令（poll_message）措辞收敛
-
-`MESSAGE_POLLING_IDLE_PROMPT` 改为显式前置条件：「此指令仅在当前没有未完成任务时生效；
-若仍在处理任务请忽略本指令并继续执行」，仅在确认无进行中/未完成任务时才调用
-`poll_message`，降低任务中途被空闲轮询打断的概率（三个 adapter 的单测改为从
-`prompts.ts` 导入常量，避免文案与断言再次脱节）。
-
-### 依赖与其它
-
-- `aws-client-agent-mcp` 新增 `temml`（Office 公式渲染）依赖，新增
-  `office_format` / `office_apply_profile` / `office_generate_from_template` 三个
-  Office 工具及 `office-equation.ts` 公式模块（含测试）。
-- `AcodeSdkAdapter` 恢复 `POST /sessions/:agentId/capability-tools[/call]` 路由，
-  `resolveAdapter(providerId)` 按会话 providerId 解析适配器；sessions 测试 29 项通过。
-- 版本号 1.9.157 – 1.9.162 为连续未发布开发周期（npm 上仍为 1.9.153），
-  本次一并发布。
-
-## v1.9.161
-
-_发布日期：2026-09-18_
-
-### Office 题注位置与回执提示修复（依据 v4 回归报告 N7/N8）
-
-**N7：`captioned_table` 题注位置对齐中文论文规范**
-
-中文论文（学位论文）规范要求「图题在下、表题在上」，本项目脚本产物同样如此；
-此前 `captioned_table` 一律把题注插在表格**下方**，用工具链重做论文逐页比对时会显现差异。
-现按元素类型区分默认位置：
-
-- `captioned_image`：题注默认在图片**下方**（行为不变）
-- `captioned_table`：题注默认在表格**上方**
-- 新增 `props.captionPosition`（`above`/`below`，兼容 `top`/`before`/`bottom`/`after`）显式覆盖
-
-实现：新增 `insertParagraphBeforeElement`（表题在上的插入路径）；章内序号统计按位置
-（章标题之后、插入点之前）计算，因此「表题在上」不改变编号连续性。
-
-**N8：`office_edit` 回执未透传服务端 warnings**
-
-服务端（Java）已在 `chapterHeadingStyle=false` 等场景返回 `warnings`，但 bridge 层
-`officeEdit` 组装回执时丢弃了该字段，使用者无法感知「F9 后编号不会按章重启」的风险。
-现原样透传 `warnings`（服务端未返回时不产生空数组噪音）。
-
-配套回归测试：`OfficeDocxPrecisionTest` 新增 4 个用例（表题默认在上、图题默认在下、
-captionPosition 显式覆盖、表题在上时序号连续）；bridge `mcp-server.test.ts` 新增 2 个
-用例（warnings 透传、无 warnings 时不含该键）。office 测试总数 179 全通过；
-Word COM F9 实测题注编号稳定（表1-1/表1-2/表2-1、图1-1/图1-2/图2-1）。
-
-### ACode 模型请求失败重试不再重置上下文
-
-模型请求超时/网关 5xx/看门狗中止后的重试此前会重新走主动压缩预检：一旦累计或估算
-用量越过阈值，与上下文大小无关的失败重试也会裁剪+摘要化历史，表现为「重试后上下文
-被重置」。本次修复：
-
-- **恢复式重试（resume，与失败请求逐字节一致）**：非溢出的普通失败（5xx/超时/看门狗）
-  后，适配器以 `resume: true` 恢复同一轮——不重发 prompt 钩子、不重复 push 用户消息、
-  **不回滚轮内进展**（工具结果/部分输出原地保留），基于与失败请求同一份 conversation
-  重建请求：重试请求与上次失败的请求逐字节一致，重试之前的状态不丢失。原先的失败轮
-  锚点回滚（`rollbackFailedTurn`）会把会话截回 turn 开始前、丢弃轮内已成功的迭代，已移除。
-- **轮级跳过压缩**：重试 submit 携带 `skipProactiveCompaction`（resume 隐含），覆盖整轮
-  全部 LLM 迭代，并同时约束 800KB 请求体字节上限截断（`truncateConversationIfNeeded`），
-  旧版 `markSkipNextCompaction()` 单次标记兼容保留；仅 provider 显式溢出信号（错误字段/
-  `finish_reason`）触发响应式压缩重建，413 溢出仍正常兜底——上下文改写只属于溢出响应。
-- **结构化溢出判定**：新增 `context-overflow.ts`（cause 链下钻 + 字段级标记 + 精选消息
-  片段），`length`/`max_tokens` 被输出长度标记独占短路，绝不因输出上限触发压缩。
-- **4xx 确定性错误短路重试**：invalid_request 类错误直接 `retry_aborted`（「请求无效」），
-  5xx/超时仍按指数退避+抖动重投。
-
-配套回归测试：acode `runtime.test.ts` 新增/强化 5 个用例（resume 重试请求体逐字节一致
-且不重复 push、中途失败保留轮内工具结果后 resume 与失败迭代逐字节一致、整轮跳过主动
-压缩、legacy 单次标记、重试轮跳过 800KB 字节截断而普通轮照常截断）；bridge
-`AcodeSdkAdapter.test.ts` 断言重试提交携带 `resume + skipProactiveCompaction`，并含
-4xx 短路与重试计数语义用例（套件 82/82 通过）。
-
-## v1.9.160
-
-_发布日期：2026-09-18_
-
-### Office 题注编号与格式检查修复（依据 v3 回归报告 N1-N6）
-
-**N1（高）：SEQ 域 `\s` 值写成了章号，F9 后含小节的章出现重复编号**
-
-`\s N` 的 N 是**标题级别**（1-9），不是章号。原实现写 `SEQ figure \s <章号>`，导致：
-含 H2 小节的章在每次小节标题处错误重启（实测 Word F9 后 图2-1 重复出现），
-第十章还会写出超范围值 `\s 10`。现固定为 `SEQ figure \s 1`（按 1 级标题重启），
-章号只体现于静态前缀；章内序号改为按「本章范围内、插入点之前」的实际域数量统计
-（`countSeqFieldsBefore`），与 `\s` 值彻底解耦。
-
-**N2（中）：题注按章重启依赖章标题具备「标题 1」样式，此前不校验也不提示**
-
-Word 的 `\s 1` 按**样式名为内置「标题 1」**的段落重启（COM 实测：仅补直接格式
-`outlineLvl` 或自定义名样式均无效）。而论文类模板常把章标题写成直排格式（无样式），
-此时 F9 后编号会跨章累计。修复：
-
-- `captioned_*` 在 `chapterTracker=auto` 时自动为识别出的章标题补「标题 1」样式
-  （新增 `DocxStyleOps`：找样式 → 套用并逐项还原差异 → 若仍不等价则回退到工具自建的
-  **最少格式「标题 1」样式**，保证可见外观零变化）
-- 新增 `props.chapterHeadingStyle=false` 可关闭自动补样式（回执带 `warnings` 说明风险）
-- `office_edit` 回执新增 `warnings` 字段
-
-**N3（低）：`props.heading` 传数字不生效（静默）**
-
-数字 `1`、字符串 `"1"`、`"Heading1"`、`"标题 1"` 现均可用；非法值（`"abc"`、越界 `4`）
-改为**显式报错**，不再静默不加样式。
-
-**N5：check 空段落噪音**
-
-`office_format` 默认跳过无文本段落（空段落/纯图片段落）的正文类检查与修正，
-summary 增加 `skippedBlankParagraphs`；`rules.blankParagraphPolicy="report"` 可恢复旧行为。
-实测重生成论文违规数 421 → 199（其中 222 条为纯空段落噪音）。
-
-**N6：preset 与模板实测口径统一**
-
-- profile 聚合修正「非空众数」偏差：此前 114 段中仅 1 段 `bold=true` 也会输出 `bold=true`
-  （回灌 apply_profile 会把全文错误加粗）；现按全量多数票取值，未显式设置的属性不输出
-- 新增 `OfficeFormatPresets.merge(base, overrides)` 与 `office_format` 的 `mergePreset=true`：
-  以 preset 为基线、实测 profile 逐键覆盖（page/rules[role].props/roles），
-  解决「preset 期望黑体 vs 模板实测宋体」的系统性差异导致的验收比对失真
-- 合并时归一「首行缩进/悬挂缩进」互斥（OOXML 中两者共存只有悬挂生效，会造成
-  check 期望与实际永不收敛）；写入端同步加固
-
-**实测验收**：模板实测 profile + preset 合并后，对重生成论文 check→fix→check
-收敛 219 → 0；对既有论文 179 → 0（此前因缩进互斥存在 12 条不可收敛残留）。
-
-配套回归测试：`OfficeDocxPrecisionTest` 新增 11 个用例（SEQ 恒定值、同章序号解耦、
-章标题样式自动补/外观保持/可关闭、heading 数字与非法值、空段落跳过与 report 策略、
-preset 合并与缩进互斥收敛、profile null 噪声）；office 测试总数 175 全通过。
-
-### office 卡片：指定文件强校验 + 预览链接服务端权威化
-
-**背景**：office 卡片的 `card.previewUrl` 此前由 agent 自报、bridge 与 Java 两端均无校验
-（纯透传），前端直接塞进无 sandbox 的 iframe——agent 可拼造任意地址（含站外页面）。
-同时卡片引用的文件是否真实存在没有任何服务端校验。
-
-**新契约**：office 卡片只能用 `filePath`（工作区路径）或 `docId`（云文档 id）之一指定
-文件，二者必居其一、不可同时传；`previewUrl` 从入参契约中移除，由服务端生成。
-
-- **bridge（发送前校验，失败即工具调用失败、消息不发送）**：`buildOfficeCardPayload`
-  重写——filePath 经 `packOfficeFile` 统一校验（存在/普通文件/docx-xlsx-pptx/≤16MB）后
-  上传，载荷换成 `{type,name,kind,fileUrl,sizeKb,title,filePath,workspacePath}`；
-  docId 路径本机零上传，载荷只带 `{type,docId,title?,description?}`；
-  两者同传 / 都缺 / 只传 fileUrl 均抛错。入参即使携带 `previewUrl` 也被丢弃。
-- **服务端（落库前权威校验）**：`McpToolHandler.toCardJson` 的 office 分支改为委托
-  `OfficeToolHandlers.normalizeOfficeCard`——校验 filePath/docId 二选一；filePath 路径
-  按 `fileUrl` 反解存储名并 `loadFile` 确认文件真实存在；docId 路径经
-  `OfficeCloudDocService.findDoc` 校验云文档有效（不存在则工具调用失败、消息不落库）
-  并回填 name/kind/fileUrl/sizeKb。
-- **预览由服务端生成**：取权威文件字节 → `OfficeDocService.buildPreviewHtml` →
-  `FileStorageService.storeFile("...-preview.html", ...)` → 服务端 `previewUrl` 写入卡片。
-  文件字节无法解析（损坏/伪装扩展名）时发送失败，杜绝「卡片指向不存在的文件」。
-- **工具描述**：`send_group`/`send_private` 的 `card` schema 删除 `previewUrl` 属性，
-  `docId`/`filePath` 描述改写为「二选一」口径；`office_preview` 描述改为「返回地址供自检/
-  留档，卡片预览由服务端生成」。
-- **dashboard**：新增 `utils/officeCardUrl.ts` 信任边界（`fileUrl` 只放行本站
-  `/api/files/` 地址，`previewUrl` 额外要求 `.html`；伪协议/携带凭据/站外链接一律拦截），
-  `ChatPanel.vue` 的预览按钮、点击、下载统一走该校验；预览 iframe 加
-  `sandbox="allow-same-origin"` 与 `referrerpolicy="no-referrer"`；卡片带 `docId` 时
-  「面板打开」直接按 docId 打开 Office 面板（跳过工作区路径匹配）。
-
-配套回归测试：bridge `mcp-server.test.ts` 新增 office 卡片 9 个用例（上传路径/预览地址
-丢弃/文件不存在/非 Office 扩展名/docId 零上传/二选一冲突/两者都缺/只传 fileUrl/DM 路径），
-`mcp-tools.test.ts` 新增 schema 契约 2 个用例；dashboard `officeCardUrl.test.ts` 7 个用例。
-
-## v1.9.159
-
-_发布日期：2026-09-17_
-
-### Office 回归修复（依据 v1/v2 回归报告）
-
-**严重：lineSpacing 提取值错误（会导致排版全毁）**
-
-`office_view(mode=profile)` 提取的 `body_text.lineSpacing` 为 `0.075` 而实际应为 `1.5`——
-`DocxStyleResolver` 已把 twips 转为磅值，profile 聚合时又按 twips 除以 240（等效多除 20）。
-现改为 `pt / 12` 得到倍数，与规则引擎 `normalizeLineSpacing` 对齐；提取值回灌
-`office_apply_profile` 后行距正确（360 twips = 1.5 倍）。
-
-**chapterTracker 跨章失效**
-
-`captioned_image` / `captioned_table` 在第二章后仍生成「图1-1」。修复：
-
-- 按 `before`/`after`/`index` 解析真实插入落点（而非扫描全篇）
-- 章号判定同时支持 Heading1 样式、大纲级别 0、「第X章」中文数字（`chineseNumeralToInt`）
-- 章内序号按 `SEQ ... \s N` 分组计数，跨章正确重启
-
-**SEQ 域缓存值与静态前缀叠加（显示「图1-1 前台首页1」）**
-
-题注以 `{seq}` 为界拆分为「静态前缀 run + SEQ 域 + 静态后缀 run」，域缓存值即章内序号，
-Word/WPS 打开即为正确编号，F9 刷新后保持一致。
-
-**heading1 角色漏识别**
-
-`OfficeRoleDetector` 新增大纲级别判据与中文样式名支持（`headingLevelOfStyle`：`Heading 1` /
-`标题 1`），章标题正则放宽空格并补充裸数字章标题兜底。
-
-配套新增 10 个回归测试；office 测试总数 161 全通过。
-
-## v1.9.158
-
-_发布日期：2026-09-17_
-
-### Office 模板对齐类文档生成增强（F1-F6）
-
-将「参考模板 → 逐项对齐样式 → 一键出稿」的论文类任务能力沉淀为 office 工具链通用能力，
-仍基于 Apache POI 纯格式层（无 COM、无外部进程）。新增 2 个工具 + 2 个 office_view 模式，
-扩展 office_edit 两种带题注元素与表格列声明。
-
-**新工具**
-
-- `office_apply_profile`：按样式 Profile 对匹配角色段落规整字体/字号/行距/缩进/对齐 +
-  页面设置 + 标题编号；值稳定（重复应用不回退、不翻倍）。
-- `office_generate_from_template`：`{{var}}` 全文跨 run 替换 + 内容清单注入
-  （heading/paragraph/image/table/pageBreak）+ 可选 profile 应用；`outputFile` 指定时保留模板。
-
-**office_view 新 mode**
-
-- `profile`：从模板 docx 提取按角色聚合的样式 Profile（page/roles/rules/numbering），
-  作为 apply_profile 的输入；role 附 `matchSource`/`sampleText`/`paragraphCount` 审计元数据。
-- `selfcheck`：按分页符拆页，逐页 `textDigest` + 标题层级跳跃/图片溢出/宽表 warning，
-  并复用规则引擎补充格式违规检查。
-
-**office_edit 扩展**
-
-- `add type=captioned_image / captioned_table`：一条命令插入图片/表格 + 居中题注段
-  （SEQ 域，Word F9 可刷新）；`caption`/`captionText` 双字段兼容；`chapterTracker=auto` 自动判章。
-- `add type=table` 新增 `columns: [{widthPt, align}]` 列宽（pt→dxa）与列对齐声明。
-
-**回归修复**
-
-- 修复 `office_create` 漏传 `template` 参数（bridge 侧）。
-- 修复 `captioned_*` 题注未写入（参数名不一致 + 题注段与内容段共用锚点）。
-- 修复 `office_generate_from_template` 的 `outputFile` 不生效（模板被就地污染）。
-- profile 角色识别增强：TOC/附录等辅助样式不再污染正文/标题统计。
-
-详见 `docs/Office文件操作能力实施方案.md` §12。
-
-## v1.9.157
-
-_发布日期：2026-09-16_
-
-### Office 精准操作能力大版本：Word 内核 / Excel / PPT / 公式 / 规则引擎
-
-对标参考开源实现（WordFormat、学术 skills 等）完成 Office 三件套从「能创建」到
-「精准操作」的升级：run 级定位、批注修订、公式目录页码、版式占位符、格式规则
-检查与一键修正。全部基于 Apache POI 5.2.5 纯格式层实现，无 COM/无外部进程。
-
-**Word 精准编辑内核（docx）**
-
-- 路径寻址扩展：`/body/p[N]/run[M]`（run 级）、`/body/table[T]/row[R]/cell[C]`（单元格）、
-  `/body/sectPr`（页面）、`/body/header|footer`（页眉页脚）
-- 新增 `DocxStyleResolver`：docDefaults → basedOn 链 → 直接格式的**有效格式解析**
-  （含主题字体兑现），支撑 `view styles` 与规则引擎「改得准、查不误报」
-- 新能力：`op=replace`（跨 run 保格式查找替换）、批注（写/读/删，五件套部件）、
-  修订（tracked 编辑 + accept/reject）、目录 TOC 域 + updateFields、PAGE/NUMPAGES/SEQ 域、
-  页码页脚、书签 + 外链/内链超链接、**引用上标 [n] + 锚点内链**、OMML 公式（行内/块级/编号公式三列表）、
-  **自定义标题编号**（第%1章模板 + 清除手动编号）、三线表（threeLine 预设）、
-  段落字符单位缩进（firstLineChars）、中英文字体三槽（fontEa/fontAscii/fontHAnsi）
-- `office_create` 支持 `template: cn-thesis`（A4+2.5cm、宋体/黑体样式体系、标题编号、页码）
-- `office_view` 新 mode：`styles`（有效格式）、`comments`、`revisions`、`search`（query 定位）
-- `office_validate` 增加 OOXML 结构检查：批注范围配对、w:del/w:ins 规范、xml:space
-
-**Excel 增强（xlsx）**
-
-- `add chart`（bar/column/line/pie/doughnut/area，XDDF 原生图表）、单元格批注、
-  数据验证（list/whole/decimal/date/textLength/custom）、条件格式（cellIs/containsText/colorScale）、
-  带位移插入/删除行（不覆盖相邻数据）、按范围拆分合并、富文本单元格（runs 数组）、
-  定义名称、页面设置（方向/缩放/打印区域）、自动筛选、行列隐藏
-
-**PowerPoint 增强（pptx）**
-
-- 演讲者备注（`set /slide[N]/notes`，view notes 读取）、**版式感知创建**（add slide + layout/layoutIndex，
-  view layouts 清单）、占位符直接赋值（`/slide[N]/placeholder[type|idx]`，保留模板样式）、
-  全 deck 查找替换（可限定单页）、表格单元格写入（`/shape[M]/cell[R][C]`）、
-  形状旋转/z-order（up/down/top/bottom）/超链接、**幻灯片克隆**（op=clone：复制文本/图片/备注/版式，
-  源页隔离，插入位置可控）
-
-**公式链路（bridge）**
-
-- 新建 `src/office/office-equation.ts`：`props.latex` → temml（MIT）LaTeX→MathML →
-  自研 MathML→OMML 转换（覆盖分数/根式/上下标/极限/求和积分/矩阵/括号分组），
-  失败时给出可读错误；`office_edit` 自动预处理 latex → omml 上行 Java 注入
-
-**格式规则引擎（差异化能力）**
-
-- 新工具 `office_format`：`{file, action: check|fix, preset|rulesFile|rules, annotate?, outputFile?}`
-  - 角色识别（三层）：Word 样式 → 正则启发式（第X章/图题/摘要/参考文献等）→ 显式匹配器
-  - 检查：逐角色比对期望格式 → 违规清单（path/role/property/actual/expected/fixable/severity）+ 摘要；
-    `annotate:true` 把违规写成 Word 批注生成标注版（不覆盖原件）
-  - 修正：确定性项自动改（字体三槽/字号/加粗/对齐/行距/缩进/编号/手动编号清除），判断类只报告
-  - 预置：`cn-thesis`（学位论文）、`cn-report`（公文）；rulesFile 支持工作区 YAML/JSON
-- 收敛性验证：fix 后复查零违规（加权优先级 + 半磅字号 + 悬挂缩进语义）
-
-**预览增强（docx HTML 预览）**
-
-- 批注标记（含正文悬浮）、修订 ins/del 着色、公式文本化、TOC 占位、
-  域友好占位（〔页码〕）、超链接渲染为可点击 a[href]、上下标
-
-**测试**
-
-- Java：新增 `OfficeDocxPrecisionTest`（25 用例）、`OfficePptxAdvancedTest`（11 用例）、
-  `OfficeFormatEngineTest`（9 用例）等，全量 1442 用例通过
-- bridge：新增 `office-equation.test.ts`（17 用例）+ mcp-tools 描述契约测试；
-  `tsc` 与本套件通过
-- 前端：`officeTimeline` 支持 office_format 事件刷新，测试补齐
-
-## v1.9.156
-
-_发布日期：2026-09-13_
-
-### Office 三件套能力升级：图片、排版、形状
-
-按照 genoffice 对标，大幅增强 Office 文件引擎和工具描述，agent 现在可以生成含图片、列表、格式化表格的工作级文档。
-
-**Java POI 引擎**（OfficeDocService.java）
-
-- **图片基础设施**：严格 Base64 校验 + 魔数嗅探（PNG/JPEG/GIF/BMP/TIFF，WebP 等明确拒绝）+ ImageIO 像素尺寸读取 + 等比缩放辅助
-- **docx 新增**：`add image`（source 支持工作区路径 / http URL / data URL → bridge 侧解析，Java 无状态接收 imageBase64）、`add pageBreak`、列表（`list: "bullet"|"number"` + `level: 0-2` 惰性初始化 XWPFNumbering）、`set /body header/footer`、段落 `pageBreakBefore`
-- **xlsx 新增**：单元格 `numberFormat`（`0.00%`、`¥#,##0`、`yyyy-mm-dd` 等）、`border`+`borderColor`（thin/medium/thick/dashed/dotted/double）、`wrapText`、`valign`（top/center/bottom）、工作表 `colWidth`（px）、`rowHeight`（pt）、`freeze`（行/列）、`add merge`（range 字符串）、`add image`（anchorCell + 图片字节 → XSSFDrawing）
-- **pptx 新增**：`add image`（fit=contain/cover/stretch，cover 写 srcRect 裁剪）、`add shape`（rect/roundRect/ellipse/triangle/diamond/chevron 等 + fillColor/lineColor/lineWidth + 垂直居中文字）、`add table`（均分列宽行高 + header 加粗）、`set /slide[N] background`（十六进制背景色）、`remove /slide[N]/shape[M]`（含图片/形状）、列表（`list: "bullet"|"number"` + bullet 三级字符差异）
-- **view 升级**：stats 增加 `images` 计数、图片段落/形状标注 `（图片）`
-- **preview 预览**：三格式含图片标注
-
-**bridge 侧**（aws-client-agent-mcp）
-
-- 新建 `src/office/office-image.ts`：`officeResolveImageSource(source)` 支持三种图片来源（data:image URL / http(s) URL / 工作区路径），含魔数校验和严格格式约束；`prepareOfficeImageCommands(commands)` 预处理 office_edit 命令中的 props.source → imageBase64
-- `mcp-server.ts`：`officeEdit` 新增调用 `prepareOfficeImageCommands`，使图片 URL/路径自动解析为 base64 上行 Java 引擎
-- `mcp-tools.ts`：`OFFICE_EDIT_TOOL` 描述重写为三格式完整能力清单 + 图片通用规则 + 使用要点；props schema 补充所有新增字段
-- 测试 `office-image.test.ts`：11 测试全通过
-
-## v1.9.155
-
-_发布日期：2026-09-13_
-
-- Office 文件能力面板化（与 pencil / draw 画布面板同款体验）：Agent 可在 Dashboard
-  面板中实时查看自己创建/编辑的 Word / Excel / PowerPoint 文档。
-  - aws-client-agent-mcp：office 工具组新增 3 个面板工具——`office_open_document`
-    （校验工作区文件存在并返回 file/kind/sizeKb/workspacePath，驱动前端打开面板）、
-    `office_close_document`（收起面板）、`office_list_open`（列出本会话已打开的文件）；
-    `office_create` / `office_edit` 返回值补充 `kind` 字段，供前端时间线提取器维护
-    文件列表（Agent 行徽标计数）；工具描述同步引导「打开面板即可实时看到编辑效果，无需截图」。
-  - aws-mcp-server：`OfficeToolHandlers` 注册同款 3 个 handler（open 校验扩展名并归一
-    kind；close/list 为轻量信封），`TOOL_NAMES` 扩为 8 个——office 能力门禁
-    （`checkAbilityGate`）自动覆盖新工具；新增 `OfficeToolHandlersTest`（8 用例）。
-  - aws-dashboard：新增 `OfficePanel.vue`（docx 用 docx-preview、xlsx 用
-    @vue-office/excel、pptx 用 pptx-preview 本地渲染，注册 workspace watch 后经
-    FILE_CHANGED 事件自动刷新，头部按类型显示 Word/Excel/PPT 彩色徽标）；
-    `useAgentTimeline` 新增 `extractOfficeDocInfo`（解析逻辑抽为可单测的
-    `officeTimeline.ts`，覆盖 call_tool 懒加载包裹形态）；index.vue 完成桌面/移动端
-    面板挂载、可拖拽宽度注册（office: 720/480/1200）与 Agent 行 Office 徽标按钮；
-    ChatPanel office 卡片新增「面板打开」入口（卡片载荷携带 filePath/workspacePath，
-    同工作区时可直接在面板中打开原文件）。
-  - 修复 `writeOfficeFileAtomic` 对非法 Base64 静默解码的存量问题（Node
-    `Buffer.from(x,"base64")` 宽容语义），改为严格字符集 + 长度校验后再解码。
-
-## v1.9.153
-
-_发布日期：2026-09-12_
-
-- 工具集懒加载（Lazy Tool Expansion）全链路接入：受管控的大工具集（pencil / draw 各 15 个、
-  启动项 9 个、招聘、浏览器 / 桌面桥接等）由「开启即全量暴露」升级为三态能力开关——
-  disabled（禁用）/ collapsed（收纳：工具不出现在工具列表，需先 expand_tools 展开）/ expanded（展开：工具全量直接可见），
-  降低初始上下文占用。
-  - aws-mcp-server：`t_agent_ability_switch` 新增 `ability_state` 列（update.sql v1.30.0 迁移，存量行按
-    `enabled` 归一：1→expanded / 0→disabled，既有 agent 行为不变），`AgentAbilitySwitch` 实体 / Mapper /
-    Service 三态读写，`enabled` 布尔列写入时同步回填保持旧读取兼容。缺省口径（DB 无行）：
-    browser / desktop / agentSys.launchItem / agentSys.hire 默认 collapsed（已授权但收纳），其余默认 disabled（显式授权）。
-  - aws-client-agent-mcp：新增常驻元工具 `expand_tools` / `call_tool`（不属于任何受控组，收纳组始终有展开与调度入口）。
-    ListTools 按三态过滤；展开不再把工具注入 runtime exposedTools、不再推送 tools/list_changed（ListTools
-    载荷字节级稳定，LLM provider 前缀缓存全程命中），改为授予 call_tool 调度授权并把工具定义
-    （name/description/inputSchema）随 expand 结果下发，agent 当轮即可 call_tool 调用；执行期纵深防御：
-    disabled 拒绝、collapsed 未展开拒绝（同时兜住原生工具名直调的旁路）。配置为 expanded 的组不可在会话中
-    收起（由用户决定）、重复展开按幂等 already-expanded 返回。browser / desktop 桥接能力经 HTTP 回传
-    bridge 新端点 `/runtime/sessions/:agentId/capability-tools[/call]`（X-Runtime-Token 鉴权），call 超时
-    55s < runtime mcpToolTimeoutMs 60s。
-  - acode runtime：系统提示词注入能力清单（新增 capability-prompt.ts）——agent 知道哪些能力已展开 /
-    已收纳 / 未开启，「我没有绘图工具」类请求会主动提示用户去能力配置开启；启动期 env 兜底改为携带三态值
-    （AWS_LAUNCH_CONFIG_TOOLS / AWS_HIRE_TOOLS / AWS_DRAW_TOOLS 等），消除首次 listTools 早于 token 就绪时
-    env 兜底把收纳组全量暴露的窗口。
-  - aws-dashboard：能力配置弹窗新增三态选择器（新组件 FeatureStatePicker.vue），capability-features.ts
-    升级为三态模型（agentSys 主开关禁用时子能力级联禁用，跨层与 Java / bridge 口径一致）。
-- Provider 请求失败不再默认无限重试：requestRetryCount 缺省由无限改为 0（持续 4xx 等不可恢复错误不再空转），
-  错误信息从响应载荷提取 code + message 直接抛出，不再被静默重试吞掉；需恢复内部重试时在 config 显式配置
-  requestRetryCount（有限值或 -1 无限）。
-- 消息中心「完整请求体」JSON 树视图：新增 JsonTreeNode.vue（层级树形展示、逐层懒展开）与 jsonRepair.ts
-  （截断 JSON 修复兜底，修复后可解析即以树形呈现），60KB 截断请求体支持全文搜索——输入防抖 200ms、
-  命中计数、回车逐个定位、自动展开命中祖先链并高亮，未解析为 JSON 时回退原始文本。
-- 图片预览缩放：新增 useImageZoom.ts（滚轮 / 双指缩放、拖拽平移、双击还原、缩放工具栏），接入 ChatPanel
-  全屏图片预览与 MessageInput 附件预览。
-- draw 卡片预览自愈：新增 drawCardPreview.ts 幽灵渲染管线——服务端从未渲染的 draw 消息卡片以发送者
-  （owner）身份补渲染生成预览，渲染成功事件即时补拉；pencil / draw 卡片渲染图 30s 定时补拉自愈
-  （消息离开列表即停止），有图即终态。
-- 杂项：.gitignore 补充审查 / 调试期临时产物（tsc / TAP 输出、一次性统计脚本、本地 AI 助手工作区）；
-  修复 draw.ts 头注释在编辑中被截断损坏的问题。
-
-## v1.9.152
-
-_发布日期：2026-09-10_
-
-- 绘图（draw.io）能力全链路接入：新增「绘图 (draw)」能力开关（默认关闭，显式授权语义，同 desktop/hire/pencil），
-  Agent 可创建 / 编辑 / 导出 / 分享 draw.io 绘图文档，Dashboard 以独立面板内嵌官方 draw.io 编辑器。
-  - aws-mcp-server：新增 `t_draw_doc`（doc_id 唯一，`doc_xml` 为完整 `<mxfile>` 权威内容）、
-    `t_draw_doc_member`（协作权限 read|write）、`t_draw_doc_change`（事务型 Outbox 变更日志，与内容写入同事务
-    落行，每 doc 保留最近 200 版；变更通知只作唤醒信号，丢失/离线时经 `draw_get_changes(sinceVersion)` 追赶）；
-    `DrawDocController` 暴露 `/api/draw/*`（docs / doc / doc ops / doc render / counts / doc members）；
-    `DrawDocMapper` 以 `doc_id + version` 乐观锁 CAS 写回，消除 check-then-act 竞态窗口。
-  - aws-runtime-bridge：新增 `DRAW_FEATURE_KEY` 能力标识与 `AWS_DRAW_TOOLS` 启动期 env 兜底；
-    `aws-client-agent-mcp` 注册 `draw_*` 工具组（create/list/open/close/get_diagram/get_changes/create_cells/
-    update_cells/delete_cells/delete_document/rename_document/share_document/revoke_share/export_document），
-    ListTools 按开关注实时过滤，服务端 `/mcp/call` 另有权威校验；`draw_export_document` 只回传
-    savedTo/sizeKb 等元信息，docXml 不回流 agent 上下文。
-  - aws-dashboard：新增 `DrawPanel.vue`（iframe 加载自托管 draw.io，经 embed postMessage 协议 load/autosave/export）；
-    会话列表新增绘图徽标（仅 Agent 有绘图文档时显示，附数量角标）；文档列表改为工具事件驱动刷新
-    （`drawRevision` 信号 + 防抖），取代每 2.5s 高频轮询 `/api/draw/docs`，仅在 WS 断线/未覆盖时低频兜底；
-    面板宽度与收缩优先级纳入 `draw`；移动端新增绘图覆盖层。
-  - 自托管编辑器资源置于 `aws-dashboard/public/draw/`（官方 draw.war 解包，v31.4.4，含 README 说明升级与授权注意），
-    并加入 Service Worker `globIgnores` 排除预缓存（app.min.js 9MB+、integrate.min.js 22MB+ 体积超预缓存上限，
-    仅打开绘图面板时按需加载）。
-- 消息卡片：`send_group` / `send_private` 支持附带 `card`（`{type:pencil|draw,docId,title?,description?}`）
-  文档引用卡片，`send_group`/`send_private` 工具描述同步说明。读取模型为「凭 docId 可读」——任何 Agent 拿到 docId
-  即可用 `pencil_get_tree` / `draw_get_diagram` 读取，无需被邀请；写操作仍按 owner / 协作成员权限校验。
-  为此 `PencilDocService` 的读取路径（readDoc / getTree / getRender / getChanges）去掉「非 owner/成员即拒绝」
-  的拦截，`resolvePermission` 返回 null 时读取归一为 read；新增 `validateCardDoc` 供卡片发送前确认文档存在。
-  卡片只读引用不写入 `*_doc_member`，因此不改变协作者列表、shared 标记与文档列表徽标。
-  `t_direct_message` / `t_group_message` 新增 `card` 列（LONGTEXT，防富内容截断），
-  `GroupMessageService` / `DirectMessageService` 增加带卡片的 8 参重载（原 7 参签名保留并委托，向后兼容），
-  卡片 JSON 落库前校验合法性（非法 JSON / 非对象直接拒绝，解析失败按无卡片降级渲染历史消息）。
-  Dashboard 侧 `ChatPanel.vue` 新增消息卡片渲染（仿小程序卡片：有渲染图显示预览、否则占位封面，
-  带类型徽标与标题，点击直接打开对应绘图 / 画布面板）。
-- 消息内容扩容 + 载荷剥离：`t_direct_message` / `t_group_message` / `t_meeting_message` 的 `content`
-  由 TEXT(64KB) 扩为 LONGTEXT——富格式内嵌图片 base64（压缩后数百 KB ~ 数 MB）在 MySQL 非严格模式下会被
-  静默截断到 64KB，Agent 经 `poll_message` 只拿到残缺 JSON、`JSON.parse` 失败，表现为 agent 看不到图
-  （`[image omitted]`）。配套在 acode runtime 的 poll 结果中剥离 directMessages/groupMessages 内嵌的
-  图片与附件 base64，仅保留可读文本摘要，避免 base64 以纯文本污染后续上下文。
-  Dashboard 发送侧新增 `buildRichAttachmentContent`——图片附件以内嵌 base64 随消息下发（Agent 直接以
-  多模态 data URL 读取，无需 fetch 图片 URL / 落盘再读），非图片附件仍为 URL 描述（语义等价 `[文件: ...]`），
-  这正是 content 必须扩容到 LONGTEXT 的直接原因。
-  新增 `ACODE_IMAGE_DIAG=1` 开启的图片注入诊断日志（默认关闭，异步追加且吞掉 I/O 异常）。
-- 发布前修复：群消息仅卡片（无正文）时 Java 侧校验误拒绝，已与 mcp-server 侧「content/attachments/card
-  至少其一非空」对齐；`draw_export_document` 工具 schema 与实现统一（仅 xml/drawio，svg/png 等渲染
-  待阶段 2 管线，描述不再误导）；`DrawPanel` 的 postMessage 接收仅接受同源自托管编辑器消息。
-- 原子写健壮性：`atomicWriteFile` 改用 `renameFileWithRetry`——Windows 下 `fs.rename` 可能因目标被瞬时占用
-  （杀毒扫描 / 并发句柄）抛 EPERM/EBUSY/EACCES，按 40ms 递增退避重试 3 次，降低实际运行与测试并发下的假失败。
-- 面板最大化（脱离为弹框）：新增 `PanelDetachButton.vue`，终端 / 时间线 / 工作区 / 上下文 / 待办 / 后台任务 /
-  子 Agent / 浏览器 / 画布等侧窗面板可一键脱离为弹框最大化，再点恢复回侧窗；脱离态保留强调色提示，
-  标签栏场景支持右对齐 sticky 固定，移动端隐藏（已是全屏覆盖层）。
-- 桌面工具 origin 判定明确化：`injectRememberedOrigin` 以 `originSet()`（非 null 且非 undefined）替代
-  `!= null` 判断，语义等价并消除隐式类型收窄告警。
-- 轮询降频：在线成员列表的断连兜底轮询由 5s 放宽到 30s（`ONLINE_CHANGE` WS 事件已支持增量更新，
-  断连时仅需兜底同步，无需高频拉取）；绘图文档列表同样由固定间隔轮询改为工具事件驱动。
-- 测试：vitest 单测超时由 30s 放宽到 90s——本机并行跑完整套件（103 个文件、真实 git/子进程）时 CPU 争用
-  可把单个用例拖慢数倍，避免负载型假失败掩盖真实回归；补齐 `draw_*` 工具、git 路由与 acode runtime 用例。
-
-## v1.9.151
-
-_发布日期：2026-09-07_
-
-- 工作区 LSP（TypeScript/JavaScript 语言服务）全链路接入：Dashboard 文件编辑器可对实例工作区的
-  TS/TSX/JS/JSX 文件提供语义级定义跳转与引用查找，不再依赖字符串搜索。
-  - runtime-bridge：新增 `typescript-language-server` 与 `typescript` 运行时依赖；`src/services/lsp-stdio-bridge.ts`
-    封装 LSP stdio 帧编解码（Content-Length 增量解析、畸形流防护）与子进程桥（自动解析 tls 入口、注入
-    TSSERVER_PATH 保证 tsserver 可启动）；`src/routes/lsp.ts` 暴露 `/ws/lsp` WebSocket——单 workspace 单进程
-    复用、60s 空闲回收、复用进程再次收到 initialize 时重建进程（避免 tsserver 沿用旧文档状态陷入
-    "No Project"、跳转恒空）。
-  - aws-mcp-server：`WorkspaceLspProxyService` 在 HTTP 侧校验 workspace 归属后签发 5 分钟一次性令牌
-    （TTL 放宽覆盖慢建连、消费即失效防重放）；`WorkspaceLspWebSocketHandler` 把浏览器 `/ws/workspace-lsp/{token}`
-    双向转发到 bridge `/ws/lsp`，隧道模式经 BridgeTunnelService 虚拟流、直连模式带 X-Runtime-Token 握手头；
-    `FileBrowserProxyService.resolveWorkspaceLspBridge` 解析 bridge 目标（保留隧道实例前缀）与鉴权令牌。
-  - aws-dashboard：`workspaceLsp.ts` 封装 CodeMirror LSP 会话——同一 bridge+workspace 仅建立一条 WS 与
-    一次 initialize，切换文件仅替换 per-file 句柄（didOpen/didClose），避免重复 initialize 导致跳转失效；
-    补充库未内置的 textDocument/references 与 definition 请求、自定义 transport 占位。`WorkspacePanel.vue`
-    接入 LSP 扩展、Ctrl+点击/快捷键跳转定义与引用查找；对 Windows 盘符修正 file:// 三层斜杠与 URI 归一比较。
-- 确认弹窗交互调整：确认按钮移至取消按钮左侧并作为默认焦点，Enter 键即触发确认，Tab 焦点循环顺序与
-  视觉排布一致（确认左、取消右）。
-- 工作区面板媒体预览：图片 / SVG / 视频预览改为经下载接口生成 object URL 展示，支持 B 站式画面缩放
-  （Ctrl+滚轮 / 缩放按钮）与按住空格+拖动平移放大后画面，双击复位；预览状态栏同步显示媒体尺寸与状态。
-
-## v1.9.150
-
-_发布日期：2026-09-07_
-
-- 长文引用（LTR）全链路化：私信超长文本粘贴不再全文进消息，改为引用上传——MCP 与 bridge
-  新增 `/api/ltr/upload`，把大文本片段落盘到目标机器 `<系统临时目录>/aw-temp/LTR/YYYYMMDD/{uuid}.txt`
-  （单篇 ≤512KB，按天归档、写入时顺带清理超 7 天的目录），消息只传 `[bridgeName:绝对路径]` 引用，
-  agent 用 read_file 读取全文，避免超长文本撑爆消息表（MySQL TEXT 65535 字节）与 LLM 上下文。
-  前端配套：粘贴转胶囊 token（发送时统一上传 + 进度提示、hover 预览全文、未上传时随草稿保留并在
-  切换会话后恢复）；LTR 图标与 capsule 颜色跟随主题。
-- 后台命令僵尸状态根治（L1–L4）：读路径对账（面板每次刷新先翻"磁盘 running 但本进程内存不命中"
-  的孤儿为 killed(runtime_crashed) 并原子回写）；状态写入事务化（per-agent 串行写链消除并发
-  heartbeat/finalize 的丢失更新）；生命周期补齐（exit+close 双监听，exit 后 2s 宽限强制 finalize，
-  孙进程持续持有管道不再留下永远 running 的状态；进程退出时落盘 killed(process_exit)）；running
-  任务心跳节流落盘（5s 或输出增量 64KB 触发）+ 启动时全量扫描所有 agent 目录孤儿。
-  面板改为只展示"真后台/运行中"命令，前台同步执行、从未转后台的命令不再占用面板。
-- open-pencil CLI 多路径探测：pencil_export_document 依次探测 `AWS_OPEN_PENCIL_HOME` →
-  `<工作区>/open-pencil` → 仓库相对路径 → 逐级向上回溯，未命中时错误信息列出全部探测路径；
-  README 补充生产部署前置（工作区锚点或环境变量二选一，须用仓库构建版 CLI 以支持 GraphSnapshot）。
-- create_meeting 有效性预检：角色占坑席位无可认领实例（如该角色唯一实例就是创建人）、或创建人把
-  自己重复加入受邀成员时直接返回错误，不再进入无谓的等待。
-- 群消息撤回语义修正：发送者本人游标越过已撤回消息仍可撤回；他人游标越过则拒绝撤回（撤回不再
-  被"阅读过即作废"误伤）。两项修复均补齐单测。
-- 输入框编辑体验：自建 undo/redo 栈（浏览器原生撤销对 contenteditable + 手动 DOM 不可靠），
-  mention / command / LTR 原子 token 可整体撤销；@mention 输入确认后自动把自由文本原地转换为
-  mention 高亮 token（`--cp-mention-highlight-*` 亮暗主题双套）；「调用式回复」更名为「强调回复」。
-- 文件下载回源文件名：下载/预览响应 Content-Disposition 改用上传时的原始文件名（URL name 参数），
-  并清洗控制字符、引号、分号与路径分隔符，避免 header 畸形与路径穿越。
-- 消息中心：项目在线成员列表去重（同一 agent 绑定多实例时不再重复头像）。
-- 健壮性：后台命令状态持久化失败仅告警不再崩进程；LTR 上传上游失败统一 502 且不回传内部错误细节。
-
-## v1.9.149
-
-_发布日期：2026-09-06_
-
-- 项目头像支持裁剪：PNG / JPG / WebP / GIF 位图在选文件或点击现有图标后进入方形裁剪
-  （拖动调整位置、滚轮或滑块缩放），以 512×512 输出确认保存；SVG / ICO 等无法用
-  canvas 裁剪的格式仍直接按原文上传；favicon 预览复用已下载文件，点击直接进入裁剪，
-  避免二次网络下载。
-- Pencil 嵌入式画布跟随 Dashboard 明暗主题：iframe URL 携带 theme 参数，主题切换时
-  经 pencil:theme 消息同步画布配色，不再固定白底。
-- 修复浅色主题下消息中心 agent 上下文用量 / 待办 / 子代理按钮的选中态样式：选中项
-  不再被浅色覆盖规则盖成深色文字（`:not(--active)` 限定浅色覆盖范围，避开高特异性
-  覆盖选中态）。
-- 「限制操作」入口从输入框左侧常驻盾牌图标移回「+」菜单（撤销 v1.9.148 的常驻盾牌，
-  并移除权限档位拉取与盾牌着色逻辑，简化输入框布局）。
-- 版本升级 1.9.148 → 1.9.149：Bridge 本包无运行时代码改动，随前端 Pencil / 消息中心
-  更新一并发布。
-
-## v1.9.148
-
-_发布日期：2026-09-06_
-
-- Pencil 导出 savePath 不再限制在工作区内：绝对路径（如 D:\exports\hero.svg 或
-  用户 Downloads）直接使用，相对路径仍基于工作区根解析——导出交付物可落盘到
-  任意位置。
-- Pencil 渲染缓存升级为原始分辨率（最长边 ≤8192 内不缩放，此前 1280），agent
-  pencil_export_image 与人工导出拿到原图；导出等待超时 8s→15s；升级规格后对旧
-  低分辨率缓存自动补渲一次。
-- Pencil 画板编辑锁：有写权限时默认锁定只读，点击解锁才可编辑；编辑中画布被
-  agent 工具/协作端推进版本时自动回锁并加载最新快照，防止基于旧版编辑整份覆盖
-  他人写入（脏写）；写权限被收回时强制回锁。
-- 输入框新增终端式 ↑/↓ 发送历史回溯（按会话隔离，Esc 退出并恢复进入前的草稿）；
-  「限制操作」入口从「+」菜单移到输入框左侧盾牌常驻图标，存在授权/禁止档位时
-  显示绿色。
-- 修复：侧板拖拽经过 iframe（画布/终端）宽度冻结且无法结束的问题（拖拽期间禁用
-  容器内 iframe 鼠标事件，窗口失焦自动结束拖拽）；全局设置菜单横向滚动两端留白
-  被吞掉的问题；项目头像弹窗标题显示项目名而非 projectId。
-- 更新健壮性：包内 CHANGELOG 缺目标版本段时继续尝试 ~/.aws-bridge 下运行时追加
-  的候选文件；更新成功后的发布说明追加改为 await 在重启前完成，版本号优先取 npm
-  刚落盘的 package.json。
-- 发布护栏：prepack-guard 校验 CHANGELOG.md 必须含当前版本段（缺段阻断发布），
-  verify-pack-contents 将 CHANGELOG.md 列为必需 payload。
-
-## v1.9.147
-
-_发布日期：2026-09-06_
-
-- Pencil 设计画布全栈接入：t_pencil_doc 权威存储（迁移 v1.26.0~v1.26.3）与协作者
-  权限、MCP pencil_* 工具（AWS_PENCIL_TOOLS 兜底可见性过滤）。
-- 桌面自动化增强：nuphus-mcp 0.1.12 的 desktop_window_activate 先还原再激活，修复
-  托盘/最小化窗口无法激活的问题；新增 som.rs 与 UIA 安全增强。
-- acode 新增 runtime-environment；后台命令/文件/图片工具优化，AcodeSdkAdapter 与
-  浏览器池稳定性改进。
-- 修复：CHANGELOG.md 自本版本起随包分发。此前发布说明依赖"执行更新的旧进程"运行
-  时追加，旧版 Bridge（≤1.9.145 无此代码）执行更新会导致新版本弹窗无发布说明可
-  展示，只能回退安装过程日志。
-
-## v1.9.146
-
-- 新增「本次更新内容」展示：将更新弹窗从安装过程日志（updates.log）切换为版本
-  发布说明（CHANGELOG.md），让用户看到本次版本相对变更的要点，而非 npm 安装
-  过程噪声。
-- 更新成功重启后，由 Bridge 自动在 CHANGELOG.md 顶部追加当前版本段。
-- 当目标版本未找到发布说明时，弹窗自动回退展示 updates.log（安装过程日志）并
-  给出提示。
-
-<!-- append-new-version-above -->
+# Changelog
+
+本文件记录 aws-runtime-bridge 各版本的发布说明，随 npm 包一并分发（package.json
+files 白名单），供调度中心「查看本次更新内容」弹窗按 `## v<version>` 精确切片
+展示。发布新版本时须在仓库中先写好 `## v<version>` 段（prepack-guard 校验缺段
+即阻断发布）；Bridge 自更新成功后的运行时追加仅作为包内缺段时的兜底。
+
+## v1.9.189
+
+_发布日期：2026-11-06_
+
+### 新增：语音表达指南工具组与 voice_guide
+
+新增 `voice` 收纳工具组（能力开关 `collaboration.voice`，默认收纳），组内提供
+`voice_guide` 工具：返回当前生效的 TTS 路由与协议、可用的情感方言（传统枚举 /
+自然语言风格）及其语法、音色目录及标签、多角色对话与停顿写法、语音转写用法。
+发送工具 send_private / send_group / transcribe_voice 不受开关影响，仍是常驻
+核心工具；带语音发送的结果新增 voice 块（合成元数据 / 受理票据 / 失败原因码
+与当前可用能力），agent 据此换语法重发，不必凭记忆猜方言与音色。
+get_send_status 票据终态统一为 send_completed（原 sent）。
+
+### 新增：桌面壳免登录通道（shell pair 全链路）
+
+- 外壳在拉起 sidecar 时注入每次启动随机生成的共享令牌（AWS_BRIDGE_SHELL_TOKEN，
+  仅存在于壳主进程与 sidecar 内存，不落盘）；bridge 视图的所有请求凭
+  `X-Shell-Token` 头 + 回环来源校验放行，桌面用户不再经过 /login；
+- 新增 GET /runtime/shell/status 与 POST /runtime/shell/pair：壳内工作台页面
+  可查询本机配对状态、凭配对票据直接完成配对（票据兑换 → 写盘 → 防抖重注册），
+  免去重启 Bridge；未注入令牌（服务器部署 / 旧壳）时行为完全不变，仍走面板会话；
+- 面板会话从 24h 改为 30 天滑动过期并持久化到 panel-sessions.json（0600）：
+  bridge 重启、崩溃自愈、升级换包不再丢登录态。
+
+### 新增：注册客户端指纹（防逆向可观测）
+
+bridge 注册时自报 clientVersion 与入口文件 sha256 前 16 位（字节码形态下哈希
+真实代码 index.jsc）。服务端仅记录不校验：同版本号不同哈希即提示私改构建，
+供 SQL 审计消费；旧版不上报为 NULL，行为不变。
+
+### 加固：浏览器 launchArgs 剥离调试参数
+
+浏览器会话 launchArgs（LLM 可传）经 sanitizeLaunchArgs 过滤
+--remote-debugging-port/pipe/address、--inspect、--inspect-brk、--debugging-port：
+防止把 Chromium 调试口开在本地被同机进程 attach。Playwright 自身 CDP 走 pipe，
+过滤后既有功能零影响。
+
+### 变更：payload 字节码分发兼容（内部）
+
+- dist 启动流程从模块顶层 await 收进 bootstrap()（payload 链路需 bundle 成单文件
+  CJS，esbuild 不支持入口 TLA），执行顺序与语义不变；
+- 新增 loadDynamicModule 统一动态加载入口：ESM（npm 包）走 import() 与原行为一致；
+  payload CJS 字节码产物走 require（含插件 reload 的缓存击穿：CJS 删 require.cache，
+  ESM 目标落同目录 nonce 临时副本），运行时 import() 在字节码下不可用的问题就此收敛；
+- koffi（win32 远程桌面）与 archiver（工作区 zip）改为惰性加载，消除 CJS 化后的
+  顶层 await。
+
+## v1.9.187
+
+_发布日期：2026-11-05_
+
+### 新增：子 agent 续聊 send_sub_agent_message（上下文保留的后续轮）
+
+终态子 agent 不再只能一次性使用：向已完成的子 agent 注入新消息即可开启新一轮，
+复用其全部上下文（终态后约 30min 保留窗口内有效），不必带着历史报告重新 spawn：
+
+- 新一轮结果照常经 await_complete / poll_message 两条通道投递，result 被新报告
+  覆盖；运行中/已释放（TTL 到期）的子 agent 拒绝续聊并给出明确错误；
+- 子 agent 禁止嵌套管理：send_sub_agent_message 加入管理工具黑名单，
+  不会进入可分配工具目录；
+- await_complete 取代 await_sub_agents 成为统一等待入口：一次 JOIN 等齐子 agent
+  （sub_agent_ids）与后台命令（bg_cmd_ids），超时_ms 是整个 JOIN 的总预算——
+  修复了混合等待时两段串行各拿满超时、最坏耗时 2× 的契约偏差；等待定时器
+  用后即清，不再给事件循环留 10min 挂起 timer；
+- 失败不再丢现场：await_complete 对 failed 子 agent 同时渲染 task_error 与
+  task_partial_output（失败前已产出的文本），不再二选一吞掉；
+- get_sub_agent_status 的 result 不再截断（完整报告 600 字回归锁定）；
+  hand-back 框架只作用于 await_complete / poll_message 两条投递通道，
+  不写入 store、不作用于 status 查询——报告全文带「模型输出、非用户消息、
+  不携带用户授权」声明并逐行缩进两格，防子 agent 输出伪造用户指令。
+
+### 新增：通知「已读 ⇒ 已交付」确认协议（邮件通知可靠投递）
+
+系统通知（邮件指针 mail_received 等）的已读语义整个翻转，杜绝「取到但没送到」
+造成的通知永久丢失：
+
+- 交付前不再预标记已读：通知随 poll/get_message 结果真正交付给模型之后，才经
+  mark_notification_read 上报确认（fire-and-forget，不阻塞结果返回）；确认失败
+  清除本地去重记录，服务端保持未读、下次 poll 重投同一条通知（at-least-once，
+  重复交付无害——通知只是「调用 read_email 读取正文」之类的指针）；
+- 邮件指针不受「任务型通知每拍一条」限流：未读邮件全量随拍交付，积压邮件
+  不再按拍逐封挤牙膏；
+- 阻塞中的 poll 被邮件等普通系统通知即时唤醒（独立于会议/任务的唤醒通道），
+  不再等满 30s 节流周期才感知；
+- POLL_MESSAGE_TYPES.md 同步更新：SubAgent 完成事件的 content 形状（hand-back
+  框架、Output 不截断、失败附 Partial output）与续聊协议说明。
+
+### 修复：语音工具描述与实现对齐
+
+send_private / send_group 带语音的终态发送结果（已送达/已按文字兜底/失败）
+本身就是定局、不带 ticket；仅超时受理（pending）才返回 ticket 走
+get_send_status 核销。此前的描述会让 agent 对每条语音多查一次状态。
+
+## v1.9.186
+
+_发布日期：2026-11-04_
+
+### 新增：语音消息发送状态查询/等待 get_send_status（私信与群聊通用）
+
+send_private / send_group 带语音不再让工具调用阻塞到合成结束：受理即落库、
+最多同步等待 20s——终态（已送达/已按文字兜底/失败）直接返回完整结果，
+超时返回 pending + ticket，任务留在后台继续。新增 `get_send_status` 工具凭
+tickets 查询或阻塞等待终态：
+
+- 可传 `wait_timeout_ms` 阻塞等待（全部票据到终态立即提前返回；到点未完返回
+  当前快照，不算错误），多条语音一次传齐统一核销；
+- 结果带 state/msgId/fallbackMsgId/error，群聊票据附 roomId/projectId、私信附
+  targetId，连发多条也能把结果对回具体消息；
+- 客户端等待上限封顶 270s：Node fetch(undici) 默认 headersTimeout=300s，
+  与服务端 300s 预算贴边必然网络层失败（与 create_meeting 同一道坑）；
+- acode 侧该工具归入轮询类（免 60s MCP 超时），适配层归为 idle（等待语音送达），
+  豁免 tool_using 5min 慢超时看门狗——否则 270s 等待会被强制恢复打断。
+
+### 修复：Windows 11 26200 上启动项端口徽标一直为空
+
+部分 Windows 构建对监听 socket 的 State 上报不稳定（node 绑定 ::/127.0.0.1 的
+监听项 State 为 null），`Get-NetTCPConnection -State Listen` 直接漏掉，vite 等
+端口徽标永远空。改为全量枚举后按「无对端（RemotePort=0）」客户端过滤监听项。
+
+### 修复：启动项端口徽标错过晚绑定的端口
+
+vite/spring-boot 的端口常在 start 返回后数秒才监听，原先只在建连时补探一次
+（固定 2s），错过即永久空。改为 5s 间隔续探（探到 / 进程退出 / 2 分钟窗口超时
+即停）；端口一经探到即缓存，后续状态帧不再把已显示的徽标清空；无订阅者时不再
+做后台续探。相关：工作区文件搜索/替换支持限定在当前显示目录（rootPath）。
+
+## v1.9.185
+
+_发布日期：2026-11-04_
+
+### 修复：已配对机器重启不再自毁配对（面板实例消失的根因）
+
+已配对机器（machineToken 自持凭据）优雅关闭时曾无条件调用 `/api/instances/unregister`
+注销实例，而 server 端该路径会整行删除登记行——`machineToken` 的 hash 就存在这一行上，
+行被删掉配对即被永久摧毁：重启后机器凭据注册被拒（invalid or revoked），面板上的实例
+也随之消失。本次两端同修：
+
+- Bridge：注销时识别机器凭据目标（machineToken / credentialType=MACHINE_TOKEN），
+  **跳过自删登记行**——配对身份必须跨重启存活；Agent 离线由隧道断开与服务端重启同步兜底，
+  真正下线机器请用管理页删除（Bearer 路径，带租户/负责人校验）；
+- Server：runtime token 自注销路径拒绝删除 MACHINE_TOKEN 行并返回明确错误
+  （兼容尚未升级的旧版 bridge，防止其重启时再毁配对）；token 无效时不提前泄露
+  实例的存在性与凭据类型，仍按既有路径走登录态校验。
+
+### 修复：票据里填写的实例名写回不再被旧主机名顶掉
+
+server 配对响应的实例名以票据建议名为权威，但 bridge 写回配置用的是
+`target.instanceName = target.instanceName || instanceName`——本机已有同址旧 target
+（instanceName 为历史主机名，如此前用 API Key 注册过）时票据名永远写不进本地配置；
+下次注册（配对后立即重注册或重启）机器上报旧主机名，server 又按请求名覆盖登记行，
+用户在票据里填写的实例名就丢了。本次改为**无条件写回 server 响应名**，票据名在
+本地配置与面板登记行之间保持一致。
+
+## v1.9.184
+
+_发布日期：2026-11-03_
+
+### 调整：后台命令上限 20 个，满额报错可操作并回显剩余名额
+
+后台命令名额此前只有 16 个，且满额报错只有一句「Kill or wait」——agent 不知道还剩多少名额，
+也不知道怎么腾位，本地命令通道因此被整段卡死（只能干等保留期过期）。本次把名额管理做成
+可见、可操作：
+
+- 单 agent 后台命令上限 16 → 20（运行中与 5 分钟保留期内已完成的命令都占名额）；
+- 满额时新命令明确失败（status=not_executed，不自动杀任务）：报错带 `20/20 slots in use`
+  实况与 `kill_background_command` 腾位指引，agent 按指引停止现有命令后重试即可继续；
+- `kill_background_command` 停止/清理命令**立即释放名额**（此前须等 5 分钟保留期淘汰），
+  「停止现有后台命令来执行新的」当场兑现；对已终态条目即清理占位，终态与输出不改写；
+  重复停止同一条目经磁盘记录幂等返回，「重置状态」重试不报错；
+- 每次 Bash 命令结果新增 `remainingBackgroundCommandSlots` / `backgroundCommandLimit`
+  （当前可执行的后台命令数），agent 随时可见剩余名额，提前腾位不再盲跑撞墙。
+
+### 修复：休眠唤醒在时间线上始终有「休眠恢复」凭证
+
+唤醒时按进度摘要接续上下文的三条路径此前在时间线上完全无卡片——`importTranscript`
+重放失败（降级摘要通道）、旧构建 runtime 不支持重放、休眠时仅存下摘要（无完整记录）。
+用户无法区分「唤醒了」和「全新启动」。本次适配层在带休眠上下文启动但正常重放卡片
+未发出时，自动补发一条「休眠恢复」兜底卡片（`transcript-replay-fallback-*`），
+文案按实际通道区分「重放未完成，已按进度摘要接续」与「已按进度摘要接续」。
+
+### 修复：机器级操作伪 agent 归属未登记时自动自愈，「AI 配置选中后立即回弹」
+
+`machine-*` 伪 agent（机器级管理操作如应用 AI 配置、工具安装）的目录可能早于多租户
+归属改造创建而没有 owner.json，归属校验 fail-closed 会让这类请求永久 403——前端表现为
+「AI 配置选中后立即回弹为未选择」。本次对**归属从未登记**的 `machine-*` 伪 agent 首次
+触达时按当前权威 scope 自动登记（登记后放行）；已登记归属（本人或他人）与真实 agent
+实例不适用自愈，他人实例仍 403，归属变更只能走受信入口。
+
+### 修复：插件卸载后不再「复活」，并发部署/移除不再互相覆盖
+
+共享插件清单此前是整表读-改-写：卸载写在旧快照上会把遗留层同名条目原样带回（卸载的
+插件下次部署对账时复活），并发部署与卸载互相覆盖丢改动。本次清单写入改为合并视图保真：
+
+- 卸载在遗留只读层仍登记同名条目时写入**移除墓碑**压制复活，展示/运行时链接/对账
+  一律走过滤墓碑后的活动视图；重新部署同名插件时整条替换墓碑自然清除；
+- 读-改-写持有 manifest 锁，并发部署/移除串行化，墓碑不再在写回时丢失；
+- 部署条目 `zipFile` 缺失时按空串消毒，不再抛异常。
+
+### 新增：崩溃自动休眠——运行上下文落盘保护，中断后下次启动自动接续
+
+运行中实例崩溃（进程死/机器睡/bridge 被杀）此前上下文全丢——对话只存在进程内存里。
+本次为 acode 实例引入休眠 journal（`~/.acode/hibernation/{agentId}.json`，与待办同区）：
+
+- **运行中节流落盘**：每个 turn 结束（≥10s 间隔）+ 长 turn 期间每 30s 由存活看门狗
+  补写一次完整对话与 token 用量；崩溃后磁盘上自然留存最近一次现场（可能丢最近几条）；
+- **启动自动接续**：启动时若 Java 未下发休眠快照且本机 journal 存在，自动重放上下文，
+  并在系统块最后注入中断提示（「遇到中断导致你进入了休眠，部分工作状态可能已经丢失，
+  请继续工作！」）；时间线先落「休眠唤醒中」卡，重放成功后出现「休眠恢复」卡；
+- **干净退出收尾**：正常停止/批量停止/bridge 优雅关闭在终止前做一次 clean 完整落盘
+  （零丢失）；`/runtime/stop` 新增 `discardContext` 参数，true 时删除 journal
+  （用户显式选择「停止（丢弃上下文）」）；journal 默认保留 7 天，启动时清扫超期文件。
+
+## v1.9.183
+
+_发布日期：2026-11-02_
+
+### 调整：voice 结果新增 protocol，agent 可感知情绪指令是否真的生效
+
+云端 TTS 现支持双 OpenAI 兼容协议：`/audio/speech`（CosyVoice2 等，指令级情绪）与
+`/chat/completions`（MiMo 等对话式音频输出，协议限制不支持情绪指令——指令会被当正文
+念出来）。两者的差异 agent 此前无法感知，`voice.emotion` 恒回显请求值，容易误以为
+情绪已经传达。
+
+- 发送工具结果 `voice` 新增 `protocol` 字段：`speech`（指令级情绪生效）/
+  `chat`（暂不支持情绪指令）/ `local`（本地兜底，仅语速与停顿）；
+- `voice` 新增 `emotionApplied`：情绪是否真实作用于本条语音的最终事实
+  （chat 与 local 为 false）；
+- `voice.emotion` 参数说明改为按 protocol 区分语义，agent 发送后即可判断
+  「这条语音到底有没有带上情绪」；
+- 会话 profile 注入全局提示词的语音能力说明由服务端按当前配置实时生成
+  （协议状态、字数上限、emotion 是否生效），agent 会话创建即知道能力边界，
+  不依赖工具描述里的静态说明；配置中途变更由逐条发送结果自我校正；
+- 语音消息载荷（`voice.protocol`）同步写入，前端/排查可定位音质来源；
+- 协议类型由站点「语音合成」配置显式指定（speech/chat），不再按接口路径猜测。
+
+## v1.9.182
+
+_发布日期：2026-11-01_
+
+### 新增：配对成功即生效，无需重启 Bridge
+
+`awsb pair` 成功写盘后，CLI 会调用本机运行中 Bridge 的回环端点
+`POST /runtime/pair-applied`，让它立即用磁盘上的最新配置重新注册并重建隧道。
+此前配对只写盘、长期运行的 Bridge 只在启动时注册，不重启就永远显示「隧道未连接」。
+
+- 端点只认回环来源（与 `/binding/request-token` 同口径），并做单飞防抖：
+  上一轮注册未结束时直接复用，不会并发跑两趟 autoRegister；
+- 立即应答、注册在后台进行（含重试可能耗时数秒），面板「等待连接」轮询如实反映结果；
+- Bridge 未运行（首次安装尚未启动服务）或是旧版本（404）时通知静默失败，
+  CLI 回落为原有的 `awsb service restart` 提示。
+
+### 修复：transcribe_voice 工具有声明无分发
+
+`aws-client-agent-mcp` 早已声明 `transcribe_voice` 工具，但 `mcp-server` 的分发
+分支漏接，调用一律落到 Unknown tool。ASR 推理在服务端容器执行，这里补上
+`callAgentScopedTool` 转发（自动注入 agentId），agent 侧语音复听/转写校验恢复可用。
+
+### 调整：voice.emotion 说明对齐云端指令级情绪
+
+工具描述从「只影响语速与句间停顿」改为区分链路：云端合成按自然语言指令真正
+改变语气（开心/兴奋/平静/低落/郑重），本地兜底只有语速与句间停顿。
+
+## v1.9.181
+
+_发布日期：2026-11-01_
+
+### 修复：插件等用户路由 403（agent-ownership-mismatch）
+
+`requireUserScope` 的解析优先级纠正：validateToken 已按凭据
+（connectionKey / runtime token）解析出的 `req.userScope` 必须原样保留，
+不再被请求头/体无条件覆盖。此前有两个问题：
+
+1. 携带合法凭据、但没带 `X-Tenant-Id` / `X-User-Id` 头的服务端调用
+   （如调度中心的插件代理）会被降级成 binding.json 的本机用户
+   `{tenantId:"_local"}`，与实例 owner.json 登记的真实归属永不相等，
+   `requireAgentOwnership` 一律拒绝——表现为插件面板一打开就报 403。
+2. 更严重的是「凭据决定的权威 scope」可被「请求自称的 scope」替换，
+   伪造请求头即可跨 target / 跨租户写入别人的用户命名空间。
+
+现在头/体身份仅服务于「无 target 凭据」的本机面板 / MCP 子进程链路，
+凭据解析出的 scope 拥有最高优先级。
+
+配套调度中心侧：`PluginProxyController` 发往 bridge 的代理请求补注
+`X-Tenant-Id` / `X-User-Id`（按 agent owner，与 RuntimeBridgeService
+同口径），本机面板/子进程链路不再缺身份头；插件面板错误提示优先透出
+bridge 返回的真实原因，不再被 "Request failed with status code 403"
+之类的 HTTP 概括语吞掉。
+
+## v1.9.180
+
+_发布日期：2026-11-01_
+
+### 功能：累计消耗 token（从 Agent 启动起）全链路
+
+此前面板只有「当前上下文」口径的输入/输出 token（覆盖式，压缩/清空会回落），
+没有「从启动到此刻一共烧了多少」的累计口径。本次打通 runtime → adapter →
+调度中心的全链路：
+
+1. **acode runtime 累计消耗**：新增 `totalInputTokens` / `totalOutputTokens`
+   累计字段（Σ 各次请求 provider 真实上报的 prompt/completion tokens，输入含
+   缓存命中），跨迭代、跨 turn 只增不减，压缩/清空不影响；与缓存命中计数同
+   口径——只累计真实上报值，文本长度兜底不计入，压缩摘要 LLM 请求（独立
+   fetch）不计入。`turn_complete` / `iteration_usage` 的 usage 覆盖式携带累计
+   快照，前端无需自行累加。
+2. **休眠唤醒跨快照延续**：休眠导出的 tokenUsage 快照（含累计与缓存四字段）
+   由调度中心落库，唤醒启动时经 `resumeTokenUsage` 回灌，runtime `start()`
+   重建 state 时以 `config.initialTokenUsage` 为累计初值——唤醒后继续累计而非
+   清零。普通启动缺省从 0 起；旧快照（无累计字段）按无 seed 处理，不阻断启动。
+3. **adapter / 终端路由透传**：`toUsage` 逐字段解析累计值（独立于 0/0 丢弃与
+   fallback 判定，不参与文本长度兜底）；`totalUsage` 字段级 presence 覆盖
+   （旧版 runtime 不带累计字段时保留现值，不清零不回落）；`resolveStatusChangeUsage`
+   在 input/output 为 0（如 seed 后、首个请求前）但累计已有值时也照常传出。
+   `getTotalUsage`（休眠导出通道）一并带出累计与缓存快照。
+
+配套调度中心侧：状态回调透传累计字段、AgentContextPanel 新增「累计消耗」区块、
+休眠快照表补列（cache_hit/miss + total_input/output tokens）。
+
+### 修复：唤醒请求的累计 token seed 解析
+
+`parseResumeTokenUsage`（与 `parseResumeTranscript` 同模式）只接受四个累计字段，
+非法/缺失字段丢弃、全部非法返回 undefined（累计从 0 起，不阻断启动），
+JSON 文本异常不会让唤醒流程失败。
+
+## v1.9.179
+
+_发布日期：2026-10-27_
+
+### 修复：注册成功后立刻拆掉自己的隧道并退出进程
+
+现象：日志依次出现「隧道客户端已启动」→「目标已不在配置中，停止旧隧道」→
+「未捕获异常: {}」→ 优雅关闭 → 注销实例。机器明明注册成功却连不上。
+
+三个叠加缺陷：
+
+1. **`instanceId` 预声明用了对象展开重绑定**（`config = {...config, instanceId}`）。
+   `autoRegisterAll` 用同一个 `config` 对象数组构造隧道「保留集」，重绑定后外层
+   仍持有旧对象，后续补上的 `credentialId` 传不出去。
+2. **`credentialId` 同样只改了局部变量**。于是一边按 `credentialId` 启动隧道、
+   一边按 `userKey 指纹` 计算保留集，键不一致 → 刚建的隧道被判定为「已不在配置
+   中」而拆除。两处均改为原地写回。
+3. **`teardownConnection` 先 `removeAllListeners()` 再 `close()`**。对仍在
+   `CONNECTING` 的 socket 调 `close()`，`ws` 会异步 emit `'error'`
+   （"WebSocket was closed before the connection was established"）；此时已无任何
+   error 监听，EventEmitter 把它抛成未捕获异常 → 进程级 `uncaughtException` →
+   整个 bridge 优雅关闭。现在保留一个忽略用的 `error` 监听。
+
+### 修复：未捕获异常日志只打印 `{}`
+
+`Error` 的 `message` / `stack` 是非可枚举属性，`JSON.stringify(error)` 只得到
+`"{}"`，此前根本看不出崩溃原因。日志格式化现在显式展开
+`name [code]: message` 与 `stack`。
+
+### 代码质量：lint 全量清零
+
+`npm run lint`（`eslint src --max-warnings 0`）从 89 error / 34 warning 降到 0 / 0：
+清理未使用导入与变量、修正 `import/order` 与重复导入；测试文件中的非空断言
+（`!`）按惯例在 eslint 配置里对 `**/*.test.ts` 放宽，避免为消除告警引入无意义判空。
+
+## v1.9.178
+
+_发布日期：2026-10-27_
+
+### 目标身份升级为 `credentialId`：轮换 Key 不再断链
+
+上一版用 `serverUrl + userKey 指纹` 作目标身份，解决了同址多账号并行；但**轮换
+API Key 会改变指纹**，导致 runtime token、隧道、注册状态、instanceId 全部重新开始
+（表现为换 Key 后 agent 找不到实例）。本版把身份锚点换成服务端下发的稳定凭据 ID：
+
+- `config.json` 的 target 新增 `credentialId` / `credentialType`，注册成功时由
+  服务端回填并持久化（与 instanceId 同一条回写路径）。
+- `targetKeyOfConfig` 改为 `buildTargetKey(serverUrl, credentialId ?? userKey)`：
+  有 credentialId 时身份不随 Key 变化；旧配置无该字段时仍回退 userKey 指纹，平滑迁移。
+- runtime token 存储、隧道槽位、注册重试、instanceId 反查统一用
+  `identityKeyOfConfig(config)`（credentialId 优先）。
+- **删除隧道鉴权的 userKey 兜底**：此前取不到 runtime token 时会把 userKey 当
+  token 发出去，服务端只认 hash 匹配必然 401，却掩盖了「未注册/注册失败」的真实
+  原因。现在明确报错并提示重新注册。
+
+### 同一调度中心地址支持多账号/多租户并行注册
+
+（承接 v1.9.177）身份模型继续保证：同一 `serverUrl` 下不同凭据各自独立隧道、
+独立 runtime token、独立 instanceId，互不覆盖。
+
+## v1.9.177
+
+_发布日期：2026-10-26_
+
+### 同一调度中心地址支持多账号/多租户并行注册
+
+同一用户加入多个组织（租户）时，同一台机器往往需要连接**同一个调度中心地址**、
+但使用**不同的 API Key** 各自注册一个实例。此前桥内以归一化 `serverUrl` 作为唯一
+身份键，同址两行会互相覆盖（隧道被拆、runtime token 串用、instanceId 写乱），
+面板因此直接拒绝保存第二行。
+
+本次把桥内身份模型从「地址」升级为「目标身份」＝ `归一化 serverUrl + userKey 指纹`：
+
+- 新增 `utils/target-identity`：`buildTargetKey(serverUrl, userKey)`，形如
+  `http://host:port#a1b2c3d4`（sha256 前 8 位，不落明文；可读、可作 properties 键）。
+  地址归一化（尾斜杠/协议大小写/`ws→http`/`localhost→127.0.0.1`/重复端口）抽到
+  `utils/scheduler-url`，由 `config`、`runtime-binding`、`target-identity` 共用一份实现。
+- **runtime token 存储**：`runtime-tokens.properties` 的键由 `md5(serverUrl)` 改为
+  目标身份键，同址多账号各存各的 token。旧键自动兼容读取；未指定 `userKey` 且该地址
+  只有一个身份时仍可命中（单目标老调用点无需改动），多身份时必须显式指定，避免串用
+  别的账号 token 造成「注册成功但回调 401」。新增 `listScopedRuntimeAccessTokens`。
+- **隧道**：`tunnels` Map 改按目标身份键控；同址不同账号各自一条隧道并存。
+  新增 `stopTunnelClientForTarget(serverUrl, userKey)` 精确停止单个身份；
+  `stopTunnelClientsExcept` 改为接收身份键集合；`stopTunnelClientForServer` 保留，
+  语义改为「停该地址下所有账号」。
+- **注册状态**：`registrationState.registrations` 键改为目标身份键，instanceId 互不覆盖；
+  新增 `resolveInstanceIdForTarget`。注销只清理本身份的 token/隧道/记录，其余身份保持注册。
+- **instanceId 回写**：只回写与本次注册身份匹配的那一行（此前按地址会把所有同址行写成
+  同一个 instanceId）。
+- **注册重试**：后台重试定时器按身份键去重，同址两个账号各自独立重试。
+- **面板去重规则**：由「同址即重复」改为「同址 + 同一 API Key」才是重复；同址不同 Key
+  属合法配置。去重校验移到「继承原配置」之后，因为编辑行留空 userKey 时真实身份要等
+  继承完成才确定。
+- **面板交互**：列表每行显示 API Key 掩码与租户 ID，便于区分同址多行；编辑行新增
+  `originalTargetKey` 精确指代被编辑的那一行（同址多行时仅靠地址无法定位），两行都留空
+  userKey 时按写入顺序逐条认领旧身份继承。
+- **目标解析**：`resolveSchedulerBaseUrlFrom` 返回值新增 `userKey`；歧义判定改用
+  「目标身份数量」而非「去重后 URL 数量」——否则同址多账号会被误判为单目标而静默选中
+  其中一个账号。新增 `resolveTargetIdentityFromToken` 按 token 反查身份（含地址与
+  userKey），供入站回调确定该用哪个账号的凭据。
+
+> **兼容**：单地址单账号的既有配置行为不变；旧 token 文件（md5 键）继续可读。
+> 无需改动 `config.json`。
+
+## v1.9.176
+
+_发布日期：2026-10-25_
+
+### 工作区代码导航：语言服务 + 语法索引兜底
+
+- `/ws/lsp` 从「仅 TypeScript 单进程」升级为多语言模型：按
+  `工作区 + provider + clientId` 隔离进程，同一会话内跨文件复用；不同浏览器
+  标签/面板使用不同 `clientId`（tsserver、pyright 都不支持多客户端共享文档状态）。
+  进程池设并发上限（`AWS_LSP_MAX_PROCESSES`，默认 6）并按最久未用淘汰，断连后
+  保活 60s 供快速重连复用。
+- 新增 provider 注册表（`services/lsp/provider-registry`），覆盖 15 个语言服务：
+  TypeScript/JavaScript、Vue、Python、JSON、CSS、HTML、YAML、Bash、Dockerfile、
+  PHP、Java、Go、Rust、clangd、C#、Ruby。按扩展名推断 provider，统一
+  `languageId` 归并与启动参数拼装；新增 `services/lsp/uri-rewrite` 处理客户端与
+  服务端路径形态差异（Windows 盘符大小写、`file://` 编码）。
+- 新增 `GET /runtime/lsp/providers`、`POST .../install`、`POST .../uninstall`、
+  `GET .../task/:id`、`GET /runtime/lsp/processes`：npm provider 按需安装到
+  `.aws-bridge/lsp-servers`，安装进度可轮询，进程列表供排障。
+- 新增工作区语法索引（`services/workspace-index`）：以 tree-sitter 抽取声明与
+  导入，覆盖 12 种语言（TypeScript/JavaScript、Python、Go、Rust、Java、C、C++、
+  Ruby、PHP、Lua、Bash），提供定义/引用/符号/大纲查询。LSP 不可用时前端回退到
+  该索引，不因语言服务缺失而失去跳转能力。端点挂在
+  `/api/workspace-index/{status,build,query,drop}`，索引随工作区切换释放。
+
+> **兼容**：旧前端只带 `file`/`language`（无 `provider`/`clientId`）时按扩展名
+> 推断 provider、`clientId` 视为 `default`，行为与历史版本一致。
+
+### 桌面控制人工治理：急停与动作审计
+
+- 新增 `POST /runtime/desktop-control/:agentId/pause`（急停/恢复）与
+  `GET .../state`（控制状态 + 最近动作审计）。急停后所有 `desktop_*` 工具
+  一律拒绝（含读类），并产生 `rejected` 事件而非静默失败。
+- 动作事件流：`desktop_*` 调用映射为 `started`/`done`/`error`/`rejected`
+  四态事件，按 agent 维护 100 条环形审计缓冲，经远程桌面 WS 实时推送，
+  每个 agent 独立自增 `seq` 供前端排序与去重。
+- **坐标陈旧性校验**：截图成功后记录「坐标依据」（截图文件 + 时刻 + 可重放参数）；
+  带坐标的动作执行前，若依据超过 `AWS_DESKTOP_STALE_WARN_MS`（默认 60s），
+  用记忆参数重截一次并做内容比对——画面已变则在结果尾部追加警告（不阻断，
+  LLM 读到后自行重截），未变则静默刷新依据时刻。5s 内结果缓存，连续动作不重复校验；
+  sharp 不可用/截屏失败时退化为时间戳警告（安全方向）。
+- 状态为进程级内存态：Bridge 重启即自动解除急停（重启本身会终止桌面 MCP，
+  等效急停，无需持久化）。
+
+### 桌面安装包 sidecar 模式
+
+- 新增 `AWS_BRIDGE_APP_MODE=desktop` 与 `AWS_BRIDGE_LISTEN_HOST`：桌面态只监听
+  回环，不暴露局域网；未显式配置注册地址时默认走隧道（回环地址对外不可达）。
+- 端口探测改为「探测形态 = listen 形态」：指定 host 时只探测该 host，避免把
+  「别的进程占了通配、但 127.0.0.1 仍可绑定」误判为冲突导致端口无谓顺延。
+- 未设置这两个变量时行为与既有一致（通配绑定、服务器部署语义不变）。
+
+### Bridge 面板
+
+- 面板 HTML 拆分为独立模块（`routes/dashboard-theme`、`routes/dashboard-icon`），
+  主题令牌与图标不再内联在巨型模板字符串里，便于维护与复用。
+
+### 子 Agent 与工具组
+
+- `SubAgentManager` 等待结果时，store 查询失败不再让该项从结果中静默消失：
+  超时后按 `settled` 集合补报未终态项，避免「部分子 agent 结果莫名丢失」。
+- 工具组：新增命名分组与 `tools/list` 名称对齐校验（`named-group-tool-names-alignment`），
+  防止分组配置与实际暴露的工具名漂移。
+- `aws-client-agent-mcp` 补齐邮箱工具组（`send_email`/`list_emails`/`read_email`/
+  `reply_email`/`ack_email`）与 `list_project_members` 的转发分支，全部经
+  `callAgentScopedTool` 注入 agentId（防越权）。
+
+### 发布链路修复
+
+- **修复 `npm publish` 被自身守卫误拦**：`verify-dist-minified` 原先用
+  `code.includes("/**")` 判断「未混淆」。但本仓库把 HTML/CSS/内联脚本放在模板
+  字符串里（`DASHBOARD_HTML`、`THEME_CSS`），压缩后字符串内的 `/** ... */`
+  会原样保留（那是要发给浏览器的页面源码，不是 JSDoc），导致
+  `dist/routes/dashboard.js` 被误判并直接阻断发布。
+  新增 `scripts/source-comments.mjs`，基于 TypeScript AST + 字面量区间排除
+  判定「代码区注释」；`minify-dist.mjs` 的 .d.ts 注释剥离同步切到同一口径，
+  避免「剥干净了却仍被判为脏」。守卫对真实未压缩文件仍然拦截（已验证）。
+
+> **验证**：`npm run typecheck` 与 `npm test` 通过（137 files、1915 passed、
+> 3 skipped）；`npm pack` 端到端通过（780 files / 6.6MB，postpack 正确还原）。
+> 新增/覆盖 `workspace-index`、`provider-registry`、`uri-rewrite`、`lsp`、
+> `desktop-control`、`desktop-staleness`、`desktop-mode`、`sub-agent-manager`、
+> `named-group-tool-names-alignment`、`mcp-tools` 等用例。
+
+## v1.9.175
+
+_发布日期：2026-10-23_
+
+### 技术栈自动识别：扫描工作区生成启动项候选
+
+- 新增端点 `POST /runtime/tech-stack/scan`（body `{ workspacePath }`）：只读扫描
+  工作区标记文件，返回可直接创建的启动项候选（名称/类型/命令/工作目录/依据）。
+- 识别范围：`pom.xml`/`build.gradle(.kts)`（Spring Boot 走 `spring-boot:run`/`bootRun`，
+  有 wrapper 优先 `mvnw`/`gradlew`）、`package.json`（按 `pnpm-lock.yaml`/`yarn.lock`/
+  `bun.lockb` 推断包管理器，脚本按 dev>develop>serve>start 取）、`manage.py`、
+  `pyproject.toml`/`requirements.txt`（FastAPI 出 `uvicorn main:app --reload`，
+  uv/poetry 项目自动加 `uv run`/`poetry run` 前缀）、`go.mod`（根 `main.go` 出
+  `go run .`，否则展开 `cmd/*/main.go`）、`composer.json`（Laravel `php artisan serve`、
+  Symfony `php -S localhost:8000 -t public`），以及 `Cargo.toml`/`deno.json`/
+  `docker-compose.yml` 兜底为 generic。
+- 遍历全层级且尊重 `.gitignore`（规则引擎抽到 `services/gitignore.ts`，与文件浏览器
+  目录树共用同一实现）；依赖/构建/版本库目录（`node_modules`/`target`/`dist`/
+  `.venv`/`.git` 等）恒跳过。目录预算 4000，超限返回 `truncated` 并保留已识别结果。
+- 命中标记文件才读内容，单文件读取上限 64KB；候选 id 为「相对目录+技术栈+命令」
+  的稳定哈希，重复扫描结果一致。
+
+> **验证**：bridge `npm run typecheck` 通过；新增 `tech-stack-scanner.test.ts`
+> （16 passed）覆盖 Spring Boot/wrapper 平台分支、Maven 回退、Node 包管理器推断、
+> monorepo 子包、Django/FastAPI/uv 前缀、Go 单入口与 `cmd/*` 展开、Laravel/Symfony、
+> Cargo 可运行 crate 判定与 lib crate 排除、compose 兜底、.gitignore 排除、
+> 同目录多栈、id 稳定性。
+
+### Git 提交历史分页与快照保留策略
+
+- `POST /runtime/git/commits` 支持 `skip`/`limit` 分页：新增 `resolveCommitPageLimit`
+  / `resolveCommitPageSkip` / `sliceCommitPage`，一次抓取多取一条用于判定 `hasMore`，
+  避免整段历史一次性返回；保留不传 `skip` 的旧单页响应形状。
+- 全分支图按 `--branches --remotes --tags` 收敛引用范围，内部引用（如 cline
+  checkpoint）不再混入提交图；detached HEAD 通过显式 revision 保留。
+- 新增工作区快照保留策略（`snapshot-retention`）：默认不清理，面板下发保留天数后
+  按 mtime 删除过期快照；与 change-cache 复用同一节流（写缓存时 1h + 24h 兜底扫描），
+  配置变更立即执行一次。面板显式下发的值不会被迟到的 `config.json` 覆盖。
+
+### 终端与隧道稳定性
+
+- 隧道请求体分帧：请求体超过单帧上限（2MB WS 文本帧）时，server 改为 `req` 头帧
+  + `reqchunk` 数据帧 + `reqend` 收尾，bridge 侧按 id 归集拼装后转发本地服务；
+  半包请求带 5 分钟空闲超时，连接断开时清理残留缓冲。
+- 终端 SDK 作答/取消：新增取消作答链路（含可选原因），与回答共用幂等与回执；
+  `compaction_summary` 走独立推送通道，不进 `sdkOutputQueueBySession` 串行队列，
+  摘要流与主输出流互不阻塞。
+- 修复时间线重复卡片：仅刷新用量的 `status-change`（`iteration_usage` 等）不再
+  重放上一次 `ai_request` 动作；抽为 `isUsageOnlyStatusChange` 便于单测覆盖。
+- 终端「等待输入」判定抽到 `lastOutputLine` + `listWaitingForInput`：只取输出末行
+  做启发式匹配，纯读不消费输出游标，供压缩后重建资源快照给出「哪些终端卡在提示符上」。
+
+### Bridge 面板
+
+- 仪表盘时间统一按面板当前语言（中/英）与浏览器本地时区渲染，修复切换语言后
+  日期仍按系统语言、以及直接切 ISO 字符串导致显示 UTC 挂钟值的问题。
+- 自更新前增加确认弹窗，明确「更新会重启 Bridge、运行中的实例会停止、进行中的
+  任务会中断」。
+
+> **验证**：`npm run typecheck` 与 `npm test` 通过（130 files、1827 passed、
+> 6 skipped）；`git-commits-page.test.ts`（4 passed）、`tech-stack.test.ts`、
+> `snapshot-retention.test.ts`、`tunnel-client.test.ts`、`terminal.sdk-answer.test.ts`
+> 均通过。
+
+## v1.9.174
+
+_发布日期：2026-10-21_
+
+### 私信附件「存到对方机器」：bridge 临时文件通道
+
+- 新增 bridge 临时文件通道：上传的文件直接落到**接收方实例所在机器**的
+  `<系统临时目录>/aw-temp/ATT/YYYYMMDD/{uuid}{扩展名}`，服务端不落盘，
+  按天归档并在写入时顺带清理超过 7 天的旧目录。
+- 新增端点：`POST /api/bridge-temp-files/upload`（multipart 上传）、
+  `POST /api/bridge-temp-files/read`（按绝对路径读回字节）、
+  `POST /api/bridge-temp-files/delete`（删除临时文件）。
+- 落盘文件名用 uuid 而非原始文件名（原始名只回传展示，规避文件名注入）；
+  扩展名由原始名清洗而来，保留原扩展名便于 agent 判断读取方式。
+- 回传路径统一为正斜杠：Windows 的 `path.resolve` 接受正斜杠，跨平台一致，
+  且正文标记进 JSON 载荷时不会被反斜杠转义弄乱。
+- 修正 multipart 文件名在部分代理链路被 latin1 解读导致的中文乱码
+  （与工作区上传同一口径）。
+- 读/删接口做路径越界校验：只允许访问 `aw-temp/ATT` 目录树内的文件，
+  越界与不存在统一返回 404，不向调用方泄露目录结构。
+- 上传超限（>512MB）返回 413 与明确错误码，不落成 HTML 500。
+
+> **验证**：bridge `npm run typecheck` 通过；新增 `bridge-temp-files.test.ts`
+> （10 passed）覆盖上传落盘/扩展名保留/读回/越界 404/删除/正斜杠跨平台往返。
+## v1.9.173
+
+_发布日期：2026-10-21_
+
+### 上下文压缩后补齐「运行时资源事实」，修复命令失忆
+
+- 压缩后重建的运行时资源快照新增「当前打开的文档」一类：画布（pencil）、
+  绘图（draw）、Office 文档各自登记**面板当前开着的那一份**。此前快照只列
+  「存在哪些文档」，压缩后 agent 不知道用户正看着哪份文档，容易重复 open
+  或对着已被取代的版本继续改。
+- 打开状态由 bridge 侧按 agentId 维护（`open-doc-registry`）：依据工具调用流
+  登记 / 清除，随会话结束清理；识别直调与收纳态 `call_tool` 中转两种形态。
+- 终端快照补「waiting for input」状态：停在 ssh 密码提示等交互提示上的会话
+  单独标出（判定只取输出末行，历史输出里的旧提示符不误判）。
+- 浏览器条目补 `browserId`：同 agent 可有多个独立 chromium 实例，缺 id 时
+  agent 无法分辨「已开的那一个」。
+- 修复两条漏掉重建快照的路径：`resetContext`（对话还原到启动基线但真实资源
+  并未消失）与休眠恢复 `importTranscript`（预压缩同样会丢弃资源事实）。
+
+- 修复「面板事件顺序与真实运行态相悖」：LLM 同一轮声明 `poll_message` + 兄弟工具
+  （如 `get_profile`）时，`call_tool` 事件原在**准备阶段**按声明序发出，但 blocking
+  工具会被调度器排到**批尾串行**执行 —— 于是 poll_message 的「调用中」卡片先落库、
+  实际先跑完的兄弟工具后落库，面板最后一条停在 `get_profile`，而 agent 正阻塞在
+  poll_message。现改为「工具真正开始执行时」才发 `call_tool`，事件顺序即真实执行顺序。
+- poll_message 阻塞期间新增**面板事件矫正**：以 runtime 内部的阻塞型调用计数
+  （`hasActiveBlockingToolCall`，经 bridge `GET /runtime/sessions/:agentId/current-action`
+  暴露）为权威判据。该判据是运行时事实、不经事件流派生，故不会被兄弟工具的完成
+  事件覆盖；发现权威状态与本地 tag 不一致时补发一次 poll_message 事件矫正面板，
+  并保留 30s 冷却避免刷屏。无法判定（查不到会话/查询失败/无阻塞调用在飞）时一律
+  不矫正，宁可保持现状也不凭猜测改写面板。
+
+> **验证**：bridge `npm run typecheck` 与 `npm test` 通过（123 files、
+> 1775 passed、2 skipped）；`package/acode` legacy 套件 175 passed / 0 failed、
+> vitest 828 passed。事件顺序修复另行验证：`package/acode` 新增
+> `call-tool-event-order.test.ts`（3 passed）、`aws-client-agent-mcp` 新增
+> 面板矫正用例（mcp-server 162 passed / 0 failed）、bridge `npm test`
+> 1775 passed / 0 failed。
+
+## v1.9.172
+
+_发布日期：2026-10-21_
+
+### 上下文压缩重构、提问取消作答与消息中心体验收敛
+
+- ACode 上下文压缩改为「高保真级联」统一策略（完整摘要 → 降级 → 截断），不再由
+  前端勾选压缩类别；移除 `compaction-preview` 与「先行压缩」配置弹窗，输入区入口
+  直接启用开关，压缩范围由运行时决定。
+- 压缩摘要改为流式上报：runtime 逐 chunk 发射 `compaction_summary`，bridge 按
+  120 字符 / 120ms 积攒后推送，时间线实时滚动展示；摘要正文不落库（bridge 本地
+  环 Buffer、per-agent 事件存储、Java 事件表与运行日志全部跳过），刷新后不复活。
+- 修复压缩摘要与思考卡片互相打断、摘要尾部落到压缩结束事件之后、长摘要不跟随
+  滚动的问题；压缩摘要使用独立琥珀色卡片样式。
+- 修复 token 用量显示：启动/恢复/压缩后的估算值与 provider 真实值用
+  `usageEstimated` 显式区分，真实 usage 变小时不再被 20% 启发式误判为 fallback；
+  provider 未上报 input tokens 时不再把上下文清零。
+- 修复时间线重复卡片：`iteration_usage` 等 usage-only 状态变更不再重放上一次
+  `ai_request` 动作；工具结果先于调用到达时不再覆盖已完成的同名工具卡片。
+- 支持「取消作答」：提问卡片新增取消入口与可选原因，Java / bridge / ACODE runtime
+  全链路解除 Agent 阻塞并把取消结果回传模型；回答与取消共用幂等与回执持久化，
+  刷新后展示「已取消」只读态。
+- `read_file` 图片 URL 读取：以魔数为权威格式判据（签名 URL 的
+  `application/octet-stream` 不再被误拒），发送最小浏览器请求头规避图床 403/406，
+  URL 只保留 origin+path 写调试日志；运行时提示明确「URL 直接读，不要先 curl 落盘」。
+- dashboard：消息通知弹层新增提示音开关（Web Audio 合成、首次手势解锁、静音持久化）；
+  桌面通知权限入口移至消息通知弹层；移动端弹框最小化新增「飞向收纳按钮」动画；
+  普通终端打开期间按钮转圈防重复点击；长文本粘贴统一转为 txt 附件；文件引用图标与
+  工作区文件树同源；引用图标视觉修正。
+- 邮件：新增 `imapInternalHost` / `smtpInternalHost` 等后端内网连接地址（留空回退
+  客户端展示地址），配置自检展示实际生效地址；compose 为 James 增加
+  `mail.<mailDomain>` 网络别名，避免容器经公网/NAT 回环；邮箱别名改用 James
+  typed alias 路由 `/address/aliases/{目标}/sources/{别名}`，修复旧路由稳定 404。
+- 消息协作：`send_dm` 的 `replyToCallId` 未命中调用式消息时降级为普通私信并回传
+  warning（不再静默丢内容）；自动关联 pending call 失败时同样降级发送。
+- 修复 `sendOutput` 在 `skipLocalPersist` 路径于 `finally` 中 `return` 吞掉异常，
+  导致上层重试队列收不到失败信号的问题。
+- 内置 `db_connect_client_mcp` 源码随仓库提交（能力市场包仍以 esbuild 单文件
+  bundle 发布）。
+
+> **验证**：bridge `npm run typecheck`、`npm test`（121 files、1747 passed、
+> 2 skipped）与 `package/acode`（827 passed）、`package/aws-client-agent-mcp`
+> （561 passed）测试通过；Java `mvn test`（2057 passed）通过；dashboard
+> `npm run lint`、`npm run type-check` 与全部 `test:*` 脚本通过。
+
+## v1.9.171
+
+_发布日期：2026-10-20_
+
+### 消息协作、邮箱别名、同事观察与日志治理
+
+- 消息中心：发送改为乐观上屏（本地「发送中」→ 服务端 `sent`），网络/5xx/429
+  自动退避重试 3 次，失败气泡保留并支持「重试 / 编辑」；WS 回显按发送者+正文+
+  时间窗认领本地待发气泡；私信/群聊发送携带客户端幂等键，服务端按
+  `(sender, clientMessageId)` 去重，HTTP 响应丢失后的自动重试不会产生重复消息。
+- 群聊支持 @所有人（后端展开为房间/项目实际成员，提及记录与未读口径一致）、
+  结构化引用提醒（回表校验被引用消息作者，拒绝客户端伪造 `senderId`），并补充
+  引用提醒系统通知。
+- 新增角色实例邮箱「人类只读查看」（收件箱 / 已发送 / 详情，不改变 IMAP 已读
+  状态）与邮箱别名设置；别名更新改为「先建新远端映射、再删旧映射」，任一步失败
+  不会让旧别名提前失效，失败时补偿恢复远端状态。
+- 同事协作：`get_colleague` 增加在线状态、当前动作、工作区路径与邮箱概要；
+  新增 `list_colleague_events` 分页查看同事行为时间线（摘要视图，剥离工具输入/
+  结果原文），由 `collaboration.agentObserve` 能力开关控制（默认收纳）。
+- ACode 收口：AI 配置 / MCP 模板 / 终端 CLI 仅保留 ACode，移除 ClaudeCode、
+  Codex、OpenCode 的配置入口与文案。
+- 修复：`RuntimeBridgeService` / `RuntimeGlobalSettingsService` 保存 MCP 时补回
+  `instantiate` / `packageUrl` / `packageSha256` 字段，避免包型 MCP 初始化丢失。
+- 修复：清空角色实例邮箱别名改为显式 `SET address_alias = NULL`（MyBatis-Plus
+  `updateById` 会忽略 null 字段）；恢复心跳超时后的 Agent 异常离线告警。
+- bridge 日志治理：新增统一日志保留策略（lifecycle、MCP 子进程、AI 配置调试
+  日志，最长保留 7 天），启动即清理 + 每 6h 周期清理，面板下发值夹取到 1..7 天；
+  Java Debug 日志清理同步收敛为最长 7 天。
+- bridge 启动记忆加载抽为独立服务并复用；provider 请求体非法（确定性 4xx）时
+  落盘完整对话上下文快照（去重 + 保留最近 20 份），便于事后复现工具调用配对问题。
+- dashboard 接入标签页未读标题 / PWA 应用角标；页面隐藏时按私信、群聊 @、系统
+  通知弹桌面通知（同会话 4s 合并、点击跳转会话），权限申请放在个人菜单。
+
+> **验证**：bridge `npm run typecheck` 与 `npm test` 通过
+> （120 files、1724 passed、2 skipped）；Java `mvn -q test` 通过；
+> dashboard `npm run lint`、`npm run type-check` 与 99 个 `test:*` 脚本
+> 全部通过。
+
+## v1.9.170
+
+_发布日期：2026-10-17_
+
+### 能力市场与插件运行时落地，并发一致性与调试挂载修复
+
+- 新增能力市场：Java 侧 `AbilityMarketService` / `AbilityMarketController` 提供
+  模板上架、安装、卸载与“我的能力”清单，安装态以 `RuntimeGlobalSettings`
+  全局设置持久化；bridge 侧配套能力市场工具与 MCP 包探测、部署链路
+  （`mcp-package.ts`、`mcp-probe-client.ts`、`ability-market-tools.ts`）。
+- bridge 插件体系重构为 manifest / loader / runtime / listener-runner 分层，
+  统一插件清单校验、持久化目录部署与监听器生命周期，并补充插件开发指南与
+  插件系统设计文档。
+- dashboard 新增能力市场管理页与安装弹窗（含环境变量占位符校验）、Agent 状态
+  重置与上下文压缩弹窗，会话操作菜单抽取为 `chat-message-actions`。
+- 新增调试挂载（debug-mount）能力：会话建立时按需挂载调试资源，会话销毁
+  （含 SDK 会话清理各出口）统一调用 `clearDebugMounts`，避免残留。
+- 修复：`AbilityMarketService` 安装 / 卸载回滚快照在同一写锁内捕获，消除并发
+  写下的回滚竞态；`mcp-deploy` 增加名称合法性校验（拒绝 `.`、`..` 与非 basename）
+  并改用原子 rename 交换，清单 `fileName` 以实际下载文件名为准。
+- 修复：插件部署仅在全部候选迁移成功时才清理旧 `shared/` 目录，legacy
+  `zipFile` 经 `sanitizeArchiveFileName` 收敛，重命名失败不再误删目标目录；
+  插件处理器在启用 shell 且命令含 `{{...}}` 插值时改为 fail-closed 拒绝执行。
+- 修复：`package/acode` 运行时 `removeMcpServer` 同步清理 stderr 缓冲；手动
+  compact 优先级高于自动 `shouldCompact`，避免手动压缩计划被丢弃。
+
+> **验证**：bridge `tsc --noEmit` 与 `vitest run` 通过（1687 passed；仅
+> `src/browser/page-listener-nav.smoke.test.ts` 偶发 hook 超时，重跑通过，该目录
+> 未改动）；`package/acode` `tsc --noEmit`、`runtime.test.ts` 与 `compaction.test.ts`
+> 通过；Java `mvn compile` 通过，`AbilityMarketServiceTest`（31）、
+> `RuntimeBridgeServiceTest`（79）通过；dashboard `npm run lint`、`npm run type-check`
+> 以及 i18n / ability-market / dialogQueue 相关测试通过。
+
+## v1.9.169
+
+_发布日期：2026-10-12_
+
+### 多语言与消息协作增强，环境变量、邮箱与流程线能力整合
+
+- dashboard 接入 `vue-i18n`，提供简体中文与英文的自动识别、持久化、运行期切换
+  和 Element Plus 文案联动，并补充完整开发指南与语言资源测试。
+- 消息中心补齐消息复制、引用流、附件下载与反馈队列体验；能力范围、时间线顺序、
+  浏览器面板适配和会话分组等交互稳定性同步收敛。
+- dashboard 侧接通项目 / 角色 / Agent 三层环境变量配置、能力开关与邮箱管理界面，
+  并补充项目关系图导入、流程线交付物下载 / 回放 / 指派标签等能力。
+- bridge 启动测试统一跨平台命令进程 PID mock 输出，稳定 Linux CI 端口探测时序，
+  避免发布流水线因平台差异产生偶发失败。
+- 更新 Docker Compose 与邮箱部署、跨项目角色冲突、环境变量分层等文档。
+
+> **验证**：dashboard `npm run lint`、`npm run type-check` 与 `npm run build` 通过；
+> dashboard 新增 34 个测试脚本全部通过；bridge `npm test` 通过
+> （114 files、1621 passed、2 skipped）。
+
+## v1.9.168
+
+_发布日期：2026-10-11_
+
+### 发版稳定性：测试兼容、任务通知与连接生命周期修复
+
+本版本主要为发版验证中暴露的兼容性与稳定性问题收敛，既有功能契约保持不变：
+
+- `aws-client-agent-mcp` 的 `initialize` 返回完整工具组清单，能力开关三态
+  （`disabled` / `collapsed` / `expanded`）契约与 Java 侧保持一致。
+- `pipeline_task_assigned` 的 `SYSTEM_NOTIFY` 与持久化任务通知增加强制任务域
+  hydrate，首次落空时自动重试，避免重启或长轮询窗口内遗漏流程任务。
+- `.agentswork` 记忆目录搜索增加项目根与 Git 仓库边界，避免相邻项目目录串用；
+  `MemoryStore` 增加 domain 写入缓存，修复大量 domain 场景测试超时。
+- WebSocket 手动断开与异步 token 刷新重连之间的竞态修复，断开后不再重新排程
+  重连，非 CLOSED 连接句柄会被终止。
+- `RuntimeBridgeService` 的 SSE 客户端改为首次使用时初始化；同步迁移版本数、
+  `reply_to` 测试 schema 与 Direct/Group Message 控制器测试签名。
+- 测试命令增加 Node 测试进程强制退出兼容项，确保 CI 收尾不被子进程管道句柄
+  阻塞。
+- 修复 Linux CI 启动项端口探测用例的 shell PID / 命令进程 PID 替换竞态，
+  避免发布流水线因平台进程发现时序产生偶发失败。
+
+> **验证**：Java 后端 `mvn test`（1873 tests）、bridge 根目录测试、ACode 测试与
+> `aws-client-agent-mcp` 测试全部通过；`npm run build:all`、`npm run build`
+> 和 `npm run typecheck` 均通过。
+
+## v1.9.167
+
+_发布日期：2026-10-07_
+
+### Word 格式管控：OOXML 版式底座 + 信任机制（自动备份 / 保护区域 / 报告聚合）
+
+面向「生成复杂排版文档并严格把控」这一目标，分两条线补强 office 工具链。
+Java 侧新增 3 个 OOXML 助手并扩展 5 个，bridge 侧补齐备份、参数透传与工具契约。
+
+#### 1. 写盘前自动备份（改坏了能回滚）
+
+`office_edit` / `office_format(fix)` / `office_apply_profile` / `office_generate_from_template`
+直接改写用户文档，此前改错只能靠事先手动 copy。现在覆盖写盘前自动留一份
+`<基名>-backup-<时间戳><扩展名>`，滚动保留最近 5 份；回执透出 `backupPath` + `backupHint`。
+**另存到已有文件**同样先备份（等价于覆盖）。备份失败不阻断写盘（磁盘满/权限异常时
+不带该字段）；只清理严格匹配时间戳命名的文件，不会误删 `报告-backup-未命名.docx` 这类同名文件。
+
+#### 2. 保护区域：封面/题注/代码块不被正文规则触碰
+
+规则新增 `exclude`（支持 `/body/p[1]-p[14]` 区间简写与 `{path/from/to/style/contains/role}` 对象）
+与 `excludeByRole`，**check 与 fix 同源生效**。`summary.excludedParagraphs` 透出命中段数。
+`office_format` 另提供顶层 `exclude` 便捷入口（preset 场景下也能一次排除封面）；
+实现上复制 rules 再写入，不原地修改 preset 共享实例（否则会污染后续所有调用）。
+
+#### 3. 三套规则系统打通：profile 可直接当 rules
+
+`office_view(mode=profile)` 的产物此前**无法**直接喂给 `office_format`——启发式识别出的
+角色其 `match` 为空对象，`RoleMatcher.matches()` 恒为 false 且不回落到内置判定。
+现空 `match` 回落内置启发式，并新增 `unmatchedRoles`/`unmatchedRolesHint` 显式报出
+「既无 match 又非内置角色名」的规则（此前这类规则静默失效，是「配了规则却没反应」的根因）。
+推荐链路：模板 `view(profile)` → `office_format(rules=profile, exclude=[封面范围], action=check)` → `action=fix`。
+
+#### 4. 报告可读性：106 条平铺 → 可定位
+
+- 每条违规新增 `textDigest`（段落文字摘要），不必再按 path 反查原文；
+- `summary.byRole`（按角色聚合降序）、`summary.paragraphs`（按段落聚合，含该段问题属性列表）、
+  `summary.topIssue`（一句话摘要）。
+- 阅读顺序：`topIssue` → `byRole` → `paragraphs` → 需要细节时再读 `violations`。
+
+#### 5. `office_format(action=dryRun)` 与 `office_view(paths=[...])`
+
+- **dryRun**：按 fix 逻辑算出将改哪些项，返回 `willModify` + `nextStep`，不写盘、不返回字节
+  （bridge 侧即使服务端意外带回字节也直接丢弃）。注意 dryRun **不产生 `converged`**——
+  未真正修正就不能声称收敛。
+- **paths**：段落白名单（`/body/p[7]`、区间 `/body/p[5]-p[11]`），仅对 `styles`/`profile`/`selfcheck`
+  生效。大文档（几百段）下排查局部时把返回量从整篇压到几段。`profile` 的 `page`/`numbering`
+  来自文档级部件仍按整篇提取；`selfcheck` 的 `pageNo` 仍为真实页码。无法解析的 `paths`
+  一律回退为「不过滤」，避免空结果误导。
+
+#### 6. OOXML 版式能力补齐 + 4 个 P0 缺陷修复
+
+新增 `DocxLayoutOps`（分栏/页码分区/文档网格/titlePg/分页控制/中文排版开关/动态版心宽）、
+`DocxRunFormatExtras`（双删除线/小型大写/字符缩放/复杂文种字号/字体 hint）、
+`DocxFootnoteOps`（脚注尾注）；扩展 `DocxStyleOps`（样式创建**与改写**、字符样式）、
+`DocxNumberingOps`（多级编号/样式绑定/一键编号）、`DocxTableOps`（行高/cantSplit/表格布局/边框）、
+`DocxPaths`（`/body/table[T]/row[R]`、`/body/style[ID]`）。
+
+修复的 P0：
+
+| 缺陷 | 影响 | 修复 |
+|---|---|---|
+| `pageBreakBefore` 进规则但不被下游识别 | 标记 `fixable=true` 却写不进去 → **check 永不收敛** | `applyParagraphExtras` 委托 `DocxLayoutOps.applyParagraphLayout` |
+| `applyProfile` 编号硬编码 `numId=2` | 文档已占用 numId=2 时挂错编号定义 | 改用 `createStyleBoundHeadingNumbering` 返回值 |
+| bridge 从不读 `outputFile` | 描述承诺「标注版不覆盖原件」落空 | 接上 `outputFile`，缺省自动派生 `<原名>-标注版.docx` |
+| `fontSize` 走 `intProp` + `setFontSize(int)` | **10.5pt 被截断为 10pt**（论文图题/表题标准字号） | 按双精度写 `w:sz`+`w:szCs`（半磅精度） |
+
+另：`keywordCount`/`refCount` 角色级聚合断言从「只在描述里」补成真实实现
+（此前按描述配置会静默零违规）；selfcheck 分页识别补齐「显式分页符 + 段前分页 + 分节符」并修正
+**文本归属页**（段前分页段的文本此前被算进上一页）；标题级别判定兼容中文样式名「标题 N」与纯 `outlineLvl`。
+
+#### 7. 颜色值序列化：`STHexColor` 联合类型陷阱
+
+`w:color/@w:val` 的类型是 XMLBeans **联合类型** `STHexColor`——RGB 分支存 3 字节 `byte[]`，
+另一分支存字符串 `"auto"`，因此 `CTColor.getVal()` 返回 `Object`。
+`DocxStyleResolver` 直接 `String.valueOf(getVal())`，RGB 被渲染成 `[B@74a239d7`。
+
+**不只是显示乱码**：`OfficeRuleEngine.compareColor` 拿这个值跟期望值比对，
+任何带 `color` 期望的规则**都不可能收敛**（fix 写完复检仍报违规，`converged` 永远 false）。
+读取改走 `xgetVal().getStringValue()`（两类分支都正确），字节分支兜底手写十六进制。
+
+同根因的写入侧缺陷：颜色归一化一律 `toUpperCase()`，把合法的 `auto` 变成非法的 `AUTO`，
+被 XMLBeans 以「union value 'AUTO' does not match any members」拒绝
+（传 `color="auto"` 清色直接报错）。归一化统一收敛到 `OfficeArgs.normalizeColor` 单点权威
+（命名色表 + `auto` 保留小写），`OfficeDocService` 与 `OfficeRuleEngine` 都委托它；
+xlsx/pptx 无 `auto` 概念，走新增的 `rgbColorOf` 显式拒绝并给可读提示。
+
+顺带修复 `office_view(outline)` 两处同源缺陷：标题判定只认 `styleId` 以 `heading` 开头
+（中文模板「标题 1」与纯 `outlineLvl` 标题全部漏检）；表格节点只有行列数，现附加题注文本
+（先取表格前一段、再取后一段，按「表 X-Y」文本特征或题注样式判定，都不中则回退）。
+
+> **升级须知**：本版本无破坏性变更。`office_format` 的 `action` 枚举新增 `dryRun`，
+> 旧调用方不受影响；备份文件会在文档同目录产生额外的 `<基名>-backup-*` 文件，
+> 若不希望出现在工作区索引中，可在 `.gitignore` 加 `*-backup-????????-??????.*`。
+
+## v1.9.166
+
+_发布日期：2026-10-05_
+
+### 修复：submit_task_result 丢参导致循环节点恒被拒绝提交
+
+`handleSubmitTaskResult` 只向 `agentClient.submitTaskResult` 透传了
+`nodeId / outputPayload / changeLog`，而工具 schema 早已声明、服务端也早已消费的
+**`handoverNote` 与 `deliverables` 在这一层被静默丢弃**。后果：
+
+- 位于循环路径（模板 `require_handover=true`）的节点，Agent 即便按描述传入
+  `handoverNote`，抵达 Java 侧时仍为 null，`validateHandoverNoteIfRequired`
+  恒定抛「必须提供交接经验」拒绝提交 —— 表现为「nodeId 能识别、handoverNote 却
+  永远缺失」的固定失败，Agent 侧穷尽调用通道与字段命名均无法绕过；
+- 结束节点的 `requiredDeliverables` 同理永远收不到交付物，必填项必然判缺。
+
+修复内容：
+
+- **补齐 5 参透传**：`handoverNote`（`getOptionalString`）与 `deliverables` 一并
+  下发到 `agentClient.submitTaskResult(nodeId, outputPayload, changeLog,
+  handoverNote, deliverables)`。
+- **新增 `prepareDeliverables`**：逐项归一化交付物，文件类（`path`）复用
+  `uploadAttachmentFiles` 换取 `url/mediaType/size` 后回传，文本类（`text`）原样
+  透传；无 key 项与空数组安全忽略。服务端 `parseDeliverablesArg` 可直接消费。
+- **changeLog 放宽形态**：数组（MCP 已解析）与 JSON 字符串两种形态均透传，
+  原先只认数组、字符串形态被吞（服务端 `parseChangeLog` 本就两种都支持）。
+
+### 错误结构化：errorCode / field 回传给 Agent
+
+服务端校验失败原先只回 `{"error":"<纯文本>"}`，Agent 只能从中文长句里猜原因。
+现新增 `McpToolError`（携带 `errorCode` / `field`），`callTool` 抛出时保留，
+`McpToolError` 经 MCP 错误响应原样透出：
+
+```json
+{"error":"该节点位于循环路径…","errorCode":"HANDOVER_REQUIRED","field":"handoverNote"}
+```
+
+仅新增字段、不改 `error` 语义，向后兼容；Agent 可据此直接补齐入参重试。
+
+> **回归锁定**：`mcp-server.test.ts` 的 `submit_task_result` 分发断言原先只校验
+> 3 个位置参数（`["node-1","...",undefined]`），恰好把丢参行为固化，导致测试全绿
+> 而线上必然失败。现改为 5 参断言，并新增 handoverNote / text 交付物 / file 交付物
+> （打桩上传）/ changeLog 字符串形态四条用例。
+
+> **兼容性**：MCP 工具 schema 未变更，仅修复「声明了却不转发」的实现缺口；
+> 新旧服务端均可对接（服务端本就接受这两个可选字段）。
+
+## v1.9.165
+
+_发布日期：2026-10-03_
+
+### 浏览器画质档位：原画改为无损 PNG，高清 80 / 流畅 60
+
+原先三档都是 JPEG，所谓「原画」实为 JPEG q80；且 tile 差量路径把 CDP 帧解码后
+**再按同一质量重编码一次**，同一区域反复变化时有损伪影逐次累积。
+
+- **档位参数改为格式驱动**（`QUALITY_PRESETS` 新增 `format` 字段）：
+  - `original`：无损 PNG，像素级还原（`quality` 不生效）；
+  - `hd`：JPEG 80；
+  - `smooth`：JPEG 60。
+- **tile 重编码跟随档位格式**（新增 `frame-encode.ts` 统一编码入口）：
+  无损档位下增量块同样输出 PNG，不再被二次有损压缩；整帧与 tile 两条路径
+  共用同一实现，避免只改一半造成「整帧无损、增量有损」的错配。
+- **CDP 参数修正**：`Page.startScreencast` 仅在 jpeg 格式下携带 `quality`，
+  png 格式传 0 会被 CDP 判为非法参数。
+- **默认格式由默认档位派生**：原先 `DEFAULT_FORMAT` 写死 `'jpeg'`，与默认档位
+  `original` 冲突，会让会话初始状态变成「UI 显示原画、实际下发 JPEG q0」。
+- **单帧上限 2MB → 6MB**（`WS_DEFAULT_MAX_SEND_BYTES`）：1280×720 的无损 PNG
+  整帧可达 3.5MB 量级，沿用 2MB 会让高熵内容的整帧被静默丢弃，
+  表现为画面冻结并反复 resync。
+- **切换档位时丢弃差分参考帧**：格式变化会改变参考帧的编码语义，
+  沿用旧基准会把新格式首帧差分成跨格式 tile。
+
+前端同步：`createImageBitmap` 不再声明 `image/jpeg`（原画档位是 PNG，
+声明错误的 MIME 会选错解码路径，改由内容嗅探）；画质下拉文案标注「原画（无损）」。
+
+> **兼容性**：帧协议未变更（`createImageBitmap` 按内容嗅探格式），
+> 新旧前端均可解码；但旧 bridge + 新前端会失去无损能力（仍为 JPEG）。
+
+## v1.9.164
+
+_发布日期：2026-09-26_
+
+### 项目级 / 角色级能力层（inherited 层）：bridge 侧落地
+
+能力配置由「全局默认 + 实例覆盖」两级升级为**四层逐键覆盖链**
+（角色实例 > 角色 > 项目 > 全局默认），本版本承接 bridge 侧全部落地。
+解析权威仍在 Java（`AgentCapabilityService.buildInheritedLayers` 产出「项目 ⊕ 角色」的
+增量层），bridge 只负责存储与逐键取用：
+
+- **能力布尔（MCP / Skill / 插件）**：per-agent 文件由「平铺 map」升级为
+  `{ overrides, inherited }` 双子对象；旧平铺文件读作 `overrides`，向后兼容。
+  取值链 `overrides > inherited > 共享默认(config) > deployedDefault > false`。
+  新增整表替换端点 `POST /runtime/{skills|mcp|plugins}/deployed/inherited`
+  （`{ agentId, inherited }`，null/缺省 = 清空本层），由 Java fan-out 推送。
+- **工具三态（disabled / collapsed / expanded）**：新增内存层
+  `inheritedFeaturesByAgent`，`getFeatureState` 改为
+  `实例显式 > inherited > 内置默认` 逐键解析；**分组父门禁**在合并视图上判定
+  （父主开关 `disabled` 则子能力一律未授权），与 Java `AgentAbilitySwitchService`
+  同口径。
+- **分层推送互不覆盖**：全局改动只动共享默认、项目/角色改动只推 inherited、
+  实例改动只推 overrides —— 因此删掉本层键即可自然露出下层值，
+  「恢复跟随上层」得以正确工作。
+- `/runtime/start` 与 `POST /instances/:id/features` 同步接收 `inheritedFeatures` /
+  `capabilitiesInherited` 字段（undefined = 不改动，避免误清空其它实例的推送值）。
+
+> **升级须知（重要）**：低于本版本的 bridge 不认识 inherited 层，会回退到
+> 「缺名 = 启用」的迁移期路径，导致**上层已禁用的能力仍被启用**。因此本版本要求
+> bridge 与 Java 端同批升级；环境变量四层链（v1.9.163 起）不涉 bridge 存储，滚动安全。
+
+### 工具批次归组：阻塞型通讯工具移出「并行执行工具」
+
+`poll_message` / `create_meeting` 这类核心阻塞型通讯工具不再进入工具批次：
+
+- **移出批次**（不进批次根事件、不带 `batchId`、不计入 `tool_batch_metrics` 的
+  `toolCount`/`traces`），时间线上按普通工具扁平展示；执行本身不变，仍由调度器排到
+  批尾串行（`poll_message` 的 while(true) 阻塞等待语义不受影响）。
+- 动因：这两者与本批其他工具毫无并行收益，归进「并行执行工具」卡片会造成双重误导——
+  卡片名宣称并行、实测 `speedup` 恒为 1.00x；`poll_message` 的阻塞等待也会被错觉为
+  批次成员。之前的批调用把 `search_memory` 与 `poll_message` 并列，既无加速、又难看懂。
+- 批次成立条件收紧为「**批次成员**数 > 1」：若排除后成员不足 2 个（如
+  `poll_message` + 单个 `write_file`），则不发根事件与指标，时间线完全扁平。
+- 运行时新增 `isMcpBatchExcludedToolName`（`mcpToolNames.ts`）作为批次排除判据；
+  与「MCP 超时策略」集合 `isMcpBlockingToolName` 语义分离。
+
+配套 Java 侧（同批发布）：`ProjectCapabilityOverrideService` 项目层存储（
+`project_capability_overrides:{tenant}:{projectId}`）、`AgentCapabilityService`
+四层解析与 source 细化（agent/role/project/bridge）、`AgentAbilitySwitchService`
+三态四层 + 分组门禁、`RuntimeBridgeService` inherited 推送与 fan-out、
+项目/角色能力配置接口与新建项目草稿落库。
+
+### 修复：Agent 回到 waiting_input 后长时间"空闲"（每次任务后约 10min 死区）
+
+现象：角色实例状态徽章长时间显示"空闲"，而时间线最新事件停在"编辑文件"；
+期间私信/流程线任务完全不消费，约 10 分钟后才自行恢复。
+
+根因（`AcodeSdkAdapter`）：`turn_complete` 的"用户消息轮调用了工作工具"分支
+（`!autoPollActive && observedAnyTool && !observedPollingTool`）原本只做 `return`——
+既不派发空闲提示词、也放弃了重臂。而 `waiting_input` 下 turn 级看门狗不计时，
+会话遂无任何定时器在看守，只能等 10min 会话存活看门狗兜底。
+且重试轮（`retryFailedRequest`，`autoPollActive=false`）同样命中该分支，
+而该路径不重置观察标记，上一失败轮残留的 `observedAnyTool` 使分支必然成立 →
+**每次任务结束都固定触发约 10min 死区**。
+
+修复（保留"不立即派发"的节流意图，改为**延迟重臂**）：
+- 新增 `ACODE_DEFERRED_IDLE_REARM_MS`（默认 3s，env 可覆盖）与
+  `scheduleDeferredIdleRearm()`：分支 2 不立即派发空闲提示词，但延迟后重臂监听，
+  把死区从 10min 压到 3s。刻意走 `scheduleAutoPoll` 而非 `armIdleLoopOrAutoPoll`，
+  避免配置了 polling 类 idle 命令时被 `IdlePollLoop`（0ms）架空延迟。
+- `armIdleLoopOrAutoPoll` 重臂前清除待触发的延迟定时器（只清 timer、不动退避档位），
+  防止延迟重臂与正常重臂双发。
+- `retryFailedRequest` 与其它提交入口对齐，重置 `autoPollObserved*` 三标记，
+  消除跨轮污染导致的"重试轮被误判为用户消息轮"。
+
+## v1.9.163
+
+_发布日期：2026-09-25_
+
+### 三级环境变量（全局 / 项目 / 角色实例）→ 工具子进程 + MCP 配置
+
+环境变量由单一「面板全局层」升级为**三级合并**（角色实例 > 项目 > 全局，择近优先），
+合并结果随 `/runtime/start` 下发，作用于 bridge 管理的工具子进程与 MCP stdio 服务器配置。
+Java 侧 `EnvVarResolver` 为唯一权威计算点，本版本承接 bridge 侧全部落地：
+
+- **per-agent 环境变量存储**：`panel-env` 由进程级单例改为按 agentId 键控。此前最后启动的
+  实例会覆盖整个 bridge 的环境变量（多实例静默串味）；现在各实例独立，桌面工具子进程按
+  调用方实例取值，切换实例时经 env 签名检测触发重启应用新值（`ownerAgentId` 记录归属）。
+- **MCP stdio spec 注入**：MCP 子进程**不继承 bridge 的 `process.env`**（MCP SDK 的
+  `StdioClientTransport` 只带 HOME/PATH 等少数键），故新增 `mcp-env-injector` 把有效环境变量
+  写入每个 stdio server 的 `env`。优先级：**server 自身 env > 三级合并结果 > SDK 默认继承项**；
+  内置 `agents-work-studio` 与 sse/http 服务器跳过。acode（per-instance acode.json 装配）
+  与 Claude SDK 两条适配器路径均已接入。
+- **`${VAR}` 占位符展开**：stdio spec 的 `env` 值与远程 spec 的 `url` / `headers` 值中的
+  `${变量名}` 按该实例有效环境变量展开（如 `Authorization: "Bearer ${API_KEY}"`）；
+  未命中的占位符保持原样，便于在 MCP 启动失败信息中定位拼写错误。
+- **子进程 env 安全名单**：新增 `utils/env-safety.ts`，把原 plugin-manager 的
+  `BLOCKED_ENV_KEYS` 集中为单点权威并新增 `sanitizeEnvForChild`，在面板环境变量入站、
+  MCP spec 注入、桌面子进程显式覆盖层三处统一把关（挡掉 `NODE_OPTIONS` / `LD_PRELOAD` /
+  `PATH` 等执行流劫持与宿主关键路径键）。
+
+配套 Java 侧（同批发布）：`EnvVarResolver` 三级合并与「空串=屏蔽」解析、`t_agent.env_overrides`
+实例层存储、项目级 `project_env_vars:*` 存储与掩码读写、有效值预览接口、三级配置 UI。
+
+## v1.9.162
+
+_发布日期：2026-09-24_
+
+### 工具懒加载：browser / desktop 收纳态展开链路打通（关键修复）
+
+v1.9.153 起 browser / desktop 改为**收纳态不注入会话工具列表**（缓存稳定化的
+前提：LLM 请求的 tools 前缀字节级不变，provider 前缀缓存全程命中），工具定义改由
+`expand_tools` 结果下发、执行经 `call_tool` 回传。但回传链路在重构中被删除且未补回，
+导致收纳态（默认档）下：
+
+- `expand_tools({group:"browser"})` 从本地 `exposedTools` 取 manifests → 收纳态下
+  必然为空（工具按设计就没注入），agent 拿到 0 个工具定义；
+- `call_tool({name:"browser_navigate"})` 找不到工具名 → 直接报「未知工具」；
+- bridge 侧 `POST /sessions/:agentId/capability-tools[/call]` 端点恢复后**没有任何调用方**
+  （原 MCP Server 中继 `setBridgeCapabilityTools` / `handleExpandTools` 已随重构移除）。
+
+本次以**同进程中继**补齐（不改 tools/list 载荷，缓存稳定性不回退）：
+
+- ACode 新增 `CapabilityToolRelay` 契约（`tool-group-manager.ts`）+ 运行时配置
+  `capabilityToolRelay`（`types.ts`），`expand_tools` / `call_tool` 的桥接组分支经其
+  回传；本地组（pencil / draw / office / launch / hire / task / meeting / debug /
+  fileHistory）路径完全不变。
+  - 展开：先中继（`setBuiltInCapabilityTools(expand)` 刷新定义缓存并授予调度授权、
+    返回 manifests），成功后才置本地展开态 —— 中继失败可重试，不留半展开态；
+  - `group="all"`：桥接组经中继拉 manifests，`disabled` 静默跳过、单组失败不阻断其余组
+    （该组 `call_tool` 会被拒并提示重新 expand，自愈）；收起时桥接授权全部回收；
+  - 调度：`findTool` 落空且工具名归 bridge 托管时，按 `call_tool` 三道闸同口径的
+    本地预检（`disabled` 拒绝 / 未展开引导 expand）后执行 `callBuiltInCapabilityTool`。
+- `AcodeSdkAdapter` 会话启动时注入中继（同进程直连，无 HTTP、无 token 依赖；
+  HTTP 端点 `capability-tools[/call]` 保留供外部/兼容调用）。无 `agentId` 时不注入，
+  退化为本地查找（与启动注入的缺省兜底一致）。
+
+配套测试：acode `tool-group-manager.test.ts` 新增「capabilityToolRelay」12 项（展开
+manifests 来自中继、幂等、失败不留状态且可重试、disabled 不触中继、group=all 混合
+本地+桥接+disabled、收起回收、调度透传参数/未展开拒绝/disabled 拒绝/错误透传/
+非桥接未知工具不触中继）；bridge `AcodeSdkAdapter.test.ts` 新增端到端用例
+（启动注入中继 → `expand` 下发 manifests 且不注入 exposedTools → `call` 执行 →
+`collapse` 后调度被拒）。bridge 套件 1473 通过 + 4 跳过、acode 743 通过。
+
+### 工具组：ACode 短 key ↔ 能力 featureKey 错位修复
+
+`collaboration.*`（流程任务 / 会议 / 调试日志 / 文件变更历史）与 `agentSys.launchItem` /
+`agentSys.hire` 的工具组短 key（`task` / `meeting` / `debug` / `fileHistory` / `launch` /
+`hire`）与完整 featureKey 不一致，ACode 侧把「收纳」误判为「禁用」（实测确认）：
+系统提示词把已授权能力显示为未开启、`expand_tools` 直接拒绝。本次新增
+`GROUP_KEY_TO_FEATURE` 映射与 `resolveGroupFeatureKey()`（`instance-features.ts`），
+`capabilityState` 回调先归一再取三态；同时补齐父门禁级联
+（`collaboration` / `agentSys` 主开关 `disabled` 时其子能力一律 `disabled`），
+与前端清除子键、Java 门禁传播同口径。
+
+工具组归属推断同时加固（`tool-group-manager.ts`）：不再只认 `key_` 前缀，注册的
+精确 `toolNames` 先于前缀命中，`listToolManifests` 忽略 MCP 的 `serverName__` 命名空间
+取裸名匹配 —— `my_task` / `create_meeting` / `query_debug_logs` /
+`query_file_changes_history` 等非前缀命名的 MCP 工具组据此正确归组与下发定义。
+
+### 协作能力分组：默认收纳 + 父门禁级联
+
+`instance-features.ts` 新增 `collaboration` 主开关与 `collaboration.task` /
+`collaboration.meeting` / `collaboration.debug` / `collaboration.fileHistory` 四个子能力
+（默认收纳），ACode 侧注册同名工具组；四个分组在收纳态下不进 LLM 工具列表，经
+`expand_tools` 展开后由 `call_tool` 调度。
+
+### 工具并发执行（资源驱动调度）
+
+新增 `tool-concurrency/` 子系统（`types` / `resource-lock` / `scheduler` /
+`observability`），ACode 一条 LLM 响应返回多个 `tool_calls` 时按**资源冲突关系**
+并发而非按工具类型分组，并新增运行时配置 `toolConcurrency`
+（`enabled` 默认 true、`maxReadOnly` 默认 8、`maxBash` 默认 0=不限）：
+
+- 资源键层级（`file:` / 目录前缀 / `bash:` 等）与祖先-后代判定；区间重叠即冲突；
+- 同资源读写按读写锁串行，写-写互斥；未声明并发策略的工具（如 bridge 注入的
+  `browser_` / `desktop_`）默认独占串行 —— 关闭 `enabled` 即退化为旧的串行行为；
+- `ToolTraceRecorder` 记录每个工具的 waiting_resource / running / completed 时序并聚合
+  批次度量（墙钟、并行度、等锁总时长、竞争次数、加速比），`ConcurrencyLimiter` 提供
+  只读 / Bash 并发上限；
+- 文件工具声明资源键（`buildFileResourceKey` / `fileResourceClaim`），读 `read`、
+  写 `write`。
+
+### 文件写入 stale guard（陈旧写入拒绝）
+
+新增 `read-file-state.ts`：`read_file` 记录 mtime / size / 内容快照，`edit_file` /
+`write_file` 落盘前比对，文件在上次读取后被外部修改（且内容与快照不匹配）时拒绝写入
+并提示模型重读，避免并发会话/外部编辑器改动被静默覆盖。运行时开关
+`enableStaleFileGuard`（缺省启用，`false` 关闭比对；状态仅存内存，`stop()` 清空）。
+
+### 工具权限：新增 `fileModificationOutside` 档位
+
+「限制操作」新增工作区外文件修改权限（`fileModificationOutside`），
+`resolveAgentToolPermissions` 全 allow 兜底值同步补齐，热推路径显式下发默认值以
+清除历史限制。
+
+### 会话启动令牌吊销与运行时钟强化
+
+- `RuntimeGlobalSettingsService` 启动时吊销历史运行令牌，避免重启后旧令牌继续可用。
+- `terminal.ts` 抽出 `isIdleStatusChangeRetryable()`：`waiting_input` 纯状态切换
+  （`turn_complete` 仅带 usage、不带 `actionType`）也纳入 idle 串行重试队列，
+  修复该类状态切换漏到零重试路径的问题；原 `!params.actionInfo` 空判改为
+  `!params.actionInfo?.actionType`。
+
+### LTR 临时文件读取端点
+
+`POST /api/ltr/read`：按绝对路径返回 LTR 临时文本内容，安全校验拒绝 `LTR_ROOT`
+目录树之外的路径（防路径穿越），文件不存在 404、非文件 400、上限 512KB。
+
+### Agent Todo 重置与 acode-todos 路由
+
+`AgentTodoService` / `routes/acode-todos.ts` 支持重置（清空）会话待办列表，
+配套 `acode-todos.test.ts` 覆盖重置语义。
+
+### 空闲监听指令（poll_message）措辞收敛
+
+`MESSAGE_POLLING_IDLE_PROMPT` 改为显式前置条件：「此指令仅在当前没有未完成任务时生效；
+若仍在处理任务请忽略本指令并继续执行」，仅在确认无进行中/未完成任务时才调用
+`poll_message`，降低任务中途被空闲轮询打断的概率（三个 adapter 的单测改为从
+`prompts.ts` 导入常量，避免文案与断言再次脱节）。
+
+### 依赖与其它
+
+- `aws-client-agent-mcp` 新增 `temml`（Office 公式渲染）依赖，新增
+  `office_format` / `office_apply_profile` / `office_generate_from_template` 三个
+  Office 工具及 `office-equation.ts` 公式模块（含测试）。
+- `AcodeSdkAdapter` 恢复 `POST /sessions/:agentId/capability-tools[/call]` 路由，
+  `resolveAdapter(providerId)` 按会话 providerId 解析适配器；sessions 测试 29 项通过。
+- 版本号 1.9.157 – 1.9.162 为连续未发布开发周期（npm 上仍为 1.9.153），
+  本次一并发布。
+
+## v1.9.161
+
+_发布日期：2026-09-18_
+
+### Office 题注位置与回执提示修复（依据 v4 回归报告 N7/N8）
+
+**N7：`captioned_table` 题注位置对齐中文论文规范**
+
+中文论文（学位论文）规范要求「图题在下、表题在上」，本项目脚本产物同样如此；
+此前 `captioned_table` 一律把题注插在表格**下方**，用工具链重做论文逐页比对时会显现差异。
+现按元素类型区分默认位置：
+
+- `captioned_image`：题注默认在图片**下方**（行为不变）
+- `captioned_table`：题注默认在表格**上方**
+- 新增 `props.captionPosition`（`above`/`below`，兼容 `top`/`before`/`bottom`/`after`）显式覆盖
+
+实现：新增 `insertParagraphBeforeElement`（表题在上的插入路径）；章内序号统计按位置
+（章标题之后、插入点之前）计算，因此「表题在上」不改变编号连续性。
+
+**N8：`office_edit` 回执未透传服务端 warnings**
+
+服务端（Java）已在 `chapterHeadingStyle=false` 等场景返回 `warnings`，但 bridge 层
+`officeEdit` 组装回执时丢弃了该字段，使用者无法感知「F9 后编号不会按章重启」的风险。
+现原样透传 `warnings`（服务端未返回时不产生空数组噪音）。
+
+配套回归测试：`OfficeDocxPrecisionTest` 新增 4 个用例（表题默认在上、图题默认在下、
+captionPosition 显式覆盖、表题在上时序号连续）；bridge `mcp-server.test.ts` 新增 2 个
+用例（warnings 透传、无 warnings 时不含该键）。office 测试总数 179 全通过；
+Word COM F9 实测题注编号稳定（表1-1/表1-2/表2-1、图1-1/图1-2/图2-1）。
+
+### ACode 模型请求失败重试不再重置上下文
+
+模型请求超时/网关 5xx/看门狗中止后的重试此前会重新走主动压缩预检：一旦累计或估算
+用量越过阈值，与上下文大小无关的失败重试也会裁剪+摘要化历史，表现为「重试后上下文
+被重置」。本次修复：
+
+- **恢复式重试（resume，与失败请求逐字节一致）**：非溢出的普通失败（5xx/超时/看门狗）
+  后，适配器以 `resume: true` 恢复同一轮——不重发 prompt 钩子、不重复 push 用户消息、
+  **不回滚轮内进展**（工具结果/部分输出原地保留），基于与失败请求同一份 conversation
+  重建请求：重试请求与上次失败的请求逐字节一致，重试之前的状态不丢失。原先的失败轮
+  锚点回滚（`rollbackFailedTurn`）会把会话截回 turn 开始前、丢弃轮内已成功的迭代，已移除。
+- **轮级跳过压缩**：重试 submit 携带 `skipProactiveCompaction`（resume 隐含），覆盖整轮
+  全部 LLM 迭代，并同时约束 800KB 请求体字节上限截断（`truncateConversationIfNeeded`），
+  旧版 `markSkipNextCompaction()` 单次标记兼容保留；仅 provider 显式溢出信号（错误字段/
+  `finish_reason`）触发响应式压缩重建，413 溢出仍正常兜底——上下文改写只属于溢出响应。
+- **结构化溢出判定**：新增 `context-overflow.ts`（cause 链下钻 + 字段级标记 + 精选消息
+  片段），`length`/`max_tokens` 被输出长度标记独占短路，绝不因输出上限触发压缩。
+- **4xx 确定性错误短路重试**：invalid_request 类错误直接 `retry_aborted`（「请求无效」），
+  5xx/超时仍按指数退避+抖动重投。
+
+配套回归测试：acode `runtime.test.ts` 新增/强化 5 个用例（resume 重试请求体逐字节一致
+且不重复 push、中途失败保留轮内工具结果后 resume 与失败迭代逐字节一致、整轮跳过主动
+压缩、legacy 单次标记、重试轮跳过 800KB 字节截断而普通轮照常截断）；bridge
+`AcodeSdkAdapter.test.ts` 断言重试提交携带 `resume + skipProactiveCompaction`，并含
+4xx 短路与重试计数语义用例（套件 82/82 通过）。
+
+## v1.9.160
+
+_发布日期：2026-09-18_
+
+### Office 题注编号与格式检查修复（依据 v3 回归报告 N1-N6）
+
+**N1（高）：SEQ 域 `\s` 值写成了章号，F9 后含小节的章出现重复编号**
+
+`\s N` 的 N 是**标题级别**（1-9），不是章号。原实现写 `SEQ figure \s <章号>`，导致：
+含 H2 小节的章在每次小节标题处错误重启（实测 Word F9 后 图2-1 重复出现），
+第十章还会写出超范围值 `\s 10`。现固定为 `SEQ figure \s 1`（按 1 级标题重启），
+章号只体现于静态前缀；章内序号改为按「本章范围内、插入点之前」的实际域数量统计
+（`countSeqFieldsBefore`），与 `\s` 值彻底解耦。
+
+**N2（中）：题注按章重启依赖章标题具备「标题 1」样式，此前不校验也不提示**
+
+Word 的 `\s 1` 按**样式名为内置「标题 1」**的段落重启（COM 实测：仅补直接格式
+`outlineLvl` 或自定义名样式均无效）。而论文类模板常把章标题写成直排格式（无样式），
+此时 F9 后编号会跨章累计。修复：
+
+- `captioned_*` 在 `chapterTracker=auto` 时自动为识别出的章标题补「标题 1」样式
+  （新增 `DocxStyleOps`：找样式 → 套用并逐项还原差异 → 若仍不等价则回退到工具自建的
+  **最少格式「标题 1」样式**，保证可见外观零变化）
+- 新增 `props.chapterHeadingStyle=false` 可关闭自动补样式（回执带 `warnings` 说明风险）
+- `office_edit` 回执新增 `warnings` 字段
+
+**N3（低）：`props.heading` 传数字不生效（静默）**
+
+数字 `1`、字符串 `"1"`、`"Heading1"`、`"标题 1"` 现均可用；非法值（`"abc"`、越界 `4`）
+改为**显式报错**，不再静默不加样式。
+
+**N5：check 空段落噪音**
+
+`office_format` 默认跳过无文本段落（空段落/纯图片段落）的正文类检查与修正，
+summary 增加 `skippedBlankParagraphs`；`rules.blankParagraphPolicy="report"` 可恢复旧行为。
+实测重生成论文违规数 421 → 199（其中 222 条为纯空段落噪音）。
+
+**N6：preset 与模板实测口径统一**
+
+- profile 聚合修正「非空众数」偏差：此前 114 段中仅 1 段 `bold=true` 也会输出 `bold=true`
+  （回灌 apply_profile 会把全文错误加粗）；现按全量多数票取值，未显式设置的属性不输出
+- 新增 `OfficeFormatPresets.merge(base, overrides)` 与 `office_format` 的 `mergePreset=true`：
+  以 preset 为基线、实测 profile 逐键覆盖（page/rules[role].props/roles），
+  解决「preset 期望黑体 vs 模板实测宋体」的系统性差异导致的验收比对失真
+- 合并时归一「首行缩进/悬挂缩进」互斥（OOXML 中两者共存只有悬挂生效，会造成
+  check 期望与实际永不收敛）；写入端同步加固
+
+**实测验收**：模板实测 profile + preset 合并后，对重生成论文 check→fix→check
+收敛 219 → 0；对既有论文 179 → 0（此前因缩进互斥存在 12 条不可收敛残留）。
+
+配套回归测试：`OfficeDocxPrecisionTest` 新增 11 个用例（SEQ 恒定值、同章序号解耦、
+章标题样式自动补/外观保持/可关闭、heading 数字与非法值、空段落跳过与 report 策略、
+preset 合并与缩进互斥收敛、profile null 噪声）；office 测试总数 175 全通过。
+
+### office 卡片：指定文件强校验 + 预览链接服务端权威化
+
+**背景**：office 卡片的 `card.previewUrl` 此前由 agent 自报、bridge 与 Java 两端均无校验
+（纯透传），前端直接塞进无 sandbox 的 iframe——agent 可拼造任意地址（含站外页面）。
+同时卡片引用的文件是否真实存在没有任何服务端校验。
+
+**新契约**：office 卡片只能用 `filePath`（工作区路径）或 `docId`（云文档 id）之一指定
+文件，二者必居其一、不可同时传；`previewUrl` 从入参契约中移除，由服务端生成。
+
+- **bridge（发送前校验，失败即工具调用失败、消息不发送）**：`buildOfficeCardPayload`
+  重写——filePath 经 `packOfficeFile` 统一校验（存在/普通文件/docx-xlsx-pptx/≤16MB）后
+  上传，载荷换成 `{type,name,kind,fileUrl,sizeKb,title,filePath,workspacePath}`；
+  docId 路径本机零上传，载荷只带 `{type,docId,title?,description?}`；
+  两者同传 / 都缺 / 只传 fileUrl 均抛错。入参即使携带 `previewUrl` 也被丢弃。
+- **服务端（落库前权威校验）**：`McpToolHandler.toCardJson` 的 office 分支改为委托
+  `OfficeToolHandlers.normalizeOfficeCard`——校验 filePath/docId 二选一；filePath 路径
+  按 `fileUrl` 反解存储名并 `loadFile` 确认文件真实存在；docId 路径经
+  `OfficeCloudDocService.findDoc` 校验云文档有效（不存在则工具调用失败、消息不落库）
+  并回填 name/kind/fileUrl/sizeKb。
+- **预览由服务端生成**：取权威文件字节 → `OfficeDocService.buildPreviewHtml` →
+  `FileStorageService.storeFile("...-preview.html", ...)` → 服务端 `previewUrl` 写入卡片。
+  文件字节无法解析（损坏/伪装扩展名）时发送失败，杜绝「卡片指向不存在的文件」。
+- **工具描述**：`send_group`/`send_private` 的 `card` schema 删除 `previewUrl` 属性，
+  `docId`/`filePath` 描述改写为「二选一」口径；`office_preview` 描述改为「返回地址供自检/
+  留档，卡片预览由服务端生成」。
+- **dashboard**：新增 `utils/officeCardUrl.ts` 信任边界（`fileUrl` 只放行本站
+  `/api/files/` 地址，`previewUrl` 额外要求 `.html`；伪协议/携带凭据/站外链接一律拦截），
+  `ChatPanel.vue` 的预览按钮、点击、下载统一走该校验；预览 iframe 加
+  `sandbox="allow-same-origin"` 与 `referrerpolicy="no-referrer"`；卡片带 `docId` 时
+  「面板打开」直接按 docId 打开 Office 面板（跳过工作区路径匹配）。
+
+配套回归测试：bridge `mcp-server.test.ts` 新增 office 卡片 9 个用例（上传路径/预览地址
+丢弃/文件不存在/非 Office 扩展名/docId 零上传/二选一冲突/两者都缺/只传 fileUrl/DM 路径），
+`mcp-tools.test.ts` 新增 schema 契约 2 个用例；dashboard `officeCardUrl.test.ts` 7 个用例。
+
+## v1.9.159
+
+_发布日期：2026-09-17_
+
+### Office 回归修复（依据 v1/v2 回归报告）
+
+**严重：lineSpacing 提取值错误（会导致排版全毁）**
+
+`office_view(mode=profile)` 提取的 `body_text.lineSpacing` 为 `0.075` 而实际应为 `1.5`——
+`DocxStyleResolver` 已把 twips 转为磅值，profile 聚合时又按 twips 除以 240（等效多除 20）。
+现改为 `pt / 12` 得到倍数，与规则引擎 `normalizeLineSpacing` 对齐；提取值回灌
+`office_apply_profile` 后行距正确（360 twips = 1.5 倍）。
+
+**chapterTracker 跨章失效**
+
+`captioned_image` / `captioned_table` 在第二章后仍生成「图1-1」。修复：
+
+- 按 `before`/`after`/`index` 解析真实插入落点（而非扫描全篇）
+- 章号判定同时支持 Heading1 样式、大纲级别 0、「第X章」中文数字（`chineseNumeralToInt`）
+- 章内序号按 `SEQ ... \s N` 分组计数，跨章正确重启
+
+**SEQ 域缓存值与静态前缀叠加（显示「图1-1 前台首页1」）**
+
+题注以 `{seq}` 为界拆分为「静态前缀 run + SEQ 域 + 静态后缀 run」，域缓存值即章内序号，
+Word/WPS 打开即为正确编号，F9 刷新后保持一致。
+
+**heading1 角色漏识别**
+
+`OfficeRoleDetector` 新增大纲级别判据与中文样式名支持（`headingLevelOfStyle`：`Heading 1` /
+`标题 1`），章标题正则放宽空格并补充裸数字章标题兜底。
+
+配套新增 10 个回归测试；office 测试总数 161 全通过。
+
+## v1.9.158
+
+_发布日期：2026-09-17_
+
+### Office 模板对齐类文档生成增强（F1-F6）
+
+将「参考模板 → 逐项对齐样式 → 一键出稿」的论文类任务能力沉淀为 office 工具链通用能力，
+仍基于 Apache POI 纯格式层（无 COM、无外部进程）。新增 2 个工具 + 2 个 office_view 模式，
+扩展 office_edit 两种带题注元素与表格列声明。
+
+**新工具**
+
+- `office_apply_profile`：按样式 Profile 对匹配角色段落规整字体/字号/行距/缩进/对齐 +
+  页面设置 + 标题编号；值稳定（重复应用不回退、不翻倍）。
+- `office_generate_from_template`：`{{var}}` 全文跨 run 替换 + 内容清单注入
+  （heading/paragraph/image/table/pageBreak）+ 可选 profile 应用；`outputFile` 指定时保留模板。
+
+**office_view 新 mode**
+
+- `profile`：从模板 docx 提取按角色聚合的样式 Profile（page/roles/rules/numbering），
+  作为 apply_profile 的输入；role 附 `matchSource`/`sampleText`/`paragraphCount` 审计元数据。
+- `selfcheck`：按分页符拆页，逐页 `textDigest` + 标题层级跳跃/图片溢出/宽表 warning，
+  并复用规则引擎补充格式违规检查。
+
+**office_edit 扩展**
+
+- `add type=captioned_image / captioned_table`：一条命令插入图片/表格 + 居中题注段
+  （SEQ 域，Word F9 可刷新）；`caption`/`captionText` 双字段兼容；`chapterTracker=auto` 自动判章。
+- `add type=table` 新增 `columns: [{widthPt, align}]` 列宽（pt→dxa）与列对齐声明。
+
+**回归修复**
+
+- 修复 `office_create` 漏传 `template` 参数（bridge 侧）。
+- 修复 `captioned_*` 题注未写入（参数名不一致 + 题注段与内容段共用锚点）。
+- 修复 `office_generate_from_template` 的 `outputFile` 不生效（模板被就地污染）。
+- profile 角色识别增强：TOC/附录等辅助样式不再污染正文/标题统计。
+
+详见 `docs/Office文件操作能力实施方案.md` §12。
+
+## v1.9.157
+
+_发布日期：2026-09-16_
+
+### Office 精准操作能力大版本：Word 内核 / Excel / PPT / 公式 / 规则引擎
+
+对标参考开源实现（WordFormat、学术 skills 等）完成 Office 三件套从「能创建」到
+「精准操作」的升级：run 级定位、批注修订、公式目录页码、版式占位符、格式规则
+检查与一键修正。全部基于 Apache POI 5.2.5 纯格式层实现，无 COM/无外部进程。
+
+**Word 精准编辑内核（docx）**
+
+- 路径寻址扩展：`/body/p[N]/run[M]`（run 级）、`/body/table[T]/row[R]/cell[C]`（单元格）、
+  `/body/sectPr`（页面）、`/body/header|footer`（页眉页脚）
+- 新增 `DocxStyleResolver`：docDefaults → basedOn 链 → 直接格式的**有效格式解析**
+  （含主题字体兑现），支撑 `view styles` 与规则引擎「改得准、查不误报」
+- 新能力：`op=replace`（跨 run 保格式查找替换）、批注（写/读/删，五件套部件）、
+  修订（tracked 编辑 + accept/reject）、目录 TOC 域 + updateFields、PAGE/NUMPAGES/SEQ 域、
+  页码页脚、书签 + 外链/内链超链接、**引用上标 [n] + 锚点内链**、OMML 公式（行内/块级/编号公式三列表）、
+  **自定义标题编号**（第%1章模板 + 清除手动编号）、三线表（threeLine 预设）、
+  段落字符单位缩进（firstLineChars）、中英文字体三槽（fontEa/fontAscii/fontHAnsi）
+- `office_create` 支持 `template: cn-thesis`（A4+2.5cm、宋体/黑体样式体系、标题编号、页码）
+- `office_view` 新 mode：`styles`（有效格式）、`comments`、`revisions`、`search`（query 定位）
+- `office_validate` 增加 OOXML 结构检查：批注范围配对、w:del/w:ins 规范、xml:space
+
+**Excel 增强（xlsx）**
+
+- `add chart`（bar/column/line/pie/doughnut/area，XDDF 原生图表）、单元格批注、
+  数据验证（list/whole/decimal/date/textLength/custom）、条件格式（cellIs/containsText/colorScale）、
+  带位移插入/删除行（不覆盖相邻数据）、按范围拆分合并、富文本单元格（runs 数组）、
+  定义名称、页面设置（方向/缩放/打印区域）、自动筛选、行列隐藏
+
+**PowerPoint 增强（pptx）**
+
+- 演讲者备注（`set /slide[N]/notes`，view notes 读取）、**版式感知创建**（add slide + layout/layoutIndex，
+  view layouts 清单）、占位符直接赋值（`/slide[N]/placeholder[type|idx]`，保留模板样式）、
+  全 deck 查找替换（可限定单页）、表格单元格写入（`/shape[M]/cell[R][C]`）、
+  形状旋转/z-order（up/down/top/bottom）/超链接、**幻灯片克隆**（op=clone：复制文本/图片/备注/版式，
+  源页隔离，插入位置可控）
+
+**公式链路（bridge）**
+
+- 新建 `src/office/office-equation.ts`：`props.latex` → temml（MIT）LaTeX→MathML →
+  自研 MathML→OMML 转换（覆盖分数/根式/上下标/极限/求和积分/矩阵/括号分组），
+  失败时给出可读错误；`office_edit` 自动预处理 latex → omml 上行 Java 注入
+
+**格式规则引擎（差异化能力）**
+
+- 新工具 `office_format`：`{file, action: check|fix, preset|rulesFile|rules, annotate?, outputFile?}`
+  - 角色识别（三层）：Word 样式 → 正则启发式（第X章/图题/摘要/参考文献等）→ 显式匹配器
+  - 检查：逐角色比对期望格式 → 违规清单（path/role/property/actual/expected/fixable/severity）+ 摘要；
+    `annotate:true` 把违规写成 Word 批注生成标注版（不覆盖原件）
+  - 修正：确定性项自动改（字体三槽/字号/加粗/对齐/行距/缩进/编号/手动编号清除），判断类只报告
+  - 预置：`cn-thesis`（学位论文）、`cn-report`（公文）；rulesFile 支持工作区 YAML/JSON
+- 收敛性验证：fix 后复查零违规（加权优先级 + 半磅字号 + 悬挂缩进语义）
+
+**预览增强（docx HTML 预览）**
+
+- 批注标记（含正文悬浮）、修订 ins/del 着色、公式文本化、TOC 占位、
+  域友好占位（〔页码〕）、超链接渲染为可点击 a[href]、上下标
+
+**测试**
+
+- Java：新增 `OfficeDocxPrecisionTest`（25 用例）、`OfficePptxAdvancedTest`（11 用例）、
+  `OfficeFormatEngineTest`（9 用例）等，全量 1442 用例通过
+- bridge：新增 `office-equation.test.ts`（17 用例）+ mcp-tools 描述契约测试；
+  `tsc` 与本套件通过
+- 前端：`officeTimeline` 支持 office_format 事件刷新，测试补齐
+
+## v1.9.156
+
+_发布日期：2026-09-13_
+
+### Office 三件套能力升级：图片、排版、形状
+
+按照 genoffice 对标，大幅增强 Office 文件引擎和工具描述，agent 现在可以生成含图片、列表、格式化表格的工作级文档。
+
+**Java POI 引擎**（OfficeDocService.java）
+
+- **图片基础设施**：严格 Base64 校验 + 魔数嗅探（PNG/JPEG/GIF/BMP/TIFF，WebP 等明确拒绝）+ ImageIO 像素尺寸读取 + 等比缩放辅助
+- **docx 新增**：`add image`（source 支持工作区路径 / http URL / data URL → bridge 侧解析，Java 无状态接收 imageBase64）、`add pageBreak`、列表（`list: "bullet"|"number"` + `level: 0-2` 惰性初始化 XWPFNumbering）、`set /body header/footer`、段落 `pageBreakBefore`
+- **xlsx 新增**：单元格 `numberFormat`（`0.00%`、`¥#,##0`、`yyyy-mm-dd` 等）、`border`+`borderColor`（thin/medium/thick/dashed/dotted/double）、`wrapText`、`valign`（top/center/bottom）、工作表 `colWidth`（px）、`rowHeight`（pt）、`freeze`（行/列）、`add merge`（range 字符串）、`add image`（anchorCell + 图片字节 → XSSFDrawing）
+- **pptx 新增**：`add image`（fit=contain/cover/stretch，cover 写 srcRect 裁剪）、`add shape`（rect/roundRect/ellipse/triangle/diamond/chevron 等 + fillColor/lineColor/lineWidth + 垂直居中文字）、`add table`（均分列宽行高 + header 加粗）、`set /slide[N] background`（十六进制背景色）、`remove /slide[N]/shape[M]`（含图片/形状）、列表（`list: "bullet"|"number"` + bullet 三级字符差异）
+- **view 升级**：stats 增加 `images` 计数、图片段落/形状标注 `（图片）`
+- **preview 预览**：三格式含图片标注
+
+**bridge 侧**（aws-client-agent-mcp）
+
+- 新建 `src/office/office-image.ts`：`officeResolveImageSource(source)` 支持三种图片来源（data:image URL / http(s) URL / 工作区路径），含魔数校验和严格格式约束；`prepareOfficeImageCommands(commands)` 预处理 office_edit 命令中的 props.source → imageBase64
+- `mcp-server.ts`：`officeEdit` 新增调用 `prepareOfficeImageCommands`，使图片 URL/路径自动解析为 base64 上行 Java 引擎
+- `mcp-tools.ts`：`OFFICE_EDIT_TOOL` 描述重写为三格式完整能力清单 + 图片通用规则 + 使用要点；props schema 补充所有新增字段
+- 测试 `office-image.test.ts`：11 测试全通过
+
+## v1.9.155
+
+_发布日期：2026-09-13_
+
+- Office 文件能力面板化（与 pencil / draw 画布面板同款体验）：Agent 可在 Dashboard
+  面板中实时查看自己创建/编辑的 Word / Excel / PowerPoint 文档。
+  - aws-client-agent-mcp：office 工具组新增 3 个面板工具——`office_open_document`
+    （校验工作区文件存在并返回 file/kind/sizeKb/workspacePath，驱动前端打开面板）、
+    `office_close_document`（收起面板）、`office_list_open`（列出本会话已打开的文件）；
+    `office_create` / `office_edit` 返回值补充 `kind` 字段，供前端时间线提取器维护
+    文件列表（Agent 行徽标计数）；工具描述同步引导「打开面板即可实时看到编辑效果，无需截图」。
+  - aws-mcp-server：`OfficeToolHandlers` 注册同款 3 个 handler（open 校验扩展名并归一
+    kind；close/list 为轻量信封），`TOOL_NAMES` 扩为 8 个——office 能力门禁
+    （`checkAbilityGate`）自动覆盖新工具；新增 `OfficeToolHandlersTest`（8 用例）。
+  - aws-dashboard：新增 `OfficePanel.vue`（docx 用 docx-preview、xlsx 用
+    @vue-office/excel、pptx 用 pptx-preview 本地渲染，注册 workspace watch 后经
+    FILE_CHANGED 事件自动刷新，头部按类型显示 Word/Excel/PPT 彩色徽标）；
+    `useAgentTimeline` 新增 `extractOfficeDocInfo`（解析逻辑抽为可单测的
+    `officeTimeline.ts`，覆盖 call_tool 懒加载包裹形态）；index.vue 完成桌面/移动端
+    面板挂载、可拖拽宽度注册（office: 720/480/1200）与 Agent 行 Office 徽标按钮；
+    ChatPanel office 卡片新增「面板打开」入口（卡片载荷携带 filePath/workspacePath，
+    同工作区时可直接在面板中打开原文件）。
+  - 修复 `writeOfficeFileAtomic` 对非法 Base64 静默解码的存量问题（Node
+    `Buffer.from(x,"base64")` 宽容语义），改为严格字符集 + 长度校验后再解码。
+
+## v1.9.153
+
+_发布日期：2026-09-12_
+
+- 工具集懒加载（Lazy Tool Expansion）全链路接入：受管控的大工具集（pencil / draw 各 15 个、
+  启动项 9 个、招聘、浏览器 / 桌面桥接等）由「开启即全量暴露」升级为三态能力开关——
+  disabled（禁用）/ collapsed（收纳：工具不出现在工具列表，需先 expand_tools 展开）/ expanded（展开：工具全量直接可见），
+  降低初始上下文占用。
+  - aws-mcp-server：`t_agent_ability_switch` 新增 `ability_state` 列（update.sql v1.30.0 迁移，存量行按
+    `enabled` 归一：1→expanded / 0→disabled，既有 agent 行为不变），`AgentAbilitySwitch` 实体 / Mapper /
+    Service 三态读写，`enabled` 布尔列写入时同步回填保持旧读取兼容。缺省口径（DB 无行）：
+    browser / desktop / agentSys.launchItem / agentSys.hire 默认 collapsed（已授权但收纳），其余默认 disabled（显式授权）。
+  - aws-client-agent-mcp：新增常驻元工具 `expand_tools` / `call_tool`（不属于任何受控组，收纳组始终有展开与调度入口）。
+    ListTools 按三态过滤；展开不再把工具注入 runtime exposedTools、不再推送 tools/list_changed（ListTools
+    载荷字节级稳定，LLM provider 前缀缓存全程命中），改为授予 call_tool 调度授权并把工具定义
+    （name/description/inputSchema）随 expand 结果下发，agent 当轮即可 call_tool 调用；执行期纵深防御：
+    disabled 拒绝、collapsed 未展开拒绝（同时兜住原生工具名直调的旁路）。配置为 expanded 的组不可在会话中
+    收起（由用户决定）、重复展开按幂等 already-expanded 返回。browser / desktop 桥接能力经 HTTP 回传
+    bridge 新端点 `/runtime/sessions/:agentId/capability-tools[/call]`（X-Runtime-Token 鉴权），call 超时
+    55s < runtime mcpToolTimeoutMs 60s。
+  - acode runtime：系统提示词注入能力清单（新增 capability-prompt.ts）——agent 知道哪些能力已展开 /
+    已收纳 / 未开启，「我没有绘图工具」类请求会主动提示用户去能力配置开启；启动期 env 兜底改为携带三态值
+    （AWS_LAUNCH_CONFIG_TOOLS / AWS_HIRE_TOOLS / AWS_DRAW_TOOLS 等），消除首次 listTools 早于 token 就绪时
+    env 兜底把收纳组全量暴露的窗口。
+  - aws-dashboard：能力配置弹窗新增三态选择器（新组件 FeatureStatePicker.vue），capability-features.ts
+    升级为三态模型（agentSys 主开关禁用时子能力级联禁用，跨层与 Java / bridge 口径一致）。
+- Provider 请求失败不再默认无限重试：requestRetryCount 缺省由无限改为 0（持续 4xx 等不可恢复错误不再空转），
+  错误信息从响应载荷提取 code + message 直接抛出，不再被静默重试吞掉；需恢复内部重试时在 config 显式配置
+  requestRetryCount（有限值或 -1 无限）。
+- 消息中心「完整请求体」JSON 树视图：新增 JsonTreeNode.vue（层级树形展示、逐层懒展开）与 jsonRepair.ts
+  （截断 JSON 修复兜底，修复后可解析即以树形呈现），60KB 截断请求体支持全文搜索——输入防抖 200ms、
+  命中计数、回车逐个定位、自动展开命中祖先链并高亮，未解析为 JSON 时回退原始文本。
+- 图片预览缩放：新增 useImageZoom.ts（滚轮 / 双指缩放、拖拽平移、双击还原、缩放工具栏），接入 ChatPanel
+  全屏图片预览与 MessageInput 附件预览。
+- draw 卡片预览自愈：新增 drawCardPreview.ts 幽灵渲染管线——服务端从未渲染的 draw 消息卡片以发送者
+  （owner）身份补渲染生成预览，渲染成功事件即时补拉；pencil / draw 卡片渲染图 30s 定时补拉自愈
+  （消息离开列表即停止），有图即终态。
+- 杂项：.gitignore 补充审查 / 调试期临时产物（tsc / TAP 输出、一次性统计脚本、本地 AI 助手工作区）；
+  修复 draw.ts 头注释在编辑中被截断损坏的问题。
+
+## v1.9.152
+
+_发布日期：2026-09-10_
+
+- 绘图（draw.io）能力全链路接入：新增「绘图 (draw)」能力开关（默认关闭，显式授权语义，同 desktop/hire/pencil），
+  Agent 可创建 / 编辑 / 导出 / 分享 draw.io 绘图文档，Dashboard 以独立面板内嵌官方 draw.io 编辑器。
+  - aws-mcp-server：新增 `t_draw_doc`（doc_id 唯一，`doc_xml` 为完整 `<mxfile>` 权威内容）、
+    `t_draw_doc_member`（协作权限 read|write）、`t_draw_doc_change`（事务型 Outbox 变更日志，与内容写入同事务
+    落行，每 doc 保留最近 200 版；变更通知只作唤醒信号，丢失/离线时经 `draw_get_changes(sinceVersion)` 追赶）；
+    `DrawDocController` 暴露 `/api/draw/*`（docs / doc / doc ops / doc render / counts / doc members）；
+    `DrawDocMapper` 以 `doc_id + version` 乐观锁 CAS 写回，消除 check-then-act 竞态窗口。
+  - aws-runtime-bridge：新增 `DRAW_FEATURE_KEY` 能力标识与 `AWS_DRAW_TOOLS` 启动期 env 兜底；
+    `aws-client-agent-mcp` 注册 `draw_*` 工具组（create/list/open/close/get_diagram/get_changes/create_cells/
+    update_cells/delete_cells/delete_document/rename_document/share_document/revoke_share/export_document），
+    ListTools 按开关注实时过滤，服务端 `/mcp/call` 另有权威校验；`draw_export_document` 只回传
+    savedTo/sizeKb 等元信息，docXml 不回流 agent 上下文。
+  - aws-dashboard：新增 `DrawPanel.vue`（iframe 加载自托管 draw.io，经 embed postMessage 协议 load/autosave/export）；
+    会话列表新增绘图徽标（仅 Agent 有绘图文档时显示，附数量角标）；文档列表改为工具事件驱动刷新
+    （`drawRevision` 信号 + 防抖），取代每 2.5s 高频轮询 `/api/draw/docs`，仅在 WS 断线/未覆盖时低频兜底；
+    面板宽度与收缩优先级纳入 `draw`；移动端新增绘图覆盖层。
+  - 自托管编辑器资源置于 `aws-dashboard/public/draw/`（官方 draw.war 解包，v31.4.4，含 README 说明升级与授权注意），
+    并加入 Service Worker `globIgnores` 排除预缓存（app.min.js 9MB+、integrate.min.js 22MB+ 体积超预缓存上限，
+    仅打开绘图面板时按需加载）。
+- 消息卡片：`send_group` / `send_private` 支持附带 `card`（`{type:pencil|draw,docId,title?,description?}`）
+  文档引用卡片，`send_group`/`send_private` 工具描述同步说明。读取模型为「凭 docId 可读」——任何 Agent 拿到 docId
+  即可用 `pencil_get_tree` / `draw_get_diagram` 读取，无需被邀请；写操作仍按 owner / 协作成员权限校验。
+  为此 `PencilDocService` 的读取路径（readDoc / getTree / getRender / getChanges）去掉「非 owner/成员即拒绝」
+  的拦截，`resolvePermission` 返回 null 时读取归一为 read；新增 `validateCardDoc` 供卡片发送前确认文档存在。
+  卡片只读引用不写入 `*_doc_member`，因此不改变协作者列表、shared 标记与文档列表徽标。
+  `t_direct_message` / `t_group_message` 新增 `card` 列（LONGTEXT，防富内容截断），
+  `GroupMessageService` / `DirectMessageService` 增加带卡片的 8 参重载（原 7 参签名保留并委托，向后兼容），
+  卡片 JSON 落库前校验合法性（非法 JSON / 非对象直接拒绝，解析失败按无卡片降级渲染历史消息）。
+  Dashboard 侧 `ChatPanel.vue` 新增消息卡片渲染（仿小程序卡片：有渲染图显示预览、否则占位封面，
+  带类型徽标与标题，点击直接打开对应绘图 / 画布面板）。
+- 消息内容扩容 + 载荷剥离：`t_direct_message` / `t_group_message` / `t_meeting_message` 的 `content`
+  由 TEXT(64KB) 扩为 LONGTEXT——富格式内嵌图片 base64（压缩后数百 KB ~ 数 MB）在 MySQL 非严格模式下会被
+  静默截断到 64KB，Agent 经 `poll_message` 只拿到残缺 JSON、`JSON.parse` 失败，表现为 agent 看不到图
+  （`[image omitted]`）。配套在 acode runtime 的 poll 结果中剥离 directMessages/groupMessages 内嵌的
+  图片与附件 base64，仅保留可读文本摘要，避免 base64 以纯文本污染后续上下文。
+  Dashboard 发送侧新增 `buildRichAttachmentContent`——图片附件以内嵌 base64 随消息下发（Agent 直接以
+  多模态 data URL 读取，无需 fetch 图片 URL / 落盘再读），非图片附件仍为 URL 描述（语义等价 `[文件: ...]`），
+  这正是 content 必须扩容到 LONGTEXT 的直接原因。
+  新增 `ACODE_IMAGE_DIAG=1` 开启的图片注入诊断日志（默认关闭，异步追加且吞掉 I/O 异常）。
+- 发布前修复：群消息仅卡片（无正文）时 Java 侧校验误拒绝，已与 mcp-server 侧「content/attachments/card
+  至少其一非空」对齐；`draw_export_document` 工具 schema 与实现统一（仅 xml/drawio，svg/png 等渲染
+  待阶段 2 管线，描述不再误导）；`DrawPanel` 的 postMessage 接收仅接受同源自托管编辑器消息。
+- 原子写健壮性：`atomicWriteFile` 改用 `renameFileWithRetry`——Windows 下 `fs.rename` 可能因目标被瞬时占用
+  （杀毒扫描 / 并发句柄）抛 EPERM/EBUSY/EACCES，按 40ms 递增退避重试 3 次，降低实际运行与测试并发下的假失败。
+- 面板最大化（脱离为弹框）：新增 `PanelDetachButton.vue`，终端 / 时间线 / 工作区 / 上下文 / 待办 / 后台任务 /
+  子 Agent / 浏览器 / 画布等侧窗面板可一键脱离为弹框最大化，再点恢复回侧窗；脱离态保留强调色提示，
+  标签栏场景支持右对齐 sticky 固定，移动端隐藏（已是全屏覆盖层）。
+- 桌面工具 origin 判定明确化：`injectRememberedOrigin` 以 `originSet()`（非 null 且非 undefined）替代
+  `!= null` 判断，语义等价并消除隐式类型收窄告警。
+- 轮询降频：在线成员列表的断连兜底轮询由 5s 放宽到 30s（`ONLINE_CHANGE` WS 事件已支持增量更新，
+  断连时仅需兜底同步，无需高频拉取）；绘图文档列表同样由固定间隔轮询改为工具事件驱动。
+- 测试：vitest 单测超时由 30s 放宽到 90s——本机并行跑完整套件（103 个文件、真实 git/子进程）时 CPU 争用
+  可把单个用例拖慢数倍，避免负载型假失败掩盖真实回归；补齐 `draw_*` 工具、git 路由与 acode runtime 用例。
+
+## v1.9.151
+
+_发布日期：2026-09-07_
+
+- 工作区 LSP（TypeScript/JavaScript 语言服务）全链路接入：Dashboard 文件编辑器可对实例工作区的
+  TS/TSX/JS/JSX 文件提供语义级定义跳转与引用查找，不再依赖字符串搜索。
+  - runtime-bridge：新增 `typescript-language-server` 与 `typescript` 运行时依赖；`src/services/lsp-stdio-bridge.ts`
+    封装 LSP stdio 帧编解码（Content-Length 增量解析、畸形流防护）与子进程桥（自动解析 tls 入口、注入
+    TSSERVER_PATH 保证 tsserver 可启动）；`src/routes/lsp.ts` 暴露 `/ws/lsp` WebSocket——单 workspace 单进程
+    复用、60s 空闲回收、复用进程再次收到 initialize 时重建进程（避免 tsserver 沿用旧文档状态陷入
+    "No Project"、跳转恒空）。
+  - aws-mcp-server：`WorkspaceLspProxyService` 在 HTTP 侧校验 workspace 归属后签发 5 分钟一次性令牌
+    （TTL 放宽覆盖慢建连、消费即失效防重放）；`WorkspaceLspWebSocketHandler` 把浏览器 `/ws/workspace-lsp/{token}`
+    双向转发到 bridge `/ws/lsp`，隧道模式经 BridgeTunnelService 虚拟流、直连模式带 X-Runtime-Token 握手头；
+    `FileBrowserProxyService.resolveWorkspaceLspBridge` 解析 bridge 目标（保留隧道实例前缀）与鉴权令牌。
+  - aws-dashboard：`workspaceLsp.ts` 封装 CodeMirror LSP 会话——同一 bridge+workspace 仅建立一条 WS 与
+    一次 initialize，切换文件仅替换 per-file 句柄（didOpen/didClose），避免重复 initialize 导致跳转失效；
+    补充库未内置的 textDocument/references 与 definition 请求、自定义 transport 占位。`WorkspacePanel.vue`
+    接入 LSP 扩展、Ctrl+点击/快捷键跳转定义与引用查找；对 Windows 盘符修正 file:// 三层斜杠与 URI 归一比较。
+- 确认弹窗交互调整：确认按钮移至取消按钮左侧并作为默认焦点，Enter 键即触发确认，Tab 焦点循环顺序与
+  视觉排布一致（确认左、取消右）。
+- 工作区面板媒体预览：图片 / SVG / 视频预览改为经下载接口生成 object URL 展示，支持 B 站式画面缩放
+  （Ctrl+滚轮 / 缩放按钮）与按住空格+拖动平移放大后画面，双击复位；预览状态栏同步显示媒体尺寸与状态。
+
+## v1.9.150
+
+_发布日期：2026-09-07_
+
+- 长文引用（LTR）全链路化：私信超长文本粘贴不再全文进消息，改为引用上传——MCP 与 bridge
+  新增 `/api/ltr/upload`，把大文本片段落盘到目标机器 `<系统临时目录>/aw-temp/LTR/YYYYMMDD/{uuid}.txt`
+  （单篇 ≤512KB，按天归档、写入时顺带清理超 7 天的目录），消息只传 `[bridgeName:绝对路径]` 引用，
+  agent 用 read_file 读取全文，避免超长文本撑爆消息表（MySQL TEXT 65535 字节）与 LLM 上下文。
+  前端配套：粘贴转胶囊 token（发送时统一上传 + 进度提示、hover 预览全文、未上传时随草稿保留并在
+  切换会话后恢复）；LTR 图标与 capsule 颜色跟随主题。
+- 后台命令僵尸状态根治（L1–L4）：读路径对账（面板每次刷新先翻"磁盘 running 但本进程内存不命中"
+  的孤儿为 killed(runtime_crashed) 并原子回写）；状态写入事务化（per-agent 串行写链消除并发
+  heartbeat/finalize 的丢失更新）；生命周期补齐（exit+close 双监听，exit 后 2s 宽限强制 finalize，
+  孙进程持续持有管道不再留下永远 running 的状态；进程退出时落盘 killed(process_exit)）；running
+  任务心跳节流落盘（5s 或输出增量 64KB 触发）+ 启动时全量扫描所有 agent 目录孤儿。
+  面板改为只展示"真后台/运行中"命令，前台同步执行、从未转后台的命令不再占用面板。
+- open-pencil CLI 多路径探测：pencil_export_document 依次探测 `AWS_OPEN_PENCIL_HOME` →
+  `<工作区>/open-pencil` → 仓库相对路径 → 逐级向上回溯，未命中时错误信息列出全部探测路径；
+  README 补充生产部署前置（工作区锚点或环境变量二选一，须用仓库构建版 CLI 以支持 GraphSnapshot）。
+- create_meeting 有效性预检：角色占坑席位无可认领实例（如该角色唯一实例就是创建人）、或创建人把
+  自己重复加入受邀成员时直接返回错误，不再进入无谓的等待。
+- 群消息撤回语义修正：发送者本人游标越过已撤回消息仍可撤回；他人游标越过则拒绝撤回（撤回不再
+  被"阅读过即作废"误伤）。两项修复均补齐单测。
+- 输入框编辑体验：自建 undo/redo 栈（浏览器原生撤销对 contenteditable + 手动 DOM 不可靠），
+  mention / command / LTR 原子 token 可整体撤销；@mention 输入确认后自动把自由文本原地转换为
+  mention 高亮 token（`--cp-mention-highlight-*` 亮暗主题双套）；「调用式回复」更名为「强调回复」。
+- 文件下载回源文件名：下载/预览响应 Content-Disposition 改用上传时的原始文件名（URL name 参数），
+  并清洗控制字符、引号、分号与路径分隔符，避免 header 畸形与路径穿越。
+- 消息中心：项目在线成员列表去重（同一 agent 绑定多实例时不再重复头像）。
+- 健壮性：后台命令状态持久化失败仅告警不再崩进程；LTR 上传上游失败统一 502 且不回传内部错误细节。
+
+## v1.9.149
+
+_发布日期：2026-09-06_
+
+- 项目头像支持裁剪：PNG / JPG / WebP / GIF 位图在选文件或点击现有图标后进入方形裁剪
+  （拖动调整位置、滚轮或滑块缩放），以 512×512 输出确认保存；SVG / ICO 等无法用
+  canvas 裁剪的格式仍直接按原文上传；favicon 预览复用已下载文件，点击直接进入裁剪，
+  避免二次网络下载。
+- Pencil 嵌入式画布跟随 Dashboard 明暗主题：iframe URL 携带 theme 参数，主题切换时
+  经 pencil:theme 消息同步画布配色，不再固定白底。
+- 修复浅色主题下消息中心 agent 上下文用量 / 待办 / 子代理按钮的选中态样式：选中项
+  不再被浅色覆盖规则盖成深色文字（`:not(--active)` 限定浅色覆盖范围，避开高特异性
+  覆盖选中态）。
+- 「限制操作」入口从输入框左侧常驻盾牌图标移回「+」菜单（撤销 v1.9.148 的常驻盾牌，
+  并移除权限档位拉取与盾牌着色逻辑，简化输入框布局）。
+- 版本升级 1.9.148 → 1.9.149：Bridge 本包无运行时代码改动，随前端 Pencil / 消息中心
+  更新一并发布。
+
+## v1.9.148
+
+_发布日期：2026-09-06_
+
+- Pencil 导出 savePath 不再限制在工作区内：绝对路径（如 D:\exports\hero.svg 或
+  用户 Downloads）直接使用，相对路径仍基于工作区根解析——导出交付物可落盘到
+  任意位置。
+- Pencil 渲染缓存升级为原始分辨率（最长边 ≤8192 内不缩放，此前 1280），agent
+  pencil_export_image 与人工导出拿到原图；导出等待超时 8s→15s；升级规格后对旧
+  低分辨率缓存自动补渲一次。
+- Pencil 画板编辑锁：有写权限时默认锁定只读，点击解锁才可编辑；编辑中画布被
+  agent 工具/协作端推进版本时自动回锁并加载最新快照，防止基于旧版编辑整份覆盖
+  他人写入（脏写）；写权限被收回时强制回锁。
+- 输入框新增终端式 ↑/↓ 发送历史回溯（按会话隔离，Esc 退出并恢复进入前的草稿）；
+  「限制操作」入口从「+」菜单移到输入框左侧盾牌常驻图标，存在授权/禁止档位时
+  显示绿色。
+- 修复：侧板拖拽经过 iframe（画布/终端）宽度冻结且无法结束的问题（拖拽期间禁用
+  容器内 iframe 鼠标事件，窗口失焦自动结束拖拽）；全局设置菜单横向滚动两端留白
+  被吞掉的问题；项目头像弹窗标题显示项目名而非 projectId。
+- 更新健壮性：包内 CHANGELOG 缺目标版本段时继续尝试 ~/.aws-bridge 下运行时追加
+  的候选文件；更新成功后的发布说明追加改为 await 在重启前完成，版本号优先取 npm
+  刚落盘的 package.json。
+- 发布护栏：prepack-guard 校验 CHANGELOG.md 必须含当前版本段（缺段阻断发布），
+  verify-pack-contents 将 CHANGELOG.md 列为必需 payload。
+
+## v1.9.147
+
+_发布日期：2026-09-06_
+
+- Pencil 设计画布全栈接入：t_pencil_doc 权威存储（迁移 v1.26.0~v1.26.3）与协作者
+  权限、MCP pencil_* 工具（AWS_PENCIL_TOOLS 兜底可见性过滤）。
+- 桌面自动化增强：nuphus-mcp 0.1.12 的 desktop_window_activate 先还原再激活，修复
+  托盘/最小化窗口无法激活的问题；新增 som.rs 与 UIA 安全增强。
+- acode 新增 runtime-environment；后台命令/文件/图片工具优化，AcodeSdkAdapter 与
+  浏览器池稳定性改进。
+- 修复：CHANGELOG.md 自本版本起随包分发。此前发布说明依赖"执行更新的旧进程"运行
+  时追加，旧版 Bridge（≤1.9.145 无此代码）执行更新会导致新版本弹窗无发布说明可
+  展示，只能回退安装过程日志。
+
+## v1.9.146
+
+- 新增「本次更新内容」展示：将更新弹窗从安装过程日志（updates.log）切换为版本
+  发布说明（CHANGELOG.md），让用户看到本次版本相对变更的要点，而非 npm 安装
+  过程噪声。
+- 更新成功重启后，由 Bridge 自动在 CHANGELOG.md 顶部追加当前版本段。
+- 当目标版本未找到发布说明时，弹窗自动回退展示 updates.log（安装过程日志）并
+  给出提示。
+
+<!-- append-new-version-above -->