> 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/gai-lan/readme.md).

# 欢迎使用 OpenHuman

一款适用于桌面的开源 AI 助手，拥有对你生活的持久记忆、代理集群和工作流，以及小到可以嵌入的 Rust 核心。

<figure><img src="https://2734108774-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fe42lJPkxRsAFpQOln2KW%2Fuploads%2Fgit-blob-ea63fb287a656aea75c044e30558090e0c8b4da3%2Fdemo.png?alt=media" alt=""><figcaption></figcaption></figure>

OpenHuman 是一款面向你的桌面的开源 AI 助手。它的设计旨在具备大多数助手所不具备的三种特性。它是一个大脑，拥有持久、本地、可读的关于你世界的记忆。它是一个编排器，具备持久的智能体图、可视化工作流、子智能体舰队以及 [端到端加密的智能体间会话](https://tinyhumans.gitbook.io/openhuman/zh/gong-neng/orchestration.md)。同时，它也是一名深度研究员，会在你问完之前就扫遍你的数据和网络。

它运行在 Tauri 桌面壳内的 Rust 核心之上，并采用 GNU GPL3 许可。源代码位于 [github.com/tinyhumansai/openhuman](https://github.com/tinyhumansai/openhuman).

大多数语言模型都是无状态的。你发出提示，得到回复，然后上下文就消失了。即使是带有“记忆”的助手，也只保留几点要点，那只是便利贴，而不是理解。OpenHuman 采用了不同的方式。

## 你将获得

* [**可供你检查的记忆。**](https://tinyhumans.gitbook.io/openhuman/zh/gong-neng/memory.md) 文档（文件夹、文件、链接、GitHub、RSS、已连接的应用）、对话和学习内容都会进入一个记忆引擎，该引擎可以由 TinyHumans 托管，也可以使用你自己的 CortexDB。智能体会基于它并附带引用作答，每一次新聊天都会先显示一段关于你的简短简介。你可以查看并删除存储的所有内容。
* [**第三方集成。**](https://tinyhumans.gitbook.io/openhuman/zh/gong-neng/integrations.md) 通过 119 个托管工具包，可一键通过 OAuth 接入 Gmail、GitHub、Slack、Notion、Stripe、Calendar、Drive、Linear、Jira 等。你无需手动配置 API 密钥。
* **为大数据而构建的智能体。** [令牌压缩](https://tinyhumans.gitbook.io/openhuman/zh/gong-neng/token-compression.md) 在工具输出到达模型之前先将冗长输出压缩，因此扫过六个月的邮件只需花费个位数美元。 [自动模型路由](https://tinyhumans.gitbook.io/openhuman/zh/gong-neng/model-routing.md) 通过一个订阅和一个 TinyHumans API 密钥，将每项任务发送到合适的模型。可选 [通过 Ollama 或 LM Studio 使用本地 AI](https://tinyhumans.gitbook.io/openhuman/zh/gong-neng/model-routing/local-ai.md) 将受支持的工作保留在你的设备上。每个模型、嵌入、记忆和网络搜索引擎都可通过配置替换。
* **快速、低成本的决策。** 在智能体花费一次完整的模型调用来从几十个工具中做选择之前，一个名为 Jev 的小型分类器会在大约 150 毫秒内对选项进行评分。它会缩小工具范围，决定是否需要任何工具，并驱动常规的浏览器步骤。昂贵的模型只会在任务需要时运行。
* [**开箱即用。**](https://tinyhumans.gitbook.io/openhuman/zh/gong-neng/native-tools.md) 默认工具集包含 [网络搜索](https://tinyhumans.gitbook.io/openhuman/zh/gong-neng/native-tools/web-search.md)，一个 [网页抓取器](https://tinyhumans.gitbook.io/openhuman/zh/gong-neng/native-tools/web-scraper.md)，一个 [编码工具集](https://tinyhumans.gitbook.io/openhuman/zh/gong-neng/native-tools/coder.md) （文件系统、git、lint、测试、grep）， [浏览器和电脑控制](https://tinyhumans.gitbook.io/openhuman/zh/gong-neng/native-tools/browser-and-computer.md), [cron 和调度](https://tinyhumans.gitbook.io/openhuman/zh/gong-neng/native-tools/cron.md), [记忆工具](https://tinyhumans.gitbook.io/openhuman/zh/gong-neng/native-tools/memory-tools.md), [智能体协调](https://tinyhumans.gitbook.io/openhuman/zh/gong-neng/native-tools/agent-coordination.md) 用于子智能体，以及 [原生语音](https://tinyhumans.gitbook.io/openhuman/zh/gong-neng/native-tools/voice.md) 支持语音输入、语音输出以及一个你可以随时打断的实时语音智能体。
* [**工作流。**](https://tinyhumans.gitbook.io/openhuman/zh/gong-neng/workflows.md) 在聊天中描述一个自动化流程。智能体会提出一个工作流图，你可以在画布上审阅并保存它。流程可按计划或应用事件运行，在审批关卡处暂停，从停下的地方继续，并保留逐步运行历史。
* [**一个能把事情做完的执行框架。**](https://tinyhumans.gitbook.io/openhuman/zh/kai-fa/architecture/agent-harness.md) 每一轮都会被检查点保存，因此子智能体会暂停等待你的输入并在之后继续，而不是退出。一个断路器会阻止重复调用循环，并返回根因摘要。工具失败会以可操作卡片的形式显示，每次运行都有可回放的日志，并附带每次调用的令牌与成本核算。
* **轻到可以在进程内运行。** Rust 核心运行在桌面应用内部，而不是作为后台服务。我们测得在一个进程中存活 500 个智能体时，每个额外占用的内存大约为 1.77 MiB。同一个核心也以库的形式提供（[`crates/openhuman-embed`](https://github.com/tinyhumansai/openhuman/tree/main/crates/openhuman-embed/README.md)，并且有一个 [一键安装设置](https://tinyhumans.gitbook.io/openhuman/zh/kai-fa/tinyhumans-api-key.md)），因此另一个产品可以启动运行时，并用几行 Rust 代码添加智能体。参见 [性能](https://tinyhumans.gitbook.io/openhuman/zh/kai-fa/performance.md)，公开的 [基准测试仓库](https://github.com/tinyhumansai/openhuman-benchmarks), [可插拔引擎](https://tinyhumans.gitbook.io/openhuman/zh/kai-fa/engines.md) 和 [将 OpenHuman 嵌入](broken://pages/e4ca2e78aa0bd4f6c9bae70053836afe68a4832e).
* [**隐私模式。**](https://tinyhumans.gitbook.io/openhuman/zh/gong-neng/privacy-and-security/privacy-mode.md) 一个开关，由 Rust 核心强制执行。本地模式会阻止所有云端模型调用，只允许设备内运行时（Ollama、LM Studio、MLX 或本地 OpenAI 兼容服务器）。
* **简单且以界面为先。** 简短的上手流程可让你在几次点击内从安装走到可工作的智能体，无需终端。该智能体有 [一个脸](https://tinyhumans.gitbook.io/openhuman/zh/gong-neng/mascot.md)：一个会说话、会对周围环境做出反应、能跨数周记住你的桌面吉祥物，并在后台持续思考。

综合起来，这些让 OpenHuman 不只是一个聊天机器人。它以低成本摄取大量个人数据，持续形成对你世界的演进式理解，并代表你采取行动。

{% hint style="warning" %}
OpenHuman 不是 AGI。它只是朝那个方向迈出的一步，拥有更好的记忆、编排和工具。
{% endhint %}

## 面向开发者

从 [环境准备](https://tinyhumans.gitbook.io/openhuman/zh/kai-fa/getting-set-up.md)，然后 [构建 Rust 核心](https://tinyhumans.gitbook.io/openhuman/zh/kai-fa/building-rust-core.md) 以及其运行时所采用的 [架构](https://tinyhumans.gitbook.io/openhuman/zh/kai-fa/architecture.md) 概览开始。若要在你自己的 Rust 产品中使用核心，请阅读 [将 OpenHuman 嵌入](broken://pages/e4ca2e78aa0bd4f6c9bae70053836afe68a4832e) 和 [一个 TinyHumans API 密钥](https://tinyhumans.gitbook.io/openhuman/zh/kai-fa/tinyhumans-api-key.md). [可加载模块](https://tinyhumans.gitbook.io/openhuman/zh/kai-fa/loadable-modules.md) 介绍原生模块系统，且 [性能和占用](https://tinyhumans.gitbook.io/openhuman/zh/kai-fa/performance.md) 包含相关数据。基准测试设备和结果公开于 [tinyhumansai/openhuman-benchmarks](https://github.com/tinyhumansai/openhuman-benchmarks).
