聊天历史定位条 linanatoly/dsh-chat-history-locator

聊天历史定位条

一个插件，为 DeepSeek Harness (DSH) Web 界面设计：在聊天消息区左缘常驻一条竖向历史定位条，帮你快速回到聊天历史中任意一条你发过的消息。

功能特性

- 竖向定位条：常驻在消息区左缘（不遮挡消息，利用消息列自带的内边距），你发过的每条消息（user / steering 类型）对应一个圆点。
- 最多 10 个可见标记：标记超过 10 个时以滑动窗口展示；在定位条上滚动滚轮即可浏览其余标记（每 60px 滚动距离换一格，触控板平滑累积）。
- 悬浮预览：鼠标悬浮圆点 → 弹出气泡显示该消息的内容（截断 140 字）和发送时间，同时在聊天里用虚线描出对应消息；悬浮的圆点变为固定大小的蓝色空心圆（scale(1.5)，任意位置大小一致）。
- 点击跳转：点击圆点 → 聊天滚到那条消息并闪光高亮，定位窗口自动把该标记移到中间。
- 中间大、两端小：可见圆点按余弦曲线缩放（中心 1.0 → 两端 0.35），滑动换格时尺寸同步平滑过渡。
- 端点提示：全部标记都在显示（无法滑动）时上下两端同时亮起蓝色端点条；窗口模式下到达顶部/底部时，对应端点（圆弧顶点处）亮蓝条。
- 回到最新：滚离底部时条顶出现「最新 ↓」，点击回到最新消息并显示末尾标记窗口。
- 健壮性：测量全部同步执行，不依赖 requestAnimationFrame（空闲/后台页面会冻结 rAF）；通过 ResizeObserver / MutationObserver / 原生 wheel（非 passive）跟踪变化；切换会话、加载更早、输入框变高都会自动重定位。

安装

有两种安装方式：

方式一：持久安装（推荐，重启/重装桌面端后仍然生效）

把插件作为一个 dsh.client 静态插件装进 DSH 的 web profile：

1. 把本仓库的 dsh-package/ 目录复制为： <DSH_HOME>/profiles/web/node_modules/dsh-chat-history-locator/ （Windows 默认 DSH_HOME = %USERPROFILE%\.dsh）

2. 在 <DSH_HOME>/profiles/web/cordis.patch.yml 中追加：
- insert:
- id: chat-history-locator
name: 'dsh-chat-history-locator'

3. 重启 DeepSeek Harness 桌面端。定位条即对所有会话生效。

因为包和配置都位于 $DSH_HOME（用户数据目录），重新安装桌面端不会丢失插件。

方式二：动态插件（快速试用，进程重启后失效）

在 DSH 会话内通过 cordis_define / cordis_run 工具加载（闭包符号 React / styles / host 仅在动态插件环境中存在）：

1. 在 DSH 会话中让 Agent 执行： cordis_define:
plugin: { kind: "new", idPrefix: "chloc" } （或任意 3–6 位小写字母前缀）
name: "Chat History Locator"
purpose: "聊天历史定位条"
code.client = plugin/client.js 的全部内容
2. cordis_run 激活返回的 pluginId / packageId，并在运行卡片上批准。

注意：动态插件只存在于当前进程，重启或重装后需要重新加载。

工作原理

| 关注点 | 方案 |
| 数据来源 | Session 标准 kit 的 useSession：snapshot.nodes（legacy 兼容层）+ chat.nodes（把消息 seq 映射到 DOM 行的 data-chat-anchor-key） |
| 滚动容器 | 产品自带的 [data-conversation-scroll]，跳转公式与官方 chatScroll 记忆逻辑同源，不与自动跟随底部冲突 |
| 测量时机 | useLayoutEffect 同步测量 + ResizeObserver（滚动区/输入区/消息流）+ MutationObserver（流元素挂载/卸载）+ scroll/resize 监听 |
| 滚轮浏览 | 原生 wheel 监听（passive: false + preventDefault），增量累积 60px/格 |
| 样式 | 插件自持 标签（ctx.effect 生命周期管理），CSS 变量驱动缩放（--dsh-loc-scale） |

文件

- dsh-package/ — 静态插件包（package.json + lib/index.js 空宿主半身 + lib/client.js 浏览器半身），持久安装用
- plugin/client.js — 动态插件源码（code.client 函数体），快速试用用
- CHANGELOG.md — 从 v1 到定稿的演进记录
- LICENSE — MIT

许可

MIT © 2025

在 DeepSeek Harness 会话里经过 11 轮迭代打磨而成 —— 从一条朴素的标记条，到带窗口、可滚轮浏览、带动画的定位条，最后打包成持久化的静态插件。