界面与主题

Web 提问功能插件：其浏览器端在会话自有的 `conversation.composer` 键控插槽中注册 `question` 入口。其宿主端刻意留空——把 `dsh-tool-ask-user` 挂载到那里会让该工具进入注册表的 GLOBAL 层，而该层会合并进每个 agent，无论其由哪个预设组合而成，于是原本只有两个工具的基准预设实际会呈现三个。渲染问题是宿主 UI 的能力；拥有该工具则是 agent 的能力，因此 `tool

Web ask_user_question feature: host tool mount plus composer-takeover question UI

原生目录选择器界面：原生选择交互的浏览器端部分。它用一个无渲染的占位组件填补 ui-workspace 的两个目录流程空缺（`conversation.hero.workspace.directoryFlow` 和 `sidebar.workspaces.directoryFlow`），对每个 `open` 请求，通过 `ctx.workspaces.pickDirectory()` 驱动本地 Host 的操作系统选择器来应答，然后经由

Native directory-picker surface: the renderless workspace directory-flow occupant driving the host's OS chooser

Settings 无归属副本与产品引导插件：在 Settings 界面上注册所有不属于任何单一功能的内容——外壳的触发/标题/关闭界面内容、本地配置文件操作、General 分区及其 `settings.general.item` 插槽、`settings` 词典，以及第一个有序欢迎步骤。归属于功能的行（Permission、Language、Appearance）、分区（Models）以及条件性引导步骤仍留在各自的功能包中。

Settings ownerless-copy and product onboarding plugin: the General section, shell trigger/header chrome content, settings dictionaries, and the versioned welcome notice

Trajectory 渲染一份感知轮次的事件账本，其中的 User、Assistant、Tool 以及嵌套的 Subtool 记录均可选中。粗分隔线标记 Turn 边界，紧凑的行内标记标识 Step，主账本只保留索引、事件和内容；选中某条记录会打开一个局部检查器，展示 token 用量、时长、Input、Output 和 Timing。可滚动的 Summary 区域在未被悬停或未获得键盘焦点时，滚动条滑块保持透明，同时不改变预留的滚动几

Trajectory event ledger with an interactive timing overview: pure-consumer plugin registering into the conversation ViewMap (no service)

应用内目录浏览界面：浏览选择交互的浏览器端部分。它用「选择工作区目录」对话框填补 ui-workspace 的两个目录流程空缺（`conversation.hero.workspace.directoryFlow` 和 `sidebar.workspaces.directoryFlow`），通过 `ctx.workspaces` 驱动本地 Host 的 `host.listDirectory` 和 `host.createDirecto

In-app directory browsing surface: the workspace directory-flow owner rendering the host's listing and creation primitives

设置外壳插件：一个纯粹的组合门面。它通过触发入口界面和模态设置面板占据 `sidebar.settings`，并声明由注册方填充的插槽：`settings.trigger` / `settings.header` / `settings.close`（入口界面内容）、`settings.action`（有序的内容头部操作）、`settings.section`（每个功能一个页面），以及 `settings.onboarding`（在全视

Settings shell plugin: sidebar trigger, modal panel, feature sections, and an ordered full-page onboarding stage

逐条消息反馈插件，浏览器端部分：一对 Like/Dislike 按钮外加一个可选备注，作为 `conversation.chat.assistant-actions` 条带的 `feedback` 条目（顺序 10）贡献。该条带由 `ui-conversation` 声明，渲染在最终确定的 assistant 消息的 IconActions 行内，位于 copy 与 branch 之间，因此这些控件会继承该行的外观与悬停行为。只有最终确

Per-message feedback controls contributed to the assistant-message action strip, backed by the messageFeedback Host Remote

