dsh-context 是什么？一眼看懂 DeepSeek Harness 的上下文组成、演进与压缩剪枝

dsh-context 是 DeepSeek Harness（DSH）的上下文洞察与管理插件，为 Agent 上下文提供全生命周期管理：在会话里直接查看上下文统计、组成、趋势、事件、文件活动与 Agent 网络，无需手动分析日志。 本文介绍 dsh-context 是什么、核心功能、完整的安装更新卸载命令、典型用法与常见排错，帮你直观理解 Agent 的上下文是怎么组成、演进和压缩的。

dsh-context 是什么？

dsh-context 解决的是「看不懂 Agent 上下文」的问题：它把对话上下文的组成、演进、压缩与剪枝变成可视化的仪表盘与浏览器，让开发者不靠翻日志就能掌握上下文动态。 以下定位与事实均来自官方 README（来源）：

dsh-context（GitHub 仓库 bowenliang123/dsh-context）由 bowenliang123 维护，Apache-2.0 协议开源。它不修改 DeepSeek Harness 的核心行为，而是提供三块入口：每个会话的 Context 标签页、聊天中的 /context 命令，以及设置里的每用户默认偏好。面板上的占用率与组成使用与聊天编辑器上下文环相同的官方 token 计量投影，数字始终一致。它属于 DSH Plugin 生态里的上下文洞察类插件，界面支持中英文。

dsh-context 的核心功能有哪些？

核心能力围绕「组成、趋势、事件、文件活动、Agent 网络」五类视图展开：一张上下文仪表盘覆盖统计到明细，/context 命令把浏览器带进对话。 这些能力全部来自官方 README（来源）：

• Context 标签页：完整仪表盘，包含统计、组成、每请求趋势、事件、文件活动与 Agent 网络。
• /context 命令：在聊天中打开居中的模态框，展示相同的组成与上下文浏览器，无需离开对话。
• 上下文统计：轮次、步骤、实时工具调用与图片、上下文事件计数，以及基于列表价格的成本估算。
• 上下文趋势：每个模型请求一根堆叠条，支持步骤/轮次粒度、总量/增量模式，并用剪刀图标标记压缩与剪枝事件。
• 上下文浏览器：查看任意请求实际组装的内容，支持实时（下一次请求）或保留步骤，还能对比上一轮的增减。
• 文件活动与 Agent 网络：按文件展示读取、写入、搜索操作与行数增减；以节点图展示当前代理、父代理与全部子代理。

怎么安装与启用 dsh-context？

安装用一条官方 npm 命令，装完用 dsh web 启动 Web UI 即可，无需构建或重启。

1. 安装 dsh-context：推荐通过 npm 安装到 DeepSeek Harness Web profile：

dsh plugin --profile web add dsh-context

2. 审计源码时从 GitHub 安装：开发或审计场景可用仓库源安装：

dsh plugin --profile web add github:bowenliang123/dsh-context

Git 安装包会执行安装期代码，请只安装可信来源。

3. 校验并启动 Web UI：安装后校验组合配置，然后启动 Web UI：

dsh --profile web --dump-config

dsh web

4. 更新插件：README 提供的更新命令（@latest 跟随最新版本）：

dsh plugin --profile web update dsh-context@latest

5. 卸载插件：不再需要时用卸载命令移除：

dsh plugin --profile web remove dsh-context

以上命令形式与宿主文档一致，包名 dsh-context 取自 README 与插件目录（来源）。

dsh-context 典型用法

dsh-context 装完即用：打开任意会话点 Context 标签页看全貌，用 /context 命令在对话中深挖，按需在设置里调整默认偏好。

1. 打开上下文仪表盘：在任意会话中点击 Context / 上下文 标签页，即可看到统计、组成、趋势、事件、文件活动与 Agent 网络的完整仪表盘。

2. 用 /context 命令快速查看：在聊天中输入命令或从斜杠菜单选择，打开居中的上下文浏览器：

/context

命令会打开一个居中对话框，包含「当前组成」卡片与上下文浏览器，带与标签页相同的组成条、步骤选择器和对比上一轮增减的徽标。

3. 读懂趋势图与剪枝事件：每个模型请求一根堆叠条；用剪刀图标找到压缩和剪枝发生的位置，悬停查看即时提示，点击钉住完整明细（含提供商报告的实际值）。

4. 回到任意请求的组装现场：在上下文浏览器选择「实时（下一次请求）」或任意保留步骤，展开系统提示、工具模式、消息正文、推理与工具输出，逐条看成本。

5. 调整每用户默认偏好：在设置 → 插件配置的 Context 卡片中，设置趋势粒度（步骤/轮次）、趋势模式（总量/增量）与文件活动排序；图表内的切换只影响当前视图，不会覆盖已保存的偏好（来源）。

dsh-context 常见问题与排错

装好后遇到「数字对不上」「压缩后内容不全」「图片不渲染」等问题时，按下面的症状对号入座排查。 以下排错要点均来自官方 README（来源）：

1. 面板占用率与钉住明细数字不一致：症状是当前组成卡的占比和趋势图细节的 token 数对不上。原因是类别数字使用 dsh 内置的固定密度启发式估算，而钉住的明细与 Token/Timing 环显示提供商报告的实际值。解决：把悬停或点击的明细视为实际值，类别概览视为估算。

2. 压缩之前的步骤内容不完整：症状是上下文浏览器里较早步骤的组成显示为近似。原因是这些步骤是从移除消息归档重建的。解决：以卡片上的「近似」标注为准，明细可能不完全精确。

3. 图片载荷不渲染为卡片：症状是上下文浏览器中图片附件只显示为文本。原因是多模态渲染需要较新的 DSH 版本。解决：升级 DeepSeek Harness 后再打开浏览器，兼容版本见 README。

4. 会话里看不到 Context 标签页：症状是启用后标签页没有出现。原因是 Web UI 未启动或安装未生效。解决：确认安装命令执行成功，并用 dsh web 启动 Web UI，无需构建或重启。

适用场景与注意

dsh-context 适合所有想深入理解 Agent 上下文动态的 DSH 用户，尤其是排查上下文被谁吃掉的场景和长对话运营。

适用场景：想知道上下文窗口被哪部分占满、何时被压缩剪枝的开发者；需要回看任意请求实际组装内容的调试场景；以及要同时观察主代理与所有子代理关系的多代理会话用户。

注意事项：类别数字是估算，实际以钉住的明细为准；兼容 @deepseek-ai/dsh 0.1.0-rc7+、0.1.1-rc2+、0.1.2-alpha1+，多模态渲染需要 0.1.1+；界面支持英文与简体中文；悬停或点击趋势图会联动上下文浏览器（来源）。

项目链接

dsh-context 是 bowenliang123 维护的 Apache-2.0 开源项目。 插件详情页：dsh-context 插件详情。

本页是基于该插件官方 README 独立重写的导读——权威文档和最新变更请以源头为准：bowenliang123/dsh-context。插件是安装时就在你机器上运行的第三方代码；收录不代表背书——安装前请自行审阅源码。