dsh-chat-plus

September 24, 2026 · View on GitHub

把 dsh-webui 全家桶里的对话体验拆成独立插件(webui 卸载后补回),并融合原 dsh-triad 的四个工作台,零 DSH 源码改动、纯插件注入。能力分六组:

  • 回合呈现:思考行 / 工具行(官方 turn-process 同款,实时走秒 + 分步跟随滚动)· 对话流卡片 (步骤卡 / 总结卡,回合收口才出现)· 共享活动抽屉(思考语义分组 + 工具调用树)
  • 动效(移植自 aa2246740/dsh-better-display,MIT):思考两行步进跟随(840ms 停顿 / 500ms 走两行,上翻即停)· 流式新文字淡入(只动新挂载块,旧文不动)· 忙碌标签 2s 微光 · 工具行 / 气泡展开收起过渡(260ms / 200ms,播完再卸载)
  • 正文增强:proto-tabs 可交互卡片(pill / expand / glow)· diagram 流程图围栏 (JSON → SVG)· 生图画廊条 · 重试行影子
  • 界面与工具:会话头部「对话 / 轨迹」标签上移到右上角 · 桌面壳窗口控制留位与主题同步 · 对话截图(无头浏览器出图,可内嵌本地 HTML)· download 下载工具(wire 工具 + 实时进度条)
  • KR 对话双栏大盘:右栏只保留任务 / 思考 / 工具调用 / 记忆四张卡。顶栏(机器人头像
    • 标题 + 统计副标题 + 截图 / 收起按钮)默认隐藏,由 KR_PANEL_HEADER_VISIBLE 单独门控; 工具调用默认整块折叠、一条不预展(展开入口在标题行右端);记忆卡常驻 footer 钉在右栏最下方, 分区有本会话新增才显示(按条目溯源 provenance.sessionId 等值判定),无新增的分区整个不出现, 支持多选批量删除; 右栏被挤压时思考卡视口行数逐档自动缩小(25→18→12→8→5)
  • 四工作台(原 dsh-triad,已融合):自动沉淀的长期记忆 · 定时自动化 · 用量与账号趋势 · 技能与 MCP Server 管理。dsh-triad 自此退役,其座位(slot id / order / locale namespace)、 8 组 HTTP 路由前缀、数据与配置目录全部原样保留,用户零迁移

产物约 5.4 MB(host 3.9 MB + 浏览器半身 448 KB + mermaid 资源 968 KB),浏览器侧只加载 448 KB。

