/context快捷命令。仪表盘支持跨会话统计,展示 7 天 Token、费用、缓存命中率、活动热力图,一键跳转会话。会话分析模块可实时查看当前上下文窗口构成,按步骤绘制上下文增长趋势,标记压缩、裁剪事件;内置上下文浏览器,逐层拆解系统提示词、工具 Schema、消息、工具返回、图片载荷,支持轮次增量对比。配套上下文事件日志记录窗口变更原因,文件活动追踪 Agent 读写检索行为;智能体网络可视化多级父子子 Agent 调用谱系。支持网页向导或 dsh cli 两种安装方式,无需编译重启。数据采用内置 Token 估算,同时展示服务商真实计费值,帮助定位上下文膨胀、会话退化问题。
10 个关键问题 Q&A
-
Q:dsh-context 是什么? A:DeepSeek Harness 开源插件,用于 Agent 上下文生命周期可视化、Token 消耗与会话行为分析。 -
Q:支持哪些使用入口? A:全局仪表盘、会话上下文标签、右侧边面板、聊天框 /context斜杠命令。 -
Q:上下文仪表盘能做什么? A:跨会话汇总 Token、成本、缓存命中率;热力图统计使用时段,卡片快速跳转会话。 -
Q:Current Context(当前上下文)视图作用? A:六色堆叠图展示上下文窗口各组分占用,快速定位导致对话质量下降的上下文模块。 -
Q:上下文趋势 Delta 增量模式含义? A:展示单次请求上下文净增减;压缩 / 裁剪会显示 Token 回落,直观看到窗口瘦身事件。 -
Q:上下文浏览器可以查看哪些内容? A:系统提示词、工具 Schema、用户 / 助手消息、工具返回、图片载荷、技能注入内容,支持前后轮对比。 -
Q:智能体网络模块功能? A:可视化父 Agent、多级子 Agent 委托调用关系,点击节点直接进入对应会话上下文面板。 -
Q:有哪两种安装方式? A:网页端插件向导一键安装;dsh CLI 命令安装更新,启动 web UI 无需编译重启。 -
Q:Token 数值是估算还是真实值? A:默认是 dsh 内置 Token 估算;详情面板同时展示服务商上报的实际 prompt、输出与缓存计费数据。 -
Q:最低兼容 dsh 哪个版本? A:最低要求 dsh 0.1.5-rc.1,支持 V3/V4 两代会话日志格式。
链接
-
NPM:https://www.npmjs.com/package/dsh-context -
GitHub:https://github.com/bowenliang123/dsh-context -
DshFind:https://dshfind.com/en/plugins/bowenliang123/dsh-context?ref=badge
概览
DeepSeek Harness 最佳 Agent 上下文洞察与管理工具dsh-context提供完整的上下文生命周期管理功能:
- 上下文仪表盘(Context Dashboard)
侧边栏底部设置项上方,跨会话总览面板;包含 KPI 指标条、7 天 Token / 费用图表、活动热力图、总量构成环形图,以及可筛选会话卡片,点击直达任意会话。 - 上下文标签页(Context tab)
UI 上下文仪表盘,用于查看 DeepSeek Harness 上下文统计、构成、趋势、事件与消息。 - 上下文侧边面板(Context panel)
(dsh 0.1.5-rc.1 及以上版本):和上下文标签页功能一致,作为右侧边栏标签;在侧边栏引导页选中「Context」,面板会在聊天窗口旁打开。 - /context 斜杠命令
:唤起弹窗,展示当前上下文结构与近期上下文演变情况。
安装 / 更新
https://github.com/bowenliang123/dsh-context#install--update
在 DeepSeek Harness 网页端或桌面端安装
https://github.com/bowenliang123/dsh-context#install-on-deekseek-harness-web-or-desktop 在「添加插件」向导搜索框填入 dsh-context,点击安装。
通过 dsh 命令行安装
从 @deepseek-ai/dsh安装 dsh-context插件:
dsh plugin --profile web add dsh-context
更新插件:
dsh plugin --profile web update dsh-context@latest
之后执行 dsh web启动网页 UI,无需编译,无需重启。
使用方法
一处底层逻辑,四种入口视图:查看 Agent 加载了哪些上下文、上下文如何形成、Agent 利用上下文完成了哪些工作。
|
|
|
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
🗂️ 上下文仪表盘(Context Dashboard)
侧边栏左下角、设置项上方,点击「Context Dashboard / 上下文仪表盘」打开。
|
|
|
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
📊 上下文标签页(Context tab)
打开任意会话,点击「Context / 上下文」标签页。
|
|
|
|---|---|
|
|
?查看每百万 Token 单价,支持 DeepSeek 峰谷电价)
|
|
|
|
|
|
|
|
|
此刻
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
头部占用率与上下文构成数据,复用聊天编辑器上下文环形图完全相同的官方 Token 计量算法(contextPressure /contextBreakdown),数据和环形图保持一致。
当前上下文 — 上下文窗口内实时内容
使用六色堆叠柱状图展示模型完整上下文窗口(阴影区域 = 剩余可用空间): 系统提示词、工具 Schema、用户消息、注入上下文、助手回复、工具返回结果;每项附带预估 Token 数量与占比。当对话效果变差时,可以在这里定位是哪一部分上下文导致问题。
上下文趋势 — 上下文随轮次 / 步骤的增长演变
每条模型请求对应一根堆叠柱,粒度细于单条消息,逐轮观察上下文窗口变化:
-
✨ 步骤简述:图表下方三行简明文本, User唤起本轮对话的用户消息;In列出新增内容(通常是上一轮工具返回结果);Response展示助手回复 / 调用的工具。点击条目,可在上下文浏览器打开对应消息。 -
✂ 事件标记:压缩、裁剪操作会标记在对应柱状图上,上下文大小下降的原因一目了然。 -
自定义视图:支持 Step(步骤)/Turn(交互轮次)粒度切换;Total(总量,累计构成)或Delta(增量,单次请求变化)模式;横向滚动查看完整会话。增量模式下,新增内容在基线之上,压缩操作则向下回落。 -
悬浮 & 固定:鼠标悬浮查看悬浮提示;点击固定完整明细,同时展示服务商返回的实际提示词 / 输出 / 缓存数值与估算值。 -
实时联动:鼠标悬浮柱状图,在图表旁的上下文浏览器预览该步骤组装的上下文;移开图表恢复原有选中内容。
🧭 上下文浏览器 — 拆解任意一次请求的上下文
选择「Live(下一次请求)」或任意历史步骤,查看该请求的完整组装内容: 分为 7 个可折叠分类,每条元素展示 Token 消耗与费用;元素可继续展开查看原始内容:系统提示词、各工具 JSON Schema、消息文本、推理内容、工具参数、工具输出。 技能内容(可用技能目录、/skill调用、技能工具加载)独立放在「技能注入」分类,避免隐藏在注入上下文与工具结果中。
-
工具来源标记:每条工具 Schema 附带来源标签: tool-*官方包、dsh-*能力包、mcp:<server>代理,或是通过tools.register()注册的实时监听插件。支持按大小 / 名称排序,每个分类自带独立搜索筛选。 -
助手回复类型筛选:助手分类搜索框内置 Thinking / Tools / Answer标签,附带该步骤消息计数;点击筛选,再次点击清除。 -
工具结果查看:展开完整调用记录,包含工具名称、参数、成功 / 错误状态,结果正文附带行数,支持「原始文本 / Markdown」切换。 -
图片载荷卡片:缩略图展示名称、尺寸、存储大小,使用 DeepSeek 官方图片 Token 估算(dsh 多模态管线,如 read_image返回内容、图片附件)。 -
和上一轮对比:每个分类附带增量标识(+N 条目、±N 千 Token),一眼看到本轮新增 / 释放的上下文。压缩之前的历史步骤由已删除消息归档重建,近似数据会标注说明。
⚡ 上下文事件 — 窗口变更的时间与原因
记录所有注入、压缩、裁剪、模型切换、计划模式切换事件;标注触发来源(指令文件、插件 ID、技能名称)、Token 净变化量(压缩会显示回收 Token 数量)、轮次 / 步骤、时间。 可通过Inject / Compact / Prune / Switch / Mode标签筛选日志,标签上显示全会话事件总数。
📁 文件活动 — Agent 对你文件的操作记录
每一条被操作文件单独一行(读取、写入、检索),数据会聚合到你在趋势图表选中的步骤:
-
用途统计标签(可点击筛选):读取 / 写入 / 检索 / 图片,附带路径搜索框。 -
行数变化:每一次编辑 / 写入,统计预估新增 / 删除代码行数,单文件汇总 + 全局汇总。 -
全模式统计:原生工具、Minimal 预设 str_replace_editor、PTCrun_code程序内嵌套调用,全部归入对应工具行。 -
文件检索:检索命中的文件生成独立操作行,附带命中次数。 -
点击条目:展开完整操作日志,点击对应操作直接跳转至上下文浏览器内的工具结果。 -
点击文件名:在右侧边栏预览文件(dsh 0.1.5-rc.1+),和内置文件侧边栏使用相同查看器、一文件一标签;无右侧栏的版本,则在本地系统打开文件。
🕸 智能体网络 — 智能体谱系图
当前智能体、父级智能体、所有子智能体;一个节点代表一个智能体,带颜色连线代表调用谱系,多级委托关系在一张图呈现。 每个环形大小代表该会话上下文窗口占用比例;鼠标悬浮查看 Token、请求量、计费、运行时长;点击节点直接跳转该会话的上下文标签页。正在运行的智能体带有绿色脉冲动画。
⌨️ /context 命令
输入 /context(或在斜杠菜单选择)回车唤起弹窗。 弹窗内包含「当前上下文构成卡片」+「上下文浏览器」,和标签页功能一致:同样的构成柱状图、步骤选择器、与上一轮对比增量标识。
⚙️ 设置
上下文偏好卡片存放插件用户配置:默认面板位置、趋势粒度(步骤 / 轮次)、趋势模式(总量 / 增量)、工具和文件活动排序、侧边栏洞察入口。 存放位置取决于 dsh 版本:
-
dsh 0.1.7+:侧边栏「Plugins」→ dsh-context 插件页面 → Configuration 配置区(卡片由配置表单实时渲染) -
旧版本:设置 → 插件 → 插件配置 → Context 卡片
图表与卡片内临时切换项仅作用于当前视图,不会覆盖持久保存的偏好设置。
补充说明
估算值与实际值
分类数值采用 dsh 内置固定密度估算算法(与内置 Token 计量器相同);趋势面板固定详情中会并列展示服务商返回的真实数值,Token 卡片同时展示估算构成占比和服务商计费总 Token。
兼容性
支持 @deepseek-ai/dsh 0.1.5-rc.1及更高版本: 0.1.5 系列(rc.1 起)、0.1.7 系列(rc.2 起)、0.2.0 系列(rc.2 起); 兼容 V3(0.1.5-alpha.x+)、V4(0.1.6/0.1.7/0.2.0+)会话日志,由同一套驱动代码实现。 版本兼容矩阵与验证方案:https://github.com/bowenliang123/dsh-context/blob/main/docs/compatibility.md
国际化
UI 支持英文与简体中文。
喜欢这个插件?
如果 dsh-context 帮你更好理解 Agent 的上下文负载,欢迎在 GitHub 给项目点⭐;欢迎提交 Issue 与 PR。
许可证
Apache License 2.0 https://www.apache.org/licenses/LICENSE-2.0

