Flynor平台文档Flynor 首页
Flynor 文档/DevOps Adapter
稳定

Choerodon Adapter

Choerodon Adapter 处理猪齿鱼认证、接口、字段、状态和错误转换。

01

必须留在 Adapter 的内容

  • OAuth、Token 刷新和产品认证方式。
  • 猪齿鱼接口路径、分页和版本差异。
  • issue、fixVersion、status、transform 等专属字段。
  • 项目/组织映射、状态名称映射与错误转换。
  • 产品侧幂等恢复、乐观锁和写后核验。
02

不得泄露到上层

  • Server 策略不能理解猪齿鱼状态名。
  • Test Intake 和 Test Writeback 不能读取产品字段。
  • BA 与 Robot 只能使用 Work Item 标准模型。
  • 通用配置只能引用 connectionId、projectBinding、adapterConfigRef 和统一 credentialRef;解析后的配置与凭据只由受控宿主注入 Provider。
03

当前兼容面

现有 integration-choerodon 包、命令名、配置和服务入口全部保留。DevOpsConnection/Provider Registry 已提供新增 Provider 的显式装配契约,现有宿主仍走已验收的显式构造/兼容 Facade;Test Writeback、Test Intake、Tech Codex、BA/Server 建单与 Robot 缓存刷新已进入通用边界;产品字段和成熟缓存实现留在 Provider。真实只读、缓存和专用测试任务写回均已有 live 证据;Robot MCP 结果进一步归一属于非阻塞 Provider 演进。

04

迁移与回滚

  1. 读取链已完成工作项数量、状态、父子关系和迭代的契约与 live 验收。
  2. 评论和 Work Item Transition 已验证权限、幂等和回执。
  3. 旧 generic 模式继续解释为 standard,项目仍可显式选择 legacy 回退。
  4. 异常时切回 legacy 模式,保留原账本、评论标记和回执,禁止清空状态或双写。
05

弃用窗口

兼容优先

通用接口正式发布后,Choerodon v1 配置、命令和协议别名至少保留两个正式小版本且不少于 90 天。

依据

architecture/adrs/0005-devops-connector-boundary.md · packages/integration-choerodon/package.json · packages/integration-choerodon/src/devopsConnector.js · architecture/audits/test-runtime-devops-governance-2026-08-26.md · architecture/audits/robot-realtime-devops-mcp-governance-2026-08-26.md · apps/robot/zcy-mcp/README.md