FrameQ v0.3.5

FrameQ v0.3.5

FrameQ v0.3.5 是基于 v0.3.4 的桌面端补丁版本，重点增强 Motion 交互体验，并修复
Windows 本地 ASR 模型下载在 worker 启动阶段无法开始的问题。安装包仍保持轻量边界，
不内置 ASR 权重、LLM key、云端模型或用户私有配置。

下载选择

• Windows x64：FrameQ_0.3.5_x64-setup.exe
• Intel Mac：FrameQ_0.3.5_x64.dmg
• Apple Silicon Mac（M 系列）：FrameQ_0.3.5_aarch64.dmg

macOS 仍使用 ad-hoc 签名与 Gatekeeper 首次打开流程；本版本不宣称 Apple notarization 或
App Store 审核。

主要变化

Motion 体验增强

• 处理阶段、任务状态、ASR 下载进度、AI 目标状态和历史列表拥有克制的状态变化动效。
• Account、Settings、History、ASR Model、AI Detail 以及确认流程的 Sheet 生命周期更平滑，
  并保留原有焦点、键盘和可访问性行为。
• 点击“重新开始新任务”返回输入页时，输入区增加短暂的淡入上移动效；首次打开首页不播放
  该重置专属动效。
• 所有 Motion 动效继承用户的 reduced-motion 偏好，不阻塞输入和任务重置。

ASR 下载启动稳定性

• Windows 开发启动器会在启动 Tauri 前补齐本地 Python runtime 所需的 VC++ 运行库 DLL。
• worker 启动前进行 app-local 运行库自检，区分运行库缺失与模型传输失败，避免出现“下载失败”
  但实际下载动作从未开始的模糊状态。
• 保留模型按需下载、缓存、取消、失败降级和离线行为边界；启动应用时不会自动下载模型。

验证

• 版本源统一为 0.3.5。
• Windows 桌面烟测通过：模型下载启动路径和“重新开始新任务”交互可用。
• 前端完整测试、lint、生产构建和治理文档校验已执行；Desktop Release workflow 负责生成
  Windows updater、Intel DMG 和 Apple Silicon DMG。

FrameQ v0.3.4

FrameQ v0.3.4

FrameQ v0.3.4 是一个桌面端补丁版本，更新应用图标并重新生成 Windows 与 macOS 安装包
所需的图标资源。除视觉标识和安装包元数据外，不改变转写、模型下载、任务处理或本地
数据行为。

下载选择

• Windows x64：FrameQ_0.3.4_x64-setup.exe
• Intel Mac：FrameQ_0.3.4_x64.dmg
• Apple Silicon Mac（M 系列）：FrameQ_0.3.4_aarch64.dmg

macOS 仍使用 ad-hoc 签名与 Gatekeeper 首次打开流程；本版本不宣称 Apple notarization 或
App Store 审核。

变更

• 更新 FrameQ 桌面应用图标及 Windows/macOS bundle 图标资源。
• 保持轻量安装包边界：不内置 ASR 权重、LLM key、云端模型或用户私有配置。

验证

• 版本源统一为 0.3.4。
• Desktop Release workflow 负责生成 Windows updater、Intel DMG 和 Apple Silicon DMG。

FrameQ v0.3.3

FrameQ v0.3.3

FrameQ v0.3.3 是基于 v0.3.2 的桌面版本，重点解决「干净 Windows 机器上 ASR 模型下载失败」
的一类根因，并强化下载链路的稳定性与可诊断性。媒体、文字稿、模型权重、LLM key、用户
配置和私有产物仍不会进入安装包。

下载选择

• Windows x64：FrameQ_0.3.3_x64-setup.exe
• Intel Mac：FrameQ_0.3.3_x64.dmg
• Apple Silicon Mac（M 系列）：FrameQ_0.3.3_aarch64.dmg

macOS 仍使用 ad-hoc 签名与 Gatekeeper 首次打开流程；本版本不宣称 Apple notarization 或
App Store 审核。

主要改进

Windows 运行库自检

• 安装包在 Windows 上随附 VC++ 2015-2022 运行库（msvcp140 / vcruntime140_1），干净系统
  无需单独安装 Microsoft Visual C++ Redistributable。
• 桌面端在启动任何本地处理前检查运行组件；缺失时给出明确指引（安装运行库或检查安全
  软件拦截后重新安装），不再显示笼统的「模型下载失败」。

