feat(kb): 空体系引导跳建体系向导链路（TD-2026-09-05-A）

Author: Aparencia

app/src/App.tsx

@@ -80,6 +80,8 @@ function App() {
   };
   // v0.13.7：跨页直达目标体系（组行徽标/结算简报 → 体系页自动选中）
   const [focusSystemId, setFocusSystemId] = useState<number | null>(null);
+  // TD-2026-09-05-A：外部请求打开建体系向导（笔记页空体系引导 → 体系页向导）
+  const [createSystemSignal, setCreateSystemSignal] = useState(0);
   // v0.14 C2：图谱组节点 → 笔记页过滤该组（同 focusNoteId 模式）
   const [focusGroupId, setFocusGroupId] = useState<number | null>(null);
   // v0.16.1：工作台深链（对话页任务视图 → 会话页自动展开精修工作台）与
@@ -343,6 +345,10 @@ function App() {
               setFocusSystemId(id);
               setPage("knowledge");
             }}
+            onCreateSystem={() => {
+              setCreateSystemSignal((s) => s + 1);
+              setPage("knowledge");
+            }}
             onOpenSessions={(id) => {
               setFocusSessionId(id);
               setPage("sessions");
@@ -377,6 +383,7 @@ function App() {
               v0.13.7：focusSystemId 跨页直达（组行徽标/结算简报 → 自动选中体系） */}
           <KnowledgePage
             focusSystemId={focusSystemId}
+            createSystemSignal={createSystemSignal}
             onOpenNote={(id) => { setFocusNoteId(id); setPage("notes"); }}
             onOpenGroup={(id) => { setFocusGroupId(id); setPage("notes"); }}
           />

app/src/components/NoteLinkToSystem.test.tsx

@@ -88,16 +88,19 @@ describe("NoteLinkToSystem v0.13.7 基础（REQ-286 列表选中语义）", () =
     });
   });
 
-  it("无体系时提示先创建体系（不显示确认按钮）", async () => {
+  it("无体系时提示先创建体系（不显示确认按钮）；引导按钮跳体系向导（TD-2026-09-05-A）", async () => {
     invokeMock.mockImplementation(async (cmd: string) => {
       if (cmd === "list_knowledge_systems") return [];
       if (cmd === "list_links_by_target") return [];
       throw new Error(`unexpected: ${cmd}`);
     });
-    render(<NoteLinkToSystem noteId={7} onChanged={vi.fn()} />);
+    const onGoto = vi.fn();
+    render(<NoteLinkToSystem noteId={7} onChanged={vi.fn()} onGotoKnowledgeSystem={onGoto} />);
     fireEvent.click(await screen.findByTestId("note-link-open"));
     expect(await screen.findByTestId("note-link-empty")).toBeTruthy();
     expect(screen.queryByTestId("note-link-confirm")).toBeNull();
+    fireEvent.click(screen.getByTestId("note-link-goto-system"));
+    expect(onGoto).toHaveBeenCalledTimes(1);
   });
 });
 

app/src/components/NoteLinkToSystem.tsx

@@ -32,6 +32,8 @@ interface Props {
   noteId: number;
   /** 挂接/取消后刷新回调（NotesPage 重载引用列表） */
   onChanged: () => void;
+  /** TD-2026-09-05-A：空体系时引导跳体系页并打开建体系向导（App 级通道） */
+  onGotoKnowledgeSystem?: () => void;
 }
 
 /** 问题节点树 → 缩进行（父链循环守卫防脏数据死循环；深度上限 30） */
@@ -69,7 +71,7 @@ function flattenNodeRows(nodes: KnowledgeNode[]): LinkRow[] {
   return rows;
 }
 
