dsh-context 详解：看清 DeepSeek Harness 的上下文、工具与 Agent 协作
用途、核心机制、上手路径与使用边界
来源：bowenliang123/dsh-context · bowenliang123
用户问题
定位与适用任务长会话变慢、成本升高或回答偏离任务时，仅看一个上下文占用百分比很难定位原因。dsh-context 是 DeepSeek Harness 的观测插件，把当前窗口、历史请求、工具执行和父子 Agent 放在可关联的界面里。它的主要价值是提供排查依据：先知道内容从哪里进入、何时被压缩，再判断应该调整任务拆分、工具输出还是 Skill 配置。
- 排查长会话中突然增长的工具结果
- 比较不同会话的使用量与上下文组成
- 观察主 Agent 与子 Agent 的任务和通信
产品机制
能力与工作方式- 从全局进入单次请求Context Insights 提供跨会话概览，Context tab 展示会话内部细节。先筛出异常会话，再看请求趋势，可以把“最近感觉更贵”转换为某一轮实际发生了什么的具体问题。 原文
- 拆开模型实际携带的内容Context Browser 展开提示、工具 schema、用户输入、推理和工具结果，并把 Skill 注入单独列出。它有助于区分工具定义太长与工具返回太长，这两种问题需要不同的处理方法。 原文
- 把变化与事件对齐趋势图按请求观察窗口增长，压缩和裁剪事件落在对应位置。文件活动与命令执行记录可以继续追到工具结果，形成从占用变化到具体操作的检查路径。 原文
- 观察整个 Agent 家族Fleet 页把关系图、成员、任务与通信连接起来。多人协作式任务中，某个成员一直运行、某项任务被依赖阻塞或消息没有被处理，可以沿这套视图进一步检查。 原文
使用流程
从最小任务开始- 安装到实际使用的配置在 Harness 的插件界面搜索 dsh-context，或使用下方官方 CLI 命令。确认安装的是运行 Web 界面的 profile，随后打开一个真实会话。
- 先记录基线用一个小任务观察 Current Context 与请求趋势，记录尚未读取大文件前的组成。不要直接把累计计费 token 与当前窗口 token 相减，它们描述不同对象。
- 定位增量完成一次文件读取或工具调用后，查看新增内容、工具结果和压缩事件。必要时展开原始文本，判断增长是否来自重复载入或过长输出。
- 修改后再比较缩小读取范围或减少无关工具后，用相近任务重复观察。比较请求结构与最终结果，同时保留模型和任务差异，避免把相关性误写成插件带来的性能提升。
以下试用顺序与检查方法是编辑建议；命令入口依据官方文档，本文未运行项目。 原文
官方入口示例
dsh plugin --profile web add dsh-context
dsh web请先完成上文前置配置；示例不包含真实凭据。
边界与限制
约束与选用判断| 边界 | 具体含义 | 使用建议 |
|---|---|---|
| 计费与估算 | 成本来自价格映射估算；上下文组成也可能包含近似值。 原文 | 查阅价格映射说明，把供应商账单作为实际结算依据。 |
| 历史重建 | 压缩之前的步骤可能依据归档重建，不能当成原始请求的完全副本。 原文 | 阅读近似提示，关键排查保留原始执行记录。 |
左右滑动查看完整表格
适合已经使用 DeepSeek Harness、希望理解上下文成本的人。若当前问题是任务目标不清或模型能力不足，增加仪表盘只能帮助识别问题，不能代替重新定义任务。
怎样判断是否值得采用
试用场景与验收一个适合的练习是让 Agent 先读目录，再读取一份较长文件，最后总结。分别观察工具 schema、文件返回和助手回答的占比，并在 Context Browser 中找到对应内容。如果第二次读取重复占据窗口，优先修改读取策略；如果多个子 Agent 重复做同一研究，则检查 Fleet 中的任务分工。这个练习验证的是可观测性，不是自动压缩效果。
安装完成的判断标准是插件入口可见、所选会话有数据、来源内容能展开。空图表先检查会话与 profile 是否匹配，再查插件与 Harness 的兼容说明。
资料依据：固定版本 README · 补充官方文档 · 当前仓库。
资料获取时间（UTC）：2026-11-02T07:26:37.778Z；仓库快照提交：6d5682870e36。来源日期表示该仓库快照提交时间，并非项目首次发布日期。