dsh-session-rotatev1.0.0

dsh-session-rotate

长会话越滚越贵。步数到上限时，本插件在这一轮答完之后（绝不中途打断）自动开一个新会话、把一份本地拼出来的交接摘要投过去、归档旧会话，然后把界面切到新会话。摘要不调用模型，是纯本地拼装，省下的是「手动总结 + 复制 + 新建会话 + 记住进度」这四步。

• 运行环境：DeepSeek Harness（DSH）桌面版 / Web GUI，作为 profile 插件挂载
• 不在 npm 上（dsh-session-rotate 这个包名已被另一位作者的同名插件占用，不是本项目）

功能

安装

1. profile 的 package.json：登记依赖和 bundle（已 clone 到本地可用 "link:<插件目录绝对路径>" 或 "file:<同上>" 代替 github:）

{
  "dependencies": { "dsh-session-rotate": "github:cry-flu/dsh-session-rotate" },
  "dsh": { "profile": { "bundles": ["...", "dsh-session-rotate"] } }
}

2. 让 node_modules 里有这个名字 —— 在 profile 目录跑包管理器 install；手工建链接也行：

cmd /c mklink /J "<profile>node_modulesdsh-session-rotate" "<插件目录绝对路径>"

3. profile 的 cordis.patch.yml 末尾挂载并配置

- insert:
    - id: dsh-session-rotate
      name: dsh-session-rotate
      config:
        defaultMaxSteps: 40
        workspaces:
          - name: my-workspace      # 与侧边栏显示名完全一致（空格、大小写都算）
            maxSteps: null          # null / 省略 / 0 / 空串 = 跟随 defaultMaxSteps

workspaces 默认为空数组 —— 空 = 所有工作区都不生效，用哪个工作区就显式加哪一行。

4. 整个 DSH 换进程重启一次。「重开窗口」不会重载插件；重启后 Web GUI 端口会变，看启动日志里的新地址。

配置

配置文件 ~/.dsh/session-rotate/config.json，设置页改的是同一份数据，保存即生效：

maxSteps 留空 = 跟随默认，之后改默认值它跟着变；填正整数就固定成那个数。工作区名必须与侧边栏显示名完全一致，对不上会静默跳过，实际匹配情况看 debug.log。

用试运行测（dryRun）

想确认「到点会不会触发」，用它，不要靠改上限去真测：

1. 在 workspaces 里加上要测的工作区，maxSteps 填你真实在用的值（例如 40）；
2. 打开 dryRun（设置页开关，保存即生效，无需重启）；
3. 正常干活，跨过那个步数；
4. 看 ~/.dsh/session-rotate/debug.log：命中会记一条 [dry-run] 只记日志不换（同一会话同一档步数只记一次，不会刷屏）。

不要把 maxSteps 调成 2、3 去真测：换新是真的换（新建会话、归档旧会话、界面跳走），一晚上能刷出一屏空会话。测完把 dryRun 关掉。

关闭与卸载

临时关闭：workspaces 改成 []（或删掉配置），保存即生效。

彻底卸载：删掉 cordis.patch.yml 里那段 - insert:；从 profile 的 package.json 的 dependencies 和 dsh.profile.bundles 各删一行；删掉 node_modules/dsh-session-rotate 链接；重启 DSH。

rm -rf ~/.dsh/session-rotate      # 可选：连日志、暂停状态、增量历史一起删

已知限制

• 热重载无效。 改插件代码（尤其 lib/client.js）后必须整个 DSH 换进程重启，「重开窗口」不算；重启后 Web GUI 端口会变。
• 上限是软上限。 判定只发生在轮与轮之间，不打断进行中的轮，真实换新点会在 maxSteps 附近浮动：开预判通常略低，关预判往往明显偏高（一轮能跑掉二十几步）。
• 换新后的第一轮是一次真实请求。 新会话把交接摘要作为第一条用户消息发出去，摘要本身零成本，但那一轮对话照常计费，会产生少量 token 费用。
• 只对顶层会话生效，子会话跳过；每个会话只触发一次；被暂停的工作区用 POST /dsh-session-rotate/config 带 {"clearPause": true} 恢复，或删 ~/.dsh/session-rotate/state.json 后重启插件。

测试情况

只在我本人环境跑过，没有跨平台、跨版本验证：DSH 桌面版 0.2.1-rc.3（Windows）+ Node v24.18.0，npm test → 23 pass / 0 fail（node --test）。CI（.github/workflows/test.yml）会在 ubuntu + windows × node 20/22/24 上跑单测，但那只覆盖单测，不覆盖宿主行为。

声明

大部分代码由 AI 辅助生成，经人工审查与本地测试，但不保证在所有环境下行为如预期。请先小范围试用、确认没有副作用，再拿它处理重要会话。

控制界面

截图占位：设置 → 会话换新（默认上限、保护闸、试运行开关、工作区名单）。图待补。

License

MIT