README.zh.md 1.1 KB
host/ — web GUI 宿主半侧
English | 中文
dsh web GUI 的宿主侧：所有客户端形态共用的 API 网关，以及承载它的纯 HTTP 服务器。浏览器侧位于 client/；组合后的应用是 apps/cli，它负责服务 apps/web。全部为产品包。
| 包 | 角色 | ctx 键 |
|---|---|---|
apiproxy/ |
共享 API 网关：零 Node 依赖的 TS 协议契约（src/api/）、fetch 载体对（宿主侧 toFetchHandler、客户端侧 AbstractApiClient），以及基于 ctx.agents／ctx.workspace 的宿主实现 |
ctx.apiProxy |
webserver/ |
纯 HTTP 路由注册载体：激活即监听的 node:http 服务器；路由以命名的 exact／prefix 处理器注册 |
ctx.httpServer |
apiproxy 在设计上与传输方式无关——它不注册任何路由；载体自行包装 ctx.apiProxy。HTTP 载体路由（连同其 /api 浏览器信任栅栏）由 client/connection 的 node 半侧挂载，这正是该包住在 client 组的原因：它拥有这条线的两端。