@allbluecn/web-app 0.23.7 → 0.24.0

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

@@ -1,310 +0,0 @@
-// SPDX-License-Identifier: AGPL-3.0-or-later
-// AllBlue - 理想之海
-// Copyright (C) 2026 AllBlue Contributors
-
-// desktop-agent 连接（桌面本地优先 P3-B5）：调用时懒取 agent 端点 → 真实
-// fetchServerSentEvents 直连 http://127.0.0.1:{port}/prompt。fetch 打桩、SSE 解析
-// 走真实 @tanstack/ai-client 实现——请求线格式即与 Pro 端点的跨仓契约：URL /
-// X-Desktop-Token / X-Run-Id 头 / forwardedProps.cwd（端点 extractCwd 取值位）。
-// 两种壳形态各覆盖：新壳经 agentCredentials 按需取凭据（appInfo.agentToken 恒 null，
-// 不参与连接），旧壳回落 appInfo 的 agentPort/agentToken。
-import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest'
-import type { UIMessage } from '@tanstack/ai-client'
-
-type AppInfo = {
-  version: string
-  clientId: string
-  platform: string
-  backendPort: number | null
-  agentPort?: number | null
-  agentToken?: string | null
-}
-
-type AgentCredentials = { port: number; token: string }
-
-type Bridge = {
-  appInfo: () => Promise<AppInfo>
-  /** 新壳按需取凭据通道；旧壳无此方法（undefined） */
-  agentCredentials?: () => Promise<AgentCredentials | null>
-}
-
-const bridgeRef: { current: Bridge | null } = { current: null }
-
-vi.mock('@/lib/desktop-bridge-types', () => ({
-  getDesktopBridge: () => bridgeRef.current,
-}))
-
-import {
-  DesktopAgentUnavailableError,
-  createDesktopAgentConnection,
-  resolveDesktopAgentEndpoint,
-} from '../connection'
-
-const BASE_INFO: AppInfo = { version: '1.0.0', clientId: 'c1', platform: 'darwin', backendPort: 51000 }
-
-function bridgeWith(info: Partial<AppInfo>) {
-  return { appInfo: vi.fn(async () => ({ ...BASE_INFO, ...info })) }
-}
-
-/** 新壳桥：appInfo 里 agentPort 仍广播（门控用）、agentToken 恒 null；凭据走按需 IPC */
-function newShellBridge(credentials: AgentCredentials | null, info: Partial<AppInfo> = {}) {
-  return {
-    appInfo: vi.fn(async () => ({ ...BASE_INFO, agentPort: null, agentToken: null, ...info })),
-    agentCredentials: vi.fn(async () => credentials),
-  }
-}
-
-const encoder = new TextEncoder()
-function sse(event: Record<string, unknown>): Uint8Array {
-  return encoder.encode(`data: ${JSON.stringify(event)}\n\n`)
-}
-
-/** 打桩 fetch：返回给定 AG-UI 事件序列的 SSE 响应 */
-function stubSseFetch(events: Array<Record<string, unknown>>) {
-  const fetchMock = vi.fn(async (_url: string | URL | RequestInfo, _init?: RequestInit) => {
-    const stream = new ReadableStream<Uint8Array>({
-      start(c) {
-        for (const e of events) c.enqueue(sse(e))
-        c.close()
-      },
-    })
-    return new Response(stream, { status: 200, headers: { 'content-type': 'text/event-stream' } })
-  })
-  vi.stubGlobal('fetch', fetchMock)
-  return fetchMock
-}
-
-const RUN_EVENTS = [
-  { type: 'RUN_STARTED', threadId: 't-1', runId: 'r-1' },
-  { type: 'TEXT_MESSAGE_START', messageId: 'msg-1', role: 'assistant' },
-  { type: 'TEXT_MESSAGE_CONTENT', messageId: 'msg-1', delta: '目录里有 a.txt' },
-  { type: 'TEXT_MESSAGE_END', messageId: 'msg-1' },
-  { type: 'RUN_FINISHED', threadId: 't-1', runId: 'r-1' },
-]
-
-const USER_MESSAGE: UIMessage = { id: 'u1', role: 'user', parts: [{ type: 'text', content: '列出目录' }] }
-
-async function drain(iterable: AsyncIterable<unknown>): Promise<unknown[]> {
-  const out: unknown[] = []
-  for await (const chunk of iterable) out.push(chunk)
-  return out
-}
-
-beforeEach(() => {
-  bridgeRef.current = null
-})
-
-afterEach(() => {
-  vi.unstubAllGlobals()
-})
-
-describe('resolveDesktopAgentEndpoint（appInfo 懒取）', () => {
-  it('无桥（云 Web / OSS）→ null', async () => {
-    await expect(resolveDesktopAgentEndpoint()).resolves.toBeNull()
-  })
-
-  it('agent 未装配（agentPort/agentToken 为 null 或旧壳 undefined）→ null', async () => {
-    bridgeRef.current = bridgeWith({ agentPort: null, agentToken: null })
-    await expect(resolveDesktopAgentEndpoint()).resolves.toBeNull()
-    bridgeRef.current = bridgeWith({})
-    await expect(resolveDesktopAgentEndpoint()).resolves.toBeNull()
-  })
-
-  it('端口或令牌非法（越界 / 非整数 / 空令牌）→ null，不拼出坏 URL', async () => {
-    for (const agentPort of [0, 65536, 1.5, -1]) {
-      bridgeRef.current = bridgeWith({ agentPort, agentToken: 'tok' })
-      await expect(resolveDesktopAgentEndpoint()).resolves.toBeNull()
-    }
-    bridgeRef.current = bridgeWith({ agentPort: 4567, agentToken: '' })
-    await expect(resolveDesktopAgentEndpoint()).resolves.toBeNull()
-  })
-
-  it('就绪 → 127.0.0.1 端点 URL + 令牌', async () => {
-    bridgeRef.current = bridgeWith({ agentPort: 4567, agentToken: 'tok-abc' })
-    await expect(resolveDesktopAgentEndpoint()).resolves.toEqual({
-      url: 'http://127.0.0.1:4567/prompt',
-      token: 'tok-abc',
-    })
-  })
-
-  it('appInfo 抛错（IPC 断开 / main 未就绪）→ null，不流出原生错误原文', async () => {
-    bridgeRef.current = {
-      appInfo: vi.fn(async () => {
-        throw new Error('ipc closed')
-      }),
-    }
-    await expect(resolveDesktopAgentEndpoint()).resolves.toBeNull()
-  })
-})
-
-describe('resolveDesktopAgentEndpoint（新壳 agentCredentials 优先 / 旧壳回落 appInfo）', () => {
-  it('新壳：用 agentCredentials 的 {port, token} 构造端点，不读 appInfo 的令牌', async () => {
-    // appInfo 故意给一个不同的端口 + 陈旧令牌：端点必须只来自 agentCredentials
-    const bridge = newShellBridge({ port: 2468, token: 'tok-cred' }, { agentPort: 4567, agentToken: 'ok' })
-    bridgeRef.current = bridge
-    await expect(resolveDesktopAgentEndpoint()).resolves.toEqual({
-      url: 'http://127.0.0.1:2468/prompt',
-      token: 'tok-cred',
-    })
-    expect(bridge.agentCredentials).toHaveBeenCalledTimes(1)
-    expect(bridge.appInfo).not.toHaveBeenCalled()
-  })
-
-  it('新壳：agentCredentials 返回 null（未装配）或抛错（IPC 断开）→ null，不回落 appInfo', async () => {
-    const bridge = newShellBridge(null)
-    bridgeRef.current = bridge
-    await expect(resolveDesktopAgentEndpoint()).resolves.toBeNull()
-    expect(bridge.appInfo).not.toHaveBeenCalled()
-
-    bridgeRef.current = {
-      appInfo: vi.fn(async () => ({ ...BASE_INFO, agentPort: 4567, agentToken: null })),
-      agentCredentials: vi.fn(async () => {
-        throw new Error('ipc closed')
-      }),
-    }
-    await expect(resolveDesktopAgentEndpoint()).resolves.toBeNull()
-  })
-
-  it('新壳：agentCredentials 产出的端口/令牌非法 → null（与 appInfo 路径同口径）', async () => {
-    bridgeRef.current = newShellBridge({ port: 0, token: 'tok' })
-    await expect(resolveDesktopAgentEndpoint()).resolves.toBeNull()
-    bridgeRef.current = newShellBridge({ port: 4567, token: '' })
-    await expect(resolveDesktopAgentEndpoint()).resolves.toBeNull()
-  })
-
-  it('旧壳（无 agentCredentials）→ 回落 appInfo 的 agentPort + agentToken', async () => {
-    bridgeRef.current = bridgeWith({ agentPort: 4567, agentToken: 'tok-abc' })
-    await expect(resolveDesktopAgentEndpoint()).resolves.toEqual({
-      url: 'http://127.0.0.1:4567/prompt',
-      token: 'tok-abc',
-    })
-  })
-})
-
-describe('createDesktopAgentConnection（fetchServerSentEvents 包装）', () => {
-  it('端点不可用 → 抛 DesktopAgentUnavailableError，且不发起 fetch', async () => {
-    const fetchMock = stubSseFetch(RUN_EVENTS)
-    bridgeRef.current = bridgeWith({ agentPort: null, agentToken: null })
-    const connection = createDesktopAgentConnection()
-    await expect(
-      drain(connection.connect([USER_MESSAGE], undefined, undefined, { threadId: 't-1', runId: 'r-1' })),
-    ).rejects.toBeInstanceOf(DesktopAgentUnavailableError)
-    expect(fetchMock).not.toHaveBeenCalled()
-  })
-
-  it('appInfo 抛错 → 同样归「服务未就绪」（DesktopAgentUnavailableError），不发 fetch、不透出 IPC 原文', async () => {
-    const fetchMock = stubSseFetch(RUN_EVENTS)
-    bridgeRef.current = {
-      appInfo: vi.fn(async () => {
-        throw new Error('ipc closed')
-      }),
-    }
-    const error = await drain(
-      createDesktopAgentConnection().connect([USER_MESSAGE], undefined, undefined, { threadId: 't', runId: 'r' }),
-    ).catch((cause: unknown) => cause)
-    expect(error).toBeInstanceOf(DesktopAgentUnavailableError)
-    expect(fetchMock).not.toHaveBeenCalled()
-  })
-
-  it('请求线格式：URL / X-Desktop-Token / X-Run-Id / forwardedProps.cwd 与 Pro 端点契约一致', async () => {
-    const fetchMock = stubSseFetch(RUN_EVENTS)
-    bridgeRef.current = bridgeWith({ agentPort: 4567, agentToken: 'tok-abc' })
-    const connection = createDesktopAgentConnection()
-    await drain(
-      connection.connect([USER_MESSAGE], undefined, undefined, {
-        threadId: 't-1',
-        runId: 'r-1',
-        forwardedProps: { cwd: '/Users/x/proj' },
-      }),
-    )
-    expect(fetchMock).toHaveBeenCalledTimes(1)
-    const [url, init] = fetchMock.mock.calls[0]!
-    expect(url).toBe('http://127.0.0.1:4567/prompt')
-    expect(init?.method).toBe('POST')
-    const headers = init?.headers as Record<string, string>
-    expect(headers['X-Desktop-Token']).toBe('tok-abc')
-    expect(headers['X-Run-Id']).toBe('r-1')
-    expect(headers['Content-Type']).toBe('application/json')
-    const body = JSON.parse(String(init?.body)) as Record<string, unknown>
-    // 端点 extractCwd：顶层无 cwd，取 forwardedProps.cwd（fetchServerSentEvents 真实形态）
-    expect(body.cwd).toBeUndefined()
-    expect(body.forwardedProps).toEqual({ cwd: '/Users/x/proj' })
-    expect(body.threadId).toBe('t-1')
-    expect(body.runId).toBe('r-1')
-    // 端点 extractPrompt：messages 末条 user 消息文本（纯文本 content 为 string）
-    expect(body.messages).toEqual([expect.objectContaining({ role: 'user', content: '列出目录' })])
-  })
-
-  it('新壳：URL / X-Desktop-Token 取自 agentCredentials（appInfo 的 agentToken 恒 null 不参与）', async () => {
-    const fetchMock = stubSseFetch(RUN_EVENTS)
-    const bridge = newShellBridge({ port: 2468, token: 'tok-cred' }, { agentPort: 4567, agentToken: null })
-    bridgeRef.current = bridge
-    await drain(
-      createDesktopAgentConnection().connect([USER_MESSAGE], undefined, undefined, { threadId: 't-1', runId: 'r-1' }),
-    )
-    expect(fetchMock).toHaveBeenCalledTimes(1)
-    const [url, init] = fetchMock.mock.calls[0]!
-    expect(url).toBe('http://127.0.0.1:2468/prompt')
-    expect((init?.headers as Record<string, string>)['X-Desktop-Token']).toBe('tok-cred')
-    // 每次 connect 都重新按需取一次凭据（backend 重启换端口/令牌后下一问即用新值）
-    expect(bridge.agentCredentials).toHaveBeenCalledTimes(1)
-    expect(bridge.appInfo).not.toHaveBeenCalled()
-  })
-
-  it('新壳未装配（agentCredentials → null）→ 抛 DesktopAgentUnavailableError，不发 fetch', async () => {
-    const fetchMock = stubSseFetch(RUN_EVENTS)
-    bridgeRef.current = newShellBridge(null)
-    await expect(
-      drain(createDesktopAgentConnection().connect([USER_MESSAGE], undefined, undefined, { threadId: 't', runId: 'r' })),
-    ).rejects.toBeInstanceOf(DesktopAgentUnavailableError)
-    expect(fetchMock).not.toHaveBeenCalled()
-  })
-
-  it('SSE 帧原样产出为 AG-UI chunk（RUN_STARTED 起、RUN_FINISHED 止）', async () => {
-    stubSseFetch(RUN_EVENTS)
-    bridgeRef.current = bridgeWith({ agentPort: 4567, agentToken: 'tok-abc' })
-    const chunks = (await drain(
-      createDesktopAgentConnection().connect([USER_MESSAGE], undefined, undefined, {
-        threadId: 't-1',
-        runId: 'r-1',
-      }),
-    )) as Array<{ type: string }>
-    expect(chunks.map((c) => c.type)).toEqual([
-      'RUN_STARTED',
-      'TEXT_MESSAGE_START',
-      'TEXT_MESSAGE_CONTENT',
-      'TEXT_MESSAGE_END',
-      'RUN_FINISHED',
-    ])
-  })
-
-  it('旧壳：每次 connect 都重取 appInfo（backend 重启换端口/令牌后下一问即用新值）', async () => {
-    const fetchMock = stubSseFetch(RUN_EVENTS)
-    const appInfo = vi
-      .fn<() => Promise<AppInfo>>()
-      .mockResolvedValueOnce({ ...BASE_INFO, agentPort: 4567, agentToken: 'tok-old' })
-      .mockResolvedValueOnce({ ...BASE_INFO, agentPort: 5678, agentToken: 'tok-new' })
-    bridgeRef.current = { appInfo }
-    const connection = createDesktopAgentConnection()
-    const ctx = { threadId: 't-1', runId: 'r-1' }
-    await drain(connection.connect([USER_MESSAGE], undefined, undefined, ctx))
-    await drain(connection.connect([USER_MESSAGE], undefined, undefined, ctx))
-    expect(appInfo).toHaveBeenCalledTimes(2)
-    expect(fetchMock.mock.calls.map((c) => c[0])).toEqual([
-      'http://127.0.0.1:4567/prompt',
-      'http://127.0.0.1:5678/prompt',
-    ])
-    expect((fetchMock.mock.calls[1]![1]?.headers as Record<string, string>)['X-Desktop-Token']).toBe('tok-new')
-  })
-
-  it('端点非 2xx（如 401 令牌失效）→ 错误携带 status 透传给 useChat error 态', async () => {
-    vi.stubGlobal(
-      'fetch',
-      vi.fn(async () => new Response('{"error":"bad token"}', { status: 401, statusText: 'Unauthorized' })),
-    )
-    bridgeRef.current = bridgeWith({ agentPort: 4567, agentToken: 'tok-abc' })
-    await expect(
-      drain(createDesktopAgentConnection().connect([USER_MESSAGE], undefined, undefined, { threadId: 't', runId: 'r' })),
-    ).rejects.toMatchObject({ status: 401 })
-  })
-})

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

