History

imccyu 717792b631 refactor: nest client manifest metadata under dsh		2026-08-10 21:11:09 +08:00
..
apiproxy	Merge remote-tracking branch 'origin/master' into worktree/subagent-missing-tools-fb2359	2026-08-10 20:32:58 +08:00
directory-picker	docs: make technical prose concrete	2026-08-10 16:34:20 +08:00
directory-picker-auto	docs: make technical prose concrete	2026-08-10 16:34:20 +08:00
directory-picker-browse	refactor: nest client manifest metadata under dsh	2026-08-10 21:11:09 +08:00
directory-picker-native	refactor: nest client manifest metadata under dsh	2026-08-10 21:11:09 +08:00
frontend-static	docs: complete Chinese proofreading and generated reference pairing	2026-08-09 11:02:16 +08:00
webserver	docs: make technical prose concrete	2026-08-10 16:34:20 +08:00
README.i18n.yaml	docs(i18n): reconcile source-drifted translations	2026-08-09 10:24:11 +08:00
README.md	docs: anchor each subsystem page to its package group; make group READMEs thin tables	2026-08-09 01:32:39 +08:00
README.zh.md	docs(i18n): reconcile source-drifted translations	2026-08-09 10:24:11 +08:00

README.md

host/ — web-GUI host half

English | 中文

The host side of the dsh web GUI: the API gateway every client shape shares, and the plain HTTP server it rides on. The browser side lives in client/; the composed application is apps/cli booting the dsh-base bundle serving apps/web. All product packages.

Package	Role	ctx key
`apiproxy/`	Shared host API gateway and wire contract	`ctx.apiProxy`
`webserver/`	HTTP route carrier	`ctx.httpServer`
`frontend-static/`	SPA dist server on the webserver fallback seat	consumes `ctx.httpServer`
`directory-picker/`	Workspace-directory picking seam	`ctx.directoryPicker`
`directory-picker-native/`	Native directory-picker backend and browser interaction	registers `ctx.directoryPicker`
`directory-picker-browse/`	In-app directory-browser backend and interaction	registers `ctx.directoryPicker`
`directory-picker-auto/`	Host-adaptive picker composition	mounts a backend

apiproxy remains transport-independent; client/connection supplies the browser/HTTP carrier. Picker implementations replace one another behind the shared seam.

The subsystem references: http-server.md and workspace.md (the picker seam).