deepseek-harness/packages/client/README.zh.md

client/ — web GUI 浏览器端

English | 中文

dsh web GUI 的浏览器侧：shell 启动、浏览器与宿主通信、共享 UI 服务和功能插件。编写规则见 AGENTS.md；宿主半侧是 host/。除 test-runtime 外，均为名为 @deepseek-ai/dsh-client-<name> 的产品包。

包	目的
web/	从客户端条目图启动浏览器 shell。
modules/	加载浏览器侧客户端模块。
web-react/	连接 shell 运行时与 React 渲染。
connection/	维护浏览器与宿主之间的 RPC 通信和事件传递。
runtime/	为会话、工作区和 UI 组合提供共享客户端服务。
hmr/	在开发期间刷新客户端插件。
locale/	提供本地化偏好与消息词典。
schema-form/	为设置编辑器提供 schema 驱动的草稿处理。
test-runtime/	为客户端功能包提供共享的仓库测试支持。
ui-slots/	定义 UI 功能注册和组合扩展 slot 的方式。
ui-theme/	应用所选颜色主题。
ui-primitives/	提供共享 React 控件、图标和内容渲染器。
ui-attachment/	提供附件展示原子组件：草稿图片栏、消息画廊与灯箱。
ui-layout/	排列应用的主要区域。
ui-sidebar/	展示工作区与会话导航。
ui-workspace/	提供工作区选择与创建界面。
ui-conversation/	展示当前对话及其输入界面。
ui-tool/	编排工具调用树和按工具键控的视图。
ui-workflow-run/	把持久工作流运行回放为 Chat 嵌套折叠项，并只为实时子 Session 提供导航。
ui-goal/	展示和管理当前目标。
ui-trajectory/	提供 agent（智能体）活动的其他视图。
ui-commands/	提供会话感知的命令发现与分发。
ui-input-trigger/	协调内联命令和引用建议。
ui-skill/	向内联建议添加 skill（技能）引用。
ui-subagent/	提供 subagent（子 agent）导航、子级 transcript（文本记录）的状态和内联引用。
ui-jobs/	在会话标题栏列出当前会话的后台任务。
ui-model-selection/	在对话界面中提供模型选择。
ui-permission/	配置默认权限并切换当前会话的访问模式。
ui-plan/	展示生效中的 plan mode 状态及其退出控件。
ui-settings-plugins/	拥有“插件”设置分区、它的标签页扩展点，以及可配置的宿主平面插件卡片。
ui-user-questions/	展示 agent 请求的交互式问题。
ui-agent-preset/	选择会话的 agent 预设，并编写预设组合。
ui-settings/	承载设置界面及其扩展区域。
ui-settings-general/	提供常规设置分区。
ui-settings-models/	提供模型提供方配置与 DeepSeek 配置引导。
ui-settings-plugin-inventory/	向“插件”设置贡献只读的 Host Loader 清单标签页。

每个子文档负责自身的约定和详细行为。slot 系统标准与 Web 客户端架构 Agent Note负责跨包组合与加载决策。

子系统参考是 client-modules.md；slot 系统标准是权威 slot 模型，web 客户端架构 Agent Note拥有加载链与对象层。