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,此处放宽)。
安装
本节仅作历史记录;官方已内置同等能力,不建议再安装。
在 DSH 的 profile(如 desktop)里,编辑 profiles/<name>/package.json:
- 在
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>"
- 在
dsh.profile.bundles数组加"dsh-client-ui-timeline"。 - 在
profiles/<name>目录下执行pnpm install。 - 重启 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
No comments yet. Be the first to write one.