@lobehub/lobehub 2.0.0-next.277 → 2.0.0-next.279

package/.cursor/rules/db-migrations.mdc

@@ -43,4 +43,4 @@ DROP TABLE "old_table";
 CREATE INDEX "users_email_idx" ON "users" ("email");
 ```
 
-**Important**: After modifying migration SQL (e.g., adding `IF NOT EXISTS` clauses), run `bun run db:generate-client` to update the hash in `packages/database/src/core/migrations.json`.
+**Important**: After modifying migration SQL (e.g., adding `IF NOT EXISTS` clauses), run `bun run db:generate:client` to update the hash in `packages/database/src/core/migrations.json`.

package/.cursor/rules/debug-usage.mdc

@@ -3,9 +3,10 @@ description: 包含添加 console.log 日志请求时
 globs:
 alwaysApply: false
 ---
+
 # Debug 包使用指南
 
-本项目使用 [debug](mdc:https:/github.com/debug-js/debug) 包进行调试日志记录。使用此规则来确保团队成员统一调试日志格式。
+本项目使用 `debug` 包进行调试日志记录。使用此规则来确保团队成员统一调试日志格式。
 
 ## 基本用法
 
@@ -15,14 +16,14 @@ alwaysApply: false
 import debug from 'debug';
 ```
 
-2. 创建一个命名空间的日志记录器：
+1. 创建一个命名空间的日志记录器：
 
 ```typescript
 // 格式: lobe:[模块]:[子模块]
 const log = debug('lobe-[模块名]:[子模块名]');
 ```
 
-3. 使用日志记录器：
+1. 使用日志记录器：
 
 ```typescript
 log('简单消息');
@@ -46,7 +47,7 @@ log('格式化数字: %d', number);
 
 ## 示例
 
-查看 [market/index.ts](mdc:src/server/routers/edge/market/index.ts) 中的使用示例：
+查看 `src/server/routers/edge/market/index.ts` 中的使用示例：
 
 ```typescript
 import debug from 'debug';
@@ -63,8 +64,9 @@ log('getAgent input: %O', input);
 ### 在浏览器中
 
 在控制台执行：
+
 ```javascript
-localStorage.debug = 'lobe-*'
+localStorage.debug = 'lobe-*';
 ```
 
 ### 在 Node.js 环境中

package/.cursor/rules/desktop-controller-tests.mdc

@@ -3,13 +3,14 @@ description: 桌面端测试
 globs:
 alwaysApply: false
 ---
+
 # 桌面端控制器单元测试指南
 
 ## 测试框架与目录结构
 
 LobeChat 桌面端使用 Vitest 作为测试框架。控制器的单元测试应放置在对应控制器文件同级的 `__tests__` 目录下，并以原控制器文件名加 `.test.ts` 作为文件名。
 
-```
+```plaintext
 apps/desktop/src/main/controllers/
 ├── __tests__/
 │   ├── index.test.ts

package/.cursor/rules/desktop-feature-implementation.mdc

@@ -3,7 +3,8 @@ description: 当要做 electron 相关工作时
 globs:
 alwaysApply: false
 ---
-**桌面端新功能实现指南**
+
+# 桌面端新功能实现指南
 
 ## 桌面端应用架构概述
 
@@ -26,6 +27,7 @@ LobeChat 桌面端基于 Electron 框架构建，采用主进程-渲染进程架
 ### 1. 确定功能需求与设计
 
 首先确定新功能的需求和设计，包括：
+
 - 功能描述和用例
 - 是否需要系统级API（如文件系统、网络等）
 - UI/UX设计（如必要）
