dsh-jump-to-top

一个极简的 DeepSeek Harness (DSH) Web 客户端插件:在聊天视图右下角、官方「回到底部」按钮的左侧,增加三个悬浮按钮:「回到下一条消息」「回到上次发消息处」「回到最顶部」。

A tiny DeepSeek Harness web plugin: adds three floating buttons — next-message, back-to-last-message and back-to-top — to the chat view, placed immediately left of the official "back to bottom" button.

功能 / Features

• 当你向上滚动聊天记录(离开底部)时,三个按钮自动浮现,位于官方「回到底部」按钮左边; All three buttons appear as soon as you scroll up into history — left of the built-in toBottom button.
• 回到下一条消息:跳到当前阅读位置下方最近的那条你发的消息; Next message: jumps to the closest user message below your current position.
• 回到上次发消息处:跳回你当前阅读位置之前最近的那条消息——在读 AI 长回复时,它带你回到引出这段回复的那条提问; Back to last message: jumps to the closest user message above your current position — while reading a long reply, it takes you back to the question that produced it.
• 连续点击向上/向下回溯:不滚动界面,再点一次就跳到上一条/下一条你发的消息(3 → 2 → 1 或 1 → 2 → 3);手动滚动后重新基于新位置定位; Walk by repeated clicks: click again without scrolling to jump one message further (3 → 2 → 1 or 1 → 2 → 3); manual scrolling resets to the viewport-relative target.
• 回到顶部后按钮自动隐藏; Hides again at the top.
• 纯前端实现:不访问任何主机服务,不做任何文件/进程/网络操作; Pure client-side: no host services, no file/process/network access.
• 遵循系统 prefers-reduced-motion 设置。 Respects prefers-reduced-motion.

安装 / Install

# 从 npm 安装(推荐)
dsh plugin --profile web add dsh-jump-to-top

# 或直接从 GitHub 安装
dsh plugin --profile web add github:rjm1130/dsh-jump-to-top

# 或 clone 后本地安装(注意路径不要含空格)
git clone https://github.com/rjm1130/dsh-jump-to-top.git
dsh plugin --profile web add <克隆路径>

装完重启 dsh web(或按 Ctrl+F5 强制刷新页面重新加载 client bundle),打开任意聊天会话,向上滚动即可看到按钮。

卸载:

dsh plugin --profile web remove dsh-jump-to-top

工作原理 / How it works

• 主机端 (lib/index.js):空壳,保证 bundle 是合法的 profile 层,无任何主机行为;
• 浏览器端 (lib/client.js):把按钮作为第一个子元素插入官方 .Md3f7G_toBottomSlot 容器,因此天然位于「回到底部」按钮左侧,并复用官方 sticky 定位(自动避让输入框、右对齐);
• 滚动容器自适应两种布局:独立聊天的 .Md3f7G_scroll,以及外壳集成布局中带 [data-conversation-scroll] 的真实滚动容器;
• 通过 MutationObserver 跟随聊天视图懒加载与 React 重渲染,按钮始终保持在正确位置。

兼容性 / Compatibility

• 目标:DSH 0.1.0-rc.6+ web 界面;
• 无运行时依赖、无 peer 依赖。

开发 / Development

git clone https://github.com/rjm1130/dsh-jump-to-top.git
dsh plugin --profile web add <克隆路径>

提交前请确保 npm pack --dry-run 与 node --check 通过。

License

MIT © 2026 rjm1130