QuickRec Lite v0.1

QuickRec Lite v0.1 发布说明

发布日期：2026-08-12

状态：正式发布

版本定位

QuickRec Lite v0.1 是 Lite 产品线的身份隔离与稳定性收口版本。它不增加录制模式，而是让 Lite 能够与 Full 同机运行，并将已验证的配置、音频、捕获和发布工程能力带回 Lite。

主要变化

独立产品身份

• 可执行文件和进程改为 QuickRec-Lite.exe。
• 产品 ID、单实例、APPDATA、临时目录、默认视频目录、开机启动项、托盘和通知全部使用 Lite 独立身份。
• Full 与 Lite 可以同时运行，互不覆盖配置与数据。

安全配置迁移

• 首次启动可选择导入旧配置、使用 Lite 默认设置或取消启动。
• 只复制保存路径与音频模式；快捷键、开机启动和未知字段不迁移。
• 旧配置只读，不移动、不删除、不覆盖。
• 配置使用同目录临时文件、刷新、fsync 和原子替换；失败时回滚内存与开机启动状态。

录制稳定性

• 默认系统声音设备按设备 ID 优先匹配。
• 双音频使用立体声 amix，并按共同起点对齐。
• 静态桌面保留最后有效帧，不生成零帧视频。
• 停止操作采用非阻塞请求和有限等待。
• 固定 60 FPS 帧调度与磁盘估算保持一致。

Lite 边界收口

• 区域、窗口、倒计时和点击高亮专属运行模块已退出 Lite 源码与打包图。
• 用户可见范围仍只有全屏录制和四种音频模式。
• 不加入 Full 的工作台、素材库、项目、时间线、剪辑、导出队列和诊断中心。

发布工程

• 固定 Python 依赖和 FFmpeg 8.0.1 来源、版本与 SHA256。
• 新增 release manifest，记录版本、构建环境、依赖、EXE、FFmpeg、ZIP 和包体积。
• CI 独立覆盖 lite-master、lite-test、Pull Request 和 lite-v* Packaging smoke。

验证状态

• 自动化测试、覆盖率、Ruff、Mypy、Compileall、Packaging：通过。
• Full/Lite 同机运行、单实例、迁移、配置事务、静态桌面、快速停止和连续录制：通过。
• 无声和系统声音候选包录制：通过。
• 麦克风与双音频真实候选包录制：通过。

正式发布资产包含 QuickRec-Lite-v0.1-win-x64.zip 与 release-manifest.json。

已知限制

• 仅支持单显示器全屏录制。
• 固定原生分辨率与 60 FPS，不提供 30/60 选择或 120 FPS。
• 展开包约 257.88 MB；体积不是 v0.1 发布阻断项。
• 不提供用户可见诊断中心。

回滚

• 代码回滚点：lite-v0 tag，固定指向 c15940e。
• v0.1 配置保存在 %APPDATA%\QuickRec-Lite，回滚不会反向写入 Full 配置。
• v0.1 录制文件不会随回滚删除。

QuickRec Full v1.9.5

QuickRec Full v1.9.5 发布说明

当前状态：正式发布

发布日期：2026-07-31

当前正式版本：v1.9.5

版本定位

v1.9.5 在 v1.9.4 正式本地导出闭环上增强剪辑交互和轨道控制。用户可以用
统一快捷键和帧级时间基准编辑时间线，安全解绑或重新关联音视频，并通过带
吸附、落点预览和条件性自动建轨的拖放流程安排素材。

本版不改变最高视频轨全画面覆盖、最多 8 路音频混合、timeline schema v2
和持久导出队列的正式语义，也不引入自由画布、关键帧、代理媒体或新编码器。

主要变化

统一快捷键与焦点规则

• Space 在剪辑时间线焦点下播放或暂停。
• 左右键逐帧导航，Shift+左右 精确移动一秒。
• Ctrl+B 分割片段，Delete 普通删除并保留空隙，
  Shift+Delete 执行全局波纹删除。
• Ctrl+L 根据当前片段状态执行解绑或打开严格重新关联候选。
• Ctrl+Z、Ctrl+Y、Esc 与工具栏、菜单使用同一语义命令。
• 输入框、按钮、列表、菜单和模态弹窗保留 Qt 原生按键行为，避免快捷键误触。

音视频解绑与轨道控制

• 合法的一视频一音频关联组可以原子解绑。
• 解绑不改变 clip_id、material_id、轨道、时间位置、源范围和未知扩展。
• 解绑后视频和音频可独立选择、移动、裁剪、分割和删除。
• 严格重新关联只接受同素材、同时间、同源范围且双方未关联的异类片段。
• 重新关联生成新的 link_group_id，失败或保存失败不会留下半成功状态。
• 普通删除和全局波纹删除具有独立入口、影响摘要和撤销记录。

智能拖放与条件性自动建轨

• 素材拖动期间展示候选时间、目标轨、帧级吸附来源、关联音频落点和冲突原因。
• 吸附候选包含播放头、片段边缘和帧网格；按住 Alt 只关闭本次吸附。
• 优先复用未锁定、类型兼容且无冲突的已有轨道。
• 所有兼容轨冲突或不存在可用轨道时，才在 8 条视频轨或 8 条音频轨上限内
  条件性自动建轨。
• 带内嵌音频的视频一次创建关联双片段；独立音频只进入音频轨。
• 自动轨和片段通过一次项目保存、一个历史项提交；取消或保存失败不留下空轨。

