主题
开源生态企业智能体平台 · 学习路线
完整分组导航与状态总览见 README-总索引。本篇按"拼装顺序"展开教学路径；索引按"功能域"分组，两者互补。
策略：最小成本缝合引擎、最大定制 HiMarket 产品壳。能力引擎（AgentScope / Higress / Nacos / RocketMQ）保持原版或最小 patch；所有"对标百炼"的产品体验——对话、目录、市场、审批、观测、计量——由 HiMarket + 统一体验层包装。设计判据来自 AI Agent Handbook，能力对标锚定阿里百炼。
这一栏不是组件说明书，而是一份拼装手册：HiMarket 供货、Nacos 登记、Higress 准入、HiRoute 选路、Jev 判断、AgentScope Java 执行、AgentScope Service 管目录、Scheduler 触发、LiteTopic 投递、OpenCode/Claude Code/Codex 当执行器、Redis/NAS/OSS 存状态、mem0 管长期记忆、OTel 留证据。
每一篇只回答两个问题：这块积木接在哪条缝上，接缝另一侧是谁。组件可以替换，接缝的字段与权威不能。
装配全景图
读图的顺序就是装配顺序：先把身份四元组定下来，再让内核与状态跑通，然后才是控制面、任务通道、市场与路由。跳过身份直接接渠道，会得到一套无法按租户隔离的入口；跳过状态直接上控制面，会在第一次重启时丢掉所有会话。
十一个功能域
| 域 | 拼什么 | 关键接缝 | 篇目 |
|---|---|---|---|
| 1 身份与入口 | 外部身份 → 平台主体 → 网关消费者 → 安全兜底 | tenant / namespace / subject / session | 02、03、15 |
| 2 内核与状态 | HarnessAgent + 状态/文件/快照/锁 | (userId, sessionId)、DistributedStore | —（06、12 已并入 41） |
| 3 控制面与领域模型 | 目录、会话、版本、端点、Vault + 实证全景 | Agent version、Session/Turn、Endpoint release | 41 |
| 4 任务与路由 | 触发 → Outbox → 会话通道 → Worker + 评审闭环 | task_id、attempt、idempotency_key、phase | 05、22 |
| 5 供给与注册 | 上架 → 注册 → 准入 → 分发 → 实例配置 | product_id、skillId、nacosRefConfig | 04、08、19、32、38 |
| 6 集成与交付 | 执行器、协议渠道、Hub 路由、产出物 | Harness 能力协商、ticket、artifact_id | 11、13 |
| 7 体验与场景 | 统一体验层、场景考量、沙箱、组织形态 | BFF、管理对象、IsolationScope | 33、20、21、50 |
| 8 观测与治理 | Trace、评测、门禁、契约调用 | traceparent、span 语义、eval API | 14 |
| 9 对标与深化 | 白皮书逐条对标、仿真台、调优闭环 | Release/Manifest、Run/Evidence、Trajectory/Dataset | 24、25、26 |
| 10 实施与验收 | 路线、台账、部署、复核与验收总报告 | 六阶段切片、T1–T10、V1–V5 | 16、30、31、44 |
| 11 总览与规范 | 能力全景、组织运行时、术语约定 | 44 项能力、G1–G12 缺口 | 47、48、23 |
数字分身线：原 36/37/38/39 与专栏子目录已迁至 08_基于QwenPaw的企业员工数字分身，07 侧只保留接缝定义，见 36-平台层接缝摘要（数字分身线）（挂在域 5 供给线上）。
篇目与拼装位置
基础方法论
| 篇目 | 这块积木负责什么 | 拼到哪个接口 |
|---|---|---|
| 01-落地方法论与总体架构 | 完整拓扑、接缝契约、数据所有权 | 全部组件的上下游 |
身份与入口
| 篇目 | 这块积木负责什么 | 拼到哪个接口 |
|---|---|---|
| 02-账号、租户与命名空间 | 把人、应用、Agent 统一成四元组 | 渠道身份 → 网关 → Service 命名空间 |
| 03-入口与模型网关 | 认证、配额、模型/MCP 转发 | 渠道 → Service Gateway；内核 → 模型端点 |
| 15-安全与多租户隔离 | 注入、越权、凭据、供应链、C1 修复方案 | 网关/工具/沙箱/存储四层 |
内核与状态
06（内核概念版）与 12（状态/记忆/沙箱）已并入 41-领域模型与使用语义全景，原文件留作历史参考；实施与查阅一律以 41 为准。
控制面与领域模型
| 篇目 | 这块积木负责什么 | 拼到哪个接口 |
|---|---|---|
| 41-领域模型与使用语义全景 | 源码实证 + 实机验证全景（含接口清单与组件分工） | 网关 → 控制面 → Dataplane 的唯一实证出口 |
07（设计版）与 35（接口清单）已并入 41，原文件留档。
任务与路由
| 篇目 | 这块积木负责什么 | 拼到哪个接口 |
|---|---|---|
| 05-模型与任务路由 | 本地选模型、任务委派（含结构化决策与派发语义） | Harness → HiRoute → 执行器 |
| 22-架构评审与任务闭环 | 任务状态机、等待、预算、证据、验收 | 全链路运行态闭环 |
09（Jev 结构化决策）与 10（RocketMQ LiteTopic 派发）已并入 05，原文件留档。
供给与注册
| 篇目 | 这块积木负责什么 | 拼到哪个接口 |
|---|---|---|
| 04-能力市场 | 上架、订阅、审批、计量 | 供给方 → product_id → 网关消费者 |
| 08-注册与配置 | 发现实例、下发配置、登记资产 | 发布流水线 → Nacos → 网关/运行时 |
| 19-Skill 与 MCP 供给链路 | 权威分层、上线审核、运行时加载 | Git → Nacos → HiMarket → Toolkit |
| 32-HiMarket 集成接线设计 | 元信息↔运行时同步、权威归属 | HiMarket → agentscope-service |
| 38-市场与实例配置打通 | Skill/MCP 分发链路（已归 08 线，留档） | HiMarket → 控制面 → 实例 |
| 36-平台层接缝摘要（数字分身线） | 07↔08 接口合同：agentscope 适配、网关身份转换、供给分发 | 07 平台层 ↔ 08 数字分身产品线 |
集成与交付
| 篇目 | 这块积木负责什么 | 拼到哪个接口 |
|---|---|---|
| 11-编码 Harness 接入 | 把成熟编码 Agent 变成可调度执行器 | Scheduler → Runtime Host → Harness |
| 13-协议、渠道与集成地图 | A2A/AG-UI/Chat Completions 与 IM 渠道（含 Hub 路由与产出物交付语义） | 外部消费者 → 网关/内核 |
17（个人助理 Hub）、18（产出物与 IM 交付）、34（OpenCode 执行体接入）已并入 13，原文件留档。
数字分身产品线（原 36/37/38/39 + 专栏子目录）已独立为 08_基于QwenPaw的企业员工数字分身，专栏子目录已删除。本栏只保留接口合同：36-平台层接缝摘要（数字分身线）（依据 32 篇接线、15 篇 §九.3 身份注入、35 篇接口清单）。
体验与场景
| 篇目 | 这块积木负责什么 | 拼到哪个接口 |
|---|---|---|
| 33-统一体验层设计 | 接入层决策、性能基线、BFF | 前端 → 网关 → agentscope-service |
| 20-场景考量点全景 | 十域决策点、管理对象、接缝 | 所有接缝的决策地图 |
| 21-沙箱资源管理 | R1–R5 分级、四钥匙、池化、配额 | Sandbox Manager → 存储/网络/配额 |
| 50-组织形态与能力开放 | 五层形态、六问矩阵、开放五件套 | 02×04×47 的组织级整合 |
观测与治理
| 篇目 | 这块积木负责什么 | 拼到哪个接口 |
|---|---|---|
| 14-可观测、评测与治理 | 12 类 span、指标、评测、门禁（含 Langfuse 选型、契约调用与 OpenJudge 评测实证） | 全链路 → OTel → 评测集 |
40（观测闭环选型）、42（OpenJudge 评测落地）、43（观测接口与契约手册）已并入 14，原文件留档；其实测结论同时收拢在 44-实证与验收总报告。
对标与深化
| 篇目 | 这块积木负责什么 | 拼到哪个接口 |
|---|---|---|
| 24-白皮书对标与落地推演 | 30 章逐条对标、22 条接缝、S0–S8 | 白皮书判据 → 全栏修订 |
| 25-Agent 仿真台落地设计 | Scenario/Manifest/Run/Result、证据链 | 生产内核 → 受控世界 → Evaluation |
| 26-调优闭环落地设计 | Trajectory/Pipeline/Dataset/Evaluator/Release | 生产 Trace → 数据 → 改进 → 发布 |
实施与验收
| 篇目 | 这块积木负责什么 | 拼到哪个接口 |
|---|---|---|
| 16-实施路线与参考部署 | S0–S8 分阶段切片与验收 | 全部组件的落地顺序 |
| 30-搭建过程与问题解决台账 | K 系列坑位、M1–M6 实证记录 | 搭建时查阅 |
| 31-环境重建与自动化部署手册 | M1–M6 命令级可复跑 | 部署时照做 |
| 44-实证与验收总报告 | 复核环境 + S1–S9 矩阵 + K17/K18 台账 + 4.5/5 验收 + 生产建议 | 复核验证者照做、决策是否进入生产 |
原 44（复核验证手册）、45（上游 Issue 草稿）、46（主线验收总结）已合并为 44-实证与验收总报告，原文件留档；49（上线检查清单）要点收拢于总报告 §五，清单原文保留发布前使用。
总览与规范
| 篇目 | 这块积木负责什么 | 拼到哪个接口 |
|---|---|---|
| 47-能力全景与接线计划 | 八域 44 项、G1–G12 缺口、选型总览 | 全局导航入口 |
| 48-组织运行时设计 | Team/编排/组织记忆 | 47 篇 D6 深化 |
| 23-术语与写作约定 | 术语/字段/状态/发布边界 | 全栏写作权威 |
前置知识
- Agent 循环、上下文、工具与 MCP：先读 Agent 工程体系。
- 平台分层与定义态/运行态：先读 企业智能体平台，那一栏讲与厂商无关的设计原则。
- 消息队列与 K8s：至少知道 Topic、分区、消费位点、Pod、Namespace 与 HPA，否则第 10 篇会变成名词堆叠。
怎么读
第一遍按十一个域顺着读，每读完一篇就把"它接在哪、带什么字段、失败怎么办"补进自己的拼装图。第二遍按角色切路径——README-总索引 §4 有五条推荐阅读线。
重点文档关系：
- 41 是主战场唯一实证出口——06/07/12/35 已并入 41，实施与接口查阅均以 41 为准（原文件留档）
- 14 是观测与治理归口——40（选型）、42（评测）、43（契约）已并入 14，实测结论另收拢于 44 总报告
- 19/32 是供给链路设计、38 分发实证（已归 08 线）；实例侧接缝合同见 36-平台层接缝摘要
- 22/24/25/26 是闭环深化——22 运行态收口、24 白皮书对标、25 仿真、26 调优
- 数字分身产品线（原 36/37/38/39 + 专栏）已独立为 08_企业员工数字分身，本栏仅保留 36-平台层接缝摘要（数字分身线）
- 44-实证与验收总报告合并原 44/45/46——复核、上游缺陷、验收结论一处读完
文中版本号与预览状态以官方文档为准，不要把预览能力写进关键路径的承诺。
适用：2026 年开源 Agent 平台组件 | 本索引 2026-10-28 收拢版：核心可导航文档约 30 篇，其余编号留作历史参考