建议：将「对话导航」拆为可插拔插件，或至少补齐总数显示与超长方案

[AbelKeithsun]

建议：将「对话导航」从外壳中拆出为可插拔插件，或至少补齐导航条的总数显示与超长方案

TL;DR / 一句话：把会话里纵向的对话导航（问答轮次定位条）做成独立、可插拔、可替换的插件能力，且导航条锚定边可切换左右；若暂时无法拆出，请至少为现有导航增加「总数显示」，并在轮次过多、条带超长时给出明确的展示方案——我的实现可作为参考。

背景 / Background

我是 DSH 外部插件 dsh-question-nav 的作者。它为 DSH Web GUI 的对话栏加了一条竖向圆点导航：每个圆点对应一个用户提问轮次（turn），悬停放大、弹出该轮提问全文与发出时间的卡片、点击可跳转到对应消息；轮次过多时条带限高、分页翻动，并带有「当前位置」高亮标记。

这个需求其实应该是对话 UI 的基础能力（尤其长会话时没有它，回看某个提问非常困难）。与其在插件里做，不如官方把它做进外壳/作为官方插件——这也是我来提建议的原因。

一、强烈建议：把「对话导航」拆成可插拔的插件能力

现状痛点：现在这种导航只能靠第三方插件实现，而我是在逆向 session.getSnapshot().chat 这类内部数据结构、并监听 DOM（[data-chat-anchor-key]、[data-chat-flow]、[data-conversation-scroll]）才做出来的。这在每个 SDK 版本升级时都可能被打破（例如 0.1.1-rc.1 → 0.1.2-alpha.2 里 session.getSnapshot().chat 就被移除了）。

建议：DSH 外壳提供一套稳定的「会话导航」服务/接口：

• 官方提供一组只读的会话结构接口（每轮 turn 的起始消息 key、全文、发送时间、会话内位置），供任何导航插件消费，不再依赖内部 chat 快照形状；
• 官方提供导航条的空位/插槽（例如 shell.overlay 这类已有插槽之外，再留一个「conversation nav」专用插槽），让第三方导航实现可以插拔替换——用户能装不同的导航风格，官方也能保留一个默认实现；
• 导航条的锚定边可配置（左 / 右），由用户或插件决定放在对话栏哪一侧。

这样：插件不再需要脆弱的内部结构依赖；用户能按喜好换导航、选位置；官方更新 UI 时也不会反复破坏第三方导航。

二、若暂不能插拔：请补齐「总数显示」

哪怕不拆插件，也请至少在现有导航里加上：

• 总数显示：当前会话总共有多少个问答轮次/提问（类似我插件点列上方的计数）。
• 当前位置：现在正读到第几轮（我插件里做了 scroll-spy：随阅读位置高亮当前轮次，只在轨迹/对话视图中显示，从不自动滚动条带）。

这两点对长会话定位非常重要，属于成本很低、收益很高的增强。

三、轮次过多、条带超长时的展示方案（推荐按我的实现）

长会话（几十上百轮）时，简单的「圆点全画出来」会溢出屏幕。我的方案，供官方参考：

1. 条带限高 + 分页翻动：导航条垂直居中、最多占对话栏高度约 60%；超出部分不画，用 ▲/▼ 三角按钮分页翻出，每次翻出 N 个（可配置 3/5/8/10）。原生滚动条隐藏，滚轮/触控板仍可滚。
2. 不自动滚动：悬停只是放大与预览，绝不自动滚动条带（避免误触）。
3. 悬停放大 + 邻居预览：悬停圆点放大，同时显示其上下各 2 个邻居，配合一张聚焦卡片，快速定位。
4. 总数 + 当前位：见上条，帮助知道「总共有多少、我在哪」。
5. 锚定边可切换（左 / 右）：见第四部分。

这套方案已经在一个真实的 Web GUI 上跑通，含滚动条避让（右对齐时让位原生滚动条）与明暗主题适配，可直接作为官方默认实现的参考基线。

四、导航条位置：支持左右切换

导航条放在对话栏哪一侧是很影响日常体验的选项，建议官方默认导航直接内置：

• 可配置锚定边：导航条对齐支持 左 / 右 一键切换（设置里一个选项即可，无需重启）；用户也可以按自己习惯（如对话内容靠左、或更喜欢贴近右侧滚动条一侧）选择。
• 右对齐时避让原生滚动条：切到右侧时，导航条应按 DSH 滚动条宽度（--dsh-scrollbar-width）让位，保证原生滚动条始终可见、可点（与外壳 composer-seat 的做法一致）。我的实现已处理好这一点。
• 切换仅影响导航条自身：卡片级联、当前位置高亮、分页等行为跟随锚定边镜像，不改变对话内容布局。

这个能力成本很低，但对左右手习惯、屏幕空间利用都是实打实的提升。

结尾 / Closing

• 如果官方愿意把导航做成可插拔服务 + 默认实现，我很乐意把现有实现的思路与设计（src/core/ 里与 UI 解耦的纯逻辑 + 插槽注入）整理成 proposal 或直接贡献代码。
• 也欢迎官方直接使用本文第三部分的方案作为内置导航的默认行为。
• 我的插件在 npm（@luziyang2026/dsh-question-nav），GitHub 上有完整源码与截图，可随时对照参考。

谢谢 DSH 团队！这个项目真的很有潜力，希望导航这类基础体验能尽快进入官方能力。

---

注：若官方已规划相关能力，请忽略并保留此条供讨论参考。

[zhj9709]

支持。官方做的的还没有第三方的好用

[AbelKeithsun]

哈哈，可以支持一波我做的，迭代过多次，欢迎提issue

[biggerboy]

我也做了一个https://github.com/biggerboy/dsh-conversation-anchors

[AbelKeithsun]

挺好的，有没有测试，当对话条数超过100条的时候横线会不会越界？

[AbelKeithsun]

官方能不能吸收一下？现在最新版的这个钢琴条样式是可以，但是没有总数和快速的一个跳转，感觉差很多，而且一旦对话框空间变小，它就不显示了，这也是个坑啊。