release: bump version to 0.44.0

docs/technical/zh/manual.md

@@ -196,6 +196,7 @@ Earth 用于在一个地球视图中观察：
 - 算力中心
 - BGP 观测
 - 卫星
+- AIS 船只
 - 轨迹
 - 地形
 
@@ -205,6 +206,31 @@ Earth 用于在一个地球视图中观察：
 - 轨迹依赖卫星
 - 高清材质关闭时，地球会显示基座地图和边缘识别效果
 
+### 图例
+
+左下角图例会跟随当前聚焦或启用的图层切换。
+
+当前已覆盖：
+
+- 海缆
+- 卫星
+- 国界
+- 算力中心
+- BGP
+- AIS 船只
+
+AIS 船只图例按船型显示颜色：
+
+- 货轮
+- 油轮
+- 客船
+- 渔船
+- 军舰
+- 停泊/低速
+- 其他船只
+
+船只图例中的三角形对应地图上的航行船只标记，圆点对应停泊或低速状态。
+
 ### 搜索
 
 Earth 搜索支持查找当前地球对象，例如：
@@ -233,6 +259,25 @@ Earth 搜索支持查找当前地球对象，例如：
 
 这些设置会保存在浏览器本地存储中。换浏览器或清理站点数据后会恢复默认值。
 
+### 视角控制
+
+Earth 支持鼠标、触控板和触屏操作。
+
+常用控制方式：
+
+| 操作 | 作用 |
+| --- | --- |
+| 鼠标左键拖动 | 旋转地球 |
+| 手指单指拖动 | 在触屏设备上旋转地球 |
+| 鼠标滚轮 | 放大或缩小视角 |
+| 双指捏合 | 在触屏设备上放大或缩小视角 |
+| 缩放按钮 | 按固定步长调整缩放 |
+| 点击缩放百分比 | 重置到默认缩放 |
+
+缩放时，顶部胶囊会短暂显示当前缩放比例，例如 `缩放 180%`。这个提示只表示当前视角缩放，不代表数据加载进度；如果页面正在加载数据，加载提示优先显示，缩放提示不会打断加载状态。
+
+拖动灵敏度会根据当前缩放自动调整。默认视角附近保持常规旋转速度；放大后拖动会逐步变细，适合检查某个区域、船只、卫星或 BGP 事件；缩小后拖动会略快，方便快速浏览全球态势。
+
 ### 巡航模式
 
 巡航模式会让 Earth 自动轮播聚焦目标。
@@ -308,7 +353,7 @@ http://localhost:3000/admin
 | --- | --- | --- |
 | 仪表盘 | `/admin` | 系统概览 |
 | Earth | `/earth` | 打开公开 Earth 页面 |
-| 数据源 | `/datasources` | 管理数据源和触发采集 |
+| 数据源 | `/datasources` | 查看数据源和触发采集 |
 | 采集数据 | `/data` | 查看采集后的数据 |
 | BGP 观测 | `/bgp` | 查看 BGP 专题数据 |
 | 系统告警 | `/alerts/system` | 系统级告警 |
@@ -321,17 +366,21 @@ http://localhost:3000/admin
 
 ### 数据源
 
-`/datasources` 用于查看和管理采集来源。
+`/datasources` 用于查看采集来源和触发采集。当前页面是“数据源目录”，会把内置数据源和自定义数据源放在同一张列表里展示。
 
 常见操作：
 
 - 查看数据源状态
 - 触发采集
 - 查看最近采集任务
-- 调整配置项
+- 打开详情抽屉查看 endpoint、请求头、基础配置和是否为内置数据源
 
 如果 Earth 上某类对象缺失，通常先到这里确认数据源是否可用。
 
+数据源列表中的名称点击后只打开信息抽屉，不再承担编辑入口。接口地址、凭证、请求头和自定义数据源配置统一到 `/settings` 的“采集器设置”里维护。
+
+当有采集任务正在运行时，总体进度下方会出现 `采集中 N` 标签。这个标签和其他状态标签放在同一排，但带有可点击样式；点击后会弹出当前采集中任务列表，显示每个任务的阶段、进度和处理数量。
+
 ### 采集数据
 
 `/data` 用于查看采集后的数据表。
