@allbluecn/web-app 0.4.21 → 0.4.22

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@allbluecn/web-app",
-  "version": "0.4.21",
+  "version": "0.4.22",
   "license": "AGPL-3.0-or-later",
   "type": "module",
   "files": [
@@ -34,31 +34,24 @@
     "@radix-ui/react-popover": "^1.1.15",
     "@radix-ui/react-slot": "^1.2.4",
     "@radix-ui/react-visually-hidden": "^1.2.11",
-    "@tanstack/ai": "^0.43.0",
-    "@tanstack/ai-anthropic": "^0.16.3",
-    "@tanstack/ai-gemini": "^0.20.1",
-    "@tanstack/ai-grok": "^0.14.9",
-    "@tanstack/ai-groq": "^0.5.3",
-    "@tanstack/ai-ollama": "^0.8.16",
-    "@tanstack/ai-openai": "^0.17.1",
-    "@tanstack/ai-openrouter": "^0.15.10",
-    "@tanstack/ai-persistence": "^0.1.0",
-    "@tanstack/ai-react": "^0.18.1",
-    "@tanstack/db": "0.6.17",
+    "@tanstack/ai": "^0.52.0",
+    "@tanstack/ai-persistence": "^0.5.4",
+    "@tanstack/ai-react": "^0.22.4",
+    "@tanstack/db": "0.8.6",
     "@tanstack/hotkeys": "^0.8.0",
-    "@tanstack/pacer": "^0.21.1",
-    "@tanstack/query-db-collection": "1.2.1",
-    "@tanstack/react-db": "0.1.95",
-    "@tanstack/react-form": "2.0.0-alpha.0",
+    "@tanstack/pacer": "^0.22.0",
+    "@tanstack/query-db-collection": "1.2.11",
+    "@tanstack/react-db": "0.3.6",
+    "@tanstack/react-form": "2.0.0-alpha.2",
     "@tanstack/react-hotkeys": "^0.10.0",
-    "@tanstack/react-pacer": "^0.22.1",
-    "@tanstack/react-query": "^5.101.2",
-    "@tanstack/react-router": "1.170.29",
-    "@tanstack/react-router-ssr-query": "^1.167.1",
-    "@tanstack/react-start": "^1.168.46",
-    "@tanstack/react-store": "^0.11.0",
-    "@tanstack/react-table": "^9.1.0",
-    "@tanstack/react-virtual": "^3.14.9",
+    "@tanstack/react-pacer": "^0.23.0",
+    "@tanstack/react-query": "^5.102.8",
+    "@tanstack/react-router": "1.170.32",
+    "@tanstack/react-router-ssr-query": "^1.167.2",
+    "@tanstack/react-start": "^1.168.49",
+    "@tanstack/react-store": "^0.11.1",
+    "@tanstack/react-table": "^9.2.3",
+    "@tanstack/react-virtual": "^3.14.10",
     "@tanstack/store": "^0.11.1",
     "@tiptap/core": "^3.27.4",
     "@tiptap/extension-code-block-lowlight": "^3.27.4",
@@ -115,7 +108,6 @@
     "next-themes": "^0.4.6",
     "nitro": "3.0.260603-beta",
     "ogl": "^1.0.11",
-    "openai": "^6.39.1",
     "prisma": "^7.8.0",
     "radix-ui": "^1.4.3",
     "react": "19.2.4",
@@ -135,14 +127,14 @@
     "three": "^0.180.0",
     "tw-animate-css": "^1.4.0",
     "zod": "^4.4.3",
-    "@allbluecn/ai-gateway": "0.4.14",
-    "@allbluecn/kernel": "0.3.0",
     "@allbluecn/database": "0.4.14",
-    "@allbluecn/plugins-core": "0.4.13",
-    "@allbluecn/prototype": "0.1.1",
-    "@allbluecn/tiptap": "0.4.13",
-    "@allbluecn/ui": "0.4.14",
-    "@allbluecn/shared": "0.4.14"
+    "@allbluecn/kernel": "0.3.1",
+    "@allbluecn/shared": "0.4.15",
+    "@allbluecn/ai-gateway": "0.4.15",
+    "@allbluecn/tiptap": "0.4.15",
+    "@allbluecn/ui": "0.4.15",
+    "@allbluecn/plugins-core": "0.4.14",
+    "@allbluecn/prototype": "0.1.1"
   },
   "devDependencies": {
     "@babel/parser": "^8.0.4",
@@ -152,7 +144,7 @@
     "@playwright/mcp": "^0.0.75",
     "@playwright/test": "^1.60.0",
     "@tailwindcss/vite": "^4.3.2",
-    "@tanstack/react-query-devtools": "5.101.4",
+    "@tanstack/react-query-devtools": "5.102.8",
     "@tanstack/react-router-devtools": "1.167.1",
     "@testing-library/jest-dom": "^6.9.1",
     "@testing-library/react": "^16.3.2",

package/src/components/command/command-palette.tsx

@@ -195,7 +195,7 @@ function CommandPaletteList({
         key={cmd.id}
         index={idx}
         onSelect={() => onRun(cmd)}
-        shortcut={cmd.shortcut ? resolveShortcut(cmd.shortcut) : undefined}
+        shortcut={cmd.shortcut ?? cmd.chord ? resolveShortcut(cmd.shortcut ?? cmd.chord!) : undefined}
         icon={Icon && <Icon className="size-4 shrink-0" />}
       >
         <span className="truncate">{cmd.title}</span>

package/src/components/knowledge/knowledge-toolbar.tsx

@@ -17,7 +17,7 @@
 
 import { useState, useEffect, useRef } from 'react'
 import { useNavigate } from '@tanstack/react-router'
-import { Settings, Globe, Lock, Trash2, Columns2, Minimize2, ArrowLeftRight, Maximize2, FileText, Grid3X3, Network, Table, PanelLeftOpen, PanelLeftClose, Plus, Check, ListIndentIncrease, ListIndentDecrease, Pencil } from 'lucide-react'
+import { Settings, Globe, Lock, Trash2, RefreshCw, Columns2, Minimize2, ArrowLeftRight, Maximize2, FileText, Grid3X3, Network, Table, PanelLeftOpen, PanelLeftClose, Plus, Check, ListIndentIncrease, ListIndentDecrease, Pencil } from 'lucide-react'
 import { Input } from '@/components/ui/input'
 import { Badge } from '@/components/ui/badge'
 import {
@@ -67,6 +67,8 @@ import { KnowledgeTagInput } from './knowledge-tag-input'
 import { useEditorWidth } from './editor/editor-width-context'
 import type { EditorWidth } from './editor/editor-width-context'
 import { deleteKnowledgeFn, updateKnowledgeFn } from '@/server/serverFns/knowledge'
+import { reindexKnowledgeBaseFn } from '@/server/serverFns/knowledge-index'
+import { toast } from '@/components/ui/sonner'
 import { KnowledgeFormDialog } from '@/components/knowledge/dialog/knowledge-form-dialog'
 import { cn } from '@/lib/utils'
 import { useTranslation } from 'react-i18next'
@@ -109,6 +111,7 @@ export function KnowledgeToolbar({ kb, onUpdate, breadcrumb, docType, treeCollap
   const [deleteConfirm, setDeleteConfirm] = useState('')
   const [editOpen, setEditOpen] = useState(false)
   const [deleting, setDeleting] = useState(false)
+  const [reindexing, setReindexing] = useState(false)
   const { effectiveWidth, setWidth } = useEditorWidth()
   const [createPopover, setCreatePopover] = useState(false)
   const [createType, setCreateType] = useState('doc')
@@ -166,6 +169,21 @@ export function KnowledgeToolbar({ kb, onUpdate, breadcrumb, docType, treeCollap
     setDeleting(false)
   }
 
+  const handleReindex = async () => {
+    setReindexing(true)
+    try {
+      const { indexed, documentCount } = await reindexKnowledgeBaseFn({ data: { kbId: kb.id } })
+      if (documentCount === 0) {
+        toast.success(t('toolbar.noDocs'))
+      } else {
+        toast.success(t('toolbar.reindexDone', { indexed, documentCount }))
+      }
+    } catch (e) {
+      toast.error(`${t('toolbar.reindexFailed')}：${e instanceof Error ? e.message : String(e)}`)
+    }
+    setReindexing(false)
+  }
+
   return (
     <div className="flex items-center gap-4 px-4 py-2 border-b bg-background shrink-0">
       <Button variant="ghost" size="icon" className="size-7 shrink-0" onClick={onToggleTree}>
@@ -466,6 +484,16 @@ export function KnowledgeToolbar({ kb, onUpdate, breadcrumb, docType, treeCollap
             </DropdownMenuSub>
 
 
+            <DropdownMenuSeparator />
+
+            <DropdownMenuItem
+              onSelect={(e) => { e.preventDefault(); if (!reindexing) handleReindex() }}
+              disabled={reindexing}
+            >
+              <RefreshCw className={`size-3.5 mr-2 ${reindexing ? 'animate-spin' : ''}`} />
+              {reindexing ? t('toolbar.reindexing') : t('toolbar.rebuildIndex')}
+            </DropdownMenuItem>
+
             <DropdownMenuSeparator />
 
             <DropdownMenuItem

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 29, 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 29, 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 29, 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 29, 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 29, 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 29, 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 29, 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 29, 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 29, 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 29, 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.4.22",
+        "lastUpdate": "Aug 29, 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 29, 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 29, 2026",
         "source": "apps/web/package.json#devDependencies",
         "docsUrl": "https://vite.dev/"
       },
       {
         "name": "Node.js",
         "version": "v24.19.0",
-        "lastUpdate": "Aug 28, 2026",
+        "lastUpdate": "Aug 29, 2026",
         "source": ".nvmrc",
         "docsUrl": "https://nodejs.org/"
       },
       {
         "name": "Prisma",
         "version": "v7.8.0",
-        "lastUpdate": "Aug 28, 2026",
+        "lastUpdate": "Aug 29, 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 29, 2026",
         "source": "apps/web/package.json#dependencies",
         "docsUrl": "https://ui.shadcn.com/"
       },
       {
         "name": "TipTap",
         "version": "v3.27.4",
-        "lastUpdate": "Aug 28, 2026",
+        "lastUpdate": "Aug 29, 2026",
         "source": "packages/shared/package.json#devDependencies",
         "docsUrl": "https://tiptap.dev/"
       },
       {
         "name": "Lucide React",
         "version": "v1.24.0",
-        "lastUpdate": "Aug 28, 2026",
+        "lastUpdate": "Aug 29, 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/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/server/ai-ports.ts

@@ -26,7 +26,7 @@ import { deleteEmbeddings } from "@/lib/pgvector"
 import {
   indexDocumentEmbeddings as knowledgeIndexDocumentEmbeddings,
   resolveAiConfig as resolveKnowledgeAiConfigRaw,
-} from "@/server/serverFns/knowledge-index"
+} from "@/server/serverFns/knowledge-index-utils"
 import type { AiConfig } from "@allbluecn/ai-gateway"
 import { registerGatewayPorts, registerProServiceResolver } from "@allbluecn/ai-gateway"
 import { getProService } from "@/server/pro-services"

package/src/server/knowledge-public/github-sync.ts

@@ -36,7 +36,7 @@ const HEADERS: HeadersInit = {
 function isAllowedGitHubUrl(url: string): boolean {
   try {
     const parsed = new URL(url)
-    return ['github.com', 'www.github.com'].includes(parsed.hostname)
+    return ['github.com', 'www.github.com', 'api.github.com'].includes(parsed.hostname)
       && ['https:', 'http:'].includes(parsed.protocol)
   } catch {
     return false

package/src/server/serverFns/__tests__/knowledge-index.test.ts

@@ -0,0 +1,178 @@
+// 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, it, expect, vi, beforeEach } from 'vitest'
+
+vi.mock('@tanstack/react-start', () => ({
+  createServerFn: (config: any) => {
+    const api: any = {
+      _validator: undefined,
+      validator(schema: any) {
+        this._validator = schema
+        return this
+      },
+      handler(fn: Function) {
+        return async (args: any) => fn({ data: args?.data })
+      },
+    }
+    return api
+  },
+}))
+
+vi.mock('@tanstack/react-start/server', () => ({
+  getRequest: vi.fn(),
+}))
+
+const m = vi.hoisted(() => ({
+  knowledgeBase: { findUnique: vi.fn(), findFirst: vi.fn() },
+  user: { findUnique: vi.fn() },
+  aiProvider: { findUnique: vi.fn() },
+  resolveDefaultProviderConfig: vi.fn(),
+}))
+
+vi.mock('@allbluecn/database', () => ({
+  prisma: {
+    knowledgeBase: m.knowledgeBase,
+    knowledgeDocument: { findMany: vi.fn() },
+    user: m.user,
+    aiProvider: m.aiProvider,
+  },
+}))
+
+vi.mock('@allbluecn/ai-gateway', () => ({
+  generateEmbedding: vi.fn(),
+  chunkText: vi.fn((t: string) => [t]),
+  resolveDefaultProviderConfig: (...args: unknown[]) => m.resolveDefaultProviderConfig(...args),
+}))
+
+vi.mock('@/server/auth-helpers', () => ({
+  requireAuth: vi.fn(),
+}))
+
+vi.mock('@/lib/pgvector', () => ({
+  insertEmbedding: vi.fn(),
+  deleteEmbeddings: vi.fn(),
+}))
+
+import { extractText, resolveAiConfig } from '../knowledge-index-utils'
+
+const KB = { id: 'kb-1', userId: 'user-1' }
+
+describe('resolveAiConfig', () => {
+  beforeEach(() => {
+    vi.clearAllMocks()
+    m.knowledgeBase.findUnique.mockResolvedValue(KB)
+    m.aiProvider.findUnique.mockResolvedValue(null)
+    m.resolveDefaultProviderConfig.mockResolvedValue(null)
+    m.user.findUnique.mockResolvedValue(null)
+  })
+
+  it('新表配置优先：adapterKind 支持 embedding 且 baseUrl 为空时补 AiProvider.defaultBaseUrl', async () => {
+    m.resolveDefaultProviderConfig.mockResolvedValue({
+      providerId: 'openrouter',
+      adapterKind: 'openrouter',
+      apiKey: 'sk-or-user-key',
+      baseUrl: null,
+      model: 'openai/gpt-4o-mini',
+    })
+    m.aiProvider.findUnique.mockResolvedValue({
+      defaultBaseUrl: 'https://openrouter.ai/api/v1',
+    })
+
+    await expect(resolveAiConfig('kb-1')).resolves.toEqual({
+      apiKey: 'sk-or-user-key',
+      baseUrl: 'https://openrouter.ai/api/v1',
+    })
+  })
+
+  it('新表配置的 baseUrl 非空时直接采用，不回落 defaultBaseUrl', async () => {
+    m.resolveDefaultProviderConfig.mockResolvedValue({
+      providerId: 'openai',
+      adapterKind: 'openai',
+      apiKey: 'sk-user-key',
+      baseUrl: 'https://my-proxy.example.com/v1',
+      model: 'gpt-4o',
+    })
+    m.aiProvider.findUnique.mockResolvedValue({
+      defaultBaseUrl: 'https://api.openai.com/v1',
+    })
+
+    await expect(resolveAiConfig('kb-1')).resolves.toEqual({
+      apiKey: 'sk-user-key',
+      baseUrl: 'https://my-proxy.example.com/v1',
+    })
+  })
+
+  it('adapterKind 不支持 embedding 时回落到旧 User.aiApiKey', async () => {
+    m.resolveDefaultProviderConfig.mockResolvedValue({
+      providerId: 'anthropic',
+      adapterKind: 'anthropic',
+      apiKey: 'sk-ant-user-key',
+      baseUrl: 'https://api.anthropic.com',
+      model: 'claude-sonnet-4-5',
+    })
+    m.user.findUnique.mockResolvedValue({
+      aiApiKey: 'sk-or-legacy',
+      aiProvider: 'openrouter',
+    })
+
+    await expect(resolveAiConfig('kb-1')).resolves.toEqual({
+      apiKey: 'sk-or-legacy',
+      baseUrl: 'https://openrouter.ai/api/v1',
+    })
+  })
+
+  it('新表无配置且旧字段有效（openrouter）时补 OpenRouter 端点', async () => {
+    m.user.findUnique.mockResolvedValue({
+      aiApiKey: 'sk-or-legacy',
+      aiProvider: 'openrouter',
+    })
+
+    await expect(resolveAiConfig('kb-1')).resolves.toEqual({
+      apiKey: 'sk-or-legacy',
+      baseUrl: 'https://openrouter.ai/api/v1',
+    })
+  })
+
+  it('旧字段是占位符时返回空对象（交给 generateEmbedding 走 env 兜底）', async () => {
+    m.user.findUnique.mockResolvedValue({
+      aiApiKey: 'sk-or-your-api-key-here',
+      aiProvider: 'openrouter',
+    })
+
+    await expect(resolveAiConfig('kb-1')).resolves.toEqual({})
+    // 新表无有效配置 → 旧字段是占位符 → 不再查 AiProvider 补端点
+    expect(m.aiProvider.findUnique).not.toHaveBeenCalled()
+  })
+
+  it('知识库不存在时返回空对象且不查询任何配置', async () => {
+    m.knowledgeBase.findUnique.mockResolvedValue(null)
+
+    await expect(resolveAiConfig('missing')).resolves.toEqual({})
+    expect(m.resolveDefaultProviderConfig).not.toHaveBeenCalled()
+    expect(m.user.findUnique).not.toHaveBeenCalled()
+  })
+})
+
+describe('extractText', () => {
+  it('优先返回 markdown，其次剥离 html 标签', () => {
+    expect(extractText({ markdown: '# 标题' })).toBe('# 标题')
+    expect(extractText({ html: '<p>正文</p>' })).toBe('正文')
+    expect(extractText({})).toBe('')
+    expect(extractText(null)).toBe('')
+  })
+})

package/src/server/serverFns/knowledge-index-utils.ts

@@ -0,0 +1,104 @@
+// 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 { prisma } from "@allbluecn/database"
+import { generateEmbedding, chunkText, resolveDefaultProviderConfig } from "@allbluecn/ai-gateway"
+import { insertEmbedding, deleteEmbeddings } from "@/lib/pgvector"
+
+export const KB_EMBEDDINGS_TABLE = "knowledge_embeddings"
+const OPENROUTER_BASE_URL = "https://openrouter.ai/api/v1"
+const PLACEHOLDER_KEYS = new Set(["sk-your-api-key-here", "", "sk-or-your-api-key-here"])
+
+// embeddings 走 OpenAI 兼容的 /embeddings 端点，仅这两个 adapterKind 可用；
+// 其余（anthropic/gemini/groq/grok/ollama）无兼容路径，回落到 env 兜底。
+const EMBEDDING_CAPABLE_ADAPTERS = new Set(["openai", "openrouter"])
+
+export function extractText(content: unknown): string {
+  if (!content || typeof content !== "object") return ""
+  const obj = content as Record<string, unknown>
+  if (typeof obj.markdown === "string" && obj.markdown) return obj.markdown
+  if (typeof obj.html === "string" && obj.html) return obj.html.replace(/<[^>]*>/g, "")
+  return ""
+}
+
+export async function resolveAiConfig(kbId: string): Promise<{ apiKey?: string; baseUrl?: string }> {
+  const kb = await prisma.knowledgeBase.findUnique({
+    where: { id: kbId },
+    select: { userId: true },
+  })
+  if (!kb) return {}
+
+  // 新表优先：用户在 /settings/ai 配置的 key（AiProviderConfig.apiKey 加密存储，
+  // resolveDefaultProviderConfig 内部已解密）。旧实现只读 User.aiApiKey，
+  // 只配了新表的用户重索引必然报 "not configured"。
+  const cfg = await resolveDefaultProviderConfig(kb.userId)
+  if (cfg && EMBEDDING_CAPABLE_ADAPTERS.has(cfg.adapterKind)) {
+    const provider = await prisma.aiProvider.findUnique({
+      where: { providerId: cfg.providerId },
+      select: { defaultBaseUrl: true },
+    })
+    const baseUrl = cfg.baseUrl || provider?.defaultBaseUrl
+    // resolveDefaultProviderConfig 已跳过空 apiKey，此处 ?? undefined 仅作类型窄化
+    return { apiKey: cfg.apiKey ?? undefined, baseUrl: baseUrl ?? undefined }
+  }
+
+  // 旧字段兜底（迁移期）
+  const user = await prisma.user.findUnique({
+    where: { id: kb.userId },
+    select: { aiApiKey: true, aiProvider: true },
+  })
+  if (!user || !user.aiApiKey || PLACEHOLDER_KEYS.has(user.aiApiKey)) return {}
+
+  const result: { apiKey: string; baseUrl?: string } = { apiKey: user.aiApiKey }
+  if (user.aiProvider === "openrouter") {
+    result.baseUrl = OPENROUTER_BASE_URL
+  }
+  return result
+}
+
+export async function indexDocumentEmbeddings(
+  doc: { id: string; kbId: string; title: string; content: unknown },
+  aiOpts?: { apiKey?: string; baseUrl?: string }
+): Promise<number> {
+  const text = extractText(doc.content) || doc.title
+  if (!text) return 0
+
+  const chunks = chunkText(text)
+  await deleteEmbeddings(KB_EMBEDDINGS_TABLE, "documentId", doc.id)
+
+  for (let i = 0; i < chunks.length; i++) {
+    const embedding = await generateEmbedding(chunks[i], aiOpts)
+    await insertEmbedding(KB_EMBEDDINGS_TABLE, `${doc.id}-${i}`, chunks[i], embedding, {
+      kbId: doc.kbId,
+      documentId: doc.id,
+      chunkIndex: i,
+    })
+  }
+
+  return chunks.length
+}
+
+export async function indexDocumentById(documentId: string): Promise<number> {
+  const doc = await prisma.knowledgeDocument.findUnique({
+    where: { id: documentId },
+    select: { id: true, kbId: true, title: true, content: true },
+  })
+  if (!doc) return 0
+
+  const aiConfig = await resolveAiConfig(doc.kbId)
+  return indexDocumentEmbeddings(doc, aiConfig)
+}

package/src/server/serverFns/knowledge-index.ts

@@ -20,73 +20,12 @@ import { getRequest } from "@tanstack/react-start/server"
 import { z } from "zod"
 import { prisma } from "@allbluecn/database"
 import { requireAuth } from "@/server/auth-helpers"
-import { generateEmbedding, chunkText } from "@allbluecn/ai-gateway"
-import { insertEmbedding, deleteEmbeddings } from "@/lib/pgvector"
-
-const KB_EMBEDDINGS_TABLE = "knowledge_embeddings"
-const OPENROUTER_BASE_URL = "https://openrouter.ai/api/v1"
-const PLACEHOLDER_KEYS = new Set(["sk-your-api-key-here", "", "sk-or-your-api-key-here"])
-
-export function extractText(content: unknown): string {
-  if (!content || typeof content !== "object") return ""
-  const obj = content as Record<string, unknown>
-  if (typeof obj.markdown === "string" && obj.markdown) return obj.markdown
-  if (typeof obj.html === "string" && obj.html) return obj.html.replace(/<[^>]*>/g, "")
-  return ""
-}
-
-export async function resolveAiConfig(kbId: string): Promise<{ apiKey?: string; baseUrl?: string }> {
-  const kb = await prisma.knowledgeBase.findUnique({
-    where: { id: kbId },
-    select: { userId: true },
-  })
-  if (!kb) return {}
-
-  const user = await prisma.user.findUnique({
-    where: { id: kb.userId },
-    select: { aiApiKey: true, aiProvider: true },
-  })
-  if (!user || !user.aiApiKey || PLACEHOLDER_KEYS.has(user.aiApiKey)) return {}
-
-  const result: { apiKey: string; baseUrl?: string } = { apiKey: user.aiApiKey }
-  if (user.aiProvider === "openrouter") {
-    result.baseUrl = OPENROUTER_BASE_URL
-  }
-  return result
-}
-
-export async function indexDocumentEmbeddings(
-  doc: { id: string; kbId: string; title: string; content: unknown },
-  aiOpts?: { apiKey?: string; baseUrl?: string }
-): Promise<number> {
-  const text = extractText(doc.content) || doc.title
-  if (!text) return 0
-
-  const chunks = chunkText(text)
-  await deleteEmbeddings(KB_EMBEDDINGS_TABLE, "documentId", doc.id)
-
-  for (let i = 0; i < chunks.length; i++) {
-    const embedding = await generateEmbedding(chunks[i], aiOpts)
-    await insertEmbedding(KB_EMBEDDINGS_TABLE, `${doc.id}-${i}`, chunks[i], embedding, {
-      kbId: doc.kbId,
-      documentId: doc.id,
-      chunkIndex: i,
-    })
-  }
-
-  return chunks.length
-}
-
-export async function indexDocumentById(documentId: string): Promise<number> {
-  const doc = await prisma.knowledgeDocument.findUnique({
-    where: { id: documentId },
-    select: { id: true, kbId: true, title: true, content: true },
-  })
-  if (!doc) return 0
-
-  const aiConfig = await resolveAiConfig(doc.kbId)
-  return indexDocumentEmbeddings(doc, aiConfig)
-}
+import { deleteEmbeddings } from "@/lib/pgvector"
+import {
+  KB_EMBEDDINGS_TABLE,
+  indexDocumentEmbeddings,
+  resolveAiConfig,
+} from "./knowledge-index-utils"
 
 export const indexKnowledgeDocumentFn = createServerFn({ method: "POST" })
   .validator(z.object({ documentId: z.string() }))

package/src/server/serverFns/knowledge.ts

@@ -20,7 +20,7 @@ import { getRequest } from '@tanstack/react-start/server'
 import { z } from 'zod'
 import { prisma } from '@allbluecn/database'
 import { requireAuth } from '@/server/auth-helpers'
-import { indexDocumentById } from '@/server/serverFns/knowledge-index'
+import { indexDocumentById } from '@/server/serverFns/knowledge-index-utils'
 import { deleteEmbeddings } from '@/lib/pgvector'
 import { requirePermission } from '@/server/permissions'
 import { auditLog } from '@/server/audit'
@@ -306,7 +306,13 @@ export const updateDocumentFn = createServerFn({ method: 'POST' })
     })
 
     if (data.content !== undefined) {
-      indexDocumentById(data.id).catch(() => {})
+      // fire-and-forget：索引失败不阻塞文档保存，但不能静默——
+      // 否则无 AI key / 端点错误时知识库检索悄悄失效且无从排查。
+      indexDocumentById(data.id).catch((e) => {
+        console.warn(
+          `知识库向量索引失败 documentId=${data.id}: ${e instanceof Error ? e.message : String(e)}`,
+        )
+      })
     }
 
     await auditLog({ workspaceId: '', userId, resourceType: 'document', resourceId: data.id, action: 'document.update' })

package/src/components/knowledge/knowledge-settings-panel.tsx

@@ -1,148 +0,0 @@
-// 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 { useState } from 'react'
-import { useNavigate } from '@tanstack/react-router'
-import { Globe, Lock, Trash2 } from 'lucide-react'
-import {
-  Dialog,
-  DialogContent,
-  DialogDescription,
-  DialogFooter,
-  DialogHeader,
-  DialogTitle,
-} from '@/components/ui/dialog'
-import { Button } from '@/components/ui/button'
-import { Label } from '@/components/ui/label'
-import {
-  Select,
-  SelectContent,
-  SelectItem,
-  SelectTrigger,
-  SelectValue,
-} from '@/components/ui/select'
-import { deleteKnowledgeFn, updateKnowledgeFn } from '@/server/serverFns/knowledge'
-import { useTranslation } from 'react-i18next'
-
-interface KbData {
-  id: string
-  name: string
-  visibility?: string
-}
-
-interface KnowledgeSettingsPanelProps {
-  open: boolean
-  onOpenChange: (open: boolean) => void
-  kb: KbData
-  onUpdate?: () => void
-}
-
-export function KnowledgeSettingsPanel({ open, onOpenChange, kb, onUpdate }: KnowledgeSettingsPanelProps) {
-  const { t } = useTranslation('knowledge')
-  const navigate = useNavigate()
-  const [visibility, setVisibility] = useState((kb as any).visibility || 'private')
-  const [deleting, setDeleting] = useState(false)
-  const [saving, setSaving] = useState(false)
-
-  const handleVisibilityChange = async (value: string) => {
-    const v = value as 'private' | 'team'
-    setVisibility(v)
-    setSaving(true)
-    try {
-      await updateKnowledgeFn({ data: { id: kb.id, visibility: v } })
-      onUpdate?.()
-    } catch (e) {
-      console.error('Update visibility failed:', e instanceof Error ? e.message : String(e))
-    }
-    setSaving(false)
-  }
-
-  const handleDelete = async () => {
-    setDeleting(true)
-    try {
-      await deleteKnowledgeFn({ data: { id: kb.id } })
-      onOpenChange(false)
-      navigate({ to: '/knowledge' })
-    } catch (e) {
-      console.error('Delete failed:', e instanceof Error ? e.message : String(e))
-    }
-    setDeleting(false)
-  }
-
-  return (
-    <Dialog open={open} onOpenChange={onOpenChange}>
-      <DialogContent className="sm:max-w-md">
-        <DialogHeader>
-          <DialogTitle>{t('kbSettings.title')}</DialogTitle>
-          <DialogDescription>{t('kbSettings.subtitle', { name: kb.name })}</DialogDescription>
-        </DialogHeader>
-
-        <div className="space-y-6 py-4">
-          <div className="space-y-2">
-            <Label>{t('kbSettings.ownership')}</Label>
-            <Select value={visibility} onValueChange={handleVisibilityChange} disabled={saving}>
-              <SelectTrigger>
-                <SelectValue />
-              </SelectTrigger>
-              <SelectContent>
-                <SelectItem value="private">
-                  <div className="flex items-center gap-2">
-                    <Lock className="size-4" />
-                    {t('kbSettings.private')}
-                  </div>
-                </SelectItem>
-                <SelectItem value="team">
-                  <div className="flex items-center gap-2">
-                    <Globe className="size-4" />
-                    {t('kbSettings.team')}
-                  </div>
-                </SelectItem>
-              </SelectContent>
-            </Select>
-            <p className="text-xs text-muted-foreground">
-              {t('kbSettings.teamHint')}
-            </p>
-          </div>
-
-          <div className="border-t pt-4">
-            <div className="space-y-2">
-              <Label className="text-destructive">{t('kbSettings.danger')}</Label>
-              <p className="text-xs text-muted-foreground">
-                {t('kbSettings.deleteHint')}
-              </p>
-              <Button
-                variant="destructive"
-                size="sm"
-                onClick={handleDelete}
-                disabled={deleting}
-              >
-                <Trash2 className="size-4 mr-1" />
-                {deleting ? t('kbSettings.deleting') : t('kbSettings.delete')}
-              </Button>
-            </div>
-          </div>
-        </div>
-
-        <DialogFooter>
-          <Button variant="outline" onClick={() => onOpenChange(false)}>
-            {t('kbSettings.close')}
-          </Button>
-        </DialogFooter>
-      </DialogContent>
-    </Dialog>
-  )
-}

package/src/lib/openai-client.ts

@@ -1,62 +0,0 @@
-// 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 OpenAI from "openai"
-
-const PLACEHOLDER_KEYS = new Set(["sk-your-api-key-here", ""])
-
-function resolveApiKey(): string | null {
-  const openai = process.env.OPENAI_API_KEY
-  if (openai && !PLACEHOLDER_KEYS.has(openai)) return openai
-
-  const openrouter = process.env.OPENROUTER_API_KEY
-  if (openrouter && !PLACEHOLDER_KEYS.has(openrouter)) return openrouter
-
-  return null
-}
-
-function resolveBaseURL(): string | undefined {
-  return process.env.AI_BASE_URL || undefined
-}
-
-const globalForOpenAI = globalThis as unknown as {
-  openAIClient: OpenAI | undefined
-}
-
-export function getOpenAIClient(opts?: { apiKey?: string; baseUrl?: string }): OpenAI {
-  const { apiKey, baseUrl } = opts || {}
-
-  if (apiKey) {
-    const url = baseUrl || resolveBaseURL()
-    return new OpenAI({ apiKey, ...(url ? { baseURL: url } : {}) })
-  }
-
-  if (globalForOpenAI.openAIClient) return globalForOpenAI.openAIClient
-
-  const envKey = resolveApiKey()
-  if (!envKey) {
-    throw new Error("OPENAI_API_KEY or OPENROUTER_API_KEY not configured")
-  }
-
-  const url = resolveBaseURL()
-  globalForOpenAI.openAIClient = new OpenAI({ apiKey: envKey, ...(url ? { baseURL: url } : {}) })
-  return globalForOpenAI.openAIClient
-}
-
-export function hasOpenAIKey(): boolean {
-  return resolveApiKey() !== null
-}