HeyGem存储清理小贴士，定期释放磁盘空间更流畅-平芜编程栈

HeyGem存储清理小贴士，定期释放磁盘空间更流畅

在使用HeyGem 数字人视频生成系统进行批量或单个视频处理的过程中，随着任务的不断执行，系统会持续将输出结果保存至本地磁盘。虽然这为用户提供了便捷的下载与回溯能力，但长期积累的生成文件若未及时管理，极易导致磁盘空间耗尽，进而影响系统稳定性、降低处理速度，甚至引发任务失败。

本文将围绕HeyGem 系统的存储机制与清理策略，提供一套实用、安全、可操作性强的磁盘空间管理方案，帮助用户实现“轻装上阵”，保障系统长期高效运行。

1. 理解 HeyGem 的文件存储结构

在深入清理之前，首先需要明确系统中各类文件的存放路径及其作用，避免误删关键数据。

1.1 核心目录结构

HeyGem 系统的主要文件存储位于项目根目录下，典型路径如下：

/root/workspace/heygem-batch-webui/ ├── inputs/ # 用户上传的原始音视频文件 ├── outputs/ # 生成的数字人视频文件（主要清理目标） ├── models/ # AI模型文件（禁止删除！） ├── logs/ 或 运行实时日志.log # 系统运行日志 └── temp/ 或 cache/ # 临时处理缓存（可选择性清理）

关键说明：

outputs/是占用空间最大的目录，每生成一个视频都会在此创建.mp4文件。
inputs/存放用户上传的音频和视频素材，建议保留时间较短。
models/包含 Wav2Lip、FaceEnricher 等核心模型，总大小通常超过 1GB，绝对不可删除。
temp/目录用于中间帧提取、音频分离等临时操作，任务完成后可自动或手动清除。

重要提示：
删除任何文件前，请确认其用途。误删模型文件将导致系统无法启动，需重新下载恢复。

2. 清理策略设计：按场景分类处理

不同使用频率和业务需求下的用户，应采取差异化的清理策略。以下是三种典型场景及对应建议。

2.1 个人测试/开发用户

特点：频繁调试参数、生成大量测试片段，单次输出时长较短（<30秒），数量多。

推荐策略：每日清理 + 自动化脚本辅助

#!/bin/bash # clean_heygem_test_outputs.sh - 清理测试输出脚本 OUTPUT_DIR="/root/workspace/heygem-batch-webui/outputs" LOG_FILE="/root/workspace/运行实时日志.log" log() { echo "[$(date '+%Y-%m-%d %H:%M:%S')] $1" >> "$LOG_FILE" } if [ -d "$OUTPUT_DIR" ]; then find "$OUTPUT_DIR" -type f -name "*.mp4" -mtime +0 -exec rm {} \; log "INFO: Test outputs older than 1 day have been cleaned." else log "ERROR: Output directory not found at $OUTPUT_DIR" fi

执行方式：

chmod +x clean_heygem_test_outputs.sh ./clean_heygem_test_outputs.sh

补充建议： - 将该脚本加入crontab实现每日自动执行：bash crontab -e # 添加以下行（每天凌晨2点执行） 0 2 * * * /root/workspace/clean_heygem_test_outputs.sh

2.2 中小型企业生产用户

特点：每日有固定数量的任务产出，部分视频需归档保存用于客户交付或审核。

推荐策略：分层归档 + 定期人工审核

分层存储建议：

类型	保存位置	保留周期	备注
待审核视频	`outputs/pending_review/`	7天	每日同步至NAS或云盘
已交付成品	`archive/delivered/`	永久（按需）	外部存储
临时中间件	`temp/`	≤1天	可自动清理

操作流程：

在outputs/下建立子目录分类管理；
每日指定人员登录 Web UI 预览并筛选有效成果；
使用mv命令迁移重要文件至外部归档路径；
对非必要文件执行批量删除。

# 示例：移动昨日生成的重要视频 find /root/workspace/heygem-batch-webui/outputs -name "*.mp4" -mtime -1 | \ grep "final_version" | \ xargs -I {} mv {} /mnt/nas/heygem_archive/

2.3 高频批量处理用户（如教育机构、MCN公司）

特点：每日处理上百个任务，磁盘压力大，对自动化程度要求高。

推荐策略：定时打包 + 外部备份 + 空间监控告警

自动化脚本示例：

#!/bin/bash # auto_backup_and_clean.sh TIMESTAMP=$(date +"%Y%m%d") BACKUP_DIR="/mnt/nas/heygem_backups/$TIMESTAMP" OUTPUT_DIR="/root/workspace/heygem-batch-webui/outputs" ZIP_FILE="/tmp/heygem_daily_$TIMESTAMP.zip" mkdir -p "$BACKUP_DIR" # 打包当天所有输出 find "$OUTPUT_DIR" -name "*.mp4" -mtime -1 -print0 | zip -qj "$ZIP_FILE" -@ # 上传到远程存储（示例使用scp） scp "$ZIP_FILE" backup_user@nas-server:"$BACKUP_DIR/" if [ $? -eq 0 ]; then rm -f "$ZIP_FILE" > "$OUTPUT_DIR"/* # 清空目录内容 echo "[$(date)] Backup completed and local files cleared." >> /root/workspace/运行实时日志.log else echo "[$(date)] ERROR: Failed to upload backup." >> /root/workspace/运行实时日志.log fi

优势： - 实现“一键归档+清理”； - 支持断点续传与完整性校验（可扩展添加md5sum）； - 减少人为遗漏风险。

3. Web UI 内置功能的高效利用

HeyGem 的 Web 界面已集成部分文件管理能力，合理使用可减少命令行操作负担。

3.1 批量下载与删除历史记录

在“批量处理模式”的生成结果历史区域，支持以下操作：

✅一键打包下载：点击“📦 一键打包下载”按钮，系统自动生成 ZIP 并提供下载链接；
✅批量删除选中：勾选多个缩略图后，点击“🗑️ 批量删除选中”即可移除；
✅分页管理：通过“◀ 上一页”和“下一页 ▶”翻阅历史任务。

技巧：
若需保留某些视频，请先完成下载再执行删除，防止误操作丢失数据。

3.2 日常维护建议

操作	频率	说明
下载重要成果	每日	避免仅依赖本地存储
清理过期任务	每周	删除超过7天的历史记录
检查磁盘使用	每日	使用`df -h`查看`/root`分区
清理浏览器缓存	每月	特别是 Chrome 的 IndexedDB 数据