ClawPanel: vanhemmat versiot ja versiohistoria

修复 (Fixed)
- 修复 Windows 后台命令反复弹出终端的问题：统一隐藏内核状态探测、命令路径查询及安装、启停等辅助进程窗口，保留标准输出、错误日志和原有超时。
- Windows Gateway 普通启动不再创建可见终端，启动失败继续通过面板诊断与日志展示；不影响用户显式打开外部应用。
- 关于页的社群交流新增 Telegram 群按钮和本地二维码，使用同一官方邀请链接；点击二维码或按钮在浏览器打开，保留现有社区入口。
验证范围 (Testing)
- 补充后台命令隐藏策略、实际自有子进程控制台可见性及 Telegram 页面回归；后台隐藏不等于完成各内核全部功能的原生界面验收。
- 本次为界面和后台进程热修复，不合入未完成验收的 Hermes 升级候选，不改变内核推荐版本或日常自动发布门禁。

兼容性 (Compatibility)
- 经维护者单独批准，适配官方 OpenClaw 2026.10.4，同步新安装推荐、发行 Docker、Linux 安装脚本和文档；保留已安装内核，不自动升级用户运行时。
- 保留新旧内核的 Gateway 协议 3/4、v3 设备签名和现有认证/配对边界；汉化版固定目标不变。
- Pi 实验引擎推荐升级至 1.3.0，保留离线 RPC、私有模型凭据、只读工具与审批边界；已安装内核仍由用户显式更新。
- OpenCode 初始安装目标升级至 1.19.2，兼容新旧原生工作台的路由、偏好、草稿、图标及 Markdown Worker，Web 嵌入继续使用不透明来源沙箱。
- DSH 预览目标升级至 0.2.1-alpha.4，默认通道仍为 0.2.0-rc.2；私有安装器固定 pnpm 11.28.5，不依赖或修改全局 pnpm。
修复 (Fixed)
- 修复 Agent 默认设置与现代所有权配置冲突的问题：新内核仅修改系统任务归属，保留会话存储、渠道与权限；Web 和桌面写入合并后同步清理退役标记，旧版配置保留原协议（#342）。
- 修正微信插件 2.4.9 的已核实兼容范围和真实 npm 安装的宿主版本识别；未核实的新插件不提示自动降级，不自动同意安装能力，本次修复仅涉及兼容状态（#345）。
- Hermes Dashboard 显式使用本实例配置端口，不再把其他实例的全局进程状态当作当前服务在线；保留本机监听、不自动打开浏览器和原就绪时限。
- Hermes 状态检测优先使用 --version 快速入口，仅不支持时回退旧子命令；Web 与桌面保持一致，避免无效 CLI 启动拖慢轮询。
- 修复 Hermes 官方无 Dashboard 进程的输出被 running 一词误判为在线的问题；成功的状态命令不再重复探测，帮助文案或端口文本不再当作运行证明。
- 维护 CI 补齐 OpenCode、DSH 默认及预览的独立容器实装门禁，保留 OpenClaw/Hermes 原有验收；每项回读真实非特权隔离事实，不增加凭据或开启自动 AI/PR。
- 修复 Hermes 聊天输入文字后发送按钮未启用的问题，保留原有发送状态和连接检查。
- 面板退出登录或认证配置变更后，及时撤销 DSH/OpenCode 内嵌能力及已有连接；无效退出请求不撤销其他会话。
- Web 后端读取 Gateway 首帧时正确处理关闭帧、Ping/Pong 和 HTTP Upgrade 同包数据，保留关闭状态码与原因；避免启动阶段的关闭帧被当成 JSON 或漏读 challenge，并及时清理读取监听。
- 修复 OpenCode 原生页面可打开却因生产服务器预检头或上传流重建而发送失败的问题；直接打开能力文档同样保持响应级沙箱隔离。
- OpenCode 冷启动的草稿事务按读写冲突有界排队，避免原生页面突发请求触发并发上限；父桥事务、数据配额与超时限制保持不变。
- OpenCode 偏好保存失败时显示可见错误并回退未保存的镜像；刷新时释放旧文档事务，草稿使用独立命名空间和原生原子提交，不读取面板存储。
- 补齐精简 Linux 镜像中受管 Node 需要的原子操作库；各引擎使用独立运行时，不因损坏的 Hermes PM 记录阻断其他引擎。
维护设施 (Maintenance)
- 新增独立的 Hermes 手工资格验收：可信 main 工具校验精确候选 SHA，使用一次性 Windows runner 和非特权 Linux 容器，保留原始安装阶段、两轮长会话及进程/端口清理证据；Web 通过不冒充原生 Tauri 通过。
- 修复新 Pi 在 Linux 把进程标题改成 pi 后被真实运行验收误判为无子进程的问题；仅在父进程、Node 执行文件、工作目录和私有配置同时吻合时计为受管进程，继续校验实际停止。
- 本机定时维护按用户委托自主复核技术风险、隔离适配和真实验收；GitHub 控制器 AI/PR/自动发布开关继续关闭，发布仍受同提交 CI、完整门禁与每日上限约束。

维护设施 (Maintenance)
- 修复只读取最终 Release 简述导致跨版本认证、执行和网络边界变更漏判的问题；补充完整 Changelog、分片索引、缺片、外域引用及材料完整性检查，证据不完整时按高风险处理。
- 巡检报告保留审查版本区间、精确 tag、材料 hash 与全文指纹，避免摘要之外的变更或等价版本排序影响失败候选拦截。
兼容性 (Compatibility)
- 经维护者单独确认，将新安装的官方 OpenClaw 推荐版本从 2026.9.8 调整为 2026.10.3；同步发行 Docker、Linux 安装脚本和文档示例，不自动升级用户已安装的内核。
- 保留 Gateway 协议 3/4 与 v3 设备签名、现有认证/配对策略；Node 要求仍按内核元数据检测，汉化版及其他引擎的固定目标不变。
- GitHub 维护控制器的 AI 候选、PR 与自动发布开关继续关闭；其他高风险更新仍需单独确认，不沿用本次 OpenClaw 批准。

文档 (Documentation)
- 重整多引擎、模型渠道、OpenCode、Pi 与 Linux/Docker/ARM 部署文档，明确官方 OpenClaw 默认基线、显式同步、服务器端运行边界及实验版能力范围。
- 新增文档导航与英文 Pi 指南，更新贡献、发版和安全政策说明。
兼容性 (Compatibility)
- DeepSeek Harness 保持 0.2.0-rc.2 稳定版默认目标，同时加入 0.2.1-alpha.2 显式测试通道；Web 与 Tauri 安装链均支持安装、版本回读和切回稳定版。

新增 (Features)
- 新增 Pi 实验引擎：受管安装、固定验证版本更新、卸载保留数据、独立运行配置页与全高聊天工作台，不依赖 OpenClaw Gateway。
- 统一模型渠道支持同步到 Pi，保留模型名称、上下文及输出上限；支持会话内切换模型、流式回复、停止生成和历史恢复。
- 接入 Pi 原生 select/confirm/input/editor 交互，写入文件与执行命令逐次审批；默认只读工具，私有配置隔离、日志脱敏。
修复 (Fixes)
- 草稿按实例与会话隔离；配置页往返和刷新恢复，发送失败不覆盖后来输入的新草稿。
- 历史会话保持自己的项目目录与工具权限，新默认配置不关闭其他会话；修复追问覆盖会话标题。
- 移除 500 条会话索引截断，恢复遗漏 JSONL 的合法历史入口；增加搜索、分批展示、后台审批提醒及指定会话进程关闭入口。
- 临时连接失败进行有界退避重试并回读状态，禁止自动重放任务；避免旁路会话列表读取失败被误报为发送失败。
- 工具守卫规范化私有目录真实路径，兼容 macOS 临时目录别名和 Windows junction，防止路径别名导致私有目录识别失效。
测试与边界 (Testing)
- 构建间接依赖 source-map-js 锁定至 1.2.2，修复 GHSA-68fv-2mgg-jv7q；未升级 Vite 或其他框架。
- 三平台 CI 和发布前门禁增加真实 Pi 1.1.0 RPC 验收，仅使用本地模拟 Provider，覆盖流式完整性、模型切换、审批、取消、项目隔离和历史恢复。
- Pi 继续标记实验版；思考档位、运行中排队/steer、附件、压缩/分支、Skills/MCP 等完整对标能力尚未开放。工作目录不是操作系统沙箱。

