README.zh.md 2.9 KB
description: "Web GUI Host 侧的包映射：HTTP 与 SPA 服务器、工作区目录选择实现、open-in-app 启动路由和插件清单投影。"
kind: "package-group"
host/ — Web GUI 宿主侧
English | 中文
概述
host/ 组提供 Web GUI 的普通 HTTP 服务器、服务已构建 Web 壳的 SPA dist 服务器、带原生／浏览／自适应组合包的工作区目录选择 seam、open-in-app 的应用探测与启动路由，以及只读的插件清单投影。这八个包都是产品包；浏览器传输位于 client/，组合应用是 apps/cli，它启动 dsh-base 组合包 来提供 apps/web/ 下的 Web 应用。选择器后端可在共享 seam 后互相替换。
目录
包
八个包分别承担 Host 角色；各包的 README 拥有自己的约定与配置。
| 包 | 职责 | ctx 键 |
|---|---|---|
webserver/ |
浏览器 HTTP 服务器：具名路由、upgrade、index 转换与回退席位 | ctx.webServer |
frontend-static/ |
占据 webserver 回退席位的 SPA dist 服务器 | 消费 ctx.webServer |
directory-picker/ |
工作区目录选择 seam：能力约定与错误词汇 | ctx.directoryPicker |
directory-picker-native/ |
面向宿主屏幕前操作者的原生 OS 选择器后端 | 注册 ctx.directoryPicker |
directory-picker-browse/ |
应用内目录浏览器后端，也服务于远程客户端 | 注册 ctx.directoryPicker |
directory-picker-auto/ |
在启动时挂载匹配后端的宿主自适应选择器 | 挂载一个后端 |
open-in-app/ |
在已安装应用中打开 workspace 目录的应用探测、图标与启动路由 | 消费 ctx.webServer |
plugin-inventory/ |
当前 Loader 条目的只读投影 | Remote pluginInventory/list |
相关文档
先从传输与工作区记录的子系统参考读起，再看 Web Client 背后的分层决策。
- HTTP 服务器子系统——webserver 的路由、匹配顺序与配置。
- 工作区子系统——目录选择器所喂给的工作区记录。
- Web 配置树启动与传输分层——Web 传输各层的所有权。