dsh-webui — DeepSeek Harness 会话增强全家桶

一个插件融合视图切换、消息导航、技能管理、供应商管理、辅助视觉、生图/生视频、记忆（hybrid 检索）、AI 浏览器、文件浏览器、Markdown 渲染、工具聚合、用量统计、网页搜索、定时自动化任务引擎、团队 Agent 编排（多团队多角色接力）、会话产物清单、对话退回与文件回退/修改历史对比、提示音、壳管理更新、插件自更新、网络代理、网关伪装接入、供应商限流、消息截图、中文思考、工作区临时垃圾清理等能力。纯插件实现，不改动 DSH 源码。

一句话安装（DSH）

dsh plugin --profile web add github:statem-li/dsh-webui

重启 DeepSeek Harness 即可。

本包在 package.json 声明了 dsh.bundle.patch（DSH rc.2 起的 bundle 契约），dsh plugin add 安装完成后 reconcile 会自动把它加入 profile 的 dsh.profile.bundles 层，挂载声明由包内 cordis.patch.yml 自带——无需再手动往 ~/.dsh/profiles/web/cordis.patch.yml 追加 insert。若你从旧版本升级且之前手动追加过同 id 条目，按 last-write-wins 合并，删除或保留均无害；已安装用户执行一次 dsh plugin update 即会自动激活。

注：webui 接管了技能 slash 源（/ 菜单），安装后需在 ~/.dsh/profiles/web/cordis.patch.yml 禁用内核 ui-skill 插件以避免同名源冲突：

- id: ui-skill
  name: "@deepseek-ai/dsh-client-ui-skill"
  disabled: true

按需启停功能模块

dsh-webui 是全家桶，但每个功能模块都可以单独关闭——不需要的功能不装配（host 不注册对应工具 / provider / HTTP API，client 不注册对应 UI 槽位），界面更干净、加载更轻。

配置方法（二选一，改完重启 DSH 生效）：

1. 编辑 ~/.dsh/profiles/web/settings.yaml，加 webui-modules 命名空间，把想关的模块显式写为 false（没写的模块全部保持启用，升级新增模块时老配置自动兼容）：

webui-modules:
  browser: false      # 不需要 AI 浏览器
  automation: false   # 不需要自动化
  team: false         # 不需要团队 Agent 编排
  peakValley: false   # 不需要峰谷时刻卡片

2. 调 HTTP API（适合脚本批量开关，部分覆盖合并写入）：

curl -X POST http://127.0.0.1:3080/api/webui-modules \
  -H "content-type: application/json" \
  -d '{"modules": {"browser": false, "automation": false}}'

生效机制：host 半身在插件加载时一次性装配，改动后需重启 DSH；client 半身启动时同步读本地缓存立即裁剪，并后台拉取 /api/webui-modules 校正缓存——重启后刷新页面，两端即按同一份配置生效。

模块 key 一览（false = 关闭；缺省全部启用）：

注意事项：

• 关闭 skills 后会失去内置 slash 两级导航源，此时应删除 cordis.patch.yml 里对内核 ui-skill 的 disabled: true 以恢复官方 / 菜单。
• 关闭 providerHub 将失去供应商/视觉/生图/生视频模型的配置入口（已保存的配置仍生效）。
• 核心能力不提供开关、始终启用：视图图块与消息导航、markstream 基础 Markdown 渲染、供应商标签、移动端响应式。

功能总览

对话体验

模型与供应商

技能

Markdown 渲染

markstream 流式渲染 + Shiki 代码高亮 + 悬浮目录（TOC）/ 标题锚点 + 提示块（admonition）/ 脚注 / 定义列表 / 任务列表 / 数学公式（KaTeX）+ 思考 chip + 图表。

• 提示块：:::note / :::tip / :::warning / :::danger / :::error 围栏容器，支持自定义标题（:::warning 注意）。
• 目录 / 锚点：正文标题 ≥ 3 个时自动在顶部生成可折叠目录，点击平滑滚动。

对话流卡片

对话流按「回合」分层呈现：

