Apeireth/Apeireth

Apeireth 是什么

Apeireth 是一个以隐私为先、基于桌面的 AI 伴侣，使用安全的 Rust 编写。它完全在用户设备上运行（Windows、Linux 和 macOS），旨在记住关于你的事实，仅在你允许时行动，并且未经明确批准绝不执行不可逆操作。该项目由一组 crate（foundation、engine、capabilities、adapters）组成，共同实现了一个由规则引擎驱动的“关怀”系统、一个五层混合记忆存储，以及一个严格的治理层，强制执行“一次批准 → 一个副作用”。

---

核心能力（按文档记录）

能力	工作原理（高层）	当前状态
记忆	仅追加、哈希链式事实流，带有两个时间戳（事件时间 + 记录时间）。检索结合词汇、语义和近期激活层；旧事实按“记忆曲线”衰减，除非标记为受保护。	已实现 – 默认开启
情感与关怀	一个“关怀潜力场”，可通过 APEIRETH_ENABLE_CARE 启用。启用后，规则引擎决定何时说话、保持沉默多久以及提供哪些手势。仅当存在情感读数时，语音输出才会进行语调调制。	已实现 – 默认关闭
工作与信任	五阶段执行流水线，带读前写保护、沙箱升级阶梯和两层原子写入模型。操作按风险等级分类；任何一级（不可逆）操作都需要人工批准的“审批卡”。	已实现
多家庭集群	每个家庭拥有自己的 users/<id>/ 域，数据平面（记忆、配额、账本）相互隔离。跨域读写被拒绝。伙伴实例运行独立的运行时，因此个性不会在家庭之间迁移。	已实现
提供商适配器	支持三个可用的 LLM 后端（OpenAI 兼容、MiniMax、Anthropic）。Gemini 和 OpenAI-Responses 仅是协议规范化器，尚未作为提供商接入。	已实现
SDK / CLI / Tauri UI	CLI（apeireth-cli）、基于 Tauri 的桌面伴侣和终端 UI（apeireth-tui）。SDK 的 WebSocket 传输目前是桩实现；HTTP 服务器不暴露 WS 端点。	UI 和 CLI 可用；SDK WS 为桩实现。

---

架构概览

+--------------------------------------------------------------+
|  Faces:  companion-desktop (Tauri) • apeireth-tui • CLI      |
+--------------------------------------------------------------+
|  Adapters: gateway (HTTP/SSE, token gate) • SDK • CLI • TUI |
+--------------------------------------------------------------+
|  Assembly: runtime‑assembly (production.rs defaults, quota, |
|            approvals)                                        |
+--------------------------------------------------------------+
|  Engine: memory • provider • organ • runtime                |
+--------------------------------------------------------------+
|  Foundation: core (onion/user_domain) • protocol •          |
|            credentials • governance                         |
+--------------------------------------------------------------+

• Foundation – 纯安全 Rust 核心 crate，无 unsafe 代码。处理用户域隔离、凭据存储（可用时使用操作系统钥匙串，否则回退到明文），以及双层洋葱权限模型。
• Engine – 实现记忆流、LLM 提供商集成，以及执行副作用（文件写入、git 写入等）并在严格审批检查下运行的“器官”模块。
• Adapters – 为外部客户端提供 HTTP/SSE 网关和（目前为桩实现的）WebSocket SDK。
• Faces – 面向用户的应用：带动画界面的 Tauri 桌面窗口、终端界面和命令行客户端。

---

快速开始（用户视角）

1. 安装 – 从 Releases 页面下载 Windows 安装程序（SHA‑256 验证）或从源码构建（cargo build --release -p apeireth-cli 以及用于 Tauri UI 的 pnpm 构建）。
2. 运行 – 启动桌面图标，选择 LLM 提供商，并输入你的 API 密钥。密钥在可能的情况下存储在操作系统钥匙串中；否则回退到环境变量或内存存储。
3. 交互 – 说话或输入；Apeireth 将使用你自己的话（来自其记忆）来回答。在设置中调整个性滑块；每次更改都会持久化到记忆账本中。
4. 验证 – README 指向一个“五分钟独立验证”，包含三条 CLI 命令，用于检查哈希链完整性、审批状态机和预算门强制执行。

---

安全与信任机制（“信任，但验证”部分）

• 零 unsafe Rust – 整个工作区禁止 unsafe；这消除了未定义行为。
• 哈希链式仅追加记忆 – 每个事实都与前一个事实链接，使篡改可被检测。
• 预算门 – 每个会话跟踪三个维度（令牌、工具步骤、微成本）；超过任何限制都会中止操作，而不是静默限流。
• 审批卡 – 不可逆操作（文件删除、资金转移、规则更改）需要一次性人工审批；系统记录审批并保证恰好一个副作用。
• 诚实的边界 – README 列出了每个已定义但未接线的功能（例如 WebSocket 服务器、P2P 网格、洋葱 DSL 层）。这些功能被有意禁用并明确标记，以便用户知道哪些不可用。
• 可导出数据 – 记忆、账本和技能可以打包、验证并移动到另一台机器；凭据永远不会随导出内容一起传输。

---

尚未接线的部分（诚实的缺口）

缺口	描述
WebSocket 8 帧全双工	协议已定义，但没有 /v1/ws HTTP 路由。
P2P 网格	仅明文网格；无 Noise 握手，无洋葱路由。
SDK 传输	桩实现（unimplemented!()）。
第三层 DSL 洋葱	代码存在，但默认禁用，除非 APEIRETH_ENABLE_ONION_LAYER=1。
备份导出	功能存在，但默认关闭（APEIRETH_ENABLE_BACKUP_EXPORT=1）。

---

谁可能觉得有用？

• 注重隐私的用户，希望拥有一个绝不会将个人数据发送到设备之外的 AI 助手。
• 开发者，对以 Rust 为先、经过正式检查且具有明确治理的 AI 代理框架感兴趣。
• 研究人员，探索规则引擎驱动的关怀模型、混合记忆检索或安全设计的 AI 执行流水线。

---

了解更多

• 文档地图 – docs/ 包含测试基线、能力矩阵、核心机制指南和内部交付记录。
• 路线图与状态 – 徽章显示项目处于内部候选发布阶段（rc internal test）。
• 许可证 – 采用 Apache-2.0 或 MIT 双许可证，允许宽松和 copyleft 使用。

---

底线： Apeireth 是一款功能完备、完全在设备端运行的 AI 伴侣，强调数据主权、可审计记忆和严格的人工参与控制。其代码库组织为 31 个 crate 的 Rust 工作区，全部不使用 unsafe，并公开记录了所有尚缺失的功能。