@@ -64,9 +66,10 @@ LobeChat 桌面端基于 Electron 框架构建，采用主进程-渲染进程架
 
    ```typescript
    // src/services/electron/newFeatureService.ts
-   import { ensureElectronIpc } from '@/utils/electron/ipc';
    import type { NewFeatureParams } from '@lobechat/electron-client-ipc';
 
+   import { ensureElectronIpc } from '@/utils/electron/ipc';
+
    const ipc = ensureElectronIpc();
 
    export const newFeatureService = async (params: NewFeatureParams) => {
@@ -84,7 +87,7 @@ LobeChat 桌面端基于 Electron 框架构建，采用主进程-渲染进程架
 
 ### 5. 如果是新增内置工具，遵循工具实现流程
 
-参考 [desktop-local-tools-implement.mdc](mdc:desktop-local-tools-implement.mdc) 了解更多关于添加内置工具的详细步骤。
+参考 `desktop-local-tools-implement.mdc` 了解更多关于添加内置工具的详细步骤。
 
 ### 6. 添加测试
 
@@ -120,12 +123,13 @@ LobeChat 桌面端基于 Electron 框架构建，采用主进程-渲染进程架
 
 ```typescript
 // apps/desktop/src/main/controllers/NotificationCtr.ts
-import { Notification } from 'electron';
-import { ControllerModule, IpcMethod } from '@/controllers';
 import type {
   DesktopNotificationResult,
   ShowDesktopNotificationParams,
 } from '@lobechat/electron-client-ipc';
