会话问题导航条 hhb1028/dsh-client-ui-timeline

dsh-client-ui-timeline — DSH 会话问题导航条（对标 ZCode TurnNavigator）

⚠️ 已停止维护（2026-10-01）

DSH 官方客户端 @deepseek-ai/dsh-client-ui-chat（0.2.0-rc.2 起，随 DSH Desktop 2.0.17 分发）已内置会话 turn rail：位于会话区右缘，支持悬停/聚焦预览气泡、运行中（busy）状态、未加载轮次（点击自动翻页加载）、容器宽度 ≤900px 自动隐藏、键盘可达与 prefers-reduced-motion。数据来自 turnOutline 投影 + 已加载窗口，跳转走 session.loadThrough(seq) 一次翻页到位。

本插件（左缘 dash 版）与之功能重复，因此停止维护，npm 包已标记 deprecated：npm view dsh-client-ui-timeline deprecated。

- 推荐做法：卸载本插件（见下方「卸载」），直接使用官方导航条。
- 仍然适用：会话区宽度 < 900px 时官方 rail 会隐藏，此时本插件仍可用；或你更喜欢左缘位置与 2.6× 距离渐变视觉。
- 历史价值：本仓库保留了「宿主还没有官方 turn 导航时如何自行实现」的完整记录，可作为旧版 DSH（@deepseek-ai/ 0.1.x）的参考实现。
- 已知问题（不再修复）：600ms 全量轮询 + 逐条 getBoundingClientRect；jumpTo 翻页期间存在最长 600ms 的索引错位窗口；助手预览只取首条 assistant-step；「助手仍在工作」文案未区分历史轮次；缺少生命周期清理（无 dispose）。详见 DSH-自研插件代码审查报告-2026-10-01.md。

给 DSH Web GUI 复刻 ZCode 桌面端的「对话问题导航」：

聊天区左缘一列小横杠——一问一杠（含会话中的 steering 追问），窗口够宽时常驻：

- 随滚动：当前所在问题的杠高亮拉长（2.6×），相邻两根也按距离渐变拉伸，运行中的最后一问常亮；导航条自动滚动跟随当前杠。
- 悬停某根杠：右侧弹出该轮问答预览气泡（用户问题 2 行加粗 + 助手回复 3 行，≤2 段、220 字截断；无正文显示「暂无助手正文」，回合运行中显示「助手仍在工作」）。
- 点击：该问题的消息行平滑滚动到视口顶部（prefers-reduced-motion 时瞬时）；目标行未渲染时自动 loadOlder 翻页（上限 80 页）后再跳。
- 少于 2 问不显示；会话宽度 < 640px 隐藏（ZCode 原版阈值 864px，此处放宽）。

English README

安装

本节仅作历史记录；官方已内置同等能力，不建议再安装。

在 DSH 的 profile（如 desktop）里，编辑 profiles/<name>/package.json：

1. 在 dependencies 加（推荐用 npm 已发布的稳定版本）：

"dsh-client-ui-timeline": "^0.1.0"

想固定某个历史提交，也可以用 GitHub 依赖（<commit hash> 换成你想固定的那次提交的完整 40 位 hash）：

"dsh-client-ui-timeline": "github:hhb1028/dsh-client-ui-timeline#<commit hash>"

2. 在 dsh.profile.bundles 数组加 "dsh-client-ui-timeline"。
3. 在 profiles/<name> 目录下执行 pnpm install。
4. 重启 DSH。

包自带 cordis.patch.yml（insert id ui-timeline-scrubber），经 dsh.bundle.patch 自动生效；勿在 profile 的 cordis.patch.yml 重复 insert 同 id（Loader 会抛 duplicate loader entry id，vision-toolkit/meow-smooth 同款坑）。

兼容性

- 针对 DSH Desktop 2.0.2（@deepseek-ai/ 0.1.1-rc.2）开发；在 2.0.17（0.2.0-rc.2）上仍能挂载，但与官方 rail 重复，故停止维护。
- 依赖会话 chat 节点形状与 [data-conversation-scroll] / [data-chat-flow-key] 的 DOM 契约。
- DSH 大版本更新可能改变上述形状/契约导致失效；失效时功能静默隐藏，不影响 DSH 本体。

卸载

从 profiles/<name>/package.json 删掉依赖与 bundles 条目，pnpm install，重启 DSH。

也可以直接执行：

cd ~/.dsh/profiles/desktop && pnpm remove dsh-client-ui-timeline

然后从 dsh.profile.bundles 数组里删掉 "dsh-client-ui-timeline" 并重启 DSH。

实现说明（对照 ZCode 原版）

- 原版：out/renderer 的 TurnNavigator 组件（chat.turnNavigator. i18n），挂在虚拟化会话列表旁，onJumpToQuery 把 data-row-id 行滚到视口顶、行未挂载时 scrollToIndex + 12 帧 rAF 轮询。
- 本插件：DSH 会话无虚拟化，全部行在 DOM——坐标直接量 [data-chat-flow-key] 行的 getBoundingClientRect；数据链 sessions.list.current → scope(id)（ctx 代理）→ sessionOf(ctx) → getSnapshot().chat.{order,nodes,timeline}；一问一杠从 kind:user/steering 节点生成，回复预览取该回合首个有正文的 assistant-step。
- 视觉规格照抄原版：10px/杠、杠 12×2px 圆角、scaleX 距离渐变（2.6/1.7/1.25）、气泡 w-320 右偏 8px、line-clamp 2/3、220 字截断、left-3 top-1/2 导轨、隐藏滚动条；颜色换用 DSH 的 --dsw-alias- 变量跟随主题/皮肤。
- 纯浏览器半区（window.__ModuleLoader__ 模块，id 必须等于包名），零构建、不碰 dsh 本体；host 半区为惰性空插件。所有宿主访问有防御：上游形状变化时功能静默隐藏，不卡 web boot。

许可证

MIT