迁移与能力边界
23.1 接入约定与迁移要点
| 主题 | Orsus 3.1 文档中的处理 |
|---|---|
| 产品名称 | 统一 Orsus；保留 edge-core 作为部署进程名 |
| HTTP 地址 | 当前配置 8898，明确区分历史 8899 |
| 认证入口 | 普通 prod、dev、标准包接管、制造放行和检测模式分别说明；prod 不等于一定启用 token |
| 健康探针 | 当前 /healthz 有 code/msg/data 信封 |
| 接口范围 | 只把当前有注册和实现的业务接口作为可调用接口；不延续旧占位路由 |
| 日志 | 使用 source/list/file 与 full_path；旧 /{filename} 路径不再作为当前接口 |
| 导航启动 | 补充三段等待、环境复用、异步参数回放及失败步骤 |
| 任务模型 | 分清 Missions 字符串状态、本机任务整数状态、下游导航状态和 OTA 状态 |
| 参数 | 补充真实写入白名单、footprint 校验、部分成功、保存与运行值差异 |
| 建图 | 5 秒快速失败检查、停止保存确认、持久化执行结果 |
| 地图 | 导入包精确结构、上传上限、PNG 缓存、内容版本字段和冲突流程 |
| 语义 | 补齐摘要和批量图像；检索结果 payload 顶层展开 |
| SSE | 补齐 hub、生产认证、health 与单次查询的差异及重连语义 |
| WebSocket | 修正 UTF-8 输入缓冲区分配，说明独立 token 与帧长度 |
| MQTT | 补充 REST/MQTT 差异、内存去重范围、ttl_ms 不自动生效及回执与任务完成区别 |
| 容器 | 不再把后台策略错误承诺为本次 HTTP 的同步失败 |
23.3 旧版占位接口不应继续调用
旧 Orsus 2.0 文档列出的下列功能没有在本基线注册为对应客户业务接口，不再描述为“可调用但固定返回 1004”：
- electric_strength/sse、electric_strength/http：电量从 systems/robot 获取。
- edge/models/model_list、edge/models/model_infer：容器服务目录不等于模型推理 API。
- interact/wakeup、interact/audio：当前仅文档化 ASR 上传识别。
- ros2_bridge/reset。
- task/support_task_list、task/patrol_task：任务使用 tasks 或 nav/missions。
- nav/switch_navigation_mode、nav/return_to_start、nav/set_map、nav/get_map_info、nav/get_nav_config、nav/set_nav_config、nav/nav_history。
api/proto/ 协议草案、过时 OpenAPI 和设计文档不构成运行时可调用保证。保留下来的旧命名接口（如 start_navigation/get_nav_params）在本文逐项列明；不能据此推断存在所有旧路由的兼容层。
23.4 仍由交付版本决定的内容
以下项目无法仅凭 Core 固定成跨设备统一枚举，集成时应从设备查询或对照对应服务版本：
| 项目 | 确认方法 |
|---|---|
| 可用适配器和离散动作 | motion/adapters、motion/system_info |
| 导航参数完整可读树及数值范围 | params/list；写入白名单见本文 8.5；更换镜像重新确认 |
| 标定状态完整枚举、轴顺序、单位 | 对应标定服务协议；Core 仅转发已定义结构 |
| OTA state 完整状态机与取消阶段 | 实际部署的升级服务契约；Core 未枚举 |
| 语义点 payload 的位置/相机字段 | 当前向量库点数据与语义服务版本 |
| MQTT 外部可用主题与 ACL | 部署方 Broker 配置，分别确认本地/云连接 |
| 媒体会话、遥控速度协议 | 对应云媒体/遥控服务契约，不从普通 MQTT 主题猜测 |
这些边界已在接口正文标注；示例中 adapter-from-device、version-from-device 等均须替换为实际查询值。