OpenSquilla 0.5.4

概览

OpenSquilla 0.5.4 是 0.5 稳定线的功能与维护版本。本版推出 Electron Desktop 单文件 HTML 版本化编辑 Beta、可选 Runtime Packs 与更轻量的安装程序、按会话选择模型路由，以及更可靠的 C3 多模型融合路径；同时改进聊天连续性、Desktop 启动与恢复、provider 行为、Skills、附件、进程生命周期和 Web 界面。

现有 Gateway 配置、聊天、Agents、记忆和定时任务都会保留。Gateway 会自动执行增量数据库迁移，无需手动转移数据。从 0.5.3 升级时，请先退出正在运行的 Desktop 或 Gateway，直接在当前安装上覆盖安装 0.5.4，再重新启动 OpenSquilla。

✨ 改进内容

HTML 文档编辑 Beta

0.5.4 在 Electron Desktop 中加入单文件 HTML 附件和交付物编辑的早期 Beta，提供 Preview、Source、Versions 和 Changes 视图、选中元素指令，以及 Agent 辅助的候选修改。该工作流仍处于评估阶段，有时需要人工检查源码、重试或回退。

Beta 仅支持单文件 UTF-8 HTML，不支持项目目录树、Office/PDF、WYSIWYG 或协作编辑。
候选修改在用户决定 commit 前保持独立；接受前应检查 Preview 和 Changes。
Agent 尝试可能不产生修改或需要补充指令；已提交修改可以按版本审阅和整版回退。
原生元素选择需要当前 Electron bridge；浏览器客户端与旧 Desktop bridge 在此 Beta 中仍为只读。

Runtime Packs 与更轻量的 Desktop 安装程序

Python、Node.js 和 Windows Git Bash 现在是可选 Runtime Packs，可从 Settings → Security & Privacy → Sandbox → Runtimes 管理；安装组件后会自动启用。
下载使用不可变 catalog，支持 GitHub 与北京 OSS 来源 fallback、严格完整性校验、断点续传、取消、移除和丢弃缓存；绝不会修改或删除系统安装的 runtime。
Desktop 安装程序仍包含 Gateway 与 Vue 控制台，但不再捆绑开发 runtime，因此体积更小。0.5.3 捆绑的 runtime 不会迁移；升级后请按需安装 Runtime Packs。

模型路由、Ensemble 与 provider

每个聊天可以保留自己的 Direct、Router 或 Ensemble 策略；全局策略继续作为新聊天默认值，已有聊天会在首次使用时原子采用当前全局策略。
C3 可使用共享多模型融合方案，新增可靠的固定模型 fallback、独立图片路由、事务化 tool 尝试，以及更清晰的初始化与 activity 展示。
新建和受管理的 TokenRhythm 配置中，C0 使用 DeepSeek V4 Flash 0731，Direct/C1 使用 DeepSeek V4 Pro 0813，C2 使用 Kimi K2.7 Code，C3 使用 GLM 5.2 B5 fusion；现有自定义 inline tier 不会迁移。
Qwen prompt caching、智谱 reasoning endpoint 匹配、Gemini CSV schema、通用自定义定价、路由成本明细、仅 reasoning 重试，以及 Ensemble 用量和 fallback 行为更加可靠。

聊天、任务与附件

Web chat 会确认 turn 已持久保存，不延迟回答也不禁用输入。activity 顺序、router panel、steering boundary、task ownership、时钟、pending input 和滚动位置在重连与切换 session 后恢复得更一致。
Stop 会快速响应 provider 和普通 tool 工作，同时允许正在进行的文件系统 mutation 安全结束后再发布 terminal turn。
大附件在路由时可使用完整 request capacity；上传图片既能供 vision model 使用，也会物化到 workspace 供 tool 访问。
session history 分页、首次查询 session 查找、transcript read、Prompt Cache 连续性、slash command 输入、Composer 粘贴和重复输出处理均已加强。