@@ -1,43 +0,0 @@
-// SPDX-License-Identifier: AGPL-3.0-or-later
-// AllBlue - 理想之海
-// Copyright (C) 2026 AllBlue Contributors
-
-// desktop-agent 错误文案映射（桌面本地优先 P3-B5）：useChat error 态 → 可读 i18n 文案。
-// 错误来源三类：连接包装（DesktopAgentUnavailableError）、端点非 2xx（官方
-// StreamHttpError 携带 status：401 令牌失效 / 403 目录未授权或 origin 被拒）、
-// 网络层（StreamReadError：端口不通 / CORS 预检被拒），其余（RUN_ERROR 等）透出原文。
-import { describe, expect, it } from 'vitest'
-import { m } from '@/paraglide/messages.js'
-import { DesktopAgentUnavailableError } from '../connection'
-import { describeDesktopAgentError } from '../errors'
-
-function withStatus(status: number): Error {
-  return Object.assign(new Error(`HTTP error! status: ${status}`), { name: 'StreamHttpError', status })
-}
-
-describe('describeDesktopAgentError', () => {
-  it('端点不可用 → 未就绪提示（实例与同名错误两种形态）', () => {
-    expect(describeDesktopAgentError(new DesktopAgentUnavailableError())).toBe(m.agent_desktop_errorUnavailable())
-    const renamed = Object.assign(new Error('x'), { name: 'DesktopAgentUnavailableError' })
-    expect(describeDesktopAgentError(renamed)).toBe(m.agent_desktop_errorUnavailable())
-  })
-
-  it('401 → 令牌失效提示；403 → 未授权/来源被拒提示', () => {
-    expect(describeDesktopAgentError(withStatus(401))).toBe(m.agent_desktop_errorUnauthorized())
-    expect(describeDesktopAgentError(withStatus(403))).toBe(m.agent_desktop_errorForbidden())
-  })
-
-  it('网络层失败（StreamReadError：端口不通 / CORS）→ 无法连接提示', () => {
-    const err = Object.assign(new Error('Failed to fetch'), { name: 'StreamReadError' })
-    expect(describeDesktopAgentError(err)).toBe(m.agent_desktop_errorConnection())
-  })
-
-  it('其余（RUN_ERROR、400、500 等）→ 运行失败 + 原文', () => {
-    expect(describeDesktopAgentError(new Error('模型配置缺失'))).toBe(
-      m.agent_desktop_errorGeneric({ message: '模型配置缺失' }),
-    )
-    expect(describeDesktopAgentError(withStatus(500))).toBe(
-      m.agent_desktop_errorGeneric({ message: 'HTTP error! status: 500' }),
-    )
-  })
-})

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

