跳到主内容

dsh-context 使用指南

为 DeepSeek Harness 增加「上下文」面板与 /context 弹窗,展示当前窗口构成、历史 token 趋势、压缩与剪枝事件,让用户看清模型到底吃了多少上下文。

本文为派生内容(基于 wiki / faq / compatibility_json 自动组装),非 AI 即时创作。

本文由本站基于该插件已收录的字段自动派生(wiki / faq / compatibility_json / readme),非 AI 即时创作。每节末尾标源字段。

快速上手

dsh-context

— 源: plugin_wiki.wiki_content

安装与验证

dsh plugin --profile web add dsh-context

复制以上命令在 DSH Web Profile 内运行。安装完成后在「插件列表」启用即可。

— 源: plugins.install

关键要点

  • Context tab — an UI context dashboard for DeepSeek Harness’s context stats, composition, history, events, and messages.
  • /context command — the slash command shows the context model for current context composition and recent context evolution.

— 源: plugin_wiki.readme_zh (fallback readme_raw)

常见问题

这个插件会修改会话历史或往 prompt 里注入额外内容吗?

不会。它是只读的状态投影:Host 半边把会话事件流折成当前构成、历史曲线、事件清单,Client 半边只渲染视图;/context 命令也不会向 session/event 写入任何记录,所以一条 /context 不会变成模型的输入。

/context 命令和右侧 Context 标签页看到的内容有什么区别?

数据完全一致,命令弹窗是标签页的精简版:只渲染当前构成头条、六类构成条和最近 10 轮的紧凑趋势图;标签页则多出全量历史曲线、压缩/剪枝事件流、当前模型可见的消息列和会话统计卡。

安装后右侧没有「上下文」标签页怎么办?

该插件只对 web profile 生效(package.json 的 dsh.client.platform=web)。请确认安装命令带了 --profile web,并用 dsh web 启动前端;CLI / TUI / 其他客户端不会显示该标签。

输入框里输入 /context 没有任何反应是怎么回事?

该命令是软依赖 harness 的 inputTriggers 服务。如果你的 DSH 版本没有这个服务,标签页照常可用,只是没有触发菜单;请升级 DSH 到 0.1.0-rc.6 或更高。

历史只保留最近多少轮 / 多少步?数据会丢吗?

默认保留 1500 步请求、300 轮、400 条事件和 200 个模型可见消息节点。折叠器只裁剪整轮、不会把一轮切两半;这些是 cordis 配置里的可调字段,不会丢底层会话日志。

卸载插件会丢失我之前积累的上下文视图数据吗?

会。上下文投影状态由插件本身折叠,没有落到 DSH 之外的持久层;卸载或停用插件后,再装回需要让会话重新产生事件以重建视图。会话本身的原始事件仍在 harness 中,不受影响。

顶部那条「模型剩余可用窗口」数字是从哪儿来的?

自 0.11 起来自 DSH 官方 token-meter 暴露的 contextPressure 投影(provider 真实用量 + 启发式估算)。如果 token-meter 未安装,会自动回退到本插件基于消息表面的估算数字。

需要联网或配置 API Key 吗?

不需要。zod 是唯一运行时依赖,所有 token 估算都在本地完成;只是插件信息卡会向 npm registry 发一次版本检查请求(1 小时缓存,断网/CSP 拦截都安全降级为不显示升级提示)。

— 源: plugin_wiki.faq_json

兼容性

  • DSH: 0.1.0-rc.6+(devDependencies 全部锁定到 0.1.0-rc.6;无 peerDependencies 声明)
  • Node: 未声明
  • Platforms: macOS, Windows, Linux

— 源: plugin_wiki.compatibility_json

踩坑提醒

安装前请审阅上游仓库;本指南基于已收录字段自动派生,可能滞后于最新版本。如发现与官方文档冲突,请以上游为准。

— 来源:通用规则