dsh-context

dsh-context 0.64.0 展示 DSH 上下文组成、趋势、文件活动与 Agent 关系，新增跨会话的上下文洞察页和 DeepSeek 余额显示；余额功能会让宿主读取 API Key 并请求 DeepSeek 平台。

• DSH 0.2.0-rc.2（必需）：0.64.0 的 DSH peer 为 >=0.1.5-rc.1，版本声明通过 0.2.0-rc.2 的检查；作者声明支持 0.1.5-rc.1、0.1.7-rc.2、0.2.0-rc.2。Node.js 需 ^22.19.0 或 >=24。
• 独立 web Profile（必需）：先在测试 Profile 中安装，安装前备份 profiles/web 下的 package.json、cordis.patch.yml 与 pnpm-lock.yaml。
• 不含敏感内容的测试会话（必需）：插件会读取并展示会话正文、工具结果和文件路径，先用无敏感内容的短会话查看。
• 确认 DeepSeek 端点配置（必需）：打开上下文洞察页时，宿主会用你的 DeepSeek API Key 请求余额接口。用环境变量 DEEPSEEK_BASE_URL 指向内部网关或中转、且未在配置里写 baseURL 的部署，Key 会被发到 https://api.deepseek.com；这类部署先把上下文洞察入口设为隐藏，或暂不升级。

本页命令固定使用 DSH 0.2.0-rc.2，与 npm 默认版本分别维护。切换 DSH 前核对本插件的兼容记录；新版 Session API 与格式变化见0.1.3-alpha.1 升级说明。源码审阅不等于运行验证。

下面的命令使用本站核验的 DSH 基线，并锁定插件版本或 Git commit，避免默认分支变化导致安装内容漂移。本站已核对安装目标，但尚未在你的系统和 Profile 中实际执行。

安装到

web Profile

DSH 基线

0.2.0-rc.2

安装来源

npm 预构建包（锁定版本）

固定目标

[email protected]

0.64.0 声明的 DSH 版本范围是没有上限的 >=0.1.5-rc.1，通过 0.2.0-rc.2 的检查；作者声明支持 0.1.5-rc.1、0.1.7-rc.2、0.2.0-rc.2。本页固定 DSH 0.2.0-rc.2，Node.js ^22.19.0 或 >=24。仅静态复核，未在本站运行验证。

• DSH 版本组合来源 1 ↗（外部链接，在新标签页打开）
• DSH 版本组合来源 2 ↗（外部链接，在新标签页打开）
• DSH 版本组合来源 3 ↗（外部链接，在新标签页打开）

1. 01
   检查 Node.js 与 pnpm

   DSH 当前基线需要 Node.js 22.19 或 Node.js 24 及以上，并且 pnpm 必须已在 PATH 中。先运行：

   环境检查复制命令

   node --version && pnpm --version

2. 02
   安装到 Web Profile

   这条命令会把插件加入 web Profile，并在插件声明 DSH Bundle 时自动加入配置层。

   npm 预构建包（锁定版本）复制命令

   npx --yes @deepseek-ai/[email protected] plugin --profile web add [email protected]

3. 03
   确认 Bundle 已进入配置

   安装成功后先导出组合配置，不启动 Agent。输出中应能找到包名 dsh-context或对应 Bundle 层。

   检查配置复制命令

   npx --yes @deepseek-ai/[email protected] --profile web --dump-config

4. 04
   启动并完成最小验证

   启动 Web Profile 后，只测试一个与插件功能直接相关的最小任务，并检查日志、文件、网络和凭据访问是否符合预期。

   启动 DSH Web复制命令

   npx --yes @deepseek-ai/[email protected] web

npx --yes @deepseek-ai/[email protected] plugin --profile web remove dsh-context

插件 → dsh-context → 配置

DSH 0.1.7 及以上在主侧栏插件页编辑 8 项显示偏好：入口位置、上下文洞察入口、趋势图默认粒度、默认展示方式、耗时曲线、对比基线、工具定义排序、文件活动排序。

$DSH_HOME/profiles/web/cordis.patch.yml

dsh-context 条目的 config 保存上述偏好，以及 6 个保留上限：maxRequestSteps 1500、maxKeptTurns 300、maxEvents 400、maxNodes 2000、maxArchiveNodes 400、maxFileOps 400。修改上限会重新加载该条目。