@@ -1,93 +0,0 @@
-// SPDX-License-Identifier: AGPL-3.0-or-later
-// AllBlue - 理想之海
-// Copyright (C) 2026 AllBlue Contributors
-
-// 本地文件助手的 agent 连接（桌面本地优先 P3-B5）：useChat 的 connection 适配。
-//
-// 端点 = Pro desktop 域 AgentService（B4）：backend utilityProcess 内 127.0.0.1
-// 随机端口 `POST /prompt`（AG-UI SSE），须带 `X-Desktop-Token`。端口与令牌经桌面桥
-// 取得，两种壳形态：
-// - 新壳：`desktopBridge.agentCredentials()` 按需 IPC 返回 { port, token }（令牌不再
-//   随 appInfo 常驻广播——常驻信息面会让任意 renderer JS（含 XSS）随时拿到令牌去读
-//   已授权目录；appInfo.agentToken 在新壳恒为 null 占位）。
-// - 旧壳（无 agentCredentials）：回落 `desktopBridge.appInfo()` 的 agentPort/agentToken。
-// backend 重启即换新值（main 侧 backend exit 清空），所以**每次请求时懒取**，不在组件
-// 顶层静态拼 URL。
-//
-// 为什么包一层而不是直接 fetchServerSentEvents(url, options)：其 url 参数只接受
-// 同步 getter，且在 connect() 内先于（可异步的）options 求值——URL 无法来自同一次
-// 调用里 await 的桥调用。包装只做「await 桥 → 构造 fetchServerSentEvents →
-// 原样委托 connect」，SSE 解析/AG-UI 协议/abort 全部是官方实现，无自定义协议面。
-//
-// 请求线格式（与 Pro 端点的跨仓契约，见 agent-service.ts extractCwd/extractPrompt）：
-// cwd 由 useChat `forwardedProps: { cwd }` 进 RunAgentInput.forwardedProps；端点
-// 取 messages 末条 user 消息为 prompt；X-Run-Id 头由官方客户端自动附带（端点预检已放行）。
-import { fetchServerSentEvents } from '@tanstack/ai-client'
-import type { ConnectConnectionAdapter } from '@tanstack/ai-client'
-import { getDesktopBridge } from '@/lib/desktop-bridge-types'
-
-export interface DesktopAgentEndpoint {
-  /** `http://127.0.0.1:{agentPort}/prompt` */
-  url: string
-  /** X-Desktop-Token 访问令牌（AgentService 每次启动随机生成） */
-  token: string
-}
-
-/** agent 端点不可用：无桥（云 Web / OSS）、旧壳（appInfo 无 agent 字段）、新壳未装配
- *  （agentCredentials 返回 null）、或 DESKTOP_AGENT 门控未开 / bundle 装配失败 */
-export class DesktopAgentUnavailableError extends Error {
-  constructor() {
-    super('desktop agent endpoint unavailable')
-    this.name = 'DesktopAgentUnavailableError'
-  }
-}
-
-/** 端口合法性（1..65535 整数）：非法即「不可用」，不拼出坏 URL */
-function isValidAgentPort(port: unknown): port is number {
-  return typeof port === 'number' && Number.isInteger(port) && port >= 1 && port <= 65535
-}
-
-/** 由端口 + 令牌构造端点；任一非法返回 null（不吞半截凭据）。令牌空串按不可用处理
- *  ——新壳 appInfo.agentToken 恒 null，回落路径若拿到空串说明壳未装配 */
-function buildEndpoint(port: unknown, token: unknown): DesktopAgentEndpoint | null {
-  if (!isValidAgentPort(port)) return null
-  if (typeof token !== 'string' || token === '') return null
-  return { url: `http://127.0.0.1:${port}/prompt`, token }
-}
-
-/** 调用时读取当前 agent 端点；不可用返回 null（端口/令牌非法同样视为不可用，不拼坏 URL）。
- *  取端点优先 agentCredentials（新壳按需取凭证），旧壳回落 appInfo 的 agentPort/agentToken。 */
-export async function resolveDesktopAgentEndpoint(): Promise<DesktopAgentEndpoint | null> {
-  const bridge = getDesktopBridge()
-  if (!bridge) return null
-  // 新壳独占使用 agentCredentials：其存在即表示令牌不再经 appInfo 广播，回落拿到
-  // 的只会是恒 null 占位，无收益。IPC 断开/main 未就绪时抛错与 appInfo 同口径归
-  // 「服务未就绪」（不可用），不把原生错误原文透出成「运行失败：<原文>」
-  if (typeof bridge.agentCredentials === 'function') {
-    const credentials = await bridge.agentCredentials().catch(() => null)
-    if (!credentials) return null
-    return buildEndpoint(credentials.port, credentials.token)
-  }
-  // 旧壳：端口/令牌同随 appInfo 广播
-  const info = await bridge.appInfo().catch(() => null)
-  if (!info) return null
-  return buildEndpoint(info.agentPort, info.agentToken)
-}
-
-/**
- * useChat 的 connection：每次 connect 懒取端点后委托官方 fetchServerSentEvents。
- * `resolveEndpoint` 可注入（测试 / 未来多端点），缺省读 desktopBridge.appInfo。
- */
-export function createDesktopAgentConnection(
-  resolveEndpoint: () => Promise<DesktopAgentEndpoint | null> = resolveDesktopAgentEndpoint,
-): ConnectConnectionAdapter {
-  return {
-    async *connect(messages, data, abortSignal, runContext) {
-      const endpoint = await resolveEndpoint()
-      if (!endpoint) throw new DesktopAgentUnavailableError()
-      yield* fetchServerSentEvents(endpoint.url, {
-        headers: { 'X-Desktop-Token': endpoint.token },
-      }).connect(messages, data, abortSignal, runContext)
-    },
-  }
-}

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

