@allbluecn/web-app 0.27.2 → 0.27.3

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@allbluecn/web-app",
-  "version": "0.27.2",
+  "version": "0.27.3",
   "license": "AGPL-3.0-or-later",
   "type": "module",
   "files": [

package/src/components/desktop/__tests__/quick-capture-invalidate.test.tsx

@@ -18,6 +18,8 @@ let captured: CaptureCb | null = null
 const unsubscribe = vi.fn()
 let noBridge = false
 
+const routerInvalidate = vi.hoisted(() => vi.fn())
+
 vi.mock('@/lib/desktop-bridge-types', () => ({
   getDesktopBridge: () => {
     if (noBridge) return null
@@ -30,6 +32,11 @@ vi.mock('@/lib/desktop-bridge-types', () => ({
   },
 }))
 
+// 需求列表/看板走 route loader（非 react-query）：事件需同时 router.invalidate
+vi.mock('@tanstack/react-router', () => ({
+  useRouter: () => ({ invalidate: routerInvalidate }),
+}))
+
 import { QuickCaptureInvalidator } from '../quick-capture-invalidate'
 
 let client: QueryClient
@@ -61,7 +68,7 @@ describe('QuickCaptureInvalidator 主窗跨窗口失效', () => {
     expect(captured).toBeTypeOf('function')
   })
 
-  it('桥推送记录创建事件 → invalidateQueries 被调（全量失效，无 queryKey 过滤参数）', async () => {
+  it('桥推送记录创建事件 → invalidateQueries 全量失效 + router.invalidate 重跑 loader', async () => {
     mount()
     const invalidateSpy = vi.spyOn(client, 'invalidateQueries')
     await act(async () => {
@@ -71,6 +78,9 @@ describe('QuickCaptureInvalidator 主窗跨窗口失效', () => {
     expect(invalidateSpy).toHaveBeenCalledTimes(1)
     // 全量失效口径（复审 C2）：无 queryKey 过滤参数——零参调用
     expect(invalidateSpy).toHaveBeenCalledWith()
+    // 列表数据走 route loader（非 react-query）：必须同时重跑 loader，
+    // 否则新记录不会出现在需求列表（用户会以为要手动刷新）
+    expect(routerInvalidate).toHaveBeenCalledTimes(1)
   })
 
   it('desktopBridge 为 undefined（浏览器直开）→ 挂载不抛错、零订阅', () => {

package/src/components/desktop/quick-capture-invalidate.tsx

@@ -4,24 +4,30 @@
 
 // 主窗跨窗口失效（托盘 mini 快捷记录面板闭环第 4 步）：订阅
 // desktopBridge.onQuickCaptureCreated——mini 面板保存成功 → Electron main 广播
-// → 本组件失效 react-query 缓存。失效口径（复审 C2）：invalidateQueries() 全量
-// 失效（无 queryKey 过滤参数）——覆盖 projects-brief/workspaces-brief/story
-// 视图；低频事件成本可接受，不做精确 key 白名单。旧壳（无此方法）undefined、
-// 浏览器直开（无桥）null——可选链双保险优雅降级，挂载零成本零报错。
+// → 本组件刷新主窗数据。两条刷新通道缺一不可：
+//  ① invalidateQueries() 全量失效（复审 C2 口径）——覆盖 projects-brief /
+//     workspaces-brief / 通知等 react-query 缓存（灵感箱首建后侧边栏即时出现）；
+//  ② router.invalidate() 重跑 active route loader——需求列表/看板/日历的数据
+//     走 route loader + 组件内 reload 原语（非 react-query），仅失效 query 缓存
+//     不会让新记录出现在列表里（用户会以为「没保存，要手动刷新」）。
+// 旧壳（无此方法）undefined、浏览器直开（无桥）null——可选链双保险优雅降级。
 // 挂载点：providers（Providers 全页挂载，DesktopRenamedToast 旁）。
 import { useEffect } from "react"
 import { useQueryClient } from "@tanstack/react-query"
+import { useRouter } from "@tanstack/react-router"
 import { getDesktopBridge } from "@/lib/desktop-bridge-types"
 
 export function QuickCaptureInvalidator() {
   const queryClient = useQueryClient()
+  const router = useRouter()
 
   useEffect(() => {
     const off = getDesktopBridge()?.onQuickCaptureCreated?.(() => {
       void queryClient.invalidateQueries()
+      void router.invalidate()
     })
     return off
-  }, [queryClient])
+  }, [queryClient, router])
 
   return null
 }

package/src/components/quick-capture/__tests__/quick-capture-panel.test.tsx

@@ -55,6 +55,8 @@ const bridgeStub = vi.hoisted(() => {
     notifyQuickCapture: vi.fn(),
     setMiniPanelPinned: vi.fn(),
     popUpTrayMenu: vi.fn(),
+    openMainWindow: vi.fn(),
+    quitApp: vi.fn(),
     onMiniPanelMode: vi.fn((_cb: (mode: string) => void) => unsubMiniPanelMode),
     onMiniPanelPinned: vi.fn((_cb: (pinned: boolean) => void) => unsubMiniPanelPinned),
   }
@@ -317,11 +319,28 @@ describe('QuickCapturePanel', () => {
     )
   })
 
-  it('设置按钮：请求弹出托盘菜单（与菜单栏右键同一份）', async () => {
+  it('设置菜单在面板处打开（内容与托盘右键一致）：打开 AllBlue / 快捷记录灵感 / 退出', async () => {
     const user = userEvent.setup()
     renderPanel()
+    await screen.findByText('独立需求')
+    await user.click(screen.getByRole('button', { name: '设置' }))
+    // 面板内嵌菜单（不弹原生托盘菜单）
+    expect(await screen.findByText('打开 AllBlue')).toBeTruthy()
+    expect(screen.getByText('快捷记录需求')).toBeTruthy()
+    expect(screen.getByText('快捷记录灵感')).toBeTruthy()
+    expect(screen.getByText('退出 AllBlue')).toBeTruthy()
+    expect(bridgeStub.popUpTrayMenu).not.toHaveBeenCalled()
+    // 快捷记录灵感 → 面板切到灵感箱
+    await user.click(screen.getByText('快捷记录灵感'))
+    await waitFor(() => expect(screen.getByRole('button', { name: /灵感箱/ })).toBeTruthy())
+    // 打开主窗
+    await user.click(screen.getByRole('button', { name: '设置' }))
+    await user.click(await screen.findByText('打开 AllBlue'))
+    expect(bridgeStub.openMainWindow).toHaveBeenCalledTimes(1)
+    // 退出
     await user.click(screen.getByRole('button', { name: '设置' }))
-    expect(bridgeStub.popUpTrayMenu).toHaveBeenCalledTimes(1)
+    await user.click(await screen.findByText('退出 AllBlue'))
+    expect(bridgeStub.quitApp).toHaveBeenCalledTimes(1)
   })
 
   it('标题字号做 md 适配；编辑器收到 hideMobileToolbar（隐藏窄窗底部工具栏）', async () => {

package/src/components/quick-capture/quick-capture-panel.tsx

@@ -44,7 +44,13 @@ import { listProjectsBriefFn } from "@/server/serverFns/project"
 import { Button } from "@/components/ui/button"
 import { Input } from "@/components/ui/input"
 import { Popover, PopoverContent, PopoverTrigger } from "@/components/ui/popover"
-import { Tooltip, TooltipContent, TooltipTrigger } from "@/components/ui/tooltip"
+import {
+  DropdownMenu,
+  DropdownMenuContent,
+  DropdownMenuItem,
+  DropdownMenuSeparator,
+  DropdownMenuTrigger,
+} from "@/components/ui/dropdown-menu"
 import { toast } from "@/components/ui/toast"
 import { LucideIconByName } from "@/components/shared-kit/icons/lucide-icon-picker/lucide-icon-by-name"
 import { NotionDocEditor } from "@/components/tiptap/notion-like"
@@ -98,6 +104,11 @@ export function QuickCapturePanel({ initialMode }: { initialMode: QuickCaptureMo
   const [aiGenerating, setAiGenerating] = useState(false)
   const [isEditorFocused, setIsEditorFocused] = useState(false)
   const [pinned, setPinned] = useState(false)
+  // SSR/CSR 首帧一致性：AI 工具栏含 useToolbarOverflow 测量层（客户端首帧多一层
+  // DOM），直接 SSR 会 hydration mismatch（React 整树重建 → 输入框事件重绑，
+  // 表现为 Enter/Esc 时好时坏）。挂载后再渲染工具栏。
+  const [mounted, setMounted] = useState(false)
+  const [appVersion, setAppVersion] = useState("")
 
   const feedbackTimerRef = useRef<ReturnType<typeof setTimeout> | null>(null)
   // 保存防重：请求在途（标题尚未清空）期间忽略再次提交，防重复落库
@@ -170,6 +181,21 @@ export function QuickCapturePanel({ initialMode }: { initialMode: QuickCaptureMo
     return () => unsubscribe?.()
   }, [])
 
+  // 首帧一致性 + 版本号（设置菜单展示；旧壳无 appInfo 时留空）
+  useEffect(() => {
+    setMounted(true)
+  }, [])
+
+  useEffect(() => {
+    const bridge = getDesktopBridge()
+    void bridge
+      ?.appInfo?.()
+      .then((info) => {
+        if (info?.version) setAppVersion(info.version)
+      })
+      .catch(() => {})
+  }, [])
+
   // 反馈定时器 unmount 清理（组件销毁后不再 setState，防泄漏）
   useEffect(() => {
     return () => {
@@ -301,40 +327,63 @@ export function QuickCapturePanel({ initialMode }: { initialMode: QuickCaptureMo
           </span>
         </div>
         <div className="flex shrink-0 items-center gap-0.5">
-          <Tooltip>
-            <TooltipTrigger
-              render={
-                <Button
-                  type="button"
-                  variant="ghost"
-                  size="icon-sm"
-                  aria-label={m.quick_capture_pin()}
-                  aria-pressed={pinned}
-                  className={pinned ? "text-primary" : undefined}
-                  onClick={togglePinned}
-                />
-              }
-            >
-              {pinned ? <PinOff className="size-4" /> : <Pin className="size-4" />}
-            </TooltipTrigger>
-            <TooltipContent>{m.quick_capture_pin()}</TooltipContent>
-          </Tooltip>
-          <Tooltip>
-            <TooltipTrigger
+          <Button
+            type="button"
+            variant="ghost"
+            size="icon-sm"
+            aria-label={m.quick_capture_pin()}
+            aria-pressed={pinned}
+            className={pinned ? "text-primary" : undefined}
+            onClick={togglePinned}
+          >
+            {pinned ? <PinOff className="size-4" /> : <Pin className="size-4" />}
+          </Button>
+          <DropdownMenu>
+            <DropdownMenuTrigger
               render={
                 <Button
                   type="button"
                   variant="ghost"
                   size="icon-sm"
                   aria-label={m.quick_capture_settings()}
-                  onClick={() => getDesktopBridge()?.popUpTrayMenu?.()}
                 />
               }
             >
               <Settings className="size-4" />
-            </TooltipTrigger>
-            <TooltipContent>{m.quick_capture_settings()}</TooltipContent>
-          </Tooltip>
+            </DropdownMenuTrigger>
+            {/* 设置菜单在面板处弹出，内容与菜单栏图标右键菜单一致（打开/快捷记录/版本/退出） */}
+            <DropdownMenuContent align="end" className="w-48">
+              <DropdownMenuItem onClick={() => getDesktopBridge()?.openMainWindow?.()}>
+                {m.quick_capture_openMain()}
+              </DropdownMenuItem>
+              <DropdownMenuItem
+                onClick={() => {
+                  const pick = pickForMode("story")
+                  if (pick) handlePickProject(pick)
+                }}
+              >
+                {m.quick_capture_quickStory()}
+              </DropdownMenuItem>
+              <DropdownMenuItem
+                onClick={() => {
+                  const pick = pickForMode("inspiration")
+                  if (pick) handlePickProject(pick)
+                }}
+              >
+                {m.quick_capture_quickIdea()}
+              </DropdownMenuItem>
+              {appVersion ? (
+                <>
+                  <DropdownMenuSeparator />
+                  <DropdownMenuItem disabled>{`v${appVersion}`}</DropdownMenuItem>
+                </>
+              ) : null}
+              <DropdownMenuSeparator />
+              <DropdownMenuItem onClick={() => getDesktopBridge()?.quitApp?.()}>
+                {m.quick_capture_quit()}
+              </DropdownMenuItem>
+            </DropdownMenuContent>
+          </DropdownMenu>
         </div>
       </header>
 
@@ -438,16 +487,20 @@ export function QuickCapturePanel({ initialMode }: { initialMode: QuickCaptureMo
           </div>
 
           <div className="mr-2 mb-1 flex shrink-0 items-center justify-end gap-1">
-            <StoryAiToolbar
-              description={description.markdown}
-              title={name}
-              mode="editor"
-              editorRef={tiptapEditorRef}
-              model={aiModel}
-              groups={aiGroups}
-              onModelChange={setAiModel}
-              onGenerating={setAiGenerating}
-            />
+            {/* 挂载后才渲染：工具栏测量层（客户端首帧多一层 DOM）会造成 hydration
+                mismatch → React 整树重建 → 输入框事件重绑（快捷键时好时坏） */}
+            {mounted && (
+              <StoryAiToolbar
+                description={description.markdown}
+                title={name}
+                mode="editor"
+                editorRef={tiptapEditorRef}
+                model={aiModel}
+                groups={aiGroups}
+                onModelChange={setAiModel}
+                onGenerating={setAiGenerating}
+              />
+            )}
           </div>
         </div>
 

package/src/lib/__tests__/query-global-error.test.ts

@@ -51,6 +51,8 @@ async function executeFailingMutation(
 
 beforeEach(() => {
   vi.mocked(toast.error).mockClear()
+  // 取证钩子（handleGlobalError 内 console.error 打印具体错误）不污染测试输出
+  vi.spyOn(console, 'error').mockImplementation(() => {})
 })
 
 describe('QueryCache 全局 onError（web）', () => {

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

@@ -112,7 +112,7 @@ export const SDK_GROUPS: SdkGroup[] = [
     "items": [
       {
         "name": "@allbluecn/web-app",
-        "version": "v0.27.2",
+        "version": "v0.27.3",
         "lastUpdate": "Nov 5, 2026",
         "source": "apps/web/package.json",
         "docsUrl": "https://github.com/allbluecn/allblue"

package/src/lib/desktop-bridge-types.ts

@@ -110,6 +110,12 @@ export interface DesktopBridgeApi {
   setMiniPanelPinned?: (pinned: boolean) => void
   onMiniPanelPinned?: (cb: (pinned: boolean) => void) => () => void
   popUpTrayMenu?: () => void
+  /** mini 面板设置菜单（2026-11-05 追加，add-only）：
+   *  - openMainWindow：打开/前置主窗（菜单项「打开 AllBlue」）；
+   *  - quitApp：退出应用（菜单项「退出 AllBlue」，复用 before-quit 清理链）。
+   *  旧壳 undefined——调用方可选链降级。 */
+  openMainWindow?: () => void
+  quitApp?: () => void
 }
 
 /** A11 desktop-state 三态载荷（main 侧 desktop-state.json 持久化态的广播形状）：

package/src/lib/query-global-error.ts

@@ -69,6 +69,9 @@ function handleGlobalError(
     if (isGlobalToastSuppressed(error, meta)) return
     // toast 仅浏览器端有渲染通道，SSR 静默
     if (typeof window === 'undefined') return
+    // 取证钩子：toast 只给通用文案，具体错误落 console 便于用户/排查时定位
+    // （哪个 serverFn 失败、状态码、消息；不影响 toast 行为）
+    console.error('[query-global-error]', error)
     if (isClientErrorStatus(extractErrorStatus(error))) {
       // 4xx（非 401）：业务语义错误，展示详情；空消息回落通用文案
       toast.error(pickErrorMessage(error, new WeakSet()) ?? m.common_error_generic())

package/src/paraglide/messages/_index.js

@@ -3550,8 +3550,12 @@ export * from './prototypepanel_title1.js'
 export * from './quick_capture_failed.js'
 export * from './quick_capture_hint.js'
 export * from './quick_capture_inbox.js'
+export * from './quick_capture_openmain1.js'
 export * from './quick_capture_paneltitle1.js'
 export * from './quick_capture_pin.js'
+export * from './quick_capture_quickidea1.js'
+export * from './quick_capture_quickstory1.js'
+export * from './quick_capture_quit.js'
 export * from './quick_capture_saved.js'
 export * from './quick_capture_settings.js'
 export * from './quick_capture_submit.js'

package/src/paraglide/messages/quick_capture_openmain1.js

@@ -0,0 +1,30 @@
+/* eslint-disable */
+import { getLocale, experimentalStaticLocale } from '../runtime.js';
+
+/** @typedef {import('../runtime.js').LocalizedString} LocalizedString */
+
+/** @typedef {{}} Quick_Capture_Openmain1Inputs */
+
+const zh_quick_capture_openmain1 = /** @type {(inputs: Quick_Capture_Openmain1Inputs) => LocalizedString} */ () => {
+	return /** @type {LocalizedString} */ (`打开 AllBlue`)
+};
+
+const en_quick_capture_openmain1 = /** @type {(inputs: Quick_Capture_Openmain1Inputs) => LocalizedString} */ () => {
+	return /** @type {LocalizedString} */ (`Open AllBlue`)
+};
+
+/**
+* | output |
+* | --- |
+* | "Open AllBlue" |
+*
+* @param {Quick_Capture_Openmain1Inputs} inputs
+* @param {{ locale?: "zh" | "en" }} options
+* @returns {LocalizedString}
+*/
+const quick_capture_openmain1 = /** @type {((inputs?: Quick_Capture_Openmain1Inputs, options?: { locale?: "zh" | "en" }) => LocalizedString) & import('../runtime.js').MessageMetadata<Quick_Capture_Openmain1Inputs, { locale?: "zh" | "en" }, {}>} */ ((inputs = {}, options = {}) => {
+	const locale = experimentalStaticLocale ?? options.locale ?? getLocale()
+	if (locale === "en") return en_quick_capture_openmain1(inputs)
+	return zh_quick_capture_openmain1(inputs)
+});
+export { quick_capture_openmain1 as "quick_capture_openMain" }

package/src/paraglide/messages/quick_capture_quickidea1.js

@@ -0,0 +1,30 @@
+/* eslint-disable */
+import { getLocale, experimentalStaticLocale } from '../runtime.js';
+
+/** @typedef {import('../runtime.js').LocalizedString} LocalizedString */
+
+/** @typedef {{}} Quick_Capture_Quickidea1Inputs */
+
+const zh_quick_capture_quickidea1 = /** @type {(inputs: Quick_Capture_Quickidea1Inputs) => LocalizedString} */ () => {
+	return /** @type {LocalizedString} */ (`快捷记录灵感`)
+};
+
+const en_quick_capture_quickidea1 = /** @type {(inputs: Quick_Capture_Quickidea1Inputs) => LocalizedString} */ () => {
+	return /** @type {LocalizedString} */ (`Quick Idea`)
+};
+
+/**
+* | output |
+* | --- |
+* | "Quick Idea" |
+*
+* @param {Quick_Capture_Quickidea1Inputs} inputs
+* @param {{ locale?: "zh" | "en" }} options
+* @returns {LocalizedString}
+*/
+const quick_capture_quickidea1 = /** @type {((inputs?: Quick_Capture_Quickidea1Inputs, options?: { locale?: "zh" | "en" }) => LocalizedString) & import('../runtime.js').MessageMetadata<Quick_Capture_Quickidea1Inputs, { locale?: "zh" | "en" }, {}>} */ ((inputs = {}, options = {}) => {
+	const locale = experimentalStaticLocale ?? options.locale ?? getLocale()
+	if (locale === "en") return en_quick_capture_quickidea1(inputs)
+	return zh_quick_capture_quickidea1(inputs)
+});
+export { quick_capture_quickidea1 as "quick_capture_quickIdea" }

package/src/paraglide/messages/quick_capture_quickstory1.js

@@ -0,0 +1,30 @@
+/* eslint-disable */
+import { getLocale, experimentalStaticLocale } from '../runtime.js';
+
+/** @typedef {import('../runtime.js').LocalizedString} LocalizedString */
+
+/** @typedef {{}} Quick_Capture_Quickstory1Inputs */
+
+const zh_quick_capture_quickstory1 = /** @type {(inputs: Quick_Capture_Quickstory1Inputs) => LocalizedString} */ () => {
+	return /** @type {LocalizedString} */ (`快捷记录需求`)
+};
+
+const en_quick_capture_quickstory1 = /** @type {(inputs: Quick_Capture_Quickstory1Inputs) => LocalizedString} */ () => {
+	return /** @type {LocalizedString} */ (`Quick Story`)
+};
+
+/**
+* | output |
+* | --- |
+* | "Quick Story" |
+*
+* @param {Quick_Capture_Quickstory1Inputs} inputs
+* @param {{ locale?: "zh" | "en" }} options
+* @returns {LocalizedString}
+*/
+const quick_capture_quickstory1 = /** @type {((inputs?: Quick_Capture_Quickstory1Inputs, options?: { locale?: "zh" | "en" }) => LocalizedString) & import('../runtime.js').MessageMetadata<Quick_Capture_Quickstory1Inputs, { locale?: "zh" | "en" }, {}>} */ ((inputs = {}, options = {}) => {
+	const locale = experimentalStaticLocale ?? options.locale ?? getLocale()
+	if (locale === "en") return en_quick_capture_quickstory1(inputs)
+	return zh_quick_capture_quickstory1(inputs)
+});
+export { quick_capture_quickstory1 as "quick_capture_quickStory" }

package/src/paraglide/messages/quick_capture_quit.js

@@ -0,0 +1,29 @@
+/* eslint-disable */
+import { getLocale, experimentalStaticLocale } from '../runtime.js';
+
+/** @typedef {import('../runtime.js').LocalizedString} LocalizedString */
+
+/** @typedef {{}} Quick_Capture_QuitInputs */
+
+const zh_quick_capture_quit = /** @type {(inputs: Quick_Capture_QuitInputs) => LocalizedString} */ () => {
+	return /** @type {LocalizedString} */ (`退出 AllBlue`)
+};
+
+const en_quick_capture_quit = /** @type {(inputs: Quick_Capture_QuitInputs) => LocalizedString} */ () => {
+	return /** @type {LocalizedString} */ (`Quit AllBlue`)
+};
+
+/**
+* | output |
+* | --- |
+* | "Quit AllBlue" |
+*
+* @param {Quick_Capture_QuitInputs} inputs
+* @param {{ locale?: "zh" | "en" }} options
+* @returns {LocalizedString}
+*/
+export const quick_capture_quit = /** @type {((inputs?: Quick_Capture_QuitInputs, options?: { locale?: "zh" | "en" }) => LocalizedString) & import('../runtime.js').MessageMetadata<Quick_Capture_QuitInputs, { locale?: "zh" | "en" }, {}>} */ ((inputs = {}, options = {}) => {
+	const locale = experimentalStaticLocale ?? options.locale ?? getLocale()
+	if (locale === "en") return en_quick_capture_quit(inputs)
+	return zh_quick_capture_quit(inputs)
+});