帧级编辑

• 项目使用 30、60 或 120 FPS 的独立编辑基准。
• 新项目继承有效录制 FPS；旧项目按稳定视频证据推导，无法推导时使用 30 FPS。
• 支持 HH:MM:SS:FF 和总帧号输入、显示、跳转及标尺刻度。
• 底层继续保存整数微秒，帧换算使用统一有理数和最近帧规则。
• 已有片段后编辑 FPS 锁定，避免时间线边界被重新解释。
• 项目根 schema 仍为 v1，timeline schema 仍为 v2；编辑配置保存在版本化扩展中。

三项稳定性治理

• 录制工具栏跟随实际录制屏幕，位于该屏幕中上安全区。
• 成功、取消和中断导出会清理可由 job_id 与 attempt_id 精确归属的
  .part.mp4 和 .filter.txt。
• 活跃任务、提交事务、相似文件名、未知文件和用户文件不会被清理。
• CLI 的项目和时间线校验增加编辑 FPS、锁定状态及关联统计。

验证状态

• 标准全量测试：1425 passed, 32 deselected, 72 subtests passed。
• Packaging：20 passed, 1437 deselected。
• 总体覆盖率：84.14%。
• v1.9.5 领域核心增量覆盖率：95.24%。
• v1.9.5 UI 协调增量覆盖率：97.75%。
• Ruff、83 个源文件 Mypy、Compileall、UTF-8 和 git diff --check 通过。
• 高保真原型 239 个交互合同及 1440×900、1216×760、960×640 视口通过。
• frozen GUI/CLI、FFmpeg、FFprobe、PyAV、editing smoke 和 export smoke 通过。
• 全屏、区域、窗口录制及工具栏目标屏幕定位通过。
• 原生 Qt 拖放、8+8 轨、100 片段、30 分钟、50 步历史和长路径通过。
• 100%、125%、150% Windows DPI 及 960×640 工作台通过。
• 导出取消和真实启动中断恢复清理通过。
• D9 验收 31/31 全部通过；GS03 麦克风口述和双音频中的系统测试音+口述
  均完成真实听音，四类音频链路全部闭合。

发布资产：

目录: E:\QRtest\QuickRec-v1.9.5-rc3-dist\QuickRec
GUI: E:\QRtest\QuickRec-v1.9.5-rc3-dist\QuickRec\QuickRec.exe
GUI SHA256: 705B227FE33F31D4EE650334D607CAAA919FC3D1B44C633CEA1E5B75B3B4A226
CLI: E:\QRtest\QuickRec-v1.9.5-rc3-dist\QuickRec\QuickRecCLI.exe
CLI SHA256: 1133802A8BB999B7CE198BB9EBF3F4F9D7C8160C9C9798C0248E28F940F0E386
FFmpeg SHA256: 5AF82A0D4FE2B9EAE211B967332EA97EDFC51C6B328CA35B827E73EAC560DC0D
FFprobe SHA256: 192A1D6899059765AC8C39764FC3148D4E6049955956DC2029F81F4BD6A8972D
ZIP: E:\QRtest\QuickRec-v1.9.5-win-x64.zip
ZIP SHA256: 0B4F90B0202B2F0296B463BFF196B04E7C0BCA6709A245037E390AC1B7185D59

完整证据见 manual-verification.md 和
verification.md。PRD 逐条追溯见
acceptance-matrix.md。

跨版本编辑警告

v1.9.5 项目与 v1.9.4 及更早版本不保证向下编辑兼容。旧版本可能能够读取
项目，但会忽略项目编辑帧率、帧级吸附、解绑/重新关联及新的删除交互。
不要在多个版本间反复打开并保存同一生产项目；跨版本操作前请备份
.qrproj 和 .bak。

这不表示旧版本一定无法打开项目。项目根 schema 和 timeline schema 没有升级，
未知扩展也会尽力往返保留；但“能够读取”不等于能够正确理解并继续编辑
v1.9.5 的全部语义。

已知限制

• 项目编辑 FPS 只支持 30、60、120，已有片段后不可修改。
• 自动建轨仍受视频轨和音频轨分别最多 8 条限制。
• 重新关联只支持严格同素材、同时间、同源范围候选，不提供自由同步偏移。
• 多视频同时有效时仍由最高视频轨全画面覆盖，不提供分屏、画中画、位置、
  缩放、旋转、透明度或关键帧。
• 本版不包含代理媒体、波形、高级音频控制、新编码器、AI、云同步或
  QuickRec Lite 改动。

回滚

• 代码和发布包回滚点：tag v1.9.4 /
  b3b8267e1950b8e2b9efc6d28d29b501189fd7af，不得移动或重写。
• 回滚前关闭 QuickRec、QuickRecCLI、FFmpeg 和 FFprobe。
• 保留项目、.bak、素材、首帧缓存、中央索引、导出队列、视频和已完成导出。
• 已经使用 v1.9.5 编辑的项目，优先使用升级前备份在 v1.9.4 中继续编辑。
• v1.9.4 能保留项目级编辑扩展，但不承诺理解 v1.9.5 的帧级和关联编辑语义。

发布状态

• D9 31/31 与 ACC 20/20 已全部通过，无发布阻塞。
• 正式版本以 master 和 annotated tag v1.9.5 为准。

QuickRec Full v1.9.4

