Max-Null/dsh-chat-rail ↗★ 6

@max-null/dsh-chat-rail

画卷式消息导航栏:右侧竖条 hover 展开画卷,scroll-spy 高亮居中跟随,编号+时间+完整预览,锚定会话列右缘避让侧边栏,收藏过滤,tip 内嵌提问&回答直达 适合需要快速预览、高亮跟随和收藏过滤历史会话消息的用户。

패키지
@max-null/dsh-chat-rail
호환성
미검증
Harness peer 범위
^0.1.2-alpha.2
Cordis peer 범위
^4.0.1
버전
0.6.4
라이선스
MIT
최근 업데이트
2026. 9. 14.

설치

$npx -p @deepseek-ai/dsh dsh plugin --profile web add github:Max-Null/dsh-chat-rail

@max-null/dsh-chat-rail

本插件属于 @max-null/* 插件系列——这一系列共同构成 SSID(思灵 · Seek Soul in Darkness) 桌面体验。SSID 是整合它们的盒:dsh-capture · dsh-chat-rail · dsh-chinese-thinking · dsh-draft-polish · dsh-guardian · dsh-habit · dsh-memory · dsh-node-appearance · dsh-plugin-center · dsh-quick-toolbar · dsh-skill-mcp-center · dsh-ssid-panels · dsh-ssid-zh-ui · dsh-achievements。

This plugin belongs to the @max-null/* family — a set of plugins that together form the SSID (思灵 · Seek Soul in Darkness) desktop experience.

面向 DeepSeek Harness 的画卷式消息导航栏:会话面板右侧的一条竖排导航,每条用户消息一个指示点,scroll-spy 跟随阅读位置,hover 展开画卷查看消息列表,点击跳转任意历史消息;消息 hover tip 内嵌「提问&回答」直达区,收藏 + 一键回填输入框。

不同于市面上"面板弹出式"的导航插件,dsh-chat-rail 采用画卷式展开:收起时是一条干净的竖条,hover 时从右往左平滑展开,像打开画卷一样。

截图

画卷展开:只显示收藏(通栏 header + 黄色收藏条)消息操作按钮(收藏 ★ / 填充 ➕ / 复制)+ 折叠态导航条
rail-fav-1rail-fav-2

为什么比市面上的导航栏优秀

市面上的会话导航插件(chat-timeline / milestone / msg-nav / turn-rail…)大多只做"指示条 + 点击跳转",在真实使用中有一堆体验问题。dsh-chat-rail 针对每一个问题给出了答案:

能力市面同类dsh-chat-rail
与侧边栏/底栏共存❌ 展开时与 better-sidebar 错位、遮挡✅ 锚定会话区右列 + 底栏变量避让:导航条实时跟随会话列右缘,官方右侧边栏 push 展开时会话列左移、导航同步左移(共享同一段过渡动画),不再被压在面板下面;底栏展开收起按 --dsh-sidebar-height 垂直避让,互不遮挡
空间不足❌ 依然悬浮,遮挡会话✅ 自动退场:会话区剩余宽度不足( add @max-null/dsh-chat-rail

或手动加入 profile 的 `package.json` dependencies + `dsh.profile.bundles`:

```yaml
- id: chat-rail
  name: '@max-null/dsh-chat-rail'

交互

  • hover 导航条:画卷展开,显示编号 / 相对时间 / 消息预览
  • hover 消息项:左侧弹出完整内容 tip 面板(含图消息在文本上方显示图片缩略图;tip 底部**「提问&回答」区**列出该消息内的提问——SVG 图标 + 单行问题,点击直达提问/回答位置)
  • 点击消息项:跳转到会话中对应消息(未加载的历史自动补载;DSH 0.1.2-alpha.3+ 走官方 loadThrough 精确跳转,旧内核回退逐页循环)
  • 滚动会话:高亮点跟随,导航条自动滚动保持居中
  • 含图消息:展开态显示柔和图片角标(收起态不显示,保持竖条干净)

收藏与快速填充

  • 消息操作按钮:每条用户消息的复制按钮左侧新增两个按钮
    • 星 ★:收藏/取消收藏该消息(收藏后变成黄色实心星);收藏状态按会话持久化(localStorage),刷新与重启后保留
    • 加号 +:一键把该消息全文 + 附件填入输入框(草稿设为消息全文,历史图片经官方附件通道回填入输入框)
  • 导航条联动:收藏的消息指示条显示为黄色;展开态在标题前显示小星标
  • 只显示收藏:过滤开关是导航面板的通栏 header(星标 + 文案 + 底部分隔线,折叠/展开同构、贴顶),点击点亮(黄色实心)后导航栏只显示已收藏的消息;再点恢复全部。列表在 header 之下独立滚动,开关不压住条目;无收藏时不显示该开关,过滤中取消最后一条收藏会自动退出过滤

架构

  • host 半端(lib/index.mjs):注册 chatRail 会话投影——从 session log 折叠用户消息锚点 { seq, time, text, id }(排除插件/工具注入的上下文行)
  • client 半端(lib/client.js):conversation.input.dock 槽注入,portal 渲染到 body;右缘实时测量会话列定位(ResizeObserver + 兜底采样),侧边栏 push 展开时跟随移动,空间不足时淡出
  • 数据源优先序:chatRail 投影 → 已加载聊天节点 → 后台 loadOlder 循环

SSID 系列

本插件是 SSID(思灵 · Seek Soul in Darkness) 全家桶的一员;也可以单独安装到任意 DSH profile——除设置卡片外不依赖其它同系列插件(右侧边栏避让、导航条定位都走官方 DOM 契约,缺失时自动降级)。

开发

pnpm install
pnpm typecheck   # tsc 严格类型检查
pnpm build       # 产出 lib/

License

MIT