muse日志调试需分层控制：运行时、工具调用、任务执行层各具独立入口，支持配置文件、启动参数（如--loggerlevel debug）或api（如post /v1/debug/toggle）动态开启。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
开启 Muse 智能体日志和调试，核心不是调一个开关，而是分层控制：运行时环境层、工具调用层、任务执行层各有一套日志入口。它不依赖统一 UI 开关，而是通过配置文件、启动参数或 API 请求动态开启。
本地部署中启用详细日志
Muse Spark 1.3 默认只输出 WARN 及以上级别日志。要看到任务拆解、工具调用、异常重试等关键过程，需显式指定日志级别：
- 启动时加参数：
--loggerLevel DEBUG或--loggerLevel TRACE（TRACE 级别会记录每一步 DOM 观察、API 响应原始体、内存状态快照） - 日志输出路径可自定义：
--loggerFile muse-runtime.log，避免混入标准输出 - 若使用 Docker 部署，需在
docker run中挂载日志目录，并通过环境变量传参：-e LOGGER_LEVEL=DEBUG -e LOGGER_FILE=/var/log/muse/debug.log
Web 自动化场景下的界面操作日志
当 Muse 执行跨平台操作（如填表、抢票、订酒店），其观察引擎（Observation Engine）会实时解析页面结构。这部分日志默认关闭，需主动触发：
- 在浏览器扩展或移动端调试桥接器中，打开「开发者模式」后，长按右上角图标 3 秒，弹出「开启 UI 跟踪」选项
- 开启后，每次点击、输入、跳转都会生成结构化事件日志，包含控件 ID、坐标、可访问性标签（如
accessibilityID="submit-button"）、响应延迟毫秒数 - 该日志不写入磁盘，而是通过 WebSocket 推送到本地调试面板，适合快速定位“点不动”“找不到按钮”类问题
任务失败时的自动诊断日志
Muse 的异常处理机制会在任务中断时自动生成诊断包，无需手动开启：
- 只要配置了
failureReport: true（默认开启），任何子任务失败都会触发完整上下文快照：失败前 5 秒的多模态信号（如 EMG 同步延迟、页面加载耗时、模型 token 使用量）、调用链路图、回滚动作记录 - 诊断包默认压缩为
.muse-diag文件，存于~/.muse/logs/下，可用muse-cli diagnose --unpack xxx.muse-diag解析 - 不建议用文本编辑器直接打开——它含二进制内存映射段，必须用官方 CLI 工具解析才可读
远程服务调试：用 API 控制日志流
如果你把 Muse 部署为后端服务（如通过 FastAPI 封装的 Agent Runtime），可通过 HTTP 接口动态开关日志：
-
POST /v1/debug/toggle，请求体：{"level": "TRACE", "target": "tool_call"}—— 仅对工具调用模块升为 TRACE 级 -
GET /v1/debug/logstream?since=2026-09-23T19:30:00Z—— 流式获取指定时间后的日志，支持 SSE（Server-Sent Events） - 所有调试接口需携带
X-Muse-Debug-Key头，密钥在部署时由debug_key_gen工具生成，不随配置文件明文存储
