Browser acceptance of the activity panel surfaced the product problem: a background bash registers in both planes, so the header grew two near- identical popovers — "background jobs" with lifecycle and duration, "activities" with live output — listing the same work twice. The service planes stay orthogonal (jobs: model-visible control with a consuming read cursor; activities: transient non-consuming observation). The join happens per row in the UI projection instead: - dsh-client-ui-activity renders the single merged "tasks" list. Each jobsBySession row joins the activity carrying its correlation.jobId — the job supplies identity, lifecycle (stopping exists only there), duration, and the model-visible detail; the activity supplies the expandable live-output panel. Standalone activities (workflow runs) keep their own rows; without the activity registry, job rows still render and the control degrades to the old job list exactly. - dsh-client-ui-jobs is deleted (pre-release, no shim); the merged entry takes its slot order. The job locale namespace folds into activity. - User-facing copy says "task" (任务): N tasks running / N 个任务进行中. - Hierarchy: live rows first as two lines (label over kind badge and status, ticking duration), a Finished divider when both sections exist, settled rows compacted to one de-emphasized line, and the output panel hangs behind a spine under its row. Deliberately not joined: subagent rows stay bare (the subagent panel is their surface) and foreground commands stay in tool cards. Both web e2e scenarios now assert one Tasks list; the background-job scenario's row gained a live-output panel, proving the join end to end. Agent Note: 2026-08-25-unified-task-list.
5.3 KiB
5.3 KiB
client/ — web-GUI browser half
English | 中文
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; the host half is host/. All except test-runtime are product packages named @deepseek-ai/dsh-client-<name>.
| Package | Purpose |
|---|---|
web/ |
Boots the browser shell from the client entry graph. |
ui-renderer/ |
Binds slot data to React and mounts the assembled application after client boot settles. |
modules/ |
Loads browser-side client modules. |
connection/ |
Maintains browser-host RPC communication and event delivery. |
hmr/ |
Refreshes client plugins during development. |
locale/ |
Provides localization preferences and message dictionaries. |
store/ |
Provides React-free observable and snapshot-store primitives. |
test-runtime/ |
Provides shared repository test support for client feature packages. |
ui-slots/ |
Defines how UI features register and compose extension slots. |
ui-session/ |
Adapts Session Controller state into standard Slot sources and hooks. |
ui-theme/ |
Applies the selected color theme. |
ui-primitives/ |
Provides shared React controls, icons, and content renderers. |
ui-attachment/ |
Registers composer and message-image attachment presentation. |
ui-layout/ |
Arranges the main application regions. |
ui-sidebar/ |
Presents workspace and session navigation. |
ui-brand-official/ |
Fills the generic browser-brand slots with the official name and marks. |
ui-workspace/ |
Provides workspace selection and creation surfaces. |
ui-conversation/ |
Presents the active conversation and its input surface. |
ui-chat/ |
Projects and renders the Chat conversation target. |
ui-approval/ |
Presents approval requests and returns user decisions. |
ui-tool/ |
Composes Tool call trees and keyed per-Tool views. |
ui-workflow-run/ |
Replays durable workflow runs as nested Chat disclosures with live-only child navigation. |
ui-goal/ |
Presents and manages the current goal. |
ui-trajectory/ |
Presents alternate views of agent activity. |
ui-commands/ |
Provides session-aware command discovery and dispatch. |
ui-input-trigger/ |
Coordinates inline command and reference suggestions. |
ui-skill/ |
Adds skill references to inline suggestions. |
ui-reference/ |
Unified Web @file / @session reference source. |
ui-subagent/ |
Provides subagent navigation, child transcript states, and inline references. |
ui-activity/ |
Lists this session's tasks — jobs joined with their live-output activities. |
ui-model-selection/ |
Provides model selection in conversation surfaces. |
ui-permission/ |
Configures default permissions and switches the current session's access. |
ui-plan/ |
Presents active plan-mode status and its exit control. |
ui-settings-plugins/ |
Owns the Plugins settings section, its tab extension point, and configurable host-plane plugin cards. |
ui-user-questions/ |
Presents interactive questions requested by the agent. |
ui-agent-preset/ |
Selects a session's agent preset and authors preset compositions. |
ui-settings/ |
Hosts the settings interface and its extension areas. |
ui-settings-general/ |
Provides the general settings section. |
ui-settings-models/ |
Provides model-provider configuration and DeepSeek onboarding. |
ui-settings-plugin-inventory/ |
Contributes the read-only Host Loader inventory tab to Plugins settings. |
Each child reference owns its contract and detailed behavior. The slot system standard and web client architecture note own the cross-package composition and loading decisions.
The subsystem reference is client-modules.md; the slot system standard is the definitive slot model, and the web client architecture note owns the loading chain and object layer.