流式输出中的片段不包卡（避免边框随文字增长反复重排）；中断的回合总结卡转为琥珀色顶边与「已中断」徽章。统计数字全部取自已有会话投影（turnTimings、本回合节点计数），不新增轮询或订阅。

图表（流程图 / 架构图 / 时序图）

语言标记为 mermaid 的代码围栏直接渲染成图，覆盖 flowchart / sequenceDiagram / stateDiagram-v2 / erDiagram / classDiagram / gantt / mindmap / timeline / block-beta / architecture-beta 等图种（各图种关键字也可直接作为围栏语言）。

卡片带图种标签与操作：复制源码 / 导出 SVG / 图⇄源码切换 / 放大整屏查看，配色随 DSH 深浅主题走品牌蓝。

零常驻开销的实现方式（这是本功能的关键约束）：

失败降级：引擎加载失败或语法错误时原样展示源码 + 一行错误说明，不吞内容。整个能力可用模块开关 diagram: false 关掉。

AI 浏览器（壳内多标签，零独立浏览器进程）

浏览器不再是独立的 Edge/Chrome 进程，而是 DeepSeek Harness 壳子内部的多标签 WebContentsView——桌面永远不会弹出浏览器窗口，任务栏无图标，AI 操作的页面实时内嵌在对话面板右侧滑出的抽屉里（原生渲染 + 鼠标键盘直接命中）。

架构

• 壳子（main.js）内置视图宿主：每会话一个 persist: 分区（登录态隔离），每标签一个 WebContentsView
• 控制通道 http://127.0.0.1:3081（仅回环）：/view/create-tab|attach|detach|close-tab|close
• CDP 调试端口动态协商：壳子启动时从 9224 起挑空闲端口并写入 D:\AI\Dsh\.shell-cdp-port，插件启动后读取该文件连接（不要写死端口——异常退出的壳子会留下僵尸监听）
• 标签 ↔ CDP target 映射：创建时用 URL hash 匹配，再用 window.name 持久标记——服务/壳子重启后视图存活可复用
• 抽屉打开 = 视图挂载到画面区（激活标签关闭 JS 节流，全速）；抽屉关闭 = 视图卸下（visible=false + 恢复节流，空闲 CPU 趋近 0）

工具速查

元素定位：ref / selector / text_match 三选一

所有元素操作工具都接受三种定位方式，任选其一：

后两者不需要先 browser_snapshot，页面变化后也不必重拍——每省一次快照就省一整轮 LLM 推理。

效率技巧：连续操作用 browser_batch

逐个调用 browser_click / browser_type 时，每个动作都要一整轮 LLM 推理（2040 秒），注册表单这类 1020 步的任务会拖到 6 分钟以上。改用 browser_batch 把整段流程压成一次调用：

{"action": "browser_batch", "actions": [
  {"action": "type", "selector": "#email", "text": "me@example.com"},
  {"action": "type", "selector": "#password", "text": "密码123"},
  {"action": "click", "text_match": "同意条款"},
  {"action": "click", "text_match": "注册"},
  {"action": "wait", "text": "注册成功", "timeoutMs": 8000}
]}

任一步失败立即中止并报「第 N 步失败 + 原因 + 已完成步骤」；全部成功返回最终快照。给 AI 的指令里写一句「用 browser_batch 批量完成」即可触发。

提速策略已默认常驻：插件会把「batch / evaluate 优先」的提速策略作为系统提示词自动注入（settings 命名空间 browser-speed，默认开启、关闭时零 token 占用），无需每次在指令里点名；开关在 dock 工具条悬停权限卡片里。

元素选取

dock 工具条「选取元素」按钮进入选取模式，点击预览画面任意元素，自动采集唯一 CSS 选择器 + 元素摘要并回填对话框草稿（再点一次或 Esc 退出）。详见 docs/ELEMENT-PICKER.md。

抽屉 UI

抽屉里是一套完整的浏览器 chrome，自上而下三条 38px 等高行 + 画面区 + 底部时间线：

