dsh-prism

dsh-prism

简体中文 | English

⚠️ 已停止开发，本仓库已归档（2026-09-27）

这个项目要做的事，DSH 官方界面自己做到了：新版界面已经原生具备折叠工具调用、简洁工具行、可读的工具输出。插件当初要解决的两个矛盾没有了。

不再继续开发。最终版本 v1.14.1（2026-09-24），源码、开发记录与验收材料全部保留在本仓库存档，供回看参考。未发布到 npm。

不推荐把它当作成品装给新用户使用；需要「可随意开关的档位」这类官方界面没有的能力时，才值得翻这里。

DSH 界面三档模式插件：原生 / 整洁 / 白话一键切换。整洁档保留产品原版的工具行语言，白话档把术语换成大白话，两者都把工具调用收成折叠组。新手看白话，老手要完整，同一套界面三种读法，降低 DeepSeek Harness 的上手门槛。

为什么做这个

DeepSeek Harness 发布后，社区对它的批评集中在一点：门槛。

• 界面新闻：「一切皆插件」的设计十分依赖配置（YAML + 插件 + 效果组件 + 服务），「对高级用户而言功能强大，但对于只想快速用上可用智能代理的人来说，上手门槛较高」
• 极客公园：DSH「对非编程用户不是很友好」，像框架、不像成品，是给开发者的尝鲜版
• 社区开发者：「这玩意鬼才用，我为什么没事要插拔」

DSH 的毛坯房是刻意为之，但「想省事的人」和「要全功能的人」不该被迫接受同一套界面。dsh-prism 用三档模式回应这个矛盾：

默认原生档，切换一次即生效，且档位会记住（刷新页面或重启 DSH 后仍是那一档）。不想用的时候，卸掉插件，界面回到出厂状态，没有任何残留。

功能

• 侧栏入口：侧栏底部「设置」上方一枚圆形按钮（官方 sidebar.footer.action 槽，与 WSL / 记忆等入口同排），显示当前档位首字（原 / 整 / 白），点开菜单切换「原生 / 整洁 / 白话」；菜单内含「隐藏复杂工具」开关（仅白话档生效）；档位会记住，刷新页面或重启 DSH 后仍是上一次选的那一档
• 整洁档 = 归组折叠 × 原版行：
  • 与白话档共用归组与折叠统计行，差别只在展开后的每一行：用宿主内置的官方 @deepseek-ai/dsh-client-ui-primitives 原语（DisclosureRow / StateDot / 官方图标）渲染，标题与摘要按产品 toolRowModel 的同一套规则推导，视觉与产品原生工具行一致
  • 行结构：状态标识（取官方 StateDot）+ 单色线性图标 + 类别标题 +「·」+ 参数摘要；通用工具按产品的写法带上工具名（如 工具调用 · get_goal · {}）
  • 状态分两级：工具真出事（isError）显红；命令返回非零退出码（grep 没匹配、head 截断管道这类常态）显琥珀，文案「命令返回非零」
  • 展开后的内容按工具类型走官方语义块：命令族用官方 TerminalBlock（命令头 + 输出 + 复制按钮）、读取族用官方 ReadBlock（带行号）；其余工具走交付文档（MarkdownText）。官方原语取不到时退回原位，一块不丢
  • 折叠开关取官方 FoldToggle；宿主这版尚未提供它，自动走自绘兜底（「展开 ▾ / 收起 ▾」），宿主升级后自动生效
  • 不折叠复杂工具（信息完整度贴近原生）；脱敏与详情渲染沿用同一套底线
• 白话档 = 工具调用折叠组 × 大白话交付文档：
  • 分段折叠行：每两段正文之间的工具调用各收成一条，收起时只显示一行统计「N 个工具 · M 次思考」（M 为该段内模型思考次数，按 assistant 输出的 reasoning 块计数；无思考时只显示工具数），行尾带该段状态（✓ 完成 / ● 运行中 / ✕ 有出错 / ⚠ 混合计数）
  • 运行中会说话：收拢行报「正在忙第 N 件 · 该工具的白话文案 · 耗时」；结算后回到统计口径（N 个工具 · M 次思考）
  • 展开面板按 step 分段：运行中自动开面板，并只展开「当前进行中那一段」的思考原文；轮次结算后自动收回成一条行（您手动点过的那一次说了算）。段头说实话：这一步有思考写「思考完成」，只调了工具写「步骤完成」；段头只管该段思考原文（默认收起，点开才铺）
  • 工具行与段头同一层常驻（工作日志）：该段的工具行 / 重试行与段头左对齐、不随思考开合，归属由整段左侧的细线表达。工具行是手风琴，点开看原生内容：完整参数（命令不截断）+ 完整结果，均先脱敏
  • 答案步由插件自己渲染完整（产品的同 key 渲染器被压住，返回 null 就是空白，不存在「交还产品」这条路）：一行「思考」（默认收起，点开才铺原文）+ 紧随的正文，答案与它的来由连着
  • 让位的座位不占地方：折进面板的座位按 display 收起（只收工具 / 重试座位，或「已结算且渲染为空」的助手座位），切档或卸载时按轮次原样撤回 —— 用 display 而非 hidden，是因为产品在它那侧会无条件抹掉同名的 hidden
  • 隐藏复杂工具：21 个高级工具（目标 / 计划、子代理编排、后台任务、插件系统）在面板内默认折叠成白话摘要行，点「展开」即展开并打开详情；菜单开关可随时关闭折叠
  • 归组规则：以有正文的助手步为界把一轮切成若干段（正文之间各一段），每段一条折叠行、紧跟在这段正文之后；段内再按 step 分段。带思考但不带正文的步不构成边界（思考原文留在段里），答案步永远是边界、它之后的内容不进折叠；运行中随新调用累计，刷新重放后按同一规则归组，每个工具恰好显示一次
