release: bump version to 0.66.0

2026-05-26 03:41:47 +08:00
parent e65267fe21
commit 5bf5c73ca0
173 changed files with 8669 additions and 13210 deletions
--- a/docs/technical/zh/frontend-admin-frontend-context.md
+++ b/docs/technical/zh/frontend-admin-frontend-context.md
@@ -4,7 +4,7 @@

 相关规则建议一起参考：

- [项目规则](/home/ray/dev/linkong/planet/rules.md)
+- 仓库根目录 `rules.md`
 - [前端布局指南](/home/ray/dev/linkong/planet/docs/technical/zh/frontend-layout-guidelines.md)

 ## 当前目标
@@ -22,7 +22,7 @@

 - [App.tsx](/home/ray/dev/linkong/planet/frontend/src/App.tsx)

-当前正式后台路由已经由 Admin Next 接管：
+当前正式后台路由已经由 Admin 接管：

 - `/admin`
 - `/users`
@@ -37,23 +37,7 @@
 - `/collection-management`
 - `/settings`

-这些路径渲染 [AdminNextRoutes.tsx](/home/ray/dev/linkong/planet/frontend/src/admin-next/AdminNextRoutes.tsx)，页面清单和菜单元信息来自 [manifest.tsx](/home/ray/dev/linkong/planet/frontend/src/admin-next/routes/manifest.tsx)。`/admin-next/*` 仅作为兼容入口存在，会重定向到上面的正式路径，不再作为并行主入口。
-
-旧 AntD 控制台保留在 `/legacy/admin/*`，用于对照和回退：
-
- `/legacy/admin`
- `/legacy/admin/datasources`
- `/legacy/admin/data`
- `/legacy/admin/collection-management`
- `/legacy/admin/earth-content`
- `/legacy/admin/ai`
- `/legacy/admin/logs`
- `/legacy/admin/settings`
- `/legacy/admin/users`
- `/legacy/admin/bgp`
- `/legacy/admin/alerts/*`
-
-旧页面、`AppLayout`、`antd` 和 `@ant-design/icons` 在 legacy 验收期继续保留。不要在新版 parity 验收前删除这些文件或依赖。
+这些路径渲染 [AdminRoutes.tsx](/home/ray/dev/linkong/planet/frontend/src/admin/AdminRoutes.tsx)，页面清单和菜单元信息来自 [manifest.tsx](/home/ray/dev/linkong/planet/frontend/src/admin/routes/manifest.tsx)。Admin 是唯一后台控制台入口，不再维护并行控制台或回退路由。

 `/earth` 是独立展示页，不属于控制台骨架。

@@ -61,7 +45,7 @@

 正式后台公共壳层在：

- [AdminNextLayout.tsx](/home/ray/dev/linkong/planet/frontend/src/admin-next/components/layout/AdminNextLayout.tsx)
+- [AdminLayout.tsx](/home/ray/dev/linkong/planet/frontend/src/admin/components/layout/AdminLayout.tsx)

 职责：

@@ -69,38 +53,13 @@
 - 当前账号、版本、退出登录和主题切换
 - 顶部搜索、面包屑和页面快捷入口
 - 内容区单屏高度闭合
- Admin Next 内部滚动、表格、详情面板和移动端详情视图协调
+- Admin 内部滚动、表格、详情面板和移动端详情视图协调

-旧 AntD legacy 壳层仍在：
+后续正式控制台页面应适配 `AdminLayout` 和 Admin 页面模式；不要重新引入并行后台壳层。

- [AppLayout.tsx](/home/ray/dev/linkong/planet/frontend/src/components/AppLayout/AppLayout.tsx)
+## Admin 分区加载策略

