OpenSquilla 0.4.1

概述

OpenSquilla 0.4.1 是面向 0.4 桌面与 Control UI 产品线的维护版本。它聚焦于打包桌面应用的可靠性、Web UI 恢复、编码模式与 SquillaRouter 打包、安装遥测准确性，以及项目将 main 作为活跃开发分支的迁移。

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

✨ 改进内容

🖥️ 桌面与编码模式可靠性

当 SquillaRouter 模型资源缺失或仍为 Git LFS 指针文件时，桌面包现在会快速失败；在发布发版资源之前，打包 gateway 的冒烟检查会覆盖 code-task、编码模式支持以及 router 启动。Windows 桌面清理措辞和活动窗口重载行为也得到了收紧。

🌐 多语言 Control UI 与客户端

Control UI 和桌面客户端现在支持英语、简体中文、日语、法语、德语和西班牙语，覆盖首次绘制的桌面启动文本、设置界面、连接状态以及持久化的语言选择。

🧰 遥测、图标与面向用户的打磨

安装遥测现在会在创建遥测状态或上传事件之前跳过 GitHub Actions、pytest 以及显式声明的测试环境。Windows Electron 应用、安装器和卸载器现在使用 OpenSquilla logo。Web UI 修复改进了流式恢复、陈旧任务隔离、设置恢复行为、session 删除、顶栏布局、状态行换行，以及从桌面应用打开 HTML artifact。

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

[privacy]
disable_network_observability = true

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

🧭 Provider、router 标签与主线治理

Provider 配置文件修复涵盖 Volcengine 和 BytePlus，macOS router 运行时诊断更加清晰，模型请求日志现在会暴露 router 目标标签。OpenSquilla 现在将 main 视为常规的开发与集成分支；维护者协作分支仍可用于发版、hotfix、staging、集成和 sandbox 工作。

下载

🖥️ 推荐的桌面下载：

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

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

⚙️ 终端与自动化下载：

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

🧳 旧版兼容下载：

旧版 Windows 便携版（带版本号）：OpenSquilla-0.4.1-windows-x64-py312-recommended-portable.zip
旧版 Windows 便携版（稳定别名）：OpenSquilla-windows-x64-portable.zip

旧版 Windows 便携版资源仍作为旧版兼容下载提供，供已有的脚本和便携目录式 workflow 使用。新的 Windows 桌面用户应优先选择 OpenSquilla-0.4.1-win-x64.exe。

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

🔄 更新器元数据：

latest-mac.yml
latest.yml
*.blockmap

从 0.4.0 升级

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

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

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

桌面用户在替换之前应先退出正在运行的桌面应用。macOS 用户通过把 OpenSquilla 拖入 Applications 来安装 .dmg。Windows 用户运行 .exe 安装器。

旧版 Windows 便携版用户应将 0.4.1 的便携版 zip 解压到一个全新的目录，或在 gateway 停止时整体替换已解压的 0.4.0 目录。请不要只把新 zip 中的部分文件拷贝到旧的便携目录树中。

致谢

感谢以下贡献者，他们的 pull request 工作首次出现在 0.4.1 发版面中：

@ab2ence，贡献了安装遥测对 CI/测试环境的跳过，以及桌面 HTML artifact 的原生打开支持。

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