QuickRec Full v1.9.4 发布说明

当前状态：正式发布

发布日期：2026-07-30

版本定位

v1.9.4 在 v1.9.3 基础剪辑能力上补齐正式本地导出闭环。用户可以从剪辑
工作台冻结当前 timeline schema v2 状态，创建可复现的导出任务，并通过工作台
中的持久队列查看进度、取消任务、诊断失败、重试以及恢复应用或系统中断的任务。

本版采用单工作线程队列、软件 H.264/AAC 编码、FFprobe 最终验证和同目录原子
提交，优先保证成片正确、旧目标安全和异常状态可解释。

主要变化

正式本地导出

• 从项目 timeline schema v2 构造不可变 ExportPlan，冻结轨道、片段、源范围、
  素材指纹和输出参数。
• 支持正偶数自定义画布，最大 3840×2160。
• 支持 30、60、120 FPS；120 FPS 仅允许不超过 1920×1080 的画布。
• 视频采用最高有效轨全画面覆盖，时间线空白区输出黑场。
• 支持最多 8 路活动音频，按活动源数量动态使用 1/N 增益并输出 48 kHz
  双声道 AAC。
• 正式输出为 H.264/AAC MP4；无音频时间线输出 H.264 MP4。

持久导出队列

• 工作台新增“导出”页面，剪辑工作台新增统一导出入口。
• 使用单工作线程顺序执行任务，支持队列暂停、继续、取消、失败诊断和手动重试。
• 任务状态、尝试历史、阶段进度、预计时间、停滞状态和入库结果持久保存。
• 应用或系统中断后，运行任务恢复为 interrupted，排队任务保持暂停，必须由
  用户显式重试，不会自动继续编码。
• 已识别的瞬时 FFmpeg 或文件系统错误最多自动重试一次；同一任务最多保留
  5 次尝试。

文件与数据安全

• 默认不覆盖已有文件，同名任务使用安全后缀。
• 显式覆盖需要二次确认，并使用备份、事务日志和恢复流程保护旧目标。
• 每次尝试使用独立临时文件；只有 FFprobe 验证通过后才原子提交正式 MP4。
• 运行前重新核对素材指纹，素材移动、删除或变化时阻止执行并说明原因。
• 导出成功后自动加入中央素材库；入库失败不改写“视频已导出”的事实，可持久
  重试且不会重新编码。
• 加入当前项目保持显式操作，不自动改变项目素材关系。

CLI、诊断与工程门禁

• QuickRecCLI.exe 新增 export validate 和 export smoke。
• CLI、工作台和剪辑工作台共用同一计划、队列、执行、验证和提交语义。
• 诊断信息新增队列摘要、失败阶段、尝试历史、输出验证和覆盖恢复上下文。
• 打包产物同时验证 GUI、CLI、FFmpeg、FFprobe、PyAV 和导出滤镜脚本。

验证状态

• 标准全量测试：1238 passed, 32 deselected, 66 subtests passed。
• Packaging：20 passed, 1250 deselected。
• 总体覆盖率：84.09%。
• 时间线剪辑核心增量覆盖率：87.72%。
• 时间线 UI 协调增量覆盖率：80.29%。
• QuickRecCLI 核心增量覆盖率：87.80%。
• 导出计划与持久化增量覆盖率：90.15%。
• 导出执行与 CLI 增量覆盖率：87.44%。
• 导出 UI 协调增量覆盖率：88.48%。
• Ruff、Mypy、Compileall、UTF-8、文档状态和差异格式检查通过。
• 1080p60、1080p120、4K60 三组 30 分钟长样本通过。
• 100 片段、最多 8 路音频、中文空格长路径、默认不覆盖和显式覆盖恢复通过。
• 应用重启、真实 Windows 系统重启、停滞、取消、重试和入库失败恢复通过。
• 100%、125%、150% Windows DPI 通过。
• v1.9.3 三类录制、四类音频、项目、素材库、剪辑、设置、诊断和 CLI 回归通过。
• D11 27/27 通过，QuickRec Lite 未修改。

正式发布资产：

目录: E:\QRtest\QuickRec-v1.9.4-rc8-dist\QuickRec
GUI: E:\QRtest\QuickRec-v1.9.4-rc8-dist\QuickRec\QuickRec.exe
GUI SHA256: 08A2ACCAFBA45C4DA02AFB2C00135B04D3CE2C606E48583AD08E30465BBA81C9
CLI: E:\QRtest\QuickRec-v1.9.4-rc8-dist\QuickRec\QuickRecCLI.exe
CLI SHA256: FF52A346B74232BFC1CE43DAFBD84FBA164EC3481CABC8CB2EBB1E34B4737C21
FFmpeg SHA256: 5AF82A0D4FE2B9EAE211B967332EA97EDFC51C6B328CA35B827E73EAC560DC0D
FFprobe SHA256: 192A1D6899059765AC8C39764FC3148D4E6049955956DC2029F81F4BD6A8972D
ZIP: E:\QRtest\QuickRec-v1.9.4-win-x64.zip
ZIP SHA256: 8969FDE7CA57853E4D658033AA91469B4990B5A5843711FDCA4662D841DD0997

完整证据见 manual-verification.md 和
verification.md。

已知限制