• 点开时钉住被点那一块：开合会改变内容高度，而宿主的滚动所有者（ui-chat 的 ChatView.tsx：ResizeObserver 盯着流列，读者贴底时把视口拽到新底部）会让被点的那一行从指下溜走。插件在点击那一刻记下被点那一块的屏幕位置，随后把它钉住：被点的行不动，内容从它下面往下长。补位只写滚动位置，静默 320ms（最长 1.2s）自己撤，滚轮 / 触摸 / 滚动键一动立刻让开；中段阅读本来就不动，补位在这里不添乱
• 双语界面：插件全部文案跟随 DSH 界面语言（简体中文 / English），设置里切换语言即时生效，无需刷新；工具白话文案、参数摘要、菜单与状态均有中英双语
• 数据脱敏（两个折叠档共用同一底线）：
  • token / secret / password / api_key / authorization 等敏感参数名永不取值，整洁档的摘要同样过滤；参数里只有敏感键时摘要留空，不回退原始 JSON
  • 结果文本与摘要中的常见密钥形态（sk-xxx、Bearer xxx、?token=xxx、key=xxx）替换为占位符
  • 白话档额外把路径缩成文件名（file_path 等参数用 basename 呈现）；整洁档按产品原版规则显示路径，以贴近原版
  • 详情面板只展示脱敏结果，不暴露原始参数
• 原生档 = 产品原貌：原生档下插件不注册任何工具行渲染器，交还产品原样渲染（含通用卡片）；整洁档与白话档才注册折叠组节点（以更低的 priority 同时接管 tool-call / assistant-step / model-retry 三个节点渲染器），切档时动态注册 / 注销、即时生效
• 可诊断性：档位菜单一行体检（版本 + 三格注册状态 + 行距三本账）；控制台 __PRISM_DIAG__ 存最近 6 次切段与最近 5 轮现场；可疑形态自动留痕（__PRISM_DIAG_LOG__() 读取、__PRISM_DIAG_LOG_CLEAR__() 清空），长会话里时好时坏的毛病也留得下现场
• 文案规则：33 个工具规则表给出白话文案（如 pwsh → 「正在电脑上执行一条命令」），未进表的工具按参数名自动生成摘要。白话档下折叠组内每一行都按这套规则渲染；整洁档改用产品原版的类别标题与摘要规则（Bash · …、工具调用 · 工具名 · …），只在脱敏底线上保留插件自己的过滤

设计原则

• 纯展示层：只改界面呈现，模型输入输出零改动，不影响 agent 的任何工作
• 原生零接管：原生档不注册任何卡片，产品原貌完整回归；白话档把工具调用收成折叠组，组内工具行统一按白话规则渲染，官方工具卡片本身不被改动，原生档下保持原版
• 档位记忆：选择的档位存浏览器本地（dsh.prism.mode），刷新页面或重启 DSH 后保持；其余界面状态（折叠组开合、菜单、隐藏复杂工具开关）仍是内存态，不留痕迹
• 跟随主题：全部使用官方 --dsw-alias-* 设计变量，明暗主题自适应
• 失败大声：注册与渲染的异常一律 console.error('[prism] …') 并记入体检面（window.__PRISM_DIAG__），绝不静默吞错
• 内容不吞不编：数据拿不到就退回朴素呈现，不靠猜、不靠解析文本硬造；折叠不让内容丢失

安装

需要先装好 DeepSeek Harness（Node.js 22.19+ 或 24+）。

当前通过 GitHub 发布，克隆本仓库后以本地路径安装：

npx -y @deepseek-ai/dsh plugin --profile web add <本仓库目录>

也可以从 Releases 下载已发布的打包产物。启动 Web UI 后，侧栏底部「设置」上方会出现档位入口。

使用

1. 启动后点击侧栏底部「设置」上方的档位入口（显示当前模式）
2. 选择「白话」：一次任务里的工具调用归成折叠组，收起是一行统计，点开展开面板看每个工具的白话行与交付文档详情
3. 菜单里可开关「隐藏复杂工具」（仅白话档生效）
4. 选择「原生」：恢复完整原生界面
5. 档位会记住：刷新页面或重启 DSH 后仍是当前档；想回原生档，在菜单里切回「原生」即可

常见问题

档位会记住吗？想清干净怎么办？ 会。档位存在浏览器本地（键名 dsh.prism.mode），刷新页面、关掉 DSH 再开都保持。想回到「原生档 + 无痕迹」，把档位切回原生即可；要连记忆一起清掉，在浏览器控制台执行 localStorage.removeItem('dsh.prism.mode') 再刷新。换浏览器或清掉浏览器数据之后，同样回到默认的原生档。

为什么有些工具卡片看起来没变？ read、write、web_search 等工具官方已有产品级原生卡片，插件不为它们注册替代卡片（原生档完全原版）；白话档把它们与其他工具一起收进折叠组，以统一的白话行展示，不改变官方卡片本身。

为什么折叠行的状态点有红有琥珀？ 红＝工具真的出错了；琥珀＝命令返回了非零退出码（grep 没匹配、head 截断管道这类常态也算），文案写「命令返回非零」。这样助手连续跑管道命令时，不会一屏全是红点。

白话档会影响 agent 干活吗？ 不会。插件只改界面显示，模型收到的输入输出与原生完全一致。

点开详情后表格 / 代码块是什么效果？ 结果文本先脱敏，再交给官方的 MarkdownText 渲染（表格、代码块、标题、列表、行内代码与链接都在内）；取不到官方原语时退回等宽纯文本，绝不抛异常。

Roadmap

• 跟进 DSH 官方接口演进，保持新版本兼容（宿主升级后，官方 FoldToggle 等此前缺位的原语会自动接上）
• 扩充工具规则表与官方块覆盖：搜索 / 网页 / 差异三类块待产品开放结构化元数据后接入
• 持续打磨长会话下的渲染稳定性与折叠体验
• 按社区反馈补充适配说明与常见问题

有想法或遇到不适配的工具，欢迎开 issue 讨论。

更新日志

v1.14.1（2026-09-24）