兼容性 (Compatibility)
- 官方 OpenClaw 稳定基线更新至 2026.9.8；默认安装、部署脚本与 Docker 镜像同步，保留旧版协议及汉化版选择，不自动升级现有运行时。
- Hermes 稳定安装目标更新至 0.21.5（v2026.9.24），固定源码提交和安装器校验；适配新版受管 Python/Node 与安装阶段顺序。
- DeepSeek Harness 更新目标为 npm 推荐的 0.2.0-rc.2，仍标记为预发布版；不默认切换到 OpenClaw beta 或 DSH alpha。
修复 (Fixes)
- 修复 Hermes 能力接口认证与 Web handler 方法绑定，恢复启动和聊天链路。
- Hermes 原生 YAML 端口、环境变量端口按正确优先级探测；旧面板端口别名迁移为原生字段，保留原字段及备份。启动守护保留 host、port、嵌套选项和其他平台配置。
- 多 Gateway 看板识别新共享宿主及命名 Profile 的宿主记录，使用实际监听端口，避免重复启动和按进程名批量结束其他实例。
- 修复 DSH 新版登录的相对根目录跳转识别，继续限制认证 Cookie 和跳转目标；验证内嵌工作台模型切换及刷新保留选择。
- 修复 Docker 构建输入遗漏引擎后端模块、共享库和版本策略，排除本机测试运行时与依赖缓存。生产 Node 升至 OpenClaw 要求的 24.16.0。
测试与验证 (Testing)
- 增加端口环境回退、旧端口迁移、共享宿主发现、认证、Web 方法绑定及 Docker 打包回归。
- 实际 OpenClaw Gateway 握手和配置读回、Hermes Profile/共享宿主/模型对话/服务启停、DSH 内嵌模型切换及流式对话通过隔离验证；聊天使用本地测试模型。
- 新增独立的手动 Runtime Compatibility 工作流，验证实际 Docker 镜像的 Web 健康、配置校验与 Gateway 握手。现有三平台 CI 门禁保持不变。
- 版本与验证范围见 docs/compatibility-2026-10-07.md；真实渠道账户、真实付费模型和预发布 beta/alpha 不纳入本次端到端验收。

修复 (Fixes)
- 实时聊天接入 OpenClaw question.requested / question.resolved、question.list 和 question.resolve：支持单选、多选、自由输入、逐题填写及取消，刷新或重连后恢复待答问题。
- 等待人工回答时暂停输出超时和托管续发；答案提交失败保留草稿，过期及其他客户端已处理的问题同步关闭。旧内核按 RPC 能力降级。
- 仅当前会话的工具活动延长空闲计时；正常卡死仍有超时检测，避免后台其他 Agent 干扰当前会话。
- 修复最终回复仍沿用最后一帧 delta 的截断：收到 final 后使用其权威全文渲染和保存。
- 敏感配置提问提示转到 OpenClaw 原生面板处理，不经普通聊天输入或本地历史保存密钥。
测试与验证 (Testing)
- 新增 22 项交互提问与聊天超时回归测试，覆盖三题答案、重连恢复、提交失败重试、跨会话隔离、旧内核降级和 final 全文保存。
- 官方 OpenClaw 2026.9.4 隔离浏览器验收通过真实提问、答案提交与回读、刷新恢复、过期关闭；实际待答 212 秒未误报输出超时。验收范围与未覆盖平台见 docs/chat-question-compatibility-2026-09-15.md。

兼容性 (Compatibility)
- 适配 OpenClaw 2026.9.4 的 Node.js 版本要求、npm 渠道插件安装来源确认和原生插件注册表；保留旧版协议与插件目录检测。
- 核对 Hermes 0.21.2（v2026.9.11）的模型/Profile 配置与 Windows/Linux 安装器阶段协议；默认稳定版本暂不切换，完整升级验收另行执行。
- DeepSeek Harness 受管目标升级至 0.1.5-rc.2（候选版），适配新版会话认证与 Typert RPC，保留旧版 RPC 分支。运行与配置页增加显式更新入口，不自动降级较新版本。
修复 (Fixes)
- 修复渠道插件包名重复拼接版本（@latest@版本）与汉化版本错误截断官方修订号，独立插件不跟随内核版本锁定。
- Web 渠道安装改为异步执行并实时显示日志；安装结束必须回读插件文件，失败保留实际错误，防止安装卡住面板或虚报成功。
- 修复新旧插件目录、QQ manifest ID 与内置插件检测；共享配置的并发安装互斥，重复安装保留现有插件。
- 补齐 Web 微信安装/更新及渠道登录操作；微信按宿主版本选择精确兼容版本，并核对安装后实际版本，不再预先删除插件与账号配置。登录二维码使用本地 CLI 矩阵，不向外部二维码服务传递登录链接。
- 按微信官方文档补齐新旧版本线、wechat 别名、重启入口和扫码后待就绪提示；未知版本不自动更新或显示已兼容，手动命令同样固定兼容版本。
- 飞书新安装使用官方 @openclaw/feishu，保留已有 Lark 实现；桌面保存不再强制禁用官方插件。补充 Zalo Personal 扫码入口。
- 修复 DSH 启动后 401 误报失败、内嵌页面资源路径导致白屏；启动认证信息仅保留在内存，代理剥离面板凭据，日志隐藏启动令牌。
- DSH 新版使用官方网页目录选择器启动叠加层，远程用户无需操作服务器系统窗口；不修改用户 Profile。错误信息保留展示，认证失败的受管进程仍可停止。
适配边界 (Known limitations)
- 本版不代表全部消息渠道端到端验收完成。QQ Bot 2.0 的插件 ID/账号规则、腾讯元宝与 Zalo ClawBot 专属向导仍在适配中。
- OpenClaw/Hermes 默认稳定基线保持不变；DSH 目标 0.1.5-rc.2 是候选版，不自动升级用户运行时。
- 微信等渠道完成安装、配置与 Gateway 接口验证，真实账号扫码/收发、多账号隔离及全部平台实机验收尚未覆盖。
测试与验证 (Testing)
- 官方 OpenClaw 2026.9.4 + Node 24.16.0 隔离实测通过协议 4 握手及主要只读 RPC；LINE、IRC、微信插件完成真实安装和状态回读，安装期间 Web 健康接口持续响应。
- 微信 Web 页面完成真实版本检测、精确版本重装和回读；飞书、Zalo、Zalo Personal 完成真实安装，四类渠道配置通过官方 CLI schema 校验。验收范围与未覆盖项目见 docs/compatibility-2026-09-14.md。
- DSH 0.1.5-rc.2 隔离实测通过安装、模型与上下文参数同步、网页选工作区、切换模型、内嵌流式对话（本地测试接口）、重装和重启后配置回读；详见 docs/deepseek-harness-compatibility-2026-09-14.md。

兼容性 (Compatibility)
- 官方 OpenClaw 稳定基线升级到 2026.8.2 — 安装向导、Linux 一键部署与 Docker 镜像默认使用官方 openclaw@2026.8.2；继续保留 8.1 起的 agents.entries、模型策略和 Gateway challenge 时间戳兼容逻辑，并保持对旧版内核的协议范围兼容
修复 (Fixes)
- 仪表盘实时刷新 WebSocket 状态 — Gateway 握手完成后立即把“握手中”更新为“已连接”，无需切页或手动刷新
测试与验证 (Testing)
- 官方 npm openclaw@2026.8.2 隔离运行时通过配置 schema、Agent 注册表、协议 4 Gateway 握手、health/status、消息渠道、路由地图、梦境模式与真实本地模型对话回归

修复 (Fixes)
- 修复 OpenClaw 2026.8.1 WebSocket 远程 Origin 拒绝 — Web/Ubuntu 代理不再把浏览器公网或局域网 Origin 直接传给本机 Gateway，统一使用受面板 Session 保护的 loopback 上游来源，实时聊天、路由地图、渠道运行态与梦境模式恢复连接
- 阻止 Web 前后端混装 — /__api/health 返回后端版本和 API 契约版本；浏览器检测到只替换 dist/ 导致版本不一致时停止加载，并明确提示安装完整 Web 包
改进 (Improvements)
- 区分完整 Web 包与桌面热更新包 — Release 中 web-x.y.z.zip 改为可独立运行的完整 Node Web 服务端包，frontend-hot-update-x.y.z.zip 仅保留给桌面端前端热更新，避免用户误装