• 本版仅使用单工作线程，不提供并发导出、任务优先级或拖动排序。
• 使用 libx264 软件编码，不接入 NVENC、QSV、AMF 或其他硬件编码器。
• 不公开码率、CRF、GOP、像素格式和滤镜图等高级编码参数。
• 导出任务使用创建时冻结的计划；项目后续变化不会自动改写既有任务。
• 应用或系统中断后的任务不会自动续跑，需要用户显式重试。
• 在导出过程中强制结束 QuickRec 及其 FFmpeg 子进程，可能留下能够按
  attempt_id 归属的 .part.mp4 和 .filter.txt。它们不会成为正式输出，
  不会覆盖旧目标，也不会被后续尝试复用；该问题作为 LIMIT-194-01 留待后续
  版本实现安全自动清理。
• 本版不包含硬件编码、云导出、AI、QuickRec Lite 改动或全量架构重写。

回滚

• 代码和发布包直接回滚点：tag v1.9.3，不得移动或重写。
• 退出 QuickRec、QuickRecCLI.exe、FFmpeg 和 FFprobe 后恢复 v1.9.3
  正式发布包。
• 保留项目、项目索引、中央素材索引、时间线、首帧缓存、视频和已完成导出。
• v1.9.3 会忽略 v1.9.4 的导出队列与配置，不需要删除用户素材。
• 回滚前如有运行中任务，应先取消或等待完成；中断任务保留诊断证据并由用户
  决定是否清理可归属临时文件。

QuickRec Full v1.9.3

QuickRec Full v1.9.3 发布说明

当前状态：正式发布

发布日期：2026-07-29

版本定位

v1.9.3 在 v1.9.2 可播放多轨时间线上交付基础剪辑闭环。用户可以对项目片段
执行裁剪、分割和固定全局波纹操作，并在同一剪辑工作台中继续播放确认结果。
本版同时提供独立的内部自动化 CLI，为持续集成、候选包验证和后续导出能力
建立稳定的机器接口。

主要变化

基础剪辑

• 支持片段左右边缘手柄裁剪和精确数值输入。
• 支持工具栏、Ctrl+B 和片段右键菜单三种分割入口。
• 关联视频与音频始终联合裁剪、联合分割，保持素材和关联身份。
• 支持轨道锁、同轨重叠保护、越界保护和最小时长校验。
• 编辑后播放头、时间线总时长、播放终点和素材源范围同步更新。

固定全局波纹

• 裁剪、分割和删除前展示影响区间、受影响轨道和片段数量。
• 固定全局波纹会移动所有受影响片段，不提供局部波纹模式。
• 遇到跨越波纹区间的冲突片段时禁止提交，并支持定位冲突。
• 删除只处理时间线片段，不删除项目素材、中央素材记录或原始视频。

数据、保存与恢复

• timeline schema 升级为 v2，正式支持非零 source_start_us。
• v1 项目仅在第一次成功剪辑时延迟、原子迁移到 v2；只打开或播放不会改写。
• v1.9.2 遇到 v2 数据时保留原始扩展并只读，支持安全回滚。
• 保存失败时正式时间线、历史栈和项目文件保持一致，可重试或放弃候选修改。
• 支持外部文件修改冲突、恢复副本、重新加载、缺失素材和归档只读。

内部自动化 CLI

• 发布包新增独立 QuickRecCLI.exe。
• 提供 doctor、record、probe、project validate、
  timeline validate 和 smoke --suite editing。
• 使用稳定退出码和 JSON 报告，默认使用隔离 APPDATA、配置、索引和证据目录。
• CLI 直接复用录制、媒体、项目和时间线生产服务，不模拟 GUI 按钮。
• CLI 仍是内部工程工具，不替代托盘、框选、DPI、真实听音和 GUI 验收。

稳定性与职责边界

• 新增应用事件、项目保存协调、录制只读守卫和单实例服务。
• 拆分时间线媒体运行时与会话协调职责，统一播放资源释放。
• 静止桌面录制会复用有效首帧，避免生成 0 帧视频。
• 诊断信息补充时间线健康、保存、CLI 和录制性能上下文。

验证状态

• 标准全量测试：1031 passed, 30 deselected, 62 subtests passed。
• Packaging：18 passed。
• 总体覆盖率：83.56%。
• 剪辑核心增量覆盖率：87.65%。
• 剪辑 UI 协调增量覆盖率：80.16%。
• QuickRecCLI 核心增量覆盖率：88.05%。
• Ruff、Mypy、Compileall、UTF-8、文档状态和差异格式检查通过。
• 30/60/120 FPS 非关键帧源入点误差不超过 1 帧。
• 30 秒音画偏差为 16 ms；10 分钟漂移增量为 0 ms。
• 8+8 轨、100 片段、30 分钟时间线和 100 次混合剪辑压力验证通过。
• 全屏、区域、窗口、四种音频及 30/60/120 FPS 回归通过。
• 100%、125%、150% DPI 和 D10 26/26 GUI/真实媒体验收通过。
• QuickRec Lite 未修改。

正式发布资产：

目录: E:\QRtest\QuickRec-v1.9.3-rc3-dist\QuickRec
GUI SHA256: 94F51E274A32E35CC2E47AA9549BF37B41BE4DD034DDBA72A66309C58E1CC986
CLI SHA256: 8E80AEB199D978944BED049668E0F49A840BE2455AA46CAA7318AE29A9DB0B09
FFmpeg SHA256: 5AF82A0D4FE2B9EAE211B967332EA97EDFC51C6B328CA35B827E73EAC560DC0D
FFprobe SHA256: 192A1D6899059765AC8C39764FC3148D4E6049955956DC2029F81F4BD6A8972D
ZIP: E:\QRtest\QuickRec-v1.9.3-win-x64.zip
ZIP SHA256: 87A784FEBA327B60CAC01E0277B7C57320BA4BC663D3DDE58C8DE4F9D09B4F89

