magicOF2/dsh-autoload-history

dsh-autoload-history

打开会话自动加载全部历史消息，免去反复点击「加载更早」。
打开会话时自动加载完整对话历史——无需再点击“加载更早”。

dsh-plugin
MIT

DeepSeek Harness（DSH）Web 打开会话时只加载最近 50 条消息，更早的内容要一页页手动点「加载更早」。本插件让打开会话即自动翻页，直到整个会话完整加载——长会话一进来就全部就绪，翻旧消息不再需要任何点击。

当 DSH Web 打开会话时，它只加载最新的 50 条消息；更早的所有内容都需要逐页点击“加载更早”。本插件会在会话打开时自动翻页加载其余内容，直到整个对话加载完毕——无需再点击即可查看旧消息。

安装 / 安装

从 GitHub 源码安装（推荐）/ 从源码安装（推荐）

dsh plugin --profile web add github:magicOF2/dsh-autoload-history

首次安装会请求 allowBuilds 构建授权（GitHub 源需要从源码构建），按提示允许后重试一次即可。 / 首次安装会请求 allowBuilds 构建授权（GitHub 源需要从源码构建）——按提示操作并重试一次。

从 npm 安装 / 从 npm 安装

发布后可用： / 发布后可用：

dsh plugin --profile web add dsh-autoload-history

npm 预构建安装会跳过 allowBuilds 步骤。 / npm 预构建安装会跳过 allowBuilds 步骤。

使用 / 使用

零配置。安装后打开任意会话即自动生效： / 无需配置。打开任意会话即可生效：

- 自动逐页加载（每页 50 条）直到整个会话全部就绪； / 自动逐页加载（每页 50 条）直到整个历史加载完毕；
- 切换会话自动跟随，互不干扰； / 自动跟随会话切换；
- 加载不打断正常聊天（翻页与实时追加互不冲突）； / 加载不会打断正在进行的对话；
- 全程无 UI 痕迹（隐形挂载在会话底部官方槽位）。 / 完全不可见——挂载在会话的官方附加槽位中。

可选设置 / 可选设置（localStorage）

| 键 Key | 值 Value | 效果 Effect |
| --- | --- | --- |
| dsh-autoload-history.disabled | '1' | 整体停用自动加载（逃生开关）/ 无需卸载即可停用插件 |
| dsh-autoload-history.maxPages | 正整数 | 单次打开会话最多自动翻的页数；缺省/'0' = 不限 / 每次打开会话最多自动翻的页数；默认不限 |

// 在 DSH Web 控制台执行 / 在浏览器控制台执行
localStorage.setItem('dsh-autoload-history.disabled', '1')      // 停用
localStorage.removeItem('dsh-autoload-history.disabled')        // 恢复
localStorage.setItem('dsh-autoload-history.maxPages', '20')     // 只翻 20 页(约 1000 条)

非法值一律回落默认（启用、不限页）。 / 非法值一律回退到默认（启用、不限页）。

工作原理 / 工作原理

- 挂载到官方会话级槽位 conversation.composer.dock（列表槽、零侵入，渲染 null）； / 挂载到官方会话级 conversation.composer.dock 列表槽位（附加式，不渲染任何内容）；
- 通过槽位标准 props 拿到会话快照（useSession 选择器）与 sessionId； / 通过槽位的标准 props 读取会话快照（useSession）和 sessionId；
- 快照 openState === 'open' 且 hasMore === true 且未在翻页时，调用 session.loadOlder() 翻一页； / 当快照处于打开状态且 hasMore 为真、没有正在进行的翻页时，调用 session.loadOlder()；
- 每翻一页快照更新 → 自动触发下一页，直到 hasMore === false；
- 防呆：连续 3 页无进展自动放弃（故障时绝不死循环）。

详见 docs/DESIGN.md。

兼容性

- DeepSeek Harness >= 0.1.0-rc.5（Web profile）
- 纯浏览器端插件：无宿主行为、无数据上报、无网络请求
- 不修改任何官方文件，卸载即完全还原

开发

npm ci
npm run build   # 产出 lib/index.mjs（Node half）+ lib/client.js（浏览器 bundle）
npm test        # node --test:纯决策核心(翻页判定/守卫/设置解析)

许可证

MIT © magicOF2

相关

- DeepSeek Harness
- awesome-dsh-plugin — DSH 插件精选列表