重构: aichat agent 能力系统化(L1元能力+L2/L3后端+list去重)

L1 agent 元能力层(治痛①死循环零交付):
- env_profile 环境姿势注入 + shell 默认 PowerShell(防引号地狱)
- 断路器:同类工具失败≥3熔断 + guard.reset
- detect_environment 主动探测工具(python/node/shell)
- 求助协议 AiHelpRequired 事件 + 前端求助卡

L2 统一状态机后端(治痛②,前端批2):
- ConvState enum 5态 + 合法转换守卫(conv_state.rs)
- GeneratingGuard 接入视图层(guard.rs)

L3 事件总线后端骨架(治痛③④⑤,接入批2):
- EventBus pub-sub + AiBusEvent 8变体(event_bus.rs)

list 工具调用重复治理第一步:
- build_system_prompt_with_excluded 去重被@实体 + 清单注明语

src-tauri/src/commands/ai/mod.rs

@@ -13,6 +13,7 @@
 //! - [`prompt`] — 系统提示词构建
 //! - [`provider_pool`] — F-260614-04 多 Provider 负载均衡池选择(纯逻辑)
 //! - [`compress`] — F-15 上下文压缩 LLM 摘要(compress_via_llm 公共函数)
+//! - [`event_bus`] — L3 全局事件数据总线 pub-sub 骨架(broadcast,渐进第一步,未接入 emit)
 //! - [`tool_registry`] — AI 工具注册表构建 + 文件路径校验
 //! - [`knowledge_inject`] — 知识库注入 + 提炼
 //! - [`augmentation`] — 上下文增强
@@ -31,6 +32,7 @@ pub mod audit;
 pub mod commands;
 pub mod compress;
 pub mod conversation;
+pub mod event_bus;
 pub mod http;
 pub mod knowledge_inject;
 pub mod prompt;
@@ -175,6 +177,26 @@ pub enum AiChatEvent {
     AiCompressing { conversation_id: Option<String> },
     /// F-15 阶段2 手动 LLM 压缩完成:摘要已插入消息首位,前端可展示摘要 + 移除压缩中态。
     AiCompressed { conversation_id: Option<String>, summary: String },
+    /// L1 求助协议(aichat 体验与 agent 能力系统化重构 §2.3,2026-06-21):
+    ///
+    /// agent 断路器(§2.2)熔断 / 自省(识别"我反复失败")时发,区别于 prompt 教 AI
+    /// 「失败就问用户」——LLM 不可靠,故用结构化事件 + 前端求助卡(机制优先 prompt 说教)。
+    ///
+    /// 字段语义:
+    /// - `reason`:求助原因(死循环/环境未知/权限不足等可读摘要,前端直接展示)
+    /// - `context`:已试情况(失败次数/最近错误 sample/卡在哪),供用户判断如何介入
+    /// - `options`:建议选项(如 [换思路/授权路径/人工接管]),前端渲染为按钮供用户选
+    /// - `conversation_id`:多对话路由(与其他事件一致)
+    ///
+    /// 与 AiApprovalRequired 区分:审批=工具执行前确认;求助=AI 主动「我搞不定」。
+    /// 与 AiMaxRoundsReached 区分:达 max 是被动截断;求助是主动识别卡点。
+    /// 兜底:开关 CIRCUIT_BREAKER_ENABLED=false 或求助消费方未接 → 后端保留 AiError 终态分支兜底。
+    AiHelpRequired {
+        reason: String,
+        context: String,
+        options: Vec<String>,
+        conversation_id: Option<String>,
+    },
 }
 
 // ============================================================