百度一镜本地版可安全清理的目录为：tmp/（全清）、logs/（压缩30天前日志）、data/cache/（全清），需谨慎处理data/upload/、data/output/、models/（按加载状态或脚本清理）和runtime/dump/（删.hprof），严禁删除bin/、conf/、webui/及models/.index文件。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
想手动清理百度一镜数字人本地安装后的冗余文件，却找不到哪些目录能删、哪些删了会导致服务崩溃——这种情况常发生在完成首次直播测试或迁移服务器后，残留的缓存、日志、临时模型权重堆积在磁盘里，占用数十GB空间，但盲目删除又怕破坏运行环境。
确认安装路径与主目录结构
百度一镜本地部署版（非SaaS网页版）默认安装路径为 /opt/baidu-yijing/，该路径由安装脚本硬编码写入，不可通过环境变量覆盖。若使用自定义路径安装，需回查安装日志中 "Installation completed at:" 后面的实际路径。
进入该目录后，执行 ls -F 可见以下核心子目录：bin/ conf/ data/ logs/ models/ runtime/ tmp/ webui/。
调用百度PaddleOCR‑VL大模型API，支持PDF、Word、PPT、图片等多格式文档解析，精准识别印刷体、手写体、表格、公式、图表、印章等复杂元素，支持100+语言，可处理不规则布局和跨页长文档。触发词：文档解析、VLM解析、大模型OCR、PaddleOCR、多模态文档、手写识别、公式识别、复杂版面。
注意：不要删除 bin/、conf/、webui/ 三个目录中的任何文件，它们分别承载启动脚本、核心配置与前端资源，缺失任一将导致服务无法启动。
可安全清理的目录及操作步骤
第一步：清空 tmp/ 下全部内容
该目录仅存放单次推流生成的中间帧、音频切片、临时视频缓存，生命周期为单次直播会话，重启服务后自动重建。直接执行 rm -rf /opt/baidu-yijing/tmp/* 即可，无副作用。
第二步：归档并压缩 logs/ 中30天前的日志文件logs/ 默认保留7天滚动日志，但部分用户启用了全量日志开关（conf/logback-spring.xml 中 <maxHistory>365</maxHistory>），导致日志膨胀至数GB。执行：find /opt/baidu-yijing/logs -name "*.log" -mtime +30 -exec gzip {} \;
这一步必须先压缩再删原始文件，否则丢失调试线索；未压缩前严禁直接 rm *.log。
第三步：筛选性清理 data/cache/ 子目录data/ 是唯一需要谨慎操作的目录，其下含 cache/ upload/ output/ 三类子目录。
- cache/ 存放AI脚本生成中间态、语音合成缓存、口型对齐临时数据，可安全执行 rm -rf /opt/baidu-yijing/data/cache/*；
- upload/ 存放用户上传的真人视频（用于“一键克隆”）、商品图、背景素材，需人工判断是否保留；
- output/ 存放已导出的直播回放MP4、剪辑片段、封面图，若已备份至NAS或对象存储，可整删。
models/ 目录清理规则
方法一：只删未加载的模型权重包models/ 下每个子目录对应一个数字人形象或语音模型，命名格式为 avatar_zhangsan_v2/ 或 voice_xiaomei_202506/。执行 ps aux | grep "java.*yijing" 查看当前加载的模型ID（出现在 -Dmodel.id=xxx 参数中），仅删除未出现在该参数里的整个子目录。
方法二：用内置清理工具（推荐）
进入 bin/ 目录，运行：./cleanup-models.sh --dry-run 先预览将删哪些模型；
确认无误后执行：./cleanup-models.sh --keep-last 2 —— 保留每个类型最新2个版本，其余自动清除。
注意：models/ 下的 .index 文件不能单独删除，它记录模型元信息，缺失会导致服务启动时报 ModelMetaNotFoundException。
runtime/ 目录能否删？
不能删，但可以瘦身。runtime/ 是Java虚拟机运行时生成的JIT编译缓存、堆转储快照（.hprof）、线程堆栈日志。其中 runtime/dump/ 下的.hprof文件单个可达4–8GB，仅在OOM时生成，日常无用。可执行：find /opt/baidu-yijing/runtime/dump -name "*.hprof" -type f -delete
其他子目录如 jre/ lib/ 属于嵌入式JRE，删则服务立即瘫痪。