@@ -1,21 +0,0 @@
-// SPDX-License-Identifier: AGPL-3.0-or-later
-// AllBlue - 理想之海
-// Copyright (C) 2026 AllBlue Contributors
-
-// 本地文件助手错误文案映射（桌面本地优先 P3-B5）：把 useChat 的 error 态翻译成
-// 用户可读的 i18n 文案。三类可归因错误：
-// - 端点不可用（DesktopAgentUnavailableError）：无桥 / 旧壳 / agent 未装配
-// - 端点非 2xx（@tanstack/ai-client StreamHttpError，带 status）：401 令牌失效
-//   （backend 重启换了令牌，下一问懒取即恢复）、403 目录未授权或 origin 被拒
-// - 网络层（StreamReadError）：端口不通、CORS 预检被拒（浏览器只给 TypeError）
-// 其余（RUN_ERROR 的 agent 失败原因、400/5xx 等）原文透出，便于排障。
-import { m } from '@/paraglide/messages.js'
-
-export function describeDesktopAgentError(error: Error): string {
-  if (error.name === 'DesktopAgentUnavailableError') return m.agent_desktop_errorUnavailable()
-  const status = (error as { status?: unknown }).status
-  if (status === 401) return m.agent_desktop_errorUnauthorized()
-  if (status === 403) return m.agent_desktop_errorForbidden()
-  if (error.name === 'StreamReadError') return m.agent_desktop_errorConnection()
-  return m.agent_desktop_errorGeneric({ message: error.message || String(error) })
-}

