DeepSeek Harness plugin

dsh-event-auditor

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

Jump to install

Source facts

Repository
qing3a/dsh-event-auditor
Latest update
Aug 14, 2026
Category
UI Enhancements
GitHub stars
1
Format
plugin
Catalog evidence
Upstream dsh.bundle evidence
Evidence path
package.json#dsh.bundle
Checked against
0.1.0-rc.8
Upstream check date
2026-08-20

This evidence comes from the upstream catalog. This site has not installed, run, or security-reviewed the plugin.

Install

Start with a prompt that asks an agent to review the GitHub repository and source. Switch to the command if you want to install it yourself.

Copy this prompt into DSH, Codex, or another agent and ask it to review the GitHub repository and source first.

Do not install or run any commands yet. Read this plugin's GitHub repository, README, and relevant source code. Then answer the questions below clearly and directly so I can decide whether it fits my needs:

1. What is this plugin, and what problem does it solve?
2. Who is it for, and what are its typical use cases?
3. How is it used after installation? Include one minimal example.
4. What known limitations or privacy, security, compatibility, or maintenance risks does it have?
5. Give a clear recommendation: recommend, conditionally recommend, or do not recommend, with reasons.

Distinguish statements documented by the repository, inferences from source code, and unknowns. If evidence is insufficient, say so explicitly. Do not guess or simply repeat the README.

GitHub: https://github.com/qing3a/dsh-event-auditor
Plugin: dsh-event-auditor
Author: qing3a

Check the source files

Read the README and other files from this plugin directory before installing.

File explorer3 files
README.mdSource · read only

dsh-event-auditor

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

配置

默认说明
enabledtrue总开关
bufferSize500环形缓冲上限
truncateAt4096单条参数序列化上限(字节)
groups.agent/session/tools/subagenttrue分组开关
groups.configfalse配置类事件默认关闭
groups.waterfalltruewaterfall 事件观察(v0.2)

事件来源

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

许可

MIT