面向两种不同生命周期的权限浏览界面。General-settings 行读取显式暴露的 `permission` Settings 描述符，从宿主的动态 `defaultPreset` 枚举推导出可选项，并带着描述符修订号写入一次 `settings.mutate` 路径操作。它的 observable 搭载在 slot 系统的 `hooks` compartment 上，因此由渲染器负责 React hook 绑定；一次 push 失

Permission surfaces: a new-session default in General settings and a current-session /permission popup over the permissions projection

description: "dsh Web 客户端 Plugins 页面上 agent loop 的设置页：agent-loop 命名空间的并行工具调用上限。" kind: "package-reference"

Settings page of the agent loop on the dsh web client's Plugins page: the parallel tool-call cap of the agent-loop namespace

description: "dsh Web 客户端 Plugins 页面上的 shell 执行器设置页：shell 命名空间的命令超时与每个流的输出上限。" kind: "package-reference"

Settings page of the shell executor on the dsh web client's Plugins page: the command timeout and the per-stream output cap of the shell namespace

description: "dsh Web 客户端 Plugins 页面上的 Subagent 设置页：在一个页面上、一次保存，管理 subagent 命名空间上的委派深度与容量，以及 agent 可在 subagent-model-selection 上选择的模型。" kind: "package-reference"

Settings page of Subagent delegation on the dsh web client's Plugins page: recursion depth, parallel capacity, and the models agents may choose for subagents

description: "DeepSeek 网页搜索提供方在 dsh Web 客户端「插件」页面上的设置页：它的 API key、endpoint 以及每次请求的搜索次数预算。" kind: "package-reference"

Settings page of the DeepSeek web-search provider on the dsh web client's Plugins page: its API key, endpoint, and per-request search budget

Plan 模式状态标签，一个纯浏览器端 surface 插件。浏览器端占用会话声明的 `conversation.input.plan` 单一席位（位于访问模式控件右侧）；node 端是一个空的 apply（即 roster 行）。Plan 行为本身——`/plan` 命令、由边界或空闲提交的 `plan/mode` 状态、`plan` 投影单元以及策略部分——由 `@deepseek-ai/dsh-plan-mode` 负责，在宿主

Plan-mode composer control: the conversation.input.plan seat over the plan projection and the /plan command channel

DSH 插件 UI 调试器：给开发/测试 DSH 插件的 AI 提供真实浏览器驱动（Playwright）+ UI 查看/测试/验证/问题解决闭环工具(ui_shot/ui_drive)（dsh-plugin-ui-debug）

目录：这是什么 · 你该装吗 · 安装 · 选一种安装方式 · 工作原理 · 日常使用 · 如何调低或关掉 · 安全边界 · 已知限制 · 故障排查 · 文档索引

Web surface for skill content history: loopback host routes plus the sidebar panel (community build)

description: "Web GUI 的 Shell 布局：三栏 AppFrame，其右栏是边缘锚定面板的轨道，还包括面板几何服务与主题呈现；面向窗口外框的用户与维护者。" kind: "package-reference"

Shell plugin: three-column AppFrame with drag handles, ctx.layout viewing-state service (navigation + panels)

Shell 插件：三栏 AppFrame（拖拽手柄与让位链）外加 `ctx.layout` 面板几何服务；它注册进运行时拥有的 `root` 槽位，并声明 `sidebar`、`conversation`、`details` 和 `conversation.empty`。侧边栏的调整边界是一条不可见的命中条带，而详情栏的边界则保留其浮动胶囊；让位时只有详情栏会收缩，随后自动关闭。侧边栏关闭后仍保留一条 56px 的控制轨道，而详情栏则收

Shell plugin: three-column AppFrame with drag handles, ctx.layout viewing-state service (navigation + panels)

description: "Session Controller 列表、交互状态和每会话上下文的 React 与 Slot 适配器。" kind: "package-reference"

Session Controller adapter for React and session-scoped slots

