Skip to content

路由覆盖与协议实现一致性问题清单 #909

@hotlong

Description

@hotlong

路由覆盖与协议实现一致性问题清单

背景

当前 DEFAULT_DISPATCHER_ROUTES 协议定义了 13 个命名空间,但实际代码只实现了其中约 9 条,其余 4 条(/workflow, /notifications, /realtime, /ai)没有任何物理路由或 handler。插件 manifest 的 contributes.routes 只作为元数据,未自动驱动路由注册。路由实际注册全部通过插件内部命令式进行,存在协议与实现脱节风险。

问题清单

1. 路由实现覆盖不足

  • 补齐 dispatcher-plugin.ts 和 HttpDispatcher 的 /workflow/notifications/realtime/ai 路由注册与 handler stub(即使只是 stub,也要保证路由存在)

2. 插件 manifest 的 contributes.routes 未驱动自动化注册

  • 增加 Kernel 层自动根据 manifest 路由批量注册路由,与 Discovery 元数据一致
  • 支持协议驱动的路由自动检测,发现协议未实现时能告警

3. Adapter/Hono Server 路由与 Dispatcher 路由脱节

  • 增加自动文档生成,保证所有注册路由都能被发现和测试
  • 实现 UI 控制台显示所有路由及 handler 状态(支持 stub、警告等)

4. Discovery 协议与真实服务注册状态不一致

  • 增加启动时路由检测,发现 required handler 缺失时有警告日志
  • Discovery 输出健康状态,区分"已注册但未实现"、"协议未覆盖"等

Metadata

Metadata

Assignees

Labels

Type

Projects

No projects

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions