核心内容摘要
繁花似锦，情意绵长——“久久草视频”：定格温情，传承经典
轻松管理历史记录HeyGem结果分页与删除操作在使用 HeyGem 数字人视频生成系统进行批量创作时一个常被忽略却极其关键的环节是——生成结果的后续管理。
随着任务数量增加几十甚至上百个视频文件会陆续出现在“生成结果历史”区域。
此时若缺乏清晰的浏览路径和高效的清理机制不仅查找目标视频耗时费力磁盘空间也会迅速告急。
好消息是HeyGem 批量版 WebUI 已内置一套简洁、直观、零学习成本的历史记录管理系统。
它不依赖命令行或文件操作所有动作都在浏览器内完成真正实现“点一点就搞定”。
本文将聚焦你每天都会用到的两个高频操作——分页浏览与精准删除手把手带你掌握如何像整理相册一样轻松管理你的数字人视频成果。
为什么需要专门管理生成历史很多人第一次使用 HeyGem 批量模式后会惊讶于它的效率一段音频 十个视频模板 → 十条口型同步的数字人视频几分钟内全部生成完毕。
但紧接着就会遇到现实问题第57条视频是你上周测试用的临时样片现在想删掉却找不到在哪一页客户要确认第3批生成的3个版本但当前页面只显示最近12条翻页按钮灰着不动点击“清空列表”误删了整个视频源文件夹而历史结果还在页面上“幽灵般”存在……这些不是 Bug而是未理解界面设计逻辑导致的操作错位。
HeyGem 的历史记录区即“生成结果历史”并非简单罗列文件而是一个独立维护的状态容器它只记录每次成功生成的输出路径、缩略图、时间戳和状态标识与输入文件、中间缓存、日志完全解耦。
这意味着删除历史记录 ≠ 删除磁盘文件需手动清理outputs/目录分页加载 ≠ 懒加载全部数据实际每页仅请求12条元信息响应极快勾选操作 ≠ 全局生效必须显式点击“批量删除选中”才触发理清这三点你就掌握了整套管理逻辑的底层钥匙。
分页浏览三步定位任意一条历史结果HeyGem 默认每页展示12 条生成记录这个数值经过实测平衡了加载速度与屏幕信息密度。
当历史总数超过12条时“◀ 上一页”和“下一页 ▶”按钮自动激活。
但很多用户卡在第一步——根本没注意到按钮位置。
1 按钮位置与视觉提示请将视线移至“生成结果历史”区域的正下方居中位置你会看到一组低调但清晰的控件◀ 上一页 第 1 页 / 共 5 页 下一页 ▶“第 X 页 / 共 Y 页”是实时计算的Y 值 总记录数 ÷ 12向上取整例如 53 条 → 共 5 页按钮采用浅灰底色 蓝色文字悬停时背景微亮符合主流 WebUI 交互习惯当处于首页时“◀ 上一页”置灰不可点末页时“下一页 ▶”置灰小技巧无需逐页点击。
若你知道目标视频大概在第几批生成可快速估算页码。
例如你昨天跑了4轮批量任务每轮10个视频那么第3轮的结果大概率在第3页30 ÷ 12 ≈
5 → 第3页。
2 翻页时的真实行为解析每次点击翻页按钮HeyGem 并非刷新整个页面而是执行一次轻量级 AJAX 请求请求地址/api/history?page2size12返回数据纯 JSON 格式的12条记录元信息含id,filename,thumbnail_url,created_at,status前端仅替换缩略图区域内容保留右侧预览器状态和顶部标签页选择这意味着翻页过程无白屏、无等待感平均响应 300ms右侧视频预览器不会重置你可在翻页前先预览当前页某条视频再翻页继续看其他页的内容所有勾选状态复选框在翻页后自动清空——这是刻意设计避免跨页误操作
3 实战演示找回三天前的测试视频假设你在12月15日上传了一段测试音频test_voice.mp3生成了8个版本现在需要从中找出编号为test_
mp4的那条。
操作流程如下进入 HeyGem WebUI确保在“批量处理模式”标签页滚动到底部找到分页栏观察“共 X 页”中的 X 值假设为 7点击“下一页 ▶”两次跳转至第3页因测试任务较早大概率在中后段在第3页的12个缩略图中快速扫视文件名缩略图下方均有文字标签找到test_
mp4点击其缩略图 —— 右侧预览器立即播放该视频确认无误后勾选左侧复选框准备后续删除或下载整个过程不超过15秒无需记忆路径、无需打开终端、无需查日志。
删除操作单条清理与批量清除的精准控制HeyGem 提供两种删除方式分别对应不同场景需求。
它们共享同一套安全机制所有删除操作均需二次确认且不可撤销。
1 删除单个视频从预览到确认的一站式流程这是最常用的操作适用于确认某条结果质量不佳需剔除客户反馈某版本需返工先下线旧版测试完成后清理干扰项完整步骤带细节说明定位目标通过分页或直接滚动找到你要删除的视频缩略图点击缩略图此时右侧预览器开始播放该视频注意这只是播放不触发任何后台操作点击“ 删除当前视频”按钮该按钮位于预览器下方、下载按钮右侧图标为灰色垃圾桶弹出确认对话框标题“确认删除”正文“将永久删除视频 test_
mp4 及其缩略图。
此操作不可恢复。
”两个按钮“取消”默认焦点、“确定删除”需主动点击点击“确定删除”按钮变为蓝色高亮点击后立即执行视觉反馈该缩略图瞬间淡出消失页面顶部出现绿色提示条“ 已删除 1 个视频”分页信息自动更新如原为“第 3 页 / 共 5 页”删除后变为“第 3 页 / 共 4 页”关键提醒此操作仅删除 WebUI 中的历史记录条目对应的视频文件仍保留在服务器outputs/目录中。
若需彻底清理磁盘请登录服务器执行rm /root/workspace/heygem-webui/outputs/test_
mp
4
2 批量删除勾选执行安全又高效当你需要一次性清理多条记录如删除某次全量测试的所有产物批量删除比重复点击单删快3倍以上。
操作要点与避坑指南勾选方式每个缩略图左上角有一个方形复选框点击即可选中支持 Ctrl/Cmd 多选全选快捷键在当前页任意复选框上右键 → 选择“全选本页”Chrome/Firefox 支持删除触发勾选完成后点击页面底部的“ 批量删除选中”按钮注意不是顶部的单删按钮确认逻辑同样弹出对话框但正文会明确写出数量例如“将永久删除已选中的 7 个视频……”失败保护若某条视频正在被其他进程读取如你刚在右侧预览完系统会跳过该条并提示“ test_
mp4 正在使用中已跳过”场景推荐操作原因删除连续编号的3条如 01/02/03手动逐个勾选避免误选相邻非目标项删除当前页全部12条右键→“全选本页”比按住 Ctrl 点12次更可靠删除跨页的8条第2页5条第4页3条分两次操作先删第2页再翻页删第4页系统不支持跨页勾选这是有意为之的安全限制
高级技巧结合日志与文件系统实现闭环管理虽然 WebUI 内操作已足够便捷但在企业级使用中我们建议建立“界面操作 后台验证”的双重保障机制。
1 用日志反向验证删除是否生效每次删除操作HeyGem 都会在运行日志中留下明确痕迹。
你可以实时核对# 实时查看删除记录在新终端中执行 tail -f /root/workspace/运行实时日志.log | grep DELETE_HISTORY正常日志示例[
14:22:37] INFO DELETE_HISTORY: user deleted 1 item (id8827, filenametest_
mp
[
14:23:01] INFO DELETE_HISTORY: user deleted 7 items (ids[8819,8820,8821,8822,8823,8824,8825])若发现日志中无对应记录说明前端点击未成功提交常见于网络抖动或按钮未正确点击此时应重试。
2 安全清理磁盘删除文件前必做的三步检查WebUI 删除仅移除索引真正的空间释放需手动清理outputs/目录。
为防误删请严格遵循比对文件名进入/root/workspace/heygem-webui/outputs/列出所有文件ls -lt --time-stylelong-iso | head -20筛选待删项找出你刚在 WebUI 中删除的那些文件名如test_*.mp4执行删除使用rm -i交互式删除系统会逐个询问rm -i test_
mp4 test_
mp4 test_
mp4此方式确保你删的每一个文件都是 WebUI 历史中已确认删除的❌ 绝对禁止rm -rf outputs/*—— 这会清空所有成果包括尚未在 WebUI 中删除的正式交付物。
5.
常见问题与即时解决方案以下是用户在管理历史记录时最常遇到的5个问题附带开箱即用的解决方法。
1 问题分页按钮不显示或点击无反应可能原因与对策原因1历史记录总数 ≤ 12 条 → 无需分页按钮自动隐藏对策滚动到底部确认总条数若确实少于12条则属正常原因2浏览器禁用了 JavaScript 或广告拦截插件误杀对策换用 Chrome 无痕窗口访问http://localhost:7860关闭所有插件后重试原因3服务端返回空数据罕见对策检查日志是否有HISTORY_LOAD_ERROR关键词重启服务cd /root/workspace/heygem-webui bash restart_app.sh
2 问题勾选后点击“批量删除选中”没反应核心原因至少有一条被勾选的视频当前正被预览器占用即你刚点击过它的缩略图且预览器仍在播放。
即时解决点击右侧预览器右上角的 × 按钮关闭当前播放或点击任意其他缩略图让预览器切换到新视频再次点击“批量删除选中”——立即生效
3 问题删除后页面显示“第 1 页 / 共 0 页”但缩略图还在本质前端缓存未及时刷新属于视觉延迟。
强制刷新按CtrlF5Windows或CmdShiftRMac页面将重新拉取最新历史数据。
4 问题想恢复误删的历史记录❌ HeyGem不提供回收站或撤销功能所有删除均为永久性操作。
唯一补救方式若你未清理outputs/目录可手动重建记录将视频文件复制回inputs/videos/作为新模板重新上传同一段音频再次执行批量生成新生成的记录将拥有全新 ID但内容一致
5 问题批量删除后磁盘空间没变化这是完全正常的。
HeyGem 的“删除历史”只是从数据库/JSON 文件中移除索引视频文件物理上仍存在于outputs/目录。
正确做法按
2 节所述登录服务器手动清理对应文件。
6.
总结让历史管理成为你的创作加速器回顾全文HeyGem 的历史记录管理绝非一个简单的“删除按钮”而是一套经过深思熟虑的轻量化工作流设计分页机制让海量结果变得可感知、可预测、可定位把“大海捞针”变成“翻书找页”双模删除单删/批量覆盖从精细调整到粗粒度清理的所有场景兼顾精度与效率前端-日志-文件系统的三层联动既保证操作直观又提供后台验证能力满足个人开发者与团队协作的不同需求。
更重要的是这套设计始终遵循一个原则不增加认知负担。
你不需要记住命令、不必理解数据库结构、不用切换多个工具——所有操作都在同一个浏览器标签页内完成就像管理手机相册一样自然。
当你熟练掌握这些技巧后生成历史将不再是需要定期“打扫”的负担而成为你创作过程中的可信索引库每一次点击、每一次删除、每一次翻页都在帮你更快地抵达下一个高质量数字人视频。