CMDC.Plugin.Builtin.EventLogger (cmdc v0.4.0)

Copy Markdown View Source

P0 事件日志插件 — 将 Agent Pipeline 事件以 JSON Lines 格式追加写入日志文件。

日志格式

每条日志是一个 JSON 对象（JSON Lines），包含：

{
  "ts": "2026-03-21T10:00:00.000Z",
  "session": "abc123",
  "event": "before_tool",
  "data": {"tool": "shell", "args": {"command": "mix test"}},
  "level": "info",
  "turn": 1
}

日志文件路径

默认写入 {working_dir}/.cmdc/logs/{session_id}.jsonl。 可通过 :log_dir 选项覆盖目录，:log_file 直接指定完整路径。

配置

{CMDC.Plugin.Builtin.EventLogger,
  level: :info,       # :debug | :info | :warn
  log_dir: nil,       # 覆盖日志目录
  log_file: nil,      # 直接指定日志文件路径（优先于 log_dir）
  include_args: true  # 是否记录工具调用参数
}