dsh-reveal-context:在對話裏重新顯示被隱藏的上下文注入行

前言

用 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 屬於設計內用法。

核心功能

已覈實能力如下:

  1. 在 Chat 中顯示被隱藏的注入行
    包括 AGENTS.md 類通知、skill catalogs、recalled sessions、runtime snapshots 等(與 package 簡介一致)。

  2. 總開關
    設置裏可關閉「顯示被隱藏的注入行」,關閉後對話恢復 DSH 默認表現。

  3. 按來源種類排除
    配置「仍然隱藏的來源」:每行一個 source.kind,也可用逗號分隔;留空表示不排除任何來源。環境快照(form: 'snapshot')後一條替換前一條,各自佔一行;若覺得吵,可把對應 kind 填進排除列表。

  4. 偏好即時生效
    偏好保存在 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 使用同一包,無需分別構建。

典型用法

  1. 按上文完成安裝並重啓、刷新。
  2. 打開 設置 → 插件 → dsh-reveal-context,按需調整:
字段 說明
顯示被隱藏的注入行 總開關,默認打開
仍然隱藏的來源 每行一個 source.kind,逗號分隔亦可;留空表示不排除
  1. 回到 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
羽毛球分组比赛记分
小程序二维码

欢迎使用《羽毛球分组比赛记分》微信小程序

小夜