dsh-context-rotate
Verifieddsh-context-rotate · v0.1.1 · MIT
DeepSeek Harness 插件:监控会话上下文占用,到达阈值时发出轮转信号并可自动归档会话,配合记忆插件实现「上下文满了先存档再换新会话」。
Install
dsh plugin add dsh-context-rotate Confirm the layer applied with dsh --profile default --dump-config — see the install guide.
Source
Tags
Creators
Readme
dsh-context-rotate
给 DeepSeek Harness 用的上下文轮转信号插件:盯着每条会话的上下文占用,到阈值就广播事件;配置成 archive 时顺手把会话归档,让记忆插件先落盘、驱动方再开新会话。
一句话:上下文快满了先存档,再换新会话——不用人盯着。
它解决什么问题
DSH 不会因为「上下文快满了」自动换会话。长期挂着跑的自动化会话(QQ/Telegram 桥接、定时任务、常驻 agent)会一直往同一条会话里堆:
- 越跑越慢、越跑越贵(每轮都要重读整段历史)
- 最后被上下文窗口硬顶断,或者压缩得不干净
- 记忆没落盘就换会话,等于失忆
本插件把「判断」和「动作」拆开:
判断层(本插件) 读 contextPressure 投影,到阈值 → 广播 context-rotate/needed
动作层(驱动方) 谁开的会话谁负责:重建映射、开新会话、通知用户
插件不替驱动方换会话——会话是驱动方建的,映射也在它手里;插件硬换只会让驱动方拿着一个已归档的 sessionId 继续发消息。
安装
dsh plugin --profile web add dsh-context-rotate
装完重启一次 DSH。
需要 DSH 版本带
sessionProjections服务(当前稳定版都有)。
配置
默认值即可用。要改就在 profile 的 cordis.patch.yml 里追加同名 id 的覆盖段(不要改包里的 cordis.patch.yml,升级会被覆盖):
- id: dsh-context-rotate
config:
thresholdTokens: 100000 # 上下文到 10 万 token 就算该换了
action: signal # signal = 只发信号;archive = 顺便归档会话
| 字段 | 默认 | 说明 |
|---|---|---|
thresholdTokens |
100000 |
触发阈值(tokens) |
contextWindowRatio |
0 |
>0 时改用「窗口 × 比例」判断,优先于 thresholdTokens |
action |
signal |
signal 只广播;archive 广播后调用 workspaceRegistry.archiveSession |
includeCwd |
[] |
只处理 cwd 含这些子串的会话;空 = 全部 |
excludeCwd |
[] |
cwd 含这些子串的一律跳过,优先级高于 include |
cooldownMs |
600000 |
同一会话两次动作的最小间隔(防抖) |
log |
true |
是否打日志 |
只对自动化会话生效的例子
- id: dsh-context-rotate
config:
thresholdTokens: 100000
action: archive
includeCwd:
- 'qq-bridge\state\agents' # 只处理 QQ 桥接开的会话
- 'scheduled-tasks'
excludeCwd:
- 'Downloads' # 别动桌面上的临时会话
事件
插件会 ctx.emit 两个事件,驱动方在自己的插件里监听即可:
ctx.on('context-rotate/needed', (payload) => {
// { sessionId, tokens, contextWindow, threshold, cwd, ratio, at }
// 这里做:先等记忆归档完成,再重建映射 / 开新会话
})
ctx.on('context-rotate/rotated', (payload) => {
// 只在 action: archive 且归档成功时触发
// { ...上同, archived: true }
})
配合记忆插件
先让记忆落盘再换会话,推荐顺序:
- 你的记忆插件按上下文百分比自动压缩(如
dsh-rofm的triggerPercent); - 本插件收到
context-rotate/needed; - 驱动方等归档完成 → 停旧会话 → 开新会话。
和「按轮数/文件大小轮转」的区别
| 判据 | 优点 | 缺点 |
|---|---|---|
| 轮数 | 简单 | 每轮长短差异巨大,60 轮可能才 2 万也可能 20 万 |
| 文件大小 | 能防磁盘爆 | 压缩后的大小和上下文占用不成比例 |
| token 数(本插件) | 和真实开销 1:1 | 需要读得到占用数据 |
本插件取的是 DSH 会话缓存里 contextPressure.surfaceTokens —— 也就是当前这一轮真正要发给模型的上下文量,不是累计消耗。
已知限制
action: archive会把会话从列表里归档掉;GUI 会话别开这个选项,否则你正看着的对话会消失。- 只发信号、不自己开会话——新会话由驱动方建。
- 归档失败只打 warn,不重试(避免和驱动方的重试打架)。
License
MIT