@allbluecn/web-app 0.4.21 → 0.5.0

package/src/components/story/views/story-list/batch-toolbar.tsx

@@ -17,7 +17,7 @@
 
 import { useState } from "react";
 import { useTranslation } from "react-i18next";
-import { ArrowUp, ArrowDown, Archive, Trash2, BrushCleaning, CalendarCheck, CalendarPlus2, GitCompareArrows } from "lucide-react";
+import { ArrowUp, ArrowDown, Archive, Trash2, BrushCleaning, CalendarCheck, CalendarPlus2, GitCompareArrows, Waypoints } from "lucide-react";
 import { Checkbox } from "@/components/ui/checkbox";
 import { Button } from "@/components/ui/button";
 import { Tooltip, TooltipContent, TooltipTrigger } from "@/components/ui/tooltip";
@@ -53,6 +53,8 @@ export interface BatchToolbarProps {
   onMoveDown: () => void;
   onArchive: (storyIds: string[]) => void;
   onDelete: (storyIds: string[]) => void;
+  /** 可选：批量移除依赖关系（依赖面板传入时显示按钮；入参为需求 id） */
+  onRemoveRelations?: (storyIds: string[]) => void;
   onBulkUpdate: (patch: StoryPatch) => void;
   onClearSelection: () => void;
   onTransfer: (updatedStories?: Array<{ id: string; identifier: string; projectId: string; parentId: string | null }>) => void;
@@ -76,6 +78,7 @@ export function BatchToolbar({
   onMoveDown,
   onArchive,
   onDelete,
+  onRemoveRelations,
   onBulkUpdate,
   onClearSelection,
   onTransfer,
@@ -141,6 +144,14 @@ export function BatchToolbar({
             </Button>
           }
         />
+        {onRemoveRelations && (
+          <ToolbarIconButton
+            label={t("dependency.remove")}
+            icon={Waypoints}
+            disabled={busy}
+            onClick={() => onRemoveRelations(stories.map((s) => s.id))}
+          />
+        )}
         <ToolbarIconButton label={t("batchToolbar.archive")} icon={Archive} disabled={busy || !canArchive} onClick={() => setArchiveOpen(true)} />
         <ToolbarIconButton label={t("batchToolbar.delete")} icon={Trash2} disabled={busy} onClick={() => setDeleteOpen(true)} />
         <div className="mx-1 h-4 w-px bg-border" />

package/src/components/story/views/story-list/index.tsx

@@ -36,8 +36,9 @@ import { StoryListRow } from "./row";
 import { BatchToolbar } from "./batch-toolbar";
 import { computeMove, canMove } from "./move";
 import { computeGroupCheckState, toggleGroupSelection } from "./group-select";
-import { GROUP_FIELD, toGroupFieldPatch, type GroupField } from "../../display/group-fields";
+import { GROUP_FIELD, toGroupFieldPatch, type GroupField, type StoryPatch } from "../../display/group-fields";
 import type { GroupKey } from "../../display/types";
+import { WavePhysicsLoader } from "@/components/shared/wave-physics-loader";
 
 const HEADER_ROW_HEIGHT = 36;
 const STORY_ROW_HEIGHT = 44;
@@ -45,11 +46,15 @@ const OVERSCAN = 8;
 
 interface StoryListProps {
   groups: PagedGroupNode[];
+  /** 首屏加载中：显示骨架行而非「暂无需求」空态，避免加载期间闪烁空态文案 */
+  isLoading?: boolean;
   displayFilters: DisplayOptions;
   users: UserBrief[];
   labels: { id: string; name: string; color: string }[];
   projects: { id: string; name: string; displayId?: string | null; icon: string }[];
   onRefresh: () => void;
+  /** 行内编辑乐观原地更新（替代整表 refresh，保持未触发规则的行位置不变） */
+  onPatchStory: (storyId: string, patch: StoryPatch) => void;
   onOpenStory: (id: string) => void;
   onCreate?: (startDate?: string, state?: string) => void;
   onLoadMoreGroup?: (groupKey: string, subKey?: string) => void;
@@ -57,7 +62,7 @@ interface StoryListProps {
   projectId?: string;
 }
 
-export function StoryList({ groups, displayFilters, users, labels, projects, onRefresh, onOpenStory, onCreate, onLoadMoreGroup, projectContext, projectId }: StoryListProps) {
+export function StoryList({ groups, isLoading = false, displayFilters, users, labels, projects, onRefresh, onPatchStory, onOpenStory, onCreate, onLoadMoreGroup, projectContext, projectId }: StoryListProps) {
   const { t } = useTranslation("story");
   const [collapsed, setCollapsed] = useState<Record<string, boolean>>({});
   const { groupBy, subGroupBy, properties } = displayFilters;
@@ -399,8 +404,8 @@ await bulkUpdateStoriesFn({ data: { storyIds: [...selectedIds], patch } });
              labels={labels}
              properties={properties}
              onOpenStory={onOpenStory}
-             onRefresh={onRefresh}
-             selected={selectedIds.has(row.story.id)}
+              onPatchStory={onPatchStory}
+              selected={selectedIds.has(row.story.id)}
              onToggle={toggleStory}
            />
         </div>
@@ -439,7 +444,13 @@ await bulkUpdateStoriesFn({ data: { storyIds: [...selectedIds], patch } });
         <div style={{ height: totalHeight, position: "relative" }}>
           {virtualRows.map((virtualRow) => renderVirtualRow(virtualRow))}
         </div>
-        {groups.length === 0 && (
+        {isLoading && groups.length === 0 && (
+          <div className="flex flex-col items-center gap-3 py-12" aria-busy="true">
+            <WavePhysicsLoader />
+            <p className="text-sm text-muted-foreground">{t("group.loadingData")}</p>
+          </div>
+        )}
+        {!isLoading && groups.length === 0 && (
           <div className="flex h-40 items-center justify-center text-sm text-muted-foreground">
             {t("table.empty")}
           </div>

package/src/components/story/views/story-list/row.tsx

@@ -39,12 +39,13 @@ interface StoryListRowProps {
   labels: { id: string; name: string; color: string }[];
   properties: DisplayProperty[];
   onOpenStory: (id: string) => void;
-  onRefresh: () => void;
+  /** 行内编辑保存成功后的乐观原地更新回调（未触发分组/排序规则时保持位置不变） */
+  onPatchStory: (storyId: string, patch: StoryPatch) => void;
   selected: boolean;
   onToggle: (id: string) => void;
 }
 
-export const StoryListRow = memo(function StoryListRow({ story, group, indent, isChild, users, labels, properties, onOpenStory, onRefresh, selected, onToggle }: StoryListRowProps) {
+export const StoryListRow = memo(function StoryListRow({ story, group, indent, isChild, users, labels, properties, onOpenStory, onPatchStory, selected, onToggle }: StoryListRowProps) {
   const { t } = useTranslation("story");
   const updateStory = useServerFn(updateStoryFn);
 
@@ -52,12 +53,12 @@ export const StoryListRow = memo(function StoryListRow({ story, group, indent, i
     async (patch: StoryPatch) => {
       try {
         await updateStory({ data: { storyId: story.id, ...patch } });
-        onRefresh();
+        onPatchStory(story.id, patch);
       } catch (e) {
         toast.error((e as Error)?.message || t("row.updateFailed"));
       }
     },
-    [story.id, updateStory, onRefresh, t],
+    [story.id, updateStory, onPatchStory, t],
   );
 
   const setPriority = useCallback((v: StoryPriority) => updateField({ priority: v }), [updateField]);

package/src/components/ui/separator.tsx

@@ -34,7 +34,7 @@ function Separator({
       decorative={decorative}
       orientation={orientation}
       className={cn(
-        "shrink-0 bg-border data-horizontal:h-px data-horizontal:w-full data-vertical:w-px data-vertical:self-stretch",
+        "shrink-0 bg-border data-[orientation=horizontal]:h-px data-[orientation=horizontal]:w-full data-[orientation=vertical]:h-full data-[orientation=vertical]:w-px",
         className
       )}
       {...props}

package/src/hooks/use-notifications.ts

@@ -8,7 +8,9 @@ import type { NotificationSseValue, NotificationItem } from '@allbluecn/shared'
 import { isInDndWindow } from '@allbluecn/shared'
 import { getUnreadCountFn, getNotificationPreferencesFn } from '@/server/serverFns/notifications'
 
+export const NOTIFICATION_ROOT_KEY = ['notifications'] as const
 export const NOTIFICATION_LIST_KEY = ['notifications', 'list'] as const
+export const NOTIFICATION_POPOVER_KEY = ['notifications', 'popover'] as const
 export const NOTIFICATION_UNREAD_KEY = ['notifications', 'unread'] as const
 export const NOTIFICATION_PREFERENCES_KEY = ['notifications', 'preferences'] as const
 
@@ -92,7 +94,8 @@ export function useNotifications(options?: { toastEnabled?: boolean }) {
           const count = (old as { count?: number } | undefined)?.count ?? 0
           return { count: count + 1 }
         })
-        queryClient.invalidateQueries({ queryKey: NOTIFICATION_LIST_KEY })
+        // 通知到达：所有通知相关查询（列表/详情页分页/popover）标记过期
+        queryClient.invalidateQueries({ queryKey: NOTIFICATION_ROOT_KEY })
         if (toastEnabled) {
           const prefs = queryClient.getQueryData<{ dndEnabled: boolean; dndStart: string; dndEnd: string }>(NOTIFICATION_PREFERENCES_KEY)
           const now = new Date()

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

@@ -16,7 +16,7 @@
 // along with this program. If not, see <https://www.gnu.org/licenses/>.
 
 import { describe, it, expect } from 'vitest'
-import { formatDate, formatRelative, resolveTimezone } from '../datetime'
+import { formatDate, formatRelative, resolveTimezone, formatTimestamp } from '../datetime'
 
 describe('resolveTimezone', () => {
   it('项目时区优先', () => {
@@ -71,4 +71,19 @@ describe('formatRelative', () => {
     const result = formatRelative(date, 'Asia/Shanghai', now)
     expect(result).toMatch(/2026-06-01/)
   })
+})
+
+describe('formatTimestamp', () => {
+  it('固定 Asia/Shanghai 输出，与运行环境 locale/时区无关', () => {
+    expect(formatTimestamp('2026-07-31T08:00:00.000Z')).toBe('2026-07-31 16:00')
+  })
+  it('接受 Date 对象', () => {
+    expect(formatTimestamp(new Date('2026-07-31T08:00:00.000Z'))).toBe('2026-07-31 16:00')
+  })
+  it('自定义格式（监控历史秒级精度）', () => {
+    expect(formatTimestamp('2026-07-31T08:00:05.000Z', 'yyyy-MM-dd HH:mm:ss')).toBe('2026-07-31 16:00:05')
+  })
+  it('无效输入返回占位符不抛错', () => {
+    expect(formatTimestamp('not-a-date')).toBe('-')
+  })
 })

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

@@ -24,10 +24,13 @@ const mockChunkText = vi.hoisted(() => vi.fn((text: string) => {
 }))
 const mockInsertEmbedding = vi.hoisted(() => vi.fn())
 const mockSearchByVector = vi.hoisted(() => vi.fn())
+const mockRerankCandidates = vi.hoisted(() => vi.fn().mockResolvedValue(null))
 
 vi.mock('@allbluecn/ai-gateway', () => ({
   generateEmbedding: mockGenerateEmbedding,
   chunkText: mockChunkText,
+  rerankCandidates: mockRerankCandidates,
+  RECALL_MULTIPLIER: 4,
 }))
 
 vi.mock('@/lib/pgvector', () => ({
@@ -89,12 +92,44 @@ describe('ragSearch', () => {
     expect(results).toHaveLength(1)
   })
 
-  it('passes custom table and limit', async () => {
+  it('passes custom table and widens recall by RECALL_MULTIPLIER for rerank', async () => {
     mockSearchByVector.mockResolvedValue([])
 
     await ragSearch('q', 'plugin_embeddings', 3)
 
     expect(mockSearchByVector.mock.calls[0][1]).toBe('plugin_embeddings')
-    expect(mockSearchByVector.mock.calls[0][2]).toBe(3)
+    expect(mockSearchByVector.mock.calls[0][2]).toBe(12)
+  })
+
+  it('falls back to vector order when rerank is unavailable', async () => {
+    mockRerankCandidates.mockResolvedValue(null)
+    mockSearchByVector.mockResolvedValue([
+      { id: '1', content: 'a', similarity: 0.9 },
+      { id: '2', content: 'b', similarity: 0.8 },
+    ])
+
+    const results = await ragSearch('q', 't', 10)
+
+    expect(mockRerankCandidates).toHaveBeenCalledWith('q', [
+      { id: '1', content: 'a', similarity: 0.9 },
+      { id: '2', content: 'b', similarity: 0.8 },
+    ], 10, undefined)
+    expect(results.map(r => r.id)).toEqual(['1', '2'])
+  })
+
+  it('uses reranked order and truncates to limit', async () => {
+    mockSearchByVector.mockResolvedValue([
+      { id: '1', content: 'a', similarity: 0.9 },
+      { id: '2', content: 'b', similarity: 0.8 },
+      { id: '3', content: 'c', similarity: 0.7 },
+    ])
+    mockRerankCandidates.mockResolvedValue([
+      { id: '3', content: 'c', similarity: 0.7 },
+      { id: '1', content: 'a', similarity: 0.9 },
+    ])
+
+    const results = await ragSearch('q', 't', 2)
+
+    expect(results.map(r => r.id)).toEqual(['3', '1'])
   })
 })

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

@@ -9,64 +9,64 @@ export const SDK_GROUPS: SdkGroup[] = [
       {
         "name": "@tanstack/react-start",
         "displayName": "TanStack Start",
-        "version": "v1.168.46",
-        "lastUpdate": "Aug 28, 2026",
+        "version": "v1.168.49",
+        "lastUpdate": "Aug 31, 2026",
         "source": "apps/web/package.json#dependencies",
         "docsUrl": "https://tanstack.com/start/latest"
       },
       {
         "name": "@tanstack/react-router",
         "displayName": "TanStack Router",
-        "version": "v1.170.29",
-        "lastUpdate": "Aug 28, 2026",
+        "version": "v1.170.32",
+        "lastUpdate": "Aug 31, 2026",
         "source": "apps/web/package.json#dependencies",
         "docsUrl": "https://tanstack.com/router/latest"
       },
       {
         "name": "@tanstack/react-query",
         "displayName": "TanStack Query",
-        "version": "v5.101.2",
-        "lastUpdate": "Aug 28, 2026",
+        "version": "v5.102.8",
+        "lastUpdate": "Aug 31, 2026",
         "source": "apps/web/package.json#dependencies",
         "docsUrl": "https://tanstack.com/query/latest"
       },
       {
         "name": "@tanstack/ai",
         "displayName": "TanStack AI",
-        "version": "v0.43.0",
-        "lastUpdate": "Aug 28, 2026",
+        "version": "v0.52.0",
+        "lastUpdate": "Aug 31, 2026",
         "source": "apps/web/package.json#dependencies",
         "docsUrl": "https://tanstack.com/ai/latest"
       },
       {
         "name": "@tanstack/react-table",
         "displayName": "TanStack Table",
-        "version": "v9.1.0",
-        "lastUpdate": "Aug 28, 2026",
+        "version": "v9.2.3",
+        "lastUpdate": "Aug 31, 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.0",
-        "lastUpdate": "Aug 28, 2026",
+        "version": "v2.0.0-alpha.2",
+        "lastUpdate": "Aug 31, 2026",
         "source": "apps/web/package.json#dependencies",
         "docsUrl": "https://tanstack.com/form/latest"
       },
       {
         "name": "@tanstack/charts",
         "displayName": "TanStack Charts",
-        "version": "v0.9.0",
-        "lastUpdate": "Aug 28, 2026",
+        "version": "v0.16.0",
+        "lastUpdate": "Aug 31, 2026",
         "source": "apps/admin/package.json#dependencies",
         "docsUrl": "https://tanstack.com/charts/latest"
       },
       {
         "name": "@tanstack/react-pacer",
         "displayName": "TanStack Pacer",
-        "version": "v0.22.1",
-        "lastUpdate": "Aug 28, 2026",
+        "version": "v0.23.0",
+        "lastUpdate": "Aug 31, 2026",
         "source": "apps/web/package.json#dependencies",
         "docsUrl": "https://tanstack.com/pacer/latest"
       },
@@ -74,15 +74,15 @@ export const SDK_GROUPS: SdkGroup[] = [
         "name": "@tanstack/react-hotkeys",
         "displayName": "TanStack Hotkeys",
         "version": "v0.10.0",
-        "lastUpdate": "Aug 28, 2026",
+        "lastUpdate": "Aug 31, 2026",
         "source": "apps/web/package.json#dependencies",
         "docsUrl": "https://tanstack.com/hotkeys/latest"
       },
       {
         "name": "@tanstack/react-virtual",
         "displayName": "TanStack Virtual",
-        "version": "v3.14.9",
-        "lastUpdate": "Aug 28, 2026",
+        "version": "v3.14.10",
+        "lastUpdate": "Aug 31, 2026",
         "source": "apps/admin/package.json#dependencies",
         "docsUrl": "https://tanstack.com/virtual/latest"
       }
@@ -91,19 +91,19 @@ export const SDK_GROUPS: SdkGroup[] = [
   {
     "id": "allblue",
     "label": "allblue-sdk",
-    "icon": "🔷",
+    "icon": "📦",
     "items": [
       {
         "name": "@allbluecn/web-app",
-        "version": "v0.4.21",
-        "lastUpdate": "Aug 28, 2026",
+        "version": "v0.5.0",
+        "lastUpdate": "Aug 31, 2026",
         "source": "apps/web/package.json",
         "docsUrl": "https://github.com/allbluecn/allblue"
       },
       {
         "name": "@allbluecn/kernel",
-        "version": "v0.3.0",
-        "lastUpdate": "Aug 28, 2026",
+        "version": "v0.3.1",
+        "lastUpdate": "Aug 31, 2026",
         "source": "packages/kernel/package.json",
         "docsUrl": "https://github.com/allbluecn/allblue"
       }
@@ -117,42 +117,42 @@ export const SDK_GROUPS: SdkGroup[] = [
       {
         "name": "Vite",
         "version": "v8.1.5",
-        "lastUpdate": "Aug 28, 2026",
+        "lastUpdate": "Aug 31, 2026",
         "source": "apps/web/package.json#devDependencies",
         "docsUrl": "https://vite.dev/"
       },
       {
         "name": "Node.js",
         "version": "v24.19.0",
-        "lastUpdate": "Aug 28, 2026",
+        "lastUpdate": "Aug 31, 2026",
         "source": ".nvmrc",
         "docsUrl": "https://nodejs.org/"
       },
       {
         "name": "Prisma",
         "version": "v7.8.0",
-        "lastUpdate": "Aug 28, 2026",
+        "lastUpdate": "Aug 31, 2026",
         "source": "packages/database/package.json#devDependencies",
         "docsUrl": "https://www.prisma.io/docs"
       },
       {
         "name": "shadcn UI",
         "version": "v1.2.4",
-        "lastUpdate": "Aug 28, 2026",
+        "lastUpdate": "Aug 31, 2026",
         "source": "apps/web/package.json#dependencies",
         "docsUrl": "https://ui.shadcn.com/"
       },
       {
         "name": "TipTap",
         "version": "v3.27.4",
-        "lastUpdate": "Aug 28, 2026",
+        "lastUpdate": "Aug 31, 2026",
         "source": "packages/shared/package.json#devDependencies",
         "docsUrl": "https://tiptap.dev/"
       },
       {
         "name": "Lucide React",
         "version": "v1.24.0",
-        "lastUpdate": "Aug 28, 2026",
+        "lastUpdate": "Aug 31, 2026",
         "source": "packages/ui/package.json#dependencies",
         "docsUrl": "https://lucide.dev/"
       }

package/src/lib/commands/registry.ts

@@ -38,7 +38,7 @@ export const COMMAND_REGISTRY: CommandDefinition[] = [
   { id: "create-prd", titleKey: "command.createPrd", icon: "file", group: "action", action: { kind: "callback", id: "create-prd" }, keywords: ["新建", "创建", "PRD", "xj"], shortcut: ["N", "P"] },
   { id: "create-conversation", titleKey: "command.createConversation", icon: "message", group: "action", action: { kind: "callback", id: "create-conversation" }, keywords: ["新建对话", "新对话", "xjdh"], shortcut: ["N", "C"] },
   { id: "create-story", titleKey: "command.createStory", icon: "clipboardList", group: "action", action: { kind: "callback", id: "create-story" }, keywords: ["新建需求", "xjxq"], shortcut: ["N", "S"] },
-  { id: "toggle-theme", titleKey: "command.toggleTheme", icon: "sunMoon", group: "action", action: { kind: "callback", id: "toggle-theme" }, keywords: ["切换主题", "暗黑", "主题", "qhzt"], shortcut: ["Mod", "Shift", "L"] },
+  { id: "toggle-theme", titleKey: "command.toggleTheme", icon: "sunMoon", group: "action", action: { kind: "callback", id: "toggle-theme" }, keywords: ["切换主题", "暗黑", "主题", "qhzt"], chord: ["Mod", "Shift", "L"] },
   { id: "sign-out", titleKey: "command.signOut", icon: "logOut", group: "action", action: { kind: "callback", id: "sign-out" }, keywords: ["退出登录", "登出", "tcdl"] },
 ] as const
 

package/src/lib/commands/types.ts

@@ -28,5 +28,8 @@ export interface CommandDefinition {
   group: CommandGroup
   action: CommandAction
   keywords?: string[]
+  /** 序列键（如 ["G","D"]），注册为 useHotkeySequences */
   shortcut?: string[]
+  /** 组合键（如 ["Mod","Shift","L"]），仅用于面板展示 */
+  chord?: string[]
 }

package/src/lib/datetime.ts

@@ -3,4 +3,5 @@ export {
   formatDate,
   formatChatDate,
   formatRelative,
+  formatTimestamp,
 } from '@allbluecn/shared/lib/datetime'

package/src/lib/rag.ts

@@ -15,7 +15,12 @@
 // 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 { generateEmbedding, chunkText } from "@allbluecn/ai-gateway"
+import {
+  generateEmbedding,
+  chunkText,
+  rerankCandidates,
+  RECALL_MULTIPLIER,
+} from "@allbluecn/ai-gateway"
 import { insertEmbedding, searchByVector } from "./pgvector"
 
 export async function indexDocument(
@@ -43,5 +48,7 @@ export async function ragSearch(
   whereValue?: string
 ): Promise<{ id: string; content: string; similarity: number }[]> {
   const embedding = await generateEmbedding(query, aiOpts)
-  return searchByVector(embedding, table, limit, whereColumn, whereValue)
+  const rows = await searchByVector(embedding, table, limit * RECALL_MULTIPLIER, whereColumn, whereValue)
+  const reranked = await rerankCandidates(query, rows, limit, aiOpts)
+  return (reranked ?? rows).slice(0, limit)
 }

package/src/routeTree.gen.ts

@@ -31,6 +31,7 @@ import { Route as NavDashboardRouteRouteImport } from './routes/_nav/dashboard/r
 import { Route as NavDesignRouteRouteImport } from './routes/_nav/design/route'
 import { Route as NavInspirationRouteRouteImport } from './routes/_nav/inspiration/route'
 import { Route as NavKnowledgeRouteRouteImport } from './routes/_nav/knowledge/route'
+import { Route as NavNotificationsRouteRouteImport } from './routes/_nav/notifications/route'
 import { Route as NavNotionLikeRouteRouteImport } from './routes/_nav/notion-like/route'
 import { Route as NavPrdRouteRouteImport } from './routes/_nav/prd/route'
 import { Route as NavPricing02RouteRouteImport } from './routes/_nav/pricing-02/route'
@@ -259,6 +260,13 @@ const NavKnowledgeRouteRoute = NavKnowledgeRouteRouteImport.update({
   path: '/knowledge',
   getParentRoute: () => NavRouteRoute,
 } as any)
+const NavNotificationsRouteRoute = NavNotificationsRouteRouteImport.update({
+  id: '/notifications',
+  path: '/notifications',
+  getParentRoute: () => NavRouteRoute,
+} as any).lazy(() =>
+  import('./routes/_nav/notifications/route.lazy').then((d) => d.Route),
+)
 const NavNotionLikeRouteRoute = NavNotionLikeRouteRouteImport.update({
   id: '/notion-like',
   path: '/notion-like',
@@ -841,6 +849,7 @@ export interface FileRoutesByFullPath {
   '/design': typeof NavDesignRouteRouteWithChildren
   '/inspiration': typeof NavInspirationRouteRoute
   '/knowledge': typeof NavKnowledgeRouteRouteWithChildren
+  '/notifications': typeof NavNotificationsRouteRoute
   '/notion-like': typeof NavNotionLikeRouteRoute
   '/prd': typeof NavPrdRouteRouteWithChildren
   '/pricing-02': typeof NavPricing02RouteRoute
@@ -942,6 +951,7 @@ export interface FileRoutesByTo {
   '/chat': typeof NavChatRouteRouteWithChildren
   '/dashboard': typeof NavDashboardRouteRoute
   '/inspiration': typeof NavInspirationRouteRoute
+  '/notifications': typeof NavNotificationsRouteRoute
   '/notion-like': typeof NavNotionLikeRouteRoute
   '/pricing-02': typeof NavPricing02RouteRoute
   '/projects': typeof NavProjectsRouteRouteWithChildren
@@ -1037,6 +1047,7 @@ export interface FileRoutesById {
   '/_nav/design': typeof NavDesignRouteRouteWithChildren
   '/_nav/inspiration': typeof NavInspirationRouteRoute
   '/_nav/knowledge': typeof NavKnowledgeRouteRouteWithChildren
+  '/_nav/notifications': typeof NavNotificationsRouteRoute
   '/_nav/notion-like': typeof NavNotionLikeRouteRoute
   '/_nav/prd': typeof NavPrdRouteRouteWithChildren
   '/_nav/pricing-02': typeof NavPricing02RouteRoute
@@ -1142,6 +1153,7 @@ export interface FileRouteTypes {
     | '/design'
     | '/inspiration'
     | '/knowledge'
+    | '/notifications'
     | '/notion-like'
     | '/prd'
     | '/pricing-02'
@@ -1243,6 +1255,7 @@ export interface FileRouteTypes {
     | '/chat'
     | '/dashboard'
     | '/inspiration'
+    | '/notifications'
     | '/notion-like'
     | '/pricing-02'
     | '/projects'
@@ -1337,6 +1350,7 @@ export interface FileRouteTypes {
     | '/_nav/design'
     | '/_nav/inspiration'
     | '/_nav/knowledge'
+    | '/_nav/notifications'
     | '/_nav/notion-like'
     | '/_nav/prd'
     | '/_nav/pricing-02'
@@ -1590,6 +1604,13 @@ declare module '@tanstack/react-router' {
       preLoaderRoute: typeof NavKnowledgeRouteRouteImport
       parentRoute: typeof NavRouteRoute
     }
+    '/_nav/notifications': {
+      id: '/_nav/notifications'
+      path: '/notifications'
+      fullPath: '/notifications'
+      preLoaderRoute: typeof NavNotificationsRouteRouteImport
+      parentRoute: typeof NavRouteRoute
+    }
     '/_nav/notion-like': {
       id: '/_nav/notion-like'
       path: '/notion-like'
@@ -2543,6 +2564,7 @@ interface NavRouteRouteChildren {
   NavDesignRouteRoute: typeof NavDesignRouteRouteWithChildren
   NavInspirationRouteRoute: typeof NavInspirationRouteRoute
   NavKnowledgeRouteRoute: typeof NavKnowledgeRouteRouteWithChildren
+  NavNotificationsRouteRoute: typeof NavNotificationsRouteRoute
   NavNotionLikeRouteRoute: typeof NavNotionLikeRouteRoute
   NavPrdRouteRoute: typeof NavPrdRouteRouteWithChildren
   NavPricing02RouteRoute: typeof NavPricing02RouteRoute
@@ -2565,6 +2587,7 @@ const NavRouteRouteChildren: NavRouteRouteChildren = {
   NavDesignRouteRoute: NavDesignRouteRouteWithChildren,
   NavInspirationRouteRoute: NavInspirationRouteRoute,
   NavKnowledgeRouteRoute: NavKnowledgeRouteRouteWithChildren,
+  NavNotificationsRouteRoute: NavNotificationsRouteRoute,
   NavNotionLikeRouteRoute: NavNotionLikeRouteRoute,
   NavPrdRouteRoute: NavPrdRouteRouteWithChildren,
   NavPricing02RouteRoute: NavPricing02RouteRoute,

package/src/routes/_nav/notifications/route.lazy.tsx

@@ -0,0 +1,22 @@
+// SPDX-License-Identifier: AGPL-3.0-or-later
+
+import { createLazyFileRoute } from '@tanstack/react-router'
+import { useTranslation } from 'react-i18next'
+import { TeamNotificationsPanel } from '@/components/notifications/team-notifications'
+
+export const Route = createLazyFileRoute('/_nav/notifications')({
+  component: NotificationsPage,
+})
+
+function NotificationsPage() {
+  const { t } = useTranslation('notifications')
+  return (
+    <div className="flex h-full flex-col gap-6 overflow-hidden p-6">
+      <div className="flex shrink-0 flex-col gap-1">
+        <h1 className="text-xl font-semibold">{t('title')}</h1>
+        <p className="text-sm text-muted-foreground">{t('description')}</p>
+      </div>
+      <TeamNotificationsPanel />
+    </div>
+  )
+}

package/src/routes/_nav/notifications/route.tsx

@@ -0,0 +1,30 @@
+// SPDX-License-Identifier: AGPL-3.0-or-later
+
+import { createFileRoute } from '@tanstack/react-router'
+import type { NotificationListResult } from '@allbluecn/shared'
+import { NOTIFICATION_LIST_KEY, NOTIFICATION_UNREAD_KEY } from '@/hooks/use-notifications'
+import { getUnreadCountFn, listNotificationsFn } from '@/server/serverFns/notifications'
+
+export const Route = createFileRoute('/_nav/notifications')({
+  loader: async ({ context }) => {
+    const { queryClient } = context
+    // SSR 预取未读数 + 列表第一页，保证服务端与客户端 hydrate 首帧渲染一致
+    // （否则 SSR 渲染空态、客户端首帧已有数据 → hydration mismatch 整树重渲染）
+    await Promise.all([
+      queryClient.ensureQueryData({
+        queryKey: NOTIFICATION_UNREAD_KEY,
+        queryFn: () => getUnreadCountFn({ data: {} }),
+      }),
+      queryClient.fetchInfiniteQuery({
+        queryKey: [...NOTIFICATION_LIST_KEY, undefined],
+        queryFn: ({ pageParam }) =>
+          listNotificationsFn({ data: pageParam ? { cursor: pageParam } : {} }),
+        initialPageParam: undefined as string | undefined,
+        getNextPageParam: (lastPage: NotificationListResult) =>
+          lastPage.hasMore ? lastPage.items[lastPage.items.length - 1].id : undefined,
+      }),
+    ]).catch(() => {
+      // 预取失败降级为客户端 fetch（与旧行为一致），不阻塞页面
+    })
+  },
+})