v2.9.38 - 高清文档、导览定位与界面细节升级

更新方式

• 已安装 v2.9.36 或 v2.9.37 的用户可以通过应用内 Tauri Updater 直接更新到本版本。
• v2.9.35 及更早版本尚未内置更新器，需要从本发布页手动下载安装 v2.9.38。
• 更新清单继续由 https://updates.cnzone.net/latest.json 提供，版本化载荷托管于 Cloudflare R2，并在安装前执行项目专用 Tauri 签名校验。

高清文档与截图体系

• 重新拍摄 11 张核心功能页面截图，统一提升到 3200 × 2000，覆盖总览、模型、下载、引擎、实例、参数、集群、路由、性能、大屏和日志。
• 重新制作 3 张操作流程海报，统一提升到 3840 × 2400，覆盖首次运行、启动诊断和 API 路由流程。
• README、完整 GUIDE、应用内使用说明和独立文档站现在共用同一套高质量素材，文档主站及下载站链接也已补齐。
• 新增可重复执行的文档截图场景与生成脚本，提供稳定演示数据，并自动校验分辨率、文件大小、当前导航唯一性、悬停状态和未处理 Tauri 调用。

导览与界面细节

• 交互式使用导览会等待目标元素、字体和布局连续稳定后再定位，并在动画帧完成后刷新高亮层，减少指引框错位。
• 导航项补充 aria-current 语义，截图回归会确保只有当前页面处于选中状态，不再把鼠标悬停误拍成第二个选中项。
• 引擎管理的默认引擎标记改为紧凑图标，并完善名称、编辑按钮与默认操作的收缩规则，避免窄布局文字挤压。
• 新增浏览器回归测试，持续验证导览定位稳定性和导航唯一选中状态。

llama.cpp 兼容性

• 发布前将权威稳定版基线从 b10215 同步到 b10218（de699957b92f490efebad149665b0dccf127eaff）。
• 稳定版与 master canary 均保持 248 个参数；参数快照、别名、用法、说明和默认值没有变化。
• Anthropic Messages、SSE、工具调用、图片输入和 Token Count 的兼容边界保持不变；工具调用仍要求目标实例启用 --jinja。

平台与签名说明

• Windows x64：提供 NSIS 与 MSI；未配置操作系统发行者证书时，文件名继续明确标注 unsigned。
• macOS Apple Silicon：提供 DMG 与应用内更新载荷；未配置 Apple 发行证书时，DMG 继续标注 adhoc。
• Linux x64 / ARM64：提供 AppImage 与 DEB；AppImage 支持应用内更新，DEB 继续手动安装。
• unsigned / adhoc 仅表示缺少操作系统发行者证书；所有应用内更新载荷仍由 Tauri Updater 项目密钥独立签名和校验。

发布验证

• 完整本地发布门禁、生产构建、锁定依赖 Rust 测试、严格 Clippy、格式检查与依赖审计通过。
• 30/30 Playwright 浏览器场景和全部回归测试通过。
• 269/269 Rust 测试通过，包括官方 Anthropic SDK 端到端代理测试。
• 发版 PR 的 quality、Windows、macOS、Linux x64、Linux ARM64 构建全部通过。
• 正式 llama.cpp Upstream Watch、GitHub Release 资产与 Cloudflare R2 更新清单均已通过独立校验。

完整变更：v2.9.37...v2.9.38

v2.9.37 - Anthropic API 路由与性能可靠性升级

更新方式

• 已安装 v2.9.36 的用户可以通过应用内 Tauri Updater 直接更新到本版本。
• v2.9.35 及更早版本尚未内置更新器，需要从本发布页手动下载安装 v2.9.37。
• 更新清单继续由 https://updates.cnzone.net/latest.json 提供，版本化载荷托管于 Cloudflare R2，并在安装前执行项目专用 Tauri 签名校验。

Anthropic API 与 Claude Code 兼容