• 修复：状态灯误判刷屏（主人当日反馈「工具运行成功失败的红绿黄灯，现在几乎经常见红灯、黄灯」）。根因：v1.14.0 换官方语汇时，结果区新写的 exitCodeOf 与数据层同名互相覆盖 —— 新份在「读不到退出码」时返回 undefined，而判据写的是 code !== null，undefined !== null 恒真，一切无标记文本（即正常成功的工具）全被判「非零退出」：行级几乎全部 ✕、段级成功计数恒 0（计数分支 ✓ n · ! m 永不可达 —— 这也正是上一版「琥珀计数分支没被验到」悬案的答案）
• 修复：行级状态分级补课：非零退出的行从红 ✕ 改为琥珀 ⚠（文案「命令返回非零」），与段级口径一致；工具真出事（isError）才红 —— v1.14.0「红点不再成排」的意图这次两处都落实（白话档图标与整洁档官方 StateDot 的 warning 态同改）
• 收锚防误报：退出码解析与产品 parseExitStatus 一字不差（前置换行 + 行尾锚定）—— 读文件、搜代码时正文里恰好出现 [exit code: N] 字样不再误判
• 验收：回归桩 161/161（默认与 --real-primitives 双模式）；新断言含行级三态、计数分支可达、尾部锚定、失败仍红；反向跑「含 bug 版」恰 3 条哨兵变红（行级实测 [0,0,2]，两行全红叉的原样复现）；其余门链 16/16、26/26、17/17、13/13、20/20 全绿；真机 PASS（投递 1.14.1、零报错）

v1.14.0（2026-09-24）

• 折叠卡片换上官方语汇（主人 2026-09-24 点名：「折叠卡片的前端是否太不够自然了，能用上官方 ui-primitives 优化吗」）。查下来，整洁档的「行」本来就是官方 DisclosureRow，但行尾的状态点、折叠开关、以及展开后装的内容这三处还是自绘的。这一版换掉它们：
  • 状态点 → 官方 StateDot（运行中是追逐动画，与 TerminalBlock 头部那颗同源，行与卡片不会各说各话）
  • 折叠开关 → 官方 FoldToggle（button + aria-expanded，文案从自造的「展开」换成产品的「还有 N 行」）
  • 工具详情 → 命令族走官方 TerminalBlock（命令 + 输出 + 退出码 + 一键复制 + 自带高度折叠），读取族走官方 ReadBlock（带行号的文件块）
• 拿不到就退回原位：官方原语取不到、或该工具不属于已接的族，一律退回原来的交付文档（MarkdownText）—— 内容一块不丢；未接的族不许冒充官方块
• 不重复、也不丢：官方块自己带命令头 / 文件名，外层参数区就摘掉 command / file_path（真机上原本命令会显示两遍）；其余参数（cwd / timeout / offset…）照旧留着
• 状态分两级（主人 2026-09-24 看到成排红点后点名）：过去「工具失败」与「命令返回非零」都算 err，于是助手连跑 grep / head 管道（退出码非零）时一屏折叠行全是红点。现在 isError（工具真出事）才红；只是退出码非零的走琥珀（复用既有的 mixed 档，文案「命令返回非零」）
• 为什么只接两类：搜索 / 网页 / 差异那三个官方块要的是产品 tool 插件自己塞进结果里的结构化元数据（path / offset / lines / totalLines 这类字段），插件这一层拿不到；靠解析文本反推会造出「看着对、其实错」的内容（红线：一块都不许吞，也不许编）
• 验收：回归桩新增 3 条断言（命令族二选一 / 读取族二选一 / 未接族不冒充官方块），正向 154/154 全绿；差分对照跑 v1.13.0，结果区断言变红。另修一处装置缺口：PRISM_REAL_PRIMITIVES=1 在 WSL 里跑 Windows 版 node.exe 时传不过去，新增 --real-primitives 命令行开关
• 同版收尾的验收：状态分级的差分为精准型：反向跑「状态分级前」的构建，全量 156 条里恰 1 条变红（正是它的哨兵）；当前全量 156/156（默认与 --real-primitives 双模式实测）

v1.13.0（2026-09-24）

• 异常自动留痕（主人 2026-09-23 报「长会话里整洁档偶尔呈现原生效果」，且「点原生再点整洁、刷新又好了」）。这类毛病自己会好，靠人手快去抓现场不可靠（主人原话：「找不到有毛病的页面了」），所以在渲染路径上挂一支极轻的笔：只在可疑形态出现、且指纹变化时写一次本地存储（键 dsh.prism.diag.log，封顶 20 条，超了丢最旧的一半）
• 可疑判据两条，都是「该折叠的行没被折叠」：span=false（本节点没落进任何段 → 工具格走单行原版行，整洁档此刻与原生档同貌）与 claimOK=false（认领失败 → 那一段没人画折叠行）。产品自己折（foldable）与节点不在窗口（inWin=false）属正常形态，不记 —— 记了只会把有效信号淹掉
• 写什么：只写结构字段（成没成段、认没认领到、在哪、那一轮 DOM 里的工具座位 / prism 折叠行 / 被收座位计数），不写 node key、不写任何正文；指纹含会话，两个会话的同号轮次不会互相吞
• 怎么读：控制台 __PRISM_DIAG_LOG__() 取回 JSON、__PRISM_DIAG_LOG_CLEAR__() 清空；dev/prism-claim-dump.js 的取证片段会一并打印
• 验收：回归桩新增 6 条断言（成不了段时落一条 / 同一形态不重复写盘 / 正常形态不记 / 同轮换形态时替换而非堆叠 / 存储被污染时当场清掉坏数据 / 污染清掉后下一次仍能落盘），正向 152/152 全绿；反向用 --client=dev/client-1.12.0-backup.js（不含留痕的旧版）跑，其中 5 条当场变红、且回归不再被中断 —— 断言咬得住。真机确认：投递版本 1.13.0、档位与三格注册面正常、读口在位、无异常时存储键不存在；另做一次端到端（塞样本 → 读口读回 → 清空）全通
• 收尾复审改掉的三处（都是本版自己留下的隐患）：指纹不再含工具计数（否则长轮里每来一个工具就写一次盘）；同一轮同一种类只留最新一条（单轮刷不爆 20 条容量）；存储被污染或配额满时清一次自愈（不让留痕从此静默失效）。另修一条断言：旧版上「空数组比长度」会恰好相等、接着去读 undefined，把整个回归跑崩 —— 现在该红就红，不崩

v1.12.0（2026-09-22）

