Physicolor/dsh-lifeline

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_scroll padding-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