Skip to content

dsh-context-rotate

Verified

dsh-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

npm version license

给 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 }
})

配合记忆插件

先让记忆落盘再换会话,推荐顺序:

  1. 你的记忆插件按上下文百分比自动压缩(如 dsh-rofm 的 triggerPercent);
  2. 本插件收到 context-rotate/needed;
  3. 驱动方等归档完成 → 停旧会话 → 开新会话。

和「按轮数/文件大小轮转」的区别

判据 优点 缺点
轮数 简单 每轮长短差异巨大,60 轮可能才 2 万也可能 20 万
文件大小 能防磁盘爆 压缩后的大小和上下文占用不成比例
token 数(本插件) 和真实开销 1:1 需要读得到占用数据

本插件取的是 DSH 会话缓存里 contextPressure.surfaceTokens —— 也就是当前这一轮真正要发给模型的上下文量,不是累计消耗。

已知限制

  • action: archive 会把会话从列表里归档掉;GUI 会话别开这个选项,否则你正看着的对话会消失。
  • 只发信号、不自己开会话——新会话由驱动方建。
  • 归档失败只打 warn,不重试(避免和驱动方的重试打架)。

License

MIT