前言¶
在 DSH 的 Web 会话里，多轮输入、补充指令和助手回复混在一起，长会话中定位自己某一条消息比较麻烦。dsh-tick-rail 在会话旁边提供一列刻度线，把用户消息作为索引，用来做快速跳转和预览。
这是什么¶
dsh-tick-rail 是 DeepSeek Harness Web UI 的 tick-rail conversation navigator。仓库由 caisiyang123 维护，许可证为 MIT。它是纯 Web 客户端插件，host 侧为空实现，安装后可在浏览器 UI 和 DSH Desktop 中使用。
核心功能¶
安装后，rail 会按用户消息生成刻度：
- 一条用户消息对应一个刻度；助手回复不占刻度。
- 鼠标经过 rail 时，高亮位置呈峰值衰减：中间刻度最长，两侧均匀变短。
- 悬停时，rail 旁边显示对应消息的片段预览。
- 点击 rail 任意位置，会话平滑滚动到对应用户消息。
- rail 可键盘聚焦：方向键移动峰值，
Enter或Space跳转，Escape收起预览。 - 用户消息少于 3 条时自动隐藏；没有打开会话时不渲染任何内容。
实现说明¶
它是纯 Web 客户端插件，host 侧为空实现。客户端模块挂载在 shell.overlay 插槽，通过会话 DOM 的 data-chat-flow-* 标记定位消息，并使用 --dsw-alias-* 主题变量适配亮色和暗色模式。
安装与启用¶
先从最新 release 下载 .tgz 包，然后执行：
dsh plugin add ./dsh-tick-rail-<version>.tgz
安装完成后重启 dsh web 生效。如果当前已有 Web 进程，可以停止后重新执行：
dsh web
也可以直接从 GitHub 安装：
dsh plugin add github:caisiyang123/dsh-tick-rail
如果安装因 allowBuilds 报错中断，把 pnpm 输出中给出的键加进 profile 目录的 pnpm-workspace.yaml，然后重新执行安装命令。
典型用法¶
下面是在一条已有会话中验证 rail 的常规路径：
1、把鼠标移到会话旁边的 rail 上，查看峰值高亮和消息片段。
2、点击 rail 的目标区域，让会话平滑滚动到对应用户消息。
3、用键盘操作时，先聚焦 rail；用方向键移动峰值，Enter 或 Space 跳转，Escape 收起预览。
适用场景与注意¶
适合在 DSH Web 或 DSH Desktop 中进行多轮对话调试、希望减少滚动查找的人。使用前注意：
- 插件以当前 dsh 进程权限运行。安装前建议检查仓库源码、版本、依赖与许可证。
- 本插件许可证为 MIT；可选 peer dependency 为
@deepseek-ai/cordis。 - 从 GitHub 安装时，pnpm 可能要求构建授权；即使本包没有构建步骤，也可能出现
allowBuilds相关报错。 - 用户消息少于 3 条时 rail 不显示，没有打开会话时不渲染，这是预期行为。
短结尾¶
dsh-tick-rail 把长会话中的用户消息变成一条可悬停、可点击、可键盘操作的索引 rail。GitHub 仓库：https://github.com/caisiyang123/dsh-tick-rail。已核实材料未提供目录页 URL，本文不附目录页链接。
