deepseek-harness/packages/client
Chinesezjc 4145cd7075 test(web): cover the cursor replay's remaining branches
CI's coverage gate caught `ansi.ts` at 95.31% branches. My local check had
scoped coverage to that one file, which measures a different test set than
the gate does — the gate is the authority and it was right.

Three branches. Two are now pinned, each verified in a real terminal first:

`ab\r` + U+0301 + `x` shows `xb` — the redraw leaves the cursor at column 0,
so a combining mark has no cell to attach to and the terminal shows nothing
for it. It also revealed that the mark was kept when `cursor` was 0, which is
fixed.

`ab\rX\x1b[31m` then a plain line shows `Xb` unstyled and the next line RED:
the mirror of the reset case, where the scan ends styled while the last cell
is not, so the convergence has to OPEN the run at the line end for it to
reach the following line.

The third was `?? ''` on a `String.split` result, which always yields at
least one element — removed rather than tested, since no input can reach it.
2026-07-29 16:20:01 +08:00
..
connection fix(web): close a run at the line end and count columns correctly 2026-07-29 16:10:37 +08:00
hmr Merge remote-tracking branch 'origin/master' into worktree/web-session-model-selector 2026-07-27 12:17:38 +08:00
locale fix(web-ui): menu placement and scrolling, tool-row and settings polish 2026-07-28 04:25:18 +08:00
modules docs: translate remaining READMEs 2026-07-26 05:06:39 +08:00
runtime fix(client): drop generation-scoped interaction state at generation death 2026-07-29 13:03:26 +08:00
test-runtime Merge remote-tracking branch 'origin/master' into web-permission-sandbox-merge-master 2026-07-29 11:16:49 +08:00
ui-command refactor(client): command decorations replace the hostBacked contribution mode 2026-07-29 12:01:36 +08:00
ui-conversation Merge remote-tracking branch 'origin/master' into feat/web-terminal-card 2026-07-29 15:44:58 +08:00
ui-goal feat(fixture): mirror the goal domain — /goal command, six verbs, projection unit 2026-07-29 01:40:23 +08:00
ui-layout refactor: simplify sidebar logics 2026-07-29 14:52:41 +08:00
ui-model Merge remote-tracking branch 'origin/master' into feat/scrollbar-tokens 2026-07-28 16:23:44 +08:00
ui-models Merge remote-tracking branch 'origin/master' into worktree/i18n-complete-non-readme 2026-07-26 14:37:46 +08:00
ui-permission refactor(client): command decorations replace the hostBacked contribution mode 2026-07-29 12:01:36 +08:00
ui-plan test(plan): cover the final-state tails and refresh the TUI golden 2026-07-28 23:49:38 +08:00
ui-primitives test(web): cover the cursor replay's remaining branches 2026-07-29 16:20:01 +08:00
ui-question style: satisfy the eslint lane on the plan surfaces 2026-07-28 22:36:35 +08:00
ui-settings Merge remote-tracking branch 'origin/master' into feat/scrollbar-tokens 2026-07-28 16:23:44 +08:00
ui-settings-general fix(web-ui): menu placement and scrolling, tool-row and settings polish 2026-07-28 04:25:18 +08:00
ui-sidebar test(ui-sidebar): pin the shell chrome with local DOM snapshots 2026-07-28 23:54:14 +08:00
ui-skill fix(client): contain notification-callback failures and document the source lifecycle 2026-07-28 14:33:37 +08:00
ui-slash refactor(client): carve outward interfaces for the session, workspace, layout, slash, and conversation services 2026-07-28 23:43:32 +08:00
ui-slots refactor(client): deferGroupRegistration owns the multi-hole flow semantics 2026-07-29 03:17:01 +08:00
ui-subagent fix(ui-slash): make the reference lexicon reactive end to end 2026-07-28 12:09:48 +08:00
ui-theme test(ui-theme): resolve elevated surfaces from the palette, not from rebinds 2026-07-28 18:31:52 +08:00
ui-trajectory refactor(web): drop the permission RPC pair and turn-anchoring machinery 2026-07-28 21:35:26 +08:00
ui-workspace Merge remote-tracking branch 'origin/master' into web-permission-sandbox-merge-master 2026-07-29 11:16:49 +08:00
web test(client): migrate the ui-conversation and web benches onto SlotTestRuntime 2026-07-28 23:54:14 +08:00
web-react docs: fix test and docs conflicts 2026-07-28 16:50:07 +08:00
AGENTS.md docs(client): state the reactive-read rules positively 2026-07-28 14:52:04 +08:00
README.i18n.yaml doc(packages): add the host/ and client/ group READMEs and table rows 2026-07-28 15:04:59 +08:00
README.md doc(packages): add the host/ and client/ group READMEs and table rows 2026-07-28 15:04:59 +08:00
README.zh.md doc(packages): add the host/ and client/ group READMEs and table rows 2026-07-28 15:04:59 +08:00
tsdown.client.ts feat(gui): settings panel with locale and theme preferences 2026-07-26 00:28:43 +08:00

