Power HTTP 注入

说明 Power.http.server 的作用、鉴权策略、以及什么样的场景适合用 HTTP 注入

Power 可以声明:

http: {
  runtime: {
    auth_policies: [...],
    register({ app, get_context, power_name }) {
      // register routes
    },
  },
}

它解决什么问题

它让 Power 自己声明:

  • 需要哪些 runtime HTTP 路由
  • 这些路由需要什么鉴权策略

而 server 侧只负责统一装配。

auth_policies

这里声明的是:

  • 这组路由应该怎么鉴权

它的意义是:

  • Power 只声明自己的安全需求
  • runtime / console 负责消费这份声明

register

这里是真正把路由挂到 runtime Hono app 上的地方。

Power 不需要自己启动 server,只需要把路由注册函数提供出来。

什么时候适合用 Power HTTP

这些场景通常适合:

  • 你要暴露一个专门的 runtime HTTP 端点
  • 这个端点更像 Power 功能面,而不是 session 面
  • 你希望它和 Power 的 availability、鉴权、控制面视图保持一致

什么时候不适合

如果你只是:

  • 做一般 session 对话
  • 暴露 SDK session 路由

那应该仍然优先使用 agent 自带的 session HTTP 能力,而不是自己重复造一层 Power HTTP。

相关文档