package/src/paraglide/messages/agent_desktop_title.js

@@ -1,29 +0,0 @@
-/* eslint-disable */
-import { getLocale, experimentalStaticLocale } from '../runtime.js';
-
-/** @typedef {import('../runtime.js').LocalizedString} LocalizedString */
-
-/** @typedef {{}} Agent_Desktop_TitleInputs */
-
-const zh_agent_desktop_title = /** @type {(inputs: Agent_Desktop_TitleInputs) => LocalizedString} */ () => {
-	return /** @type {LocalizedString} */ (`本地文件助手`)
-};
-
-const en_agent_desktop_title = /** @type {(inputs: Agent_Desktop_TitleInputs) => LocalizedString} */ () => {
-	return /** @type {LocalizedString} */ (`Local File Assistant`)
-};
-
-/**
-* | output |
-* | --- |
-* | "Local File Assistant" |
-*
-* @param {Agent_Desktop_TitleInputs} inputs
-* @param {{ locale?: "zh" | "en" }} options
-* @returns {LocalizedString}
-*/
-export const agent_desktop_title = /** @type {((inputs?: Agent_Desktop_TitleInputs, options?: { locale?: "zh" | "en" }) => LocalizedString) & import('../runtime.js').MessageMetadata<Agent_Desktop_TitleInputs, { locale?: "zh" | "en" }, {}>} */ ((inputs = {}, options = {}) => {
-	const locale = experimentalStaticLocale ?? options.locale ?? getLocale()
-	if (locale === "en") return en_agent_desktop_title(inputs)
-	return zh_agent_desktop_title(inputs)
-});

