dsh-context

dsh-context

简体中文 · English · 日本語 · Español · Français · Português




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

获得 DeepSeek Harness 团队成员 @tianyicui 和 @turtle1999 推荐并加星——参见 X 上的这条帖子。

dsh-context 提供完整的上下文生命周期管理功能。

• 上下文洞察页面 — 跨会话总览，作为一级侧边栏面板（与 Plugins 和 Automation tasks 并列）：包含 7 天 Token/成本使用图表的 KPI 栏、活动热力图、汇总组成环形图，以及可筛选并可直接跳转至任一会话的会话卡片。
• Context 标签页 — DeepSeek Harness 上下文统计、组成、趋势、事件、消息和命令执行的 UI 上下文仪表板。
• Fleet 标签页 — Agent 家族专属页面：当前 Agent、它的父级，以及每个子 Agent 各自显示为一张实时卡片。
• Context 面板 — 同一仪表板也可作为右侧边栏标签页：在侧边栏指南页面选择 Context，面板便会在聊天旁打开，并包含 Agent 网络。
• /context 命令 — 斜杠命令会显示当前上下文组成模型和近期上下文演变。

▶️ 4 分钟视频导览 — 在 Bilibili 观看。


安装 / 更新

在 DeepSeek Harness 网页版或桌面版中安装

在 Add plugin 向导的搜索框中填写 dsh-context，然后点击 Install：

使用 dsh CLI 安装

从 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 标签页 · 完整仪表板：统计、组成、逐请求趋势、事件、文件活动和命令执行——适用于每个会话。

Fleet 标签页 · Agent 网络：当前 Agent、它的父级以及所有子 Agent，实时呈现。

/context 命令 · 居中弹窗，提供相同的组成信息和上下文浏览器，无需离开聊天。

Preferences 卡片 · 每位用户的默认设置：面板入口、洞察时间范围、趋势与排序默认值，以及拼接在每个会话系统提示词前后的前缀/后缀。

🗂️ 上下文洞察页面

点击侧边栏面板列表中的 Context Insights / 上下文洞察（与 Plugins 和 Automation tasks 位于同一层级），页面便会作为完整的中央栏面板打开：

区块 · 解答的问题

KPI 栏 · 我的使用量如何——所选时间范围（7 天 / 30 天 / 全部）内活跃的会话，其计费 Token、预估成本、缓存命中率和轮次按 step 发起日归因；工具执行与活跃时长则统计这些会话及其子 Agent 的全部生命周期，与耗时统计卡片一致。

7 天使用量图表 · 每天的花费和用量如何——最近 7 天每天的计费 Token 和预估成本以成对柱状图展示，按会话自身各请求的时间汇总（而不是按会话最后活跃日期）。

活动热力图 · 我实际在什么时候工作——最近 8 周每日的计费 Token；点击某天即可筛选当天活跃的会话，并让三个统计卡片只看当天。

技能加载 · 加载了哪些技能、各多少次、最近何时——所选时间范围内按技能汇总的加载次数；点击可筛选加载过它的会话。

工具调用 · 运行了哪些工具、各多少次、最近何时——按日账本汇总的工具执行次数；点击可筛选运行过它的会话。

命令执行 · 运行了哪些程序、各多少次、最近何时——按程序汇总的命令执行次数（按派发计）；点击可筛选执行过它的会话。

设置入口 · 页面标题栏中的按钮——与 Context 标签页 Plugin Info 卡片中通往此插件偏好设置的受保护跳转相同。

Context Composition · 所选时间范围内的计费 Token 用在了哪里，按 Token 卡片的计费分类（Tool Calls、Reasoning、Answers……）拆分。

会话卡片 · 四个卡片下方每个会话的概况：组成环形图、计费 Token、轮次、成本以及工作区分组 / 项目路径；可按最近活动、Token 数或上下文大小排序、搜索、按工作区分组。点击卡片即可打开会话。

📊 Context 标签页

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

卡片 · 解答的问题

Context Stats · 轮次、步骤、用户输入、实时工具调用——以及根据 models.dev 价格列表估算的成本（将鼠标悬停在 ? 上可查看每百万 Token 单价；仅 DeepSeek 区分高峰 / 非高峰：其挂牌价为谷时价，高峰时段按 2 倍计费）。

Token Stats · 计费 Token 用在了哪里——总量与输入框下方聊天统计行相同，拆分为系统提示词、工具定义、用户消息、注入上下文、技能注入、工具调用、推理和回答。工具调用把工具名称与参数（提示词中重放的部分，加上输出中生成的部分）与这些工具返回的结果一并计入；回答从同一份助手内容与输出中拆出模型的回复正文；推理以同样方式拆出其思考内容；会话的缓存命中率显示在角落。

Timing Stats · 活跃时间如何分布在模型调用、工具运行和开销之间。

Current Context · 此刻窗口中的内容。

Context Trend · 每个请求的大小及其变化过程。

Context Browser · 任意请求实际由哪些内容组成。

Context Events · 上下文窗口何时以及为何发生变化。

File Activity · Agent 对你的文件做了什么。

命令执行 · Agent 执行了哪些命令、每次运行如何结束、主要用到了哪些程序。

成本估算遵循一套有文档记录的规则：[模型定价如何映射](docs/model-pricing-mapping.md)。

标题中的占用率和组成数据读取的都是与聊天输入框上下文环形图相同的官方 Token 计量投影（contextPressure / contextBreakdown），因此数值始终与环形图一致——卡片中的百分比就是同一占用率，精确显示到小数点后一位。

Context Stats 卡片中的 Agent Network 单元格（整个 Agent 家族的计费 Token 和预估成本）会跳转至 Fleet 标签页。输入输出一行的胶囊同样是跳转链接：用户输入 打开上下文浏览器的用户消息，读取 / 写入 / 搜索 / 图片 落到文件活动卡片并选中对应筛选。

Context Stats

Token Stats 和 Timing Stats

Context Stats

🧱 当前上下文 — 此刻上下文窗口中的内容

六种颜色的堆叠条，以模型的完整窗口为基准（末尾两个带斜线的区域 = 自动压缩预留空间：先是其余量，再是请求预留的输出窗口）：系统提示词、工具定义、用户消息、注入上下文、助手回复、工具结果——每项都显示约略 Token 数和占比。当对话开始退化时，可以在这里看到具体是哪部分导致的。

📈 上下文趋势 — 按轮次或步骤查看上下文的增长与演变

…(truncated)