OpenSquilla 0.5.2

概述

OpenSquilla 0.5.2 是 0.5 稳定产品线的一个维护版本。它让同一 turn 内的追问在各客户端 之间保持一致，让 Desktop 与 Gateway 的启动保持流畅，让保留的 session 历史在加载过程中 依然可用，恢复了自定义 provider 与用量设置，并修复了 Desktop 项目选择与原生 HTML artifact 预览。

已有的 gateway 配置、聊天、Agents、记忆与计划任务都会保持原位。从 0.5.1 升级的 用户，应退出正在运行的桌面应用或 gateway，直接在当前安装之上安装 0.5.2，然后 重启 OpenSquilla。常规版本升级不需要进行数据转移。

✨ 改进内容

各客户端间同一 turn 的 steering

• 追问消息可以从 Web UI 与 CLI 一致地 steer 一个正在进行的、受支持的单模型或 router turn，而无需取消或重建任务。Ensemble turn、附件与控制项变更仍然是明确的仅入队场景。
• 被接受的 steer 输入会针对预期的 turn 进行校验、幂等地持久化，并被解析为已应用、 已提升、已取消或已拒绝。符合条件的 provider fallback 仍可在不重新运行该 turn 的 路由决策的情况下应用该输入。
• 新的 Gateway 能力是增量式的。较旧的客户端保留其原有路径，较新的客户端在与较旧的 Gateway 通信时会回退到可见的入队行为。无需任何数据库或配置迁移。

更快的启动与更安全的恢复

• Desktop 不再因不必要的恢复扫描或遗留恢复维护而阻塞一个本可正常使用的主 profile。 只要存在真正的恢复工作，严格校验仍会运行，保留的恢复数据也依然可用，以便从数据 维护中安全重试。
• 重复的 Desktop 所有权检查会共享一个有界的就绪截止时间，同时不削弱保护 gateway 关闭与替换的新鲜所有权与存活性检查。
• 历史用量回填使用更小的事务和有界的竞争处理。恢复合并现在即使在去重一个已有对话时 也会保留用量记录。

session 与活动

• 保留的 session 消息、控制项、导航与消息发送在历史加载或恢复过程中依然可用。Gateway 历史读取不再占用串行的交互式请求路径。
• Model Ensemble 活动计时器会跨 channel 心跳持续计时，而不是重新开始，Desktop 启动 加载动画现在也按预期方向旋转。
• 用量回填不再在每次启动时重复执行已终结的部分工作，且在后续批次失败时会保留已提交 的进度。

Desktop 项目与 artifact 预览

• Desktop 项目选择器现在在 macOS 上与 Web 选择器保持一致：它支持文件夹创建、使用系统 本地化的对话框文本，并在预期的初始目录处打开。
• Windows Desktop 在准备其 sandbox 时接受经过校验的 Electron profile 标记，同时继续 拒绝任意标记路径。
• HTML artifact 会立即出现在 Desktop 右侧预览中。完整/离线模式的切换无需额外确认即可 应用，已保存的默认值保持不变，强制离线策略也保持权威。

provider 与用量设置

• 自定义的 OpenAI 兼容与 Anthropic 兼容 provider 再次在激活的 provider 编辑器中暴露其 Base URL 字段。
• 用量货币切换现在会应用于混合、待定与较旧的用量行，同时在可用时保留精确的原生收据 金额。
• TokenRhythm onboarding 会将其可选的注册操作与 provider 选择分开呈现，助手用量详情也 不再贴着消息面板边缘被裁切。

下载

推荐的桌面下载：

• macOS 桌面安装包：OpenSquilla-0.5.2-mac-arm64.dmg
• macOS 桌面 zip：OpenSquilla-0.5.2-mac-arm64.zip
• Windows 桌面安装包：OpenSquilla-0.5.2-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.2-py3-none-any.whl
• 校验和：SHA256SUMS

更新器元数据：

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

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

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

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

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

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

从 0.5.1 升级

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

直接在 0.5.1 之上安装 0.5.2。已有的配置、聊天、Agents、记忆与计划任务都会保留在 激活的 profile 中。

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

在 macOS 上，把新应用拖入 Applications，弹出 DMG，然后打开 Applications 中的副本。

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

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

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

[privacy]
disable_network_observability = true

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

致谢

感谢以下贡献者，他们的工作首次出现在 0.5.2 中：

• @jiaoqingrui，启动、恢复、历史用量、活动、 provider 设置以及 Windows Desktop 修复。
• @Liu-RK，Desktop 项目选择器的一致性。
• @joyfan621-png，provider onboarding 与助手 用量展示的改进。

发布归属记录参见 CONTRIBUTORS.md。