用途：在本地实时调试 LiveKit 智能体。lk agent debugger 会把智能体作为后台进程在本地运行，由你扮演用户逐轮推进对话，并检查每一轮之间智能体做了什么。
主要能力：逐轮发送用户话语并打印智能体的完整响应，包括带参数和结果的工具调用、交接、错误和最终回复；可查看智能体的聊天历史、实时事件流、进程日志和状态。默认文本模式关闭语音，不经过 LiveKit 房间，速度较快；排查音频链路问题时可用音频模式，通过 LiveKit Inference TTS 把每轮 say 读入智能体麦克风输入，走完整音频管线，并显示智能体听到的转写文本，便于与发送文本对照。
用法：首次使用前先确认命令存在并阅读帮助：lk agent debugger --help。该帮助是子命令和参数的事实来源。基本循环为 lk agent debugger start、lk agent debugger say "..."、lk agent debugger stop。每次修改代码后必须重启会话，否则仍在运行旧代码。可穿插日志，在对应轮次下显示智能体日志行，快速定位症状到原因。可用聊天历史核对 LLM 实际看到的上下文。修复前先复现，保留触发问题的 say 序列以便前后对比。
适用场景：交互式发现智能体缺陷，尤其是多轮才暴露的问题，如早期收集的细节丢失、用户中途改变主意、交接丢上下文。音频模式适合听错、STT 转写、数字读法、提前结束回合等与听觉相关的问题，以及只能跑音频的实时语音模型。
限制：若命令缺失说明 CLI 版本过旧，需更新 lk，在此之前使用 testing-livekit-agents。音频模式需要 LiveKit Cloud 项目凭据，文本模式不需要；模式属于会话，stop 后再 start 才能切换。音频模式下长静默可能提前结束回合，剩余回复会出现在下一轮，且无法打断智能体回复，也不能判断智能体听起来的音色，这些应使用 lk agent console 或音频模拟。需要真人试听用 lk agent console；同一失败反复出现应写回归测试；需要规模化评估整段对话用模拟；打断或跨对话语音行为评估用音频模拟。