主题
总索引：07_开源生态企业智能体平台
本目录系统性梳理总入口（2026-10-28 收拢版：核心 30 篇 + 留档参考，合并映射见 §2.1）。 用法：按“分组 → 阅读顺序 → 状态”三列定位；“三类问题”见 §3（汇总/补充/修正清单）。
1. 分组导航（核心 30 篇 + 留档参考 · 2026-10-28 收拢版）
方法论与总览（5）
| 编号 | 文档 | 一句话定位 | 状态 |
|---|---|---|---|
| 00 | 学习路线 | 全局学习路径与前置知识 | 入口 |
| 01 | 落地方法论与总体架构 | 总体架构与落地方法 | 设计 |
| 47 | 能力全景与接线计划 | 八域 44 项、G1-G12 缺口台账、选型总览 | 总览 |
| 48 | 组织运行时设计 | 批 5 组织化（Team/编排/组织记忆） | 设计 |
| 23 | 术语与写作约定 | 术语/字段/发布边界（权威） | 规范 |
身份·网关·安全（3）
| 编号 | 文档 | 一句话定位 | 状态 |
|---|---|---|---|
| 02 | 账号租户与命名空间 | 三类主体×五级作用域、信封 | 设计 |
| 03 | 入口与模型网关 Higress | LLM/MCP/Agent 三类网关语义 | 设计+部分实证 |
| 15 | 安全与多租户隔离 | 纵深防御、数据面身份注入方案（C1 已定稿，含数字分身路径 2） | 设计+关键定稿 |
控制面与主战场实证（1）
| 编号 | 文档 | 一句话定位 | 状态 |
|---|---|---|---|
| 41 | AgentScopeService 领域模型与使用语义全景 | 资源抽象/执行语义/存储/编排唯一实证出口 | 实证 ✅（06/07/12/35 已并入） |
任务与路由（2）
| 编号 | 文档 | 一句话定位 | 状态 |
|---|---|---|---|
| 05 | 模型与任务路由 HiRoute | 四策略路由 + 决策/派发语义 | 调研（09/10 已并入） |
| 22 | 架构评审与任务闭环 | 任务账本、审批、证据链 | 设计 |
供给·注册·市场接线（5 + 1 留档）
| 编号 | 文档 | 一句话定位 | 状态 |
|---|---|---|---|
| 04 | 能力市场 HiMarket | 市场产品模型（接入层底座） | 调研 |
| 08 | 注册与配置 Nacos | 三使用面、资产元数据、Resolver | 调研 |
| 19 | Skill 与 MCP 供给链路 | 供给生命周期、Nacos 集成 | 设计 |
| 32 | HiMarket 集成接线设计 | 元信息↔运行时同步、权威归属 | 设计+决策 |
| 36 | 平台层接缝摘要（数字分身线） | 07↔08 接口合同（agentscope 适配/网关身份转换/供给分发） | 合同页（新建） |
| 38 | 市场与实例配置打通 | Skill/MCP 分发实证 | 留档（已归 08 线） |
集成与交付（2）
| 编号 | 文档 | 一句话定位 | 状态 |
|---|---|---|---|
| 11 | 编码 Harness 接入 | OpenCode/Claude Code/Codex 接入面 | 设计 |
| 13 | 协议渠道与集成地图 | A2A/AG-UI/MCP/四通信面 + Hub/交付/执行体语义 | 调研（17/18/34 已并入） |
体验与场景（4）
| 编号 | 文档 | 一句话定位 | 状态 |
|---|---|---|---|
| 33 | 统一体验层设计 | 接入层决策、BFF 定位 | 设计 |
| 20 | 场景考量点全景 | 十类考量+管理对象+十二接缝 | 设计 |
| 21 | 沙箱资源管理 | R1-R5 分级、四钥匙隔离 | 设计+实证对照 |
| 50 | 组织形态与能力开放设计 | 五层形态×六问矩阵、开放五件套 | 调研+设计 |
观测与治理（1）
| 编号 | 文档 | 一句话定位 | 状态 |
|---|---|---|---|
| 14 | 可观测、评测与治理 | 12 类 span、Langfuse 选型、评测门禁、契约调用 | 归口（40/42/43 已并入） |
对标与深化（3）
| 编号 | 文档 | 一句话定位 | 状态 |
|---|---|---|---|
| 24 | 白皮书对标与落地推演 | 22 条接缝、缺口台账、装配顺序 | 对标 |
| 25 | Agent 仿真台落地设计 | S7 仿真台对象模型 | 设计 |
| 26 | 调优闭环落地设计 | S8 数据飞轮（Trajectory→Release） | 设计 |
实施与验收（4 + 1 留档）
| 编号 | 文档 | 一句话定位 | 状态 |
|---|---|---|---|
| 16 | 实施路线与参考部署 | S0–S8 分阶段切片与验收 | 路线 |
| 30 | 搭建过程与问题解决台账 | K 系列坑位全量、M1-M6 | 台账 |
| 31 | 环境重建与自动化部署手册 | M1-M6 命令级可复跑 | 手册 |
| 44 | 实证与验收总报告 | 复核环境 + S1-S9 矩阵 + K17/K18 台账 + 4.5/5 验收 + 生产建议 | 验收出口 ✅（原 44/45/46 已合并） |
| 49 | 上线检查清单 | 逐项核对（要点收拢于 44 §五） | 留档 |
数字分身产品线（已迁出）
原 36/37/38/39 与专栏子目录已整体迁至 08_基于QwenPaw的企业员工数字分身；旧文件加警示留档，专栏子目录已删除。07 侧接口合同只读 36-平台层接缝摘要（数字分身线）。
2. 编号变更对照（2026-10-26 大扫除）
| 旧编号 | 新编号 | 说明 |
|---|---|---|
| 99-检查清单 | 49-上线检查清单 | 消除三连编号冲突，引用已同步（00/12/15/21/24/26/30/32 篇） |
| 99-组织运行时设计 | 48-组织运行时设计 | 同上 |
| 99-能力全景与接线计划 | 47-能力全景与接线计划 | 同上；"99 台账/99 篇/99 清单/99 §x"引用全部改 47 |
| 29 篇 | （并入 47 篇） | 29 篇 Team/编排专题未单独成篇，内容并入 47 能力全景 §四/§8；24 篇引用已标注"原 29 篇并入" |
| 27/28 篇 | （从未存在） | 编号断档非缺失，规划时预留，不补空号 |
| 35-…包皮调用 | 35-…网关接入调用 | 用词规范化（正文此前已规范，仅文件名残留） |
2.1 合并映射（2026-10-28 收拢版）
| 来源 | 归口 | 说明 |
|---|---|---|
| 原 44（复核验证手册）+ 45（上游 Issue 草稿）+ 46（主线验收总结） | 44-实证与验收总报告 | 实证三篇合一，作为主战场唯一验收出口；45/46 原文留档并加提示（旧 44 复核手册原文保留代码片段证据） |
| 原 36/37/38/39 + 专栏-基于开源生态的员工数字分身落地/ | 08_基于QwenPaw的企业员工数字分身（产品线）+ 36-平台层接缝摘要（数字分身线）（07 合同页） | 产品线整体迁至 08；专栏子目录已删除；旧 36/37/38/39 加 ⚠️ 留档 |
| 06（内核）+ 07（控制面）+ 12（状态记忆）+ 35（接口清单） | 41-领域模型与使用语义全景 | 设计版/清单版并入实证全景 |
| 09（Jev 决策）+ 10（LiteTopic 派发） | 05-模型与任务路由 HiRoute | 决策与派发语义并入路由篇 |
| 17（个人助理 Hub）+ 18（产出物 IM 交付）+ 34（OpenCode 执行体） | 13-协议渠道与集成地图 | 渠道/交付/执行体并入集成地图 |
| 40（观测选型）+ 42（OpenJudge 评测）+ 43（观测契约手册） | 14-可观测评测与治理 | 观测四件套归口一篇；实测数据另收拢于 44 总报告 |
| 49（上线检查清单） | 要点收拢 44 总报告 §五 | 清单原文保留发布前使用 |
3. 三类问题清单（系统性梳理结论）
3.1 应汇总（内容重叠，阅读时以实证版为准）
| 重叠组 | 文档 | 处理建议 |
|---|---|---|
| AgentScope 内核 | 06（入门）→ 41（源码实证全景） | ✅ 已并入 41（06/12 留档为概念版） |
| 控制面运行时 | 07（早期）+ 35（接口清单）→ 41（§10.x 实证） | ✅ 已并入 41 |
| 任务与路由 | 09/10 → 05 | ✅ 已并入 05 |
| 集成与交付 | 17/18/34 → 13 | ✅ 已并入 13 |
| 观测链路 | 14（信号定义）+ 40（Langfuse 选型）+ 42/43（实证落地） | ✅ 已并入 14；实测结论同收拢于 44 总报告 |
| 市场供给 | 19（供给链路）→ 32（接线设计）→ 38（实证分发） | 19/32 设计继续有效；38 已归 08 线留档，✅ 07 侧合同页由 36-平台层接缝摘要承接 |
| 数字分身 | 36/37/39 + 专栏-数字分身子目录 | ✅ 已迁 08 产品线；专栏子目录已删除；07 只留 36-平台层接缝摘要 |
| 工程验证 | 原 44（复核）+ 45（Issue）+ 46（验收） | ✅ 已合并为 44-实证与验收总报告（30 台账/31 手册独立保留） |
| 反馈闭环 | 25（仿真台 S7）→ 26（调优 S8） | S7/S8 两件套，S8 核心链路不依赖 S7（见 16 篇复核意见） |
| 总览 | 47（能力全景）← 引用 00-26 篇 | 47 是全局导航，所有缺口/选型从 47 进 |
3.2 需补充知识（待办，按优先级）
| 优先级 | 待补项 | 涉及文档 |
|---|---|---|
| P0 | ✅ C1 方案已核对（15 篇 §9.3 定稿：两条注入路径+验收 V1-V5+上线门禁；实施未做，属独立决策项——需 fork 控制面或 sidecar） | 15 → 44（新增场景） |
| P0 | ✅ 7 处源码改动已补 diff 证据（44 篇 §2.2 新增代码片段小节，2026-10-26 本机构建版本核对） | 44 §2.2 |
| P0 | ⏳ Issue 草稿提交 GitHub（45 篇为可提交终稿；提交动作需 GitHub 登录，待用户操作或授权接管） | 45 |
| P1 | ✅ Nacos 扩展包已核实（agentscope-extensions-nacos 三子模块源码坐实：nacos-skill/a2a/prompt；service 标准 type 分派仅 filesystem/git → 32 篇口径已修正） | 32/19 |
| P1 | ✅ 观测链路已回写：14 篇补 OTel 后端=Langfuse 声明；40 篇新增 12 类 span→Langfuse 映射表；43 篇补 usage 成本配置+budget 推荐值 | 14/40/43 |
| P1 | ✅ 31 篇已补 M5/M6 扩展部署（§8.1：MCP/Skill/Higress/QwenPaw 命令级）+ schema 修复（item_key VARCHAR(2048) DDL） | 31 |
| P1 | ✅ 16 篇已补 Langfuse 资源估算（9C/21.5GiB）+ Runbook 新增 ClickHouse/Langfuse/PG 迁移三故障 | 16 |
| P1 | ✅ 42 篇 TrajectoryGrader 已定论（读 openjudge 0.2.4 源码：换 ToolSelectionGrader，输入契约与 43 篇 tools 端点实测吻合） | 42 |
| P2 | ✅ 13/06/12 篇已修（A2A/AG-UI 成熟度警示；06 prepareRun 真实签名标注；12 篇改"五类数据"） | 13/06/12 |
| P2 | ✅ 20 篇已补 Channel 管理对象+数据驻留说明 | 20 |
| P2 | ✅ 04/32 篇已核实 HiMarket 版本（v0.50，非 v1.0；观测分析依赖阿里云 SLS）+风险重评 | 04/32 |
3.3 错写（2026-10-26 已全部修正）
| 项 | 位置 | 状态 |
|---|---|---|
| 35 篇文件名"包皮调用" | 文件名 | ✅ 已改"网关接入调用" |
| 99 三连编号冲突 | 3 文件+10 篇引用 | ✅ 已改 47/48/49 并全量同步 |
| "29 篇"断档引用 | 24/47 篇 | ✅ 已标注并入 47 |
| 45 篇 Issue B 无平台侧规避 | 45 篇 | ✅ 已补 4 条规避方案 |
| 46 篇"4.5/5 乐观" | 46 篇 | ✅ 已改"能力实证 4.5/5 + Chat UI P0"，补临时替代 |
| 06 篇 API 示例（prepareRun 签名不实） | 06 篇 | ✅ 已修正（真实签名 prepareRun(List<Msg>, RuntimeContext)，ReActAgent.java:1409 坐实） |
| 07 篇成熟度高估（channels 404/LEGACY NPE 未预警） | 07 篇 | ✅ 已加 beta 级成熟度标注（UI Chat 缺陷/LEGACY NPE/channels 404/K18） |
| 32 篇 Nacos 集成结论（可能过悲观） | 32/19 篇 | ✅ 已核实并修正（2026-10-26：官方有 nacos 扩展但 service 配置入口不支持，需自定义装配） |
| 12 篇"四类数据四种存储"实为五行 | 12 篇 | ✅ 已改"五类数据，五类存储" |
| 20 篇缺 Channel 管理对象 | 20 篇 | ✅ 已补（第十个管理对象 + 数据驻留规则） |
| 04/32 篇 HiMarket 版本口径 | 04/32 篇 | ✅ 已核实 v0.50（非 v1.0）+ SLS 观测缺口 |
4. 阅读导航
| 读者 | 推荐路径 |
|---|---|
| 新读者（了解全局） | 47（能力全景）→ 24（对标）→ 00（学习路线） |
| 平台实施者 | 44（总报告 §一/§二）→ 41（领域模型）→ 31（部署） |
| 复核验证者 | 44（总报告 S1-S9 + 期望值速查）→ 14（观测/评测，40/42/43 已并入）→ 41（缺陷定位背景） |
| 数字分身线 | 08-方案总纲 → 08 各篇；07 侧只读 36-平台层接缝摘要 |
| 市场供给线 | 32（接线）→ 19（供给）→ 04（HiMarket）；实例分发看 36 摘要 §三（38 留档） |
| 组织与开放线 | 47（能力全景）→ 48（组织运行时）→ 50（组织形态与能力开放） |