• 档位会记住（主人 2026-09-22 点名：「每次点好档位后，退出 DSH 重来或刷新、重启等，档位保持，不用次次重新设置」）。档位存浏览器本地 dsh.prism.mode，与宿主自己的界面偏好同一条路（例如 dsh.conversation.contentWidth）；读取放在 store 创建之前，所以启动时按记忆直接注册渲染器。读不到 / 值脏 / 存储被禁一律当没存过，回默认原生档：存储不可用只 console.warn 一次，不进 errors 计数（那三本账是渲染可靠性的计数器）
• 只记档位：折叠组开合、菜单开合、隐藏复杂工具开关仍是内存态，刷新即回默认
• 验收：新装置 dev/prism-persist-check.mjs（真 React + 真 Chrome + 真 reload）20/20；反向验证两条：摘掉落盘 → 8 条红，读改成常量 → 5 条红。回归：桩 145/145、契约 16/16、数据红队 26/26、浏览器红队 17/17、钉位 13/13、自检片段守门 12/12

v1.11.0（2026-09-22）

• 点开时把被点的那一行钉住（主人 2026-09-22 点名：「每次点开一个折叠卡片时，界面都会弹飞（上或下）出去，没有实现点击卡片时，卡片不动，界面向下展开」）。病灶在宿主，源码有据：ui-chat 的 ChatView.tsx 用 ResizeObserver 盯着流列，读者贴底（FOLLOW_THRESHOLD = 24px）时回调里直接 el.scrollTop = el.scrollHeight；插件一展开，列高了，视口就被拽到新的底部。真机实测：贴底点开，卡片当场向上飞 160px；收起时向下掉 151px。现在点击那一刻记下被点那一块（座位）在屏幕上的 y，随后盯住列的尺寸变化，被挪走多少就补回多少 —— 只写滚动位置，不碰产品状态、不新增定时器（静默 320ms 或最长 1.2s 就自己撤），读者一动滚轮 / 触摸 / 滚动键 / 点别处立刻让开
• 覆盖所有会改变高度的开合：折叠卡片、段头思考、答案思考、工具行详情；整洁档的行由官方 DisclosureRow 绘制，为此给它挂了自己的类名 prism-native-row，补位才认得出这条行
• 中段阅读不受影响：读者不在底部时宿主本来就不动，补位在这里不添乱（真机实测 Δy = 0）
• 验收：新装置 dev/prism-pin-check.mjs（真 React + 真 Chrome + 宿主跟随的替身）13/13；反向验证：摘掉补位那一行，贴底三条断言变红（Δy 0 → −151px），中段依旧绿。桩 145/145、契约 16/16、数据红队 26/26、浏览器红队 17/17 全绿；旧版 1.9.9 跑同一套 136/145（红的 9 条正是 v1.10 分区的哨兵）

v1.10.9（2026-09-21）

• 首行注释 + 排错面红线（v1.10.9）：文件头补了插件用途说明；排错面（__PRISM_DIAG__ 的 groups / snap）注明只供本地排错、勿贴进公开仓库——它含节点 key 与轮次结构这类会话内部标识。另：.gitignore 已把 dev/（约 5MB 的本地探针、截图与历史备份，且可能含会话原文）排除在版本控制之外

• 折叠范围从「一轮一条」改为「两次正文之间各一条」。 模型边写边调时，正文与工具交替出现：长活按有正文的助手步切成若干段，每段工具收成一条折叠行，紧跟在这段正文之后；段内的显示机制（面板、按 step 分段、段头、手风琴、脱敏）一字未动。一轮里没有正文边界时（纯工具长活）仍是一条，行为连续

• 段的边界怎么定：正文（含图片 / 插件不认识的块）算边界；只带思考的步不算 —— 思考原文留在折叠面板的段里，不会因为每步都有思考而把时间线切碎；答案步永远是边界，它之后的内容不进折叠。这段判据写在数据层一处，分段与折叠边界共用

• 每条折叠行各记各的账：认领账本与开合状态都按「会话 + turn + 段标识」记账，点开一条不再带动全轮；段标识取段首步号，成段后不再变

• 行距减半（v1.10.2 补）：承载折叠行的座位与它后面一行都取半值行距（8px，产品自己给「折起来的过程行」用的也是这个值），卡片与正文贴紧；本轮里「插件接过、但什么也没画」的工具 / 重试座位直接收掉（它们零高度却各占一条 16px，正是「间隔太大」的另一半来路）；撤回改为只还自己收过的那批，不再把同轮别的所有者刚收好的座位弹回来

• 答案步边界（v1.10.8）：折叠切段原先把答案步并进了上一段，造出一段横跨答案步的段——而答案步在折叠范围之外，段内每个成员都被判在段外、谁都不许认领，这一段永远画不出来；答案之后的节点也被一并折进卡片。现在答案步一到就结算上一段、边界之外一律不参与成段（回归桩 145/145、契约 16/16、数据红队 26/26）

• 修掉「一轮回复完有时呈现原生效果」（v1.10.7）：助手那条渲染路径把 useMode() 放在了「无段即早退」之后——那一格在两次渲染之间形态一变（收尾时组形态会变），hook 数就随之增减，React 抛 #310（Rendered more hooks），它抛在插件的 catch 之外，槽位按 keyed 规则摘牌，这一格回落到产品自己的行。档位读取已提到所有早退之前，并在浏览器层加了「有段↔无段来回切换不抛 #310」的常驻断言

• 排错面一眼可见（v1.10.5）：档位菜单那一行直接摆出行距三本账 —— seats=（按折叠名单收掉的让位座位）、blank=（本轮空白座位直接收的累计数）、compact=（取半值行距的行数）。三个数为 0 也照写：「该收却没收到」正是要看的异常

• 长会话记账有界（v1.10.4）：手动开合那几本 Map（展开态 / 段展开 / 答案思考 / 行详情）键里带会话，不能按轮次清；但没有上限时会随长会话无限增长且会话关掉也不回收。现在超过 600 条就丢弃最旧的一半（只丢可重建的界面状态，不碰任何数据与渲染契约）

• 修回两档的区别（v1.10.3 补）：面板里的工具行必须「整洁档走产品原版行（官方原语 + 类别标题 + 摘要）、白话档走大白话（emoji + 白话文案）」。此前助手那条渲染路径把档位读成了 props.mode，而助手节点根本没有这个 prop —— 只要折叠行由正文步认领（v1.10.0 分区的常态），整洁档的面板就会整块掉进白话分支，看着就是「整洁档做成了白话档的程度」。现在档位一律走 useMode()；浏览器层新增 4 条「两档必须不同」的常驻断言

