release: bump version to 0.66.2

2026-05-26 08:45:33 +08:00
parent 887fec972e
commit eb4c4b7904
46 changed files with 250 additions and 235 deletions
--- a/docs/technical/zh/manual.md
+++ b/docs/technical/zh/manual.md
@@ -1,15 +1,15 @@
-# Planet 使用手册
+# 智能星球使用手册

-这份手册面向 Planet 的最终用户。从打开浏览器开始，覆盖注册账号、登录、配置数据采集器、配置 AI、使用 Earth 和控制台、阅读文档站。所有操作都在浏览器里完成。
+这份手册面向智能星球的最终用户。从打开浏览器开始，覆盖注册账号、登录、配置数据采集器、配置 AI、使用智能星球和控制台、阅读文档站。所有操作都在浏览器里完成。

-如果你是负责部署或值班的运维，请改读 [Planet 运维手册](/home/ray/dev/linkong/planet/docs/technical/zh/ops-runbook.md)，里面是 shell 命令、日志位置、SMTP 兜底创建用户等内容。
+如果你是负责部署或值班的运维，请改读 [智能星球运维手册](/home/ray/dev/linkong/planet/docs/technical/zh/ops-runbook.md)，里面是 shell 命令、日志位置、SMTP 兜底创建用户等内容。

 ## 入口总览

 | 名称 | 地址 | 是否需要登录 | 说明 |
 | --- | --- | --- | --- |
-| Earth | `http://<域名>/earth` | 否 | 公开 3D 地球态势页面 |
-| Docs | `http://<域名>/docs` | 部分需要 | 公共文档免登录，开发/运维文档按 Gatekeeper 权限组开放 |
+| 智能星球 | `http://<域名>/earth` | 否 | 公开 3D 态势页面 |
+| 文档 | `http://<域名>/docs` | 部分需要 | 公共文档免登录，开发/运维文档按 Gatekeeper 权限组开放 |
 | 注册 / 登录 / 找回密码 | `/register`、`/login`、`/forgot-password` | 否 | 自助开通和恢复账号 |
 | 控制台 | `http://<域名>/admin` | 是 | 数据、采集器、告警、AI、用户、设置 |
 | AI | `http://<域名>/ai` | 是 | 模型供应商、工具和测试台 |
@@ -68,7 +68,7 @@
 | 页面 | 路由 | 用途 |
 | --- | --- | --- |
 | 仪表盘 | `/admin` | 系统概览 |
-| Earth | `/earth` | 跳到公开 Earth 页面 |
+| 智能星球 | `/earth` | 跳到公开智能星球页面 |
 | 数据源 | `/datasources` | 数据源目录、触发采集 |
 | 采集数据 | `/data` | 已落库的数据 |
 | BGP 观测 | `/bgp` | BGP 专题观测 |
@@ -76,7 +76,7 @@
 | BGP 告警 | `/alerts/bgp` | BGP 相关告警 |
 | 态势告警 | `/alerts/situational` | 态势研判告警 |
 | AI | `/ai` | 模型供应商、工具、测试台 |
-| Earth 内容 | `/earth-content` | 电视直播、国界精度、底图和图层资源入口 |
+| 智能星球内容 | `/earth-content` | 电视直播、国界精度、底图和图层资源入口 |
 | 采集管理 | `/collection-management` | 采集器、采集调度、采集历史入口 |
 | 系统日志 | `/logs` | 通常仅 super admin 可见 |
 | 用户管理 | `/users` | 创建/删除/改角色/调权限组 |
@@ -186,19 +186,19 @@ Base URL 输入框尾端的插头图标会触发连接测试。测试通过会

 电视直播和国界精度已经移到 `/earth-content`，采集器和采集调度已经移到 `/collection-management`，AI Provider / WebSearch / OCR 在 `/ai`。

-### Earth 内容
+### 智能星球内容

-`/earth-content` 位于控制台“运维与配置”下，面向 Earth 前端体验资源：
+`/earth-content` 位于控制台“运维与配置”下，面向智能星球前端体验资源：