+import { Notification } from 'electron';
+
+import { ControllerModule, IpcMethod } from '@/controllers';
 
 export default class NotificationCtr extends ControllerModule {
   static override readonly groupName = 'notification';

package/.cursor/rules/desktop-local-tools-implement.mdc

@@ -3,78 +3,79 @@ description:
 globs:
 alwaysApply: false
 ---
+
 **新增桌面端工具流程:**
 
-1.  **定义工具接口 (Manifest):**
-    *   **文件:** `src/tools/[tool_category]/index.ts` (例如: `src/tools/local-files/index.ts`)
-    *   **操作:**
-        *   在 `ApiName` 对象（例如 `LocalFilesApiName`）中添加一个新的、唯一的 API 名称。
-        *   在 `Manifest` 对象（例如 `LocalFilesManifest`）的 `api` 数组中，新增一个对象来定义新工具的接口。
-        *   **关键字段:**
-            *   `name`: 使用上一步定义的 API 名称。
-            *   `description`: 清晰描述工具的功能，供 Agent 理解和向用户展示。
-            *   `parameters`: 使用 JSON Schema 定义工具所需的输入参数。
-                *   `type`: 通常是 'object'。
-                *   `properties`: 定义每个参数的名称、`description`、`type` (string, number, boolean, array, etc.)，使用英文。
-                *   `required`: 一个字符串数组，列出必须提供的参数名称。
+1. **定义工具接口 (Manifest):**
+   - **文件:** `src/tools/[tool_category]/index.ts` (例如: `src/tools/local-files/index.ts`)
+   - **操作:**
+     - 在 `ApiName` 对象（例如 `LocalFilesApiName`）中添加一个新的、唯一的 API 名称。
+     - 在 `Manifest` 对象（例如 `LocalFilesManifest`）的 `api` 数组中，新增一个对象来定义新工具的接口。
+     - **关键字段:**
+       - `name`: 使用上一步定义的 API 名称。
+       - `description`: 清晰描述工具的功能，供 Agent 理解和向用户展示。
+       - `parameters`: 使用 JSON Schema 定义工具所需的输入参数。
+         - `type`: 通常是 'object'。
+         - `properties`: 定义每个参数的名称、`description`、`type` (string, number, boolean, array, etc.)，使用英文。
+         - `required`: 一个字符串数组，列出必须提供的参数名称。
 
-2.  **定义相关类型:**
-    *   **文件 1:** `packages/electron-client-ipc/src/types.ts` (或类似的共享 IPC 类型文件)
-        *   **操作:** 定义传递给 IPC 事件的参数类型接口 (例如: `RenameLocalFileParams`, `MoveLocalFileParams`)。确保与 Manifest 中定义的 `parameters` 一致。
-    *   **文件 2:** `src/tools/[tool_category]/type.ts` (例如: `src/tools/local-files/type.ts`)
-        *   **操作:** 定义此工具执行后，存储在前端 Zustand Store 中的状态类型接口 (例如: `LocalRenameFileState`, `LocalMoveFileState`)。这通常包含操作结果（成功/失败）、错误信息以及相关数据（如旧路径、新路径等）。
+2. **定义相关类型:**
+   - **文件 1:** `packages/electron-client-ipc/src/types.ts` (或类似的共享 IPC 类型文件)
+     - **操作:** 定义传递给 IPC 事件的参数类型接口 (例如: `RenameLocalFileParams`, `MoveLocalFileParams`)。确保与 Manifest 中定义的 `parameters` 一致。
+   - **文件 2:** `src/tools/[tool_category]/type.ts` (例如: `src/tools/local-files/type.ts`)
+     - **操作:** 定义此工具执行后，存储在前端 Zustand Store 中的状态类型接口 (例如: `LocalRenameFileState`, `LocalMoveFileState`)。这通常包含操作结果（成功/失败）、错误信息以及相关数据（如旧路径、新路径等）。
 
-3.  **实现前端状态管理 (Store Action):**
-    *   **文件:** `src/store/chat/slices/builtinTool/actions/[tool_category].ts` (例如: `src/store/chat/slices/builtinTool/actions/localFile.ts`)
-    *   **操作:**
-        *   导入在步骤 2 中定义的 IPC 参数类型和状态类型。
-        *   在 Action 接口 (例如: `LocalFileAction`) 中添加新 Action 的方法签名，使用对应的 IPC 参数类型。
-        *   在 `createSlice` (例如: `localFileSlice`) 中实现该 Action 方法：
-            *   接收 `id` (消息 ID) 和 `params` (符合 IPC 参数类型)。
-            *   设置加载状态 (`toggleLocalFileLoading(id, true)`)。
-            *   调用对应的 `Service` 层方法 (见步骤 4)，传递 `params`。
-            *   使用 `try...catch` 处理 `Service` 调用可能发生的错误。
-            *   **成功时:**
-                *   调用 `updatePluginState(id, {...})` 更新插件状态，使用步骤 2 中定义的状态类型。
-                *   调用 `internal_updateMessageContent(id, JSON.stringify({...}))` 更新消息内容，通常包含成功确认信息。
-            *   **失败时:**
-                *   记录错误 (`console.error`)。
-                *   调用 `updatePluginState(id, {...})` 更新插件状态，包含错误信息。
-                *   调用 `internal_updateMessagePluginError(id, {...})` 设置消息的错误状态。
-                *   调用 `internal_updateMessageContent(id, JSON.stringify({...}))` 更新消息内容，包含错误信息。
-            *   在 `finally` 块中取消加载状态 (`toggleLocalFileLoading(id, false)`)。
-            *   返回操作是否成功 (`boolean`)。
+3. **实现前端状态管理 (Store Action):**
+   - **文件:** `src/store/chat/slices/builtinTool/actions/[tool_category].ts` (例如: `src/store/chat/slices/builtinTool/actions/localFile.ts`)
+   - **操作:**
+     - 导入在步骤 2 中定义的 IPC 参数类型和状态类型。
+     - 在 Action 接口 (例如: `LocalFileAction`) 中添加新 Action 的方法签名，使用对应的 IPC 参数类型。
+     - 在 `createSlice` (例如: `localFileSlice`) 中实现该 Action 方法：
+       - 接收 `id` (消息 ID) 和 `params` (符合 IPC 参数类型)。
+       - 设置加载状态 (`toggleLocalFileLoading(id, true)`)。
+       - 调用对应的 `Service` 层方法 (见步骤 4)，传递 `params`。
+       - 使用 `try...catch` 处理 `Service` 调用可能发生的错误。
+       - **成功时:**
+         - 调用 `updatePluginState(id, {...})` 更新插件状态，使用步骤 2 中定义的状态类型。
+         - 调用 `internal_updateMessageContent(id, JSON.stringify({...}))` 更新消息内容，通常包含成功确认信息。
+       - **失败时:**
+         - 记录错误 (`console.error`)。
+         - 调用 `updatePluginState(id, {...})` 更新插件状态，包含错误信息。
+         - 调用 `internal_updateMessagePluginError(id, {...})` 设置消息的错误状态。
+         - 调用 `internal_updateMessageContent(id, JSON.stringify({...}))` 更新消息内容，包含错误信息。
+       - 在 `finally` 块中取消加载状态 (`toggleLocalFileLoading(id, false)`)。
+       - 返回操作是否成功 (`boolean`)。
 
-4.  **实现 Service 层 (调用 IPC):**
-    *   **文件:** `src/services/electron/[tool_category]Service.ts` (例如: `src/services/electron/localFileService.ts`)
-    *   **操作:**
-        *   导入在步骤 2 中定义的 IPC 参数类型。
-        *   添加一个新的 `async` 方法，方法名通常与 Action 名称对应 (例如: `renameLocalFile`)。
-        *   方法接收 `params` (符合 IPC 参数类型)。
-        *   通过 `ensureElectronIpc()` 获取 IPC 代理 (`const ipc = ensureElectronIpc();`)，调用与 Manifest 中 `name` 字段匹配的链式方法，并将 `params` 传递过去。
-        *   定义方法的返回类型，通常是 `Promise<{ success: boolean; error?: string }>`，与后端 Controller 返回的结构一致。
+4. **实现 Service 层 (调用 IPC):**
+   - **文件:** `src/services/electron/[tool_category]Service.ts` (例如: `src/services/electron/localFileService.ts`)
+   - **操作:**
+     - 导入在步骤 2 中定义的 IPC 参数类型。
+     - 添加一个新的 `async` 方法，方法名通常与 Action 名称对应 (例如: `renameLocalFile`)。
+     - 方法接收 `params` (符合 IPC 参数类型)。
+     - 通过 `ensureElectronIpc()` 获取 IPC 代理 (`const ipc = ensureElectronIpc();`)，调用与 Manifest 中 `name` 字段匹配的链式方法，并将 `params` 传递过去。
+     - 定义方法的返回类型，通常是 `Promise<{ success: boolean; error?: string }>`，与后端 Controller 返回的结构一致。
 
-5.  **实现后端逻辑 (Controller / IPC Handler):**
-    *   **文件:** `apps/desktop/src/main/controllers/[ToolName]Ctr.ts` (例如: `apps/desktop/src/main/controllers/LocalFileCtr.ts`)
-    *   **操作:**
-        *   导入 Node.js 相关模块 (`fs`, `path` 等) 和 IPC 相关依赖 (`ControllerModule`, `IpcMethod`、参数类型等)。
-        *   添加一个新的 `async` 方法，方法名通常以 `handle` 开头 (例如: `handleRenameFile`)。
-        *   使用 `@IpcMethod()` 装饰器将此方法注册为对应 IPC 事件的处理器，确保方法名与 Manifest 中的 `name` 以及 Service 层的链式调用一致。
-        *   方法的参数应解构自 Service 层传递过来的对象，类型与步骤 2 中定义的 IPC 参数类型匹配。
-        *   实现核心业务逻辑：
-            *   进行必要的输入验证。
-            *   执行文件系统操作或其他后端任务 (例如: `fs.promises.rename`)。
-            *   使用 `try...catch` 捕获执行过程中的错误。
-            *   处理特定错误码 (`error.code`) 以提供更友好的错误消息。
-        *   返回一个包含 `success` (boolean) 和可选 `error` (string) 字段的对象。
+5. **实现后端逻辑 (Controller / IPC Handler):**
+   - **文件:** `apps/desktop/src/main/controllers/[ToolName]Ctr.ts` (例如: `apps/desktop/src/main/controllers/LocalFileCtr.ts`)
+   - **操作:**
+     - 导入 Node.js 相关模块 (`fs`, `path` 等) 和 IPC 相关依赖 (`ControllerModule`, `IpcMethod`、参数类型等)。
+     - 添加一个新的 `async` 方法，方法名通常以 `handle` 开头 (例如: `handleRenameFile`)。
+     - 使用 `@IpcMethod()` 装饰器将此方法注册为对应 IPC 事件的处理器，确保方法名与 Manifest 中的 `name` 以及 Service 层的链式调用一致。
+     - 方法的参数应解构自 Service 层传递过来的对象，类型与步骤 2 中定义的 IPC 参数类型匹配。
+     - 实现核心业务逻辑：
+       - 进行必要的输入验证。
+       - 执行文件系统操作或其他后端任务 (例如: `fs.promises.rename`)。
+       - 使用 `try...catch` 捕获执行过程中的错误。
+       - 处理特定错误码 (`error.code`) 以提供更友好的错误消息。
+     - 返回一个包含 `success` (boolean) 和可选 `error` (string) 字段的对象。
 
-6.  **更新 Agent 文档 (System Role):**
-    *   **文件:** `src/tools/[tool_category]/systemRole.ts` (例如: `src/tools/local-files/systemRole.ts`)
-    *   **操作:**
-        *   在 `<core_capabilities>` 部分添加新工具的简要描述。
-        *   如果需要，更新 `<workflow>`。
-        *   在 `<tool_usage_guidelines>` 部分为新工具添加详细的使用说明，解释其参数、用途和预期行为。
-        *   如有必要，更新 `<security_considerations>`。
-        *   如有必要（例如工具返回了新的数据结构或路径），更新 `<response_format>` 中的示例。
+6. **更新 Agent 文档 (System Role):**
+   - **文件:** `src/tools/[tool_category]/systemRole.ts` (例如: `src/tools/local-files/systemRole.ts`)
+   - **操作:**
+     - 在 `<core_capabilities>` 部分添加新工具的简要描述。
+     - 如果需要，更新 `<workflow>`。
+     - 在 `<tool_usage_guidelines>` 部分为新工具添加详细的使用说明，解释其参数、用途和预期行为。
+     - 如有必要，更新 `<security_considerations>`。
+     - 如有必要（例如工具返回了新的数据结构或路径），更新 `<response_format>` 中的示例。
 
 通过遵循这些步骤，可以系统地将新的桌面端工具集成到 LobeChat 的插件系统中。

package/.cursor/rules/desktop-menu-configuration.mdc

@@ -3,7 +3,8 @@ description:
 globs:
 alwaysApply: false
 ---
-**桌面端菜单配置指南**
+
+# 桌面端菜单配置指南
 
 ## 菜单系统概述
 
@@ -15,7 +16,7 @@ LobeChat 桌面应用有三种主要的菜单类型：
 
 ## 菜单相关文件结构
 
-```
+```plaintext
 apps/desktop/src/main/
 ├── menus/                 # 菜单定义
 │   ├── appMenu.ts         # 应用菜单配置
@@ -33,8 +34,9 @@ apps/desktop/src/main/
 应用菜单在 `apps/desktop/src/main/menus/appMenu.ts` 中定义：
 
 1. **导入依赖**
+
    ```typescript
-   import { app, BrowserWindow, Menu, MenuItem, MenuItemConstructorOptions } from 'electron';
+   import { BrowserWindow, Menu, MenuItem, MenuItemConstructorOptions, app } from 'electron';
    import { is } from 'electron-util';
    ```
 
@@ -43,6 +45,7 @@ apps/desktop/src/main/
    - 每个菜单项可以包含：label, accelerator (快捷键), role, submenu, click 等属性
 
 3. **创建菜单工厂函数**
+
    ```typescript
    export const createAppMenu = (win: BrowserWindow) => {
      const template = [
@@ -61,6 +64,7 @@ apps/desktop/src/main/
 上下文菜单通常在特定元素上右键点击时显示：
 
 1. **在主进程中定义菜单模板**
+
    ```typescript
    // apps/desktop/src/main/menus/contextMenu.ts
    export const createContextMenu = () => {
@@ -73,6 +77,7 @@ apps/desktop/src/main/
    ```
 
 2. **在适当的事件处理器中显示菜单**
+
    ```typescript
    const menu = createContextMenu();
    menu.popup();
@@ -83,11 +88,13 @@ apps/desktop/src/main/
 托盘菜单在 `TrayMenuCtr.ts` 中配置：
 
 1. **创建托盘图标**
+
    ```typescript
    this.tray = new Tray(trayIconPath);
    ```
 
 2. **定义托盘菜单**
+
    ```typescript
    const contextMenu = Menu.buildFromTemplate([
      { label: '显示主窗口', click: this.showMainWindow },
@@ -97,6 +104,7 @@ apps/desktop/src/main/
    ```
 
 3. **设置托盘菜单**
+
    ```typescript
    this.tray.setContextMenu(contextMenu);
    ```
@@ -106,11 +114,13 @@ apps/desktop/src/main/
 为菜单添加多语言支持：
 
 1. **导入本地化工具**
+
    ```typescript
    import { i18n } from '../locales';
    ```
 
 2. **使用翻译函数**
+
    ```typescript
    const template = [
      {
@@ -118,14 +128,13 @@ apps/desktop/src/main/
        submenu: [
          { label: i18n.t('menu.new'), click: createNew },
          // ...
-       ]
+       ],
      },
      // ...
    ];
    ```
 
-3. **在语言切换时更新菜单**
-   在 `MenuCtr.ts` 中监听语言变化事件并重新创建菜单
+3. **在语言切换时更新菜单** 在 `MenuCtr.ts` 中监听语言变化事件并重新创建菜单
 
 ## 添加新菜单项流程
 
@@ -134,6 +143,7 @@ apps/desktop/src/main/
    - 确定在菜单中的位置（主菜单项或子菜单项）
 
 2. **定义菜单项**
+
    ```typescript
    const newMenuItem: MenuItemConstructorOptions = {
      label: '新功能',
@@ -141,12 +151,11 @@ apps/desktop/src/main/
      click: (_, window) => {
        // 处理点击事件
        if (window) window.webContents.send('trigger-new-feature');
-     }
+     },
    };
    ```
 
-3. **添加到菜单模板**
-   将新菜单项添加到相应的菜单模板中
+3. **添加到菜单模板** 将新菜单项添加到相应的菜单模板中
 
 4. **对于与渲染进程交互的功能**
    - 使用 `window.webContents.send()` 发送 IPC 消息到渲染进程
@@ -157,6 +166,7 @@ apps/desktop/src/main/
 动态控制菜单项状态：
 
 1. **保存对菜单项的引用**
+
    ```typescript
    this.menuItems = {};
    const menu = Menu.buildFromTemplate(template);
@@ -164,6 +174,7 @@ apps/desktop/src/main/
    ```
 
 2. **根据条件更新状态**
+
    ```typescript
    updateMenuState(state) {
      if (this.menuItems.newFeature) {
@@ -179,6 +190,7 @@ apps/desktop/src/main/
 
 2. **平台特定菜单**
    - 使用 `process.platform` 检查为不同平台提供不同菜单
+
    ```typescript
    if (process.platform === 'darwin') {
      template.unshift({ role: 'appMenu' });

package/.cursor/rules/desktop-window-management.mdc

@@ -3,7 +3,8 @@ description:
 globs:
 alwaysApply: false
 ---
-**桌面端窗口管理指南**
+
+# 桌面端窗口管理指南
 
 ## 窗口管理概述
 
@@ -16,7 +17,7 @@ LobeChat 桌面应用使用 Electron 的 `BrowserWindow` 管理应用窗口。
 
 ## 相关文件结构
 
-```
+```plaintext
 apps/desktop/src/main/
 ├── appBrowsers.ts               # 窗口管理的核心文件
 ├── controllers/
@@ -63,6 +64,7 @@ export const createMainWindow = () => {
 实现窗口状态持久化保存和恢复：
 
 1. **保存窗口状态**
+
    ```typescript
    const saveWindowState = (window: BrowserWindow) => {
      if (!window.isMinimized() && !window.isMaximized()) {
@@ -80,6 +82,7 @@ export const createMainWindow = () => {
    ```
 
 2. **恢复窗口状态**
+
    ```typescript
    const restoreWindowState = (window: BrowserWindow) => {
      const savedState = settings.get('windowState');
@@ -96,6 +99,7 @@ export const createMainWindow = () => {
    ```
 
 3. **监听窗口事件**
+
    ```typescript
    window.on('close', () => saveWindowState(window));
    window.on('moved', () => saveWindowState(window));
@@ -107,6 +111,7 @@ export const createMainWindow = () => {
 对于需要多窗口支持的功能：
 
 1. **跟踪窗口**
+
    ```typescript
    export class WindowManager {
      private windows: Map<string, BrowserWindow> = new Map();
@@ -133,6 +138,7 @@ export const createMainWindow = () => {
    ```
 
 2. **窗口间通信**
+
    ```typescript
    // 从一个窗口向另一个窗口发送消息
    sendMessageToWindow(targetWindowId, channel, data) {
@@ -148,9 +154,11 @@ export const createMainWindow = () => {
 通过 IPC 实现窗口操作：
 
 1. **在主进程中注册 IPC 处理器**
+
    ```typescript
    // apps/desktop/src/main/controllers/BrowserWindowsCtr.ts
    import { BrowserWindow } from 'electron';
+
    import { ControllerModule, IpcMethod } from '@/controllers';
 
    export default class BrowserWindowsCtr extends ControllerModule {
@@ -178,10 +186,12 @@ export const createMainWindow = () => {
      }
    }
    ```
+
    - `@IpcMethod()` 根据控制器的 `groupName` 自动将方法映射为 `windows.minimizeWindow` 形式的通道名称。
    - 控制器需继承 `ControllerModule`，并在 `controllers/registry.ts` 中通过 `controllerIpcConstructors` 注册，便于类型生成。
 
 2. **在渲染进程中调用**
+
    ```typescript
    // src/services/electron/windowService.ts
    import { ensureElectronIpc } from '@/utils/electron/ipc';
@@ -194,6 +204,7 @@ export const createMainWindow = () => {
      close: () => ipc.windows.closeWindow(),
    };
    ```
+
    - `ensureElectronIpc()` 会基于 `DesktopIpcServices` 运行时生成 Proxy，并通过 `window.electronAPI.invoke` 与主进程通信；不再直接使用 `dispatch`。
 
 ### 5. 自定义窗口控制 (无边框窗口)
@@ -201,6 +212,7 @@ export const createMainWindow = () => {
 对于自定义窗口标题栏：
 
 1. **创建无边框窗口**
+
    ```typescript
    const window = new BrowserWindow({
      frame: false,
@@ -210,6 +222,7 @@ export const createMainWindow = () => {
    ```
 
 2. **在渲染进程中实现拖拽区域**
+
    ```css
    /* CSS */
    .titlebar {
@@ -229,6 +242,7 @@ export const createMainWindow = () => {
 
 2. **安全性**
    - 始终设置适当的 `webPreferences` 确保安全
+
    ```typescript
    webPreferences: {
      preload: path.join(__dirname, '../preload/index.js'),
@@ -255,6 +269,7 @@ export const createMainWindow = () => {
 ```typescript
 // apps/desktop/src/main/controllers/BrowserWindowsCtr.ts
 import type { OpenSettingsWindowOptions } from '@lobechat/electron-client-ipc';
+
 import { ControllerModule, IpcMethod } from '@/controllers';
 
 export default class BrowserWindowsCtr extends ControllerModule {

package/.cursor/rules/drizzle-schema-style-guide.mdc

@@ -10,14 +10,14 @@ This document outlines the conventions and best practices for defining PostgreSQ
 
 ## Configuration
 
-- Drizzle configuration is managed in [drizzle.config.ts](mdc:drizzle.config.ts)
+- Drizzle configuration is managed in `drizzle.config.ts`
 - Schema files are located in the src/database/schemas/ directory
 - Migration files are output to `src/database/migrations/`
 - The project uses `postgresql` dialect with `strict: true`
 
 ## Helper Functions
 
-Commonly used column definitions, especially for timestamps, are centralized in [src/database/schemas/\_helpers.ts](mdc:src/database/schemas/_helpers.ts):
+Commonly used column definitions, especially for timestamps, are centralized in `src/database/schemas/_helpers.ts`:
 
 - `timestamptz(name: string)`: Creates a timestamp column with timezone
 - `createdAt()`, `updatedAt()`, `accessedAt()`: Helper functions for standard timestamp columns
@@ -46,7 +46,7 @@ Commonly used column definitions, especially for timestamps, are centralized in
 
 ### Timestamps
 
-- Consistently use the `...timestamps` spread from [\_helpers.ts](mdc:src/database/schemas/_helpers.ts) for `created_at`, `updated_at`, and `accessed_at` columns
+- Consistently use the `...timestamps` spread from `_helpers.ts` for `created_at`, `updated_at`, and `accessed_at` columns
 
 ### Default Values
 
@@ -74,12 +74,12 @@ Commonly used column definitions, especially for timestamps, are centralized in
 
 ## Relations
 
-- Table relationships are defined centrally in [src/database/schemas/relations.ts](mdc:src/database/schemas/relations.ts) using the `relations()` utility from `drizzle-orm`
+- Table relationships are defined centrally in `src/database/schemas/relations.ts` using the `relations()` utility from `drizzle-orm`
 
 ## Code Style & Structure
 
-- **File Organization**: Each main database entity typically has its own schema file (e.g., [user.ts](mdc:src/database/schemas/user.ts), [agent.ts](mdc:src/database/schemas/agent.ts))
-- All schemas are re-exported from [src/database/schemas/index.ts](mdc:src/database/schemas/index.ts)
+- **File Organization**: Each main database entity typically has its own schema file (e.g., `user.ts`, `agent.ts`)
+- All schemas are re-exported from `src/database/schemas/index.ts`
 - **ESLint**: Files often start with `/* eslint-disable sort-keys-fix/sort-keys-fix */`
 - **Comments**: Use JSDoc-style comments to explain the purpose of tables and complex columns, fields that are self-explanatory do not require jsdoc explanations, such as id, user_id, etc.
 

package/.cursor/rules/hotkey.mdc

@@ -1,6 +1,7 @@
 ---
 alwaysApply: false
 ---
+
 # 如何添加新的快捷键：开发者指南
 
 本指南将带您一步步地向 LobeChat 添加一个新的快捷键功能。我们将通过一个完整示例，演示从定义到实现的整个过程。

package/.cursor/rules/i18n.mdc

@@ -37,6 +37,7 @@ export default {
 - `sync.status.ready` - Feature + group + status
 
 **Parameters:** Use `{{variableName}}` syntax
+
 ```typescript
 'alert.cloud.desc': '我们提供 {{credit}} 额度积分',
 ```

package/.cursor/rules/project-structure.mdc

@@ -1,6 +1,5 @@
 ---
-description: Project directory structure overview
-alwaysApply: false
+alwaysApply: true
 ---
 
 # LobeChat Project Structure
@@ -27,6 +26,11 @@ lobe-chat/
 │   ├── agent-runtime/
 │   ├── builtin-agents/
 │   ├── builtin-tool-*/           # builtin tool packages
+│   ├── business/                 # cloud-only business logic packages
+│   │   ├── config/
+│   │   ├── const/
+│   │   └── model-runtime/
+│   ├── config/
 │   ├── const/
 │   ├── context-engine/
 │   ├── conversation-flow/
@@ -36,6 +40,8 @@ lobe-chat/
 │   │       ├── schemas/
 │   │       └── repositories/
 │   ├── desktop-bridge/
+│   ├── edge-config/
+│   ├── editor-runtime/
 │   ├── electron-client-ipc/
 │   ├── electron-server-ipc/
 │   ├── fetch-sse/
@@ -46,7 +52,7 @@ lobe-chat/
 │   │   └── src/
 │   │       ├── core/
 │   │       └── providers/
-│   ├── obervability-otel/
+│   ├── observability-otel/
 │   ├── prompts/
 │   ├── python-interpreter/
 │   ├── ssrf-safe-fetch/
@@ -72,6 +78,10 @@ lobe-chat/
 │   │   │   ├── onboarding/
 │   │   │   └── router/
 │   │   └── desktop/
+│   ├── business/                 # cloud-only business logic (client/server)
+│   │   ├── client/
+│   │   ├── locales/
+│   │   └── server/
 │   ├── components/
 │   ├── config/
 │   ├── const/
@@ -130,6 +140,9 @@ lobe-chat/
   - Repository (bff-queries): `packages/database/src/repositories`
 - Third-party Integrations: `src/libs` — analytics, oidc etc.
 - Builtin Tools: `src/tools`, `packages/builtin-tool-*`
+- Business (cloud-only): Code specific to LobeHub cloud service, only expose empty interfaces for opens-source version.
+  - `src/business/*`
+  - `packages/business/*`
 
 ## Data Flow Architecture