edit | blame | history | raw

Round 1 总 To Do List

状态：v0.1
所属子项目：02-P-NBL
Round：Round 1
日期：2026-06-02
输入文档：

1. 当前状态

Round 1 已完成：

  • PRD v0.2 已确认。
  • 研发任务拆解已完成。
  • QA 测试计划已完成。
  • 开发自查模板已完成。
  • QA 报告模板已完成。
  • 第一轮核心代码改造已完成。
  • 代码复核发现的问题已处理一轮。
  • QA 预检记录已完成。
  • Go 单元测试已通过。
  • 前端构建已通过。

当前状态：

可进入 QA 预检；尚不能直接交付用户验收。

2. 产品 To Do

ID 事项 状态 负责人 说明
P-01 确认 Round 1 产品边界 已完成 产品 不接新模型，不做新 UI
P-02 确认老用户兼容底线 已完成 产品 旧模型目录必须可用
P-03 确认离线承诺底线 已完成 产品 已有模型时识别不得联网
P-04 确认 QA 发现 P0/P1 时阻断交付 待确认 产品/QA 进入 QA 后执行
P-05 QA 通过后决定是否进入 Round 2 待确认 产品 Round 1 验收后再定

3. 研发 To Do

ID 事项 状态 负责人 说明
DEV-01 ModelProfile / ModelRegistry 已完成 研发 已注册 sensevoice-zh
DEV-02 LanguageProfile / LanguageRegistry 最小实现 已完成 研发 已注册 zh-CN
DEV-03 RequiredFileRule 支持 AllOf / AnyOf 已完成 研发 已覆盖单元测试
DEV-04 ModelInstallState / models/state.json 已完成 研发 已支持读写
DEV-05 ModelResolver / ResolvedModel 已完成 研发 支持 state、新目录、旧目录 fallback
DEV-06 SelectedModelID 隐藏配置 已完成 研发 默认 sensevoice-zh
DEV-07 EngineFactory 改造 已完成 研发 engine.New() 保持兼容
DEV-08 下载器 staging + 校验 + 安全落盘 已完成 研发 新下载进入 models/sensevoice-zh
DEV-09 Wails public API 兼容 已完成 研发 旧 ModelExists / DownloadModel 签名保留
DEV-10 Go 单元测试 已完成 研发 go test ./... 通过
DEV-11 前端构建验证 已完成 研发 npm run build 通过，有既有 a11y warning
DEV-12 primary 坏包时尝试 fallback 已完成 研发 fallback 覆盖下载、解压、校验全流程
DEV-13 state path 限制在 models 根目录内 已完成 研发 拒绝绝对路径和 .. 逃逸
DEV-14 macOS provider 使用 profile ProviderOrder 已完成 研发 Round 3/4 减少返工
DEV-15 engine 初始化失败状态明确 已完成 研发 结构存在但不可加载时发 error
DEV-16 Onboarding 显示 need_model + error 已完成 研发 避免坏模型初始化失败时卡住
DEV-17 用户触发下载可安全替换 sensevoice-zh 已完成 研发 替换失败恢复 backup，不触碰旧目录
DEV-18 增加前端 engine status 补查 已完成 研发 避免 ready/error 事件早于订阅
DEV-19 真实模型下载 smoke 待做 研发/QA 需要真实网络和模型包
DEV-20 真实模型初始化 smoke 待做 研发/QA 需要本机真实模型
DEV-21 如 QA 发现问题，修复并回归 待做 研发 QA 后执行

4. QA To Do

ID 事项 状态 负责人 说明
QA-01 QA 预检开发自查材料 已完成 QA/研发 已形成 qa-precheck-current.md
QA-02 准备旧目录完整模型场景 待做 QA models/sensevoice
QA-03 准备新目录完整模型场景 待做 QA models/sensevoice-zh
QA-04 准备 state 非法 JSON 场景 待做 QA 验证 fallback
QA-05 准备 state 指坏目录场景 待做 QA 验证 fallback 到旧目录
QA-06 准备缺 tokens 场景 待做 QA 不得初始化 engine
QA-07 准备缺模型文件场景 待做 QA 不得初始化 engine
QA-08 准备 0 字节文件场景 待做 QA 不得判定可用
QA-09 验证老用户旧目录升级路径 待做 QA 断网也要可用
QA-10 验证新用户无模型下载路径 待做 QA 新下载到 sensevoice-zh
QA-11 验证下载失败不破坏旧模型 待做 QA 失败后旧模型仍可用
QA-12 验证解压失败不写完整 state 待做 QA 需要损坏压缩包
QA-13 验证 Wails API 兼容 待做 QA 前端启动链路不破
QA-14 验证 UI 不暴露新能力 待做 QA 不出现 Moonshine/Parakeet/Qwen3/语言选择
QA-15 验证真实录音识别 待做 QA 真机真实麦克风
QA-16 验证 replacement 生效 待做 QA 真实识别链路
QA-17 验证历史写入 待做 QA 真实识别链路
QA-18 验证麦克风权限未授权/已授权 待做 QA 权限路径回归
QA-19 验证断网已有模型可用 待做 QA 冷启动、识别、历史写入
QA-20 网络观察确认识别阶段无上传 待做 QA 离线承诺
QA-21 macOS 菜单栏/Dock/窗口层级 smoke 待做 QA 真实使用回归
QA-22 输出 QA 报告 待做 QA 使用 qa-report-template.md

5. 交付 To Do

ID 事项 状态 负责人 说明
REL-01 开发自查记录 已完成 研发 dev-checklist-current.md
REL-02 QA 预检记录 已完成 QA/研发 qa-precheck-current.md
REL-03 QA 报告 待做 QA QA 完成后输出
REL-04 P0/P1 缺陷清零 待做 研发/QA 发布前必须完成
REL-05 P2 缺陷处理结论 待做 产品/研发/QA 修复或明确接受
REL-06 测试包打包 待做 研发 QA 通过后按发布规则执行
REL-07 版本号和 build 编号更新 待做 研发 打包前执行
REL-08 CHANGELOG.md 更新 待做 研发 打包前执行
REL-09 生成 macOS .dmg 待做 研发 QA 通过后执行
REL-10 用户验收 待做 产品/用户 QA 通过并交付测试包后执行

6. 当前阻塞项

目前没有产品决策阻塞。

当前主要阻塞在 QA 阶段：

  • 需要真实模型环境。
  • 需要真机麦克风权限验证。
  • 需要断网验证。
  • 需要网络观察验证离线承诺。
  • 需要真实 macOS 使用 smoke。

7. 下一步建议

按顺序执行：

  1. QA 按 qa-test-plan.md 做预检。
  2. QA 记录结果到 qa-report-YYYYMMDD.md。
  3. 研发修复 QA 发现的问题。
  4. QA 回归验证。
  5. QA 通过后进入测试包打包流程。