DeepSeek Harness (DSH) 生态允许通过插件扩展功能。上下文窗口管理是智能体开发中的常见痛点，特别是当压缩策略导致重复操作和额外的 token 消耗时。dsh-toolong-warning 插件旨在解决这一问题，它不主动打扰，只在对话变得不经济时发出提示。
插件简介¶
这是一个由 Hjdd14 维护的 DSH 客户端插件。它统计每个会话中被压缩的次数，并在界面上实时显示计数。只有当压缩发生得较为频繁，且在此后消耗了大量额外 token 时，插件才会发出警告。
插件使用手写 JavaScript，无构建步骤。它提供可拖动的浮动窗口，支持中英文双语切换，且默认倾向于保持静默，避免“狼来了”效应。
核心功能¶
- 压缩计数展示：在浮动窗口中持久显示每个对话的压缩次数。
- 智能触发机制：仅在满足特定条件时发出警告。只有当压缩次数达到阈值、且在最后一次压缩后消耗了额外大量 token 时，才会触发警告。
- 界面交互：支持中/英双语切换，点击“Got it”仅隐藏当前提醒卡片，计数器继续更新。
- 浮动窗口：窗口可拖动，不会与其他插件争夺屏幕空间。
安装与启用¶
先决条件：
* dsh 版本 >= 0.1.7-rc.1
* Node.js 版本 >= 22.19
* 需要一个支持浏览器客户端的配置文件（web 或 desktop）
安装步骤：
- 在终端中执行以下命令安装插件：
dsh plugin --profile web add @hjdd14/dsh-toolong-warning
- 插件安装后，配置值会写入配置文件的 cordis 补丁中，并在加载后立即生效。
典型用法¶
- 语言切换：在 DSH 的设置页面找到该插件对应的区域，切换界面语言（中文/英文）。
- 阈值调整：在插件设置中，可以调整
compactCountMin（最小压缩次数）、occupancyPercentMin（最小上下文占用率）和tokensSinceCompactionMin（最小额外 token 消耗）等参数。 - 查看提醒：当对话出现重复压缩且消耗了高额额外 token 时，顶部会弹出警告卡片，显示当前的上下文占用率和自上次压缩以来的 token 消耗量。
适用场景与注意¶
- 适用场景：适合需要精细管理上下文窗口、频繁进行压缩操作的开发者。它可以帮助开发者识别哪些对话正在变得不经济。
- 静默机制：如果缺少使用数据，或者路由未声明上下文窗口，插件将保持静默。如果从未压缩过、压缩次数不足或额外 token 消耗未达阈值，插件也不会发出警告。
- 禁用状态：当插件被禁用或未打开任何对话时，不会显示任何内容。
- 安全建议：安装前建议检查源码与许可证（MIT）。
总结¶
dsh-toolong-warning 提供了一种非侵入式的监控方式，帮助开发者平衡上下文管理与成本。它通过计数和阈值判断，在对话变得不值得继续时给予提示，否则保持安静。