Web Settings 的只读 **Plugin 列表**标签页。浏览器端 plugin 注册一个本地化的 `settings.plugins.tab` 贡献，id 为 `all`；Plugins 区块负责导航入口和标签页外壳。它在 plugin 激活期间不执行任何 Remote 读取。首次选中该标签页时才会挂载它，并通过 `api-remotes` 惰性调用 `ctx.remote.pluginInventory.list()`。

Read-only Cordis Loader inventory tab in Web Plugins settings

这是拥有 React 渲染层的浏览器端 Cordis 插件。`dsh-client-web` 会渲染一个不依赖任何框架的启动页，并加载完整的客户端插件清单；当所有条目都激活后，它会调用 `ctx.uiRenderer.mount(container)`。本包提供该服务，安装 slot 渲染器，对已有的启动页 DOM 进行 hydration，在下一次绘制前切换到组装完成的应用，并返回 React root 的卸载 disposer。

Browser UI renderer: React slot bindings, ctx.uiRenderer, and the assembled application root

agent-preset 的各个界面：一个「常规」设置行，用来选择新会话由哪个预设组合而成；新会话界面上的一个 chip，用来选择下一个会话的预设；会话头部的一个只读标签；以及一个管理预设名册的设置区块——复制、删除、设为默认，以及进入某个预设自身文件的入口。

Agent-preset surfaces: the default for later sessions, this session's seat, and the composition editor

只有当某个命名空间既由活跃的 Host 插件注册、又提供给浏览器时，对应的卡片才会渲染。如果某个部署没有组合拥有该命名空间的插件——或者没有向任何客户端提供该命名空间——则不会为它渲染任何内容，而不是渲染一张空卡片或禁用卡片，因此可配置标签页反映的是该部署实际运行的内容。

Plugins settings section with feature-owned tabs and configurable host-plane plugin cards

本包仅在 `DSH_CLIENT_BUILD_PROFILE` 为 `official` 时填充 `sidebar.brand.mark`、`sidebar.brand.name` 和 `conversation.hero.brand.mark`。其他构建会加载该插件，但不注册任何占位内容，从而让 shell 的回退内容保持可见。

Official DeepSeek Harness brand occupants for the Web client's sidebar and conversation Hero slots

统一的 Web `@file` 与 `@session` 来源。浏览器会针对未加引号的 token 同时发起 `fileReferences/list` 和 `sessionReferenceResolver/candidates` Remote 调用，按语言环境注册的文件夹/文件/会话标签，确定性地把文件排在会话之前，并在不可选中的文件与会话分区标题下渲染各行，且不再显示多余的原始 `reference` 来源标题。任一候选域失败时各

Unified Web @file and @session reference source

Goal 界面插件，浏览器端部分：`GoalBar` 条是 `conversation.input.dock` composer-context 栈中的第二张独立卡片（顺序为 10，位于 Todo 之后、Queue 之前）。实时 goal 通过 `useProjection('goal')` 传入——这是由历史尾部页面播种、并由 `session/projection` 帧更新的宿主计算整体值——因此该插件不拥有任何领域存储、刷新链或事

Session goal surface: GoalBar docked above the composer, read from the goal session projection

description: "在 Web 右侧边栏中打开、恢复和控制交互式 shell 标签页。" kind: "package-reference"

Interactive shell tabs for the right Sidebar

这个浏览器插件把持久化的顶层 workflow 运行重建为独立的 Chat 节点。它消费由 `dsh-tool-workflow` 拥有的四个 `tool-workflow/*` Session 事件，注册一个 `ConversationNodeDefinition`，并通过带 key 的 `conversation.chat.node` 插槽渲染，而不改动现有的 workflow 工具卡片。

Durable workflow-run Conversation Node and nested member disclosure for dsh web

产出文件功能的归属插件：把一轮对话结束时展示的「产出文件」行注册到聊天视图的 `conversation.chat.turnTail` 插槽中。所有策略都在这里；从 cordis.yml 中删掉这个插件的那一行，整个界面元素就会消失，而归属视图会以零成本渲染出一个空插槽。