完整证据见 manual-verification.md 和
verification.md。

已知限制

• 本版不包含变速、转场、滤镜、关键帧、视频变换、正式导出和导出队列。
• 固定全局波纹是唯一波纹模式，不提供局部波纹或关闭波纹。
• 不支持解除关联、音视频分离、独立音频文件、波形和可调音量混合。
• 播放后端正式承诺 QuickRec 自身生成的 H.264/AAC MP4，其他格式仅尽力兼容。
• QuickRecCLI.exe 是内部自动化入口，不作为普通用户命令行产品承诺。
• QuickRec Lite 未修改。

回滚

• 代码和发布包直接回滚点：tag v1.9.2，不得移动或重写。
• 退出 QuickRec 和 QuickRecCLI.exe 后恢复 v1.9.2 正式发布包。
• 保留项目文件、项目索引、中央素材索引、首帧缓存和所有视频。
• v1.9.2 会保留 timeline schema v2 原始数据并只读，不得为了回滚删除项目。

QuickRec Full v1.9.2

QuickRec Full v1.9.2 发布说明

当前状态：正式发布

发布日期：2026-07-28

版本定位

v1.9.2 在 v1.9 项目工作区和 v1.9.1 素材预览基础上，交付项目内可持久化、
可恢复、可播放的多轨时间线。用户可以把项目素材加入时间线，完成基础编排，
并在独立剪辑工作台中播放确认结果。

主要变化

独立剪辑工作台

• 项目页提供“进入剪辑”入口。
• 剪辑工作台默认最大化，并可与素材工作台同时存在。
• 可以在剪辑工作台发起录制；录制期间时间线进入运行时只读，保存完成后恢复。
• 支持可调整素材区、预览区和时间线区域，提供放大预览与专注时间线。

多轨编排

• 默认创建一条视频轨和一条音频轨，视频轨和音频轨分别最多 8 条。
• 支持同一素材生成多个独立片段实例。
• 支持新增、删除、重命名和调整轨道顺序。
• 支持片段拖动、同类轨道间移动、吸附和按 Alt 临时关闭吸附。
• 同一轨道禁止片段重叠，不同轨道允许重叠。
• 每个离散操作自动保存；支持最多 50 步撤销和重做。

最小播放闭环

• 使用 PyAV 生产后端提供播放、暂停、随机跳转和播放头同步。
• 多个视频片段重叠时，最高活动视频轨按固定全画面规则覆盖。
• 多路活动音频采用固定等增益混合；QuickRec MP4 中的系统声和麦克风仍视为
  单一混合音频源。
• 播放终点由最后一个时间线片段结束点确定，不会在素材结束后继续空播。
• 素材缺失、解码失败和音频设备不可用时提供明确占位或无声降级。

数据与恢复

• 时间线使用项目 extensions 中的版本化扩展块，不升级项目顶层 schema。
• v1.9 和 v1.9.1 项目无感获得空时间线，旧版本会安全忽略时间线扩展数据。
• 支持素材缺失后的重新定位，并恢复所有引用同一素材的片段。
• 支持归档项目只读、未知时间线版本保护、损坏数据备份恢复和外部修改冲突处理。
• 保存失败时回滚界面、内存和磁盘状态，不留下半写入时间线。

性能与交互

• 通过 8 条视频轨、8 条音频轨、100 个片段和 30 分钟时间线压力验证。
• 完整时间线适配不再受 25% 最小缩放限制。
• 剪辑工作台在 100%、125% 和 150% DPI 下完成关键布局验收。
• 首次播放、随机跳转、暂停、长时漂移和资源释放均满足 PRD 门槛。

验证状态

• 标准全量测试：867 passed, 27 deselected, 56 subtests passed。
• Packaging：15 passed, 879 deselected。
• 总体覆盖率：83.56%。
• 时间线核心增量覆盖率：86.44%。
• 播放与页面协调增量覆盖率：82.23%。
• Ruff、Mypy、Compileall、UTF-8、文档链接和差异格式检查通过。
• 全屏、区域、窗口、四种捕获音频及 30/60/120 FPS 回归通过。
• 四路时间线固定混合已完成自动分析、真实设备输出和用户实际听音。
• D10 GUI 与真实媒体验收结论：通过。

正式发布资产：

目录: E:\QRtest\QuickRec-v1.9.2-release-dist\QuickRec
EXE: E:\QRtest\QuickRec-v1.9.2-release-dist\QuickRec\QuickRec.exe
EXE SHA256: 5383A34E50F963E224AF67D299B58B3903FDBC84F4A5CAA3B955B9C4AE75A5FA
ZIP: E:\QRtest\QuickRec-v1.9.2-win-x64.zip
ZIP SHA256: AA4D234F0AA4E3B8342B29A5AABD7CD9A76E45BCF140696748A1A9A490848BA1

完整验收证据见 manual-verification.md 和
verification.md。

已知限制