Desktop、Web 与平台可靠性

Desktop 启动与 Gateway readiness 解耦并报告单调递进的 milestone。恢复启动更快；macOS Keychain 失败有引导式重试；Windows process-tree helper 与安装进度更可靠。
Settings 整理为十个稳定入口，包括合并后的 Security & Privacy 和一级 Memory 页面；旧 Settings 深链通过兼容 alias 继续工作。
sidebar 交互、长 session 滚动、Workbench 缩放、activity detail、用量展开、automation 空状态、memory import 和全局控制更加一致。
Windows Safe 执行、process-tree 取消、Gateway shutdown、Skill catalog digest 验证和 CLI error exit 在支持平台上的失败行为更可预测。

下载

从 0.5.3 升级

升级前退出 Desktop 和 Gateway；如果可能需要恢复或回滚，请先备份 active profile。

直接在 0.5.3 上覆盖安装 0.5.4。现有配置、聊天、Agents、记忆和定时任务保留在 active profile 中；Gateway 启动时自动执行增量数据库迁移。

0.5.4 Desktop 使用可选 Runtime Packs，取代 0.5.3 中捆绑的开发 runtime。旧 runtime 不会复制进新应用；任务需要受管理的 Python、Node.js 或 Git Bash 时，请在升级后从 Sandbox settings 安装对应 Runtime Pack。

已有聊天可继续与旧客户端协作。每个聊天的 routing mode 会在首次由 0.5.4 使用时从当前全局策略初始化。新的 routing field 与 commit receipt 是增量字段，不理解它们的客户端可继续使用旧行为。HTML 编辑 Beta 需要完整的当前 Electron bridge 才能原生选择元素；旧客户端或仅浏览器客户端仍为只读。

[!IMPORTANT] Windows 用户若从 RC3 或早于 Preview 4 的版本升级，切勿先卸载旧版本：旧版 uninstaller 可能删除 %APPDATA%\OpenSquilla。请先备份该目录，再在现有安装上直接覆盖安装 0.5.4。Preview 4、0.5.0、0.5.1、0.5.2、0.5.3 和 0.5.4 的安装程序在正常卸载时都会保留 profile 数据。

macOS 用户请把新应用拖入 Applications、弹出 DMG，再打开 Applications 中的副本。

CLI 用户可以在当前 tool environment 上强制重装发布的 wheel：

uv tool install --python 3.12 --force --reinstall-package opensquilla \
  "opensquilla[recommended] @ https://github.com/opensquilla/opensquilla/releases/download/v0.5.4/opensquilla-0.5.4-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.4 中：

@AmirF194：使智谱 reasoning 行为严格匹配官方 API endpoint。
@Kiuyor：修复过期 IME composition state 后 Composer 粘贴内容的恢复。
@Liu-RK：改进公开 release 仓库卫生。
@LiuXinchen1997：为可靠 C3 fusion 提供 tier-level routing 基础。
@Sanjays2402：在首次搜索查询中查找已有 session。
@ab2ence：改进 C3 fusion、Ensemble fallback、provider state 隔离、Qwen Prompt Cache、用量准确性与 sidebar。
@freeaccount-create：提供兼容 Gemini 的 CSV tool schema。
@jiaoqingrui：改进 Ensemble trace token 标注。
@kriptoburak：实现 Skill catalog path digest 验证。
@lifelmy：保留 CLI 路由模型成本明细。
@lihongguang-0014：大量改进聊天连续性、steering、附件、Desktop 启动、进程生命周期、session 恢复、provider 处理与 CLI 可靠性。
@openvictory：发布技术报告 PDF 并增加发现入口。
@shixi-li：提供更安全的 Ensemble timeout fallback。
@xfjsssq：允许未知 slash-prefixed 文本按普通消息发送。

发布归属记录与 Pull Request 证据请参阅 CONTRIBUTORS.md。