大数跨境

DeepSeek Harness 开源新插件dsh-context :Agent 上下文全生命周期可视化管理

DeepSeek Harness 开源新插件dsh-context :Agent 上下文全生命周期可视化管理 苏哲管理咨询
2026-10-01
6
导读:dsh-context 是 DeepSeek Harness 的开源插件,主打 Agent 上下文全生命周期可视化管理,支持中英双语,Apache2.0 协议,适配 dsh 0.1.5-rc.1 及以
编者摘要:dsh-context 是 DeepSeek Harness 的开源插件,主打 Agent 上下文全生命周期可视化管理,支持中英双语,Apache2.0 协议,适配 dsh 0.1.5-rc.1 及以上版本。提供四类使用入口:全局上下文仪表盘、会话内 Context 标签页、右侧上下文侧边面板、聊天/context快捷命令。仪表盘支持跨会话统计,展示 7 天 Token、费用、缓存命中率、活动热力图,一键跳转会话。会话分析模块可实时查看当前上下文窗口构成,按步骤绘制上下文增长趋势,标记压缩、裁剪事件;内置上下文浏览器,逐层拆解系统提示词、工具 Schema、消息、工具返回、图片载荷,支持轮次增量对比。配套上下文事件日志记录窗口变更原因,文件活动追踪 Agent 读写检索行为;智能体网络可视化多级父子子 Agent 调用谱系。支持网页向导或 dsh cli 两种安装方式,无需编译重启。数据采用内置 Token 估算,同时展示服务商真实计费值,帮助定位上下文膨胀、会话退化问题。

10 个关键问题 Q&A

  1. Q:dsh-context 是什么? A:DeepSeek Harness 开源插件,用于 Agent 上下文生命周期可视化、Token 消耗与会话行为分析。
  2. Q:支持哪些使用入口? A:全局仪表盘、会话上下文标签、右侧边面板、聊天框/context斜杠命令。
  3. Q:上下文仪表盘能做什么? A:跨会话汇总 Token、成本、缓存命中率;热力图统计使用时段,卡片快速跳转会话。
  4. Q:Current Context(当前上下文)视图作用? A:六色堆叠图展示上下文窗口各组分占用,快速定位导致对话质量下降的上下文模块。
  5. Q:上下文趋势 Delta 增量模式含义? A:展示单次请求上下文净增减;压缩 / 裁剪会显示 Token 回落,直观看到窗口瘦身事件。
  6. Q:上下文浏览器可以查看哪些内容? A:系统提示词、工具 Schema、用户 / 助手消息、工具返回、图片载荷、技能注入内容,支持前后轮对比。
  7. Q:智能体网络模块功能? A:可视化父 Agent、多级子 Agent 委托调用关系,点击节点直接进入对应会话上下文面板。
  8. Q:有哪两种安装方式? A:网页端插件向导一键安装;dsh CLI 命令安装更新,启动 web UI 无需编译重启。
  9. Q:Token 数值是估算还是真实值? A:默认是 dsh 内置 Token 估算;详情面板同时展示服务商上报的实际 prompt、输出与缓存计费数据。
  10. Q:最低兼容 dsh 哪个版本? A:最低要求 dsh 0.1.5-rc.1,支持 V3/V4 两代会话日志格式。
附录  dsh-context 是面向 DeepSeek Harness 的 Agent 上下文洞察与管理插件,提供完整的上下文生命周期管理能力。

链接

  • 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提供完整的上下文生命周期管理功能:

  1. 上下文仪表盘(Context Dashboard)
    侧边栏底部设置项上方,跨会话总览面板;包含 KPI 指标条、7 天 Token / 费用图表、活动热力图、总量构成环形图,以及可筛选会话卡片,点击直达任意会话。
  2. 上下文标签页(Context tab)
    UI 上下文仪表盘,用于查看 DeepSeek Harness 上下文统计、构成、趋势、事件与消息。
  3. 上下文侧边面板(Context panel)
    (dsh 0.1.5-rc.1 及以上版本):和上下文标签页功能一致,作为右侧边栏标签;在侧边栏引导页选中「Context」,面板会在聊天窗口旁打开。
  4. /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 命令
居中弹窗,同样支持查看上下文构成与上下文浏览器,无需离开聊天界面
偏好设置卡片
用户自定义默认配置:面板位置、趋势粒度与展示模式、文件活动排序等

🗂️ 上下文仪表盘(Context Dashboard)

侧边栏左下角、设置项上方,点击「Context Dashboard / 上下文仪表盘」打开。

板块
解答的问题
KPI 指标条
资源消耗总量:会话数、计费 Token、预估成本、所选时间范围(7 天 / 30 天 / 全部)内的缓存命中率
7 天用量图表
消耗发生时间:过去 7 天每日计费 Token 与预估费用的双柱状图;数据基于会话请求时间统计,而非会话最后活跃日期
活动热力图
你的实际工作时段:最近 8 周每日计费 Token 分布;点击日期可筛选当天活跃的会话
设置入口
热力图下方,快速跳转本插件偏好设置(与上下文标签页的插件信息卡片入口一致)
上下文构成
所选时段所有会话的上下文窗口占用汇总
会话卡片
每个会话概况:构成环形图、计费 Token、交互轮次、费用、工作空间 / 项目路径;支持按最近时间、Token 数量、上下文大小排序,可搜索、按工作空间分组,点击卡片打开对应会话

📊 上下文标签页(Context tab)

打开任意会话,点击「Context / 上下文」标签页。

卡片模块
解答的问题
上下文统计
交互轮次、执行步骤、人类输入、实时工具调用、会话缓存命中率;基于模型官方标价估算费用(鼠标悬浮?查看每百万 Token 单价,支持 DeepSeek 峰谷电价)
Token 统计
计费 Token 流向:与编辑器下方聊天统计数值保持一致,按类型拆分(系统提示词、工具定义、消息等),环形图展示服务商实际输出占比
耗时统计
模型调用、工具执行、额外开销之间的时间分配
当前上下文
此刻
上下文窗口内包含的全部内容
上下文趋势
每一次请求的上下文大小,以及变化过程
上下文浏览器
查看任意一次请求实际组装的完整上下文
上下文事件
上下文窗口变更的时间与原因
文件活动
Agent 对你的文件执行的全部操作
智能体网络
完整智能体调用谱系,实时展示

头部占用率与上下文构成数据,复用聊天编辑器上下文环形图完全相同的官方 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、PTC run_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

【声明】内容源于网络
0
0
苏哲管理咨询
为企业及组织提供AI+战略、数智化转型咨询及观点、建议等
内容 2260
粉丝 0
苏哲管理咨询 为企业及组织提供AI+战略、数智化转型咨询及观点、建议等
总阅读52.9k
粉丝0
内容2.3k