消息时间轴 Guan0923/dsh-message-timeline

DSH 消息时间轴

DeepSeek Harness Web 界面的会话用户消息时间轴插件：在会话栏左缘显示最近 30 条用户消息的竖排刻度条，悬浮查看消息时间与完整内容，点击跳转定位到对应消息。

功能简介

- 完整历史，不受窗口截断影响：通过 Harness 的会话投影机制在 Host 侧折叠完整持久日志，最近 30 条用户消息全部可见——聊天区只加载了最近一段历史时，更早的用户消息仍会出现在时间轴上。
- 悬浮预览：鼠标悬浮某刻度，弹出该消息的本地时间与全文，气泡中心跟随刻度的纵向位置。
- 点击跳转：点击刻度把聊天区滚动定位到该消息；目标在已加载窗口之外时，自动分页加载更早历史（上限 20 页）后跳转。
- 高斯悬浮特效：悬浮时刻度向右单向变长，相邻刻度宽度与颜色按高斯权重渐变（中心 #361115，基色深灰玻璃）。
- 仅含用户消息（不含插话 steering，窗口内可识别部分）；刻度等高、垂直居中、间距 4px。

与 DeepSeek 的关系

本插件不是 DeepSeek 官方项目。 它是基于 DeepSeek Harness（MIT 开源）的 Cordis 插件体系开发的第三方扩展：使用其 Web 客户端插槽系统（shell.overlay）与会话投影接缝（session-projection seam）读取会话日志并推送到浏览器。数据全部来自 Harness 自身的会话日志与快照，插件不引入任何外部服务。

下载

- npm 包（推荐）：npm install -g dsh-message-timeline@latest；在普通 npm 项目内安装用 npm install dsh-message-timeline。
- 源码：git clone https://github.com/Guan0923/dsh-message-timeline.git，或仓库页面 Download ZIP。

安装与启用（dsh 的 npm 部署）

前置条件：dsh 已通过 npm 全局安装（dsh web 可用），Node ^22.19 || >=24。

1. 安装插件包：
npm install -g dsh-message-timeline@latest

2. 把包装进 dsh 的 web profile（在 ~/.dsh/profiles/web 的 workspace 中安装依赖）：
dsh plugin --profile web add dsh-message-timeline

3. 注册插件行：编辑 ~/.dsh/profiles/web/cordis.patch.yml（Windows 下为 C:\Users\\.dsh\profiles\web\cordis.patch.yml），加入：
- insert:
- id: dsh-message-timeline
name: 'dsh-message-timeline'

说明：dsh 只加载配置树中明确列出的插件行（官方自带插件同样以行为单位启用）；dsh plugin add 只负责安装依赖，注册行需要写在这个补丁文件里。

4. 重启 Web 服务：dsh web。

5. 验证：打开 http://127.0.0.1:3080，进入任意有用户消息的会话，聊天区左缘出现刻度条即成功。

插件的 @deepseek-ai/ 与 cordis peer 依赖标记为 optional——它们由 dsh 运行时环境提供，安装时不会因 peer 缺失而报错。

更新与卸载

- 更新：npm install -g dsh-message-timeline@latest，再次执行 dsh plugin --profile web add dsh-message-timeline，然后重启 dsh web。
- 卸载：
npm uninstall -g dsh-message-timeline
dsh plugin --profile web remove dsh-message-timeline

并删除 cordis.patch.yml 中的注册行，然后重启 dsh web。

使用

打开任一有用户消息的会话，聊天区左缘即出现刻度条。悬浮刻度查看时间与全文；点击刻度跳转定位；「回到底部」按钮（产品自带）可返回最新消息。

构建说明（开发者）

本项目 tsconfig.json / tsdown.config.ts 按 deepseek-harness 工作区布局编写（相对引用 ../../../tsconfig.base.client.json 与 ../tsdown.client.ts），并依赖尚未发布的 @deepseek-ai/ 工作区包与 Harness 客户端打包管线——构建必须在 deepseek-harness 检出内进行。

开源许可证和版权归属

本项目以 MIT License 开源，版权 © 2026 Guan0923，详见 LICENSE。

本项目派生自 DeepSeek Harness（© deepseek-ai，MIT License）：插件基于其 Web 客户端插槽系统与会话投影体系实现，相关代码遵循上游 MIT 条款。

当前维护状态及主要维护者

- 维护状态：维护中（actively maintained）。
- 主要维护者：Guan0923。
- 欢迎通过 GitHub Issues 报告问题、提交 Pull Request 参与改进。

已知风险、限制或兼容性说明

- 兼容性：面向 deepseek-harness 0.1.0-rc.x 的 Web GUI；依赖 @deepseek-ai/* 运行时包，独立构建需在 harness 检出内进行。
- 产品 DOM data 属性是事实契约：定位依赖 [data-conversation-scroll] / [data-composer-seat]，跳转依赖 [data-chat-anchor-key]（与 Harness 自身分页机制共用）。GUI 布局改版重命名或移除这些属性会静默破坏定位或跳转。
- 窗口外插话消息会显示为刻度：日志不携带插话标记，投影折叠无法区分窗口外插话与普通用户消息；点击这类刻度会翻页并落在插话气泡上。
- 跳转需要聊天视图挂载：在非 chat 视图页签（如轨迹视图）点击刻度无效果。
- 消息文本不设上限：超长消息会成比例增大投影载荷。
- 无开关、常驻显示：只要当前会话存在用户消息，刻度条即显示。
- 特效参数为内置常量：高斯增幅/σ/影响半径、配色、刻度尺寸目前不可配置。