Repository navigation
Releases: Fourques/video-reviewer-tools
Release list
v2.0.12 · Windows 默认浏览器与独立窗口兼容修复
Windows 双击默认使用现代浏览器，解决独立窗口兼容问题
如果网页可以正常使用、独立窗口却纯黑，故障在独立窗口初始化/渲染这一层。仅凭截图不能断定具体是 GPU、缓存还是组件错误。Windows 新版双击后默认启动一个已安装的 Edge / Chrome / Firefox 窗口，直接使用已经验证可用的网页路径，不再依赖 WebView2。
- 保留免安装特性：无需配置 Python 或 FFmpeg。
- 原人工标签、规则、整理历史继续跟随原项目，不改视频、旧 CSV 或进度格式。
- 关闭最后一个审核页后约 8–12 秒释放服务；刷新不算关闭，整理任务会等待完成。只有显式
--keep-running才常驻。 - 可用
VideoReviewer.exe --desktop选择独立窗口；禁止旧 IE/MSHTML 内核静默降级。 - 可选独立窗口 25 秒内既未完成页面加载、也未建立页面连接时，会关闭失效窗口并回退浏览器。不误关慢目录扫描或已连接的页面。
- 未初始化窗口不再等待不存在的 JS 桥接才能关闭；回退时保留正在进行的项目准备工作。
- 项目中心/工作台检测旧内核和样式文件缺失，显示可读提示及内核诊断，而不是黑字深底、弹窗铺满页面。
- Windows CI 增加真实窗口内核、背景色、网格布局、弹窗、视频解码、保存标注和端口释放检查；同时测试默认浏览器模式与黑屏恢复。
更新方式
确认旧版显示已保存后退出，完整解压新版应用包到电脑本地，运行后重新选择原项目目录。保留原项目 output 和 .video-reviewer，不必重新标注。视频可以仍放在 NAS。
如需独立窗口，可自行安装微软官方 WebView2 Runtime。应用不会自动安装组件或修改默认浏览器；默认网页模式无需此组件。
macOS 与 Linux 保留原默认独立窗口方式。四平台最新包保持在固定本机/NAS packages 目录，不建立多套版本副本。
v2.0.11
v2.0.10 · 打开项目性能与进度体验优化
打开项目更快，等待过程更清楚
- 点击“开始标注”立即显示载入面板；目录验证移到后台，等待时仍可查询进度、复制诊断或退出。
- Windows 项目中心不再逐个访问映射盘，避免断开的网络盘拖慢界面。
- 视频扫描和当前目录 CSV 发现共用一次清单。已有记录按目录批量核对；旧输出目录每个只扫描一次，缺失文件不再逐个查询磁盘。
- 未变化的 CSV 匹配结果复用本机缓存；CSV、字段设置或视频清单变化自动重新匹配。缓存损坏或不可写时回退到正常读取，不改 CSV。
- 快照顺序读取显示 MB 进度；日志恢复、中断整理核验和各阶段耗时进入诊断信息。大快照写入改为顺序缓冲写入，保留刷新到磁盘与原子替换。
- 修正明确选择“不展示字段/不使用设备列”时重新扫描又恢复默认字段的问题。
更新与继续整理
先退出旧程序，完整解压对应系统的应用包，再选择原来的项目目录。保留原目录中的 .video-reviewer 和 output；无需重新标注。通过“整理历史 → 检查并继续整理”重新检查并处理未完成文件。此前 v2.0.7 的 Windows 长路径、短临时文件名、整理历史和失败重试修复均已保留。
缓存不保存人工标签；人工标签和整理记录始终跟随原项目。首次访问网络盘、首次匹配 CSV 或换电脑时仍需要实际读盘；CSV 阶段过慢可选“本次跳过 CSV，先审核视频”。
下载
- Windows 64 位：VideoReviewer-Windows-x64.zip
- macOS Apple Silicon：VideoReviewer-macOS-AppleSilicon.zip
- macOS Intel：VideoReviewer-macOS-Intel.zip
- Linux 64 位：VideoReviewer-Linux-x64.tar.gz
免配置运行，所有平台均经过自动回归与应用包自检；Linux 额外验证真实浏览器和独立窗口。大目录测试覆盖 12000 个视频记录、12000 个缺失记录、CSV 缓存失效/损坏、旧进度与整理重试。
VideoReviewer v2.0.7 · 整理历史与长路径修复
同事如何更新并继续之前的整理
- 先等待旧版正在运行的整理批次结束，保留原视频、已有 output 和
.video-reviewer，然后退出旧程序。 - 下载对应系统的包，完整解压后双击运行；不要混合新旧包内的文件。
- 选择之前同一个项目目录，原规则、人工标签和逐文件整理记录会继续保留。
- 点击顶部 整理历史 → 检查并继续整理 → 确认整理。按当前标签/输出规则处理失败和未完成项，已归位的移动文件跳过；无需重新审核。
- 等待最终结果，确认失败为 0。若仍有报错，查看原因或下载完整失败 JSON；不要靠删除旧成品或隐藏进度来重试。
本版优化
- 修复 Windows 长文件名整理临时路径过长：短随机临时名 + 原生 Windows 扩展路径，兼容本地盘和 UNC 网络盘，不要求改注册表。成品名称和整段字节不变。
- 整理窗口点击后立即显示；计划预览只读内存，不逐文件访问磁盘；确认复用计划，不再重复一遍 NAS 预检查，也不向浏览器传输成千上万条完整文件计划。
- 后台进度展示当前文件、校验/复制/发布/记录阶段、本阶段字节数、用时和等待提示；已处理不再混淆为已成功。
- 新增跟随项目保存的整理历史，最近 100 批汇总、失败原因、中断恢复和继续整理入口。旧版逐文件记录同样可查看，不清空旧标签，不新增导出 CSV。
- 单项失败继续后续文件；重试不覆盖外部同名冲突，不重复改写已归位视频。缺失原文件明确失败，整理期间禁止改标签/规则/刷新，防止归错目录。
- 长报错自动换行，状态页面只展示前 50 条，避免大量失败拖慢界面；可下载完整当前批次失败清单。
- 保留 SHA-256 内容校验、删除源文件前复核、独占发布不覆盖，以及区间零重编码保护。网络或磁盘阻塞仍可能等待，未以降低安全校验换取速度。
平台与验证
提供 Windows x64、macOS Apple Silicon、macOS Intel、Linux x64 四个独立包，内置 FFmpeg。Windows 需要系统 WebView2；Linux 原生应用需现代桌面环境。
本机通过 71 项 Python 回归（其中 Windows 专属项留给 Windows 构建机）、23 项播放/生命周期测试、真实浏览器和桌面窗口测试。GitHub Actions 在每个平台重新运行测试并自检应用；Windows 额外实测 >260 字符路径的导出、重开和 FFmpeg 读取。
这次发布不替同事实际整理数据；归档是否完成以同事原项目的最终成功/失败结果为准。界面显示已保存标签，不代表文件已经全部整理。
VideoReviewer 2.0.5 · 大目录与 CSV 启动优化
VideoReviewer 2.0.5 · 大目录与 CSV 启动优化
修复 Windows / NAS 大目录在扫描后长时间停留于计数界面的问题。12000 不是视频数量上限；旧版扫描后仍有真实路径查询、CSV 自动匹配和索引保存步骤，缺少及时的阶段提示。
- 复用目录枚举信息，不再对每个视频反复解析真实路径和检查存在性；CSV 查找先筛文件名，不逐个查询非 CSV 视频。
- 索引仅提交新增/变化项，未变化的清单不重复写整份日志。
- CSV 自动检测每候选最多采样 10000 行，在检查点使用约 8 秒总体预算；已保存映射直接复用，不重新尝试所有附近候选。手动选择和最终选中的 CSV 仍完整读取，避免漏掉后段数据与重复冲突。
- 启动时可点“本次跳过 CSV，先审核视频”；原 CSV 配置、审核标签与视频不变，进入后可在项目设置手动载入。
- 显示真实阶段、用时及距上次进展时间；20 秒无进展提供提示，可复制诊断信息、取消并退出。状态查询有超时重试，不会静默一直等待。
- 回归测试新增 12000 条目录、12000 条虚拟队列、CSV 采样、完整手选、中途跳过、保留旧进度与 HTTP 控制。
系统层阻塞的 NAS 读请求不保证在预算内返回；若仍很慢，请复制诊断信息提供当前阶段、CSV 名称与路径。自动采样可能找不到只出现在 CSV 后段的视频，此时可手动选择。跳过 CSV 不影响人工标注，但本次不会展示设备和原始对照字段。
更新：退出旧程序，完整解压与系统匹配的新版，打开原项目即可。不要混用新旧包内文件，也不要删除隐藏 .video-reviewer/ 进度目录。四个平台构建、回归与独立包自检通过后发布；Linux 额外验证真实浏览器与原生窗口。
VideoReviewer 2.0.4 · 通用视频标注工作台
VideoReviewer 2.0.4 · 通用视频标注工作台
把整段分类、旧分类复核和区间精选合并为一个项目、一套标签、一张工作台。视频本地处理，不上传云端。
本次升级
- 三个新项目模板：跌倒分类、区间精选、通用标注；已有项目始终恢复自己的配置。
- 自定义类别数量、名称、颜色、判定说明、输出位置和快捷键；可选辅助标签，规则支持模板导入导出。
- 可折叠、可调宽、虚拟化视频队列；搜索文件名、设备 ID、CSV 原始字段和备注，保存筛选视图。当前视频始终在队列中可见。
- 下一条预加载并继承播放、倍速、暂停、循环和静音状态；A/D 默认跳转 1 秒，长按支持循环。自动兼容预览和后台批量兼容。
- CSV 自动或手动匹配设备 ID，最多展示 3 个原始字段；CSV 只读，不新建导出 CSV。
- 标注、待复核和整理状态分离；没有片段不自动判为负类。支持新一轮复核、撤销、失败重试和断线恢复。
- 项目日志持久保存、冲突检查、单写入锁；自动迁入 v1 进度并保留原文件。
- 整理前查看计划，逐项失败不阻断后续；整段原名，移动/复制内容校验，同名不同内容不覆盖。修改输出位置后仍保留已知视频与审核记录。
- 本机独立应用窗口关闭时释放服务；未保存或整理任务中阻止误关。浏览器/远程模式保留刷新与短暂断线宽限，并提供明确退出按钮。
下载与更新
下载匹配系统的包，完整解压后双击程序：Windows x64、Linux x64、macOS Apple Silicon 或 macOS Intel。包内包含运行时与 FFmpeg，不用安装 Python。
先退出旧版，再完整解压新版并选择原数据目录。不要混用新旧包内文件。只替换程序不删除审核进度；迁移或备份数据时连同隐藏 .video-reviewer/ 一起保留。旧版 .fall_label_state*.json / .clip_reviewer_state.json 会迁入，原文件保留。项目外的旧输出请重新绑定对应目录。
标签提交只保存进度；点“整理文件”并确认后才移动、复制或截取。未审核与待复核不整理。
画质与兼容说明
- 整段输出保持原文件内容；区间用
-c copy，不重新编码，但任意帧精确切点与无重编码不能同时保证，实际时长可能偏离 8.000 秒。 - 兼容预览只改变本机缓存，最终输出读取原视频；Linux 独立窗口使用 VP9 预览。
- 倍速原生播放；20× 有跳段补足，会提示漏看风险。网络盘、首次转码及异常解码可能仍有等待。
- 应用尚未签名，系统可能提示安全确认。Windows 原生窗口需要 WebView2；Linux 包面向现代 x64 桌面（glibc 2.34+）。源码仍可用于服务器远程模式。
- 同一项目仅一个程序写入，不是多人实时协作系统。远程服务不得暴露公网。
验证
四个平台分别运行 Python 回归、播放/生命周期测试、独立包构建与包内资源/FFmpeg 自检。Linux 额外运行真实浏览器流程和原生窗口的视频解码、持久标注、关闭及端口释放测试；并非声称已人工操作每个平台的界面。
详细操作、数据恢复、远程使用和许可证见仓库 README 与 THIRD_PARTY_NOTICES。