exxperts · 智能体框架与编排

你好，这是你的新同事——exxperts

想象一下：你刚入职一家公司，有一位经验丰富的同事已经在那里工作了三年。他认识团队里的每一个人，熟悉所有项目的来龙去脉，知道哪些坑踩过、哪些方法管用。更神奇的是，这位同事从不擅自记笔记——每次要记住新东西，他都会先给你看草稿，等你点头才正式记下来。

这就是 exxperts 试图创造的东西：一个驻留在你本地的 AI 同事，不是那种每次对话都从零开始的聊天机器人，而是一个能够真正"认识"你和你的工作的持久化智能体。

exxperts Logo（暗色主题）

背景：从 Pi 出发，走向记忆治理

exxperts 的血统可以追溯到 libGDX 游戏引擎作者 Mario Zechner 主导的 Pi 开源编码 Agent 项目（MIT 许可证）。EXXETA（一家欧洲软件咨询公司）在 Pi v0.70.5 的基础上进行了深度改造，并于 2024 年开源了 exxperts 这个分支。

团队的核心判断是：现有 AI 编程助手最大的问题不是模型能力不够，而是没有记忆——每次对话都像遇到一个失忆症患者。而现有解决方案要么把记忆权完全交给 AI（隐私风险），要么干脆不支持记忆（实用性差）。

exxperts 的解法是审批门控记忆（Approval-Gated Memory）：AI 可以提议记住什么，但必须经过人类批准才能写入长期记忆。这从根本上解决了隐私和实用性之间的矛盾。

核心机制：三步记忆生命周期

exxperts 的记忆系统分为三层，严格按顺序执行：

第一步：Remember（记住）
每次工作会话结束时，AI 会生成一个"记忆草稿"，以压缩格式（Recent Context 条目）暂存。你会看到完整草稿，可以编辑、删减或直接拒绝。只有你点了"批准"，内容才会写入记忆文件。重要的事情可以标记为 must-keep，确保在任何压缩操作中存活。

第二步：Memorize（消化）
当多个 Recent Context 条目积累到一定程度，系统会触发"消化"流程：AI 从头阅读所有条目（按时间顺序，新的覆盖旧的），然后提出一份重写的长期记忆草稿。这份草稿会合并相似内容、删除冗余信息，让记忆文件"密度增加但体积不膨胀"。你同样需要审批才能写入。

第三步：Review（回顾）
记忆写入后，每条记忆都附带"来源收据"——它来自哪一次对话、哪个时间点。你可以随时点击记忆，追溯到原始对话上下文。记忆页面还提供时间旅行视图：选择一个日期，就能看到当时 AI 知道的所有事情。

技术架构：模块化的记忆引擎

exxperts 采用 Monorepo 架构，核心由多个 npm workspace 包组成：

包	职责
`@exxeta/exxperts-ai`	多模型提供商抽象层（Anthropic、Google、Mistral、AWS Bedrock、LM Studio）
`@exxeta/exxperts-core`	Agent 核心：工具调用、会话管理、MCP 集成
`@exxeta/exxperts-runtime`	编码专项 Agent（处理 repo 读写、命令执行）
`@exxeta/exxperts-tui`	终端用户界面（CLI 模式）
`apps/web-server`	Fastify + Hono Web 服务端，持久化层、记忆文件读写
`apps/web-ui`	房间管理界面、记忆生命周期 UI

Agent 的系统提示由四层构成：

L0（平台内核）：身份、隐私规则、行为风格，代码级别控制
L1a（宪章）：每个 Agent 的角色定义和模式预设，版本化管理
L1b（持久记忆）：人类治理的记忆文件，只通过批准的流程写入
L2（运行时信封）：会话元数据、工作区授权

接入 MCP：连接真实世界

exxperts 内置了对 Model Context Protocol (MCP) 的支持。MCP 是一个标准化协议，让 AI Agent 能够调用外部工具和数据源——本质上是一个可插拔的工具生态。

项目自带开箱即用的 MCP 集成：文件系统、Web 搜索、浏览器自动化（Playwright）。开发者也可以接入自定义 MCP 服务器，为特定场景扩展能力。

上手体验：桌面应用 vs 命令行

桌面应用（推荐新手）
直接下载 macOS DMG 或 Windows EXE 安装包，安装后打开应用，配置 API Key 即可使用。全程无需接触命令行。

命令行（推荐开发者）
通过官方安装脚本一键安装：curl -fsSL https://raw.githubusercontent.com/EXXETA/exxperts/main/install.sh | bash
安装脚本自动检测系统架构，优先使用预编译包（包含 Node.js 运行时），失败时自动回退源码编译。

局限与争议

API Key 成本：exxperts 本身免费，但需要自备 LLM API Key，高端模型成本较高。
记忆治理的学习曲线：审批门控机制是核心价值，但也意味着用户需要投入时间理解和维护记忆文件。
非容器化部署：无 Dockerfile/docker-compose，对于习惯容器化运维的团队需要额外适配工作。
维护者单一：目前仅由 EXXETA 公司内部团队维护，长期社区健康度存疑。

行业意义

exxperts 代表了一个重要趋势：Local-First AI。在云端 AI 统治市场的时候，exxperts 选择把记忆和对话全部留在本地——不是因为性能不够，而是因为隐私不可妥协。

"记忆必须经过人类批准"这个设计选择，在当前 AI 隐私讨论中具有标杆意义。它不是把隐私问题推到用户协议里，而是用产品机制强制执行。

随着 Claude、Mistral、Gemini 等模型的 API 能力越来越强，本地 Agent + 云端模型推理的混合模式正在成为主流。exxperts 站在了这个趋势的交叉点上。

项目来源：EXXETA/exxperts · Apache-2.0 · TypeScript · 352 Stars
分析时间：2026-09-12
分析版本：v0.11.2