会话秒切 guofug/dsh-fastswitch

dsh-fastswitch

让 DeepSeek Harness 的会话切换变快，只做两件事，都可单独关闭。

English: README.md

它解决什么

切换会话时，DSH 会重新向 Host 要一份「首屏历史」。这段历史有一个写死的窗口——至少 50 条消息——在长对话里这一帧能达到 2 MB，而这正是切换时那几秒的等待来源。

同时，页面初次构建时，几个组件会各自去拉同一批只读目录接口：session/modelCatalog 6 次、credentials/describe 7 次、agentPresets/list 6 次、cotTranslation/limits 3 次。它们没有去重，也没有缓存。

dsh-fastswitch 在浏览器里对这两件事各做一处改动：

1. 首屏窗口可配置 —— 把外发的 session/follow 请求里的 turnWindow.minMessages 从 50 改小（默认 20）。Host 只校验 0 < minMessages <= maxMessages，所以这是协议允许的请求，不是打补丁。凡是要「加载更早」的分页请求（200 条）一律不动。
2. 只读 RPC 去重 + 缓存 —— 包装 window.fetch，对只读目录接口做 5 分钟结果缓存，并发调用合并为一次实际请求。

实测

同一台机器、同一个页面、同一段会话：

| 指标 | 默认 | 装上之后 |
| 首屏快照（一次长会话） | 2,040,432 B | 1,054,070 B |
| session/modelCatalog | 6 次 | 1 次 |
| credentials/describe | 7 次 | 1 次 |
| agentPresets/list | 6 次 | 1 次 |
| 首屏请求总数 | 52 | 33 |

数字来自一次真实测量，取决于会话长度与浏览器缓存状态，不是常量。

安装

在插件市场里搜索 fastswitch，或直接：

dsh plugin --profile web add github:guofug/dsh-fastswitch

装完重启或等 HMR 重载一次生效。

配置

全部通过 localStorage，无需改配置文件：

| 键 | 默认 | 说明 |
| dsh-fastswitch | — | 设为 off 关闭全部功能 |
| dsh-fastswitch-window | 20 | 首屏窗口条数；0 表示不改写 |
| dsh-fastswitch-ttl | 300000 | 结果缓存时长（毫秒）；0 表示不缓存 |
| dsh-fastswitch-merge | 800 | 并发合并窗口（毫秒） |

例：

localStorage.setItem('dsh-fastswitch-window', '10') // 更激进
localStorage.setItem('dsh-fastswitch', 'off') // 临时全关

怎么确认它在工作

window.__dshFastswitch
// { installed: true,
// ws: { rewritten: 3, untouched: 40 },
// fetch: { calls: 51, hits: 10, dedup: 8, bypass: 33 } }

- ws.rewritten 每切换一次会话应 +1；
- fetch.hits + fetch.dedup 就是省掉的请求数。

边界

- 只影响浏览器。终端、SDK、ACP、其他客户端不受影响。
- 不改 DeepSeek Harness 的任何文件，也不改 Host。窗口是通过改写外发请求实现的，缓存是浏览器侧的 fetch 包装；卸载插件即恢复原行为。
- 不含「会话停泊缓存」（把已打开的会话留在内存里以便瞬间切回）。那需要改动 Session 生命周期内部实现，跨版本容易碎，本项目有意不做。
- 缓存只覆盖只读目录接口。任何写操作、流式响应、鉴权接口都不在缓存范围内。

兼容性

- 面向 dsh ^0.2.1-rc.2（见 engines.dsh）。
- 两处包装都做了幂等保护，HMR 重载不会重复叠加。
- 任何一处包装失败都不会破坏页面：失败即跳过，功能降级为原生行为。

许可

MIT