- **品牌资源**：维护 Earth HUD 使用的 logo、标题图、标题文本、副标题和描述；上传的图片会保存为 Earth 品牌资产并立即供 Earth 页面读取。
- **关于**：维护 Earth 设置面板里的关于卡片，包括 logo、眉标、标题、版本、描述和元信息。
- **电视直播**：维护 Earth 媒体面板里的直播源。
+- **品牌资源**：维护智能星球 HUD 使用的 logo、标题图、标题文本、副标题和描述；上传的图片会保存为智能星球品牌资产并立即供智能星球页面读取。
+- **关于**：维护智能星球设置面板里的关于卡片，包括 logo、眉标、标题、版本、描述和元信息。
+- **电视直播**：维护智能星球媒体面板里的直播源。
 - **国界精度**：查看当前国界 provider、低精 fallback、高精 PMTiles/manifest 状态，编辑本机源配置并手动构建。
 - **地球底图**、**图层资源**、**三维素材**、**新闻锚点策略**：目前是待接入占位页，不展示假数据。

-Earth 页面工具栏齿轮中也有“国界精度”。切到“高精”时，如果本机尚未构建高精资产，会像游戏更新包一样启动后台下载/构建并显示百分比；构建成功后自动应用，无需刷新。切回“低精”只切换本机显示偏好，不重新下载。
+智能星球页面工具栏齿轮中也有“国界精度”。切到“高精”时，如果本机尚未构建高精资产，会像游戏更新包一样启动后台下载/构建并显示百分比；构建成功后自动应用，无需刷新。切回“低精”只切换本机显示偏好，不重新下载。

-如果后端判断 Earth 尚未初始化，首次进入 `/earth` 会出现毛玻璃引导，提示登录控制台并采集数据。这个判断来自后端真实数据状态；如果系统已经有已采集数据，清空浏览器缓存也不会重新弹出。
+如果后端判断智能星球尚未初始化，首次进入 `/earth` 会出现毛玻璃引导，提示登录控制台并采集数据。这个判断来自后端真实数据状态；如果系统已经有已采集数据，清空浏览器缓存也不会重新弹出。

 ### 采集管理

@@ -229,7 +229,7 @@ Earth 页面工具栏齿轮中也有“国界精度”。切到“高精”时
 - 查看用户列表（用户名、邮箱、角色、是否激活、邮箱是否已验证）
 - 创建用户：与公开注册等价，但跳过邮箱验证（管理员认账）
 - 修改角色：`viewer` / `operator` / `admin` / `super_admin`
- 调整 Gatekeeper 权限组：`docs_user` / `docs_developer` / `docs_admin`，影响 Docs 站可见文档范围
+- 调整 Gatekeeper 权限组：`docs_user` / `docs_developer` / `docs_admin`，影响文档站可见文档范围
 - 禁用 / 启用账号

 要让普通用户能看开发或运维文档，进 `/users` 给他加 `docs_developer` 或 `docs_admin`。
@@ -238,7 +238,7 @@ Earth 页面工具栏齿轮中也有“国界精度”。切到“高精”时

 - `/datasources`：数据源目录。`内置源` 支持按产品域、层级、启用状态、最近执行状态、是否已有采集数据和关键词筛选；未勾选时主按钮显示“触发全部”，勾选多行后会变成“触发已选 N”，并只提交所选数据源。右上角队列按钮空态显示队列图标，有任务时显示纯圆环总进度；点击后打开队列浮层，按运行中、完成、失败和跳过分组，失败项可重试，完成项可跳到详情。`实时源` 面向 AISStream / WebSocket 长连接，展示连接健康、累计入库、时间窗统计和启动 / 停止 / 重连操作。接口、凭证、请求头的编辑统一在 `/collection-management` 的"采集器"。
 - `/data`：采集后数据表，适合排查"数据是否已经进入系统"、"更新时间是否符合预期"、"某个数据源是否产出有效记录"
