Files
planet/docs/technical/zh/quickstart.md
T

92 lines
7.2 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 快速开始
这份快速开始面向智能星球的最终用户:你拿到了管理员给的访问地址,要从打开浏览器到第一次完成配置之间的最短路径。所有操作都在浏览器里完成。
如果你是负责部署或运维的同事,请改读 [智能星球运维手册](/home/ray/dev/linkong/planet/docs/technical/zh/ops-runbook.md)。
## 1. 打开访问地址
打开管理员给的 URL,例如 `http://planet.example.com`。本地演示一般是 `http://localhost:3000`。
入口分两类:
- 公开页:`/earth`(3D 态势)、`/docs`(公共文档)
- 登录后:`/admin`(控制台)、`/ai`(AI)、`/settings`(系统设置)、`/earth-content`(智能星球内容)、`/collection-management`(采集管理)
## 2. 注册账号
1. 打开 `/login`,点击表单下方"注册账户"。
2. 在 `/register` 填用户名、邮箱、密码(至少 8 位)。
3. 提交后,到邮箱查收 6 位验证码(10 分钟内有效)。
4. 在验证页输入验证码,点击"验证并登录",系统会自动跳到控制台。
收不到邮件时:
- 看一下垃圾邮件或企业邮件网关
- 验证页右下角的"重新发送验证码"会显示倒计时,结束后可以重发
- 提示"邮件服务尚未配置"时联系管理员开 SMTP
默认角色是 `viewer`,可登录但只能看公共内容。要看采集器、用户管理、系统设置,请联系管理员升级角色或加 Gatekeeper 权限组。
## 3. 第一次登录
进入 `/admin` 仪表盘后,建议按这个顺序熟悉控制台:
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 末端的插头检查模型目录;实际生成在 Playground 验证。右上角刷新图标会更新并保存可选模型目录,同时保留当前表单;选中新模型后点“保存”生效。WebSearch / OCR 工具可选
3. `/earth-content?section=brand`:在“品牌标识”里维护智能星球的 Logo 和标题图;对应地址字段内的“上传”按钮支持选择文件,也支持把图片直接拖到字段上,保存后会应用到智能星球 HUD
4. `/datasources` 或 `/data`:看采集器是否已经产出数据。有限采集器看 `/datasources -> 内置源`,不勾选时点“触发全部”,勾选后主按钮会变成“触发已选 N”;右上角队列按钮可查看进度。AISStream / WebSocket 长连接看 `/datasources -> 实时源` 的健康状态和计数
5. `/alerts/system`:看系统告警是否正常
6. `/users`(仅 `super_admin`):根据需要给同事开账号或调权限组
## 4. 打开智能星球
访问 `/earth`,公开页面,不需要登录。
如果系统还没有已采集数据,智能星球会显示初始化引导,提示登录控制台并触发采集。这个引导由后端状态决定,不会因为清空浏览器缓存而误判。
进入后建议确认:
- 地球正常显示,右侧图层面板可以打开/关闭
- 搜索可以查找海缆、卫星、算力中心、BGP 事件
- 算力中心和 BGP 观测站详情卡可以自动采集坐标候选,并能在智能星球上预览
- 一键定位期间关闭候选面板或切换浏览器标签页,再返回可查看进度;刷新或离开智能星球页面会中断未完成队列
- 船只图层持续接收 AISStream / BarentsWatch 位置,断线重连后自动校准
- 直播菜单可搜索完整频道库,滚到底部继续加载;默认频道为半岛电视台
- 鼠标拖动、滚轮缩放、缩放百分比提示工作正常
- 设置面板的旋转 / 巡航 / 动捕模式可以切换;动捕设置可以选择输入源和允许识别的动作;视图设置里可以切换悬停提示,卫星相关设置里可以打开或关闭真实高度分层和轨迹显示
- 底图默认使用“原始底图”,并将该选项放在首位;显示菜单可以切换并保存底图源。Natural Earth I 仍保留可用,NASA 21K 只作源归档,运行时同一时间只使用一张 8K 贴图。
点击物件或开启图层后,可直接点击对应图例项筛选;无需在图层中寻找额外入口。设置 → 显示可开启 FPS,卫星名称在缩放达到 400% 后显示。
顶部新闻条可打开态势新闻面板;启用“显示区域新闻卡片”后,美洲、欧洲、中东与非洲、亚太分别轮播本区新闻。每张卡片可单独暂停、翻页、拖动与折叠。
## 5. 找回密码
忘记密码时打开 `/forgot-password`,输入邮箱并接收验证码,再输入验证码 + 新密码即可。系统对未注册的邮箱也会返回同样的提示(防止账号枚举)。
## 6. 看文档
`/docs` 是文档站。未登录可看:本快速开始、使用手册、常见问题。登录后被分配 `docs_user` / `docs_developer` / `docs_admin` 权限组的用户可以看更多技术文档。
## 下一步
- 完整 UI 操作说明:[智能星球使用手册](/home/ray/dev/linkong/planet/docs/technical/zh/manual.md)
- 排障与配置疑问:[常见问题](/home/ray/dev/linkong/planet/docs/technical/zh/faq.md)
- 智能星球坐标候选采集流程见 [智能星球使用手册](/home/ray/dev/linkong/planet/docs/technical/zh/manual.md) 的智能星球章节
- 部署 / 运维相关命令:[智能星球运维手册](/home/ray/dev/linkong/planet/docs/technical/zh/ops-runbook.md)
## 试用算力专题
维护卡片数值:管理员打开“智能星球内容 → 算力对比”,先维护报告来源,再填写年度国家观测并“保存并发布”。只录入同年同口径数据,缺失国家不填,设施数量不会替代算力份额。可恢复内置默认值,地球卡片自动检查已发布配置。
在算力中心旁打开“算力态势分析”,开启“显示区域卡片”,选择地区并旋转地球。关闭配置窗会保留卡片,显示开关才控制启停。桌面卡片可调整大小、收起并查看真实历史图;点击来源或设施进入详情。手机使用底部“算力”页。国家指标与设施样本分开,“—”表示缺数据,不代表算力为零。
### 查看卫星与重试采集
在 Earth 启用卫星并选中一个粒子,可查看开放预测轨道、方向流光及受支持的覆盖投影。拖动移出球体仍会继续旋转。数据源采集失败后可重新触发;新任务独立显示,旧失败记录保留在当前任务队列的失败分组。
区域卡片保持在地球周边,旋转时主要变化是连线。空间不足时保留完整内容,允许少量遮挡;合法落点会保留;落在中央或越界时会自动就近调整。详情卡只保留业务信息和必要的可信度提示。
详情卡配图可在“智能星球内容 → 图层资源”管理:上传图片,选择适用物件或分组,预览后保存。内置专属图、系列图和类型通用示意覆盖全部地图物件;新安装无需导入,旧项目更新后重启前后端即可补齐默认配图。用户自定义关联和明确禁用的设置保留。