73 lines
4.9 KiB
Markdown
73 lines
4.9 KiB
Markdown
# 快速开始
|
||
|
||
这份快速开始面向智能星球的最终用户：你拿到了管理员给的访问地址，要从打开浏览器到第一次完成配置之间的最短路径。所有操作都在浏览器里完成。
|
||
|
||
如果你是负责部署或运维的同事，请改读 [智能星球运维手册](/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 位置，断线重连后自动校准
|
||
- 直播菜单可搜索完整频道库，滚到底部继续加载；默认频道为半岛电视台
|
||
- 鼠标拖动、滚轮缩放、缩放百分比提示工作正常
|
||
- 设置面板的旋转 / 巡航 / 动捕模式可以切换；动捕设置可以选择输入源和允许识别的动作；视图设置里可以切换悬停提示，卫星相关设置里可以打开或关闭真实高度分层和轨迹显示
|
||
|
||
## 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)
|