openhuman/gitbooks/developing/architecture/README.zh-CN.md

description, icon, lang

description	icon	lang
OpenHuman 系统的高层轮廓（桌面壳层、Rust 核心、Memory Tree、Agent 循环）。指向仓库中的深度开发者架构文档。	code-branch	zh-CN

架构

OpenHuman 基于 GNU GPL3 开源。本页是系统的高层轮廓；深度开发者架构参考位于仓库中的 深度架构文档。

系统形态

OpenHuman 是一款 React + Tauri v2 桌面应用，搭配一个承担重活的 Rust 核心。

┌──────────────────────────────────────────────────┐
│ Tauri 壳层 (app/src-tauri/)                      │
│ • 窗口管理、OS 集成、sidecar 生命周期            │
│ • 用于集成提供商的 CEF 子 WebView                │
└──────────────────────────────────────────────────┘
 │ JSON-RPC (HTTP) ↕
┌──────────────────────────────────────────────────┐
│ Rust 核心 (openhuman 二进制, src/)               │
│ • Memory Tree 流水线                             │
│ • 集成适配器 + 自动获取调度器                    │
│ • 提供商路由器（模型路由）                       │
│ • TokenJuice 压缩                              │
│ • 原生工具（搜索、获取、文件系统、git…）         │
│ • 语音（STT 输入、TTS 输出、Meet Agent）         │
└──────────────────────────────────────────────────┘
 │
┌──────────────────────────────────────────────────┐
│ React 前端 (app/src/)                            │
│ • 页面、导航                                     │
│ • 通过 coreRpcClient 与核心通信                  │
│ • 无业务逻辑 —— 仅负责展示                       │
└──────────────────────────────────────────────────┘

逻辑归属：

• Rust 核心。所有业务逻辑。Memory Tree、集成、模型路由、工具、语音。具有权威性。
• Tauri 壳层。窗口管理、进程生命周期、IPC。是交付载体，不是功能的栖身之所。
• React 前端。UI 与编排。通过 JSON-RPC 调用核心。

数据流

1. 连接。通过 OAuth 接入集成。后端保存 token；核心永远不会以明文形式看到它。
2. 自动获取。每二十分钟，调度器会遍历每个活跃连接，并要求每个原生提供商进行同步。
3. 规范化。提供商输出（邮件页面、GitHub diff、Slack 频道转储）被归一化为带来源标签的 Markdown。
4. 分块。Markdown 被拆分为 ≤3k token 的确定性块。
5. 存储。块存入 SQLite (<workspace>/memory_tree/chunks.db)，并以 .md 文件形式存入 <workspace>/wiki/。
6. 评分。后台工作线程运行嵌入、实体提取、热度评分。
7. 摘要。从块池中构建并刷新来源 / 主题 / 全局摘要树。
8. 检索。当你提问时，Agent 查询 Memory Tree（搜索 / 钻取 / 主题 / 全局 / 获取）。
9. 压缩。工具输出和大型源数据在进入 LLM 上下文前经过 TokenJuice 处理。
10. 路由。路由器 根据任务提示选择合适的提供商 + 模型。

隐私边界

留在你机器上的数据：

• Memory Tree SQLite 数据库。
• Obsidian Markdown 仓库。
• 音频捕获缓冲区和任何本地模型状态。

经过 OpenHuman 后端的数据（在一个订阅下）：

• LLM 调用（模型提供商）。
• 网页搜索智能体。
• 集成 OAuth 和工具智能体。
• TTS 流。

完整图景请参阅 隐私与安全。

开源

• 仓库： github.com/tinyhumansai/openhuman。GNU GPL3。
• 欢迎提交 Issue 和 PR。项目处于早期测试阶段。
• 对于贡献者，权威开发者指南是深度架构文档。