OpenSquilla 

在 AI 代理（Agent）日益复杂的今天，高昂的 Token 成本和低效的推理过程成为落地的最大阻碍。OpenSquilla 是一个开源、令牌高效（Token-Efficient） 的微内核架构 AI 代理框架。它通过内置的 SquillaRouter 智能路由系统、四级认知记忆模型以及按需加载的技能机制，确保每一分 Token 都花在刀刃上。

OpenSquilla 不仅是一个代理，更是一个统一的网关平台。它支持 Web UI、CLI 及 Slack/Telegram/Discord 等十余种聊天渠道，并能无缝对接 OpenAI、Anthropic、Ollama、DeepSeek 等 20+ 主流 LLM 提供商。无论你是个休开发者还是企业级用户，OpenSquilla 都能让你在同样的预算下，获得更强的能力与更好的结果。

核心亮点：智能、高效、安全

1. SquillaRouter：本地智能路由引擎

• 四层分级路由 (T0–T3)：根据任务复杂度（长度、语言、代码块、语义），自动将请求路由至最合适的模型层级。
  • T0/T1：简单任务使用廉价小模型。
  • T2/T3：复杂推理调用强大模型。
• 本地决策，隐私无忧：分类器在设备端运行，提示词在路由决策阶段绝不离开本地，确保数据隐私。
• 自适应推理：仅在需要深度思考时产生推理 Token，系统提示随任务复杂度动态缩放，拒绝为“你好”支付高额推理费。

2. 四级认知记忆系统

模仿人类认知结构，构建持久且高效的知识库：

• 工作记忆：当前任务的短期上下文。
• 情节记忆：记录经验与因果关系。
• 语义记忆：存储事实与规则。
• 原始记忆：用于审计与再训练的基础数据。
• 混合搜索：结合 FTS 关键词搜索与 sqlite-vec 语义召回，捆绑 ONNX 推理在 CPU 上运行，实现完全本地的向量嵌入。
• 梦境整合：定期将分散的情节痕迹合并为结构化知识，模拟睡眠中的记忆巩固，同时受限于提示注入预算。

3. 按需技能加载 (On-Demand Skills)

• MCP 客户端集成：内置 Model Context Protocol 支持。
• 16+ 捆绑技能：涵盖编码代理、GitHub 操作、Cron 定时任务、深度研究、Office 文档处理 (pptx/docx/xlsx/pdf)、摘要生成等。
• 零稳态浪费：只有当前任务需要的技能才会被加载到上下文中，避免无关工具描述占用宝贵的 Context Window。

4. 分层安全沙箱

• 三级策略：标准、严格、锁定，配合权限矩阵。
• 隔离执行：Linux 上使用 Bubblewrap，macOS 使用 Seatbelt (SBPL)，确保代码执行环境隔离。
• 防注入机制：重复拒绝后自动暂停自主执行，清除被拒输出缓存，所有技能元数据进行 XML 转义，彻底关闭常见提示注入向量。

5. 统一网关与多渠道支持

• Starlette ASGI 服务器：运行在 127.0.0.1:18790，提供 WebSocket RPC 和嵌入式控制台。
• 全渠道接入：Web UI、CLI、Terminal、Slack、Telegram、Discord、Feishu (飞书)、DingTalk (钉钉)、WeCom (企微)、MS Teams、Matrix、QQ 等，所有入口共享同一个 TurnRunner，确保一致的调度、重试与日志记录。

快速开始

1. 安装前提条件

你需要安装 Git, Git LFS 和 uv (极速 Python 包管理器)。

macOS (Homebrew):

brew install git git-lfs uv
git lfs install

Windows (PowerShell):

winget install --id Git.Git -e
winget install --id GitHub.GitLFS -e
powershell -ExecutionPolicy Bypass -c "irm https://astral.sh/uv/install.ps1 | iex"
git lfs install

2. 克隆仓库

git lfs install
git clone https://github.com/opensquilla/opensquilla.git
cd opensquilla
# 拉取路由器模型资产
git lfs pull --include="src/opensquilla/squilla_router/models/**"

3. 安装 OpenSquilla

macOS / Linux:

bash install.sh

Windows PowerShell:

powershell -ExecutionPolicy Bypass -File .\install.ps1

💡 提示：如需额外渠道支持（如飞书），可添加参数 -Extras feishu。

4. 配置与启动

初始化向导：

opensquilla onboard

跟随向导选择提供商（如 OpenRouter）并输入 API Key。

运行网关：

opensquilla gateway run

访问 http://127.0.0.1:18790/control/ 打开 Web UI。

适用场景