Files

Josh Palmer 5676a6b38d Docs: normalize zh-CN terminology + tone

What: switch to 你/你的 tone; standardize Skills/Gateway网关/local loopback/私信 wording
Why: align zh-CN docs with issue 6995 feedback + idiomatic tech style
Tests: pnpm docs:build

2026-02-02 16:38:25 +01:00

3.7 KiB

Raw Blame History

read_when, summary, title, x-i18n

read_when

summary

title

x-i18n

添加位置节点支持或权限界面

设计后台位置 + 推送流程

节点的位置命令（location.get）、权限模式和后台行为

位置命令

generated_at	model	provider	source_hash	source_path	workflow
2026-02-01T21:18:11Z	claude-opus-4-5	pi	23124096256384d2b28157352b072309c61c970a20e009aac5ce4a8250dc3764	nodes/location-command.md	15

位置命令（节点）

简要说明

location.get 是一个节点命令（通过 node.invoke）。
默认关闭。
设置使用选择器：关闭 / 使用时 / 始终。
单独的开关：精确位置。

为什么用选择器（而不是简单开关）

操作系统权限是多级的。我们可以在应用内提供选择器，但实际授权由操作系统决定。

iOS/macOS：用户可以在系统提示/设置中选择使用时或始终。应用可以请求升级，但操作系统可能要求进入设置。
Android：后台位置是独立的权限；在 Android 10+ 上通常需要进入设置流程。
精确位置是独立的授权（iOS 14+ "精确"，Android "精确" vs "粗略"）。

界面中的选择器驱动我们请求的模式；实际授权存储在操作系统设置中。

设置模型

每个节点设备：

location.enabledMode：off | whileUsing | always
location.preciseEnabled：bool

界面行为：

选择 whileUsing 请求前台权限。
选择 always 首先确保 whileUsing，然后请求后台权限（如果需要则引导用户进入设置）。
如果操作系统拒绝请求的级别，则回退到已授予的最高级别并显示状态。

权限映射（node.permissions）

可选。macOS 节点通过权限映射报告 location；iOS/Android 可能省略。

命令：`location.get`

通过 node.invoke 调用。

参数（建议）：

{
  "timeoutMs": 10000,
  "maxAgeMs": 15000,
  "desiredAccuracy": "coarse|balanced|precise"
}

响应载荷：

{
  "lat": 48.20849,
  "lon": 16.37208,
  "accuracyMeters": 12.5,
  "altitudeMeters": 182.0,
  "speedMps": 0.0,
  "headingDeg": 270.0,
  "timestamp": "2026-01-03T12:34:56.000Z",
  "isPrecise": true,
  "source": "gps|wifi|cell|unknown"
}

错误（稳定错误码）：

LOCATION_DISABLED：选择器为关闭状态。
LOCATION_PERMISSION_REQUIRED：缺少请求模式所需的权限。
LOCATION_BACKGROUND_UNAVAILABLE：应用在后台运行但仅允许"使用时"。
LOCATION_TIMEOUT：未在规定时间内获取定位。
LOCATION_UNAVAILABLE：系统故障 / 无可用提供者。

后台行为（未来）

目标：即使节点在后台，模型也能请求位置，但仅在以下条件满足时：

用户选择了始终。
操作系统授予了后台位置权限。
应用被允许在后台运行位置服务（iOS 后台模式 / Android 前台服务或特殊许可）。

推送触发流程（未来）：

Gateway网关向节点发送推送（静默推送或 FCM 数据）。
节点短暂唤醒并向设备请求位置。
节点将载荷转发给 Gateway网关。

注意事项：

iOS：需要"始终"权限 + 后台位置模式。静默推送可能被限流；预期会有间歇性失败。
Android：后台位置可能需要前台服务；否则预期会被拒绝。

模型/工具集成

工具接口：nodes 工具添加 location_get 操作（需要节点）。
CLI：openclaw nodes location get --node <id>。
智能体指南：仅在用户启用位置并了解范围时调用。

界面文案（建议）

关闭："位置共享已禁用。"
使用时："仅在 OpenClaw 打开时共享。"
始终："允许后台定位。需要系统权限。"
精确："使用精确 GPS 定位。关闭后将共享大致位置。"

3.7 KiB Raw Blame History Unescape Escape