前言¶
在 DeepSeek Harness (DSH) 的开发流程中，错误往往在运行时被吞没，或者难以追溯具体的用户输入与 AI 动作之间的关联。排查问题通常需要人工介入日志系统，效率较低。dsh-error-audit 插件解决了这个问题，它将报错和警告的上下文信息实时归档，并赋予 AI 自身读取和响应的能力。
这是什么¶
dsh-error-audit 是一个 DeepSeek Harness 实时 AI 自审插件。它负责在报错或警告发生的第一时间，连同时间戳、错误码、会话 ID、用户原话、AI 动作以及工作区信息写入日志目录，并主动通知 AI。插件还内置了 read_error_logs 工具，方便 AI 随时读取错误日志。
核心功能¶
- 实时记录：监听
agent/error、agent/request-error、tools/result等事件，错误发生时立即落盘并打印。 - 完整归因：记录数据不截断，包含时间、错误码、会话、工作区、用户原话和 AI 动作。
- 主动通知：error 级别错误会向出错会话注入提示（支持运行中注入和空闲唤醒）；warning 仅落盘。
- AI 可读：内置
read_error_logs工具，支持列表、过滤和读取单条报告。
安装与启用¶
- 执行安装命令：
dsh plugin --profile web add "github:166767/dsh-error-audit#main"
- 安装后需重启 dsh web 服务：
dsh web
- 验证安装是否生效：
dsh --profile web --dump-config | findstr error-audit
典型用法¶
插件安装后默认开箱即用。日志文件会写入 $DSH_HOME/error-audit/ 目录。AI 可以直接调用内置工具读取：
read_error_logs
配置（可选）¶
如果需要修改默认行为，可在对应配置文件中覆盖配置项。路径为 $DSH_HOME/profiles/<name>/cordis.patch.yml。
| 配置项 | 默认值 | 说明 |
|---|---|---|
logDir |
$DSH_HOME/error-audit |
日志目录，也可使用环境变量 DSH_ERROR_AUDIT_DIR |
notify |
true |
error 级错误是否主动通知 AI |
notifyMode |
auto |
通知模式：auto / inject / followup |
windowSize |
50 |
每条错误携带的最近会话事件数 |
适用场景与注意¶
- 适用场景：需要实时监控智能体运行状态、快速定位错误上下文的 DSH 开发者或管理员。
- 注意事项：插件以当前 DSH 进程的权限运行。安装前请检查源码与许可证。
结尾¶
该插件通过将错误日志结构化并赋予 AI 自读能力，降低了排查故障的门槛。项目地址与目录见下方。
