前言¶
用 DSH 跑智能体时,对话里会不断注入 AGENTS.md 提示、技能目录、召回会话、运行时环境快照等上下文。这些内容以 context 节点形式写入会话,但 DSH 的对话视图默认不渲染这类行——从 0.1.7-rc.2 起,只有带工具增删块(tool-addition / tool-removal)的 context 才会显示。想核对「当时到底注入了什么」,往往只能切到轨迹视图,和日常聊天对照起来不方便。
下面介绍社区客户端插件 dsh-reveal-context(维护者 azazo1):在不改 DSH 源码的前提下,用额外的 conversation 定义和自定义节点 kind,把这些被隐藏的注入行重新画进 Chat transcript,并支持按来源种类选择性关闭。
这是什么¶
dsh-reveal-context 是 DSH 的 客户端(web / desktop 共用同一套 Web 应用) 插件,当前包版本 0.1.0,许可证 MIT。它解决的是:对话界面看不到非工具类的 context 注入行 这一痛点。
实现思路(摘自项目 README):DSH 在 isVisibleChatNode 里过滤 context 节点;本插件注册另一份 conversation 定义,匹配同一批 user/message 事件,但产出 kind 为 reveal-context 的节点,从而通过可见性判定,再由插件自带的渲染器画成一行。引擎对每个事件的上下文 key 是 (definition.kind, id),与 DSH 内置定义并存、互不干扰。ChatNodeDataMap 为 DSH 公开的 merge-extensible 载荷注册表,新增节点 kind 属于设计内用法。
核心功能¶
已核实能力如下:
-
在 Chat 中显示被隐藏的注入行
包括 AGENTS.md 类通知、skill catalogs、recalled sessions、runtime snapshots 等(与 package 简介一致)。 -
总开关
设置里可关闭「显示被隐藏的注入行」,关闭后对话恢复 DSH 默认表现。 -
按来源种类排除
配置「仍然隐藏的来源」:每行一个source.kind,也可用逗号分隔;留空表示不排除任何来源。环境快照(form: 'snapshot')后一条替换前一条,各自占一行;若觉得吵,可把对应 kind 填进排除列表。 -
偏好即时生效
偏好保存在 profile 的 patch 层,修改后无需刷新页面。
安装与启用¶
Web 端¶
Web 端装进 web profile:
dsh plugin --profile web add azazo1/dsh-reveal-context
装完后重启 dsh web,浏览器里刷新一次页面。
桌面端¶
桌面端装进 desktop profile。Electron 应用独占管理该 profile,命令行 dsh plugin 会拒绝 --profile desktop。请在应用内插件管理器的安装入口填写与 Web 命令相同的包名 azazo1/dsh-reveal-context(或本地目录)。装上后重启应用并刷新窗口。
引擎版本¶
要求 @deepseek-ai/dsh-* 不低于 0.2.0-rc.1,且仍在 0.2.x(peerDependencies 与 devDependencies 均为 >=0.2.0-rc.1 <0.3.0)。更早的引擎线无法安装当前插件版本。web 与 desktop 使用同一包,无需分别构建。
典型用法¶
- 按上文完成安装并重启、刷新。
- 打开 设置 → 插件 → dsh-reveal-context,按需调整:
| 字段 | 说明 |
|---|---|
| 显示被隐藏的注入行 | 总开关,默认打开 |
| 仍然隐藏的来源 | 每行一个 source.kind,逗号分隔亦可;留空表示不排除 |
- 回到 Chat,对照原先只能在轨迹里看到的注入内容;若
runtime-context等快照行过多,在「仍然隐藏的来源」中填入对应source.kind。
适用场景与注意¶
适合谁: 需要在对话流里直接审计或调试 DSH 注入上下文(规则文件、技能目录、会话召回、运行时快照等)的 DSH / 智能体开发者。
边界(README 明确说明):
- 只覆盖
user/message上非 user 来源的context类节点;system-prompt、permission命令行不在范围内。 developer/message(如 agent loop 追加的工具增删)不在范围内;含工具增删块的context已由 DSH 自行显示,本插件再匹配可能多出一行。- 行渲染器依赖持久化事件的
content与source;节点形状沿用 DSH 当前内部约定,无对外 API 承诺,DSH 大版本升级后插件可能需要跟进。
安全与信任: 插件在当前 DSH 进程权限下运行,会注入客户端 UI 与 conversation 逻辑。安装前请阅读 GitHub 仓库 源码与 MIT 许可证,自行判断是否适合你的环境。
DSH 生态强调「一切皆插件」;社区目录 SkillHub 上的插件页 为独立站点,与 DeepSeek / 幻方无官方从属关系。
结尾¶
dsh-reveal-context 把 DSH 在 Chat 里藏起来的 context 注入行重新可见,并可用 per-kind opt-out 控制噪音。若你经常在轨迹与对话之间来回切换只为看一眼注入内容,可以按官方命令装进 web profile,或在桌面端通过应用内插件管理器安装同一包名。
- 目录页:https://www.skillhub.cn/plugins/azazo1/dsh-reveal-context
- 源码与说明:https://github.com/azazo1/dsh-reveal-context