dsh-session-keepwarm
让最近使用的会话保留在浏览器中，切换回来时可复用已加载的历史记录，而无需重新读取。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add dsh-session-keepwarm@0.1.1Session Keepwarm 以 dsh-session-keepwarm 发布，当前版本为 0.1.1。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
Keep the most recently used sessions resident in the browser, so switching back reuses the loaded history instead of re-reading it.
Since DSH 0.1.7 the client keeps a session resident only while a SessionReference is outstanding
(see the Client references section of packages/api/session-controller/README.zh.md): a main-view
switch releases the outgoing session, and when the last reference is released the generation — local
data, scoped Context and history window — is torn down. Switching back builds a new generation and
re-reads the first history page (at least 50 messages across two turn boundaries), which the UI shows
as "Loading history…".
This plugin holds one extra reference per recently used session (under its own source key
sessionKeepwarm), so the last release never fires for those sessions. Switching back then reuses
the resident window — Session.open() is idempotent for an already-open session, so no history is
fetched again. The set is an LRU capped by the keepWarm setting, which bounds the memory the old
"keep everything" behaviour used to spend.
sessions.list snapshot: a row that gains retainedBy.mainView > 0 is the session
just switched to; it moves to the front of the LRU and is retained.keepWarm, the oldest reference is released.The settings form is derived from this plugin's Config schema (profile entry id session-keepwarm):
| key | default | meaning |
|---|---|---|
enabled | true | master switch; turning it off releases every held reference |
keepWarm | 5 | how many recently used sessions stay resident (1–20) |
keepWarm costs
more memory.dsh plugin --profile web add dsh-session-keepwarm
Then enable it in the profile. The plugin declares its host contract as
@deepseek-ai/dsh-api-session-controller ^0.1.7-rc.2 || ^0.2.0-rc.1 — the range the
dsh startup gate and the plugin market read — and is tested on DSH 0.1.7-rc.2 and
0.2.0-rc.1.
npm install # esbuild
npm run build
If the DSH client gains a "retain the last N sessions" setting (or an equivalent deferred-teardown policy), prefer that and remove this plugin.
DSH 0.1.7 起，客户端按引用计数管理会话（见 packages/api/session-controller/README.zh.md
的 Client 引用一节）：
引用保活本地会话数据、作用域 Context 和历史流…… 最后一个引用释放时，generation 先退出可访问映射，再执行清理。
主视图切换会话时先 retain 新目标、再 release 旧目标；旧会话没有别的持有者时计数归零，那一代 （含已解码的历史窗口）被销毁。切回来是新的一代，于是重新拉首页历史（≥50 条消息、跨 ≥2 个 turn），界面上就是「载入历史」。
本插件替最近用过的 N 个会话各持一张凭据（来源键 sessionKeepwarm），让它们的最后一个引用
永远不归零：同一标签页内切走再切回零重读、瞬间复用（Session.open() 对已打开会话是幂等的）
——同时 LRU 上限保证内存有界，不像旧模型那样无限保留。
sessions.list 快照：某行出现 retainedBy.mainView > 0 即视为「刚被切过去的会话」，
推到 LRU 头部并 retain；keepWarm 时释放最旧的引用；设置表单由本插件的 Config schema 派生（条目 id session-keepwarm）：
| 字段 | 默认 | 含义 |
|---|---|---|
enabled | true | 总开关；关闭即释放全部引用 |
keepWarm | 5 | 保活几个最近用过的会话（1–20） |
keepWarm 越大占用越高。dsh plugin --profile web add dsh-session-keepwarm
然后在 profile 里启用。插件把宿主契约声明为 @deepseek-ai/dsh-api-session-controller
的 ^0.1.7-rc.2 || ^0.2.0-rc.1（dsh 启动门禁与插件市场都读这个范围），已在 DSH
0.1.7-rc.2 与 0.2.0-rc.1 实测。
npm install # esbuild
npm run build
上游若为客户端加入「保留最近 N 个会话」的设置（或恢复等价的延迟销毁策略），应优先用上游设置 并移除本插件。