OpenSquilla 0.5.0 Preview 2

概述

OpenSquilla 0.5.0 Preview 2 是面向 0.5 路由与桌面/运行时产品线的预览维护版本。它将默认路径保持在单模型 squilla_router 上，同时前端 ensemble 开关仍会将已启用 ensemble 的 session 默认切换到打包的 static_openrouter_b5 profile。本次预览聚焦于 provider/router 恢复、Web UI 上传刷新、桌面与 session 稳定性，以及在下一个 0.5 候选版之前修复 CI 契约。

已有的 gateway 配置与 session 数据保持不变。从 0.4.1 或 0.5.0 Preview 1 升级的用户应关闭任何正在运行的桌面应用或 gateway 进程，安装 0.5.0 Preview 2 包，然后重新启动 OpenSquilla。

改进内容

Model Ensemble 与 provider 路由

Provider 与 router 设置现在在 Web UI、桌面 onboarding、config provenance RPC 以及 provider 目录中更易于恢复和检视。全新安装默认继续使用直接的单模型 router 路径。显式启用 ensemble 模式的用户会将静态 OpenRouter B5 profile 作为默认的 ensemble 选择，doctor 与超时检查也仅限于该 opt-in 路径。

受管执行与 sandbox 一致性

被取消的 turn、sandbox 拒绝后的 resume 恢复、审批授予行为，以及受限的 code-task 校验现在具有更紧密的回滚与恢复行为。code-task 构建脚手架现在通过使用脚手架包支持的 skip flag，保持非交互式。

桌面与 Control UI 打磨

桌面应用和 Control UI 改进了本地 HTML artifact 打开、桌面重新打开行为、session 删除、附件隔离、composer 草稿持久化、刷新后 session 恢复、空状态、语音就绪，以及 ensemble 进度 trace 显示。

Web UI 上传与运行时契约

已过期或临近过期的暂存上传，在原始本地文件仍然可用时，会在发送前刷新其文件 UUID。Preview 2 分支还修复了 main CI 在 onboarding 状态字段、router 模式分类、迁移/provider 持久化以及 static-B5 doctor 覆盖方面的契约漂移。

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

[privacy]
disable_network_observability = true

该统一开关涵盖自动安装遥测、被动更新检查以及桌面启动时的自动更新检查。旧版兼容环境变量 OPENSQUILLA_TELEMETRY_DISABLED=true 和 OPENSQUILLA_UPDATE_CHECK_DISABLED=true 仍然有效；由用户手动发起的发版、下载或更新检查在用户表达意图后仍可能联系 GitHub。

下载

推荐的桌面下载：

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

代码签名策略：docs/code-signing-policy.md。

终端与自动化下载：

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

0.5.0 预览版不发布 Windows 便携版资源。已有的 0.4.x 便携版下载仍可在其原始发版页面上获取，供旧版脚本和便携目录式 workflow 使用。新的 Windows 用户应使用 Electron 安装器或终端 wheel 安装路径。请不要期望有新的 0.5.0rc2 便携版 zip 或 /releases/latest/download/ 便携版别名。

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

更新器元数据：

latest-mac.yml
latest.yml
*.blockmap

从 0.4.1 升级

如果 OpenSquilla 是用 uv tool install 安装的，请在已有的 tool 环境上重新安装 0.5.0 Preview 2：

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

发版安装器使用的是相同的强制重装路径。升级前请关闭任何正在运行的 OpenSquilla gateway 或桌面应用，安装完成后再重新启动。已有的 ~/.opensquilla/config.toml 和 session 数据会被复用。

桌面用户在替换之前应先退出正在运行的桌面应用。macOS 用户通过把 OpenSquilla 拖入 Applications 来安装 .dmg，然后弹出挂载的 DMG，并打开 Applications 中的副本。如果 Dock 图标持续跳动，或启动时报告应用处于繁忙/被 translocated 状态，请强制退出任何旧的 OpenSquilla 进程，弹出 DMG，然后重新打开 OpenSquilla。Windows 用户运行 .exe 安装器。

旧版 Windows 便携版用户应切换到 Windows Electron 安装器或 0.5.0 预览版的终端 wheel 安装路径。请不要期望有新的 0.5.0rc2 便携版 zip 或 /releases/latest/download/ 便携版别名。

致谢

感谢以下贡献者，其工作首次出现在 0.5.0 Preview 2 发版面中：

@HuaXiawithMoon，让 code-task 构建脚手架保持非交互式。

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