fix(knowledge): 画布重挂载位置丢失与框选批量移动治理

审查发现（新增代码审查·逻辑性/牵连性）：
- 高：拖拽/批量初始化持久化后 props 陈旧——树↔画布往返重挂载时辐射布局
  重算覆盖已拖走位置（违反 §4.4 位置只由用户决定）。修复：onPositionsSaved
  回传父页 applyCanvasPositions 合并进 nodes props（重挂载即已存位置）+ 回归测试
- 中：elementsSelectable 默认开启——shift 框选 + 多节点拖拽仅主节点保存，
  其余节点视觉位移不持久（下次打开回弹）。修复：elementsSelectable=false +
  selectionKeyCode=null（§九 暂不暴露框选批量移动）
- 低：KnowledgePage.test withSystemMock 画布命令分支死代码（视图已 mock）清理；
  行数豁免登记刷新（KnowledgePage 322 行）

Author: Aparencia

app/src/components/KnowledgeCanvasView.test.tsx

@@ -67,9 +67,11 @@ function renderView(overrides: {
   coreQuestion?: string | null;
   onSelectItem?: (kind: string, id: number) => void;
   onGoBack?: () => void;
+  onPositionsSaved?: (updates: { nodeId: number; x: number; y: number }[]) => void;
 } = {}) {
   const onSelectItem = overrides.onSelectItem ?? vi.fn();
   const onGoBack = overrides.onGoBack ?? vi.fn();
+  const onPositionsSaved = (overrides.onPositionsSaved ?? vi.fn()) as unknown as ReturnType<typeof vi.fn>;
   const utils = render(
     <KnowledgeCanvasView
       systemId={5}
@@ -80,10 +82,11 @@ function renderView(overrides: {
       links={links}
       selectedKey={null}
       onSelectItem={onSelectItem}
+      onPositionsSaved={onPositionsSaved as unknown as (updates: { nodeId: number; x: number; y: number }[]) => void}
       onGoBack={onGoBack}
     />,
   );
-  return { onSelectItem, onGoBack, ...utils };
+  return { onSelectItem, onGoBack, onPositionsSaved, ...utils };
 }
 
 /** 最近一次 ReactFlow 收到的 props */
@@ -123,9 +126,9 @@ function batchCalls() {
 }
 
 describe("KnowledgeCanvasView 画布", () => {
-  it("首次打开（全部未布局）→ 辐射布局批量初始化，位置落入 RF 节点", async () => {
+  it("首次打开（全部未布局）→ 辐射布局批量初始化，位置落入 RF 节点且回传父页合并", async () => {
     // Arrange + Act
-    renderView();
+    const { onPositionsSaved } = renderView();
     // Assert：批量初始化携全量节点（左上角口径——根 (−110,−40)，子 (−110,−260)）
     await waitFor(() => expect(batchCalls()).toHaveLength(1));
     const [, args] = batchCalls()[0];
@@ -136,6 +139,28 @@ describe("KnowledgeCanvasView 画布", () => {
     expect(rounded(positions.find((p) => p.nodeId === 2)!)).toEqual({ x: -110, y: -260 });
     // RF 节点位置与持久化一致（root0 圆心 (0,0) → 左上角 (-110,-40)）
     await waitFor(() => expect(rounded(rfNode("q:1").position)).toEqual({ x: -110, y: -40 }));
+    // 父页合并回调（防重挂载覆盖）
+    await waitFor(() => expect(onPositionsSaved).toHaveBeenCalled());
+    expect(rounded((onPositionsSaved.mock.calls[0][0] as { x: number; y: number }[])[0])).toEqual({ x: -110, y: -40 });
+  });
+
+  it("回归：重挂载且父页已合并位置 → 不再批量初始化（拖拽落点不被辐射重算覆盖）", async () => {
+    // Arrange：首次打开 → 批量初始化 → 父页合并（模拟 onPositionsSaved 生效）
+    const saved: { nodeId: number; x: number; y: number }[] = [];
+    const { unmount } = renderView({
+      onPositionsSaved: (updates) => { saved.push(...updates); },
+    });
+    await waitFor(() => expect(saved).toHaveLength(2));
+    unmount();
+    // Act：以"已存位置"的 props 重挂载（父页合并后的状态）
+    renderView({ nodes: makeNodes(true).map((n) => {
+      const s = saved.find((x) => x.nodeId === n.id)!;
+      return { ...n, canvasX: s.x, canvasY: s.y };
+    }) });
+    // Assert：不再触发第二次批量初始化，位置来自存储
+    await waitFor(() => expect(rfProps.length).toBeGreaterThan(0));
+    expect(batchCalls()).toHaveLength(1);
+    expect(rounded(rfNode("q:1").position)).toEqual({ x: -110, y: -40 });
   });
 
   it("已存位置 → 不触发初始化，位置来自存储", async () => {
@@ -148,9 +173,9 @@ describe("KnowledgeCanvasView 画布", () => {
     expect(rfNode("q:2").position).toEqual({ x: 30, y: 40 });
   });
 
-  it("拖拽结束 → 防抖后保存 update_node_canvas_position", async () => {
+  it("拖拽结束 → 防抖后保存 update_node_canvas_position 并回传父页合并", async () => {
     // Arrange
-    renderView({ nodes: makeNodes(true) });
+    const { onPositionsSaved } = renderView({ nodes: makeNodes(true) });
     await waitFor(() => expect(rfProps.length).toBeGreaterThan(0));
     const onNodeDragStop = latestRf().onNodeDragStop as (e: unknown, node: { id: string; position: { x: number; y: number } }) => void;
     // Act：拖拽 q:1 到 (100, 200)
@@ -159,6 +184,8 @@ describe("KnowledgeCanvasView 画布", () => {
     await waitFor(() =>
       expect(invokeMock).toHaveBeenCalledWith("update_node_canvas_position", { nodeId: 1, canvasX: 100, canvasY: 200 }),
     );
+    // 父页合并回调（拖拽位置同步进 props——重挂载不丢）
+    await waitFor(() => expect(onPositionsSaved).toHaveBeenCalledWith([{ nodeId: 1, x: 100, y: 200 }]));
   });
 
   it("节点点击 → onSelectItem（问题/概念/模型分派）", async () => {

app/src/components/KnowledgeCanvasView.tsx

@@ -19,7 +19,7 @@ import {
   type Edge, type Node, type NodeProps, type OnMoveEnd, type Viewport,
 } from "@xyflow/react";
 import "@xyflow/react/dist/style.css";
-import type { KnowledgeConcept, KnowledgeLink, KnowledgeModel, KnowledgeNode } from "../types/knowledge";
+import type { KnowledgeConcept, KnowledgeLink, KnowledgeModel, KnowledgeNode, CanvasNodePosition } from "../types/knowledge";
 import {
   buildCanvasElements, canvasKey, entityIdFromKey,
   type CanvasNodeData, type CanvasSelectKind,
@@ -40,6 +40,11 @@ interface Props {
   /** 当前选中实体 key（`q:1`/`c:2`/`m:3`——与树视图/列表共享选中态） */
   selectedKey: string | null;
   onSelectItem: (kind: CanvasSelectKind, entityId: number) => void;
+  /**
+   * 位置持久化成功回调（父页合并进 nodes props——重挂载后 props 即为已存位置，
+   * 杜绝"辐射布局重算覆盖已拖走位置"；规格 §4.4 纪律：位置只由用户决定）。
+   */
+  onPositionsSaved?: (updates: CanvasNodePosition[]) => void;
   /** 返回树视图（§4.5 切换） */
   onGoBack: () => void;
 }
@@ -71,7 +76,7 @@ export default function KnowledgeCanvasView(props: Props) {
 }
 
 function CanvasFlow({
-  systemId, coreQuestion, nodes, concepts, models, links, selectedKey, onSelectItem, onGoBack,
+  systemId, coreQuestion, nodes, concepts, models, links, selectedKey, onSelectItem, onPositionsSaved, onGoBack,
 }: Props) {
   const [rfNodes, setRfNodes, onNodesChange] = useNodesState<Node<CanvasNodeData>>([]);
   const [rfEdges, setRfEdges, onEdgesChange] = useEdgesState<Edge>([]);
@@ -84,6 +89,10 @@ function CanvasFlow({
   rfApi.current.fitView = fitView;
   rfApi.current.setViewport = setViewport;
 
+  // onPositionsSaved 经 ref 透传：防抖/卸载回调在闭包外执行，ref 保证拿到最新回调
+  const savedRef = useRef(onPositionsSaved);
+  savedRef.current = onPositionsSaved;
+
   // 拖拽落点本地覆盖（props 未刷新前保持视图正确；systemId 切换随组件卸载清空）
   const localOverrides = useRef(new Map<number, CanvasPoint>());
   // 待保存拖拽位置（防抖批量刷 DB；卸载时兜底刷新）
@@ -98,23 +107,30 @@ function CanvasFlow({
     }
     const entries = [...pendingPositions.current.entries()];
     pendingPositions.current.clear();
-    for (const [nodeId, pos] of entries) {
-      void invoke("update_node_canvas_position", { nodeId, canvasX: pos.x, canvasY: pos.y })
-        .catch((e) => setStatus(`位置保存失败: ${e}`));
-    }
+    if (entries.length === 0) return;
+    // 全部成功才回传父页合并（部分失败不污染 props——下次重挂载用 DB 兜底）
+    void Promise.all(
+      entries.map(([nodeId, pos]) =>
+        invoke("update_node_canvas_position", { nodeId, canvasX: pos.x, canvasY: pos.y }),
+      ),
+    )
+      .then(() => savedRef.current?.(entries.map(([nodeId, pos]) => ({ nodeId, x: pos.x, y: pos.y }))))
+      .catch((e) => setStatus(`位置保存失败: ${e}`));
   }, []);
 
-  // 卸载兜底：清定时器 + 刷新未保存的拖拽落点（防切页丢失）
+  // 卸载兜底：清定时器 + 刷新未保存的拖拽落点（防切页丢失；父页存活，合并安全）
   useEffect(() => {
     return () => {
       if (dragTimer.current != null) window.clearTimeout(dragTimer.current);
       if (vpTimer.current != null) window.clearTimeout(vpTimer.current);
       if (pendingPositions.current.size > 0) {
         const entries = [...pendingPositions.current.entries()];
         pendingPositions.current.clear();
-        for (const [nodeId, pos] of entries) {
-          void invoke("update_node_canvas_position", { nodeId, canvasX: pos.x, canvasY: pos.y });
-        }
+        void Promise.all(
+          entries.map(([nodeId, pos]) =>
+            invoke("update_node_canvas_position", { nodeId, canvasX: pos.x, canvasY: pos.y }),
+          ),
+        ).then(() => savedRef.current?.(entries.map(([nodeId, pos]) => ({ nodeId, x: pos.x, y: pos.y }))));
       }
     };
   }, []);
@@ -161,6 +177,7 @@ function CanvasFlow({
     if (batchPersist.length > 0) {
       // 首次打开（或新增未布局节点）→ 批量初始化；失败不阻塞渲染（下次打开重试）
       void invoke("batch_initialize_canvas_positions", { systemId, positions: batchPersist })
+        .then(() => savedRef.current?.(batchPersist))
         .catch((e) => setStatus(`布局初始化失败: ${e}`));
     }
 
@@ -250,6 +267,7 @@ function CanvasFlow({
     setRfNodes(rfn);
     setRfEdges(edges);
     void invoke("batch_initialize_canvas_positions", { systemId, positions: persist })
+      .then(() => savedRef.current?.(persist))
       .catch((e) => setStatus(`布局保存失败: ${e}`));
     void fitView({ padding: 0.15 });
   };
@@ -279,6 +297,10 @@ function CanvasFlow({
           maxZoom={2}
           nodesConnectable={false}
           edgesReconnectable={false}
+          // §九 不做清单：框选批量移动（RF 内置但本版暂不暴露）——禁用元素选择
+          // 引擎，杜绝 shift 框选 + 多节点拖拽导致的"其余节点视觉位移不持久"竞态
+          elementsSelectable={false}
+          selectionKeyCode={null}
           deleteKeyCode={null}
           fitView={false}
         >

app/src/pages/KnowledgePage.test.tsx

@@ -38,7 +38,7 @@ const aNode = {
   orderIdx: 0, status: "active", createdAt: 0, canvasX: null, canvasY: null,
 };
 
-/** 有体系 + 画布命令的 mock（画布激活时需要的命令回路） */
+/** 有体系的 mock（画布视图已 mock——本层只需列表命令回路） */
 function withSystemMock() {
   invokeMock.mockImplementation(async (cmd: string) => {
     switch (cmd) {
@@ -47,8 +47,6 @@ function withSystemMock() {
       case "list_knowledge_concepts": return [];
       case "list_knowledge_models": return [];
       case "list_knowledge_links": return [];
-      case "get_canvas_viewport": return null;
-      case "batch_initialize_canvas_positions": return true;
       default: throw new Error(`unexpected: ${cmd}`);
     }
   });

app/src/pages/KnowledgePage.tsx

@@ -16,7 +16,7 @@ import { useCallback, useEffect, useMemo, useState } from "react";
 import { invoke } from "@tauri-apps/api/core";
 import type {
   KnowledgeSystem, KnowledgeNode, KnowledgeConcept, KnowledgeModel,
-  KnowledgeLink, KnowledgeSelection,
+  KnowledgeLink, KnowledgeSelection, CanvasNodePosition,
 } from "../types/knowledge";
 import { systemStatusLabel } from "../types/knowledge";
 import { canvasKey } from "../utils/canvasElements";
@@ -124,6 +124,20 @@ export default function KnowledgePage({ focusSystemId }: Props) {
     return canvasKey("model", selection.id);
   }, [selection]);
 
+  // v0.13.8：画布位置持久化成功 → 合并进本页 nodes props（重挂载后 props 即已存
+  // 位置——防辐射布局重算覆盖用户拖走的落点，§4.4 纪律"位置只由用户决定"）
+  const applyCanvasPositions = useCallback((updates: CanvasNodePosition[]) => {
+    const byId = new Map(updates.map((u) => [u.nodeId, u]));
+    setNodes((prev) =>
+      prev.map((n) => {
+        const u = byId.get(n.id);
+        if (!u) return n;
+        if (n.canvasX === u.x && n.canvasY === u.y) return n;
+        return { ...n, canvasX: u.x, canvasY: u.y };
+      }),
+    );
+  }, []);
+
   const globalSystem = systems.find((s) => s.kind === "global") ?? null;
   const domainSystems = systems.filter((s) => s.kind === "domain");
   const selectedSystem = systems.find((s) => s.id === selectedSystemId) ?? null;
@@ -260,6 +274,7 @@ export default function KnowledgePage({ focusSystemId }: Props) {
                   links={links}
                   selectedKey={selectedCanvasKey}
                   onSelectItem={(kind, id) => setSelection({ type: kind, id })}
+                  onPositionsSaved={applyCanvasPositions}
                   onGoBack={() => setMiddleView("tree")}
                 />
               </div>

docs/standards/line-limit-exemptions.md

@@ -77,7 +77,7 @@
 | app/src/components/NoteEditView.tsx | —— | v0.12.2 行数修正：实测 299 行（登记值 315 过期），本版新增 autoFocus 一行后仍 300 行以内——登记移除，见"已拆分/登记移除记录" | —— |
 | app/src/pages/NotesPage.tsx | 359 | v0.12.2 三栏编排（GroupSidebar/FeedFragmentList/NoteListView 插槽 + 收件箱动线 onPromoted 接线 + 新建零对话框）——编排层内聚（数据获取/选中态/快捷键/辅助面板插槽），组件已全部下沉拆件；2026-08-23 审查修复（onPromoted 同步清搜索态/onOpenInbox 清组过滤）+6 行；v0.12.8 列表级批量删除（runBatchDelete 确认+逐条 invoke+刷新，confirm 导入，+27 行）；v0.13.6（REQ-223）编辑退出统一刷新回调 + 审查轮（ESC flush 出口） | 若再增长：键盘监听与收件箱动线回调拆至 useNotesPageShortcuts.ts / useInboxFlow.ts |
 | app/src/components/AiProviderSettings.tsx | 329 | v0.11.6 M1 code-review 修复（2026-08-22）：删除/清钥加 window.confirm、window.prompt 改卡片内联 password 输入（+2 state + 内联表单）、模型列表 input 改 textarea、fallbackOrder 透传 initial、run 置"处理中"反馈、预设双源 presetOptions 后端拉取——修复净增约 13 行越线（实测 329，含 4 行豁免头注释） | 若再增长：内联密钥表单拆至 AiProviderKeyInput.tsx |
-| app/src/pages/KnowledgePage.tsx | 310 | v0.13.8 画布接线越线（原 296）：中栏新增「画布」标签 + 树/画布双入口（树视图浮钮 + 标签栏）+ 中栏 display 切换（树常驻/画布激活挂载）——页面编排层内聚（数据获取/选中态/标签态为页面本地状态），子组件已全部下沉（Tree/Canvas/DetailPanel/Wizard/ConceptCardRow/Sample） | 若再增长：中栏视图块（树/画布/概念/模型 + 标签栏）拆至 KnowledgeMiddlePane.tsx，SystemCard 拆至 SystemSidebarCard.tsx |
+| app/src/pages/KnowledgePage.tsx | 322 | v0.13.8 画布接线越线（原 296）：中栏新增「画布」标签 + 树/画布双入口（树视图浮钮 + 标签栏）+ 中栏 display 切换（树常驻/画布激活挂载）+ 审查修复（applyCanvasPositions 位置合并回传）——页面编排层内聚（数据获取/选中态/标签态为页面本地状态），子组件已全部下沉（Tree/Canvas/DetailPanel/Wizard/ConceptCardRow/Sample） | 若再增长：中栏视图块（树/画布/概念/模型 + 标签栏）拆至 KnowledgeMiddlePane.tsx，SystemCard 拆至 SystemSidebarCard.tsx |
 
 > 前端 **拆分中**（Task #9 笔记域修复进行中，暂不登记行数）：`app/src/types.ts`——待前端拆分完成后以实测行数重新评估。
 > 前端 SessionsPage.tsx 审查快照 304 行（登记值），v0.7.1 硬拆后长期 ≤300，本轮审查期间轻微越线；随 NotesPage/types.ts 拆分任务一并复核，若仍越线按上表模式登记。