-export default function NoteLinkToSystem({ noteId, onChanged }: Props) {
+export default function NoteLinkToSystem({ noteId, onChanged, onGotoKnowledgeSystem }: Props) {
   const [open, setOpen] = useState(false);
   const [systems, setSystems] = useState<KnowledgeSystem[]>([]);
   const [nodes, setNodes] = useState<KnowledgeNode[]>([]);
@@ -252,7 +254,19 @@ export default function NoteLinkToSystem({ noteId, onChanged }: Props) {
             }}
           >
           {domainSystems.length === 0 ? (
-            <div data-testid="note-link-empty" style={{ fontSize: 12, color: "#9ca3af" }}>暂无体系——请先到「🧠 体系」页创建。</div>
+            <div data-testid="note-link-empty" style={{ fontSize: 12, color: "#9ca3af", display: "flex", flexDirection: "column", gap: 6, alignItems: "flex-start" }}>
+              <span>暂无体系——笔记无法挂接。</span>
+              {/* TD-2026-09-05-A：引导按钮（跳体系页并打开建体系向导） */}
+              {onGotoKnowledgeSystem && (
+                <button
+                  data-testid="note-link-goto-system"
+                  onClick={onGotoKnowledgeSystem}
+                  style={{ fontSize: 12, padding: "4px 10px", borderRadius: 6, border: "1px solid #0f766e", background: "#f0fdfa", color: "#0f766e", cursor: "pointer" }}
+                >
+                  ➕ 去体系页创建（向导）
+                </button>
+              )}
+            </div>
           ) : (
             <>
               <select

app/src/pages/KnowledgePage.tsx

@@ -51,9 +51,11 @@ interface Props {
   onOpenNote?: (noteId: number) => void;
   /** 图谱双击组节点 → 笔记页过滤该组 */
   onOpenGroup?: (groupId: number) => void;
+  /** TD-2026-09-05-A：外部请求打开建体系向导（递增信号——挂起页常驻时仍触发） */
+  createSystemSignal?: number;
 }
 
-export default function KnowledgePage({ focusSystemId, onOpenNote, onOpenGroup }: Props) {
+export default function KnowledgePage({ focusSystemId, onOpenNote, onOpenGroup, createSystemSignal }: Props) {
   // v0.15：左列可拖拽/记忆/窄窗折叠（默认 260=历史值）；详情面板宽度由父层持有
   const leftCol = useColumnLayout("knowledge-left", { default: 260, min: 200, max: 360, autoFoldBelow: 860 });
   const detailCol = useColumnLayout("knowledge-detail", { default: 320, min: 260, max: 420 });
@@ -131,6 +133,12 @@ export default function KnowledgePage({ focusSystemId, onOpenNote, onOpenGroup }
   // 保留挂载下后台仅数次轻查询 + hook 内防抖合并风暴）
   useDbRefresh(["knowledge"], reloadAll);
 
+  // TD-2026-09-05-A：外部（笔记页空体系引导）请求打开建体系向导——递增信号
+  // 语义：挂起页（display:none 常驻）重复请求仍逐次触发
+  useEffect(() => {
+    if (createSystemSignal && createSystemSignal > 0) setWizardOpen(true);
+  }, [createSystemSignal]);
+
   // v0.13.7：跨页直达目标体系（与 NotesPage focusNoteId 同模式——仅 focusSystemId
   // 变化时跟随；空态无体系时该值无意义，由既有选中/创建逻辑接管）
   useEffect(() => {

app/src/pages/NotesPage.tsx

@@ -50,12 +50,14 @@ interface Props {
   onOpenSessions?: (sessionId: number) => void;
   /** 打开体系页并选中体系（v0.13.7 触点① 组行徽标） */
   onOpenSystem?: (systemId: number) => void;
+  /** TD-2026-09-05-A：空体系引导——跳体系页并打开建体系向导 */
+  onCreateSystem?: () => void;
 }
 
 /** 中部视图：notes=笔记列表（组过滤/搜索/标签）；inbox=收件箱碎片列表 */
 type MiddleView = "notes" | "inbox";
 
-export default function NotesPage({ focusNoteId, focusNoteSearch, focusGroupId, onOpenSessions, onOpenSystem }: Props) {
+export default function NotesPage({ focusNoteId, focusNoteSearch, focusGroupId, onOpenSessions, onOpenSystem, onCreateSystem }: Props) {
   const [notes, setNotes] = useState<Note[]>([]);
   const [keyword, setKeyword] = useState("");
   const [tagFilter, setTagFilter] = useState<string | null>(null);
@@ -531,7 +533,12 @@ export default function NotesPage({ focusNoteId, focusNoteSearch, focusGroupId,
                   onChanged={() => void handleNoteChanged()}
                 />
                 {/* v0.13.7 触点②：标题栏「挂到体系」入口；key=note.id 切笔记重置内部态 */}
-                <NoteLinkToSystem key={`link-${selected.id}`} noteId={selected.id} onChanged={() => void handleNoteChanged()} />
+                <NoteLinkToSystem
+                  key={`link-${selected.id}`}
+                  noteId={selected.id}
+                  onChanged={() => void handleNoteChanged()}
+                  onGotoKnowledgeSystem={onCreateSystem}
+                />
                 {/* v0.17.0：编辑态 AI 能力统一入口（阅读态点击直接进入编辑态） */}
                 <button
                   data-testid="note-ai-entry"