# 第一阶段实施路线图

版本号：v0.1.0
最后更新：2026-04-04

## 1. 目的

本文档用于定义第一阶段的实施顺序，确保项目从文档设计逐步落到可运行的最小系统，而不是长期停留在概念层。

## 2. 第一阶段目标

第一阶段的目标不是做完全部能力，而是跑通最小闭环：

- 手机录入音频
- 本地跑基础探针
- 远端 AI 制定实验计划
- 实验执行器执行验证链
- 系统返回结构化结论

## 3. 实施原则

- 先打通主链路，再扩展能力
- 先保证结构化和可复现，再追求模型聪明程度
- 先保证实验闭环，再追求视觉精细度

## 4. 里程碑划分

### 4.1 里程碑一：核心模型与文档固化

交付物：

- 核心数据模型
- 算法链分层设计
- 模块注册表设计
- 实验执行器设计
- AI 编排接口规范

### 4.2 里程碑二：本地探针引擎 MVP

交付物：

- Rust 本地探针库
- Flutter FFI 桥接
- 通用探针链可运行
- 初始 evidence 可生成

### 4.3 里程碑三：注册表与执行器 MVP

交付物：

- 模块注册信息
- 链模板注册信息
- 实验计划校验
- 串行实验执行
- 实验记录持久化

### 4.4 里程碑四：AI 编排闭环 MVP

交付物：

- AI 输入构造
- AI 输出 schema 校验
- 假设生成
- 下一轮实验规划
- 停止条件初版

### 4.5 里程碑五：Flutter 终端 MVP

交付物：

- 录音入口
- 样本详情页
- 实验过程页
- 结论页
- 历史记录页

## 5. 第一批必须先实现的能力

### 5.1 数据对象

- `Observation`
- `Evidence`
- `Experiment`
- `ScoreCard`
- `ExperimentPlan`

### 5.2 第一批模块

- `audio_normalize`
- `mono_convert`
- `resample_16k`
- `energy_probe`
- `spectral_probe`
- `onset_probe`
- `periodicity_probe`
- `autocorrelation_period_check`
- `f0_tracking`
- `baseline_sound_classifier`

### 5.3 第一批链模板

- 通用探针链
- 周期模式验证链
- 谐波结构验证链
- 异常判断链

## 6. 第一阶段暂不做的内容

- 完整离线模式
- 大规模插件市场
- 多模态同步分析
- 复杂并行调度
- 高级 UI 视觉包装
- 自动修改底层算法代码

## 7. 推荐实现顺序

1. 建仓库代码骨架
2. 落 schema 和类型定义
3. 实现本地探针引擎
4. 实现注册表加载与校验
5. 实现实验执行器
6. 接 AI 编排接口
7. 接 Flutter 终端页面
8. 跑通完整样本闭环

## 8. 第一阶段成功标准

第一阶段完成时，系统至少应能做到：

- 对一段音频生成初始 probe evidence
- 由 AI 给出至少一个可信假设
- 由 AI 选择至少一条验证链
- 执行器完成至少一轮验证实验
- 输出带依据和不确定性的结论

## 9. 结论

第一阶段的关键不是“做很多”，而是“把最小实验闭环做实”。

只要这一闭环打通，后续扩展算法链、扩展模型能力、扩展模态都会更顺。