BatchFlow 文档索引 当前建议把文档分成三层阅读： 先看 README，确认推荐用法和生命周期。 再看 API 参考 与 配置说明，确认公开契约。 接着根据需要进入监控、测试和架构文档。 面向使用者 README API 参考 配置说明 使用示例 监控快速上手 监控指南 Metrics 规格 自定义 MetricsReporter 面向维护者 架构设计 贡献指南 测试指南 集成测试 go-pipeline 指标接入说明 变更记录 当前文档约定 README、docs/api/reference.md、docs/guides/metrics-spec.md 是一线契约文档。 示例代码以仓库内真实 API 为准，不再使用历史包路径或过期签名。 test/integration 文档主要描述测试和仪表盘，不再承担业务接入文档角色。