@allbluecn/web-app 0.18.2 → 0.19.0

package/src/config/sidebar-routes.tsx

@@ -24,9 +24,8 @@ import {
   ClipboardList,
   FlaskConical,
   Bug,
-  CircleCheckBig,
   PenTool,
-  Speech,
+  ListTodo,
 } from "lucide-react";
 
 export type RouteSubItem = {
@@ -44,6 +43,12 @@ export type Route = {
   link: string;
   badge: () => string;
   subs?: RouteSubItem[];
+  /**
+   * 模块级 presence 头像组渲染工厂（§8.2）。入参为 route.id 经 MODULE_ROUTES
+   * 查表解析出的 module key（id ≠ module key，如 home→dashboard）；消费者仅
+   * nav-main.tsx（调用渲染）与 app-sidebar.tsx（提供工厂）两文件。
+   */
+  presence?: (module: string) => React.ReactNode;
 };
 
 export const workspaceRoutes: Route[] = [
@@ -97,17 +102,10 @@ export const workspaceRoutes: Route[] = [
     link: "/bugs",
   },
   {
-    id: "acceptance",
-    title: m.common_nav_acceptance,
-    icon: <CircleCheckBig className="size-4" />,
+    id: "task",
+    title: m.common_nav_task,
+    icon: <ListTodo className="size-4" />,
     badge: () => " ",
-    link: "/acceptance-criteria",
-  },
-  {
-    id: "debrief",
-    title: m.common_nav_debrief,
-    icon: <Speech className="size-4" />,
-    badge: () => " ",
-    link: "/debrief",
+    link: "/tasks",
   },
 ];

package/src/design-engine/document/serialize-leafer-json.ts

@@ -58,7 +58,8 @@ export function isLeaferJSONPackage(v: unknown): v is LeaferJSONPackage {
   return p.format === "leafer-json" && p.version === 1 && !!p.tree && typeof p.tree === "object"
 }
 
-const EXTENSION_KEYS: readonly (keyof SceneNodeExtensions)[] = [
+// 导出供 collab-core canvas-tree 镜像对账（web 对账测试逐值断言两侧键清单一致）
+export const EXTENSION_KEYS: readonly (keyof SceneNodeExtensions)[] = [
   "props",
   "overrides",
   "exports",

package/src/design-engine/engine/__tests__/engine-split.test.ts

@@ -35,7 +35,7 @@ describe("引擎拆分结构哨兵", () => {
   });
 });
 
-const PUBLIC_API = ["loadDoc","getDoc","getJSON","applyNodePatch","applyNodesAppend","updateNodeGeometry","updateMultiNodeGeometry","applyMultiNodePatch","deleteSelectedNodes","replaceNodes","reorderNodes","groupSelection","ungroupSelection","applyBooleanOp","getSelection","select","selectAll","copySelection","cutSelection","pasteClipboard","pasteClipboardAt","pasteIntoFrame","duplicateSelection","setNodesLocked","setNodesVisible","setTool","zoomTo","panBy","fit","focusNode","zoomToFrame","getLeaf","findLeaf","getZoom","toCanvas","fromCanvas","pickFrameLabel","undo","redo","enterPathEdit","exitPathEdit","pathEditingNodeId","getPathEditInfo","getSelectedAnchorInfo","movePathAnchor","setAnchorPointType","togglePathClosed","addPathAnchorAfterSelected","deleteSelectedPathAnchor","hasClipboard","onDocChange","onSelectionChange","onToolChange","setKeyEventEnabled","mount","dispose","remount"] as const;
+const PUBLIC_API = ["loadDoc","applyRemoteScene","rebuildRemoteScene","getDoc","getJSON","applyNodePatch","applyNodesAppend","updateNodeGeometry","updateMultiNodeGeometry","applyMultiNodePatch","deleteSelectedNodes","replaceNodes","reorderNodes","groupSelection","ungroupSelection","applyBooleanOp","getSelection","select","selectAll","copySelection","cutSelection","pasteClipboard","pasteClipboardAt","pasteIntoFrame","duplicateSelection","setNodesLocked","setNodesVisible","setTool","zoomTo","panBy","fit","focusNode","zoomToFrame","getLeaf","findLeaf","getZoom","toCanvas","fromCanvas","pickFrameLabel","undo","redo","enterPathEdit","exitPathEdit","pathEditingNodeId","getPathEditInfo","getSelectedAnchorInfo","movePathAnchor","setAnchorPointType","togglePathClosed","addPathAnchorAfterSelected","deleteSelectedPathAnchor","hasClipboard","onDocChange","onSelectionChange","onToolChange","setKeyEventEnabled","mount","dispose","remount"] as const;
 
 // getOwnPropertyDescriptor 只覆盖自有属性；继承链各层方法的描述符在祖先原型上，
 // 需沿链上行取首个命中（终类公开 API 面 = 各层方法经原型链可达）

package/src/design-engine/engine/__tests__/engine.test.ts

@@ -455,6 +455,26 @@ describe("LeaferEngine", () => {
     expect(mod.apps[0].mode).toBe("normal")
   })
 
+  it("拖拽生命周期广播 onDragChange（DragEvent.START/END → true/false）", () => {
+    const engine = new LeaferEngine(mod as never)
+    engine.mount(el)
+    const cb = vi.fn()
+    const unsubscribe = engine.onDragChange(cb)
+
+    mod.fireApp(mod.apps[0], "drag.start")
+    expect(cb).toHaveBeenCalledTimes(1)
+    expect(cb).toHaveBeenLastCalledWith(true)
+
+    mod.fireApp(mod.apps[0], "drag.end")
+    expect(cb).toHaveBeenCalledTimes(2)
+    expect(cb).toHaveBeenLastCalledWith(false)
+
+    // 退订后不再广播（协同桥用毕摘订阅不悬挂）
+    unsubscribe()
+    mod.fireApp(mod.apps[0], "drag.start")
+    expect(cb).toHaveBeenCalledTimes(2)
+  })
+
   it("loadDoc 触发 onDocChange，且 getDoc 反映载入内容", () => {
     const engine = new LeaferEngine(mod as never)
     engine.mount(el)

package/src/design-engine/engine/app.ts

@@ -212,6 +212,8 @@ export class LeaferEngine extends ActionsEngine {
     // END 落栈，撤销会跳过拖拽步骤直达更早状态
     const dragStartHandler = (): void => {
       this.preDragDoc = this.currentDoc
+      // 拖拽生命周期广播（任务 28 协同桥：冻结远端回放 + 启动 awareness 影子）
+      this.notifyDragChange(true)
       // 拖拽手势期间冻结 shader 动画预览：帧循环逐帧对活跃动画 leaf
       // forceRender 会持续作废增量渲染脏区，挤占拖拽帧预算（5 个大元素
       // 可见时拖拽明显掉帧）；活跃集读空后循环自停，松手恢复
@@ -230,6 +232,9 @@ export class LeaferEngine extends ActionsEngine {
       this.reparentOnDrop()
       this.shaderRuntime?.setInteractionPaused(false)
       this.shaderFrameLoop.refresh()
+      // 拖拽生命周期广播放最后：re-parent 落位后派发，订阅方（协同桥）读
+      // getDoc 即含落位结果的最终态，释放写 Y 恰好一次
+      this.notifyDragChange(false)
     }
     this.appEventIds = [
       app.on_(this.mod.DragEvent.START, dragStartHandler),

package/src/design-engine/engine/engine-base.ts

@@ -62,6 +62,9 @@ export class LeaferEngineBase {
   protected tool: ToolId = "select"
   protected docListeners = new Set<(doc: SceneDocument) => void>()
   protected selectionListeners = new Set<(ids: string[]) => void>()
+  // 拖拽生命周期订阅（协同桥冻结/影子会话的接线上游：DragEvent.START/END
+  // 经 notifyDragChange 转译为布尔）
+  protected dragListeners = new Set<(dragging: boolean) => void>()
   protected lastNotifiedSelection: string[] | null = null
   // 权威选中态（单一事实源）：leafer editor.select/cancel 异步生效，
   // editor.list 在重建/选中切换瞬间读到的是旧值或空值。engine 同步维护
@@ -180,6 +183,16 @@ export class LeaferEngineBase {
     }
   }
 
+  // 拖拽生命周期订阅（任务 28 协同桥接线上游）：START → true、END → false。
+  // END 在 reparentOnDrop 之后派发（app.ts），订阅方读 getDoc 即最终态。
+  onDragChange(cb: (dragging: boolean) => void): () => void {
+    this.assertUsable({ allowUnmounted: true })
+    this.dragListeners.add(cb)
+    return () => {
+      this.dragListeners.delete(cb)
+    }
+  }
+
   onToolChange(cb: (tool: ToolId) => void): () => void {
     this.assertUsable({ allowUnmounted: true })
     this.toolListeners.add(cb)
@@ -192,6 +205,10 @@ export class LeaferEngineBase {
     for (const cb of this.docListeners) cb(this.currentDoc)
   }
 
+  protected notifyDragChange(dragging: boolean): void {
+    for (const cb of this.dragListeners) cb(dragging)
+  }
+
   protected notifySelectionChange(expected?: string[]): void {
     // getSelection() 读权威 selectionState（同步可靠）；expected 用于
     // applyScene 补发场景，语义等价，保留参数便于调用方显式表达意图

package/src/design-engine/engine/engine-doc.ts

@@ -169,6 +169,38 @@ export class DocEngine extends DecorEngine {
     })
   }
 
+  // ===== §7.2 画布桥·远端方向（P4b）：协同远端场景应用门面 ================
+
+  // 远端 Y 树反序列化场景的增量应用口（协同绑定层 canvas-remote 消费）。
+  // 与 loadDoc 的语义区分：增量优先（R1 管线，appliedDoc 为 diff 基线），
+  // 不重置撤销历史（远端变更不入本地撤销栈）、不 cancel 选中、不 fit。
+  // 返回 false = 增量失败（内部异常或基线未建），调用方应立即以同一快照走
+  // rebuildRemoteScene 全量兜底（§7.2「失败兜底 rebuildScene（现有回退路径）」）。
+  applyRemoteScene(doc: SceneDocument): boolean {
+    this.assertUsable()
+    // 远端数据不可信（对端可能是写坏 Y 树的客户端）：同 loadDoc 的防御姿态
+    const clean = sanitizeScene(doc)
+    const shaderPrev = this.appliedDoc
+    if (this.appliedDoc && this.applySceneIncremental(clean)) {
+      this.currentDoc = clean
+      this.appliedDoc = clean
+      this.syncShaderLifecycle(shaderPrev, clean)
+      this.notifyDocChange()
+      return true
+    }
+    return false
+  }
+
+  // 增量失败的全量兜底（rebuildScene 现有回退路径的公开门面）：强制整树重建，
+  // appliedDoc 在 applyScene 内重置（§7.2「重建后基线重置」）。与 applyRemoteScene
+  // 成对消费（绑定层契约）；不 fit（兜底不劫持用户视口）、不入撤销历史。
+  rebuildRemoteScene(doc: SceneDocument): void {
+    this.assertUsable()
+    this.currentDoc = sanitizeScene(doc)
+    this.applyScene(this.currentDoc, true)
+    this.notifyDocChange()
+  }
+
   getDoc(): SceneDocument {
     this.assertUsable()
     return leaferToDoc(this.app!.tree, { device: this.opts.device, preserveFrom: this.currentDoc })

package/src/hooks/__tests__/use-commands.test.tsx

@@ -28,10 +28,15 @@ vi.mock('@/lib/auth/auth-client', () => ({
   signOut: vi.fn(async () => ({})),
 }))
 
-vi.mock('next-themes', () => ({
-  useTheme: () => ({
-    theme: 'light',
-    setTheme: vi.fn(),
+const toggleMock = vi.fn()
+
+vi.mock('@/providers/theme-mode-provider', () => ({
+  useThemeMode: () => ({
+    mode: 'auto',
+    setMode: vi.fn(),
+    toggle: toggleMock,
+    resolved: 'light',
+    mounted: true,
   }),
 }))
 
@@ -42,7 +47,7 @@ describe('useCommands', () => {
 
   it('returns all commands with i18n-resolved title', () => {
     const { result } = renderHook(() => useCommands())
-    expect(result.current.commands).toHaveLength(21)
+    expect(result.current.commands).toHaveLength(18)
     const dash = result.current.commands.find((c) => c.id === 'goto-dashboard')
     expect(dash?.title).toBe('前往工作台')
   })
@@ -61,4 +66,11 @@ describe('useCommands', () => {
     result.current.execute(cmd)
     expect(onAction).toHaveBeenCalledWith('create-prd')
   })
+
+  it('toggle-theme 调用主题切换（写入手动选择）', () => {
+    const { result } = renderHook(() => useCommands())
+    const cmd = result.current.commands.find((c) => c.id === 'toggle-theme')!
+    result.current.execute(cmd)
+    expect(toggleMock).toHaveBeenCalledTimes(1)
+  })
 })

package/src/hooks/use-commands.ts

@@ -17,9 +17,9 @@
 
 import { useCallback, useMemo } from 'react'
 import { useRouter } from '@tanstack/react-router'
-import { useTheme } from 'next-themes'
 import { signOut } from '@/lib/auth/auth-client'
 import { COMMAND_REGISTRY } from '@/lib/commands/registry'
+import { useThemeMode } from '@/providers/theme-mode-provider'
 import type { CommandDefinition } from '@/lib/commands/types'
 
 export type ResolvedCommand = Omit<CommandDefinition, 'title'> & { title: string }
@@ -28,7 +28,7 @@ const DELEGATED_ACTIONS = new Set(['create-prd'])
 
 export function useCommands(options?: { onAction?: (id: string) => void }) {
   const router = useRouter()
-  const { theme, setTheme } = useTheme()
+  const { toggle } = useThemeMode()
 
   const commands = useMemo<ResolvedCommand[]>(
     () => COMMAND_REGISTRY.map((c) => ({ ...c, title: c.title() })),
@@ -49,7 +49,7 @@ export function useCommands(options?: { onAction?: (id: string) => void }) {
       }
 
       if (id === 'toggle-theme') {
-        setTheme(theme === 'dark' ? 'light' : 'dark')
+        toggle()
         return
       }
 
@@ -67,7 +67,7 @@ export function useCommands(options?: { onAction?: (id: string) => void }) {
         void router.navigate({ to: '/stories' as never })
       }
     },
-    [router, setTheme, theme, options],
+    [router, toggle, options],
   )
 
   return { commands, execute }

package/src/hooks/use-toolbar-search.ts

@@ -33,6 +33,11 @@ export function useToolbarSearch({
   externalRef.current = externalValue;
   const onSearchRef = useRef(onSearch);
   onSearchRef.current = onSearch;
+  // transform 经 ref 取最新值且不进依赖：调用方多传内联箭头（每渲染新身份），
+  // 进依赖会让本 effect 在「外部值已变、防抖值未跟上」的窗口重跑，把保存视图
+  // 刚应用的 searchText 当作用户输入回声清掉（回 undefined + 回落默认视图）
+  const transformRef = useRef(transform);
+  transformRef.current = transform;
 
   useEffect(() => {
     setLocalSearch(externalValue ?? "");
@@ -40,8 +45,8 @@ export function useToolbarSearch({
 
   useEffect(() => {
     if (debouncedSearch === (externalRef.current ?? "")) return;
-    onSearchRef.current(transform(debouncedSearch));
-  }, [debouncedSearch, transform]);
+    onSearchRef.current(transformRef.current(debouncedSearch));
+  }, [debouncedSearch]);
 
   const handleSearchChange = (value: string) => {
     setLocalSearch(value);

package/src/lib/__tests__/datetime-local.test.ts

@@ -83,4 +83,50 @@ describe('datetime 本地日历工具', () => {
     const grid = getWeekGrid(2026, 6, 31) // 2026-07-31 周五，跨 8 月
     expect(grid[6].inMonth).toBe(false)
   })
+
+  describe('parseDate 分量范围校验（越界不滚动，返回 Invalid Date）', () => {
+    it('2026-13-45 双分量越界返回 Invalid Date（旧实现滚成 2027-02-14）', () => {
+      expect(Number.isNaN(parseDate('2026-13-45').getTime())).toBe(true)
+    })
+
+    it('2026-02-30 越界返回 Invalid Date（旧实现滚成 03-02）', () => {
+      expect(Number.isNaN(parseDate('2026-02-30').getTime())).toBe(true)
+    })
+
+    it('2026-02-29 非闰年返回 Invalid Date（旧实现滚成 03-01）', () => {
+      expect(Number.isNaN(parseDate('2026-02-29').getTime())).toBe(true)
+    })
+
+    it('2024-02-29 闰年合法', () => {
+      const d = parseDate('2024-02-29')
+      expect(d.getFullYear()).toBe(2024)
+      expect(d.getMonth()).toBe(1)
+      expect(d.getDate()).toBe(29)
+    })
+
+    it('2026-00-10 月份为 0 返回 Invalid Date（旧实现滚成 2025-12-10）', () => {
+      expect(Number.isNaN(parseDate('2026-00-10').getTime())).toBe(true)
+    })
+
+    it('2026-10-00 日为 0 返回 Invalid Date（旧实现滚成 09-30）', () => {
+      expect(Number.isNaN(parseDate('2026-10-00').getTime())).toBe(true)
+    })
+
+    it('garbage 非数字返回 Invalid Date', () => {
+      expect(Number.isNaN(parseDate('garbage').getTime())).toBe(true)
+    })
+
+    it('ISO 字符串前缀兼容不变', () => {
+      expect(formatDateLocal(parseDate('2026-10-19T08:00:00Z'))).toBe(
+        '2026-10-19',
+      )
+    })
+
+    it('2026-12-31 年末边界合法', () => {
+      const d = parseDate('2026-12-31')
+      expect(d.getFullYear()).toBe(2026)
+      expect(d.getMonth()).toBe(11)
+      expect(d.getDate()).toBe(31)
+    })
+  })
 })

package/src/lib/__tests__/datetime.test.ts

@@ -86,4 +86,11 @@ describe('formatTimestamp', () => {
   it('无效输入返回占位符不抛错', () => {
     expect(formatTimestamp('not-a-date')).toBe('-')
   })
+  it('同一时刻 string 与 Date 入口输出一致（详情页 createdAt 与运行历史同页统一口径——任务 11 发现 B 回归钉）', () => {
+    const iso = '2026-10-10T00:31:49.341Z'
+    expect(formatTimestamp(iso)).toBe(formatTimestamp(new Date(iso)))
+    // 详情页两个显示点（createdAt: string / run.startedAt: string | Date）
+    // 同页均为 +8 转换，不存在两种时区
+    expect(formatTimestamp(iso)).toBe('2026-10-10 08:31')
+  })
 })

package/src/lib/__tests__/layout-responsive.test.ts

@@ -0,0 +1,123 @@
+// SPDX-License-Identifier: AGPL-3.0-or-later
+// AllBlue - 理想之海
+// Copyright (C) 2026 AllBlue Contributors
+//
+// This program is free software: you can redistribute it and/or modify
+// it under the terms of the GNU Affero General Public License as published by
+// the Free Software Foundation, either version 3 of the License, or
+// (at your option) any later version.
+//
+// This program is distributed in the hope that it will be useful,
+// but WITHOUT ANY WARRANTY; without even the implied warranty of
+// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+// GNU Affero General Public License for more details.
+//
+// You should have received a copy of the GNU Affero General Public License
+// along with this program. If not, see <https://www.gnu.org/licenses/>.
+
+import { describe, expect, it } from "vitest";
+import {
+  AI_DOCKED_WIDTH,
+  CONTENT_MIN_WIDTH,
+  DOCK_MIN_WIDTH,
+  HYSTERESIS_WIDTH,
+  LAYOUT_CHROME_WIDTH,
+  SIDEBAR_EXPANDED_WIDTH,
+  SIDEBAR_ICON_WIDTH,
+  computeLayout,
+  type LayoutState,
+} from "../layout-responsive";
+
+const prevState = (over: Partial<LayoutState>): LayoutState => ({
+  sidebarCollapsed: false,
+  dockOverlay: false,
+  aiOverlay: false,
+  ...over,
+});
+/** 由目标可用宽（外层 − 侧栏目标宽 − chrome）反推外层宽度 */
+const outerFor = (usable: number, collapsed = false): number =>
+  usable + (collapsed ? SIDEBAR_ICON_WIDTH : SIDEBAR_EXPANDED_WIDTH) + LAYOUT_CHROME_WIDTH;
+
+describe("computeLayout 侧栏自动收起", () => {
+  const needExpanded = SIDEBAR_EXPANDED_WIDTH + CONTENT_MIN_WIDTH + DOCK_MIN_WIDTH + LAYOUT_CHROME_WIDTH;
+
+  it("外层足够：侧栏展开", () => {
+    expect(computeLayout({ outerWidth: needExpanded, dockPresent: true, aiDocked: false }).sidebarCollapsed).toBe(false);
+  });
+
+  it("外层不足：侧栏自动收起", () => {
+    expect(
+      computeLayout({ outerWidth: needExpanded - 1, dockPresent: true, aiDocked: false }).sidebarCollapsed,
+    ).toBe(true);
+  });
+
+  it("回差：已收起时需多出回差才展开", () => {
+    const prev = prevState({ sidebarCollapsed: true });
+    expect(
+      computeLayout({ outerWidth: needExpanded + 10, dockPresent: true, aiDocked: false }, prev).sidebarCollapsed,
+    ).toBe(true);
+    expect(
+      computeLayout({ outerWidth: needExpanded + HYSTERESIS_WIDTH, dockPresent: true, aiDocked: false }, prev)
+        .sidebarCollapsed,
+    ).toBe(false);
+  });
+});
+
+describe("computeLayout 面板浮层判定（基于外层预测）", () => {
+  it("宽裕：面板停靠、AI 停靠", () => {
+    const s = computeLayout({ outerWidth: 2400, dockPresent: true, aiDocked: true });
+    expect(s.dockOverlay).toBe(false);
+    expect(s.aiOverlay).toBe(false);
+  });
+
+  it("侧栏展开时刚好放下：仍停靠（边界）", () => {
+    const s = computeLayout({ outerWidth: outerFor(CONTENT_MIN_WIDTH + DOCK_MIN_WIDTH), dockPresent: true, aiDocked: false });
+    expect(s.sidebarCollapsed).toBe(false);
+    expect(s.dockOverlay).toBe(false);
+  });
+
+  it("侧栏收起后仍放得下：保持停靠（不翻转）", () => {
+    const s = computeLayout({ outerWidth: 1100, dockPresent: true, aiDocked: false });
+    expect(s.sidebarCollapsed).toBe(true);
+    expect(s.dockOverlay).toBe(false);
+  });
+
+  it("侧栏收起后仍放不下最小停靠：面板转浮层", () => {
+    const s = computeLayout({ outerWidth: 1000, dockPresent: true, aiDocked: false });
+    expect(s.sidebarCollapsed).toBe(true);
+    expect(s.dockOverlay).toBe(true);
+    expect(s.aiOverlay).toBe(false);
+  });
+
+  it("仅当连 AI 自身宽都放不下：AI 转浮层", () => {
+    // 面板已覆盖内容（内容不再保最小宽），AI 仍停靠；只有 usable < AI 宽 时 AI 才浮层
+    const aiDockedAt = computeLayout({ outerWidth: 700, dockPresent: true, aiDocked: true });
+    expect(aiDockedAt.dockOverlay).toBe(true);
+    expect(aiDockedAt.aiOverlay).toBe(false);
+    const s = computeLayout({ outerWidth: 500, dockPresent: true, aiDocked: true });
+    expect(s.dockOverlay).toBe(true);
+    expect(s.aiOverlay).toBe(true);
+  });
+
+  it("无面板：仅判 AI 是否停靠", () => {
+    const docked = computeLayout({ outerWidth: outerFor(CONTENT_MIN_WIDTH + AI_DOCKED_WIDTH), dockPresent: false, aiDocked: true });
+    expect(docked.aiOverlay).toBe(false);
+    const overlaid = computeLayout({ outerWidth: 500, dockPresent: false, aiDocked: true });
+    expect(overlaid.aiOverlay).toBe(true);
+  });
+
+  it("回差：面板已浮层时需多出回差才切回停靠", () => {
+    const prev = prevState({ dockOverlay: true, sidebarCollapsed: true });
+    const justUnder = outerFor(CONTENT_MIN_WIDTH + DOCK_MIN_WIDTH + 10, true);
+    const justOver = outerFor(CONTENT_MIN_WIDTH + DOCK_MIN_WIDTH + HYSTERESIS_WIDTH, true);
+    expect(computeLayout({ outerWidth: justUnder, dockPresent: true, aiDocked: false }, prev).dockOverlay).toBe(true);
+    expect(computeLayout({ outerWidth: justOver, dockPresent: true, aiDocked: false }, prev).dockOverlay).toBe(false);
+  });
+
+  it("未测量：返回默认态", () => {
+    const s = computeLayout({ outerWidth: 0, dockPresent: true, aiDocked: true });
+    expect(s.sidebarCollapsed).toBe(false);
+    expect(s.dockOverlay).toBe(false);
+    expect(s.aiOverlay).toBe(false);
+  });
+});

package/src/lib/__tests__/sidebar-utils.test.ts

@@ -3,13 +3,13 @@ import { isParentActive, isPathActive } from '../sidebar-utils'
 
 describe('isParentActive', () => {
   it('只在完全相等时激活', () => {
-    expect(isParentActive('/tags', '/tags')).toBe(true)
-    expect(isParentActive('/tags/settings', '/tags')).toBe(false)
+    expect(isParentActive('/knowledge', '/knowledge')).toBe(true)
+    expect(isParentActive('/knowledge/laws', '/knowledge')).toBe(false)
   })
 
   it('空链接与 # 返回 false', () => {
-    expect(isParentActive('/tags', '')).toBe(false)
-    expect(isParentActive('/tags', '#')).toBe(false)
+    expect(isParentActive('/knowledge', '')).toBe(false)
+    expect(isParentActive('/knowledge', '#')).toBe(false)
   })
 })
 

package/src/lib/ai/story-ai-stream.ts

@@ -17,7 +17,7 @@
 
 export type StoryAiMode = "create" | "split" | "polish"
 export type StoryAiSplitMode = "children" | "independent"
-export type StoryAiPolishAction = "expand" | "polish" | "acceptance"
+export type StoryAiPolishAction = "expand" | "polish"
 
 export interface StoryAiRequest {
   mode: StoryAiMode

package/src/lib/ai/use-selected-model.ts

@@ -26,14 +26,24 @@ const STORAGE_KEY = "chat:selectedModel"
  */
 export function useSelectedModel() {
   const [selectedModel, setSelectedModel] = useState<string>(
-    () =>
-      (typeof window !== "undefined" && localStorage.getItem(STORAGE_KEY)) ||
-      "",
+    () => {
+      // 本项目 SSR 的 Node 环境存在注入的 window（opaque origin，localStorage
+      // 访问抛 SecurityError），typeof 守卫会穿透——浏览器存储访问必须 try/catch
+      try {
+        return window.localStorage.getItem(STORAGE_KEY) ?? "";
+      } catch {
+        return "";
+      }
+    },
   )
 
   useEffect(() => {
-    if (typeof window !== "undefined" && selectedModel) {
-      localStorage.setItem(STORAGE_KEY, selectedModel)
+    try {
+      if (selectedModel) {
+        localStorage.setItem(STORAGE_KEY, selectedModel)
+      }
+    } catch {
+      // SSR/无存储环境降级：不持久化
     }
   }, [selectedModel])
 

package/src/lib/changelog/sdk-versions.ts

@@ -9,56 +9,56 @@ export const SDK_GROUPS: SdkGroup[] = [
       {
         "name": "@tanstack/react-start",
         "displayName": "TanStack Start",
-        "version": "v1.168.60",
-        "lastUpdate": "Oct 6, 2026",
+        "version": "v1.169.4",
+        "lastUpdate": "Oct 25, 2026",
         "source": "apps/web/package.json#dependencies",
         "docsUrl": "https://tanstack.com/start/latest"
       },
       {
         "name": "@tanstack/react-router",
         "displayName": "TanStack Router",
-        "version": "v1.170.41",
-        "lastUpdate": "Oct 6, 2026",
+        "version": "v1.170.46",
+        "lastUpdate": "Oct 25, 2026",
         "source": "apps/web/package.json#dependencies",
         "docsUrl": "https://tanstack.com/router/latest"
       },
       {
         "name": "@tanstack/react-query",
         "displayName": "TanStack Query",
-        "version": "v5.104.1",
-        "lastUpdate": "Oct 6, 2026",
+        "version": "v5.104.5",
+        "lastUpdate": "Oct 25, 2026",
         "source": "apps/web/package.json#dependencies",
         "docsUrl": "https://tanstack.com/query/latest"
       },
       {
         "name": "@tanstack/ai",
         "displayName": "TanStack AI",
-        "version": "v0.55.0",
-        "lastUpdate": "Sep 20, 2026",
+        "version": "v1.0.0",
+        "lastUpdate": "Oct 25, 2026",
         "source": "apps/web/package.json#dependencies",
         "docsUrl": "https://tanstack.com/ai/latest"
       },
       {
         "name": "@tanstack/react-table",
         "displayName": "TanStack Table",
-        "version": "v9.2.6",
-        "lastUpdate": "Oct 6, 2026",
+        "version": "v9.3.1",
+        "lastUpdate": "Oct 25, 2026",
         "source": "apps/web/package.json#dependencies",
         "docsUrl": "https://tanstack.com/table/latest"
       },
       {
         "name": "@tanstack/react-form",
         "displayName": "TanStack Form",
-        "version": "v2.0.0-alpha.2",
-        "lastUpdate": "Sep 11, 2026",
+        "version": "v2.0.0-alpha.3",
+        "lastUpdate": "Oct 25, 2026",
         "source": "apps/web/package.json#dependencies",
         "docsUrl": "https://tanstack.com/form/latest"
       },
       {
         "name": "@tanstack/charts",
         "displayName": "TanStack Charts",
-        "version": "v0.16.0",
-        "lastUpdate": "Sep 11, 2026",
+        "version": "v1.1.0",
+        "lastUpdate": "Oct 25, 2026",
         "source": "apps/admin/package.json#dependencies",
         "docsUrl": "https://tanstack.com/charts/latest"
       },
@@ -73,16 +73,16 @@ export const SDK_GROUPS: SdkGroup[] = [
       {
         "name": "@tanstack/react-hotkeys",
         "displayName": "TanStack Hotkeys",
-        "version": "v0.10.0",
-        "lastUpdate": "Sep 11, 2026",
+        "version": "v0.17.0",
+        "lastUpdate": "Oct 25, 2026",
         "source": "apps/web/package.json#dependencies",
         "docsUrl": "https://tanstack.com/hotkeys/latest"
       },
       {
         "name": "@tanstack/react-virtual",
         "displayName": "TanStack Virtual",
-        "version": "v3.14.13",
-        "lastUpdate": "Oct 6, 2026",
+        "version": "v3.14.22",
+        "lastUpdate": "Oct 25, 2026",
         "source": "apps/admin/package.json#dependencies",
         "docsUrl": "https://tanstack.com/virtual/latest"
       }
@@ -95,15 +95,15 @@ export const SDK_GROUPS: SdkGroup[] = [
     "items": [
       {
         "name": "@allbluecn/web-app",
-        "version": "v0.18.2",
-        "lastUpdate": "Oct 7, 2026",
+        "version": "v0.19.0",
+        "lastUpdate": "Oct 25, 2026",
         "source": "apps/web/package.json",
         "docsUrl": "https://github.com/allbluecn/allblue"
       },
       {
         "name": "@allbluecn/kernel",
-        "version": "v0.9.1",
-        "lastUpdate": "Oct 7, 2026",
+        "version": "v0.10.0",
+        "lastUpdate": "Oct 25, 2026",
         "source": "packages/kernel/package.json",
         "docsUrl": "https://github.com/allbluecn/allblue"
       }