orbit/docs/console.md

Orbit Console · 星轨控制台

Orbit 内置了一个不依赖 Node.js、外部 CDN 或额外文件挂载的管理控制台第一版。静态资源编译进 Orbit 二进制，入口为：

http://127.0.0.1:8080/console/

当前能力

• 读取 /health/live、/health/ready 和 /version 展示服务、Schema 与工具链状态。
• 通过用户选择的本地凭据 JSON 或手工 Token/队列 ID 调用现有授权 API。
• 展示任务、定时计划、流程实例和结果订阅的最近摘要。
• 点击任务查看任务详情、执行尝试时间线、最终结果和操作审计摘要。
• 在具备对应权限时提交任务取消和安全重试，沿用服务端的版本校验、幂等键、队列范围和审计规则。
• 任务状态按 10 秒自动刷新；页面不会把凭据上传到独立服务，也不读取数据库。
• 页面使用当前请求方的业务权限；没有权限的模块显示为空或等待权限，不绕过服务端授权。

本地打开

启动 Orbit 后直接访问 /console/。当前 Docker 开发环境可用：

http://127.0.0.1:8080/console/

点击“选择凭据 JSON”，选择 orbit-admin bootstrap 生成的私有凭据文件，例如 .local/local.credentials.json，再点击“连接”。文件只在浏览器内解析，Token 保留在当前页面会话中，不写入 Orbit 数据库。

安全边界

控制台不直接访问数据库，也不绕过 Bearer Token。取消和人工重试会使用当前任务版本生成一次性幂等键；网络结果不明时不要重复点击，应使用原始操作身份通过 API/SDK 核对。NEEDS_REVIEW 任务仍须使用带证据的核查 API/SDK 完成最终裁决。控制台不创建独立管理员身份，不支持跨命名空间聚合，不代替平台的权限与审计 API。

不能把业务 Token 长期放进浏览器本地存储，也不能让控制台直连 MySQL。后续再补独立管理身份、计划控制和交付重试等更高风险操作。