仪表盘
实时健康检查、/metrics,以及 usage/list 真计数(无假数据)。
/health 与 /metrics 可匿名访问。已有租户丢 Key:有管理密钥到设置补发;否则只粘贴 QO_API_KEY(本机,不写仓库)。空集群才 bootstrap。
- 在仓库根目录启动 API:make docker-up && make db-init && make dev(监听 8230)
- 浏览器打开 Swagger:https://qo.aitoall.cc/docs,确认 /health 为 ok
- 在「租户向导」或「设置 → API Key」注册租户(可选 industry 模板),或 POST /api/v1/tenants/register
- 已有租户丢 Key:设置页用管理密钥补发,或粘贴 QO_API_KEY 到本机(localStorage);不要把 Key 写入仓库
- Admin 默认:http://127.0.0.1:3230(改 .env.local 后需重启)
首租户(空集群)
公开注册默认关闭。空集群请 POST /tenants/register,并附 X-QO-Bootstrap-Key / X-QO-Admin-Key / Bearer。无密钥 403;已有租户 409。不要把 /tenants/bootstrap 当唯一入口(中间件可能未豁免)。
若集群已有租户:有管理密钥可补发;否则只粘贴 QO_API_KEY(本机,不写仓库)。不要卡在 bootstrap。
服务健康
未知
命名空间
—
实体类型
—
实体实例
—
关系类型
—
系统意识
未知
世界 As-of 探查
未查询
GET /api/v1/world/as-of?at= · 走 apiFetch(禁硬编码密钥)· 空快照不是成功/健康态 · 成功拉取后用「再拉一次」回读核验,勿把空表当绿
实体数
—
https://qo.aitoall.cc/api/v1/world/as-of
该时刻邻居GET /api/v1/world/neighbors-as-of?entity_id=&at= · 空邻居 ≠ 成功 · 与上方 as-of 共用时刻
| ID | 邻居 |
|---|---|
| 填写实体 ID 后查询该时刻邻居;未成功拉取前不展示假绿。 | |
Prometheus 指标
未知