能力说明
思考行无工具调用的回合只剩这一行官方 turn-process 同款(已思考 › + 底部发丝线);有工具调用时并入工具行(抽屉里仍有思考分区;流式思考中工具行下方同步挂实时预览卡,收口自动消失)。思考中实时走秒(思考中 · 12.3s,2s 微光)+ 实时预览卡片(标题「思考 · 步骤 N」+ 有界视口 224px + 上下缘渐隐;分步跟随 840ms 停顿 / 500ms 走两行,上翻/选中即停,滚回底部自动恢复),点击 chip 行打开共享活动弹窗看全文
工具调用聚合直接接管官方 turn-process control 位:每回合只留一行官方同款(N 次工具调用 › + 底部发丝线,文案走官方 chat locale 键,中英文自动切换),点正文进活动弹窗、点尾部 chevron 走官方内联折叠——再无双行;有思考的回合行尾缀思考数(N 次工具调用 · 思考 M,与弹窗页签同口径)。弹窗内容:工具调用总结卡(次数/进行中/失败/按工具分布/涉及文件点击跳转)+ 调用卡片(图标 + 变体标题 + 一行摘要 + 阶段徽标,展开后是台账与结果/输入/原始数据页签,命令/读写/差异/搜索/网页结果用原生展示块,子调用沿左导轨递归)。无 control 的回合(非紧凑模式/流式中)回退到成员槽位自有行
对话流卡片总结卡头部 chip 含 Git 操作计数(本轮 git 调用次数,悬停看动词摘要);头部单色分层(标签弱化 + 数值加强 + 状态圆点,仅对勾留一笔语义绿,hover 上浮);全卡片去底色(1px 超细发丝边条 + 轻阴影,深浅主题各配色)
共享活动抽屉浏览器侧居中对话框(dim 遮罩 + 面板,z-index 9990/9991,截图面板同款框架;打开底部上滑进入、关闭淡出,播完再卸载),头部分区页签(思考 N / 工具 N,两边都有内容时可切,行点击只决定初始分区),思考按语义分类成组(实施编写/原因排查/验证确认/规划方案/决策权衡/总结汇报/探索分析),工具调用按树展开(行展开/收起 260ms 高度补间);Esc/点遮罩关闭
可交互卡片正文里的 proto-tabs 围栏渲染成可点击的 Tab 卡片(信息分层 pill / 可展开卡片 / AI 流光三种形态,缺省 pill);解析失败自动回退原文,绝不崩卡
对话截图assistant 消息操作栏相机按钮 → 截图面板(范围本条回复/这一轮/整段会话 × 版式电脑/手机 × 画质 1080P/2K/4K × 画幅 × 五套主题(浅/深/玻璃/玻璃深/阅读版);标题/徽章可编辑;预览后保存/复制/下载/打开目录;「元素删除」编辑模式点击页面删元素再重新生成)。正文里提到的本地 HTML 会自动内嵌进截图(走 file:// iframe,同目录样式图片照常加载,只嵌页面本身,最多 3 张);host 端常驻无头浏览器渲染卡片(markdown-it + shiki + mermaid 真图),保存目录 ~/.dsh/storages/dsh-chat-flow-screenshot
会话头部视图标签官方把「对话 / 轨迹」两个视图标签独占标题下方一整行(header 76px);本插件把 header 改成单行 flex,标签钉到右上角与标题同行(header 收回 45px,省下的 31px 还给正文),下划线贴字、hover 从中心展开、选中常驻蓝条。纯 CSS 注入,选择器只用 header / role=tablist / CSS Module 的 _titleRow、_tab 后缀,不依赖构建 hash 前缀;单视图(无 tablist)时 :has 不匹配,零影响。桌面壳(Electron 无边框窗口)右上角自绘 最小化/最大化·还原/关闭:与壳走 dsh:shell-hello → dsh:shell-chrome 能力握手,收到应答才给 <html> 挂 dsh-in-shell(旧壳不应答 = 行为不变,不留空档),header 右 padding 28px→128px,右侧控制簇(工作区按钮/更多/侧栏展开/对话·轨迹)整体左移 100px 留位;同时监听 <body data-ds-dark-theme> 把主题以 dsh:theme postMessage 给壳,壳按钮颜色随界面深浅同步。浏览器直开两者零影响
KR 对话双栏大盘左栏官方 ChatView 原样保留,右栏是全高执行大盘。四张卡自上而下:任务(来自本轮 todo_write / 官方 todos 实时投影,有真实任务才出现)→ 思考(有界视口 + 实时跟随滚动,默认 25 行封顶)→ 工具调用(默认整块折叠、一条不预展,标题行只留「展开 N 次调用」入口,展开后是全量台账与结果 / 输入 / 原始数据页签)→ 记忆(sticky 常驻底部,见下条)。四个开关都在 src/client/kr-chat/enabled.ts:KR_CHAT_ENABLED(整套 KR 视图)、KR_PANEL_HEADER_VISIBLE(顶栏,默认 false)、KR_MEMORY_CARD_VISIBLE(记忆卡,默认 true)——全是隐藏而非删除,改回 true 即恢复。顶栏隐藏后能力不丢:收起 / 展开走标签行最右端的「Agent 轨迹大盘」开关(#kr-panel-toggle-btn),截图走 assistant 消息操作栏相机按钮。挤压自适应:use-adaptive-rows.ts 用 ResizeObserver 监视 .kr-panel__scroll,溢出时把思考卡视口行数逐档下调(25→18→12→8→5),空间恢复即回升,只在档位真正变化时 setState(不进 ResizeObserver 自激循环)
记忆卡(KR 右栏)数据面走 host 的 /api/dsh-memory/*(纯 fetch,无 typert)。口径 = 本会话新增,有新增才显示:分区只列这个会话写下 / 更新过的条目——按条目溯源 provenance.sessionId 等值判定(host 在自动提取、memory_remember / memory_revise 写入时落盘),不按时间:时钟偏差、刷新、切会话都不影响结果;本会话更新过的记忆(upsert 撞已有条目)同样刷新溯源算本会话。没有新增的分区整个不渲染(无占位行),两个分区都无新增时卡体收成一行头部;不再提供「全部 N」历史逃生口(全量历史走侧边栏记忆工作台)。工作区分区再叠加当前 cwd → projectHash 限定(path 匹配,不自己复刻 sha1)。删除:分区标题行「选择」进多选态 → 勾若干条 →「删除」→ 行内「确认删除 N 条?」→ POST /delete-batch,乐观摘除、失败整份回滚。记忆模块不可用时整卡降级成一行「记忆模块未就绪」,不崩其余卡片
四工作台(原 dsh-triad)2026-09-24 融合:dsh-triad 的 host / client 两半身整体搬进 src/triad/ 与 src/client/triad/(host 45 文件 + client 74 文件,SHA256 逐一比对零差异),dsh-triad 从 profile bundles 摘除。侧边栏四入口:自动化(首行)/ 记忆 / 能力 / 用量。8 组路由前缀与工具名一字未改:/api/dsh-memory/*(面板数据 + 裁决操作)、/api/triad-automation/*、/api/usage-stats/*、/api/skill-manager/*、/api/skill-toggles/*、/api/skill-health、/api/mcp-recommended、`/api/triad/mcp-status

正文链路保持官方:text 块用官方 MarkdownText(ui-primitives)、图片走官方 renderMessageImages 槽——不引入 markstream / shiki / katex(截图渲染是 host 端独立管线,不受影响),流式渲染与内置 UI 完全一致,性能零负担(不做常驻 轮询,统计全部来自已有会话投影)。截图引擎空闲 5 分钟自动回收,卸载即关。

流程图卡片(diagram,flowchart)

diagram 围栏放 JSON(坐标 /4 网格,节点 ≤9、边 ≤12,非法结构自动回退原文):

{"type": "flowchart", "title": "标题", "desc": "一句话", "nodes": [{"id": "a", "shape": "oval", "x": 280, "y": 24, "w": 160, "h": 48, "name": "开始", "sub": "start"}], "edges": [{"from": "a", "to": "b", "label": "是", "accent": false, "pts": [[360,72],[360,120]]}]}

shape 三选一 oval / rect / diamond,pts 为完整折线点(含起终点,圆角自动倒)。size 缺省 full,紧凑版设 "size": "compact"(去副标签和图例,矮四成)。卡片右上角另有“紧 / 标 / 大”切换,看图的人可随时改比例(放大横向滚动)。视口自动贴合内容宽度,窄图不留两侧空白。

可交互卡片(proto-tabs)

总结时想放可点卡片,正文里加一个围栏(JSON,tabs 最多 4 个,minis 每 Tab 最多 4 条):

{"title": "胶囊组件重构设计提案", "tabs": [{"label": "方案 A:信息分层", "variant": "pill", "heading": "高可读性重构", "pill": {"tag": "Embedding 向量嵌入", "desc": "把文字映射为多数值向量", "detail": "点击展开的详情"}, "minis": [{"t": "1. 视觉锚点", "d": "专有名词打 Tag"}]}]}

variant 可选 pill / expand / glow,缺省 pill(方案A)。未闭合围栏(流式中)与非法 JSON 都按原文显示。

host 半身改动要重启 DSH 服务才生效(托盘「重启服务与程序」);client 半身刷新页面即可。

KR 对话双栏大盘

在 header 的 tablist 里注入第三个视图分类「KR对话」,与官方「对话 / 轨迹」并列。 底层仍是官方 ChatView(多轮历史、虚拟滚动、Markdown 渲染、底部输入框全部保留), 右侧多一栏全高执行大盘:

┌─ 左栏(官方 ChatView,100% 原生)──┬─ 右栏 KrAgentPanel ──────────┐
│                                    │ ┌ 任务 ────────────────────┐ │
│   [user]  …                        │ │ todo_write / 官方 todos  │ │
│   [assistant] …                    │ └──────────────────────────┘ │
│   …                                │ ┌ 思考 ────────────────────┐ │
│                                    │ │ 有界视口,25 行封顶      │ │
│                                    │ │ 挤压时逐档缩到 5 行      │ │
│                                    │ └──────────────────────────┘ │
│                                    │ ┌ 工具调用 ───────────────┐ │
│                                    │ │ 默认折叠,只留展开入口  │ │
│                                    │ └──────────────────────────┘ │
│                                    │ ┌ 记忆 ───────────────────┐ │
│                                    │ │ sticky 常驻底部         │ │
│                                    │ │ 只列本会话新增          │ │
│                                    │ └──────────────────────────┘ │
└────────────────────────────────────┴──────────────────────────────┘

四个开关(src/client/kr-chat/enabled.ts)都是隐藏而非删除:

开关默认控制
KR_CHAT_ENABLEDtrue整套 KR 视图(「KR对话」标签 + 右栏 + KR 专属 CSS)
KR_PANEL_HEADER_VISIBLEfalse右栏顶栏:机器人头像 + 标题 + 统计副标题 + 截图 / 收起按钮
KR_MEMORY_CARD_VISIBLEtrue「记忆」卡片

改回 true 重新 build(client 半身刷新页面即可)就恢复。

记忆卡的本会话口径

「本会话新增」的判定基准是条目溯源,不按时间:host 在写入/更新条目时把 provenance.sessionId 一并落盘(自动提取、memory_remember / memory_revise 都填), 前端拿当前 sessionId 做纯等值比较。

  • 与时间无关:时钟偏差、刷新时机、切会话都不影响结果;条目属于哪个会话由写它 的那次调用说了算,不再用「进入会话的时间基线」猜(旧实现的 localStorage 基线 + 5 分钟时钟冗余已移除)
  • 更新也算:upsert 撞上已有条目时同样刷新溯源,本会话更新过的记忆照样出现在 本会话口径里
  • 旧 host 过渡窗口:host 半身要重启 DSH 才生效,旧 host 不返回 provenance 时 本会话口径显示「暂无」——宁可少显示,也不把别的会话的记忆混进来

挤压自适应

use-adaptive-rows.ts 用 ResizeObserver 监视 .kr-panel__scroll:

  1. 判定挤压 = scrollHeight > clientHeight + 1
  2. 从默认 25 行逐档下调(25→18→12→8→5),每档重新测量
  3. 只在档位真正变化时 setState——ResizeObserver → setState → 高度变化 → 再次触发 这条链最容易写成死循环,档位比较是唯一的刹车
  4. 不再溢出且当前低于默认档时回升一档(带回退,避免在阈值上抖动)

四工作台(原 dsh-triad 融合)

2026-09-24 把 dsh-triad 整体并入本插件,dsh-triad 从 profile bundles 摘除: 侧边栏的自动化 / 记忆 / 能力 / 用量四个入口与各自的面板,现在都来自这一个插件。

为什么整包搬而不是各自调用:dsh-triad 的 client 半身本来就是「纯 fetch + 同源 路由」的形态(createMemoryApi() 就是 fetch 包装),host 半身的路由与工具在 DSH 的 service 图上是一等公民。只调它的 API 会让两插件之间形成隐式的加载顺序依赖(谁先挂载、 对方没装怎么办),而整包搬之后四工作台的装配仍按「每模块一个 try/catch」,一个挂不起来 不影响其他三个。

融合时守住的三条:

  1. 座位与命名空间原样保留 —— slot id / order / locale namespace / 8 组路由前缀 / 工具名 / 数据与配置目录一字未改,用户侧零迁移
  2. 相对路径同构 —— dsh-triad 的 vendor/ 实际在仓库根(不是 src/vendor/), 所以搬到 src/vendor/,让 src/triad/host.ts 的 ../vendor/... 与 memory/engine 的 ../../../vendor/... 一个字符都不用改;86 条相对 import 逐一 验证可解析
  3. 重名不覆盖 —— modal-animation.ts 两版内容不等价(triad 版多 drawer keyframes,且 STYLE_ID 刻意加 dsh-triad- 前缀防样式表互相吞并),改名 triad-modal-animation.ts;error-boundary.tsx 经 diff 确认等价,直接共用

一个被实测证伪的假设

原以为 @deepseek-ai/dsh-util-crypto 可以像 dsh-triad 那样留在 allowlist 里(它有 lib/index.js 且自身零导入)。实测证伪:profile 的 node_modules 里根本没有这个 包,DSH 自己靠 tsx 的 tsconfig.base.json paths 才跑得起来,而 tsx 的 paths 只对 不在 node_modules 里的 importer 生效。装进 profile 的插件拿到的是裸 node 解析 → ERR_MODULE_NOT_FOUND。所以一并 vendor 化到 src/vendor/dsh-util-crypto/,现在 host 产物对 @deepseek-ai/* 零运行时依赖,assertHostExternals() 的空 allowlist 就是 这条约束的守门人。

冒烟(四套)

node scripts/smoke-client.mjs       # 对话增强:7 座位 / 9 样式表 / KR 开关同源自适应
node scripts/smoke-host.mjs         # 本插件 host:3 路由 + download 工具
node scripts/smoke-triad-host.mjs   # 四工作台 host:8 组路由 + 记忆 8 工具 + 自动化 + agent 钩子,路由零撞车
node scripts/smoke-triad-client.mjs # 四工作台 client:Token 活动 52 周热力模型等纯逻辑

smoke-triad-host.mjs 从已安装位置加载 host 半身(@deepseek-ai/* 在 profile 里才 可解析),并显式等一拍让被 await 的异步挂载(usage / skills / skill-toggles)跑完 ——同步 ctx.inject 回调里 await 的挂载在 apply 返回时还没落地,不等这一拍会误判成 「路由没注册」。

一句话安装(DSH)

dsh plugin --profile web add github:Kr-ATG/dsh-chat-plus

重启 DeepSeek Harness 即可。本包在 package.json 声明了 dsh.bundle.patch, dsh plugin add 完成后自动加入 profile 的 bundles 层,无需手动改 patch。

本地开发安装(junction,与 dsh-done-pill 同款):

New-Item -ItemType Junction -Path "$env:USERPROFILE\.dsh\profiles\web\node_modules\dsh-chat-plus" -Target D:\AI\Dsh\dsh-chat-plus

并在 ~/.dsh/profiles/web/cordis.patch.yml 追加(同 id 条目按 last-write-wins 合并):

- insert:
    - id: dsh-chat-plus
      name: dsh-chat-plus

卸载

dsh plugin --profile web remove dsh-chat-plus

本地 junction 安装:删除 junction 与 profile patch 里的 insert 条目,重启 DSH。

与 dsh-webui 共存

两者都替换 conversation.chat.node 的 tool-call / assistant-step 槽位 (priority -100)。webui 已安装时请关闭其 toolSummary 模块(保留官方正文), 或不要同时安装本插件,否则同 key 同 priority 的第二个注册会抛错。

活动抽屉 window 总线键 __dshActivityDrawerStore__ 与 webui 相同:若 webui 的 toolSummary 同时开启,两者共享同一抽屉(last-write-wins)。

对话截图不受上述冲突影响:本插件注册 conversation.chat.assistant-actions 的 id 为 chat-flow-screenshot(webui 为 webui-screenshot),路由前缀 与保存目录也都独立(/api/chat-flow/screenshot 与 storages/dsh-chat-flow-screenshot)——共存时只是在每条消息上多一个 相机按钮。

与 dsh-triad 的关系

已融合,dsh-triad 退役。 2026-09-24 起 dsh-triad 的 host / client 两半身整体并入 本插件(src/triad/ + src/client/triad/),并已从 profile 的 bundles 摘除。若你的 环境里还挂着 dsh-triad,请去掉——两套同时挂会因为 slot id 相同(automation-notifier、 dsh-memory-inject-toggle、tool.call.toolview key skill)与路由前缀相同 (/api/dsh-memory/* 等 8 组)而重复注册。

融合保留的是「座位与命名空间原样」:slot id / order / locale namespace / 8 组路由前缀 / 12 个工具名 / 记忆与自动化的数据目录(<DSH_HOME>/storages、<DSH_HOME>/automation/dsh-triad/) 都没动,所以原本装在 dsh-triad 上的记忆条目、定时任务、用量统计在融合后继续可用, 不需要迁移任何数据。

产物体积

发布内容约 5.4 MB:lib/index.js 3.9 MB(host 半身,含融合进来的四工作台)+ lib/client.js 448 KB(浏览器半身,另带 822 KB 的 map 给 DevTools 断点用)+ assets/ 968 KB(mermaid 引擎预压缩)+ 构建脚本零头。两处刻意省下来的:

  • host 半身不出 source map:Node 只有带 --enable-source-maps 才读它,DSH 服务没开,十几 MB 的 map 纯属占地方(也占 git 历史)。build.mjs 里 host 是 sourcemap: false,client 保留。
  • shiki 走 fine-grained:shiki/core + shiki/engine/javascript + 显式 import 的 34 个 grammar 与 2 个主题。之前从 shiki 主入口 createHighlighter,esbuild 会把全量 ~220 种语法(约 10 MB)内联进来,而其中未注册的那些本来也用不到(codeToHtml 外面套着 try/catch,未注册语言回落纯文本)。用纯 JS 正则引擎而不是 oniguruma wasm,是为了不引 wasm 文件路径依赖 —— 产物仍是单文件自包含,装到 profile 的 node_modules 里也不会找不到 wasm。代价是首次高亮慢一些(三个代码块含引擎初始化约 550ms,截图整体 1.4s 内),加语言要在 src/shot/markdown.ts 的 import 列表里补一行。

融合 dsh-triad 后 host 半身从 3.45 MB 涨到 3.9 MB(记忆引擎 + 自动化 store + usage/skills host + vendored 的 DSH 叶子模块),浏览器半身从 258 KB 涨到 448 KB(四个工作台的面板)。这部分体积换来的是一整套侧边栏工作台,且 host 侧对 @deepseek-ai/* 仍是零运行时依赖。

构建(Windows)

node build.mjs    # esbuild 双 bundle:lib/index.js(host) + lib/client.js(browser)
  • host 半身运行时导入仅 node: 内置 —— markdown-it / shiki / CDP 客户端 / 融合进来的 四工作台及其 vendored DSH 叶子模块全部内联,产物自包含。构建末尾的 assertHostExternals() 拿一份空 allowlist 逐个扫 lib/index.js 里留给运行时 解析的裸 import,命中任何一个 @deepseek-ai/* 就直接让构建失败(这条守卫真实拦过 一次:@deepseek-ai/dsh-util-crypto 在源码 checkout 里解析得到、装进 profile 后 ERR_MODULE_NOT_FOUND,见「一个被实测证伪的假设」);mermaid 引擎 (assets/vendor/mermaid.min.js.gz)随包分发,运行时由截图引擎按需解压进临时页面;
  • client 半身 external react 家族 + @deepseek-ai/*(DSH client 模块表 运行时提供实例),CJS 工厂包 window.__ModuleLoader__.load 契约。dsh.client.inject 是模块表白名单:不在表里的 @deepseek-ai/dsh-client-* 会在运行时直接 "missed the module table",所以融合后取的是两套 inject 的并集(7 项);
  • esbuild 解析顺序:本地 node_modules → DSH checkout pnpm store(可设 DSH_CHECKOUT 环境变量)。

类型检查(借用 DSH checkout 的 typescript,paths 已指向同一 checkout):

node <DSH>/node_modules/.pnpm/typescript@*/node_modules/typescript/bin/tsc -p tsconfig.json --noEmit

冒烟测试

node scripts/smoke-client.mjs        # 对话增强:7 座位 / 9 样式表 / KR 开关同源自适应
node scripts/smoke-host.mjs          # 本插件 host:3 路由 + download 工具
node scripts/smoke-triad-host.mjs    # 四工作台 host:8 组路由 + 记忆 8 工具 + agent 钩子,路由零撞车
node scripts/smoke-triad-client.mjs  # 四工作台 client:Token 活动 52 周热力模型等纯逻辑
node scripts/test-skill-manager.mjs && node scripts/test-skill-toggles.mjs   # 技能纯逻辑

smoke-*.mjs 用 node:vm 假出 window.__ModuleLoader__ + DOM + React 跑真正的 lib/client.js,或用桩 ctx 驱动 lib/index.js 的 apply()。几个值得知道的桩细节:

  • client 桩必须给全 slots / locale / inputTriggers / sessions 四类服务—— 融合后 apply 同时装配对话增强和四工作台,少给一个,对应工作台的 try/catch 会静默 吃掉它,座位数断言就分不清「真没注册」与「桩不够」
  • smoke-triad-host.mjs 从已安装位置加载 host 半身(@deepseek-ai/* 在 profile 里 才可解析),并且要显式等一拍(setImmediate)让被 await 的异步挂载跑完——同步 ctx.inject 回调里 await 的挂载在 apply 返回时还没落地,不等会误判成「路由没注册」
  • host 桩的 ctx.inject 必须真的把回调跑起来,且 scope 得是「ctx 超集 + effect」: 四工作台的模块一进去就调 webCtx.effect(fn, 'dsh-memory: routes') 做资源回收登记, scope 少了 effect 会 TypeError,而且这个异常会从 apply 冒出去、把后面所有 ctx.inject 全中断(表现为 routes / tools / listeners 全 0)

结构

src/
├── host.ts                          — host 半身:spill 图片读取 + 截图路由接入
├── shims.d.ts                       — markdown-it 插件的无官方类型声明
├── browser/                         — 零依赖 CDP 客户端 + 系统 Chrome/Edge 启动
├── shared/
│   ├── html-paths.ts              — 本地 HTML 路径抽取(截图内嵌用)
│   └── sanitize-html.ts             — 模型原始 HTML 净化(截图 markdown 管线用)
├── shot/                            — 截图 host 半身(自 webui/screenshot 移植)
│   ├── index.ts                     — /api/chat-flow/screenshot 路由(render/save/reveal/image/diagnose)
│   ├── card.ts                      — 卡片 HTML 组装(页头/标题/正文/页脚/鲸鱼署名)
│   ├── markdown.ts                  — markdown-it + shiki + mermaid 围栏识别
│   ├── theme.ts                     — 五套主题 CSS 编译(浅/深/玻璃/玻璃深/阅读版)
│   ├── presets.ts                   — 设备×画质档位(host/client 共用纯数据)
│   ├── renderer.ts                  — 常驻无头浏览器 + 串行渲染队列 + 长图分段拼接
│   └── stitch.ts                    — PNG 拼接(零依赖手写 filter/CRC32)
└── client/
    ├── index.ts                     — client 入口:样式 + 抽屉 + 三座注册
    ├── styles.ts                    — 思考 chip + 对话流卡片样式(dtt__ 命名空间)
    ├── flow-card.tsx                — 步骤卡 / 总结卡(ReplyCardMeta 统计)
    ├── modal-animation.ts           — 弹窗开合动画(截图面板共用)
    ├── thinking/
    │   └── ThinkingStepNodeView.tsx — assistant-step 替换:回合聚合思考 chip +
    │                                  卡片门控(回合结束才出卡)+ 官方正文渲染
    ├── shot/                        — 截图 client 半身(自 webui/screenshot 移植)
    │   ├── index.tsx                — assistant-actions 相机按钮(useChat 快照 ref)
    │   ├── Panel.tsx                — 截图面板(范围/版式/画质/画幅/主题 + 元素删除)
    │   ├── collect.ts               — ChatSnapshot 消息抽取(0.1.2 扁平节点形状)
    │   ├── api.ts                   — /render /save /reveal API 客户端
    │   └── styles.ts                — 面板样式(tsh__ 命名空间)
    └── tool-summary/                — 工具聚合(自 webui/dsh-tool-summary 移植)
        ├── ToolGroupNodeView.tsx    — 每回合一枚工具 chip + 抽屉入口
        ├── activity-drawer.tsx      — 共享活动抽屉(window 总线 + 居中弹窗)
        ├── tool-stats.ts            — 统计/耗时/下载解析纯函数(callView 防御式读取)
        ├── activity-kind.ts         — 调用分类徽标(git push/构建/测试…)
        ├── reasoning-classify.ts    — 思考语义分类(关键词打分)
        ├── icons.tsx                — kind 徽标 SVG 字形
        ├── use-now.ts               — 走秒时钟
        └── styles.ts                — 工具聚合样式(dts__ 命名空间)
    └── kr-chat/                     — KR 对话双栏大盘(右栏四张卡)
        ├── enabled.ts               — 三个「隐藏不删除」开关(KR/PANEL_HEADER/MEMORY_CARD)
        ├── KrAgentPanel.tsx         — 右栏容器:头部开关 + 卡片编排 + 自适应行数下发
        ├── KrTaskOverviewCard.tsx   — 任务卡(todo_write / 官方 todos 投影)
        ├── KrReasoningCard.tsx      — 思考卡(有界视口 + 实时跟随滚动 + maxRows 自适应)
        ├── KrToolCallsCard.tsx      — 工具调用卡(默认折叠,展开后是全量台账)
        ├── KrMemoryCard.tsx         — 记忆卡(本会话口径、无新增分区不显示、批量删除)
        ├── memory-api.ts            — /api/dsh-memory/* 最小 fetch 客户端(零依赖)
        ├── use-adaptive-rows.ts     — 挤压自适应 hook(ResizeObserver + 档位刹车)
        ├── kr-chat-store.ts         — panelOpen / selectedTurn 状态(含 localStorage)
        ├── kr-chat-controller.tsx   — 「KR对话」标签 + 「Agent 轨迹大盘」开关注入
        ├── kr-todo-bridge.ts        — 官方 todos 实时投影(同时是会话身份登记点)
        ├── KrChatView.tsx           — Portal 双栏主视图
        ├── step-parser.ts           — 步骤/总结卡解析
        ├── default-view.ts          — 默认视图判定
        ├── KrExecutionResultCard.tsx — 执行结果卡
        └── styles.ts                — KR 专属 CSS(含 .kr-card--memory sticky 常驻)
    └── triad/                       — 原 dsh-triad 四工作台 client 半身(整体搬迁)
        ├── index.ts                 — applyTriadClient(四模块各 try/catch)
        ├── memory/                  — 记忆面板 + composer 注入开关(纯 fetch)
        ├── automation/              — 定时任务面板 + notifier
        ├── usage/                   — 用量工作台(dashboard/ charts/ primitives/)
        ├── skill-source/            — 技能面板 + `/` slash source
        ├── sidebar-nav.tsx          — 侧边栏导航行(四入口)
        ├── popover-shell.tsx        — 面板外壳
        ├── responsive.ts            — 响应式
        └── triad-modal-animation.ts —  triad 版弹窗动画(与主插件那版不等价,故改名)
src/triad/                           — 原 dsh-triad 四工作台 host 半身
├── host.ts                          — applyTriadHost(七模块各 try/catch)
├── memory/                          — 记忆引擎:store / tools / api / engine/(extract|compile|inject|retrieval|scoring|embedding|consolidate|ticker)
├── automation/                      — 定时任务:store / scheduler / executor / routes / tool / suggestions
├── skill-toggles.ts                 — /api/skill-toggles/*
├── skill-health.ts                  — /api/skill-health
├── mcp-recommended.ts               — /api/mcp-recommended
├── mcp-status.ts                    — /api/triad/mcp-status
└── memory-store-singleton.ts        — MemoryStore 共享单例
src/vendor/                          — 内联的 DSH 叶子模块(构建时打包,零运行时 @deepseek-ai/* 依赖)
├── dsh-llm/                         — BlockAssembler / createMessage / MessageId / HarnessError …
├── dsh-tools/                       — defineTool / JSON Schema 编译校验
├── dsh-session/json.ts              — isJsonValue
├── dsh-util-crypto/index.ts         — randomUUID(原 allowlist 项,实测不可解析后 vendor 化)
└── usage-skill/                     — usage + skills host(JS,vendored)
assets/
└── vendor/
    └── mermaid.min.js.gz            — mermaid 引擎(截图带图围栏时解压使用)
scripts/
├── smoke-host.mjs                   — 本插件 host:3 路由 + download 工具
├── smoke-client.mjs                 — 对话增强:7 座位 / 9 样式表 / KR 开关自适应
├── smoke-triad-host.mjs             — 四工作台 host:8 组路由 + 工具 + agent 钩子
├── smoke-triad-client.mjs           — 四工作台 client:热力模型纯逻辑
├── test-skill-manager.mjs           — 技能管理纯逻辑
└── test-skill-toggles.mjs           — 技能开关纯逻辑

许可

MIT