release: bump version to 0.50.0

docs/technical/zh/manual.md

@@ -7,7 +7,7 @@
 - 控制台：登录后的管理后台
 - Docs：后端 Gatekeeper 受控的文档站，基础使用文档公开，开发/运维文档按权限组开放
 
-快速启动路径见 [快速开始](/home/ray/dev/linkong/planet/docs/technical/zh/quickstart.md)。
+快速启动路径见 [快速开始](/home/ray/dev/linkong/planet/docs/technical/zh/quickstart.md)。常见排障见 [常见问题](/home/ray/dev/linkong/planet/docs/technical/zh/faq.md)。
 
 ## 入口总览
 
@@ -17,6 +17,7 @@
 | --- | --- | --- | --- |
 | Earth | `http://localhost:3000/earth` | 否 | 3D 地球、图层、BGP、卫星、海缆、新闻态势 |
 | Docs | `http://localhost:3000/docs` | 部分需要 | 使用手册公开；开发、后端、运维文档按 Gatekeeper 权限组开放 |
+| FAQ | `http://localhost:3000/docs/faq` | 否 | Windows / WSL、端口、依赖、动捕、凭证和权限排障 |
 | 控制台 | `http://localhost:3000/admin` | 是 | 数据、配置、告警、日志和专题观测 |
 | AI Playground | `http://localhost:3000/playground` | 是 | AI Provider 状态和调试 |
 | 后端 API 文档 | `http://localhost:8000/docs` | 视接口而定 | FastAPI / OpenAPI 文档 |
@@ -311,7 +312,7 @@ Earth 搜索支持查找当前地球对象，例如：
 
 ### 位置候选采集
 
-算力中心和 BGP 观测站详情卡支持自动采集坐标候选。点击对象后，使用详情卡中的 `自动采集坐标候选` 或 `重新自动采集坐标` 按钮，后端会从源坐标、开放组织注册 API 和在线地理编码中整理候选位置。BGP 观测站的已存储位置只用于补齐查询上下文，不会作为候选直接返回。
+算力中心和 BGP 观测站详情卡支持自动采集坐标候选。点击对象后，使用详情卡中的 `自动采集坐标候选` 或 `重新自动采集坐标` 按钮，后端会从源坐标、开放组织注册 API 和在线地理编码中整理候选位置；这些常规来源没有候选时，会使用当前默认 AI Provider 做一次 LLM factcheck 兜底。BGP 观测站的已存储位置只用于补齐查询上下文，不会作为候选直接返回。
 
 候选可以直接在 Earth 上预览。算力中心候选点击 `保存` 后会写入 `compute_center_locations` 维表，并立即刷新图层。算力中心图层左上角的通知气泡显示无法渲染的待定位数量；点击后可查看列表，单条采集候选，或用 `一键采用` 从上到下保存最高置信候选。没有可用候选的记录会留在列表中，不会被国家中心点或硬编码 hint 伪造位置。详细流程见 [Earth 位置候选采集使用手册](/home/ray/dev/linkong/planet/docs/technical/zh/location-pipeline-user.md)。
 
@@ -319,11 +320,10 @@ Earth 搜索支持查找当前地球对象，例如：
 
 设置面板包含：
 
-- 旋转模式 / 巡航模式
-- 巡航模块：BGP、新闻
-- 卫星显示风格：自身发光、真实地表覆盖
-- 日夜模式
-- 面板显示开关
+- 旋转模式 / 巡航模式 / 动捕模式
+- 巡航模块：BGP、新闻、算力中心、船只、海缆、卫星
+- 视图设置：卫星显示风格、日夜模式、面板显示开关
+- 动捕调试模式、动捕输入源、只显示骨骼
 - 地球默认大小
 - 地形透明度
 - 重置设置
@@ -349,6 +349,30 @@ Earth 支持鼠标、触控板和触屏操作。
 
 拖动灵敏度会根据当前缩放自动调整。默认视角附近保持常规旋转速度；放大后拖动会逐步变细，适合检查某个区域、船只、卫星或 BGP 事件；缩小后拖动会略快，方便快速浏览全球态势。
 
+### 动作捕捉控制
+
+Earth 预留了动作捕捉控制入口，面向大屏和未来 3D 展示。实时链路有两种输入源：默认的 `浏览器摄像头` 会直接用网页 `getUserMedia` 在本机浏览器识别；高级的 `Motion Agent` 会走 `摄像头/RTSP/HTTP -> 本地 Agent -> 本地 WebSocket -> Earth 页面`。两种模式都不会把摄像头帧或实时手势发到云端，也不会复用新闻/RSS 聚合接口。
+
+默认不自动启用。打开设置里的 `动捕调试模式`，或用 `?motion=1` 打开 Earth 动捕连接后，系统会启动当前选择的输入源。输入源默认是 `浏览器摄像头`，无需安装应用，但页面必须运行在 HTTPS 或 localhost，且用户需要允许浏览器摄像头权限。需要双摄、USB index、手机/网络摄像头流或客户端/边缘设备时，可在设置中切到 `Motion Agent`。默认 Agent 地址是 `ws://127.0.0.1:8765/ws/gestures`，也可用 URL 参数 `motionAgent` 覆盖。
+
+URL 参数也可以直接指定输入源：`?motion=1&motionProvider=browser` 使用浏览器摄像头；`?motion=1&motionProvider=agent` 使用 Motion Agent；传入 `motionAgent=ws://...` 时会自动选择 Motion Agent。
+
+当前手势语义：
+
+| 手势事件 | 作用 |
+| --- | --- |
+| `rotate_left` | 地球向左旋转 |
+| `rotate_right` | 地球向右旋转 |
+| `rotate_up` | 地球向上旋转 |
+| `rotate_down` | 地球向下旋转 |
+| `zoom_in` | 放大视角 |
+| `zoom_out` | 缩小视角 |
+| `focus_prev` / `focus_next` | 在当前动捕图层内切换可交互目标 |
+| `layer_prev` / `layer_next` | 切换动捕候选图层，并巡航到新图层最近目标 |
+| `confirm` | 确认当前已选目标；当前浏览器识别暂未启用双手上举确认 |
+
+设置面板中的 `动捕调试模式` 会打开调试面板。浏览器摄像头输入源会在面板内显示本机实时预览，并在其上绘制关节点和连线；`Motion Agent` 输入源只发送归一化骨架事件，不发送原始视频帧。面板里的 `只显示骨骼` 会隐藏视频预览、只保留深色背景和骨架；`停止匹配动作` 会暂停手势触发，但摄像头预览和骨架绘制仍可继续用于调试。未匹配动作时骨架为红色，匹配后变绿并显示当前动作名称。该入口和 `动捕输入源` 控件都已预留 Gatekeeper 权限标记，后续可接入鉴权控制。
+
 ### 巡航模式
 
 巡航模式会让 Earth 自动轮播聚焦目标。
@@ -357,6 +381,10 @@ Earth 支持鼠标、触控板和触屏操作。
 
 - BGP
 - 新闻
+- 算力中心
+- 船只
+- 海缆
+- 卫星
 
 适合演示、监控大屏或无人值守展示。