> ## Documentation Index
> Fetch the complete documentation index at: https://docs.wuji.tech/llms.txt
> Use this file to discover all available pages before exploring further.

# 设备日志

在[数据可视化](/docs/wuji-studio/visualization)页面，点击右上角的 **Show bottom bar** 图标 <svg width="1.2em" height="1.2em" viewBox="0 0 16 16" fill="currentColor" style={{verticalAlign: 'middle', display: 'inline'}}><path d="M12.5 1H3.5C2.122 1 1 2.121 1 3.5V12.5C1 13.879 2.122 15 3.5 15H12.5C13.878 15 15 13.879 15 12.5V3.5C15 2.121 13.878 1 12.5 1ZM14 12.5C14 13.327 13.327 14 12.5 14H3.5C2.673 14 2 13.327 2 12.5V11H14V12.5ZM14 10H2V3.5C2 2.673 2.673 2 3.5 2H12.5C13.327 2 14 2.673 14 3.5V10Z" /></svg> 展开 Bottom bar，切换到 **DEVICE LOG** tab，即可实时查看来自设备和软件的日志信息，帮助排查问题。

<img src="https://mintcdn.com/wuji-0bbde051/Q08CII5VOvpQDcUt/assets/source/images/zh/wuji-studio/logs.png?fit=max&auto=format&n=Q08CII5VOvpQDcUt&q=85&s=c3b5a859d5895eb3efebc5ed03a16ae7" alt="日志面板" width="1438" height="898" data-path="assets/source/images/zh/wuji-studio/logs.png" />

## 工具栏

| 控件 | 功能 |
| - | - |
| Filter logs | 关键字搜索，覆盖消息内容、等级、来源和设备名称。面板底部显示已过滤条目数和总条目数（如 "42 / 100 entries"） |
| Log Level | 按等级筛选，显示所选等级及以上的日志：<ul><li>**TRACE**：最详细的追踪信息</li><li>**DEBUG**：调试信息</li><li>**INFO**：常规运行信息（默认）</li><li>**WARN**：警告信息</li><li>**ERROR**：错误信息</li></ul> |
| Source | 多选筛选日志来源：<ul><li>**Device**：设备端固件运行日志（默认启用）</li><li>**SDK**：Wuji SDK 的运行日志（默认禁用）</li><li>**Studio**：Wuji Studio 应用自身的日志（默认禁用）</li></ul> |
| Auto-scroll | 开启后新日志到达时自动滚动到底部，关闭后可自由浏览历史日志 |
| Clear | 清除当前所有日志条目 |

## 本地日志文件

日志面板暂不提供导出按钮。所有日志会持久化到本地目录 `~/.wuji/logs/`，按天滚动写入：

| 文件 | 内容与用途 |
| - | - |
| <code style={{whiteSpace: 'nowrap'}}>studio\_YYYY-MM-DD.log</code> | Studio 应用、SDK 与设备的运行日志合并文件，与日志面板显示的内容完全一致。日志面板里 Device/SDK/Studio 三个来源的消息最终都写入这里。排查软件运行、设备连接或 SDK 调用问题时分享此文件 |
| <code style={{whiteSpace: 'nowrap'}}>sdk\_YYYY-MM-DD.log</code> | Wuji SDK 自身的运行日志。在 Studio 中使用时，SDK 内容也会合并到 `studio_*.log`。独立运行 SDK（如 Python 包脚本）而未启动 Studio 时，此文件是 SDK 日志的唯一来源 |
| <code style={{whiteSpace: 'nowrap'}}>device\_YYYY-MM-DD.bin</code> | 设备与上位机之间的原始通信数据 dump，二进制格式，不可直接阅读。需要回溯协议帧、定位通信异常时使用 |
| <code style={{whiteSpace: 'nowrap'}}>stderr\_YYYY-MM-DD.log</code> | 进程的标准错误输出，捕获程序崩溃信息（panic）和第三方库写入的错误信息。文件通常较小，仅在出现崩溃或底层异常时才有内容 |

<Info>
  设备未产生日志时，面板显示"Waiting for log messages..."等待状态。确保设备已连接并正常运行。
</Info>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.