• 地址栏：非编辑态显示「安全标识 + 域名强调 + 路径淡化」，点击进入编辑并全选，Enter 导航、Esc 取消；导航中底缘显示进度轨。
• 宽度可调：左缘 4px 拖拽把手，范围 520px ~ 视口宽 −44px，结果持久化（localStorage）。
• 左侧留白区点击或 Esc 收起抽屉；收起后浏览器视图卸下、不占任何资源。选取模式或「更多」菜单打开时，Esc 只关闭它们。
• 图标全部为内联 SVG（browser/icons.tsx），规格对齐 DSH 官方 ui-primitives：28px 图标按钮 (r14)、24px 胶囊 (r12)、30px 输入件 (r8)、border-l2 细线。文字对比度在明暗 × 玻璃开关四种组合下均达 WCAG AA。

定时自动化任务引擎

左侧导航「新会话」下方菜单项，点开从菜单右侧滑出 TAB 式浮层卡片（窄屏回退底部 sheet），分「任务计划 / 运行记录」两个 Tab。

• 任务计划：工具栏「＋ 新建」创建任务（调度类型：单次 at / 固定间隔 every / 5 字段 cron；执行 prompt；绑定模型与推理等级或留空用默认模型）+ AI 待确认建议区——Agent 通过 automation 工具发起的 create/update 先落为建议卡，用户二次确认后才生效
• 真实执行引擎（host 半身）：CronStore 持久化到 ${DSH_HOME}/automation/dsh-webui/，服务进程内 60s tick 调度——GUI 关闭照常触发；到期任务经 ctx.llm 以绑定模型真实执行并记录运行历史；连续失败计数驱动退避，配置修订号乐观锁防运行中编辑错写
• 运行记录：每次执行落一条 jsonl 记录（success / error / skipped + 起止时间 + 输出摘要 + 完整产出全文回看）
• Agent 协作：automation 工具供 Agent 列出全部任务、以自然语言建议新建/修改任务（经用户确认生效）

团队 Agent 编排（team）

把「多角色 AI 团队分工协作」做成可编排的数据：多个团队，每个团队有自己的角色集、协作链、 团队默认模型；一次任务按链条串行接力，末尾由主脑整合成最终交付物。

• 多团队：一团队一文件持久化（${DSH_HOME}/team/teams/<id>.json，可直接编辑 / 纳入 git / 导入导出）， 支持新建（空白或套用出厂编制）、复制、重命名、删除、恢复出厂编制；面板顶部团队切换器
• 一句话生成团队：面板「✨ 一句话生成」/ 对话内 team_create 工具——描述一句需求，模型设计出 完整编制（角色 + 各自的系统提示词 + 分组 + 协作链 + 关联关系）并落盘为新团队；生成只产结构不产 模型绑定（角色统一继承团队默认模型，避免模型编出不存在的 provider/model）；解析失败不留半成品
• 全高抽屉面板：占满右侧可视区（min(1180px, 92vw)），编制页为「左画布 + 右检视栏」双列， 抽屉窄于 860px 时自动退化为上下单列
• 可交互编制画布：SVG 手绘（无第三方图表依赖）——节点可拖拽排布（归一化坐标持久化，窗口缩放 等比例保持）、拖节点右下角连接柄建立关联、点连线可改单/双向或删除、一键「自动重排」； 中心主脑 + 分组配色，选中链高亮接力路径，运行中角色节点点亮并呼吸；拖拽只改一处 transform， 松手才保存一次（不影响性能）
• 模型分层可设置：团队默认模型 → 角色可单独覆盖（下拉首项固定「继承团队默认」）→ 单次运行还能临时覆盖。 解析优先级 本次运行 > 角色覆盖 > 团队默认 > 全局默认，每步开始时解析一次并记录来源层（运行中改配置不影响在跑的步骤）
• 每角色能力装配（插件工具 + 技能包）：角色编辑面里按角色开关——工具（继承全部 / 只允许所选白名单 / 禁用所选黑名单）
  • 技能（不限制 / 只用所选 / 不用技能）+ 技能包多选（选中即展开包内技能）。subagent 通道走 DSH 原生 toolFilter 真实限制（未授权工具从子 agent 提示词消失且拒绝执行）；llm 直跑通道无工具，工具装配仅作声明、 技能则把正文内联进提示词（按预算截断）。装配清单里当前环境缺失的名字只提示、不阻断执行。
