上下文透视面板bowenliang123/dsh-context

社交预览图

dsh-context

npm 版本
GitHub 星标
dshfind

用于 Agent 上下文洞察与管理的最佳 DeepSeek Harness 插件。

dsh-context 提供完整的上下文生命周期管理功能。
- 上下文仪表盘 — 位于侧边栏底部 Settings 上方的跨会话概览：KPI 带、活动热力图、聚合构成环形图，以及可筛选的会话卡片，可一键跳转到任意会话。
- Context 标签页 — 用于展示 DeepSeek Harness 上下文统计、构成、趋势、事件和消息的 UI 上下文仪表盘。
- 上下文面板 — 作为右侧边栏标签页的同一仪表盘（dsh 0.1.5-rc.1+）：在侧边栏的引导页选择 Context，面板会在聊天窗口旁打开。
- /context 命令 — 该斜杠命令展示当前上下文构成与近期上下文演变的上下文模型。

安装 / 更新

从 DeepSeek Harness 安装 dsh-context 插件：

dsh plugin --profile web add dsh-context

或更新 dsh-context 插件：

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

然后用 dsh web 启动 Web UI。无需构建步骤，无需重启。

使用方式

四个界面，一个故事 —— 你的 agent 承载了什么、它是如何变成这样的，以及它用这些做了什么：

| 位置 | 你能获得什么 |
| --- | --- |
| 上下文仪表盘 | 一览所有会话：用量、成本、缓存命中、每日活动，以及每个会话的上下文概况 —— 可按范围、日期、分组或搜索进行筛选，一键跳转。 |
| Context 标签页 | 完整仪表盘：统计、构成、每请求趋势、事件、文件活动，以及 agent 网络 —— 在每个会话中均可查看。 |
| /context 命令 | 一个居中的模态框，包含相同的构成与上下文浏览器，无需离开聊天。 |
| Settings → Plugin configuration | 每用户默认值：趋势粒度与模式、File Activity 排序。 |

🗂️ 上下文仪表盘

点击侧边栏左下角、Settings 正上方的 Context Dashboard / 上下文仪表盘：

上下文仪表盘

| 区块 | 它回答的问题 |
| --- | --- |
| KPI 带 | 我用了多少 —— 在所选范围（7d / 30d / all）内的会话数、计费 token、预估成本和缓存命中率。 |
| 活动热力图 | 我实际何时在工作——过去 8 周每日计费 token；点击某一天可筛选当天活跃的会话。 |
| 上下文构成 | 上下文窗口的去向，按所选范围内的会话汇总。 |
| 会话卡片 | 每个会话的概况：构成环、计费 token、轮次、成本，以及其工作区分组 / 项目面包屑——可按最近使用、token 或上下文大小排序，可搜索，按工作区分组。点击卡片可打开该会话。 |

📊 上下文标签页

打开任意会话，点击 Context / 上下文 标签页：

上下文面板概览

| 卡片 | 它回答的问题 |
| --- | --- |
| 上下文统计 | 轮次、步骤、人工输入、实时工具调用、会话的缓存命中率——以及根据 models.dev 标价估算的成本（悬停 ? 查看每百万 token 费率；感知 DeepSeek 高峰/低谷时段）。 |
| Token 统计 | 计费 token 的去向——与输入框下方聊天统计行中的总量相同，按构成拆分（系统、工具、消息……），并以提供商精确的输出量闭合该环。 |
| 耗时统计 | 活跃时间如何在模型调用、工具运行和开销之间分配。 |
| 当前上下文 | 窗口此刻包含什么。 |
| 上下文趋势 | 每个请求的大小——以及它的来龙去脉。 |
| 上下文浏览器 | 任意请求实际由什么组装而成。 |
| 上下文事件 | 窗口何时以及为何发生变化。 |
| 文件活动 | 智能体对你的文件做了什么。 |
| 智能体网络 | 整个智能体家族，实时呈现。 |

标题中的占用率和构成读取的是与聊天输入框上下文环相同的官方 token 计量投影（contextPressure / contextBreakdown），因此这些数字始终与环所显示的一致。

上下文统计

Token 统计与耗时统计
Token_Stats_and_Timing_Stats

上下文统计
Context_Stats

🧱 当前上下文——上下文窗口现在包含什么

当前上下文卡片

一条六色堆叠条，对照模型的完整窗口（斜线 = 空闲余量）：系统提示词、工具 schema、用户消息、注入上下文、助手回复、工具结果——每项都带有其约计 token 数和占比。当对话开始退化时，你就能在这里看到哪一部分是罪魁祸首。

📈 上下文趋势——上下文如何按轮次或步骤增长和演变

带步骤摘要的上下文趋势

每个模型请求一条堆叠条——比按消息更精细——因此你可以逐轮观察窗口的增长：
- ✨ 步骤摘要 — 图表下方有三行通俗易懂的信息：User 回顾开启该轮次的消息，In 列出新进入的内容（通常是之前的工具结果），Response 显示回复和/或调用的工具。点击某一行即可在上下文浏览器中打开那条确切的消息。
- ✂ 标记事件 — 压缩和裁剪被固定在其发生的那根柱子上，因此这些下降本身就能说明原因。
- 按你的方式阅读 — Step / Turn 粒度，Total（累计构成）或 Delta（每次请求的带符号变化），并可横向滚动浏览整个会话。在 Delta 模式下，增长在基线之上不断累积，而一次压缩则会骤降到基线之下：

Delta 模式下的上下文趋势

