linanatoly/dsh-chat-history-locator

README 摘要

Chat History Locator 一个为 DeepSeek Harness (DSH) Web 界面设计的插件：在聊天消息区左缘常驻一条 竖向历史定位条 ，帮你快速回到聊天历史中的任意一条你发过的消息。 A plugin for the DeepSeek Harness (DSH) web UI: a persistent vertical marker rail on the left edge of the chat area, letting you jump back to any message you sent. 功能特性 / Features - 竖向定位条 ：常驻在消息区左缘（不遮挡消息，利用消息列自带的内边距），每个你发过的消息（ user / steering 类型）对应一个圆点。 - 最多 10 个可见标记 ：标记超过 10 个时以滑动窗口展示；在定位条上 滚动滚轮 即可浏览其余标记（每 60px 滚动距离换一格，触控板平滑累积）。 - 悬浮预览 ：鼠标悬浮圆点 → 弹出气泡显示该消息的内容（截断 140 字）和发送时间，同时在聊天里用虚线描出对应消息；悬浮的圆点变为 固定大小的蓝色空心圆 （ scale(1.5) ，任意位置大小一致）。 - 点击跳转 ：点击圆点 → 聊天滚到那条消息并闪光高亮，定位窗口自动把该标记移到中间。 - 中间大、两端小 ：可见圆点按余弦曲线缩放（中心 1.0 → 两端 0.35），滑动换格时尺寸同步平滑过渡。 - 端点提示 ：全部标记都在显示（无法滑动）时上下两端同时亮起蓝色端点条；窗口模式下到达顶部/底部时，对应端点（圆弧顶点处）亮蓝条。 - 回到最新 ：滚离底部时条顶出现「最新 ↓」，点击回到最新消息并显示末尾标记窗口。 - 健壮性 ：测量全部同步执行，不依赖 requestAnimationFrame （空闲/后台页面会冻结 rAF）；通过 ResizeObserver / MutationObserver / 原生 wheel （非 passive）跟踪变化；切换会话、加载更早、输入框变高都会自动重定位。 安装 / Install 有两种安装方式： 方式一：持久安装（推荐，重启/重装桌面端后仍然生效） 把插件作为一个 dsh.client 静态插件 装进 DSH 的 web profile： 因为包和配置都位于 $DSH HOME （用户数据目录）， 重新安装桌面端不会丢失插件 。 方式二：动态插件（快速试用，进程重启后失效） 在 DSH 会话内通过 cordis define / cordis run 工具加载（闭包符号 React / styles / host 仅在动态插件环境中存在）： 注意：动态插件只存在于当前进程，重启或重装后需要重新加载。 工作原理 / How it works …

分类