用途
Finta CI Integration 用于在 CI 流水线中自动化 Finta 相关集成的检查与报告，重点覆盖融资 CRM 数据的同步验证、轮次与投资人查询、管道阶段转换以及自动化投资人报告流程。其核心目标是在不暴露融资数据、不向不可信代码授予凭证的前提下完成自动化校验。
主要能力
- 无凭证运行 schema、格式与单元检查。
- 将需要认证的暂存环境检查限制在受保护分支，并使用最小权限密钥。
- 使用合成记录、脱敏日志，在目的地、权限或 schema 结果异常时快速失败。
- 生产部署前要求显式审批，并保留测试回执。
- 输出 CI 回执，包含提交 SHA、执行的检查、合成夹具版本、总体结果与脱敏失败引用；不打印密钥、原始导出或投资人数据。
使用方式
技能提供 GitHub Actions 工作流示例：在 pull request 时对指定路径触发，运行单元测试；在 push 到 main 分支后，依赖单元测试通过再运行集成测试，并通过 FINTA_API_KEY 环境变量注入密钥。单元测试使用 vitest 和 mock 的 FintaClient，验证融资轮次进度汇总（如计算已融资百分比与投资人数量）。集成测试在有 API Key 时才运行，调用 https://api.finta.io/v1/rounds 并校验返回状态与 rounds 字段。
前置条件
- 具备受保护密钥的 CI 环境，且密钥仅对受信任的受保护分支任务可用。
- 任何集成测试所需的合成夹具与暂存端点。
- 针对部署相关流程变更的指定负责人与回滚流程。
适用场景
适用于需要在 PR 阶段用模拟投资人管道数据运行单元测试、在合并到 main 后验证轮次与投资人查询的实时 API 连通性的团队。适合围绕 Finta 集中的融资 CRM 数据（轮次、投资人联系人、管道阶段）构建的集成项目。
限制与注意事项
资料提示的常见问题包括：401 Unauthorized 由无效 API Key 引起，需在 finta.io 仪表板重新生成；空轮次列表表示没有活跃融资轮次，可在沙箱创建测试轮次；管道阶段不匹配源于工作区自定义阶段名，需通过 listStages() 动态获取；429 限流由并行测试的 API 调用突发导致，需串行化集成测试或加入节流；投资人数据过期由 webhook 同步延迟导致，需对最近更新的投资人增加轮询重试。
后续步骤
部署相关内容参见 finta-deploy-integration。资源包括 Finta API 文档与 GitHub Actions Secrets 文档。