Docs: add zh-CN translations

docs/zh-CN/platforms/ios.md

@@ -0,0 +1,114 @@
+---
+read_when:
+  - 配对或重新连接 iOS 节点
+  - 从源码运行 iOS 应用
+  - 调试 Gateway 发现或画布命令
+summary: iOS 节点应用：连接 Gateway、配对、画布及故障排除
+title: iOS 应用
+x-i18n:
+  generated_at: "2026-02-01T21:32:23Z"
+  model: claude-opus-4-5
+  provider: pi
+  source_hash: 692eebdc82e4bb8dc221bcbabf6a344a861a839fc377f1aeeb6eecaa4917a232
+  source_path: platforms/ios.md
+  workflow: 15
+---
+
+# iOS 应用（节点）
+
+可用性：内部预览。iOS 应用尚未公开分发。
+
+## 功能说明
+
+- 通过 WebSocket 连接到 Gateway（局域网或 tailnet）。
+- 暴露节点能力：画布、屏幕快照、摄像头捕获、位置、对话模式、语音唤醒。
+- 接收 `node.invoke` 命令并上报节点状态事件。
+
+## 要求
+
+- Gateway 运行在另一台设备上（macOS、Linux 或通过 WSL2 的 Windows）。
+- 网络路径：
+  - 通过 Bonjour 的同一局域网，**或**
+  - 通过单播 DNS-SD 的 Tailnet（示例域名：`openclaw.internal.`），**或**
+  - 手动输入主机/端口（备用方案）。
+
+## 快速开始（配对 + 连接）
+
+1. 启动 Gateway：
+
+```bash
+openclaw gateway --port 18789
+```
+
+2. 在 iOS 应用中，打开设置并选择已发现的 Gateway（或启用手动主机并输入主机/端口）。
+
+3. 在 Gateway 主机上批准配对请求：
+
+```bash
+openclaw nodes pending
+openclaw nodes approve <requestId>
+```
+
+4. 验证连接：
+
+```bash
+openclaw nodes status
+openclaw gateway call node.list --params "{}"
+```
+
+## 发现路径
+
+### Bonjour（局域网）
+
+Gateway 在 `local.` 上广播 `_openclaw-gw._tcp`。iOS 应用会自动列出这些服务。
+
+### Tailnet（跨网络）
+
+如果 mDNS 被阻止，请使用单播 DNS-SD 区域（选择一个域名；示例：`openclaw.internal.`）和 Tailscale 分割 DNS。
+参阅 [Bonjour](/gateway/bonjour) 了解 CoreDNS 配置示例。
+
+### 手动主机/端口
+
+在设置中，启用**手动主机**并输入 Gateway 主机 + 端口（默认 `18789`）。
+
+## 画布 + A2UI
+
+iOS 节点渲染一个 WKWebView 画布。使用 `node.invoke` 来驱动它：
+
+```bash
+openclaw nodes invoke --node "iOS Node" --command canvas.navigate --params '{"url":"http://<gateway-host>:18793/__openclaw__/canvas/"}'
+```
+
+注意事项：
+
+- Gateway 画布主机提供 `/__openclaw__/canvas/` 和 `/__openclaw__/a2ui/` 服务。
+- iOS 节点在连接时如果画布主机 URL 已广播，会自动导航到 A2UI。
+- 使用 `canvas.navigate` 和 `{"url":""}` 返回内置脚手架页面。
+
+### 画布执行 / 快照
+
+```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\"; })()"}'
+```
+
+```bash
+openclaw nodes invoke --node "iOS Node" --command canvas.snapshot --params '{"maxWidth":900,"format":"jpeg"}'
+```
+
+## 语音唤醒 + 对话模式
+
+- 语音唤醒和对话模式可在设置中配置。
+- iOS 可能会挂起后台音频；当应用不在前台时，请将语音功能视为尽力而为。
+
+## 常见错误
+
+- `NODE_BACKGROUND_UNAVAILABLE`：将 iOS 应用切换到前台（画布/摄像头/屏幕命令需要前台运行）。
+- `A2UI_HOST_NOT_CONFIGURED`：Gateway 未广播画布主机 URL；请检查 [Gateway 配置](/gateway/configuration) 中的 `canvasHost`。
+- 配对提示始终未出现：运行 `openclaw nodes pending` 并手动批准。
+- 重新安装后重连失败：钥匙串中的配对令牌已被清除；请重新配对节点。
+
+## 相关文档
+
+- [配对](/gateway/pairing)
+- [发现](/gateway/discovery)
+- [Bonjour](/gateway/bonjour)