Docs: update zh-CN translations and pipeline

What:
- update zh-CN glossary, TM, and translator prompt
- regenerate zh-CN docs and apply targeted fixes
- add zh-CN AGENTS pipeline guidance

Why:
- address terminology/spacing feedback from #6995

Tests:
- pnpm build && pnpm check && pnpm test
This commit is contained in:
Josh Palmer
2026-02-03 13:23:00 -08:00
parent 9f03791aa9
commit a3ec2d0734
228 changed files with 10651 additions and 10475 deletions
+32 -32
View File
@@ -2,11 +2,11 @@
read_when:
- 配对或重新连接 iOS 节点
- 从源码运行 iOS 应用
- 调试 Gateway网关发现或画布命令
summary: iOS 节点应用:连接 Gateway网关、配对、画布及故障排除
- 调试 Gateway 网关发现或 canvas 命令
summary: iOS 节点应用:连接 Gateway 网关、配对、canvas 和故障排除
title: iOS 应用
x-i18n:
generated_at: "2026-02-01T21:32:23Z"
generated_at: "2026-02-03T07:52:17Z"
model: claude-opus-4-5
provider: pi
source_hash: 692eebdc82e4bb8dc221bcbabf6a344a861a839fc377f1aeeb6eecaa4917a232
@@ -18,31 +18,31 @@ x-i18n:
可用性:内部预览。iOS 应用尚未公开分发。
## 功能说明
## 功能
- 通过 WebSocket 连接到 Gateway网关(局域网或 tailnet
- 暴露节点能力:画布、屏幕快照、摄像头捕获、位置、对话模式、语音唤醒。
- 接收 `node.invoke` 命令并报节点状态事件。
- 通过 WebSocketLAN 或 tailnet连接到 Gateway 网关。
- 暴露节点能力:Canvas、屏幕快照、相机捕获、位置、对话模式、语音唤醒。
- 接收 `node.invoke` 命令并报节点状态事件。
## 要求
- Gateway网关运行在另一台设备上(macOS、Linux 或通过 WSL2 的 Windows)。
- Gateway 网关运行在另一台设备上(macOS、Linux 或通过 WSL2 的 Windows)。
- 网络路径:
- 通过 Bonjour 的同一局域网**或**
- 通过单播 DNS-SD 的 Tailnet(示例域`openclaw.internal.`),**或**
- 手动输入主机/端口(备用方案)。
- 通过 Bonjour 的同一 LAN**或**
- 通过单播 DNS-SD 的 Tailnet(示例域:`openclaw.internal.`),**或**
- 手动主机/端口(备)。
## 快速开始(配对 + 连接)
1. 启动 Gateway网关:
1. 启动 Gateway 网关:
```bash
openclaw gateway --port 18789
```
2. 在 iOS 应用中,打开设置并选择已发现的 Gateway网关(或启用手动主机并输入主机/端口)。
2. 在 iOS 应用中,打开设置并选择一个已发现的 Gateway 网关(或启用手动主机并输入主机/端口)。
3. 在 Gateway网关主机上批准配对请求:
3. 在 Gateway 网关主机上批准配对请求:
```bash
openclaw nodes pending
@@ -58,22 +58,22 @@ openclaw gateway call node.list --params "{}"
## 发现路径
### Bonjour局域网
### BonjourLAN
Gateway网关在 `local.` 上广播 `_openclaw-gw._tcp`。iOS 应用会自动列出这些服务
Gateway 网关在 `local.` 上广播 `_openclaw-gw._tcp`。iOS 应用会自动列出这些。
### Tailnet(跨网络)
如果 mDNS 被阻止,使用单播 DNS-SD 区域(选择一个域;示例:`openclaw.internal.`)和 Tailscale 分割 DNS。
[Bonjour](/gateway/bonjour) 了解 CoreDNS 配置示例。
如果 mDNS 被阻止,使用单播 DNS-SD 区域(选择一个域;示例:`openclaw.internal.`)和 Tailscale 分割 DNS。
[Bonjour](/gateway/bonjour) 了解 CoreDNS 示例。
### 手动主机/端口
在设置中,启用**手动主机**并输入 Gateway网关主机 + 端口(默认 `18789`)。
在设置中,启用**手动主机**并输入 Gateway 网关主机 + 端口(默认 `18789`)。
## 画布 + A2UI
## Canvas + A2UI
iOS 节点渲染一个 WKWebView 画布。使用 `node.invoke` 来驱动它:
iOS 节点渲染一个 WKWebView canvas。使用 `node.invoke` 来驱动它:
```bash
openclaw nodes invoke --node "iOS Node" --command canvas.navigate --params '{"url":"http://<gateway-host>:18793/__openclaw__/canvas/"}'
@@ -81,11 +81,11 @@ openclaw nodes invoke --node "iOS Node" --command canvas.navigate --params '{"ur
注意事项:
- Gateway网关画布主机提供 `/__openclaw__/canvas/``/__openclaw__/a2ui/` 服务
- iOS 节点在连接时如果画布主机 URL 已广播,会自动导航到 A2UI。
- 使用 `canvas.navigate``{"url":""}` 返回内置脚手架页面
- Gateway 网关 canvas 主机服务于 `/__openclaw__/canvas/``/__openclaw__/a2ui/`
- 当广播了 canvas 主机 URL 时,iOS 节点在连接时自动导航到 A2UI。
- 使用 `canvas.navigate``{"url":""}` 返回内置脚手架。
### 画布执行 / 快照
### Canvas eval / snapshot
```bash
openclaw nodes invoke --node "iOS Node" --command canvas.eval --params '{"javaScript":"(() => { const {ctx} = window.__openclaw; ctx.clearRect(0,0,innerWidth,innerHeight); ctx.lineWidth=6; ctx.strokeStyle=\"#ff2d55\"; ctx.beginPath(); ctx.moveTo(40,40); ctx.lineTo(innerWidth-40, innerHeight-40); ctx.stroke(); return \"ok\"; })()"}'
@@ -97,18 +97,18 @@ openclaw nodes invoke --node "iOS Node" --command canvas.snapshot --params '{"ma
## 语音唤醒 + 对话模式
- 语音唤醒和对话模式在设置中配置
- iOS 可能会挂起后台音频;当应用不在前台时,将语音功能视为尽力而为。
- 语音唤醒和对话模式在设置中可用
- iOS 可能会暂停后台音频;当应用不活跃时,将语音功能视为尽力而为。
## 常见错误
- `NODE_BACKGROUND_UNAVAILABLE`:将 iOS 应用切换到前台(画布/摄像头/屏幕命令需要前台运行)。
- `A2UI_HOST_NOT_CONFIGURED`Gateway网关未广播画布主机 URL检查 [Gateway网关配置](/gateway/configuration) 中的 `canvasHost`
- 配对提示始终未出现:运行 `openclaw nodes pending` 并手动批准。
- 重新安装后重连失败:钥匙串中的配对令牌已被清除;重新配对节点。
- `NODE_BACKGROUND_UNAVAILABLE`:将 iOS 应用到前台(canvas/相机/屏幕命令需要)。
- `A2UI_HOST_NOT_CONFIGURED`Gateway 网关未广播 canvas 主机 URL;检查 [Gateway 网关配置](/gateway/configuration) 中的 `canvasHost`
- 配对提示未出现:运行 `openclaw nodes pending` 并手动批准。
- 重新安装后重连失败:钥匙串配对令牌已被清除;重新配对节点。
## 相关文档
- [配对](/gateway/pairing)
- [发现](/gateway/discovery)
- [设备发现](/gateway/discovery)
- [Bonjour](/gateway/bonjour)