主题
00 - 生态市场构建总纲（基于 HiMarket 的 Agent 能力市场）
一句话：以 HiMarket（Higress 生态企业级 AI 开放平台）为市场控制面，构建企业私有 AI 能力市场——模型 / MCP / Agent / Skill / Worker 五类业务资产，以及支撑调用的发布 → 订阅 → 授权 → 凭证注入 → 调用 → 计量 → 观测目标闭环（当前尚未完成）；HiMarket 不直接承载业务流量，数据面由 Higress 与执行层承担。 形态：独立产品线乐高积木——先在本专栏内闭环，再与其他积木（数字分身、托管执行体）拼接。 调研日期：2026-10-25；审核修订：2026-10-26 当前结论：POC 已有部分实证，尚未达到生产可上线状态。生产门槛、阻断项与修正架构见
05-AI基础设施架构审核与生产收敛.md；六视角评审、证据分级与 50 项闭环台账见06-架构委员会评审与闭环台账.md。 状态口径：05是架构基准，06是唯一状态源。设计完成、源码存在、单机 POC 均不等于生产验收；证据等级按 E0–E4 标注。
一、调研结论（HiMarket 是什么）
HiMarket = 基于 Higress AI 网关的企业级 AI 开放平台（官方："AI 的下一站"），以 API Product 统一承载能力目录。业务上可归纳为五类市场，但不能把“五类市场”误解为只有五个产品枚举：
| 市场 | 能力 | 底层承载 |
|---|---|---|
| 模型市场 | 公有云/私有模型接入，内容安全、Token 限流 | Higress AI 网关（AI Proxy 插件） |
| MCP 市场 | 接入各平台 MCP Server + 外部 API 转标准 MCP | Higress MCP 托管 / 代理 |
| Agent 市场 | Agent 应用打包上架，可对接 AgentScope 等构建平台一键注册 | Agent Endpoint / 网关路由 |
| Skills 市场 | 上传/分发 Agent Skill 包，浏览/订阅/安装 | 内容寻址（Nacos / git / 对象存储） |
| Worker 市场 | Worker（可装载 Skills 的执行单元）打包/版本化/分发，Nacos 批量导入 + CLI 安装 | Nacos / 控制面拉器 |
源码校正：当前快照的
ProductType共有 7 类：REST_API、HTTP_API、MCP_SERVER、AGENT_API、MODEL_API、AGENT_SKILL、WORKER。其中REST_API/HTTP_API不是独立“市场”，但会参与产品目录与发布；Skill/Worker 的元数据可以来自 Nacos，真正执行仍由消费端完成。
管理后台链路：注册管理员 → 导入 Higress 网关实例 → 创建 Portal（多租户门户）→ 创建 API Product（MCP Server / Model API / Agent API）→ 关联 API（ref 引用 Nacos / Higress）→ 编写使用指南 → 发布到门户。
开发者门户链路：注册 Developer（身份）→ 浏览/订阅 API Product → 创建 Consumer（调用凭证 API Key/Secret）→ 订阅审批 → 调用 → HiChat（模型对话 + MCP 工具测试）/ HiCoding（在线编码沙箱）。
核心机制（07-04 已沉淀，直接复用）：
- 产品模型：类型/端点/版本/鉴权/配额/可见范围/责任人/下线策略
- 双状态机解耦：发布决定"可被看见"，订阅决定"可被授权"，网关决定"这次调用放不放行"
- 计量≠计费：市场提供用量事实（第二层），价格/结算/对账在企业计费系统
- 引用而非副本：市场保存 ref（Nacos/Higress），不复制能力定义；需对账防目录漂移
二、源码事实（本地盘点）
代码树：C:\Users\Administrator\Desktop\02-项目代码\himarket（Java Spring 全家桶）。本地 Git 快照为 3a63fc5（2026-10-23），pom.xml 版本为 1.0-SNAPSHOT，不能等同于某个正式发布版。
| 模块 | 职责 |
|---|---|
himarket-bootstrap | 应用启动 |
himarket-server | API 服务（当前快照 28 个 Controller） |
himarket-dal | 数据访问（entity/repository） |
himarket-web | 前端（管理后台 + 开发者门户） |
harness | 编码 Harness（HiCoding 配套） |
sandbox | 执行沙箱 |
server 端 Controller 全景（当前快照 28 个）：
| 面 | Controller |
|---|---|
| 管理面 | Administrator / AdminSetting / Portal / Product / ProductCategory / ApiDefinition / Gateway / Consumer / Developer / ExternalVendor / Attachment |
| 市场面 | McpServer / OpenApiMcp / Skill / Worker / AiRegistry |
| 体验面 | Chat（HiChat）/ CodingSession（HiCoding）/ Sandbox / Workspace / Session / CliProvider |
| 治理面 | Observability / Sls / DBCollector / Nacos |
| 身份面 | OAuth2 / Oidc |
三、已有设计基础（07 专栏三篇可复用进本专栏）
| 篇 | 内容 | 复用方式 |
|---|---|---|
| 07-04 能力市场 HiMarket | 市场机制（产品模型/双状态机/计量/供给同步） | 直接引用为本专栏机制篇 |
| 07-32 HiMarket 集成接线 | 六层组件角色、五条接线链路、六个接缝、P0-P5 | 契约整合篇回填（与 agentscope 的接缝） |
| 07-38 市场与实例配置打通 | Skill/MCP 分发双向打通（下行安装/上行上架） | 分发闭环篇回填（实证后） |
四、专栏结构（各篇定位）
| 篇 | 主题 | 内容 |
|---|---|---|
| 00 | 本总纲 | 定位/调研/结构/台账 |
| 01 | HiMarket 底座与五类市场 | 源码盘点：28 个 Controller、7 类 ProductType、Portal/API Product |
| 02 | 三角接线 | HiMarket × Higress × Nacos × 企业 SSO；引用模型与 OIDC 边界 |
| 03 | 企业落地推演 | 七阶段落地、关键决策、HA/SLO/安全闸门 |
| 04 | 本地部署实证 | 模型 / Skill / MCP 三类产品；Nacos 导入、发布与订阅实证 |
| 05 | AI Infra 审核与生产收敛 | 架构基准：控制面/数据面、凭证中介、SLO/容量/灾备、验收闸门 |
| 06 | 架构委员会评审与闭环 | 状态源：六视角评审、E0–E4 证据分级、50 项缺口台账、ADR、闸门状态板 |
| 10 | 知识底座开题 | RAG/Connector 选型、Knowledge Broker、评测与治理 |
| 11 | 知识库落地实证 | RAGFlow RC 小样本链路、模型供应、API 验证与生产边界 |
| 12 | 记忆底座实施方案 | 百炼记忆对标、mem0 + Qdrant、隔离/审计/删除 |
| 13 | 记忆底座 POC 实证 | mem0 服务化、事实记忆/画像/审计链路与生产化差距 |
| 14 | 包皮总体架构与统一入口网关需求 | 目标态施工图（上）：Java 模块、页面地图、网关 10 项能力 |
| 15 | 按百炼能力面的模块需求清单（上） | 目标态施工图：Agent 开发运行 + 上下文 8 模块 |
| 16 | 按百炼能力面的模块需求清单（下）与路线 | 目标态施工图：治理/Store 5 模块、权限审计、里程碑与对标 |
原计划中未实际成稿的篇目（供给链、订阅、网关计量、体验中心、部署二开等）不再保留空编号；其中关键架构内容已并入 02/03/04/05，知识与记忆分别落在 10/11/12/13。后续新增篇目应使用连续编号并回写本表。
施工图边界：14–16 是生产目标态施工图，不是生产验收结论；其 Java 模块 M0–M8 与功能里程碑 0–3 不等于 P0/P1/P2 生产闸门（ADR-11）。文中“已实证”只按 E1（源码/接口）或 E2（单机 POC）解释，生产结论以 06 的证据等级为准。
五、实证台账（截至 2026-10-26）
| 能力 | 状态 | 证据 |
|---|---|---|
| HiMarket 源码拉取与盘点 | ✅ | 本地代码树（commit 3a63fc5）+ 28 Controller 清单 |
| 官方用户指南全流程梳理 | ✅ | USER_GUIDE_zh（管理后台/开发者门户） |
| 五类市场机制分析 | ✅ | 07-04 |
| 与 agentscope 接线设计 | ✅ | 07-32（六层角色/五链路/六接缝/P0-P5） |
| Skill/MCP 分发设计 | ✅ | 07-38（双向打通） |
| HiMarket + Nacos 接线实证 | ✅ | 04 篇（2026-10-25 本机：mysql/nacos/server/admin/frontend/sandbox healthy；Higress 不在该次最小集内） |
| Skill 市场搜索 + 安装进池实证 | ✅ | #22（qwenpaw 实例侧，source=customized）+ 04 篇（HiMarket 侧：Nacos 导入 AGENT_SKILL=174） |
| 模型市场实证 | ✅ | 04 篇（MODEL_API 产品创建：TokenPlan Qwen Max + modelFeature；发布 + 订阅 APPROVED） |
| MCP 市场目录与订阅 | ✅ | 04 篇（MCP_SERVER 产品 + meta streamable_http；发布 + 订阅 APPROVED） |
| MCP 端到端调用 | ⏳ | 未完成真实 MCP Server → Higress → 工具发现 → 调用 → 计量 |
| 部署闭环（发布→审批→订阅→凭证→调用→计量） | ⏳ | 订阅链已验证；凭证签发、数据面调用、限流与计量尚未闭环 |
| RAGFlow 单机小样本链路 | ✅（POC） | 11 篇：v1.0.0-rc2 建库/上传/解析/检索/问答；仅 4 chunk / 193 tokens |
| 知识库多租户与越权测试 | ⏳ | 尚未执行负向测试 |
| 记忆服务服务化 | ✅（POC） | 13 篇：mem0 + Qdrant + FastAPI 链路；身份绑定/跨租户/删除/投毒/HA 未完成 |
| 记忆库生产隔离与删除 | ⏳ | 12 篇设计已补强，13 篇未验证 |
| 生产级 HA / 容量 / 灾备 | ⏳ | 只有建议目标，无压测与故障演练证据 |
| 与 agentscope-service 契约整合实证 | ⏳ | 待 07-32 P2-P4 落地 |
| 架构委员会评审与闭环台账 | ✅（桌面评审） | 06 篇：6 视角、50 项缺口、25 项 P0、ADR 与证据分级；企业正式会签未做 |
| 14–16 目标态施工图 | 📝（设计） | 14/15/16 篇：模块需求、权限模型、里程碑；证据等级 E0/E1，不等于已实现 |
六、演进路线（乐高拼接）
- 先过评审闸门（G0）：以 06 台账锁定 P0 与证据等级，完成边界、身份、凭证、授权传播、隔离与版本的闭环设计与会签；
- 再补治理闭环（P0，6–8 周）：修 OIDC 验签，建立工作负载身份与 Agent 委托，打通真实 MCP/模型的订阅→凭证→调用→计量，收口密钥不落客户端；
- 知识闭环（P1）：锁定 RAGFlow 稳定版，引入 Knowledge Broker，完成 ACL、评测与 HA；
- 记忆闭环（P2）：记忆服务化，强隔离、幂等、删除与审计；
- 契约整合：按 07-32 对接 agentscope-service，但以 05 篇的身份/凭证契约为准；
- 统一入口“皮”：在前五步稳定后再做 Java 聚合模块与页面定制，避免把门户皮建立在未稳定的数据面上。
边界
- 本专栏不解决执行：市场管产品化与授权，执行在 agentscope-service/实例侧；
- 本专栏不解决计费结算：提供用量事实，价格/账单在企业计费系统；
- 发现≠授权：目录可见/体验可试 ≠ 生产可调用；
- 设计≠验收：14–16 是目标态施工图；任何“已实现/已实证”必须按 06 的 E0–E4 标注，状态以 06 为准；
- 源码基线：本地快照为
1.0-SNAPSHOT，不是 v0.5.0；升级或 fork 前必须固定 commit、镜像 digest 与数据库迁移方案； - 生产边界：当前只能定位为 POC；上线前必须满足 05 篇的 P0 闸门与 06 的 P0 关闭集，不能把订阅 APPROVED 当作生产能力。