• 本版不包含裁剪、分割、变速、转场、滤镜、关键帧和正式导出。
• 不支持独立音频文件、可调视频合成、可调音量、波形或专业剪辑快捷键体系。
• 播放后端正式承诺 QuickRec 自身生成的 H.264/AAC MP4，其他格式仅尽力兼容。
• 重复启动同一 EXE 可能创建多个 QuickRec 应用进程并显示多个托盘图标，
  已登记为 BUG-009，计划后续独立治理。
• QuickRec Lite 未修改。

回滚

• 代码和发布包直接回滚点：tag v1.9.1，不得移动或重写。
• 退出 QuickRec 后恢复 v1.9.1 正式发布包。
• 保留项目文件、项目索引、中央素材索引、首帧缓存和所有视频。
• v1.9.1 会安全忽略项目 extensions 中的时间线数据；不得为了回滚删除项目。

QuickRec Full v1.9.1

QuickRec Full v1.9.1 发布说明

当前状态：正式发布

发布日期：2026-07-27

版本定位

v1.9.1 为项目工作区补充静态首帧预览和基础素材使用闭环。用户可以在项目中识别素材、查看关键元数据、打开视频或目录，并在项目页与全局素材库之间保持上下文跳转。

主要变化

项目素材预览

• 项目素材列表提供固定 16:9 首帧。
• 详情区提供 320×180 预览和完整素材元数据。
• 支持未生成、排队、生成中、可用、失败、缓存失效、文件缺失和待关联状态。
• 文件缺失时可保留历史首帧，并叠加明确缺失提示。
• 支持刷新单条预览和批量重建项目预览。

素材使用闭环

• 支持从项目页打开视频和所在目录。
• 支持跳转全局素材库并按稳定素材 ID 选中。
• 支持从素材库返回原项目和原素材。
• 预览失败不影响文件操作、项目引用或素材库恢复。

缓存与性能

• 首帧缓存位于 %LOCALAPPDATA%\QuickRec\ThumbnailCache\v1。
• 缓存使用源文件大小、修改时间和稳定素材 ID 生成指纹。
• 默认上限为 500 MiB，并按最近使用时间清理。
• 最多同时执行两个预览任务，录制主链路优先。
• 工作台隐藏不取消预览；应用退出会停止任务和 FFmpeg 子进程。

数据边界

• 不向 project.qrproj、projects.json 或 recordings.json 写入预览路径或任务状态。
• 删除预览缓存不会删除视频、项目或中央素材索引。
• v1.9 项目无须迁移即可使用。

已知边界

• 不包含内嵌视频播放器。
• 不包含时间线、多轨、剪辑、导出队列、AI 或云同步。
• 不修改 QuickRec Lite。

验证状态

• 项目标准测试门禁 714 项通过，packaging 14 项通过。
• 总体覆盖率 85.89%，ruff、mypy、compileall 和差异格式检查通过。
• rc6 最终候选包 SHA256：
  33B7DB1EB96007D75BF933D5600EE813A03ED42390CAE3A93EAD0960B9C6C7D9。
• 真实全屏录制、项目首帧、文件打开、目录定位、项目与素材库往返、容量和 DPI
  布局均已验证。
• 从真实托盘退出后 QuickRec、FFmpeg 和 FFprobe 无残留。
• D8 GUI 验收结论为通过。

正式发布资产：

QuickRec-v1.9.1-win-x64.zip
SHA256: FD859E4EA0065119BE06C382BCE3FA2C76774DB23711C21023F0A95A1F61F588

完整验收证据见 manual-verification.md。

回滚

• 代码回滚点：tag v1.9，不得移动或重写。
• 发布包回滚：恢复 v1.9 正式发布包。
• 回滚前可以删除首帧缓存；项目文件、项目索引、中央素材索引和视频必须保留。

QuickRec Full v1.9

QuickRec Full v1.9 发布说明

当前状态：正式发布
发布日期：2026-07-27

版本定位

v1.9 为 QuickRec Full 增加本地项目工作区基础。项目用于组织全局素材引用和项目上下文录制，不复制、移动或接管原始视频，也不引入时间线、剪辑、多轨或导出队列。

主要变化

项目工作区

• 工作台新增“项目”一级页面。
• 支持默认或自定义位置创建项目。
• 支持原地打开外部 project.qrproj。
• 支持重命名、说明编辑、归档和恢复。
• 同一素材可加入多个项目，从项目移除不会删除视频或全局素材记录。
• 项目页支持全屏、区域、窗口三种平级录制入口。

数据安全

• 使用 %APPDATA%\QuickRec\projects.json 维护中央项目发现索引。
• 每个项目使用独立 project.qrproj 保存项目详情和素材稳定 ID 引用。
• 项目与中央索引均使用原子写入和有效备份。
• 支持项目缺失重新定位、损坏备份恢复和外部修改冲突保护。
• 无有效备份时保留损坏文件，不创建空项目。

安全删除

• 删除项目默认不选择任何原始视频。
• 只有可证明独占且存在的素材允许选择。
• 共享、缺失或归属不确定素材禁止删除。
• 项目文件和选中视频只进入 Windows 回收站。
• 任一步失败都会停止后续操作并显示逐项结果。

工程质量

• 项目存储、生命周期、查询、录制协调、恢复和删除逻辑从 UI 中独立。
• 慢速回收站操作在后台线程执行。
• 新模块已纳入 ruff、mypy、coverage、CI 和 packaging 门禁。

已知边界