Produced-files turn tail: the deliverables row a finished turn ends with

主题插件：ThemeService 构建在 --dsw-* 令牌基础样式表之上（静态色阶 + 别名语义层）。该服务持有实时主题偏好（`light`/`dark`/`system`），通过 `prefers-color-scheme` 解析 `system`，并在 `theme/change` 事件上发布不可变的 `ThemeSnapshot`；它从不接触 DOM——由 ui-layout 的 presenter 应用解析后的快照（`ht

Theme plugin: ThemeService (light/dark/system preference, prefers-color-scheme resolution, theme/change snapshots; no DOM), --dsw-* token base stylesheets; registers the Appearance settings row

主题插件：ThemeRuntime 构建在 --dsw-* token 基础样式表之上（静态色阶 + 别名语义层）。该服务持有实时主题偏好（`light`/`dark`/`system`），通过 `prefers-color-scheme` 解析 `system`，并在 `theme/change` 事件上发布不可变的 `ThemeSnapshot`；它从不触碰 DOM——由 ui-layout 的呈现层应用解析后的快照（`html {

Theme plugin: Host bootstrap for the pre-plugin palette; DOM-free ThemeRuntime for light/dark/system state; --dsw-* token styles and Appearance settings row

对话领域：骨架（header/tabs/composer/empty state）、聊天视图（分组步骤摘要流、流式尾部隔离、回合状态）、composer dock（会话统计与输入框粘性固定）、输入 dock（队列行加 todo 计划条）、详情外壳，以及按作用域寻址的 ConversationService。工具呈现属于 `ui-tool`。

Conversation domain: skeleton, ordered chat flow, composer with the Host-backed busy-Enter preference, and details host

模型选择插件，浏览器端：在由 `ModelDirectoryResolver`（`ctx.modelDirectories`）持有的单个按会话目录之上提供两个入口。对于普通会话，`/model` 的 popupSelect 贡献（通过 `ctx.commandUi` 注册）与 composer 中具名的 `conversation.input.model` 座位都通过 `session.models` 加载该会话的建议目录，并通过同一个

Model selection: the /model popupSelect over session.models / session.selectModel

侧边栏插件：按稳定的 Host 顺序展示真实的 Host Workspace，每个 Workspace 内按 Workspace 顺序包含其 `sessionIds`，并带有 `parentId` 嵌套；不属于任何 Workspace 的 Session 会出现在末尾的 `Ungrouped` 分区中。搜索、状态圆点和折叠进布局方拥有的 56px 侧栏轨道，都属于展示层本地行为。契约见插槽系统标准。

Sidebar plugin: session multi-level tree, search, grouping, state dots

客户端 Tool 展示插件。`ui-conversation` 会按顺序把每个 `tool-call` Conversation Node 分发到 `conversation.chat.node` 中匹配的 key；本包负责渲染它的根节点和 Code Dispatch 子节点，然后通过带 key 的 `tool.call.toolview` 插槽分发每一次原子调用。未注册的 Tool 名称使用通用卡片。

Client Tool call-tree renderer and keyed per-tool presentation slot

description: "官方 DeepSeek Harness 品牌占位组件，用于侧边栏，仅在官方构建中生效；面向选择或替换品牌呈现方式的用户与维护者。" kind: "package-reference"

Official DeepSeek Harness brand occupants for the Web client's sidebar slots

为 DeepSeek Harness（DSH）提供一组可选的**配色主题**。

Selectable DSH theme palettes (Tokyo Night, Catppuccin, Dracula, Gruvbox, Nord, One Dark) with live previews, applied from the General settings page.

description: "通过作用域交互路径响应 Host 权限请求的浏览器审批 UI。" kind: "package-reference"

Approval composer takeover over the scoped Remote Event waterfall

description: "dsh Web 客户端的主题与正文字号设置：--dsw-* token 样式表、ThemeRuntime 状态、General 设置行，以及插件加载前的 bootstrap。" kind: "package-reference"

Theme plugin: Host bootstrap for the pre-plugin palette; DOM-free ThemeRuntime for light/dark/system state; --dsw-* token styles and Appearance settings row

Skill 调用来源的浏览器端：把 `/` 触发的 `skill` 来源注册进 `ctx.slash`。普通会话的候选来自 `skill.list` RPC，其地址由每次调用的 `ClientSessionContext` 投影的 `{sessionId}` 给出，宿主则从会话头中解析出 `cwd`。宿主为每个用户可调用的 skill 提供服务；`modelInvocable: false` 条目（即 `disable-model-in

Web skill references and the dedicated skill tool row

description: "以流式、带认证的方式导出并校验恢复基于文件的 DSH 用户数据，并在浏览器中显示进度。" kind: "package-reference"

Full-stack Plus user-data Backup plugin with streamed Host archive routes and Settings UI

description: "dsh Web 客户端的 Web skill 引用与专用 skill 工具行：由 / 触发的 skill 来源与 skill 调用卡片。" kind: "package-reference"

Web skill references and the dedicated skill tool row

description: "dsh Web 客户端的 Web skill 引用与专用 skill 工具行：由 / 触发的 skill 来源，以及 skill 调用卡片。" kind: "package-reference"

Web skill references and the dedicated skill tool row

description: "用于沙箱化 HTTP(S) 页面的右侧边栏浏览器标签页，包括回环服务。" kind: "package-reference"

Sandboxed Web browser tabs for the right Sidebar

description: "侧边栏技能中心：按来源浏览已加载的技能，切换模型调用，创建和删除技能。" kind: "package-reference"

Skill center for the dsh web client: browses loaded skills grouped by source, enables or disables model invocation, creates skills, and deletes them into a recoverable trash

description: "Web 会话头部的 \"Open In...\" 拆分按钮：在会话工作区目录上启动记忆的应用，并列出宿主探测到已安装的所有应用。" kind: "package-reference"

Web Session-header "Open In..." split button opening the session workspace directory in a locally installed application

共享 Workspace 浏览器与选择器插件。`WorkspaceBrowser` 填充侧边栏的 `sidebar.workspaces` 槽位，而 `WorkspacePicker` 填充页面级 Session Intent hero 的 `conversation.hero.workspace` 槽位；两个界面使用同一个 Workspace 菜单和添加流程。

Workspace picker plugin: one WorkspacePicker registered into the sidebar and empty-state workspace slots

输入触发器流水线插件：光标处的 `/` 与 `@` 检测（词边界 + 守卫层级规则）、分组候选菜单，以及将选中结果路由到已注册来源。`ctx.inputTriggers` 持有来源名册，并按会话作用域解析出一个 `InputTriggerController`（`sessionOf`）；会话接线层在控制器上驱动 `track`/`arbitrate`/`onSpace`/`adjudicate`。同一个控制器还暴露 `toggleSou

Input trigger pipeline: '/' and '@' detection, candidate menu, pick routing to registered sources

description: "在右侧边栏中预览文档：共享的文件加载与控制、可选择的 Markdown、代码、图片、PDF 和 HTML 渲染器，以及纯文本回退。" kind: "package-reference"

Extensible document previews for Sidebar files: Markdown, highlighted code, images, PDF, HTML, and plain text

阅读本包即可了解完整的 plugin 树及其组合顺序。

The default executor-less/UI-less agent spine with fallback session titles, provider-routed retry, and optional persisted goals

纯 React 附件原子组件（零 cordis）：composer 草稿图片栏（`AttachmentRail`）、聊天历史图片画廊（`MessageImage`/`ImageGallery`），以及原图灯箱（`ImageLightbox`）。所有字符串都通过 label props 传入，由所属插件自己的 locale 命名空间解析，这里不读取任何应用状态；`@deepseek-ai/dsh-client-ui-conversatio

Pure React attachment atoms for the dsh web UI: draft-image rail, message image gallery, and original-image lightbox (zero cordis)

阅读本包即可了解完整的 plugin 树及其组合顺序。

The default executor-less/UI-less agent spine with fallback session titles, provider-routed retry, and optional persisted goals

模型设置插件：提供方配置页面，以及官方 DeepSeek 的条件式引导步骤。它把三个 wire 域汇入同一份共享快照 —— `llm.providers`（可配置提供方目录，含每条路由的 live/dormant 状态）、`settings.describe`（序列化 schema、分层脱敏值、密钥槽位）和 `credentials.describe`（不含值的 configured/source/writable 徽标）—— 并以一次

Models settings and official-DeepSeek first-run routing over one live provider/settings/credential join

description: "DataOps 目标身份、浏览器 PKCE 授权、凭据生命周期、已认证的 MCP 子组合以及 Settings UI。" kind: "package-reference"

Standalone DataOps MCP integration with delegated browser authorization and Settings UI

description: "浏览器 Chat 目标，负责渲染 Session 会话节点、详情、历史图片、操作、本地化与滚动状态。" kind: "package-reference"

Chat Conversation target, node definitions, renderers, and details surface

DeepSeek Harness（DSH）插件：在会话底部统计行（composer dock，即 token 统计所在行）实时显示当前对话的费用和 DeepSeek 账户余额。**币种跟随界面语言自动切换：中文界面显示人民币（¥），英文界面显示美元（$）。**

DeepSeek Harness (DSH) plugin: live conversation cost and DeepSeek account balance in the composer stats row — RMB in Chinese UI, USD in English UI

description: "使用并调试实验性的 Web Agent Teams 名册、共享任务板和队友导航面板。" kind: "package-reference"

Web Agent Teams roster, task board, and teammate navigation

用户交互服务定义。它拥有 `ctx.userQuestions`，即面向模型的工具或权限插件在需要暂停工作、向人类请求决策时所使用的服务。

Abstract user-questions seam (ctx.userQuestions) for asking the human during agent runs

DSH 插件：把 Herdr 的 pane / agent 操作做成三个**注册式工具** —— `herdr_layout`、`herdr_pane`、`herdr_agent`。

DSH plugin: herdr_layout / herdr_pane / herdr_agent tools — inspect and create Herdr terminal topology, drive ordinary commands in panes, and control coding agents. Port of @muzi3/herdr's pane-agent-tools.

Persistent personalization plugin for the dsh Web GUI: conversation/sidebar backgrounds (solid, image, looping video), true-transparency opacity, liquid-glass effects with adjustable panel border, global font and text color, custom logo, multi custom-font

DSH skin plugin: Alphacoders popular wallpapers as the DeepSeek Harness Web GUI background (gallery, search, local upload, per-theme wallpapers, favorites, auto-change, history, glass blur)

DSH plugin: browser & Electron UI operation and verification — actions, assertions, and visual regression testing.

DSH plugin: visual session replay — browse, compare, and debug agent sessions in a local web UI.

DSH 插件雷达：定时扫描 GitHub 上 topic:dsh-plugin 的新插件，在 DeepSeek Harness Web 界面左下角推送卡片流，支持 README 关键词搜索与一键安装。

将 tavern-cards 的三套 skill 工作流接入独立 `@ai4rpg/dsh-stage-switch` 插件的 DSH 插件。设计决策记录见 docs/DESIGN.zh.md。

DSH plugin that brings tavern-design, tavern-cards, and tavern-ui workflows into dsh-stage-switch stages

dashi 是 DeepSeek Harness（DSH）的终端 UI。请通过 `@antst/dashi-app` 将其作为 bundle 安装， 而不要作为独立依赖安装：

A terminal UI for DeepSeek Harness