Experience Recipe 能力参考

版本口径：v2.0

状态：已签收

实现范围：Java/MCP minimum

Experience Recipe 是可治理的经验方案资产。它把已经签收的分析方案、必要参数、证据和治理条件沉淀下来，让 router / planner 在合适上下文中复用，而不是每次都重新发明复杂计划。

定位

Experience Recipe 适合：

• 高频复杂分析流程复用。
• 记录签收模型、字段、route、参数和边界。
• 在 namespace、tenant、permission、owner 条件满足时进行发现。
• 对缺参、冲突、未激活或权限不匹配场景保持可审计拒绝。

Recipe 不能绕过 TM/QM、权限、validator 或 signed contract。

已签能力

Runtime Lookup 语义

dataset.search_experience_recipes 的 registryKey exact lookup 仍然执行治理过滤：

• registry key 必须匹配。
• recipe 必须 validated。
• recipe 必须 active for discovery。
• namespace 必须匹配。
• tenant 必须匹配。
• permission tags 必须满足。
• owner delegation 必须满足。

精确 key 不会绕过权限，也不会让 draft、candidate、rejected 或 deprecated recipe 被返回。

Evidence Artifact

v2.0 记录的是 artifact reference 和基础校验，不等于完整对象存储可信链路。

可记录：

• artifact refs。
• artifact hash 格式。
• URI 形态。
• publish response 回显。
• event audit。
• signature verifier SPI 结果。

不承诺：

• 真实 S3/OSS native resolver。
• 远端对象权限。
• KMS / 信任根。
• 密钥轮换或撤销。
• 完整管理后台。

Fail-closed 规则

以下情况应返回空结果或阻断发布：

• registry key 不匹配。
• recipe 未 validated。
• recipe 未 activeForDiscovery。
• namespace / tenant / permission / owner 不匹配。
• publish 缺少必需 evidence artifacts。
• strict signature 模式下缺 verifier。
• verifier 返回 invalid signature。

不纳入 v2.0

Experience Recipe v2.0 不承诺：

• 完整 recipe 市场。
• 向量检索、全文检索或混合检索。
• recipe ranking。
• 产品管理台。
• 人工审核 UI。
• recipe 对引擎 validator 的绕过能力。

与 LLM Planner 的关系

Recipe 可以给 planner 提供结构化经验，但 planner 仍必须输出受治理 plan。命中 recipe 后仍要经过模型、权限、字段、规模和 signed contract 校验。