• 正文步自己承担它那一行的渲染：正文在上、卡片紧随其下（同一个渲染结果里两段内容），所以卡片总是落在它对应正文的下面

• 回归桩升级为 140 条断言（13 条覆盖分区与行距：两条行的条数、各段统计、正文在卡片之前、答案步不认领、各段独立开合、跨会话不串档、无边界退化、只有工具头的步不构成边界、助手格收行距、紧凑标记、空白座位直接收）；旧版 1.9.9 跑同一套 132/140，红的 8 条正是本次功能的哨兵

v1.9.0 – v1.9.9（2026-09-19）

这一版把折叠组从「能跑」修到「站得住」，逐条都是真机上撞到过的问题：

• 修复：答案那一整段在折叠档下是空白。 此前按「命中答案步就返回 null 交还产品」实现，而产品的 keyed 槽只渲染赢家 —— 赢家返回 null 就是这一格空白。答案步改为由插件自己渲染完整（思考 + 正文 + 图片 + 未知块 JsonBlock 兜底），一块都不吞
• 修复：切档后折叠行空窗。 所有者卸载时把过期时刻写成「现在」，切档回来要干等 10 秒 TTL 才能接管；改为卸载即交还，并在切档时清空认领账本
• 修复：产品会反手抹掉插件的 hidden（它自己那侧 hidden=false 时无条件 removeAttribute）。收行距改用 display，两边互不相干；撤回按轮次过滤，不再把别的轮次收好的座位一起弹回
• 修复：产品自己折叠这一轮时插件抢同一行（默认 compact 档、轮次闭合后，插件那条行会被连座位一起藏掉）。现在让位；用户展开产品的过程区时，插件逐行给，保证展开后看得见内容
• 修复：步号读了一个不存在的字段 location.step.seq（真字段是 location.step.step）。分段与折叠边界都可能因此判错；折叠边界同时改为按节点次序判定，不再依赖步号算术
• 修复：只有重试、没有工具的回合，重试信息整块丢掉；重试行交给同一个认领组件，没工具时由它自己认领那条行
• 修复：异常一律退化成空白 → 改为降级渲染（工具行退化为一行，答案退化为纯文本），并记进体检面
• 修复：认领者隐身（窗口外节点占住渲染权却渲染空）、空轮次冒出一条「0 个工具」的行
• 新增：运行中说清在忙什么（第 N 件 + 工具白话文案 + 耗时）；运行中自动开面板、只展开当前段的思考，手动点过则以手动为准
• 新增：工具行提到与段头同一层常驻（工作日志），段头只管思考；段头按事实说话（「思考完成」/「步骤完成」）
• 新增：详情补上原生内容 —— 完整参数（命令不截断）+ 完整结果；复杂参数交给官方 JsonBlock
• 新增：答案步的思考也收成一行（默认收起），推理原文不再平铺在正文之前
• 修复：一次崩溃会连累整类行消失。 插件内部的 try/catch 只能接住代码里抛的异常；异常若发生在产品 hook 调用中间，钩子计数就与上一次对不上，React 会在插件的 catch 之外抛它自己的错误，槽位随即按 keyed 规则摘牌，这一格落到产品自己的渲染器上 —— 折叠行与工具行一起没了，菜单却还写着 tool-call=ok。现在插件在自己子树里装了一层错误边界：崩溃只降级成一行，绝不惊动槽位
• 修复：错误日志只记 message，钉不到抛出点。 现在连堆栈一起记（控制台打 [prism] 抛出位置： + 最多 6 帧）
• 侧栏入口保持一个字标（主人两次定调）：wide 与 rail 都是圆点（28 / 36px），与同槽其它插件的按钮同规格、同一条中线。中途试过按 house style 铺成「整行条」，真机上把同排邻居的按钮顶出了边界，已退回；留下的加固只有一条：入口 flex:none，不参与伸缩，既不被挤扁也不去抢邻居的宽度
• 回归桩从「能跑」升级为验收表：126 条断言（含切档、接管、座位收行距、hook 次序稳定性、崩溃边界、侧栏入口形态、脱敏底线等兵棋），旧版 1.7.1 跑同一套只过 63/126

v1.8.0（2026-09-19）

• 折叠组按第一性原理重建：数据层（分段 / 计数 / 答案边界）与视图层拆开，段与工具行各自独立渲染；运行中、已完成、刷新重放三种情况共用同一套规则
• 答案边界改走产品的正式通道：优先读 props.turnProcess.spec.answerStep（产品 ChatNodeSeat 透传给节点渲染器的那一份），旧通道 location.turn.data.get('turn-process') 作为回退；「答案步交还产品」这条链不再依赖插件自己解析
• 认领制收紧两条：只有「自己在窗口里 + 自己在折叠范围内」的节点能认领（此前一个查不到自己的节点会占住渲染权却渲染空，整轮收拢行就此消失）；认领者离场（key 不在当前窗口里）时下一个节点立即接管，不再干等 10 秒过期
• 重试行收进折叠：折叠档下 model-retry 节点一并接管，产品那一行不再单独渲染（同一个事实本来会被画两遍）
• 收行距：折进面板的节点会在时间线上留下空座位。产品的行距规则是逐条 .flowItem 加行距，而槽位锚点 [data-slot] 是 display:contents 且恒存在，.flowItem:empty 永不成立 —— 于是每个让位的节点各留一条 16px 空档。现在按产品自己的 hidden="until-found" 把确实渲染为空的座位收成零高，切档 / 卸载整批撤回
• 段的每行只摆一次：同一 node.key 被窗口重复投递时不再重复渲染；只有思考、没有工具的段不再被当成空段丢掉
• 回归桩升级为验收表：40 条断言，含点击驱动的组 / 段开合、座位收行距、切档撤回、认领者隐身回归；node dev/harness.mjs --client=dev/xxx.js 可把同一套断言跑在旧版上做差分对照（旧版 1.7.1 在 8 条上失败）

v1.7.1（2026-09-18）

• 段与面板的渲染收紧：段体只在展开时生成，面板内无内容时不渲染空壳；折叠行上下间距与产品行距对齐（不额外叠一层外边距）

