fix(ai): 审查即修 FE 批——采纳回写/dock 实时/竞态与设置治理收口（v0.19.4/5）

Author: Aparencia

app/src/components/AiConversationDock.tsx

@@ -2,24 +2,26 @@
  * AiConversationDock — 全局 AI 对话面板（REQ-274 v0.19.4，丙案 v1）。
  *
  * @ai-context: 应用级右侧停靠「AI 任务对话」跟随工作区——按需唤起 + 内容保活
- *              （常驻挂载，open 仅切 display——选中态/已加载列表不销毁，关闭后
- *              任务在后台照跑，完成经 App 既有 ai:task-update toast 通知）。
- * @ai-context: 同源承诺：本面板不建第二套会话——数据全部来自既有命令
- *              （chat_list_sessions/chat_list_messages/ai_task_history/
- *              ai_task_conversation），线程内容在「💬 AI 对话」页天然可见可查；
- *              会话视图 v1 只读 + 「在对话页继续」跳转（规避双实例流控冲突），
- *              任务视图复用 TaskConversationView（含采纳/跳转/工作台深链）。
+ *              （常驻挂载，open 仅切 display——选中态/列表不销毁，后台照跑），
+ *              完成经 App 既有 ai:task-update toast 通知。
+ * @ai-context: 同源承诺：本面板不建第二套会话——数据来自既有命令（chat_list_*
+ *              /ai_task_*），线程内容在「💬 AI 对话」页天然可见可查；会话视图
+ *              v1 只读 + 「在对话页继续」跳转（规避双实例流控冲突），任务视图
+ *              复用 TaskConversationView（含采纳/跳转/工作台深链）。
  * @ai-context: 唤起：导航栏 🤖 按钮 / Ctrl+Shift+A（本地 window 快捷键）；
  *              段切换：💬 对话会话 / 🤖 AI 任务（与 ChatSidebar 口径一致）。
+ * @ai-context: 0.19.4/5 审查即修：F1 采纳回写详情（onTaskChanged 双刷）；F2
+ *              open 期间监听 ai:task-update 实时刷新（关闭零订阅）；F9 懒加载
+ *              （挂载不拉，首次 open 才装载）＋静态数据 10s 时效。
  */
 import { useCallback, useEffect, useRef, useState } from "react";
 import { invoke } from "@tauri-apps/api/core";
-import type { AiTaskRecord, AiTurn, ChatMessage, ChatSession } from "../types";
+import { listen } from "@tauri-apps/api/event";
+import type { AiTaskRecord, AiTaskState, AiTurn, ChatMessage, ChatSession } from "../types";
 import TaskConversationView from "./TaskConversationView";
 import { refLabel } from "../utils/entityLabel";
 
 interface SessionRow { id: number; title: string }