• 出厂编制：主脑 brain 星见（中枢）+ architect 观月 / strategist 凛音（信息与判断）+ coder 琉夏 / tester 星乃（落地执行）+ reviewer 神代（守护支持）， 两条预设链：full-delivery 观月→琉夏→神代→整合、fast-iteration 琉夏→星乃→整合
• 两条执行通道：llm 直跑（精确用设定模型，无工具）/ subagent（完整 agent，可读写文件跑命令，模型继承会话）； 角色 executor 为 auto 时按触发上下文自动选择（面板触发→llm，对话内触发→subagent）
• 对话框团队开关：输入区「团队」图标（order 4，提示词优化左侧）→ 悬浮卡选团队/链条/强制模式， 会话级持久化；开启后 host 动态注入系统提示词，模型在需要多角色协作时自行调用 team_run（零 DSH 源码改动）
• 对话流执行 HUD：运行中在对话区顶部浮出——团队名·链名、步骤圆点、总耗时、TODO 进度条， 运行一开始即实时显示（新运行自动展开面板；页面会话错位/切会话后仍能跨会话兜底显示全局在跑的团队）， 展开后是每角色一张运行卡（状态灯呼吸 / 实际模型 + 来源徽标 / 单步计时 / 流式输出摘要 / 点开看全文）， 支持取消运行、多团队并发分段、结束后停留 15s 再收成小胶囊
• 产物落盘：${DSH_HOME}/team/runs/R-<ts>-<rand>/（run.json + steps/NN-<role>.md + final-deliverable.md）
• 工具：team_create（一句话生成团队）、team_list（列出团队与链）、team_run（启动并等待完成，返回最终交付物）、team_status（查运行状态与每步模型来源）
• HTTP API：/api/webui-team/{teams,globals,providers,capabilities,chat-mode,runs}（loopback-only）； settings 命名空间 webui-team 承载全局默认（超时/重试/并发/上游预算/失败即停）

记忆

• 记忆引擎：侧边栏记忆面板 + 会话记忆注入 + 注入开关 + 手动写入长期记忆
• 面板（主从布局）：左列紧凑条目行（标题 / 摘要 / 相对时间 / 重要度迷你条 / 作用域徽章 / 行内启用开关），右列详情（语义徽章 + 重要度与置信度 + Markdown 正文 + 标签 + 版本/创建/命中脚注）；顶部 Tab 组带统计条（记忆数 · 项目数 · 置顶 · 长期 · 已禁用），项目胶囊带条目计数，工具行 = 搜索（260ms 防抖 + 一键清除）· 标签下拉 · 刷新 · 一键整理 · 添加 · 多选；四个 Tab（全部 / 变更 / 修订 / 设置）各自按需加载，切 Tab 不会把所有接口重打一遍
• 条目编辑：内容 / 标签 / 重要度 / 置顶 / 记忆类型（身份·偏好·事实·决策·踩坑·会话摘要）/ 归属（全局 ⇄ 项目）在同一编辑面完成；项目可就地改别名（清空回退目录名）、按项目开关自动记忆、清空该项目记忆（置顶豁免）
• 变更 / 修订：变更 Tab 可切「今天 / 全部」，动作徽标按语义配色（新增绿 / 沉淀金 / 删除红），改写类变更左右并排对比；修订 Tab 列出整理前快照并可一键回滚
• 设置 Tab：分组行卡片（注入 / 提取 / 编译与衰减 / 整理 / 诊断），每项显示取值范围与说明，数值失焦或回车才提交（避免把「删空重打」的中间态写进配置），越界由 host 钳制，另有「恢复默认」
• 本地 hybrid 检索引擎（零外部依赖）：keyword 精确子串 AND 命中；hybrid（默认）= 字符 n-gram Jaccard 相似度 + 精确命中加成 + 元数据加权（verified / confidence / importance）；semantic 模式预留，待 embedding 接口可用时替换打分实现即可。面板搜索与 memory_search 工具走同一套打分，不会出现「工具搜得到、面板搜不到」
• Memory Dream 记忆巩固：每天（或手动触发）用 LLM 对记忆做语义化整理——合并近重复/强相关条目、精炼重写、删除过时/低价值、提升长期；与每日规则化衰减/折叠（处理「分数」）正交叠加，本引擎处理「语义」
• 安全设计：输入排除 pinned 与已禁用条目（保护用户明确标记/冻结的内容），apply 时按 id 锚定防误删；整理前写入 revisions 快照支持一键回滚；LLM 失败/超时/解析失败一律空结果，绝不阻塞每日编译
• 回归测试：npm run test:memory（scripts/test-memory.mjs）覆盖配置钳制、注入文本预算累积、记忆分类、条目 id 派生与合并，以及 HTTP 路由（含批量删除 / 配置合并写 / 变更全量查询 / 项目 hash 派生）——不依赖 DSH 运行时、不碰用户数据

