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
@@ -1,11 +1,11 @@
---
read_when:
- 添加位置节点支持或权限界面
- 添加位置节点支持或权限 UI
- 设计后台位置 + 推送流程
summary: 节点的位置命令(location.get)、权限模式和后台行为
title: 位置命令
x-i18n:
generated_at: "2026-02-01T21:18:11Z"
generated_at: "2026-02-03T07:50:59Z"
model: claude-opus-4-5
provider: pi
source_hash: 23124096256384d2b28157352b072309c61c970a20e009aac5ce4a8250dc3764
@@ -15,22 +15,22 @@ x-i18n:
# 位置命令(节点)
## 简要说明
## 简要概述
- `location.get` 是一个节点命令(通过 `node.invoke`)。
- 默认关闭。
- 设置使用选择器:关闭 / 使用时 / 始终。
- 单独的开关:精确位置。
## 为什么用选择器(而不是简单开关)
## 为什么用选择器(而不是开关)
操作系统权限是多级的。我们可以在应用内提供选择器,但实际授权由操作系统决定
操作系统权限是多级的。我们可以在应用内暴露选择器,但操作系统仍然决定实际授权。
- iOS/macOS:用户可以在系统提示/设置中选择**使用时**或**始终**。应用可以请求升级,但操作系统可能要求进入设置。
- Android:后台位置是独的权限;在 Android 10+ 上通常需要进入设置流程。
- 精确位置是独的授权(iOS 14+ "精确"Android "精" vs "粗略")。
- Android:后台位置是独的权限;在 Android 10+ 上通常需要进入设置流程。
- 精确位置是独的授权(iOS 14+ "精确"Android "精" vs "粗略")。
界面中的选择器驱动我们请求的模式;实际授权存在操作系统设置中。
UI 中的选择器驱动我们请求的模式;实际授权存在操作系统设置中。
## 设置模型
@@ -39,15 +39,15 @@ x-i18n:
- `location.enabledMode``off | whileUsing | always`
- `location.preciseEnabled`bool
界面行为:
UI 行为:
- 选择 `whileUsing` 请求前台权限。
- 选择 `always` 首先确保 `whileUsing`,然后请求后台权限(如果需要则引导用户进入设置)。
- 如果操作系统拒绝请求的级别,回退到已授予的最高级别并显示状态。
- 选择 `always` 首先确保 `whileUsing`,然后请求后台(或在需要时将用户引导到设置)。
- 如果操作系统拒绝请求的级别,回退到已授予的最高级别并显示状态。
## 权限映射(node.permissions
可选。macOS 节点通过权限映射报告 `location`iOS/Android 可能省略。
可选。macOS 节点通过权限映射报告 `location`iOS/Android 可能省略
## 命令:`location.get`
@@ -63,7 +63,7 @@ x-i18n:
}
```
响应载
响应载:
```json
{
@@ -79,42 +79,42 @@ x-i18n:
}
```
错误(稳定错误码):
错误(稳定码):
- `LOCATION_DISABLED`:选择器关闭状态
- `LOCATION_PERMISSION_REQUIRED`:缺少请求模式所需的权限。
- `LOCATION_BACKGROUND_UNAVAILABLE`:应用在后台运行但仅允许"使用时"
- `LOCATION_TIMEOUT`未在规定时间内获取定位。
- `LOCATION_UNAVAILABLE`:系统故障 / 无可用提供
- `LOCATION_DISABLED`:选择器关闭。
- `LOCATION_PERMISSION_REQUIRED`:缺少请求模式的权限。
- `LOCATION_BACKGROUND_UNAVAILABLE`:应用在后台但只允许使用时。
- `LOCATION_TIMEOUT`时间内没有定位。
- `LOCATION_UNAVAILABLE`:系统故障/没有提供
## 后台行为(未来)
目标:即使节点在后台,模型也能请求位置,但仅在以下条件满足时
目标:模型可以在节点处于后台时请求位置,但仅当
- 用户选择了**始终**。
- 操作系统授予后台位置权限。
- 应用被允许在后台运行位置服务iOS 后台模式 / Android 前台服务或特殊许可)。
- 操作系统授予后台位置权限。
- 应用被允许在后台运行以获取位置(iOS 后台模式/Android 前台服务或特殊许可)。
推送触发流程(未来):
1. Gateway网关向节点发送推送(静默推送或 FCM 数据)。
2. 节点短暂唤醒并设备请求位置。
3. 节点将载转发给 Gateway网关。
1. Gateway 网关向节点发送推送(静默推送或 FCM 数据)。
2. 节点短暂唤醒并设备请求位置。
3. 节点将载转发给 Gateway 网关。
注意事项
说明
- iOS:需要"始终"权限 + 后台位置模式。静默推送可能被限流;预期会有间歇性失败。
- iOS:需要始终权限 + 后台位置模式。静默推送可能被限流;预期会有间歇性失败。
- Android:后台位置可能需要前台服务;否则预期会被拒绝。
## 模型/工具集成
- 工具接口:`nodes` 工具添加 `location_get` 操作(需要节点)。
- CLI`openclaw nodes location get --node <id>`
- 智能体指南:仅在用户启用位置并解范围时调用。
- 智能体指南:仅在用户启用位置并解范围时调用。
## 界面文案(建议)
## UX 文案(建议)
- 关闭:"位置共享已禁用。"
- 使用时:"仅 OpenClaw 打开时共享。"
- 始终:"允许后台位。需要系统权限。"
- 精确:"使用精确 GPS 位。关闭后将共享大致位置。"
- 使用时:"仅 OpenClaw 打开时。"
- 始终:"允许后台位。需要系统权限。"
- 精确:"使用精确 GPS 位。关闭共享大致位置。"