• 现有模型路由监听器现在同时支持 OpenAI 与 Anthropic API 格式，无需部署两套代理。
• 新增 Anthropic POST /v1/messages 与 POST /v1/messages/count_tokens，覆盖同步消息、流式 SSE、图片输入、thinking、工具调用、工具结果和 token 统计。
• 模型发现接口兼容 OpenAI 客户端、Anthropic SDK 与 Claude Code，并支持按模型 ID 查询。
• 支持 Bearer 与 x-api-key 两种客户端鉴权；公开代理凭据不会转发到内部 llama-server，目标实例继续使用自身凭据。
• 路由别名会在同步 JSON 与 Anthropic message_start 流事件中保持一致，同时不会错误改写工具参数中同名的 model 字段。
• Anthropic 请求失败会返回标准错误结构和 request-id，旧版或自定义 llama-server 缺少 Messages 端点时也会给出明确错误。
• 路由遥测新增 api_format 字段，可以区分 OpenAI 与 Anthropic 请求。
• Claude Code 配置、--jinja 工具调用要求、32 MiB 请求上限和云端专属能力边界已写入路由页面与兼容说明。

性能、资源占用与可靠性

• 路由请求不再为每次调用复制完整运行时映射或重复排序规则，并通过明确的 64 MiB 全局请求上限避免意外的小请求体限制。
• 遥测写入改为批量事务，向量事件去重增加索引；实例监控锁相互隔离，降低并发请求下的数据库与锁竞争。
• GGUF 元数据解析移出异步执行器，减少大模型目录扫描对运行任务的阻塞。
• 全局最近日志改为有界增量维护，路由轮询避免重叠，大屏计算结果复用，重量级页面按需加载。
• 自动启动改为单次、错峰执行，避免重复拉起实例；Updater 增加手动重试、周期检查和并发保护，安装失败后仍可恢复操作。
• 修复暂停下载恢复、集群节点刷新及部分退出/后台运行流程中的时序问题，并新增对应浏览器回归场景。

llama.cpp 兼容性

• 发布前将权威稳定版基线从 b10199 同步到 b10215（eb41d503ba9496b816ff4180a34780bc13a4f4b8）。
• 稳定版与 master canary 均保持 248 个参数；参数快照、别名、用法、说明和默认值没有变化。
• Anthropic Messages 依赖受支持 llama.cpp 的原生实现；工具调用仍要求目标实例启用 --jinja。本项目不模拟 prompt caching、服务端工具等 Anthropic 云端专属能力。

平台与签名说明

• Windows x64：提供 NSIS 与 MSI；未配置操作系统发行者证书时，文件名继续明确标注 unsigned。
• macOS Apple Silicon：提供 DMG 与应用内更新载荷；未配置 Apple 发行证书时，DMG 继续标注 adhoc。
• Linux x64 / ARM64：提供 AppImage 与 DEB；AppImage 支持应用内更新，DEB 继续手动安装。
• unsigned / adhoc 仅表示缺少操作系统发行者证书；所有应用内更新载荷仍由 Tauri Updater 项目密钥独立签名和校验。

发布验证

• 完整本地发布门禁、生产构建、锁定依赖 Rust 测试、严格 Clippy 与依赖审计通过。
• 29/29 Playwright 浏览器场景和全部回归测试通过。
• 269/269 Rust 测试通过，包括官方 Anthropic SDK 端到端代理测试。
• GitHub Actions 的 quality、Windows、macOS、Linux x64、Linux ARM64 构建全部通过。
• 正式 llama.cpp Upstream Watch 通过，Cloudflare R2 latest.json 与 GitHub Release 资产完成独立校验。

完整变更：v2.9.36...v2.9.37

v2.9.36 - Tauri Updater 与中国大陆更新链路

重要提示

这是首个启用 Tauri Updater 的版本。v2.9.35 及更早版本尚未内置更新器，因此必须先从本页手动下载安装 v2.9.36 一次；从后续版本开始，才能直接在应用内完成更新。

Tauri Updater 与中国大陆更新链路

• 新增应用内更新检测、版本提示、下载进度、安装确认与一键重启。
• 应用启动后从 https://updates.cnzone.net/latest.json 检查更新，更新清单和版本化安装包托管于 Cloudflare R2，减少直接访问 GitHub 时的连接不稳定。
• 安装前会明确确认；检测到实例或路由仍在运行时，会提示更新重启可能中断当前任务。
• 所有 Updater 安装载荷均使用项目专用 Tauri 密钥签名，客户端通过内置公钥校验，签名不匹配的载荷不会被安装。
• 发布流水线先上传版本化文件，校验公网清单后最后更新 latest.json，并将同一批发布资产保留在 GitHub Releases 作为下载与恢复来源。

