# 概览

OpenHuman 采用 GPLv3 开源，地址为 [github.com/tinyhumansai/openhuman](https://github.com/tinyhumansai/openhuman)。本节面向贡献者以及任何从源码运行 OpenHuman 的人。

如果你只是想使用这个应用，请前往 [快速开始](/openhuman/zh/gai-lan/getting-started.md)。如果你是来阅读架构、开发某个功能，或者合并一个 PR，那么你来对地方了。

***

## 内容所在位置

| 路径          | 这里有什么                                                                                |
| ----------- | ------------------------------------------------------------------------------------ |
| `app/`      | pnpm 工作区 `openhuman-app`。Vite + React 前端（`app/src/`）以及 Tauri 桌面宿主（`app/src-tauri/`). |
| `src/`      | Rust crate `openhuman_core` 以及 `openhuman-core` CLI 二进制。域、JSON-RPC、MCP 路由。           |
| `gitbooks/` | 本网站（面向公众的文档）。                                                                        |
| `docs/`     | 尚未迁移到 GitBook 的更早期深度参考资料（记忆管线图、代理流程等）。                                               |

`CLAUDE.md` 位于仓库根目录的文件是处理代码库的 AI 代理的事实来源。对人类也适用同样的规则。

***

## 从这里开始

如果你是第一次拉取该仓库：

1. [**安装与设置**](/openhuman/zh/kai-fa/getting-set-up.md)。工具链、依赖项、内置的 Tauri CLI、侧车预备——所有这些 `pnpm dev` 都需要真正启动。
2. [**构建 Rust 核心**](/openhuman/zh/kai-fa/building-rust-core.md)。仅针对仓库根目录的 Rust crate 的新机器设置：固定的工具链、操作系统包，以及精确的 `cargo` 命令。
3. [**架构**](https://github.com/tinyhumansai/openhuman/blob/main/gitbooks/developing/architecture.md)。桌面应用、Rust 核心侧车、JSON-RPC 桥以及双套接字如何协同工作。在进行非平凡更改前请先阅读这里。
4. [**前端**](/openhuman/zh/kai-fa/architecture/frontend.md) 和 [**Tauri Shell**](/openhuman/zh/kai-fa/architecture/tauri-shell.md)。React 应用以及包裹它的桌面宿主。
5. [**MCP 服务器**](https://github.com/tinyhumansai/openhuman/blob/main/gitbooks/developing/mcp-server.md)。可选的 stdio MCP 模式，用于向本地客户端暴露只读的 OpenHuman 记忆工具。

***

## 测试

OpenHuman 提供三层测试。请确认你的改动属于哪一层：

* [**测试策略**](/openhuman/zh/kai-fa/testing-strategy.md)。何时编写 Vitest、cargo 测试或 WDIO。
* [**端到端测试**](/openhuman/zh/kai-fa/e2e-testing.md)。WDIO/Appium 规格、双平台设置（Linux tauri-driver、macOS Appium Mac2），以及如何在本地运行单个规格。
* [**代理可观测性**](/openhuman/zh/kai-fa/agent-observability.md)。用于在事后调试 E2E 和代理运行的工件捕获层。

PR 必须通过 **变更行覆盖率 ≥ 80%** 门槛。为新行为添加测试，不要只测“快乐路径”。

***

## 发布

* [**发布策略**](/openhuman/zh/kai-fa/release-policy.md)。版本策略、发布节奏、OAuth + 安装器规则。
* [**云部署**](/openhuman/zh/gong-neng/cloud-deploy.md)。当某项变更跨越桌面边界时，进行后端/云端部署。

***

## 深入了解

* [**代理框架**](/openhuman/zh/kai-fa/architecture/agent-harness.md)。代理面向代码的工具表面，以及如何扩展它。
* [**Chromium Embedded Framework**](/openhuman/zh/kai-fa/cef.md)。内嵌提供方 webview 的工作方式、它们为何不运行注入的 JS，以及各提供方扫描器会做什么来替代。

对于仍在构建中的功能， [潜意识循环](/openhuman/zh/gong-neng/subconscious.md) 页面全面介绍了后台任务评估系统。

***

## 贡献

* 在以下位置查看开放 issue 和 PR： [tinyhumansai/openhuman](https://github.com/tinyhumansai/openhuman).
* PR 的目标分支是 `main`。推送到你的 fork，不要推到上游仓库。
* 请遵循 [`CONTRIBUTING.md`](https://github.com/tinyhumansai/openhuman/blob/main/CONTRIBUTING.md) 以及 issue/PR 模板。
* 保持改动聚焦。修复 bug 不需要顺带清理周边；一次性操作不需要 helper。

为 AGI 建设所做的帮助并不一定意味着要交付一个内核——修复 bug、文档、集成和测试都能推动进展。


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://tinyhumans.gitbook.io/openhuman/zh/kai-fa/developing.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.