浏览器 localStorage 键 dsh-context:platform-balance

保存上一次查询到的余额数字，用于下次打开时先显示；不含 API Key。

npx --yes @deepseek-ai/[email protected] plugin --profile web add [email protected]

- id: dsh-context
  config:
    insightsEntry: hide

- id: dsh-context
  config:
    defaultPlacement: all
    defaultGranularity: step
    defaultTrendMode: total
    defaultDeltaBase: step
    defaultToolSort: count
    defaultFileSort: count
    insightsEntry: show
    defaultDurationCurve: show

1. 停止正在运行的 DSH 后执行安装命令，再运行 npx --yes @deepseek-ai/[email protected] web 并刷新浏览器。
2. 打开一个测试会话，在会话视图切到「上下文」标签，或输入 /context 打开弹窗。
3. 不希望宿主用 API Key 查询余额时，先在 插件 → dsh-context → 配置 把「上下文洞察入口」设为隐藏，再使用其他功能。
4. 需要跨会话概览时，点击主侧栏面板列表中的「上下文洞察」；首次打开会在后台读取全部历史会话来补齐统计。

1. 01
   在输出中查找 id: dsh-context 条目。

   复制验证命令复制命令

   npx --yes @deepseek-ai/[email protected] --profile web --dump-config

   期望结果：合并配置中只有一个 dsh-context 条目，name 为 dsh-context。

2. 02
   在测试会话中打开「上下文」标签，展开一个分类查看明细。

   期望结果：能看到组成、趋势和事件汇总；展开后才加载该会话的明细。

3. 03
   在 插件 → dsh-context → 配置 修改一项显示偏好（如趋势图默认粒度）并刷新页面。

   期望结果：偏好在刷新后保留，cordis.patch.yml 的 dsh-context 条目 config 中出现对应值。

4. 04
   把「上下文洞察入口」设为隐藏后查看主侧栏。

   期望结果：面板列表不再出现「上下文洞察」，浏览器不再请求 /api/dsh-context/balance。

• 查看当前测试会话中系统提示、工具定义、工具结果和用户消息各占多少上下文。
• 在上下文浏览器中选一个步骤，对比上一轮新增或回收了哪些内容。

读取全部会话的事件、正文、路径与统计；经凭据服务读取 DeepSeek API Key 并向平台余额接口发起请求；agent/pre-step 钩子可为缺少 ID 的消息写入新标识；首次打开洞察页会冷读全部历史会话并写入投影缓存。不能描述为只读插件。

数据存储：显示偏好和保留上限保存在当前 profile 的 cordis.patch.yml 条目 config（旧版 DSH 为 settings.yaml 的 dsh-context 段）。时间线、请求头和每日活动三类投影由 DSH 的投影缓存持久化在本机会话数据中。执行前补全的 dshctx- 前缀消息 ID 会进入会话日志。余额数字保存在浏览器 localStorage；API Key 只在宿主进程内使用，不写入插件自己的文件，也不下发浏览器。

请注意：“源码已审阅”说明本站检查到的证据范围，不等于安全认证。重要工作区应锁定版本、备份数据并在最小权限下测试。

上下文面板全是 0 并提示升级 DSH

插件检测到 DSH 低于 0.1.5-rc.1 时只显示空数据和升级提示。确认当前运行的是本页固定的 DSH 版本；不要通过版本豁免在更旧的 DSH 上使用。

上下文洞察页没有显示 DeepSeek 余额

余额只在使用 DeepSeek API Key 提供方、凭据可解析且平台接口正常返回时显示；账号登录方式、第三方端点或网络失败时不显示，属于预期行为，不影响其他统计。

首次打开上下文洞察页后磁盘读取明显增加

插件正在后台逐个读取历史会话补齐统计，每个进程只做一次；等待完成即可。无法读取的旧格式会话会被跳过，原文件不会被修改。

上下文详情持续显示无法按需获取

0.64.0 的详情改走 /api/dsh-context/detail。确认 DSH 已重启并刷新页面，浏览器仍处于登录状态；仍失败时保留脱敏错误，不删除会话。

费用或余额与平台账单不一致

分类占比是估算，费用按内置价格表计算，余额是打开页面时的一次查询；都不能替代平台账单。