- 悬停与固定 — 拖动即可查看即时工具提示；点击可固定完整明细，其中在估算值旁边显示提供商报告的 Actual Prompt / Output / Cache。
- 实时联动 — 悬停在某根柱子上时，会在图表旁的上下文浏览器中预览该步骤组装后的上下文；离开图表则返回你自己选择的内容。

🧭 上下文浏览器 — 打开任意请求的盒子

选择 Live (next request) 或任意保留的步骤，浏览该请求是由什么组装而成的：七个可折叠类别会展开为每个元素一行，并显示其 token 成本，而每个元素又会进一步展开为其实际内容 — 系统提示词、每个工具的 JSON schema、消息文本、推理、工具参数和工具输出。技能内容（可用技能目录、/skill 调用以及 skill 工具加载）有自己的 Skill Injections 类别，因此隐蔽技能的上下文占用无法藏在注入上下文和工具结果这两个桶里。

- 每个工具由谁提供 — 每个工具 schema 行都带有一个尽力而为的来源标签：tool- 一方包、dsh- 能力包、mcp: 代理，或从 tools.register() 实时监视到的确切插件。可按大小 / 名称排序，并按每个类别各自的可搜索字段进行筛选：

带来源标签、筛选和排序的工具 schema

- 工具结果可展开为完整调用 — 工具名称和参数及其 OK/error 状态，结果正文带行数以及 Raw / Markdown 切换：

展开的工具结果，带 Raw/Markdown 切换

- 图像载荷渲染为卡片 — 缩略图带名称、尺寸、存储大小，以及官方 DeepSeek 图像 token 估算（dsh 多模态流水线，例如 read_image 结果和图像附件）：

渲染为缩略图卡片的图像载荷
- 与上一轮次的差异对比 — 每个类别的带符号增量徽章（+N 项、±Nk token）让你一眼看出某一轮次新增或回收了什么。早于压缩的步骤会从已移除消息归档中重建——当某一步的构成只能近似还原时，卡片会明确说明。

⚡ 上下文事件 — 窗口何时以及为何发生变化

带压缩的上下文事件

每一次注入、压缩、修剪、模型切换和计划模式切换——都标注了其生产者（指令文件、插件 id、技能名称）、净 token 增量（压缩会显示回收了多少）、轮次/步骤以及时间。Inject / Compact / Prune / Switch / Mode 筛选标签按类型过滤日志，每个标签都带有其整个会话的事件计数。

📁 文件活动 — agent 对你的文件做了什么

文件活动

每个被触及的文件一行——读取、写入或搜索——并按你在趋势图上选择的步骤进行聚合：

- 按用途计数，表头标签同时充当筛选器（Read / Written / Searched / Images），并配有路径搜索框。
- 行数增量 — 每次 edit/write 都会贡献其估算的 +added / −removed 足迹，按文件统计并汇总。
- 所有模式都计入 — 原生工具、Minimal 预设的 str_replace_editor，以及 PTC run_code 程序中的嵌套调用，都会归入按工具划分的行中。
- 搜索会落到真实文件上 — 匹配到的文件会拥有自己的操作行，并带有命中次数。
- 点击某一行可展开其完整操作日志——每个操作都会直接跳转到 Context 浏览器中对应的工具结果。
- 点击文件名可在右侧边栏中打开其预览（dsh 0.1.5-rc.1+），与内置 Files 边栏的行为完全一致——相同的查看器、相同的每文件一个标签页行为。在没有该列的 harness 上，文件名会像以前一样在你的系统中打开。

🕸 Agent 网络 — 全家福

带两个子 agent 的 Agent 网络

当前 agent、其父级以及每个子 agent——每个 agent 一个节点，谱系用彩色边表示，多级委派呈现在同一张图上。每个环是该会话的构成按其窗口占用缩放后的结果；悬停可查看 token、请求、计费和活跃时间；点击可跳转到该会话自己的 Context 标签页。运行中的 agent 会以绿色脉冲呼吸。

⌨️ /context 命令

输入 /context（或从 / 菜单中选择它）并按 Enter：

带有 context 命令的斜杠菜单

会打开一个居中对话框，其中包含 Current Composition 卡片和 Context 浏览器——与标签页中相同的构成条、按步骤选择器和 vs previous turn 差异徽章：
/context 模态框

⚙️ 设置

在 设置 → 插件 → 插件配置 中，Context 卡片保存了此插件的每用户偏好设置——默认趋势粒度（Step/Turn）、默认趋势模式（Total/Delta），以及 File Activity 的默认排序。图表内和卡片内的切换开关仅作用于当前视图，绝不会覆盖已存储的偏好设置。

Context 设置卡片

值得了解

- 估算值与实际值 —— 分类数据使用 dsh 自有的固定密度启发式算法（与其内置 token 计量器所用的相同）；固定趋势详情会在其旁边显示提供商报告的实际值，而 Token 卡片则将其 ≈ 估算的组成占比与提供商精确的计费总额配对显示。
- 兼容性 —— 适用于 @deepseek-ai/dsh 0.1.2-rc1+，涵盖 V0（0.1.2-rc.x）、V2（0.1.3-alpha.x）和 V3（0.1.5-alpha.x+）会话日志代际。各版本的兼容性矩阵及其验证方式：docs/compatibility.md。
- 国际化 —— 界面支持英语和简体中文。

喜欢它吗？

如果 dsh-context 帮助你了解了你的 agent 正在承载什么内容，欢迎在 GitHub 上点一个 ⭐ —— 同时也欢迎提交 issue/PR！

许可证

Apache-2.0