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 为存根

---

核心能力（如文档所述）

能力	工作原理（高层）	当前状态
记忆	仅追加、哈希链式事实流，带两个时间戳（事件时间 + 记录时间）。检索结合词汇、语义和近期激活层；旧事实按“记忆曲线”衰减，除非标记为受保护。	已实现 – 默认开启
情感与关怀	一个“关怀势场”，可通过 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 为桩实现

---

核心能力（如文档所述）

能力	工作原理（高层）	当前状态
记忆	仅追加、哈希链式事实流，带两个时间戳（事件时间 + 记录时间）。检索结合词汇、语义和近期激活层；旧事实按“记忆曲线”衰减，除非标记为受保护。	已实现 – 默认开启
情感与关怀	一个“关怀势场”，可通过 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 – 纯 Safe 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 OR MIT 双许可证，允许宽松和 copyleft 使用。

---

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

---

核心能力（按文档记录）

能力	工作原理（高层）	当前状态
记忆	仅追加、哈希链式事实流，带有两个时间戳（事件时间 + 记录时间）。检索结合词汇、语义和近期激活层；较旧的事实会按“记忆曲线”衰减，除非标记为受保护。	已实现 – 默认开启
情感与关怀	一个“关怀势场”，可通过 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 – 纯 Safe 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 OR MIT 双许可证，允许宽松和 copyleft 使用。

---

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

---

摘要

Apeireth 是一个以隐私为先、设备端的 AI 伴侣，使用安全的 Rust 编写。它存储用户事实的仅追加、哈希链式记忆，提供规则引擎驱动的“关怀”模式，并对任何不可逆操作强制要求人工批准。该项目提供桌面 UI（Tauri）、终端 UI 和 CLI，并支持三个 LLM 提供商（兼容 OpenAI、MiniMax、Anthropic）。所有核心功能均在 Windows、Linux 和 macOS 上本地运行；缺失的部分（WebSocket 服务器、P2P 网格、完整的 SDK 传输）被明确列为“诚实的缺口”。