平台支持

• Windows x64：支持 NSIS 与 MSI 安装目标，应用内安装采用被动模式。
• macOS Apple Silicon：支持应用内更新。
• Linux x64 / ARM64：AppImage 支持应用内更新；DEB 继续通过 GitHub Releases 手动安装。
• Windows 安装包目前仍会明确标注 unsigned，macOS 安装包标注 adhoc。这表示尚未配置操作系统发行者证书；Updater 载荷仍会独立执行 Tauri 签名校验。
• macOS PR 构建会使用一次性临时密钥真实生成并检查 .app.tar.gz，在打标签前验证完整的 Updater 载荷路径；临时密钥不会用于正式发布。

监控与桌面体验

• 统一仪表盘、性能页和大屏的实时指标口径：CPU、GPU、内存和显存保持为全局资源快照，不再随所选实例混用。
• 统一实时任务吞吐量展示，避免不同页面对同一运行状态显示不一致。
• 修复 Windows、macOS 与 Linux 的托盘图标尺寸与模板处理，提升系统托盘中的清晰度和一致性。

llama.cpp 兼容性

• 发布前将权威稳定版基线同步到 b10199。
• 稳定版与 master canary 均保持 248 个参数；参数快照、别名、用法、说明和默认值没有变化。

发布验证

• 完整本地发布门禁、生产构建、锁定依赖 Rust 编译均通过。
• 22/22 Playwright 浏览器场景和全部回归测试通过。
• GitHub Actions 的 quality、Windows、macOS、Linux x64、Linux ARM64 构建全部通过。
• 正式 llama.cpp Upstream Watch 通过。

完整变更：v2.9.35...v2.9.36

v2.9.35 - 参数配置快捷操作与上游兼容性完善

重点更新

• 参数配置页新增浮动操作区。展开大量参数并滚动到页面下方后，可直接保存当前配置，无需长距离返回页首。
• 浮动操作区提供一键返回顶部，并沿用原有保存状态、校验结果和防重复提交逻辑。
• 增加浏览器回归测试，覆盖长页面滚动、浮动保存和返回顶部操作。

llama.cpp 参数兼容性

• 同步近期 llama.cpp 稳定版参数契约，新增 draft-dspark 推测解码类型。
• 模型加载模式新增 mmap+mlock，并更新 mlock 与组合模式的中英文说明。
• draft-dspark 现在会按外部草稿模型模式进行配置检查，缺少草稿模型时给出明确提示。
• 改进 Upstream Watch：只有参数、别名、用法或默认说明发生真实变化时才阻塞；仅稳定版标签前进且参数契约完全一致时记录为信息，避免无意义的发版追赶。

可靠性与验证

• 加固共享保存流程的回归断言，确保浮动入口与页首入口共用同一套保存保护。
• 完整通过 UTF-8、用户指南、主题、ESLint、i18n、组件预算、IPC、安全策略和跨平台发布检查。
• 完整通过浏览器测试、前端/后端回归测试、TypeScript 检查与生产构建。
• 发布流水线继续覆盖 Windows、macOS、Linux x64 和 Linux ARM64。

安装说明

• Windows 在未配置正式签名凭据时提供明确标注的 unsigned 安装包。
• macOS 在未配置 Apple 签名与公证凭据时提供明确标注的 adhoc 安装包。

v2.9.34 - 安全加固、运行可靠性与下载管理修复

重点更新

• 修复下载任务暂停后点击“取消”无效的问题。取消操作现在只使用后端登记的任务身份和受管路径，能够正确清理分片文件、元数据与持久化队列记录，不再出现 Frontend file path does not match registered download task 警告。
• 重新设计应用图标，并统一 Windows、macOS、Linux、Android、iOS 资源及侧边栏品牌图标。
• 更新存在安全公告的前端依赖。

安全与可靠性

• 加固模型、引擎、下载目录及配置文件的路径授权、目录穿越与符号链接边界检查。
• 完善配置、下载状态和后台运行状态的原子写入、回滚与损坏恢复，降低异常退出或写入失败导致状态丢失的风险。
• 加固代理公开入口、API 密钥处理、连接头过滤，以及集群 SSH 命令与远程路径的转义和验证。
• 修复独立后台运行时的健康检查端点、Unix 套接字路径长度与生命周期恢复问题。
• 完善集群发现、远程启动、实例启动并发、模型/引擎扫描及下载恢复流程中的错误处理。

