---
name: decision_gateway
when: '代码执行, 代码生成, 自动执行, 自动生成, LLM 预算, Token 控制'
scope: ['*']
products:
  - '*'
id: ka-pattern-decision_gateway
asset_kind: pattern
lifecycle_status: active
authority: supporting
routes:
  - '*'
primary_triggers:
  - 代码执行
  - 代码生成
  - 自动执行
  - 自动生成
  - LLM 预算
  - Token 控制
priority: P2
specificity: 3
version: 1.1.0
last_reviewed: '2026-06-01'
consumes: []
emits: []
secondary_triggers: []
negative_triggers: []
type: pattern
stages: ["*"]
owner_mechanism_id: mc-engine-runtime
---

## 决策规则

- LLM Gateway Token 全局预算上限 Budget_Total = 100000（advisory，不 hard block）
- LLM Gateway 单任务预算上限 Task_Budget = 30000（advisory，预算耗尽返回 warning 不阻断）
- H1 handler 返回 h1_advisory warning，任务仍继续进入 executing
- 熔断触发比 Circuit_Breaker_Ratio = 0.9，超过即 advisory 告警并建议降级模型
- 重型操作分级 tier=heavy 自动启动流式心跳（advisory）
- 心跳间隔 Heartbeat_Interval = 5000 毫秒
- 控制流操作（classify/scope_resolve/drift_detect 等）走本地，不消耗 Token
- 决策流操作（intent_refinement/solution_brainstorm/code_generation 等）走 Gateway，消耗 Token
- AI 操作分级: light（<2000）/ medium（2000-3000）/ heavy（>3000）
- 信心门限 Confidence_Threshold = 0.95，低于此值走 sf_brainstorm 补充

## 验收项

- [AC-01] Token 消耗监控按 operation_type 追踪
- [AC-02] 预算超限返回 advisory warning，不阻断任务
- [AC-03] 熔断后 AI 操作建议降级模型（advisory）
- [AC-04] 心跳在重型操作期间每 Heartbeat_Interval 毫秒输出进度
- [AC-05] 每次请求返回 remaining_budget 和 remaining_task_budget

## 何时使用

advisory: 预算耗尽是 warning 不是 hard fail，不应阻断任务

## 是否 hard block

否。此能力为 advisory 状态，违规仅产生 advisory 警告，不阻断流程。

## 证据要求

- H1/H4 handler 测试通过
- heartbeat 测试通过
-

## 人工确认/降级边界

- 此能力可被开发者决策覆盖
- 升级到 enforced 需满足 promotion_conditions 并通过 lifecycle_test_files 测试
- 降级/禁用需经 sf_capability_update + 人工确认