@@ -369,10 +418,63 @@ http://localhost:3000/admin
 
 - 系统设置
 - 电视直播源配置
-- 数据源相关配置入口
+- 采集器设置
+- 外部集成和 AI Provider 配置
 
 具体可用配置取决于当前登录用户权限。
 
+#### 采集器设置
+
+`/settings?tab=collector_credentials` 当前显示为“采集器设置”。这里统一维护所有采集器的连接配置，而不是只维护凭证。
+
+使用方式：
+
+1. 在下拉框选择采集器。
+2. 查看状态标签：
+   - `无需凭证` / `需要凭证`
+   - 所属模块
+   - `启用` / `禁用`
+   - `未检查` / `可用` / `不可用`
+3. 点击下拉框右侧的插头图标执行健康检查。
+4. 如果检查通过，状态会变为 `可用`。
+5. 修改 endpoint、请求头、超时或重试次数后保存。
+
+对于免费且不需要凭证的采集器，连接检查会直接请求对应 endpoint。对于需要凭证的采集器，连接检查会走对应凭证链路；如果凭证或 endpoint 相比上次验证成功时发生变化，需要重新点击连接。
+
+系统判断“已连接”的条件是：
+
+- 当前配置已经成功采集过数据；或
+- 当前配置已经点击过连接按钮并验证成功。
+
+#### BarentsWatch AIS 凭证
+
+`BarentsWatch AIS` 是需要凭证的内置采集器。选择该采集器后，凭证区域会显示在基础配置上方。
+
+配置项：
+
+- `Client ID`
+- `Client Secret`
+- `Endpoint`
+
+如果已经配置过 secret，输入框会显示脱敏预览。保存时如果保持这个脱敏预览不变，系统会保留原 secret；只有输入新的 secret 才会替换。
+
+BarentsWatch AIS 支持从以下位置读取凭证：
+
+1. 控制台采集器设置中保存的凭证。
+2. 后端环境变量：
+   - `BARENTSWATCH_CLIENT_ID`
+   - `BARENTSWATCH_CLIENT_SECRET`
+   - 兼容历史拼写：`BARRENTSWATCH_CLIENT_ID`、`BARRENTSWATCH_CLIENT_SECRET`
+3. `~/.zshrc` 中的同名 `export`。
+
+如果连接失败，页面会弹出凭证获取教程。教程支持：
+
+- 查看默认教程。
+- 点击“教程不好用”让 AI Provider 根据默认 prompt 重新生成教程。
+- 点击“重置”恢复默认教程。
+
+默认教程以 BarentsWatch 官方 tutorial 为准，并提醒 Live AIS 应选择 `AIS - API`，不是普通 `BarentsWatch - API`。
+
 ### 系统日志
 
 `/logs` 用于查看系统日志。若菜单中不可见，通常是当前用户角色没有权限。
@@ -397,7 +499,8 @@ http://localhost:3000/docs
 当前公开内容来自：
 
 ```text
-docs/technical/*.md
+docs/technical/zh/*.md
+docs/technical/en/*.md
 ```
 
 Docs 支持：
@@ -486,3 +589,4 @@ source ~/.zshrc && bun run build
 - [earth-layer-style-reference.md](/home/ray/dev/linkong/planet/docs/technical/zh/earth-layer-style-reference.md)
 - [backend-system-service-control.md](/home/ray/dev/linkong/planet/docs/technical/zh/backend-system-service-control.md)
 - [backend-collectors.md](/home/ray/dev/linkong/planet/docs/technical/zh/backend-collectors.md)
+- [datasource-collector-settings-connectivity.md](/home/ray/dev/linkong/planet/docs/technical/zh/datasource-collector-settings-connectivity.md)