- `/bgp`：BGP 专题页面，列表 + 详情 + 研判，与 Earth 的 BGP 图层互补
+- `/bgp`：BGP 专题页面，列表 + 详情 + 研判，与智能星球的 BGP 图层互补
 - `/alerts/system`、`/alerts/bgp`、`/alerts/situational`：系统、BGP、态势告警

 ## AI 测试台
@@ -251,9 +251,9 @@ Earth 页面工具栏齿轮中也有“国界精度”。切到“高精”时

 旧链接 `/playground` 会跳到这里。

-## Earth 公开页面
+## 智能星球公开页面

-Earth `http://localhost:3000/earth` 是公开 3D 态势页面，不需要登录。React 路由中的 `/earth` 用 iframe 承载独立前端（位于 `frontend/public/earth/`）。
+智能星球 `http://localhost:3000/earth` 是公开 3D 态势页面，不需要登录。React 路由中的 `/earth` 用 iframe 承载独立前端（位于 `frontend/public/earth/`）。

 ### 主要用途

@@ -283,14 +283,14 @@ AIS 船只图例按船型显示颜色：货轮、油轮、客船、渔船、军

 算力中心和 BGP 观测站详情卡支持自动采集坐标候选。点击对象后用"自动采集坐标候选"或"重新自动采集坐标"按钮，后端会从源坐标、开放组织注册 API 和在线地理编码中整理候选；常规来源没有候选时使用当前默认 AI Provider 做 LLM factcheck 兜底。BGP 观测站的已存储位置只用于补齐查询上下文，不会作为候选直接返回。

-候选可以直接在 Earth 预览。算力中心候选点击"保存"后写入 `compute_center_locations` 维表并刷新图层。算力中心图层左上角的通知气泡显示无法渲染的待定位数量；点击查看列表，单条采集候选，或用"一键采用"从上到下保存最高置信候选。没有可用候选的记录会留在列表中，不会被国家中心点或硬编码 hint 伪造位置。
+候选可以直接在智能星球预览。算力中心候选点击"保存"后写入 `compute_center_locations` 维表并刷新图层。算力中心图层左上角的通知气泡显示无法渲染的待定位数量；点击查看列表，单条采集候选，或用"一键采用"从上到下保存最高置信候选。没有可用候选的记录会留在列表中，不会被国家中心点或硬编码 hint 伪造位置。

 单个对象的推荐流程：

 1. 打开算力中心或 BGP 观测站详情卡。
 2. 点击"自动采集坐标候选"。
 3. 等待候选列表返回；有 WebSearch / AI factcheck 依赖的候选会显示采集中状态。
-4. 在 Earth 上预览候选位置。
+4. 在智能星球上预览候选位置。
 5. 确认可用候选后点击"保存"；不确定时关闭卡片不会丢失当前任务状态。

 一键定位用于批量处理算力中心待定位队列。它会从列表顶部开始采用最高置信候选；仍没有事实依据的记录会保留在队列中。未开启 WebSearch 时，单个定位和一键定位会置灰，因为位置核验依赖事实查询。
@@ -324,12 +324,12 @@ AIS 船只图例按船型显示颜色：货轮、油轮、客船、渔船、军

 ### 动作捕捉控制

-Earth 预留了动作捕捉控制入口。实时链路两种输入源：
+智能星球预留了动作捕捉控制入口。实时链路两种输入源：

 - **浏览器摄像头**（默认）：直接用网页 `getUserMedia` 在本机浏览器识别；无需安装应用，但页面必须运行在 HTTPS 或 localhost，且需允许浏览器摄像头权限
- **Motion Agent**：摄像头/RTSP/HTTP → 本地 Agent → 本地 WebSocket → Earth 页面；用于双摄、USB index、手机/网络摄像头流
+- **Motion Agent**：摄像头/RTSP/HTTP → 本地 Agent → 本地 WebSocket → 智能星球页面；用于双摄、USB index、手机/网络摄像头流