package/src/paraglide/messages/common_hotkey_desc_agentabort1.d.ts

@@ -1,17 +0,0 @@
-export { common_hotkey_desc_agentabort1 as "common_hotkey_desc_agentAbort" };
-export type LocalizedString = import("../runtime.js").LocalizedString;
-export type Common_Hotkey_Desc_Agentabort1Inputs = {};
-/**
-* | output |
-* | --- |
-* | "Stop the local file assistant" |
-*
-* @param {Common_Hotkey_Desc_Agentabort1Inputs} inputs
-* @param {{ locale?: "zh" | "en" }} options
-* @returns {LocalizedString}
-*/
-declare const common_hotkey_desc_agentabort1: ((inputs?: Common_Hotkey_Desc_Agentabort1Inputs, options?: {
-    locale?: "zh" | "en";
-}) => LocalizedString) & import("../runtime.js").MessageMetadata<Common_Hotkey_Desc_Agentabort1Inputs, {
-    locale?: "zh" | "en";
-}, {}>;

package/src/paraglide/messages/common_hotkey_desc_agentabort1.js

@@ -1,30 +0,0 @@
-/* eslint-disable */
-import { getLocale, experimentalStaticLocale } from '../runtime.js';
-
-/** @typedef {import('../runtime.js').LocalizedString} LocalizedString */
-
-/** @typedef {{}} Common_Hotkey_Desc_Agentabort1Inputs */
-
-const zh_common_hotkey_desc_agentabort1 = /** @type {(inputs: Common_Hotkey_Desc_Agentabort1Inputs) => LocalizedString} */ () => {
-	return /** @type {LocalizedString} */ (`中止本地文件助手运行`)
-};
-
-const en_common_hotkey_desc_agentabort1 = /** @type {(inputs: Common_Hotkey_Desc_Agentabort1Inputs) => LocalizedString} */ () => {
-	return /** @type {LocalizedString} */ (`Stop the local file assistant`)
-};
-
-/**
-* | output |
-* | --- |
-* | "Stop the local file assistant" |
-*
-* @param {Common_Hotkey_Desc_Agentabort1Inputs} inputs
-* @param {{ locale?: "zh" | "en" }} options
-* @returns {LocalizedString}
-*/
-const common_hotkey_desc_agentabort1 = /** @type {((inputs?: Common_Hotkey_Desc_Agentabort1Inputs, options?: { locale?: "zh" | "en" }) => LocalizedString) & import('../runtime.js').MessageMetadata<Common_Hotkey_Desc_Agentabort1Inputs, { locale?: "zh" | "en" }, {}>} */ ((inputs = {}, options = {}) => {
-	const locale = experimentalStaticLocale ?? options.locale ?? getLocale()
-	if (locale === "en") return en_common_hotkey_desc_agentabort1(inputs)
-	return zh_common_hotkey_desc_agentabort1(inputs)
-});
-export { common_hotkey_desc_agentabort1 as "common_hotkey_desc_agentAbort" }

