总体架构

平台由资源目录、凭据、连接、同步、工具、任务执行、Agent、消息入口和项目智能等逻辑模块组成。模块可以独立部署，也可以共进程运行。

资源模块边界

Project Resource Catalog / Binding 声明资源、位置、用途、分支、环境/主机、访问路径与权限。
Secret Store 只保存真实秘密；配置只出现 credentialRef。
Project Resource Connector 解决怎么连接资源。
Resource Synchronizer 解决何时、按什么策略更新缓存、last-good、索引与 GitNexus。
Resource Tool Adapter 解决 Agent 怎么通过本地或网络安全访问。

Project Intelligence

端侧 Agent 可以直接调用 Resource Tool，也可以启动一个或多个资源侧 Subagent。最终结果由端侧 Agent 汇总。

群内 @机器人组合

Robot Connector（企微/飞书连接、消息、身份、图片、附件、回复）→ Job/Queue/Outbox Dispatcher → Worker Runtime → Resource Tool Adapter + Agent Adapter → Robot Connector 回复。Project Intelligence 只在任务需要时调用。

测试结构组合

Choerodon Tester 是只读 Test Management Resource Provider；Test Orchestrator 当前只 OBSERVE；项目 Runner 当前保留 Server→Host 主链，Test Worker→Runner v1 是待迁移目标；Test Browser 只提供 Web 证据；DevOps 写回继续走唯一 DevOps Connector。它们是独立逻辑边界，不要求拆成独立微服务。

平台管控面

Management Registry 保存项目、能力、流程、策略和发布定义。

当前发布方式

Management 0.4.0 支持版本发布、服务端确认、Author/Publisher 职责分离、目录审计和签名快照。Server 可离线验证快照。

兼容策略

旧链路继续可用

旧 Server→Host Runner 保留。Runner v1 先进行只读影子比较，再按消费者逐步启用。