-打开方式：设置中开启"动捕调试模式"，或加 URL 参数 `?motion=1` 打开 Earth 动捕连接。Motion Agent 默认地址 `ws://127.0.0.1:8765/ws/gestures`，可用 `motionAgent` URL 参数覆盖。也可以直接 `?motion=1&motionProvider=browser` 或 `?motion=1&motionProvider=agent`。
+打开方式：设置中开启"动捕调试模式"，或加 URL 参数 `?motion=1` 打开智能星球动捕连接。Motion Agent 默认地址 `ws://127.0.0.1:8765/ws/gestures`，可用 `motionAgent` URL 参数覆盖。也可以直接 `?motion=1&motionProvider=browser` 或 `?motion=1&motionProvider=agent`。

 两种模式都不会把摄像头帧或实时手势发到云端，也不会复用新闻/RSS 聚合接口。

@@ -347,7 +347,7 @@ Earth 预留了动作捕捉控制入口。实时链路两种输入源：

 ### 巡航模式

-巡航模式让 Earth 自动轮播聚焦目标。当前巡航模块：BGP、新闻、算力中心、船只、海缆、卫星。适合演示、监控大屏或无人值守。
+巡航模式让智能星球自动轮播聚焦目标。当前巡航模块：BGP、新闻、算力中心、船只、海缆、卫星。适合演示、监控大屏或无人值守。

 ### 移动端

@@ -355,27 +355,27 @@ Earth 预留了动作捕捉控制入口。实时链路两种输入源：

 ### 常见问题

- **Earth 打不开**：先确认前端服务是否在线；如果端口不是 `3000`，使用启动输出的实际端口
+- **智能星球打不开**：先确认前端服务是否在线；如果端口不是 `3000`，使用启动输出的实际端口
 - **图层没有数据**：进 `/datasources` 看数据源状态、是否已采集和最近执行结果，再到 `/data` 或 `/bgp` 看是否有记录
 - **卫星 / BGP / 海缆加载慢**：这些图层依赖后端接口和外部数据源，首次加载需要等启动任务完成
 - **卫星看起来不在同一层**：这是默认的真实高度压缩显示。想回到旧版同层球面，可在设置中关闭“真实卫星高度”

-## Docs 文档站
+## 文档站

 文档站 `http://localhost:3000/docs` 由后端按权限读取，不再把全部 Markdown 直接打进前端构建产物。

 未登录访客默认只能看到 `public` 文档：首页、快速开始、使用手册、常见问题。登录用户被分配 Gatekeeper 权限组后可以看到更多技术文档：

 - `docs_user`：用户操作类文档
- `docs_developer`：Earth、前端、后端、采集器和 AI Provider 等开发文档
+- `docs_developer`：智能星球、前端、后端、采集器和 AI Provider 等开发文档
 - `docs_admin`：服务控制、运维、环境变量和敏感操作文档（包括运维手册）

-`admin` 默认拥有 `docs_admin`，`super_admin` 拥有全部 Docs 权限。Gatekeeper 权限组在"用户管理"中配置。
+`admin` 默认拥有 `docs_admin`，`super_admin` 拥有全部文档权限。Gatekeeper 权限组在"用户管理"中配置。

-Docs 支持分类导航、Markdown 渲染、表格和代码块、文档内目录、对当前可见文档搜索、technical 文档间内部链接跳转。
+文档站支持分类导航、Markdown 渲染、表格和代码块、文档内目录、对当前可见文档搜索、technical 文档间内部链接跳转。

 ## 相关文档

 - [快速开始](/home/ray/dev/linkong/planet/docs/technical/zh/quickstart.md)
 - [常见问题](/home/ray/dev/linkong/planet/docs/technical/zh/faq.md)
- [Planet 运维手册](/home/ray/dev/linkong/planet/docs/technical/zh/ops-runbook.md)
+- [智能星球运维手册](/home/ray/dev/linkong/planet/docs/technical/zh/ops-runbook.md)