• 不包含素材预览、项目时间线、多轨、剪辑、导出队列、AI 或云同步。
• 不修改 QuickRec Lite。
• 项目只保存素材引用，不复制原始视频。
• 多项目共享状态依赖可读取的本机项目索引；无法证明独占时按“不确定”处理。

验证状态

• 全量测试：642 passed, 25 deselected, 52 subtests passed。
• 总体覆盖率：85.76%。
• Packaging：13 passed, 654 deselected。
• Ruff、mypy、compileall、原型回归和基础启动：通过。
• GUI 手动验收：通过。三档 DPI、三类录制、四类音频、真实 120 FPS 自检、设置成功/失败、诊断、素材库和三条真实回收站路径均已补证。
• 正式发布源：E:\QRtest\QuickRec-v1.9-dist-r8\QuickRec\QuickRec.exe，SHA256 CFE6BC6D4FC342039A0B410B4CF80FC9A34BAD47908F671AE9161FC63F7A9D47。

发布资产

文件	大小	SHA256
QuickRec.exe	7,047,836 字节	CFE6BC6D4FC342039A0B410B4CF80FC9A34BAD47908F671AE9161FC63F7A9D47
ffmpeg.exe	99,264,000 字节	5AF82A0D4FE2B9EAE211B967332EA97EDFC51C6B328CA35B827E73EAC560DC0D
ffprobe.exe	99,066,368 字节	192A1D6899059765AC8C39764FC3148D4E6049955956DC2029F81F4BD6A8972D
QuickRec-v1.9-win-x64.zip	160,233,267 字节	B683D051D8D0442B3503F8C5AD9FAE96F8D5538510E890E98F48EB3A1562F446

分发目录包含 244 个文件，共 428,210,468 字节。正式 ZIP 直接由锁定 R8
目录生成；不得用其他构建替代上述验收身份。

回滚

• 代码回滚点：tag v1.8，不得移动或重写。
• 发布包回滚：恢复 v1.8 正式发布包。
• v1.9 项目数据不影响 v1.8 全局素材索引；回滚前保留 %APPDATA%\QuickRec\projects.json 和所有 project.qrproj。

QuickRec Full v1.8

QuickRec Full v1.8 发布说明

状态：正式发布
收口日期：2026-07-26

本版定位

v1.8 将 QuickRec Full 从托盘录制工具推进为统一的创作者桌面工作台，并在真实硬件
技术门禁通过后正式提供单显示器 1080p120 全屏录制。素材、设置和诊断能力保持本地化，
不引入项目模型、剪辑、导出队列、AI 或云同步。

主要变化

Full 工作台

• 固定左侧导航统一承接录制、素材库、设置和诊断。
• 工作台全局单实例；关闭只隐藏，托盘退出才结束应用。
• 同一进程内恢复上次页面，首次启动默认进入录制页。
• 工作台发起录制时自动隐藏，保存完成后恢复并显示结果。
• 录制中可重新打开工作台查看只读状态，控制仍由浮动工具栏负责。
• 保存窗口大小和位置，显示环境变化后自动修正到可见区域。
• 设置页使用显式保存，支持保存、放弃、取消和保存失败回滚。
• 完成侧栏、页面、选择器、浮动工具栏、提示和图标的统一视觉改版。

1080p120 全屏录制

• FPS 设置提供 30、60、120；新安装仍默认 30。
• 120 FPS 仅用于全屏录制，区域和窗口录制最高 60 FPS。
• 首次启用 120 FPS 时执行约 5 秒真实能力检测。
• 录制前快速校验刷新率、检测缓存、FFmpeg、保存目录和磁盘空间。
• 能力缓存会在显示模式、保存磁盘、CPU/GPU、FFmpeg 或编码配置变化后失效。
• 性能不稳定时正常保存视频，并显示实际平均 FPS、最低 FPS 和稳定性告警。
• 支持无声、系统声音、麦克风和系统声音＋麦克风。
• 修复音频采集与视频首帧固定时间轴偏移，按音轨独立对齐后再混音。

验证结果

• 全量测试：523 passed, 1 skipped, 25 deselected, 48 subtests passed。
• Packaging：13 passed。
• 项目总体覆盖率最近记录：86.07%。
• Ruff、项目门禁 mypy、compileall、UTF-8 和 git diff --check：通过。
• 三次单显示器 1920×1080@120Hz 技术门禁：通过。
• 100%、125%、150% DPI：通过。
• 三类录制模式和四类音频模式：通过。
• 双音频 10 分钟漂移增量：-8.333 ms，门槛 20 ms。
• 音画最大绝对偏移：18.229 ms，门槛 40 ms。
• QuickRec Lite：未修改。

已知限制

• 120 FPS 正式承诺仅覆盖单显示器 1920×1080 全屏录制。
• 区域和窗口录制最高 60 FPS。
• 不承诺多显示器、4K、WGC 或硬件编码。
• 120 FPS 能力检测仍使用 dxcam 与 libx264-superfast。
• 工作台不包含项目模型、多轨、剪辑、导出队列、素材预览、AI 或云同步。
• 诊断信息只保存在本地，不自动上传。

发布资产

发布目录: E:\QRtest\QuickRec-v1.8-release-dist\QuickRec
发布资产: QuickRec-v1.8-win-x64.zip
ZIP 路径: E:\QRtest\QuickRec-v1.8-win-x64.zip

