平台与可用性

OpenHuman 的发布形态（原生 React + Tauri v2 桌面应用，带 Rust 核心）、支持的平台，以及当前涵盖的范围。

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 之所以构建为原生应用而不是 Web 外壳，原因有三。

占用小。 只有典型通信工具的一小部分大小。启动不到一秒，内存占用极低。

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

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

---

架构概览

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

外壳只是一个传递载体（窗口管理、进程生命周期、IPC）。所有产品逻辑都位于 Rust 核心中。React 前端通过 JSON-RPC 与核心通信。另见 架构 以了解完整情况。

---

远程/无头使用

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

通过提供 Vite 前端并将其指向远程核心，可用于开发/预览的私有浏览器 UI 是可行的，但它并不能完全替代桌面外壳。原生深度链接、托盘控制、操作系统钥匙串访问、CEF 账户扫描器以及屏幕/窗口集成仍然需要 Tauri 应用。另见 云端部署 了解当前的远程 UI 设置。

---

实时通信

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

---

离线行为

您的本地状态会保留在设备上。偏好设置、配置和已连接源的配置在离线时仍然可用。本地 Memory Tree 完全可访问，您可以浏览 Obsidian 知识库 并在没有任何网络连接的情况下阅读现有笔记。

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

---

自动更新

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