cursor-debug-log

name	cursor-debug-log
description	当需要调查 Cursor 本地模式 debug/log 证据时使用：config.yaml 的 log 热加载、history/<conversationId>/debug JSONL 文件、Bidi 原始/解码记录、RunSSE 记录、runtime/provider debug 记录、debug 文件缺失原因，或解释这些 debug 文件如何生成与如何查询。

Cursor Debug Log

使用这个技能来解释和检查本地 debug log 体系。目标是在不修改已安装 Cursor 客户端、不依赖旧版 legacy artifact 的前提下，还原一次请求附近发生了什么。

作用定位

debug log 是本地模式请求链路的可选证据层。它和模型可见历史是分开的：

• 用来回答“客户端到底发了什么”。
• 用来回答“后端解码后认为这是什么请求”。
• 用来回答“哪些字段被挂到了当前 active request 上”。
• 用来回答“最终 provider request body 是什么样”。
• 用来回答“RunSSE 实际给客户端发送了什么”。
• 不要把它当成 replay history、prompt 输入或状态事实源。

稳定事实源仍然是：

• history/<conversationId>/state.json
• history/<conversationId>/context.json
• history/usage.json
• logs/app.log

debug 文件是在这些事实源之外，补充原始或近原始链路证据。

固定路径

• 助手根目录：~/.cursor-local-assistant-v2
• 配置文件：~/.cursor-local-assistant-v2/config.yaml
• history 根目录：~/.cursor-local-assistant-v2/history
• app 日志：~/.cursor-local-assistant-v2/logs/app.log
• 会话 debug 目录：history/<conversationId>/debug/
• 孤儿 debug 目录：history/_debug/orphan/<requestId>/

通过配置开启 debug logging：

log: true

当前实现会用轻量文件快照检查热加载 config.yaml。改完 log 后，预留大约 500ms，再期待下一次请求事件使用新值。旧二进制可能仍然需要重启。

文件如何生成

debug 层随着请求穿过后端边界逐步落盘：

1. BidiAppend 收到客户端上行数据。