dsh-agent-run-logger

Agent Run Logger

中文 | English

Agent Run Logger 是一个 DeepSeek Harness 插件，为每个正在运行的 Session 写入一份精简的本地 JSONL trace。它把底层 Session 事件整理成 run、step、模型和工具的计时记录，比直接阅读完整会话日志更方便。

默认情况下，每个 Session 分别写入 <session cwd>/.dsh/traces/。记录会在 Agent 运行期间持续追加；同一 Session 内严格保持源事件顺序，不同 Session 的写入队列相互独立，可以并行落盘。

默认只记录元数据、标识符、耗时、结果状态和 token 用量，不记录提示词、回复、工具参数或工具结果。设置 includeContent: true 后才会记录这些内容。每项内容默认最多保留 64 KiB；超限 JSON 会转换为 UTF-8 安全的头尾预览，原始 Session 日志不会被修改。

事件处理不会等待磁盘 I/O。每个 Session 默认拥有上限为 4 MiB 的独立队列。队列满时会丢弃新 trace 记录，并在之后通过 trace.gap 记录报告缺失的源事件序号范围。目录创建、写入或同步失败时，插件只警告一次并停用对应 Session 的 writer，不会影响 Agent 和其他 Session。

从 tarball 安装

构建并打包插件，然后把生成的压缩包安装到一个 profile：

```sh
pnpm install
pnpm pack
dsh plugin --profile trace-demo add ./dsh-agent-run-logger-0.1.0.tgz
dsh --profile trace-demo -