OpenSquilla 0.5.0

概述

OpenSquilla 0.5.0 是 0.5 产品线的首个稳定版本。它汇集了 Previews 1 到 4 中交付的全部内容，以及此后落地的修复，覆盖自 0.4.1 以来的完整范围：Model Ensemble 与多 provider routing、带有强力 profile 数据保护的更安全升级、经过签名 的 macOS 桌面更新、用量与成本报告，以及一个中国大陆下载镜像。

已有的 gateway 配置、聊天、Agents 与记忆都会保持原位。从 0.4.1 或任一 0.5.0 预览版升级的用户，应退出正在运行的桌面应用或 gateway，安装 0.5.0 软件包，然后 重启 OpenSquilla。常规版本升级不需要进行数据转移。

✨ 新增内容

Model Ensemble 与多 provider routing

Model Ensemble 会在多个模型上运行同一个 turn 并对答案进行调和。0.5.0 提供了预设 与自定义阵容，并给出清晰的静态与动态指引、动态 ensemble routing、quorum 延迟与 超时调优，以及在 ensemble 执行前对图像输入的校验。Provider 管理围绕它进行了重建： 多 provider routing，其经过验证的 provider 状态可在重启后持续保留；更清爽的模型 设置与凭据控制；以及跟随当前 provider 的 session 自动命名。面向经过验证的 coding provider 的 router 预设让初始设置更为实用，而 SquillaRouter 也为从本地结果中改进 其路由决策打下了基础——分类完全在设备本地进行，prompt 绝不会为了做出路由决策而 离开本机。

更安全的升级、迁移与 profile 数据保护

0.5 产品线重构了 OpenSquilla 保护激活的 workspace、身份、记忆、配置与聊天记录的 方式。桌面会在创建空 workspace 或打开聊天数据库之前先验证生效的 profile：已有的 USER.md、SOUL.md、IDENTITY.md、MEMORY.md 以及 state/ 下的聊天数据库不会 被静默覆盖、删除或合并。完整的 profile 转移使用稳定的源快照与全有或全无的目标 替换，两个 profile 绝不会被静默合并或保持自动同步。

从旧版 home 进行的一键迁移获得了带防护的预览与显式的 apply 控制；可选的 profile 迁移现在仅位于 Settings → Advanced → Data maintenance 中，启动、onboarding 与 Doctor 均保持静默。Profile 转移会将机器本地的运行 worktree 排除在复制之外，并在 处理 workspace 链接时不跟随它们。Preview 4 及之后的 Windows 安装器会在常规卸载 过程中保留 profile 数据，一个可选的转移流程可以导入旧的 Windows 便携版安装。

桌面应用：签名的 macOS 构建与应用内更新

macOS 桌面构建经过 Developer-ID 签名与公证，并可原地更新：预览版安装会自动收到 下一个发布，包括本次稳定版。桌面 gateway 启动恢复、fail-closed 重启处理、凭据 清理，以及更清晰的打包启动诊断，共同完善了桌面加固。Windows 桌面安装器仍未签名， 通过手动下载更新；请参阅下方链接的代码签名策略。

控制台与 Web UI

Vue 控制台现在是唯一的控制台。导航经过重新组织，支持与诊断操作统一到一个入口 下，tool 详情展开可配置，fork 出的聊天 session 会完整交接，控制台支持英语、简体 中文、日语、法语、德语和西班牙语。上传、流式恢复与运行时契约在各预览版中得到 加固。AI 生成的聊天内容会被相应地标注。

用量与成本报告

每日用量报告会汇总运行了什么以及花费了多少。成本由一个持久化账本支撑，采用精确 的基于用量的计费运算，因此这些数字在重启和长时间 session 中都保持正确。

终端预览（OpenTUI）

源码检出可以选择启用全屏终端聊天，它具有共享的 gateway session，turn、tool 与 reasoning 的展示，以及 Router 与 Ensemble 控制。这仍然是一个源码安装的预览：发布 安装保留 Python 原生聊天，且不涉及任何额外的发布资源。

channel 与运行时可靠性

channel 平台工作流得到统一，并具有加固的心跳投递；WeCom websocket 连接更加稳定； 格式错误的 WebSocket 帧会被拒绝，而不是断开连接。运行时一侧汇集了大量长尾修复， 涵盖传输、进程处理、SQLite、checkpoint、原子文件写入、重试上限，以及面向托管执行 的 sandbox 对齐——包括本次发布前不久的一次涉及 36 个缺陷的可靠性排查。

容器镜像与中国大陆下载

每个发布都会向 GHCR 发布多架构 gateway 镜像（linux/amd64、linux/arm64）， 并带有一个跟随最近经过验证的发布的移动 latest tag。发布资源会镜像到阿里云 OSS，并带有稳定的下载别名，为中国大陆用户提供快速的安装器下载与更新 channel 元数据。

自 Preview 4 以来

对于已经在使用 0.5.0 Preview 4 的用户，自该预览版以来的重要变化如下：

• 多 provider routing 与 provider 管理，其 provider 验证可在重启后持续保留。
• 每日用量报告，以及基于持久化账本的精确的基于用量的计费。
• 控制台导航重新组织，统一的支持与诊断操作，以及可配置的 tool 详情展开。
• 可选的 profile 迁移移至 Settings → Advanced → Data maintenance；启动与 onboarding 保持静默。
• 桌面 gateway 重启在超时时 fail closed，而不是挂起。
• Ensemble quorum 延迟调优，以及在 ensemble 执行前拒绝图像输入。
• 一次涉及 36 个缺陷的可靠性与兼容性排查，覆盖运行时、channels 与客户端。
• 源码安装现在会从锁定的前端依赖构建 Vue 控制台，并需要 Node.js 22.12+ 与 npm；发布 wheel、桌面安装器与容器镜像仍然包含预构建的控制台，无需 Node.js。

