dsh-event-auditor

by qing3a

UI 增强github收录于 08-23

Harness 事件流审计面板：观察事件类型、分发模式、计数与最近事件，帮助插件作者理解 DeepSeek Harness 内部发生了什么。

安装

$ dsh plugin --profile web add github:qing3a/dsh-event-auditor

GitHub 源码安装：首次需按提示配置 allowBuilds 构建授权后重试

安装与环境配置指引、插件开发教程见 DSH 中文社区文档 ↗

安装即在你的机器上以你的权限运行第三方代码——它可读写文件、使用凭据、访问网络，DSH 的工具审批不会为插件代码加沙箱。「检测到 manifest」仅代表发现 dsh.bundle / dsh.plugin 清单，不构成兼容性或安全审查；安装前请审阅源码，不熟悉的插件先在不含密钥的环境试用。

Harness 事件流审计面板：观察事件类型、分发模式、计数与最近事件，帮助插件作者理解 DeepSeek Harness 内部发生了什么。

状态：✅ 已在本地 DSH 源码环境验证运行（2026-08-14）。v0.3：settings 热改 + headless dump + waterfall 运行时捕获实证（74 事件/12 waterfall 全部捕获，mock-llm 方案）。

功能

监听 22 个 harness emit 事件（agent 生命周期 / 会话 / 工具 / subagent / 配置）
v0.2：监听 10 个 waterfall 事件（tools/execute、approval/request、fs/write-intent、llm/stream 等，观察性透传 next()）
v0.3：settings 面板热改（installSettingsSection，实时开关分组无需重启）、headless dump（DSH_EVENT_AUDIT_DUMP）
按事件名与分发模式计数，环形缓冲保留最近 500 条
/audit 面板（纯静态页）+ /api/audit/events JSON 接口（支持 ?since= 增量）
分组开关（agent/session/tools/subagent/config/waterfall；config 默认关闭）

安装

# 生产安装（npm，agent 可直接执行）
dsh plugin --profile <profile> add @qing3a/dsh-event-auditor
dsh --profile <profile>
# 打开 http://localhost:<port>/audit

# 开发模式（需 Node >= 22 + pnpm）
git clone https://github.com/qing3a/dsh-event-auditor.git
cd dsh-event-auditor && pnpm install && pnpm build
cd <path-to-deepseek-harness>
dsh plugin --profile <profile> add link:$(pwd)/dsh-event-auditor

卸载

dsh plugin --profile <profile> remove @qing3a/dsh-event-auditor

配置

键	默认	说明
`enabled`	`true`	总开关
`bufferSize`	`500`	环形缓冲上限
`truncateAt`	`4096`	单条参数序列化上限（字节）
`groups.agent/session/tools/subagent`	`true`	分组开关
`groups.config`	`false`	配置类事件默认关闭
`groups.waterfall`	`true`	waterfall 事件观察（v0.2）

事件来源

事件清单与声明位置：docs/event-producer-consumer.zh.md（仓库生成内容）。 waterfall 事件（tools/execute、approval/request 等）v0.2 已启用，签名逐条从源码确认（next 均无参），观察性透传 next()。