前言¶
在 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
