Wuji CLI · 开发工具

日志导出

设备行为异常需要技术支持时，用 wuji logs export 把主机上的 Wuji 日志与诊断信息打包成一个 ZIP 支持包，直接发给支持人员。

导出并发送支持包

wuji logs export                     # 导出最近 1 天日志
wuji logs export --days 7            # 覆盖最近 7 天
wuji logs export -o support.zip      # 指定输出文件

默认在当前目录生成带时间戳的 wuji-logs-*.zip。把它连同问题描述——现象、发生时间、设备序列号——一起发给支持人员即可。

参数	说明
`--days <N>`	导出最近 N 天的日志，默认 1
`--source <来源>`	按来源筛选文本日志，可选 `sdk`、`studio`、`stderr`，逗号分隔，默认全部
`--with-dump`	附带 `device_*.bin` 设备通信 dump 文件（二进制原文）
`-o, --output <路径>`	输出文件路径

支持包内容包括：

文本日志：选定范围内的软件日志
主机与设备诊断：主机快照、健康诊断结果，以及设备诊断快照与 Flash 历史（按设备序列号区分）
手部模型标定录制：同一日期范围内的标定录制数据
manifest.json：本次导出的文件清单与摘要

以上内容都默认包含，不需要额外参数。

打包前自动对文本日志脱敏用户名、主机名等个人信息，设备序列号与固件版本保留，便于支持人员定位问题。--with-dump 附带的通信 dump 与设备侧诊断数据按原样打包。标定录制的 .mcap 是原始动作数据。

范围内没有日志文件时导出仍会完成，摘要显示 Logs: skipped (no log files exported)。设备诊断失败或未扫描到设备时，支持包照常生成，但命令返回退出码 1 并在摘要中标记失败项。

采集设备诊断快照

只需要设备侧的诊断数据、无需导出完整支持包时，用 wuji logs dump。命令当前支持 Wuji Hand 2，后续会扩展到更多设备类型。采集内容包括设备身份、故障与状态、母线电压与温度、通信诊断以及 Flash KV 历史：

wuji logs dump                       # 扫描并采集全部设备
wuji logs dump --sn <SN>             # 只采集指定设备
wuji logs dump -o /tmp/dump          # 指定输出目录

参数	说明
`--sn <SN>`	按序列号指定设备
`--address <地址>`	按地址指定设备
`--handedness <left\|right>`	按左右手指定设备
`-o, --output <目录>`	输出目录路径

每台设备产出 <sn>_<时间戳>_device.json（快照）与 <sn>_<时间戳>_flash.jsonl（Flash 历史）。单个字段采集失败不中断整体流程，失败原因记入快照的 failures 列表。任一设备失败、快照含字段采集失败或未生成 Flash 历史时，命令以退出码 1 结束。未扫描到任何设备时命令报错退出。扫描模式下遇到不支持 dump 的设备类型记为跳过，不计入失败，显式指定这类设备则记为失败。

查看日志目录

wuji logs path

显示日志目录路径，默认为 ~/.wuji/logs，SDK、Wuji Studio 等组件的运行日志都存放在该目录。

列出日志文件

wuji logs list                       # 列出全部日志文件
wuji logs list --days 7              # 只看最近 7 天
wuji logs list --source sdk,studio   # 按来源筛选

参数	说明
`--days <N>`	只列最近 N 天的日志，默认全部时间范围
`--source <来源>`	按来源筛选，取值同 `wuji logs export`

结构化输出

四个子命令都支持全局参数 --json（格式化 JSON）与 --jsonl（每行一条紧凑 JSON），便于脚本解析。