模块参考
按能力域组织的模块索引。每页包含职责、数据模型、接口、关键流程、边界与源码位置。
能力与供给
| 模块 | 一句话 | 数据 |
|---|---|---|
| Agent Profile | 企业注册与上架 Agent | agent_profiles |
| Agent Matching | 四维加权评分选供给 | 无状态 |
| Agent Gateway | WebSocket 连接、任务推送、离线积压 | offline_tasks、dialogue_sessions |
| A2A 协议 | 平台与外部的标准通信协议 | 无 |
| Skill Catalog | 能力定义与导入 | skills |
需求与编排
| 模块 | 一句话 | 数据 |
|---|---|---|
| 需求翻译 | 自然语言 → 结构化子任务 | translated_demands |
| Task | 任务生命周期与执行主链路 | tasks（MySQL） |
| Task Open | 对话里开任务（open_task）与读任务清单（list_tasks） | tasks、task_journal |
| Proactive | 平台助手主动开口：单关注点卡片 + 兴趣记忆 | proactive_interests、dialogue_messages |
| Workflow | DAG 定义、校验、执行 | workflows、workflow_executions |
| Dialog | 多轮对话与消息持久化 | agent_dialogues |
| Reporter | 多节点结果 → 统一报告 | 复用 Task |
| Compliance Engine | 合规定向能力（CE） | 无 |
域与账务
| 模块 | 一句话 | 数据 |
|---|---|---|
| Order 订单域 | 条款与金额的权威；执行归 Task，记账归 Accounting | orders（事件流） |
| Accounting 期间与账务 | 期间门禁、四科目分录、结算自动派生 | periods（事件流） |
| Ledger 余额资源 | 余额账户与原子扣减——不是账本 | ledger_accounts、ledger_movements |
| Master Data 主数据 | 唯一编码、版本历史、合并与回滚 | master_entities、master_aliases |
| Computation 计算型 | 只存运行记录，同输入复用、版本失效 | computation_runs |
| External Skill 能力集成 | 外部系统作为可调用能力，结果落事实 | /tasks/{id}/external-calls |
这一组的共同点：都在回答「事实怎么被可靠地承载」。 统一说明见 四类事实形态与域模型。
智能体进化与主动
| 模块 | 一句话 | 数据 |
|---|---|---|
| Agent RSI：智能体自进化 | 每日复盘、证据门禁、自治等级与变更提案 | state_*（/agents/{id}/...） |
| 智能体主动模式 | 从决策行为推断偏好，按预算与冷却主动提醒 | state_*（per-owner 信号 / 通知） |
| 知识库 | 有状态、会过期、只让批准内容影响客户的长期记忆 | state_*（knowledge / lessons） |
这三项能力跨越多个既有模块（Agent Profile / AgentRuntime / State）， 因此详细介绍放在架构目录，而不是单个模块页。
信任与交付
| 模块 | 一句话 | 数据 |
|---|---|---|
| Verification | 输出校验与质量统计 | verification_results |
| Fulfillment | 交付 / 验收 / 争议 / 裁定 | fulfillment_* |
| Escrow | 托管状态机与结算指令 | escrows |
| State | 事件溯源状态层 | state_* |
| Policy Settings | 运行时商业参数 | policy_settings |
| Dispute Timeout | 争议超时扫描与自动处置 | 复用 fulfillment_disputes |
| Reference Case | 端到端参考业务 | 复用 L0/L1/L2 |
商业与支撑
| 模块 | 一句话 |
|---|---|
| 支付与钱包 | 支付通道、钱包、银行卡 |
| 平台支撑服务 | 安全、邮件、短信、截图、PDF、上传、存储 |
| 历史模块 | 早期脚手架与遗留代码说明 |
如何阅读模块页
每页结构固定：
- 职责——这个模块负责什么、不负责什么
- 在架构中的位置——上下游依赖
- 核心能力——功能表
- 数据模型——集合 / 表 / 关键字段
- 接口——HTTP / WebSocket / 内部方法
- 关键流程——状态迁移或时序
- 边界与限制——已知取舍与未完成项
- 源码位置——从哪里开始读
模块依赖图
┌──────────────┐
│ agent │ Skill Catalog
└──────┬───────┘
▼
┌──────────────┐
│ agent-profile│
└──────┬───────┘
┌────────────┼────────────┐
▼ ▼ ▼
agent-matching agent-gateway a2a
│ │ │
└────────────┼────────────┘
▼
┌──────────────┐
│demand-transl.│
└──────┬───────┘
▼
┌──────────────┐
│ workflow │
└──────┬───────┘
▼
┌──────────────┐
│ task │
└──────┬───────┘
▼
┌────────────┴────────────┐
▼ ▼
┌──────────────┐ ┌──────────────┐
│ verification │ │ fulfillment │
└──────────────┘ └──────┬───────┘
▼
┌──────────────┐
│ escrow │
└──────┬───────┘
▼
┌──────────────┐
│ state │
└──────────────┘下一步
- 从任务主链路开始 → Task
- 从能力目录开始 → Agent Profile
- 从信任层开始 → Fulfillment
- 让 agent 自己变强 → Agent RSI / 智能体主动模式 / 知识库