OpenSquilla 0.5.0 Preview 3
概述
OpenSquilla 0.5.0 Preview 3 是面向 0.5 运行时、桌面、路由与部署产品线的大范围预览版本。它为较旧的 OpenSquilla home 增加了事务式迁移路径，扩展了 provider 与 router 的选择，强化了共享的 agent 运行时，刷新了终端与 Control UI 体验，并引入了预构建的多架构容器镜像。
已有的 CLI 与桌面配置只要位于当前激活的 OpenSquilla home 中就会保持不变。已退役的 Windows 便携版 home 以及其他旧版或已迁移位置的 home，现在可以被发现、预览并显式导入。
Preview 2、Preview 1 和 0.4.1 客户端不应等待应用内的 RC3 更新通知。这些已发布的客户端要么早于 macOS 预发布 feed 解析器，要么查询的是 GitHub 仅含稳定版的 latest-release 端点，因此即使 RC3 被正确标记为 pre-release，它们也无法可靠地看到。请使用下方任一固定版本的下载手动安装 Preview 3。Preview 3 包含了后续同产品线预览版与稳定版更新所需的 macOS 解析器。
✨ 改进内容
旧版 home 迁移与升级安全
opensquilla migrate 现在会在已有迁移来源之外，同时检测旧版 OpenSquilla home。专用的 opensquilla migrate opensquilla 路径支持 CLI home、已退役的 Windows 便携版数据目录、桌面 home、恢复的备份、Docker volume 以及其他显式指定的来源路径。
迁移默认是 dry-run。Apply 模式会暂存完整的导入内容，规范化过期路径与配置，将内联的 provider 密钥移入 .env，暂停导入的计划任务，并以事务方式发布目标。恢复元数据使被中断的导入可以重复执行，而不会留下一个不完整的 home，也不会迫使用户丢弃其源数据。
桌面 onboarding、Settings、gateway 启动诊断、doctor 以及 Web UI 都会呈现旧版数据并给出对应的恢复命令。每一个已发布 OpenSquilla 版本的配置格式都仍然受支持，因此较旧的 home 无需手工编辑其文件即可导入。
Provider、模型与路由
TokenRhythm 支持现在包含经过验证的 provider 集成、精选的 router 阶梯、静态 ensemble profile、实时模型限制修正，以及 GLM 5.2 覆盖。ensemble 配置已围绕清晰的预设与自定义阵容重新设计。
新增的 provider 覆盖包括面向 Hunyuan hy3 系列的 Tencent TokenHub 与 Token Plan，以及用于运行时联网搜索的 Alibaba Cloud IQS。实时目录与模型发现可展示更完整的模型列表和当前限制。Provider 探测会报告延迟，逐模型的 context-window 覆盖会参与预算计算，API key 形态诊断可捕获常见的设置错误，而显式保存的 llm.base_url 现在优先于 provider 环境默认值。
Provider 请求与流式处理在严格的 OpenAI 兼容 gateway、DashScope thinking 与 prompt-cache 行为、仅含 reasoning 的响应、长度限制以及一次性 thinking 回退等方面具有更紧密的兼容性。Code-task 子 agent 会继承已配置的 provider，并在所选凭据无法使用时尽早失败。
opt-in 的 router 自学习闭环可以收集保护隐私的路由特征、从显式反馈中学习、离线评估候选 head，并回滚出现退化的晋升。除非运维人员主动开启，它保持禁用状态。
桌面、终端与 Control UI
终端 UI 获得了大幅的交互与渲染改造，包括内联审批和更清晰的实时活动展示。Control UI 新增了主题引擎、改进的监控与诊断、更安全的 Settings 导航、可复制的桌面 shell 命令、更好的图像导航、紧凑化的长 tool trace，以及一个 opt-in 的背景音乐播放器（用于用户自备的媒体文件）。
桌面修复涵盖 gateway 启动恢复、语言选择、Windows 原生主题行为、macOS 预发布 feed 解析器、gateway 生命周期指引以及打包的 CLI 调用。聊天现在能更可靠地保持滚动位置和与 token 关联的状态，代码块与 skill 详情也更易于查看和复制。
附件现在可以接受不解析其内容的不透明文件类型，且上传内存与 workspace 磁盘用量都有边界限制。大体量的有效 UTF-8 文本文件以及更大的 channel 下载具有更清晰、更安全的暂存行为。
运行时、安全与数据可靠性
持久化迁移、任务调度、session 清理、MCP 生命周期、channel 回复路由、provider 重试行为、上下文压缩、tool 分发以及 workspace 写入均获得了契约层面的加固。逐 turn 的目标提醒现在默认关闭，以保留 provider prompt-cache 复用并避免不必要的重复推理。
gateway 现在默认禁用 CORS，并拒绝对状态变更路由的跨源浏览器请求，除非该来源被显式允许。诊断信息会脱敏更多形态的密钥，provider 凭据的展示窗口更短，sandbox/搜索/文件访问边界在各平台上也更加一致。
容器部署
发版 tag 现在会为 linux/amd64 和 linux/arm64 构建并发布预构建的 gateway 镜像：
ghcr.io/opensquilla/opensquilla:v0.5.0rc3ghcr.io/opensquilla/opensquilla:latest
Docker latest 跟随最近推送的发版 tag，包括预览版和 backport。请使用带版本号的 tag 来实现可复现的部署与回滚。替换容器时，状态仍保留在所配置的 volume 中。
下载
推荐的桌面下载：
- macOS 桌面安装包：
OpenSquilla-0.5.0-rc3-mac-arm64.dmg - macOS 桌面 zip：
OpenSquilla-0.5.0-rc3-mac-arm64.zip - Windows 桌面安装包：
OpenSquilla-0.5.0-rc3-win-x64.exe
Windows 桌面安装包目前未签名。安装前请参阅代码签名策略。
终端与自动化下载：
- Python wheel：
opensquilla-0.5.0rc3-py3-none-any.whl - 校验和：
SHA256SUMS
更新器元数据：
latest-mac.ymllatest.yml*.blockmap
0.5.0 预览版不发布 Windows 便携版资源。已有的 0.4.x 便携版下载仍保留在其原始发版页面上，以便用户找回旧的数据目录；但新安装应使用 Electron、带版本号的 Python wheel 或容器镜像。请不要期望有新的 0.5.0rc3 便携版 zip 或 /releases/latest/download/ 便携版别名。
隐私与第三方归属记录参见 PRIVACY.md 和 THIRD_PARTY_NOTICES.md。
从 Preview 2、Preview 1 或 0.4.1 升级
替换前请先退出正在运行的桌面应用和 gateway。macOS 用户应把新应用拖入 Applications，弹出 DMG，然后打开 Applications 中的副本。Windows 用户应运行新的安装器。已有的激活 home 配置与 session 数据会被复用。
从 Preview 3 迁移到 RC4 或更新的 Windows 桌面构建时，直接在现有安装之上安装新的软件包。不要先卸载 Preview 3：其卸载器可能会删除 %APPDATA%\OpenSquilla。升级前请备份该目录。RC4 及之后的安装器在正常卸载过程中会保留 profile 数据。
如果你可能需要回滚，请在升级前备份激活的 home。Preview 3 会重新安置遗留在旧桌面布局中的数据；在该迁移之后，降级到 Preview 2 或 Preview 1 可能会让 workspace、skill、密钥或 session 看起来像是丢失了，因为那些构建版本仍然期望旧路径。相比用旧客户端去运行已迁移的 home，更推荐恢复备份。
CLI 用户可以在当前 tool 环境上重新安装已发布的 wheel：
uv tool install --python 3.12 --force --reinstall-package opensquilla \
"opensquilla[recommended] @ https://github.com/opensquilla/opensquilla/releases/download/v0.5.0rc3/opensquilla-0.5.0rc3-py3-none-any.whl"在导入之前检视旧版 OpenSquilla 数据：
opensquilla migrate除非带有 --apply，该命令都是 dry-run。对于已退役的 Windows 便携版 home，也可以使用显式路径：
opensquilla migrate opensquilla --kind windows-portable
opensquilla migrate opensquilla --kind windows-portable --apply如果找到多个便携版 home，请使用显示的选择器或传入 --home <path>。导入成功后，源数据会保持原样不被改动。
容器用户应固定此发版以获得可复现的部署：
docker pull ghcr.io/opensquilla/opensquilla:v0.5.0rc3
docker compose up -d非用户发起的网络可观测性可以在启动前通过 OPENSQUILLA_PRIVACY_DISABLE_NETWORK_OBSERVABILITY=true 或以下配置禁用：
[privacy]
disable_network_observability = true旧版兼容环境变量 OPENSQUILLA_TELEMETRY_DISABLED=true 和 OPENSQUILLA_UPDATE_CHECK_DISABLED=true 仍然有效。
致谢
感谢以下贡献者，其工作首次出现在 Preview 3 中：
- @ab2ence，桌面 gateway 启动恢复。
- @JarvisPei，桌面语言解析以及 opt-in 的背景音乐播放器。
- @labulalala，更可靠的 Windows 源码安装器 PATH 设置和更清晰的 shell 指引。
- @Liu-RK，token 深链、零输出聊天恢复以及 sandbox 文件访问对齐。
- @lyteen，router 自学习基础工作，已被采纳进加固后的 opt-in 闭环。
- @nice-code-la，经过验证的 coding-provider router 预设。
- @TUOXI293，聊天、代码复制、skill 详情、tool trace、标题栏以及原生主题改进。
完整的归属记录和 PR/commit 证据参见 CONTRIBUTORS.md。