DSH-Plugin: structural observability layer

前言¶

在 DeepSeek Harness (DSH) 环境中，了解模型实际做了什么通常依赖于模型对自身行为的自报告。这种方式容易产生偏差。该插件旨在提供一种结构化的观测层，通过记录平台实际捕获的工具/技能使用情况 (tools/result)、技能目录审计以及带健康/错误事件的 watchdog，替代模型自报告。

核心能力¶

该插件提供以下核心功能：

tools/result 监听器：平台将每一个真实的工具执行（名称 + 结果）记录到环缓冲区中，并生成按日聚合的数据。
agent/error / agent/status：提供错误总计和实时代理状态跟踪。
Watchdog：基于定时器的警报机制，当代理错误数量在 5 分钟内激增至阈值（≥ N）时触发。
浏览器仪表板：在客户端注册一个「觀測」视图标签页（位于聊天/轨迹右侧），渲染来自 infraView 会话投影的实时仪表板，包括回合计数、失败计数、工具/技能排行榜及最近执行记录。

提供的工具¶

该插件向模型和人类提供三个查询工具：

usage_report：提供按日的工具/技能聚合数据（调用次数 / 成功 / 错误）以及最近的执行记录。
audit_skills：提供技能目录总数、提供商分布、警告信息（如描述缺失、非 kebab 命名），以及今日技能使用情况。
infra_health：提供运行时间、保留记录数、错误计数、运行中的代理、目录大小和 watchdog 状态。

安装与启用¶

安装该插件需要将包添加到 DSH 的配置中。

方法 A：Host Composition（推荐）¶

在 package.json 的 dsh.profile.bundles 中添加包名。该包会自动注入插件行：

{
  "dsh": {
    "profile": {
      "bundles": ["@bryan-cmf/dsh-infra-observability"]
    }
  }
}

方法 B：Agent Preset Row¶

在 Agent 的预设配置中指定包名：

- id: infra-observability
  name: '@bryan-cmf/dsh-infra-observability'

注意事项与依赖¶

依赖要求：该插件需要 DSH 版本 >= 0.1.0-rc.6。
数据生命周期：聚合数据基于进程生命周期（与 dsh-skill-trail 一致）。
持久化计划：跨重启的持久化功能计划中。
配套包：@bryan-cmf/dsh-skill-trail 是配套的后端层，用于渲染每条回复的徽章行。
项目状态：此套件已于 2026-08-17 合并入 @bryan-cmf/dsh-insights，当前仓库仅保留合并前的历史记录，后续迭代请前往 dsh-insights。

生态背景¶

DSH 采用“一切皆插件”的理念。该插件可在技能目录中查找到：dsh-infra-observability。