v1.7.0（2026-09-18）

• 收尾思考不再被收进折叠：答案前那一次推理与正文是一个整体——正文由它推出，把它也折进去就等于把答案和它的来由切开。现在读取产品算好的答案边界（turn-process.answerStep），最后一步交还产品原样渲染（思考 + 正文连着出现），只把中间过程性思考收进面板
• 段头去掉条目计数，只留「思考完成 + 状态」；条目清单在展开里
• 回归：中间步返回正文（只渲染 text）、答案步返回 null（交还产品）

v1.6.5（2026-09-18）

• 菜单诊断行改为 ASCII（tool-call=ok · assistant-step=ok · errors=0）：切到英文界面也能一眼读，不受语言影响
• 真机确认：白话档下总收拢行正常出现，且同一段内容里不再夹带独立思考行

v1.6.4（2026-09-18）

• 诊断搬到界面上：档位菜单标题现在写作「界面模式 · v1.6.4 · 组✓ 助手✓」——组与助手两个渲染器是否注册成功、渲染期是否抛过错，一眼可见，排错不必再开控制台
• 控制台 window.__PRISM_DIAG__ 仍可看到完整清单（已注册的 key 与错误文本）

v1.6.3（2026-09-18）

• 不再静默吞错：注册渲染器与两个组件体原先都包在 catch 里，出错后一声不响——用户看到的只是“插件什么都没做”。现在异常会 console.error('[prism] …') 并记入 window.__PRISM_DIAG__（含已注册的渲染器清单与错误列表），排错有据
• 诊断口径：控制台执行 window.__PRISM_DIAG__ 即可看到「注册成功了吗 / 渲染时抛了什么」

v1.6.2（2026-09-18）

• 空面板一律不渲染：展开态若没有任何“有内容的段”，整个面板返回空元素而不是渲染空壳；此前空壳会带着内边距在时间线上留出空白（就是「收拢了内容却仍有占位」的来源）
• 段的开合默认收起；段的正文（思考原文 + 工具行）只在展开时出现
• 本版起，插件在浏览器里可见版本号（档位菜单标题），排错不必再猜跑的是哪一版

v1.6.1（2026-09-18）

• 段默认收起：点开总收拢后得到的是一排折叠好的「思考完成」行（对标界面同款），不再默认铺开；展开状态按「会话 + turn + 段序」记住
• 消除盒内空白：思考原文原先设了 max-height:260px + overflow:auto，长思考时盒子里留白并出现内滚动条，看起来像「内容被收走后留下空格」。现在不设高度上限，整页滚动
• 工具行改手风琴：行本体始终一行高（图标 + 文案 + 耗时 + 状态 + 展开），点开在行内展开详情，不再撑成两段
• 总收拢行与面板去掉多余外边距：产品已在相邻行之间给间距，插件再叠一层外边距就会多出空档
• 段收起时严格只有一行：回归量到收起态 segHeads=0 / toolRows=0 / thinkingBlocks=0，逐节点渲染结果为「首节点 1 条总收拢，其余全为 null」

v1.6.0（2026-09-18）

• 段收起时只剩一行「思考完成」。此前段内还平铺着一行行工具摘要，收起状态下就已经是「标题 + 一长串行」两层，看着乱。现在收起只有段头（段名 + 状态 + 条目数），工具与思考都收在展开里
• 思考原文只在段展开时出现，并明确标注为「思考」。这是模型内部推理，不该被误当成给用户的答复；此前我把它的正文搬进了段内且未加区分，还混着英文原文，是我的错
• 接管助手节点，思考行不再单独占位。折叠档下棱镜接管 assistant-step：只渲染正文 text 块，reasoning 块不单独渲染（产品那条思考行需要四个条件同时成立才隐藏，长轮里几乎不成立）。影子验证：产品同 key 的渲染器在折叠档不会被调用
• 回归：组收起态段内容为 0；组展开态段头与段内条目齐备；认领制一轮一条收拢行；无助手节点场景 6 工具切 6 段；退出码失败计入

v1.5.5（2026-09-18）

• 思考行不再单独占位：折叠档下棱镜接管 assistant-step 节点，只渲染正文，思考块作为「思考完成」段的展开内容收进面板。此前思考行只在「可折叠 + 答案步 + inlineReasoning + 过程未展开」时才被产品隐藏，长轮里几乎总是不隐藏，于是思考一行行摊在收拢行外面
• 修复：档位无变化时注册丢失。setMode 原先在档位相同时提前 return，而渲染器注册靠订阅通知驱动 —— 一旦出现「状态已是白话档、渲染器却没注册」，再点白话档不会有任何反应，折叠组整块消失。现在档位设置永远通知一次
• 段内展开顺序：先该段思考全文，再该段工具详情；段收起时行内只留「思考完成 + 该段条目摘要」

v1.5.4（2026-09-18）

• 界面上能看见版本了：档位菜单标题显示「界面模式 · v1.5.4」。往后判断页面里跑的是哪一版，不必再猜或翻控制台
• 真机已确认：白话档下同一轮恰好一条收拢行，行尾混合状态（⚠ ✓1 · ✕1）正确，exit 5 计入失败

v1.5.3（2026-09-18）

• 修复：收拢行有时整个消失。上一版为了治重复，把「找不到自己就不渲染」当成了默认，长轮里便没有任何节点敢渲染那条收拢行。渲染权改成认领制：一轮只允许一个节点渲染收拢行，第一个渲染者认领，其余节点让位；渲染者卸载后 10 秒过期，由后来者接管。既不会重复，也不会消失
• 回归：整轮 7 个节点各渲染一次 → 只出现 1 条收拢行；孤儿节点不渲染；无助手节点场景 6 工具切 6 段
• 对照说明（借 prism 的实现经验）：这块效果对标 HanaAgent（openhanako）的「忙活了一阵子 · N 个工具 · M 次思考」，但两者结构不同——它的折叠发生在整条消息列表的渲染前重排（一条消息里装整个 turn 的过程），DSH 的插槽按节点分发，插件拿不到「整轮一次」的位置，所以只能用认领制在节点粒度上等价实现

v1.5.2（2026-09-18）

