开发指南

开发指南#

项目结构#

speech2motion/
├── apis/              # 流式 API 实现
├── cache/             # 缓存系统
├── data_structures/   # 核心数据模型
├── filters/           # 动作筛选流水线
├── io/                # 数据 I/O 模块
├── merge/             # 动作合并和混合
├── retrieve/          # 动作检索系统
├── service/           # FastAPI 服务器
├── text_segmentation/ # 文本处理
├── utils/             # 工具函数
└── variety/           # 动作多样性管理

测试#

项目包含全面的测试：

# 运行所有测试
pytest tests --log-cli-level=ERROR

# 运行特定测试类别
pytest tests/filters/  # 筛选器测试
pytest tests/merge/    # 动作合并测试

代码质量#

项目通过以下方式保持高代码质量：

  • 代码检查：使用 Ruff 进行代码风格和质量检查

  • 类型提示：完整的类型注解支持

  • CI/CD：自动化测试和部署流程

Contents