OpenSquilla 0.4.0

概述

OpenSquilla 0.4.0 是首个为 Vue 控制台提供签名桌面安装包的版本。它仍然保留 Python wheel 和旧版 Windows 便携版的安装路径，同时把桌面应用作为面向 macOS 和 Windows 用户、希望获得打包好的控制 UI 的最清晰安装方式。

本次发版还更新了日常控制界面、workflow 启动模型、编码 workflow、搜索 provider、终端预览路径以及运行时加固。已有的 gateway 与数据位置保持不变，因此用户无需迁移 ~/.opensquilla 状态即可升级。

✨ 新功能

面向 Control UI 的签名桌面安装包

本次发版现在包含一个经过签名和公证的 macOS Apple Silicon 安装包，以及一个面向 Electron 桌面外壳的 Windows x64 NSIS 安装包。两个安装包都内嵌了构建好的 Vue 控制 UI 和打包的 gateway 运行时。

编码模式与受保护的代码任务 workflow

编码模式为源码编辑工作提供了更清晰的产品通道。opensquilla code-task workflow 会把生成或编辑的代码引导经过隔离的运行目录、可信主机确认、分离的构建输出，以及在源码持久化之前进行验证。这让编码任务更易于检视，也更安全，便于在 Control UI 中继续推进。

手动 MetaSkills 与 workflow 启动控制

MetaSkills 默认仅支持手动触发。使用 /meta 列出 workflow，使用 /meta <name> 运行其中一个；仅当确实需要旧的自动行为时，才设置 meta_skill.auto_trigger = true。MetaSkill 的进度、澄清、运行历史读取以及救援操作界面在 Control UI 中更加清晰。

Control UI、sessions 与日常 workflow 打磨

焕新后的浏览器控制台把日常工作围绕会话状态、session 检视、Settings、artifact 预览、分享导出、交付物、turn trace、移动端标签页，以及更清晰的 Skills、Usage、Cron、Logs 和 Approvals 界面来组织。

搜索、provider 与运行时加固

DuckDuckGo、Bocha、Brave、Tavily 和 Exa 现在被记录为运行时搜索 provider，其中 web_search 用于有来源支撑的回答，web_discover 用于轻量级发现。本次发版还加入了 openai_responses 的 provider 形态，并加固了 provider 流式解析、Gemini thought-signature replay、SSRF 伪造 IP 的 DNS 处理指引、session 恢复、artifact 处理以及审批事件投递。

下载

推荐的桌面下载：

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

终端与自动化下载：

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

旧版兼容下载：

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

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

更新器元数据：

latest-mac.yml
latest.yml
*.blockmap

从 0.3.1 升级

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

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

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

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

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

致谢

感谢以下贡献者，他们的 pull request 工作体现在当前的 0.4.0 发版面中：

@ab2ence，贡献了 Control UI 迁移与稳定化、分享图导出、Web Chat 斜杠输入处理、内置的 AwesomeWebpage MetaSkill 工作、编码模式开关，以及桌面 gateway 启动和安装遥测加固。
@myz-ah，贡献了受保护的 code-task workflow 和 Web UI 的 LaTeX 公式渲染。
@nice-code-la，贡献了 Skills 就绪状态、MetaSkill 进度与澄清的 UX、手动 /meta 行为、限定作用域的 MetaSkill 运行历史读取、router 回退/默认刷新工作、图像后续路由关卡、从零开始的 code-task 构建支持，以及 MetaSkill 澄清恢复反馈。
@openvictory，贡献了 MetaSkill 运行历史与救援操作的 Control UI 工作（贯穿 session-contract 的 Control UI 集成），以及 Skill 的 API key 回退行为。
@Liu-RK，贡献了跨 Windows 与 Linux 的 sandbox 运行模式和受管访问控制工作。
@weiconghe，贡献了跨 provider 工具调用 turn 的 Gemini thought-signature replay。
@changquanyou，贡献了无空格 SSE data: 处理和受管层的 MetaSkill 检视。
@nkgotcode，贡献了 DOCX 的 skill_exec 导出行为。
@C1-BA-B1-F3，贡献了可执行的 SSRF 伪造 IP 的 DNS 失败处理指引。
@BlueOcean223，贡献了缓存重入时的 TUI EOF 状态恢复。
@szdtzpj，贡献了环境测试优先级和 TUI abort hook。
@lose4578，贡献了 OpenTUI 原生滚动回看的前端工作，并被带入 0.4.0 的预览后端。
cwan0785（@Anonymous-4427），贡献了 OpenTUI 预览后端实现的 commit，并被带入 0.4.0 的预览后端。

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