上下文用量提醒 itstartstosnow/dsh-context-window-reminder

dsh-context-window-reminder

给智能体的轻量上下文窗口提醒，不是账号/套餐用量提醒。

DSH 不会在每轮对话里主动把模型上下文窗口用量注入给模型。模型有时会猜测剩余空间，e.g.，误以为上下文快满了所以偷工减料。本插件会在提示词中增加轻量提醒，告诉智能体自己用了多少上下文：

Context window: 392k / 1M tokens used (39%)

❌ 仅关注上下文窗口，不涉及账单、套餐、账号用量等 usage 数据。

设计上刻意保持最小：每次只给一条数据，不做任何判断、建议、阈值或状态分级；这条数据怎么用、要不要收敛、要不要继续，由模型自行决定。

适用于 DeepSeek Harness（dsh）0.2.1-rc.x，Host 插件，安装后对所有会话生效。

用前 / 用后

用前，模型看不到任何占用数据：

你：帮我重构这个模块模型：（只能靠猜……"我读了不少文件，可能快满了"）

用后，你的消息后面多一条可折叠的上下文提示（模型可见，界面上是灰色的"上下文注入"行）：

你：帮我重构这个模块 Context window: 392k / 1M tokens used (39%) ← 新增，可折叠，不是你说的话模型：……（知道还有约 60% 空间，自行判断怎么安排）

- 这条提示不是用户消息：不用回复、不占工具位、不产生新的对话轮次，只是让模型多知道一个事实。
- 插入位置在历史尾部：你的消息、之前的所有对话、系统提示词都不动。
- 同一轮里如果步骤很长，每 20 步会再补一条最新数字（第 1、21、41…步）；数字与上次完全相同时不重复。
- 拿不到占用数据时（比如会话第一步还没有上次请求的计量）就什么都不做，不会报错或留占位。

实现方案（简要）

1. 读取宿主现成的上下文占用（与界面占用环同源），不自己估算、不调模型。
2. 在每轮第一步、以及每 20 步，把「已用 / 上限 / 百分比」追加成一条独立的上下文消息。
3. 不判断、不建议、不改系统提示词、不改压缩策略、不打断任务。
4. 取不到数字就静默跳过。

更细的接入点、数据字段、去重投影和验证记录见 doc/technical.md（中文）。

性能影响

- 每次注入约 13 token；每 20 步才一条。一个 80 步的长回合大约 4 条，总计不到 60 token。
- 只在对话尾部追加，系统提示词和已有历史的缓存前缀完全复用，不会让整段 prompt 重新计费/重算。
- 非注入步骤只多一次取模判断；没有额外模型请求、没有网络请求、没有可感知延迟。
- 不改变模型行为之外的任何东西：不触发回复、不新增轮次、不占工具。

安装

npm：

dsh plugin --profile <profile 名> install @itstartstosnow/dsh-context-window-reminder

本地开发（link 本目录）：

- 桌面端在会话里让智能体执行：plugin_manager install_bundle target: <本目录绝对路径>
- 命令行：dsh plugin --profile <profile 名> install link:<本目录绝对路径>

安装通常热生效；如果之后修改了本地代码，需要重启一次 DSH 让模块重新加载。

配置与关闭

默认每 20 步、也覆盖子代理会话。要调整就在配置档的 cordis.patch.yml 里按行 id 覆盖：

- id: context-window-reminder
name: '@itstartstosnow/dsh-context-window-reminder'
config:
everySteps: 20
includeSubagents: true

| 字段 | 默认 | 含义 |
| everySteps | 20 | 同一轮内再次注入的步数间隔 |
| includeSubagents | true | 是否也向子代理会话注入 |

关闭：plugin_manager set_plugin entryId: include:context-window-reminder enabled: false；彻底移除：plugin_manager remove_bundle target: @itstartstosnow/dsh-context-window-reminder。

已知限制

- 数字是宿主估算（与界面占用环同源），不是服务商账单级精确值，判断"还剩多少"足够。
- 不含本轮刚发出、尚未写入会话的那条消息本身，所以可能比最终请求略小一点。
- 只影响模型可见的上下文，不改变界面仪表、压缩策略或任何工具行为。

许可

MIT，见 LICENSE。