> 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/kai-fa-zhong/developing.md).

# 概览

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-zhong/getting-set-up.md)。工具链、依赖项、内置的 Tauri CLI、sidecar 暂存——所有 `pnpm dev` 让它真正启动所需的一切。
2. [**构建 Rust 核心**](/openhuman/zh/kai-fa-zhong/building-rust-core.md)。仅针对仓库根目录 Rust crate 的全新机器配置：固定的工具链、操作系统软件包，以及精确的 `cargo` 命令。
3. [**架构**](https://github.com/tinyhumansai/openhuman/blob/main/gitbooks/developing/architecture.md)。桌面应用、Rust 核心 sidecar、JSON-RPC 桥接，以及双 socket 如何协同工作。在做非平凡更改之前先读这部分。
4. [**前端**](/openhuman/zh/kai-fa-zhong/architecture/frontend.md) 以及 [**Tauri Shell**](/openhuman/zh/kai-fa-zhong/architecture/tauri-shell.md)。React 应用，以及将其封装的桌面宿主。
5. [**MCP 服务器**](https://github.com/tinyhumansai/openhuman/blob/main/gitbooks/developing/mcp-server.md)。用于向本地客户端暴露只读 OpenHuman 记忆工具的可选 stdio MCP 模式。

***

## 测试

OpenHuman 附带三层测试。要知道你的改动属于哪一层：

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

PR 必须通过 **更改行至少 80% 覆盖率** 门槛。为新行为添加测试，而不只是“快乐路径”。

***

## 发布

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

***

## 更深入了解

* [**Agent Harness**](/openhuman/zh/kai-fa-zhong/architecture/agent-harness.md)。基于 tinyagents 的回合循环（检查点、断路器、子代理回传、日志/回放）以及如何扩展工具表面。
* [**工作流**](/openhuman/zh/gong-neng/workflows.md)。由 tinyflows 支持的 `flows` 领域：触发器、信任来源、审批门控运行，以及 `flows_*` RPC 表面。
* [**Chromium Embedded Framework**](/openhuman/zh/kai-fa-zhong/cef.md)。嵌入式提供方网页视图如何工作、为什么它们不运行注入的 JS，以及每个提供方扫描器实际做什么。

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

***

## 贡献

* 在 [tinyhumansai/openhuman](https://github.com/tinyhumansai/openhuman).
* 处提交开放的 issue 和 PR `main`。推送到你的 fork，而不是上游仓库。
* 按照 [`CONTRIBUTING.md`](https://github.com/tinyhumansai/openhuman/blob/main/CONTRIBUTING.md) 以及 issue/PR 模板。
* 保持改动聚焦。修复 bug 不需要顺带清理周边；一次性操作也不需要辅助函数。

为 AGI 的构建提供帮助，并不一定意味着要交付一个内核——修复 bug、文档、集成和测试都能提升整体水平。