Plugin directory / UI & Skins / dsh-event-auditor
dsh-event-auditor
Verified · install-tested on dsh qing3a
What it does
dsh-event-auditor — DSH plugin (ui)
Works — verified, early-stage project
dsh-event-auditor — DSH plugin (ui) It installs cleanly and boots without issues in our testing. It's early-stage but functional.
“Verified” means our automated CI actually ran dsh plugin add in a clean profile and it booted — nothing more. Feature descriptions and version compatibility are the author’s claims. This is not a security audit and not an endorsement of third-party code.
README
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/eventsJSON 接口（支持?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()。
许可
MIT
Install
Install the catalog once, then DeepSeek Harness can find and install any plugin from this site automatically:
dsh plugin add dshbase-catalogThen say "install dsh-event-auditor for me" — your agent finds it in the directory and installs it. Docs: dshbase-catalog · verified packs.
This plugin is GitHub source (not published to npm) — install it straight from the repo:
Web profile:
dsh plugin --profile web add github:qing3a/dsh-event-auditorHeadless (CLI) profile:
dsh plugin --profile headless add github:qing3a/dsh-event-auditorTest report
Verified: L1 install + L2 load + L3 runtime from GitHub source on dsh 0.1.0-rc.6.
When to use it
Change how dsh looks or how you interact with it — a theme, a skin, or a new panel that reshapes the workspace.
Who it's for
Users who spend hours in the web UI and want it to look and feel the way they work.
For developers — extending it
Skins, panels, and theme tokens are the extension points — author a new skin, add a panel, or sync tokens with an upstream palette.
Share this badge
Drop this badge into your README — it links back here and updates automatically when our test status changes:
[](https://dshbase.com/plugins/dsh-event-auditor/)<a href="https://dshbase.com/plugins/dsh-event-auditor/"><img src="https://dshbase.com/badges/dsh-event-auditor.svg" alt="dshbase install-tested"></a>