前言¶
在 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 的验证清单,可按顺序自检:
- 页面加载无控制台报错,「系统」Tab 出现在「轨迹」右侧。
- 新会话发起第一轮对话后,「提示词」「工具」「配置」页有内容;概览条显示模型、工具数、Skills 数。
- 在「工具」页搜索
ToolSearch可见(启用 dsh-mcp-lazy 时);搜索mcp__应无结果。 - 「Skills」页显示当前目录块的 skill 卡片。
- 「配置」页显示「上下文窗口」行,值来自
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