Spacebot

在 AI 智能体（Agent）爆发的今天，大多数框架仍停留在“单线程对话”的原始阶段：一个 LLM 循环处理所有任务——思考、执行、记忆检索、上下文压缩。这导致了一个致命缺陷：阻塞。当它在执行复杂任务时，无法回应新消息；当它在压缩上下文时，整个会话陷入沉默。

Spacebot 不是一个简单的聊天机器人包装器，而是一个面向团队、社区和多用户环境设计的并发智能体操作系统。它通过架构级的革新，实现了“从不阻塞、从不遗忘、永远响应”。

核心理念：拆分单体，并发执行

Spacebot 的核心哲学是专业化分工。它将传统单体智能体拆解为五个独立的进程类型，每个进程只专注于一件事，并通过高效的协作机制并行运行：

这种架构使得 Spacebot 能够同时处理数百个用户的并发请求：它在回答用户 A 的同时，可以为用户 B 编写代码，并为用户 C 整理会议纪要，互不干扰。

关键特性详解

1. 真正的并发与消息合并

在 Discord 群组或 Slack 频道中，消息往往瞬间刷屏。Spacebot 引入了消息合并系统：

• 批处理机制：检测快速连续的消息流，将其合并为单个 LLM 轮次，附带时间上下文。
• 全局感知：LLM 能一次性看到“一组”消息，从而理解对话脉络，选择最有趣的话题参与，或在无意义时保持沉默，避免“刷屏式”回复。
• 去抖与过滤：可配置的去抖时间，自动忽略私信骚扰，确保公共频道的整洁。

2. 结构化图记忆系统

告别杂乱的 Markdown 文件和向量数据库的“黑盒”检索。Spacebot 的记忆是一个带类型的图连接知识系统：

• 8 种记忆类型：事实、偏好、决定、身份、事件、观察、目标、待办事项。
• 图边关系：明确记录记忆间的逻辑（如“更新”、“矛盾”、“由...引起”）。
• 混合召回：结合向量相似度与全文搜索（RRF 融合），精准提取相关信息。
• 记忆简报：Core 进程定期生成知识摘要，注入到每个对话中，让智能体“带着记忆”交流，而非每次从零开始。

3. 强大的任务执行能力

内置的 Worker 系统配备了全套生产力工具：

• Shell & Exec：运行任意命令和程序，支持超时控制。
• File System：读写文件、自动创建目录，安全沙箱运行。
• Browser Automation：基于无头 Chrome 的自动化，采用无障碍树引用系统（如 e0, e1），比脆弱的 CSS 选择器更稳定，支持点击、输入、截图。
• OpenCode 集成：可生成持久的编码智能体，具备 LSP 感知和代码库探索能力，胜任复杂的重构任务。
• Web Search：集成 Brave 搜索，支持新鲜度过滤和本地化结果。

4. 智能模型路由与成本优化

Spacebot 内置了四层路由系统，自动为不同任务匹配最具性价比的模型：

• 进程级路由：对话用高性能模型（如 Claude Sonnet），后台任务用廉价模型（如 Haiku）。
• 提示词复杂度评分：轻量级分析用户消息，将简单问候自动降级到免费/低价模型，耗时<1ms。
• 故障转移链：遇到 429/502 错误时，自动切换到备用模型，确保持续可用。
• 多提供商支持：原生支持 Anthropic, OpenAI, Z.ai (GLM), Ollama, NVIDIA, Moonshot (Kimi) 等，甚至支持自定义 OpenAI 兼容端点。

5. 灵活的部署与扩展

• 一键托管：通过 spacebot.sh 脚本快速部署，无需自行维护服务器。
• 自托管自由：单个 Rust 二进制文件，无 Docker 依赖，无微服务架构，克隆即运行。
• 技能生态系统：通过 skills.sh 注册表一键安装社区技能（如 PDF 处理、Vercel 集成），兼容 OpenClaw 技能体系。
• MCP 集成：支持 Model Context Protocol，轻松连接外部数据库、API 和 SaaS 工具，无需重新编译。

技术栈亮点

Spacebot 基于现代高性能技术栈构建，确保了极致的速度与稳定性：

• 语言：Rust 2024 Edition（内存安全、零成本抽象）
• 异步运行时：Tokio（高并发处理能力）
• 数据存储：SQLite (关系型) + LanceDB (向量/全文) + redb (键值)
• LLM 框架：Rig v0.30（专为智能体设计）
• 加密：AES-256-GCM 本地加密存储密钥
• 平台适配：Serenity (Discord), slack-morphism (Slack), teloxide (Telegram)

快速开始

前置条件

• Rust 1.85+
• 任意支持的 LLM API Key（或使用 OAuth 登录）

安装与运行

# 克隆项目
git clone https://github.com/spacedriveapp/spacebot
cd spacebot

# 编译发布版
cargo build --release

# 创建配置文件 config.toml (参考官方文档配置 API Key 和 Discord Token)

# 启动服务
./target/release/spacebot start --foreground

认证方式

支持静态 API Key 或 Anthropic OAuth（直接使用 Claude Pro/Max 订阅）：

spacebot auth login             # 浏览器授权
spacebot auth status            # 查看状态

未来愿景：Spacebot + Spacedrive

Spacebot 是文件管理器 Spacedrive 的 AI 对应物。未来的集成将实现终极形态：

• Spacedrive 索引你所有设备、云端和本地的文件，提供语义搜索。
• Spacebot 利用这些数据进行自主推理和任务执行。
• 结果：一个真正拥有“本地记忆”和“全局视野”的智能体，能基于你 TB 级的个人数据回答问题、执行操作，且所有数据完全保留在本地。