DSH HUB
HomePlugin StorePlugin PacksCommunityRankingsResourcesPublish Guide
Plugin source
Back to catalog

hhb1028 /

hhb1028/dsh-client-ui-timeline

Verified

DSH Web GUI 会话问题导航条:聊天区左缘一问一杠,随滚动高亮当前问题、悬停显示问答预览气泡、点击把该问平滑滚到视口顶(未渲染的更早历史自动翻页加载),无需改动 dsh 本体源码

★ 0 Stars0 Forks0 IssuesN/A Community rating0 Confirmed installs
View on GitHub
READMESource: main@1300e795

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>"
  1. 在 dsh.profile.bundles 数组加 "dsh-client-ui-timeline"。
  2. 在 profiles/<name> 目录下执行 pnpm install。
  3. 重启 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

—/ 5

No ratings yet

Verified DSH bundle

Commit 1300e795b98c

Community comments

No comments yet. Be the first to write one.

DSH HUB

A community index for DSH plugins. Not an official GitHub or DeepSeek AI product.

CommunityResourcesAPIAbout