核心组件
按职责、数据归属、依赖、部署方式和维护状态查看平台组件。
角色体验层5
Flynor BA Partner
面向 BA、产品与项目角色的唯一业务协作客户端，按项目加载 Management 配置并发布的 Flynor 能力。
Flynor Tech Codex
本地优先的开发者任务与 Agent 工作台，融合当前工作区、项目证据和交付动作。当前工作列表、任务包关联所需父级/协作事实、开发前实时状态核对、流转候选和完整任务详情已通过产品无关 DevOps Read Query/Result 调用受管 Choerodon Provider；已绑定项目的用户评论、显式/策略状态、中央技术任务创建和分工完成后的父任务状态也经标准 Task Operation/Result。中央建单保留 marker 恢复、plan/apply 确认、priority-only 补全、不确定写入恢复与依赖顺序。工作台边缘保持原 UI/详情/状态语义，标准正文继续复用 Content Runtime；无项目配置仍回退成熟旧入口。
Robot Dispatcher / Queue / Outbox
Robot 部署内的渠道无关兼容 Dispatcher：管理 conversation、Job、Queue、进度和 Outbox。飞书与两种企微入口现通过共享 Robot Connector Facade 交付标准 Channel Message/Reply，同时保留原 NormalizedMessage、Outbox 和 Worker 行为；robot-orchestrator 仅保留为兼容 ID。
Robot Connector
只处理企微/飞书的连接、消息、身份、图片、附件和回复。共享 Facade 已承接飞书、企微 callback/relay 与企微官方长连接的入站和出站投影，覆盖 reply/send/update 与 text/card/file/image；Delivery Receipt 元数据已关联共用 Runtime 账本并可跨重启查询，Outbox 仍是业务投递权威。原渠道协议、NormalizedMessage、Outbox 和 Provider 行为保持不变；enterprise-wechat-connector 仅保留为兼容 ID。
Flynor Documentation Portal
对外产品门户与对内架构治理入口，从统一清单生成组件、部署、术语、兼容和风险文档。
平台管控面3
Flynor Management
平台长期治理入口；Management 0.3.0 Registry 已提供版本化定义、组织主体操作权限、Author/Publisher 职责分离、服务端确认、可追溯审计、签名快照及同源 Console，Codex 管理原型仅保留设计参考。
Management MCP Gateway
管理系统面向 Codex 的标准工具入口；当前只读查询 Registry 已发布定义，并保留原型页面入口。
Project Resource Catalog / Binding
项目资源配置的结构化目录：声明资源、位置、用途、环境/主机绑定、访问路径、权限和非秘密 credentialRef。Robot 与 Project Intelligence 已复用同一兼容 Facade；legacy 保持原行为，shadow 记录覆盖差异，standard 只在成熟 Binding、Adapter 与 Sync 引用完整时切换。新增宿主按相同契约增量接入。
统一运行面1
项目执行面9
Flynor Robot
现有 Robot 成熟能力的兼容部署组合：Robot Connector 接收企微/飞书消息并交给 Worker Runtime；Worker 复用 Resource Tool Adapter、Agent Adapter 和项目资源模块，按需调用 Project Intelligence，但不以 PI 作为每条消息的必经层。
Project Intelligence Core
已投入使用的项目智能组合继续提供两条并行能力：端侧 Agent 直接调用远程项目工具的主链路，以及困难问题按需启动一个或多个资源侧 Subagent 的协助链路；两者互不替代。当前 12 个旧资源方法已通过同一 Resource Tool Adapter Provider 提供 Host 本地与端侧网络语义；显式配置标准模式的资源节点会协商 Server 签发的只读 Ed25519 Lease，并在节点侧验签、授权和持久审计，旧节点继续兼容。Expert/Subagent 路径把固定只读预取、Worker Task 和确定性 Cursor Agent Run 绑定到同一签名任务租约，审计引用进入 Worker/Agent Result；共用 Runtime 元数据账本又为 Worker/Agent 状态、中断识别和 Session hash 映射提供跨重启查询。固定镜像的远程资源、Expert 契约、容器网络与重启边界已有 devbox deployed-contract；端侧远程工具与两个真实 Cursor Subagent 已完成并行、续聊和单节点失败隔离 live 验收。
Flynor Test Runtime
测试场景的可部署组合；现有 Test Intake、Test Worker、Test MCP、Test Browser、项目 Runner 和 DevOps Test Writeback 成熟链路保持不变。Choerodon Tester 作为只读 Test Management Resource Provider，OBSERVE 作为测试编排逻辑，Runner v1 作为 Test Worker 与项目 Test Driver 的标准契约；Project Runner Adapter 已完成单次执行同响应 shadow 验收，旧 Server→Host Runner 入口继续兼容，不做无保护切换。
Test Tool Gateway
面向测试场景的 MCP 工具投影或入口；实际调用已由 TestResourceToolAdapter 执行并生成 Capability Invocation/Result。旧 MCP text content 保持不变，新增 structuredContent；legacy-static 模式明确生成兼容 Lease，capability-adapter 模式接收 Server→Worker→Driver 原样透传的 Ed25519 签名 Lease，必须同时装配 verifier 与持久元数据审计，并对作用域、权限、writeUseCase、参数约束和可跨重启恢复的 maxCalls 默认拒绝。
Choerodon Adapter
当前猪齿鱼 Provider 与兼容入口。Test Writeback 写入、Test Intake 读取、Tech Codex 主要读写链，以及 BA/Server 业务父子任务创建已通过 DevOps Connector；Robot 工作项缓存刷新已由 Resource Synchronizer 包住成熟 MCP/SQLite Provider。Robot bundled realtime/plan/write/operate MCP 仍复用原产品 handler 和返回，但已在显式 shadow/standard 增加逐调用签名授权、项目 scope、读写预算、删除拒绝与持久审计。Provider 内继续执行产品 HTTP/字段、marker 恢复、plan/apply、优先级补全、不确定写入恢复和 BA 根任务状态流转，Tech/Server/Robot 边缘恢复原详情、状态、依赖、action、receipt、缓存返回与异常语义。其他资源仍使用兼容路径。
Resource Tool Adapter
Agent 访问项目资源的统一窗口：把代码、文档、GitNexus、链路映射、DevOps、数据库、日志、Test Management、浏览器证据与项目 MCP 定义为可复用工具；本地直连和端侧网络调用共享参数、权限、结果与错误语义。Choerodon Tester 只读能力在此投影，Test Browser 归 Web Evidence Provider；两者都不拥有测试编排或 Runner。既有 Project Data MCP、Project Intelligence、Test MCP、Robot Worker 与 Agent 工具兼容 Facade 保持原入口和行为。
Worker Runtime
受限任务执行单元：接收冻结任务与任务级权限，可直接调用 Resource Tool Adapter，并按需通过 Agent Adapter 使用 Agent Runtime。兼容 Facade 已包裹 Robot Job、Project Intelligence 专家任务和 Test Worker 主执行/恢复入口。测试链新增 Runner v1 作为 Test Worker→项目 Test Driver 的公开边界；旧 Server→Host execute_test_batch 继续保留，待影子对比后逐消费者切换。
Agent Adapter
统一 Claude Code CLI、Codex CLI、Cursor、Devin 与现有 Agent 后端的启动、续跑、取消、状态、会话恢复和工具注入。可执行 Facade 已承接 Robot Worker 中 9 个 Codex/Claude/Cursor 主链、恢复与 fallback 调用点、Project Intelligence 只读 Cursor 专家、Evolution Codex，以及 Tech Codex 的 Codex/Claude/Devin Router；原 Provider 选择、Runner 参数、会话续跑、取消、超时和错误类型保持不变。PI Expert 的 Cursor Agent Run 已精确绑定签名任务；Robot 的可选签名投影只签认本次 Runner 实际注入且同时被 Task/Lease 允许的成熟 MCP/Claude CLI 与内建 workspace read/write/shell 候选，bundled Choerodon MCP 已进一步执行逐调用门禁并在 Agent 结束后清理短期 context。公开 query/continue、Session hash 恢复映射、持久元数据 Run/工具审计和脱敏 Provider probe 已完成。固定 Codex/Claude/Cursor/Devin Provider 契约和重启边界已有 devbox deployed-contract；任意第三方 MCP/其他 CLI/Agent 自行启动命令的事务性调用前 gateway 仍待完成；model-runtime-connector 仅保留为兼容 ID。
Managed Deployment Controller
每套项目侧 Docker Compose 自带的独立控制面。它主动通过短 HTTPS 轮询连接 Server，自注册并受控诊断、修改允许配置、重启、重建、固定版本更新和回滚；v2 Release 可在同一主干选择带内容层增量/完整包兜底的 Generic Package，或受 repository allowlist 限制的 OCI digest Provider，不要求主机公网 IP、SSH 或远程终端。
共享底座8
@flynor/protocol
跨端协议常量、Schema、校验器和测试夹具的唯一来源。
@flynor/client
面向 Flynor Server 的 TypeScript 客户端与调用封装。
@flynor/codex-runtime
Codex 运行时装配、能力加载和受控执行的共享实现。
@flynor/evaluation
评测契约、数据集、CLI 和平台质量工具。
DevOps Connector
产品无关 DevOps 访问边界已完成当前治理，并继续作为 Agile Work Item 的唯一写入所有者。Choerodon Tester 只拥有 Test Manager 用例、计划、周期和执行记录，不能形成第二条评论、状态或缺陷写链。Test Writeback、Tech 已绑定项目的评论/状态/中央技术任务，以及 BA/Server 业务父子任务创建使用 DevOps Task Operation/Result；标准 Project、Iteration、Work Item、Status、Comment、User、Relation、Transition 与 Read Query/Result 已由 Fake/Choerodon Provider 同套实现。版本化 DevOpsConnection 与失败关闭的 Provider Registry 为新增 Provider 提供不含凭据正文的装配契约；现有宿主仍保留已验收的显式构造与兼容 Facade。标准 Compose 已通过受控 Secret 投影在 devbox 对真实项目完成读取、缓存刷新，以及专用低优先级测试任务的评论、合法状态流转、幂等重放和原状态恢复。
Project Resource Connector
按 Project Resource Catalog 建立资源连接并统一 Driver 注册、授权、结果、错误与 doctor。Test Management 作为项目资源专门类型接入：Choerodon Tester Provider 只负责测试用例、计划、周期、执行记录和追溯的只读连接，能力通过 Resource Tool Adapter 投影；它不替代 DevOps Connector、Test Worker 或项目 Runner。当前兼容切片已包住数据库/日志、GitNexus、本地 Git、语雀读取等成熟入口。
Resource Synchronizer
独立维护定时、事件和手动更新策略，生成缓存、freshness、last-good、Repo Mirror、文档索引与 GitNexus 等派生数据。公开 Registry/Sync Run 已兼容包住 Scheduler GitNexus 增量索引、Docker runtime 项目复制、文档导出/缓存和 Robot DevOps 工作项缓存刷新；通用 run ledger 当前为进程内，成熟缓存与索引各自保留既有持久恢复。跨节点账本、高级索引和新宿主属于增量增强。
Secret Store
统一 SecretRef 与 Provider 边界已经用于 Server、Robot、PI、Test Runtime 和标准 Compose 的成熟子集：兼容 env://，支持 Docker/目录 secret://、受限 file-ref://，未配置 managed-secret:// 时默认拒绝；执行侧只接收公钥或最小投影。Tester 的 CHOERODON_TEST_* Token Store 与 Agile/DevOps 凭据严格分离；@flynor/choerodon-core 不拥有任何凭据。企业 Secret backend、统一 workload identity、撤销与双版本轮换作为非阻塞增强继续治理。