11_08_Scratchpad

(八) Scratchpad 运行追踪与可观测性

cli/scratchpad.py 为每个 CLI（命令行）/ TUI（终端图形界面）turn（对话轮次）写一份 JSONL trace（逐行 JSON 运行轨迹）到 ~/.wyckoff/scratchpad/。

记录内容：

事件	字段
init	用户输入、session_id
thinking	模型 reasoning（推理内容）
tool_result	工具名、参数、结果、耗时、状态
compaction	压缩前后消息数
final	最终回复、token、耗时
error	异常信息

所有明显敏感字段会脱敏：api_key、token、password、secret、authorization、cookie。

Scratchpad（运行追踪文件）独立于 SQLite chat log（本地聊天日志）：即使中途崩溃、工具超时或长任务异常，也能留下足够证据复盘“模型为什么这样回答”。

---

---

返回 系列索引