mirror of
https://github.com/tinyhumansai/openhuman.git
synced 2026-07-30 23:14:37 +00:00
82 lines
4.5 KiB
Markdown
82 lines
4.5 KiB
Markdown
---
|
||
description: >-
|
||
OpenHuman 系统的高层轮廓（桌面壳层、Rust 核心、Memory Tree、Agent 循环）。指向仓库中的深度开发者架构文档。
|
||
icon: code-branch
|
||
lang: zh-CN
|
||
---
|
||
|
||
# 架构
|
||
|
||
OpenHuman 基于 GNU GPL3 开源。本页是系统的高层轮廓；深度开发者架构参考位于仓库中的 [深度架构文档](../architecture.zh-CN.md)。
|
||
|
||
## 系统形态
|
||
|
||
OpenHuman 是一款 **React + Tauri v2 桌面应用**，搭配一个承担重活的 **Rust 核心**。
|
||
|
||
```text
|
||
┌──────────────────────────────────────────────────┐
|
||
│ 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 接入[集成](../../features/integrations/README.zh-CN.md)。后端保存 token；核心永远不会以明文形式看到它。
|
||
2. **自动获取**。每二十分钟，[调度器](../../features/obsidian-wiki/auto-fetch.zh-CN.md)会遍历每个活跃连接，并要求每个原生提供商进行同步。
|
||
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](../../features/token-compression.zh-CN.md) 处理。
|
||
10. **路由**。[路由器](../../features/model-routing/) 根据任务提示选择合适的提供商 + 模型。
|
||
|
||
## 隐私边界
|
||
|
||
留在你机器上的数据：
|
||
|
||
* Memory Tree SQLite 数据库。
|
||
* Obsidian Markdown 仓库。
|
||
* 音频捕获缓冲区和任何本地模型状态。
|
||
|
||
经过 OpenHuman 后端的数据（在一个订阅下）：
|
||
|
||
* LLM 调用（模型提供商）。
|
||
* 网页搜索智能体。
|
||
* 集成 OAuth 和工具智能体。
|
||
* TTS 流。
|
||
|
||
完整图景请参阅 [隐私与安全](../../features/privacy-and-security.zh-CN.md)。
|
||
|
||
## 开源
|
||
|
||
* **仓库：** [github.com/tinyhumansai/openhuman](https://github.com/tinyhumansai/openhuman)。GNU GPL3。
|
||
* 欢迎提交 **Issue 和 PR**。项目处于早期测试阶段。
|
||
* 对于贡献者，权威开发者指南是[深度架构文档](../architecture.zh-CN.md)。
|