参数与兼容性

• 更新 llama.cpp 稳定版参数基线至 b10107；与此前 b10105 相比，248 个参数、别名、说明及默认值均无变化。
• 完善加载模式、显式参数覆盖、向量模型策略及旧版/分支引擎的能力协商。
• 非回环地址上的服务现在要求 API 密钥，以避免未认证的明文公网暴露。

验证

• 已通过暂停下载取消场景的实际安装测试。
• 已通过 18 项浏览器回归、完整前端发布检查、Rust 测试与 Lint。
• 已通过 Windows、macOS、Linux x64、Linux ARM64 跨平台构建及独立后台运行生命周期测试。
• 已通过 llama.cpp b10107 上游兼容性门禁。

完整变更：v2.9.33...v2.9.34

v2.9.33 - 运行错误告警清理与后台状态修复

本次更新

运行错误告警清理

• 修复模型 OOM 或后台实例异常退出后，页面“运行警告”横幅点击“清除”仍被状态轮询反复恢复的问题。
• 清除操作现在会同步确认后台运行服务中的持久错误状态，避免仅清除前端显示而留下旧错误。
• 对相同状态快照进行去重，已清除的历史错误不会每 3 秒重新加入警告列表。

后台实例恢复行为

• 实例重新启动时，仅清理由该实例上一次异常退出产生的陈旧错误，不会误清除其他实例或无关运行错误。
• 成功重启后旧告警保持消失；若实例之后再次真实异常退出，即使错误文本相同，也会重新显示新的告警。
• 后台运行协议新增错误确认能力，并自动升级不支持该能力的旧后台服务。

llama.cpp 兼容性基线

• 将官方稳定版参数基线从 b10068 更新至 b10085。
• 参数数量仍为 247；参数、别名、说明和默认值均无变化。
• Upstream Watch 已重新验证通过，之前的兼容性监控红叉已消除。

验证

• 本地完整发布门禁通过：18/18 浏览器回归测试。
• Rust 测试通过：243 项通过，1 项按设计忽略；严格 Clippy 与格式检查通过。
• 真实后台运行服务 IPC 生命周期测试通过，覆盖异常退出、成功重启、再次异常和清除确认。
• npm 漏洞审计未发现漏洞。
• GitHub Actions 预发布验证已在 Windows、macOS、Linux x64 与 Linux ARM64 上完成测试、Clippy、打包和产物上传。

升级说明

• 无需迁移现有实例或配置，安装新版本即可。
• 若仓库未配置平台签名凭据，Windows 安装包会标注为 unsigned，macOS 安装包会标注为 ad-hoc。

完整变更：v2.9.32...v2.9.33

v2.9.32 - 实例路由健康状态与配置可靠性完善

本次更新

实例路由健康状态与可观测性

• 将“已启用规则”和“当前健康路由”拆分统计，避免规则已保存但目标实例不可用时仍被误认为可路由。
• 每条路由显示当前命中、备用可用、目标已停止、状态未知、目标缺失、已禁用或尚未保存等实时状态。
• 新增“测试路由”，直接复用真实优先级与故障转移解析逻辑，无需发送推理请求即可确认最终命中目标。
• 目标状态定时刷新；实时状态不可用时安全降级为未知并将健康路由归零，恢复后自动更新。

对外模型名与路由边界

• 显式配置的“对外模型名”现在是统一 API 的唯一公开模型标识。
• 目标实例的 --alias / -a 仅用于代理与上游 llama-server 通信，不再通过模型发现、请求或 JSON/SSE 响应向外透传。
• 不完整、过期或目标不可用的显式路由会被拒绝，不会意外回退到无关模型。

配置与运行时可靠性

• 保存、启动、重启及独立后台恢复统一执行路由配置规范化和校验。
• 自动清理首尾空白、修复空或重复的路由 ID，并阻止永久无效配置进入无限重试。
• 完善停止、重启和后台恢复期间的路由状态生命周期，降低陈旧状态造成的误判。

发版前审计修复

