OpenSquilla 0.3.1

概述

OpenSquilla 0.3.1 是 0.3 系列的维护版本。它更新了稳定安装路径，同时把集成分支上对用户最可见的修复带到了发版线上。

本次发版聚焦于让日常使用不那么脆弱：聊天消息按编写时的样子呈现，Slack channel 的配置与回复保留必要的上下文，媒体与语音 workflow 的交接更易于继续，无效的 provider 或发版状态可以更早被发现。

🛠 修复

聊天与 channel 回复保留上下文

WebChat 现在会保留多行用户消息，并为编写好的消息提供更易读的间距。Slack 的配置与回复路径也保留了更多必要的上下文，包括 Socket Mode 与 app-mention 配置、signing-secret 检查、已有 secret 的保留，以及用于回复的 thread/channel 元数据。

workflow 交接恢复更干净

语音/音频、媒体助手以及 MetaSkill 澄清交接现已上线稳定发版线。内置的短剧与视频助手 workflow 仍可使用，并具备 Windows 安全的脚本处理与审查暂停，便于在继续之前检查生成的 workflow 输出。

provider 与发版检查更早失败

畸形的工具调用历史会在变成无效请求之前被挡在 provider 之外。PR CI 也会按影响面对变更文件进行分类，使文档、运行时、依赖、发版与测试相关的变更可以触发它们各自需要的检查，而不必为每个 pull request 都执行不必要的工作。

变更

发版安装器默认现在指向 v0.3.1。
README、快速开始、MCP 与运维文档现在使用 0.3.1 的 wheel URL。
pyproject.toml、uv.lock、发版一致性测试以及安装脚本测试现在均统一为版本 0.3.1。
docs/releases/0.3.1.md 记录了本次发版所用的 GitHub Release 正文。

下载

Python wheel：opensquilla-0.3.1-py3-none-any.whl
Windows 便携版：OpenSquilla-0.3.1-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.3.0 升级

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

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

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

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

致谢

感谢 @openvictory 提交的 #123、#133 与 #137，这些贡献帮助把可见的运行状态反馈以及短剧与媒体助手 workflow 带进了 0.3.1 发版线。

感谢 @freeaccount-create 提交的 #142，帮助把 Slack Socket Mode 与自指向回复纳入 channel workflow。

感谢 @ruhook 提交的 #124，也感谢 @qq712696307 撰写了该 pull request 中的 commit，这些工作在 WebChat 中保留了用户消息的换行。

感谢 @Cola-Alex 提交的 #143，扩大了 tokenjuice 总结与失败上下文窗口，以服务回退工具结果投影。

感谢 @nice-code-la 提交的 #165 与 #166，让语音 workflow 能够端到端可用，并让澄清暂停能够干净地恢复。