client/ — web-GUI browser half

English | 中文

The browser side of the dsh web GUI: shell kernel, module system, wire consumer, React-free object services, the slot system, and the ui-* feature-plugin roster. Authoring rules live in AGENTS.md; the host half is host/. All product packages, named @deepseek-ai/dsh-client-<name>.

Package Role ctx key / slot
web/ Shell kernel: AppWebEntry runs the two-stage boot over the host-pushed entry graph (boots the tree)
modules/ Client module system: browser peer of Node's ESM loader as a lazy CJS table under the vendored cordis Loader (module face)
web-react/ Shell-side React glue: createSlotRenderer + SessionProvider render seats (renderer install)
connection/ Wire consumer both ends: browser ctx.connection (shared api client + stream loop) and the node half mounting the /api route with its browser-trust fence ctx.connection
runtime/ Client cordis boot and React-free object services: slots, Sessions, Workspaces, per-session bindings ctx.slots ctx.sessions ctx.workspaces
hmr/ Dev-only hot reload for fetch-arrival client plugins (--dev graphs) (dev entry)
locale/ Browser locale preference (zh/en) plus the ns×locale dictionary registry ctx.locale
ui-slots/ Slot registry pure core: SlotMap merging, single register API, the four-share props family (types + core)
ui-theme/ Theme preference over the --dsw-* token stylesheets (light/dark/system) ctx.theme
ui-primitives/ Pure React atoms: icons, Button/Pill/Menu/Modal/Input, markdown family (component library)
ui-layout/ Shell three-column AppFrame; declares sidebar / conversation / details / conversation.empty ctx.layout
ui-sidebar/ Sidebar shell: Workspace/session rail, search, collapse; declares sidebar.workspaces (slot host)
ui-workspace/ Shared Workspace picker: browser region + hero picker over the same creation flow (fills sidebar.workspaces, conversation.hero.workspace)
ui-conversation/ Conversation domain: skeleton, chat view, input dock, per-tool row slots (slot host)
ui-trajectory/ Trajectory/Waterfall view tabs; the minimal pure-consumer plugin exemplar (fills conversation.view)
ui-command/ Command surface: session-keyed directory cache, / source, three-kind dispatch ctx.command
ui-slash/ Input trigger pipeline: / and @ detection, grouped candidate menu, source roster ctx.slash
ui-skill/ /-trigger skill reference source over the skill.list RPC (registers into ctx.slash)
ui-subagent/ @-trigger subagent reference source over the sessions snapshot (registers into ctx.slash)
ui-model/ Model selection: /model popupSelect + the composer model seat over ModelService ctx.models
ui-question/ Web ask_user_question: host half mounts the tool, browser half fills the composer seat (fills conversation.composer)
ui-settings/ Settings shell: trigger chrome + modal panel; declares the settings.* slots (slot host)
ui-settings-general/ Settings ownerless copy: chrome content + General section skeleton (fills settings.*)
ui-models/ Models settings nav entry (content column lands in a later phase) (fills settings.section)

Feature UI composes only through the slot system (ctx.slots.register) — the slot system standard is the definitive model; the web client architecture note owns the loading chain and object layer.