package/src/routes/-tests/agent-gate.test.ts

@@ -1,45 +0,0 @@
-// SPDX-License-Identifier: AGPL-3.0-or-later
-// AllBlue - 理想之海
-// Copyright (C) 2026 AllBlue Contributors
-
-// 本地文件助手页（/_nav/agent）路由门控（桌面本地优先 P3-B5）：依赖桌面壳
-// AgentService，云 Web / OSS 构建无此页——beforeLoad 以构建期常量
-// isDesktopEdition（VITE_DEPLOY_TARGET）判定，非桌面构建直接 throw notFound
-// （SSR 即 404，无占位闪烁）。运行时的桥探测（useDesktopAgentPresence）另由
-// lib/desktop-agent/__tests__/use-desktop-agent-presence.test.tsx 覆盖。
-// 断言方式同 -edition-routing.test.tsx：直接调 Route.options.beforeLoad。
-import { afterEach, describe, expect, it, vi } from 'vitest'
-
-async function importAgentRoute(desktop: boolean) {
-  vi.resetModules()
-  vi.doMock('@/lib/edition-desktop', () => ({ isDesktopEdition: () => desktop }))
-  return import('../_nav/agent/route')
-}
-
-/** beforeLoad 抛出的 notFound 对象（@tanstack/router-core：{ isNotFound: true }） */
-function catchNotFound(fn: () => unknown): { isNotFound?: boolean } | null {
-  try {
-    fn()
-    return null
-  } catch (error) {
-    return error as { isNotFound?: boolean }
-  }
-}
-
-afterEach(() => {
-  vi.doUnmock('@/lib/edition-desktop')
-  vi.resetModules()
-})
-
-describe('/_nav/agent beforeLoad 门控', () => {
-  it('非桌面构建（云 Web / OSS）：throw notFound（页面不存在，SSR 即 404）', async () => {
-    const { Route } = await importAgentRoute(false)
-    const result = catchNotFound(() => Route.options.beforeLoad!({} as never))
-    expect(result?.isNotFound).toBe(true)
-  })
-
-  it('桌面构建：放行（运行时无桥由 lazy 组件的 useDesktopAgentPresence 落到 NotFound）', async () => {
-    const { Route } = await importAgentRoute(true)
-    expect(Route.options.beforeLoad!({} as never)).toBeUndefined()
-  })
-})

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

