diff --git a/gitbooks/developing/README.zh-CN.md b/gitbooks/developing/README.zh-CN.md index 2ddf35886..83b9100f5 100644 --- a/gitbooks/developing/README.zh-CN.md +++ b/gitbooks/developing/README.zh-CN.md @@ -8,7 +8,7 @@ lang: zh-CN OpenHuman 在 [github.com/tinyhumansai/openhuman](https://github.com/tinyhumansai/openhuman) 以 GPLv3 协议开源。本节面向贡献者和所有从源码运行 OpenHuman 的人。 -如果你只是想使用应用，请前往[快速开始](../overview/getting-started.md)。如果你来这里是为了阅读架构文档、hack 一个新特性，或者提交一个 PR，那你来对地方了。 +如果你只是想使用应用，请前往[快速开始](../overview/getting-started.zh-CN.md)。如果你来这里是为了阅读架构文档、hack 一个新特性，或者提交一个 PR，那你来对地方了。 *** @@ -61,7 +61,7 @@ PR 必须通过 **变更行覆盖率 ≥ 80%** 的门禁。为新行为添加测 * [**Agent Harness**](architecture/agent-harness.zh-CN.md)。智能体面向代码的工具表面，以及如何扩展它。 * [**Chromium Embedded Framework**](cef.zh-CN.md)。嵌入式提供商 webview 如何工作、为什么不运行注入的 JS，以及各提供商 scanner 实际上做了什么。 -对于仍在构建中的特性，[Subconscious Loop](../features/subconscious.md) 页面从头到尾涵盖了后台任务评估系统。 +对于仍在构建中的特性，[Subconscious Loop](../features/subconscious.zh-CN.md) 页面从头到尾涵盖了后台任务评估系统。 *** diff --git a/gitbooks/developing/architecture/frontend.zh-CN.md b/gitbooks/developing/architecture/frontend.zh-CN.md index 87a312b59..cc2c63414 100644 --- a/gitbooks/developing/architecture/frontend.zh-CN.md +++ b/gitbooks/developing/architecture/frontend.zh-CN.md @@ -874,7 +874,7 @@ speaking、acknowledgement 和 error 状态。 在 **`app/src/AppRoutes.tsx`** (HashRouter) 中定义。近似映射： -``` +```text / → Welcome (公共包装器) /onboarding → Onboarding (auth，onboarding 未完成) /mnemonic → Mnemonic / 加密设置 (auth) diff --git a/gitbooks/developing/e2e-testing.zh-CN.md b/gitbooks/developing/e2e-testing.zh-CN.md index 5216b1e36..21160faf2 100644 --- a/gitbooks/developing/e2e-testing.zh-CN.md +++ b/gitbooks/developing/e2e-testing.zh-CN.md @@ -239,7 +239,7 @@ bash app/scripts/e2e-run-spec.sh test/e2e/specs/notifications.spec.ts notificati bash app/scripts/e2e-agent-review.sh ``` -工件落在 `app/test/e2e/artifacts/-agent-review/`。完整详情 + 辅助 API：[`AGENT-OBSERVABILITY.md`](agent-observability.md)。任何失败的测试都会触发 `wdio.conf.ts` 的 `afterTest` hook，将 `failure-*.png` + `failure-*.source.xml` 写入同一运行目录。 +工件落在 `app/test/e2e/artifacts/-agent-review/`。完整详情 + 辅助 API：[`AGENT-OBSERVABILITY.md`](agent-observability.zh-CN.md)。任何失败的测试都会触发 `wdio.conf.ts` 的 `afterTest` hook，将 `failure-*.png` + `failure-*.source.xml` 写入同一运行目录。 --- diff --git a/gitbooks/features/integrations/triggers.zh-CN.md b/gitbooks/features/integrations/triggers.zh-CN.md index f8c2c2107..e863a358d 100644 --- a/gitbooks/features/integrations/triggers.zh-CN.md +++ b/gitbooks/features/integrations/triggers.zh-CN.md @@ -24,7 +24,7 @@ icon: bolt | **Stripe** | `STRIPE_CHARGE_SUCCEEDED`，你账户上的一笔成功 charge | | **日历** | `GOOGLE_CALENDAR_EVENT_CREATED`，你日历上的新事件 | -完整集合来自为[第三方集成](README.md)提供支持的 [Composio](https://composio.dev) 连接器层。当连接活跃时，相关的触发器订阅会自动接入。 +完整集合来自为[第三方集成](README.zh-CN.md)提供支持的 [Composio](https://composio.dev) 连接器层。当连接活跃时，相关的触发器订阅会自动接入。 ### Gmail OAuth 作用域 @@ -88,11 +88,11 @@ Webhook 永远不会被原始地到达你的机器。后端持有 OAuth token - **`react`** 是廉价路径。Trigger Reactor 是一个有严格预算的窄专家，只有几个工具调用。它非常适合：写一条简短的记忆笔记说"看到 Stripe 新增一笔 $84 charge，客户 X，商户 Y"、静默将同一自动提醒标记为已处理因为你本周已经分类过两次、或存储用户以后可能想查找的事件的结构化记录。 -- **`escalate`** 是重型路径。当分类智能体决定触发器需要真正的工作时，它将自包含的任务描述交给 Orchestrator。orchestrator 可以访问你完整的技能表面、工具、记忆和[潜意识循环](../subconscious.md)输出。从那里它可能： +- **`escalate`** 是重型路径。当分类智能体决定触发器需要真正的工作时，它将自包含的任务描述交给 Orchestrator。orchestrator 可以访问你完整的技能表面、工具、记忆和[潜意识循环](../subconscious.zh-CN.md)输出。从那里它可能： - 起草一封重要邮件的回复并排队等待你批准。 - 为入站 issue 拉取相关的 Notion / Linear / Drive 上下文并写一条结构化评论。 - 基于单个入站事件更新三个已连接系统（"这个客户的计划在 Stripe 变了，更新 HubSpot，在 #revenue 发帖，并在他们的 Notion 文件中添加一条笔记"）。 - - 判断触发器意味着一个会议刚刚被预定并为该通话预加载[会议智能体](../mascot/meeting-agents.md)。 + - 判断触发器意味着一个会议刚刚被预定并为该通话预加载[会议智能体](../mascot/meeting-agents.zh-CN.md)。 两种情况下操作都在你的机器上运行，针对你的本地记忆树，使用与智能体其余部分相同的模型路由和工具表面。 @@ -103,7 +103,7 @@ Webhook 永远不会被原始地到达你的机器。后端持有 OAuth token 1. **大多数触发器是噪音。** 一个已连接的 Gmail 账户每小时触发数十个触发器，其中绝大多数是用户不在乎的。在每个上运行 orchestrator 会消耗预算并产生持续的后台活动流。 2. **不同的触发器值得不同的上限。** 一个自动 Stripe 收据和个人 Slack DM 不应该花相同的 token 数来处理。分类让廉价路径保持廉价，并将 orchestrator 保留给值得它的东西。 -分类在快速模型层运行（参见[自动模型路由](../model-routing/README.md)），所以分类本身在亚秒级完成。 +分类在快速模型层运行（参见[自动模型路由](../model-routing/README.zh-CN.md)），所以分类本身在亚秒级完成。 ## 配置和退出 @@ -114,7 +114,7 @@ Webhook 永远不会被原始地到达你的机器。后端持有 OAuth token ## 隐私边界 -触发器遵循与产品其余部分相同的边界（参见[隐私与安全](../privacy-and-security.md)）： +触发器遵循与产品其余部分相同的边界（参见[隐私与安全](../privacy-and-security.zh-CN.md)）： - 第三方 token 位于后端，永不在你的笔记本上。 - Webhook 在到达你的机器之前由后端进行 HMAC 验证。 @@ -132,7 +132,7 @@ Webhook 永远不会被原始地到达你的机器。后端持有 OAuth token ## 另见 -* [第三方集成](README.md)，触发器来源的服务目录。 -* [从集成自动拉取](../obsidian-wiki/auto-fetch.md)，轮询对应部分，定期将源数据摄入记忆树。 -* [潜意识循环](../subconscious.md)，使用触发器上下文和记忆提前规划的背景循环。 -* [会议智能体](../mascot/meeting-agents.md)，升级触发器可以落地的地方之一（日历事件有 Meet 链接）。 \ No newline at end of file +* [第三方集成](README.zh-CN.md)，触发器来源的服务目录。 +* [从集成自动拉取](../obsidian-wiki/auto-fetch.zh-CN.md)，轮询对应部分，定期将源数据摄入记忆树。 +* [潜意识循环](../subconscious.zh-CN.md)，使用触发器上下文和记忆提前规划的背景循环。 +* [会议智能体](../mascot/meeting-agents.zh-CN.md)，升级触发器可以落地的地方之一（日历事件有 Meet 链接）。 \ No newline at end of file diff --git a/gitbooks/features/mascot/README.zh-CN.md b/gitbooks/features/mascot/README.zh-CN.md index 74a4cb02c..0be420e25 100644 --- a/gitbooks/features/mascot/README.zh-CN.md +++ b/gitbooks/features/mascot/README.zh-CN.md @@ -70,4 +70,4 @@ OpenHuman 有一张脸。吉祥物是一个生活在你桌面上的动画角色 * [原生语音](../native-tools/voice.zh-CN.md)，吉祥物所依赖的 STT / TTS 管道。 * [记忆树](../obsidian-wiki/memory-tree.zh-CN.md)，吉祥物记住什么以及如何记住。 * [潜意识循环](../subconscious.zh-CN.md)，你离开时它在思考什么。 -* [Chromium Embedded Framework](../../developing/cef.md)，摄像头进入 Meet 的管道（开发者参考）。 +* [Chromium Embedded Framework](../../developing/cef.zh-CN.md)，摄像头进入 Meet 的管道（开发者参考）。 diff --git a/gitbooks/features/mascot/meeting-agents.zh-CN.md b/gitbooks/features/mascot/meeting-agents.zh-CN.md index 095f3d332..bb36043fb 100644 --- a/gitbooks/features/mascot/meeting-agents.zh-CN.md +++ b/gitbooks/features/mascot/meeting-agents.zh-CN.md @@ -82,7 +82,7 @@ icon: video - 大脑 - `src/openhuman/meet_agent/brain.rs`（LLM 轮次、说话/不说话决定、工具调用）。 - 语音管道 - `src/openhuman/voice/`（STT in、TTS out、幻觉过滤、后处理）。参见[原生语音](../native-tools/voice.zh-CN.md)。 - 作为出站摄像头的吉祥物画布 - `app/src/features/meet/MascotFrameProducer.tsx` 和 Tauri 端 `mascot_native_window.rs` 窗口。 -- 嵌入式 Meet webview - 参见 [Chromium Embedded Framework](../../developing/cef.md)。Meet 子 webview **零注入 JavaScript** 发货；所有 host 端通过 CDP 原生运行。 +- 嵌入式 Meet webview - 参见 [Chromium Embedded Framework](../../developing/cef.zh-CN.md)。与六个零注入提供商不同，Google Meet 使用 CDP 驱动 join 自动化：CDP 通过 `Page.addScriptToEvaluateOnNewDocument` 和 `Runtime.evaluate` 注入 bridging scripts / recipes（`GOOGLE_MEET_RECIPE_JS` / `provider_recipe_js("google-meet")`），而不是真正的零注入交付。 - 要阅读的上下文的重要 commit - `0bc74575`（实时记笔记）、`f1203479`（真实 LLM 轮次 + 调优 TTS）、`b6d05cb4`（吉祥物画布作为出站摄像头）、`f5dce783`（吉祥物帧流水线 + 屏外会议窗口）。 ## 另见 diff --git a/gitbooks/features/native-tools/browser-and-computer.zh-CN.md b/gitbooks/features/native-tools/browser-and-computer.zh-CN.md index 50cfe5238..43fb0d7c1 100644 --- a/gitbooks/features/native-tools/browser-and-computer.zh-CN.md +++ b/gitbooks/features/native-tools/browser-and-computer.zh-CN.md @@ -13,7 +13,7 @@ icon: display * **截图**当前页面。 * **检查**图像输出和元数据，以便智能体描述它看到的内容。 -浏览器界面通过 CEF（Chromium Embedded Framework）运行，并包含一个安全层，限制页面能做什么。参见 [Chromium Embedded Framework](../../developing/cef.md) 了解平台详情。 +浏览器界面通过 CEF（Chromium Embedded Framework）运行，并包含一个安全层，限制页面能做什么。参见 [Chromium Embedded Framework](../../developing/cef.zh-CN.md) 了解平台详情。 ## 计算机（鼠标 + 键盘） @@ -23,11 +23,11 @@ icon: display ## 适用于 -* 驱动没有 API 或没有[原生集成](../integrations/README.md)的网站。 +* 驱动没有 API 或没有[原生集成](../integrations/README.zh-CN.md)的网站。 * 单次截图不够的多步骤 UI 流程。 * 在聊天中自动化本地应用。 ## 另见 * [网页抓取](web-scraper.zh-CN.md) —— 当你只需要文章而非整个页面时。 -* [Chromium Embedded Framework](../../developing/cef.md) —— 运行时浏览器层。 +* [Chromium Embedded Framework](../../developing/cef.zh-CN.md) —— 运行时浏览器层。 diff --git a/gitbooks/features/obsidian-wiki/memory-tree.zh-CN.md b/gitbooks/features/obsidian-wiki/memory-tree.zh-CN.md index 7a59cf5e2..26f5a16aa 100644 --- a/gitbooks/features/obsidian-wiki/memory-tree.zh-CN.md +++ b/gitbooks/features/obsidian-wiki/memory-tree.zh-CN.md @@ -42,7 +42,7 @@ icon: tree 热路径（规范化 → 分块 → 快速评分 → 持久化 → 入队后续工作）很快。重型工作——向量生成、实体提取、密封摘要 bucket、每日摘要——在后台 workers 中运行，UI 永远不会阻塞。 -如果你开启了[本地 AI](../model-routing/local-ai.md)，嵌入向量和摘要树的构建可以在**设备上通过 Ollama** 运行；否则它们像其他模型调用一样通过 OpenHuman 后端处理。 +如果你开启了[本地 AI](../model-routing/local-ai.zh-CN.md)，嵌入向量和摘要树的构建可以在**设备上通过 Ollama** 运行；否则它们像其他模型调用一样通过 OpenHuman 后端处理。 ## 三棵树，三个作用域