@allbluecn/web-app 0.23.2 → 0.23.4

package/src/lib/hotkeys/registry.ts

@@ -74,6 +74,14 @@ export const appHotkeys = defineAppHotkeys({
     hotkey: "ArrowDown",
     meta: { descriptionKey: "common_hotkey_desc_chatNext", category: "聊天" },
   },
+  // 本地文件助手（桌面 P3-B5）中止运行：绑定点 components/desktop-agent/agent-chat.tsx
+  // （仅运行中 enabled）。Mod+. 取 macOS「Command-句点 = 取消」惯例；Escape 已被
+  // close-panel 全局占用（同 scope 即冲突）。Mod 组合在 ignoreInputs auto 下输入框
+  // 内同样生效（边输入边中止）
+  "agent-abort": {
+    hotkey: "Mod+.",
+    meta: { descriptionKey: "common_hotkey_desc_agentAbort", category: "聊天" },
+  },
   "command-palette": {
     hotkey: "Mod+K",
     meta: { descriptionKey: "common_hotkey_desc_commandPalette", category: "导航" },
@@ -165,7 +173,7 @@ export interface AppHotkeyConflict {
 
 /**
  * 声明级冲突检测：用官方 AppHotkeysStore.findConflicts 的冲突语义
- * （scope 相同或任一为 global，且组合键相等或序列互为前缀）对全部 25 条
+ * （scope 相同或任一为 global，且组合键相等或序列互为前缀）对全部 26 条
  * 声明两两比对。
  *
  * 注：官方 `findHotkeyConflicts()` 检测的是**运行时注册表**（HotkeyManager

package/src/lib/queries/README.md

@@ -65,3 +65,4 @@ export const xxxQueryOptions = (params) =>
 | `agents.ts` | `agents` / `skills` / `agent-bindings` / `persona-hint` | 新增常量；harness 同键查询已收拢 |
 | `team.ts` | `teamMembers` / `teamInvitations` / `teamUsers` | mention-dropdown 的 `teamUsers` 是另一数据源，未动（见上第 5 条） |
 | `compliance.ts` | `compliance` / `compliance-detail` / `entity-tags` / `favorite-ids` | detail / favorite-ids 双份合并；entityTags / favoriteIds 参数化 `entityType`，`legal`（laws）/ `dictionary` 模块可渐进复用 |
+| `desktop-agent.ts` | `desktop-agent` 前缀 / `desktop-agent,workspaces` | 本地文件助手（桌面 P3）授权目录清单；queryFn 走 desktopBridge.listWorkspaces（IPC，非 serverFn），无桥/旧壳降级 `[]` |

package/src/lib/queries/__tests__/desktop-agent-queries.test.ts

@@ -0,0 +1,80 @@
+// SPDX-License-Identifier: AGPL-3.0-or-later
+// AllBlue - 理想之海
+// Copyright (C) 2026 AllBlue Contributors
+
+// desktop-agent queryOptions 工厂（桌面本地优先 P3-B5）：key 结构单一来源 +
+// queryFn 走 desktopBridge.listWorkspaces（main 侧 workspaces.json），非桌面 /
+// 旧壳（无 listWorkspaces）降级空数组——本地桥数据，非 serverFn。
+import { beforeEach, describe, expect, it, vi } from 'vitest'
+import { QueryClient } from '@tanstack/react-query'
+
+const bridgeRef: { current: unknown } = { current: null }
+
+vi.mock('@/lib/desktop-bridge-types', () => ({
+  getDesktopBridge: () => bridgeRef.current,
+}))
+
+import {
+  DESKTOP_AGENT_QUERY_KEY,
+  DESKTOP_AGENT_WORKSPACES_QUERY_KEY,
+  desktopAgentWorkspacesQueryOptions,
+} from '../desktop-agent'
+
+beforeEach(() => {
+  bridgeRef.current = null
+})
+
+/** queryFn 运行时恒存在（工厂必传），类型上可选故窄化；context 形状对齐 react-query v5 调用面 */
+function invokeQueryFn(
+  options: { queryFn?: (...args: never[]) => unknown },
+  queryKey: readonly unknown[],
+): Promise<unknown> {
+  return (options.queryFn as (c: unknown) => Promise<unknown>)({
+    client: new QueryClient(),
+    queryKey,
+    signal: new AbortController().signal,
+    meta: undefined,
+  })
+}
+
+describe('desktop-agent queryOptions key 结构', () => {
+  it('前缀常量固定段 + workspaces 子段（invalidate 前缀覆盖全部 desktop-agent 查询）', () => {
+    expect(DESKTOP_AGENT_QUERY_KEY).toEqual(['desktop-agent'])
+    expect(DESKTOP_AGENT_WORKSPACES_QUERY_KEY).toEqual(['desktop-agent', 'workspaces'])
+  })
+
+  it('工厂产出 workspaces 常量同一引用（invalidate 与 useQuery 同源）', () => {
+    expect(desktopAgentWorkspacesQueryOptions().queryKey).toBe(DESKTOP_AGENT_WORKSPACES_QUERY_KEY)
+  })
+})
+
+describe('desktop-agent queryOptions queryFn 接线', () => {
+  it('桌面壳：调 desktopBridge.listWorkspaces() 并原样返回授权清单', async () => {
+    const listWorkspaces = vi.fn().mockResolvedValue(['/Users/x/proj-a', '/Users/x/proj-b'])
+    bridgeRef.current = { listWorkspaces }
+    const options = desktopAgentWorkspacesQueryOptions()
+    await expect(invokeQueryFn(options, options.queryKey)).resolves.toEqual([
+      '/Users/x/proj-a',
+      '/Users/x/proj-b',
+    ])
+    expect(listWorkspaces).toHaveBeenCalledWith()
+  })
+
+  it('无桥（云 Web / OSS）：返回空数组，不抛错', async () => {
+    bridgeRef.current = null
+    const options = desktopAgentWorkspacesQueryOptions()
+    await expect(invokeQueryFn(options, options.queryKey)).resolves.toEqual([])
+  })
+
+  it('旧壳（桥存在但无 listWorkspaces）：返回空数组（optional-chaining 降级）', async () => {
+    bridgeRef.current = { appInfo: vi.fn() }
+    const options = desktopAgentWorkspacesQueryOptions()
+    await expect(invokeQueryFn(options, options.queryKey)).resolves.toEqual([])
+  })
+
+  it('桥 IPC 失败：错误透传给 react-query（error 态由消费方渲染，不吞成空清单）', async () => {
+    bridgeRef.current = { listWorkspaces: vi.fn().mockRejectedValue(new Error('ipc down')) }
+    const options = desktopAgentWorkspacesQueryOptions()
+    await expect(invokeQueryFn(options, options.queryKey)).rejects.toThrow('ipc down')
+  })
+})

package/src/lib/queries/desktop-agent.ts

@@ -0,0 +1,25 @@
+// SPDX-License-Identifier: AGPL-3.0-or-later
+// AllBlue - 理想之海
+// Copyright (C) 2026 AllBlue Contributors
+
+// desktop-agent（本地文件助手，桌面本地优先 P3-B5）queryOptions 工厂（key +
+// queryFn 单一来源）。消费方（组件 useQuery / invalidate）一律从本模块取，禁止
+// 再写 ['desktop-agent', ...] 内联字面量。模式说明见 ./README.md。
+//
+// 数据源是桌面壳桥（desktopBridge.listWorkspaces → main 侧
+// userData/agent/workspaces.json），不是 serverFn：授权清单只存在于本机 main
+// 进程，renderer 经 IPC 读取。非桌面（云 Web / OSS，无桥）与旧壳（无此方法）
+// 降级空数组——入口本就被门控隐藏，降级只为让误用时不抛错。
+import { queryOptions } from '@tanstack/react-query'
+import { getDesktopBridge } from '@/lib/desktop-bridge-types'
+
+/** desktop-agent 全域前缀：invalidate 用它即覆盖本模块全部查询 */
+export const DESKTOP_AGENT_QUERY_KEY = ['desktop-agent'] as const
+export const DESKTOP_AGENT_WORKSPACES_QUERY_KEY = [...DESKTOP_AGENT_QUERY_KEY, 'workspaces'] as const
+
+/** 已授权工作目录清单（规范化绝对路径，main 侧 pickDirectory 写入顺序） */
+export const desktopAgentWorkspacesQueryOptions = () =>
+  queryOptions({
+    queryKey: DESKTOP_AGENT_WORKSPACES_QUERY_KEY,
+    queryFn: async (): Promise<string[]> => (await getDesktopBridge()?.listWorkspaces?.()) ?? [],
+  })

package/src/lib/session.ts

@@ -18,6 +18,10 @@
 import { getSession } from 'start-authjs'
 import type { AuthSession } from 'start-authjs'
 import { getAuthConfig } from './auth/auth.config'
+// A10（桌面本地优先 P2）：单条豁免 import（eslint 文件级放行）——
+// desktop-session-merge 为纯数据组装 + remote-auth 纯 fs 读取（node:fs +
+// env 守卫），无 prisma/server 重依赖链，客户端/云端部署零副作用。
+import { getDesktopRemoteSession } from '@/server/desktop-session-merge'
 
 export type SessionUser = NonNullable<AuthSession['user']> & {
   id?: string
@@ -42,7 +46,17 @@ export type Session = Omit<AuthSession, 'user'> & { user?: SessionUser | null }
 export async function getCurrentSession(request?: Request): Promise<Session | null> {
   if (!request) return null
   try {
-    return (await getSession(request, await getAuthConfig())) as Session | null
+    const session = (await getSession(request, await getAuthConfig())) as Session | null
+    // 有效性口径与 getSessionFn 一致：有 user.id 才算有效（session callback
+    // 对 DB 无行用户返回 user: null 的残影不算登录态）
+    if (session?.user?.id) return session
+    // 桌面本地优先（P2 A10）：authjs session 无效且为 desktop 部署时，回落
+    // remote-auth.json 的轻量云身份（user.id = 云 userId）。本函数是鉴权单点
+    // （requireAuth/authContextMiddleware 全链复用），回落在此一处生效、
+    // 604 处自动受益；非 desktop 恒 null（desktop 判定先于 fs 读取，零 IO）。
+    const remoteSession = await getDesktopRemoteSession()
+    if (remoteSession) return remoteSession
+    return session
   } catch (error) {
     // JWT 解密失败（AUTH_SECRET 轮换 / 跨应用同名 cookie 污染）等效于无 session：
     // 返回 null 走未登录分支；@auth/core 会自行清理坏 cookie。