-legacy 职责：
-
- 左侧导航
- 折叠与展开
- 当前账号/版本信息
- 内容区高度闭合
- 全站统一侧边栏滚动条
-
-当前结构是：
-
-```tsx
-<Layout className="dashboard-layout">
-  <Sider className="dashboard-sider">...</Sider>
-  <Layout>
-    <Content className="dashboard-content">
-      <div className="dashboard-content-inner">{children}</div>
-    </Content>
-  </Layout>
-</Layout>
-```
-
-后续正式控制台页面应优先适配 `AdminNextLayout` 和 Admin Next 页面模式，而不是继续往旧 `AppLayout` 增加新能力。只有维护 `/legacy/admin/*` 时才应修改旧壳层。
-
-## Admin Next 分区加载策略
-
-多 tab 页面由 [PlainResourcePages.tsx](/home/ray/dev/linkong/planet/frontend/src/admin-next/pages/PlainResourcePages.tsx) 统一承载当前的管理型和信息型工作台。分区加载规则是：
+多 tab 页面由 [PlainResourcePages.tsx](/home/ray/dev/linkong/planet/frontend/src/admin/pages/PlainResourcePages.tsx) 统一承载当前的管理型和信息型工作台。分区加载规则是：

 - 初次进入页面只请求当前 active tab，不预先拉取所有 tab 的接口。
 - 用户切换 tab 时懒加载该 tab；已经加载过的 tab 保留在本地 `states` 缓存中，切回时直接复用。
@@ -112,20 +71,22 @@ legacy 职责：

 ## 数据源采集队列

-Admin Next 的数据源页把单源触发、表格勾选触发和触发全部统一接入浏览器下载列表式采集队列：
+Admin 的数据源页把单源触发、表格勾选触发和触发全部统一接入浏览器下载列表式采集队列：

- 队列状态由 [PlainResourcePages.tsx](/home/ray/dev/linkong/planet/frontend/src/admin-next/pages/PlainResourcePages.tsx) 管理，只保存当前会话中的可见任务，不用 `localStorage` 伪造历史。
+- 队列状态由 [PlainResourcePages.tsx](/home/ray/dev/linkong/planet/frontend/src/admin/pages/PlainResourcePages.tsx) 管理，只保存当前会话中的可见任务，不用 `localStorage` 伪造历史。
 - 任务进度优先消费 `/ws` 的 `datasource_tasks` channel；如果 WebSocket 未连接或没有及时返回，则轮询 `/api/v1/datasources/{id}/task-status`。
 - 触发接口返回的 `triggered`、`skipped`、`failed` 会立即进入队列；刷新页面后只根据后端当前仍在 `running/pending/queued` 的数据源恢复队列。
 - `内置源` 分区通过表格选择列收敛批量触发。没有勾选时主按钮是“触发全部”；勾选后同一个主按钮变成“触发已选 N”，不再提供手填 ID 的独立批量按钮。
 - 页面内容流不再承载展开队列，避免全量触发后挤压列表和详情面板。右上角 actions 区的队列按钮沿用现有 `Button` 样式；空态使用 `ListChecks` 图标，有任务时只显示纯圆环总进度。点击后打开浮层，按运行中、失败、完成、跳过分组。
 - 队列项可以跳转到对应数据源详情，失败项可以重试。详情页内的“采集任务”摘要只展示当前数据源最近任务，不承担保存配置职责。
+- 运行中的单源采集按钮显示为“停止采集”；队列中未完成项右侧提供取消按钮。取消调用 `/api/v1/datasources/{source_id}/tasks/{task_id}/cancel`，后端语义是保留已提交批次并回滚未完成批次。
+- 删除数据库数据和清理展示缓存也会进入同一队列，前端只展示任务状态，不假定接口同步完成。

 这个队列是用户感知层，不替代后端调度状态。后端仍然是任务是否运行、完成、失败或跳过的唯一事实来源。

-## Admin Next 主题滑块
+## Admin 主题滑块

-Admin Next 侧栏底部主题切换继续复用共享 [SegmentedControl.tsx](/home/ray/dev/linkong/planet/frontend/src/components/SegmentedControl/SegmentedControl.tsx)，但主题变量在 [styles.css](/home/ray/dev/linkong/planet/frontend/src/admin-next/styles.css) 内跟随 `data-theme` 覆盖：
+Admin 侧栏底部主题切换继续复用共享 [SegmentedControl.tsx](/home/ray/dev/linkong/planet/frontend/src/components/SegmentedControl/SegmentedControl.tsx)，但主题变量在 [styles.css](/home/ray/dev/linkong/planet/frontend/src/admin/styles.css) 内跟随 `data-theme` 覆盖：

 - light 下使用 `--d-segment-bg: #eef3f9`、白色 slider 和轻投影。
 - dark 下使用与 Docs 一致的深色底座、`#202938` slider 和深色外投影。
