用途：为 Glean 企业搜索集成建立 CI/CD 流程，在每次 PR 运行带 Mock 搜索与索引响应的单元测试，合并到 main 时针对暂存 Glean 实例校验连接器文档转换与搜索质量。Glean 索引多个 SaaS 工具的内容，因此流水线聚焦连接器数据转换、索引 API 调用与搜索相关性回归测试。
主要能力：Mock 驱动的单元测试（含默认拒绝的 ACL 与畸形响应用例）；带幂等键的受限沙箱批次；仅输出聚合计数、关联 ID 与策略版本，遇意外目标、ACL 扩大或未脱敏日志断言即失败；经评审后通过金丝雀数据源晋升，同时测试允许与拒绝身份，失败时回滚到上一已知良好版本。
使用方式：示例工作流监听 src/connectors/、tests/ 的 PR 与 main 推送，unit-tests 作业执行 npm ci 与 npm test -- --reporter=verbose，integration-tests 在 main 上依赖前者并注入 GLEAN_API_KEY、GLEAN_DOMAIN 秘密运行 npm run test:integration。集成测试在缺少密钥时跳过，成功后发布含提交 SHA、fixture 版本、沙箱数据源、测试总数、策略检查、金丝雀结果与回滚引用的回执。
适用场景：Glean 连接器开发团队需要自动化索引测试、搜索质量验证与安全部署门槛时使用。
限制与前提：需使用 CI 秘密引用而非明文令牌，沙箱端点仅接受虚构租户与数据源 ID；fixture 不得含员工姓名、客户内容或生产 URL，日志需脱敏请求头与正文；需保护分支与已批准的回滚机制。常见问题包括 401 未授权（令牌或域错误）、索引返回 0 文档（格式不匹配 schema）、搜索质量回归（索引未更新，需在索引与检查间加等待）、数据源未找到（暂存未配置连接器）以及 429 限流（建议每批最多 100 个文档并限流）。部署模式参见 glean-deploy-integration。