release: bump version to 0.72.0

docs/technical/zh/datasource-collector-settings-connectivity.md

@@ -8,7 +8,7 @@
   - 展示所有数据源，包括内置和自定义。
   - 点击名称只打开信息抽屉。
   - 负责查看状态、触发采集和查看采集中任务。
-- `/collection-management?tab=collector_credentials`
+- `/collection-management?section=collector_credentials`
   - 显示为“采集器”。
   - 负责 endpoint、请求头、基础参数和凭证配置。
   - 所有采集器都提供连接按钮，用于健康检查。

docs/technical/zh/frontend-admin-frontend-context.md

@@ -274,17 +274,16 @@ Admin 的状态标签统一走 [StatusText](/home/ray/dev/linkong/planet/fronten
 
 职责：
 
-- `/ai` 独立承载 LLM Provider、AI Tool 配置和测试台，不再放在 `/settings` 的系统配置 tabs 中
-- `模型供应商` tab 管理默认 provider、模型、base URL、provider key、本地 `aiprovider` 代理和连接测试；provider 和模型输入使用可输入组合框，models.dev 目录停更时用户仍可手动填新 provider/model
-- `工具` tab 先通过下拉菜单选择工具，再管理对应配置；当前包含 WebSearch 和 OCR
+- `/ai` 独立承载 LLM Provider、AI Tool 配置和 Playground，不再放在 `/settings` 的系统配置分区中
+- `模型供应商` 分区管理默认 provider、模型、base URL、provider key、本地 `aiprovider` 代理和连接测试；provider 和模型输入使用可输入组合框，models.dev 目录停更时用户仍可手动填新 provider/model
+- `工具调用` 分区先通过下拉菜单选择工具，再管理对应配置；当前包含 WebSearch 和 OCR
 - WebSearch 配置包含 provider、搜索 key、base URL、超时、结果数和高级 provider 参数
 - OCR 配置包含 provider、Base URL、API Key、模型/engine、语言、超时、文件大小上限和输出格式
-- `测试台` tab 嵌入原 Playground 的真实会话、预设请求和 AI Provider 状态调试
-- 页面复用 Settings 的单屏 tabs、panel card 和内部滚动样式
+- `Playground` 分区嵌入原 Playground 的真实会话、预设请求和 AI Provider 状态调试
+- 页面复用 Settings 的单屏分区、panel card 和内部滚动样式
 - AI Provider / WebSearch 的连接测试使用 `ConnectionTestInput`，连接器图标固定在 Base URL 输入框末端；WebSearch 未启用时，除开关外的配置项和测试入口都置灰
 
-旧的 `/settings?tab=ai` 应跳转到 `/ai?tab=providers`。
-旧的 `/playground` 应跳转到 `/ai?tab=playground`。
+AI 配置不再挂在 `/settings` 下；`/playground` 应跳转到 `/ai?section=playground`。
 
 ### 3. 业务数据网关
 
@@ -342,7 +341,7 @@ Admin 的状态标签统一走 [StatusText](/home/ray/dev/linkong/planet/fronten
 - endpoint、headers、config 只展示，不在这里编辑。
 - 需要凭证的采集器提示用户到“采集管理 -> 采集器”维护。
 
-这个边界很重要：后续不要把自定义数据源编辑、内置 endpoint 覆盖或凭证表单再塞回 `/datasources`。这些配置入口统一放在 `/collection-management?tab=collector_credentials`。
+这个边界很重要：后续不要把自定义数据源编辑、内置 endpoint 覆盖或凭证表单再塞回 `/datasources`。这些配置入口统一放在 `/collection-management?section=collector_credentials`。
 
 页面顶部的总进度区域新增 `采集中 N` 标签：
 
@@ -355,7 +354,7 @@ Admin 的状态标签统一走 [StatusText](/home/ray/dev/linkong/planet/fronten
 
 ### 采集器设置页
 
-[Settings.tsx](/home/ray/dev/linkong/planet/frontend/src/admin/pages/PlainResourcePages.tsx) 会按路由进入三种模式：`/settings` 是系统设置，`/earth-content` 是智能星球内容，`/collection-management` 是采集管理。`collector_credentials` tab 当前在 `/collection-management` 下显示为“采集器”。
+[Settings.tsx](/home/ray/dev/linkong/planet/frontend/src/admin/pages/PlainResourcePages.tsx) 会按路由进入三种模式：`/settings` 是系统设置，`/earth-content` 是智能星球内容，`/collection-management` 是采集管理。`collector_credentials` section 当前在 `/collection-management` 下显示为“采集器”。
 
 `/settings` 的“系统显示”分区包含 `演示模式` 开关。开启后，智能星球的 OOBE 会忽略“已有当前采集数据”和本地“先浏览”临时跳过状态，直接展示初始化引导；该开关仅用于演示/验收流程，不改变数据源、采集队列或智能星球内容资源配置。
 
@@ -368,7 +367,7 @@ Admin 的状态标签统一走 [StatusText](/home/ray/dev/linkong/planet/fronten
 - 不需要凭证的采集器只显示基础配置：endpoint、默认 endpoint、请求头、timeout、retry。
 - `BarentsWatch AIS` 使用专用凭证表单。
 
-连接图标使用内联 `PlugConnectIcon`，视觉语义来自 Tabler `plug-connected`。后续如果控制台重写图标体系，应迁移到 Tabler Icons，而不是继续使用 Ant Design 刷新图标表达连接。
+连接测试入口使用现有 `Button icon="test"` 图标语义。后续如果控制台重写图标体系，应迁移到现有 lucide / Tactile UI 图标体系，而不是用普通刷新图标表达连接。
 
 `Client Secret` 的表单语义：
 
@@ -421,6 +420,7 @@ Admin 的状态标签统一走 [StatusText](/home/ray/dev/linkong/planet/fronten
 4. 不要用 `overflow: hidden` 掩盖结构问题
 5. 不要为了摘要卡完整显示去压缩主工作区
 6. 自定义滚动条必须是浮层，不得挤压内容宽度
+7. Admin shell 依赖 root `height: 100%` 高度链，不在根工作区重新写精确 `100vh`
 
 详细经验见：
 

docs/technical/zh/frontend-layout-guidelines.md

@@ -210,6 +210,10 @@
 3. 真正滚动节点是否明确 `overflow: auto`
 4. 中间包装层是否偷偷改了布局语义
 
+当前 Admin 和 Docs 根 shell 依赖 `html` / `body` / `#root` 的 `height: 100%`
+链路。不要在这些嵌入式工作区根容器上重新写精确 `100vh` / `100vw`；
+弹窗、浮层和窄屏安全边界可以继续使用 `calc(100vh - ...)` 作为最大尺寸约束。
+
 ### 5. UI 状态和显示状态不同步
 
 Earth 相关改动里反复出现：

docs/technical/zh/manual.md

@@ -22,7 +22,7 @@
 1. 打开 `http://localhost:3000/login`，点击表单下方"注册账户"。
 2. 在 `/register` 填写：
    - **用户名**：3–50 位字符，登录时使用
-   - **邮箱**：用于接收验证码，可在账户设置中修改
+   - **邮箱**：用于接收验证码；当前版本如需修改邮箱，请联系管理员在用户管理中维护
    - **密码**：至少 8 位
 3. 提交后会跳到验证页，已将 6 位验证码发到你的邮箱。10 分钟内有效。
 4. 输入验证码，点击"验证并登录"。验证通过后系统会自动写入登录态并跳到控制台。
@@ -52,23 +52,23 @@
 3. 收到验证码后，在下一步填入验证码 + 新密码（至少 8 位），点击"重置密码"。
 4. 系统会跳回 `/login`，用新密码登录即可。
 
-## 账户设置
+## 账户区与退出
 
-控制台右上角点击你的用户名进入账户设置，可以：
+控制台左侧底部的账户区会显示当前用户名、版本号和主题切换。当前版本还没有登录后的自助账户设置页：
 
-- 修改密码：输入当前密码 + 新密码
-- 修改邮箱：输入新邮箱后系统会发验证码到新地址，验证通过后才生效
-- 查看权限组：列出你目前拥有的 Gatekeeper 权限组（`docs_user` / `docs_developer` / `docs_admin`）
-- 登出：清除当前会话
+- 忘记密码或需要重置密码时，使用 `/forgot-password` 邮件验证码流程
+- 邮箱、角色和 Gatekeeper 权限组由管理员在 `/users` 维护
+- 点击账户区的退出图标会清除当前会话并返回登录页
 
 ## 控制台总览
 
-控制台 `http://localhost:3000/admin` 使用 React + Ant Design，左侧菜单按工作域组织。
+控制台 `http://localhost:3000/admin` 使用 React + Tactile UI / Radix 基础组件和 lucide 图标，左侧菜单按工作域组织。
 
 | 页面 | 路由 | 用途 |
 | --- | --- | --- |
 | 仪表盘 | `/admin` | 系统概览 |
 | 智能星球 | `/earth` | 跳到公开智能星球页面 |
+| 文档 | `/docs` | 打开文档站并按 Gatekeeper 权限查看可见文档 |
 | 数据源 | `/datasources` | 数据源目录、触发采集 |
 | 采集数据 | `/data` | 已落库的数据 |
 | BGP 观测 | `/bgp` | BGP 专题观测 |
@@ -86,7 +86,7 @@
 
 ## 配置数据采集器
 
-`/collection-management?tab=collector_credentials` 是"采集器"页。这里统一维护所有采集器的连接配置，不仅是凭证。旧链接 `/settings?tab=collector_credentials` 会自动跳转到这个入口；数据源目录仍保留在 `/datasources`。
+`/collection-management?section=collector_credentials` 是"采集器"页。这里统一维护所有采集器的连接配置，不仅是凭证；数据源目录仍保留在 `/datasources`。
 
 操作步骤：
 
@@ -130,7 +130,7 @@
 
 操作步骤：
 
-1. `/collection-management?tab=collector_credentials` 选择 `AISStream 实时船舶 : aisstream_vessels`
+1. `/collection-management?section=collector_credentials` 选择 `AISStream 实时船舶 : aisstream_vessels`
 2. 在 `AISStream 凭证` 填入 API Key
 3. Endpoint 保持默认 `wss://stream.aisstream.io/v0/stream`
 4. 点击插头图标进行连接测试，确认显示 `可用`
@@ -144,11 +144,12 @@
 
 ## 配置 AI 凭证
 
-`/ai?tab=providers` 是 AI 模型管理入口。包含三个核心子 tab：
+`/ai?section=integrations` 是 AI 模型管理入口。主要分区包括：
 
 - `模型供应商`：默认 LLM provider、模型、Base URL、API Key、本地 `aiprovider` 代理和连接测试
-- `工具`：通过下拉菜单选择具体工具，当前支持 WebSearch 和 OCR
+- `工具调用`：通过下拉菜单选择具体工具，当前支持 WebSearch 和 OCR
 - `提示词`：通过功能入口下拉菜单选择新闻汉化、告警研判、BGP 简报等 LLM 任务，手动调整提示词或重置为缺省
+- `Playground`：真实会话、预设请求和 AI Provider 状态调试
 
 ### 模型供应商
 
@@ -173,7 +174,7 @@ Base URL 输入框尾端的插头图标会触发连接测试。测试通过会
 
 选择功能入口后，页面会显示当前提示词、是否已自定义、缺省版本和重置按钮。保存只影响该功能入口；重置会恢复当前发布包中的缺省提示词。业务事实、上下文和输出 schema 仍由后端按功能入口自动传入。
 
-旧链接 `/settings?tab=ai` 会跳到 `/ai?tab=providers`。
+旧的 AI 配置入口不再放在系统设置里；`/playground` 会跳到 `/ai?section=playground`。
 
 ## 系统设置
 
@@ -244,7 +245,7 @@ Base URL 输入框尾端的插头图标会触发连接测试。测试通过会
 
 ## AI 测试台
 
-`/ai?tab=playground` 用于真实分析链路调试。可以：
+`/ai?section=playground` 用于真实分析链路调试。可以：
 
 - 选择当前 provider
 - 用预设请求或自定义 prompt 触发分析

docs/technical/zh/quickstart.md

@@ -32,8 +32,8 @@
 
 进入 `/admin` 仪表盘后，建议按这个顺序熟悉控制台：
 
-1. `/collection-management?tab=collector_credentials`：选一个采集器，点插头图标做连接测试。免费 collector（开源 BGP 等）通常直接可用；像 `AISStream`、`BarentsWatch` 这类需要凭证的，需要先填 API Key/Client Secret
-2. `/ai?tab=providers`：填一个 LLM provider（例如 `minimax` / `openai`）、模型名、Base URL、API Key，点 Base URL 末端的插头测试连接。WebSearch / OCR 工具可选
+1. `/collection-management?section=collector_credentials`：选一个采集器，点插头图标做连接测试。免费 collector（开源 BGP 等）通常直接可用；像 `AISStream`、`BarentsWatch` 这类需要凭证的，需要先填 API Key/Client Secret
+2. `/ai?section=integrations`：填一个 LLM provider（例如 `minimax` / `openai`）、模型名、Base URL、API Key，点 Base URL 末端的插头测试连接。WebSearch / OCR 工具可选
 3. `/datasources` 或 `/data`：看采集器是否已经产出数据。有限采集器看 `/datasources -> 内置源`，不勾选时点“触发全部”，勾选后主按钮会变成“触发已选 N”；右上角队列按钮可查看进度。AISStream / WebSocket 长连接看 `/datasources -> 实时源` 的健康状态和计数
 4. `/alerts/system`：看系统告警是否正常
 5. `/users`（仅 `super_admin`）：根据需要给同事开账号或调权限组