修复 (Fixes)
- 兼容 OpenClaw 2026.8.1 Gateway 新握手 — Web、桌面端、实时聊天和聊天诊断统一复用 connect.challenge.ts 完成 Ed25519 设备签名，修复官方 8.1 运行正常但 ClawPanel 报“设备签名失败/内核过旧”的问题
- 继续兼容旧版 Gateway — 旧版 challenge 未提供时间戳时回退客户端当前时间，并保持 3..4 协议协商范围；Token 与 Password 认证按 7.1/8.1 共同签名契约处理
- 纠正连接错误诊断 — 设备签名、Nonce、Public Key 错误不再误判为协议版本过旧，只有明确的协议协商错误才提示升级内核
改进 (Improvements)
- 稳定版默认使用官方原版 — 安装向导、未知来源升级、Linux 一键部署和 Docker 镜像默认使用官方 openclaw@2026.8.1；汉化版 2026.7.1-2-zh.1 继续作为明确选项，已有汉化安装不会被强制切换
- 增加真实 Gateway 握手回归工具 — 新增隔离设备密钥的 smoke 脚本，可分别验证官方/汉化版以及 Token/Password 认证，不读取或输出用户密钥
测试与验证 (Testing)
- 官方 openclaw@2026.8.1 完成 Token 与 Password 两种真实 Gateway 握手；汉化版 @qingchencloud/openclaw-zh@2026.7.1-2-zh.1 完成 Token 握手，三组均协商到协议版本 4
- Node 全量测试、Rust 单元测试、生产构建、格式检查、编译检查、Clippy 严格门禁和 Linux 部署脚本语法检查通过

