feat(notes): REQ-316 空组清理 toast 留痕与调用方接线

- types/notes.ts 同步五命令结果契约（autoCleanedGroups 组标题数组；
  空数组=零变化）；NotesPage 单删/批量删消费并自绘 toast（批量逐条
  触发、聚合去重单次留痕）
- 新 hooks/useTransientToast.tsx（自绘 toast 复用件——批 4 会话页模式）
  + utils/groupClean.ts autoCleanNotice 纯函数（文案拼接单点，配 4 例
  单测）；NoteListView/NoteMoveToGroupMenu/NoteRowContextMenu/
  GroupSidebar/RouteInfoPopover/FeedFragmentList 经可选 onCleanNotice
  上抛统一 toast（无清理零变化）
- 全量 vitest 672/672、tsc 0 错误

Author: Aparencia

app/src/components/FeedFragmentList.test.tsx

@@ -50,12 +50,12 @@ beforeEach(() => {
         return [containerGroup];
       case "promote_fragment_to_note":
         dbFragments = dbFragments.filter((f) => f.id !== args.fragmentId);
-        return noteStub;
+        return { note: noteStub, autoCleanedGroups: [] };
       case "promote_fragment_to_card":
         return 1;
       case "delete_fragment":
         dbFragments = dbFragments.filter((f) => f.id !== args.fragmentId);
-        return true;
+        return { deleted: true, autoCleanedGroups: [] };
       case "resolve_fragment_image":
         return null;
       default:

app/src/components/FeedFragmentList.tsx

@@ -13,6 +13,8 @@
 import { useCallback, useEffect, useState } from "react";
 import { invoke, convertFileSrc } from "@tauri-apps/api/core";
 import type { Fragment, Note, NoteGroup } from "../types";
+// REQ-316（批 7）：碎片删除/升笔记返回契约（源空组清理留痕数据源）
+import type { DeleteFragmentResult, PromoteNoteResult } from "../types/notes";
 import { fragmentPreview, promoteTitleFor } from "../utils/inbox";
 
 interface Props {
@@ -22,6 +24,8 @@ interface Props {
   onChanged: () => void;
   /** 升笔记成功——父层打开新笔记（右侧自动打开，闭环可见） */
   onPromoted: (note: Note) => void;
+  /** REQ-316（批 7）：碎片操作触发源空组自动清理 → 上抛组标题（父层 toast 留痕） */
+  onCleanNotice?: (groupNames: string[]) => void;
   /** v0.15：折叠为窄条（父层 useColumnLayout.setManualFolded(true)） */
   onCollapse?: () => void;
 }
@@ -67,7 +71,7 @@ interface PromoteForm {
   groupId: string;
 }
 
-export default function FeedFragmentList({ width = 320, onChanged, onPromoted, onCollapse }: Props) {
+export default function FeedFragmentList({ width = 320, onChanged, onPromoted, onCleanNotice, onCollapse }: Props) {
   const [fragments, setFragments] = useState<Fragment[]>([]);
   const [loaded, setLoaded] = useState(false);
   const [err, setErr] = useState("");
@@ -116,16 +120,18 @@ export default function FeedFragmentList({ width = 320, onChanged, onPromoted, o
     if (!promote) return;
     setBusy(true);
     try {
-      const note = await invoke<Note>("promote_fragment_to_note", {
+      const r = await invoke<PromoteNoteResult>("promote_fragment_to_note", {
         fragmentId: promote.fragmentId,
         title: promote.title,
         groupId: promote.groupId === "" ? null : Number(promote.groupId),
       });
       setPromote(null);
       setErr("");
+      // REQ-316（批 7）：碎片源组因升笔记变空 → 自动清理留痕（结果空=零变化）
+      if (r.autoCleanedGroups.length > 0) onCleanNotice?.([...new Set(r.autoCleanedGroups)]);
       await load();
       onChanged();
-      onPromoted(note);
+      onPromoted(r.note);
     } catch (e) {
       setErr(`升笔记失败: ${e}`);
     } finally {
@@ -157,7 +163,9 @@ export default function FeedFragmentList({ width = 320, onChanged, onPromoted, o
     if (!window.confirm(`删除这条碎片？\n「${f.text.slice(0, 30)}…」\n（绑定的闪卡会保留）`)) return;
     setBusy(true);
     try {
-      await invoke<boolean>("delete_fragment", { fragmentId: f.id });
+      const r = await invoke<DeleteFragmentResult>("delete_fragment", { fragmentId: f.id });
+      // REQ-316（批 7）：碎片源组因删除变空 → 自动清理留痕（结果空=零变化）
+      if (r.autoCleanedGroups.length > 0) onCleanNotice?.([...new Set(r.autoCleanedGroups)]);
       await load();
       onChanged();
     } catch (e) {

app/src/components/GroupSidebar.test.tsx

@@ -47,7 +47,7 @@ beforeEach(() => {
           ? [{ id: 1, systemId: 10, nodeId: null, conceptId: null, modelId: null, targetType: "note_group", targetId: 1, createdAt: 0 }]
           : [];
       case "override_group_route": return true;
-      case "move_note_to_group": return true;
+      case "move_note_to_group": return { moved: true, autoCleanedGroups: [] };
       // 审查修复：ⓘ 弹层静默降级依赖的 mock 补齐（简报拉取 list_group_cards——原缺省
       // throw 依赖"简报静默降级"容错，测试通过≠mock 完备）
       case "list_group_cards": return [];

app/src/components/GroupSidebar.tsx

@@ -17,6 +17,8 @@ import { useCallback, useEffect, useMemo, useState } from "react";
 import { invoke } from "@tauri-apps/api/core";
 import type { Fragment, NoteGroup } from "../types";
 import type { KnowledgeLink, KnowledgeSystem } from "../types/knowledge";
+// REQ-316（批 7）：移组返回契约（源空组清理留痕数据源）
+import type { MoveNoteResult } from "../types/notes";
 import {
   GROUP_SECTIONS,
   filterGroups,
@@ -59,13 +61,15 @@ interface Props {
   refreshToken: number;
   /** 跳转体系页并选中体系（v0.13.7 触点①） */
   onOpenSystem: (systemId: number) => void;
+  /** REQ-316（批 7）：移组触发源空组自动清理 → 上抛组标题（父层 toast 留痕） */
+  onCleanNotice?: (groupNames: string[]) => void;
   /** v0.15：折叠为窄条（父层 useColumnLayout.setManualFolded(true)） */
   onCollapse?: () => void;
 }
 
 export default function GroupSidebar({
   width = 240, groupFilter, onGroupFilterChange, onChanged, onOpenReview, selectedNoteId,
-  onOpenInbox, inboxActive, refreshToken, onOpenSystem, onCollapse,
+  onOpenInbox, inboxActive, refreshToken, onOpenSystem, onCleanNotice, onCollapse,
 }: Props) {
   const [groups, setGroups] = useState<NoteGroup[]>([]);
   const [feedCaptureOn, setFeedCaptureOn] = useState(true);
@@ -234,14 +238,19 @@ export default function GroupSidebar({
     if (ids.length === 0) return;
     void (async () => {
       let failed = 0;
+      const cleanedNames: string[] = [];
       for (const noteId of ids) {
         try {
-          await invoke("move_note_to_group", { noteId, groupId: g.id });
+          // REQ-316（批 7）：移组结果含自动清理列表（源组空 → 后端已删）
+          const r = await invoke<MoveNoteResult>("move_note_to_group", { noteId, groupId: g.id });
+          cleanedNames.push(...r.autoCleanedGroups);
         } catch {
           failed += 1;
         }
       }
       if (failed > 0) setStatus(`归组失败 ${failed}/${ids.length} 条`);
+      // 清理留痕（无清理零变化；父层 toast）
+      if (cleanedNames.length > 0) onCleanNotice?.([...new Set(cleanedNames)]);
       onChanged();
     })();
   };
@@ -473,6 +482,7 @@ export default function GroupSidebar({
           // 复习深链：关弹层后交 NotesPage→App 转复习页组预选（v0.20.10 批 5）
           onOpenReview={(gid, name) => { setPopover(null); onOpenReview(gid, name); }}
           selectedNoteId={selectedNoteId}
+          onCleanNotice={onCleanNotice}
         />
       )}
 

app/src/components/NoteHeaderActions.tsx

@@ -27,6 +27,8 @@ interface Props {
   onChanged: () => void;
   /** 错误上抛（父层 status 区展示） */
   onError: (msg: string) => void;
+  /** REQ-316（批 7）：移组触发源空组自动清理 → 上抛组标题（父层 toast 留痕） */
+  onCleanNotice?: (groupNames: string[]) => void;
   /** 跳体系页并打开建体系向导（TD-2026-09-05-A 空体系引导） */
   onGotoKnowledgeSystem?: () => void;
   /** 打开编辑态 AI 能力对话框（阅读态点击直接进入编辑态） */
@@ -36,7 +38,7 @@ interface Props {
 }
 
 export default function NoteHeaderActions({
-  note, resolvedColor, groups, onChanged, onError, onGotoKnowledgeSystem, onOpenAi, onOpenModelCard,
+  note, resolvedColor, groups, onChanged, onError, onCleanNotice, onGotoKnowledgeSystem, onOpenAi, onOpenModelCard,
 }: Props) {
   const [colorPickerOpen, setColorPickerOpen] = useState(false);
   // v0.14 B：当前主题（跟随 prefers-color-scheme；jsdom 无 matchMedia 回退 light）
@@ -81,6 +83,7 @@ export default function NoteHeaderActions({
         note={note}
         groups={groups}
         onChanged={onChanged}
+        onCleanNotice={onCleanNotice}
       />
       {/* v0.13.7 触点②：标题栏「挂到体系」入口；key=note.id 切笔记重置内部态 */}
       <NoteLinkToSystem

app/src/components/NoteListView.test.tsx

@@ -44,7 +44,7 @@ beforeEach(() => {
       case "note_group_order_list": return []; // REQ-315：组序行（树组头排序）
       case "note_order_save": return null;
       case "note_order_clear": return true;
-      case "move_note_to_group": return true;
+      case "move_note_to_group": return { moved: true, autoCleanedGroups: [] };
       default: return null;
     }
   });

app/src/components/NoteListView.tsx

@@ -16,6 +16,8 @@
 import { useCallback, useEffect, useMemo, useRef, useState } from "react";
 import { invoke } from "@tauri-apps/api/core";
 import type { Note, NoteGroup } from "../types";
+// REQ-316（批 7）：移组返回契约（空组自动清理留痕数据源）
+import type { MoveNoteResult } from "../types/notes";
 import { paletteHex } from "../utils/colorPalette";
 import type { ThemeMode } from "../utils/colorPalette";
 import { emptySelection, rangeSelection, toggleSelection } from "../utils/noteSelection";
@@ -61,6 +63,8 @@ interface Props {
   onNoteEdit?: (note: Note) => void;
   onNoteDelete?: (note: Note) => void;
   onNoteMoved?: () => void;
+  /** REQ-316（批 7）：移组触发空组自动清理 → 上抛组标题（父层 toast 留痕） */
+  onCleanNotice?: (groupNames: string[]) => void;
   onCollapse?: () => void;
 }
 
@@ -85,7 +89,7 @@ export default function NoteListView({
   keyword, tagFilter, sortMode, allTags, selectedId, status,
   noteColors, tagColors,
   onKeywordChange, onTagFilterChange, onSortModeChange, onSelect, onCreate, onRefresh, onOpenSession, onBatchDelete,
-  onNotePinToggle, onNoteEdit, onNoteDelete, onNoteMoved, onCollapse,
+  onNotePinToggle, onNoteEdit, onNoteDelete, onNoteMoved, onCleanNotice, onCollapse,
 }: Props) {
   const theme: ThemeMode = useMemo(
     () => (typeof window !== "undefined" && window.matchMedia?.("(prefers-color-scheme: dark)").matches ? "dark" : "light"),
@@ -305,9 +309,11 @@ export default function NoteListView({
       const groupNotes = new Set(
         notes.filter((n) => (groupId == null ? n.group_id == null : n.group_id === groupId)).map((n) => n.id),
       );
+      const cleanedNames: string[] = [];
       for (const id of ids) {
         if (groupNotes.has(id)) continue;
-        await invoke("move_note_to_group", { noteId: id, groupId });
+        const r = await invoke<MoveNoteResult>("move_note_to_group", { noteId: id, groupId });
+        cleanedNames.push(...r.autoCleanedGroups);
       }
       // 目标手排：新入组未置顶笔记追加末尾（跨组 drop 的"加入该组"语义；
       // 置顶成员由置顶区表达，不写手排行；重写快照顺带清存量置顶残行）
@@ -318,13 +324,15 @@ export default function NoteListView({
         await saveOrder(scope, [...cur, ...ids.filter((id) => !groupNotes.has(id) && !pinned.has(id))]);
       }
       onNoteMoved?.();
+      // REQ-316（批 7）：批量移走后源空组清理留痕（跨条聚合去重）
+      if (cleanedNames.length > 0) onCleanNotice?.([...new Set(cleanedNames)]);
       setBatchMenu(null);
     } catch (e) {
       console.warn("[notes] 归组失败:", e);
     } finally {
       setBusyMove(false);
     }
-  }, [notes, manualOrders, saveOrder, onNoteMoved]);
+  }, [notes, manualOrders, saveOrder, onNoteMoved, onCleanNotice]);
 
   /**
    * REQ-315：右键「上移/下移」组内显式移动——补"必须拖一次才触发手排快照"的
@@ -367,9 +375,13 @@ export default function NoteListView({
         const n = notes.find((x) => x.id === id);
         return n && (n.group_id ?? null) !== targetGroup;
       });
+      const cleanedNames: string[] = [];
       for (const id of external) {
-        await invoke("move_note_to_group", { noteId: id, groupId: target.group_id });
+        const r = await invoke<MoveNoteResult>("move_note_to_group", { noteId: id, groupId: target.group_id });
+        cleanedNames.push(...r.autoCleanedGroups);
       }
+      // REQ-316（批 7）：跨组拖走使源组变空 → 清理留痕（零清理零变化）
+      if (cleanedNames.length > 0) onCleanNotice?.([...new Set(cleanedNames)]);
       // 落位（REQ-315：只写置顶区外子序列；落点在置顶行上 = 置顶区下沿即手动区首位）
       const pinned = new Set(notes.filter((n) => n.pin === 1).map((n) => n.id));
       const moved = ids.filter((id) => !pinned.has(id));
@@ -402,7 +414,7 @@ export default function NoteListView({
     } finally {
       dropBusyRef.current = false;
     }
-  }, [treeMode, notes, manualOrders, manualBaseOf, saveOrder, onNoteMoved]);
+  }, [treeMode, notes, manualOrders, manualBaseOf, saveOrder, onNoteMoved, onCleanNotice]);
 
   /** 划选（组头空白起 → 组内首行至当前行带；走既有行命中的全局可见序）。
    *  L9 审查修正：rAF 节流 + pointercancel/blur/松开（buttons=0）即清理——
@@ -597,6 +609,7 @@ export default function NoteListView({
           onEdit={onNoteEdit}
           onDelete={onNoteDelete}
           onMoved={onNoteMoved}
+          onCleanNotice={onCleanNotice}
           // REQ-315：树视图才显 上移/下移（平铺态禁移动——orderActions 为 null）
           onMoveWithinScope={orderActions?.move}
           canMoveUp={orderActions?.canMoveUp ?? false}

app/src/components/NoteMoveToGroupMenu.test.tsx

@@ -24,7 +24,7 @@ const noteBase: Note = {
   id: 42, title: "笔记", content: "x", source: "manual", tags: "[]", pin: 0, created_at: 0, updated_at: 0,
 };
 
-beforeEach(() => { invokeMock.mockReset(); invokeMock.mockResolvedValue(true); });
+beforeEach(() => { invokeMock.mockReset(); invokeMock.mockResolvedValue({ moved: true, autoCleanedGroups: [] }); });
 afterEach(() => cleanup());
 
 describe("NoteMoveToGroupMenu 手动分组", () => {
@@ -54,6 +54,42 @@ describe("NoteMoveToGroupMenu 手动分组", () => {
     });
   });
 
+  it("REQ-316：移出最后笔记 → 结果含 autoCleanedGroups 上抛 onCleanNotice（留痕）", async () => {
+    // Arrange：移出组命令返回清理列表（源组已自动删除）
+    const onCleanNotice = vi.fn();
+    invokeMock.mockResolvedValueOnce({ moved: true, autoCleanedGroups: ["乐理"] });
+    render(
+      <NoteMoveToGroupMenu
+        note={{ ...noteBase, group_id: 2 }}
+        groups={groups}
+        onChanged={vi.fn()}
+        onCleanNotice={onCleanNotice}
+      />,
+    );
+    // Act：移出分组
+    fireEvent.click(screen.getByTestId("move-to-group-open"));
+    fireEvent.click(screen.getByTestId("move-to-group-none"));
+    // Assert：清理组标题上抛（父层 toast「已自动清理空组：乐理」）
+    await waitFor(() => expect(onCleanNotice).toHaveBeenCalledWith(["乐理"]));
+  });
+
+  it("REQ-316：结果无清理（空数组）→ 不上抛（零变化）", async () => {
+    const onCleanNotice = vi.fn();
+    invokeMock.mockResolvedValueOnce({ moved: true, autoCleanedGroups: [] });
+    render(
+      <NoteMoveToGroupMenu
+        note={{ ...noteBase, group_id: 2 }}
+        groups={groups}
+        onChanged={vi.fn()}
+        onCleanNotice={onCleanNotice}
+      />,
+    );
+    fireEvent.click(screen.getByTestId("move-to-group-open"));
+    fireEvent.click(screen.getByTestId("move-to-group-none"));
+    await waitFor(() => expect(invokeMock).toHaveBeenCalled());
+    expect(onCleanNotice).not.toHaveBeenCalled();
+  });
+
   it("无组：提示先新建组（零命令调用）", () => {
     render(<NoteMoveToGroupMenu note={noteBase} groups={[]} onChanged={vi.fn()} />);
     fireEvent.click(screen.getByTestId("move-to-group-open"));

app/src/components/NoteMoveToGroupMenu.tsx

@@ -11,6 +11,8 @@
 import { useMemo, useState } from "react";
 import { invoke } from "@tauri-apps/api/core";
 import type { Note, NoteGroup } from "../types";
+// REQ-316（批 7）：移组返回契约（源空组清理留痕数据源）
+import type { MoveNoteResult } from "../types/notes";
 import { paletteHex } from "../utils/colorPalette";
 import type { ThemeMode } from "../utils/colorPalette";
 
@@ -19,6 +21,8 @@ interface Props {
   groups: NoteGroup[];
   /** 变更后的刷新回调（父层重载列表 + 重取选中笔记） */
   onChanged: () => void;
+  /** REQ-316（批 7）：移组触发源空组自动清理 → 上抛组标题（父层 toast 留痕） */
+  onCleanNotice?: (groupNames: string[]) => void;
 }
 
 const DROPDOWN_ITEM: React.CSSProperties = {
@@ -58,7 +62,7 @@ function GroupDot({ colorId }: { colorId: string | null | undefined }) {
   );
 }
 
-export default function NoteMoveToGroupMenu({ note, groups, onChanged }: Props) {
+export default function NoteMoveToGroupMenu({ note, groups, onChanged, onCleanNotice }: Props) {
   const [open, setOpen] = useState(false);
   const [busy, setBusy] = useState(false);
   const [status, setStatus] = useState("");
@@ -68,9 +72,11 @@ export default function NoteMoveToGroupMenu({ note, groups, onChanged }: Props)
     if (busy || groupId === currentId) return;
     setBusy(true);
     try {
-      await invoke<boolean>("move_note_to_group", { noteId: note.id, groupId });
+      const r = await invoke<MoveNoteResult>("move_note_to_group", { noteId: note.id, groupId });
       setStatus("");
       setOpen(false);
+      // REQ-316（批 7）：源组因移走变空 → 自动清理留痕（结果空=零变化）
+      if (r.autoCleanedGroups.length > 0) onCleanNotice?.([...new Set(r.autoCleanedGroups)]);
       onChanged();
     } catch (e) {
       setStatus(`移动失败: ${e}`);

app/src/components/NoteRowContextMenu.test.tsx

@@ -39,7 +39,7 @@ function renderMenu(overrides: Partial<Parameters<typeof NoteRowContextMenu>[0]>
 
 beforeEach(() => {
   invokeMock.mockReset();
-  invokeMock.mockResolvedValue(true);
+  invokeMock.mockResolvedValue({ moved: true, autoCleanedGroups: [] });
   writeTextMock.mockReset();
   writeTextMock.mockResolvedValue(undefined);
 });