问题导轨导航 fupj2028/dsh-nav-rail

dsh-nav-rail

一个用于 DeepSeek Harness Web GUI 的极简左边缘导轨导航器。

当前会话中的每个用户问题都会渲染为一条细条，固定在对话列的左边缘。悬停时这些条会像水波一样泛起涟漪，一张浮动卡片会预览完整的问题文本，点击则会平滑滚动对话到该消息处。

功能特性

- 极简导轨 —— 没有面板，没有标题栏：只有一列 2px 的条固定在对话区域的左边缘（布局变化时自动重新锚定）。
- 等长条，窗口上限 —— 默认情况下所有条长度相等；导轨一次最多显示 7 条（滚轮滚动，边缘渐隐提示溢出，悬停的条自动滚动进入视野）。
- 悬停涟漪 —— 悬停的条会拉伸并变亮；相邻的条随距离衰减拉伸（46 / 36 / 28 / 22 / 18 → 16 px）。
- 滚动监听 —— 滚动对话时会高亮当前视野中问题对应的条。
- 悬停预览 —— 一张位置稳定的浮动卡片显示完整的问题文本（锚定在导轨上，绝不遮挡这些条）。
- 点击跳转 —— 通过稳定的 data-chat-anchor-key 锚点平滑滚动到该消息处。
- 感知引导 —— 打断（引导）类问题以琥珀色渲染。
- 感知主题 —— 所有颜色均来自 --dsw-* 令牌，因此浅色/深色主题会自动应用。

安装

从本地检出安装：

dsh plugin --profile web add file:/path/to/dsh-nav-rail

或手动操作：将包放到 ~/.dsh/ext/dsh-nav-rail 下，在 ~/.dsh/profiles/web/package.json 中将其添加到 web profile 的 dependencies 和 dsh.profile.bundles 中，在那里运行 pnpm install，然后重启 dsh web 进程。

工作原理

- Bundle 补丁（cordis.patch.yml）插入一行 Loader 记录，命名此包，因此客户端模块扫描会拾取 dsh.client 声明，并将 lib/client.js 注入到 window.__DSH_BOOT__ 中。
- 浏览器端在 shell.overlay 插槽中注册一个附加条目（不替换任何已发布的 UI），通过官方的 sessions.binding(id).session 接口（ConversationSnapshot）读取当前会话，并列出 user / steering 聊天节点。
- 导轨位置通过 ResizeObserver 跟踪 [data-conversation-scroll]；滚动监听使用 requestAnimationFrame 节流监听对话滚动视口。
- 纯 UI 插件：零服务端依赖（lib/index.js 是一个空的 apply，因此该包会出现在 设置 → 插件 中）。

卸载

dsh plugin --profile web remove dsh-nav-rail

许可证

MIT