DSH 插件 · 社区项目

dsh-context

在 DeepSeek Harness Web UI 中查看上下文占用与构成、请求趋势、完整上下文内容、文件活动和 Agent 网络,适合排查长会话为何膨胀以及哪些内容真正进入模型请求。

1.2k StarsApache-2.0TypeScript今天更新
01

项目介绍

dsh-context 是面向 DeepSeek Harness Web UI 的上下文洞察插件。它把当前请求的 token 占用与构成、每步或每轮的上下文趋势、模型实际可见的系统提示和工具 schema,以及文件活动与 Agent 关系放到同一个界面中。最有价值的用途不是把图表当作性能结论,而是定位长会话里哪类内容持续增长、压缩前后发生了什么,以及某个工具或 Agent 对上下文的实际影响。

dsh-context 的 Context 页面,展示上下文统计、构成与趋势图
仓库自带的 Context 总览截图,同时展示上下文统计、分类构成和趋势,是理解插件核心界面的直接证据。查看仓库原图
02

核心功能

01

上下文占用与构成

读取 DSH 官方 token-meter 的 contextPressure 与 contextBreakdown 投影,显示当前请求各类内容及占用比例,与聊天输入框的上下文环保持同一数据来源。

02

趋势与事件诊断

按步骤或完整轮次查看上下文总量、增量和事件,辅助定位压缩、工具调用或长结果引起的结构变化。

03

完整上下文浏览

展示系统提示、工具 schema、用户与助手消息、推理,以及工具参数和结果;超出当前消息窗口的内容通过兼容新旧 DSH 的历史接口按需读取。

04

文件活动与 Agent 网络

从会话事件聚合文件读写、搜索、图像和行数变化,并以 best-effort 工具来源归属生成 Agent 关系视图。

03

安装与使用

确认 DSH 版本满足最低要求后,把插件添加到 web profile。启动 `dsh web`,从 Context 标签页或 `/context` 打开页面,再用一个不含敏感信息的测试会话验证投影、历史展开和设置。

AI AGENT INSTALL

让 AI Agent 帮你安装

把这段话发送给 Codex、Claude Code 或其他可以操作本地环境的 AI Agent。

请帮我安装并审查 dsh-context,项目地址为 https://github.com/bowenliang123/dsh-context。先读取 README、LICENSE、package.json、发布说明和源码中的 `src/client/latestVersion.ts`、`src/client/historyPage.ts`、`src/host/index.ts`,确认当前 DeepSeek Harness 至少为 0.1.1-rc.2 或 0.1.2-alpha.2,并确认目标是 web profile。使用仓库当前命令 `dsh plugin --profile web add dsh-context`,不要覆盖其他 profile 或现有插件配置。执行前说明 npm 下载、web profile 修改、会话历史读取、完整上下文显示和 npm/npmmirror 版本查询的数据边界。安装后运行 `dsh web`,只用不含敏感信息的测试会话检查 Context 标签页、`/context`、趋势图和旧内容展开。遇到凭据、额外权限、版本冲突、覆盖配置或公开暴露 Web UI 时先停下向我确认。
01开始前准备
  • DeepSeek Harness 0.1.1-rc.2+ 或 0.1.2-alpha.2+
  • 可运行 `dsh` CLI 并修改 web profile
  • 可从 npm registry 下载 dsh-context 及其依赖
  • 已确认 DSH Web UI 的访问范围适合显示完整会话内容
02复制安装命令或配置
dsh plugin --profile web add dsh-context
03按步骤完成安装
  1. 1
    核对版本与 Web UI 暴露范围

    运行 DSH 版本检查,确认满足 0.1.1-rc.2+ 或 0.1.2-alpha.2+。同时确认 Web UI 只对可信用户开放,因为插件可以展示完整会话内容。

  2. 2
    安装到 web profile

    运行 `dsh plugin --profile web add dsh-context`。命令会从 npm 获取包并修改 web profile;若已有同名插件,先检查当前版本和配置。

  3. 3
    启动并打开 Context 页面

    运行 `dsh web`,从侧边栏进入 Context 标签页,或在聊天中输入 `/context` 打开弹窗。插件设置位于 Settings → Plugin configuration。

  4. 4
    用低敏感测试会话验证

    建立一个短测试会话,检查占用、构成和趋势,再展开旧消息或工具结果验证按需历史读取。分类数字是估算,计量时以提供商报告的实际数值为准。

