优化: 清理无意义注释(走查编号前缀/过时历史标注/死代码注释)

2026-08-15 18:05:43 +08:00
parent 5a4c821629
commit 5ac815b9ca
137 changed files with 735 additions and 737 deletions
@@ -165,7 +165,7 @@ pub(super) async fn maybe_auto_compress(
                String::new()
            };

-            // L0-3:保护区外无 active 可压缩(active_msgs 空)→ noop,同步复位 is_compressing
+            // 保护区外无 active 可压缩(active_msgs 空)→ noop,同步复位 is_compressing
            // 后返回(不 spawn 空任务)。对齐原 Ok(None) 分支语义。
            if active_msgs.is_empty() {
                session_arc.lock().await.conv(&conv_id).messages.set_compressing(false);
@@ -277,7 +277,7 @@ pub const CIRCUIT_BREAKER_THRESHOLD: u32 = 3;
 /// 单轮并行失败爆发,又足够长以容忍偶发抖动。
 pub const CIRCUIT_BREAKER_WINDOW: usize = 20;

-/// BE2(AC-EFF-R2-1):断路器/探索熔断读消息的尾部窗口大小。
+/// BE2 断路器/探索熔断读消息的尾部窗口大小。
 ///
 /// count_recent_failures / check_stall_breaker 只关心最近若干条消息(末尾工具结果 + 其前驱
 /// assistant tool_calls / 最近几轮工具签名),用 ContextManager::recent_messages 只 clone 尾部
@@ -570,7 +570,7 @@ async fn stream_with_retry(
 /// 表达本轮的 4 种结束路径,供 loop 主框架据以 `return` 或继续后续处理。
 ///
 /// **不在本函数范围**(loop 内其它段):
-/// - 停止/收敛/审批等待/熔断(L1815-L1917):这些在 process_tool_calls 之后,
+/// - 停止/收敛/审批等待/熔断这些在 process_tool_calls 之后,
 ///   属「工具执行后路径」,与流式调用本身解耦,留 loop 主体。
 /// - 正常完成(loop 外 L1957+):loop 退出后由 run_agentic_loop 直收尾。
 enum RoundOutcome {
@@ -1096,12 +1096,12 @@ pub(crate) async fn run_agentic_loop(
    // 单 provider 场景:池仅 1 enabled provider → select 返回单元素 Vec → 首位 = 唯一 provider,
    // 行为同 F-01 前(零变化)。空池(0 enabled)→ fallback 入参 provider_config(保启动行为)。
    //
-    // F-04b:select 返回的**完整有序 Vec** 即 fallback 序(主→备用)。本轮接入真实切换:
+    // b:select 返回的**完整有序 Vec** 即 fallback 序(主→备用)。本轮接入真实切换:
    // 流式重试块外层包 `for candidate in &candidates`,主 candidate InitFailed{retryable=true}
    // 耗尽 → continue 切下一 candidate(stream_one_provider 内重建 build_provider + resolved_model
    // 在新 candidate.model_configs 上重算 select_model_id);Fatal(4xx 非429)立即放弃整轮。
    //
-    // 主候选的 model_configs 用于路由(F-01),其 provider_config 用于 build_provider。
+    // 主候选的 model_configs 用于路由,其 provider_config 用于 build_provider。
    // compress_via_llm / 标题 / 后台 spawn 沿用主 candidate(非 fallback 范围,见各调用点注释)。
    //
    // AiProviderRepo::new 仅 clone Arc<Database>(廉价),不复用 AppState.ai_providers
@@ -1212,7 +1212,7 @@ pub(crate) async fn run_agentic_loop(
        }
    };
    // 用主候选覆盖入参 provider_config(下游 build_provider / 路由 / 日志均用此)。
-    // mut:F-04b 切换 candidate 后更新为实际成功所用 provider(供后续 push/save/标题 spawn)。
+    // mut:b 切换 candidate 后更新为实际成功所用 provider(供后续 push/save/标题 spawn)。
    let mut provider_config = primary_provider;
    // 诊断日志:401/错误时据此定位是 url/type/model/key 哪项问题(只记长度不记明文)
    tracing::info!(
@@ -1250,7 +1250,7 @@ pub(crate) async fn run_agentic_loop(
    // 用户指定模型 override 穿透(仅主对话生效,标题/扫描/灵感仍走路由)。
    // 兜底原则:override 非空且在该 provider model_configs 池中 → 用 override;否则用 resolved_model。
    // 绝不让 override 导致无模型(空/不在池 → 落回路由结果,行为不变)。
-    // mut:F-04b 切换 candidate 后由 stream_one_provider 返回的 Success.resolved_model 覆盖
+    // mut:b 切换 candidate 后由 stream_one_provider 返回的 Success.resolved_model 覆盖
    // (新 candidate 模型池不同,必须重选);此后 push/save 均用迭代最新值。
    let mut resolved_model = match model_override.as_deref() {
        Some(id) if !id.is_empty()
@@ -2238,7 +2238,7 @@ async fn count_recent_failures(
    conv_id: &str,
    fail_window: &mut std::collections::VecDeque<String>,
 ) -> (u32, String) {
-    // BE2(AC-EFF-R2-1):只克隆尾部 BREAKER_TAIL_N 条,避免 all_messages_clone 全量深克隆
+    // BE2只克隆尾部 BREAKER_TAIL_N 条,避免 all_messages_clone 全量深克隆
    // (长对话每轮 O(n) clone 浪费)。窗口覆盖末尾 Tool 结果与其前驱 assistant tool_calls
    // (同轮工具回填通常 1~5 条,40 足富余;超窗工具映射退化为 unknown_tool,仅失败分组更粗,不误熔断)。
    let messages = {
@@ -2298,7 +2298,7 @@ async fn count_recent_failures(
 ///
 /// - run_command 等带 exit_code → `tool_name::exit=N`(非零退出码即失败类别)。
 /// - status=failed/error envelope → `tool_name::error:<错误文本稳定哈希>`:
-///   用 fxhash 风格简单 FNV-1a 哈希避免裸截内容前缀(前 40 字符易把同类失败拆多 key
+///   用 fxhash 风格简单 a 哈希避免裸截内容前缀(前 40 字符易把同类失败拆多 key
 ///   或异类误聚)。哈希值非敏感信息(仅断路器分组用),无碰撞顾虑(N=20 窗口内几无碰撞)。
 /// - 内容解析失败(非 JSON)→ is_failure_content 已返回 false 不会进本函数,
 ///   此处兜底返回 `tool_name::unknown` 防御。
@@ -2327,7 +2327,7 @@ fn failure_key(tool_name: &str, content: &str) -> String {
    format!("{}::{}:{:08x}", tool_name, bucket, h)
 }

-/// FNV-1a 32-bit 哈希(零依赖,纯函数,断路器 key 归一专用;非密码学用途)。
+/// a 32-bit 哈希(零依赖,纯函数,断路器 key 归一专用;非密码学用途)。
 fn fnv1a_32(bytes: &[u8]) -> u32 {
    let mut hash: u32 = 0x811c9dc5;
    for &b in bytes {
@@ -2556,7 +2556,7 @@ async fn check_stall_breaker(
    //    arguments 非合法 JSON 时 to_string 兜底(签名仍可比,只是兜底全量)。
    let signatures: Vec<String> = {
        let session = session_arc.lock().await;
-        // BE2(AC-EFF-R2-1):只取尾部 BREAKER_TAIL_N 条(签名抽取只需最近几轮工具调用,
+        // BE2只取尾部 BREAKER_TAIL_N 条(签名抽取只需最近几轮工具调用,
        // 全量 clone 纯浪费;STALL_BREAKER_SAMPLE_SIZE=12 ≪ 40,样本充足)。
        let messages = match session.conv_read(conv_id) {
            Some(conv) => conv.messages.recent_messages(BREAKER_TAIL_N),
@@ -28,7 +28,7 @@ use super::super::{AiChatEvent, AiSession, ApprovalKind, PendingApproval, ToolCa
 /// - medium：Low+Medium 自动
 /// - all：全自动无审批（完全 AI 接管）
 ///
-/// C-260627：patch_file 小改动（≤5 行）特例自动放行，不阻塞 AI 工作流。
+/// patch_file 小改动（≤5 行）特例自动放行，不阻塞 AI 工作流。
 pub(super) fn classify_risk_and_auto(
    risk_level: RiskLevel,
    auto_exec_mode: &str,
@@ -96,7 +96,7 @@ fn resolve_namespace_content(session: &AiSession, content: &str) -> String {
 /// tool_result 回传 LLM → LLM（不可靠）仍重试同命令 → 新 tool_call_id（provider 每轮新 id）
 /// → `process_tool_calls` 重新 insert pending(audit.rs:418) → 用户被迫重新审批，循环。
 ///
-/// **治本（F-05）**：即使 LLM 仍重试，同 (tool_name, args) 不重复审批。本函数扫描会话历史，
+/// **治本**：即使 LLM 仍重试，同 (tool_name, args) 不重复审批。本函数扫描会话历史，
 /// 若发现**已落定**（executed/failed/rejected，非 pending）的同类同参高危调用，返回其
 /// tool_result 内容，调用方把缓存结果作为新 tool_call_id 的 tool_result 回传 LLM，跳过审批。
 ///
@@ -216,7 +216,7 @@ fn canonical_args_key(args: &serde_json::Value) -> String {
 /// 后续命中返回缓存 + 专用警告(cache_hit_warning 目录分支)。
 /// 其他只读工具仍走全参 JSON 归一(键序无关,见 canonical_args_key)。
 ///
-/// pub(crate):供 audit/mod.rs 轮内去重(AC-EFF-T1-2)复用同一 key 口径(同源同 key,
+/// pub(crate):供 audit/mod.rs 轮内去重复用同一 key 口径(同源同 key,
 /// 跨轮缓存 + 轮内去重判定一致,防两处 key 漂移致去重误判)。
 pub(crate) fn readonly_cache_args_key(tool_name: &str, args: &serde_json::Value) -> String {
    if matches!(tool_name, "list_directory" | "list_dir") {
@@ -25,7 +25,7 @@ pub(super) fn data_change_for_tool(name: &str) -> Option<(&'static str, &'static
        "update_project" => ("project", "update"),
        "update_task" => ("task", "update"),
        "update_idea" => ("idea", "update"),
-        // P0-2:advance_task 改任务状态 = 任务数据变更,MCP 走 HTTP 形态时让 GUI 前端
+        // advance_task 改任务状态 = 任务数据变更,MCP 走 HTTP 形态时让 GUI 前端
        // listen df-data-changed 刷新任务列表(此前不在映射 → 状态推进后 GUI 不刷新)。
        // 数据变更机制是 entity 级(无 id),映射到 (task, update) 对齐 update_task。
        "advance_task" => ("task", "update"),
@@ -536,7 +536,7 @@ pub(crate) async fn process_tool_calls(
                            };
                            let _ = app_clone.emit("ai-chat-event", ev.clone());
                            let _ = app_clone.state::<crate::state::AppState>().ai_event_bus.publish_event(ev);
-                            // AR-11：数据变更类工具执行成功后 emit df-data-changed 联动刷新
+                            // 数据变更类工具执行成功后 emit df-data-changed 联动刷新
                            // （write_file/run_command 不在 data_change_for_tool 映射内，emit_data_changed 内部 None 即 noop）
                            emit_data_changed(&app_clone, &draft.name);
                            (draft, risk_level, Ok(content))
@@ -14,7 +14,7 @@ use df_storage::db::Database;

 /// 查项目可读标签:id → "「项目名」(id=x)"。
 ///
-/// AR-3：审批卡片需显示对象名而非裸 id（用户反馈"只返回 ID 不知道是什么数据"）。
+/// 审批卡片需显示对象名而非裸 id（用户反馈"只返回 ID 不知道是什么数据"）。
 /// 三臂区分：
 /// - Ok(Some) → 项目名标签
 /// - Ok(None) → "项目已不存在"（真不存在，项目已彻底清除/外部 id）
@@ -21,7 +21,7 @@ use super::risk_from_str;
 /// **惰性建 `PerConvState`**(不依赖 `active_conversation_id` 单值),使后续 ai_approve →
 /// try_continue_agent_loop 的 `conv_read(conv_id)` 命中各自 per_conv(各归各,不串)。
 /// `pending_approvals` 本身保持单层 HashMap(设计 §2.1.2,已带 conversation_id 是业务
-/// 语义而非路由键)。conversation_id=None 的无主审批(R-9)不建 per_conv(无 conv_id 可挂),
+/// 语义而非路由键)。conversation_id=None 的无主审批不建 per_conv(无 conv_id 可挂),
 /// 仍进 pending_approvals 单层表,后续审批按 tool_call_id 路由,不影响正确性。
 pub async fn restore_pending_approvals(state: &AppState) {
    // 清理超 24 小时的残留 pending(旧会话遗留,不再有意义)
@@ -64,7 +64,7 @@ pub async fn restore_pending_approvals(state: &AppState) {
            continue;
        }
        // 多 conv 分配:有 conversation_id 的审批惰性建/复用对应 conv 的 per_conv(设计 §3 batch8)。
-        // 无 conversation_id 的无主审批(R-9)不建 per_conv——无 conv_id 可挂,仍进 pending_approvals
+        // 无 conversation_id 的无主审批不建 per_conv——无 conv_id 可挂,仍进 pending_approvals
        // 单层表按 tool_call_id 路由,后续 ai_approve 路径不依赖其 per_conv。
        if let Some(cid) = rec.conversation_id.as_deref() {
            if !cid.is_empty() && convs_restored.insert(cid.to_string()) {
@@ -133,7 +133,7 @@ mod tests_multi_conv_restore {
            ("tc-1".to_string(), "write_file".to_string(), Some("conv-a".to_string())),
            ("tc-2".to_string(), "run_command".to_string(), Some("conv-a".to_string())),
            ("tc-3".to_string(), "delete_project".to_string(), Some("conv-b".to_string())),
-            ("tc-4".to_string(), "create_task".to_string(), None), // 无主(R-9)
+            ("tc-4".to_string(), "create_task".to_string(), None), // 无主
        ];

        // 复现 restore_pending_approvals 的分配逻辑(同名变量,逐字对齐实现)。
@@ -110,7 +110,7 @@ impl CommandSink {

    /// 累积一行 + 触发 flush 判定(行加入 stdout/stderr 分桶)。
    ///
-    /// AC-EFF-S2-5:不立即 emit,先累积入缓冲;体积超阈值立即 flush,否则等 50ms 定时 flush
+    /// 不立即 emit,先累积入缓冲;体积超阈值立即 flush,否则等 50ms 定时 flush
    /// 或 Drop 兜底 flush。emit 失败静默吞(前端未 listen / 总线无订阅不阻断命令执行)。
    fn emit(&self, kind: StreamKind, line: &str) {
        let over_threshold = {
@@ -45,7 +45,7 @@ use super::super::{AiChatEvent, ApprovalKind, SessionState};
 /// 把当前所有挂起审批的占位 tool_result(内容为 audit.rs:PENDING_APPROVAL_PLACEHOLDER
 /// "需要用户审批，等待确认")就地替换为终态文本。
 ///
-/// 背景(SW-260618-02):审批占位文本在 stop/clear/create/delete/force_send 等
+/// 背景审批占位文本在 stop/clear/create/delete/force_send 等
 /// 清 pending_approvals 时若不替换,会残留在 messages 里,下次发送把占位喂给 LLM。
 /// 占位内容非工具结果语义,污染上下文 + 误导模型继续等待。
 ///
@@ -60,7 +60,7 @@ use super::super::{AiChatEvent, ApprovalKind, SessionState};
 ///   conv_id 入参作 fallback(审批无 conversation_id 的无主审批 R-9 异常数据,终态化到入参 conv,
 ///   入参也空则跳过——审计仍记,占位不残留内存因 pending 即将被 clear/retain)。
 pub(crate) fn finalize_pending_placeholders(session: &mut super::super::AiSession, conv_id: &str, final_text: &str) {
-    // SW-260618-02: 先 clone pending 的 tool_call_id(借用在此结束),再可变借 messages。
+    // 先 clone pending 的 tool_call_id(借用在此结束),再可变借 messages。
    // 必须整体借 &mut session 在函数体内做 disjoint field borrow —— 调用方若分别传
    // &mut messages + &pending 两个引用,函数参数列表不做 disjoint 推断会触发 E0502。
    // 单真相源合并:两类挂起(path + risk)合一进 pending_approvals,占位都需终态化。
@@ -258,7 +258,7 @@ fn append_volatile(volatile: String, seg: &str) -> String {
 // 发送 / 审批 / 控制
 // ============================================================

-/// 重新生成最后一条 AI 回复(UX-02:消息操作栏「重新生成」)
+/// 重新生成最后一条 AI 回复消息操作栏「重新生成」)
 ///
 /// 流程:占用 generating → 弹出末尾 AI 回复(pop_last_assistant_round,保留触发它的
 /// user 消息)→ save 落库(避免前端切走时残留旧回复)→ spawn run_agentic_loop 重跑
@@ -368,9 +368,9 @@ pub async fn ai_regenerate(
    let app_handle = app.clone();
    let knowledge_config = state.knowledge_config.lock().await.clone();
    let llm_concurrency = state.llm_concurrency.clone();
-    // F-260616-01: loop 入口 load 快照，当前 loop 锁定边界（热改下次发消息生效）
+    // loop 入口 load 快照，当前 loop 锁定边界（热改下次发消息生效）
    let max_iterations = state.agent_max_iterations.load(Ordering::SeqCst);
-    // F-260616-07: 流式失败重试次数快照
+    // 流式失败重试次数快照
    let max_retries = state.agent_max_retries.load(Ordering::SeqCst);
    // F1 并发 epoch(F-260616-09 决策 e 真并发上线):新 loop 的 owner token。
    // 每 spawn 前 fetch_add(1) 递增,旧 loop 即刻失效(退出/Guard 复位/emit 只认自己 epoch)。
@@ -386,7 +386,7 @@ pub async fn ai_regenerate(
    Ok("ok".to_string())
 }

-/// 查询后端真实 generating 状态(B-260615-22:方案 A 发送前 IPC 查后端真值)
+/// 查询后端真实 generating 状态方案 A 发送前 IPC 查后端真值)
 ///
 /// 前端 `state.streaming` 与后端 `AiSession.generating` 各自维护:
 /// 后端 loop 异常退出 / AiError 已复位 generating=false 时,前端若仅查本地 streaming
@@ -606,7 +606,7 @@ pub async fn ai_chat_send(
        // 批3 双轨收口:generating bool 已退役,生成态由 run_agentic_loop 入口迁移设置(不再手动赋值)。
        conv.stop_flag.store(false, Ordering::SeqCst);
        conv.agent_language = language.clone();
-        // F-260616-11: 新对话生命周期 iteration 从头计数(累计计数器复位)。
+        // 新对话生命周期 iteration 从头计数(累计计数器复位)。
        conv.iteration_used = 0;
        // F-01 阶段6: 记录用户指定模型 override(主对话专用)。run_agentic_loop 兜底校验
        // (override 非空且在 provider model_configs 池中才用,否则落回路由结果)。
@@ -710,9 +710,9 @@ pub async fn ai_chat_send(
    let app_handle = app.clone();
    let knowledge_config = state.knowledge_config.lock().await.clone();
    let llm_concurrency = state.llm_concurrency.clone();
-    // F-260616-01: loop 入口 load 快照，当前 loop 锁定边界（热改下次发消息生效）
+    // loop 入口 load 快照，当前 loop 锁定边界（热改下次发消息生效）
    let max_iterations = state.agent_max_iterations.load(Ordering::SeqCst);
-    // F-260616-07: 流式失败重试次数快照
+    // 流式失败重试次数快照
    let max_retries = state.agent_max_retries.load(Ordering::SeqCst);
    // F1 并发 epoch(F-260616-09 决策 e 真并发上线):新 loop 的 owner token。
    // 每 spawn 前 fetch_add(1) 递增,旧 loop 即刻失效(退出/Guard 复位/emit 只认自己 epoch)。
@@ -745,8 +745,8 @@ pub async fn ai_approve(
            // 阶段3a 单真相源合并:ai_approve 从单 pending_approvals remove(原 risk_pending 合一)。
            // 若前端误调 ai_approve 消费 path_auth 挂起 → 这里拿不到该 id(kind=Path 的挂起也走同一表,
            // 但下方 kind 校验会拦截 Err)。无挂起则查审计表(幂等,已处理返成功)。
-            // F-260616-06: 幂等——内存无挂起审批时查审计表，若已处理则返回成功（非报错）
-            // BUG-260618-11: 区分 Err(DB 故障)与 Ok(None)(真无记录),原 unwrap_or_default 把
+            // 幂等——内存无挂起审批时查审计表，若已处理则返回成功（非报错）
+            // 区分 Err(DB 故障)与 Ok(None)(真无记录),原 unwrap_or_default 把
            // Err 压成 None,DB 故障被「未找到」误导(实为可重试故障),对齐 audit.rs audit_finalize 三路分流。
            let audit_status = match state.ai_tool_executions.find_by_tool_call_id(&tool_call_id).await {
                Ok(Some(rec)) => {
@@ -799,7 +799,7 @@ pub async fn ai_approve(
        //   无 conversation_id 的无主审批(R-9 异常数据)无 per_conv 可写,拒绝结果不入 messages
        //   (审计仍记 rejected),避免写错 conv。
        if let Some(ref cid) = approval.conversation_id {
-            // BUG-2026-07-07/P1-3:拒绝消息改结构化 JSON,防裸文本破坏 tool role 消息协议
+            // BUG-2026-07-07/拒绝消息改结构化 JSON,防裸文本破坏 tool role 消息协议
            // (部分 provider 严格解析 tool role content,裸文本会触发协议错误)。
            let reject_payload = serde_json::json!({
                "status": "rejected",
@@ -1184,7 +1184,7 @@ pub async fn ai_authorize_dir(

    // ── "deny":拒绝路径授权 → 工具返 Err,恢复 loop ──
    if decision == "deny" {
-        // BUG-2026-07-07/P1-3:拒绝消息改结构化 JSON,防裸文本破坏 tool role 消息协议
+        // BUG-2026-07-07/拒绝消息改结构化 JSON,防裸文本破坏 tool role 消息协议
        let err_msg = serde_json::json!({
            "status": "rejected",
            "reason": "path_auth_denied",
@@ -1460,7 +1460,7 @@ pub async fn ai_chat_clear(state: State<'_, AppState>) -> Result<(), String> {
    // ── ③ 内存清(DB 成功后;内存 clear 不失败,回滚只需保证 DB 原子)──
    if let Some(ref id) = active_id {
        let mut session = state.ai_session.lock().await;
-        // SW-260618-02:清 pending 前先把占位 tool_result 终态化(此处 messages 紧随即 clear,
+        // 清 pending 前先把占位 tool_result 终态化(此处 messages 紧随即 clear,
        // 调用为 no-op,但保持清理点统一口径防顺序变更时占位随 messages 残留 DB)。
        // F-260616-09 B 批4:per_conv.messages 唯一真相源,删顶层 messages.clear 双写;
        //   pending_approvals 仅清 active conv 的(retain 保留其他 conv 的审批)。
@@ -1712,7 +1712,7 @@ pub async fn ai_chat_compress_context(
    Ok(())
 }

-/// 编辑最后一条 user 消息并重新生成（UX-09）
+/// 编辑最后一条 user 消息并重新生成
 ///
 /// 流程(复用 ai_regenerate 的 spawn 模式):占用 generating → 校验活跃对话一致 →
 /// ① 替换末条 active user 消息 content=new_message → ② 其后所有消息标 truncated(软删,
@@ -1752,7 +1752,7 @@ pub async fn ai_chat_edit(
        // 批3 双轨收口:generating bool 已退役,生成态由 run_agentic_loop 入口迁移设置(不再手动赋值)。
        conv.stop_flag.store(false, Ordering::SeqCst);
        conv.agent_language = language.clone();
-        // F-260616-11: 编辑重生成 = 新生命周期起点,iteration 从头计数。
+        // 编辑重生成 = 新生命周期起点,iteration 从头计数。
        conv.iteration_used = 0;
        // F-01 阶段6: 记录用户指定模型 override(主对话专用)。
        conv.model_override = model_override.clone();
@@ -1834,14 +1834,14 @@ pub async fn ai_chat_edit(
    Ok("ok".to_string())
 }

-/// 强制发送消息（B-260616-02: L2 发送韧性；BUG-260617-04: 原子复位+占用消除双锁竞态）
+/// 强制发送消息L2 发送韧性；原子复位+占用消除双锁竞态）
 ///
 /// 当后端 generating=true 残留（HMR/异常退出等）导致 sendMessage 被拦截时，
 /// 前端可调此命令强制复位 generating + 清审批，然后发送新消息。
 ///
 /// 旧实现先 lock 复位 generating→释放锁→调 ai_chat_send 再 lock，两锁之间另一个发送
 /// IPC(force_send/send)可插入占用 generating=true → ai_chat_send 因 generating=true 被
-/// reject → 前端以为已强制发送但后端拒绝,状态不一致(BUG-260617-04)。
+/// reject → 前端以为已强制发送但后端拒绝,状态不一致。
 ///
 /// 修法:把"软停止复位 + 新消息占用 generating"合并到**同一把锁**,消除竞态窗口;
 /// 其后 system prompt 构建 + spawn run_agentic_loop 与 ai_chat_send 同款(照 ai_chat_edit
@@ -1907,7 +1907,7 @@ pub async fn ai_chat_force_send(
        // was_gen 读点(B-Phase2):改读无锁 conv_states.is_active()(Generating/Compressed),
        // 用于判断「原是否在生成」以决定是否 emit AiCompleted。语义等价。
        let was_gen = state.conv_states.is_active(&target);
-        // SW-260618-02:强制发送丢弃目标 conv 的旧审批,先终态化占位 tool_result,防占位随 messages
+        // 强制发送丢弃目标 conv 的旧审批,先终态化占位 tool_result,防占位随 messages
        // 残留下次发送喂给 LLM。仅清目标 conv 的 pending_approvals(retain 保留其他 conv)。
        finalize_pending_placeholders(&mut *session, &target, "已取消");
        // 阶段3a 单真相源合并:单表 retain(仅清目标 conv,保留其他 conv,kind 不区分)。
@@ -1936,7 +1936,7 @@ pub async fn ai_chat_force_send(
        // 批3 收口:生成态由 run_agentic_loop 入口 ConvState→Generating 迁移设置(不再手动赋值)。
        // 注:stop_flag 保持 true(旧 loop 退出用),新 loop spawn 前由下方锁外等待窗口后置 false。
        conv.agent_language = language.clone();
-        // F-260616-11: 强制发送 = 新对话生命周期起点,iteration 从头计数。
+        // 强制发送 = 新对话生命周期起点,iteration 从头计数。
        conv.iteration_used = 0;
        conv.model_override = model_override.clone();
        // user content 处理(技能调用空文本标记 /{skillname}),照 ai_chat_send
@@ -2109,7 +2109,7 @@ pub async fn ai_chat_stop(
    let has_pending = session.session_state(&target, &state.conv_states) == SessionState::AwaitingApproval;
    if has_pending {
        // 审批等待态：loop 已退出，直接清理目标 conv 让其立即可用
-        // SW-260618-02:messages 不 clear,占位 tool_result 会残留,下次发送喂给 LLM。
+        // messages 不 clear,占位 tool_result 会残留,下次发送喂给 LLM。
        // 清 pending 前先终态化为"会话已停止"。仅清目标 conv 的 pending(retain 保留其他 conv)。
        finalize_pending_placeholders(&mut *session, &target, "会话已停止");
        session.pending_approvals.retain(|_, a| a.conversation_id.as_deref() != Some(target.as_str()));
@@ -2152,7 +2152,7 @@ pub async fn ai_chat_stop(
        conv.stop_flag.store(true, Ordering::SeqCst);
        conv.notify.clone()
    };
-    // B-260615-14:置位后立即 notify_one 唤醒阻塞在 stream.next() 的 select!，
+    // 置位后立即 notify_one 唤醒阻塞在 stream.next() 的 select!，
    // 不再等 30s 心跳 tick 或 120s idle timeout 才轮到 stop_flag 检查。
    // Notify 仅承载「即时唤醒」，停止真值仍由 stop_flag 决定（stream_llm 唤醒后再判 flag）。
    notify.notify_one();
@@ -2261,7 +2261,7 @@ pub async fn ai_chat_stop(
    Ok(())
 }

-/// 续跑 agentic 循环（F-260616-03：达 max_iterations 暂停态用户点「继续」）
+/// 续跑 agentic 循环达 max_iterations 暂停态用户点「继续」）
 ///
 /// 场景：run_agentic_loop 达 max_iterations 未收敛 → emit AiMaxRoundsReached + 保持
 /// generating=true 暂停。用户点继续调本命令 → 复位 stop_flag（防上一轮残留致续跑入口即退出）
@@ -2308,7 +2308,7 @@ pub async fn ai_continue_loop(
    Ok("ok".to_string())
 }

-/// 停止 agentic 循环并走完成流程（F-260616-03：达 max_iterations 暂停态用户点「停止」）
+/// 停止 agentic 循环并走完成流程达 max_iterations 暂停态用户点「停止」）
 ///
 /// 场景：run_agentic_loop 达 max_iterations 未收敛 → emit AiMaxRoundsReached + 保持
 /// ConvState=Generating 暂停。用户点停止调本命令 → 复位生成态(ConvState→Idle) + emit AiCompleted（标收敛）。
@@ -176,7 +176,7 @@ pub async fn ai_conversation_create(
    let now = now_millis();

    // F-260616-09 B 批4(决策 e 真并发上线):新建会话**不杀旧 loop**。
-    //   旧实现(B-260615-10)生成中强制结束旧 conv 的 loop + clear 其 per_conv,在真并发下会误杀
+    //   旧实现生成中强制结束旧 conv 的 loop + clear 其 per_conv,在真并发下会误杀
    //   后台跑着的 conv。决策 e:旧 conv 的 per_conv 完整保留(后台 loop 继续跑自己的 conv),
    //   仅切换 active_conversation_id 到新会话 + 为新会话建独立 per_conv。
    //
@@ -682,7 +682,7 @@ pub async fn ai_conversation_archive(
    Ok(())
 }

-/// 置顶/取消置顶对话(UX-17:对话置顶)
+/// 置顶/取消置顶对话对话置顶)
 ///
 /// 置顶后侧栏排序置前(前端按 pinned DESC, updated_at DESC)。
 /// 纯元数据标记(同归档),不改 updated_at(保持相对时间不变)。
@@ -727,7 +727,7 @@ pub async fn ai_update_conversation_goals(
    Ok(())
 }

-/// 导出对话为指定格式(UX-18:对话导出)
+/// 导出对话为指定格式对话导出)
 ///
 /// - 优先落库 messages(完整历史,与 switch 一致),内存 session 不读(可能被切走/未落库)
 /// - markdown: `## 用户` / `## 助手` 交替标题 + content 原样输出
@@ -13,7 +13,7 @@
 //! 再经 `ai/mod.rs` 的 `pub use self::commands::*;` 透传到 `commands::ai::*`,
 //! 保 `lib.rs` invoke_handler + 前端 `api/ai.ts` 零改动。
 //!
-//! 纯搬迁:不改 IPC 签名/行为(FR-S1 密钥迁移 / F-260614-04c 池配置编辑保留 / F-01 阶段5 探测
+//! 纯搬迁:不改 IPC 签名/行为(FR-S1 密钥迁移 / c 池配置编辑保留 / F-01 阶段5 探测
 //! 等逻辑原样保留)。

 use tauri::State;
@@ -37,7 +37,7 @@ use super::super::secret::{
 // 提供商管理
 // ============================================================

-/// api_key 脱敏:IPC 不传明文给前端(FR-S1),保留首尾各 4 字符便于辨识。
+/// api_key 脱敏:IPC 不传明文给前端,保留首尾各 4 字符便于辨识。
 ///
 /// `pub(crate)` 供 get_app_config AI 工具复用(查 DevFlow 自身 provider 配置时同样脱敏,
 /// 不向 LLM 回灌明文 key,与 ai_list_providers IPC 走同一套脱敏规则,单点维护)。
@@ -83,7 +83,7 @@ pub async fn ai_list_providers(state: State<'_, AppState>) -> Result<Vec<AiProvi
            }
        }
    }
-    // IPC 不传明文 api_key(FR-S1):前端编辑用空 apiKey 表示不改,mask 后前端 realm 不持有明文。
+    // IPC 不传明文 api_key前端编辑用空 apiKey 表示不改,mask 后前端 realm 不持有明文。
    // 迁移后 DB api_key 空 → 从 keyring 取真实密钥再 mask(前端看到 mask 但不持有明文)
    for p in &mut providers {
        let real = if !p.api_key.is_empty() {
@@ -111,7 +111,7 @@ pub async fn ai_save_provider(
    // 接收前端传入的 model_configs 落库(含用户在 Settings 调的 weight/enabled/label),
    // 不再硬塞 Vec::new() 丢弃用户配置。新建传 []、编辑传回填+改动后的 providerForm.models。
    // 编辑已有提供商时保留原 created_at，避免被覆盖
-    // F-260614-04c: 编辑路径同时保留原 enabled/weight(负载均衡池可编辑层)。
+    // c: 编辑路径同时保留原 enabled/weight(负载均衡池可编辑层)。
    // 前端经此 IPC 改 enabled/weight 落库;新建走默认 enabled=true/weight=50。
    let existing = match &id {
        Some(pid) => state.ai_providers.get_by_id(pid).await.map_err(err_str)?,
@@ -125,13 +125,13 @@ pub async fn ai_save_provider(
            .map_err(err_str)?
            .iter().any(|p| p.is_default),
    };
-    // F-260614-04c: enabled/weight 编辑保留原值(前端 Settings 改值经此落库);
+    // c: enabled/weight 编辑保留原值(前端 Settings 改值经此落库);
    // 新建默认进池(enabled=true,weight=50)。
    let (enabled, weight) = match &existing {
        Some(p) => (p.enabled, p.weight),
        None => (true, 50),
    };
-    // FR-S1:密钥存 OS keyring,DB api_key 列恒空(不入明文)。
+    // 密钥存 OS keyring,DB api_key 列恒空(不入明文)。
    // api_key 非空 = 新/改密钥 → 写 keyring;空 = 编辑不改 → 保留原 keyring 密钥不动。
    let provider_id = id.clone().unwrap_or_else(new_id);
    if !api_key.is_empty() {
@@ -140,7 +140,7 @@ pub async fn ai_save_provider(
            return Err(format!("密钥保存到系统钥匙串失败: {}", e));
        }
    } else if let Some(pid) = &id {
-        // 空 key 编辑:保住密钥,防未迁移态静默丢失(R-PD-1)。
+        // 空 key 编辑:保住密钥,防未迁移态静默丢失。
        // 未迁移态(DB 有明文 + keyring 空)下,下方 INSERT OR REPLACE 会无条件清 DB api_key,
        // 唯一密钥副本被覆盖成空 → keyring 也空 → resolve 返空 → provider 报废密钥永久丢失。
        // 兜底:发现未迁移态先即时迁移补密钥,迁移成功后再让下方清 DB 明文(收敛到迁移完成态);
@@ -181,7 +181,7 @@ pub async fn ai_save_provider(
        config: None,
        created_at,
        updated_at: now_millis(),
-        // F-260614-04c: enabled/weight 编辑保留原值(负载均衡池可编辑层),新建走默认。
+        // c: enabled/weight 编辑保留原值(负载均衡池可编辑层),新建走默认。
        enabled,
        weight,
    };
@@ -194,7 +194,7 @@ pub async fn ai_save_provider(
    Ok(id)
 }

-/// F-260614-04c: 轻量更新 provider 池配置(enabled/weight),不改其它字段、不触密钥迁移。
+/// c: 轻量更新 provider 池配置(enabled/weight),不改其它字段、不触密钥迁移。
 ///
 /// 与 `ai_save_provider` 的区别:
 /// - ai_save_provider 是全量保存(name/base_url/api_key/model...),编辑路径会走 R-PD-1 密钥
@@ -277,7 +277,7 @@ pub async fn ai_delete_provider(
    provider_id: String,
 ) -> Result<(), String> {
    state.ai_providers.delete(&provider_id).await.map_err(err_str)?;
-    // CR-260615-01:DB 已删则清 keyring 残留密钥(失败仅 warn 不阻断——无 DB 消费方,
+    // DB 已删则清 keyring 残留密钥(失败仅 warn 不阻断——无 DB 消费方,
    // 残留 keyring 不可复活;同 id 复用也不会读到旧密钥,因 set 覆盖写)
    if let Err(e) = delete_provider_secret_async(provider_id.clone()).await {
        tracing::warn!("[FR-S1] keyring 清理失败 {} (残留但无消费方,不阻断删除): {}", provider_id, e);
@@ -310,7 +310,7 @@ fn normalize_provider_type_for_fetch(provider_type: &str) -> String {
 ///
 /// 流程:
 /// 1. DB 取 AiProviderRecord(get_by_id)
-/// 2. FR-S1:经 resolve_provider_secret 内存解析真实 api_key(keyring 优先 fallback DB,
+/// 2. 经 resolve_provider_secret 内存解析真实 api_key(keyring 优先 fallback DB,
 ///    绝不进日志/返回值/错误信息)
 /// 3. provider_type 归一(anthropic→anthropic_compat)+ base_url + api_key 调
 ///    df_ai::model_fetch::fetch_and_probe → Vec<ModelConfig>(每个模型名已探测出 4 维度)
@@ -329,7 +329,7 @@ pub async fn ai_fetch_models(
        .map_err(err_str)?
        .ok_or_else(|| format!("提供商不存在: {}", provider_id))?;

-    // FR-S1:内存解析密钥,绝不外泄(不入日志/返回值/错误信息)
+    // 内存解析密钥,绝不外泄(不入日志/返回值/错误信息)
    let api_key = df_storage::secret::resolve_provider_secret(&provider);
    let fetch_type = normalize_provider_type_for_fetch(&provider.provider_type);

@@ -381,7 +381,7 @@ pub async fn ai_fetch_models(
    Ok(merged)
 }

-/// 一次性测试连接(P0-1):用**表单当前值**而非 DB 值测试,不写库。
+/// 一次性测试连接用**表单当前值**而非 DB 值测试,不写库。
 ///
 /// 解决:`ai_fetch_models` 从 DB 读 provider,用户改了表单未保存就点「测试连接」时
 /// 测的是旧值(base_url/api_key 已改但 DB 未落),给出误导性「成功/失败」。
@@ -416,7 +416,7 @@ pub async fn ai_test_connection(
            .await
            .map_err(err_str)?
            .ok_or_else(|| format!("提供商不存在: {}", pid))?;
-        // FR-S1:内存解析,绝不外泄(不入日志/返回值/错误信息)
+        // 内存解析,绝不外泄(不入日志/返回值/错误信息)
        df_storage::secret::resolve_provider_secret(&provider)
    };

@@ -10,7 +10,7 @@

 use df_ai::context_helpers::CompressedSummary;
 use df_ai::provider::{ChatMessage, CompletionRequest, LlmProvider};
-// F-15: 压缩路由 — TaskRequirements(Standard 智力即可,无需工具)。压缩是结构化
+// 压缩路由 — TaskRequirements(Standard 智力即可,无需工具)。压缩是结构化
 // 摘要任务,选 Standard 智力保摘要质量;不传 tools(纯文本出,避免 LLM 调工具跑偏)。
 // 池空/无匹配兜底 default_model(与 title.rs 一致,行为可预期)。
 use df_ai::router::{
@@ -329,7 +329,7 @@ mod tests {
        assert_eq!(clean_summary(""), "");
    }

-    // ── BUG-2026-07-07/P0-1: LLM 退化重复输出检测 ──
+    // ── BUG-2026-07-07/LLM 退化重复输出检测 ──
    #[test]
    fn clean_summary_rejects_degenerated_repetition() {
        // 实测样本(9357c27c seq0):同一短语重复 41 次
@@ -94,7 +94,7 @@ pub(crate) fn accumulate_tokens(old: Option<i64>, add: u32) -> Option<i64> {
 /// 防 read_file 1MB 洞 / list_directory 大体量结果落库后每轮重发累积致 token 暴增
 /// (Sprint 19 实测单对话 in=115万 / 消息体 1.6MB)。仅作用于持久化视图,不污染内存真相源。
 ///
-/// B-260619-02:50KB → 8KB 收紧。治 GLM 1214 messages 非法根因——GLM anthropic 端点对
+/// 50KB → 8KB 收紧。治 GLM 1214 messages 非法根因——GLM anthropic 端点对
 /// 单条 tool_result content 限制更严(实测 ~10-20KB 即拒 1214),read_file 默认前 500 行源码
 /// 约 11-21KB,旧 50KB 阈值未触发→DB 存全量→reload/下轮重发→GLM 1214 整请求失败。
 /// 8KB 对齐 GLM 单条上限留余量;截断后 LLM 仍能据截断片段推理(优于 1214 直接拒收)。
@@ -235,14 +235,14 @@ async fn save_conversation_inner(
    touch_updated_at: bool,
 ) {
    // 取 messages + 懒创建首次落库所需的 provider_id/created_at
-    // 工具结果(content)超 8KB(B-260619-02:50KB→8KB,治 GLM 1214)时截断头尾各 ~3KB + 中段
+    // 工具结果(content)超 8KB50KB→8KB,治 GLM 1214)时截断头尾各 ~3KB + 中段
    // 标注(含原字节数),防大体量结果(read_file 1MB 洞 / list_directory 13782 项)落库后每轮重发
    // 累积致 token 暴增。仅影响持久化视图,不污染内存真相源(ContextManager)——build_for_request
    // 仍读全量 messages。
    //
    // per_conv.messages 是唯一真相源(conv_id 来源:本函数入参,与 save 落库的 conv 一致)。
    // conv() 惰性建:save 路径 conv 必然已建;极端未建(如启动恢复无 live conv)建空态,save 空消息(幂等)。
-    // BUG-2026-07-19: lock 段只 clone 必要读(messages + 元数据),truncate 移出 lock。
+    // lock 段只 clone 必要读(messages + 元数据),truncate 移出 lock。
    // 原 clone+truncate 全在 lock 内,对话历史长(多轮+大工具结果)时 clone+truncate 持锁可达秒级,
    // 致 guard.reset/process_tool_calls 等 session lock 竞争超时(aichat 卡死连环:工具卡片不呈现+
    // 回答完卡住+下条进队列)。truncate 在 clone 副本上操作,锁外执行不污染 session 真相源,行为等价。
@@ -251,7 +251,7 @@ async fn save_conversation_inner(
    //   读基线与读 messages 在同一 lock 段(快,无 await),保证两者一致性快照。
    //   借用顺序:先 clone session 顶层字段(immutable borrow),再 conv(conv_id) mutable borrow,
    //   避免同时持有 session 的 mut 和 immut 借用(E0502)。
-    // BE1(AC-EFF-L0-1):无变化捷径提前到克隆之前——同一 lock 段内先判「消息数未增且非 dirty」,
+    // BE1无变化捷径提前到克隆之前——同一 lock 段内先判「消息数未增且非 dirty」,
    //   无变化则不 clone(每轮无变化 save 省一次全量 clone + 后续 truncate/records 构建)。
    let (provider_id, created_at, pinned_goals, msg_len, persisted_count, needs_full_rewrite, mut persist_msgs) = {
        let mut session = session_arc.lock().await;
@@ -313,7 +313,7 @@ async fn save_conversation_inner(
            }
        }
        for m in &mut persist_msgs {
-            // P0-2:tool result 是结构化 JSON(provider 读工具返回原样),
+            // tool result 是结构化 JSON(provider 读工具返回原样),
            // 中段截断会插裸换行+中文省略标记破坏 JSON 结构致 reload/重发 parse FAIL。
            // tool result 体量已由 read_file limit 控源,此处跳过 content 截断,仅截 assistant/user 文本。
            if !matches!(m.role, df_ai::provider::MessageRole::Tool) {
@@ -616,7 +616,7 @@ mod tests {
        // 中段标注存在 + 标注省略字符数(中段 = 总长 - 头 - 尾 = 9192 - 3072 - 3072 = 3048)
        assert!(result.contains("已截断"));
        assert!(result.contains("省略 3048 字符"));
-        // B-260619-02:截断提示含原字节数(9192 个 'x' = 9192 字节),让 LLM 感知非全文
+        // 截断提示含原字节数(9192 个 'x' = 9192 字节),让 LLM 感知非全文
        assert!(result.contains("原 9192 字节"));
        // 结果总长应远小于原长(20k 头 + 20k 尾 + 标注)
        assert!(result.chars().count() < TRUNCATE_THRESHOLD + 1000);
@@ -687,7 +687,7 @@ mod tests {
        assert_eq!(truncate_parts_for_persist(&[]), None);
    }

-    // ---------- P0-2: tool role content 不截断(防 JSON 结构破坏) ----------
+    // ---------- tool role content 不截断(防 JSON 结构破坏) ----------

    /// 辅助:构造指定 role + content 的 ChatMessage,用 provider 全路径类型
    fn make_msg(role: df_ai::provider::MessageRole, content: &str) -> df_ai::provider::ChatMessage {
@@ -795,7 +795,7 @@ mod tests {
        );
    }

-    // ── 真实 SenseNova U1-Fast 图像生成验证(#[ignore],手动跑) ──
+    // ── 真实 SenseNova ast 图像生成验证(#[ignore],手动跑) ──
    //
    // 端到端验证:用真实 db 副本(SenseNova provider 配置)+ OS keyring 解析 api_key +
    // 真实调 https://token.sensenova.cn/v1/images/generations 生成一张测试图并下载落地。
@@ -94,7 +94,7 @@ pub use self::augmentation::build_resolver_registry;
 // 事件载荷类型(放 mod.rs,各子文件经 use super::* 拿到)
 // ============================================================

-/// AI 错误分类(B-260615-42)：供前端按错误源差异化提示(如 auth 引导填 key,
+/// AI 错误分类供前端按错误源差异化提示(如 auth 引导填 key,
 /// network 提示检查连接,provider_config 引导检查 base_url/model)。
 ///
 /// 设计：`Option<ErrorType>` 向后兼容——旧 emit 点若难精确分类填 `None`,
@@ -178,7 +178,7 @@ pub enum AiChatEvent {
    },
    /// 错误
    ///
-    /// `error_type` 为错误源分类(B-260615-42),`None` 表示未分类(向后兼容旧 emit 点)。
+    /// `error_type` 为错误源分类,`None` 表示未分类(向后兼容旧 emit 点)。
    AiError {
        error: String,
        /// 错误源分类(可选,便于前端差异化提示);旧点/难精确分类填 None
@@ -207,13 +207,13 @@ pub enum AiChatEvent {
    AiAgentRound { round: u32, conversation_id: Option<String> },
    /// 流式心跳（静默期报活，前端 watchdog reset，区分「LLM 在跑」与「真断」）
    AiHeartbeat { conversation_id: Option<String> },
-    /// 达最大轮次仍未收敛（F-260616-03：转暂停态询问用户继续/停止）
+    /// 达最大轮次仍未收敛转暂停态询问用户继续/停止）
    ///
    /// 触发时 generating 仍为 true（仿审批等待），前端展示独立操作卡：
    /// - 点继续 → ai_continue_loop → try_continue_agent_loop 再跑 max_iterations 轮
    /// - 点停止 → ai_stop_loop → 走完成流程（save + AiCompleted + generating=false）
    AiMaxRoundsReached { conversation_id: Option<String> },
-    /// 流式调用自动重试提示（F-260616-07：流前失败重试中）
+    /// 流式调用自动重试提示流前失败重试中）
    ///
    /// 每次重试前 emit，前端可在错误气泡内显示「重试 n/m」。
    /// attempt 从 1 开始(首次失败后第一次重试=attempt 1)，max_attempts = max_retries + 1。
@@ -238,7 +238,7 @@ pub enum AiChatEvent {
    AiCompressing { conversation_id: Option<String> },
    /// F-15 阶段2 手动 LLM 压缩完成:摘要已插入消息首位,前端弹 toast + 刷新视图回填摘要。
    ///
-    /// 治 Task#1(BUG-260624-05):自动压缩路径误用此变体致桌面误弹 toast+每次发送误刷,
+    /// 治 Task#1自动压缩路径误用此变体致桌面误弹 toast+每次发送误刷,
    /// 现拆为 AiManualCompressed(手动 IPC,弹 toast) + AiAutoCompressed(loop 自动,静默)。
    /// emit 点:ai_chat_compress_context IPC 的 3 处(空会话/无 active/LLM 成功主路径)。
    AiManualCompressed { conversation_id: Option<String>, summary: String },
@@ -502,7 +502,7 @@ pub enum SessionState {
 /// - `Write { dir }`：write_file 在 `dir` 目录下（路径父目录归一化）
 /// - `Execute { dir }`：run_command 在 `dir` 工作目录下
 ///
-/// 命中即自动放行，跳过 pending 审批 + 二次确认（AE-05），不写 audit 仍记一条
+/// 命中即自动放行，跳过 pending 审批 + 二次确认，不写 audit 仍记一条
 /// `decided_by=auto_trust` 的审计记录留痕。
 #[derive(Debug, Clone, Hash, PartialEq, Eq)]
 pub enum TrustKey {
@@ -518,7 +518,7 @@ pub enum TrustKey {
 ///   （run_command handler 自身仅 validate_path 不限定 workspace，信任目录用 LLM 传入或
 ///   workspace_root 默认值作为 key 字面量，与 handler 实际 working_dir 对齐）
 ///
-/// FR-S1：不读 api_key / content / command 等敏感字段，只取 path/working_dir 归一化为 dir。
+/// 不读 api_key / content / command 等敏感字段，只取 path/working_dir 归一化为 dir。
 pub fn trust_key_for(tool: &str, args: &serde_json::Value) -> Option<TrustKey> {
    match tool {
        "write_file" => {
@@ -1164,10 +1164,10 @@ pub(crate) async fn execute_run_workflow_for_tool(
    let config = serde_json::Value::Object(serde_json::Map::new());
    let name = format!("AI 推进任务 {} → {}", task_id, target_status);

-    // 转调工作流执行核心(B-260617-01:run_workflow_inner 是 run_workflow 命令的共用核心,
+    // 转调工作流执行核心run_workflow_inner 是 run_workflow 命令的共用核心,
    // 同 invoke('run_workflow') IPC 入口的执行逻辑,持 &AppState 非 tauri::State,绕开
    // tauri::State 在非命令上下文不可构造的限制)。
-    // CR-52: 本路径是 AI 工具经 ai_approve 审批后执行 → triggered_by="ai"(区别命令层 manual)。
+    // 本路径是 AI 工具经 ai_approve 审批后执行 → triggered_by="ai"(区别命令层 manual)。
    // 返回 execution_id 字符串;失败(模板不存在/DAG 校验失败/DB 写入失败)上抛 Err。
    let execution_id = crate::commands::workflow::run_workflow_inner(
        app,
@@ -269,7 +269,7 @@ fn app_config_query_guidance_section(lang: &str) -> &'static str {
    }
 }

-// ── BE3(AC-EFF-L0-2): system prompt 会话内缓存 ──
+// ── BE3system prompt 会话内缓存 ──
 //
 // 背景:同一会话连续轮次(每次 send)都全量重建 system prompt——查活跃 project/task 清单 +
 // 逐条 format 拼多 KB 字符串,对高频轮次是纯重复成本。
@@ -11,7 +11,7 @@
 //! `secret.rs::build_provider_for` 同属"消费 AiProviderRecord 的 app 层逻辑",故放 src-tauri。
 //!
 //! ## 与 router 协同(职责切分,不重叠)
-//! - **router.select_model_id**:在**单个 provider 的 model_configs 池**中选最优模型(F-01)。
+//! - **router.select_model_id**:在**单个 provider 的 model_configs 池**中选最优模型。
 //! - **ProviderPool::select**:在**多个 provider 间**选主 + 列出备用(本模块)。
 //! 调用顺序:先 router 选模型 → 再 ProviderPool 选 provider 实例(模型在多 provider 间共享时)。
 //!
@@ -114,7 +114,7 @@ pub(crate) enum StreamResult {
        reasoning_content: Option<String>,
    },
    /// Init 失败（provider.stream() Err：建连/鉴权/HTTP non-2xx,或流建立后空文本各类中断）。
-    /// UX-260618-15: **不再 emit AiError**——重试可恢复路径的 emit 权交调用方(agentic/mod.rs),
+    /// **不再 emit AiError**——重试可恢复路径的 emit 权交调用方(agentic/mod.rs),
    /// 由 agentic 在重试耗尽/Fatal 时统一 emit 最终 AiError(单气泡),避免 N 次重试 push N+1 气泡。
    /// `retryable`: 据状态码分类(retry::is_status_retryable 镜像)：true=5xx/429/timeout/connect
    /// 可重试；false=4xx(非429)/鉴权/参数错 Fatal 立即放弃。调用方据此决定是否重试。
@@ -154,7 +154,7 @@ fn emit_ai_chat_event(app_handle: &AppHandle, ev: AiChatEvent) {
    let _ = app_handle.state::<crate::state::AppState>().ai_event_bus.publish_event(ev);
 }

-/// AR-8: flush 合批的 AiTextDelta(双写 emit + event_bus)。空 buffer 不 emit。
+/// flush 合批的 AiTextDelta(双写 emit + event_bus)。空 buffer 不 emit。
 fn flush_delta(app_handle: &AppHandle, conv_id: &str, pending_delta: &mut String) {
    if pending_delta.is_empty() {
        return;
@@ -196,16 +196,16 @@ pub(crate) async fn stream_llm(
    conv_id: &str,
 ) -> StreamResult {
    /// 流式读取空闲超时:超过此时长无任何 chunk 即判定连接已断
-    /// BUG-2026-07-17:原 120s 太长,后端挂死时用户等太久。改为 45s,正常流式每 chunk 间隔
+    /// 原 120s 太长,后端挂死时用户等太久。改为 45s,正常流式每 chunk 间隔
    /// 远不到 45s(即使模型思考间隙),超时即判为连接异常走保文/报错路径
    const STREAM_IDLE_TIMEOUT: Duration = Duration::from_secs(45);
-    /// BUG-2026-07-08: 首 chunk 超时(等首字节)。
+    /// 首 chunk 超时(等首字节)。
    /// 正常 provider 首 token <3s(即使 48 工具定义 + 长上下文),10s 足够宽容;
    /// 已有数据后中途静默仍用 STREAM_IDLE_TIMEOUT(120s,允许模型思考间隙)。
    const FIRST_CHUNK_TIMEOUT: Duration = Duration::from_secs(10);
    /// 心跳间隔：静默期向前端报「LLM 仍在跑」，reset watchdog
    const HEARTBEAT_INTERVAL: Duration = Duration::from_secs(30);
-    /// AR-8: 后端 delta 合批窗口。50ms 内的多次 AiTextDelta 合并为一条再 emit,
+    /// 后端 delta 合批窗口。50ms 内的多次 AiTextDelta 合并为一条再 emit,
    /// 降低 IPC 事件风暴(前端 rAF 只节流渲染不节流 IPC);合并后前端 currentText
    /// 逐条累加,最终一致。
    const DELTA_FLUSH_INTERVAL: Duration = Duration::from_millis(50);
@@ -287,14 +287,14 @@ pub(crate) async fn stream_llm(
    let mut finished_received = false;
    let mut stopped = false;
    let mut final_usage: Option<df_ai::provider::TokenUsage> = None;
-    // BUG-260617-12: DeepSeek thinking 模式推理内容累积（多轮需回传）
+    // DeepSeek thinking 模式推理内容累积（多轮需回传）
    let mut reasoning_content_acc: Option<String> = None;
-    // AR-8: per-conv delta 合批累加器。pending_delta 累积未 flush 的文本,
+    // per-conv delta 合批累加器。pending_delta 累积未 flush 的文本,
    // next_flush_at 记录下次 flush 的绝对时刻(首个入 buffer 时置 now+50ms)。
    let mut pending_delta = String::new();
    let mut next_flush_at: Option<tokio::time::Instant> = None;

-    // B-260615-15:heartbeat interval 提至 loop 外复用,避免每轮重建计时器
+    // heartbeat interval 提至 loop 外复用,避免每轮重建计时器
    // (每轮重建会丢已积累的节拍,且 interval 首次 tick 立即返回的特性会被误用)。
    // tokio interval 首 tick 立即返回——此处先丢弃首 tick,让心跳等满首个 30s 静默期才发
    // (心跳语义是"静默期仍在跑",循环入口立即报无意义且会与 rx.recv() 抢分支错过首 chunk)。
@@ -310,7 +310,7 @@ pub(crate) async fn stream_llm(
    let mut first_chunk_done = false;

    loop {
-        // B-260615-04:stop 即时打断。
+        // stop 即时打断。
        if stop_flag.load(std::sync::atomic::Ordering::SeqCst) {
            stopped = true;
            break;
@@ -348,7 +348,7 @@ pub(crate) async fn stream_llm(
            };
        }

-        // AR-8: 到点 flush 合批的 delta(单条 AiTextDelta 双写 emit + event_bus)。
+        // 到点 flush 合批的 delta(单条 AiTextDelta 双写 emit + event_bus)。
        if let Some(deadline) = next_flush_at {
            if tokio::time::Instant::now() >= deadline {
                next_flush_at = None;
@@ -360,7 +360,7 @@ pub(crate) async fn stream_llm(
        // 1) chunk_rx.recv():来自专用线程的 LLM chunk (15s 保底 timeout,防 select! 死等)
        // 2) heartbeat.tick():静默期发 AiHeartbeat reset 前端 watchdog
        // 3) notify.notified():用户停止即时打断
-        // 4) flush 定时器(sleep_until next_flush_at):尾部 delta 不因流静默而延迟(AR-8)。
+        // 4) flush 定时器(sleep_until next_flush_at):尾部 delta 不因流静默而延迟。
        let flush_deadline = next_flush_at
            .unwrap_or_else(|| tokio::time::Instant::now() + Duration::from_secs(3600));
        let flush_fut = tokio::time::sleep_until(flush_deadline);
@@ -412,7 +412,7 @@ pub(crate) async fn stream_llm(
                        idle_deadline = tokio::time::Instant::now() + STREAM_IDLE_TIMEOUT;
                        if !chunk.delta.is_empty() {
                            full_text.push_str(&chunk.delta);
-                            // AR-8: 合批入 buffer,首个入 buffer 时置 flush 时刻(到点统一 emit 单条)。
+                            // 合批入 buffer,首个入 buffer 时置 flush 时刻(到点统一 emit 单条)。
                            pending_delta.push_str(&chunk.delta);
                            if next_flush_at.is_none() {
                                next_flush_at = Some(tokio::time::Instant::now() + DELTA_FLUSH_INTERVAL);
@@ -514,20 +514,20 @@ pub(crate) async fn stream_llm(
                    }
                }
            }
-            // 2) 心跳:静默期 30s 发 AiHeartbeat,前端 watchdog reset(B-260615-02)
+            // 2) 心跳:静默期 30s 发 AiHeartbeat,前端 watchdog reset
            _ = heartbeat.tick() => {
                emit_ai_chat_event(app_handle, AiChatEvent::AiHeartbeat {
                    conversation_id: Some(conv_id.to_string()),
                });
            }
-            // 3) 即时停止唤醒(B-260615-14)
+            // 3) 即时停止唤醒
            _ = notify.notified() => {
                if stop_flag.load(std::sync::atomic::Ordering::SeqCst) {
                    stopped = true;
                    break;
                }
            }
-            // 4) AR-8: delta 合批到点 flush(流静默/工具执行等待期也能按时发出尾部文本)
+            // 4) delta 合批到点 flush(流静默/工具执行等待期也能按时发出尾部文本)
            _ = &mut flush_fut => {
                if next_flush_at.is_some() {
                    next_flush_at = None;
@@ -589,7 +589,7 @@ pub(crate) async fn stream_llm(
 /// - timeout / connect → retryable=true(瞬态,可重试)
 /// - unknown / 其他 → retryable=true(保守可重试,避免误判 Fatal 错杀)
 ///
-/// CR-30-1: 抽公共分类函数(决策 F-260616-07 a1 "复用 retry.rs 错误分类逻辑或镜像"),
+/// 抽公共分类函数(决策 F-260616-07 a1 "复用 retry.rs 错误分类逻辑或镜像"),
 /// 避免 stream_recv 与 agentic 各自重写状态码解析。
 fn classify_status_or_class(status_or_class: &str) -> bool {
    use df_ai::retry::is_status_retryable;
@@ -612,7 +612,7 @@ fn classify_status_or_class(status_or_class: &str) -> bool {
        i += 1;
    }
    // 无三位数字码:按文本分类(timeout/connect/transport/decode 可重试,其余 unknown 保守不重试)
-    // BUG-260617-01:Anthropic 中文参数错误(如 `[1214][messages 参数非法]`)无 HTTP 数字前缀,
+    // Anthropic 中文参数错误(如 `[1214][messages 参数非法]`)无 HTTP 数字前缀,
    // 走此文本分支,原 || true 致 retryable=true 空耗 4 次重试浪费 token。
    // 删 || true 对齐 retry::is_status_retryable 未知码不可重试语义;timeout/connect 瞬态仍可重试。
    //
@@ -694,7 +694,7 @@ fn classify_error_frame_retryable(msg: &str, status_or_class: &str) -> bool {
        "api-key",
        "api_key",
        "unauthorized",
-        // 中文签名(BUG-260617-01:Anthropic 中文参数错误)
+        // 中文签名Anthropic 中文参数错误)
        "鉴权",
        "认证失败",
        "未授权",
@@ -746,7 +746,7 @@ mod tests {
        assert!(classify_status_or_class("connect"));
    }

-    /// unknown → 保守 retryable=false(BUG-260617-01:防 Anthropic 中文参数错误等 Fatal 空耗重试)
+    /// unknown → 保守 retryable=false防 Anthropic 中文参数错误等 Fatal 空耗重试)
    #[test]
    fn classify_unknown_not_retryable() {
        assert!(!classify_status_or_class("unknown"));
@@ -941,7 +941,7 @@ mod tests {
    /// 状态码出现在更长数字串里也不误匹配（边界判断：前后必须非数字）
    #[test]
    fn diag_does_not_match_status_inside_longer_digits() {
-        // R-P2-6:边界判断后,白名单码嵌在长数字串内不再误命中(原窗口切片会从 14012 抠出 401)
+        // 边界判断后,白名单码嵌在长数字串内不再误命中(原窗口切片会从 14012 抠出 401)
        let e = anyhow::anyhow!("port 14012 used");
        assert_eq!(extract_error_diag(&e).0, "unknown");
        // 纯长数字串(无白名单码)同样不命中
@@ -957,7 +957,7 @@ mod tests {
        assert_eq!(s, "[anthropic-compat] AI 调用失败(HTTP 401): Unauthorized");
    }

-    /// R-P2-6:状态码紧贴中文字符(多字节 UTF-8)时仍能正确抠出
+    /// 状态码紧贴中文字符(多字节 UTF-8)时仍能正确抠出
    /// (原按字节窗口切片在中文边界脆弱,改为 char 迭代后安全)
    #[test]
    fn diag_extracts_code_adjacent_to_multibyte_chars() {
@@ -8,7 +8,7 @@ use tokio::sync::Mutex;
 use df_ai::provider::{ChatMessage, CompletionRequest, LlmProvider, MessageRole};
 // F-01 阶段5: 标题生成路由 — TaskRequirements(无需工具)。
 // 标题是短文本摘要任务;池空/无匹配兜底 default_model(行为不变)。
-// 注:路由已解耦(B-260618-03),原 Lite/Low 智力成本约束已删除,纯 weight 选模型。
+// 注:路由已解耦,原 Lite/Low 智力成本约束已删除,纯 weight 选模型。
 use df_ai::router::{
    is_likely_image_model, select_model_id, Modality, TaskRequirements,
 };
@@ -121,7 +121,7 @@ pub(crate) async fn ensure_conversation_title(
        );
        return;
    }
-    // B-260617-17: LLM 调用包 20s 超时,防信号量/网络挂起致后台 task 永久堆积;
+    // LLM 调用包 20s 超时,防信号量/网络挂起致后台 task 永久堆积;
    // 超时或返回 None 均保留上方已落的 extract 兜底,不覆盖。
    let title = match tokio::time::timeout(
        std::time::Duration::from_secs(20),
@@ -33,7 +33,7 @@ use crate::state::AllowedDirs;
 pub(crate) const MAX_LIST_RESULTS: usize = 50;

 /// run_command 默认超时（秒）。LLM 可在 args timeout_secs 覆盖此默认值。
-/// 提取为常量便于在超时标注处引用同一来源（F-260616-04）。
+/// 提取为常量便于在超时标注处引用同一来源。
 ///
 /// tool_registry 拆分:run_command handler 迁声明式(tools/file.rs),复用本常量保单真相源
 /// (避免字面量 60 漂移),故 pub(crate) 暴露给 tools 子模块。
@@ -48,7 +48,7 @@ pub(crate) const MAX_RUN_COMMAND_TIMEOUT_SECS: u64 = 600;
 /// AE-2025-03（路径 B）：audit.rs 挂起审批前预读旧文件复用此函数生成 diff，
 /// 供前端审批卡即时预览（write_file 审批不再只看裸 content）。故 pub(crate)。
 ///
-/// BUG-260617-07: LCS DP 表 O(n*m) 内存,两文件均>1000 行时 DP 表可达数百 MB
+/// LCS DP 表 O(n*m) 内存,两文件均>1000 行时 DP 表可达数百 MB
 /// (5000×5000×8B≈200MB)。虽然 1MB 字节上限能挡住多数情况,但短行高密度的源码
 /// (大量空行/单字符行)仍可能突破。改:两文件均>1000 行时跳过 LCS,退化为
 /// 「删旧全量 + 增新全量」朴素行对比 + 截断提示。朴素对比 O(n+m) 内存,安全。
@@ -118,7 +118,7 @@ pub(crate) fn generate_diff(old: &str, new: &str) -> String {

 /// 验证文件路径：禁止访问系统敏感目录 + 防路径遍历绕过
 ///
-/// 安全要点(BUG-260617-03):
+/// 安全要点
 /// 1. **先 URL 解码**再检查——防 `%2e%2e` / `%2f` 等 URL 编码绕过 `..` 检测。
 ///    LLM / 外部输入可能传编码串,若直接做字符串 `..` 检查会被 `%2e%2e` 骗过,
 ///    解码后再走分段归一化校验。
@@ -151,7 +151,7 @@ pub(crate) fn validate_path(path: &str) -> anyhow::Result<()> {
    if crate::state::is_in_system_blacklist(&PathBuf::from(&normalized)) {
        anyhow::bail!("禁止访问敏感系统目录");
    }
-    // F-260620: AppData 不再硬拦(原 `lower.contains("\\appdata\\")` 一刀切致用户授权后仍拒)。
+    // AppData 不再硬拦(原 `lower.contains("\\appdata\\")` 一刀切致用户授权后仍拒)。
    // AppData 走白名单流程(is_authorized/check_path_authorization):默认不在白名单 → 弹 DirAuthDialog
    // → 用户显式授权(once/always)→ 放行。真正敏感凭据(.ssh/.aws/.gnupg)由 is_in_system_blacklist
    // 硬拦(授权也不放,防凭据泄漏),AppData 内应用数据(DBeaver Scripts/项目配置等)归用户自治——
@@ -180,7 +180,7 @@ pub(crate) fn truncate_output(s: &str, max: usize) -> (String, bool) {
 }

 // ============================================================
-// patch_file 三模式共用底层（F-260617-01）
+// patch_file 三模式共用底层
 //
 // 三模式互斥（old_text 精确匹配 / replace_lines 行号区间 / anchor 锚点），
 // 后两者均归约为「按行号区间 [start, end]（1-based 含首尾）替换为 new_text」，
@@ -407,7 +407,7 @@ pub(crate) fn resolve_workspace_path_with_allowed(
    resolve_workspace_path_impl(path, allowed)
 }

-/// AE-2025-04：mod.rs trust_key_for 计算 write_file 的 TrustKey 目录粒度时复用本函数
+/// mod.rs trust_key_for 计算 write_file 的 TrustKey 目录粒度时复用本函数
 /// 归一化路径（去 .. / symlink 逃逸）。pub(crate) wrapper 转调私有 impl，保持原私有函数
 /// 可见性边界（不暴露给 crate 外，但允许同 crate ai 模块 mod.rs 调用）。
 ///
@@ -631,7 +631,7 @@ fn register_local_proxy_tools(
 /// 数据层 AI 工具注册(25 个持 db 的 CRUD/状态机/工作流/知识图谱工具)——从 build_ai_tool_registry 抽出。
 ///
 /// 工具闭包捕获 `db: &Arc<Database>` Arc 重建 Repo(列表/创建/更新/删除/状态推进/工作流/任务关联)。
-/// 例外:run_workflow handler 防御返回 Err(CR-52),不持 db 不 clone,真正执行经
+/// 例外:run_workflow handler 防御返回 Err,不持 db 不 clone,真正执行经
 /// ai_approve → run_workflow_inner 另走完整 State 路径。
 ///
 /// 知识图谱 Phase 1(2026-06-26):新增 register_task_graph_tools 子函数(6 工具:task_link CRUD
@@ -641,7 +641,7 @@ fn register_local_proxy_tools(
 /// 知识图谱 Phase 3(2026-06-27):register_task_graph_tools 增 add_project_service(Medium)/
 /// list_project_services(Low 只读) 项目基础设施配置,data 层 25→27。
 ///
-/// SMELL-P0-2:抽自原 build_ai_tool_registry 1091 行单函数(数据+文件混合)。
+/// 抽自原 build_ai_tool_registry 1091 行单函数(数据+文件混合)。
 /// 18 个 register 调用【原样移入】,零行为变更,仅机械搬运。
 ///
 /// SMELL-P0-2 续拆(2026-06-19):18 工具按业务表细分为 5 子函数:
@@ -761,7 +761,7 @@ fn register_trash_tools(registry: &mut AiToolRegistry, db: &Arc<Database>) {
 }

 /// 文件系统类 AI 工具注册(命令执行/读/列/写/改/元/追加/删/移/搜)——不持 db,纯文件系统操作。
-/// 从 build_ai_tool_registry 抽出(SMELL-P0-2:1091行单函数拆分,build 1090→~390 行)。
+/// 从 build_ai_tool_registry 抽出1091行单函数拆分,build 1090→~390 行)。
 ///
 /// F-260619-03 Phase A: 各文件工具闭包捕获 `allowed_dirs: Arc<RwLock<AllowedDirs>>`,
 /// handler 执行时 read lock 取白名单快照,resolve_workspace_path_with_allowed 校验动态白名单。
@@ -852,11 +852,11 @@ pub(crate) fn list_dir_recursive<'a>(
                continue;
            }
            // 临时文件(.bak/.tmp-write 等)也不返回:write_file 原子写过程的副产物,
-            // 崩溃/中断会留孤儿文件,泄漏进 list_directory 噪化 AI 上下文(CR-260615-03)。
+            // 崩溃/中断会留孤儿文件,泄漏进 list_directory 噪化 AI 上下文。
            if skip_noise && is_noise_file(&name) {
                continue;
            }
-            // FR-S8:用 file_type() 不跟随 symlink——entry.metadata() 会解析符号链接目标,
+            // 用 file_type() 不跟随 symlink——entry.metadata() 会解析符号链接目标,
            // 经 workspace 内 symlink 即可泄露外部目标的 size/类型,且递归会进入 symlink 指向的 workspace 外目录
            let file_type = entry.file_type().await?;
            let is_symlink = file_type.is_symlink();
@@ -929,7 +929,7 @@ pub(crate) fn tool_display_hint(name: &str) -> Option<&'static str> {
        "create_idea" => Some("捕获灵感"),
        "update_task" => Some("修改任务"),
        // advance_task 不在此轻量映射:让 build_approval_reason 走 display_hint_for_tool
-        // 模板(含 target_status 详情),否则轻量命中"推进任务状态"丢失目标态信息(UX-260618-14)
+        // 模板(含 target_status 详情),否则轻量命中"推进任务状态"丢失目标态信息
        "run_workflow" => Some("触发工作流"),
        "delete_task" => Some("删除任务"),
        "update_idea" => Some("修改灵感"),
@@ -948,7 +948,7 @@ pub(crate) fn is_noise_dir(name: &str) -> bool {
    const NOISE_DIRS: &[&str] = &[
        ".git", "node_modules", "target", "dist", "build",
        ".next", ".cache", "__pycache__", ".venv", "venv", ".idea",
-        ".trash", // delete_file 软删除回收站(F-260615-16),不污染 list_directory
+        ".trash", // delete_file 软删除回收站,不污染 list_directory
    ];
    NOISE_DIRS.contains(&name)
 }
@@ -964,7 +964,7 @@ pub(crate) fn is_noise_file(name: &str) -> bool {
 }

 // ============================================================
-// grep 工具底层（F-260621）
+// grep 工具底层
 //
 // FileGrepHit 单文件命中聚合:line_matches 按行号升序。output_mode 分派时:
 // - content: 展平 line_matches 为 matches[{file,line,content,context?}]
@@ -1101,7 +1101,7 @@ pub(crate) fn grep_recursive<'a>(
                }
                continue;
            }
-            // 文件处理(BUG-260625-01:提取为 grep_one_file,grep handler 单文件路径复用同一逻辑)
+            // 文件处理提取为 grep_one_file,grep handler 单文件路径复用同一逻辑)
            grep_one_file(&path, &file_name, re, glob, output_mode, context_lines, max_results, out, total, truncated).await?;
        }
        Ok(())
@@ -1109,7 +1109,7 @@ pub(crate) fn grep_recursive<'a>(
 }

 /// 单文件 grep:读 + 二进制检测 + 行匹配,收集命中到 out。
-/// 提取自 grep_recursive 循环体(BUG-260625-01),供 grep handler 单文件路径复用——
+/// 提取自 grep_recursive 循环体,供 grep handler 单文件路径复用——
 /// grep 命令行原生支持单文件,LLM 常传文件路径而非目录,旧实现直接 read_dir 文件路径报 os error 267。
 /// files_with_matches:文件级命中(content/count 不收集行详情);content/count:行级命中,达 max_results 截断。
 pub(crate) async fn grep_one_file(
@@ -1317,7 +1317,7 @@ mod tests {
        let registry = build_ai_tool_registry(&db, &allowed_dirs, PathBuf::from(""), make_test_get_app_config_ctx(&db), make_test_local_proxy_ctx());

        // 总量基线:41(27 data + 13 file + 1 http)。拆分前后必须一致。
-        // F-260621: file 层 10→11(新增 grep 跨文件内容搜索工具)。
+        // file 层 10→11(新增 grep 跨文件内容搜索工具)。
        // L1 环境感知(设计 §2.1): file 层 11→12(新增 detect_environment 环境探测工具)。
        // AST 代码智能(7c2e3b2): file 层 12→13(新增 read_symbol 符号解析,治 read_file 全文回灌 prompt 爆)。
        // 知识图谱 Phase 1(2026-06-26): data 层 18→24(新增 register_task_graph_tools 6 工具:
@@ -1332,7 +1332,7 @@ mod tests {
        //   register_git_tools 3 个)
        // Git 写工具(2026-06-29): data 层 31→34(新增 git_commit/git_branch/git_merge,
        //   register_git_tools 3→6)
-        // BUG-2026-07-07: 修正 baseline 计数(原写死 41 与实际 48 不符,HEAD 上即失败)。
+        // 修正 baseline 计数(原写死 41 与实际 48 不符,HEAD 上即失败)。
        //   48 = 34 data + 13 file + 1 http。data 34 含 6 知识图谱 + 2 基础设施 + 1 module + 6 git。
        // update_idea/delete_idea(2026-08-01): data 层 34→36(补 AI 改/删灵感专用工具,
        //   idea_repo.update_field / soft_delete 早已具备,工具层此前缺失致 AI 误用 update_task)。
@@ -1780,7 +1780,7 @@ mod tests {
    }

    // ============================================================
-    // patch_file 三模式共用底层测试（F-260617-01）
+    // patch_file 三模式共用底层测试
    // 纯函数 apply_line_range / resolve_anchor_to_lines，不依赖 fs/async/锁。
    // handler 闭包内的三模式分派/互斥校验逻辑由参数解析+这两个函数组合而成，
    // 故覆盖纯函数即覆盖 replace_lines/anchor 两模式核心；old_text 模式逻辑
@@ -1942,7 +1942,7 @@ mod tests {
    }

    // ============================================================
-    // grep 工具测试（F-260621）
+    // grep 工具测试
    //
    // compile_glob_to_regex:纯函数,无 fs 依赖。
    // grep_recursive:递归遍历临时目录树,覆盖基本匹配/正则/大小写/glob/噪音跳过/截断。
@@ -81,7 +81,7 @@ pub fn register(
                &snap,
            )?;
            let path = resolved.to_str().ok_or_else(|| anyhow::anyhow!("路径含非法字符"))?;
-            // 单次 File::open 取 metadata+read 消除 TOCTOU(FR-S2:原 metadata+read 两步 syscall 间 symlink 替换破 1MB 限)
+            // 单次 File::open 取 metadata+read 消除 TOCTOU原 metadata+read 两步 syscall 间 symlink 替换破 1MB 限)
        use tokio::fs::File;
        use tokio::io::AsyncReadExt;
        let mut file = File::open(path).await
@@ -143,7 +143,7 @@ pub fn register(
            }));
        }
        // 默认分页模式: limit 硬上限 2000 行(防 LLM 传超大 limit 读全文件,1MB 限下仍可能数万行)
-        // BUG-260617-11: 无 offset 时旧实现 content.clone() 全量返回大文件,
+        // 无 offset 时旧实现 content.clone() 全量返回大文件,
        // 虽 1MB 字节上限挡住极端情况,但万行级源码全量进 LLM context 仍易撑爆。
        // 改:无 offset 默认返回前 500 行 + has_more 提示翻页(对齐 read 工具常规用法)。
        let line_count = content.lines().count();
@@ -157,7 +157,7 @@ pub fn register(
        } else {
            // 无 offset: 尊重 LLM 传入的 limit(对齐有 offset 分支语义),
            // 未传 limit 默认 500 行(大文件翻页友好,避免一次灌入全量)。
-            // BUG-260623-01: 旧实现固定 take(500) 忽略 limit,
+            // 旧实现固定 take(500) 忽略 limit,
            // 实测 LLM 传 limit=15 仍返回 430 行(撑爆 prompt + 触发 truncate 破坏 JSON)。
            const DEFAULT_PREVIEW_LINES: usize = 500;
            let limit = args["limit"].as_u64()
@@ -319,7 +319,7 @@ pub fn register(
            let path = resolved.to_str().ok_or_else(|| anyhow::anyhow!("路径含非法字符"))?;
            let recursive = args["recursive"].as_bool().unwrap_or(false);
            let skip_noise = args["skip_noise_dirs"].as_bool().unwrap_or(true);
-            // BUG-260617-09: max_depth 由 LLM 参数控制,无上限时虽 entries 上限(1000)
+            // max_depth 由 LLM 参数控制,无上限时虽 entries 上限(1000)
            // 隐式约束,但深递归仍可能大量 fs IO / 撑爆上下文。clamp 到合理范围 1-10。
            let max_depth = args["max_depth"].as_u64().unwrap_or(3).clamp(1, 10) as usize;
            let mut entries = Vec::new();
@@ -348,7 +348,7 @@ pub fn register(
            )?;
            let path = resolved.to_str().ok_or_else(|| anyhow::anyhow!("路径含非法字符"))?;
            let raw = args["content"].as_str().ok_or_else(|| anyhow::anyhow!("缺少 content 参数"))?;
-            // F-260615-11: encoding 参数支持 base64,写二进制(图片/PDF/Excel 等)
+            // encoding 参数支持 base64,写二进制(图片/PDF/Excel 等)
            // 默认 utf-8:走原 &str 字节写入;base64:解码为 Vec<u8> 写字节
            let encoding = args.get("encoding").and_then(|v| v.as_str()).unwrap_or("utf-8");
            let bytes: Vec<u8> = if encoding.eq_ignore_ascii_case("base64") {
@@ -360,7 +360,7 @@ pub fn register(
            } else {
                anyhow::bail!("不支持的 encoding: {}（仅 utf-8 / base64）", encoding);
            };
-            // 写入大小上限(FR-S2:原无限制,LLM 经审批可写超大文件撑爆磁盘/对话历史)
+            // 写入大小上限原无限制,LLM 经审批可写超大文件撑爆磁盘/对话历史)
            if bytes.len() > 1_048_576 {
                anyhow::bail!("写入内容超过 1MB 限制 ({} 字节)", bytes.len());
            }
@@ -378,8 +378,8 @@ pub fn register(
                Err(_) => None,   // 不存在(新建)
            };
            if let Some(parent) = target.parent() {
-                // FR-S8:parent 必须在授权目录内(防 path=授权根时 parent 越界 create_dir_all)。
-                // BUG-260623-01:原用 workspace_root()(编译期写死 devflow 源码目录)→ 用户授权的其他项目
+                // parent 必须在授权目录内(防 path=授权根时 parent 越界 create_dir_all)。
+                // 原用 workspace_root()(编译期写死 devflow 源码目录)→ 用户授权的其他项目
                // 目录(ai-news 等)parent 不 starts_with 它 → 误拒授权目录内写。改用 allowed_dirs 白名单。
                if !snap.is_authorized(parent) {
                    anyhow::bail!("禁止在项目目录之外创建目录");
@@ -397,7 +397,7 @@ pub fn register(
                let _ = tokio::fs::remove_file(&tmp).await;
                return Err(anyhow::anyhow!("原子替换失败: {}", e));
            }
-            // R-P2-2:rename 成功后清理 .bak(原子写已完成,.bak 不再需要);
+            // rename 成功后清理 .bak(原子写已完成,.bak 不再需要);
            // rename 失败分支不删 .bak——它是回退依据(失败分支已 return,不会走到这里)。
            // 仅当 old_size>0(曾备份过)才清理;忽略清理失败(非阻断,最多留个孤儿 .bak 文件)
            if old_size.map(|s| s > 0).unwrap_or(false) {
@@ -464,7 +464,7 @@ pub fn register(
            let new_text = args["new_text"].as_str()
                .ok_or_else(|| anyhow::anyhow!("缺少 new_text 参数"))?;

-            // F-260617-01: 三模式互斥校验（old_text / replace_lines / anchor）
+            // 三模式互斥校验（old_text / replace_lines / anchor）
            // 三选一：统计传入的模式参数数，>1 报错，0 报错（缺定位方式）
            let has_old_text = args.get("old_text").map(|v| !v.is_null()).unwrap_or(false);
            let has_replace_lines = args.get("replace_lines").map(|v| !v.is_null()).unwrap_or(false);
@@ -491,7 +491,7 @@ pub fn register(
                anyhow::bail!("文件超过 1MB 限制 ({} 字节)", file_meta.len());
            }

-            // TD-260621-03:读改写整体锁内防 lost update。
+            // 读改写整体锁内防 lost update。
            // 原实现读+校验+new_content 计算在无锁段,仅写序列持 FILE_LOCKS → 两并发 patch 同文件:
            // A/B 各自读 v1 算 new_content(锁外)→ A 持锁写 v2 释放 → B 持锁用基于 v1 的 new_content 覆盖 A。
            // 改:读+校验+算+写 全程持 _patch_guard,串行化 patch(全局锁,单用户桌面够用,见 FILE_LOCKS 注释)。
@@ -528,7 +528,7 @@ pub fn register(
                }
            }

-            // F-260617-01: 三模式分派计算 new_content + match_count + warning
+            // 三模式分派计算 new_content + match_count + warning
            // old_text 模式：精确匹配（CAS）+ 多匹配警告（仅替换第 1 处）
            // replace_lines 模式：行号区间 splice（越界 Err）
            // anchor 模式：子串锚点定位 → 行号区间 splice（找不到/start 在 end 后 Err）
@@ -548,7 +548,7 @@ pub fn register(
                    }));
                }
                // L2: old_text 精确匹配（CAS 语义）
-                // 失败时附相近片段提示(AC-5):把文件里与 old_text 相似的几行列给 LLM,
+                // 失败时附相近片段提示把文件里与 old_text 相似的几行列给 LLM,
                // 供其对照真实缩进/空格修正锚点,避免靠猜反复重试。完全无关(无相似行)则
                // 退回原提示,不误导。
                if !content.contains(old_text) {
@@ -656,7 +656,7 @@ pub fn register(
            let modified = metadata.modified()
                .ok().and_then(|t| t.duration_since(std::time::UNIX_EPOCH).ok())
                .map(|d| d.as_millis() as i64);
-            // is_binary: 流式读前 8KB 检测 \x00 (BUG-260617-02)
+            // is_binary: 流式读前 8KB 检测 \x00 
            // 旧实现 tokio::fs::read(path) 把整个文件读进内存再切片前 8192,
            // >2MB 文件触发 OOM(注释">2MB 跳过"只作用于 lines, is_binary 无防护)。
            // 改:File::open + BufReader + .take(8192) 只读前 N 字节做二进制检测,
@@ -701,7 +701,7 @@ pub fn register(
            let path = resolved.to_str().ok_or_else(|| anyhow::anyhow!("路径含非法字符"))?;
            let content = args["content"].as_str().ok_or_else(|| anyhow::anyhow!("缺少 content 参数"))?;
            if let Some(parent) = std::path::Path::new(path).parent() {
-                // BUG-260623-01:用 allowed_dirs 校验(非 workspace_root 编译期写死),授权目录内 parent 放行
+                // 用 allowed_dirs 校验(非 workspace_root 编译期写死),授权目录内 parent 放行
                if !snap.is_authorized(parent) {
                    anyhow::bail!("禁止在项目目录之外创建目录");
                }
@@ -779,7 +779,7 @@ pub fn register(
                let backup_name = format!("{}-{}", new_id(), file_name);
                let backup_path = trash_dir.join(&backup_name);
                let backup_path_str = backup_path.to_string_lossy().to_string();
-                // 软删除跨盘降级(F-260621):同盘 rename 原子;跨盘(Windows EXDEV os error 17,
+                // 软删除跨盘降级同盘 rename 原子;跨盘(Windows EXDEV os error 17,
                // 如 C盘授权路径 → data_dir/.trash)rename 失败,降级 copy + remove(非原子,
                // 失败回滚删 backup 保源完整)。
                // 阶段4:跨盘降级抽统一 helper rename_or_cross_volume_copy(对齐 rename_file 跨卷处理),
@@ -846,7 +846,7 @@ pub fn register(
            // 目标父目录不存在则创建(对齐 write_file L643/append_file L851,跨目录移动到不存在父目录否则 rename 失败)
            let to_target = std::path::Path::new(to_path);
            if let Some(parent) = to_target.parent() {
-                // BUG-260623-01:用 allowed_dirs 校验(非 workspace_root 编译期写死),授权目录内 parent 放行
+                // 用 allowed_dirs 校验(非 workspace_root 编译期写死),授权目录内 parent 放行
                if !snap.is_authorized(parent) {
                    anyhow::bail!("禁止在项目目录之外创建目录");
                }
@@ -959,7 +959,7 @@ pub fn register(
            let mut matches_out: Vec<FileGrepHit> = Vec::new();
            let mut total: usize = 0;
            let mut truncated = false;
-            // BUG-260625-01: path 可能是单文件(grep 命令行原生支持单文件,LLM 常传文件路径)。
+            // path 可能是单文件(grep 命令行原生支持单文件,LLM 常传文件路径)。
            // 旧实现直接 grep_recursive(root) → 内部 read_dir → 文件路径报 os error 267「目录名称无效」。
            // 改:文件走 grep_one_file(单文件匹配),目录走 grep_recursive(递归)。
            let root_meta = tokio::fs::metadata(root).await
@@ -1103,7 +1103,7 @@ pub fn register(
            let mut out = serde_json::json!({
                "path": path, "pattern": pattern, "results": page_results, "total": total, "has_more": has_more
            });
-            // AC-5:total=0 时空结果引导(治 LLM 搜不到就放弃/盲目重试)。
+            // total=0 时空结果引导(治 LLM 搜不到就放弃/盲目重试)。
            // 注:search_files 已大小写不敏感(内部 pattern.to_lowercase + 包含匹配),文案勿写"换大小写"。
            if total == 0 {
                out["hint"] = serde_json::json!("未找到匹配文件。可尝试: ① 放宽关键词(更短/字符更少); ② 用 grep 工具做跨文件内容正则搜索(pattern 支持正则, -i 大小写不敏感)。注: search_files 为文件名大小写不敏感包含匹配");
@@ -1156,7 +1156,7 @@ pub fn register(
                timeout_secs: Some(timeout_secs),
                shell_type: Default::default(),
            };
-            // F-260616-04:超时标注——execute 超时返 Err("命令执行超时: N秒")。
+            // 超时标注——execute 超时返 Err("命令执行超时: N秒")。
            // 原行为:该 Err 经 ? 上抛 → 人工审批路径(commands.rs ai_approve L256)把 e.to_string()
            // 包成 tool_result 回传 LLM → LLM 误判命令失败而非超时 → 盲目重试同命令 →
            // 新 tool_call_id → 重新 insert pending → 重新审批,「再过一会又提示 Run Command」循环。
@@ -1391,13 +1391,13 @@ fn similar_line_fragments(content: &str, needle: &str, max: usize) -> Vec<String
 }

 // ============================================================
-// read_file/read_symbol NotFound 提示辅助 — 相近文件名候选(AC-5)
+// read_file/read_symbol NotFound 提示辅助 — 相近文件名候选
 // ============================================================

 /// 父目录下与 needle 文件名最相近的 max 个文件名(Dice 字符多重集,思路同 similar_line_fragments)。
 ///
 /// 用途:read_file/read_symbol 打开文件 NotFound 时,把父目录下最可能的文件名候选附进错误提示,
-/// 治 LLM 拼错文件名/少写扩展名后盲目重试(AC-5)。低频错误路径(文件不存在),同步 std::fs::read_dir
+/// 治 LLM 拼错文件名/少写扩展名后盲目重试。低频错误路径(文件不存在),同步 std::fs::read_dir
 /// 枚举可接受(目录通常不大)。阈值 40% 防误导(完全无关文件名不提示);父目录不可读/非目录返空。
 fn similar_file_names(dir: &std::path::Path, needle: &str, max: usize) -> Vec<String> {
    if needle.is_empty() {
@@ -1445,7 +1445,7 @@ fn similar_file_names(dir: &std::path::Path, needle: &str, max: usize) -> Vec<St
    scored.into_iter().map(|(_, s)| s).collect()
 }

-/// 文件打开 NotFound 的统一错误文案:基础提示 + 父目录相近文件名候选(AC-5)。
+/// 文件打开 NotFound 的统一错误文案:基础提示 + 父目录相近文件名候选。
 ///
 /// read_file / read_symbol 共用(DRY)。保留原「建议用 list_directory」引导;候选为空不追加。
 fn file_not_found_error(path: &str) -> anyhow::Error {
@@ -34,7 +34,7 @@ use df_storage::db::Database;
 /// 只读工具(status/diff/log)直接调本函数拿退出码做差异语义:git diff 退 1 = 有差异是
 /// **合法成功**、git log 退 128 = 非 git 仓是失败;单纯 bool(exit==0)无法区分。
 ///
-/// BUG-2026-07-18: 原实现 spawn_blocking 内裸 std::process::Command::output() 无 timeout
+/// 原实现 spawn_blocking 内裸 std::process::Command::output() 无 timeout
 /// (注释谎称"10s 超时")。git 在 OneDrive/网盘/挂载盘/lfs/大仓库场景会卡数十秒到无限,
 /// spawn_blocking 线程永不返回 → 累计耗尽 tokio blocking 池 → 间接卡死单线程 runtime
 /// (与 env_snapshot::probe_version 同型病根)。AI 的 git_status/log/diff 工具在会话内高频触发。
@@ -42,7 +42,7 @@ use df_storage::db::Database;
 /// 改用 tokio::process + tokio::time::timeout(10s) + kill_on_drop:超时 drop 时 child 进程
 /// 被 kill,不泄漏线程/进程,对齐 shell.rs execute 同源封装。
 ///
-/// BUG-2026-08-02: 原签名返 String,失败/超时统一吞成空串,使 create/switch/commit 三个写操作
+/// 原签名返 String,失败/超时统一吞成空串,使 create/switch/commit 三个写操作
 /// 恒返成功假象(commit 失败 HEAD 不动,log -1 仍返上次 hash → committed:true)。
 /// 改返 (String, bool),上层据 success 判定真实成败。
 async fn exec_git_exit(working_dir: &str, args: &[&str]) -> (String, Option<i32>) {
@@ -111,7 +111,7 @@ pub fn register(registry: &mut AiToolRegistry, db: &Arc<Database>) {
            let stack_opt = args.get("stack").and_then(|v| v.as_str()).filter(|s| !s.is_empty());
            let repo = df_storage::crud::ProjectRepo::new(&db);
            let stack = bind_dir_to_project(&repo, id, path, stack_opt).await?;
-            // F-260619-03: 项目绑定目录加 AI 白名单由 reload_allowed_dirs 自动读 projects.bind_directory
+            // 项目绑定目录加 AI 白名单由 reload_allowed_dirs 自动读 projects.bind_directory
            // 统一处理(优雅:绑定 = 自动授权,reload 时合并)。bind handler 不直接写 allowed_dirs
            // (register_project_tools 无 allowed_dirs 参数,且 reload 集中更易维护)。
            // 绑定后触发 reload:通过 app_handle emit 事件让 state reload,或下次工具调用前 reload 兜底。
@@ -150,7 +150,7 @@ pub fn register(registry: &mut AiToolRegistry, db: &Arc<Database>) {
            // 透传 affected:0 行(id 不存在 / 已软删)→ updated=false + title 空,
            // 让 AI 知道 id 不对而非假成功(对齐 update_idea)。
            let updated = repo.update_field(id, field, value).await?;
-            // UX-260619-04: 返回 title 供前端卡片友好展示(对齐 advance_task 返 TaskRecord,
+            // 返回 title 供前端卡片友好展示(对齐 advance_task 返 TaskRecord,
            // 防裸 UUID id 辨识度低)。update_field 返 bool 不含 record,单独 get_by_id 取 title。
            let title = repo.get_by_id(id).await?.map(|t| t.title).unwrap_or_default();
            Ok(serde_json::json!({ "id": id, "title": title, "field": field, "updated": updated }))
@@ -158,7 +158,7 @@ pub fn register(registry: &mut AiToolRegistry, db: &Arc<Database>) {
    );

    // F-03 收口(子项1):advance_task AI 工具 — 推进任务状态的唯一合法路径。
-    // D-260616-03:推进链业务逻辑(状态机校验 + 原子 CAS + review_rounds 累加)落
+    // 推进链业务逻辑(状态机校验 + 原子 CAS + review_rounds 累加)落
    // df-nodes::task_advance_node::advance_task_atomic,本 handler 直接调它(与 IPC
    // commands::task::advance_task 同源,thin 转发),无需 AppHandle/State/EventBus。
    // 风险 Medium:status 变更属状态机推进(非破坏),但改变任务流转语义需人工知情。
@@ -203,7 +203,7 @@ pub fn register(registry: &mut AiToolRegistry, db: &Arc<Database>) {
        }
    );

-    // FR-D6:delete_task 对齐 commands::task::delete_task(D-260616-02 软删除)
+    // delete_task 对齐 commands::task::delete_task(D-260616-02 软删除)
    // tasks 表 V14 加 deleted_at,delete_task 改调 soft_delete 移入回收站(对标 delete_project)
    declare_tool!(
        registry,
@@ -53,7 +53,7 @@ fn parse_repo_url(repo_url: &str) -> Option<(String, String, String)> {
        return None;
    }
    let host = url.host_str()?;
-    // BUG-2026-07-07: port_or_known_default() 对 https 返 Some(443)、http 返 Some(80),
+    // port_or_known_default() 对 https 返 Some(443)、http 返 Some(80),
    // 致 authority 总是带默认端口(:443/:80),base URL 形如 "https://host:443" 而非规范
    // "https://host"。下游 Gitea API 调用虽大多容忍,但测试断言与可读性受影响。
    // 修复:仅当端口非 scheme 默认端口时才拼入 authority(显式非默认端口才保留)。
@@ -34,7 +34,7 @@ fn default_priority() -> i32 {

 /// 列出灵感。
 ///
-/// **双路径向后兼容**(F-260621-02):
+/// **双路径向后兼容**
 /// - 旧调用方仅传 `status`(`ideaApi.list(status)`)→ 转 IdeaQuery 仅带 status,走
 ///   `list_by_query`(白名单 status 列 WHERE),与原 `query("status", s)` 等价。
 /// - 新调用方传 `query`(`ideaApi.list(query)`)→ 多条件(status/keyword/order_by/limit/offset)。
@@ -73,7 +73,7 @@ pub async fn create_idea(
    state: State<'_, AppState>,
    input: CreateIdeaInput,
 ) -> Result<IdeaRecord, String> {
-    // IDEA-FIX-03: priority 值域校验 ∈ 0..=3 (对标 tasks B-260615-15)。
+    // priority 值域校验 ∈ 0..=3 (对标 tasks B-260615-15)。
    // priority_from_i32 对越界值兜底归并(>=3→Critical),但 IPC 入口应显式拒非法值,
    // 防 LLM/前端传 99 等被静默吞为 Critical。
    if !(0..=3).contains(&input.priority) {
@@ -121,7 +121,7 @@ pub async fn update_idea(
    field: String,
    value: String,
 ) -> Result<bool, String> {
-    // BE-CMD-4:status 值合法性校验(防任意值进库)+ 拒绝经 update_field 直达 promoted
+    // status 值合法性校验(防任意值进库)+ 拒绝经 update_field 直达 promoted
    // (半立项:绕过 promote_idea 不建项目不写 promoted_to,须走立项流程)。
    if field == "status" {
        if IdeaStatus::from_db_str(value.trim()).is_none() {
@@ -142,7 +142,7 @@ pub async fn update_idea(
        serde_json::from_str::<serde_json::Value>(&value)
            .map_err(|e| format!("{field} 不是合法 JSON: {e}"))?;
    }
-    // LW-6(BE-CMD-5):update_field_active 过滤软删(deleted_at IS NULL),回收站灵感不可改字段。
+    // update_field_active 过滤软删(deleted_at IS NULL),回收站灵感不可改字段。
    let updated = state
        .ideas
        .update_field_active(&id, &field, &value)
@@ -230,7 +230,7 @@ pub async fn promote_idea(
        .await
        .map_err(err_str)?;

-    // LW-8(BE-CMD-7):CAS 回写灵感(status=promoted + promoted_to,WHERE id AND promoted_to IS NULL)。
+    // LW-8CAS 回写灵感(status=promoted + promoted_to,WHERE id AND promoted_to IS NULL)。
    // 双击/并发两次 promote 都读到 promoted_to=None → 各自建项目;本方法原子「立项认领」,
    // 仅首个 affected=1 成功,第二个 affected=0 → 判定「已立项」并补偿软删刚建项目(回滚)。
    // 替代原 update_full(无条件覆盖):并发下两个项目都保留、灵感只指向一个,留悬空项目。
@@ -386,7 +386,7 @@ async fn evaluate_one(
    engine: &df_ideas::adversarial::AdversarialEngine,
 ) -> Result<IdeaRecord, String> {
    let id = record.id.clone();
-    // LW-7(BE-CMD-6):终态灵感不可再评估(防无条件覆盖 pending_review 打回终态)。
+    // LW-7终态灵感不可再评估(防无条件覆盖 pending_review 打回终态)。
    // promoted(已立项)/archived(已归档)是终态,评估会把 status 覆盖回 pending_review,
    // 破坏「已立项/已归档不可回退」语义。软删灵感由 evaluate_idea/batch 的存在性检查已过滤。
    if matches!(record.status, IdeaStatus::Promoted | IdeaStatus::Archived) {
@@ -545,7 +545,7 @@ fn record_to_idea(record: &IdeaRecord) -> Idea {
        },
        None => Vec::new(),
    };
-    // IDEA-FIX-05: 读真实 related_ids(原硬编码 Vec::new() 丢关联上下文)。解析同 tags 模式。
+    // 读真实 related_ids(原硬编码 Vec::new() 丢关联上下文)。解析同 tags 模式。
    let related_ids: Vec<String> = match record.related_ids.as_deref() {
        Some(r) => match serde_json::from_str::<Vec<String>>(r) {
            Ok(v) => v,
@@ -560,7 +560,7 @@ fn record_to_idea(record: &IdeaRecord) -> Idea {
        id: record.id.clone(),
        title: record.title.clone(),
        description: record.description.clone(),
-        // IDEA-FIX-05: 读真实 status(原硬编码 Draft 丢真实状态,评估上下文完整性)
+        // 读真实 status(原硬编码 Draft 丢真实状态,评估上下文完整性)
        status: status_from_str(record.status.as_str()),
        priority: priority_from_i32(record.priority),
        scores: None,
@@ -587,7 +587,7 @@ fn priority_from_i32(p: i32) -> Priority {
    }
 }

-/// IDEA-FIX-05: idea status 字符串(DB snake_case)→ IdeaStatus 枚举。
+/// idea status 字符串(DB snake_case)→ IdeaStatus 枚举。
 /// record_to_idea 读真实 status 用(原硬编码 Draft 丢真实状态)。未知值 fallback Draft(同原行为)。
 fn status_from_str(s: &str) -> df_types::types::IdeaStatus {
    use df_types::types::IdeaStatus;
@@ -8,7 +8,7 @@ use tauri::State;
 use df_ai::provider::{ChatMessage, CompletionRequest};
 // F-01 阶段5: 项目扫描描述路由 — TaskRequirements(采样含图时追加 Vision,
 // 当前采样(ProjectSample)未含图像,故仅 Text)。池空/无匹配兜底 default_model。
-// 注:路由已解耦(B-260618-03),原 Standard 智力约束已删除,纯 weight 选模型。
+// 注:路由已解耦,原 Standard 智力约束已删除,纯 weight 选模型。
 use df_ai::router::{
    select_model_id, Modality, TaskRequirements,
 };
@@ -78,7 +78,7 @@ pub struct CreateProjectInput {

 /// 列出未删除项目(过滤回收站)。
 ///
-/// F-260621-02:吃可选 query(关键词/排序/分页),向后兼容——不传(或 None)走 list_active
+/// 吃可选 query(关键词/排序/分页),向后兼容——不传(或 None)走 list_active
 /// 全量(deleted_at IS NULL + created_at DESC),零破坏;传 query 走 list_by_query 动态 WHERE。
 ///
 /// 问题3(项目最近活跃排序):默认无 query 路径改走 list_active_with_activity,返回
@@ -228,7 +228,7 @@ async fn create_with_binding(
            tracing::warn!("创建项目时自动建工程失败(非阻断): {}", e);
        }
    }
-    // F-260620: 绑定目录变更后立即 reload 白名单(reload_allowed_dirs 读 projects.path 合并 persistent),
+    // 绑定目录变更后立即 reload 白名单(reload_allowed_dirs 读 projects.path 合并 persistent),
    // 否则新绑定目录需重启/改 Settings 才生效 → AI 访问误弹窗(已绑定重复弹窗主因,agent3 问题5)
    if record.path.is_some() {
        state.reload_allowed_dirs().await;
@@ -338,7 +338,7 @@ pub async fn get_project(

 /// 更新项目单个字段（字段名走 df-storage 白名单校验）
 ///
-/// B-260801-01(P0-1):0 行(id 不存在 / 已软删)→ 返 Err 而非假成功。原实现无视
+/// B-260801-010 行(id 不存在 / 已软删)→ 返 Err 而非假成功。原实现无视
 /// update_field 返回值恒返 Ok(true),前端误以为成功但库无变更(UI/DB 不一致)。
 ///
 /// 返回值保持 bool(成功恒 true):前端 api 包装 `Promise<boolean>` 契约不变零破坏,
@@ -351,7 +351,7 @@ pub async fn update_project(
    field: String,
    value: String,
 ) -> Result<bool, String> {
-    // BE-CMD-3:白名单剔除 id/created_at 已下沉 storage(allowed_columns_for,update_field 直拒,
+    // 白名单剔除 id/created_at 已下沉 storage(allowed_columns_for,update_field 直拒,
    // 防改主键/伪造创建时间致子表悬空),此处补剩余字段的语义校验:
    // - status:值合法性(ProjectStatus::from_db_str,防任意值进库静默归 planning)
    // - stack:JSON 合法性(防脏 JSON 落库)
@@ -396,7 +396,7 @@ pub async fn update_project(
        state.reload_allowed_dirs().await;
        return Ok(true);
    }
-    // LW-6(BE-CMD-5):update_field_active 过滤软删(deleted_at IS NULL),回收站项目不可改字段。
+    // update_field_active 过滤软删(deleted_at IS NULL),回收站项目不可改字段。
    let updated = state
        .projects
        .update_field_active(&id, &field, &value)
@@ -405,7 +405,7 @@ pub async fn update_project(
    if !updated {
        return Err(format!("项目 ID {id} 不存在或已删除"));
    }
-    // F-260620: path 字段变更后立即 reload 白名单(新绑定/重绑目录即时生效,防 AI 误弹窗)
+    // path 字段变更后立即 reload 白名单(新绑定/重绑目录即时生效,防 AI 误弹窗)
    if field == "path" {
        state.reload_allowed_dirs().await;
    }
@@ -448,7 +448,7 @@ pub async fn purge_project(state: State<'_, AppState>, id: String) -> Result<boo

 /// 查找已绑定该目录的项目(排除 exclude_id 自身)。无冲突返回 None。
 ///
-/// 委托 `ProjectRepo::find_path_conflict`(DRY R-PD-11:与 tool_registry::bind_dir_to_project
+/// 委托 `ProjectRepo::find_path_conflict`(DRY 与 tool_registry::bind_dir_to_project
 /// 共用同一防重复绑定实现)。normalize_path 内含 canonicalize,防 `C:\a\b` vs `C:/a/b/` 绕过。
 async fn find_binding_conflict(
    state: &AppState,
@@ -508,7 +508,7 @@ pub async fn relocate_project_path(
        .update_field(&id, "path", &new_path)
        .await
        .map_err(err_str)?;
-    // F-260620: 重定位目录后立即 reload 白名单(新路径即时授权,防 AI 误弹窗)
+    // 重定位目录后立即 reload 白名单(新路径即时授权,防 AI 误弹窗)
    state.reload_allowed_dirs().await;
    state
        .projects
@@ -6,7 +6,7 @@ use tauri::State;
 use df_types::types::{new_id, TaskStatus};
 use df_storage::crud::TaskQuery;
 use df_storage::models::{ProjectEventRecord, TaskLinkRecord, TaskRecord};
-// LW-9(BE-CMD-8):父任务聚合重算(df-nodes 共享层,与 advance_task 同源,消除双轨)。
+// LW-9父任务聚合重算(df-nodes 共享层,与 advance_task 同源,消除双轨)。
 use df_nodes::task_advance_node::recompute_parent_status;

 use crate::state::AppState;
@@ -247,7 +247,7 @@ pub async fn create_task(
    state: State<'_, AppState>,
    input: CreateTaskInput,
 ) -> Result<TaskRecord, String> {
-    // ── BE-CMD-1:空 title trim 拒空 + priority 值域校验(对齐前端 PRIORITY_LABELS 与
+    // ── 空 title trim 拒空 + priority 值域校验(对齐前端 PRIORITY_LABELS 与
    // update_task 校验,拦截空白标题 / 99 等脏数据静默落库)。 ──
    let title = input.title.trim().to_string();
    if title.is_empty() {
@@ -321,7 +321,7 @@ pub async fn create_task(
        base_branch: None,
        review_rounds: 0,
        output_json: None,
-        // F-260619-01:空字符串视为不关联(与 AI 工具层一致)
+        // 空字符串视为不关联(与 AI 工具层一致)
        idea_id: input.idea_id.filter(|s| !s.is_empty()),
        // 多工程:可选关联到具体工程(module)
        module_id: input.module_id.filter(|s| !s.is_empty()),
@@ -348,7 +348,7 @@ pub async fn create_task(
        Some(record.status.as_str()),
    )
    .await;
-    // LW-9(BE-CMD-8):建子任务后触发父聚合重算(容器模型,父 status 由子任务聚合)。
+    // LW-9建子任务后触发父聚合重算(容器模型,父 status 由子任务聚合)。
    // 聚合失败仅 warn 不阻断(对齐 advance_task 宽容语义)。
    if let Some(pid) = &record.parent_id {
        if let Err(e) = recompute_parent_status(&state.tasks, pid).await {
@@ -365,7 +365,7 @@ pub async fn create_task(

 /// 更新任务单个字段（字段名走 df-storage 白名单校验；status 值走枚举校验）。
 ///
-/// B-260801-01(P0-1):0 行(id 不存在 / 已软删)→ 返 Err 而非 false,杜绝「假成功」
+/// B-260801-010 行(id 不存在 / 已软删)→ 返 Err 而非 false,杜绝「假成功」
 /// (前端 updateTask 仅 await 不读 bool,但 store.runWithCatch 把 Err 转 toast,用户能感知;
 /// 若返 false 则 store 静默忽略,本地状态前端手动改但库无变更,造成 UI 与 DB 不一致)。
 ///
@@ -439,7 +439,7 @@ pub async fn update_task(
        }
        // 空字符串 = None(解除父),合法放行
    }
-    // LW-4(BE-CMD-1):queue 字段校验(白名单 + queue/status 一致性,读当前 status)。
+    // queue 字段校验(白名单 + queue/status 一致性,读当前 status)。
    // update_task 只改单字段不改 status,故用严格一致性校验(与 move_task_queue 自动联动不同):
    // 设置不兼容的 queue 直接拒绝,调用方需走 move_task_queue 自动联动调整 status。
    if field == "queue" {
@@ -453,13 +453,13 @@ pub async fn update_task(
            .ok_or_else(|| format!("任务 ID {id} 不存在或已删除"))?;
        assert_queue_status_consistent(q, current.status.as_str())?;
    }
-    // B-260801-01(P0-1):update_field 返 affected>0;false = id 不存在或已软删(0 行)。
+    // update_field 返 affected>0;false = id 不存在或已软删(0 行)。
    // 不可静默返 false——前端 store.runWithCatch 把 Err 转 toast,而 false 会被忽略致假成功。
    //
    // 任务字段更新是高频「项目活跃」信号(改 title/priority/assignee 等),埋点 task_updated
    // 推动项目最近活跃排序反映真实业务(问题3)。best-effort 不阻断。
    // 读当前 project_id(一次轻量读):update_field 返 bool 不带 project_id,无法直接埋点。
-    // LW-6(BE-CMD-5):update_field_active 过滤软删(deleted_at IS NULL),回收站任务不可改字段。
+    // update_field_active 过滤软删(deleted_at IS NULL),回收站任务不可改字段。
    let current = state
        .tasks
        .get_by_id(&id)
@@ -473,7 +473,7 @@ pub async fn update_task(
    if !updated {
        return Err(format!("任务 ID {id} 不存在或已删除"));
    }
-    // LW-9(BE-CMD-8):改 parent_id 后重算父聚合——旧父(任务已离开,计数减少)与新父(任务挂上)。
+    // LW-9改 parent_id 后重算父聚合——旧父(任务已离开,计数减少)与新父(任务挂上)。
    // 从 current 读旧 parent_id(pre-update),value 是新父值。聚合失败仅 warn 不阻断。
    if field == "parent_id" {
        if let Some(old_pid) = current.as_ref().and_then(|c| c.parent_id.clone()) {
@@ -590,7 +590,7 @@ pub async fn restore_task(state: State<'_, AppState>, id: String) -> Result<bool

 /// 推进任务状态(任务推进链 F-260616-02,推进链唯一 status 写入路径)。
 ///
-/// thin 入口(D-260616-03):业务逻辑(状态机校验 + 原子 CAS + review_rounds 累加 + 父聚合)
+/// thin 入口业务逻辑(状态机校验 + 原子 CAS + review_rounds 累加 + 父聚合)
 /// 落 df-nodes::task_advance_node,本命令只做参数转发与结果包装。
 ///
 /// 返回: `Result<TaskRecord, String>` — 成功返更新后的任务;失败 Err(状态机拒绝/CAS 冲突/
@@ -794,7 +794,7 @@ pub async fn move_task_queue(
        .await;
    }

-    // LW-9(BE-CMD-8):跨池移动后子任务 status 可能联动变化(一致性联动)→ 触发其父聚合重算。
+    // LW-9跨池移动后子任务 status 可能联动变化(一致性联动)→ 触发其父聚合重算。
    // 仅当被移动任务是子任务;父任务自身 move 不重算自身聚合(容器 status 由子任务推进时重算)。
    // 聚合失败仅 warn 不阻断。
    if let Some(pid) = &updated.parent_id {
@@ -102,9 +102,9 @@ pub async fn run_workflow(
    task_id: Option<String>,
    target_status: Option<String>,
 ) -> Result<String, String> {
-    // 瘦转发到 run_workflow_inner(B-260617-01:抽取共用核心供 ai_approve 经
+    // 瘦转发到 run_workflow_inner抽取共用核心供 ai_approve 经
    // execute_run_workflow_for_tool 直接调,无需构造 tauri::State)。
-    // CR-52: 命令层(前端 invoke run_workflow)是人工手动触发 → triggered_by="manual"。
+    // 命令层(前端 invoke run_workflow)是人工手动触发 → triggered_by="manual"。
    run_workflow_inner(&app, &state, name, dag, config, task_id, target_status, "manual").await
 }

@@ -117,7 +117,7 @@ pub async fn run_workflow(
 /// `triggered_by` 落入 WorkflowRecord.triggered_by,区分触发来源:
 ///   - 命令层 run_workflow(前端 invoke,人工手动)传 "manual"
 ///   - execute_run_workflow_for_tool(AI 工具经 ai_approve 审批后执行)传 "ai"
-///   CR-52:原硬编码 "manual" 致 AI 路径误标,改由调用方透传。
+///   原硬编码 "manual" 致 AI 路径误标,改由调用方透传。
 pub async fn run_workflow_inner(
    app: &AppHandle,
    state: &AppState,
@@ -148,7 +148,7 @@ pub async fn run_workflow_inner(
    // 1. 先构建运行时 DAG，校验失败直接返回，不落库
    let runtime_dag = state.registry.build_dag(&dag).map_err(err_str)?;

-    // 2. P2-I: 反查 project_id（task_id 有值时），不阻塞工作流
+    // 2. 反查 project_id（task_id 有值时），不阻塞工作流
    let project_id = match &task_id {
        Some(tid) => TaskRepo::new(&state.db)
            .get_by_id(tid)
@@ -167,7 +167,7 @@ pub async fn run_workflow_inner(
        name,
        dag_json,
        status: "running".to_string(),
-        // CR-52: triggered_by 由调用方透传(命令层 run_workflow="manual",
+        // triggered_by 由调用方透传(命令层 run_workflow="manual",
        // execute_run_workflow_for_tool="ai"),不再硬编码 "manual" 致 AI 路径误标。
        triggered_by: Some(triggered_by.to_string()),
        project_id,
@@ -185,7 +185,7 @@ pub async fn run_workflow_inner(
    let mut rx = state.event_bus.subscribe();
    let forward_app = app.clone();
    let forward_exec_id = execution_id.clone();
-    // B-260615-35: forward 任务内需查 DB 终态兜底 Lagged 丢终态事件，故 move 进 db 句柄
+    // forward 任务内需查 DB 终态兜底 Lagged 丢终态事件，故 move 进 db 句柄
    let forward_db = state.db.clone();
    tauri::async_runtime::spawn(async move {
        // Lagged 累计次数（用于"累计达阈值"触发兜底查询）
@@ -195,7 +195,7 @@ pub async fn run_workflow_inner(
        loop {
            match rx.recv().await {
                Ok(event) => {
-                    // B-03b-R10 ③(波17 治本): 完成判定加 execution_id 匹配。
+                    // b-R10 ③(波17 治本): 完成判定加 execution_id 匹配。
                    // AppState.event_bus 是全局单例,并发工作流各自订阅同一总线;
                    // 此前 matches! 只看变体不看 exec_id,任一工作流的 WorkflowCompleted/Failed
                    // 都会触发本 forward 循环 break,过早断他人链(并发串扰根因)。
@@ -222,7 +222,7 @@ pub async fn run_workflow_inner(
                        break;
                    }
                }
-                // R-PD-13: Lagged 表示消费过慢，broadcast 滑动窗口丢 n 条最旧事件。
+                // Lagged 表示消费过慢，broadcast 滑动窗口丢 n 条最旧事件。
                // broadcast 不暴露被丢事件的具体类型，无法在此精确判断是否为关键终态事件。
                // 风险：若关键终态事件（WorkflowCompleted/WorkflowFailed）被丢，finished 判定不触发，
                //      循环不会 break，前端永久收不到工作流结束信号。
@@ -303,7 +303,7 @@ pub async fn run_workflow_inner(
            .lock()
            .await
            .insert(exec_id.clone(), executor.state_machine());
-        // P0-A: 把 task_id 注入 config，使 AiSelfReviewNode(ctx.config.get("task_id")) 与
+        // 把 task_id 注入 config，使 AiSelfReviewNode(ctx.config.get("task_id")) 与
        //   AiNode parse_params 兜底(ctx.config.get("task_id") 读 task 生成默认 prompt) 可读。
        //   config 是 serde_json::Value，仅 object 时 insert 安全；task_id None 跳过(向后兼容)。
        //   executor.run 之前的 config 是 move 进 run 的，此处 mutate 后整体 move，零额外开销。
@@ -478,7 +478,7 @@ pub async fn get_workflow_execution(

 /// 发送人工审批响应
 ///
-/// F-260615-01: 支持 single/multiple。
+/// 支持 single/multiple。
 ///   - single: decision 单值,decisions 为空(向后兼容);
 ///   - multiple: decisions 数组(≥1 项),decision 留空。
 /// IPC 早校验规则与 HumanNode 下游兜底一致,避免「IPC 成功+工作流失败」割裂。
@@ -489,12 +489,12 @@ pub async fn approve_human_approval(
    execution_id: ExecutionId,
    node_id: String,
    decision: String,
-    // F-260615-01: 多选结果数组,缺省空数组(单选调用方不传)
+    // 多选结果数组,缺省空数组(单选调用方不传)
    decisions: Option<Vec<String>>,
    comment: Option<String>,
-    // R-PD-5: options 由前端从收到的 HumanApprovalRequest 事件透传（IPC 无法访问节点 config）。
+    // options 由前端从收到的 HumanApprovalRequest 事件透传（IPC 无法访问节点 config）。
    options: Vec<String>,
-    // F-260615-01: 选择类型,缺省 single
+    // 选择类型,缺省 single
    select_type: Option<String>,
 ) -> Result<(), String> {
    let _ = &app; // 原签名含 app 参数(未使用),保留避免 invoke_handler 注册签名变化
@@ -70,13 +70,13 @@ pub fn run() {

            // 初始化全局状态（打开数据库 + 执行迁移），传入运行期确定的 data_dir
            let app_state = tauri::async_runtime::block_on(AppState::init(&db_path, data_dir.clone()))?;
-            // FR-S1:启动一次性迁移 DB 明文 api_key → OS keyring(失败保留明文下次重试,非阻断)
+            // 启动一次性迁移 DB 明文 api_key → OS keyring(失败保留明文下次重试,非阻断)
            if let Err(e) = tauri::async_runtime::block_on(
                commands::ai::secret::migrate_secrets_to_keyring(&app_state.ai_providers),
            ) {
                tracing::warn!("[FR-S1] 启动密钥迁移失败(非阻断): {}", e);
            }
-            // B-260616-01: L0 握手 — 提前 clone ai_session(Arc),因 manage() 会 move app_state
+            // L0 握手 — 提前 clone ai_session(Arc),因 manage() 会 move app_state
            let session_for_handshake = app_state.ai_session.clone();
            app.manage(app_state);

@@ -100,7 +100,7 @@ pub fn run() {
                tracing::error!("[tray] 托盘创建失败(非阻断): {}", e);
            }

-            // B-260616-01: L0 握手 — 监听前端就绪事件，清除 HMR/刷新导致的残留 generating 状态
+            // L0 握手 — 监听前端就绪事件，清除 HMR/刷新导致的残留 generating 状态
            // 任务5: 3 秒防抖 —— 前端 HMR/快速连击会连发 ai-client-ready(实测 <1s 内多次),
            // 每次都走完整 握手(spawn + 锁 session + emit)造成事务事并行冲突 + emit 风暴。
            // 记录上次处理时间,3s 内重复事件跳过(只取首次,使能状态复位一次即可)。
@@ -422,7 +422,7 @@ pub fn run() {
            commands::ai::ai_chat_force_send,
            commands::ai::ai_chat_stop,
            commands::ai::ai_approve,
-            // F-260616-03：达 max_iterations 暂停态续/停（消费 AiMaxRoundsReached，前端操作卡留 batch45）
+            // 达 max_iterations 暂停态续/停（消费 AiMaxRoundsReached，前端操作卡留 batch45）
            commands::ai::ai_continue_loop,
            commands::ai::ai_stop_loop,
            commands::ai::ai_pending_tool_calls,
@@ -435,12 +435,12 @@ pub fn run() {
            commands::ai::ai_save_provider,
            commands::ai::ai_set_provider,
            commands::ai::ai_delete_provider,
-            // F-260614-04c: 负载均衡池可编辑层(enabled/weight 轻量更新 + caps 重建)
+            // c: 负载均衡池可编辑层(enabled/weight 轻量更新 + caps 重建)
            commands::ai::ai_update_provider_pool,
            // F-01 阶段5:测试连接拉取模型列表 + 单模型探测
            commands::ai::ai_fetch_models,
            commands::ai::ai_probe_model,
-            // P0-1:用表单当前值一次性测试连接(不写库,新建/编辑未保存均可测)
+            // 用表单当前值一次性测试连接(不写库,新建/编辑未保存均可测)
            commands::ai::ai_test_connection,
            // AI 对话管理
            commands::ai::ai_conversation_create,
@@ -464,7 +464,7 @@ pub fn run() {
            commands::ai::ai_set_allowed_dirs,
            // F-260619-03 Phase B: 路径授权弹窗决策(消费 AiDirAuthRequired 挂起)
            commands::ai::ai_authorize_dir,
-            // 审批历史面板(AE-2025-08:查 ai_tool_executions 表,敏感字段截断)
+            // 审批历史面板查 ai_tool_executions 表,敏感字段截断)
            commands::ai::audit::record::list_tool_executions,
            // AC-5 按工具失败率统计(诊断 IPC,聚合 ai_tool_executions 覆盖全量/时间范围)
            commands::ai::audit::record::tool_failure_stats,
@@ -316,7 +316,7 @@ impl AppState {
        // 启动恢复:重启前卡 pending 的工具审批(内存 pending_approvals 已丢)从审计表重建,
        // 使重启后待审批不丢。前端经 ai_pending_tool_calls + switchConversation 恢复 toolCard 态。
        crate::commands::ai::restore_pending_approvals(&state).await;
-        // F-260614-04c: 启动一次性初始化 per-provider caps 表。
+        // c: 启动一次性初始化 per-provider caps 表。
        // 根据 DB enabled providers 建 HashMap<provider_id, global_cap>,让 agentic loop 的
        // try_acquire_for_provider 从 NotConfigured(无限流)切换到 Acquired/Exhausted(按配置限流)。
        // disabled / weight=0 的 provider 不入表(其被 provider_pool::select 过滤出候选,不会被 acquire)。
@@ -352,10 +352,10 @@ impl AppState {
        Ok(state)
    }

-    /// F-260614-04c: 从 DB enabled providers 重建 per_provider caps 并 set_provider_caps。
+    /// c: 从 DB enabled providers 重建 per_provider caps 并 set_provider_caps。
    ///
    /// 启动 + provider 变更(ai_update_provider_pool / 删除 / 新增)后调用。caps 策略见
-    /// AppState::init 注释(本轮每 provider cap = global_cap,F-04d 配差异化上限时仅改此)。
+    /// AppState::init 注释(本轮每 provider cap = global_cap,d 配差异化上限时仅改此)。
    pub async fn reload_provider_caps(&self) {
        let providers = match self.ai_providers.list_all().await {
            Ok(ps) => ps,
@@ -425,7 +425,7 @@ impl AppState {
    /// 每条路径尝试 canonicalize 规范化(防大小写/分隔符差异绕过);canonicalize 失败
    /// (目录不存在)回退原字面量 trim(写入后再校验场景:先授权目录路径,目录暂不存在)。
    pub async fn reload_allowed_dirs(&self) {
-        // F-260619-03: 白名单 = Settings KV allowed_dirs(用户配)+ projects.bind_directory(项目绑定目录自动授权)。
+        // 白名单 = Settings KV allowed_dirs(用户配)+ projects.bind_directory(项目绑定目录自动授权)。
        // 项目绑定目录 = AI 天然可访问(用户已主动绑定),不应重复弹窗。reload 时自动合并入 persistent。
        let kv_dirs: Vec<String> = match self.settings.get(AllowedDirs::SETTINGS_KEY).await {
            Ok(Some(v)) => serde_json::from_str(&v).unwrap_or_default(),
@@ -592,7 +592,7 @@ impl AppState {
 /// 这里注册 df-nodes 提供的真实 HumanNode / AiNode。
 ///
 /// "script" 节点不注册：ScriptNode 走 cmd /C | sh -c 执行 config.command 原始串，
-/// 前端可构造任意 DagDef 触达无审批 shell（R-PD-2）。DevFlow 工作流当前为纯演示
+/// 前端可构造任意 DagDef 触达无审批 shell。DevFlow 工作流当前为纯演示
 /// 功能（前端唯一构造点 ProjectDetail.vue demoDag 三步 echo），无真实构建/部署脚本
 /// 需求。需要脚本执行能力时新建独立 BuildNode（白名单 + 项目目录锚定 + 复用 AI 工具
 /// RiskLevel 审批链），而非回头启用 ScriptNode + 黑名单。
@@ -621,7 +621,7 @@ fn build_registry(db: Arc<Database>) -> NodeRegistry {
    //   推进链阶段 2 工作流联动入口 — DAG 内触发 advance_task。
    //   持有 Arc<Database> 在此构造时注入(NodeRegistry::register 工厂闭包 move 捕获 db,
    //   Arc clone 廉价),Node::execute 从 NodeContext.config 读 task_id/target_status。
-    //   D-260616-03: 推进链/状态机/闸门走 df-nodes Node trait,非复活 df-task。
+    //   推进链/状态机/闸门走 df-nodes Node trait,非复活 df-task。
    registry.register("task_advance", move |_config| {
        Box::new(df_nodes::task_advance_node::TaskAdvanceNode::new(db.clone()))
    });
@@ -662,11 +662,11 @@ mod tests {
    use super::*;

    // ============================================================
-    // F-260620: strip_verbatim 比对侧收口 + 黑名单增强测试
+    // strip_verbatim 比对侧收口 + 黑名单增强测试
    // 三方审查(安全/UX/跨端)交叉印证:strip_verbatim 仅写入侧调用,比对侧遗漏致误弹窗。
    // ============================================================

-    /// F-260620: strip_verbatim 三前缀(\\?\ / \\.\ / \??\)统一去除
+    /// strip_verbatim 三前缀(\\?\ / \\.\ / \??\)统一去除
    #[test]
    fn test_strip_verbatim_three_prefixes() {
        assert_eq!(strip_verbatim(PathBuf::from(r"\\?\E:\foo")), PathBuf::from("E:\\foo"));
@@ -168,7 +168,7 @@ pub fn check_path_authorization(
    // Phase C: 黑名单优先独立判定(is_authorized 内也判,此处先判便于 NeedsAuthorization
    // 不误把黑名单路径推到弹窗 — 黑名单路径直接硬拒不让用户"授权")。
    //
-    // BUG-2026-07-07: 黑名单检查必须在路径规范化(is_absolute / root.join)之前对**原始路径**
+    // 黑名单检查必须在路径规范化(is_absolute / root.join)之前对**原始路径**
    // 也判一次。原因:Windows 上 "/home/user/.ssh/config" 这类 Unix 风格路径 is_absolute() 返 false
    // (Windows 绝对路径需盘符或 UNC),会被当相对路径走 first_persistent_dir 分支;若 persistent 为空,
    // 旧逻辑直接 return NeedsAuthorization,**跳过黑名单检查** → .ssh/.aws 等敏感路径在 Windows 上绕过黑名单。
@@ -443,7 +443,7 @@ mod tests {
        }
    }

-    /// BUG-2026-07-07: Windows 上 Unix 风格 .ssh 路径必须被黑名单拒(不能绕过)。
+    /// Windows 上 Unix 风格 .ssh 路径必须被黑名单拒(不能绕过)。
    ///
    /// 背景:Windows 上 `/home/user/.ssh/config` 的 is_absolute() 返 false(无盘符),
    /// 旧逻辑在 persistent 为空时直接返 NeedsAuthorization,**跳过黑名单检查**,
@@ -476,11 +476,11 @@ mod tests {


    // ============================================================
-    // F-260620: strip_verbatim 比对侧收口 + 黑名单增强测试
+    // strip_verbatim 比对侧收口 + 黑名单增强测试
    // 三方审查(安全/UX/跨端)交叉印证:strip_verbatim 仅写入侧调用,比对侧遗漏致误弹窗。
    // ============================================================

-    /// F-260620: is_authorized 比对侧 strip_verbatim — candidate 带 \\?\ 前缀也命中白名单
+    /// is_authorized 比对侧 strip_verbatim — candidate 带 \\?\ 前缀也命中白名单
    /// (handler canonicalize 后路径 vs persistent 词法路径,形态不一致曾致误弹窗)。
    /// persistent 用动态 workspace_root_path(非硬编码开发机路径),candidate 拼 verbatim 前缀。
    #[test]
@@ -497,7 +497,7 @@ mod tests {
        assert!(allowed.is_authorized(&dev), "设备命名空间前缀路径应命中白名单");
    }

-    /// F-260620: strip_verbatim 三前缀(\\?\ / \\.\ / \??\)统一去除
+    /// strip_verbatim 三前缀(\\?\ / \\.\ / \??\)统一去除
    #[test]
    fn test_strip_verbatim_three_prefixes() {
        assert_eq!(strip_verbatim(PathBuf::from(r"\\?\E:\foo")), PathBuf::from("E:\\foo"));
@@ -507,7 +507,7 @@ mod tests {
        assert_eq!(strip_verbatim(PathBuf::from("E:\\foo")), PathBuf::from("E:\\foo"));
    }

-    /// F-260620: 黑名单增强 — Windows 根本身 / ProgramData / 用户凭据目录(.ssh/.aws/.gnupg)
+    /// 黑名单增强 — Windows 根本身 / ProgramData / 用户凭据目录(.ssh/.aws/.gnupg)
    #[test]
    fn test_blacklist_windows_root_programdata_creds() {
        // C:\Windows 根本身(不再限定 system32 子目录 — 防 win.ini/hosts 等)
@@ -32,7 +32,7 @@ use tokio::sync::{Mutex, Semaphore};
 /// 新请求 lock 后克隆到最新 Arc、自动走新限制。旧 Semaphore 随最后 permit 释放而 drop。
 /// per_conv HashMap 内每条 Arc<Semaphore> 不需运行时改 permits（对话内并发上限 2 固定），故无重建需求。
 ///
-/// ## F-260614-04: per-provider 层(可选)
+/// ## per-provider 层(可选)
 /// `per_provider` 为 HashMap<provider_id, Arc<Semaphore>>。调用方(agentic loop)经
 /// `try_acquire_for_provider(pid)` 取额外 permit,防单 provider 被打满(限流 429)。
 /// **单 provider 场景**:若未调 `set_provider_caps`,HashMap 为空,
@@ -75,7 +75,7 @@ pub struct LlmConcurrency {
    /// 热改后**已建对话**的旧 Semaphore 不变(permits 构造时固定)，**新建对话**用新值；
    /// 为使热改立即全量生效，set_per_conv 同时清空 HashMap 强制重建(软收敛：旧 permit 随 Drop 释放)。
    per_conv_permits: Arc<AtomicUsize>,
-    /// F-260614-04: per-provider 信号量表。空 = 无 per-provider 限流(单 provider 路径零变化)。
+    /// per-provider 信号量表。空 = 无 per-provider 限流(单 provider 路径零变化)。
    /// Arc<Mutex<HashMap>>:运行时增删 provider 配置时替换/插入,acquire 时 clone Arc。
    per_provider: Arc<Mutex<HashMap<String, Arc<Semaphore>>>>,
    /// Phase3 预留(批2-B): per-sub_flow 信号量表。key = sub_flow_id(约定 "{conv_id}::{sub_id}")。
@@ -306,7 +306,7 @@ impl LlmConcurrency {
        }
    }

-    /// F-260614-04: 批量设置 per-provider 并发上限(替换整表)。
+    /// 批量设置 per-provider 并发上限(替换整表)。
    ///
    /// 调用方(Settings 配置热改 / 启动初始化)传入 `{ provider_id: permits }` map,
    /// 替换整张 per_provider 表(软收敛:已持 permit 不回收)。全局容量约束 min(sum, global_cap)