Flynor Robot
现有 Robot 成熟能力的兼容部署组合：Robot Connector 接收企微/飞书消息并交给 Worker Runtime；Worker 复用 Resource Tool Adapter、Agent Adapter 和项目资源模块，按需调用 Project Intelligence，但不以 PI 作为每条消息的必经层。
职责与边界
负责
- 保持现有渠道、Job、Queue、Outbox 与 PI 入口兼容
- 装配可复用的 Robot Connector 与渠道无关 Job/Queue/Outbox Dispatcher
- 把规范化消息交给 Worker Runtime，复用 Agent Adapter 与 Resource Tool Adapter
- 仅在任务需要项目理解或并行调查时按需组合 Project Intelligence
不负责
- 目标状态不直接实现项目资源连接、同步或能力语义
- 不成为平台主数据源
- 不绕过写操作确认
- 不把凭据交给模型
数据与接口
拥有的数据
- 机器人会话与任务
- 兼容本地工作区
- 通道 outbox；项目缓存目标迁入 Project Resource Connector
输入
飞书/企业微信事件；项目配置；受控知识与工具
输出
会话回复；产物附件；项目证据与运行事件
协议
Channel Message/Reply Envelope；Worker Task/Result；Capability Invocation/Result；Agent Adapter
依赖
robot-orchestrator；enterprise-wechat-connector；worker-agent-runtime；capability-adapter；model-runtime-connector；project-intelligence
运行与部署
AI 运维组 · pilot · active；升级路径：AI 运维组 → 运行平台组
standalone · supported；长期运行服务，production-standard 是唯一默认生产 profile。
核心 Settings、bots.yaml 与部署选择器已有版本化 JSON Schema；通道 profile 和 Worker 拓扑显式配置，迁移规则与 doctor 统一提示
发布节点用唯一入口构建 Base/App/Admin、固定工具版本与三方 digest；production-standard 只安装目标机无源码构建的 Robot Release Bundle，compact 双容器仅作为资源受限模式
Release rehearsal、目标机 accept-host JSON、/health/ready、doctor 与首次通道业务验收
容器输出 platform-event/v1 与轮转日志；目标机验收输出 bounded JSON；Job 稳定映射为 AI-ROBOT-<jobId>，入口、Worker 与外发事件复用 executionId/traceId
流水线从干净 commit 生成非 fixture image lock 与 digest bundle，目标机 pull/迁移/原子切换 current；compact 回退需要数据一致性判断
标准生产部署
长期运行、可独立扩缩、可观测和可回滚的正式环境
robot-production-standard · robot · docker-compose-v2 · postgres / migrate / api / worker / dispatcher / scheduler / listener-or-webhook / reverse-proxy / optional-admin / shared-runtime-state-ledger-on-named-data-volume查看完整部署契约
前置条件
- Linux production host
- Docker Engine 24+
- Docker Compose v2
- non-fixture digest-pinned Robot Release Bundle produced by the standard image publisher
- TLS reverse proxy or outbound long connection
- external secret storage
配置与交付物
- apps/robot/.env.example
- apps/robot/schemas/deployment-config.schema.json
- apps/robot/config/bots.example.yaml
- apps/robot/config/qiyeweix.example.yaml
- apps/robot/config/qiyeweix-long.example.yaml
- apps/robot/config/qiyeweix-relay.example.yaml
- apps/robot/config/test-environments.example.yaml
- apps/robot/config/database-access.example.yaml
- apps/robot/config/elasticsearch-access.example.yaml
- apps/robot/schemas/runtime-settings.schema.json
- apps/robot/schemas/qiyeweix-relay-config.schema.json
- apps/robot/schemas/qiyeweix-long-config.schema.json
- apps/robot/schemas/qiyeweix-public-relay-config.schema.json
- apps/robot/schemas/test-environments-config.schema.json
- apps/robot/schemas/database-access-config.schema.json
- apps/robot/schemas/elasticsearch-access-config.schema.json
- apps/robot/zcy-mcp/.env.example
健康与验收
- Robot Release Bundle integrity rehearsal
- sh bin/accept-host
- minimal channel round-trip
- doctor reports Runtime state ledger ready when shadow/standard is enabled
备份范围
- PostgreSQL logical backup
- project/config backup without secrets
- append-only Runtime state ledger when shadow/standard is enabled
- workspace/index cache is rebuildable
install and rehearse a digest-pinned immutable bundle, pull without building, back up PostgreSQL, the Runtime state ledger and external configuration, run compatible migrations, atomically switch current, start with --no-build, then verify doctor, ready and business smoke test
switch current to the previous digest-pinned bundle and restore the pre-migration PostgreSQL backup when required; preserve project data, model homes, outbox, Runtime state ledger and named volumes; legacy rollback ignores but does not delete the ledger
紧凑部署
资源受限的试点或小型团队环境，不作为默认生产路径
robot-compact · robot · docker-compose-v2 · core-with-postgres-and-process-supervision / optional-admin查看完整部署契约
前置条件
- Docker Engine 24+
- Docker Compose v2
- explicit host-mounted data directories
配置与交付物
- apps/robot/.env.example
- apps/robot/all-in-one/compose.yaml
健康与验收
- all-in-one compose ps
- /health/ready
- migration and pgvector check
- worker smoke test
- compact-to-standard preview
备份范围
- host PostgreSQL directory plus logical dump
- core data directory
- credential home with restricted permissions
use all-in-one deploy script with running-job guard and health verification
immediate old-volume rollback only before new data; otherwise use the preview-first compact-to-standard migration with logical restore and snapshot comparison
开发环境
本地开发、单元测试和配置验证
robot-development · robot · python-node-docker · local virtualenv / local node packages / optional docker dependencies查看完整部署契约
前置条件
- Node.js 20+
- Python 3.11+
- Docker when testing compose
配置与交付物
- example files only
- local ignored environment files
健康与验收
- pytest
- npm test
- frontend build
- docker compose config --quiet
备份范围
- Git history for source and versioned configuration
- local ignored runtime data is disposable and must not be treated as a durable backup
not applicable
git worktree or branch rollback