如何确认安装成功

运行 `dsh web` 后打开 Context 标签页或输入 `/context`。先用一个无敏感信息的短会话确认当前占用、构成和趋势出现,再展开一条系统提示或工具结果,核对历史读取;最后在插件设置页更改粒度或排序并刷新确认。

使用前注意
  • 更新命令为 `dsh plugin --profile web update dsh-context@latest`
  • 插件没有自定义 RPC,Host 端通过 DSH sessionProjections 推送结果
  • 默认保留上限包括 1500 个请求步骤、300 个完整轮次和 400 个事件,可在插件配置中调整
  • 最新版查询优先访问 registry.npmjs.org,失败时回退到 registry.npmmirror.com,并缓存一小时
04

使用场景

SCENARIO 01

定位上下文膨胀来源

比较步骤或轮次的总量与增量,判断增长主要来自系统提示、工具 schema、消息、推理还是工具结果。

SCENARIO 02

检查压缩前后变化

结合趋势、上下文事件和浏览器内容,查看自动压缩前后哪些内容被保留、替换或移出当前窗口。

SCENARIO 03

审查工具与 Agent 影响

用 File Activity 和 Agent Network 查看哪些工具读取或修改了文件,以及多 Agent 工作流的来源关系;工具归属仍需按 best-effort 结果理解。

05

使用评价

dsh-context 的优势是把 DSH 已有的上下文投影、会话历史和工具活动组织成可追踪的 Web 视图,安装命令清晰,仓库也有双版本基线 CI、密集测试和近期发布。主要风险在于它会把系统提示、推理和工具结果等敏感内容集中显示,且部分分类与工具归属是估算或 best-effort。此评价来自公开文档、源码和 GitHub 元数据,不代表本机实测。

值得一试的地方

  • 同一界面覆盖当前占用、历史趋势、完整内容、文件活动和 Agent 网络
  • README 提供直接安装、更新、入口和兼容版本说明
  • 发布工作流对两条 DSH 版本线运行类型检查、测试与构建
  • v0.40.1 于核验前一日发布,仓库公开且未归档

使用前要知道

  • 完整上下文视图可能暴露系统提示、推理和工具结果中的敏感信息
  • 分类估算不能替代提供商实际计量,工具归属也可能未知或误归属
  • 没有 SECURITY.md,安全问题报告和响应方式不明确
  • 本次没有在目标 DSH 环境安装或运行插件
06

README

dsh-context


Overview

在 DeepSeek Harness Web UI 中查看上下文占用与构成、请求趋势、完整上下文内容、文件活动和 Agent 网络,适合排查长会话为何膨胀以及哪些内容真正进入模型请求。 为 DeepSeek Harness 提供 Web 上下文仪表盘和 /context 命令,展示上下文构成、趋势、内容浏览、文件活动与 Agent 网络。

Getting started

  • 确认 DSH 版本满足最低要求后,把插件添加到 web profile。启动 `dsh web`,从 Context 标签页或 `/context` 打开页面,再用一个不含敏感信息的测试会话验证投影、历史展开和设置。
  • 安装后可通过 Context 标签页或 `/context` 命令打开仪表盘;设置入口位于插件配置页,无需手工构建前端。
  • Context Stats、Token Stats 和 Timing Stats 展示上下文占用、官方 token meter 投影、延迟和请求节奏;Context Trend 可按步骤或轮次看总量与增量。
  • 运行 `dsh web` 后打开 Context 标签页或输入 `/context`。先用一个无敏感信息的短会话确认当前占用、构成和趋势出现,再展开一条系统提示或工具结果,核对历史读取;最后在插件设置页更改粒度或排序并刷新确认。

Configuration

dsh plugin --profile web add dsh-context
在 GitHub 阅读完整 README