-
 interface Props {
   open: boolean;
   onClose: () => void;
@@ -31,17 +33,26 @@ interface Props {
   onOpenNote: (noteId: number) => void;
   onOpenRefineWorkbench: (sessionId: number, taskId: number) => void;
 }
-
 const PANEL_W = 560;
+/** F9 静态数据时效（ms）：open 翻转时距上次拉取 <10s 则跳过——列表不抖动 */
+const STATIC_TTL_MS = 10_000;
 
 const itemBase: React.CSSProperties = {
   display: "flex", alignItems: "center", gap: 8, width: "100%", boxSizing: "border-box",
   padding: "7px 10px", cursor: "pointer", fontSize: 12.5, textAlign: "left",
   background: "none", border: "none", borderRadius: 8, color: "#374151",
 };
 
-const OP_LABEL: Record<string, string> = { refine: "✨ 精修", enrich: "📚 补充" };
+/** 顶部分段胶囊（active 高亮）——复用一处免重复内联块 */
+const pill = (active: boolean): React.CSSProperties => ({
+  fontSize: 12, cursor: "pointer", padding: "3px 10px", borderRadius: 999,
+  border: active ? "1px solid #4f46e5" : "1px solid #d1d5db",
+  background: active ? "#eef2ff" : "#fff", color: active ? "#3730a3" : "#374151",
+});
 
+/** 详情头部返回/跳转文字钮基样式 */
+const textBtn: React.CSSProperties = { border: "none", background: "none", cursor: "pointer", padding: 0 };
+const OP_LABEL: Record<string, string> = { refine: "✨ 精修", enrich: "📚 补充" };
 export default function AiConversationDock({
   open, onClose, onOpenChat, onOpenTaskInChat, onOpenSessions, onOpenNote, onOpenRefineWorkbench,
 }: Props) {
@@ -55,16 +66,23 @@ export default function AiConversationDock({
   const [activeTaskId, setActiveTaskId] = useState<number | null>(null);
   const [taskDetail, setTaskDetail] = useState<{ task: AiTaskRecord; turns: AiTurn[] } | null>(null);
   const [notice, setNotice] = useState("");
+  // F9：是否已首次 open 装载（此前挂载即拉——审查改懒加载）
   const loadedOnce = useRef(false);
+  const staticAtRef = useRef(0);
+  // F2：activeTaskId 经 ref 镜像——事件监听只注册一次，永远读最新选中任务
+  const activeTaskIdRef = useRef<number | null>(null);
+  activeTaskIdRef.current = activeTaskId;
 
   const reloadTasks = useCallback(async () => {
     const refine = await invoke<AiTaskRecord[]>("ai_task_history", { opType: "refine", limit: 30 }).catch(() => [] as AiTaskRecord[]);
     const enrich = await invoke<AiTaskRecord[]>("ai_task_history", { opType: "enrich", limit: 30 }).catch(() => [] as AiTaskRecord[]);
-    setTasks([...refine, ...enrich].sort((a, b) => b.createdAt - a.createdAt).slice(0, 40));
+    // F4（审查对齐）：展示条数与 ChatPage 一致（40→60——同源同口径）
+    setTasks([...refine, ...enrich].sort((a, b) => b.createdAt - a.createdAt).slice(0, 60));
   }, []);
 
-  /** 会话/标题静态数据（与 ChatPage 同源同口径——打开面板时拉一次） */
+  /** 会话/标题静态数据（与 ChatPage 同源同口径——按 F9 时效拉取） */
   const loadStatic = useCallback(async () => {
+    staticAtRef.current = Date.now();
     const [sess, rows, notes] = await Promise.all([
       invoke<ChatSession[]>("chat_list_sessions").catch(() => [] as ChatSession[]),
       invoke<SessionRow[]>("list_sessions", { limit: 500 }).catch(() => [] as SessionRow[]),
@@ -75,21 +93,6 @@ export default function AiConversationDock({
     setNoteTitles(new Map(notes.map((n) => [n.id, n.title])));
   }, []);
 
-  useEffect(() => {
-    if (loadedOnce.current) return;
-    loadedOnce.current = true;
-    void loadStatic();
-    void reloadTasks();
-  }, [loadStatic, reloadTasks]);
-
-  // open 变 true：刷新静态/任务（外部变化及时可见——防抖由调用频率天然承担）
-  useEffect(() => {
-    if (open) {
-      void loadStatic();
-      void reloadTasks();
-    }
-  }, [open, loadStatic, reloadTasks]);
-
   const selectTask = useCallback(async (taskId: number) => {
     setActiveTaskId(taskId);
     setActiveChatId(null);
@@ -117,6 +120,37 @@ export default function AiConversationDock({
       : refLabel("note", noteTitles.get(t.refId)),
   [sessionTitles, noteTitles]);
 
+  // F9：懒加载 + open 翻转刷新——首次 open 装载；之后静态数据 10s 时效跳过，
+  // 任务列表每次 open 仍刷（状态多变不设时效）
+  useEffect(() => {
+    if (!open) return;
+    if (!loadedOnce.current) {
+      loadedOnce.current = true;
+      void loadStatic();
+    } else if (Date.now() - staticAtRef.current >= STATIC_TTL_MS) {
+      void loadStatic();
+    }
+    void reloadTasks();
+  }, [open, loadStatic, reloadTasks]);
+
+  // F2：dock 打开期间订阅任务更新事件——列表/当前详情即时跟进（关面板即
+  // 解绑零订阅；disposed 处理 listen 异步注册竞态，同 App.tsx 全局监听模式；
+  // activeTaskId 经 ref 镜像读取——选中切换不触发重订阅）
+  useEffect(() => {
+    if (!open) return;
+    let disposed = false;
+    let unlisten: (() => void) | undefined;
+    void listen<[number, AiTaskState]>("ai:task-update", () => {
+      if (disposed) return;
+      void reloadTasks();
+      const tid = activeTaskIdRef.current;
+      if (tid != null) void selectTask(tid);
+    }).then((u) => {
+      if (disposed) u(); else unlisten = u;
+    });
+    return () => { disposed = true; unlisten?.(); };
+  }, [open, reloadTasks, selectTask]);
+
   /** 列表段（每行数据复用 ChatSidebar 的形态——标题/模型/状态/时间） */
   const renderList = () => {
     if (tab === "task") {
@@ -194,30 +228,10 @@ export default function AiConversationDock({
       borderBottom: "1px solid #e5e7eb", background: "#fff", flexShrink: 0,
     }}>
       <span style={{ fontWeight: 700, fontSize: 13.5 }}>🤖 AI 任务对话</span>
-      <button
-        data-testid="dock-tab-task"
-        onClick={() => setTab("task")}
-        style={{
-          marginLeft: 8, fontSize: 12, cursor: "pointer", padding: "3px 10px", borderRadius: 999,
-          border: tab === "task" ? "1px solid #4f46e5" : "1px solid #d1d5db",
-          background: tab === "task" ? "#eef2ff" : "#fff", color: tab === "task" ? "#3730a3" : "#374151",
-        }}
-      >🤖 AI 任务</button>
-      <button
-        data-testid="dock-tab-chat"
-        onClick={() => setTab("chat")}
-        style={{
-          fontSize: 12, cursor: "pointer", padding: "3px 10px", borderRadius: 999,
-          border: tab === "chat" ? "1px solid #4f46e5" : "1px solid #d1d5db",
-          background: tab === "chat" ? "#eef2ff" : "#fff", color: tab === "chat" ? "#3730a3" : "#374151",
-        }}
-      >💬 对话</button>
+      <button data-testid="dock-tab-task" onClick={() => setTab("task")} style={{ ...pill(tab === "task"), marginLeft: 8 }}>🤖 AI 任务</button>
+      <button data-testid="dock-tab-chat" onClick={() => setTab("chat")} style={pill(tab === "chat")}>💬 对话</button>
       <span style={{ flex: 1 }} />
-      <button
-        data-testid="dock-close"
-        onClick={onClose}
-        style={{ border: "none", background: "transparent", cursor: "pointer", fontSize: 14, color: "#6b7280" }}
-      >✕</button>
+      <button data-testid="dock-close" onClick={onClose} style={{ ...textBtn, fontSize: 14, color: "#6b7280" }}>✕</button>
     </div>
   );
 
@@ -243,13 +257,13 @@ export default function AiConversationDock({
             <div style={{ flexShrink: 0, display: "flex", gap: 6, padding: "4px 10px", borderBottom: "1px solid #f3f4f6", fontSize: 11 }}>
               <button
                 onClick={() => { setActiveTaskId(null); setTaskDetail(null); }}
-                style={{ border: "none", background: "none", cursor: "pointer", color: "#0f766e", padding: 0 }}
+                style={{ ...textBtn, color: "#0f766e" }}
               >← 任务列表</button>
               <span style={{ flex: 1 }} />
               <button
                 title="在 AI 对话页打开同源任务（可查轨迹/追问）"
                 onClick={() => onOpenTaskInChat(taskDetail.task.taskId)}
-                style={{ border: "none", background: "none", cursor: "pointer", color: "#0d9488", padding: 0 }}
+                style={{ ...textBtn, color: "#0d9488" }}
               >💬 在对话页打开 →</button>
             </div>
             <div style={{ flex: 1, minHeight: 0, display: "flex", flexDirection: "column" }}>
@@ -266,7 +280,9 @@ export default function AiConversationDock({
                 busy={false}
                 // 笔记级任务 → 查看笔记；会话级 → 工作台深链（同 ChatPage 口径）
                 onOpenWorkbench={(t) => (t.targetKind === "note" ? onOpenNote(t.refId) : onOpenRefineWorkbench(t.refId, t.taskId))}
-                onTaskChanged={() => void reloadTasks()}
+                // F1：采纳成功 → 列表 + 当前详情双刷新（详情 adopted=true 才
+                // 让「✅ 采纳到笔记」消失/「已采纳」徽标出现）
+                onTaskChanged={() => { void reloadTasks(); if (activeTaskId != null) void selectTask(activeTaskId); }}
               />
             </div>
           </>
@@ -276,13 +292,13 @@ export default function AiConversationDock({
             <div style={{ flexShrink: 0, display: "flex", gap: 6, padding: "4px 10px", borderBottom: "1px solid #f3f4f6", fontSize: 11 }}>
               <button
                 onClick={() => { setActiveChatId(null); setMessages([]); }}
-                style={{ border: "none", background: "none", cursor: "pointer", color: "#0f766e", padding: 0 }}
+                style={{ ...textBtn, color: "#0f766e" }}
               >← 会话列表</button>
               <span style={{ flex: 1 }} />
               <button
                 title="到 AI 对话页继续对话（本面板会话视图 v1 只读）"
                 onClick={() => onOpenChat(activeChatId)}
-                style={{ border: "none", background: "none", cursor: "pointer", color: "#0d9488", padding: 0 }}
+                style={{ ...textBtn, color: "#0d9488" }}
               >💬 在对话页继续 →</button>
             </div>
             <div style={{ flex: 1, minHeight: 0, overflowY: "auto", padding: 12 }}>{renderChatDetail()}</div>

app/src/components/AiTaskPanel.tsx

@@ -13,6 +13,8 @@
 import { useCallback, useEffect, useState } from "react";
 import { invoke } from "@tauri-apps/api/core";
 import type { AiEnrichResult, AiRefineResult, AiTaskRecord } from "../types";
+// 低5（审查）：类别词经 entityLabel.kindWord 单一来源（不带 id 的语义词）
+import { kindWord } from "../utils/entityLabel";
 
 const btn: React.CSSProperties = { padding: "3px 8px", fontSize: 11, borderRadius: 5, border: "1px solid #d1d5db", background: "#fff", cursor: "pointer" };
 
@@ -149,7 +151,7 @@ export default function AiTaskPanel() {
                   {badge.text}
                 </span>
                 <span style={{ color: "#374151", flex: 1, overflow: "hidden", textOverflow: "ellipsis", whiteSpace: "nowrap" }}>
-                  {t.opType === "refine" ? "会话" : "笔记"}
+                  {kindWord(t.opType === "refine" ? "session" : "note")}
                   {t.model && <span style={{ color: "#9ca3af" }}> · {t.model}</span>}
                 </span>
                 <span style={{ color: "#9ca3af", width: 52, textAlign: "right" }}>{fmtMs(t.elapsedMs)}</span>

app/src/components/ChatSaveNoteDialog.test.tsx

@@ -45,7 +45,9 @@ describe("ChatSaveNoteDialog", () => {
         new: { title: "梯度下降", content, source: "manual" },
       });
     });
-    expect(screen.getByTestId("chat-note-saved").textContent).toContain("#99");
+    // 信息9（审查）：成功态去裸 `#id`——改标题语义回显（REQ-277 全站口径）
+    expect(screen.getByTestId("chat-note-saved").textContent).toContain("已保存为笔记《梯度下降》");
+    expect(screen.getByTestId("chat-note-saved").textContent).not.toContain("#");
   });
 
   it("选目标组 → group_id 直入 NewNote", async () => {

app/src/components/ChatSaveNoteDialog.tsx

@@ -85,7 +85,9 @@ export default function ChatSaveNoteDialog({ initialTitle, content, groups, onOp
         {savedId != null ? (
           <>
             <div data-testid="chat-note-saved" style={{ color: "#047857", marginBottom: 10 }}>
-              ✓ 已保存为笔记 #{savedId}（{title}）
+              {/* 信息9（审查裸号）：去 `#id`——成功态以标题语义回显（REQ-277）；
+                  title 恒非空（保存前置校验 + 默认值）——空时仅兜底不带书名号 */}
+              ✓ 已保存为笔记{title.trim() ? `《${title.trim()}》` : ""}
             </div>
             <div style={{ display: "flex", gap: 8 }}>
               <button