• 加固 SSH 目标参数边界，避免形似命令行选项的输入被 OpenSSH 继续解析。
• 将端口探测与下载断点状态 I/O 调整为非阻塞路径，改善运行时响应性。
• 下载暂停、恢复、取消失败现在会回滚或保留正确界面状态，并记录可见运行时警告。
• 收紧前端类型边界，升级并精简 Rust 依赖，同时补充审计回归测试。

验证

• 本地完整发布门禁通过：17/17 浏览器回归测试。
• Rust 测试通过：241 项通过，1 项忽略。
• TypeScript 检查、前端构建、编码检查、版本一致性检查、Rust 格式检查及严格 Clippy 均通过。
• GitHub Actions 已在 Windows、macOS、Linux x64 与 Linux ARM64 上完成 PR 与正式标签两轮测试、打包和 Release 上传验证。

升级说明

• 现有实例与路由配置会在加载时自动规范化，无需手工迁移。
• 若仓库未配置平台签名凭据，Windows 安装包会标注为 unsigned，macOS 安装包会标注为 ad-hoc。

完整变更：v2.9.31...v2.9.32

v2.9.31 - 独立后台运行、路由标识与参数配置完善

本次更新

独立后台运行与退出交互

• 新增跨平台、用户级的独立后台运行服务。启用后，关闭管理界面不会再连带停止已托管实例和统一 API 路由；Windows、macOS、Linux 均使用各自安全的本地通信与进程交接机制。
• 重做退出流程：存在后台工作负载时，默认操作会先完成并验证管理权交接，再退出界面；交接失败会保留界面并显示可恢复错误，避免“界面退出了、服务也意外停了”。
• 将“停止实例与路由”的破坏性操作收回到路由设置并增加确认，退出弹窗不再混合后台保留与全部停止两种相反语义。
• 完善后台运行状态恢复、进程身份校验、心跳/看门狗和开机启动路径，并加入 Windows、macOS、Linux x64、Linux ARM64 的独立运行生命周期验证。

统一 API 路由与模型标识

• 修复 /v1/models 混入内部实例 UUID 的问题；现在只公开正在运行且可路由的模型标识。
• 修复实例未设置别名时，/v1/chat/completions 等响应中的 model 字段暴露后端 GGUF 完整文件路径的问题。
• 托管模式下若别名为空，程序会生成稳定、可读且不含路径的公共模型标识；请求与普通 JSON/SSE 响应会统一转换为同一个对外标识。
• 加固路由鉴权、连接头与敏感凭据过滤，并避免运行中的公共路由被静默取消鉴权或换绑地址。

模型仓库首次启动恢复

• 修复清除旧配置、仅保留默认 models 目录后，统计卡片能识别模型但扫描根目录与模型树为空的问题。
• 全新配置会自动注册默认模型目录；旧配置中的空根目录也会在扫描前安全修复，已有模型无需重新下载或手工添加路径。
• 新增浏览器与 Rust 回归，覆盖首次安装、旧配置迁移和手动扫描场景。

参数配置与可解释性

• 参数页面现在明确区分“继承引擎默认”“用户明确指定”“程序托管必需”“当前不生效”和“引擎不支持”，引擎探测到的默认值仅用于解释，不会擅自写回配置或扩大启动命令。
• 用户明确保存的参数即使恰好等于当前引擎默认值也会继续发射；选择“恢复引擎默认”后才会移除显式覆盖，消除“设置了但命令里没看到”的不确定感。
• 自动数值参数、依赖参数和推测解码子参数会按实际激活关系生成命令；未指定项继续交由 llama.cpp 处理，启动命令保持简洁。
• 将 --no-mmap、--no-repack、--no-kv-offload、--no-mmproj-offload 等反向开关改为正向业务语义展示，并补充开/关效果、收益、代价和发射结果说明。
• 全面校正参数名称、别名、搜索定位和悬浮帮助，新增参数目录与说明准确性回归检查。

稳定性修复

• 修复 Issue #5：从 v2.9.29 开始，创建实例或编辑实例时可能触发 React Minified Error #310。根因是参数配置页在不同渲染分支间改变了 Hooks 调用顺序，现已固定调用顺序并加入真实浏览器回归。
• 修复后台运行退出交接失败时缺少可恢复反馈，以及托盘退出路径与主窗口退出行为不一致的问题。
• 修复跨平台后台运行自动启动测试在 macOS/Linux 上的路径与时序差异。

