dsh-system-view:在會話區用「系統」Tab 查看生效上下文

前言

在 DSH 裏調試智能體時,系統提示詞、本輪請求實際攜帶的工具、Skills 目錄和模型配置往往分散在軌跡事件或日誌裏,要拼出「模型此刻到底看見什麼」需要反覆翻找。官方會話區已有「對話」和「軌跡」,但沒有一塊專門聚合「當前生效面」的視圖。dsh-system-view 由 ice-ai-lab 維護,屬於客戶端類插件:在會話區頭部新增「系統」Tab,從已提交的會話事件重建上述信息,不發起額外 I/O,也不向模型注入內容,符合 DSH「模型可見 ⟺ 可由會話日誌重建」的約定。

這是什麼

dsh-system-view(GitHub:ice-ai-lab/dsh-system-view)是一個雙面 bundle 插件——Node 側 inert 佔位,瀏覽器客戶端承載全部 UI 能力,形態參考同生態的 dsh-mcp-lazy。它解決的是「在當前會話裏一眼看清生效系統提示詞、工具列表、Skills 與請求配置及其變更」的問題,面向在 Web GUI 裏開發、聯調 DSH 插件或智能體流程的開發者。

核心功能

「系統」Tab 下分四個二級頁,數據均來自會話事件重建:

二級頁 內容 數據來源
提示詞 當前生效系統提示詞全文,字符數、歷史內更新標記、搜索、複製 system/message 會話事件
工具 當前請求實際攜帶的完整工具列表(名稱、描述、參數 schema,可搜索、可展開) request/header 的 header.tools
Skills <available_skills> 目錄塊解析爲名稱 + 摘要卡片;無法解析時展示原始塊 系統提示詞文本
配置 provider/model/溫度/最大 token/推理力度/上下文窗口等,含適配器默認值與原始 JSON request/header 的 header.config 與 request/context 的 contextWindow

實現上,插件通過 ctx.slots.inject("conversation.view", …) 註冊 id: "system", order: 20 的視圖,與 chat(order 0)、trajectory(order 10)並列;用 uiConversation.events.register 掛載私有 systemView 目標上的事件 Definition,組件經 useSystemView 訂閱快照。客戶端 client.js 爲平臺 ModuleLoader 工廠格式,依賴僅 React,無獨立構建步驟。

與「軌跡」的區別在於:這裏強調當前請求組裝結果和生效面。例如啓用 dsh-mcp-lazy 時,「工具」頁展示的是 ToolSearch、DeferExecuteTool 等實際生效工具,被懶加載隱藏的 mcp__* 不會出現——便於覈對 MCP 懶加載是否按預期裁剪工具面。

安裝與啓用

在 DSH 會話中執行 README 給出的安裝方式(target 需指向本機上的插件目錄):

plugin_manager install_bundle target=/Users/gatesma/project/DeepseekHarness/plugins/dsh-system-view

安裝後刷新 Web GUI 頁面(客戶端 bundle 隨頁面啓動加載)。新會話或已有會話的會話區頭部應在「軌跡」右側出現「系統」Tab。

運行環境(見 package.json):Node >=22.18.0,DSH >=0.2.0 <0.3.0,peer 依賴 @deepseek-ai/cordis ^4.0.2。許可證 MIT,當前版本 0.1.0。

典型用法與驗證

下面步驟來自倉庫 README 的驗證清單,可按順序自檢:

  1. 頁面加載無控制台報錯,「系統」Tab 出現在「軌跡」右側。
  2. 新會話發起第一輪對話後,「提示詞」「工具」「配置」頁有內容;概覽條顯示模型、工具數、Skills 數。
  3. 在「工具」頁搜索 ToolSearch 可見(啓用 dsh-mcp-lazy 時);搜索 mcp__ 應無結果。
  4. 「Skills」頁顯示當前目錄塊的 skill 卡片。
  5. 「配置」頁顯示「上下文窗口」行,值來自 request/context(例如 GLM 路由可能顯示 1000000)。

長會話重啓後,歷史加載遵循會話窗口分頁:初始窗口在尾部時,激活「系統」Tab 會自動向上補載直到生效上下文出現;也可手動滾到對話頂部觸發加載。

適用場景與注意

適合誰: 需要在 GUI 裏對照「系統提示詞是否更新」「本輪請求帶了哪些工具」「Skills 塊是否解析正確」「模型與上下文窗口配置」的 DSH 開發者;與 dsh-mcp-lazy 等改變工具面的插件聯調時,用來確認生效工具列表而非完整 MCP 註冊表。

邊界與限制:

  • Skills 解析只認 - \name`: summary` 列表形態;目錄塊格式變化時回退爲原始文本,不影響其他頁。
  • 視圖純展示,不提供修改配置或寫回會話的入口。
  • 插件隨 DSH 進程與 Web 客戶端加載運行;安裝前應在 GitHub 閱讀源碼與 LICENSE,自行評估信任邊界。社區目錄頁(skillhub.cn)爲獨立站點,與 DeepSeek / 幻方無官方從屬關係。

結尾

dsh-system-view 把系統提示詞、請求級工具、Skills 與配置集中到會話區「系統」Tab,全部從已有事件重建,適合作爲調試與審計生效上下文的只讀面板。

  • 目錄頁:https://www.skillhub.cn/plugins/ice-ai-lab/dsh-system-view
  • 倉庫:https://github.com/ice-ai-lab/dsh-system-view
羽毛球分组比赛记分
小程序二维码

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

小夜