用途:wuji-cli-logs 通过 wuji logs 命令管理 Wuji SDK、Studio、stderr 及 CLI 自身写入 ~/.wuji/logs/ 的本地日志,用于收集支持包和排查问题。
主要能力:子命令包括 wuji logs path(打印日志目录)、wuji logs list(按大小和日期列出日志)、wuji logs export(导出 ZIP 支持包)、wuji logs dump(收集设备端诊断快照与刷写历史,Wuji Hand 2)。导出默认包含 sdk、studio、stderr 日志及匹配日期范围的手部模型标定录制,并附带 host_snapshot.json、doctor_diagnosis.json、设备快照与 manifest.json;即使未找到日志也会包含快照和诊断。
使用方式:常用命令如 wuji logs list --days 7、wuji logs export --days 7、wuji logs export --source cli --days 1、wuji logs export --with-dump、wuji logs export -o /tmp/support-bundle.zip、wuji logs dump --sn <SN>。支持 --json、--jsonl 输出便于脚本处理。未指定 -o 时 ZIP 命名为 wuji-logs-{env_id}-{timestamp}.zip。
限制:凭据类信息始终脱敏;用户名、路径、主机名、SSID、IPv4、MAC 默认脱敏,仅内部构建可用 --no-redact 关闭。二进制 dump 与标定 .mcap 文件不脱敏,分享前需自行检查。退出码 0 表示成功,1 表示任一失败。日志目录不存在时仍会生成含快照和诊断的包。包超过 300 MB 会警告,可用 --days 缩小范围。各子命令加 --help 查看完整选项。