• 修复：整轮挤成一段。分段原来只认助手节点给的步号，可真实长轮里窗口常常不交出助手节点，于是三十多个工具、二十来次思考全落进同一段——面板看起来就是「一整坨」。现在工具与重试节点自己的步号（location.step.seq）也能切段，助手节点缺席时照样分段
• 调试面加了一行 [prism-segments]：把窗口里的节点种类、助手步号清单、工具步号清单、段数与每段的工具/重试/思考数一次打出。分段是否成立不用猜，看这一行即可
• 回归用例：无助手节点场景（6 个工具 → 6 段）

v1.5.1（2026-09-18）

• 修复：长轮里出现一串一模一样的收拢行。一轮的工具调用很多时（实例见过 30 ~ 75 个），产品的会话窗口不会把这一轮的全部节点都交出来，于是插件里「先找自己的 key、找不到就自己渲染一条」的旧写法会让每个查不到自己的节点各渲染一条完整组 —— 屏幕上就是一串「N 个工具 · M 次思考」重复行。现在边界一律按窗口内的位置判定：只有窗口里的最后一个节点渲染整组，查不到自己的节点渲染空；同时段内对同一工具去重。回归用例已加进 dev/harness.mjs（孤儿节点不渲染、窗口重复投递不重复摆行）
• 说明：这是 v1.5.0 引入分段时暴露出来的老判定问题（旧版靠另一条路径侥幸掩盖，长轮一样会重复）

v1.5.0（2026-09-18）

• 失败判定改看退出码：产品的 shell 结果把非零退出写在结果文本里（[exit code: N]），并不设 isError —— 所以 exit 3 这类命令在此之前会被显示成绿勾。现在行的状态同时看 isError 与结果文本里的退出码，两者任一命中即为失败；标题里也会带上「退出码 N」
• 展开面板改为按 step 分段：一个 user turn 仍收成一行总收拢（口径不变），但点开后不再是一张平铺的工具清单，而是按模型 step 切段——一个 step 一段，段头沿用官方「思考完成」的说法，段内只装这一段的工具调用与重试行；每段各自开合，默认展开、用户收起后按「会话 + turn + 段序」记住
• 重试行纳入统计：产品对重试有自己的行（node kind model-retry），插件不接管、不重画它的样式，只在组内折算成一行次数摘要，让「几次尝试未成功」进得了统计口径
• 每行带耗时：已结算的行显示调用与结果时刻之差（如 12.3s），运行中的行按秒推进显示至今；数据取自产品工具块上的 callTime / time，不需要插件额外计时
• 段头不另造词：官方「思考完成」那一行仍由产品渲染，插件不碰、不重画
• 白话 / 整洁两档差别不变（一个白话更彻底、一个保留产品行语言），段结构两档共用

v1.4.0（2026-09-18）

• 入口迁移：档位切换按钮从浮动层搬进左栏底部——官方 sidebar.footer.action 槽，与 WSL / 记忆等入口同排、位于「设置」上方；按钮显示当前档位首字（原 / 整 / 白；英文 N / T / P），宽栏 28px、窄栏 36px，与同排其它插件一致
• 随之删掉整套浮动定位逻辑（含手机端专门的角落定位）：入口住在侧栏里，宽屏窄屏都自然就位，不再与输入框上方的控件争地方
• 回归脚本的入口选择器同步更新（26 个）

v1.3.4（2026-09-18）

• 手机（窄屏）适配：宽度不足 560px 时，悬浮入口贴屏幕左下角，不再与输入框上方那一行的控件争位；入口触控高度 31→39px，菜单与面板不溢出视口。宽屏行为不变

v1.3.3（2026-09-17）

• 修复：工具收起不彻底。一个 user turn 里的调用原先按「正式回复」切段，而模型边写边调时，回复之间夹着的调用会各自单独成行——看起来就是「收了一半、漏了一半」。现在一个 turn 的全部工具调用收成一行统计，不再切段
• 顺带校准：思考计数从「正式回复之前的 reasoning」改为「本 turn 的全部 reasoning」，与工具数口径一致
• 回归：组逻辑 26/26（新增「回复后调用仍并入同一组」用例）、等价性全过、红队单元 29/29、红队浏览器 20/20

v1.3.2（2026-09-17）

收尾复审（只动确会影响后续的地方）：

• 修复：折叠组的展开态此前只按 turn 编号记账，两个会话里同号 turn 会互相串档（在会话 A 展开的组，切到会话 B 也显示展开）。改为按「会话 + turn」记账——跨会话隔离，同会话内记忆照旧
• 清理：dsh.client.inject 里长期挂着一个宿主并不存在的包名（@deepseek-ai/dsh-client-runtime），已清空；对官方 ui-primitives 的依赖补进 peerDependencies
• 文档：装配说明与脱敏章节跟上了三档现状（白话档把路径缩成文件名，整洁档照原版显示路径；两档共用同一套敏感键过滤）

v1.3.1（2026-09-17）

• 档位定名：原生 / 整洁 / 白话（原名「原生 / 中级 / 简化」）。三个词各指一处可感知的差别——原生讲保真度、整洁讲排布、白话讲语言；「中级」是程度词，与另外两项不在同一根轴上。英文同步为 Native / Tidy / Plain
• 修复：选「整洁」档后左下角悬浮按钮仍显示「原生」（档位名分派漏了第三档；全项目仅此一处，已逐点审计确认）
• 安全（红队发现并修复）：整洁档照产品规则取参数摘要时，补上脱敏底线——敏感键名（token / secret / password / api_key / authorization 等）永不取值；参数里只有敏感键时不再回退原始 JSON 文本（否则键名与结构会出现在摘要里）；URL 查询串里的 ?token= / &api_key= / &sig= 等凭据形态纳入脱敏
• 移除摘要上的 title 属性（产品没有），避免超长参数在悬停时弹出整段 JSON
• 三档语义不变，功能与数据零改动

v1.3.0（2026-09-17）