验证结果

• npm run check:release、TypeScript、ESLint、前端生产构建和 Mock 隔离检查全部通过。
• Chromium 浏览器自动化 14 项全部通过，覆盖 Issue #5、退出交接、参数意图、公共模型标识和默认模型树恢复。
• Rust 测试 233 项通过、1 项外部模型语料测试按设计忽略；Clippy 在 -D warnings 下通过。
• npm 官方漏洞库检查为 0 个漏洞；RustSec 检查无新增未批准公告。
• 正式标签构建会再次执行质量门禁和 Windows、macOS、Linux x64、Linux ARM64 全平台打包。

升级与运行说明

• 本次升级保留现有模型、实例和参数配置；建议需要后台常驻的用户在路由设置中启用独立后台运行。
• 第一阶段采用当前用户级后台服务，不安装系统级服务，不要求管理员/root 权限；注销当前系统用户或系统关机时服务会结束。
• Windows 安装包若文件名带 unsigned，表示未配置商业代码签名，系统可能显示未知发布者提示。
• macOS Apple Silicon 在未配置 Apple Developer 证书时提供明确标注的 ad-hoc 签名 DMG。
• Linux 提供 x64 与 ARM64 的 AppImage 和 DEB。

完整变更：v2.9.30...v2.9.31

v2.9.30 - 参数配置、引擎兼容与下载恢复完善

本次更新

参数配置与引擎兼容性

• 参数配置恢复简洁托管逻辑：仅发射程序必需参数和用户明确调整的参数，未修改项继续交由 llama.cpp 使用自身默认值，启动命令更短、更便于人工调优和排查。
• 新增旧引擎手动命令模式，可直接维护完整启动参数，同时继续使用程序的进程管理、日志采集、健康检查和性能监测能力。
• 建立 llama.cpp 引擎能力探测、版本识别、启动前兼容性验证和未知引擎保守降级机制；参数基线已与官方稳定版 b10068 对齐。
• 参数页面现在分别展示“本次改动”和“启动参数”，支持定位、撤销、恢复引擎默认值和真实发射结果核对；修复参数搜索按 Enter 无法跳转的问题。
• 优化参数分组、开关、输入框和状态标记的对齐方式，明确每个“将发射”标记所属参数，减少复杂配置页面中的视觉歧义。
• 修复缺失引擎时生成命令无响应、保存预检竞态和默认值被意外显式发射等问题；用户自定义参数仍按配置原样进入启动命令。

模型与多模态配置

• 多模态投影器重新支持从模型仓库手动选择；切换主模型时会尝试安全匹配同来源 projector，也可由用户覆盖自动选择结果。
• 改进 GGUF 元数据、模型家族、仓库来源和 projector 类型的匹配逻辑，区分确认匹配、目录弱匹配、来源未知和来源冲突，减少视觉模型的误报提醒。
• 加固 GGUF 元数据解析，对标签数量、单项大小、累计内存和文件越界实施限制，避免损坏或恶意模型文件造成异常资源消耗。
• 完善向量模型、Embedding、Reranker、推测解码及多模态参数的互斥和启动规范化，避免不适用参数进入最终命令。

下载管理与状态恢复

• 修复取消下载后任务仅从前端消失、重启程序又重新出现的问题，取消操作现在会同步清理运行队列、持久化队列和下载产物状态。
• 统一正常退出、异常退出和旧版状态文件的恢复逻辑：手动策略恢复为“已暂停”，自动恢复策略会刷新运行标识并重新排队，重试耗尽任务不会被误启动。
• 加固暂停、继续、批量取消、断点续传、任务版本和延迟事件隔离，避免旧运行事件覆盖新任务或产生重复下载。
• 完善下载路径、远程目录、绝对保存目录和清理边界校验，保留断点文件的同时防止任务状态与实际文件错位。

性能监测、实例与跨平台稳定性

• 统一性能监测和大屏模式的实时吞吐、空闲归零、任务完成、向量并发速率及历史会话统计口径，减少轮询延迟造成的旧数据残留。
• 修复实例生成命令、配置保存、运行状态交接和引擎删除后的降级处理，避免按钮无响应或配置被异步结果覆盖。
• 加固代理鉴权与敏感请求头过滤、集群发现身份、远程命令、开机启动和跨平台路径处理。
• 补齐 Windows、macOS、Linux x64 与 Linux ARM64 的条件编译检查，修复仅在非 Windows 平台暴露的 Clippy 问题。