文件	大小	SHA256
QuickRec.exe	6,979,451 字节	8BDB84FB08198E927C722E41AC37276A796AD168C55183EE6C24194F2BFE7EA6
ffmpeg.exe	99,264,000 字节	5AF82A0D4FE2B9EAE211B967332EA97EDFC51C6B328CA35B827E73EAC560DC0D
ffprobe.exe	99,066,368 字节	192A1D6899059765AC8C39764FC3148D4E6049955956DC2029F81F4BD6A8972D
QuickRec-v1.8-win-x64.zip	160,163,885 字节	78AD1AA5EABCE77211607CE7135C9656923892B5D9C837F92E4EF6C961B10B27

分发目录包含 244 个文件，共 428,142,083 字节。ZIP 可正常读取，包含
QuickRec.exe、包内 FFmpeg 和 FFprobe；隔离基础启动验证通过。

回滚方式

• 代码和发布包直接回滚点：v1.7。
• 回滚前如配置中 fps=120，先将其改为 60。
• 使用 v1.7 tag 或 v1.7 GitHub Release 发布包。
• 不删除 %APPDATA%\QuickRec\recordings.json、待入库记录或视频文件。
• 不移动或重写任何历史 tag。

QuickRec Full v1.7

QuickRec Full v1.7 发布说明

状态：正式发布
收口日期：2026-07-21

本版定位

v1.7 聚焦素材发现效率，在 v1.6.1 中央素材库基础上增加关键词搜索、条件筛选和结果排序，不改变索引 schema，也不引入数据库或完整工作台。

主要变化

• 支持按文件名或完整路径片段搜索素材。
• 支持按状态、录制模式、音频模式和时间范围筛选。
• 支持按录制时间、时长和文件大小进行六种排序。
• 待入库与正式素材保持独立分区，并分别应用相同查询条件。
• 正式素材按匹配结果每次加载 50 条，待入库记录不分页。
• 同一进程内关闭再打开素材库可恢复查询条件；应用重启后恢复默认状态。
• 查询异常保留上一次有效结果，日志不记录查询关键词和素材路径。

明确不包含

• 不包含素材预览、收藏、标签、项目分类和完整工作台。
• 不包含 AI、剪辑、导出队列、云同步、WGC 或 120 FPS。
• 不修改 QuickRec Lite。

当前验证状态

• 自动化测试、coverage、ruff、mypy、compileall 和 packaging 已通过。
• 独立候选包已生成并完成基础启动及包内 FFmpeg/FFprobe 检查。
• D6 GUI 验收已通过，覆盖查询主链路、容量边界、待入库分区、异常降级、素材操作、三类录制、四类音频、诊断与真实系统 100%/125%/150% DPI。
• 锁定 EXE SHA256：8966985B6E1EBCEDC27499404BF8467133EFCC9C6A827898D8904CE137E15AF2。
• 发布资产：QuickRec-v1.7-win-x64.zip（160,085,094 字节）。
• 发布 ZIP SHA256：0C200C549D1E4ED495BC381298E1A3157B1534526337899DB9ED9C655A37E963。

回滚方式

• 代码回滚点：v1.6.1 tag。
• 发布包回滚：继续使用 v1.6.1 Release 资产。
• v1.7 不迁移或改写素材索引 schema，回滚不应删除视频或现有中央索引。

QuickRec Full v1.6.1

QuickRec Full v1.6.1 发布说明

状态：正式发布（2026-07-18）

主要变化

• 当视频已保存但中央素材索引写入失败时，持久保存待入库上下文。
• 应用启动后在后台对每条待处理记录自动重试一次，并对成功恢复进行汇总提示。
• 素材库新增待入库置顶区域、独立计数、失败详情、手动重试、重新定位和仅移除记录。
• APPDATA 主待入库文件不可写时，可降级到视频目录单项标记。
• 待入库容量与正式素材容量独立，淘汰待处理元数据不会删除视频。
• 修复多声道系统回环与麦克风同时录制时可能生成 AAC 不支持的 9 声道布局问题。
• 改进系统回环设备选择，优先匹配默认扬声器设备，降低选错同名前缀设备导致静音的风险。
• 新增模块纳入 PyInstaller、ruff、mypy、coverage 和 packaging 门禁。

验证结果

• 修复后全量测试：376 passed、24 deselected、22 subtests passed。
• Packaging：12 passed；ruff、mypy、compileall 与 git diff --check 通过。
• 锁定候选包 GUI 验收通过，覆盖待入库恢复、三类录制、四类音频、设置诊断、素材库回归、容量边界与三档 DPI。
• 发布资产：QuickRec-v1.6.1-win-x64.zip（160,071,928 字节）。
• 发布 ZIP SHA256：CE72D690DD46950C46CDEE2F3999B6F64E6DC0362B20CAC21FC53A34FCE197CF。
• 锁定 EXE SHA256：2CB447709769A8A986B7A48A63C98377803A002ED56892E57F0911661FA3E092。

已知边界

• 启动自动重试每条每次启动最多一次；失败项由素材库长期承接。
• 不提供复杂恢复中心、云同步、AI、剪辑、导出队列或新捕获后端。

回滚

• 代码回滚点：v1.6 tag，指向 ac8d151aababb5e7c37b3dcc646ae10c8593acf3。
• 回滚到 v1.6 不删除 pending-recordings.json 或视频目录降级标记。
• 重新升级到 v1.6.1 后可继续发现并恢复待入库记录。