兼容性 (Compatibility)
- 适配 OpenClaw 2026.8.1 Agent 注册表 — Web 与桌面端同时支持旧版 agents.list[] 和新版 agents.entries.{id}，Agent 列表、增删改、身份、模型、Workspace、Memory 与 Skills 均按当前内核配置形状读写，并为多 Agent 配置维护 ownership: "explicit"
- 清理 8.1 退役配置字段 — 校准、普通保存、Docker 节点同步和已有配置回读会按已安装内核版本移除 commands.ownerDisplay* 与 gateway.controlUi.allowInsecureAuth；旧汉化内核继续保留原字段，避免两套严格 schema 互相污染
- 适配 8.1 模型策略语义 — 保留 agents.defaults.models 作为模型元数据；仅在用户已经启用显式 modelPolicy.allow 时同步白名单，避免把新版默认的 allow-any 配置意外收紧
- Web 端补齐 OpenClaw Doctor — Web/Ubuntu 可直接执行当前绑定 CLI 的诊断与修复；8.1 自动使用非交互迁移参数，Web 改为异步子进程并将迁移超时提升至 120 秒，桌面端同步提升超时
- 官方稳定版基线更新 — 官方 OpenClaw 推荐版本更新为 2026.8.1；汉化版继续保持当前已发布的 2026.7.1-2-zh.1，避免向旧内核写入新版配置形状
测试与验证 (Testing)
- 官方 npm openclaw@2026.8.1 隔离运行时完成旧 agents.list → 新 agents.entries Doctor 迁移、配置回读、Gateway 启动、HTTP 200、CLI health 与 RPC status 验证；ClawPanel 直接生成的 8.1 keyed 配置通过官方 schema 校验
- 当前本机汉化版 2026.7.1-zh.2 隔离配置继续通过旧 agents.list schema 校验
- node --test tests/*.test.js：597 项，596 passed、1 项 POSIX 用例在 Windows 跳过；Rust cargo test --locked：363 passed；生产构建、格式检查、编译检查和 Clippy 严格门禁通过

修复 (Fixes)
- Gateway 缺失依赖可直接定位 — 启动诊断会识别 Cannot find package / MODULE_NOT_FOUND，明确显示缺失的 OpenClaw 运行依赖，不再让用户把 npm 安装损坏误判为模型、端口或 API Key 问题
- OpenClaw 安装完成后校验运行依赖 — Web 与桌面安装器除版本检查外，还会核对主包声明的全部直接运行依赖；镜像源返回不完整安装时自动切换 npm 官方源重装，避免“安装成功但 Gateway 无法启动”
改进 (Improvements)
- 诊断窗口支持一键修复 — 对可修复的运行依赖缺失提供“一键修复 OpenClaw”，保留现有配置、强制重装当前稳定版、完成依赖校验并自动重新启动 Gateway
- 修复流程保持安装模式 — 自动识别官方版、汉化版以及 npm/standalone 来源，优先沿用当前运行模式和 ClawPanel 绑定的稳定版本
测试与验证 (Testing)
- 使用用户实际反馈的 @openclaw/ai 缺失日志补充诊断回归；Web 与 Rust 后端均覆盖不完整 npm 依赖树拒绝、完整依赖树通过和镜像失败切换官方源
- node --test：589 项，588 passed、1 项 POSIX 用例在 Windows 跳过；Rust cargo test --lib：360 passed；生产构建、格式检查和 Clippy 严格门禁通过

修复 (Fixes)
- 启动卡顿与重复拉起保护 — 首屏改为按需加载当前语言、合并仪表盘并发刷新，Windows 僵尸 Gateway 扫描移至后台；Web 与桌面端统一串行化 Gateway 启停操作，避免多个入口同时唤起 OpenClaw
- Gateway 启动错误可见 — 启动失败、超时和自动修复失败会保留本次新增的 stderr，并在仪表盘、服务页和设置页展示可复制的诊断信息；用户启动失败后守护进程保持停机，避免后台反复重试
改进 (Improvements)
- Hermes 稳定版升级到 0.20.5 / v2026.8.19 — 安装与更新改用官方源码安装器，并固定发布标签、提交 SHA 和安装脚本校验值，避免继续使用新版已经禁止的 uv tool install git+... 构建路径
- Hermes 生命周期更可控 — Web 与桌面端统一管理源码目录、虚拟环境和安装缓存；更新继续跟随 ClawPanel 选定的稳定版，卸载只清理由面板创建的进程和运行时，默认保留用户配置、会话与数据
兼容性 (Compatibility)
- 适配 Hermes 0.20.5 CLI 与 Profile 输出 — 版本检测兼容新版 hermes --version，Profile 列表支持显示名、canonical id 和 Distribution 列
- 模型渠道与 Provider 对齐上游 — 更新内置 Provider 注册表，并补充 Gemini Native、OpenAI API、Fireworks、Tencent TokenHub、xAI OAuth 等新版接入方式
- 保护新版配置模板 — 模型同步只修改顶层模型路由，不再误改 stt.local.model 等嵌套字段；Dashboard 使用外置兼容资源，避免污染受管源码目录
测试与验证 (Testing)
- Hermes 0.20.5 隔离环境完成安装、重复更新、版本检测、Profile 增删改查、Dashboard/API、模型同步、Gateway 健康检查、保留数据卸载和完整卸载闭环
- 安装结果固定到提交 fcbd1076a93841fa88855acce810e342a5b78101，源码工作区保持干净；前端、Node 测试及 Rust 质量门禁均纳入回归验证

新功能 (Features)
- OpenCode 第四引擎 — 新增 OpenCode 管理入口、独立工作台和受管本地运行时，支持安装、启动、停止、状态检测、在线更新与一键卸载
- 面板内置 OpenCode Web 工作台 — 左侧可直接在“运行与配置”和“工作台”之间切换，用户无需单独打开 OpenCode 页面即可管理项目、会话、模型和实际编码任务
- 统一模型渠道同步到 OpenCode — 模型渠道可同步 Provider 地址、API Key、模型列表、默认模型、上下文窗口和最大输出长度，并与 OpenClaw、Hermes、DeepSeek Harness 和助手共用同一配置入口
改进 (Improvements)
- 运行中无感更新 — 检测 npm 最新版本后，先在 staging 目录完成安装和校验，再备份并原子切换运行时；更新前正在运行的服务会自动停止并在成功后恢复
- 失败自动回滚 — OpenCode 更新安装、切换或重启失败时会恢复旧运行时，避免升级中断后留下不可用状态
- Web/headless 安全集成 — OpenCode 仅监听回环地址，ClawPanel 使用短期能力令牌代理 HTTP/WebSocket；兼容 Ubuntu Web 部署和 Tauri 桌面端
- Windows 命令兼容 — npm 安装与升级统一经 cmd.exe 启动，避免 Windows Node 子进程直接调用 npm 时出现 EINVAL
安全 (Security)
- 凭据与配置隔离 — OpenCode 凭据独立保存并限制文件权限，代理会剥离 ClawPanel Cookie、Authorization 和来源头，内嵌页面使用受限 sandbox
- 受管卸载边界 — 卸载会先安全停止由面板启动的 OpenCode 进程，只移除 ClawPanel 专用运行目录，并保留用户配置、凭据与工作区数据
测试与验证 (Testing)
- node --test tests/*.test.js：572 项，571 passed、1 项 POSIX 用例在 Windows 跳过
- npm run build：通过
- cargo fmt --all -- --check、cargo check --locked、cargo clippy --locked --all-targets -- -D warnings、cargo test --locked：357 passed
- 本地真实生命周期：OpenCode 1.18.20 → 1.18.21 运行中更新、自动重启、运行中卸载、配置保留和重新安装全部通过
- 本地 Web Playwright：桌面端及 390px 移动端管理页/工作台通过，横向溢出与浏览器控制台错误均为 0

修复 (Fixes)
- Linux/Web 配置文件权限不再被锁死 — ClawPanel 以 root 运行并原子保存 openclaw.json 时，会保留原文件的 UID、GID 和权限，不再把配置替换为 root:root + 0600，避免 OpenClaw 原生面板和普通用户进程失去读写权限
- 桌面端与模型渠道写入保持一致 — Tauri 配置写入及模型渠道 JSON 原子替换同步保留已有 POSIX 文件元数据，新建敏感配置仍默认使用安全的 0600
兼容性 (Compatibility)
- OpenClaw 修正版基线对齐 — 推荐稳定版更新为官方 2026.7.1-2 / 汉化版 2026.7.1-2-zh.1，Linux 部署、版本策略和功能目录使用同一稳定基线
安全 (Security)
- nanoid 构建依赖升级 — 锁定到 3.3.18，修复自定义生成器在长度为零时可能无限循环导致拒绝服务的问题；npm audit 当前为 0 vulnerabilities
测试与验证 (Testing)
- node --test tests/*.test.js：555 项，554 passed、1 项 POSIX 用例在 Windows 跳过；同一权限用例在 Linux 容器通过
- npm run build：通过
- cargo fmt --all -- --check、cargo check --locked、cargo clippy --locked --all-targets -- -D warnings、cargo test --locked：354 passed
- Linux Tauri 依赖环境：cargo check --locked 及 POSIX 元数据保留单测通过

新功能 (Features)
- DeepSeek Harness 第三引擎 — 新增 DeepSeek Harness 管理入口，固定安装已验收的 @deepseek-ai/dsh 0.1.1-rc.2，支持本地受管运行时安装、启动、停止、卸载、版本检测和端口配置
- 独立 Harness 工作台 — 左侧导航拆分为“运行与配置”和“工作台”；管理页专注运行时与 Provider 状态，工作台独立承载完整原生 Web 界面，可直接进行对话、工作区选择、模型切换和会话管理
- 统一模型渠道同步到 DSH — 模型渠道可写入 Harness Provider、凭据引用、模型列表、上下文窗口、最大输出长度和默认模型，并通过 Harness RPC 回读确认同步结果
改进 (Improvements)
- Web/headless 无需额外开放 DSH 端口 — Harness 只监听 127.0.0.1，ClawPanel 使用短期专用令牌代理 HTTP、WebSocket、插件和静态资源，Ubuntu Web 部署可直接在面板内使用完整工作台
- Harness 工作台状态持久化 — 沙箱内的工作区和界面偏好通过受限存储桥接保存，重新加载 iframe 或刷新短期令牌后继续保留
- 工作台响应式布局 — 桌面端使用接近全屏的独立操作区，移动端工具栏自动换行并保留触控空间；Harness 未启动时提供明确的配置页入口
安全 (Security)
- 内嵌代理凭据隔离 — 代理请求会剥离 ClawPanel Cookie、Authorization、转发来源和浏览器来源头；Web iframe 使用不含 allow-same-origin 的沙箱，专用令牌不能调用 ClawPanel API 或访问父页面 DOM
- 受管进程边界 — 安装和卸载限制在 ClawPanel 专用运行目录，停止操作只处理面板启动且身份核对一致的进程，不会终止端口上的其它服务
测试与验证 (Testing)
- node --test tests/*.test.js：554 passed
- npm run build：通过
- cargo fmt --all -- --check、cargo check --locked、cargo clippy --locked --all-targets -- -D warnings、cargo test --locked：354 passed
- 本地 Web Playwright：管理页/工作台左侧切换、完整 DSH 页面、HTTP/WebSocket 代理、Provider 同步、LM Studio 上下文窗口覆盖、存储持久化、桌面及 390px 移动布局均通过，浏览器控制台错误为 0

兼容性 (Compatibility)
- OpenClaw 新版 Web 配置同步恢复 — Web/headless 保存模型 Provider 后，会同步更新 openclaw.json 与每个 Agent 的 models.json，连接信息、模型能力、上下文长度和结构化密钥保持一致；运行中的 Gateway 会在回读确认后重启加载新配置
- Hermes Agent 新版 Profile 适配 — 同时兼容新版纯名称列表和旧版状态表格，Profile 页面可直接配置 Provider/模型，聊天页可在 Gateway 停止时直接启动
改进 (Improvements)
- LM Studio 上下文长度可编辑 — 模型编辑器新增 contextTokens 字段，不再固定为 50000；保存后同步到主配置和所有 Agent，并在刷新后正确回显
- Linux Web 自定义端口 — 原生部署支持 CLAWPANEL_PORT / PANEL_PORT，Docker 与 Compose 的监听端口和健康检查会跟随 PORT 配置
- Hermes Profile 移动端布局 — Profile 操作区支持自动换行，按钮满足移动端触控高度并消除横向溢出
修复 (Fixes)
- Web Gateway 探测返回 HTTP 500 — 移除 ESM 运行时残留的 require('net')，端口关闭时稳定返回 false，不再污染控制台或阻断模型保存流程
- Docker 镜像构建和运行失败 — 复用官方 Node 镜像内置用户，避免 Alpine UID/GID 1000 冲突；补齐 Web API、运行时模块和 public 静态资源，生产镜像可完整构建并加载页面资源
- Hermes Profile 信息缺失 — 修复新版 profile list 输出被旧表格解析器过滤的问题，并保持桌面端与 Web 端解析行为一致
安全 (Security)
- PostCSS 构建依赖升级 — 锁定到 8.5.25，修复受控 sourceMappingURL 在缺少 from 时可能读取任意 .map 文件的问题；npm audit 当前为 0 vulnerabilities
- Rust 网络与序列化依赖升级 — quinn-proto 更新到 0.11.15，修复乱序流重组可能造成的远程内存耗尽；serde_with 更新到 3.21.0，修复空序列或 Map 条目序列化 panic
测试与验证 (Testing)
- node --test tests/*.test.js：537 passed
- npm run build：通过
- cargo fmt --all -- --check、cargo check --locked、cargo clippy --locked --all-targets -- -D warnings、cargo test --locked：通过
- 本地生产 Web Playwright：OpenClaw 核心路由、LM Studio 配置同步、Hermes Gateway/Profile 和移动端布局全部通过，页面错误、HTTP 500、失败请求和控制台错误均为 0
- Linux Docker 实测：镜像构建、OpenClaw CLI、LM Studio 50000 → 196608 写入/Agent 同步/刷新回读、自定义端口及健康检查全部通过

改进 (Improvements)
- 性能优化 — 优化部分页面与配置流程的响应和交互体验
- 内容优化 — 调整界面内容与常用配置入口
- 文档调整 — 更新使用说明、多语言内容与相关文档

新功能 (Features)
- 创作中心与后台生成队列 — 新增图片、视频生成和本地产物管理；提交后立即进入持久化后台队列，支持并发控制、队列状态、历史记录、重启恢复和批量连续提交
- 多服务商媒体生成 — 支持火山方舟、OpenAI / GPT 与 NewAPI / OpenAI 兼容网关，可分别配置 API Key、Base URL、图片模型、视频模型、超时和产出目录
- 统一模型渠道 — 新增统一渠道页，一处维护服务商、接口、密钥和模型列表，并显式同步到 OpenClaw、Hermes 与晴辰助手；支持从 OpenClaw 导入、在线拉取模型和未同步状态提示
- U 盘便携模式双向迁移 — 支持迁移到便携目录及从 U 盘迁回本机；配置、Agent、记忆、模型渠道和媒体数据一并迁移，目标已有数据会先备份再切换
兼容性 (Compatibility)
- OpenClaw 2026.7.1 稳定版适配 — 推荐稳定版切换到官方 2026.7.1 / 汉化修复版 2026.7.1-zh.2；桌面端、Web/headless、Linux 部署与 standalone 安装统一使用同一稳定基线
- OpenClaw 7.1 Node.js 门槛对齐 — 优先读取安装包 engines.node，缺少包元数据时按 >=22.22.3 <23 || >=24.15.0 <25 || >=25.9.0 兜底，避免误放行 Node.js 23 或过旧的 24.x
- OpenClaw 7.1 配置契约对齐 — 旧字符串模型自动迁移为含 id/name 的完整对象，旧 Codex Responses API 类型迁移到正式名称；未知 API 类型和模型能力元数据继续保留
- Hermes Agent 稳定版跟进 — 安装与升级固定到 Hermes Agent 0.18.2 / v2026.7.7.2，同步最新 Provider Registry，并补齐 Gateway 运行所需的 croniter、httpx、openai、aiohttp、websockets
- Hermes Dashboard 兼容 — 优先使用上游 dashboard_auth，并提供受管 Web dist 作为 token bootstrap 兜底，桌面与 Web/headless 启动行为一致
改进 (Improvements)
- 模型同步改为可验证事务 — OpenClaw 只提交目标 provider 的最小补丁并回读核对；Hermes 在备份、落盘和回读成功后才标记同步完成；助手同步同样执行本地回读确认
- 模型密钥与能力字段无损往返 — 结构化 SecretRef、环境变量引用、上下文长度、输入能力和未知字段不会在编辑、导入或同步时被字符串化或丢失
- OpenClaw 安装升级原子化 — npm 安装会先校验目标 Node.js 要求；standalone 归档通过 SHA-256、版本和运行依赖校验后再 staging/backup 切换，失败自动恢复旧安装
- OpenClaw standalone 双源容灾 — 固定版本从 GitHub 下载时不再依赖 CDN latest.json；便携模式优先使用 U 盘内置 Node.js 与 CLI，并避免污染宿主机 PATH
- Hermes 安装体验完善 — 安装与升级日志实时输出，支持 PyPI / Git 镜像、断点续行和可操作错误提示；环境异常时停留等待用户处理，不再自动跳页
- Hermes 安装运行时加固 — 桌面端受管 uv 更新到 0.11.28，拒绝早于 0.11.24 的缓存冲突版本；wheel 元数据或分发缓存异常时自动使用隔离缓存重试，Web/headless 同步采用相同恢复策略
- Web 自定义域名兼容 — 自动配对会把浏览器当前 Origin 增量写入 Gateway 白名单，支持 HTTPS 域名和自定义端口部署
- 初始设置页首屏提速 — 本地检测先渲染、网络版本信息异步补充，并复用启动缓存，避免 npm registry 查询阻塞首屏
- 发布流水线加固 — CI 在三平台运行锁定依赖的 Node / Rust 测试、格式、编译和 lint；tag 发布前校验版本、tag 与 HEAD 一致性，并在全平台产物成功后统一发布
安全 (Security)
- 桌面运行时安全升级 — Tauri 升级到 2.11.1，修复远程页面可能混淆 Origin 并调用本地 IPC 的问题；tar 升级到 0.4.46，修复 PAX header 解析不同步问题
- OpenClaw 配置安全写入 — 配置修改使用备份、同目录临时文件、fsync、原子替换和回读校验；失败保留最后有效备份，避免模型配置保存导致主配置损坏
- 外部密钥引用保护 — 未改动的环境变量和结构化 SecretRef 不再阻断无关保存，也不会被当作明文写回；file / exec 引用不会被模型测试误当 API Key
- 媒体 API Key 防泄漏 — 下载产物时仅向与服务商 Base URL 同源的地址携带 Authorization，跨源重定向自动剥离密钥，并限制响应体大小与读取超时
- 助手付费生成必须确认 — 媒体生成工具默认关闭且需显式启用；图片、视频等付费请求在任何助手模式下都必须二次确认
- 便携迁移路径保护 — 拒绝父目录穿越、源目标重叠和目录链接绕过，失败迁移不会留下半成品 manifest 或覆盖现有目标
修复 (Fixes)
- OpenClaw 7.1 初次安装缺少运行依赖 — standalone 激活前校验 CLI 及核心运行依赖，失败不会替换现有安装；npm 与 standalone 路径统一按目标版本检查环境
- OpenClaw 7.1 Gateway 重载不稳定 — 配置写入交给内核 watcher 热重载，不再探测不存在的面板端口；Windows 启动终端会等待受管 Gateway 进程退出，关闭窗口即可停止服务
- 实时聊天长时间卡住 — 等待首个响应期间也可中止本次运行，输入状态变化会重新同步发送按钮；连接恢复后不会继续保持错误的禁用状态
- 模型配置破坏未知字段 — 保存和删除 provider 改为最小补丁及显式墓碑，保留其它 provider、认证资料和上游新增字段；旧模型结构会在写入前安全迁移
- 模型渠道下拉显示 [object Object] — API 类型选项改为可读名称，未知类型在编辑时仍保留原值供用户确认
- Hermes 安装 wheel 元数据无效 — 修复旧 uv 缓存冲突导致 annotated-types 报 Metadata field Name not found；自动升级受管运行时并在缓存异常时透明重试
- Hermes 0.18.2 Windows 启动后端口未就绪 — 所有 Hermes 子进程显式继承 ClawPanel 管理的 HERMES_HOME，避免新版平台默认目录变化导致读取空配置；启动前自动补齐 API Server 开关和随机强密钥，并保留已有合格密钥与其它环境配置
- Hermes 0.18.2 自定义模型无回复 — 旧版裸 custom 配置自动迁移为新版命名 Provider，继续使用用户原有 Base URL 和密钥环境变量；迁移前备份 config.yaml，保留其它模型及高级配置，避免请求误回退到 OpenRouter 后返回 401
- Hermes 仪表盘误导性 9119 入口 — 隐藏默认不运行且当前安装包不提供完整页面的原生 Dashboard 外链；继续保留 ClawPanel 内置仪表盘、实时聊天及内部按需 Dashboard API 能力
- 创作中心提交后按钮一直禁用 — 后台刷新后重新定位当前表单按钮，生成完成或失败都会正确解锁；图片和视频提交不再阻塞页面等待云端任务结束
- 视频任务瞬时错误失联 — 429 / 5xx 时保留任务并继续轮询；已有服务商任务 ID 的失败任务可恢复，无法识别任务 ID 时也保留原始响应供排查
- 媒体历史膨胀与大文件卡顿 — 持久化前裁剪大体积原始响应，预览限制 64MB 并限制缓存数量；跨端视频状态解析保持一致
- 便携迁移数据和状态异常 — 媒体配置与历史跟随 OpenClaw 数据迁移，失败会显示原因并保持原目标可恢复；Web 多实例查询固定在本地执行
- 未安装时反复跳回检测页 — 安装失败不再强制重置向导；窗口聚焦只在后台更新检测结果，API Key / 配置错误改为页面内持续展示
- 默认密码无提示挡住登录 — 使用出厂密码 123456 时，桌面与 Web 锁定页均直接提示并预填，登录后引导立即修改
- 移动端语言菜单点穿 — 关闭状态不再拦截点击，切换语言后同步收起菜单和侧栏并更新 html lang
- 跨平台发布被 Tauri 版本校验拦截 — 前端 @tauri-apps/api 与 Rust Tauri 同步到 2.11 系列，并增加锁文件主次版本一致性回归测试
测试与验证 (Testing)
- Node.js 24.15.0 下 node --test tests/*.test.js：512 passed
- Node.js 24.15.0 下 npm run build：通过
- cargo fmt --all -- --check：通过
- cargo check --locked：通过
- cargo clippy --locked

修复 (Fixes)
- Hermes 文件管理路径安全 — 文件读写/列表入口拒绝 .. 路径穿越，并通过 canonical path 校验新文件父目录，避免访问 ~/.hermes 之外的路径
- 配对 token 撤销后不再复活 — 自动配对升级遇到已撤销的 operator token 时会生成新 token，不再复用带 revokedAtMs 的旧 token
- Linux Gateway 清理更保守 — 清理端口占用时会先确认进程命令行属于 openclaw gateway，并在 /health 连续无响应后才终止，避免误杀同端口其他服务或健康 Gateway
- 校准不再恢复用户已删配置 — 继承模式优先使用当前非空配置，只有当前配置为空时才从 .bak 回退，避免旧备份把用户主动删除的 provider/channel 恢复回来
测试与验证 (Testing)
- 已通过 node --test tests/calibration-source-policy.test.js tests/gateway-linux-cleanup-policy.test.js tests/patch-gateway-origins.test.js tests/hermes-web-config.test.js
- 已通过 npm run build
- 已通过 node -e "import('./scripts/dev-api.js').then(()=>console.log('dev-api import ok'))"
- 已通过 cd src-tauri && cargo fmt --check
- 已通过 cd src-tauri && cargo check
- 已通过 cd src-tauri && cargo test normalize_existing_pairing_rotates_revoked_operator_token --lib
- 已通过 cd src-tauri && cargo test select_calibration_source --lib
- 已通过 cd src-tauri && cargo test hermes_fs_path --lib
- 已通过 cd src-tauri && cargo clippy --all-targets -- -D warnings
- 已通过 git diff --check

兼容性 (Compatibility)
- 跟进 Hermes Agent 最新版 Web Search 策略 — Hermes upstream 已回滚无 Key 的 parallel-free 后端；面板不再提供或写入 parallel-free，Parallel 搜索统一使用需要 PARALLEL_API_KEY 的 parallel
- 补充 Hermes 最新模型候选 — Z.AI / GLM、Kimi / Moonshot、Nous Portal 与聚合服务商候选模型补充 glm-5.2、kimi-k2.7-code，减少用户手动输入新版模型名的成本
测试与验证 (Testing)
- 已通过 node --test tests/hermes-web-config.test.js tests/hermes-config-page-ui.test.js
- 已通过 cd src-tauri && cargo test hermes_web_config --lib
- 已通过 npm run build
- 已通过 node -e "import('./scripts/dev-api.js').then(()=>console.log('dev-api import ok'))"
- 已通过 cd src-tauri && cargo fmt --check
- 已通过 cd src-tauri && cargo check
- 已通过 git diff --check

修复 (Fixes)
- 最新版 OpenClaw 的 Node.js 门槛兼容 — 继续保留当前稳定推荐版不变；当用户已安装 OpenClaw 2026.6.5 或更高版本时，面板会按新版运行要求检测 Node.js >=22.19.0，旧稳定版不会被误拦截
- standalone OpenClaw Node.js 检测误判 — standalone 安装会优先使用同目录捆绑的 node / node.exe 做兼容检测，避免被 PATH 中较旧的系统 Node.js 误判
- 配对修复覆盖配置风险 — Gateway 配对流程只增量写入 gateway.controlUi.allowedOrigins，避免用旧的全量配置快照覆盖用户刚保存的模型、认证或安全配置
- 配置写回保留深层字段 — openclaw.json 写回改为对象递归合并，数组与标量仍显式替换，减少升级或自动修复时丢失未知配置字段的风险
兼容性 (Compatibility)
- 兼容 Parallel Web Search 插件 — Web 搜索后端白名单补充 parallel-free 与 parallel，并保留 plugins.entries.parallel.config.webSearch.apiKey / baseUrl 等插件配置
- 保留 OpenClaw 新增配置项 — 支持并保留 memory.qmd.rerank 与 security.installPolicy；校准/重置配置时会继承 memory、security 等高级配置块
- Linux 部署默认仍走稳定版 — 一键部署脚本默认安装 @qingchencloud/openclaw-zh@2026.5.18-zh.1，仅当检测到 OpenClaw 2026.6.5+ 时才提升 Node.js 运行门槛
改进 (Improvements)
- Hermes 配置页补充 QMD 与 Install Policy — 记忆配置新增 QMD rerank 开关，安全配置新增 Install Policy JSON 编辑入口，并保留其他高级 YAML 字段
- 第三方服务商接入规范更清晰 — 贡献指南新增 provider 接入规范，要求服务商 PR 保持中性技术接入，不夹带默认推广位或未经确认的商业宣传
测试与验证 (Testing)
- 已通过 git diff --check
- 已通过 bash -n scripts/linux-deploy.sh
- 已通过 npm run build
- 已通过 node --test tests/patch-gateway-origins.test.js tests/node-runtime-detection-policy.test.js tests/hermes-web-config.test.js tests/hermes-memory-config.test.js tests/hermes-security-config.test.js tests/hermes-config-page-ui.test.js
- 已通过 cd src-tauri && cargo fmt --check
- 已通过 cd src-tauri && cargo check
- 已通过 cd src-tauri && cargo test --lib
- 已通过 cd src-tauri && cargo clippy --all-targets -- -D warnings

修复 (Fixes)
- Node.js 版本过低导致 Gateway 启动失败 — 启动 Gateway 前会读取当前 OpenClaw 安装包的 engines.node 要求，发现 Node.js 不兼容时提前阻断并给出可执行提示，不再让用户看到后端崩溃日志
- Windows Node.js 版本过低时升级引导不足 — 设置向导在检测到 Node.js 过低时提供一键升级入口，通过 winget upgrade/install OpenJS.NodeJS.LTS 安装或升级 Node.js LTS，并在升级后刷新 PATH 检测
- 自定义 Node.js 路径可选中旧版本 — 扫描和手动保存 Node.js 路径时会同步校验版本兼容性，版本不满足当前 OpenClaw 要求的路径不再允许保存
- macOS / Linux / Web 模式缺少同等保护 — 桌面端 macOS 启动链路、Web/headless 后端 start_service、路径扫描和自定义路径保存均补齐 Node.js 兼容检测
- 新手引导误导用户创建 Agent — 默认 main Agent 已内置可用；仪表盘新手步骤改为“确认默认 Agent”，有任意 Agent 即视为完成，不再要求用户创建第一个 Agent
改进 (Improvements)
- 升级弹窗体验优化 — 自动过滤 winget 进度块和旋转符号噪音；升级成功后按钮改为“完成”，并提示回到仪表盘或服务页启动 Gateway
- 跨端 Node.js 升级提示更清晰 — Windows 显示一键升级，macOS / Linux 显示各自的手动升级建议和重启/重新检测提示
- Gateway 错误更用户友好 — 服务页会把 Node.js 版本过低错误转成普通用户能理解的升级提示
- 发布文案口径统一 — Release Notes、README、多语言 README 与部署文档统一说明 Node.js 要求，避免把 ClawPanel Web 后端的 Node.js 18+ 误读为当前 OpenClaw Gateway 的完整运行要求
测试与验证 (Testing)
- 已通过 npm run build
- 已通过 node -e "import('./scripts/dev-api.js').then(()=>console.log('dev-api import ok'))"
- 已通过 cd src-tauri && cargo fmt --check
- 已通过 cd src-tauri && cargo check
- 已通过 cd src-tauri && cargo test node_requirement --lib
- 已通过 git diff --check
- 已通过 npm run tauri build（Windows NSIS / MSI 本地打包）

修复 (Fixes)
- Windows OpenClaw 切换/升级后版本丢失 — 修复 npm 源切换时新旧包共用 openclaw.cmd，旧包卸载把新 CLI shim 一并删除的问题；安装成功后会重新确认 npm CLI 入口、读取版本并写入 ClawPanel 绑定
- standalone 升级后仍使用旧 CLI — standalone 安装完成后先校验目标 CLI 版本，再自动切换当前绑定路径，避免升级成功但面板仍指向旧 npm 全局目录
- 多安装路径提示误导 — 安装管理与仪表盘会区分“当前绑定安装”和 PATH 残留；已绑定新版时，旧 npm 路径只提示为 PATH 残留，不再误导用户再次绑定旧版
- Gateway 配对失败 / role-upgrade 循环 — 自动配对会补齐已有设备记录中的 operator role、scopes、approvedScopes 和 operator token，避免控制台反复提示 pairing required: device is asking for a higher role
- 配对修复误杀手动 Gateway — 设备配对和聊天页自动配对不再主动 reload/restart Gateway，避免 Windows 上手动启动的 Gateway 被面板重启打断
- Codex 导入缺少 API Key 后 OpenClaw 无法启动 — 导入 Codex/OpenAI 客户端配置时，如果引用的环境变量缺失，会阻止导入并提示补齐；保存 OpenClaw 配置时也会校验模型服务商的环境变量引用
- 仪表盘升级后仍显示旧版本/未知来源 — 升级或卸载完成后自动清理仪表盘版本缓存并刷新；自定义 npm prefix（如 D:\...\npm-global\openclaw.cmd）会读取 shim 内容识别为官方版或汉化版
- 升级弹窗关闭无效 — 修复升级完成后关闭按钮可能被页面刷新打断的问题
改进 (Improvements)
- 安装校验更严格 — npm 与 standalone 安装完成后都会校验目标版本，校验失败会保留旧绑定并给出明确错误
- Gateway 重装提示更清晰 — 切换 OpenClaw 源后会先修复并绑定当前 CLI，再重装 Gateway 服务，失败时保留更明确的手动处理提示
- Web/dev 后端行为对齐 — scripts/dev-api.js 同步桌面端的配对规范化、模型环境变量校验、安装绑定和 PATH 残留处理逻辑
测试与验证 (Testing)
- 已通过 npm run build
- 已通过 node --check scripts\dev-api.js
- 已通过 cd src-tauri && cargo fmt --check
- 已通过 cd src-tauri && cargo check
- 已通过 cd src-tauri && cargo test commands::pairing::tests
- 已通过 npm run tauri build（Windows NSIS / MSI 本地打包）

新功能 (Features)
- 接入官方独立站 API — 客户端版本发现、推荐安装包、下载链接、公告通知统一走 https://claw.qt.cool，由 Rust/Tauri 后端封装后提供给前端使用
- 完整安装包更新流程 — 启动检查和关于页改为推荐下载官方完整安装包，按 Windows / macOS / Linux 展示安装引导，不再把 Web 热更新作为用户主路径
- 官网公告与通知中心 — 新增左下角系统公告入口，支持通知与固定公告分流、关闭去重、中文/英文 fallback，以及官网 surface=client 公告接口
- 桌面端心跳统计 — Tauri 后台任务定时上报匿名稳定 client id、版本、平台、架构、语言等粗粒度信息，用于官网统计在线情况
- 登录页语言切换 — 首次登录和锁屏登录页支持直接切换语言
改进 (Improvements)
- 更新弹窗重设计 — 支持 Markdown 更新日志、安全渲染、长日志滚动、底部按钮固定、移动端适配和官网 / GitHub 下载入口
- 关于页更新入口收口 — 版本卡片只展示推荐安装包和 GitHub 备用下载，不再暴露热更新按钮
- 公告 UI 收紧 — 公告弹窗、底部工具按钮、默认密码提醒条都改为更轻量的客户端风格，减少遮挡
- 多引擎侧边栏适配 — 修复 Hermes / Xintian 主题对底部工具按钮的旧样式污染，通知、夜间模式、语言按钮统一为紧凑图标按钮
- 官网 URL 安全归一化 — 下载链接只允许官方站和 GitHub fallback，latest / announcements / legacy update 请求都附带 _t 缓存小尾巴
- 移除旧官网单页 — 删除仓库内 docs/index.html，官网由独立站维护；版本同步脚本不再处理旧官网 SEO 内容
修复 (Fixes)
- Windows OpenClaw CLI 路径识别 — 补充 openclaw.cmd / .exe / .bat / .js 识别与规范化，避免把 npm 目录下不可直接执行的 openclaw shim 当作 Gateway 启动命令
- 更新日志显示不完整 — 更新弹窗内日志区域限制高度并独立滚动，避免内容截断或按钮被挤出视口
- 关于页更新信息挤压 — 修复推荐安装包文件名过长导致卡片文字竖排、布局破坏的问题
- 默认密码提醒过重 — 顶部提醒从大色块横幅改为轻量安全提示条，PC 和移动端都降低高度和视觉干扰
- 公告标签无法切换 — 修复通知为空时点击“通知”标签无反应的问题
兼容性 (Compatibility)
- /update/latest.json 继续只服务 web-*.zip 热更新包；新版用户升级主路径为完整安装包
- 完整安装包更新只打开浏览器下载，不做静默安装
测试与验证 (Testing)
- 已通过 git diff --check
- 已通过 node --test tests\site-message-center.test.js
- 已通过 cd src-tauri && cargo fmt --check
- 已通过 cd src-tauri && cargo test site_api::tests
- 已通过 cd src-tauri && cargo check
- 已通过 cd src-tauri && cargo clippy --all-targets -- -D warnings
- 已通过 npm run build

✨ 新功能
- hermes): add display tui controls
- hermes): add browser camofox controls
- hermes): add terminal docker advanced controls
- hermes): add display analytics controls
- hermes): add context engine controls
- hermes): add x search controls
- hermes): add model catalog controls
- hermes): add lsp diagnostic controls
- hermes): add web tool backend controls
- hermes): add terminal cloud runtime controls
- hermes): add tts voice controls
- hermes): add terminal env passthrough controls
- hermes): add terminal shell environment controls
- hermes): add update backup controls
- hermes): add session store maintenance controls
- hermes): add curator maintenance controls
- hermes): add skills security controls
- hermes): add browser advanced controls
- hermes): add kanban profile routing controls
- hermes): add kanban worker log controls
🐛 修复
- hermes): make hermes_venv_python aware of uv-tool default install path
- hermes): self-host dashboard_auth + web_dist stubs to survive upstream missing pieces
- dashboard): prevent superseded dashboard loads from mutating state (#301)
- config): sync agent models from merged openclaw.json after write (#297)
- 修复 Node.js 版本检测优先命中系统路径而非 nvm 管理版本的问题 (#295)
- hermes): validate mcp sampling config
- hermes): improve dashboard touch targets
- hermes): stabilize chat health banner
- hermes): validate raw config saves
- channels): improve configured card touch targets
- channels): add generic channel diagnostics
- channels): validate binding accounts by credential fields
- channels): expose Discord guild allowlist fields
- channels): preserve Discord application id
- channels): stabilize default account selection
- channels): save multi-account platform configs
- hermes): align channel secrets with runtime env
- channels): preserve SecretRef credentials
- channels): normalize OpenClaw channel config policies
- web): support openclaw path conflict scan
📦 其他
- fix(hermes): include all runtime extras in upgrade path

🐛 修复
- gateway): release 0.16.5

🐛 修复
- engine-select): release 0.16.4

🐛 修复
- stabilize gateway startup and kernel i18n

🐛 修复
- apply pending correctness fixes

🐛 修复
- gateway): support latest hello server version payload

✨ 新功能
- gateway): surface negotiated handshake protocol version in UI
- models): import external client configs
- engine-select): Monolith 对角线全屏选择屏
- hermes): Batch 3 §N - 群聊（多 Agent 并行响应）
- hermes): Batch 3 §L - 文件管理器（限定在 ~/.hermes 子树内）
- hermes): Batch 2 §G - 多 Gateway 看板（同时运行多 profile Gateway）
- hermes): Batch 3 §Q - OAuth 三种登录 (PKCE / device_code / external)
- hermes): Batch 3 §P TTS + Dashboard session token 自动注入
- hermes): UX 小白化第一步 - services restart/stop 加 showConfirm 防误触
- hermes): Batch 2 §I + Batch 3 §M - 流恢复 + Kanban 看板
- hermes): Batch 2 §H - Profiles 管理 UI + Dashboard API 通用代理
- hermes): Batch 3 §K - 多模态图片上传（chat attach + 拖拽 + 粘贴 + base64）
- hermes): Batch 1 §E - Sessions 导出（走 dashboard /api/sessions//messages）
- hermes): Batch 1 §A + §B + P1-3 lazy_deps 优化 - 占位修 + 中文硬编码清 + 自定义 venv 适配
- hermes): Batch 1 §C+§D+§C-bis - Approval Flow + Stop 真中断 + 3 类新事件
- openclaw): P1-6 config.schema RPC 写入校验 - 防小白改坏配置
- openclaw): P1-0 push.web.* 推送通知 - ClawPanel 关掉也能弹系统通知
- hermes): P1-3 lazy_deps 预处理 - 加 IM 渠道不再「首启 Gateway 卡 30 秒后崩」
- hermes): P1-4 hermes_read_config_full 全字段解析 - 解锁 14+ Gateway 高价值配置
- ux): toast 智能行动按钮 + 拓展 ⓘ 到 gateway/agents + sidebar 加术语表入口
🐛 修复
- assistant): give assistant a Hermes identity, surface raw install hint, unblock CI
- ui): hide useless docker manager on desktop, auto-start hermes dashboard, polish layout
- models): stop auto-filling fallback chain and add clear-all button
- windows): make gateway terminal window actually visible
- models): normalize invalid primary model
- assistant): normalize OpenClaw context path
- ui): polish docker and model configuration views
- dashboard): avoid startup skeleton deadlock
- windows): harden gateway terminal runner
- windows): launch gateway in visible terminal
- ui): sync latest upgrade copy in locale bundles
- openclaw): allow upgrading kernel to latest patch
- ui): import term tooltip helpers in config pages
- openclaw): update recommended kernel target and delta protocol handling
- hermes): restore gateway message sending dependencies
- hermes): stabilize gateway provider routing and startup
- audit): 复查第三波 — Hermes 安装向导 i18n 化漏网中文
- audit): 复查第二波 — alert/confirm 统一 + chat.js 潜伏语法 bug
- audit): 复查发现的 5 个 bug — 双 listener / duplicate stub / timer leak / i18n
- rust): 修 CI 失败的 4 个 clippy + fmt 问题
📦 其他
- perf(ui): speed up dashboard startup rendering
- refactor(hermes): emoji → SVG 图标，统一视觉语言
- refactor(hermes): UX 小白化最后一波 - skills/memory/cron 升级 humanizeError
- refactor(hermes): UX 小白化收尾 - 6 个页面统一 humanizeError + 修 usage.js bug
- refactor(hermes): UX 小白化 - chat.js profile 切换错误用 humanizeError

- 常规更新与优化

✨ 新功能
- 内核版本兼容层 — 新增 kernel.js / feature-catalog.js / api-compat.js，统一管理 OpenClaw/Hermes 内核版本、特性门控、最低版本地板和新旧 RPC 返回结构兼容。
- 内核升级提示 — 侧边栏新增可升级提示卡，低版本内核可直接触发一键升级流程；低于硬地板版本时显示阻断式引导，避免旧内核继续进入不兼容页面。
- CLI 冲突检测与隔离 — 新增 PATH 中外部 OpenClaw CLI 扫描、隔离、恢复能力，支持识别 Cherry Studio / Cursor / npm 全局安装等残留来源。
- Hermes 实时聊天桥接增强 — Web 模式补齐 Hermes Gateway /v1/runs 流式转发、API Key 注入、取消与错误事件处理，使浏览器模式与桌面模式聊天链路保持一致。
🚀 改进
- OpenClaw 2026.5.6 适配 — 推荐版本更新到官方 2026.5.6 与汉化版 2026.5.6-zh.1。
- 多版本内核兼容 UX — Dashboard、服务页、Agents、Models、侧边栏和 WebSocket 连接流程统一接入内核快照，老内核自动降级，新内核显示更丰富状态。
- Gateway 重启体验 — 模型保存后先探测 Gateway 是否运行，运行中才防抖排队重启；未运行时只提示配置已保存，避免无意义 doctor/restart 卡顿。
- Hermes 安装依赖补齐 — uv tool install 统一追加 croniter，并默认安装 hermes-agent[web]。
- MiniMax 预设补全 — MiniMax 服务商预设恢复 OpenAI-compatible 入口，并补齐 M2.7/M2.5 及 highspeed 模型快捷项。
- 热更新兼容底座 — 本次版本包含新增 Tauri 命令，热更新清单最低兼容版本提升到 0.15.0。
🐛 修复
- Hermes Gateway 本机自动拉起 — 自定义 Gateway URL 为 127.0.0.1、localhost、::1 等 loopback 地址时不再误判为远程 Gateway，桌面端和 Web 模式都会自动启动本机 Gateway。
- Hermes /v1/runs 连接失败诊断 — 启动 run 前自动确保本机 Gateway ready，请求失败时附带健康检查和日志尾部。
- Standalone 版本显示未知 — About 页和仪表盘优先读取 standalone 安装目录的 VERSION / package.json，正确识别官方版或汉化版。
- 仪表盘版本缓存自愈 — 检测到空版本、unknown 来源或不完整版本信息时自动清理 get_version_info 缓存并重新拉取。
- 版本检测不再被运行态拖垮 — openclaw status --json 后移为 fallback 并增加短超时，避免 Gateway 未运行时拖慢 About 页和仪表盘。
- 服务配置错误引导 — 启停服务遇到配置 schema 错误时弹出 doctor --fix 一键修复入口。
✅ 验证
- CI 已通过：Linux / Windows / macOS
- Release 已通过：macOS Apple Silicon、macOS Intel、Linux、Windows 轻量包、Windows 完整包
- 热更新包：web-0.15.0.zip
- docs/update/latest.json 已更新为 version=0.15.0、minAppVersion=0.15.0

✨ 新功能
- hermes): align dashboard APIs and add xintian engine
- hermes): auto-heal platforms.api_server.enabled before gateway start (Step 5)
- hermes): add .env editor page for unmanaged env vars (Step 4)
- hermes): dynamically load provider registry in setup & dashboard (Step 2)
- hermes): add 22-provider registry + rewrite core commands (Step 1)
- diagnose): detect and inform about @homebridge/ciao cmd popup bug (#250)
- models): refine fallback UI styling
- optimize model management UI with waterfall fallback editor
🐛 修复
- security): resolve remaining dependabot alerts
- security): update rustls-webpki for dependabot alert
- gateway): conservative zombie cleanup on windows (#249)
- gateway): debounce restart with single-flight queue (#248)
- models): recognize google-generative-ai as google-gemini api type (#241)
📦 其他
- refactor(models): address PR #232 review comments

✨ 新功能
- http): reqwest 客户端启用 brotli / deflate 解码
- assistant): 识别本地 LLM 服务端常见错误并给出修复指引
- assistant): 备用模型组 failover + 测试按钮走 Rust 后端（修 status 0）
🐛 修复
- cargo fmt formatting for list_remote_models
- deploy): 修复 Linux 全新系统部署 npm 缓存权限问题 (#236)
- models): 获取模型列表 404 改为友好提示 + 助手侧走后端绕 CORS
- assistant): 模型测试按钮改用流式累积 + 增强诊断信息
- assistant): 修复测试 Response Body 为 (empty) + 优化结果展示
- assistant): 补齐备用模型重设计缺失的变量声明
- lifecycle): 卸载/升级 OpenClaw 后同步刷新 Rust 缓存与前端缓存
- setup): 修复 Node.js/Git/OpenClaw 装完不识别（需重启客户端）
- assistant): 连续错误自动熔断，避免无限重试循环 (#226)
- assistant): 拦截本地文件路径粘贴/拖拽，清洗消息中的本地路径引用 (#226)
- sidebar): 增强引擎切换器视觉发现性 (#228, #235)
📦 其他
- refactor(assistant): 备用模型 UI 重设计 - 厂商预设快捷添加 + 极简列表
- refactor(chat): 聊天界面字体大小统一使用 CSS 变量 (#194)

- 常规更新与优化

- 常规更新与优化

✨ 新功能
- setup): add local/custom install mode for Hermes Agent
- setup): simplify Hermes install — remove extras, add inline logs
- about): Hermes config/upgrade/uninstall use modal dialogs with logs
- about): add Hermes Agent upgrade/uninstall/config buttons
🐛 修复
- show loading skeleton during engine switch and initial boot
- sidebar menu not updating after engine switch + dashboard loading skeleton
- hermes): add --force to uv tool install, improve install error handling
- setup): make Hermes wizard phases clickable, stop auto-redirect
- fake update detection, Hermes web mode commands, cleanup hot update
- 修正所有 README 中 Hermes Agent GitHub 链接

✨ 新功能
- Hermes Agent 多引擎架构核心代码
- v0.13.0 — 新增 Hermes Agent 双引擎支持，更新全部文档与官网
🐛 修复
- Hermes setup 完成后自动更新引擎状态并跳转仪表盘
- Hermes 模式下隐藏 OpenClaw Gateway 横幅
- 初始设置页全部检测通过时自动跳转仪表盘

✨ 新功能
- OpenClaw 4.9 全面适配 (v0.12.0)
- new pages + dashboard enhancements + backend improvements
- add Dreaming UI and gateway auto-fix startup flow
🐛 修复
- npm install 后误卸载新装包（current_source=unknown 时 old_pkg 与 new pkg 相同）
- allow unused_variables for reload_gateway_internal (app unused on macOS)
- CI lint errors - openclaw_command import scope, clippy warnings
- improve install/uninstall stability + dreaming animations + scan fix flow
fix hosted session binding and harden panel config resolution

✨ 新功能
- chat): OpenClaw 4.5 compatibility — fix silent no-reply + add working state indicators

🐛 修复
- clippy manual_flatten in skills.rs

✨ 新功能
- IME-aware chat input, message copy button, Git path scanning
🐛 修复
- Gateway status discrepancy — foreign detection, claim action, banner sync
- settings): support custom git path and robust skills bundled scanning
- deps): patch picomatch 4.0.4 and rustls-webpki 0.103.10 (dependabot #6, #4)
- models): stop auto-populating fallbacks on every save (fixes #190)
- ci): format config command

- 常规更新与优化