deepseek-harness/packages/api/README.zh.md

api/：Remote API 层

English | 中文

面向应用的 Remote 技术栈。remotes 负责 BFF 策略和选定的业务 API，gateway 则实现 Host 与 Client 环境共用的 TypeRT 一元 RPC endpoint。

包	职责	ctx key
remotes/	Host Agent/Session lookup 策略与 Client Remote contribution 装配	无服务；配置 ctx.typert 并消费 ctx.api
gateway/	Host TypeRT 分发器与 Client API endpoint	ctx.typertGateway / ctx.api

运行时依赖方向为 remotes → gateway → connection → webserver：BFF 消费共享的 TypeRTClientApi 契约，Gateway 把传输交给 Connection，Connection 再挂载到 HTTP server。Cordis 服务注入与 Client 模块元数据在不让 Remotes Client 入口导入具体 Gateway 实现的前提下维持该顺序。

已知限制与延期工作

• Connection 与 WebServer 仍位于 client/connection 和 host/webserver；后续可以只移动包，将它们放到 api/connection 和 api/webserver 下，而无需改变服务契约。
• 旧 API Proxy 仍位于 host/apiproxy，作为尚未迁移到 Remote 的方法的回退路径。它使用由 api-remotes 持有的 Host resolver，使已迁移与旧方法共用同一套 Agent/Session 身份策略。