在 DeepSeek Harness (DSH) 的开发流程中,模型上下文往往是一个黑盒:系统提示词、历史消息、工具结果以及运行时注入的内容混杂在一起,开发者很难单独查看或精准修改。dsh-ctm 插件将这段上下文转化为可视、可编辑且带有有效性评分的“一等对象”,解决了这一痛点。
这是什么¶
dsh-ctm(Context Transparency Manager)是由开发者 ac0033 维护的 DeepSeek Harness 插件。它基于纯 TypeScript 和 Zod 构建,通过零耦合的 HTTP 协议与 DSH 主进程通信,提供全量上下文可见性、MECE 令牌核算、实时编辑和有效性评分功能。
核心功能¶
-
全局可见与分段流视图
插件提供 Turn 到 Segment 的流程视图,内容按角色、令牌数、缓存状态和有效性评分着色,支持 Markdown 渲染和分页。你可以清晰地看到每一段内容在上下文流中的位置和状态。 -
MECE 令牌核算
KPI 条带使用 MECE(Mutually Exclusive, Collectively Exhaustive)分桶统计令牌,包括未缓存输入、缓存命中、输出。数据优先取自提供商测量的tokenUsage,当投影不可用时回退至全日志折叠。视图会显示缓存命中率,并在 Turn 和 Step 标题中展示累计或单步数据。 -
实时刷新
编辑器基于反应式订阅机制,新消息、工具结果和回合边界会触发即时更新,无需轮询。 -
可编辑性
支持对初始系统提示词进行替换、删除、回滚、快照恢复和撤销操作。同时也支持手动覆盖内容的有效性评分。需要说明的是,除了初始系统提示词外,系统注入内容、工具结果、CTM 占位符标记在 UI 中为只读。 -
有效性评分引擎
内置自动评分引擎,根据 2-gram 相似性(LRU 缓存,500 条目上限)判定内容为“有效”、“冗余”、“陈旧”或“注入”,并允许开发者手动覆盖裁决。 -
真实应用
当启用“真实应用”功能时,替换、删除或回滚操作不再仅仅是 UI 级的预览,而是通过agent/pre-step水流写入会话日志,实现拦截和修改上下文。工具调用与结果对不会拆分,删除操作会自动平衡工具调用的最小范围。
安装与启用¶
通过 DSH 生态目录或 GitHub 仓库获取。安装后,在 DSH 界面中注册即可使用。
典型用法¶
-
测试系统提示词变体
在 Context 标签页中,替换初始系统提示词,观察模型在不同指令或约束下的行为变化,无需重新启动会话。 -
拦截并修改上下文
启用“真实应用”开关,在日志记录前拦截上下文并进行修改,确保最终进入模型的上下文符合预期。 -
查看性能指标
在 Context 标签页中查看 KPI 条带,监控缓存命中率及 Token 使用情况,辅助优化上下文长度。
适用场景与注意¶
- 注意:分段级别的令牌计数为启发式估算,仅供参考。
- 注意:系统注入内容在 UI 中为只读。
- 注意:工具调用/结果对不会拆分。
- 注意:撤销功能仅对最近一次操作有效。
- 注意:插件以当前 DSH 进程权限运行,安装前请检查源码与许可证。
短结尾¶
dsh-ctm 提供了从“看”到“改”再到“评”的上下文管理闭环,适合需要精细调试上下文流或优化提示词效果的 DSH 用户。更多详情请参考插件目录或GitHub 仓库。