> For the complete documentation index, see [llms.txt](https://tinyhumans.gitbook.io/openhuman/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://tinyhumans.gitbook.io/openhuman/zh/gong-neng/platform.md).

# 平台与可用性

OpenHuman 是一个原生桌面应用，不是浏览器扩展，也不是 Electron 包装器。基于 **React + Tauri v2** ，带有 **Rust 核心**，它体积小、启动快，并且不打扰你。

***

## 支持的平台

| 平台          | 架构                  | 分发                                       |
| ----------- | ------------------- | ---------------------------------------- |
| **macOS**   | Intel、Apple Silicon | `.dmg` 安装程序、Homebrew                     |
| **Windows** | x64、ARM64           | `.msi` 安装程序                              |
| **Linux**   | x64                 | AppImage、 `.deb`，AUR 配方（`openhuman-bin`) |

### Linux AppImage 说明

Linux AppImage 是为 x64 桌面构建的，也是 curl 安装程序默认选择的资源。在较新的发行版上，尤其是那些收紧非特权用户命名空间或 AppArmor 默认设置的构建版本上，AppImage 启动可能在 OpenHuman 到达自身崩溃报告器之前就失败。已知症状包括：

* `unshare：写入 /proc/self/uid_map 失败：不允许执行该操作`
* `未找到解释器！`
* `无法执行二进制文件`

发生这种情况时，请优先使用 `.deb` Debian/Ubuntu 系统上的软件包。对于 Fedora、openSUSE 以及其他非 Debian 发行版，在报告问题时请附上发行版版本、内核版本、GPU/驱动栈以及确切的 AppImage 文件名，以便维护者区分主机限制和打包有问题的 AppImage 运行时。

***

## 为什么原生很重要

OpenHuman 采用原生应用而不是网页包装器，原因有三点。

**体积小。** 仅为典型通信工具的一小部分大小。启动时间不到一秒，并且占用极少内存。

**启动快。** 无需初始化浏览器引擎。可立即开始接收请求。

**操作系统级安全。** 凭据保存在平台的安全钥匙串中，macOS Keychain、Windows Credential Manager、Linux Secret Service。敏感数据绝不会存放在浏览器存储或纯文本文件中。本地 Memory Tree 的 SQLite 数据库位于你的工作区文件夹中，归你所有。

***

## 架构一览

```
┌──────────────────────────────────────────────────┐
│ Tauri 外壳 - 窗口管理、操作系统集成 │
└──────────────────────────────────────────────────┘
 │ JSON-RPC ↕
┌──────────────────────────────────────────────────┐
│ Rust 核心（`openhuman` sidecar） │
│ • Memory Tree、集成、自动抓取 │
│ • 模型路由器、TokenJuice、原生工具 │
│ • 语音（STT 输入，TTS 输出，Meet 代理） │
└──────────────────────────────────────────────────┘
 │
┌──────────────────────────────────────────────────┐
│ React 前端 - 界面、导航 │
└──────────────────────────────────────────────────┘
```

外壳只是一个传递载体（窗口管理、进程生命周期、IPC）。所有产品逻辑都在 Rust 核心中。React 前端通过 JSON-RPC 与核心通信。参见 [架构](/openhuman/zh/kai-fa/architecture.md) 以了解完整情况。

***

## 远程/无头使用

Linux 服务器可以在没有桌面会话的情况下托管 Rust 核心。生产形态是一个远程 `openhuman-core` JSON-RPC 服务，加上一个本地桌面客户端，并配置该核心 URL 和 bearer token。

通过提供 Vite 前端并将其指向远程核心，可以用于开发/预览的私有浏览器 UI，但它并不能完全替代桌面外壳。原生深度链接、托盘控制、操作系统钥匙串访问、CEF 账户扫描器以及屏幕/窗口集成仍然需要 Tauri 应用。参见 [云部署](/openhuman/zh/gong-neng/cloud-deploy.md#remote-ui-choices) 当前的远程 UI 设置。

***

## 实时通信

桌面应用会与 OpenHuman 后端保持持久连接。响应会在生成时流式输出；结果会逐步出现，而不是卡住后才一次性显示。如果网络中断，应用会以指数退避方式自动重新连接。

***

## 离线行为

你的本地状态会保留在设备上。偏好、设置和已连接来源的配置在离线时仍可使用。本地 Memory Tree 完全可访问，你可以浏览 [Obsidian 知识库](/openhuman/zh/gong-neng/obsidian-wiki.md) 并在没有任何网络连接的情况下阅读你现有的笔记。

自动抓取和实时 LLM 调用需要联网。网络恢复后，下一次 20 分钟的周期会从中断处继续。

***

## 自动更新

桌面外壳会通过 Tauri 的更新器插件，依据 GitHub Releases 上发布的清单自动更新自身。OpenHuman 核心 sidecar 也包含在同一个捆绑包中，因此外壳更新会同时升级两者。