dsh-context Skill 技能

技能简介

dsh-context 是一款面向 DeepSeek Harness（简称 DSH）的第三方开源插件，专门解决 AI 长会话里的"上下文黑箱"问题。它把一次会话的上下文占用、Token 去向、成本开销、结构组成和演进过程全部摊开成可视化面板，让开发者不必再靠猜来判断 Agent 到底在"记"什么。项目在 GitHub 上已获得约 2400 星标与 78 次 fork，并被 DeepSeek Harness 团队成员公开推荐并加星，是目前 DSH 生态中最受关注的上下文类插件之一。

核心能力

• 上下文仪表板：统计轮次、步数、人工输入次数与实时工具调用，并按公开价目估算成本，能区分 DeepSeek 的峰时与谷时价格。
• Token 拆分：把计费 Token 按系统提示词、工具定义、历史消息等组成分类拆开，环形图直接显示占比，角落标注本次会话的缓存命中率。
• 跨会话总览：最近 7 天的 Token 与成本以成对柱状图呈现，最近 8 周的活动热力图按天显示用量，且按每次请求自身的时间归因，而不是按会话最后活跃日粗暴合并。
• 上下文浏览器：可以回看任意一次请求到底由哪些内容拼成，判断究竟是哪一段对话把窗口撑大的。
• 上下文事件流：记录上下文窗口何时、因何被压缩或改写，压缩前后的差异一目了然。
• 文件活动追踪：记录 Agent 对工作区文件做过哪些读写与修改。
• Agent 网络视图：Fleet 标签页把当前 Agent、它的父级以及每一个子 Agent 各显示为一张实时卡片。

安装配置

1. 图形化安装：在 DSH 网页版或桌面版的 Add plugin 向导中搜索 dsh-context，点击 Install 即可完成。
2. 命令行安装：执行 dsh plugin --profile web add dsh-context，后续更新执行 dsh plugin --profile web update dsh-context@latest。
3. 安装后用 dsh web 启动 Web UI，无需构建步骤，也无需重启既有会话。
4. 偏好设置在 Preferences 卡片里按用户保存，可调整视图位置、趋势粒度与模式、文件活动排序，以及拼接在每个会话系统提示词前后的前缀与后缀。

使用步骤

1. 打开任一会话，点击 Context 标签页，查看该会话的统计、组成、逐请求趋势、事件与文件活动。
2. 在侧边栏面板列表中选择 Context Insights（上下文洞察），进入跨会话总览页面。
3. 用时间范围（7 天 / 30 天 / 全部）、具体日期、工作区分组或关键词搜索来筛选会话卡片。
4. 点击某张会话卡片可直接跳转进入该会话继续查看细节。
5. 在聊天框输入 /context，可唤起居中弹窗，不离开对话就能看当前上下文组成与浏览器。
6. 需要观察多 Agent 协作时，切到 Fleet 标签页查看实时网络。

工作原理

插件的核心做法是只读地消费 DSH 自身的会话日志与请求元数据，再按"逐个请求"而非"逐个会话"的粒度重新聚合。Token 统计沿用聊天输入框下方那条统计线的同一口径，因此与内置数字保持一致；输出侧用模型供应商的精确值闭合环形图；成本部分基于公开价目表计算并区分 DeepSeek 峰谷时段，所以给出的是估算金额而非真实账单。上下文浏览器则是把每次请求实际拼装进去的片段还原出来，这也是它能解释"上下文为什么突然变大"的原因。

适用场景

• 长会话成本控制：定位是哪类内容把上下文撑大、哪一步开始成本明显上升。
• 上下文膨胀排查：查看压缩发生的时机、压缩比例与压缩前后的组成差异。
• 多 Agent 协作观察：还原父子 Agent 与子任务之间的上下文继承关系。
• 团队用量复盘：按工作区或项目统计 Token 与花费，做成本归因。
• 缓存命中优化：对照缓存命中率判断系统提示词前缀是否足够稳定。

适用人群

长期使用 DeepSeek Harness 的个人开发者、需要为团队核算 AI 成本的工程负责人、研究 Agent 上下文工程的开发者，以及需要向管理者解释"Token 究竟花在哪里"的一线工程师。

生态与更新

项目以 npm 包 dsh-context 分发，仓库仍在活跃维护，最新提交时间为 2026 年 10 月 20 日。插件同时提供 dshfind 目录页入口，便于在插件市场中检索与更新。

官方链接

GitHub 仓库：https://github.com/bowenliang123/dsh-context npm 包地址：https://www.npmjs.com/package/dsh-context