• 新增「中级」档：三档结构为原生 / 中级 / 简化。中级档与简化档共用归组折叠，差别在展开后的行——改用宿主内置的官方 ui-primitives 原语（DisclosureRow、StateDot、官方图标组件）渲染，标题与摘要照产品 toolRowModel 的规则推导，行语言与产品原生工具行一致（Bash · Run syntax check、工具调用 · get_goal · {}）
• 官方包通过宿主模块表的平台单例取得（seed.ts 里已登记 @deepseek-ai/dsh-client-ui-primitives），插件 require 即得，零打包、零安装、零依赖；取不到时自动降级为普通布局，功能不丢
• 中间面板行的度量值照抄产品的 ToolRow.module.css（标题字重、2px 圆点分隔、摘要字号与省略），主题令牌沿用 --dsw-alias-*，明暗主题自适应

v1.2.1（2026-09-17）

• 适配 DSH 0.1.5：Chat 视图快照改从运行时注入的 useChat 取用（新版把它从 SessionSnapshot.chat 挪到了 SessionStandardProps.useChat），旧版路径保留为回退，同一份代码在两代产品上都能正常归组
• 新增诊断开关：控制台执行 window.__PRISM_DEBUG__ = true 后刷新，会输出首个组节点的分组上下文（turn / 节点数 / 工具数 / 边界判定），产品升级后定位问题不必再猜
• 配套回归脚本同步：新增「新版 ChatSnapshot 直取」用例，25 项全通过

v1.2.0（2026-08-18）

• 界面双语适配：全部文案跟随 DSH 界面语言（zh/en），切换即时生效；33 工具规则、参数摘要、菜单、组状态均有英文

v1.1.1（2026-08-18）

• 修复：简化档归组在真实浏览器完全失效（ToolGroupNode 裸用 framework hook useSession，每次渲染抛错导致槽位条目退出、回退产品原版渲染，两档看起来一样）；改为从组件 props 取运行时注入的 hook
• 组状态升级为三态 + 混合计数：全对显示 ✓、全错显示 ✕、对错混合显示警示符号 + 「✓ n · ✕ m」计数（对在前）；组内还有调用在跑时只显示 ● 运行中，跑完才给对错总结
• 状态计数按根工具调用计算，与组内行数口径一致

v1.1.0（2026-08-18）

• 简化档工具调用归组折叠：一次 user turn 内、正式回复之前的整串工具调用收成一个折叠组
  • 总结档：收起时一行统计「N 个工具 · M 次思考」（M 按 assistant 输出的 reasoning 块计数，无思考时只显工具数），行尾带组状态
  • 中间档：点开统计行展开文档化面板（标题区 + 每工具一行 + 说明区），每行复用白话卡片样式，点行看脱敏交付文档详情
  • 归组在运行中随新调用累计、刷新重放按同一规则归组；每工具恰好显示一次
  • 行推导提取为共享函数 toolRowMeta，时间线卡片与折叠组面板共用，文案与状态完全一致
• 折叠组统计行的开合状态按组独立存内存 store（每个 turn 一组），刷新回默认收起
• 修复：简化档的 tool-call 节点渲染器与产品 ToolCallTree 同 key 注册冲突（keyed 槽同 key 同 priority 会抛错），改为以 priority: -1 shadow 产品渲染；白话卡片不再注册到 tool.call.toolview（该槽在简化档无消费方），折叠组面板内直接渲染

v1.0.0（2026-08-18）

• 架构：规则表 + 参数名规则驱动（33 工具白话文案、接管名单自动推导），新增工具只需加一行
• 原生档零注册：产品原貌完整回归，切换即时生效
• 简化档：时间线行（类别图标 + 白话动作 + 状态图标）+ 交付文档详情（Markdown 子集渲染：表格 / 代码块 / 标题 / commit 高亮）
• 新增「隐藏复杂工具」开关（默认开启）：21 个高级工具折叠成一行
• 数据脱敏加严：敏感参数名永不展示、密钥形态替换、详情先脱敏后渲染

早期版本

• 初版：简化 / 原生两档切换，33 工具白话文案，接管 19 个无原生卡片的工具

贡献

• 发现工具适配问题：开 issue，附上工具名与界面截图即可
• 想补充白话文案或新工具规则：按「新增一个工具」一节改 TOOL_RULES，提 PR
• 代码风格：与 lib/client.js 保持一致（零依赖、React.createElement、中文注释）

架构（全部实现位于 lib/client.js）

TOOL_RULES        规则表：33 个工具 → 白话文案与参数摘要声明
ARG_NAME_RULES    参数名规则：无显式声明的工具按参数名自动生成摘要
SENSITIVE_KEY     敏感参数名（任何情况下不展示其值）

注册是动态的：conversation.chat.node 的 tool-call 渲染器仅在白话 / 整洁两档注册（以 priority: -1 shadow 产品 ToolCallTree；keyed 槽同 key 同 priority 的注册会抛错，更低 priority 者胜出），原生档零注册，产品界面原样呈现。折叠组面板内的工具行由插件直接渲染（白话卡片 / 原版行，展开后的详情走官方语义块或交付文档），不经 tool.call.toolview 槽分发（该槽的消费方是产品 ToolCallTree，折叠档下已被 shadow）。

分区与分段：computeGroups() 先按「有正文的助手步」把本 turn 的节点切成若干段（正文之间各一段；答案步是边界，它之后不折；只有工具头的步不构成边界），每段再交给 computeSegments() 按 step 切列（段边界取同一 step 的最后一个工具或重试节点，每个节点恰好渲染一次）。段头用官方「思考完成」的说法，段内条目复用 ToolCard / NativeToolRow / RetryRow 三种行。每条折叠行的渲染权按「会话 + turn + 段标识」认领（useGroupClaim），开合状态同键记账。耗时取工具块上的 callTime 与 time 之差，运行中的行由 useTick() 的秒级节拍推进（仅在存在运行中行时启动）。

规则表字段

新增一个工具

1. 在 TOOL_RULES 加一行，只写工具名即可：doing/done 自动生成通用白话文案，参数摘要由 ARG_NAME_RULES 按参数名自动生成（如 file_path → 「文件：xxx」、url → 「链接：xxx」），白话档折叠组面板自动按规则渲染该工具行。
2. 想更精准时再补 doing / done / arg；想让它默认折叠则加 complex: true。
3. 白话档折叠组面板会把组内所有工具（含产品有原生卡片的 read / write 等）按规则渲染成白话行；原生档下它们仍是产品原版卡片，无需特殊处理。

装配