mirror of
https://github.com/tinyhumansai/openhuman.git
synced 2026-07-27 21:08:00 +00:00
0f439fe1e1
## Summary - 添加第二批核心功能模块的中文翻译(8 个文件):隐私与安全、第三方集成、吉祥物、模型路由、编码器、语音、定时任务、系统与工具 - 修复批次 A 遗留的 12 处未本地化内部链接(因第二批新增目标 `.zh-CN` 文件,之前保留的英文链接现在可指向中文版) - 修复第二批翻译中的 12 处质量问题:错别字、过直译、中英混杂、指向不存在的 `.zh-CN` 链接 - 修复隐私与安全文档中指向 `local-ai.zh-CN.md` 和 `triggers.zh-CN.md` 等尚未翻译文件的错误链接 - 统一 mascot、integrations 等跨模块链接指向,确保中文读者在 zh-CN 文档间流转 - 所有修改仅涉及 `.md` 文档,无代码变更 ## Problem - OpenHuman 中文用户阅读英文文档存在语言障碍 - 第一批汉化(overview + lightweight features)完成后,核心功能模块(integrations、model-routing、native-tools 等)仍无中文版 - 批次 A 的部分链接因目标文件当时未翻译而保留英文版,随着第二批新增 zh-CN 文件,这些链接已过时 ## Solution - 基于英文原文逐文件翻译,遵循术语统一表(vault→存储库、Agent→智能体、LLM/Token 保留英文等) - 翻译完成后运行审计脚本扫描,修复所有未本地化链接、MD040 代码块标识、术语一致性问题 - 对于目标 `.zh-CN.md` 不存在的链接(如 triggers、subconscious、local-ai、agent-coordination),保持指向英文原文,在 Related 中标记后续批次覆盖计划 ## Submission Checklist - [x] I have read the Codex PR Checklist - [x] I have confirmed Type Check passes (`pnpm typecheck`) (N/A: Markdown docs only) - [x] I have confirmed the app builds locally (`pnpm build`) (N/A: Markdown docs only) - [x] I have added tests for this change (N/A: i18n docs do not affect testable logic) - [x] I have updated documentation (N/A: this PR is documentation-only) - [x] I have confirmed no feature flags are required (N/A: no code changes) - [x] I have confirmed Prettier passes (`pnpm format:check`) (N/A: Markdown docs only) ## Impact - Runtime/platform impact: None - Performance/security/migration/compatibility: None ## Related - Follow-up PR(s)/TODOs: - Batch C: subconscious.zh-CN.md, triggers.zh-CN.md, local-ai.zh-CN.md, agent-coordination.zh-CN.md - Batch C: memory-tools.zh-CN.md, meeting-agents.zh-CN.md, developing/cef.zh-CN.md --- ## AI Authored PR Metadata ### Linear Issue - Key: N/A - URL: N/A ### Commit & Branch - Branch: `docs/i18n-batch-b-core-features` - Commit SHA: see PR commits ### Validation Run - [x] `pnpm --filter openhuman-app format:check` — N/A: no code changed - [x] `pnpm typecheck` — N/A: no code changed - [x] Focused tests: N/A - [x] Rust fmt/check: N/A - [x] Tauri fmt/check: N/A ### Validation Blocked - N/A ### Behavior Changes - Intended behavior change: None - User-visible effect: Chinese users can now read core feature docs in zh-CN ### Parity Contract - Legacy behavior preserved: N/A - Guard/fallback/dispatch parity checks: N/A ### Duplicate / Superseded PR Handling - N/A <!-- This is an auto-generated comment: release notes by coderabbit.ai --> ## Summary by CodeRabbit * **Localization** * Updated Simplified Chinese UI strings for vault operations and MCP server/settings. * **Documentation** * Added extensive Chinese documentation covering integrations, mascot/meeting agents, model routing, native tools (voice, web search/scraper, coder, cron, system/tools), memory tree, obsidian wiki, token compression, platform, privacy/security, and subconscious/agent coordination. * **Chores** * Updated ignore rules to exclude AI assistant progress tracking. * Added documentation maintenance and validation scripts. <!-- review_stack_entry_start --> [](https://app.coderabbit.ai/change-stack/tinyhumansai/openhuman/pull/2450?utm_source=github_walkthrough&utm_medium=github&utm_campaign=change_stack) <!-- review_stack_entry_end --> <!-- end of auto-generated comment: release notes by coderabbit.ai --> Co-authored-by: agent:skill-master <skill-master@openclaw> Co-authored-by: Steven Enamakel <enamakel@tinyhumans.ai>
8.0 KiB
8.0 KiB
description, icon
| description | icon |
|---|---|
| 后台循环,评估用户/系统任务相对于工作区的状态, 并决定做什么。 | loader |
潜意识循环
一个后台任务评估和执行系统。在每个周期 tick 上,它加载用户定义和系统任务列表,读取你工作区的当前状态,决定对每项做什么,然后要么自主行动,要么升级给你审批。
把它想象成智能体的空闲线程:你停止打字后仍在继续思考的部分。
一个 tick 如何工作
┌─────────────────────────────────────────────────────────┐
│ Heartbeat │
│ (tick 之间睡眠几分钟) │
└──────────────────────┬──────────────────────────────────┘
│
▼
┌─────────────────────────────────────────────────────────┐
│ Subconscious Engine │
│ │
│ 1. 加载到期任务 │
│ 2. 将每项标记为进行中 │
│ 3. 构建情况报告(记忆 + 工作区) │
│ 4. 用本地模型评估每个任务 │
│ 5. 执行决定(act / noop / escalate) │
│ 6. 将结果写回活动日志 │
└─────────────────────────────────────────────────────────┘
│
┌───────────┼───────────┐
▼ ▼ ▼
noop act escalate
(skip) (execute) (deeper agent)
每个 tick 是独立的。如果一个 tick 在下一个开始时仍在运行(慢速模型调用、网络抖动),新的 tick 接管,旧的在进行中的条目被标记为已取消。Tick 永远不会堆叠。
任务类型
系统任务
引擎启动时自动播种。不能删除,只能禁用。默认覆盖你希望任何助手监视的事情:
- 检查已连接技能的错误或断开
- 审查新记忆更新中的可操作项目
- 监控系统健康(本地模型、记忆、连接)
你可以通过在 workspace 的 HEARTBEAT.md 文件中列出额外的系统任务来扩展,每行一个任务。
用户任务
你从 UI 手动添加的任何内容。切换开/关、编辑、删除。例如:
- "检查紧急邮件"(只读)
- "发送每日摘要到 Slack"(写意图)
- "总结 Notion 更新"(只读)
决策
对于每个到期任务,本地模型返回三个决策之一:
| 决策 | 含义 |
|---|---|
| Skip | 现在没什么相关的 |
| Act | 发现了相关的东西,执行任务 |
| Escalate | 需要更深入的推理,交给云端智能体 |
决定如何执行取决于任务是否有写意图(它要求智能体执行一个操作)还是只读(它要求智能体查看和报告):
Decision: Skip
→ 记录"没什么新东西",调度下一次运行
Decision: Act
→ 在本地模型上执行(读或写)
Decision: Escalate
├─ 写意图任务
│ → 用完整权限运行云端智能体
│ → 不需要批准(你明确要求了该操作)
│
└─ 只读任务
→ 用仅分析模式运行云端智能体
→ 如果智能体浮出未经请求的推荐操作
│ → 为你审批创建升级卡片
│ → 批准后 → 用完整权限重新运行
└─ 否则 → 记录结果,完成
每个任务评估都带着彩色点和简短状态落在活动日志中:
| 状态 | 颜色 | 文本 |
|---|---|---|
| 进行中 | 蓝色(脉冲) | "评估中…" |
| 已行动 | 绿色 | 结果文本 |
| 已跳过 | 灰色 | "没什么新东西" |
| 等待批准 | 琥珀色 | "等待批准" |
| 失败 | 珊瑚色 | 错误消息 |
| 已取消 | 灰色 | "已取消" |
| 已忽略 | 灰色 | "已跳过" |
两个模型,一个循环
| 阶段 | 运行位置 | 为什么 |
|---|---|---|
| 每个任务评估(每个 tick) | 本地模型(Ollama) | 免费,无速率限制,适合端侧 |
| 仅文本执行(摘要、检查) | 本地模型 | 相同 |
| 工具使用执行(发送、发布…) | 云端智能体 | 工具、更大上下文、速率限制重试 |
| 升级读取的分析模式 | 云端智能体(只读) | 本地模型 defer 时更深入的推理 |
这种分割保持了循环便宜:只有当任务真正需要时你才为云端调用付费。
审批门
只有当智能体想要采取你没有明确要求的写操作时才需要审批。
| 任务意图 | 智能体想要写 | 需要审批? |
|---|---|---|
| "发送摘要到 Slack"(写) | 是 | 否,你要求的 |
| "检查紧急邮件"(读) | 否 | 否,只读结果 |
| "检查紧急邮件"(读) | 是(转发它们) | 是,未经请求的写 |
审批流程:
- 云端智能体以仅分析模式运行。
- 它浮出一个推荐,例如 "将 3 封紧急邮件转发到 #team-alerts。"
- 升级卡片出现在 UI 的需要审批下。
- 继续用完整权限重新运行。
- 跳过什么都不做。
与技能相关的升级(断开的集成、过期的 OAuth、缺失的范围)显示一个在技能中修复按钮,直接带你到技能页面而不是。
失败处理
失败计数器跟踪连续 tick 全评估步骤失败(本地模型宕机、网络断开)。任何成功 tick 将其重置为零,并在 UI 状态栏中以珊瑚色显示(当非零时)。
每任务失败不会触发此计数器,tick 本身仍被认为成功。
如果一个 tick 失败或被取消,引擎不会推进其"上次看到"时间戳,所以下一次成功 tick 覆盖相同的窗口。你工作区中的任何内容都不会被跳过。
配置
循环可在桌面 app 中配置:
- 启用 / 禁用。 打开或关闭整个后台循环。
- Tick 间隔。 tick 触发的频率。默认为 5 分钟;这也是最小值。
- 推理。 本地模型是否在每个 tick 评估任务。如果你想仅通过手动立即运行按钮运行,则禁用。
- 上下文预算。 情况报告一次可以传入多少工作区。默认值是合理的;为更丰富的上下文调高,为更紧密的成本调低。
在 UI 中
位于智能 → 潜意识。
- 状态栏。 任务数、总 tick 数、上次 tick 时间、失败计数器(如果有)。
- 进行中的任务。 系统任务(只读,带"默认"badge)和你自己的任务(切换 + 删除)。
- 需要审批。 待处理升级的琥珀色卡片。每张有标题、描述和优先级。按钮:继续、在技能中修复(当相关时)、或跳过。
- 活动日志。 每个任务评估的按时间顺序的 feed,彩色点 + 结果。当任何内容进行中时自动刷新。
- 立即运行。 手动触发一个 tick。立即返回;UI 轮询结果。