前言¶
DeepSeek Harness（DSH）的“轨迹”回答过去发生了什么，而运行时的状态变化需要通过“透视”来查看。dsh-runtime-xray 是 DeepSeek Harness 的只读运行时检查插件。它不会修改配置、重载插件、执行命令或向模型增加工具，而是通过查看当前真正生效的运行时底座、会话能力、模型输入和生命周期资源，解决开发者需要实时掌握 Agent 状态的问题。
插件简介¶
dsh-runtime-xray 是 DeepSeek Harness 的只读运行时 X-Ray，由 hollis-openlab 维护。它遵循 MIT 许可证。
透视页按一条清晰的运行链组织信息：运行时底座 → Skill / 工具 → 模型上下文。服务属于 Host 内部运行底座，不会被误认为模型输入。
核心功能¶
插件提供以下能力：
- 分层导航：概览、运行时底座、会话能力和模型输入按运行层级浏览。
- 当前会话：查看当前会话实际可用的服务、Skill、工具、模型上下文和模型路由。
- 整个应用：检查所有会话共享的插件、服务与生命周期资源。
- 作用域继承：展示“整个应用 → 预设 → 当前会话”的覆盖顺序。
- 模型输入：统计系统指令段、运行时上下文、变量，并按 Harness、工具、应用、部署、Plan、UI 分组。
- 插件—服务网络：展示所有者关系（实线）和来自明确
ctx.provide标签的推断关系（虚线）。 - 生命周期资源：按服务注册、子插件挂载、定时器、监听器和其他资源聚合，展开后可查看来源和深度。
- 服务词典：显示原生 DSH 服务的用户化名称和中英文作用气泡；未知服务保留原始 key 并使用安全兜底。
- 证据等级：区分精确、推断、不可用；不会把猜测伪装成事实。
- 故障隔离：一个检查域失败时，其他域仍然可用。
- 重新读取：手动采集一次当前状态；页面关闭时不会后台轮询。
- 下载诊断文件：下载当前画面的脱敏 JSON；文件大小上限为 1 MiB。
- 中英双语：跟随 DSH Web 的语言设置实时切换，无需重载插件。
安装与启用¶
使用以下命令安装插件并启动 Web profile：
dsh plugin --profile web add "github:hollis-openlab/dsh-runtime-xray#main"
dsh --profile web
重启 Web profile 后，在「对话」和「轨迹」旁边会出现「透视」。
典型用法¶
- 打开一个会话，点击“透视”。
- 选择“当前会话”，沿着运行时底座、会话能力和模型输入查看当前会话。
- 打开“Skill”查看有效 Skill 目录；再打开“工具”查看模型可调用动作。
- 打开“模型上下文”，按数据类型和来源分组检查模型输入。
- 选择“整个应用”，检查插件—服务网络和聚合后的生命周期资源。
- 需要确认热更新后的状态时，点击“重新读取”。
- 需要提交问题证据时，点击“下载诊断文件”下载脱敏 JSON。
适用场景与注意事项¶
插件只读取当前 DSH 进程公开提供的运行时信息，不会连接任何外部服务，也不需要自己的 API Key、环境变量或可写数据目录。
默认快照和诊断文件不会包含：
* 凭据和环境变量值；
* 提示词正文和运行时上下文正文；
* 变量值、审批载荷和工具结果；
* 可调用对象或任意插件配置；
* 原始会话和运行时实体标识。
导出标识会在单个文件内一致地匿名化。诊断文件的大小上限为 1 MiB。
结语¶
dsh-runtime-xray 提供了从运行时底座到模型输入的完整视图，帮助开发者在调试和排查问题时快速定位状态。若需了解更多或获取源码，可访问 DSH 生态目录 或 GitHub 仓库。
