上下文抽屉 yue7ye/dsh-Context-Drawer

dsh-Context-Drawer

一个 DeepSeek Harness（DSH）插件，只做一件事：

会话上下文到达阈值（默认占模型窗口的 50%）时，把更早的消息移进跟这个会话关联的文件夹，再把最旧的已结束轮次从模型可见的上下文里释放出去。

没有界面，没有按钮，没有路由，没有记忆桥接，没有提示词注入。聊天记录和只追加的会话日志永远不改——释放的部分只是对模型不可见，磁盘上的存档始终留着它。

行为

- 每一轮的第一步，插件估算上下文占用（服务商给了真实用量就用真实用量，否则按字符估算）。
- 占用达到模型窗口的 thresholdRatio（默认 0.5）时：
1. 把比上次存档水位更新的消息追加到 {archiveDir}/{sessionShort}/{date}.md，先 fsync；
2. 文件安全落盘之后，才用 replace 事件把最旧的已结束轮次从模型可见上下文里移除。
最近的 keepRecentTurns（默认 6）轮永远不动，单次最多释放 releaseMaxTurns（默认 40）轮，接近 releaseTargetRatio（默认 0.45）就停。
- 会话日志和聊天记录保持完整；存档文件是纯 Markdown，随时可以打开。
- 状态存在 ~/.dsh/context-drawer/state/state.json（每个会话一个水位，防止重复）。

文件放在哪

默认：~/上下文存档/{sessionShort}/{YYYY-MM-DD}.md

sessionShort 是会话 id 去掉 session- 前缀后的前 8 个字符——一个会话一个子文件夹，随时能看出文件属于哪个会话。

配置（cordis.patch.yml）

- insert:
- id: context-drawer
name: dsh-context-drawer
config:
archiveDir: C:/deepseek/上下文存档 # optional; default ~/上下文存档 thresholdRatio: 0.5

其他可选字段：thresholdTokens（绝对 token 阈值）、modelWindow（默认 1048576）、 charsPerToken、baselineTokens、keepRecentTurns、releaseMaxTurns、releaseTargetRatio、 format（md | jsonl | txt）、includeRoles、minTextLength、maxEntryChars、 timeZone（默认 Asia/Shanghai）、stateDir。

安装

在 DSH 插件市场搜索 dsh-Context-Drawer 安装，或者：

dsh plugin --profile <profile> add dsh-context-drawer

测试

node test.mjs

离线模拟会话：10 个已结束轮次 → 触发阈值 → 20 条存档 + 8 个释放轮次 → 第二次触发只追加新消息 → 非第一步和低占用什么都不做。

中文说明

只做一件事：上下文占用到达阈值（默认 50%）时，把更早的对话追加进「跟这个会话关联的外部文件夹」，落盘之后再把最旧的已结束轮次从模型可见上下文里移走。没有界面、没有按钮、不写记忆、不碰聊天记录原文。

默认存档位置 ~/上下文存档/{会话短号}/{日期}.md，一个会话一个文件夹；状态在 ~/.dsh/context-drawer/state/state.json。最近 6 轮永远保留，单次最多释放 40 轮。

MIT License.