概览
dsh-lifeline
DeepSeek Harness 右侧消息导航轨道：会话消息刻度 + 悬浮预览抽屉 + 星标回看 + 平滑跳转与回退过滤联动。
README / ZH
插件文档
English · 简体中文
DSH Lifeline
DeepSeek Harness 右侧消息导航轨道。
每条消息一个刻度 · 悬浮预览抽屉 · 平滑跳转 · 星标回看 · 实时平移动画
一句话总结： 常驻右侧导航轨，把对话历史变成可导航的时间线——悬浮预览，点击跳转，星标收藏。使用官方
--dsw-*token，与 DSH 生态无缝集成。
DSH Lifeline 是基于 Cordis 组合模型的 持久化 DSH bundle 插件。它在对话页面右侧渲染一条垂直导航轨，每条用户消息对应一个刻度，实时跟踪你的阅读位置。悬浮展开预览抽屉；点击任意历史消息即可平滑跳转（按需加载更早历史）。导航轨动态避让其他右侧面板（组件栏、侧栏等），并在面板开合时以协调动画平滑滑入/滑出。
功能特性
导航轨
| 能力 | 说明 |
|---|---|
| 逐条消息刻度 | 每条用户消息在垂直轨道上生成一个刻度指示线 |
| 阅读位置高亮 | 最接近当前阅读位置的刻度以品牌蓝高亮 |
| 中心轴对齐 | 轨道中心轴对齐消息排版的内容边缘——不遮挡内容 |
| 常驻显示 | 固定在右侧；会话 < 2 条用户消息时自动隐藏 |
| 窄屏自适应 | 视口 ≤ 767px（移动端/窄窗口）时自动收起 |
悬浮预览抽屉
| 能力 | 说明 |
|---|---|
| 悬浮展开 | 鼠标悬停轨道展开 260px 宽预览抽屉，显示消息文本 |
| 平滑滑入 | 抽屉从右侧以 CSS transition 滑入（可打断） |
| 点击跳转 | 点击任意条目平滑滚动到对应消息（按需加载更早历史） |
| 星标收藏 | 点击 ★ 标记重要消息；折叠态已标记项显示金色高亮；抽屉顶部「★ 只看标记」筛选 |
| 虚拟列表 | 抽屉使用虚拟列表（行高 30px）；数千轮对话依然流畅 |
| 官方 token | 背景 --dsw-alias-bg-layer-1、边框 --dsw-alias-border-l2、阴影 --dsw-shadow-lv3——与 DSH 输入框/组件栏视觉一致，双主题自动适配 |
实时平移动画
| 能力 | 说明 |
|---|---|
| 逐帧同步 | 当右侧面板（组件栏、侧栏）开合时，导航轨每帧跟随对话区宽度变化 |
| 220ms ease-out 补间 | 平滑进入/退出，可打断动画——快速 开→关→开 无缝过渡 |
| 内容流参照 | 定位基于对话区内容流容器的实时 rect；无过期缓存问题 |
会话索引 + 回退联动
| 能力 | 说明 |
|---|---|
| 完整会话索引 | host 侧 REST 端点（/api/chat-timeline-index）提供全量用户消息索引 + 增量推送 |
| 无需分页加载 | 长对话直接显示所有历史刻度，无需逐页「加载更早」 |
| 回退联动 | 被回退/撤回的消息通过 dsh-rewind 插件自动从时间线剔除 |
面板避让
| 能力 | 说明 |
|---|---|
| 动态右缘跟踪 | 检测右侧工作台（dsh-better-sidebar、dsh-widgets、aionui）并自动平移对齐 |
| 多面板感知 | 同时处理两个重叠的右侧面板 |
架构
- Host 端（
lib/index.js）：注册dshChatTimeline会话投影 + REST 索引端点（/api/chat-timeline-index）提供完整历史访问； - Client 端（
lib/client.js）：通过window.__ModuleLoader__导出{ name, inject, apply }；TimelineRail组件挂载于conversation.input.dock插槽，portal 渲染到document.body； - 定位引擎：每帧测量内容流容器的
getBoundingClientRect()；轨道中心轴对齐排版的padding-box右缘（如Md3f7G_scroll的 32px 右内边距）； - 样式：所有表面使用
--dsw-*语义 token——无硬编码 rgba，浅色/深色主题自动适配； - 数据管线：REST 增量索引 → 会话投影 → 已加载节点 → 按需
loadOlder（速度优先）。
安装
npm 一键安装（推荐）
dsh plugin --profile web add dsh-lifeline
安装完成后重启 dsh web 并刷新浏览器。
本地开发（link）
# 1. 克隆仓库
git clone https://github.com/Physicolor/dsh-lifeline.git
# 2. 在 profile 中 link
# 在 $DSH_HOME/profiles/web/package.json 中添加：
# "dsh-lifeline": "link:../../plugins/dsh-lifeline"
cd $DSH_HOME/profiles/web && pnpm install
# 3. 重启 dsh web
变更日志
v0.1.0（2026-09-01）
独立项目首次发布（原 dsh-chat-timeline 基础上重写）：
- 重写定位引擎——基于内容流容器实时 rect 逐帧跟随；兼容
dsh-better-sidebar/dsh-widgets/aionui面板避让 - 完整会话索引——host REST 端点提供全量消息历史 + 增量推送；无需逐页加载
- 虚拟化渲染——抽屉虚拟列表 + 刻度邻域切片；长对话流畅
- 中心轴对齐——轨道中心轴对齐
Md3f7G_scrollpadding-box 右缘（此前因内容内边距偏移） - 实时平移动画——面板开合逐帧同步；220ms ease-out 补间，支持打断
- 官方 token 样式——抽屉与折叠胶囊使用
--dsw-*token（layer-1/border-l2/shadow-lv2/shadow-lv3）；双主题自适应，无硬编码 rgba
致谢
本项目基于 jjxjjjjiik-bot/dsh-chat-timeline（MIT）的源码进行二次开发。插件架构最初参考 asukasec/dsh-message-preview（MIT）。
许可证
MIT © Physicolor