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
羽毛球分组比赛记分
小程序二维码

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

小夜