@@ -1,63 +0,0 @@
-// SPDX-License-Identifier: AGPL-3.0-or-later
-// AllBlue - 理想之海
-// Copyright (C) 2026 AllBlue Contributors
-
-// 本地文件助手页（桌面本地优先 P3-B5）：授权目录卡 + agent 对话区。门控说明见
-// 同目录 route.tsx；本文件承担运行时桥探测（mounted 模式：SSR / hydration 首帧
-// 渲染空白、不读 window，挂载后 Electron 恢复页面，无桥即 NotFound）。
-//
-// 双层判定：presence（含 agentPort 装配，见 lib/desktop-agent/availability）决定
-// 页面是否可达；isAgentWorkspaceSupported（B1 三方法）决定目录授权是否可用——
-// 旧壳缺三方法时整页只留升级提示，不渲染对话区（否则对话区「请先添加授权目录」
-// 与卡片「请升级客户端」互相打脸）。
-import { useState } from 'react'
-import { createLazyFileRoute } from '@tanstack/react-router'
-import { useQuery } from '@tanstack/react-query'
-import { AgentChat } from '@/components/desktop-agent/agent-chat'
-import { AgentWorkspaceCard } from '@/components/desktop-agent/agent-workspace-card'
-import { isAgentWorkspaceSupported } from '@/lib/desktop-agent/availability'
-import { useDesktopAgentPresence } from '@/lib/desktop-agent/use-desktop-agent-presence'
-import { desktopAgentWorkspacesQueryOptions } from '@/lib/queries/desktop-agent'
-import { m } from '@/paraglide/messages.js'
-import { NavNotFound } from '../-components/nav-not-found'
-
-export const Route = createLazyFileRoute('/_nav/agent')({
-  component: DesktopAgentRoute,
-})
-
-function DesktopAgentRoute() {
-  const presence = useDesktopAgentPresence()
-  if (presence === 'pending') return null
-  if (presence === 'absent') return <NavNotFound />
-  return <DesktopAgentPage />
-}
-
-function DesktopAgentPage() {
-  const supportsWorkspaces = isAgentWorkspaceSupported()
-  // enabled 与卡片同口径：不支持目录授权时不查清单，避免无效 IPC
-  const { data: workspaces = [] } = useQuery({
-    ...desktopAgentWorkspacesQueryOptions(),
-    enabled: supportsWorkspaces,
-  })
-  const [picked, setPicked] = useState<string | null>(null)
-  const [running, setRunning] = useState(false)
-  // 未选择 / 选中项已被撤销 → 回落清单首项（清单为空则 null，对话区禁用输入）
-  const cwd = picked !== null && workspaces.includes(picked) ? picked : (workspaces[0] ?? null)
-
-  return (
-    <div className="flex h-full min-h-0 flex-col gap-4 overflow-hidden p-6">
-      <header className="space-y-1">
-        <h1 className="text-lg font-semibold">{m.agent_desktop_title()}</h1>
-        <p className="text-sm text-muted-foreground">{m.agent_desktop_pageDescription()}</p>
-      </header>
-      <div className="flex min-h-0 flex-1 flex-col gap-4 lg:flex-row">
-        <div className="shrink-0 lg:w-80 lg:overflow-y-auto">
-          <AgentWorkspaceCard selected={cwd} onSelect={setPicked} disabled={running} />
-        </div>
-        {/* 旧壳（无目录授权 IPC）只留卡片里的升级提示；否则每个目录一份会话
-            （换目录即新会话，运行中由 disabled 锁定切换） */}
-        {supportsWorkspaces && <AgentChat key={cwd ?? 'none'} cwd={cwd} onRunningChange={setRunning} />}
-      </div>
-    </div>
-  )
-}