用量与统计

文件与工作区

外观与系统

构建（Windows）

node D:\AI\deepseek-harness\node_modules\tsdown\dist\run.mjs   # host + client bundle

Linux/macOS：DSH_CHECKOUT=<checkout> bash scripts/build.sh

结构

src/
├── index.ts                  — host 半身入口：各能力模块装配（按模块开关裁剪）
├── modules.ts                — 功能模块 key 清单与开关解析（host / client 共用）
├── modules-host.ts           — 模块开关 host（settings 命名空间 webui-modules + GET/POST /api/webui-modules）
├── team/                     — 团队 Agent 编排（types / seed 出厂编制 / store 多团队存储 / roster 模型解析 / prompts / engine 运行引擎 / capabilities 能力装配 / generate 一句话生成 / chat-mode 提示词注入 / tools / host 路由）
├── automation/               — 定时自动化任务引擎（store / scheduler / executor / tool / suggestions / routes）
├── deliverables.ts           — 会话产物记账 host（/api/webui-deliverables，按会话白名单授权）
├── devrole-probe.ts          — 供应商 Developer Role 兼容性一键检测 + 自动修复
├── gateway-rewrite.ts        — 网关伪装接入（fetch 层按域名改写 UA + 可选代理 dispatcher；/api/webui-gateway-rewrite）
├── provider-throttle.ts      — 供应商限流（fetch 层按域名 RPM 令牌桶 + 并发信号量；/api/webui-provider-throttle）
├── screenshot/               — 对话截图 host（card 卡片模板 / theme 主题 / presets 设备×画质 / renderer 常驻无头浏览器 / 路由 render·save·reveal·image）
├── diagram.ts                — 图表支撑 host（/dyn-assets/vendor/mermaid.min.js 按需下发 + 作图提示词开关）
├── memory/                   — 记忆引擎（engine/retrieval.ts 本地 hybrid 检索、engine/consolidate.ts 为 Memory Dream 语义整理）
├── vision-helper.ts          — 辅助视觉 + 生图 + 生视频能力与 HTTP 接口
├── skill-toggles.ts          — 技能开关路由（读写 SKILL.md frontmatter）
├── usage-host.ts             — 用量统计 + 技能管理 host
├── sidebar-float.ts          — 悬浮侧边栏设置
├── message-width.ts          — 消息气泡宽度设置
├── prompt-optimize.ts        — 提示词优化 host 路由（loopback-only，SSE 流式 + 风格档位）
├── prompt-optimize-clean.ts  — 优化结果清洗纯函数（去围栏/小标题/结尾说明，两端共用）
├── appearance.ts             — 玻璃质感设置（/api/webui-appearance）
├── plugin-update.ts          — 插件自更新 host（/api/webui-plugin-update：检测上游版本/提交 + 增量补丁 / 整包重装 / git pull）
├── plugin-update-patch.ts    — 增量更新纯函数内核（unified diff 解析与应用 + git blob sha 校验，可单测）
├── done-pill.ts              — 对话完成胶囊 host
├── voice.ts                  — 语音播报 host（朗读进程 / 多会话话筒仲裁 / 静音 / 结论总结；/api/webui-voice + /speak /summary /stop /mute）
├── voice-text.ts             — 播报文本纯函数（Markdown 清洗 / 流式分句 / outcomeSummary 结论提取，两端共用）
├── rewind.ts / rewind-diff.ts / screenshot.ts — 对话退回（git 式内容寻址快照）/ 行级 LCS 对齐 diff / 消息截图 host
├── workspace-dir-picker.ts   — 工作区目录选择器
├── tmp-cleaner.ts            — 工作区临时垃圾清理器（_tmp 约定目录 + 规则扫描 + 调度 + webui_tmp_clean 工具）
├── browser/                  — AI 浏览器 host（壳内多标签对接 + CDP 原语）
└── client/
    ├── index.ts              — client 入口：注册各 UI 槽位（按模块开关裁剪）
    ├── modules.ts            — 模块开关 client（localStorage 同步读 + /api/webui-modules 校正）
    ├── skill-source/         — 技能 slash 两级导航源 + 技能工具行
    ├── session-pin/          — 会话置顶 / 归档 / 右键菜单 / 重命名
    ├── provider-hub/         — 供应商设置页（chat / vision / image / video）
    ├── automation/           — 自动化面板（Tab 浮层：任务计划 / 运行记录 + AI 建议确认卡）
    ├── team/                 — 团队编排 client（Panel 全高抽屉 / TeamGraph 可拖拽关联画布 / RoleCard / CapabilityEditor 能力装配 / ChainEditor / ModelSelect / GenerateModal 一句话生成 / ChatToggle 对话框开关 / RunHud 执行 HUD / RoleRunCard 角色运行卡）
    ├── markdown/             — markstream 渲染（Shiki 高亮 / stub 替换层）+ flow-card.tsx 对话流卡片 + diagram.tsx 图表块（引擎懒加载）
    ├── memory/ browser/ file-explorer/ image-gallery/ tool-summary/ message-deliverables/
    │                         — 记忆面板（含 SettingsTab）/ 浏览器 dock / 文件浏览器（FileHistoryView 修改历史、预览总线）/ 图库 / 工具聚合 / 会话产物大卡片
    ├── usage/                — 用量工作台（TrendTab / SignalTab / RangePicker / Heatmap / AreaChart）
    ├── done-pill.tsx         — 完成胶囊 client
    ├── voice/                — 语音播报 client（SettingsRow 全局默认 / ChatToggle 本会话开关与静音 / announcer 播报驱动 / store 会话覆盖与订阅 / session-label 会话名）
    ├── glass.ts / glass-row.tsx — 玻璃质感 client
    ├── session-motion.ts     — 会话切换柔和过渡
    ├── sidebar-float*.ts(x)  — 悬浮侧边栏 client
    ├── shell-titlebar.ts     — 壳子窗口控制按钮共存样式
    ├── tmp-cleaner-card.tsx  — 临时垃圾清理设置卡（计划 / 预览 / 立即清理）
    ├── plugin-update-card.tsx — 插件更新设置卡（检查更新 / 增量更新 / 强制重装 / 日志）
    ├── gateway-rewrite-card.tsx — 网关伪装接入设置卡（UA / 代理 规则列表）
    ├── provider-throttle-card.tsx — 供应商限流设置卡（RPM / 并发 规则列表）
    └── styles.ts             — 注入样式
docs/
├── ELEMENT-PICKER.md         — 浏览器元素选取设计文档
└── TEAM-ORCHESTRA.md         — 团队 Agent 编排插件设计文档（v0.5：多团队 + 团队级模型 + 对话框开关 + 执行 HUD + 可拖拽关联画布 + 一句话生成 + 每角色工具/技能装配）

许可

BSD-3-Clause