下载与运行稳定性加固

• 中断的 ONNX 模型下载残留目录会自动清理，不再累积占用磁盘。
• 自定义模型下载源改为带超时、大小上限和自动重试的流式下载，并有真实进度。
• 下载前检查磁盘空间，空间不足时立即提示，不再白等一次大下载。
• 模型缓存校验加强：损坏或截断的模型文件会被识别并重新下载。
• 桌面日志增加大小上限自动滚动。
• 高频下载进度事件节流，降低界面开销。

可诊断性

• worker 启动阶段（模块导入期）的崩溃现在会记录一条结构化诊断事件；配合「导出诊断
  信息」可以远程区分运行库缺失、文件被安全软件隔离等问题，无需在用户机器上手动复现。

隐私边界

与 v0.3.2 一致：诊断导出不包含媒体、文字稿、模型文件、.env、账户信息、路径、主机/IP、
URL、代理、token、任务 ID、原始异常或 traceback；FrameQ 不会自动上传诊断包。

验收记录

• Windows 打包产物断言随包三个运行库 DLL 存在；canonical 与打包 worker 字节一致性检查
  已加入发布 CI（scripts/verify-packaged-worker.mjs）。
• 干净 Windows（无 VC++ 运行库）烟测结果见发布计划验收记录。
• 本地 Windows 上既有 watchdog 子进程 fixture 可能因 taskkill 权限/并发环境返回
  Access denied；该环境残余不代表本版本功能失败，hosted CI 与三平台 Desktop Release
  构建是发布门禁依据。

已知限制

• macOS 首次打开仍需按 Gatekeeper 提示手动授权。
• 若安全软件隔离了安装文件，仍需用户在安全软件中恢复或重装；诊断导出可帮助确认该场景。

FrameQ v0.3.2

FrameQ v0.3.2

FrameQ v0.3.2 是基于 v0.3.1 的桌面补丁版本，加入用户主动导出本地诊断 ZIP 的能力，帮助
用户在遇到 ASR 模型下载或桌面运行问题时把必要的安全诊断信息交给维护者。媒体、文字稿、
模型权重、LLM key、用户配置和私有产物仍不会进入安装包或诊断导出。

下载选择

• Windows x64：FrameQ_0.3.2_x64-setup.exe
• Intel Mac：FrameQ_0.3.2_x64.dmg
• Apple Silicon Mac（M 系列）：FrameQ_0.3.2_aarch64.dmg

macOS 仍使用 v0.3.1 的 ad-hoc 签名与 Gatekeeper 首次打开流程；本版本不宣称 Apple
notarization 或 App Store 审核。

主要改进

桌面诊断导出

• 设置 → 高级提供“导出诊断”入口；ASR 模型下载终态失败时，失败界面也提供同一入口。
• 导出使用原生 Save As，由用户选择目标位置；取消、忙碌、目标不可写和重复点击均闭合处理。
• ZIP 只包含固定根目录条目，诊断内容由 Rust 在导出时再次脱敏、截断和去重；导出本身不
  上传、不发起 DNS/HTTP 请求、不调用服务器、LLM 或模型下载。
• 诊断日志默认保留最近七天并受大小、行数和单条字符上限约束；ASR 下载 stderr 仅作为
  受限兜底信息保存。

Worker contract v8

新增结构化 ASR 模型下载诊断事件通道。诊断事件不刷新 watchdog，不改变 stdout 终态结果，
非法或不受信任内容只留下固定拒绝标记。

隐私边界

诊断导出不会包含媒体、文字稿、模型文件、.env、账户信息、路径、主机/IP、URL、代理、
token、任务 ID、原始异常或 traceback。FrameQ 不会自动上传诊断包，用户需手动将 ZIP 交给
维护者。

验收记录

• 合并后的 Windows Rust 串行测试命令为：
  cargo test --manifest-path app\\src-tauri\\Cargo.toml -- --test-threads=1。
• 原生 Save As 手动验证已完成。
• 本地 Windows 上既有 watchdog 子进程 fixture 可能因 taskkill 权限/并发环境返回
  Access denied；该环境残余不代表诊断导出失败，合并后的 hosted CI 与三平台 Desktop
  Release 构建是发布门禁依据。

已知限制

• macOS 首次打开仍需按 Gatekeeper 提示手动授权。
• 诊断导出不会自动附加到工单或上传服务；用户需要手动发送 ZIP。