OpenSquilla 0.3.0

概述

每一个 agent 工作区最终都会沉淀出一些小仪式：搜索这里、查看那里、追问缺失的细节、撰写报告、保留有用的痕迹。

0.3.0 是 OpenSquilla 开始把这些仪式保存下来的版本，让你不必每次都重新教会它。

OpenSquilla 0.3.0 把 MetaSkills 作为可复用的 agent workflow 引入到产品中。它还加入了实用的 Health Doctor、更强的结构化工具输出压缩、一套真正面向任务的文档，以及针对长时间运行的 agent 任务的一轮广泛的运行时/WebUI 修复。

✨ 新功能

MetaSkills：把重复工作变成一套协议

MetaSkills 把可重复的多步骤工作打包成可复用、可检视的 workflow。本次发版补齐了让它们真正可用所需的运行时部分：组合解析、step 调度、暂停/恢复式的用户输入流、运行历史、提案关卡、内置稳定 MetaSkills，以及编写文档。

当一个任务不仅仅是一条 prompt 时就可以使用它：研究到报告、文档到决策、每日运营简报、账号追踪、求职准备、儿童项目规划、学术论文起草，以及创建新的 workflow 提案。如果一个任务有你认得出的形状，OpenSquilla 现在就可以开始把这种形状当作可复用的产品行为来对待。

Health Doctor：更少的离奇故障

opensquilla doctor 和 WebUI 的 Health 视图现在会把运行时状态转化为可执行的诊断结论。provider、gateway、记忆、日志、搜索、图像生成、router、channels、sandbox 以及 embedding 的问题，现在都会以具体的就绪诊断和恢复命令的形式呈现，而不再依赖零散的手工排障。目标很简单：当某些功能出现降级时，产品应当告诉你需要关注什么。

结构化工具压缩：嘈杂的工具，更干净的上下文

工具密集的 session 不再容易让模型被原始输出淹没。新的基于 Tokenjuice 的投影路径会在大段日志、diff、JSON、测试输出、包管理器输出以及其他已知工具形态进入 provider 上下文之前对它们进行压缩，同时 OpenSquilla 仍然在运行时一侧保留原始证据和投影遥测以供检视。

产品文档：终于有了一张地图

仓库现在包含了一套真正面向任务的文档：quickstart、配置、CLI、WebUI、providers、sessions、工具与 sandbox、用量与成本、记忆、compaction、MetaSkills、工具压缩、调度、channels、MCP、排障，以及贡献指引。

🛠 修复

长 session 与 compaction

长 session 的记忆与 compaction 流程现在会保留原始归档证据、checkpoint 收据、修复队列以及对 WebUI 安全的状态。上下文安全性、语义记忆质量与修复工作分别作为独立信号上报。

WebUI 聊天与 artifacts

WebChat 的修复涵盖 router replay、session 恢复缺口、重复的 compaction 状态、附件与粘贴文本的渲染、artifact 下载、输入框布局、模型 router 动画时序，以及长 turn 期间可见的恢复反馈。

运行时与 provider 处理

provider/运行时的加固降低了畸形工具调用带来的影响，保留了配置的模型切换意图，处理了 provider 的 tool-choice 要求，并避免当前 turn 过大的工具负载以裸的内部错误形式暴露出来。

跨平台可靠性

CLI 帮助渲染、sqlite 回退行为、UTF-8 子进程处理、仅 Windows 的测试 fixture、onboarding 命令以及发版面检查在受支持的平台之间更具可移植性。

下载

• Python wheel：opensquilla-0.3.0-py3-none-any.whl
• Windows 便携版：OpenSquilla-0.3.0-windows-x64-py312-recommended-portable.zip
• 稳定 Windows 便携版别名：OpenSquilla-windows-x64-portable.zip
• 校验和：SHA256SUMS

Linux 与 macOS 用户应通过 uv tool install 安装 Python wheel。Windows 用户可以使用 wheel，也可以使用便携 zip。

稳定 Windows 便携版别名包含与带版本号的便携 zip 相同的构建，但保持固定的文件名，便于脚本和文档使用。

从 0.2.1 升级

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

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

发版安装器使用的是相同的强制重装路径。升级前请关闭任何正在运行的 OpenSquilla gateway，安装完成后再重新启动。已有的 ~/.opensquilla/config.toml 和 session 数据会被复用；旧的 agent_token_saving.tool_result_compression_* 设置会被忽略或迁移，因为 Tokenjuice 投影现在已经是内置的工具结果路径。

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

致谢

感谢 @ab2ence 提交的 #56、#61、#81、#88 与 #109，这些贡献帮助把基于 Tokenjuice 的工具压缩、规范化的工具结果投影、记忆 dream 整合、聊天流式恢复工作以及跨平台发版关卡加固带进了 OpenSquilla。

感谢 @lose4578 提交 #80，也感谢 cwan0785（GitHub 上的 @Anonymous-4427）撰写了该 pull request 背后的 TUI 后端/运行时抽取相关 commit。

感谢 @nice-code-la 提交的 #82、#93、#96、#110、#114（通过 #115 重放）与 #119，这些贡献帮助保留了 router 的模型切换意图，加固了 router/MetaSkill 执行，并打磨了保留下来的高价值 MetaSkill workflow。

感谢 @openvictory 提交的 #116，修复了 yoyo migrations 的 UTF-8 迁移加载，并帮助保持发版关卡在 Windows 上的一致。

OpenSquilla 基于 Tokenjuice 的投影包含了一套用 Python 改写的、由规则驱动的精简思路，以及源自 vincentkoc/tokenjuice 的内置规则，依据 MIT 许可证再分发。出处细节参见 THIRD_PARTY_NOTICES.md 和 src/opensquilla/plugins/tokenjuice/PROVENANCE.md。