@@ -164,8 +125,7 @@ Admin Next 侧栏底部主题切换继续复用共享 [SegmentedControl.tsx](/ho

 当前使用场景：

- Admin Next 数据源、采集数据、采集管理、日志、告警和 BGP 页面
- 旧 AntD legacy 页面通过兼容封装继续使用共享滚动能力
+- Admin 数据源、采集数据、采集管理、日志、告警和 BGP 页面

 ### 3. `TableScrollRegion`

@@ -188,7 +148,7 @@ Admin Next 侧栏底部主题切换继续复用共享 [SegmentedControl.tsx](/ho

 用途：

- Admin Next 全局工具按钮和详情页工具按钮
+- Admin 全局工具按钮和详情页工具按钮
 - icon-only + tooltip 的普通操作
 - 保存、创建、确认、删除、停止等强意图操作
 - 与 Docs 主题滑块一致的紧凑开关
@@ -246,39 +206,19 @@ Admin Next 侧栏底部主题切换继续复用共享 [SegmentedControl.tsx](/ho
 - 文档内部链接应通过 `transformLink` 转成 `/docs/:slug`
 - 标题锚点由 `getHeadingId` 注入，避免渲染器自己理解路由状态

-### 7. `ConnectionTestInput`
+### 7. Admin UI primitives

 文件：

- [ConnectionTestInput.tsx](/home/ray/dev/linkong/planet/frontend/src/components/ConnectionTestInput/ConnectionTestInput.tsx)
+- [button.tsx](/home/ray/dev/linkong/planet/frontend/src/admin/components/ui/button.tsx)
+- [dialog.tsx](/home/ray/dev/linkong/planet/frontend/src/admin/components/ui/dialog.tsx)
+- [switch.tsx](/home/ray/dev/linkong/planet/frontend/src/admin/components/ui/switch.tsx)

 用途：

- Endpoint、Base URL 这类“输入值 + 连接验证”的控制台表单项
- AI Provider 和 WebSearch 的连接测试入口
- 后续采集器配置如果把连接测试放进输入框，也应复用它
-
-当前约束：
-
- 输入框末端只显示一个插头/连接器图标，不再并排放“测试连接”文字按钮
- 禁用的集成能力必须同时置灰输入框和连接测试按钮
- 组件只负责输入框与测试入口组合，不保存业务状态；调用方仍负责表单值、loading、disabled 和连接请求
-
-### 8. `TableActions`
-
-文件：
-
- [TableActions.tsx](/home/ray/dev/linkong/planet/frontend/src/components/TableActions/TableActions.tsx)
-
-用途：
-
- 表格操作列的统一操作入口
- 展开状态下直接展示按钮
- 收起状态下用更多菜单承载操作
-
-配套导出：
-
- `actionCellProps`：用于操作列 `onCell`，防止操作按钮被省略号截断或换行
+- 全局工具按钮、详情页动作、确认弹窗和二元设置。
+- 与 Tactile UI token 对齐，保持 Admin 内部控件尺寸、hover、disabled 和 dark mode 一致。
+- 表格行内动作优先使用 icon button + tooltip/title，不重新引入独立操作菜单组件。

 ## 当前状态来源

@@ -301,7 +241,7 @@ Admin Next 侧栏底部主题切换继续复用共享 [SegmentedControl.tsx](/ho

 文件：

- [AISettings.tsx](/home/ray/dev/linkong/planet/frontend/src/pages/AISettings/AISettings.tsx)
+- [AISettings.tsx](/home/ray/dev/linkong/planet/frontend/src/admin/pages/PlainResourcePages.tsx)

 职责：

@@ -337,7 +277,7 @@ Admin Next 侧栏底部主题切换继续复用共享 [SegmentedControl.tsx](/ho

 例如：

- [Dashboard.tsx](/home/ray/dev/linkong/planet/frontend/src/pages/Dashboard/Dashboard.tsx)
+- [Dashboard.tsx](/home/ray/dev/linkong/planet/frontend/src/admin/pages/Dashboard.tsx)

 优先目标：

@@ -349,10 +289,10 @@ Admin Next 侧栏底部主题切换继续复用共享 [SegmentedControl.tsx](/ho

 例如：

- [DataSources.tsx](/home/ray/dev/linkong/planet/frontend/src/pages/DataSources/DataSources.tsx)
- [DataList.tsx](/home/ray/dev/linkong/planet/frontend/src/pages/DataList/DataList.tsx)
- [Users.tsx](/home/ray/dev/linkong/planet/frontend/src/pages/Users/Users.tsx)
- [Settings.tsx](/home/ray/dev/linkong/planet/frontend/src/pages/Settings/Settings.tsx)
+- [DataSources.tsx](/home/ray/dev/linkong/planet/frontend/src/admin/pages/PlainResourcePages.tsx)
+- [DataList.tsx](/home/ray/dev/linkong/planet/frontend/src/admin/pages/DataList.tsx)
+- [Users.tsx](/home/ray/dev/linkong/planet/frontend/src/admin/pages/Users.tsx)
+- [Settings.tsx](/home/ray/dev/linkong/planet/frontend/src/admin/pages/PlainResourcePages.tsx)

 约束：

@@ -362,7 +302,7 @@ Admin Next 侧栏底部主题切换继续复用共享 [SegmentedControl.tsx](/ho

 ### 数据源目录页

-[DataSources.tsx](/home/ray/dev/linkong/planet/frontend/src/pages/DataSources/DataSources.tsx) 当前不再承担配置编辑职责，而是数据源目录和采集操作页。
+[DataSources.tsx](/home/ray/dev/linkong/planet/frontend/src/admin/pages/PlainResourcePages.tsx) 当前不再承担配置编辑职责，而是数据源目录和采集操作页。

 当前页面边界：

@@ -386,7 +326,9 @@ Admin Next 侧栏底部主题切换继续复用共享 [SegmentedControl.tsx](/ho

 ### 采集器设置页

-[Settings.tsx](/home/ray/dev/linkong/planet/frontend/src/pages/Settings/Settings.tsx) 会按路由进入三种模式：`/settings` 是系统设置，`/earth-content` 是 Earth 内容，`/collection-management` 是采集管理。`collector_credentials` tab 当前在 `/collection-management` 下显示为“采集器”。
+[Settings.tsx](/home/ray/dev/linkong/planet/frontend/src/admin/pages/PlainResourcePages.tsx) 会按路由进入三种模式：`/settings` 是系统设置，`/earth-content` 是 Earth 内容，`/collection-management` 是采集管理。`collector_credentials` tab 当前在 `/collection-management` 下显示为“采集器”。
+
+`/settings` 的“系统显示”分区包含 `演示模式` 开关。开启后，Earth 的 OOBE 会忽略“已有当前采集数据”和本地“先浏览”临时跳过状态，直接展示初始化引导；该开关仅用于演示/验收流程，不改变数据源、采集队列或 Earth 内容资源配置。

 当前页面边界：

@@ -419,7 +361,7 @@ Admin Next 侧栏底部主题切换继续复用共享 [SegmentedControl.tsx](/ho

 ### Earth 内容页

-`/earth-content` 复用 [Settings.tsx](/home/ray/dev/linkong/planet/frontend/src/pages/Settings/Settings.tsx) 的单屏 tab 容器，但页面责任与系统设置分离：
+`/earth-content` 复用 [Settings.tsx](/home/ray/dev/linkong/planet/frontend/src/admin/pages/PlainResourcePages.tsx) 的单屏 tab 容器，但页面责任与系统设置分离：

 - `电视直播` 迁移原直播源配置，继续管理 Earth 媒体面板内容源。
 - `国界精度` 管理 Earth 静态国界资产：provider 状态、低精 fallback、高精 manifest/PMTiles、源配置 JSON 和构建动作。
@@ -431,8 +373,8 @@ Admin Next 侧栏底部主题切换继续复用共享 [SegmentedControl.tsx](/ho

 例如：

- [BGP.tsx](/home/ray/dev/linkong/planet/frontend/src/pages/BGP/BGP.tsx)
- [Playground.tsx](/home/ray/dev/linkong/planet/frontend/src/pages/Playground/Playground.tsx)
+- [BGP.tsx](/home/ray/dev/linkong/planet/frontend/src/admin/pages/PlainResourcePages.tsx)
+- [Playground.tsx](/home/ray/dev/linkong/planet/frontend/src/admin/pages/PlainResourcePages.tsx)

 约束：