前言¶
在 DeepSeek Harness（DSH）里做长任务时，模型只能根据已读内容推断「上下文还剩多少」。DSH 默认不会在每轮对话里把窗口占用写进提示词，Agent 有时会误判空间紧张，从而缩短分析或提前收尾。界面上的占用环对人可见，对模型不可见。
dsh-context-window-reminder 是维护者 itstartstosnow 发布的工作流类 Host 插件（npm 包 @itstartstosnow/dsh-context-window-reminder，当前版本 0.1.0）。它只做一件事：在提示词尾部追加一行与界面同源的数字，不做阈值、建议和状态分级；怎么用由模型自己决定。下面介绍定位、行为、安装与配置。
这是什么¶
插件面向 Agent，不是账号或套餐用量提醒。注入示例：
Context window: 392k / 1M tokens used (39%)
不涉及账单、套餐或账号 usage。适用于 DSH >=0.2.1-rc.3（README 写明 0.2.1-rc.x），安装后对 profile 下所有会话生效。源码与 MIT 许可见 GitHub 仓库；社区目录页：skillhub.cn。DSH 生态以插件扩展能力，skillhub 为独立社区目录，与 DeepSeek / 幻方无官方从属关系。
核心功能¶
- 读取宿主计量：使用 DSH 现成的上下文占用（与界面占用环同源），不自行估算、不额外调用模型。
- 按步注入：每轮第一步注入一条；同一轮内每 20 步（第 1、21、41…步）再补一条最新数字；与上次完全相同时不重复。
- 插入方式：在历史尾部追加独立上下文消息，不修改用户消息、系统提示词或已有对话；不是用户发言，无需回复、不占工具位、不产生新轮次。界面上表现为可折叠的灰色「上下文注入」行。
- 静默跳过：拿不到占用数据（例如会话第一步尚无上次请求计量）时不注入、不报错、不留占位。
- 可选覆盖 subagent：默认向子代理会话同样注入，可通过配置关闭。
设计上刻意保持最小：每次只给一条数据，不判断、不建议、不改压缩策略、不打断任务。
性能与限制¶
- 每次注入约 13 token；80 步长回合大约 4 条，合计不到 60 token。只在尾部追加，系统提示与历史缓存前缀可复用。
- 非注入步骤仅多一次取模判断，无额外模型或网络请求。
- 数字为宿主估算，非 provider 账单级精确值；不含本轮尚未写入会话的最新用户消息，可能比最终请求略小。
- 只影响模型可见上下文，不改变界面仪表、压缩策略或工具行为。
安装与启用¶
插件以当前 DSH 进程权限运行，安装前建议浏览仓库源码与 LICENSE。
npm 安装（命令来自官方 README）：
dsh plugin --profile <profile 名> install @itstartstosnow/dsh-context-window-reminder
本地 link 开发：
- 桌面端在会话中：
plugin_manager install_bundle target: <本目录绝对路径> - CLI：
dsh plugin --profile <profile 名> install link:<本目录绝对路径>
安装通常热生效；修改本地代码后需重启 DSH 以重新加载模块。
配置与关闭¶
在 profile 的 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。
典型用法（用前 / 用后）¶
用前，模型看不到占用数据，只能猜测是否接近上限。
用后，用户消息之后多一条模型可见的占用行（可折叠，不是用户输入），模型可据此自行安排是否继续读文件、展开步骤或收敛输出。长回合中每 20 步会刷新数字，避免步骤很多时信息过时。
适用场景¶
适合在 DSH 里跑多文件阅读、长工具链、subagent 协作的开发者：需要 Agent 知道「还剩多少窗口」、又不想引入自动压缩或硬阈值策略时。若你只关心账单或 API quota，应使用其他用量工具，本插件不覆盖该场景。
结尾¶
dsh-context-window-reminder 用极低开销把上下文占用写成一行事实交给模型，弥补 DSH 默认不向 Agent 暴露窗口计量的缺口。安装与配置以 README 为准；详情与接入说明见仓库内 doc/technical.md。
- 目录页：https://www.skillhub.cn/plugins/itstartstosnow/dsh-context-window-reminder
- GitHub：https://github.com/itstartstosnow/dsh-context-window-reminder