自动化与质量保障

• 新增隔离于正式构建的模拟 Tauri 浏览器后端，并将 Playwright Chromium 回归纳入发布门禁。
• 浏览器自动化覆盖参数搜索定位、改动与发射状态、配置保存、--models-autoload 关闭态、多模态来源匹配/冲突及后端命令生成失败。
• 增加 llama.cpp 上游参数漂移监测，稳定版变化会阻断兼容性门禁，master 分支变化作为 canary 提醒。
• 扩充下载恢复、配置保存、引擎能力、多模态元数据、向量策略、实时吞吐、推测解码和跨平台回归测试。

验证结果

• npm run check:release、TypeScript 类型检查、ESLint 和前端生产构建全部通过。
• Chromium 浏览器自动化 4 项全部通过，正式构建通过 Mock 隔离检查。
• Rust 常规测试 199 项通过；真实模型目录 GGUF 全语料解析测试单独执行通过。
• Clippy 在 -D warnings 下通过，npm 官方漏洞库检查为 0 个漏洞，RustSec 无未批准安全公告。
• GitHub Actions 的质量检查、Windows、macOS、Linux x64 和 Linux ARM64 构建与资产上传全部通过。

安装包说明

• Windows：提供明确标注的 unsigned EXE 与 MSI；系统可能显示未知发布者提示。
• macOS Apple Silicon：提供 ad-hoc 签名 DMG；未配置 Apple Developer 年费证书时不阻断发布。
• Linux：提供 x64 与 ARM64 的 AppImage 和 DEB。

完整变更：v2.9.29...v2.9.30

v2.9.29 - 稳定性、安全性与监控完善

本次更新

稳定性与数据安全

• 强化下载队列的断点续传、并发交接、退出快照和崩溃恢复，避免重复任务、终态文件被误重试及损坏状态覆盖。
• 下载清理统一校验受管目录、绝对保存目录、路径穿越和符号链接，兼顾取消清理能力与文件安全。
• 配置持久化支持损坏主配置的备份恢复，并避免无变化时重复写盘；代理和实例生命周期操作改为串行协调，减少竞态。
• 服务退出时完整排空标准输出和错误输出，保留末尾日志、性能数据及遥测记录，并增强异常日志和进程状态的边界处理。

性能监控与向量服务

• 恢复推测解码分析，在性能监控和大屏模式中展示接受率、草稿 token 统计及相关耗时指标。
• 统一性能监控与大屏模式的实时吞吐、请求压力、会话状态和历史趋势口径，空闲时吞吐可正确归零。
• 改进 CPU、GPU、内存和显存信息展示，增强 Windows、Linux 与 macOS 下 AMD/NVIDIA 设备名称及监控降级处理。
• 完善 Embedding 与 Reranker 的实时速率、并发聚合、历史基线和诊断统计，避免与生成模型指标混用。

架构与质量保障

• 建立统一的结构化 IPC 错误、原子持久化和配置保存协调机制，降低跨前后端错误丢失与异步覆盖风险。
• 拆分应用命令中心、实例模型选择、配置工作区和下载策略等大型组件，补齐组件复杂度、国际化和 IPC 边界检查。
• 加固代理鉴权、敏感请求头过滤、集群发现与远程命令、跨平台路径和开机启动处理。
• 扩充下载、配置、实例生命周期、向量策略、实时吞吐、推测解码和审计修复回归测试。

验证结果

• npm run check:release、TypeScript 类型检查和生产构建通过。
• npm 官方漏洞库检查结果为 0 个漏洞。
• Rust 138 项测试全部通过，Clippy 在 -D warnings 下通过。
• GitHub Actions 的质量检查、Windows、macOS、Linux x64 和 Linux ARM64 构建全部通过。

安装包说明

• Windows：提供明确标注的 unsigned EXE 与 MSI；系统可能显示未知发布者提示。
• macOS Apple Silicon：提供 ad-hoc 签名 DMG；未配置 Apple Developer 年费证书时不阻断发布。
• Linux：提供 x64 与 ARM64 的 AppImage 和 DEB。

完整变更：v2.9.28...v2.9.29