Winter-And-You-Gone/dsh-turn-fold
Project Overview项目介绍
A pure DSH plugin that folds tool calls and Think segments into collapsible step bars showing tool name, args, reasoning, and failure count in real time. A round bar appears the moment a message is sent, ticking duration, TTFT, tokens, tok/s, cache hit rate, and turn number, then collapsing the whole turn on completion. Click to toggle. It does not modify any @deepseek-ai/dsh-* source. Caveat: only DSH 0.1.1-rc.2 and 0.1.2-alpha.1 are supported; changes to snapshot or slot contracts may require plugin updates, and labels are tunable via CONFIG at the top of client.js.
DSH 纯插件,折叠工具调用与 Think 段为步骤栏,实时显示工具名、参数、思考摘要、运行状态与失败计数。运行中回合栏秒级刷新耗时、TTFT、token、tok/s、缓存命中率与轮次,段闭合后按工具类型分组汇总(如"编辑了index.js [+12 -3]"),整轮完成自动收为回合栏。点击切换展开/收起;不修改任何 @deepseek-ai/dsh-* 源码。注意:仅兼容 DSH 0.1.1-rc.2 与 0.1.2-alpha.1,版本升级若改变快照或 slot 契约需随改,文案通过 client.js 顶部 CONFIG 可调。
请帮我了解并安装插件:【dsh-turn-fold】【https://github.com/Winter-And-You-Gone/dsh-turn-fold】
Send this message to DSH in your current session. CLI install commands may not be accurate across systems — DSH will figure it out for you.把上面这条消息直接发给当前会话里的 DSH,让它帮你了解并安装。安装命令不一定准确,发给 DSH 更稳。
Or use CLI install (for developers)或使用命令行安装(适合开发者)
CLI Install命令行安装
dsh plugin --profile web add @winteries/dsh-turn-fold
把 Winter-And-You-Gone/dsh-turn-fold 加入你的 DSH 配置(web profile)即可启用。
READMEREADME
dsh-turn-fold
简体中文(默认) | English
受够了几十条工具调用占满屏幕? 也眼馋隔壁 Codex 的自动折叠? 那这个插件就是为你准备的。
DeepSeek Harness(DSH)纯插件,只负责折叠:
- 步骤分组自动折叠:两个 text 之间的所有工具调用和 Think(含纯 Think 段)收成一个步骤折叠栏,默认折叠;运行中步骤折叠栏动态显示「正在运行
图标 工具名· 描述 / 正在思考图标 Think· 内容」(文字带 shimmer 光泽动效),下一个 text 出现后按工具类型分组显示详细标题(如「运行了pwsh」「读取了client.js」「编辑了index.js [ +12 -3 ]」),纯 Think 段闭合后显示「思考了N次」。 - 运行中回合折叠栏:发消息即出现(0 秒占位,不等第一个 response),折叠栏实时显示耗时/首字/消耗token/tok/s/缓存命中率/待折叠步数,最右侧右对齐显示「第x轮」;折叠栏与内容之间有分隔线。
- 整回合折叠:一轮回复完成后自动收成一个回合折叠栏(默认收起),最终总结只显示正文。
- 手动展开/收起:点击折叠栏切换。
- 新版本更新说明:每个新版本首次加载时右下角弹出一次更新说明(本地记录已读版本,不重复打扰)。
不修改任何 @deepseek-ai/dsh-* 源码。
功能一:步骤分组自动折叠
text:先看仓库状态和改动规模: ← text 直接显示
┌────────────────────────────────────────────────────┐
│ › 正在运行 ⬢ Pwsh · Commit 1: core +tests │ ← 运行中:图标 + 工具名 + 参数摘要
└────────────────────────────────────────────────────┘
text:…… ← 下一个 text 出现
┌────────────────────────────────────────────────────┐
│ › 编辑了client.js [ +7 -7 ] 运行了2条命令 │ ← 段闭合:按工具类型分组显示
└────────────────────────────────────────────────────┘
- 段 = 两个 text 之间的内容:连续的工具调用与 Think 混排成一段(Think 不再打断分组), 含 text 的消息是段边界;text 正文始终在步骤折叠栏下方直接显示(官方渲染,唯一一份, 不参与折叠——DSH 把 think 和 text 放在同一节点,think 部分收进段、text 部分留在段外)。
- 默认折叠:步骤折叠栏始终默认收起(运行中也不例外)——运行中只显示 text 和步骤折叠栏行, 工具卡片/Think 内容点击步骤折叠栏才展开。
- 运行中动态标题:段未闭合(下一个 text 还没出现)时,步骤折叠栏显示段内最后一个节点——
工具调用显示「正在运行
图标 工具名· 参数摘要」(工具图标复用官方 VARIANT_ICONS 映射, 如 Pwsh → API 图标、Read → 浏览图标、Grep → 搜索图标), Think 显示「正在思考图标Think · 最新一行」(前缀 + 官方 Think 图标 + 摘要,摘要取 最新一行、横向自动滚动跟随末尾,内容随流式逐字推进);运行中标题文字带shimmer 光泽 扫过动画(灰色基调 + 高光流动,节奏为流动 1.8s + 停顿 2s,亮/暗主题各自配色)。 - 段闭合标题(按工具类型分组):下一个 text 出现后,按段内工具类型分组显示——
仅命令:
运行了pwsh(单次显示工具名)/运行了3条命令(多次显示次数); 仅读取:读取了client.js(同一文件显示文件名)/读取了2份文件(多文件显示数量); 仅编辑:编辑了index.js [ +12 -3 ](单文件附加行数变更,从官方 diffs 数据读取)/编辑了3份文件;搜索:搜索了2次; 混合时按「读取 → 编辑 → 搜索 → 命令」排序且命令始终在最后, 如读取了client.js 编辑了App.tsx 运行了2条命令;纯 Think 段(段内无工具)闭合后显示 「思考了N次」(N = 段内 Think 次数)。 - 手动可展开/收起:点击步骤折叠栏切换;手动选择会覆盖自动规则。
- 失败命令标红:组内已有命令执行失败(工具结果
isError,含中断)时,折叠栏文字变红, 并在标题后追加失败数——仅单条工具调用失败显示「 —— 执行失败」(无条数), 多条工具调用时 1 条失败也显示「 —— 1条执行失败」、多条显示「 —— y条执行失败」。 失败统计涵盖段内所有工具类型(read/edit/search/命令都算)。
效果示意
段闭合标题:按工具类型汇总 + 编辑行数统计([ +11 -11 ],悬停括号 +N 变绿 / -N 变红):
![段折叠栏:编辑了 client.js [ +11 -11 ]](https://raw.githubusercontent.com/Winter-And-You-Gone/dsh-turn-fold/HEAD/docs/images/segment-edit-stats.png)
标题里的文件名可点击复制完整路径:悬停变 DeepSeek 蓝 + 白色下划实线:

功能二:运行中回合折叠栏 + 整回合折叠成一个回合折叠栏
[用户消息]
[▸ 耗时5分12秒 · 首字1.2s · 消耗12345token · 34tok/s · 缓存命中80.00% · 待折叠6步 第13轮] ← 回复开始即出现的回合折叠栏
───────────────────────────────────────────── ← 分隔线
[Think / 工具调用逐条加载…] ← 运行中默认折叠成步骤折叠栏
[最终总结正文] ← 无 Think 行,只有正文
[耗时 · token 脚注] ← 官方 turn-tail
- 发消息即出现回合折叠栏(0 秒占位):用户发送消息后立即出现回合折叠栏(耗时从 0 开始计时), 不等第一个 response——占位栏由输入区 dock 条目渲染在输入区上方,第一条中间节点到达后 占位消失、正式回合折叠栏接替显示;
- 指标实时更新:回合折叠栏中的耗时秒数每秒走动(从回合
turn/start起计时), "消耗token"按随机间隔(默认 125~250ms)刷新且持续增长,tok/s 按已输出 token / 已耗时实时估算, 缓存命中率显示两位小数(如80.00%),**首字(TTFT)**在第一个请求完成 (step settle)后即显示官方值(assistant-step的finalNode.timing:firstTokenTime - stepStartTime),回合结束后切换为官方持久化聚合值 (turn-tail 携带的ttftMs,来自事件日志,刷新页面不丢);仅当首个请求仍在流式时 用渲染时刻近似(回合启动到首个 assistant-step 渲染); 回合结束后全部指标切换为官方权威值(turn-tail 的 tok/s、turn/end的精确耗时); - 回合折叠栏最右侧右对齐显示"第x轮"(如
第13轮/Turn 13,英文随 DSH 语言切换); - "消耗token"持续增长动画:真实 usage 只在每个请求完成时到达,两次之间数字会
停住——运行中在真实基线之上叠加纯展示用的动画偏移,偏移按实际 tick 次数推进
(+1/+11 交替:个位每 tick +1、十位每 2 tick +1、更高位随进位自然走动),
tick 间隔 =
liveTickMs× 随机数(liveTickJitter~ 1,默认 125~250ms), 数字跳动节奏不规律,更像真实生成速率而不是节拍器;真实 usage 到达时只把基线校 正为真实值,偏移继续累计、数字只增不减。基准间隔和抖动分别通过CONFIG.liveTickMs和CONFIG.liveTickJitter调整; - 滚轮式数字动画:运行中数值变化时,每一位数字独立"滚动"到新值(里程表/滚轮效果, 回弹缓动;动画时长按变化频率自适应:token 个位这类快速变化用略短于刷新周期的短动画 保证每拍完整走完,耗时秒数等慢速变化用 350ms 回弹滚动)——数字拆成逐位视窗、内部 竖排 0-9,视觉上像计数滚筒;完整文案另有 sr-only 副本,读屏/无障碍不受影响, 系统开启「减少动态效果」时自动退化为静态数字;
- 折叠栏下方常驻分隔线:回合折叠栏文字下方始终有一条 1px 水平细线
(颜色取官方
--dsw-alias-line-secondarytoken,随主题明暗自动适配), 收起/展开都显示,展开时同时充当折叠栏与内容的视觉分界; - 一轮回复完成(输出最终总结、回合结束)后,回合折叠栏自动收起,本回合内所有 Think、 工具调用和上下文注入收进回合折叠栏,只保留最终总结消息和官方耗时/token 脚注可见; (手动展开过的回合保持展开状态)
- 无工具调用也折叠:回合内只有上下文注入 / Think、没有任何工具调用时,同样收成 一个回合折叠栏(折叠栏显示耗时/token 指标,不显示命令数);
- 回合折叠栏显示本轮指标:
耗时x时x分x秒(不足 1 小时只显示分秒,不足 1 分钟只显示秒), 首字x.xs,消耗xxx token,xxx tok/s,缓存命中xx.xx%,待折叠/已折叠N步(>0 时才显示; 运行中为「待折叠N步」,回合结束后为「已折叠N步」)」;某几项缺失时自动省略, 全部缺失才回退为「运行了 N 条命令」;字段之间用·分隔,右侧附「第x轮」; - 点击回合折叠栏展开/收起整轮内容;重新打开历史会话时,已完成的回合同样保持整回合折叠;
- 折叠作用域不越过用户消息:回合折叠栏只折叠「用户消息之后、agent 回复之间」的内容。 锚定在用户消息上方的上下文行(如审批策略变更通知)不属于本回合输出区间, 始终保持原样可见,绝不参与折叠,也不会被当作折叠栏锚点——避免回合折叠栏「跨过」用户消息 去折叠其上方的内容;
- 最终总结只显示正文:回合结束后,最终总结消息内部自带的 Think 行也一并隐藏;
- 状态标签:非正常结束的回合(用户停止 / 中断)在回合折叠栏前置状态文本, 如「已停止 | 耗时5分12秒…」,正常完成不显示额外标签;
- 单条也分组:两个 text 之间只有 1 条命令(或 1 个 Think)时同样套步骤折叠栏,
运行中显示「正在运行
图标 工具名· …」、text 出现后显示「运行了pwsh」; 回合结束整回合折叠时它收进回合折叠栏,展开回合折叠栏后步骤折叠栏行可见。
效果示意
回合进行中/手动展开:回合折叠栏实时显示耗时、首字、token、tok/s、缓存命中率、 已折叠步数(右端对齐轮次),过程内容按步骤分组折叠、工具卡片与 Think 行原样可读:

回合结束后(或手动收起):整回合收进回合折叠栏,只保留最终总结正文与用量脚注:

组件样式与行距
- 折叠栏即官方样式:折叠栏直接复用官方
DisclosureRow原语(@deepseek-ai/dsh-client-ui-primitives) 渲染——24px 行高、16px 前导、官方 14px chevron(收起右向 / 展开下向)、14px/24px 标题, 与 Think / 工具卡片的折叠行逐像素一致; - 回合折叠栏分隔线:折叠栏下方常驻一条 1px 水平细线(
.ccg-turn-divider,颜色按var(--dsw-alias-line-secondary, var(--dsw-alias-border-l1, #d1d5db))链式回退—— 两版 DSH 均未定义--dsw-alias-line-secondary,实际生效的是 0.1.1/0.1.2 共有的--dsw-alias-border-l1,随主题明暗自动适配),收起/展开都显示,上下留白 4px / 8px; - 紧凑行距:折叠组只占一行(24px);被折叠的成员节点整行
display:none,不会残留空行, 行距与官方消息完全一致(column 的 16px 节奏),折叠再多也不会越空越大; - 过渡动画:展开时内容从 0 高度平滑展开到真实高度(grid 轨道
0fr→1fr过渡 + 淡入,280ms, 起始帧用useLayoutEffect同步提交保证过渡稳定播放);收起时播放收缩动画(280ms)后卸载内容; 系统开启「减少动态效果」时自动禁用动画;回合运行中(直播模式)内容高度自适应, 不裁切不断增长的流式内容; - 运行中标题 shimmer 动效:步骤折叠栏运行中标题(「正在运行…」「正在思考…」)的文字带
shimmer 光泽扫过动画——渐变背景 +
background-clip: text+ 背景位移动画,整行一个渐变 统一流动(高光节奏:流动 1.8s + 停顿 2s);暗色/亮色主题各有配色,图标不受影响; - 滚轮数字:运行中回合折叠栏的数字(耗时/首字/token/tok/s/缓存命中)按数位拆成 1ch 宽的 滚动视窗,数值变化时逐位滚动(350ms 回弹缓动);回合结束后回退纯文本;
- 多语言:界面文案跟随 DSH 界面语言实时切换(读取
document.documentElement.lang, 简体中文 / 英语),浏览器语言仅作回退; - 无障碍:折叠栏带
aria-label/aria-expanded,键盘可操作(Enter / Space 切换)。
安装
方式一(推荐):从 npm 安装
本插件已发布到 npm registry:@winteries/dsh-turn-fold
(旧包名 dsh-turn-fold 仍会随每次发布同步更新,供已安装旧包的用户持续获取更新;新安装请使用 @winteries/dsh-turn-fold。)
# 官方命令(推荐)
dsh plugin --profile web add @winteries/dsh-turn-fold
# 或从 GitHub 源码安装
dsh plugin --profile web add github:Winter-And-You-Gone/dsh-turn-fold
dsh plugin 会将包加入 profile 的 pnpm 依赖并自动追加到组合包层(dsh.profile.bundles),无需手动改任何文件。验证方式:
dsh --profile web --dump-config # 确认输出中能看到 "@winteries/dsh-turn-fold" 层
然后完全退出 DSH 进程并重启。
方式二:手工 install.ps1
# 把插件目录放到你已有的插件目录,然后:
.\install.ps1 -PluginSource "<你的插件目录>"
# 例如:.\install.ps1 -PluginSource "C:\dsh-plugins\dsh-turn-fold"
# 不传参数时默认用脚本自身所在目录作为插件源
脚本会:
- 在
~/.dsh/profiles/node_modules/@winteries/dsh-turn-fold建 Junction 指向插件目录; - 在
~/.dsh/profiles/web/cordis.patch.yml追加一行- insert:注册; - 校验
require.resolve可解析。
然后完全退出 DSH 进程并重启。
卸载
# 官方方式:同时移除依赖和插件层
dsh plugin --profile web remove @winteries/dsh-turn-fold
手工方式(曾用 install.ps1 安装时):
Remove-Item "$env:DSH_HOME\profiles\node_modules\@winteries\dsh-turn-fold" -Force # 删 Junction
# 手动删掉 cordis.patch.yml 里对应的 insert 块
测试
npm install # 首次:安装 jsdom / react / react-dom(devDependencies)
npm test # node --test 运行 tests/ 下的全部测试
npm run check # 语法检查 client.js / index.js
测试套件(tests/)直接加载真实 client.js(经 __ModuleLoader__ 注入 + __test
导出,无复制粘贴漂移),分四层:
| 文件 | 覆盖 |
|---|---|
unit.logic.test.mjs |
纯函数:computeGroup 步骤分组、computeTurnFold 整回合折叠、computeTurnMetrics / turnHeaderLabel 指标文案、turnNumber 定位;含历史 verify-fix 的全部场景与真实会话数据(TURN13) |
unit.render.test.mjs |
React 渲染:初始折叠 → 点击回合折叠栏展开 → 再收起 的完整交互;内置组件委托渲染时 useHostDescription 等 kit hook 的透传;条目注册契约(inject 声明) |
unit.css.test.mjs |
CSS :has() 隐藏规则在真实 DOM 上的生效(含"展开→收起"往返) |
regression.test.mjs |
历史 bug 回归:节点对象替换(Bug1)、inject 缺失崩溃/abdicate(Bug2)、无工具调用回合折叠(v0.2.3)、折叠作用域不越过用户消息(v0.2.2)、步骤分组手动展开/收起 |
unit.gear.test.mjs / unit.settings-row.test.mjs |
齿轮字段弹窗与「回合折叠方式」设置行(shadow 官方 transcript-view) |
unit.compat.test.mjs |
DSH 双版本兼容:0.1.1 useSession(.chat + 顶层 turnEnds/turnTimings) 与 0.1.2 useChat + chat.legacy 两条快照路径、折叠模式切换 hooks 顺序回归、官方 diffs 读取链(meta.diffs / resultView / callView) |
在 Windows 沙箱等无法 spawn 子进程的环境下需要
--test-isolation=none(已在npm test中内置);普通 Linux/macOS CI 同样可用该参数(Node ≥ 22.9)。
折叠图标(扑克牌)
步骤/回合折叠栏的前导图标默认为动态扑克牌(设置 → 对话 → 折叠图标 可切回官方 chevron):
- 完成态:收起为牌堆(段内工具 ≤3 用 3 张、>3 用 5 张),点击展开变扇形;
- 牌面池:♠ ♥ ♦ ♣ + DeepSeek 鲸鱼 Logo 五选一,每个折叠栏按 leaderKey 随机记忆(重渲染不变);
- 运行态:步骤栏播放五牌面轮换动画、回合栏播放对角线轴翻牌(四花色循环、 Logo 背面),均为 SVG 原生动画;
- 遮挡:luminance mask 按上层牌变换动态挖空下层覆盖区,牌身透明(壁纸/ 透明背景下正确);
- 设置预览:4 个静态形态每秒轮换牌面(相位错开,同一时刻 4 种不同牌面)+ 两个运行态动画预览;
- 数据源:
icons/default.json(花色路径、卡牌几何、扇形/牌堆变换表、动画 模板),改完npm run sync:icons注入、npm run icons:check校验。
设置弹窗(回合折叠栏字段显隐 + 折叠图标选择;预览项悬浮 2x 放大):

自定义图标(Agent Skill)
想改折叠栏图标的用户不用手动操作——本插件随包注册了一个 agent skill
dsh-turn-fold-customize-icons(host 半边 index.js 通过 ctx.skills 注册,
DSH 0.1.2+ 装配了 @deepseek-ai/dsh-skill 时自动生效)。对 AI 助手说"帮我把
扑克牌图标改成××样式",助手会自动加载该 skill,得到完整自定义流程:
- 数据源:
icons/default.json(唯一数据源,含花色路径、牌堆/扇形几何、动画) - 改完同步:
npm run sync:icons注入 client.js →npm run icons:check校验 - 快速预览:写
localStorage['dsh-turn-fold:icons']可免改代码覆盖 - 避坑指南:该环境特有的 SVG 渲染坑(fill var 属性不生效、defs fill 覆盖不掉、 clip-rule 无效、transform-origin 不可靠等)
skill 正文在 assets/dsh-turn-fold-customize-icons.md,随 npm 包 files 一起发布。
CI 与发布
GitHub Actions 会在每次 PR / push 到 main 时自动运行语法检查、npm test 全套测试和
npm pack --dry-run 打包预检;推送 v* tag 时自动发布到 npm(OIDC Trusted Publishing,
无需长期 token)并创建 GitHub Release。一次性配置(把 npm 包绑定到本仓库的 release workflow):
npx npm@^11.15.0 trust github @winteries/dsh-turn-fold \
--repo Winter-And-You-Gone/dsh-turn-fold \
--file release.yml \
--allow-publish
也可以改为在 npmjs.com 网站账户设置里配置 Trusted Publishing。
之后每次发版只需两步:
npm version patch # 或 minor / major:bump 版本并自动打 v* tag
git push --follow-tags
提示:
npm version要求工作区干净,先把待发布的改动提交;tag 名必须与package.json的version一致(workflow 会校验,不一致即失败)。
工作原理(为什么不用改源码)
- DSH 会话 UI 是 Cordis 插件 + Slot 插槽系统拼出来的;聊天流每个块经
conversation.chat.node(keyed slot)按类型分发渲染器。 - Slot 注册器官方支持 不同 priority 覆盖(
register at a different priority to shadow it, lowest renders)。 本插件用priority: -1覆盖内置的tool-call/assistant-step/context渲染器;user格不再注册——0 秒占位迁往输入区 dock 条目,user格让给 user 消息专用 插件(如 dsh-easyrewrite 的撤回/重编辑气泡),从根上消除同 key 同 priority 抢位 导致对方加载失败的一类冲突。 - 注册冲突自动让位:注册前探测同 key/id 的
priority: -1是否已被占用 (ctx.slots.entries),被占则自动让位到第一个不冲突的值(官方0恒预留,绝不 落回官方档)并打console.warn——本插件后加载时不再与先占者冲突。conversation.chat.node三格与settings.general.item的 transcript-view 行都走该逻辑。 - 注册异常软降级(绝不带崩 DSH):slots 注入回调若让异常外泄,延迟执行路径
(目标 slot 声明晚于插件加载时,回调跑在官方声明者的调用栈里 / 声明订阅里
uncaught re-throw)会打断官方 UI 激活、web 整页无法启动。因此本插件所有 slot
注册(chat.node 三格、设置行、dock 占位条)统一走一个注册管道:inject 声明等待
与回调内 register 各自兜异常(
return undefined即"无可清理资源",官方 cachedSlotInject 对 falsy 返回无害),单个条目注册失败仅跳过该条目,console.warn留排查线索并弹一次中性措辞的降级 Toast 告知用户(不指涉冲突方——旧版宿主未声明 slot 的版本缺口也走同一条降级路径);宿主半边的 skill 注册同样双层防护。DSH 启动 不受本插件任何注册异常影响。 - 展开时通过
ctx.slots.entries('conversation.chat.node')取到内置组件引用做委托渲染, 工具卡片/Think 行/上下文注入的内容与样式与内置完全一致。 - 整回合折叠通过会话快照的
turnEnds(turn/end 事件驱动)判定回合完成,配合chat.locations.getTurn()计算折叠栏/成员/最终消息,再以 CSS:has()隐藏成员 flowItem。 回合运行中由turnTimings(turn/start 事件给出startTime)判定回合已开始, 回合折叠栏即出现:耗时用随机间隔时钟(每CONFIG.liveTickMs× 0.51,默认 125250ms) 补Date.now()实时走动,"消耗token"在真实值之上叠加每 tick +1/+11 交替的动画 偏移持续增长(真实usage到达时校正基线),全部指标在turn/end后切换为权威值。 - 会话快照双版本读取层:DSH 0.1.1 与 0.1.2 的快照契约不同——0.1.2 把快照拆分成
useSession(会话级状态)与useChat(chat 数据),turnEnds/turnTimings收进chat.legacy。组件统一经useChatSnapshotData适配:有useChat(0.1.2+)就读useChat快照本体,否则从useSession(s).chat取;turnEnds/turnTimings优先读chat.legacy、顶层兼容字段兜底。所有 hooks 无条件调用(数据计算与订阅和"是否接管 折叠"解耦),折叠模式切换(接管 ↔ 委托内置)不改变 hook 数量,条目不会崩。 - 0 秒占位:
RunningTurnDock条目注册到输入区conversation.input.dock(list slot, 按id共存——与官方 todo/queue dock 不存在 priority 冲突面),在「会话运行中且 最后一条消息是 user」时渲染占位回合折叠栏(耗时从运行中回合的startTime计时), 第一条中间节点到达后自动交接给正式回合折叠栏。旧版 DSH 未声明该 slot 时注册 try/catch 跳过(占位条缺失不影响其余功能)。 - 首字(TTFT)三来源(官方优先):① step settle 后即实时读取官方值——
assistant-step节点的data.finalNode.timing(官方在assistant/message事件后写入{ stepStartTime, firstTokenTime, completedTime }),取回合内 step 号最小者(第一个 请求)的firstTokenTime - stepStartTime(与官方deriveTurnMetrics同款语义); ② 回合结束后优先用 turn-tail 携带的聚合ttftMs(同值、来自持久化事件日志、 刷新页面不丢);③ 仅当无任何 step 完成(首个请求仍在流式)时回退渲染时刻近似 (Date.now() - turnTimings.startTime,误差约一帧渲染延迟,幂等记录、回合内只记一次)。 - 段闭合标题缓存:段闭合后标题不再变化,按
leaderKey + 节点 keys + 语言 + 工具指纹(名称/isError/argsRaw 长度,不解析内容)记忆,避免每次渲染重复解析 argsRaw; 工具行数变更优先读取官方 diffs 数据(oldText/newText块行数;0.1.2 在结算 metadataroot.meta.diffs、0.1.1 在 wire 视图root.resultView.diffs/root.callView.diffs), 无 diffs 时才回退解析 argsRaw(单次解析同时提取路径与行数)。 - 会话切换清理:
segmentLabelCache(段闭合标题缓存,每段一条字符串、长会话可达数百 KB)、liveTokenCache(每回合 1-2 条)与手动展开状态(overrides/turnOverrides)在切换 会话时清理——手动状态回到自动规则(已结束回合默认收起);ttftCache保留(每回合一个 数字,量级可忽略)。切换回原会话仅"已结束回合回到默认收起 + 段标题重新计算一次"。 - 多语言跟随:文案读取
document.documentElement.lang(DSH 切换界面语言时由dsh-client-locale设置),随 DSH 语言实时切换,浏览器语言仅作回退。
注意事项
- 兼容 DSH 0.1.1-rc.2 ~ 0.1.3-alpha.1(会话快照契约差异由插件内适配层消化、官方 渲染 hook 面自动跟随,见工作原理);DSH 升级若改变上述槽位契约或内置组件 props, 本插件可能需要随版本小改(属插件维护,非改源码)。
- 折叠栏文案在
client.js顶部CONFIG可调。 - 耦合点清单(DSH 升级时对照排查;任一失效均优雅降级——回退内置渲染 / 文案兜底 +
console.warn提示,不会白屏):- 会话快照字段:0.1.1 走
useSession快照的s.chat.order / nodes / locations、locations.getTurn()、顶层turnEnds/turnTimings、chat.timeline.turns; 0.1.2 快照拆分后改走框架注入的useChat(扁平 ChatSnapshot),turnEnds/turnTimings在chat.legacy(适配层自动选择,见工作原理)——用于段/回合分组、 结束判定、耗时与状态标签; - 节点数据结构:
tool-call的data.root(call.name / argsRaw;diffs 按版本在root.meta.diffs(0.1.2)或resultView/callView视图(0.1.1))、assistant-step的blocks(reasoning / text)与usage、turn-tail的tokensPerSecond(用于折叠栏文案、think 摘要、token/缓存命中指标); - CSS 选择器:
[data-chat-flow-kind]、[data-variant="think"](隐藏折叠成员 flowItem 与最终总结的 Think 行); - Slot 系统:
conversation.chat.node内置条目(priority: 0)、slotsService.entriesOfSlot()(委托渲染与tool.call.toolview子视图分发); - Locale 命名空间:条目的
locale:声明决定注入的t词典,且同一个 slot 上官方 条目混用两种命名空间——tool-call(ui-tool 注册)声明'conversation'(工具标题词tool.title.read=读取 等),assistant-step/context/user(ui-chat 注册)声明'chat'(message.think=思考 等);旧版全在'conversation'。插件注册时按条目 key 对应复制同 key 官方条目的声明(detectChatLocale,无对应时ctx.locale试查后回退'conversation'),转发给官方组件的t一律过wrapLocaleT兜底(查不到 key 时用 内嵌的官方词典合并本——chat + conversation + common 共 282 词条——做{占位符}插值兜底,不再裸显"message.think"/"message.contextInjection"/"tool.title.read"等任何原始 key)。
- 会话快照字段:0.1.1 走
liangmianya/dsh-synapse
alaliqing/claude-paper
omdsh-dev/dsh-annotation
Anionex/dsh-turn-rewind
hanshenmesen/dsh-turn-delete
qkycir-123/dsh-run2skill
Tyan66666/billion-context-dsh
PKUfudawei/dsh-capability-menu