OpenSquilla — Token-Efficient AI Agent

使用相同的预算，获得更强的能力与更优的结果。 一个适用于 CLI、Web UI 和聊天频道的微内核 AI Agent。

---

概述

OpenSquilla 是一个 Token 高效的微内核 AI Agent。其内置的本地模型路由器（Model Router）会将每个请求发送给能处理该任务且成本最低的模型。同时，持久化记忆、分层沙盒、内置网络搜索以及端侧 Embeddings 共同构建了一个统一的共享循环。

所有的入口点——Web UI、CLI 和聊天频道——都运行在同一个循环中，因此工具调度、重试机制和决策日志在任何地方的表现都是一致的。它拥有一个可插拔的提供商层（Provider Layer），支持 OpenRouter、OpenAI、Anthropic、Ollama、DeepSeek、Gemini、Qwen/DashScope 以及其他 20 多种 LLM 提供商，且无需更改代码或配置方案。

OpenSquilla 0.3.0 是当前版本。

有关任务导向的产品文档，请参阅 OpenSquilla 产品指南 或 文档索引。

---

安装

OpenSquilla 支持 Windows、macOS 和 Linux。请根据您的使用场景选择安装路径。

Windows 便携版和快速终端安装提供的是预构建的发布版本，无需 Git。另外两种方式——从源码安装和从源码开发——则是从 Git 检出进行构建（git clone + Git LFS）。

发布安装命令使用已发布的 GitHub Release 资产。Windows 便携版压缩包还为当前版本提供了 /releases/latest/download/ 别名。Python wheel 安装使用带版本号的文件名，因为安装程序会校验文件名中嵌入的版本信息。

路径	适用人群	使用时机
Windows 便携版	Windows 用户	无 Python 工具链；单压缩包启动
快速终端安装 (推荐)	任意系统的终端用户	从终端安装发布版 Wheel
从源码安装	追踪 main 分支的用户	运行检出的源码，而非编辑
从源码开发	贡献者	编辑、测试或调试源码

先决条件

要求	Windows 便携版	快速终端安装	从源码安装	从源码开发
Python 3.12+	已打包	通过 uv	通过 uv 或系统	通过 uv
Git + Git LFS	—	—	必须	必须
uv	—	若缺失则自动安装	推荐	必须

默认的 recommended 配置文件会安装 SquillaRouter（OpenSquilla 的端侧模型路由器）及其模型资源；设置 OPENSQUILLA_INSTALL_PROFILE=core 则会省略这些依赖。使用 --router disabled 启动标志可以在保留依赖项安装的同时，在运行时关闭路由器。

在 Windows 上，SquillaRouter 打包的 ONNX 运行时还需要 Visual C++ 运行时。Windows 便携版启动器和源码 PowerShell 安装程序会通过 winget 自动安装它；但快速终端安装（uv tool install）路径不会自动处理——如果启动时报错 DLL load failed，请手动安装（参见 故障排除）。在此之前，OpenSquilla 将继续以直接单模型路由模式运行。

安装链接：Git · Git LFS · uv.

Windows 便携版（无需 Python）

这是 Windows 上最快捷的路径——压缩包附带了打包好的 CPython 运行时，因此无需单独安装 Python。

1. 下载当前的便携版 zip 压缩包：

2. 将其解压到可写的文件夹（如“下载”或“文档”），然后右键点击 Start OpenSquilla.cmd 并选择以管理员身份运行。

3. 完成首次运行设置，然后打开。

[!NOTE] 预览版未签名；支持的启动方式是以管理员身份运行。如果出现 SmartScreen 提示，请选择更多信息 → 仍要运行。如果 Smart App Control 或企业策略阻止了未签名的应用，请改用快速终端安装。

便携版高级用法

在首次启动前提供 OpenRouter Key：

$env:OPENROUTER_API_KEY="sk-..."
Set-ExecutionPolicy -Scope Process Bypass
.\start.ps1

如果已设置 OPENROUTER_API_KEY 且不存在本地配置，启动器将写入一个指向环境变量的配置，并直接启动网关而无需提示。如果未设置，引导向导将允许您选择任何支持的提供商。

便携版压缩包不会安装全局的 opensquilla 命令。若要在一个可以使用 opensquilla … 的终端中工作，请运行 OpenSquilla Shell.cmd，或直接调用打包的启动器：

.\opensquilla.cmd onboard --provider openrouter --api-key-env OPENROUTER_API_KEY

快速终端安装

这是 Windows、macOS 和 Linux 上推荐的安装方式。uv 会将 OpenSquilla 安装到其专属的隔离环境中并管理其自身的 Python，无需系统 Python。此路径仅安装已发布的版本；若要使用 main 分支、开发分支或本地检出的源码，请使用 [从源码安装]。