贡献指南
权威来源
本页内容生成自 CONTRIBUTING.md，以代码仓库中的文件为准。
快速开始
git clone https://github.com/vllm-project/semantic-router.git
cd semantic-router
make download-models # 从 HuggingFace 下载 ML 模型
make build # 构建 Rust + Go 组件
make test # 运行所有测试
工作流程
创建分支
git checkout -b feature/your-feature-name
本地构建和测试
make clean && make build && make test
运行端到端测试
make run-envoy &
make run-router &
python e2e/testing/run_all_tests.py
运行 Pre-commit 检查
pre-commit run --all-files
如未安装：pip install pre-commit && pre-commit install
使用 DCO 签名提交
所有提交必须签名（DCO 要求）。不使用 -s 参数，CI 将拒绝你的 PR。
git commit -s -m "feat: add something"
提交 PR
- 目标分支：
main - 包含：描述 + 关联 issue 链接 + 测试结果
make test和端到端测试必须通过
调试
| 组件 | 调试方法 |
|---|---|
| Envoy | 查看 make run-envoy 终端的请求/响应日志 |
| Router | 查看 make run-router 终端的路由决策 |
| Rust | RUST_LOG=debug（级别：trace/debug/info/warn/error） |
| Go | SR_LOG_LEVEL=debug |