下载

推荐的桌面下载：

• macOS 桌面安装包：OpenSquilla-0.5.0-mac-arm64.dmg
• macOS 桌面 zip：OpenSquilla-0.5.0-mac-arm64.zip
• Windows 桌面安装包：OpenSquilla-0.5.0-win-x64.exe

中国大陆用户可以使用阿里云 OSS 镜像上的稳定直连安装器链接：

• macOS Apple Silicon: https://opensquilla-releases.oss-cn-beijing.aliyuncs.com/releases/latest/OpenSquilla-mac-arm64.dmg
• Windows x64: https://opensquilla-releases.oss-cn-beijing.aliyuncs.com/releases/latest/OpenSquilla-win-x64.exe

每个别名只有在某个发布通过镜像校验和验证后才会被替换；带版本号的 OSS 与 GitHub Release 文件仍然可用于固定版本下载。

Windows 桌面安装包目前未签名。安装前请参阅代码签名策略。

终端与自动化下载：

• Python wheel：opensquilla-0.5.0-py3-none-any.whl
• 校验和：SHA256SUMS

更新器元数据：

• latest-mac.yml
• latest.yml
• *.blockmap

0.5.0 不发布 Windows 便携版资源。已有的 0.4.x 便携版下载仅作为遗留来源保留在其 原始发版页面上。请不要期望有 0.5.0 便携版 zip 或便携版 /releases/latest/download/ 别名。

隐私与第三方归属记录参见 PRIVACY.md 和 THIRD_PARTY_NOTICES.md。

容器用户可以拉取多架构的 gateway 镜像：

docker pull ghcr.io/opensquilla/opensquilla:v0.5.0

带版本号的镜像支持 linux/amd64 和 linux/arm64。移动的 GHCR latest tag 跟随 最近经过验证的发版 tag。

从 0.4.1 或某个 0.5.0 预览版升级

升级前请先退出正在运行的桌面应用和 gateway。如果你可能需要恢复或回滚，请先备份 激活的 profile。

[!IMPORTANT] 在 Windows 上，请直接在已有安装之上安装 0.5.0。不要先卸载 Preview 4 之前的 构建：较旧的卸载器可能会删除 %APPDATA%\OpenSquilla。升级前请备份该目录。 Preview 4 及更新的安装器会在常规卸载过程中保留 profile 数据。

在 macOS 上，把新应用拖入 Applications，弹出 DMG，然后打开 Applications 中的副本。 已有的 profile 数据会保持原位。带有应用内更新的预览版安装会自动收到 0.5.0。

启动后，如果已有的聊天和 Agents 显示正常，则无需任何操作。可选的数据转移是面向 遗留的 Windows 便携版安装或另一个显式选定的 profile 的，而不是面向桌面刚刚升级 完成的那个 profile。

CLI 用户可以在当前 tool 环境上重新安装已发布的 wheel：

uv tool install --python 3.12 --force --reinstall-package opensquilla \
  "opensquilla[recommended] @ https://github.com/opensquilla/opensquilla/releases/download/v0.5.0/opensquilla-0.5.0-py3-none-any.whl"

不支持从 0.5.0 二进制降级到某个预览版或 0.4.x。如果确实需要回滚，请恢复一份完整 备份，而不要用较旧的二进制去运行一个已被 0.5.0 使用过的 profile。

非用户发起的网络可观测性可以在启动前通过 OPENSQUILLA_PRIVACY_DISABLE_NETWORK_OBSERVABILITY=true 或以下配置禁用：

[privacy]
disable_network_observability = true

旧版兼容环境变量 OPENSQUILLA_TELEMETRY_DISABLED=true 和 OPENSQUILLA_UPDATE_CHECK_DISABLED=true 仍然有效。

致谢

感谢以下贡献者，他们的工作首次出现在 0.5.0 发布范围内（自 0.4.1 起，跨越 Previews 1–4 及此后的修复）：

• @ab2ence，拖放附件、动态 Model Ensemble routing 与超时调优、桌面 gateway 启动恢复，以及 Ensemble 阵容指引。
• @HuaXiawithMoon，WeCom AI Bot websocket 模式与连接稳定性，以及非交互式 code-task 构建脚手架。
• @JarvisPei，桌面语言解析以及 opt-in 的背景音乐 播放器。
• @jiaoqingrui，一位首次参与 OpenSquilla 发布 的贡献者，统一的 channel 平台工作流、加固的心跳投递，以及每日用量报告。
• @labulalala，更可靠的 Windows 源码安装器 PATH 设置和更清晰的 shell 指引。
• @Liu-RK，sandbox 授权与托管执行对齐、token 深链、 零输出聊天恢复、workspace session 与 Full Host 传播对齐，以及 CodeTask 宿主 访问。
• @LiuXinchen1997，一位首次参与 OpenSquilla 发布的贡献者，Model Ensemble quorum 延迟与超时优化。
• @lyteen，router 自学习基础工作。
• @nankingjing，传输、进程、SQLite、checkpoint 与原子文件写入可靠性修复。
• @nice-code-la，带稳定下载别名的阿里云 OSS 发布镜像、稳定下载页面，以及经过验证的 coding-provider router 预设。
• @openvictory，一位首次参与 OpenSquilla 发布 的贡献者，在 README News 中报道了 Agentic Routing 报告的 arXiv 发布。
• @tqangxl，gateway 生命周期冲突诊断以及 SQLAlchemy core 依赖工作。
• @TUOXI293，图像预览导航，以及聊天、代码复制、 skill 详情、tool trace、标题栏与原生主题改进。

完整的归属记录和 PR/commit 证据参见 CONTRIBUTORS.md。