@allbluecn/web-app 0.12.0 → 0.12.2

package/src/components/workspace/kb/workspace-kb-card.tsx

@@ -18,7 +18,7 @@
 import * as React from "react";
 import { Link, useRouter } from "@tanstack/react-router";
 import { useServerFn } from "@tanstack/react-start";
-import { toast } from "sonner";
+import { toast } from "@/components/ui/toast";
 import {
   BookOpenText, CornerUpRight, FileSymlink, GripVertical, LayoutGrid, Link as LinkIcon, Link2, Pencil, Plus, SquareArrowOutUpRight, Trash2, Unlink,
 } from "lucide-react";
@@ -261,13 +261,9 @@ const QuickDocRowItem = React.memo(function QuickDocRowItem({ row, index, onRena
         <div className={`items-center gap-0.5 pl-1 ${editing ? "flex" : "absolute inset-y-0 right-0 hidden opacity-0 transition-opacity group-hover/row:opacity-100 group-hover/row:pointer-events-auto group-hover/row:flex"}`}>
           {linkTarget && (
             <Tooltip>
-              <TooltipTrigger asChild>
-                <Button variant="ghost" size="sm" className="size-5 p-0" asChild>
-                  <Link to={linkTarget.to} params={linkTarget.params} target="_blank" rel="noreferrer">
+              <TooltipTrigger render={<Button render={<Link to={linkTarget.to} params={linkTarget.params} target="_blank" rel="noreferrer" />} variant="ghost" size="sm" className="size-5 p-0" nativeButton={false} />}>
                     <SquareArrowOutUpRight className="size-3" />
-                  </Link>
-                </Button>
-              </TooltipTrigger>
+                  </TooltipTrigger>
               <TooltipContent side="bottom">{m.workspace_kb_openInNewTab()}</TooltipContent>
             </Tooltip>
           )}
@@ -437,22 +433,16 @@ export function WorkspaceKbCard({ workspaceId, data }: WorkspaceKbCardProps) {
   const goToKbButton =
     kbs.length === 0 ? (
       <Tooltip>
-        <TooltipTrigger asChild>
-          <Button variant="ghost" size="icon" className="size-7" disabled>
+        <TooltipTrigger render={<Button variant="ghost" size="icon" className="size-7" disabled />}>
             <FileSymlink className="size-3.5" />
-          </Button>
-        </TooltipTrigger>
+          </TooltipTrigger>
         <TooltipContent side="top">{m.workspace_kb_goToKb()}</TooltipContent>
       </Tooltip>
     ) : kbs.length === 1 ? (
       <Tooltip>
-        <TooltipTrigger asChild>
-          <Button variant="ghost" size="icon" className="size-7" asChild>
-            <Link to="/knowledge/$kbId" params={{ kbId: kbs[0].id }}>
+        <TooltipTrigger render={<Button render={<Link to="/knowledge/$kbId" params={{ kbId: kbs[0].id }} />} variant="ghost" size="icon" className="size-7" nativeButton={false} />}>
               <CornerUpRight className="size-3.5" />
-            </Link>
-          </Button>
-        </TooltipTrigger>
+            </TooltipTrigger>
         <TooltipContent side="top">
           {m.workspace_kb_goToKb()} <span className="font-medium">{kbs[0].name}</span>
         </TooltipContent>
@@ -460,23 +450,17 @@ export function WorkspaceKbCard({ workspaceId, data }: WorkspaceKbCardProps) {
     ) : (
       <DropdownMenu>
         <Tooltip>
-          <TooltipTrigger asChild>
-            <DropdownMenuTrigger asChild>
-              <Button variant="ghost" size="icon" className="size-7">
+          <TooltipTrigger render={<DropdownMenuTrigger render={<Button variant="ghost" size="icon" className="size-7" />} />}>
                 <CornerUpRight className="size-3.5" />
-              </Button>
-            </DropdownMenuTrigger>
-          </TooltipTrigger>
+              </TooltipTrigger>
           <TooltipContent side="top">{m.workspace_kb_goToKb()}</TooltipContent>
         </Tooltip>
         <DropdownMenuContent align="end">
           {kbs.map((kb) => (
-            <DropdownMenuItem key={kb.id} asChild>
-              <Link to="/knowledge/$kbId" params={{ kbId: kb.id }}>
+            <DropdownMenuItem render={<Link to="/knowledge/$kbId" params={{ kbId: kb.id }} />} key={kb.id}>
                 <LucideIconByName name={kb.icon} size={14} className="shrink-0" />
                 <span className="truncate">{kb.name}</span>
-              </Link>
-            </DropdownMenuItem>
+              </DropdownMenuItem>
           ))}
         </DropdownMenuContent>
       </DropdownMenu>
@@ -503,26 +487,20 @@ export function WorkspaceKbCard({ workspaceId, data }: WorkspaceKbCardProps) {
         </div>
         <div className="flex items-center gap-1">
           <Tooltip>
-            <TooltipTrigger asChild>
-              <Button
-                variant="ghost"
+            <TooltipTrigger render={<Button variant="ghost"
                 size="icon"
                 className="size-7"
-                onClick={() => setManageOpen(true)}
-              >
+                onClick={() => setManageOpen(true)} />}>
                 {hasLinkedKb ? <Link2 className="size-3.5" /> : <Unlink className="size-3.5" />}
-              </Button>
-            </TooltipTrigger>
+              </TooltipTrigger>
             <TooltipContent side="top">
               {hasLinkedKb ? m.workspace_kb_linked() : m.workspace_kb_linkButton()}
             </TooltipContent>
           </Tooltip>
           <Tooltip>
-            <TooltipTrigger asChild>
-              <Button variant="ghost" size="icon" className="size-7" aria-label={m.workspace_kb_addQuickDoc()} onClick={() => setAddOpen(true)}>
+            <TooltipTrigger render={<Button variant="ghost" size="icon" className="size-7" aria-label={m.workspace_kb_addQuickDoc()} onClick={() => setAddOpen(true)} />}>
                 <Plus className="size-3.5" />
-              </Button>
-            </TooltipTrigger>
+              </TooltipTrigger>
             <TooltipContent side="top">{m.workspace_kb_addQuickDoc()}</TooltipContent>
           </Tooltip>
           {goToKbButton}

package/src/components/workspace/kb/workspace-kb-manage-dialog.tsx

@@ -17,7 +17,7 @@
 
 import * as React from "react";
 import { useServerFn } from "@tanstack/react-start";
-import { toast } from "sonner";
+import { toast } from "@/components/ui/toast";
 import { Check, Search } from "lucide-react";
 import { Button } from "@/components/ui/button";
 import { Badge } from "@/components/ui/badge";

package/src/components/workspace/kb/workspace-quick-doc-dialog.tsx

@@ -17,7 +17,7 @@
 
 import * as React from "react";
 import { useServerFn } from "@tanstack/react-start";
-import { toast } from "sonner";
+import { toast } from "@/components/ui/toast";
 import { BookOpenText, X } from "lucide-react";
 import { Button } from "@/components/ui/button";
 import { Checkbox } from "@/components/ui/checkbox";
@@ -394,12 +394,10 @@ export function WorkspaceQuickDocDialog({
         <DialogFooter className="flex items-center justify-between sm:justify-between">
           <label className="flex cursor-pointer items-center gap-2 text-sm">
             <Checkbox
-              checked={
-                items.length > 0 && selectedRows.size === items.length
-                  ? true
-                  : selectedRows.size > 0
-                    ? "indeterminate"
-                    : false
+              checked={items.length > 0 && selectedRows.size === items.length}
+              indeterminate={
+                !(items.length > 0 && selectedRows.size === items.length) &&
+                selectedRows.size > 0
               }
               disabled={items.length === 0}
               onCheckedChange={() => {

package/src/components/workspace/members/workspace-members-manager.tsx

@@ -17,7 +17,7 @@
 
 import { useState, useEffect } from "react";
 import { UserPlus, Loader2, Search, X, Check, Users } from "lucide-react";
-import { toast } from "@/components/ui/sonner";
+import { toast } from "@/components/ui/toast";
 import { Button } from "@/components/ui/button";
 import { Input } from "@/components/ui/input";
 import {
@@ -191,13 +191,11 @@ export function WorkspaceMembersManager({ workspaceId, workspaceOwnerId, members
             <Users className="size-4 text-muted-foreground" />
             <h2 className="text-base font-semibold">{m.workspace_home_members()}</h2>
           </div>
-          <TooltipProvider delayDuration={0}>
+          <TooltipProvider>
             <Tooltip>
-              <TooltipTrigger asChild>
-                <Button variant="ghost" size="icon" onClick={openAddMember} aria-label={m.workspace_home_addMember()}>
+              <TooltipTrigger render={<Button variant="ghost" size="icon" onClick={openAddMember} aria-label={m.workspace_home_addMember()} />}>
                   <UserPlus className="size-3.5" />
-                </Button>
-              </TooltipTrigger>
+                </TooltipTrigger>
               <TooltipContent>
                 <p>{m.workspace_home_addMember()}</p>
               </TooltipContent>

package/src/config/sidebar-routes.tsx

@@ -19,7 +19,7 @@ import { m } from '@/paraglide/messages.js';
 import type React from "react";
 import {
   Sparkles,
-  BotMessageSquare,
+  SquareTerminal,
   Lightbulb,
   ClipboardList,
   Package2,
@@ -56,11 +56,11 @@ export const workspaceRoutes: Route[] = [
     link: "/dashboard",
   },
   {
-    id: "chat",
-    title: m.common_nav_chat,
-    icon: <BotMessageSquare className="size-4" />,
+    id: "harness",
+    title: m.common_nav_harness,
+    icon: <SquareTerminal className="size-4" />,
     badge: () => " ",
-    link: "/chat",
+    link: "/harness",
   },
   {
     id: "inspiration",

package/src/devframe-docks/ai-chat-iframe.tsx

@@ -0,0 +1,29 @@
+// 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 { createRoot } from 'react-dom/client'
+import { StrictMode } from 'react'
+import { AiDevtoolsPanel } from '@tanstack/react-ai-devtools'
+
+const container = document.getElementById('root')
+if (container) {
+  createRoot(container).render(
+    <StrictMode>
+      <AiDevtoolsPanel />
+    </StrictMode>,
+  )
+}

package/src/devframe-docks/session-iframe.tsx

@@ -0,0 +1,86 @@
+// 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 { createRoot } from 'react-dom/client'
+import { StrictMode, useEffect, useState } from 'react'
+
+type UserInfo = {
+  id: string
+  email: string
+  name: string | null
+  role: string
+  aiProvider?: string | null
+  aiModel?: string | null
+  hasAiKey?: boolean | null
+}
+
+function SessionPanel() {
+  const [user, setUser] = useState<UserInfo | null>(null)
+  const [loading, setLoading] = useState(true)
+
+  useEffect(() => {
+    fetch('/api/auth/session', { credentials: 'include' })
+      .then((res) => (res.ok ? res.json() : null))
+      .then((data) => {
+        setUser(data?.user ?? null)
+        setLoading(false)
+      })
+      .catch(() => setLoading(false))
+  }, [])
+
+  if (loading) {
+    return (
+      <div style={{ display: 'flex', height: '100%', alignItems: 'center', justifyContent: 'center', color: '#888' }}>
+        加载中…
+      </div>
+    )
+  }
+
+  if (!user) {
+    return (
+      <div style={{ display: 'flex', height: '100%', alignItems: 'center', justifyContent: 'center', color: '#888' }}>
+        未登录
+      </div>
+    )
+  }
+
+  const row: React.CSSProperties = { display: 'grid', gridTemplateColumns: '80px 1fr', gap: '6px', fontSize: '12px', padding: '4px 0', borderBottom: '1px solid #00000010' }
+  const labelStyle: React.CSSProperties = { color: '#888' }
+
+  return (
+    <div style={{ padding: 12, fontFamily: 'ui-sans-serif, system-ui, -apple-system, sans-serif', color: '#222' }}>
+      <h4 style={{ margin: '0 0 8px', fontSize: 13 }}>当前用户</h4>
+      <div style={row}><span style={labelStyle}>ID</span><code>{user.id}</code></div>
+      <div style={row}><span style={labelStyle}>Email</span><span>{user.email}</span></div>
+      <div style={row}><span style={labelStyle}>Name</span><span>{user.name || '-'}</span></div>
+      <div style={row}><span style={labelStyle}>Role</span><span style={{ fontWeight: 600 }}>{user.role}</span></div>
+      <h4 style={{ margin: '16px 0 8px', fontSize: 13 }}>AI 配置</h4>
+      <div style={row}><span style={labelStyle}>Provider</span><span>{user.aiProvider || '未配置'}</span></div>
+      <div style={row}><span style={labelStyle}>Model</span><span>{user.aiModel || '未配置'}</span></div>
+      <div style={row}><span style={labelStyle}>Has Key</span><span>{user.hasAiKey ? '是' : '否'}</span></div>
+    </div>
+  )
+}
+
+const container = document.getElementById('root')
+if (container) {
+  createRoot(container).render(
+    <StrictMode>
+      <SessionPanel />
+    </StrictMode>,
+  )
+}

package/src/hooks/use-commands.ts

@@ -59,7 +59,7 @@ export function useCommands(options?: { onAction?: (id: string) => void }) {
       }
 
       if (id === 'create-conversation') {
-        void router.navigate({ to: '/chat' as never })
+        void router.navigate({ to: '/harness' as never })
         return
       }
 

package/src/hooks/use-mobile.ts

@@ -1,20 +1,3 @@
-// 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 * as React from "react"
 
 const MOBILE_BREAKPOINT = 768

package/src/hooks/use-notifications.ts

@@ -2,7 +2,7 @@
 import { useCallback, useEffect } from 'react'
 import { useQuery, useQueryClient } from '@tanstack/react-query'
 import { useRouter } from '@tanstack/react-router'
-import { toast } from 'sonner'
+import { toast } from '@/components/ui/toast'
 import type { NotificationSseValue, NotificationItem } from '@allbluecn/kernel'
 import { isInDndWindow } from '@allbluecn/kernel'
 import { getUnreadCountFn, getNotificationPreferencesFn } from '@/server/serverFns/notifications'

package/src/lib/__tests__/annotation-prompt.test.ts

@@ -0,0 +1,74 @@
+// @vitest-environment node
+// 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("@allbluecn/database", () => ({
+  prisma: { systemPromptTemplate: { findUnique: vi.fn() } },
+}))
+
+import { prisma } from "@allbluecn/database"
+import "@/server/ai-gateway/prompts/builtin"
+import { resolveSystemPrompt } from "@/server/ai-gateway/prompts/registry"
+import { buildFillPrompt, type FillComponentInfo } from "../../plugins/core/prd/lib/ai/annotation-prompt"
+
+beforeEach(() => {
+  vi.mocked(prisma.systemPromptTemplate.findUnique).mockResolvedValue(null as never)
+})
+
+describe("buildFillPrompt", () => {
+  it("componentInfo 承载类型/名称/属性/模板整块，并与模板指令段拼接一致", async () => {
+    const info: FillComponentInfo = {
+      type: "button",
+      name: "登录按钮",
+      editableProps: [{ key: "text", label: "按钮文案", type: "string" }],
+      commentTemplate: "<p>按钮文案：{{text}}</p>",
+      overrides: { text: "登录" },
+    }
+    const sections = await buildFillPrompt(info)
+    const prompt = sections.join("\n")
+    // 指令段来自模板（收编到 PromptRegistry），组件信息在「组件信息：」与「要求：」之间
+    expect(prompt).toContain("你是产品文档注释填充助手")
+    expect(prompt).toContain("组件信息：\n- 类型：button\n- 名称：登录按钮\n- 可编辑属性：")
+    expect(prompt).toContain("- 按钮文案（text）（当前值：登录）")
+    expect(prompt).toContain("注释模板（保持此 HTML 结构不变")
+    expect(prompt).toContain("<p>按钮文案：{{text}}</p>")
+    expect(prompt).toContain("要求：")
+    // 组件信息块必须落在「组件信息：」与「要求：」之间
+    expect(prompt.indexOf("- 类型：button")).toBeGreaterThan(prompt.indexOf("组件信息："))
+    expect(prompt.indexOf("- 类型：button")).toBeLessThan(prompt.indexOf("\n要求："))
+  })
+
+  it("无声明属性时降级为占位文案", async () => {
+    const prompt = (await buildFillPrompt({ type: "x", name: "y" })).join("\n")
+    expect(prompt).toContain("（无声明属性）")
+  })
+
+  it("无预设模板时降级为占位文案", async () => {
+    const prompt = (await buildFillPrompt({ type: "x", name: "y" })).join("\n")
+    expect(prompt).toContain("（无预设模板，请生成简洁的描述性 HTML 段落）")
+  })
+
+  it("有预设模板时不出现无模板占位文案", async () => {
+    const prompt = (
+      await buildFillPrompt({ type: "x", name: "y", commentTemplate: "<b>t</b>" })
+    ).join("\n")
+    expect(prompt).not.toContain("（无预设模板")
+    expect(prompt).toContain("<b>t</b>")
+  })
+})

package/src/lib/__tests__/provider-router.test.ts

@@ -48,7 +48,7 @@ beforeEach(async () => {
       }),
     },
     accessPolicy: { requireFeature: async () => undefined },
-    auth: { getSession: async () => null },
+    auth: { getSession: async () => null, invalidateProfileCache: () => {} },
     remoteAuth: { read: async () => null },
     webSearch: { search: async () => ({ results: [] }) },
     infra: {

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

@@ -24,6 +24,7 @@ const mockChunkText = vi.hoisted(() => vi.fn((text: string) => {
 }))
 const mockInsertEmbedding = vi.hoisted(() => vi.fn())
 const mockSearchByVector = vi.hoisted(() => vi.fn())
+const mockDeleteEmbeddings = vi.hoisted(() => vi.fn())
 const mockRerankCandidates = vi.hoisted(() => vi.fn().mockResolvedValue(null))
 
 vi.mock('@/server/ai-gateway', () => ({
@@ -33,9 +34,12 @@ vi.mock('@/server/ai-gateway', () => ({
   RECALL_MULTIPLIER: 4,
 }))
 
-vi.mock('@/lib/pgvector', () => ({
-  insertEmbedding: mockInsertEmbedding,
-  searchByVector: mockSearchByVector,
+vi.mock('@/lib/vector-store', () => ({
+  getVectorStore: vi.fn().mockResolvedValue({
+    searchByVector: mockSearchByVector,
+    insertEmbedding: mockInsertEmbedding,
+    deleteEmbeddings: mockDeleteEmbeddings,
+  }),
 }))
 
 import { indexDocument, ragSearch } from '@/lib/rag'

package/src/lib/ai/__tests__/chat-handoff.test.ts

@@ -0,0 +1,19 @@
+import { describe, it, expect, beforeEach } from "vitest";
+import {
+  startHandoffWithContext,
+  consumeHandoffContext,
+} from "@/lib/ai/chat-handoff";
+
+describe("chat-handoff", () => {
+  beforeEach(() => {
+    sessionStorage.clear();
+    consumeHandoffContext();
+  });
+
+  it("startHandoffWithContext 两参：不再创建 convPromise，workbench 侧建会话", () => {
+    const ret = startHandoffWithContext("hello", { board: "story", entityId: "st-1" });
+    expect(ret.pending).toBe("hello");
+    expect("convPromise" in ret).toBe(false);
+    expect(consumeHandoffContext()).toEqual({ board: "story", entityId: "st-1" });
+  });
+});

package/src/lib/ai/__tests__/story-prompt.test.ts

@@ -1,3 +1,4 @@
+// @vitest-environment node
 // SPDX-License-Identifier: AGPL-3.0-or-later
 // AllBlue - 理想之海
 // Copyright (C) 2026 AllBlue Contributors
@@ -15,12 +16,33 @@
 // 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 } from "vitest"
-import { buildStorySystemPrompt } from '@/server/ai-gateway'
+import { describe, it, expect, vi, beforeEach } from "vitest"
 
-describe("buildStorySystemPrompt", () => {
-  it("基础 prompt 包含 JSONL 输出约束", () => {
-    const prompt = buildStorySystemPrompt({
+vi.mock("@allbluecn/database", () => ({
+  prisma: { systemPromptTemplate: { findUnique: vi.fn() } },
+}))
+
+import { prisma } from "@allbluecn/database"
+import "@/server/ai-gateway/prompts/builtin"
+import { resolveSystemPrompt } from "@/server/ai-gateway/prompts/registry"
+import { buildStoryPromptVars, type StoryPromptOptions } from "@/server/ai-gateway/story-prompt"
+
+/**
+ * 端到端渲染：PromptRegistry 的 story.generate 模板 + buildStoryPromptVars 的 vars。
+ * findUnique 返回 null 模拟 DB 无自定义模板（回落内置），与线上 seed 后的形态一致。
+ */
+const renderStoryPrompt = (options: StoryPromptOptions): Promise<string> =>
+  resolveSystemPrompt("story.generate", buildStoryPromptVars(options)).then((sections) =>
+    sections.filter(Boolean).join("\n"),
+  )
+
+beforeEach(() => {
+  vi.mocked(prisma.systemPromptTemplate.findUnique).mockResolvedValue(null as never)
+})
+
+describe("story.generate 端到端提示词", () => {
+  it("基础 prompt 包含 JSONL 输出约束", async () => {
+    const prompt = await renderStoryPrompt({
       taskType: "create",
       requirement: "实现用户登录功能",
     })
@@ -28,8 +50,8 @@ describe("buildStorySystemPrompt", () => {
     expect(prompt).toContain("实现用户登录功能")
   })
 
-  it("拆解任务时包含父需求描述", () => {
-    const prompt = buildStorySystemPrompt({
+  it("拆解任务时包含父需求描述", async () => {
+    const prompt = await renderStoryPrompt({
       taskType: "breakdown",
       requirement: "实现购物车结算",
       parentStory: { name: "购物车结算", description: "支持优惠券抵扣" },
@@ -38,8 +60,8 @@ describe("buildStorySystemPrompt", () => {
     expect(prompt).toContain("支持优惠券抵扣")
   })
 
-  it("包含优先级枚举值", () => {
-    const prompt = buildStorySystemPrompt({ taskType: "create", requirement: "x" })
+  it("包含优先级枚举值", async () => {
+    const prompt = await renderStoryPrompt({ taskType: "create", requirement: "x" })
     expect(prompt).toContain("urgent")
     expect(prompt).toContain("high")
     expect(prompt).toContain("medium")
@@ -47,8 +69,8 @@ describe("buildStorySystemPrompt", () => {
     expect(prompt).toContain("none")
   })
 
-  it("包含可用标签列表", () => {
-    const prompt = buildStorySystemPrompt({
+  it("包含可用标签列表", async () => {
+    const prompt = await renderStoryPrompt({
       taskType: "create",
       requirement: "x",
       availableLabels: ["前端", "后端", "登录"],
@@ -58,16 +80,16 @@ describe("buildStorySystemPrompt", () => {
     expect(prompt).toContain("登录")
   })
 
-  it("输出字段仅含 name/description/priority/labelNames", () => {
-    const prompt = buildStorySystemPrompt({ taskType: "create", requirement: "x" })
+  it("输出字段仅含 name/description/priority/labelNames", async () => {
+    const prompt = await renderStoryPrompt({ taskType: "create", requirement: "x" })
     expect(prompt).toContain("name")
     expect(prompt).toContain("description")
     expect(prompt).toContain("priority")
     expect(prompt).toContain("labelNames")
   })
 
-  it("拆解任务的字段约束说明覆盖全部四个字段", () => {
-    const prompt = buildStorySystemPrompt({ taskType: "breakdown", requirement: "x" })
+  it("拆解任务的字段约束说明覆盖全部四个字段", async () => {
+    const prompt = await renderStoryPrompt({ taskType: "breakdown", requirement: "x" })
     const fieldLines = prompt.split("\n").filter((l) => l.includes("字段"))
     expect(fieldLines.length).toBeGreaterThanOrEqual(2)
     const joined = fieldLines.join(" ")
@@ -75,4 +97,9 @@ describe("buildStorySystemPrompt", () => {
     expect(joined).toContain("priority")
     expect(joined).toContain("labelNames")
   })
+
+  it("无父需求时空分区被过滤（不产生连续空行分区）", async () => {
+    const prompt = await renderStoryPrompt({ taskType: "create", requirement: "x" })
+    expect(prompt).not.toContain("\n\n")
+  })
 })

package/src/lib/ai/byok.ts

@@ -0,0 +1,32 @@
+// 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/>.
+
+// apps/web/src/lib/ai/byok.ts
+//
+// BYOK（Bring Your Own Key）高隐私档客户端单例：`defineByok` + `defaultByokStorage`
+// 使用 passkey/PRF 加密的 IndexedDB，WebAuthn 不可用时降级到 session 内存。
+//
+// `setServerCoverage(true)` 允许无浏览器 key 用户照常 POST——服务端有 DB / env
+// 兜底（见 `server/ai-gateway/byok.ts` 的 resolveByokApiKey 回落逻辑）。
+
+import { defineByok, defaultByokStorage } from "@tanstack/ai-client/byok"
+
+export const byok = defineByok({
+  storage: defaultByokStorage(),
+})
+
+byok.setServerCoverage(true)