2026-07-28 15:04:59 +08:00
# client/ — web-GUI browser half
English | [中文 ](README.zh.md )
2026-08-05 12:46:38 +08:00
The browser side of the dsh web GUI: shell boot, browser-host communication, shared UI services, and feature plugins. Authoring rules live in [AGENTS.md ](AGENTS.md ); the host half is [`host/` ](../host/README.md ). All except `test-runtime` are **product ** packages named `@deepseek-ai/dsh-client-<name>` .
2026-07-28 15:04:59 +08:00
2026-08-05 12:46:38 +08:00
| Package | Purpose |
|---|---|
| [`web/` ](web/README.md ) | Boots the browser shell from the client entry graph. |
| [`modules/` ](modules/README.md ) | Loads browser-side client modules. |
| [`web-react/` ](web-react/README.md ) | Connects the shell runtime to React rendering. |
| [`connection/` ](connection/README.md ) | Maintains browser-host RPC communication and event delivery. |
| [`runtime/` ](runtime/README.md ) | Provides shared client services for sessions, workspaces, and UI composition. |
| [`hmr/` ](hmr/README.md ) | Refreshes client plugins during development. |
| [`locale/` ](locale/README.md ) | Provides localization preferences and message dictionaries. |
| [`schema-form/` ](schema-form/README.md ) | Provides schema-backed draft handling for settings editors. |
| [`test-runtime/` ](test-runtime/README.md ) | Provides shared repository test support for client feature packages. |
| [`ui-slots/` ](ui-slots/README.md ) | Defines how UI features register and compose extension slots. |
| [`ui-theme/` ](ui-theme/README.md ) | Applies the selected color theme. |
| [`ui-primitives/` ](ui-primitives/README.md ) | Provides shared React controls, icons, and content renderers. |
2026-08-11 17:01:29 +08:00
| [`ui-attachment/` ](ui-attachment/README.md ) | Provides attachment display atoms: draft-image rail, message gallery, and lightbox. |
2026-08-05 12:46:38 +08:00
| [`ui-layout/` ](ui-layout/README.md ) | Arranges the main application regions. |
| [`ui-sidebar/` ](ui-sidebar/README.md ) | Presents workspace and session navigation. |
| [`ui-workspace/` ](ui-workspace/README.md ) | Provides workspace selection and creation surfaces. |
| [`ui-conversation/` ](ui-conversation/README.md ) | Presents the active conversation and its input surface. |
2026-08-08 15:18:52 +08:00
| [`ui-tool/` ](ui-tool/README.md ) | Composes Tool call trees and keyed per-Tool views. |
2026-08-10 18:37:30 +08:00
| [`ui-workflow-run/` ](ui-workflow-run/README.md ) | Replays durable workflow runs as nested Chat disclosures with live-only child navigation. |
2026-08-05 12:46:38 +08:00
| [`ui-goal/` ](ui-goal/README.md ) | Presents and manages the current goal. |
| [`ui-trajectory/` ](ui-trajectory/README.md ) | Presents alternate views of agent activity. |
| [`ui-command/` ](ui-command/README.md ) | Provides session-aware command discovery and dispatch. |
| [`ui-slash/` ](ui-slash/README.md ) | Coordinates inline command and reference suggestions. |
| [`ui-skill/` ](ui-skill/README.md ) | Adds skill references to inline suggestions. |
| [`ui-subagent/` ](ui-subagent/README.md ) | Provides subagent navigation, child transcript states, and inline references. |
2026-08-08 23:29:41 +08:00
| [`ui-task/` ](ui-task/README.md ) | Lists this session's background tasks in the conversation header. |
2026-08-05 12:46:38 +08:00
| [`ui-model/` ](ui-model/README.md ) | Provides model selection in conversation surfaces. |
| [`ui-permission/` ](ui-permission/README.md ) | Configures default permissions and switches the current session's access. |
| [`ui-plan/` ](ui-plan/README.md ) | Presents active plan-mode status and its exit control. |
2026-08-10 19:14:59 +08:00
| [`ui-plugin-config/` ](ui-plugin-config/README.md ) | The Plugins settings section: host-plane plugin configuration as expandable cards. |
2026-08-05 12:46:38 +08:00
| [`ui-question/` ](ui-question/README.md ) | Presents interactive questions requested by the agent. |
2026-08-05 18:51:11 +08:00
| [`ui-agent-preset/` ](ui-agent-preset/README.md ) | Selects a session's agent preset and authors preset compositions. |
2026-08-05 12:46:38 +08:00
| [`ui-settings/` ](ui-settings/README.md ) | Hosts the settings interface and its extension areas. |
| [`ui-settings-general/` ](ui-settings-general/README.md ) | Provides the general settings section. |
| [`ui-models/` ](ui-models/README.md ) | Provides model-provider configuration and DeepSeek onboarding. |
2026-07-28 15:04:59 +08:00
2026-08-05 12:46:38 +08:00
Each child reference owns its contract and detailed behavior. The [slot system standard ](../../.agents/notes/implemented/architecture/2026-07-22-slot-type-chain-implementation.md ) and [web client architecture note ](../../.agents/notes/implemented/architecture/2026-07-19-gui-web-client-architecture.md ) own the cross-package composition and loading decisions.
2026-08-02 05:54:15 +08:00
The subsystem reference is [client-modules.md ](../../docs/subsystems/client-modules.md ); the [slot system standard ](../../.agents/notes/implemented/architecture/2026-07-22-slot-type-chain-implementation.md ) is the definitive slot model, and the [web client architecture note ](../../.agents/notes/implemented/architecture/2026-07-19-gui-web-client-architecture.md ) owns the loading chain and object layer.
