OpenSquilla 0.5.0 Preview 4

概述

OpenSquilla 0.5.0 Preview 4 是一个面向已有桌面与终端安装的升级安全版本。它在纠正早期预览版引入的 profile 布局迁移的同时，保护激活的 workspace、身份、记忆、配置与聊天记录。

常规版本升级不需要进行数据转移。如果当前的聊天和 Agents 已经正确显示，请继续使用激活的 profile。数据转移仅保留给旧的 Windows 便携版安装或另一个显式选定的 OpenSquilla profile。

✨ 改进内容

Profile 恢复与升级安全

桌面现在会在创建空 workspace、打开聊天数据库或写入任何 profile 数据之前，先检查生效的 profile 与 workspace。已有的 USER.md、SOUL.md、IDENTITY.md、MEMORY.md 以及 state/ 下的聊天数据库不会被静默覆盖、删除或合并。

当同时存在较旧和当前 workspace 但激活数据仍然有效时，OpenSquilla 会继续使用它，并展示一条非阻断的恢复提示。如果激活的 profile 无法被安全验证，桌面会转而提供一个隔离的、持久化的恢复 profile，而不是写入一个不确定的位置。恢复始终可用，且不会删除原始 profile 或其备份。

完整的 profile 转移使用稳定的源快照与全有或全无的目标替换。已有的目标数据必须先备份，源则保持不变。两个 profile 绝不会被静默合并或保持自动同步。

Windows 便携版转移

全新的 Windows 桌面安装可以检测已退役的 OpenSquilla 便携版数据，并在设置过程中提供可选的复制。该页面会在复制其聊天、Agents、设置及其他 profile 状态之前，先识别所选的便携版数据。任何内容都不会被自动选中，选择 Not now 会继续正常设置，而不改动便携版源。

CLI home 与其他桌面 profile 在首次运行设置期间不会作为常规升级数据呈现。它们仍可通过 Settings 中的显式转移操作使用，在那里，已填充的桌面目标在替换前需要一次完整备份。

桌面清理、凭据与更新

RC4 的 Windows 卸载器会在常规卸载过程中保留桌面 profile 数据。桌面还将重置设置、删除当前 profile 以及删除所有用户数据这三项操作区分开来，使每一项都明确说明其将删除的内容。

Provider API key 的更新现在会在重启后仍然生效，而不会被较旧的已保存值替换。更新检查可以跨越长时间运行的桌面 session 持续进行，并能上报后续的 0.5 预览版或最终的 0.5.0 发布。Windows 更新提示仍会引导至手动的安装器下载；它们不会静默替换正在运行的应用。

Model Ensemble、provider 与 Control UI

Model Ensemble 现在会分别上报候选与聚合进度，更可靠地处理缓慢或不完整的流，并关闭停滞的运行，而不会让界面无限期地处于忙碌状态。用量不再对 Ensemble turns 套用具有误导性的单模型节省公式。

Control UI 还改进了模型选择、完整的 tool-result 检视以及聊天滚动位置保持。Provider 限制与请求预算针对长时间运行和多模型 turns 获得了额外的修正。

发往官方 TokenRhythm 与 OpenRouter API 主机的请求现在会包含 OpenSquilla 公开的 HTTP-Referer 与 X-Title 应用归属请求头。自定义的 OpenAI 兼容主机不会收到这些请求头。

运行时与 channel 可靠性

WeCom WebSocket 连接不再运行相互竞争的心跳循环，从而避免反复断连。传输失败、子进程清理、SQLite 扩展处理以及 checkpoint 恢复也会以更可预测的方式失败，而不丢弃有效的用户状态。

下载与部署

发布文件仍可从 GitHub 以及带版本号的阿里云 OSS 镜像获取。中国大陆用户可以使用以下稳定下载页面：

https://opensquilla-releases.oss-cn-beijing.aliyuncs.com/releases/latest.html

该页面指向最新经过验证的镜像发布；它不是额外的 GitHub Release 资源。

下载

推荐的桌面下载：

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

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

终端与自动化下载：

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

更新器元数据：

latest-mac.yml
latest.yml
*.blockmap

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

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

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

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

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

从 Preview 3、更早的预览版或 0.4.1 升级

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

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

在 macOS 上，把新应用拖入 Applications，弹出 DMG，然后打开 Applications 中的副本。已有的 profile 数据会保持原位。

启动后，如果已有的聊天和 Agents 显示正常，则无需任何操作。可选的便携版转移是面向另一个遗留安装的，而不是面向桌面刚刚升级完成的那个 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.0rc4/opensquilla-0.5.0rc4-py3-none-any.whl"

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

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

[privacy]
disable_network_observability = true

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

致谢

感谢以下贡献者，其新工作出现在 Preview 4 中：

@HuaXiawithMoon，改进 WeCom WebSocket 连接稳定性。
@ab2ence，围绕清晰的静态与动态阵容重构了 Model Ensemble 指引。
@nice-code-la，阿里云 OSS 发布镜像与稳定下载页面。
@nankingjing，传输、进程、SQLite 与 checkpoint 可靠性修复。

完整的归属记录和 pull request 证据参见 CONTRIBUTORS.md。