# 快速开始 这份快速开始面向智能星球的最终用户:你拿到了管理员给的访问地址,要从打开浏览器到第一次完成配置之间的最短路径。所有操作都在浏览器里完成。 如果你是负责部署或运维的同事,请改读 [智能星球运维手册](/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 启用卫星并选中一个粒子,可查看开放预测轨道、方向流光及受支持的覆盖投影。拖动移出球体仍会继续旋转。数据源采集失败后可重新触发;新任务独立显示,旧失败记录保留在当前任务队列的失败分组。 区域卡片保持在地球周边,旋转时主要变化是连线。空间不足时保留完整内容,允许少量遮挡;合法落点会保留;落在中央或越界时会自动就近调整。详情卡只保留业务信息和必要的可信度提示。 详情卡配图可在“智能星球内容 → 图层资源”管理:上传图片,选择适用物件或分组,预览后保存。内置专属图、系列图和类型通用示意覆盖全部地图物件;新安装无需导入,旧项目更新后重启前后端即可补齐默认配图。用户自定义关联和明确禁用的设置保留。