feat: add fadeInWithBlur animation to Tailwind CSS and update Markdown component

- Introduced a new `fadeInWithBlur` keyframe animation in Tailwind CSS for enhanced visual effects.
- Removed inline fade animation styles from the `Markdown` component to streamline rendering.
- Updated the `SmoothFade` function to utilize the new animation, improving the user experience during content transitions.

.github/CODEOWNERS

@@ -1,11 +1,4 @@
 /src/renderer/src/store/ @0xfullex
 /src/main/services/ConfigManager.ts @0xfullex
 /packages/shared/IpcChannel.ts @0xfullex
-/src/main/ipc.ts @0xfullex
-
-/migrations/ @0xfullex
-/packages/shared/data/ @0xfullex
-/src/main/data/ @0xfullex
-/src/renderer/src/data/ @0xfullex
-
-/packages/ui/ @MyPrototypeWhat
+/src/main/ipc.ts @0xfullex

.github/workflows/auto-i18n.yml

@@ -2,8 +2,8 @@ name: Auto I18N
 
 env:
   API_KEY: ${{ secrets.TRANSLATE_API_KEY }}
-  MODEL: ${{ vars.AUTO_I18N_MODEL || 'deepseek/deepseek-v3.1'}}
-  BASE_URL: ${{ vars.AUTO_I18N_BASE_URL || 'https://api.ppinfra.com/openai'}}
+  MODEL: ${{ vars.MODEL || 'deepseek/deepseek-v3.1'}}
+  BASE_URL: ${{ vars.BASE_URL || 'https://api.ppinfra.com/openai'}}
 
 on:
   pull_request:
@@ -26,7 +26,7 @@ jobs:
           ref: ${{ github.event.pull_request.head.ref }}
 
       - name: 📦 Setting Node.js
-        uses: actions/setup-node@v5
+        uses: actions/setup-node@v4
         with:
           node-version: 20
 

.github/workflows/claude-code-review.yml

@@ -27,7 +27,7 @@ jobs:
 
     steps:
       - name: Checkout repository
-        uses: actions/checkout@v5
+        uses: actions/checkout@v4
         with:
           fetch-depth: 1
 

.github/workflows/claude-translator.yml

@@ -16,13 +16,10 @@ on:
 jobs:
   translate:
     if: |
-      (github.event_name == 'issues')
-      || (github.event_name == 'issue_comment' && github.event.sender.type != 'Bot')
-      || (
-        (github.event_name == 'pull_request_review' || github.event_name == 'pull_request_review_comment')
-        && github.event.sender.type != 'Bot'
-        && github.event.pull_request.head.repo.fork == false
-      )
+      (github.event_name == 'issues') ||
+      (github.event_name == 'issue_comment' && github.event.sender.type != 'Bot') ||
+      (github.event_name == 'pull_request_review' && github.event.sender.type != 'Bot') ||
+      (github.event_name == 'pull_request_review_comment' && github.event.sender.type != 'Bot')
     runs-on: ubuntu-latest
     permissions:
       contents: read
@@ -32,7 +29,7 @@ jobs:
 
     steps:
       - name: Checkout repository
-        uses: actions/checkout@v5
+        uses: actions/checkout@v4
         with:
           fetch-depth: 1
 

.github/workflows/claude.yml

@@ -37,7 +37,7 @@ jobs:
       actions: read # Required for Claude to read CI results on PRs
     steps:
       - name: Checkout repository
-        uses: actions/checkout@v5
+        uses: actions/checkout@v4
         with:
           fetch-depth: 1
 

.github/workflows/delete-branch.yml

@@ -12,7 +12,7 @@ jobs:
     if: github.event.pull_request.merged == true && github.event.pull_request.head.repo.full_name == github.repository
     steps:
       - name: Delete merged branch
-        uses: actions/github-script@v8
+        uses: actions/github-script@v7
         with:
           script: |
             github.rest.git.deleteRef({

.github/workflows/nightly-build.yml

@@ -56,7 +56,7 @@ jobs:
           ref: main
 
       - name: Install Node.js
-        uses: actions/setup-node@v5
+        uses: actions/setup-node@v4
         with:
           node-version: 20
 
@@ -99,9 +99,9 @@ jobs:
           GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
           NODE_OPTIONS: --max-old-space-size=8192
           MAIN_VITE_CHERRYAI_CLIENT_SECRET: ${{ secrets.MAIN_VITE_CHERRYAI_CLIENT_SECRET }}
-          MAIN_VITE_MINERU_API_KEY: ${{ secrets.MAIN_VITE_MINERU_API_KEY }}
-          RENDERER_VITE_AIHUBMIX_SECRET: ${{ secrets.RENDERER_VITE_AIHUBMIX_SECRET }}
-          RENDERER_VITE_PPIO_APP_SECRET: ${{ secrets.RENDERER_VITE_PPIO_APP_SECRET }}
+          MAIN_VITE_MINERU_API_KEY: ${{ vars.MAIN_VITE_MINERU_API_KEY }}
+          RENDERER_VITE_AIHUBMIX_SECRET: ${{ vars.RENDERER_VITE_AIHUBMIX_SECRET }}
+          RENDERER_VITE_PPIO_APP_SECRET: ${{ vars.RENDERER_VITE_PPIO_APP_SECRET }}
 
       - name: Build Mac
         if: matrix.os == 'macos-latest'
@@ -110,15 +110,15 @@ jobs:
         env:
           CSC_LINK: ${{ secrets.CSC_LINK }}
           CSC_KEY_PASSWORD: ${{ secrets.CSC_KEY_PASSWORD }}
-          APPLE_ID: ${{ secrets.APPLE_ID }}
-          APPLE_APP_SPECIFIC_PASSWORD: ${{ secrets.APPLE_APP_SPECIFIC_PASSWORD }}
-          APPLE_TEAM_ID: ${{ secrets.APPLE_TEAM_ID }}
+          APPLE_ID: ${{ vars.APPLE_ID }}
+          APPLE_APP_SPECIFIC_PASSWORD: ${{ vars.APPLE_APP_SPECIFIC_PASSWORD }}
+          APPLE_TEAM_ID: ${{ vars.APPLE_TEAM_ID }}
           GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
           NODE_OPTIONS: --max-old-space-size=8192
           MAIN_VITE_CHERRYAI_CLIENT_SECRET: ${{ secrets.MAIN_VITE_CHERRYAI_CLIENT_SECRET }}
-          MAIN_VITE_MINERU_API_KEY: ${{ secrets.MAIN_VITE_MINERU_API_KEY }}
-          RENDERER_VITE_AIHUBMIX_SECRET: ${{ secrets.RENDERER_VITE_AIHUBMIX_SECRET }}
-          RENDERER_VITE_PPIO_APP_SECRET: ${{ secrets.RENDERER_VITE_PPIO_APP_SECRET }}
+          MAIN_VITE_MINERU_API_KEY: ${{ vars.MAIN_VITE_MINERU_API_KEY }}
+          RENDERER_VITE_AIHUBMIX_SECRET: ${{ vars.RENDERER_VITE_AIHUBMIX_SECRET }}
+          RENDERER_VITE_PPIO_APP_SECRET: ${{ vars.RENDERER_VITE_PPIO_APP_SECRET }}
 
       - name: Build Windows
         if: matrix.os == 'windows-latest'
@@ -128,9 +128,9 @@ jobs:
           GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
           NODE_OPTIONS: --max-old-space-size=8192
           MAIN_VITE_CHERRYAI_CLIENT_SECRET: ${{ secrets.MAIN_VITE_CHERRYAI_CLIENT_SECRET }}
-          MAIN_VITE_MINERU_API_KEY: ${{ secrets.MAIN_VITE_MINERU_API_KEY }}
-          RENDERER_VITE_AIHUBMIX_SECRET: ${{ secrets.RENDERER_VITE_AIHUBMIX_SECRET }}
-          RENDERER_VITE_PPIO_APP_SECRET: ${{ secrets.RENDERER_VITE_PPIO_APP_SECRET }}
+          MAIN_VITE_MINERU_API_KEY: ${{ vars.MAIN_VITE_MINERU_API_KEY }}
+          RENDERER_VITE_AIHUBMIX_SECRET: ${{ vars.RENDERER_VITE_AIHUBMIX_SECRET }}
+          RENDERER_VITE_PPIO_APP_SECRET: ${{ vars.RENDERER_VITE_PPIO_APP_SECRET }}
 
       - name: Rename artifacts with nightly format
         shell: bash

.github/workflows/pr-ci.yml

@@ -17,14 +17,14 @@ jobs:
     runs-on: ubuntu-latest
     env:
       PRCI: true
-    if: github.event.pull_request.draft == false || github.head_ref == 'v2'
+    if: github.event.pull_request.draft == false
 
     steps:
       - name: Check out Git repository
         uses: actions/checkout@v5
 
       - name: Install Node.js
-        uses: actions/setup-node@v5
+        uses: actions/setup-node@v4
         with:
           node-version: 20
 

.github/workflows/release.yml

@@ -47,7 +47,7 @@ jobs:
           npm version "$VERSION" --no-git-tag-version --allow-same-version
 
       - name: Install Node.js
-        uses: actions/setup-node@v5
+        uses: actions/setup-node@v4
         with:
           node-version: 20
 
@@ -86,9 +86,9 @@ jobs:
           GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
           NODE_OPTIONS: --max-old-space-size=8192
           MAIN_VITE_CHERRYAI_CLIENT_SECRET: ${{ secrets.MAIN_VITE_CHERRYAI_CLIENT_SECRET }}
-          MAIN_VITE_MINERU_API_KEY: ${{ secrets.MAIN_VITE_MINERU_API_KEY }}
-          RENDERER_VITE_AIHUBMIX_SECRET: ${{ secrets.RENDERER_VITE_AIHUBMIX_SECRET }}
-          RENDERER_VITE_PPIO_APP_SECRET: ${{ secrets.RENDERER_VITE_PPIO_APP_SECRET }}
+          MAIN_VITE_MINERU_API_KEY: ${{ vars.MAIN_VITE_MINERU_API_KEY }}
+          RENDERER_VITE_AIHUBMIX_SECRET: ${{ vars.RENDERER_VITE_AIHUBMIX_SECRET }}
+          RENDERER_VITE_PPIO_APP_SECRET: ${{ vars.RENDERER_VITE_PPIO_APP_SECRET }}
 
       - name: Build Mac
         if: matrix.os == 'macos-latest'
@@ -98,15 +98,15 @@ jobs:
         env:
           CSC_LINK: ${{ secrets.CSC_LINK }}
           CSC_KEY_PASSWORD: ${{ secrets.CSC_KEY_PASSWORD }}
-          APPLE_ID: ${{ secrets.APPLE_ID }}
-          APPLE_APP_SPECIFIC_PASSWORD: ${{ secrets.APPLE_APP_SPECIFIC_PASSWORD }}
-          APPLE_TEAM_ID: ${{ secrets.APPLE_TEAM_ID }}
+          APPLE_ID: ${{ vars.APPLE_ID }}
+          APPLE_APP_SPECIFIC_PASSWORD: ${{ vars.APPLE_APP_SPECIFIC_PASSWORD }}
+          APPLE_TEAM_ID: ${{ vars.APPLE_TEAM_ID }}
           GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
           NODE_OPTIONS: --max-old-space-size=8192
           MAIN_VITE_CHERRYAI_CLIENT_SECRET: ${{ secrets.MAIN_VITE_CHERRYAI_CLIENT_SECRET }}
-          MAIN_VITE_MINERU_API_KEY: ${{ secrets.MAIN_VITE_MINERU_API_KEY }}
-          RENDERER_VITE_AIHUBMIX_SECRET: ${{ secrets.RENDERER_VITE_AIHUBMIX_SECRET }}
-          RENDERER_VITE_PPIO_APP_SECRET: ${{ secrets.RENDERER_VITE_PPIO_APP_SECRET }}
+          MAIN_VITE_MINERU_API_KEY: ${{ vars.MAIN_VITE_MINERU_API_KEY }}
+          RENDERER_VITE_AIHUBMIX_SECRET: ${{ vars.RENDERER_VITE_AIHUBMIX_SECRET }}
+          RENDERER_VITE_PPIO_APP_SECRET: ${{ vars.RENDERER_VITE_PPIO_APP_SECRET }}
 
       - name: Build Windows
         if: matrix.os == 'windows-latest'
@@ -116,9 +116,9 @@ jobs:
           GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
           NODE_OPTIONS: --max-old-space-size=8192
           MAIN_VITE_CHERRYAI_CLIENT_SECRET: ${{ secrets.MAIN_VITE_CHERRYAI_CLIENT_SECRET }}
-          MAIN_VITE_MINERU_API_KEY: ${{ secrets.MAIN_VITE_MINERU_API_KEY }}
-          RENDERER_VITE_AIHUBMIX_SECRET: ${{ secrets.RENDERER_VITE_AIHUBMIX_SECRET }}
-          RENDERER_VITE_PPIO_APP_SECRET: ${{ secrets.RENDERER_VITE_PPIO_APP_SECRET }}
+          MAIN_VITE_MINERU_API_KEY: ${{ vars.MAIN_VITE_MINERU_API_KEY }}
+          RENDERER_VITE_AIHUBMIX_SECRET: ${{ vars.RENDERER_VITE_AIHUBMIX_SECRET }}
+          RENDERER_VITE_PPIO_APP_SECRET: ${{ vars.RENDERER_VITE_PPIO_APP_SECRET }}
 
       - name: Release
         uses: ncipollo/release-action@v1

.gitignore

@@ -71,5 +71,3 @@ playwright-report
 test-results
 
 YOUR_MEMORY_FILE_PATH
-
-.sessions/

.oxlintrc.json

@@ -27,7 +27,7 @@
       "env": {
         "node": true
       },
-      "files": ["src/main/**", "resources/scripts/**", "scripts/**", "playwright.config.ts", "electron.vite.config.ts", "packages/ui/scripts/**"]
+      "files": ["src/main/**", "resources/scripts/**", "scripts/**", "playwright.config.ts", "electron.vite.config.ts"]
     },
     {
       "env": {
@@ -37,7 +37,6 @@
         "src/renderer/**/*.{ts,tsx}",
         "packages/aiCore/**",
         "packages/extension-table-plus/**",
-        "packages/ui/**",
         "resources/js/**"
       ]
     },
@@ -118,7 +117,7 @@
     "no-unused-expressions": "off", // this rule disallow us to use expression to call function, like `condition && fn()`
     "no-unused-labels": "error",
     "no-unused-private-class-members": "error",
-    "no-unused-vars": ["warn", { "caughtErrors": "none" }],
+    "no-unused-vars": ["error", { "caughtErrors": "none" }],
     "no-useless-backreference": "error",
     "no-useless-catch": "error",
     "no-useless-escape": "error",
@@ -141,7 +140,7 @@
     "typescript/await-thenable": "warn",
     // "typescript/ban-ts-comment": "error",
     "typescript/no-array-constructor": "error",
-    "typescript/consistent-type-imports": "error",
+    // "typescript/consistent-type-imports": "error",
     "typescript/no-array-delete": "warn",
     "typescript/no-base-to-string": "warn",
     "typescript/no-duplicate-enum-values": "error",

.vscode/settings.json

@@ -31,14 +31,13 @@
   },
   "editor.formatOnSave": true,
   "files.associations": {
-    "*.css": "tailwindcss",
-    ".oxlintrc.json": "jsonc"
+    "*.css": "tailwindcss"
   },
   "files.eol": "\n",
-  // "i18n-ally.displayLanguage": "zh-cn", // 界面显示语言
+  "i18n-ally.displayLanguage": "zh-cn",
   "i18n-ally.enabledFrameworks": ["react-i18next", "i18next"],
   "i18n-ally.enabledParsers": ["ts", "js", "json"], // 解析语言
-  "i18n-ally.fullReloadOnChanged": true,
+  "i18n-ally.fullReloadOnChanged": true, // 界面显示语言
   "i18n-ally.keystyle": "nested", // 翻译路径格式
   "i18n-ally.localesPaths": ["src/renderer/src/i18n/locales"],
   // "i18n-ally.namespace": true, // 开启命名空间
@@ -48,9 +47,5 @@
   "search.exclude": {
     "**/dist/**": true,
     ".yarn/releases/**": true
-  },
-  "tailwindCSS.classAttributes": [
-    "className",
-    "classNames",
-  ]
+  }
 }

.yarn/patches/@ai-sdk-google-npm-2.0.14-376d8b03cc.patch

@@ -0,0 +1,36 @@
+diff --git a/dist/index.mjs b/dist/index.mjs
+index 110f37ec18c98b1d55ae2b73cc716194e6f9094d..91d0f336b318833c6cee9599fe91370c0ff75323 100644
+--- a/dist/index.mjs
++++ b/dist/index.mjs
+@@ -447,7 +447,10 @@ function convertToGoogleGenerativeAIMessages(prompt, options) {
+ }
+ 
+ // src/get-model-path.ts
+-function getModelPath(modelId) {
++function getModelPath(modelId, baseURL) {
++  if (baseURL?.includes('cherryin')) {
++    return `models/${modelId}`;
++  }
+   return modelId.includes("/") ? modelId : `models/${modelId}`;
+ }
+ 
+@@ -856,7 +859,8 @@ var GoogleGenerativeAILanguageModel = class {
+       rawValue: rawResponse
+     } = await postJsonToApi2({
+       url: `${this.config.baseURL}/${getModelPath(
+-        this.modelId
++        this.modelId,
++        this.config.baseURL
+       )}:generateContent`,
+       headers: mergedHeaders,
+       body: args,
+@@ -962,7 +966,8 @@ var GoogleGenerativeAILanguageModel = class {
+     );
+     const { responseHeaders, value: response } = await postJsonToApi2({
+       url: `${this.config.baseURL}/${getModelPath(
+-        this.modelId
++        this.modelId,
++        this.config.baseURL
+       )}:streamGenerateContent?alt=sse`,
+       headers,
+       body: args,

.yarn/patches/@ai-sdk-google-npm-2.0.20-b9102f9d54.patch

@@ -1,13 +0,0 @@
-diff --git a/dist/index.mjs b/dist/index.mjs
-index 69ab1599c76801dc1167551b6fa283dded123466..f0af43bba7ad1196fe05338817e65b4ebda40955 100644
---- a/dist/index.mjs
-+++ b/dist/index.mjs
-@@ -477,7 +477,7 @@ function convertToGoogleGenerativeAIMessages(prompt, options) {
- 
- // src/get-model-path.ts
- function getModelPath(modelId) {
--  return modelId.includes("/") ? modelId : `models/${modelId}`;
-+  return modelId?.includes("models/") ? modelId : `models/${modelId}`;
- }
- 
- // src/google-generative-ai-options.ts

.yarn/patches/@anthropic-ai-claude-agent-sdk-npm-0.1.1-d937b73fed.patch

@@ -1,31 +0,0 @@
-diff --git a/sdk.mjs b/sdk.mjs
-index 461e9a2ba246778261108a682762ffcf26f7224e..44bd667d9f591969d36a105ba5eb8b478c738dd8 100644
---- a/sdk.mjs
-+++ b/sdk.mjs
-@@ -6215,7 +6215,7 @@ function createAbortController(maxListeners = DEFAULT_MAX_LISTENERS) {
- }
-
- // ../src/transport/ProcessTransport.ts
--import { spawn } from "child_process";
-+import { fork } from "child_process";
- import { createInterface } from "readline";
-
- // ../src/utils/fsOperations.ts
-@@ -6473,14 +6473,11 @@ class ProcessTransport {
-         const errorMessage = isNativeBinary(pathToClaudeCodeExecutable) ? `Claude Code native binary not found at ${pathToClaudeCodeExecutable}. Please ensure Claude Code is installed via native installer or specify a valid path with options.pathToClaudeCodeExecutable.` : `Claude Code executable not found at ${pathToClaudeCodeExecutable}. Is options.pathToClaudeCodeExecutable set?`;
-         throw new ReferenceError(errorMessage);
-       }
--      const isNative = isNativeBinary(pathToClaudeCodeExecutable);
--      const spawnCommand = isNative ? pathToClaudeCodeExecutable : executable;
--      const spawnArgs = isNative ? args : [...executableArgs, pathToClaudeCodeExecutable, ...args];
--      this.logForDebugging(isNative ? `Spawning Claude Code native binary: ${pathToClaudeCodeExecutable} ${args.join(" ")}` : `Spawning Claude Code process: ${executable} ${[...executableArgs, pathToClaudeCodeExecutable, ...args].join(" ")}`);
-+      this.logForDebugging(`Forking Claude Code Node.js process: ${pathToClaudeCodeExecutable} ${args.join(" ")}`);
-       const stderrMode = env.DEBUG || stderr ? "pipe" : "ignore";
--      this.child = spawn(spawnCommand, spawnArgs, {
-+      this.child = fork(pathToClaudeCodeExecutable, args, {
-         cwd,
--        stdio: ["pipe", "pipe", stderrMode],
-+        stdio: stderrMode === "pipe" ? ["pipe", "pipe", "pipe", "ipc"] : ["pipe", "pipe", "ignore", "ipc"],
-         signal: this.abortController.signal,
-         env
-       });

AGENTS.md

@@ -1 +0,0 @@
-CLAUDE.md

CLAUDE.md

@@ -1,39 +1,44 @@
-# AI Assistant Guide
+# CLAUDE.md
 
-This file provides guidance to AI coding assistants when working with code in this repository. Adherence to these guidelines is crucial for maintaining code quality and consistency.
-
-## Guiding Principles (MUST FOLLOW)
-
-- **Keep it clear**: Write code that is easy to read, maintain, and explain.
-- **Match the house style**: Reuse existing patterns, naming, and conventions.
-- **Search smart**: Prefer `ast-grep` for semantic queries; fall back to `rg`/`grep` when needed.
-- **Build with HeroUI**: Use HeroUI for every new UI component; never add `antd` or `styled-components`.
-- **Log centrally**: Route all logging through `loggerService` with the right context—no `console.log`.
-- **Research via subagent**: Lean on `subagent` for external docs, APIs, news, and references.
-- **Seek review**: Ask a human developer to review substantial changes before merging.
-- **Commit in rhythm**: Keep commits small, conventional, and emoji-tagged.
+This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
 
 ## Development Commands
 
-- **Install**: `yarn install` - Install all project dependencies
-- **Development**: `yarn dev` - Runs Electron app in development mode with hot reload
-- **Debug**: `yarn debug` - Starts with debugging enabled, use `chrome://inspect` to attach debugger
-- **Build Check**: `yarn build:check` - **REQUIRED** before commits (lint + test + typecheck)
-  - If having i18n sort issues, run `yarn sync:i18n` first to sync template
-  - If having formatting issues, run `yarn format` first
-- **Test**: `yarn test` - Run all tests (Vitest) across main and renderer processes
-- **Single Test**:
-  - `yarn test:main` - Run tests for main process only
-  - `yarn test:renderer` - Run tests for renderer process only
-- **Lint**: `yarn lint` - Fix linting issues and run TypeScript type checking
-- **Format**: `yarn format` - Auto-format code using Biome
+### Environment Setup
 
-## Project Architecture
+- **Prerequisites**: Node.js v22.x.x or higher, Yarn 4.9.1
+- **Setup Yarn**: `corepack enable && corepack prepare yarn@4.9.1 --activate`
+- **Install Dependencies**: `yarn install`
+- **Add New Dependencies**: `yarn add -D` for renderer-specific dependencies, `yarn add` for others.
 
-### Electron Structure
-- **Main Process** (`src/main/`): Node.js backend with services (MCP, Knowledge, Storage, etc.)
-- **Renderer Process** (`src/renderer/`): React UI with Redux state management
-- **Preload Scripts** (`src/preload/`): Secure IPC bridge
+### Development
+
+- **Start Development**: `yarn dev` - Runs Electron app in development mode
+- **Debug Mode**: `yarn debug` - Starts with debugging enabled, use chrome://inspect
+
+### Testing & Quality
+
+- **Run Tests**: `yarn test` - Runs all tests (Vitest)
+- **Run E2E Tests**: `yarn test:e2e` - Playwright end-to-end tests
+- **Type Check**: `yarn typecheck` - Checks TypeScript for both node and web
+- **Lint**: `yarn lint` - ESLint with auto-fix
+- **Format**: `yarn format` - Biome formatting
+
+### Build & Release
+
+- **Build**: `yarn build` - Builds for production (includes typecheck)
+- **Platform-specific builds**:
+  - Windows: `yarn build:win`
+  - macOS: `yarn build:mac`
+  - Linux: `yarn build:linux`
+
+## Architecture Overview
+
+### Electron Multi-Process Architecture
+
+- **Main Process** (`src/main/`): Node.js backend handling system integration, file operations, and services
+- **Renderer Process** (`src/renderer/`): React-based UI running in Chromium
+- **Preload Scripts** (`src/preload/`): Secure bridge between main and renderer processes
 
 ### Key Architectural Components
 
@@ -52,11 +57,11 @@ This file provides guidance to AI coding assistants when working with code in th
 - **Client Factory**: Supports multiple AI providers (OpenAI, Anthropic, Gemini, etc.)
 - **Stream Processing**: Real-time response handling
 
-#### Data Management
+#### State Management (`src/renderer/src/store/`)
 
-- **Cache System**: Three-layer caching (memory/shared/persist) with React hooks integration
-- **Preferences**: Type-safe configuration management with multi-window synchronization
-- **User Data**: SQLite-based storage with Drizzle ORM for business data
+- **Redux Toolkit**: Centralized state management
+- **Persistent Storage**: Redux-persist for data persistence
+- **Thunks**: Async actions for complex operations
 
 #### Knowledge Management
 
@@ -94,57 +99,29 @@ The project is in the process of migrating from antd & styled-components to Hero
 
 HeroUI Docs: https://www.heroui.com/docs/guide/introduction
 
-### Database Architecture
-
-- **Database**: SQLite (`cherrystudio.sqlite`) + libsql driver
-- **ORM**: Drizzle ORM with comprehensive migration system
-- **Schemas**: Located in `src/main/data/db/schemas/` directory
-
-#### Database Standards
-
-- **Table Naming**: Use singular form with snake_case (e.g., `topic`, `message`, `app_state`)
-- **Schema Exports**: Export using `xxxTable` pattern (e.g., `topicTable`, `appStateTable`)
-- **Field Definition**: Drizzle auto-infers field names, no need to add default field names
-- **JSON Fields**: For JSON support, add `{ mode: 'json' }`, refer to `preference.ts` table definition
-- **JSON Serialization**: For JSON fields, no need to manually serialize/deserialize when reading/writing to database, Drizzle handles this automatically
-- **Timestamps**: Use existing `crudTimestamps` utility
-- **Migrations**: Generate via `yarn run migrations:generate`
-
-## Data Access Patterns
-
-The application uses three distinct data management systems. Choose the appropriate system based on data characteristics:
-
-### Cache System
-- **Purpose**: Temporary data that can be regenerated
-- **Lifecycle**: Component-level (memory), window-level (shared), or persistent (survives restart)
-- **Use Cases**: API response caching, computed results, temporary UI state
-- **APIs**: `useCache`, `useSharedCache`, `usePersistCache` hooks, or `cacheService`
-
-### Preference System
-- **Purpose**: User configuration and application settings
-- **Lifecycle**: Permanent until user changes
-- **Use Cases**: Theme, language, editor settings, user preferences
-- **APIs**: `usePreference`, `usePreferences` hooks, or `preferenceService`
-
-### User Data API
-- **Purpose**: Core business data (conversations, files, notes, etc.)
-- **Lifecycle**: Permanent business records
-- **Use Cases**: Topics, messages, files, knowledge base, user-generated content
-- **APIs**: `useDataApi` hook or `dataApiService` for direct calls
-
-### Selection Guidelines
-
-- **Use Cache** for data that can be lost without impact (computed values, API responses)
-- **Use Preferences** for user settings that affect app behavior (UI configuration, feature flags)
-- **Use User Data API** for irreplaceable business data (conversations, documents, user content)
-
 ## Logging Standards
 
 ### Usage
 
 ```typescript
+// Main process
 import { loggerService } from '@logger'
 const logger = loggerService.withContext('moduleName')
-// Renderer: loggerService.initWindowSource('windowName') first
+
+// Renderer process (set window source first)
+loggerService.initWindowSource('windowName')
+const logger = loggerService.withContext('moduleName')
+
+// Logging
 logger.info('message', CONTEXT)
+logger.error('message', new Error('error'), CONTEXT)
 ```
+
+### Log Levels (highest to lowest)
+
+- `error` - Critical errors causing crash/unusable functionality
+- `warn` - Potential issues that don't affect core functionality
+- `info` - Application lifecycle and key user actions
+- `verbose` - Detailed flow information for feature tracing
+- `debug` - Development diagnostic info (not for production)
+- `silly` - Extreme debugging, low-level information

biome.jsonc

@@ -38,7 +38,6 @@
       "!.github/**",
       "!.husky/**",
       "!.vscode/**",
-      "!.claude/**",
       "!*.yaml",
       "!*.yml",
       "!*.mjs",

electron-builder.yml

@@ -63,9 +63,6 @@ asarUnpack:
   - resources/**
   - "**/*.{metal,exp,lib}"
   - "node_modules/@img/sharp-libvips-*/**"
-extraResources:
-  - from: "migrations/sqlite-drizzle"
-    to: "migrations/sqlite-drizzle"
 win:
   executableName: Cherry Studio
   artifactName: ${productName}-${version}-${arch}-setup.${ext}
@@ -128,21 +125,59 @@ afterSign: scripts/notarize.js
 artifactBuildCompleted: scripts/artifact-build-completed.js
 releaseInfo:
   releaseNotes: |
-    What's New in v1.6.3
+    <!--LANG:en-->
+    🚀 New Features:
+    - Refactored AI core engine for more efficient and stable content generation
+    - Added support for multiple AI model providers: CherryIN, AiOnly
+    - Added API server functionality for external application integration
+    - Added PaddleOCR document recognition for enhanced document processing
+    - Added Anthropic OAuth authentication support
+    - Added data storage space limit notifications
+    - Added font settings for global and code fonts customization
+    - Added auto-copy feature after translation completion
+    - Added keyboard shortcuts: rename topic, edit last message, etc.
+    - Added text attachment preview for viewing file contents in messages
+    - Added custom window control buttons (minimize, maximize, close)
+    - Support for Qwen long-text (qwen-long) and document analysis (qwen-doc) models with native file uploads
+    - Support for Qwen image recognition models (Qwen-Image)
+    - Added iFlow CLI support
+    - Converted knowledge base and web search to tool-calling approach for better flexibility
 
-    Features:
-    - Notes: Add spell-check control, automatic table line wrapping, export functionality, and LLM-based renaming
-    - UI: Expand topic rename clickable area, add middle-click tab closing, remove redundant scrollbars, fix message menubar overflow
-    - Editor: Add read-only extension support, make TextFilePreview read-only but copyable
-    - Models: Update support for DeepSeek v3.2, Claude 4.5, GLM 4.6, Gemini regex, and vision models
-    - Code Tools: Add GitHub Copilot CLI integration
+    🎨 UI Improvements & Bug Fixes:
+    - Integrated HeroUI and Tailwind CSS framework
+    - Optimized message notification styles with unified toast component
+    - Moved free models to bottom with fixed position for easier access
+    - Refactored quick panel and input bar tools for smoother operation
+    - Optimized responsive design for navbar and sidebar
+    - Improved scrollbar component with horizontal scrolling support
+    - Fixed multiple translation issues: paste handling, file processing, state management
+    - Various UI optimizations and bug fixes
+    <!--LANG:zh-CN-->
+    🚀 新功能：
+    - 重构 AI 核心引擎，提供更高效稳定的内容生成
+    - 新增多个 AI 模型提供商支持：CherryIN、AiOnly
+    - 新增 API 服务器功能，支持外部应用集成
+    - 新增 PaddleOCR 文档识别，增强文档处理能力
+    - 新增 Anthropic OAuth 认证支持
+    - 新增数据存储空间限制提醒
+    - 新增字体设置，支持全局字体和代码字体自定义
+    - 新增翻译完成后自动复制功能
+    - 新增键盘快捷键：重命名主题、编辑最后一条消息等
+    - 新增文本附件预览，可查看消息中的文件内容
+    - 新增自定义窗口控制按钮（最小化、最大化、关闭）
+    - 支持通义千问长文本（qwen-long）和文档分析（qwen-doc）模型，原生文件上传
+    - 支持通义千问图像识别模型（Qwen-Image）
+    - 新增 iFlow CLI 支持
+    - 知识库和网页搜索转换为工具调用方式，提升灵活性
 
-    Bug Fixes:
-    - Fix migration for missing providers
-    - Fix forked topic retaining old name after rename
-    - Restore first token latency reporting in metrics
-    - Fix UI scrollbar and overflow issues
+    🎨 界面改进与问题修复：
+    - 集成 HeroUI 和 Tailwind CSS 框架
+    - 优化消息通知样式，统一 toast 组件
+    - 免费模型移至底部固定位置，便于访问
+    - 重构快捷面板和输入栏工具，操作更流畅
+    - 优化导航栏和侧边栏响应式设计
+    - 改进滚动条组件，支持水平滚动
+    - 修复多个翻译问题：粘贴处理、文件处理、状态管理
+    - 各种界面优化和问题修复
+    <!--LANG:END-->
 
-    Technical Updates:
-    - Upgrade to Electron 37.6.0
-    - Update dependencies across packages

electron.vite.config.ts

@@ -22,7 +22,6 @@ export default defineConfig({
       alias: {
         '@main': resolve('src/main'),
         '@types': resolve('src/renderer/src/types'),
-        '@data': resolve('src/main/data'),
         '@shared': resolve('packages/shared'),
         '@logger': resolve('src/main/services/LoggerService'),
         '@mcp-trace/trace-core': resolve('packages/mcp-trace/trace-core'),
@@ -35,10 +34,6 @@ export default defineConfig({
         output: {
           manualChunks: undefined, // 彻底禁用代码分割 - 返回 null 强制单文件打包
           inlineDynamicImports: true // 内联所有动态导入，这是关键配置
-        },
-        onwarn(warning, warn) {
-          if (warning.code === 'COMMONJS_VARIABLE_IN_ESM') return
-          warn(warning)
         }
       },
       sourcemap: isDev
@@ -62,20 +57,7 @@ export default defineConfig({
       }
     },
     build: {
-      sourcemap: isDev,
-      rollupOptions: {
-        // Unlike renderer which auto-discovers entries from HTML files,
-        // preload requires explicit entry point configuration for multiple scripts
-        input: {
-          index: resolve(__dirname, 'src/preload/index.ts'),
-          simplest: resolve(__dirname, 'src/preload/simplest.ts') // Minimal preload
-        },
-        external: ['electron'],
-        output: {
-          entryFileNames: '[name].js',
-          format: 'cjs'
-        }
-      }
+      sourcemap: isDev
     }
   },
   renderer: {
@@ -102,16 +84,13 @@ export default defineConfig({
       alias: {
         '@renderer': resolve('src/renderer/src'),
         '@shared': resolve('packages/shared'),
-        '@types': resolve('src/renderer/src/types'),
         '@logger': resolve('src/renderer/src/services/LoggerService'),
-        '@data': resolve('src/renderer/src/data'),
         '@mcp-trace/trace-core': resolve('packages/mcp-trace/trace-core'),
         '@mcp-trace/trace-web': resolve('packages/mcp-trace/trace-web'),
         '@cherrystudio/ai-core/provider': resolve('packages/aiCore/src/core/providers'),
         '@cherrystudio/ai-core/built-in/plugins': resolve('packages/aiCore/src/core/plugins/built-in'),
         '@cherrystudio/ai-core': resolve('packages/aiCore/src'),
-        '@cherrystudio/extension-table-plus': resolve('packages/extension-table-plus/src'),
-        '@cherrystudio/ui': resolve('packages/ui/src')
+        '@cherrystudio/extension-table-plus': resolve('packages/extension-table-plus/src')
       }
     },
     optimizeDeps: {
@@ -131,12 +110,7 @@ export default defineConfig({
           miniWindow: resolve(__dirname, 'src/renderer/miniWindow.html'),
           selectionToolbar: resolve(__dirname, 'src/renderer/selectionToolbar.html'),
           selectionAction: resolve(__dirname, 'src/renderer/selectionAction.html'),
-          traceWindow: resolve(__dirname, 'src/renderer/traceWindow.html'),
-          dataRefactorMigrate: resolve(__dirname, 'src/renderer/dataRefactorMigrate.html')
-        },
-        onwarn(warning, warn) {
-          if (warning.code === 'COMMONJS_VARIABLE_IN_ESM') return
-          warn(warning)
+          traceWindow: resolve(__dirname, 'src/renderer/traceWindow.html')
         }
       }
     },

eslint.config.mjs

@@ -2,7 +2,6 @@ import tseslint from '@electron-toolkit/eslint-config-ts'
 import eslint from '@eslint/js'
 import eslintReact from '@eslint-react/eslint-plugin'
 import { defineConfig } from 'eslint/config'
-import importZod from 'eslint-plugin-import-zod'
 import oxlint from 'eslint-plugin-oxlint'
 import reactHooks from 'eslint-plugin-react-hooks'
 import simpleImportSort from 'eslint-plugin-simple-import-sort'
@@ -16,8 +15,7 @@ export default defineConfig([
   {
     plugins: {
       'simple-import-sort': simpleImportSort,
-      'unused-imports': unusedImports,
-      'import-zod': importZod
+      'unused-imports': unusedImports
     },
     rules: {
       '@typescript-eslint/explicit-function-return-type': 'off',
@@ -27,7 +25,6 @@ export default defineConfig([
       'simple-import-sort/exports': 'error',
       'unused-imports/no-unused-imports': 'error',
       '@eslint-react/no-prop-types': 'error',
-      'import-zod/prefer-zod-namespace': 'error'
     }
   },
   // Configuration for ensuring compatibility with the original ESLint(8.x) rules
@@ -72,9 +69,8 @@ export default defineConfig([
   ...oxlint.configs['flat/eslint'],
   ...oxlint.configs['flat/typescript'],
   ...oxlint.configs['flat/unicorn'],
-  // Custom rules should be after oxlint to overwrite
-  // LoggerService Custom Rules - only apply to src directory
   {
+    // LoggerService Custom Rules - only apply to src directory
     files: ['src/**/*.{ts,tsx,js,jsx}'],
     ignores: ['src/**/__tests__/**', 'src/**/__mocks__/**', 'src/**/*.test.*', 'src/preload/**'],
     rules: {
@@ -88,7 +84,6 @@ export default defineConfig([
       ]
     }
   },
-  // i18n
   {
     files: ['**/*.{ts,tsx,js,jsx}'],
     languageOptions: {
@@ -136,30 +131,4 @@ export default defineConfig([
       'i18n/no-template-in-t': 'warn'
     }
   },
-  // ui migration
-  {
-    // Component Rules - prevent importing antd components when migration completed
-    files: ['**/*.{ts,tsx,js,jsx}'],
-    ignores: ['src/renderer/src/windows/dataRefactorTest/**/*.{ts,tsx}'],
-    rules: {
-      'no-restricted-imports': [
-        'error',
-        {
-          paths: [
-            {
-              name: 'antd',
-              importNames: ['Flex', 'Switch', 'message', 'Button', 'Tooltip'],
-              message:
-                '❌ Do not import this component from antd. Use our custom components instead: import { ... } from "@cherrystudio/ui"'
-            },
-            // {
-            //   name: '@heroui/react',
-            //   message:
-            //     '❌ Do not import components from heroui directly. Use our wrapped components instead: import { ... } from "@cherrystudio/ui"'
-            // }
-          ]
-        }
-      ]
-    }
-  },
 ])

migrations/README.md

@@ -1,6 +0,0 @@
-**THIS DIRECTORY IS NOT FOR RUNTIME USE**
-
-- Using `libsql` as the `sqlite3` driver, and `drizzle` as the ORM and database migration tool
-- `migrations/sqlite-drizzle` contains auto-generated migration data. Please **DO NOT** modify it.
-- If table structure changes, we should run migrations.
-- To generate migrations, use the command `yarn run migrations:generate`

migrations/sqlite-drizzle.config.ts

@@ -1,7 +0,0 @@
-import { defineConfig } from 'drizzle-kit'
-export default defineConfig({
-  out: './migrations/sqlite-drizzle',
-  schema: './src/main/data/db/schemas/*',
-  dialect: 'sqlite',
-  casing: 'snake_case'
-})

migrations/sqlite-drizzle/0000_solid_lord_hawal.sql

@@ -1,17 +0,0 @@
-CREATE TABLE `app_state` (
-	`key` text PRIMARY KEY NOT NULL,
-	`value` text NOT NULL,
-	`description` text,
-	`created_at` integer,
-	`updated_at` integer
-);
---> statement-breakpoint
-CREATE TABLE `preference` (
-	`scope` text NOT NULL,
-	`key` text NOT NULL,
-	`value` text,
-	`created_at` integer,
-	`updated_at` integer
-);
---> statement-breakpoint
-CREATE INDEX `scope_name_idx` ON `preference` (`scope`,`key`);

migrations/sqlite-drizzle/meta/0000_snapshot.json

@@ -1,114 +0,0 @@
-{
-  "_meta": {
-    "columns": {},
-    "schemas": {},
-    "tables": {}
-  },
-  "dialect": "sqlite",
-  "enums": {},
-  "id": "de8009d7-95b9-4f99-99fa-4b8795708f21",
-  "internal": {
-    "indexes": {}
-  },
-  "prevId": "00000000-0000-0000-0000-000000000000",
-  "tables": {
-    "app_state": {
-      "checkConstraints": {},
-      "columns": {
-        "created_at": {
-          "autoincrement": false,
-          "name": "created_at",
-          "notNull": false,
-          "primaryKey": false,
-          "type": "integer"
-        },
-        "description": {
-          "autoincrement": false,
-          "name": "description",
-          "notNull": false,
-          "primaryKey": false,
-          "type": "text"
-        },
-        "key": {
-          "autoincrement": false,
-          "name": "key",
-          "notNull": true,
-          "primaryKey": true,
-          "type": "text"
-        },
-        "updated_at": {
-          "autoincrement": false,
-          "name": "updated_at",
-          "notNull": false,
-          "primaryKey": false,
-          "type": "integer"
-        },
-        "value": {
-          "autoincrement": false,
-          "name": "value",
-          "notNull": true,
-          "primaryKey": false,
-          "type": "text"
-        }
-      },
-      "compositePrimaryKeys": {},
-      "foreignKeys": {},
-      "indexes": {},
-      "name": "app_state",
-      "uniqueConstraints": {}
-    },
-    "preference": {
-      "checkConstraints": {},
-      "columns": {
-        "created_at": {
-          "autoincrement": false,
-          "name": "created_at",
-          "notNull": false,
-          "primaryKey": false,
-          "type": "integer"
-        },
-        "key": {
-          "autoincrement": false,
-          "name": "key",
-          "notNull": true,
-          "primaryKey": false,
-          "type": "text"
-        },
-        "scope": {
-          "autoincrement": false,
-          "name": "scope",
-          "notNull": true,
-          "primaryKey": false,
-          "type": "text"
-        },
-        "updated_at": {
-          "autoincrement": false,
-          "name": "updated_at",
-          "notNull": false,
-          "primaryKey": false,
-          "type": "integer"
-        },
-        "value": {
-          "autoincrement": false,
-          "name": "value",
-          "notNull": false,
-          "primaryKey": false,
-          "type": "text"
-        }
-      },
-      "compositePrimaryKeys": {},
-      "foreignKeys": {},
-      "indexes": {
-        "scope_name_idx": {
-          "columns": ["scope", "key"],
-          "isUnique": false,
-          "name": "scope_name_idx"
-        }
-      },
-      "name": "preference",
-      "uniqueConstraints": {}
-    }
-  },
-  "version": "6",
-  "views": {}
-}

migrations/sqlite-drizzle/meta/_journal.json

@@ -1,13 +0,0 @@
-{
-  "dialect": "sqlite",
-  "entries": [
-    {
-      "breakpoints": true,
-      "idx": 0,
-      "tag": "0000_solid_lord_hawal",
-      "version": "6",
-      "when": 1754745234572
-    }
-  ],
-  "version": "7"
-}

package.json

@@ -1,6 +1,6 @@
 {
   "name": "CherryStudio",
-  "version": "2.0.0-alpha",
+  "version": "1.6.1",
   "private": true,
   "description": "A powerful AI assistant for producer.",
   "main": "./out/main/index.js",
@@ -43,19 +43,15 @@
     "release": "node scripts/version.js",
     "publish": "yarn build:check && yarn release patch push",
     "pulish:artifacts": "cd packages/artifacts && npm publish && cd -",
-    "agents:generate": "NODE_ENV='development' drizzle-kit generate --config src/main/services/agents/drizzle.config.ts",
-    "agents:push": "NODE_ENV='development' drizzle-kit push --config src/main/services/agents/drizzle.config.ts",
-    "agents:studio": "NODE_ENV='development' drizzle-kit studio --config src/main/services/agents/drizzle.config.ts",
-    "agents:drop": "NODE_ENV='development' drizzle-kit drop --config src/main/services/agents/drizzle.config.ts",
+    "generate:agents": "yarn workspace @cherry-studio/database agents",
     "generate:icons": "electron-icon-builder --input=./build/logo.png --output=build",
     "analyze:renderer": "VISUALIZER_RENDERER=true yarn build",
     "analyze:main": "VISUALIZER_MAIN=true yarn build",
-    "typecheck": "concurrently -n \"node,web,ui\" -c \"cyan,magenta,green\" \"npm run typecheck:node\" \"npm run typecheck:web\" \"npm run typecheck:ui\"",
+    "typecheck": "concurrently -n \"node,web\" -c \"cyan,magenta\" \"npm run typecheck:node\" \"npm run typecheck:web\"",
     "typecheck:node": "tsgo --noEmit -p tsconfig.node.json --composite false",
     "typecheck:web": "tsgo --noEmit -p tsconfig.web.json --composite false",
-    "typecheck:ui": "cd packages/ui && npm run type-check",
-    "check:i18n": "dotenv -e .env -- tsx scripts/check-i18n.ts",
-    "sync:i18n": "dotenv -e .env -- tsx scripts/sync-i18n.ts",
+    "check:i18n": "tsx scripts/check-i18n.ts",
+    "sync:i18n": "tsx scripts/sync-i18n.ts",
     "update:i18n": "dotenv -e .env -- tsx scripts/update-i18n.ts",
     "auto:i18n": "dotenv -e .env -- tsx scripts/auto-translate-i18n.ts",
     "update:languages": "tsx scripts/update-languages.ts",
@@ -69,23 +65,21 @@
     "test:e2e": "yarn playwright test",
     "test:lint": "oxlint --deny-warnings && eslint . --ext .js,.jsx,.cjs,.mjs,.ts,.tsx,.cts,.mts --cache",
     "test:scripts": "vitest scripts",
-    "lint": "oxlint --fix && eslint . --ext .js,.jsx,.cjs,.mjs,.ts,.tsx,.cts,.mts --fix --cache && biome lint --write && biome format --write && yarn typecheck && yarn check:i18n && yarn format:check",
-    "lint:ox": "oxlint --fix && biome lint --write && biome format --write",
+    "lint": "oxlint --fix && eslint . --ext .js,.jsx,.cjs,.mjs,.ts,.tsx,.cts,.mts --fix --cache && yarn typecheck && yarn check:i18n",
     "format": "biome format --write && biome lint --write",
     "format:check": "biome format && biome lint",
     "prepare": "git config blame.ignoreRevsFile .git-blame-ignore-revs && husky",
     "claude": "dotenv -e .env -- claude",
-    "migrations:generate": "drizzle-kit generate --config ./migrations/sqlite-drizzle.config.ts",
     "release:aicore:alpha": "yarn workspace @cherrystudio/ai-core version prerelease --immediate && yarn workspace @cherrystudio/ai-core npm publish --tag alpha --access public",
     "release:aicore:beta": "yarn workspace @cherrystudio/ai-core version prerelease --immediate && yarn workspace @cherrystudio/ai-core npm publish --tag beta --access public",
     "release:aicore": "yarn workspace @cherrystudio/ai-core version patch --immediate && yarn workspace @cherrystudio/ai-core npm publish --access public"
   },
   "dependencies": {
-    "@anthropic-ai/claude-agent-sdk": "patch:@anthropic-ai/claude-agent-sdk@npm%3A0.1.1#~/.yarn/patches/@anthropic-ai-claude-agent-sdk-npm-0.1.1-d937b73fed.patch",
     "@libsql/client": "0.14.0",
     "@libsql/win32-x64-msvc": "^0.4.7",
     "@napi-rs/system-ocr": "patch:@napi-rs/system-ocr@npm%3A1.0.2#~/.yarn/patches/@napi-rs-system-ocr-npm-1.0.2-59e7a78e8b.patch",
     "@strongtz/win32-arm64-msvc": "^0.4.7",
+    "express": "^5.1.0",
     "font-list": "^2.0.0",
     "graceful-fs": "^4.2.11",
     "jsdom": "26.1.0",
@@ -95,6 +89,7 @@
     "selection-hook": "^1.0.12",
     "sharp": "^0.34.3",
     "swagger-jsdoc": "^6.2.8",
+    "swagger-ui-express": "^5.0.1",
     "tesseract.js": "patch:tesseract.js@npm%3A6.0.1#~/.yarn/patches/tesseract.js-npm-6.0.1-2562a7e46d.patch",
     "turndown": "7.2.0"
   },
@@ -102,10 +97,10 @@
     "@agentic/exa": "^7.3.3",
     "@agentic/searxng": "^7.3.3",
     "@agentic/tavily": "^7.3.3",
-    "@ai-sdk/amazon-bedrock": "^3.0.35",
-    "@ai-sdk/google-vertex": "^3.0.40",
-    "@ai-sdk/mistral": "^2.0.19",
-    "@ai-sdk/perplexity": "^2.0.13",
+    "@ai-sdk/amazon-bedrock": "^3.0.21",
+    "@ai-sdk/google-vertex": "^3.0.27",
+    "@ai-sdk/mistral": "^2.0.14",
+    "@ai-sdk/perplexity": "^2.0.9",
     "@ant-design/v5-patch-for-react-19": "^1.0.3",
     "@anthropic-ai/sdk": "^0.41.0",
     "@anthropic-ai/vertex-sdk": "patch:@anthropic-ai/vertex-sdk@npm%3A0.11.4#~/.yarn/patches/@anthropic-ai-vertex-sdk-npm-0.11.4-c19cb41edb.patch",
@@ -127,7 +122,6 @@
     "@cherrystudio/embedjs-ollama": "^0.1.31",
     "@cherrystudio/embedjs-openai": "^0.1.31",
     "@cherrystudio/extension-table-plus": "workspace:^",
-    "@cherrystudio/ui": "workspace:*",
     "@dnd-kit/core": "^6.3.1",
     "@dnd-kit/modifiers": "^9.0.0",
     "@dnd-kit/sortable": "^10.0.0",
@@ -143,6 +137,7 @@
     "@google/genai": "patch:@google/genai@npm%3A1.0.1#~/.yarn/patches/@google-genai-npm-1.0.1-e26f0f9af7.patch",
     "@hello-pangea/dnd": "^18.0.1",
     "@heroui/react": "^2.8.3",
+    "@kangfenmao/keyv-storage": "^0.1.0",
     "@langchain/community": "^0.3.50",
     "@mistralai/mistralai": "^1.7.5",
     "@modelcontextprotocol/sdk": "^1.17.5",
@@ -155,9 +150,7 @@
     "@opentelemetry/sdk-trace-base": "^2.0.0",
     "@opentelemetry/sdk-trace-node": "^2.0.0",
     "@opentelemetry/sdk-trace-web": "^2.0.0",
-    "@opeoginni/github-copilot-openai-compatible": "0.1.18",
     "@playwright/test": "^1.52.0",
-    "@radix-ui/react-context-menu": "^2.2.16",
     "@reduxjs/toolkit": "^2.2.5",
     "@shikijs/markdown-it": "^3.12.0",
     "@swc/plugin-styled-components": "^8.0.4",
@@ -209,7 +202,6 @@
     "@types/swagger-ui-express": "^4.1.8",
     "@types/tinycolor2": "^1",
     "@types/turndown": "^5.0.5",
-    "@types/uuid": "^10.0.0",
     "@types/word-extractor": "^1",
     "@typescript/native-preview": "latest",
     "@uiw/codemirror-extensions-langs": "^4.25.1",
@@ -223,7 +215,7 @@
     "@viz-js/lang-dot": "^1.0.5",
     "@viz-js/viz": "^3.14.0",
     "@xyflow/react": "^12.4.4",
-    "ai": "^5.0.68",
+    "ai": "^5.0.44",
     "antd": "patch:antd@npm%3A5.27.0#~/.yarn/patches/antd-npm-5.27.0-aa91c36546.patch",
     "archiver": "^7.0.1",
     "async-mutex": "^0.5.0",
@@ -246,12 +238,9 @@
     "docx": "^9.0.2",
     "dompurify": "^3.2.6",
     "dotenv-cli": "^7.4.2",
-    "drizzle-kit": "^0.31.4",
-    "drizzle-orm": "^0.44.5",
-    "electron": "37.6.0",
+    "electron": "37.4.0",
     "electron-builder": "26.0.15",
     "electron-devtools-installer": "^3.2.0",
-    "electron-reload": "^2.0.0-alpha.1",
     "electron-store": "^8.2.0",
     "electron-updater": "6.6.4",
     "electron-vite": "4.0.0",
@@ -260,13 +249,10 @@
     "emoji-picker-element": "^1.22.1",
     "epub": "patch:epub@npm%3A1.3.0#~/.yarn/patches/epub-npm-1.3.0-8325494ffe.patch",
     "eslint": "^9.22.0",
-    "eslint-plugin-import-zod": "^1.2.0",
     "eslint-plugin-oxlint": "^1.15.0",
     "eslint-plugin-react-hooks": "^5.2.0",
     "eslint-plugin-simple-import-sort": "^12.1.1",
     "eslint-plugin-unused-imports": "^4.1.4",
-    "express": "^5.1.0",
-    "express-validator": "^7.2.1",
     "fast-diff": "^1.3.0",
     "fast-xml-parser": "^5.2.0",
     "fetch-socks": "1.3.2",
@@ -299,7 +285,7 @@
     "notion-helper": "^1.3.22",
     "npx-scope-finder": "^1.2.0",
     "openai": "patch:openai@npm%3A5.12.2#~/.yarn/patches/openai-npm-5.12.2-30b075401c.patch",
-    "oxlint": "^1.22.0",
+    "oxlint": "^1.15.0",
     "oxlint-tsgolint": "^0.2.0",
     "p-queue": "^8.1.0",
     "pdf-lib": "^1.17.1",
@@ -339,8 +325,6 @@
     "string-width": "^7.2.0",
     "striptags": "^3.2.0",
     "styled-components": "^6.1.11",
-    "swagger-ui-express": "^5.0.1",
-    "swr": "^2.3.6",
     "tailwindcss": "^4.1.13",
     "tar": "^7.4.3",
     "tiny-pinyin": "^1.3.2",
@@ -351,7 +335,7 @@
     "typescript": "~5.8.2",
     "undici": "6.21.2",
     "unified": "^11.0.5",
-    "uuid": "^13.0.0",
+    "uuid": "^10.0.0",
     "vite": "npm:rolldown-vite@latest",
     "vitest": "^3.2.4",
     "webdav": "^5.8.0",
@@ -375,7 +359,6 @@
     "app-builder-lib@npm:26.0.13": "patch:app-builder-lib@npm%3A26.0.13#~/.yarn/patches/app-builder-lib-npm-26.0.13-a064c9e1d0.patch",
     "app-builder-lib@npm:26.0.15": "patch:app-builder-lib@npm%3A26.0.15#~/.yarn/patches/app-builder-lib-npm-26.0.15-360e5b0476.patch",
     "atomically@npm:^1.7.0": "patch:atomically@npm%3A1.7.0#~/.yarn/patches/atomically-npm-1.7.0-e742e5293b.patch",
-    "esbuild": "^0.25.0",
     "file-stream-rotator@npm:^0.6.1": "patch:file-stream-rotator@npm%3A0.6.1#~/.yarn/patches/file-stream-rotator-npm-0.6.1-eab45fb13d.patch",
     "libsql@npm:^0.4.4": "patch:libsql@npm%3A0.4.7#~/.yarn/patches/libsql-npm-0.4.7-444e260fb1.patch",
     "node-abi": "4.12.0",
@@ -383,11 +366,10 @@
     "openai@npm:^4.87.3": "patch:openai@npm%3A5.12.2#~/.yarn/patches/openai-npm-5.12.2-30b075401c.patch",
     "pdf-parse@npm:1.1.1": "patch:pdf-parse@npm%3A1.1.1#~/.yarn/patches/pdf-parse-npm-1.1.1-04a6109b2a.patch",
     "pkce-challenge@npm:^4.1.0": "patch:pkce-challenge@npm%3A4.1.0#~/.yarn/patches/pkce-challenge-npm-4.1.0-fbc51695a3.patch",
-    "tar-fs": "^2.1.4",
     "undici": "6.21.2",
     "vite": "npm:rolldown-vite@latest",
     "tesseract.js@npm:*": "patch:tesseract.js@npm%3A6.0.1#~/.yarn/patches/tesseract.js-npm-6.0.1-2562a7e46d.patch",
-    "@ai-sdk/google@npm:2.0.20": "patch:@ai-sdk/google@npm%3A2.0.20#~/.yarn/patches/@ai-sdk-google-npm-2.0.20-b9102f9d54.patch"
+    "@ai-sdk/google@npm:2.0.14": "patch:@ai-sdk/google@npm%3A2.0.14#~/.yarn/patches/@ai-sdk-google-npm-2.0.14-376d8b03cc.patch"
   },
   "packageManager": "yarn@4.9.1",
   "lint-staged": {

packages/aiCore/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cherrystudio/ai-core",
-  "version": "1.0.1",
+  "version": "1.0.0-alpha.18",
   "description": "Cherry Studio AI Core - Unified AI Provider Interface Based on Vercel AI SDK",
   "main": "dist/index.js",
   "module": "dist/index.mjs",
@@ -36,14 +36,15 @@
     "ai": "^5.0.26"
   },
   "dependencies": {
-    "@ai-sdk/anthropic": "^2.0.27",
-    "@ai-sdk/azure": "^2.0.49",
-    "@ai-sdk/deepseek": "^1.0.23",
-    "@ai-sdk/openai": "^2.0.48",
-    "@ai-sdk/openai-compatible": "^1.0.22",
+    "@ai-sdk/anthropic": "^2.0.17",
+    "@ai-sdk/azure": "^2.0.30",
+    "@ai-sdk/deepseek": "^1.0.17",
+    "@ai-sdk/google": "patch:@ai-sdk/google@npm%3A2.0.14#~/.yarn/patches/@ai-sdk-google-npm-2.0.14-376d8b03cc.patch",
+    "@ai-sdk/openai": "^2.0.30",
+    "@ai-sdk/openai-compatible": "^1.0.17",
     "@ai-sdk/provider": "^2.0.0",
-    "@ai-sdk/provider-utils": "^3.0.12",
-    "@ai-sdk/xai": "^2.0.26",
+    "@ai-sdk/provider-utils": "^3.0.9",
+    "@ai-sdk/xai": "^2.0.18",
     "zod": "^4.1.5"
   },
   "devDependencies": {

packages/aiCore/src/core/middleware/manager.ts

@@ -2,7 +2,7 @@
  * 中间件管理器
  * 专注于 AI SDK 中间件的管理，与插件系统分离
  */
-import type { LanguageModelV2Middleware } from '@ai-sdk/provider'
+import { LanguageModelV2Middleware } from '@ai-sdk/provider'
 
 /**
  * 创建中间件列表

packages/aiCore/src/core/middleware/types.ts

@@ -1,7 +1,7 @@
 /**
  * 中间件系统类型定义
  */
-import type { LanguageModelV2Middleware } from '@ai-sdk/provider'
+import { LanguageModelV2Middleware } from '@ai-sdk/provider'
 
 /**
  * 具名中间件接口

packages/aiCore/src/core/middleware/wrapper.ts

@@ -2,7 +2,7 @@
  * 模型包装工具函数
  * 用于将中间件应用到LanguageModel上
  */
-import type { LanguageModelV2, LanguageModelV2Middleware } from '@ai-sdk/provider'
+import { LanguageModelV2, LanguageModelV2Middleware } from '@ai-sdk/provider'
 import { wrapLanguageModel } from 'ai'
 
 /**

packages/aiCore/src/core/models/ModelResolver.ts

@@ -5,7 +5,7 @@
  * 集成了来自 ModelCreator 的特殊处理逻辑
  */
 
-import type { EmbeddingModelV2, ImageModelV2, LanguageModelV2, LanguageModelV2Middleware } from '@ai-sdk/provider'
+import { EmbeddingModelV2, ImageModelV2, LanguageModelV2, LanguageModelV2Middleware } from '@ai-sdk/provider'
 
 import { wrapModelWithMiddlewares } from '../middleware/wrapper'
 import { DEFAULT_SEPARATOR, globalRegistryManagement } from '../providers/RegistryManagement'

packages/aiCore/src/core/models/types.ts

@@ -1,7 +1,7 @@
 /**
  * Creation 模块类型定义
  */
-import type { LanguageModelV2Middleware } from '@ai-sdk/provider'
+import { LanguageModelV2Middleware } from '@ai-sdk/provider'
 
 import type { ProviderId, ProviderSettingsMap } from '../providers/types'
 

packages/aiCore/src/core/options/factory.ts

@@ -1,4 +1,4 @@
-import type { ExtractProviderOptions, ProviderOptionsMap, TypedProviderOptions } from './types'
+import { ExtractProviderOptions, ProviderOptionsMap, TypedProviderOptions } from './types'
 
 /**
  * 创建特定供应商的选项

packages/aiCore/src/core/plugins/built-in/toolUsePlugin/promptToolUsePlugin.ts

@@ -10,7 +10,7 @@ import type { AiRequestContext } from '../../types'
 import { StreamEventManager } from './StreamEventManager'
 import { type TagConfig, TagExtractor } from './tagExtraction'
 import { ToolExecutor } from './ToolExecutor'
-import type { PromptToolUseConfig, ToolUseResult } from './type'
+import { PromptToolUseConfig, ToolUseResult } from './type'
 
 /**
  * 工具使用标签配置
@@ -261,39 +261,22 @@ export const createPromptToolUsePlugin = (config: PromptToolUseConfig = {}) => {
         return params
       }
 
-      // 分离 provider-defined 和其他类型的工具
-      const providerDefinedTools: ToolSet = {}
-      const promptTools: ToolSet = {}
+      context.mcpTools = params.tools
 
-      for (const [toolName, tool] of Object.entries(params.tools as ToolSet)) {
-        if (tool.type === 'provider-defined') {
-          // provider-defined 类型的工具保留在 tools 参数中
-          providerDefinedTools[toolName] = tool
-        } else {
-          // 其他工具转换为 prompt 模式
-          promptTools[toolName] = tool
-        }
-      }
-
-      // 只有当有非 provider-defined 工具时才保存到 context
-      if (Object.keys(promptTools).length > 0) {
-        context.mcpTools = promptTools
-      }
-
-      // 构建系统提示符（只包含非 provider-defined 工具）
+      // 构建系统提示符
       const userSystemPrompt = typeof params.system === 'string' ? params.system : ''
-      const systemPrompt = buildSystemPrompt(userSystemPrompt, promptTools)
+      const systemPrompt = buildSystemPrompt(userSystemPrompt, params.tools)
       let systemMessage: string | null = systemPrompt
       if (config.createSystemMessage) {
         // 🎯 如果用户提供了自定义处理函数，使用它
         systemMessage = config.createSystemMessage(systemPrompt, params, context)
       }
 
-      // 保留 provider-defined tools，移除其他 tools
+      // 移除 tools，改为 prompt 模式
       const transformedParams = {
         ...params,
         ...(systemMessage ? { system: systemMessage } : {}),
-        tools: Object.keys(providerDefinedTools).length > 0 ? providerDefinedTools : undefined
+        tools: undefined
       }
       context.originalParams = transformedParams
       return transformedParams
@@ -302,9 +285,8 @@ export const createPromptToolUsePlugin = (config: PromptToolUseConfig = {}) => {
       let textBuffer = ''
       // let stepId = ''
 
-      // 如果没有需要 prompt 模式处理的工具，直接返回原始流
       if (!context.mcpTools) {
-        return new TransformStream()
+        throw new Error('No tools available')
       }
 
       // 从 context 中获取或初始化 usage 累加器

packages/aiCore/src/core/plugins/built-in/toolUsePlugin/type.ts

@@ -1,6 +1,6 @@
-import type { ToolSet } from 'ai'
+import { ToolSet } from 'ai'
 
-import type { AiRequestContext } from '../..'
+import { AiRequestContext } from '../..'
 
 /**
  * 解析结果类型

packages/aiCore/src/core/plugins/built-in/webSearchPlugin/helper.ts

@@ -1,10 +1,9 @@
-import type { anthropic } from '@ai-sdk/anthropic'
-import type { google } from '@ai-sdk/google'
-import type { openai } from '@ai-sdk/openai'
-import type { InferToolInput, InferToolOutput, Tool } from 'ai'
+import { anthropic } from '@ai-sdk/anthropic'
+import { google } from '@ai-sdk/google'
+import { openai } from '@ai-sdk/openai'
 
-import type { ProviderOptionsMap } from '../../../options/types'
-import type { OpenRouterSearchConfig } from './openrouter'
+import { ProviderOptionsMap } from '../../../options/types'
+import { OpenRouterSearchConfig } from './openrouter'
 
 /**
  * 从 AI SDK 的工具函数中提取参数类型，以确保类型安全。
@@ -15,13 +14,6 @@ export type AnthropicSearchConfig = NonNullable<Parameters<typeof anthropic.tool
 export type GoogleSearchConfig = NonNullable<Parameters<typeof google.tools.googleSearch>[0]>
 export type XAISearchConfig = NonNullable<ProviderOptionsMap['xai']['searchParameters']>
 
-type NormalizeTool<T> = T extends Tool<infer INPUT, infer OUTPUT> ? Tool<INPUT, OUTPUT> : Tool<any, any>
-
-type AnthropicWebSearchTool = NormalizeTool<ReturnType<typeof anthropic.tools.webSearch_20250305>>
-type OpenAIWebSearchTool = NormalizeTool<ReturnType<typeof openai.tools.webSearch>>
-type OpenAIChatWebSearchTool = NormalizeTool<ReturnType<typeof openai.tools.webSearchPreview>>
-type GoogleWebSearchTool = NormalizeTool<ReturnType<typeof google.tools.googleSearch>>
-
 /**
  * 插件初始化时接收的完整配置对象
  *
@@ -66,31 +58,24 @@ export const DEFAULT_WEB_SEARCH_CONFIG: WebSearchPluginConfig = {
 
 export type WebSearchToolOutputSchema = {
   // Anthropic 工具 - 手动定义
-  anthropic: InferToolOutput<AnthropicWebSearchTool>
+  anthropicWebSearch: Array<{
+    url: string
+    title: string
+    pageAge: string | null
+    encryptedContent: string
+    type: string
+  }>
 
   // OpenAI 工具 - 基于实际输出
-  // TODO: 上游定义不规范,是unknown
-  // openai: InferToolOutput<ReturnType<typeof openai.tools.webSearch>>
-  openai: {
-    status: 'completed' | 'failed'
-  }
-  'openai-chat': {
+  openaiWebSearch: {
     status: 'completed' | 'failed'
   }
+
   // Google 工具
-  // TODO: 上游定义不规范,是unknown
-  // google: InferToolOutput<ReturnType<typeof google.tools.googleSearch>>
-  google: {
+  googleSearch: {
     webSearchQueries?: string[]
     groundingChunks?: Array<{
       web?: { uri: string; title: string }
     }>
   }
 }
-
-export type WebSearchToolInputSchema = {
-  anthropic: InferToolInput<AnthropicWebSearchTool>
-  openai: InferToolInput<OpenAIWebSearchTool>
-  google: InferToolInput<GoogleWebSearchTool>
-  'openai-chat': InferToolInput<OpenAIChatWebSearchTool>
-}

packages/aiCore/src/core/plugins/built-in/webSearchPlugin/index.ts

@@ -9,8 +9,7 @@ import { openai } from '@ai-sdk/openai'
 import { createOpenRouterOptions, createXaiOptions, mergeProviderOptions } from '../../../options'
 import { definePlugin } from '../../'
 import type { AiRequestContext } from '../../types'
-import type { WebSearchPluginConfig } from './helper'
-import { DEFAULT_WEB_SEARCH_CONFIG } from './helper'
+import { DEFAULT_WEB_SEARCH_CONFIG, WebSearchPluginConfig } from './helper'
 
 /**
  * 网络搜索插件

packages/aiCore/src/core/plugins/manager.ts

@@ -1,4 +1,4 @@
-import type { AiPlugin, AiRequestContext } from './types'
+import { AiPlugin, AiRequestContext } from './types'
 
 /**
  * 插件管理器

packages/aiCore/src/core/providers/HubProvider.ts

@@ -5,7 +5,7 @@
  * 例如: aihubmix:anthropic:claude-3.5-sonnet
  */
 
-import type { ProviderV2 } from '@ai-sdk/provider'
+import { ProviderV2 } from '@ai-sdk/provider'
 import { customProvider } from 'ai'
 
 import { globalRegistryManagement } from './RegistryManagement'

packages/aiCore/src/core/providers/RegistryManagement.ts

@@ -4,7 +4,7 @@
  * 基于 AI SDK 原生的 createProviderRegistry
  */
 
-import type { EmbeddingModelV2, ImageModelV2, LanguageModelV2, ProviderV2 } from '@ai-sdk/provider'
+import { EmbeddingModelV2, ImageModelV2, LanguageModelV2, ProviderV2 } from '@ai-sdk/provider'
 import { createProviderRegistry, type ProviderRegistryProvider } from 'ai'
 
 type PROVIDERS = Record<string, ProviderV2>

packages/aiCore/src/core/providers/schemas.ts

@@ -9,12 +9,11 @@ import { createDeepSeek } from '@ai-sdk/deepseek'
 import { createGoogleGenerativeAI } from '@ai-sdk/google'
 import { createOpenAI, type OpenAIProviderSettings } from '@ai-sdk/openai'
 import { createOpenAICompatible } from '@ai-sdk/openai-compatible'
-import type { LanguageModelV2 } from '@ai-sdk/provider'
+import { LanguageModelV2 } from '@ai-sdk/provider'
 import { createXai } from '@ai-sdk/xai'
 import { createOpenRouter } from '@openrouter/ai-sdk-provider'
-import type { Provider } from 'ai'
-import { customProvider } from 'ai'
-import * as z from 'zod'
+import { customProvider, Provider } from 'ai'
+import { z } from 'zod'
 
 /**
  * 基础 Provider IDs

packages/aiCore/src/core/providers/types.ts

@@ -4,7 +4,7 @@ import { type DeepSeekProviderSettings } from '@ai-sdk/deepseek'
 import { type GoogleGenerativeAIProviderSettings } from '@ai-sdk/google'
 import { type OpenAIProviderSettings } from '@ai-sdk/openai'
 import { type OpenAICompatibleProviderSettings } from '@ai-sdk/openai-compatible'
-import type {
+import {
   EmbeddingModelV2 as EmbeddingModel,
   ImageModelV2 as ImageModel,
   LanguageModelV2 as LanguageModel,

packages/aiCore/src/core/runtime/__tests__/generateImage.test.ts

@@ -1,4 +1,4 @@
-import type { ImageModelV2 } from '@ai-sdk/provider'
+import { ImageModelV2 } from '@ai-sdk/provider'
 import { experimental_generateImage as aiGenerateImage, NoImageGeneratedError } from 'ai'
 import { beforeEach, describe, expect, it, vi } from 'vitest'
 

packages/aiCore/src/core/runtime/executor.ts

@@ -2,12 +2,12 @@
  * 运行时执行器
  * 专注于插件化的AI调用处理
  */
-import type { ImageModelV2, LanguageModelV2, LanguageModelV2Middleware } from '@ai-sdk/provider'
-import type { LanguageModel } from 'ai'
+import { ImageModelV2, LanguageModelV2, LanguageModelV2Middleware } from '@ai-sdk/provider'
 import {
   experimental_generateImage as _generateImage,
   generateObject as _generateObject,
   generateText as _generateText,
+  LanguageModel,
   streamObject as _streamObject,
   streamText as _streamText
 } from 'ai'

packages/aiCore/src/core/runtime/index.ts

@@ -11,7 +11,7 @@ export type { RuntimeConfig } from './types'
 
 // === 便捷工厂函数 ===
 
-import type { LanguageModelV2Middleware } from '@ai-sdk/provider'
+import { LanguageModelV2Middleware } from '@ai-sdk/provider'
 
 import { type AiPlugin } from '../plugins'
 import { type ProviderId, type ProviderSettingsMap } from '../providers/types'

packages/aiCore/src/core/runtime/pluginEngine.ts

@@ -1,13 +1,6 @@
 /* eslint-disable @eslint-react/naming-convention/context-name */
-import type { ImageModelV2 } from '@ai-sdk/provider'
-import type {
-  experimental_generateImage,
-  generateObject,
-  generateText,
-  LanguageModel,
-  streamObject,
-  streamText
-} from 'ai'
+import { ImageModelV2 } from '@ai-sdk/provider'
+import { experimental_generateImage, generateObject, generateText, LanguageModel, streamObject, streamText } from 'ai'
 
 import { type AiPlugin, createContext, PluginManager } from '../plugins'
 import { type ProviderId } from '../providers/types'

packages/aiCore/src/core/runtime/types.ts

@@ -1,8 +1,8 @@
 /**
  * Runtime 层类型定义
  */
-import type { ImageModelV2 } from '@ai-sdk/provider'
-import type { experimental_generateImage, generateObject, generateText, streamObject, streamText } from 'ai'
+import { ImageModelV2 } from '@ai-sdk/provider'
+import { experimental_generateImage, generateObject, generateText, streamObject, streamText } from 'ai'
 
 import { type ModelConfig } from '../models/types'
 import { type AiPlugin } from '../plugins'

packages/extension-table-plus/src/kit/index.ts

@@ -1,5 +1,4 @@
-import type { Node } from '@tiptap/core'
-import { Extension } from '@tiptap/core'
+import { Extension, Node } from '@tiptap/core'
 
 import type { TableCellOptions } from '../cell/index.js'
 import { TableCell } from '../cell/index.js'

packages/mcp-trace/trace-core/core/spanConvert.ts

@@ -1,7 +1,7 @@
 import { SpanKind, SpanStatusCode } from '@opentelemetry/api'
-import type { ReadableSpan } from '@opentelemetry/sdk-trace-base'
+import { ReadableSpan } from '@opentelemetry/sdk-trace-base'
 
-import type { SpanEntity } from '../types/config'
+import { SpanEntity } from '../types/config'
 
 /**
  * convert ReadableSpan to SpanEntity

packages/mcp-trace/trace-core/core/traceCache.ts

@@ -1,4 +1,4 @@
-import type { ReadableSpan } from '@opentelemetry/sdk-trace-base'
+import { ReadableSpan } from '@opentelemetry/sdk-trace-base'
 
 export interface TraceCache {
   createSpan: (span: ReadableSpan) => void

packages/mcp-trace/trace-core/exporters/FuncSpanExporter.ts

@@ -1,6 +1,5 @@
-import type { ExportResult } from '@opentelemetry/core'
-import { ExportResultCode } from '@opentelemetry/core'
-import type { ReadableSpan, SpanExporter } from '@opentelemetry/sdk-trace-base'
+import { ExportResult, ExportResultCode } from '@opentelemetry/core'
+import { ReadableSpan, SpanExporter } from '@opentelemetry/sdk-trace-base'
 
 export type SaveFunction = (spans: ReadableSpan[]) => Promise<void>
 

packages/mcp-trace/trace-core/processors/CacheSpanProcessor.ts

@@ -1,9 +1,7 @@
-import type { Context } from '@opentelemetry/api'
-import { trace } from '@opentelemetry/api'
-import type { BufferConfig, ReadableSpan, Span, SpanExporter } from '@opentelemetry/sdk-trace-base'
-import { BatchSpanProcessor } from '@opentelemetry/sdk-trace-base'
+import { Context, trace } from '@opentelemetry/api'
+import { BatchSpanProcessor, BufferConfig, ReadableSpan, Span, SpanExporter } from '@opentelemetry/sdk-trace-base'
 
-import type { TraceCache } from '../core/traceCache'
+import { TraceCache } from '../core/traceCache'
 
 export class CacheBatchSpanProcessor extends BatchSpanProcessor {
   private cache: TraceCache

packages/mcp-trace/trace-core/processors/EmitterSpanProcessor.ts

@@ -1,7 +1,6 @@
-import type { Context } from '@opentelemetry/api'
-import type { BufferConfig, ReadableSpan, Span, SpanExporter } from '@opentelemetry/sdk-trace-base'
-import { BatchSpanProcessor } from '@opentelemetry/sdk-trace-base'
-import type { EventEmitter } from 'stream'
+import { Context } from '@opentelemetry/api'
+import { BatchSpanProcessor, BufferConfig, ReadableSpan, Span, SpanExporter } from '@opentelemetry/sdk-trace-base'
+import { EventEmitter } from 'stream'
 
 import { convertSpanToSpanEntity } from '../core/spanConvert'
 

packages/mcp-trace/trace-core/processors/FuncSpanProcessor.ts

@@ -1,7 +1,5 @@
-import type { Context } from '@opentelemetry/api'
-import { trace } from '@opentelemetry/api'
-import type { BufferConfig, ReadableSpan, Span, SpanExporter } from '@opentelemetry/sdk-trace-base'
-import { BatchSpanProcessor } from '@opentelemetry/sdk-trace-base'
+import { Context, trace } from '@opentelemetry/api'
+import { BatchSpanProcessor, BufferConfig, ReadableSpan, Span, SpanExporter } from '@opentelemetry/sdk-trace-base'
 
 export type SpanFunction = (span: ReadableSpan) => void
 

packages/mcp-trace/trace-core/types/config.ts

@@ -1,5 +1,5 @@
-import type { Link } from '@opentelemetry/api'
-import type { TimedEvent } from '@opentelemetry/sdk-trace-base'
+import { Link } from '@opentelemetry/api'
+import { TimedEvent } from '@opentelemetry/sdk-trace-base'
 
 export type AttributeValue =
   | string

packages/mcp-trace/trace-node/nodeTracer.ts

@@ -1,14 +1,11 @@
-import type { Tracer } from '@opentelemetry/api'
-import { trace } from '@opentelemetry/api'
+import { trace, Tracer } from '@opentelemetry/api'
 import { AsyncLocalStorageContextManager } from '@opentelemetry/context-async-hooks'
 import { W3CTraceContextPropagator } from '@opentelemetry/core'
 import { OTLPTraceExporter } from '@opentelemetry/exporter-trace-otlp-http'
-import type { SpanProcessor } from '@opentelemetry/sdk-trace-base'
-import { BatchSpanProcessor, ConsoleSpanExporter } from '@opentelemetry/sdk-trace-base'
+import { BatchSpanProcessor, ConsoleSpanExporter, SpanProcessor } from '@opentelemetry/sdk-trace-base'
 import { NodeTracerProvider } from '@opentelemetry/sdk-trace-node'
 
-import type { TraceConfig } from '../trace-core/types/config'
-import { defaultConfig } from '../trace-core/types/config'
+import { defaultConfig, TraceConfig } from '../trace-core/types/config'
 
 export class NodeTracer {
   private static provider: NodeTracerProvider

packages/mcp-trace/trace-web/TopicContextManager.ts

@@ -1,5 +1,4 @@
-import type { Context, ContextManager } from '@opentelemetry/api'
-import { ROOT_CONTEXT } from '@opentelemetry/api'
+import { Context, ContextManager, ROOT_CONTEXT } from '@opentelemetry/api'
 
 export class TopicContextManager implements ContextManager {
   private topicContextStack: Map<string, Context[]>

packages/mcp-trace/trace-web/traceContextPromise.ts

@@ -1,5 +1,4 @@
-import type { Context } from '@opentelemetry/api'
-import { context } from '@opentelemetry/api'
+import { Context, context } from '@opentelemetry/api'
 
 const originalPromise = globalThis.Promise
 

packages/mcp-trace/trace-web/webTracer.ts

@@ -1,11 +1,9 @@
 import { W3CTraceContextPropagator } from '@opentelemetry/core'
 import { OTLPTraceExporter } from '@opentelemetry/exporter-trace-otlp-http'
-import type { SpanProcessor } from '@opentelemetry/sdk-trace-base'
-import { BatchSpanProcessor, ConsoleSpanExporter } from '@opentelemetry/sdk-trace-base'
+import { BatchSpanProcessor, ConsoleSpanExporter, SpanProcessor } from '@opentelemetry/sdk-trace-base'
 import { WebTracerProvider } from '@opentelemetry/sdk-trace-web'
 
-import type { TraceConfig } from '../trace-core/types/config'
-import { defaultConfig } from '../trace-core/types/config'
+import { defaultConfig, TraceConfig } from '../trace-core/types/config'
 import { TopicContextManager } from './TopicContextManager'
 
 export const contextManager = new TopicContextManager()

packages/shared/IpcChannel.ts

@@ -2,11 +2,11 @@ export enum IpcChannel {
   App_GetCacheSize = 'app:get-cache-size',
   App_ClearCache = 'app:clear-cache',
   App_SetLaunchOnBoot = 'app:set-launch-on-boot',
-  // App_SetLanguage = 'app:set-language',
+  App_SetLanguage = 'app:set-language',
   App_SetEnableSpellCheck = 'app:set-enable-spell-check',
   App_SetSpellCheckLanguages = 'app:set-spell-check-languages',
+  App_ShowUpdateDialog = 'app:show-update-dialog',
   App_CheckForUpdate = 'app:check-for-update',
-  App_QuitAndInstall = 'app:quit-and-install',
   App_Reload = 'app:reload',
   App_Quit = 'app:quit',
   App_Info = 'app:info',
@@ -14,7 +14,7 @@ export enum IpcChannel {
   App_SetLaunchToTray = 'app:set-launch-to-tray',
   App_SetTray = 'app:set-tray',
   App_SetTrayOnClose = 'app:set-tray-on-close',
-  // App_SetTheme = 'app:set-theme',
+  App_SetTheme = 'app:set-theme',
   App_SetAutoUpdate = 'app:set-auto-update',
   App_SetTestPlan = 'app:set-test-plan',
   App_SetTestChannel = 'app:set-test-channel',
@@ -34,7 +34,6 @@ export enum IpcChannel {
   App_GetBinaryPath = 'app:get-binary-path',
   App_InstallUvBinary = 'app:install-uv-binary',
   App_InstallBunBinary = 'app:install-bun-binary',
-  App_InstallOvmsBinary = 'app:install-ovms-binary',
   App_LogToMain = 'app:log-to-main',
   App_SaveData = 'app:save-data',
   App_GetDiskInfo = 'app:get-disk-info',
@@ -46,14 +45,13 @@ export enum IpcChannel {
   App_MacRequestProcessTrust = 'app:mac-request-process-trust',
 
   App_QuoteToMain = 'app:quote-to-main',
-  // App_SetDisableHardwareAcceleration = 'app:set-disable-hardware-acceleration',
+  App_SetDisableHardwareAcceleration = 'app:set-disable-hardware-acceleration',
 
   Notification_Send = 'notification:send',
   Notification_OnClick = 'notification:on-click',
 
   Webview_SetOpenLinkExternal = 'webview:set-open-link-external',
   Webview_SetSpellCheckEnabled = 'webview:set-spell-check-enabled',
-  Webview_SearchHotkey = 'webview:search-hotkey',
 
   // Open
   Open_Path = 'open:path',
@@ -92,10 +90,6 @@ export enum IpcChannel {
   // Python
   Python_Execute = 'python:execute',
 
-  // agent messages
-  AgentMessage_PersistExchange = 'agent-message:persist-exchange',
-  AgentMessage_GetHistory = 'agent-message:get-history',
-
   //copilot
   Copilot_GetAuthMessage = 'copilot:get-auth-message',
   Copilot_GetCopilotToken = 'copilot:get-copilot-token',
@@ -189,7 +183,6 @@ export enum IpcChannel {
   File_ValidateNotesDirectory = 'file:validateNotesDirectory',
   File_StartWatcher = 'file:startWatcher',
   File_StopWatcher = 'file:stopWatcher',
-  File_ShowInFolder = 'file:showInFolder',
 
   // file service
   FileService_Upload = 'file-service:upload',
@@ -220,22 +213,6 @@ export enum IpcChannel {
   Backup_DeleteS3File = 'backup:deleteS3File',
   Backup_CheckS3Connection = 'backup:checkS3Connection',
 
-  // data migration
-  DataMigrate_CheckNeeded = 'data-migrate:check-needed',
-  DataMigrate_GetProgress = 'data-migrate:get-progress',
-  DataMigrate_Cancel = 'data-migrate:cancel',
-  DataMigrate_RequireBackup = 'data-migrate:require-backup',
-  DataMigrate_BackupCompleted = 'data-migrate:backup-completed',
-  DataMigrate_ShowBackupDialog = 'data-migrate:show-backup-dialog',
-  DataMigrate_StartFlow = 'data-migrate:start-flow',
-  DataMigrate_ProceedToBackup = 'data-migrate:proceed-to-backup',
-  DataMigrate_StartMigration = 'data-migrate:start-migration',
-  DataMigrate_RetryMigration = 'data-migrate:retry-migration',
-  DataMigrate_RestartApp = 'data-migrate:restart-app',
-  DataMigrate_CloseWindow = 'data-migrate:close-window',
-  DataMigrate_SendReduxData = 'data-migrate:send-redux-data',
-  DataMigrate_GetReduxData = 'data-migrate:get-redux-data',
-
   // zip
   Zip_Compress = 'zip:compress',
   Zip_Decompress = 'zip:decompress',
@@ -243,15 +220,14 @@ export enum IpcChannel {
   // system
   System_GetDeviceType = 'system:getDeviceType',
   System_GetHostname = 'system:getHostname',
-  System_GetCpuName = 'system:getCpuName',
 
   // DevTools
   System_ToggleDevTools = 'system:toggleDevTools',
 
   // events
   BackupProgress = 'backup-progress',
-  DataMigrateProgress = 'data-migrate-progress',
-  NativeThemeUpdated = 'native-theme:updated',
+  ThemeUpdated = 'theme:updated',
+  UpdateDownloadedCancelled = 'update-downloaded-cancelled',
   RestoreProgress = 'restore-progress',
   UpdateError = 'update-error',
   UpdateAvailable = 'update-available',
@@ -290,6 +266,12 @@ export enum IpcChannel {
   Selection_ToolbarVisibilityChange = 'selection:toolbar-visibility-change',
   Selection_ToolbarDetermineSize = 'selection:toolbar-determine-size',
   Selection_WriteToClipboard = 'selection:write-to-clipboard',
+  Selection_SetEnabled = 'selection:set-enabled',
+  Selection_SetTriggerMode = 'selection:set-trigger-mode',
+  Selection_SetFilterMode = 'selection:set-filter-mode',
+  Selection_SetFilterList = 'selection:set-filter-list',
+  Selection_SetFollowToolbar = 'selection:set-follow-toolbar',
+  Selection_SetRemeberWinSize = 'selection:set-remeber-win-size',
   Selection_ActionWindowClose = 'selection:action-window-close',
   Selection_ActionWindowMinimize = 'selection:action-window-minimize',
   Selection_ActionWindowPin = 'selection:action-window-pin',
@@ -308,27 +290,6 @@ export enum IpcChannel {
   Memory_DeleteAllMemoriesForUser = 'memory:delete-all-memories-for-user',
   Memory_GetUsersList = 'memory:get-users-list',
 
-  // Data: Preference
-  Preference_Get = 'preference:get',
-  Preference_Set = 'preference:set',
-  Preference_GetMultiple = 'preference:get-multiple',
-  Preference_SetMultiple = 'preference:set-multiple',
-  Preference_GetAll = 'preference:get-all',
-  Preference_Subscribe = 'preference:subscribe',
-  Preference_Changed = 'preference:changed',
-
-  // Data: Cache
-  Cache_Sync = 'cache:sync',
-  Cache_SyncBatch = 'cache:sync-batch',
-
-  // Data: API Channels
-  DataApi_Request = 'data-api:request',
-  DataApi_Batch = 'data-api:batch',
-  DataApi_Transaction = 'data-api:transaction',
-  DataApi_Subscribe = 'data-api:subscribe',
-  DataApi_Unsubscribe = 'data-api:unsubscribe',
-  DataApi_Stream = 'data-api:stream',
-
   // TRACE
   TRACE_SAVE_DATA = 'trace:saveData',
   TRACE_GET_DATA = 'trace:getData',
@@ -369,15 +330,6 @@ export enum IpcChannel {
   // OCR
   OCR_ocr = 'ocr:ocr',
 
-  // OVMS
-  Ovms_AddModel = 'ovms:add-model',
-  Ovms_StopAddModel = 'ovms:stop-addmodel',
-  Ovms_GetModels = 'ovms:get-models',
-  Ovms_IsRunning = 'ovms:is-running',
-  Ovms_GetStatus = 'ovms:get-status',
-  Ovms_RunOVMS = 'ovms:run-ovms',
-  Ovms_StopOVMS = 'ovms:stop-ovms',
-
   // CherryAI
   Cherryai_GetSignature = 'cherryai:get-signature'
 }

packages/shared/agents/claudecode/types.ts

@@ -1,12 +0,0 @@
-import type { SDKMessage } from '@anthropic-ai/claude-agent-sdk'
-import type { ContentBlockParam } from '@anthropic-ai/sdk/resources/messages'
-
-export type ClaudeCodeRawValue =
-  | {
-      type: string
-      session_id: string
-      slash_commands: string[]
-      tools: string[]
-      raw: Extract<SDKMessage, { type: 'system' }>
-    }
-  | ContentBlockParam

packages/shared/anthropic/index.ts

@@ -1,170 +0,0 @@
-/**
- * @fileoverview Shared Anthropic AI client utilities for Cherry Studio
- *
- * This module provides functions for creating Anthropic SDK clients with different
- * authentication methods (OAuth, API key) and building Claude Code system messages.
- * It supports both standard Anthropic API and Anthropic Vertex AI endpoints.
- *
- * This shared module can be used by both main and renderer processes.
- */
-
-import Anthropic from '@anthropic-ai/sdk'
-import type { TextBlockParam } from '@anthropic-ai/sdk/resources'
-import { loggerService } from '@logger'
-import type { Provider } from '@types'
-import type { ModelMessage } from 'ai'
-
-const logger = loggerService.withContext('anthropic-sdk')
-
-const defaultClaudeCodeSystemPrompt = `You are Claude Code, Anthropic's official CLI for Claude.`
-
-const defaultClaudeCodeSystem: Array<TextBlockParam> = [
-  {
-    type: 'text',
-    text: defaultClaudeCodeSystemPrompt
-  }
-]
-
-/**
- * Creates and configures an Anthropic SDK client based on the provider configuration.
- *
- * This function supports two authentication methods:
- * 1. OAuth: Uses OAuth tokens passed as parameter
- * 2. API Key: Uses traditional API key authentication
- *
- * For OAuth authentication, it includes Claude Code specific headers and beta features.
- * For API key authentication, it uses the provider's configuration with custom headers.
- *
- * @param provider - The provider configuration containing authentication details
- * @param oauthToken - Optional OAuth token for OAuth authentication
- * @returns An initialized Anthropic or AnthropicVertex client
- * @throws Error when OAuth token is not available for OAuth authentication
- *
- * @example
- * ```typescript
- * // OAuth authentication
- * const oauthProvider = { authType: 'oauth' };
- * const oauthClient = getSdkClient(oauthProvider, 'oauth-token-here');
- *
- * // API key authentication
- * const apiKeyProvider = {
- *   authType: 'apikey',
- *   apiKey: 'your-api-key',
- *   apiHost: 'https://api.anthropic.com'
- * };
- * const apiKeyClient = getSdkClient(apiKeyProvider);
- * ```
- */
-export function getSdkClient(
-  provider: Provider,
-  oauthToken?: string | null,
-  extraHeaders?: Record<string, string | string[]>
-): Anthropic {
-  if (provider.authType === 'oauth') {
-    if (!oauthToken) {
-      throw new Error('OAuth token is not available')
-    }
-    return new Anthropic({
-      authToken: oauthToken,
-      baseURL: 'https://api.anthropic.com',
-      dangerouslyAllowBrowser: true,
-      defaultHeaders: {
-        'Content-Type': 'application/json',
-        'anthropic-version': '2023-06-01',
-        'anthropic-beta':
-          'oauth-2025-04-20,claude-code-20250219,interleaved-thinking-2025-05-14,fine-grained-tool-streaming-2025-05-14',
-        'anthropic-dangerous-direct-browser-access': 'true',
-        'user-agent': 'claude-cli/1.0.118 (external, sdk-ts)',
-        'x-app': 'cli',
-        'x-stainless-retry-count': '0',
-        'x-stainless-timeout': '600',
-        'x-stainless-lang': 'js',
-        'x-stainless-package-version': '0.60.0',
-        'x-stainless-os': 'MacOS',
-        'x-stainless-arch': 'arm64',
-        'x-stainless-runtime': 'node',
-        'x-stainless-runtime-version': 'v22.18.0',
-        ...extraHeaders
-      }
-    })
-  }
-  const baseURL =
-    provider.type === 'anthropic'
-      ? provider.apiHost
-      : (provider.anthropicApiHost && provider.anthropicApiHost.trim()) || provider.apiHost
-
-  logger.debug('Anthropic API baseURL', { baseURL, providerId: provider.id })
-
-  if (provider.id === 'aihubmix') {
-    return new Anthropic({
-      apiKey: provider.apiKey,
-      baseURL,
-      dangerouslyAllowBrowser: true,
-      defaultHeaders: {
-        'anthropic-beta': 'output-128k-2025-02-19',
-        'APP-Code': 'MLTG2087',
-        ...provider.extra_headers,
-        ...extraHeaders
-      }
-    })
-  }
-
-  return new Anthropic({
-    apiKey: provider.apiKey,
-    authToken: provider.apiKey,
-    baseURL,
-    dangerouslyAllowBrowser: true,
-    defaultHeaders: {
-      'anthropic-beta': 'output-128k-2025-02-19',
-      ...provider.extra_headers
-    }
-  })
-}
-
-/**
- * Builds and prepends the Claude Code system message to user-provided system messages.
- *
- * This function ensures that all interactions with Claude include the official Claude Code
- * system prompt, which identifies the assistant as "Claude Code, Anthropic's official CLI for Claude."
- *
- * The function handles three cases:
- * 1. No system message provided: Returns only the default Claude Code system message
- * 2. String system message: Converts to array format and prepends Claude Code message
- * 3. Array system message: Checks if Claude Code message exists and prepends if missing
- *
- * @param system - Optional user-provided system message (string or TextBlockParam array)
- * @returns Combined system message with Claude Code prompt prepended
- *
- * ```
- */
-export function buildClaudeCodeSystemMessage(system?: string | Array<TextBlockParam>): Array<TextBlockParam> {
-  if (!system) {
-    return defaultClaudeCodeSystem
-  }
-
-  if (typeof system === 'string') {
-    if (system.trim() === defaultClaudeCodeSystemPrompt || system.trim() === '') {
-      return defaultClaudeCodeSystem
-    } else {
-      return [...defaultClaudeCodeSystem, { type: 'text', text: system }]
-    }
-  }
-  if (Array.isArray(system)) {
-    const firstSystem = system[0]
-    if (firstSystem.type === 'text' && firstSystem.text.trim() === defaultClaudeCodeSystemPrompt) {
-      return system
-    } else {
-      return [...defaultClaudeCodeSystem, ...system]
-    }
-  }
-
-  return defaultClaudeCodeSystem
-}
-
-export function buildClaudeCodeSystemModelMessage(system?: string | Array<TextBlockParam>): Array<ModelMessage> {
-  const textBlocks = buildClaudeCodeSystemMessage(system)
-  return textBlocks.map((block) => ({
-    role: 'system',
-    content: block.text
-  }))
-}

packages/shared/config/constant.ts

@@ -197,11 +197,11 @@ export enum FeedUrl {
   GITHUB_LATEST = 'https://github.com/CherryHQ/cherry-studio/releases/latest/download'
 }
 
-// export enum UpgradeChannel {
-//   LATEST = 'latest', // 最新稳定版本
-//   RC = 'rc', // 公测版本
-//   BETA = 'beta' // 预览版本
-// }
+export enum UpgradeChannel {
+  LATEST = 'latest', // 最新稳定版本
+  RC = 'rc', // 公测版本
+  BETA = 'beta' // 预览版本
+}
 
 export const defaultTimeout = 10 * 1000 * 60
 
@@ -217,8 +217,7 @@ export enum codeTools {
   claudeCode = 'claude-code',
   geminiCli = 'gemini-cli',
   openaiCodex = 'openai-codex',
-  iFlowCli = 'iflow-cli',
-  githubCopilotCli = 'github-copilot-cli'
+  iFlowCli = 'iflow-cli'
 }
 
 export enum terminalApps {

packages/shared/config/types.ts

@@ -1,4 +1,4 @@
-import type { ProcessingStatus } from '@types'
+import { ProcessingStatus } from '@types'
 
 export type LoaderReturn = {
   entriesAdded: number
@@ -22,12 +22,3 @@ export type MCPProgressEvent = {
   callId: string
   progress: number // 0-1 range
 }
-
-export type WebviewKeyEvent = {
-  webviewId: number
-  key: string
-  control: boolean
-  meta: boolean
-  shift: boolean
-  alt: boolean
-}

packages/shared/data/README.md

@@ -1,106 +0,0 @@
-# Cherry Studio Shared Data
-
-This directory contains shared type definitions and schemas for the Cherry Studio data management systems. These files provide type safety and consistency across the entire application.
-
-## 📁 Directory Structure
-
-```
-packages/shared/data/
-├── api/                     # Data API type system
-│   ├── index.ts            # Barrel exports for clean imports
-│   ├── apiSchemas.ts       # API endpoint definitions and mappings
-│   ├── apiTypes.ts         # Core request/response infrastructure types
-│   ├── apiModels.ts        # Business entity types and DTOs
-│   ├── apiPaths.ts         # API path definitions and utilities
-│   └── errorCodes.ts       # Standardized error handling
-├── cache/                   # Cache system type definitions
-│   ├── cacheTypes.ts       # Core cache infrastructure types
-│   ├── cacheSchemas.ts     # Cache key schemas and type mappings
-│   └── cacheValueTypes.ts  # Cache value type definitions
-├── preference/              # Preference system type definitions
-│   ├── preferenceTypes.ts  # Core preference system types
-│   └── preferenceSchemas.ts # Preference schemas and default values
-└── README.md               # This file
-```
-
-## 🏗️ System Overview
-
-This directory provides type definitions for three main data management systems:
-
-### API System (`api/`)
-- **Purpose**: Type-safe IPC communication between Main and Renderer processes
-- **Features**: RESTful patterns, error handling, business entity definitions
-- **Usage**: Ensures type safety for all data API operations
-
-### Cache System (`cache/`)
-- **Purpose**: Type definitions for three-layer caching architecture
-- **Features**: Memory/shared/persist cache schemas, TTL support, hook integration
-- **Usage**: Type-safe caching operations across the application
-
-### Preference System (`preference/`)
-- **Purpose**: User configuration and settings management
-- **Features**: 158 configuration items, default values, nested key support
-- **Usage**: Type-safe preference access and synchronization
-
-## 📋 File Categories
-
-**Framework Infrastructure** - These are TypeScript type definitions that:
-- ✅ Exist only at compile time
-- ✅ Provide type safety and IntelliSense support
-- ✅ Define contracts between application layers
-- ✅ Enable static analysis and error detection
-
-## 📖 Usage Examples
-
-### API Types
-```typescript
-// Import API types
-import type { DataRequest, DataResponse, ApiSchemas } from '@shared/data/api'
-```
-
-### Cache Types
-```typescript
-// Import cache types
-import type { UseCacheKey, UseSharedCacheKey } from '@shared/data/cache'
-```
-
-### Preference Types
-```typescript
-// Import preference types
-import type { PreferenceKeyType, PreferenceDefaultScopeType } from '@shared/data/preference'
-```
-
-## 🔧 Development Guidelines
-
-### Adding Cache Types
-1. Add cache key to `cache/cacheSchemas.ts`
-2. Define value type in `cache/cacheValueTypes.ts`
-3. Update type mappings for type safety
-
-### Adding Preference Types
-1. Add preference key to `preference/preferenceSchemas.ts`
-2. Define default value and type
-3. Preference system automatically picks up new keys
-
-### Adding API Types
-1. Define business entities in `api/apiModels.ts`
-2. Add endpoint definitions to `api/apiSchemas.ts`
-3. Export types from `api/index.ts`
-
-### Best Practices
-- Use `import type` for type-only imports
-- Follow existing naming conventions
-- Document complex types with JSDoc
-- Maintain type safety across all imports
-
-## 🔗 Related Implementation
-
-### Main Process Services
-- `src/main/data/CacheService.ts` - Main process cache management
-- `src/main/data/PreferenceService.ts` - Preference management service
-- `src/main/data/DataApiService.ts` - Data API coordination service
-
-### Renderer Process Services
-- `src/renderer/src/data/CacheService.ts` - Renderer cache service
-- `src/renderer/src/data/PreferenceService.ts` - Renderer preference service
-- `src/renderer/src/data/DataApiService.ts` - Renderer API client

packages/shared/data/api/apiModels.ts

@@ -1,107 +0,0 @@
-/**
- * Generic test model definitions
- * Contains flexible types for comprehensive API testing
- */
-
-/**
- * Generic test item entity - flexible structure for testing various scenarios
- */
-export interface TestItem {
-  /** Unique identifier */
-  id: string
-  /** Item title */
-  title: string
-  /** Optional description */
-  description?: string
-  /** Type category */
-  type: string
-  /** Current status */
-  status: string
-  /** Priority level */
-  priority: string
-  /** Associated tags */
-  tags: string[]
-  /** Creation timestamp */
-  createdAt: string
-  /** Last update timestamp */
-  updatedAt: string
-  /** Additional metadata */
-  metadata: Record<string, any>
-}
-
-/**
- * Data Transfer Objects (DTOs) for test operations
- */
-
-/**
- * DTO for creating a new test item
- */
-export interface CreateTestItemDto {
-  /** Item title */
-  title: string
-  /** Optional description */
-  description?: string
-  /** Type category */
-  type?: string
-  /** Current status */
-  status?: string
-  /** Priority level */
-  priority?: string
-  /** Associated tags */
-  tags?: string[]
-  /** Additional metadata */
-  metadata?: Record<string, any>
-}
-
-/**
- * DTO for updating an existing test item
- */
-export interface UpdateTestItemDto {
-  /** Updated title */
-  title?: string
-  /** Updated description */
-  description?: string
-  /** Updated type */
-  type?: string
-  /** Updated status */
-  status?: string
-  /** Updated priority */
-  priority?: string
-  /** Updated tags */
-  tags?: string[]
-  /** Updated metadata */
-  metadata?: Record<string, any>
-}
-
-/**
- * Bulk operation types for batch processing
- */
-
-/**
- * Request for bulk operations on multiple items
- */
-export interface BulkOperationRequest<TData = any> {
-  /** Type of bulk operation to perform */
-  operation: 'create' | 'update' | 'delete' | 'archive' | 'restore'
-  /** Array of data items to process */
-  data: TData[]
-}
-
-/**
- * Response from a bulk operation
- */
-export interface BulkOperationResponse {
-  /** Number of successfully processed items */
-  successful: number
-  /** Number of items that failed processing */
-  failed: number
-  /** Array of errors that occurred during processing */
-  errors: Array<{
-    /** Index of the item that failed */
-    index: number
-    /** Error message */
-    error: string
-    /** Optional additional error data */
-    data?: any
-  }>
-}

packages/shared/data/api/apiPaths.ts

@@ -1,60 +0,0 @@
-import type { ApiSchemas } from './apiSchemas'
-
-/**
- * Template literal type utilities for converting parameterized paths to concrete paths
- * This enables type-safe API calls with actual paths like '/test/items/123' instead of '/test/items/:id'
- */
-
-/**
- * Convert parameterized path templates to concrete path types
- * @example '/test/items/:id' -> '/test/items/${string}'
- * @example '/topics/:id/messages' -> '/topics/${string}/messages'
- */
-export type ResolvedPath<T extends string> = T extends `${infer Prefix}/:${string}/${infer Suffix}`
-  ? `${Prefix}/${string}/${ResolvedPath<Suffix>}`
-  : T extends `${infer Prefix}/:${string}`
-    ? `${Prefix}/${string}`
-    : T
-
-/**
- * Generate all possible concrete paths from ApiSchemas
- * This creates a union type of all valid API paths
- */
-export type ConcreteApiPaths = {
-  [K in keyof ApiSchemas]: ResolvedPath<K & string>
-}[keyof ApiSchemas]
-
-/**
- * Reverse lookup: from concrete path back to original template path
- * Used to determine which ApiSchema entry matches a concrete path
- */
-export type MatchApiPath<Path extends string> = {
-  [K in keyof ApiSchemas]: Path extends ResolvedPath<K & string> ? K : never
-}[keyof ApiSchemas]
-
-/**
- * Extract query parameters type for a given concrete path
- */
-export type QueryParamsForPath<Path extends string> = MatchApiPath<Path> extends keyof ApiSchemas
-  ? ApiSchemas[MatchApiPath<Path>] extends { GET: { query?: infer Q } }
-    ? Q
-    : Record<string, any>
-  : Record<string, any>
-
-/**
- * Extract request body type for a given concrete path and HTTP method
- */
-export type BodyForPath<Path extends string, Method extends string> = MatchApiPath<Path> extends keyof ApiSchemas
-  ? ApiSchemas[MatchApiPath<Path>] extends { [M in Method]: { body: infer B } }
-    ? B
-    : any
-  : any
-
-/**
- * Extract response type for a given concrete path and HTTP method
- */
-export type ResponseForPath<Path extends string, Method extends string> = MatchApiPath<Path> extends keyof ApiSchemas
-  ? ApiSchemas[MatchApiPath<Path>] extends { [M in Method]: { response: infer R } }
-    ? R
-    : any
-  : any

packages/shared/data/api/apiSchemas.ts

@@ -1,487 +0,0 @@
-// NOTE: Types are defined inline in the schema for simplicity
-// If needed, specific types can be imported from './apiModels'
-import type { BodyForPath, ConcreteApiPaths, QueryParamsForPath, ResponseForPath } from './apiPaths'
-import type { HttpMethod, PaginatedResponse, PaginationParams } from './apiTypes'
-
-// Re-export for external use
-export type { ConcreteApiPaths } from './apiPaths'
-
-/**
- * Complete API Schema definitions for Test API
- *
- * Each path defines the supported HTTP methods with their:
- * - Request parameters (params, query, body)
- * - Response types
- * - Type safety guarantees
- *
- * This schema serves as the contract between renderer and main processes,
- * enabling full TypeScript type checking across IPC boundaries.
- */
-export interface ApiSchemas {
-  /**
-   * Test items collection endpoint
-   * @example GET /test/items?page=1&limit=10&search=hello
-   * @example POST /test/items { "title": "New Test Item" }
-   */
-  '/test/items': {
-    /** List all test items with optional filtering and pagination */
-    GET: {
-      query?: PaginationParams & {
-        /** Search items by title or description */
-        search?: string
-        /** Filter by item type */
-        type?: string
-        /** Filter by status */
-        status?: string
-      }
-      response: PaginatedResponse<any>
-    }
-    /** Create a new test item */
-    POST: {
-      body: {
-        title: string
-        description?: string
-        type?: string
-        status?: string
-        priority?: string
-        tags?: string[]
-        metadata?: Record<string, any>
-      }
-      response: any
-    }
-  }
-
-  /**
-   * Individual test item endpoint
-   * @example GET /test/items/123
-   * @example PUT /test/items/123 { "title": "Updated Title" }
-   * @example DELETE /test/items/123
-   */
-  '/test/items/:id': {
-    /** Get a specific test item by ID */
-    GET: {
-      params: { id: string }
-      response: any
-    }
-    /** Update a specific test item */
-    PUT: {
-      params: { id: string }
-      body: {
-        title?: string
-        description?: string
-        type?: string
-        status?: string
-        priority?: string
-        tags?: string[]
-        metadata?: Record<string, any>
-      }
-      response: any
-    }
-    /** Delete a specific test item */
-    DELETE: {
-      params: { id: string }
-      response: void
-    }
-  }
-
-  /**
-   * Test search endpoint
-   * @example GET /test/search?query=hello&page=1&limit=20
-   */
-  '/test/search': {
-    /** Search test items */
-    GET: {
-      query: {
-        /** Search query string */
-        query: string
-        /** Page number for pagination */
-        page?: number
-        /** Number of results per page */
-        limit?: number
-        /** Additional filters */
-        type?: string
-        status?: string
-      }
-      response: PaginatedResponse<any>
-    }
-  }
-
-  /**
-   * Test statistics endpoint
-   * @example GET /test/stats
-   */
-  '/test/stats': {
-    /** Get comprehensive test statistics */
-    GET: {
-      response: {
-        /** Total number of items */
-        total: number
-        /** Item count grouped by type */
-        byType: Record<string, number>
-        /** Item count grouped by status */
-        byStatus: Record<string, number>
-        /** Item count grouped by priority */
-        byPriority: Record<string, number>
-        /** Recent activity timeline */
-        recentActivity: Array<{
-          /** Date of activity */
-          date: string
-          /** Number of items on that date */
-          count: number
-        }>
-      }
-    }
-  }
-
-  /**
-   * Test bulk operations endpoint
-   * @example POST /test/bulk { "operation": "create", "data": [...] }
-   */
-  '/test/bulk': {
-    /** Perform bulk operations on test items */
-    POST: {
-      body: {
-        /** Operation type */
-        operation: 'create' | 'update' | 'delete'
-        /** Array of data items to process */
-        data: any[]
-      }
-      response: {
-        successful: number
-        failed: number
-        errors: string[]
-      }
-    }
-  }
-
-  /**
-   * Test error simulation endpoint
-   * @example POST /test/error { "errorType": "timeout" }
-   */
-  '/test/error': {
-    /** Simulate various error scenarios for testing */
-    POST: {
-      body: {
-        /** Type of error to simulate */
-        errorType:
-          | 'timeout'
-          | 'network'
-          | 'server'
-          | 'notfound'
-          | 'validation'
-          | 'unauthorized'
-          | 'ratelimit'
-          | 'generic'
-      }
-      response: never
-    }
-  }
-
-  /**
-   * Test slow response endpoint
-   * @example POST /test/slow { "delay": 2000 }
-   */
-  '/test/slow': {
-    /** Test slow response for performance testing */
-    POST: {
-      body: {
-        /** Delay in milliseconds */
-        delay: number
-      }
-      response: {
-        message: string
-        delay: number
-        timestamp: string
-      }
-    }
-  }
-
-  /**
-   * Test data reset endpoint
-   * @example POST /test/reset
-   */
-  '/test/reset': {
-    /** Reset all test data to initial state */
-    POST: {
-      response: {
-        message: string
-        timestamp: string
-      }
-    }
-  }
-
-  /**
-   * Test config endpoint
-   * @example GET /test/config
-   * @example PUT /test/config { "setting": "value" }
-   */
-  '/test/config': {
-    /** Get test configuration */
-    GET: {
-      response: Record<string, any>
-    }
-    /** Update test configuration */
-    PUT: {
-      body: Record<string, any>
-      response: Record<string, any>
-    }
-  }
-
-  /**
-   * Test status endpoint
-   * @example GET /test/status
-   */
-  '/test/status': {
-    /** Get system test status */
-    GET: {
-      response: {
-        status: string
-        timestamp: string
-        version: string
-        uptime: number
-        environment: string
-      }
-    }
-  }
-
-  /**
-   * Test performance endpoint
-   * @example GET /test/performance
-   */
-  '/test/performance': {
-    /** Get performance metrics */
-    GET: {
-      response: {
-        requestsPerSecond: number
-        averageLatency: number
-        memoryUsage: number
-        cpuUsage: number
-        uptime: number
-      }
-    }
-  }
-
-  /**
-   * Batch execution of multiple requests
-   * @example POST /batch { "requests": [...], "parallel": true }
-   */
-  '/batch': {
-    /** Execute multiple API requests in a single call */
-    POST: {
-      body: {
-        /** Array of requests to execute */
-        requests: Array<{
-          /** HTTP method for the request */
-          method: HttpMethod
-          /** API path for the request */
-          path: string
-          /** URL parameters */
-          params?: any
-          /** Request body */
-          body?: any
-        }>
-        /** Execute requests in parallel vs sequential */
-        parallel?: boolean
-      }
-      response: {
-        /** Results array matching input order */
-        results: Array<{
-          /** HTTP status code */
-          status: number
-          /** Response data if successful */
-          data?: any
-          /** Error information if failed */
-          error?: any
-        }>
-        /** Batch execution metadata */
-        metadata: {
-          /** Total execution duration in ms */
-          duration: number
-          /** Number of successful requests */
-          successCount: number
-          /** Number of failed requests */
-          errorCount: number
-        }
-      }
-    }
-  }
-
-  /**
-   * Atomic transaction of multiple operations
-   * @example POST /transaction { "operations": [...], "options": { "rollbackOnError": true } }
-   */
-  '/transaction': {
-    /** Execute multiple operations in a database transaction */
-    POST: {
-      body: {
-        /** Array of operations to execute atomically */
-        operations: Array<{
-          /** HTTP method for the operation */
-          method: HttpMethod
-          /** API path for the operation */
-          path: string
-          /** URL parameters */
-          params?: any
-          /** Request body */
-          body?: any
-        }>
-        /** Transaction configuration options */
-        options?: {
-          /** Database isolation level */
-          isolation?: 'read-uncommitted' | 'read-committed' | 'repeatable-read' | 'serializable'
-          /** Rollback all operations on any error */
-          rollbackOnError?: boolean
-          /** Transaction timeout in milliseconds */
-          timeout?: number
-        }
-      }
-      response: Array<{
-        /** HTTP status code */
-        status: number
-        /** Response data if successful */
-        data?: any
-        /** Error information if failed */
-        error?: any
-      }>
-    }
-  }
-}
-
-/**
- * Simplified type extraction helpers
- */
-export type ApiPaths = keyof ApiSchemas
-export type ApiMethods<TPath extends ApiPaths> = keyof ApiSchemas[TPath] & HttpMethod
-export type ApiResponse<TPath extends ApiPaths, TMethod extends string> = TPath extends keyof ApiSchemas
-  ? TMethod extends keyof ApiSchemas[TPath]
-    ? ApiSchemas[TPath][TMethod] extends { response: infer R }
-      ? R
-      : never
-    : never
-  : never
-
-export type ApiParams<TPath extends ApiPaths, TMethod extends string> = TPath extends keyof ApiSchemas
-  ? TMethod extends keyof ApiSchemas[TPath]
-    ? ApiSchemas[TPath][TMethod] extends { params: infer P }
-      ? P
-      : never
-    : never
-  : never
-
-export type ApiQuery<TPath extends ApiPaths, TMethod extends string> = TPath extends keyof ApiSchemas
-  ? TMethod extends keyof ApiSchemas[TPath]
-    ? ApiSchemas[TPath][TMethod] extends { query: infer Q }
-      ? Q
-      : never
-    : never
-  : never
-
-export type ApiBody<TPath extends ApiPaths, TMethod extends string> = TPath extends keyof ApiSchemas
-  ? TMethod extends keyof ApiSchemas[TPath]
-    ? ApiSchemas[TPath][TMethod] extends { body: infer B }
-      ? B
-      : never
-    : never
-  : never
-
-/**
- * Type-safe API client interface using concrete paths
- * Accepts actual paths like '/test/items/123' instead of '/test/items/:id'
- * Automatically infers query, body, and response types from ApiSchemas
- */
-export interface ApiClient {
-  get<TPath extends ConcreteApiPaths>(
-    path: TPath,
-    options?: {
-      query?: QueryParamsForPath<TPath>
-      headers?: Record<string, string>
-    }
-  ): Promise<ResponseForPath<TPath, 'GET'>>
-
-  post<TPath extends ConcreteApiPaths>(
-    path: TPath,
-    options: {
-      body?: BodyForPath<TPath, 'POST'>
-      query?: Record<string, any>
-      headers?: Record<string, string>
-    }
-  ): Promise<ResponseForPath<TPath, 'POST'>>
-
-  put<TPath extends ConcreteApiPaths>(
-    path: TPath,
-    options: {
-      body: BodyForPath<TPath, 'PUT'>
-      query?: Record<string, any>
-      headers?: Record<string, string>
-    }
-  ): Promise<ResponseForPath<TPath, 'PUT'>>
-
-  delete<TPath extends ConcreteApiPaths>(
-    path: TPath,
-    options?: {
-      query?: Record<string, any>
-      headers?: Record<string, string>
-    }
-  ): Promise<ResponseForPath<TPath, 'DELETE'>>
-
-  patch<TPath extends ConcreteApiPaths>(
-    path: TPath,
-    options: {
-      body?: BodyForPath<TPath, 'PATCH'>
-      query?: Record<string, any>
-      headers?: Record<string, string>
-    }
-  ): Promise<ResponseForPath<TPath, 'PATCH'>>
-}
-
-/**
- * Helper types to determine if parameters are required based on schema
- */
-type HasRequiredQuery<Path extends ApiPaths, Method extends ApiMethods<Path>> = Path extends keyof ApiSchemas
-  ? Method extends keyof ApiSchemas[Path]
-    ? ApiSchemas[Path][Method] extends { query: any }
-      ? true
-      : false
-    : false
-  : false
-
-type HasRequiredBody<Path extends ApiPaths, Method extends ApiMethods<Path>> = Path extends keyof ApiSchemas
-  ? Method extends keyof ApiSchemas[Path]
-    ? ApiSchemas[Path][Method] extends { body: any }
-      ? true
-      : false
-    : false
-  : false
-
-type HasRequiredParams<Path extends ApiPaths, Method extends ApiMethods<Path>> = Path extends keyof ApiSchemas
-  ? Method extends keyof ApiSchemas[Path]
-    ? ApiSchemas[Path][Method] extends { params: any }
-      ? true
-      : false
-    : false
-  : false
-
-/**
- * Handler function for a specific API endpoint
- * Provides type-safe parameter extraction based on ApiSchemas
- * Parameters are required or optional based on the schema definition
- */
-export type ApiHandler<Path extends ApiPaths, Method extends ApiMethods<Path>> = (
-  params: (HasRequiredParams<Path, Method> extends true
-    ? { params: ApiParams<Path, Method> }
-    : { params?: ApiParams<Path, Method> }) &
-    (HasRequiredQuery<Path, Method> extends true
-      ? { query: ApiQuery<Path, Method> }
-      : { query?: ApiQuery<Path, Method> }) &
-    (HasRequiredBody<Path, Method> extends true ? { body: ApiBody<Path, Method> } : { body?: ApiBody<Path, Method> })
-) => Promise<ApiResponse<Path, Method>>
-
-/**
- * Complete API implementation that must match ApiSchemas structure
- * TypeScript will error if any endpoint is missing - this ensures exhaustive coverage
- */
-export type ApiImplementation = {
-  [Path in ApiPaths]: {
-    [Method in ApiMethods<Path>]: ApiHandler<Path, Method>
-  }
-}

packages/shared/data/api/apiTypes.ts

@@ -1,289 +0,0 @@
-/**
- * Core types for the Data API system
- * Provides type definitions for request/response handling across renderer-main IPC communication
- */
-
-/**
- * Standard HTTP methods supported by the Data API
- */
-export type HttpMethod = 'GET' | 'POST' | 'PUT' | 'DELETE' | 'PATCH'
-
-/**
- * Request object structure for Data API calls
- */
-export interface DataRequest<T = any> {
-  /** Unique request identifier for tracking and correlation */
-  id: string
-  /** HTTP method for the request */
-  method: HttpMethod
-  /** API path (e.g., '/topics', '/topics/123') */
-  path: string
-  /** URL parameters for the request */
-  params?: Record<string, any>
-  /** Request body data */
-  body?: T
-  /** Request headers */
-  headers?: Record<string, string>
-  /** Additional metadata for request processing */
-  metadata?: {
-    /** Request timestamp */
-    timestamp: number
-    /** OpenTelemetry span context for tracing */
-    spanContext?: any
-    /** Cache options for this specific request */
-    cache?: CacheOptions
-  }
-}
-
-/**
- * Response object structure for Data API calls
- */
-export interface DataResponse<T = any> {
-  /** Request ID that this response corresponds to */
-  id: string
-  /** HTTP status code */
-  status: number
-  /** Response data if successful */
-  data?: T
-  /** Error information if request failed */
-  error?: DataApiError
-  /** Response metadata */
-  metadata?: {
-    /** Request processing duration in milliseconds */
-    duration: number
-    /** Whether response was served from cache */
-    cached?: boolean
-    /** Cache TTL if applicable */
-    cacheTtl?: number
-    /** Response timestamp */
-    timestamp: number
-  }
-}
-
-/**
- * Standardized error structure for Data API
- */
-export interface DataApiError {
-  /** Error code for programmatic handling */
-  code: string
-  /** Human-readable error message */
-  message: string
-  /** HTTP status code */
-  status: number
-  /** Additional error details */
-  details?: any
-  /** Error stack trace (development mode only) */
-  stack?: string
-}
-
-/**
- * Standard error codes for Data API
- */
-export enum ErrorCode {
-  // Client errors (4xx)
-  BAD_REQUEST = 'BAD_REQUEST',
-  UNAUTHORIZED = 'UNAUTHORIZED',
-  FORBIDDEN = 'FORBIDDEN',
-  NOT_FOUND = 'NOT_FOUND',
-  METHOD_NOT_ALLOWED = 'METHOD_NOT_ALLOWED',
-  VALIDATION_ERROR = 'VALIDATION_ERROR',
-  RATE_LIMIT_EXCEEDED = 'RATE_LIMIT_EXCEEDED',
-
-  // Server errors (5xx)
-  INTERNAL_SERVER_ERROR = 'INTERNAL_SERVER_ERROR',
-  DATABASE_ERROR = 'DATABASE_ERROR',
-  SERVICE_UNAVAILABLE = 'SERVICE_UNAVAILABLE',
-
-  // Custom application errors
-  MIGRATION_ERROR = 'MIGRATION_ERROR',
-  PERMISSION_DENIED = 'PERMISSION_DENIED',
-  RESOURCE_LOCKED = 'RESOURCE_LOCKED',
-  CONCURRENT_MODIFICATION = 'CONCURRENT_MODIFICATION'
-}
-
-/**
- * Cache configuration options
- */
-export interface CacheOptions {
-  /** Cache TTL in seconds */
-  ttl?: number
-  /** Return stale data while revalidating in background */
-  staleWhileRevalidate?: boolean
-  /** Custom cache key override */
-  cacheKey?: string
-  /** Operations that should invalidate this cache entry */
-  invalidateOn?: string[]
-  /** Whether to bypass cache entirely */
-  noCache?: boolean
-}
-
-/**
- * Transaction request wrapper for atomic operations
- */
-export interface TransactionRequest {
-  /** List of operations to execute in transaction */
-  operations: DataRequest[]
-  /** Transaction options */
-  options?: {
-    /** Database isolation level */
-    isolation?: 'read-uncommitted' | 'read-committed' | 'repeatable-read' | 'serializable'
-    /** Whether to rollback entire transaction on any error */
-    rollbackOnError?: boolean
-    /** Transaction timeout in milliseconds */
-    timeout?: number
-  }
-}
-
-/**
- * Batch request for multiple operations
- */
-export interface BatchRequest {
-  /** List of requests to execute */
-  requests: DataRequest[]
-  /** Whether to execute requests in parallel */
-  parallel?: boolean
-  /** Stop on first error */
-  stopOnError?: boolean
-}
-
-/**
- * Batch response containing results for all requests
- */
-export interface BatchResponse {
-  /** Individual response for each request */
-  results: DataResponse[]
-  /** Overall batch execution metadata */
-  metadata: {
-    /** Total execution time */
-    duration: number
-    /** Number of successful operations */
-    successCount: number
-    /** Number of failed operations */
-    errorCount: number
-  }
-}
-
-/**
- * Pagination parameters for list operations
- */
-export interface PaginationParams {
-  /** Page number (1-based) */
-  page?: number
-  /** Items per page */
-  limit?: number
-  /** Cursor for cursor-based pagination */
-  cursor?: string
-  /** Sort field and direction */
-  sort?: {
-    field: string
-    order: 'asc' | 'desc'
-  }
-}
-
-/**
- * Paginated response wrapper
- */
-export interface PaginatedResponse<T> {
-  /** Items for current page */
-  items: T[]
-  /** Total number of items */
-  total: number
-  /** Current page number */
-  page: number
-  /** Total number of pages */
-  pageCount: number
-  /** Whether there are more pages */
-  hasNext: boolean
-  /** Whether there are previous pages */
-  hasPrev: boolean
-  /** Next cursor for cursor-based pagination */
-  nextCursor?: string
-  /** Previous cursor for cursor-based pagination */
-  prevCursor?: string
-}
-
-/**
- * Subscription options for real-time data updates
- */
-export interface SubscriptionOptions {
-  /** Path pattern to subscribe to */
-  path: string
-  /** Filters to apply to subscription */
-  filters?: Record<string, any>
-  /** Whether to receive initial data */
-  includeInitial?: boolean
-  /** Custom subscription metadata */
-  metadata?: Record<string, any>
-}
-
-/**
- * Subscription callback function
- */
-export type SubscriptionCallback<T = any> = (data: T, event: SubscriptionEvent) => void
-
-/**
- * Subscription event types
- */
-export enum SubscriptionEvent {
-  CREATED = 'created',
-  UPDATED = 'updated',
-  DELETED = 'deleted',
-  INITIAL = 'initial',
-  ERROR = 'error'
-}
-
-/**
- * Middleware interface
- */
-export interface Middleware {
-  /** Middleware name */
-  name: string
-  /** Execution priority (lower = earlier) */
-  priority?: number
-  /** Middleware execution function */
-  execute(req: DataRequest, res: DataResponse, next: () => Promise<void>): Promise<void>
-}
-
-/**
- * Request context passed through middleware chain
- */
-export interface RequestContext {
-  /** Original request */
-  request: DataRequest
-  /** Response being built */
-  response: DataResponse
-  /** Path that matched this request */
-  path?: string
-  /** HTTP method */
-  method?: HttpMethod
-  /** Authenticated user (if any) */
-  user?: any
-  /** Additional context data */
-  data: Map<string, any>
-}
-
-/**
- * Base options for service operations
- */
-export interface ServiceOptions {
-  /** Database transaction to use */
-  transaction?: any
-  /** User context for authorization */
-  user?: any
-  /** Additional service-specific options */
-  metadata?: Record<string, any>
-}
-
-/**
- * Standard service response wrapper
- */
-export interface ServiceResult<T = any> {
-  /** Whether operation was successful */
-  success: boolean
-  /** Result data if successful */
-  data?: T
-  /** Error information if failed */
-  error?: DataApiError
-  /** Additional metadata */
-  metadata?: Record<string, any>
-}

packages/shared/data/api/errorCodes.ts

@@ -1,194 +0,0 @@
-/**
- * Centralized error code definitions for the Data API system
- * Provides consistent error handling across renderer and main processes
- */
-
-import type { DataApiError } from './apiTypes'
-import { ErrorCode } from './apiTypes'
-
-// Re-export ErrorCode for convenience
-export { ErrorCode } from './apiTypes'
-
-/**
- * Error code to HTTP status mapping
- */
-export const ERROR_STATUS_MAP: Record<ErrorCode, number> = {
-  // Client errors (4xx)
-  [ErrorCode.BAD_REQUEST]: 400,
-  [ErrorCode.UNAUTHORIZED]: 401,
-  [ErrorCode.FORBIDDEN]: 403,
-  [ErrorCode.NOT_FOUND]: 404,
-  [ErrorCode.METHOD_NOT_ALLOWED]: 405,
-  [ErrorCode.VALIDATION_ERROR]: 422,
-  [ErrorCode.RATE_LIMIT_EXCEEDED]: 429,
-
-  // Server errors (5xx)
-  [ErrorCode.INTERNAL_SERVER_ERROR]: 500,
-  [ErrorCode.DATABASE_ERROR]: 500,
-  [ErrorCode.SERVICE_UNAVAILABLE]: 503,
-
-  // Custom application errors (5xx)
-  [ErrorCode.MIGRATION_ERROR]: 500,
-  [ErrorCode.PERMISSION_DENIED]: 403,
-  [ErrorCode.RESOURCE_LOCKED]: 423,
-  [ErrorCode.CONCURRENT_MODIFICATION]: 409
-}
-
-/**
- * Default error messages for each error code
- */
-export const ERROR_MESSAGES: Record<ErrorCode, string> = {
-  [ErrorCode.BAD_REQUEST]: 'Bad request: Invalid request format or parameters',
-  [ErrorCode.UNAUTHORIZED]: 'Unauthorized: Authentication required',
-  [ErrorCode.FORBIDDEN]: 'Forbidden: Insufficient permissions',
-  [ErrorCode.NOT_FOUND]: 'Not found: Requested resource does not exist',
-  [ErrorCode.METHOD_NOT_ALLOWED]: 'Method not allowed: HTTP method not supported for this endpoint',
-  [ErrorCode.VALIDATION_ERROR]: 'Validation error: Request data does not meet requirements',
-  [ErrorCode.RATE_LIMIT_EXCEEDED]: 'Rate limit exceeded: Too many requests',
-
-  [ErrorCode.INTERNAL_SERVER_ERROR]: 'Internal server error: An unexpected error occurred',
-  [ErrorCode.DATABASE_ERROR]: 'Database error: Failed to access or modify data',
-  [ErrorCode.SERVICE_UNAVAILABLE]: 'Service unavailable: The service is temporarily unavailable',
-
-  [ErrorCode.MIGRATION_ERROR]: 'Migration error: Failed to migrate data',
-  [ErrorCode.PERMISSION_DENIED]: 'Permission denied: Operation not allowed for current user',
-  [ErrorCode.RESOURCE_LOCKED]: 'Resource locked: Resource is currently locked by another operation',
-  [ErrorCode.CONCURRENT_MODIFICATION]: 'Concurrent modification: Resource was modified by another user'
-}
-
-/**
- * Utility class for creating standardized Data API errors
- */
-export class DataApiErrorFactory {
-  /**
-   * Create a DataApiError with standard properties
-   */
-  static create(code: ErrorCode, customMessage?: string, details?: any, stack?: string): DataApiError {
-    return {
-      code,
-      message: customMessage || ERROR_MESSAGES[code],
-      status: ERROR_STATUS_MAP[code],
-      details,
-      stack: stack || undefined
-    }
-  }
-
-  /**
-   * Create a validation error with field-specific details
-   */
-  static validation(fieldErrors: Record<string, string[]>, message?: string): DataApiError {
-    return this.create(ErrorCode.VALIDATION_ERROR, message || 'Request validation failed', { fieldErrors })
-  }
-
-  /**
-   * Create a not found error for specific resource
-   */
-  static notFound(resource: string, id?: string): DataApiError {
-    const message = id ? `${resource} with id '${id}' not found` : `${resource} not found`
-
-    return this.create(ErrorCode.NOT_FOUND, message, { resource, id })
-  }
-
-  /**
-   * Create a database error with query details
-   */
-  static database(originalError: Error, operation?: string): DataApiError {
-    return this.create(
-      ErrorCode.DATABASE_ERROR,
-      `Database operation failed${operation ? `: ${operation}` : ''}`,
-      {
-        originalError: originalError.message,
-        operation
-      },
-      originalError.stack
-    )
-  }
-
-  /**
-   * Create a permission denied error
-   */
-  static permissionDenied(action: string, resource?: string): DataApiError {
-    const message = resource ? `Permission denied: Cannot ${action} ${resource}` : `Permission denied: Cannot ${action}`
-
-    return this.create(ErrorCode.PERMISSION_DENIED, message, { action, resource })
-  }
-
-  /**
-   * Create an internal server error from an unexpected error
-   */
-  static internal(originalError: Error, context?: string): DataApiError {
-    const message = context
-      ? `Internal error in ${context}: ${originalError.message}`
-      : `Internal error: ${originalError.message}`
-
-    return this.create(
-      ErrorCode.INTERNAL_SERVER_ERROR,
-      message,
-      { originalError: originalError.message, context },
-      originalError.stack
-    )
-  }
-
-  /**
-   * Create a rate limit exceeded error
-   */
-  static rateLimit(limit: number, windowMs: number): DataApiError {
-    return this.create(ErrorCode.RATE_LIMIT_EXCEEDED, `Rate limit exceeded: ${limit} requests per ${windowMs}ms`, {
-      limit,
-      windowMs
-    })
-  }
-
-  /**
-   * Create a resource locked error
-   */
-  static resourceLocked(resource: string, id: string, lockedBy?: string): DataApiError {
-    const message = lockedBy
-      ? `${resource} '${id}' is locked by ${lockedBy}`
-      : `${resource} '${id}' is currently locked`
-
-    return this.create(ErrorCode.RESOURCE_LOCKED, message, { resource, id, lockedBy })
-  }
-
-  /**
-   * Create a concurrent modification error
-   */
-  static concurrentModification(resource: string, id: string): DataApiError {
-    return this.create(ErrorCode.CONCURRENT_MODIFICATION, `${resource} '${id}' was modified by another user`, {
-      resource,
-      id
-    })
-  }
-}
-
-/**
- * Check if an error is a Data API error
- */
-export function isDataApiError(error: any): error is DataApiError {
-  return (
-    error &&
-    typeof error === 'object' &&
-    typeof error.code === 'string' &&
-    typeof error.message === 'string' &&
-    typeof error.status === 'number'
-  )
-}
-
-/**
- * Convert a generic error to a DataApiError
- */
-export function toDataApiError(error: unknown, context?: string): DataApiError {
-  if (isDataApiError(error)) {
-    return error
-  }
-
-  if (error instanceof Error) {
-    return DataApiErrorFactory.internal(error, context)
-  }
-
-  return DataApiErrorFactory.create(
-    ErrorCode.INTERNAL_SERVER_ERROR,
-    `Unknown error${context ? ` in ${context}` : ''}: ${String(error)}`,
-    { originalError: error, context }
-  )
-}

packages/shared/data/api/index.ts

@@ -1,121 +0,0 @@
-/**
- * Cherry Studio Data API - Barrel Exports
- *
- * This file provides a centralized entry point for all data API types,
- * schemas, and utilities. Import everything you need from this single location.
- *
- * @example
- * ```typescript
- * import { Topic, CreateTopicDto, ApiSchemas, DataRequest, ErrorCode } from '@/shared/data'
- * ```
- */
-
-// Core data API types and infrastructure
-export type {
-  BatchRequest,
-  BatchResponse,
-  CacheOptions,
-  DataApiError,
-  DataRequest,
-  DataResponse,
-  HttpMethod,
-  Middleware,
-  PaginatedResponse,
-  PaginationParams,
-  RequestContext,
-  ServiceOptions,
-  ServiceResult,
-  SubscriptionCallback,
-  SubscriptionOptions,
-  TransactionRequest
-} from './apiTypes'
-export { ErrorCode, SubscriptionEvent } from './apiTypes'
-
-// Domain models and DTOs
-export type {
-  BulkOperationRequest,
-  BulkOperationResponse,
-  CreateTestItemDto,
-  TestItem,
-  UpdateTestItemDto
-} from './apiModels'
-
-// API schema definitions and type helpers
-export type {
-  ApiBody,
-  ApiClient,
-  ApiMethods,
-  ApiParams,
-  ApiPaths,
-  ApiQuery,
-  ApiResponse,
-  ApiSchemas
-} from './apiSchemas'
-
-// Path type utilities for template literal types
-export type {
-  BodyForPath,
-  ConcreteApiPaths,
-  MatchApiPath,
-  QueryParamsForPath,
-  ResolvedPath,
-  ResponseForPath
-} from './apiPaths'
-
-// Error handling utilities
-export {
-  ErrorCode as DataApiErrorCode,
-  DataApiErrorFactory,
-  ERROR_MESSAGES,
-  ERROR_STATUS_MAP,
-  isDataApiError,
-  toDataApiError
-} from './errorCodes'
-
-/**
- * Re-export commonly used type combinations for convenience
- */
-
-// Import types for re-export convenience types
-import type { CreateTestItemDto, TestItem, UpdateTestItemDto } from './apiModels'
-import type {
-  BatchRequest,
-  BatchResponse,
-  DataApiError,
-  DataRequest,
-  DataResponse,
-  ErrorCode,
-  PaginatedResponse,
-  PaginationParams,
-  TransactionRequest
-} from './apiTypes'
-import type { DataApiErrorFactory } from './errorCodes'
-
-/** All test item-related types */
-export type TestItemTypes = {
-  TestItem: TestItem
-  CreateTestItemDto: CreateTestItemDto
-  UpdateTestItemDto: UpdateTestItemDto
-}
-
-/** All error-related types and utilities */
-export type ErrorTypes = {
-  DataApiError: DataApiError
-  ErrorCode: ErrorCode
-  ErrorFactory: typeof DataApiErrorFactory
-}
-
-/** All request/response types */
-export type RequestTypes = {
-  DataRequest: DataRequest
-  DataResponse: DataResponse
-  BatchRequest: BatchRequest
-  BatchResponse: BatchResponse
-  TransactionRequest: TransactionRequest
-}
-
-/** All pagination-related types */
-export type PaginationTypes = {
-  PaginationParams: PaginationParams
-  PaginatedResponse: PaginatedResponse<any>
-}

packages/shared/data/cache/cacheSchemas.ts

@@ -1,168 +0,0 @@
-import type { TranslateLanguageCode } from '@types'
-
-import type * as CacheValueTypes from './cacheValueTypes'
-
-/**
- * Use cache schema for renderer hook
- */
-
-export type UseCacheSchema = {
-  // App state
-  'app.dist.update_state': CacheValueTypes.CacheAppUpdateState
-  'app.user.avatar': string
-
-  // Chat context
-  'chat.multi_select_mode': boolean
-  'chat.selected_message_ids': string[]
-  'chat.generating': boolean
-  'chat.websearch.searching': boolean
-  'chat.websearch.active_searches': CacheValueTypes.CacheActiveSearches
-
-  // Minapp management
-  'minapp.opened_keep_alive': CacheValueTypes.CacheMinAppType[]
-  'minapp.current_id': string
-  'minapp.show': boolean
-  'minapp.opened_oneoff': CacheValueTypes.CacheMinAppType | null
-
-  // Topic management
-  'topic.active': CacheValueTypes.CacheTopic | null
-  'topic.renaming': string[]
-  'topic.newly_renamed': string[]
-
-  // Translate state
-  'translate.lang.source': TranslateLanguageCode | 'auto'
-  'translate.lang.target': TranslateLanguageCode
-  'translate.input': string
-  'translate.output': string
-  'translate.detecting': boolean
-  'translate.translating': CacheValueTypes.CacheTranslating
-  'translate.bidirectional': CacheValueTypes.CacheTranslateBidirectional
-
-  // Test keys (for dataRefactorTest window)
-  // TODO: remove after testing
-  'test-hook-memory-1': string
-  'test-ttl-cache': string
-  'test-protected-cache': string
-  'test-deep-equal': { nested: { count: number }; tags: string[] }
-  'test-performance': number
-  'test-multi-hook': string
-  'concurrent-test-1': number
-  'concurrent-test-2': number
-  'large-data-test': Record<string, any>
-  'test-number-cache': number
-  'test-object-cache': { name: string; count: number; active: boolean }
-}
-
-export const DefaultUseCache: UseCacheSchema = {
-  // App state
-  'app.dist.update_state': {
-    info: null,
-    checking: false,
-    downloading: false,
-    downloaded: false,
-    downloadProgress: 0,
-    available: false
-  },
-  'app.user.avatar': '',
-
-  // Chat context
-  'chat.multi_select_mode': false,
-  'chat.selected_message_ids': [],
-  'chat.generating': false,
-  'chat.websearch.searching': false,
-  'chat.websearch.active_searches': {},
-
-  // Minapp management
-  'minapp.opened_keep_alive': [],
-  'minapp.current_id': '',
-  'minapp.show': false,
-  'minapp.opened_oneoff': null,
-
-  // Topic management
-  'topic.active': null,
-  'topic.renaming': [],
-  'topic.newly_renamed': [],
-
-  // Translate state
-  'translate.lang.source': 'auto',
-  'translate.lang.target': 'zh-cn',
-  'translate.input': '',
-  'translate.output': '',
-  'translate.detecting': false,
-  'translate.translating': { isTranslating: false, abortKey: null },
-  'translate.bidirectional': {
-    enabled: false,
-    origin: 'en-us',
-    target: 'zh-cn'
-  },
-
-  // Test keys (for dataRefactorTest window)
-  // TODO: remove after testing
-  'test-hook-memory-1': 'default-memory-value',
-  'test-ttl-cache': 'test-ttl-cache',
-  'test-protected-cache': 'protected-value',
-  'test-deep-equal': { nested: { count: 0 }, tags: ['initial'] },
-  'test-performance': 0,
-  'test-multi-hook': 'hook-1-default',
-  'concurrent-test-1': 0,
-  'concurrent-test-2': 0,
-  'large-data-test': {},
-  'test-number-cache': 42,
-  'test-object-cache': { name: 'test', count: 0, active: true }
-}
-
-/**
- * Use shared cache schema for renderer hook
- */
-export type UseSharedCacheSchema = {
-  'example-key': string
-
-  // Test keys (for dataRefactorTest window)
-  // TODO: remove after testing
-  'test-hook-shared-1': string
-  'test-multi-hook': string
-  'concurrent-shared': number
-}
-
-export const DefaultUseSharedCache: UseSharedCacheSchema = {
-  'example-key': 'example default value',
-
-  // Test keys (for dataRefactorTest window)
-  // TODO: remove after testing
-  'concurrent-shared': 0,
-  'test-hook-shared-1': 'default-shared-value',
-  'test-multi-hook': 'hook-3-shared'
-}
-
-/**
- * Persist cache schema defining allowed keys and their value types
- * This ensures type safety and prevents key conflicts
- */
-export type RendererPersistCacheSchema = {
-  'example-key': string
-
-  // Test keys (for dataRefactorTest window)
-  // TODO: remove after testing
-  'example-1': string
-  'example-2': string
-  'example-3': string
-  'example-4': string
-}
-
-export const DefaultRendererPersistCache: RendererPersistCacheSchema = {
-  'example-key': 'example default value',
-
-  // Test keys (for dataRefactorTest window)
-  // TODO: remove after testing
-  'example-1': 'example default value',
-  'example-2': 'example default value',
-  'example-3': 'example default value',
-  'example-4': 'example default value'
-}
-
-/**
- * Type-safe cache key
- */
-export type RendererPersistCacheKey = keyof RendererPersistCacheSchema
-export type UseCacheKey = keyof UseCacheSchema
-export type UseSharedCacheKey = keyof UseSharedCacheSchema

packages/shared/data/cache/cacheTypes.ts

@@ -1,43 +0,0 @@
-/**
- * Cache types and interfaces for CacheService
- *
- * Supports three-layer caching architecture:
- * 1. Memory cache (cross-component within renderer)
- * 2. Shared cache (cross-window via IPC)
- * 3. Persist cache (cross-window with localStorage persistence)
- */
-
-/**
- * Cache entry with optional TTL support
- */
-export interface CacheEntry<T = any> {
-  value: T
-  expireAt?: number // Unix timestamp
-}
-
-/**
- * Cache synchronization message for IPC communication
- */
-export interface CacheSyncMessage {
-  type: 'shared' | 'persist'
-  key: string
-  value: any
-  ttl?: number
-}
-
-/**
- * Batch cache synchronization message
- */
-export interface CacheSyncBatchMessage {
-  type: 'shared' | 'persist'
-  entries: Array<{
-    key: string
-    value: any
-    ttl?: number
-  }>
-}
-
-/**
- * Cache subscription callback
- */
-export type CacheSubscriber = () => void

packages/shared/data/cache/cacheValueTypes.ts

@@ -1,32 +0,0 @@
-import type { MinAppType, Topic, TranslateLanguageCode, WebSearchStatus } from '@types'
-import type { UpdateInfo } from 'builder-util-runtime'
-
-export type CacheAppUpdateState = {
-  info: UpdateInfo | null
-  checking: boolean
-  downloading: boolean
-  downloaded: boolean
-  downloadProgress: number
-  available: boolean
-}
-
-export type CacheActiveSearches = Record<string, WebSearchStatus>
-
-// For cache schema, we use any for complex types to avoid circular dependencies
-// The actual type checking will be done at runtime by the cache system
-export type CacheMinAppType = MinAppType
-export type CacheTopic = Topic
-export type CacheTranslating =
-  | {
-      isTranslating: true
-      abortKey: string
-    }
-  | {
-      isTranslating: false
-      abortKey: null
-    }
-export type CacheTranslateBidirectional = {
-  enabled: boolean
-  origin: TranslateLanguageCode
-  target: TranslateLanguageCode
-}

packages/shared/data/preference/preferenceSchemas.ts

@@ -1,703 +0,0 @@
-/**
- * Auto-generated preferences configuration
- * Generated at: 2025-09-16T03:17:03.354Z
- *
- * This file is automatically generated from classification.json
- * To update this file, modify classification.json and run:
- * node .claude/data-classify/scripts/generate-preferences.js
- *
- * === AUTO-GENERATED CONTENT START ===
- */
-
-import { TRANSLATE_PROMPT } from '@shared/config/prompts'
-import * as PreferenceTypes from '@shared/data/preference/preferenceTypes'
-
-/* eslint @typescript-eslint/member-ordering: ["error", {
-  "interfaces": { "order": "alphabetically" },
-  "typeLiterals": { "order": "alphabetically" }
-}] */
-
-export interface PreferenceSchemas {
-  default: {
-    // redux/settings/enableDeveloperMode
-    'app.developer_mode.enabled': boolean
-    // redux/settings/disableHardwareAcceleration
-    'app.disable_hardware_acceleration': boolean
-    // redux/settings/autoCheckUpdate
-    'app.dist.auto_update.enabled': boolean
-    // redux/settings/testChannel
-    'app.dist.test_plan.channel': PreferenceTypes.UpgradeChannel
-    // redux/settings/testPlan
-    'app.dist.test_plan.enabled': boolean
-    // redux/settings/language
-    'app.language': PreferenceTypes.LanguageVarious | null
-    // redux/settings/launchOnBoot
-    'app.launch_on_boot': boolean
-    // redux/settings/notification.assistant
-    'app.notification.assistant.enabled': boolean
-    // redux/settings/notification.backup
-    'app.notification.backup.enabled': boolean
-    // redux/settings/notification.knowledge
-    'app.notification.knowledge.enabled': boolean
-    // redux/settings/enableDataCollection
-    'app.privacy.data_collection.enabled': boolean
-    // redux/settings/proxyBypassRules
-    'app.proxy.bypass_rules': string
-    // redux/settings/proxyMode
-    'app.proxy.mode': PreferenceTypes.ProxyMode
-    // redux/settings/proxyUrl
-    'app.proxy.url': string
-    // redux/settings/enableSpellCheck
-    'app.spell_check.enabled': boolean
-    // redux/settings/spellCheckLanguages
-    'app.spell_check.languages': string[]
-    // redux/settings/tray
-    'app.tray.enabled': boolean
-    // redux/settings/trayOnClose
-    'app.tray.on_close': boolean
-    // redux/settings/launchToTray
-    'app.tray.on_launch': boolean
-    // redux/settings/userId
-    'app.user.id': string
-    // redux/settings/userName
-    'app.user.name': string
-    // electronStore/ZoomFactor/ZoomFactor
-    'app.zoom_factor': number
-    // redux/settings/clickAssistantToShowTopic
-    'assistant.click_to_show_topic': boolean
-    // redux/settings/assistantIconType
-    'assistant.icon_type': PreferenceTypes.AssistantIconType
-    // redux/settings/showAssistants
-    'assistant.tab.show': boolean
-    // redux/settings/assistantsTabSortType
-    'assistant.tab.sort_type': PreferenceTypes.AssistantTabSortType
-    // redux/settings/codeCollapsible
-    'chat.code.collapsible': boolean
-    // redux/settings/codeEditor.autocompletion
-    'chat.code.editor.autocompletion': boolean
-    // redux/settings/codeEditor.enabled
-    'chat.code.editor.enabled': boolean
-    // redux/settings/codeEditor.foldGutter
-    'chat.code.editor.fold_gutter': boolean
-    // redux/settings/codeEditor.highlightActiveLine
-    'chat.code.editor.highlight_active_line': boolean
-    // redux/settings/codeEditor.keymap
-    'chat.code.editor.keymap': boolean
-    // redux/settings/codeEditor.themeDark
-    'chat.code.editor.theme_dark': string
-    // redux/settings/codeEditor.themeLight
-    'chat.code.editor.theme_light': string
-    // redux/settings/codeExecution.enabled
-    'chat.code.execution.enabled': boolean
-    // redux/settings/codeExecution.timeoutMinutes
-    'chat.code.execution.timeout_minutes': number
-    // redux/settings/codeFancyBlock
-    'chat.code.fancy_block': boolean
-    // redux/settings/codeImageTools
-    'chat.code.image_tools': boolean
-    // redux/settings/codePreview.themeDark
-    'chat.code.preview.theme_dark': string
-    // redux/settings/codePreview.themeLight
-    'chat.code.preview.theme_light': string
-    // redux/settings/codeShowLineNumbers
-    'chat.code.show_line_numbers': boolean
-    // redux/settings/codeViewer.themeDark
-    'chat.code.viewer.theme_dark': string
-    // redux/settings/codeViewer.themeLight
-    'chat.code.viewer.theme_light': string
-    // redux/settings/codeWrappable
-    'chat.code.wrappable': boolean
-    // redux/settings/pasteLongTextAsFile
-    'chat.input.paste_long_text_as_file': boolean
-    // redux/settings/pasteLongTextThreshold
-    'chat.input.paste_long_text_threshold': number
-    // redux/settings/enableQuickPanelTriggers
-    'chat.input.quick_panel.triggers_enabled': boolean
-    // redux/settings/sendMessageShortcut
-    'chat.input.send_message_shortcut': PreferenceTypes.SendMessageShortcut
-    // redux/settings/showInputEstimatedTokens
-    'chat.input.show_estimated_tokens': boolean
-    // redux/settings/autoTranslateWithSpace
-    'chat.input.translate.auto_translate_with_space': boolean
-    // redux/settings/showTranslateConfirm
-    'chat.input.translate.show_confirm': boolean
-    // redux/settings/confirmDeleteMessage
-    'chat.message.confirm_delete': boolean
-    // redux/settings/confirmRegenerateMessage
-    'chat.message.confirm_regenerate': boolean
-    // redux/settings/messageFont
-    'chat.message.font': string
-    // redux/settings/fontSize
-    'chat.message.font_size': number
-    // redux/settings/mathEngine
-    'chat.message.math.engine': PreferenceTypes.MathEngine
-    // redux/settings/mathEnableSingleDollar
-    'chat.message.math.single_dollar': boolean
-    // redux/settings/foldDisplayMode
-    'chat.message.multi_model.fold_display_mode': PreferenceTypes.MultiModelFoldDisplayMode
-    // redux/settings/gridColumns
-    'chat.message.multi_model.grid_columns': number
-    // redux/settings/gridPopoverTrigger
-    'chat.message.multi_model.grid_popover_trigger': PreferenceTypes.MultiModelGridPopoverTrigger
-    // redux/settings/multiModelMessageStyle
-    'chat.message.multi_model.style': PreferenceTypes.MultiModelMessageStyle
-    // redux/settings/messageNavigation
-    'chat.message.navigation_mode': PreferenceTypes.ChatMessageNavigationMode
-    // redux/settings/renderInputMessageAsMarkdown
-    'chat.message.render_as_markdown': boolean
-    // redux/settings/showMessageDivider
-    'chat.message.show_divider': boolean
-    // redux/settings/showMessageOutline
-    'chat.message.show_outline': boolean
-    // redux/settings/showPrompt
-    'chat.message.show_prompt': boolean
-    // redux/settings/messageStyle
-    'chat.message.style': PreferenceTypes.ChatMessageStyle
-    // redux/settings/thoughtAutoCollapse
-    'chat.message.thought.auto_collapse': boolean
-    // redux/settings/narrowMode
-    'chat.narrow_mode': boolean
-    // redux/settings/skipBackupFile
-    'data.backup.general.skip_backup_file': boolean
-    // redux/settings/localBackupAutoSync
-    'data.backup.local.auto_sync': boolean
-    // redux/settings/localBackupDir
-    'data.backup.local.dir': string
-    // redux/settings/localBackupMaxBackups
-    'data.backup.local.max_backups': number
-    // redux/settings/localBackupSkipBackupFile
-    'data.backup.local.skip_backup_file': boolean
-    // redux/settings/localBackupSyncInterval
-    'data.backup.local.sync_interval': number
-    // redux/nutstore/nutstoreAutoSync
-    'data.backup.nutstore.auto_sync': boolean
-    // redux/nutstore/nutstoreMaxBackups
-    'data.backup.nutstore.max_backups': number
-    // redux/nutstore/nutstorePath
-    'data.backup.nutstore.path': string
-    // redux/nutstore/nutstoreSkipBackupFile
-    'data.backup.nutstore.skip_backup_file': boolean
-    // redux/nutstore/nutstoreSyncInterval
-    'data.backup.nutstore.sync_interval': number
-    // redux/nutstore/nutstoreToken
-    'data.backup.nutstore.token': string
-    // redux/settings/s3.accessKeyId
-    'data.backup.s3.access_key_id': string
-    // redux/settings/s3.autoSync
-    'data.backup.s3.auto_sync': boolean
-    // redux/settings/s3.bucket
-    'data.backup.s3.bucket': string
-    // redux/settings/s3.endpoint
-    'data.backup.s3.endpoint': string
-    // redux/settings/s3.maxBackups
-    'data.backup.s3.max_backups': number
-    // redux/settings/s3.region
-    'data.backup.s3.region': string
-    // redux/settings/s3.root
-    'data.backup.s3.root': string
-    // redux/settings/s3.secretAccessKey
-    'data.backup.s3.secret_access_key': string
-    // redux/settings/s3.skipBackupFile
-    'data.backup.s3.skip_backup_file': boolean
-    // redux/settings/s3.syncInterval
-    'data.backup.s3.sync_interval': number
-    // redux/settings/webdavAutoSync
-    'data.backup.webdav.auto_sync': boolean
-    // redux/settings/webdavDisableStream
-    'data.backup.webdav.disable_stream': boolean
-    // redux/settings/webdavHost
-    'data.backup.webdav.host': string
-    // redux/settings/webdavMaxBackups
-    'data.backup.webdav.max_backups': number
-    // redux/settings/webdavPass
-    'data.backup.webdav.pass': string
-    // redux/settings/webdavPath
-    'data.backup.webdav.path': string
-    // redux/settings/webdavSkipBackupFile
-    'data.backup.webdav.skip_backup_file': boolean
-    // redux/settings/webdavSyncInterval
-    'data.backup.webdav.sync_interval': number
-    // redux/settings/webdavUser
-    'data.backup.webdav.user': string
-    // redux/settings/excludeCitationsInExport
-    'data.export.markdown.exclude_citations': boolean
-    // redux/settings/forceDollarMathInMarkdown
-    'data.export.markdown.force_dollar_math': boolean
-    // redux/settings/markdownExportPath
-    'data.export.markdown.path': string | null
-    // redux/settings/showModelNameInMarkdown
-    'data.export.markdown.show_model_name': boolean
-    // redux/settings/showModelProviderInMarkdown
-    'data.export.markdown.show_model_provider': boolean
-    // redux/settings/standardizeCitationsInExport
-    'data.export.markdown.standardize_citations': boolean
-    // redux/settings/useTopicNamingForMessageTitle
-    'data.export.markdown.use_topic_naming_for_message_title': boolean
-    // redux/settings/exportMenuOptions.docx
-    'data.export.menus.docx': boolean
-    // redux/settings/exportMenuOptions.image
-    'data.export.menus.image': boolean
-    // redux/settings/exportMenuOptions.joplin
-    'data.export.menus.joplin': boolean
-    // redux/settings/exportMenuOptions.markdown
-    'data.export.menus.markdown': boolean
-    // redux/settings/exportMenuOptions.markdown_reason
-    'data.export.menus.markdown_reason': boolean
-    // redux/settings/exportMenuOptions.notes
-    'data.export.menus.notes': boolean
-    // redux/settings/exportMenuOptions.notion
-    'data.export.menus.notion': boolean
-    // redux/settings/exportMenuOptions.obsidian
-    'data.export.menus.obsidian': boolean
-    // redux/settings/exportMenuOptions.plain_text
-    'data.export.menus.plain_text': boolean
-    // redux/settings/exportMenuOptions.siyuan
-    'data.export.menus.siyuan': boolean
-    // redux/settings/exportMenuOptions.yuque
-    'data.export.menus.yuque': boolean
-    // redux/settings/joplinExportReasoning
-    'data.integration.joplin.export_reasoning': boolean
-    // redux/settings/joplinToken
-    'data.integration.joplin.token': string
-    // redux/settings/joplinUrl
-    'data.integration.joplin.url': string
-    // redux/settings/notionApiKey
-    'data.integration.notion.api_key': string
-    // redux/settings/notionDatabaseID
-    'data.integration.notion.database_id': string
-    // redux/settings/notionExportReasoning
-    'data.integration.notion.export_reasoning': boolean
-    // redux/settings/notionPageNameKey
-    'data.integration.notion.page_name_key': string
-    // redux/settings/defaultObsidianVault
-    'data.integration.obsidian.default_vault': string
-    // redux/settings/siyuanApiUrl
-    'data.integration.siyuan.api_url': string | null
-    // redux/settings/siyuanBoxId
-    'data.integration.siyuan.box_id': string | null
-    // redux/settings/siyuanRootPath
-    'data.integration.siyuan.root_path': string | null
-    // redux/settings/siyuanToken
-    'data.integration.siyuan.token': string | null
-    // redux/settings/yuqueRepoId
-    'data.integration.yuque.repo_id': string
-    // redux/settings/yuqueToken
-    'data.integration.yuque.token': string
-    // redux/settings/yuqueUrl
-    'data.integration.yuque.url': string
-    // redux/settings/apiServer.apiKey
-    'feature.csaas.api_key': string
-    // redux/settings/apiServer.enabled
-    'feature.csaas.enabled': boolean
-    // redux/settings/apiServer.host
-    'feature.csaas.host': string
-    // redux/settings/apiServer.port
-    'feature.csaas.port': number
-    // redux/settings/maxKeepAliveMinapps
-    'feature.minapp.max_keep_alive': number
-    // redux/settings/minappsOpenLinkExternal
-    'feature.minapp.open_link_external': boolean
-    // redux/settings/showOpenedMinappsInSidebar
-    'feature.minapp.show_opened_in_sidebar': boolean
-    // redux/note/settings.defaultEditMode
-    'feature.notes.default_edit_mode': string
-    // redux/note/settings.defaultViewMode
-    'feature.notes.default_view_mode': string
-    // redux/note/settings.fontFamily
-    'feature.notes.font_family': string
-    // redux/note/settings.fontSize
-    'feature.notes.font_size': number
-    // redux/note/settings.isFullWidth
-    'feature.notes.full_width': boolean
-    // redux/note/notesPath
-    'feature.notes.path': string
-    // redux/note/settings.showTabStatus
-    'feature.notes.show_tab_status': boolean
-    // redux/note/settings.showTableOfContents
-    'feature.notes.show_table_of_contents': boolean
-    // redux/note/settings.showWorkspace
-    'feature.notes.show_workspace': boolean
-    // redux/note/sortType
-    'feature.notes.sort_type': string
-    // redux/settings/clickTrayToShowQuickAssistant
-    'feature.quick_assistant.click_tray_to_show': boolean
-    // redux/settings/enableQuickAssistant
-    'feature.quick_assistant.enabled': boolean
-    // redux/settings/readClipboardAtStartup
-    'feature.quick_assistant.read_clipboard_at_startup': boolean
-    // redux/selectionStore/actionItems
-    'feature.selection.action_items': PreferenceTypes.SelectionActionItem[]
-    // redux/selectionStore/actionWindowOpacity
-    'feature.selection.action_window_opacity': number
-    // redux/selectionStore/isAutoClose
-    'feature.selection.auto_close': boolean
-    // redux/selectionStore/isAutoPin
-    'feature.selection.auto_pin': boolean
-    // redux/selectionStore/isCompact
-    'feature.selection.compact': boolean
-    // redux/selectionStore/selectionEnabled
-    'feature.selection.enabled': boolean
-    // redux/selectionStore/filterList
-    'feature.selection.filter_list': string[]
-    // redux/selectionStore/filterMode
-    'feature.selection.filter_mode': PreferenceTypes.SelectionFilterMode
-    // redux/selectionStore/isFollowToolbar
-    'feature.selection.follow_toolbar': boolean
-    // redux/selectionStore/isRemeberWinSize
-    'feature.selection.remember_win_size': boolean
-    // redux/selectionStore/triggerMode
-    'feature.selection.trigger_mode': PreferenceTypes.SelectionTriggerMode
-    // redux/settings/translateModelPrompt
-    'feature.translate.model_prompt': string
-    // redux/settings/targetLanguage
-    'feature.translate.target_language': string
-    // redux/shortcuts/shortcuts.exit_fullscreen
-    'shortcut.app.exit_fullscreen': Record<string, unknown>
-    // redux/shortcuts/shortcuts.search_message
-    'shortcut.app.search_message': Record<string, unknown>
-    // redux/shortcuts/shortcuts.show_app
-    'shortcut.app.show_main_window': Record<string, unknown>
-    // redux/shortcuts/shortcuts.mini_window
-    'shortcut.app.show_mini_window': Record<string, unknown>
-    // redux/shortcuts/shortcuts.show_settings
-    'shortcut.app.show_settings': Record<string, unknown>
-    // redux/shortcuts/shortcuts.toggle_show_assistants
-    'shortcut.app.toggle_show_assistants': Record<string, unknown>
-    // redux/shortcuts/shortcuts.zoom_in
-    'shortcut.app.zoom_in': Record<string, unknown>
-    // redux/shortcuts/shortcuts.zoom_out
-    'shortcut.app.zoom_out': Record<string, unknown>
-    // redux/shortcuts/shortcuts.zoom_reset
-    'shortcut.app.zoom_reset': Record<string, unknown>
-    // redux/shortcuts/shortcuts.clear_topic
-    'shortcut.chat.clear': Record<string, unknown>
-    // redux/shortcuts/shortcuts.copy_last_message
-    'shortcut.chat.copy_last_message': Record<string, unknown>
-    // redux/shortcuts/shortcuts.search_message_in_chat
-    'shortcut.chat.search_message': Record<string, unknown>
-    // redux/shortcuts/shortcuts.toggle_new_context
-    'shortcut.chat.toggle_new_context': Record<string, unknown>
-    // redux/shortcuts/shortcuts.selection_assistant_select_text
-    'shortcut.selection.get_text': Record<string, unknown>
-    // redux/shortcuts/shortcuts.selection_assistant_toggle
-    'shortcut.selection.toggle_enabled': Record<string, unknown>
-    // redux/shortcuts/shortcuts.new_topic
-    'shortcut.topic.new': Record<string, unknown>
-    // redux/settings/enableTopicNaming
-    'topic.naming.enabled': boolean
-    // redux/settings/topicNamingPrompt
-    'topic.naming_prompt': string
-    // redux/settings/topicPosition
-    'topic.position': string
-    // redux/settings/pinTopicsToTop
-    'topic.tab.pin_to_top': boolean
-    // redux/settings/showTopics
-    'topic.tab.show': boolean
-    // redux/settings/showTopicTime
-    'topic.tab.show_time': boolean
-    // redux/translate/settings
-    'translate.settings.auto_copy': boolean
-    // indexedDB/translate
-    'translate.settings.auto_detection_method': PreferenceTypes.AutoDetectionMethod
-    'translate.settings.enable_markdown': boolean
-    'translate.settings.scroll_sync': boolean
-    // new preference
-    'translate.settings.target_langs': PreferenceTypes.TargetLangs
-    // redux/settings/customCss
-    'ui.custom_css': string
-    // redux/settings/navbarPosition
-    'ui.navbar.position': 'left' | 'top'
-    // redux/settings/sidebarIcons.disabled
-    'ui.sidebar.icons.invisible': PreferenceTypes.SidebarIcon[]
-    // redux/settings/sidebarIcons.visible
-    'ui.sidebar.icons.visible': PreferenceTypes.SidebarIcon[]
-    // redux/settings/theme
-    'ui.theme_mode': PreferenceTypes.ThemeMode
-    // redux/settings/userTheme.userCodeFontFamily
-    'ui.theme_user.code_font_family': string
-    // redux/settings/userTheme.colorPrimary
-    'ui.theme_user.color_primary': string
-    // redux/settings/userTheme.userFontFamily
-    'ui.theme_user.font_family': string
-    // redux/settings/windowStyle
-    'ui.window_style': PreferenceTypes.WindowStyle
-  }
-}
-
-/* eslint sort-keys: ["error", "asc", {"caseSensitive": true, "natural": false}] */
-export const DefaultPreferences: PreferenceSchemas = {
-  default: {
-    'app.developer_mode.enabled': false,
-    'app.disable_hardware_acceleration': false,
-    'app.dist.auto_update.enabled': true,
-    'app.dist.test_plan.channel': PreferenceTypes.UpgradeChannel.LATEST,
-    'app.dist.test_plan.enabled': false,
-    'app.language': null,
-    'app.launch_on_boot': false,
-    'app.notification.assistant.enabled': false,
-    'app.notification.backup.enabled': false,
-    'app.notification.knowledge.enabled': false,
-    'app.privacy.data_collection.enabled': false,
-    'app.proxy.bypass_rules': '',
-    'app.proxy.mode': 'system',
-    'app.proxy.url': '',
-    'app.spell_check.enabled': false,
-    'app.spell_check.languages': [],
-    'app.tray.enabled': true,
-    'app.tray.on_close': true,
-    'app.tray.on_launch': false,
-    'app.user.id': 'uuid()',
-    'app.user.name': '',
-    'app.zoom_factor': 1,
-    'assistant.click_to_show_topic': true,
-    'assistant.icon_type': 'emoji',
-    'assistant.tab.show': true,
-    'assistant.tab.sort_type': 'list',
-    'chat.code.collapsible': false,
-    'chat.code.editor.autocompletion': true,
-    'chat.code.editor.enabled': false,
-    'chat.code.editor.fold_gutter': false,
-    'chat.code.editor.highlight_active_line': false,
-    'chat.code.editor.keymap': false,
-    'chat.code.editor.theme_dark': 'auto',
-    'chat.code.editor.theme_light': 'auto',
-    'chat.code.execution.enabled': false,
-    'chat.code.execution.timeout_minutes': 1,
-    'chat.code.fancy_block': true,
-    'chat.code.image_tools': false,
-    'chat.code.preview.theme_dark': 'auto',
-    'chat.code.preview.theme_light': 'auto',
-    'chat.code.show_line_numbers': false,
-    'chat.code.viewer.theme_dark': 'auto',
-    'chat.code.viewer.theme_light': 'auto',
-    'chat.code.wrappable': false,
-    'chat.input.paste_long_text_as_file': false,
-    'chat.input.paste_long_text_threshold': 1500,
-    'chat.input.quick_panel.triggers_enabled': false,
-    'chat.input.send_message_shortcut': 'Enter',
-    'chat.input.show_estimated_tokens': false,
-    'chat.input.translate.auto_translate_with_space': false,
-    'chat.input.translate.show_confirm': true,
-    'chat.message.confirm_delete': true,
-    'chat.message.confirm_regenerate': true,
-    'chat.message.font': 'system',
-    'chat.message.font_size': 14,
-    'chat.message.math.engine': 'KaTeX',
-    'chat.message.math.single_dollar': true,
-    'chat.message.multi_model.fold_display_mode': 'expanded',
-    'chat.message.multi_model.grid_columns': 2,
-    'chat.message.multi_model.grid_popover_trigger': 'click',
-    'chat.message.multi_model.style': 'horizontal',
-    'chat.message.navigation_mode': 'none',
-    'chat.message.render_as_markdown': false,
-    'chat.message.show_divider': true,
-    'chat.message.show_outline': false,
-    'chat.message.show_prompt': true,
-    'chat.message.style': 'plain',
-    'chat.message.thought.auto_collapse': true,
-    'chat.narrow_mode': false,
-    'data.backup.general.skip_backup_file': false,
-    'data.backup.local.auto_sync': false,
-    'data.backup.local.dir': '',
-    'data.backup.local.max_backups': 0,
-    'data.backup.local.skip_backup_file': false,
-    'data.backup.local.sync_interval': 0,
-    'data.backup.nutstore.auto_sync': false,
-    'data.backup.nutstore.max_backups': 0,
-    'data.backup.nutstore.path': '/cherry-studio',
-    'data.backup.nutstore.skip_backup_file': false,
-    'data.backup.nutstore.sync_interval': 0,
-    'data.backup.nutstore.token': '',
-    'data.backup.s3.access_key_id': '',
-    'data.backup.s3.auto_sync': false,
-    'data.backup.s3.bucket': '',
-    'data.backup.s3.endpoint': '',
-    'data.backup.s3.max_backups': 0,
-    'data.backup.s3.region': '',
-    'data.backup.s3.root': '',
-    'data.backup.s3.secret_access_key': '',
-    'data.backup.s3.skip_backup_file': false,
-    'data.backup.s3.sync_interval': 0,
-    'data.backup.webdav.auto_sync': false,
-    'data.backup.webdav.disable_stream': false,
-    'data.backup.webdav.host': '',
-    'data.backup.webdav.max_backups': 0,
-    'data.backup.webdav.pass': '',
-    'data.backup.webdav.path': '/cherry-studio',
-    'data.backup.webdav.skip_backup_file': false,
-    'data.backup.webdav.sync_interval': 0,
-    'data.backup.webdav.user': '',
-    'data.export.markdown.exclude_citations': false,
-    'data.export.markdown.force_dollar_math': false,
-    'data.export.markdown.path': null,
-    'data.export.markdown.show_model_name': false,
-    'data.export.markdown.show_model_provider': false,
-    'data.export.markdown.standardize_citations': false,
-    'data.export.markdown.use_topic_naming_for_message_title': false,
-    'data.export.menus.docx': true,
-    'data.export.menus.image': true,
-    'data.export.menus.joplin': true,
-    'data.export.menus.markdown': true,
-    'data.export.menus.markdown_reason': true,
-    'data.export.menus.notes': true,
-    'data.export.menus.notion': true,
-    'data.export.menus.obsidian': true,
-    'data.export.menus.plain_text': true,
-    'data.export.menus.siyuan': true,
-    'data.export.menus.yuque': true,
-    'data.integration.joplin.export_reasoning': false,
-    'data.integration.joplin.token': '',
-    'data.integration.joplin.url': '',
-    'data.integration.notion.api_key': '',
-    'data.integration.notion.database_id': '',
-    'data.integration.notion.export_reasoning': false,
-    'data.integration.notion.page_name_key': 'Name',
-    'data.integration.obsidian.default_vault': '',
-    'data.integration.siyuan.api_url': null,
-    'data.integration.siyuan.box_id': null,
-    'data.integration.siyuan.root_path': null,
-    'data.integration.siyuan.token': null,
-    'data.integration.yuque.repo_id': '',
-    'data.integration.yuque.token': '',
-    'data.integration.yuque.url': '',
-    'feature.csaas.api_key': '`cs-sk-${uuid()}`',
-    'feature.csaas.enabled': false,
-    'feature.csaas.host': 'localhost',
-    'feature.csaas.port': 23333,
-    'feature.minapp.max_keep_alive': 3,
-    'feature.minapp.open_link_external': false,
-    'feature.minapp.show_opened_in_sidebar': true,
-    'feature.notes.default_edit_mode': 'preview',
-    'feature.notes.default_view_mode': 'edit',
-    'feature.notes.font_family': 'default',
-    'feature.notes.font_size': 16,
-    'feature.notes.full_width': true,
-    'feature.notes.path': '',
-    'feature.notes.show_tab_status': true,
-    'feature.notes.show_table_of_contents': true,
-    'feature.notes.show_workspace': true,
-    'feature.notes.sort_type': 'sort_a2z',
-    'feature.quick_assistant.click_tray_to_show': false,
-    'feature.quick_assistant.enabled': false,
-    'feature.quick_assistant.read_clipboard_at_startup': true,
-    'feature.selection.action_items': [
-      {
-        enabled: true,
-        icon: 'languages',
-        id: 'translate',
-        isBuiltIn: true,
-        name: 'selection.action.builtin.translate'
-      },
-      {
-        enabled: true,
-        icon: 'file-question',
-        id: 'explain',
-        isBuiltIn: true,
-        name: 'selection.action.builtin.explain'
-      },
-      { enabled: true, icon: 'scan-text', id: 'summary', isBuiltIn: true, name: 'selection.action.builtin.summary' },
-      {
-        enabled: true,
-        icon: 'search',
-        id: 'search',
-        isBuiltIn: true,
-        name: 'selection.action.builtin.search',
-        searchEngine: 'Google|https://www.google.com/search?q={{queryString}}'
-      },
-      { enabled: true, icon: 'clipboard-copy', id: 'copy', isBuiltIn: true, name: 'selection.action.builtin.copy' },
-      { enabled: false, icon: 'wand-sparkles', id: 'refine', isBuiltIn: true, name: 'selection.action.builtin.refine' },
-      { enabled: false, icon: 'quote', id: 'quote', isBuiltIn: true, name: 'selection.action.builtin.quote' }
-    ],
-    'feature.selection.action_window_opacity': 100,
-    'feature.selection.auto_close': false,
-    'feature.selection.auto_pin': false,
-    'feature.selection.compact': false,
-    'feature.selection.enabled': false,
-    'feature.selection.filter_list': [],
-    'feature.selection.filter_mode': PreferenceTypes.SelectionFilterMode.Default,
-    'feature.selection.follow_toolbar': true,
-    'feature.selection.remember_win_size': false,
-    'feature.selection.trigger_mode': PreferenceTypes.SelectionTriggerMode.Selected,
-    'feature.translate.model_prompt': TRANSLATE_PROMPT,
-    'feature.translate.target_language': 'en-us',
-    'shortcut.app.exit_fullscreen': { editable: false, enabled: true, key: ['Escape'], system: true },
-    'shortcut.app.search_message': {
-      editable: true,
-      enabled: true,
-      key: ['CommandOrControl', 'Shift', 'F'],
-      system: false
-    },
-    'shortcut.app.show_main_window': { editable: true, enabled: true, key: [], system: true },
-    'shortcut.app.show_mini_window': { editable: true, enabled: false, key: ['CommandOrControl', 'E'], system: true },
-    'shortcut.app.show_settings': { editable: false, enabled: true, key: ['CommandOrControl', ','], system: true },
-    'shortcut.app.toggle_show_assistants': {
-      editable: true,
-      enabled: true,
-      key: ['CommandOrControl', '['],
-      system: false
-    },
-    'shortcut.app.zoom_in': { editable: false, enabled: true, key: ['CommandOrControl', '='], system: true },
-    'shortcut.app.zoom_out': { editable: false, enabled: true, key: ['CommandOrControl', '-'], system: true },
-    'shortcut.app.zoom_reset': { editable: false, enabled: true, key: ['CommandOrControl', '0'], system: true },
-    'shortcut.chat.clear': { editable: true, enabled: true, key: ['CommandOrControl', 'L'], system: false },
-    'shortcut.chat.copy_last_message': {
-      editable: true,
-      enabled: false,
-      key: ['CommandOrControl', 'Shift', 'C'],
-      system: false
-    },
-    'shortcut.chat.search_message': { editable: true, enabled: true, key: ['CommandOrControl', 'F'], system: false },
-    'shortcut.chat.toggle_new_context': {
-      editable: true,
-      enabled: true,
-      key: ['CommandOrControl', 'K'],
-      system: false
-    },
-    'shortcut.selection.get_text': { editable: true, enabled: false, key: [], system: true },
-    'shortcut.selection.toggle_enabled': { editable: true, enabled: false, key: [], system: true },
-    'shortcut.topic.new': { editable: true, enabled: true, key: ['CommandOrControl', 'N'], system: false },
-    'topic.naming.enabled': true,
-    'topic.naming_prompt': '',
-    'topic.position': 'left',
-    'topic.tab.pin_to_top': false,
-    'topic.tab.show': true,
-    'topic.tab.show_time': false,
-    'translate.settings.auto_copy': false,
-    'translate.settings.auto_detection_method': 'franc',
-    'translate.settings.enable_markdown': false,
-    'translate.settings.scroll_sync': false,
-    'translate.settings.target_langs': {
-      alter: 'zh-cn',
-      target: 'en-us'
-    },
-    'ui.custom_css': '',
-    'ui.navbar.position': 'top',
-    'ui.sidebar.icons.invisible': [],
-    'ui.sidebar.icons.visible': [
-      'assistants',
-      'store',
-      'paintings',
-      'translate',
-      'minapp',
-      'knowledge',
-      'files',
-      'code_tools',
-      'notes'
-    ],
-    'ui.theme_mode': PreferenceTypes.ThemeMode.system,
-    'ui.theme_user.code_font_family': '',
-    'ui.theme_user.color_primary': '#00b96b',
-    'ui.theme_user.font_family': '',
-    'ui.window_style': 'opaque'
-  }
-}
-
-// === AUTO-GENERATED CONTENT END ===
-
-/**
- * 生成统计:
- * - 总配置项: 197
- * - electronStore项: 1
- * - redux项: 196
- * - localStorage项: 0
- */

packages/shared/data/preference/preferenceTypes.ts

@@ -1,100 +0,0 @@
-import type { TranslateLanguageCode } from '@types'
-import * as z from 'zod'
-
-import type { PreferenceSchemas } from './preferenceSchemas'
-
-export type PreferenceDefaultScopeType = PreferenceSchemas['default']
-export type PreferenceKeyType = keyof PreferenceDefaultScopeType
-
-export type PreferenceUpdateOptions = {
-  optimistic: boolean
-}
-
-export type PreferenceShortcutType = {
-  key: string[]
-  editable: boolean
-  enabled: boolean
-  system: boolean
-}
-
-export enum SelectionTriggerMode {
-  Selected = 'selected',
-  Ctrlkey = 'ctrlkey',
-  Shortcut = 'shortcut'
-}
-
-export enum SelectionFilterMode {
-  Default = 'default',
-  Whitelist = 'whitelist',
-  Blacklist = 'blacklist'
-}
-
-export type SelectionActionItem = {
-  id: string
-  name: string
-  enabled: boolean
-  isBuiltIn: boolean
-  icon?: string
-  prompt?: string
-  assistantId?: string
-  selectedText?: string
-  searchEngine?: string
-}
-
-export enum ThemeMode {
-  light = 'light',
-  dark = 'dark',
-  system = 'system'
-}
-
-/** 有限的UI语言 */
-export type LanguageVarious = 'zh-CN' | 'zh-TW' | 'el-GR' | 'en-US' | 'es-ES' | 'fr-FR' | 'ja-JP' | 'pt-PT' | 'ru-RU'
-
-export type WindowStyle = 'transparent' | 'opaque'
-
-export type SendMessageShortcut = 'Enter' | 'Shift+Enter' | 'Ctrl+Enter' | 'Command+Enter' | 'Alt+Enter'
-
-export type AssistantTabSortType = 'tags' | 'list'
-
-export type SidebarIcon =
-  | 'assistants'
-  | 'store'
-  | 'paintings'
-  | 'translate'
-  | 'minapp'
-  | 'knowledge'
-  | 'files'
-  | 'code_tools'
-  | 'notes'
-
-export type AssistantIconType = 'model' | 'emoji' | 'none'
-
-export type ProxyMode = 'system' | 'custom' | 'none'
-
-export type MultiModelFoldDisplayMode = 'expanded' | 'compact'
-
-export type MathEngine = 'KaTeX' | 'MathJax' | 'none'
-
-export enum UpgradeChannel {
-  LATEST = 'latest', // 最新稳定版本
-  RC = 'rc', // 公测版本
-  BETA = 'beta' // 预览版本
-}
-
-export type ChatMessageStyle = 'plain' | 'bubble'
-
-export type ChatMessageNavigationMode = 'none' | 'buttons' | 'anchor'
-
-export type MultiModelMessageStyle = 'horizontal' | 'vertical' | 'fold' | 'grid'
-
-export type MultiModelGridPopoverTrigger = 'hover' | 'click'
-
-const AutoDetectionMethodSchema = z.enum(['franc', 'llm', 'auto'])
-export type AutoDetectionMethod = z.infer<typeof AutoDetectionMethodSchema>
-export const isAutoDetectionMethod = (method: string): method is AutoDetectionMethod => {
-  return AutoDetectionMethodSchema.safeParse(method).success
-}
-export type TargetLangs = {
-  target: TranslateLanguageCode
-  alter: TranslateLanguageCode
-}

packages/ui/.gitignore

@@ -1,15 +0,0 @@
-node_modules/
-dist/
-*.log
-.DS_Store
-
-# Storybook build output
-storybook-static/
-
-# IDE
-.vscode/
-.idea/
-
-# Temporary files
-*.tmp
-*.temp

packages/ui/.storybook/main.ts

@@ -1,17 +0,0 @@
-import type { StorybookConfig } from '@storybook/react-vite'
-
-const config: StorybookConfig = {
-  stories: ['../stories/components/**/*.stories.@(js|jsx|ts|tsx)'],
-  addons: ['@storybook/addon-docs', '@storybook/addon-themes'],
-  framework: '@storybook/react-vite',
-  viteFinal: async (config) => {
-    const { mergeConfig } = await import('vite')
-    // 动态导入 @tailwindcss/vite 以避免 ESM/CJS 兼容性问题
-    const tailwindPlugin = (await import('@tailwindcss/vite')).default
-    return mergeConfig(config, {
-      plugins: [tailwindPlugin()]
-    })
-  }
-}
-
-export default config

packages/ui/.storybook/preview.tsx

@@ -1,18 +0,0 @@
-import '../stories/tailwind.css'
-
-import { withThemeByClassName } from '@storybook/addon-themes'
-import type { Preview } from '@storybook/react'
-
-const preview: Preview = {
-  decorators: [
-    withThemeByClassName({
-      themes: {
-        light: '',
-        dark: 'dark'
-      },
-      defaultTheme: 'light'
-    })
-  ]
-}
-
-export default preview

packages/ui/MIGRATION_STATUS.md

@@ -1,152 +0,0 @@
-# UI 组件库迁移状态
-
-## 使用示例
-
-```typescript
-// 从 @cherrystudio/ui 导入组件
-import { Spinner, DividerWithText, InfoTooltip, CustomTag } from '@cherrystudio/ui'
-
-// 在组件中使用
-function MyComponent() {
-  return (
-    <div>
-      <Spinner size={24} />
-      <DividerWithText text="分隔文本" />
-      <InfoTooltip content="提示信息" />
-      <CustomTag color="var(--color-primary)">标签</CustomTag>
-    </div>
-  )
-}
-```
-
-## 目录结构说明
-
-```text
-@packages/ui/
-├── src/
-│   ├── components/         # 组件主目录
-│   │   ├── base/           # 基础组件（按钮、输入框、标签等）
-│   │   ├── display/        # 显示组件（卡片、列表、表格等）
-│   │   ├── layout/         # 布局组件（容器、网格、间距等）
-│   │   ├── icons/          # 图标组件
-│   │   ├── interactive/    # 交互组件（弹窗、提示、下拉等）
-│   │   └── composite/      # 复合组件（多个基础组件组合而成）
-│   ├── hooks/              # 自定义 React Hooks
-│   └── types/              # TypeScript 类型定义
-```
-
-### 组件分类指南
-
-提交 PR 时，请根据组件功能将其放入正确的目录：
-
-- **base**: 最基础的 UI 元素，如按钮、输入框、开关、标签等
-- **display**: 用于展示内容的组件，如卡片、列表、表格、标签页等
-- **layout**: 用于页面布局的组件，如容器、网格系统、分隔符等
-- **icons**: 所有图标相关的组件
-- **interactive**: 需要用户交互的组件，如模态框、抽屉、提示框、下拉菜单等
-- **composite**: 复合组件，由多个基础组件组合而成
-
-## 迁移概览
-
-- **总组件数**: 236
-- **已迁移**: 34
-- **已重构**: 18
-- **待迁移**: 184
-
-## 组件状态表
-
-| Category        | Component Name            | Migration Status | Refactoring Status | Description                                                                                                                                                   |
-| --------------- | ------------------------- | ---------------- | ------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| **base**        |                           |                  |                    | 基础组件                                                                                                                                                      |
-|                 | CopyButton                | ✅                | ✅                  | 复制按钮                                                                                                                                                      |
-|                 | CustomTag                 | ✅                | ✅                  | 自定义标签                                                                                                                                                    |
-|                 | DividerWithText           | ✅                | ✅                  | 带文本的分隔线                                                                                                                                                |
-|                 | EmojiIcon                 | ✅                | ✅                  | 表情图标                                                                                                                                                      |
-|                 | ErrorBoundary             | ✅                | ✅                  | 错误边界 (通过 props 解耦)                                                                                                                                    |
-|                 | StatusTag                 | ✅                | ✅                  | 统一状态标签（合并了 ErrorTag、SuccessTag、WarnTag、InfoTag）                                                                                                 |
-|                 | IndicatorLight            | ✅                | ✅                  | 指示灯                                                                                                                                                        |
-|                 | Spinner                   | ✅                | ✅                  | 加载动画                                                                                                                                                      |
-|                 | TextBadge                 | ✅                | ✅                  | 文本徽标                                                                                                                                                      |
-|                 | CustomCollapse            | ✅                | ✅                  | 自定义折叠面板                                                                                                                                                |
-| **display**     |                           |                  |                    | 显示组件                                                                                                                                                      |
-|                 | Ellipsis                  | ✅                | ✅                  | 文本省略                                                                                                                                                      |
-|                 | ExpandableText            | ✅                | ✅                  | 可展开文本                                                                                                                                                    |
-|                 | ThinkingEffect            | ✅                | ✅                  | 思考效果动画                                                                                                                                                  |
-|                 | EmojiAvatar               | ✅                | ✅                  | 表情头像                                                                                                                                                      |
-|                 | ListItem                  | ✅                | ✅                  | 列表项                                                                                                                                                        |
-|                 | MaxContextCount           | ✅                | ✅                  | 最大上下文数显示                                                                                                                                              |
-|                 | ProviderAvatar            | ✅                | ✅                  | 提供者头像                                                                                                                                                    |
-|                 | CodeViewer                | ❌                | ❌                  | 代码查看器 (外部依赖)                                                                                                                                         |
-|                 | OGCard                    | ❌                | ❌                  | OG 卡片                                                                                                                                                       |
-|                 | MarkdownShadowDOMRenderer | ❌                | ❌                  | Markdown 渲染器                                                                                                                                               |
-|                 | Preview/*                 | ❌                | ❌                  | 预览组件                                                                                                                                                      |
-| **layout**      |                           |                  |                    | 布局组件                                                                                                                                                      |
-|                 | HorizontalScrollContainer | ✅                | ❌                  | 水平滚动容器                                                                                                                                                  |
-|                 | Scrollbar                 | ✅                | ❌                  | 滚动条                                                                                                                                                        |
-|                 | Layout/*                  | ✅                | ✅                  | 布局组件                                                                                                                                                      |
-|                 | Tab/*                     | ❌                | ❌                  | 标签页 (Redux 依赖)                                                                                                                                           |
-|                 | TopView                   | ❌                | ❌                  | 顶部视图 (window.api 依赖)                                                                                                                                    |
-| **icons**       |                           |                  |                    | 图标组件                                                                                                                                                      |
-|                 | Icon                      | ✅                | ✅                  | 图标工厂函数和预定义图标（合并了 CopyIcon、DeleteIcon、EditIcon、RefreshIcon、ResetIcon、ToolIcon、VisionIcon、WebSearchIcon、WrapIcon、UnWrapIcon、OcrIcon） |
-|                 | FileIcons                 | ✅                | ❌                  | 文件图标 (FileSvgIcon、FilePngIcon)                                                                                                                           |
-|                 | ReasoningIcon             | ✅                | ❌                  | 推理图标                                                                                                                                                      |
-|                 | SvgSpinners180Ring        | ✅                | ❌                  | 旋转加载图标                                                                                                                                                  |
-|                 | ToolsCallingIcon          | ✅                | ❌                  | 工具调用图标                                                                                                                                                  |
-| **interactive** |                           |                  |                    | 交互组件                                                                                                                                                      |
-|                 | InfoTooltip               | ✅                | ❌                  | 信息提示                                                                                                                                                      |
-|                 | HelpTooltip               | ✅                | ❌                  | 帮助提示                                                                                                                                                      |
-|                 | WarnTooltip               | ✅                | ❌                  | 警告提示                                                                                                                                                      |
-|                 | EditableNumber            | ✅                | ❌                  | 可编辑数字                                                                                                                                                    |
-|                 | InfoPopover               | ✅                | ❌                  | 信息弹出框                                                                                                                                                    |
-|                 | CollapsibleSearchBar      | ✅                | ❌                  | 可折叠搜索栏                                                                                                                                                  |
-|                 | ImageToolButton           | ✅                | ❌                  | 图片工具按钮                                                                                                                                                  |
-|                 | DraggableList             | ✅                | ❌                  | 可拖拽列表                                                                                                                                                    |
-|                 | CodeEditor                | ✅                | ❌                  | 代码编辑器                                                                                                                                                    |
-|                 | EmojiPicker               | ❌                | ❌                  | 表情选择器 (useTheme 依赖)                                                                                                                                    |
-|                 | Selector                  | ✅                | ❌                  | 选择器 (i18n 依赖)                                                                                                                                            |
-|                 | ModelSelector             | ❌                | ❌                  | 模型选择器 (Redux 依赖)                                                                                                                                       |
-|                 | LanguageSelect            | ❌                | ❌                  | 语言选择                                                                                                                                                      |
-|                 | TranslateButton           | ❌                | ❌                  | 翻译按钮 (window.api 依赖)                                                                                                                                    |
-| **composite**   |                           |                  |                    | 复合组件                                                                                                                                                      |
-|                 | -                         | -                | -                  | 暂无复合组件                                                                                                                                                  |
-| **未分类**      |                           |                  |                    | 需要分类的组件                                                                                                                                                |
-|                 | Popups/* (16+ 文件)       | ❌                | ❌                  | 弹窗组件 (业务耦合)                                                                                                                                           |
-|                 | RichEditor/* (30+ 文件)   | ❌                | ❌                  | 富文本编辑器                                                                                                                                                  |
-|                 | MarkdownEditor/*          | ❌                | ❌                  | Markdown 编辑器                                                                                                                                               |
-|                 | MinApp/*                  | ❌                | ❌                  | 迷你应用 (Redux 依赖)                                                                                                                                         |
-|                 | Avatar/*                  | ❌                | ❌                  | 头像组件                                                                                                                                                      |
-|                 | ActionTools/*             | ❌                | ❌                  | 操作工具                                                                                                                                                      |
-|                 | CodeBlockView/*           | ❌                | ❌                  | 代码块视图 (window.api 依赖)                                                                                                                                  |
-|                 | ContextMenu               | ❌                | ❌                  | 右键菜单 (Electron API)                                                                                                                                       |
-|                 | WindowControls            | ❌                | ❌                  | 窗口控制 (Electron API)                                                                                                                                       |
-|                 | ErrorBoundary             | ❌                | ❌                  | 错误边界 (window.api 依赖)                                                                                                                                    |
-
-## 迁移步骤
-
-### 第一阶段：复制迁移（当前阶段）
-
-- 将组件原样复制到 @packages/ui
-- 保留原有依赖（antd、styled-components 等）
-- 在文件顶部添加原路径注释
-
-### 第二阶段：重构优化
-
-- 移除 antd 依赖，替换为 HeroUI
-- 移除 styled-components，替换为 Tailwind CSS
-- 优化组件 API 和类型定义
-
-## 注意事项
-
-1. **不迁移**包含以下依赖的组件（解耦后可迁移）：
-   - window.api 调用
-   - Redux（useSelector、useDispatch 等）
-   - 其他外部数据源
-
-2. **可迁移**但需要后续解耦的组件：
-   - 使用 i18n 的组件（将 i18n 改为 props 传入）
-   - 使用 antd 的组件（后续替换为 HeroUI）
-
-3. **提交规范**：
-   - 每次 PR 专注于一个类别的组件
-   - 确保所有迁移的组件都有导出
-   - 更新此文档的迁移状态

packages/ui/MIGRATION_STATUS_EN.md

@@ -1,151 +0,0 @@
-# UI Component Library Migration Status
-
-## Usage Example
-
-```typescript
-// Import components from @cherrystudio/ui
-import { Spinner, DividerWithText, InfoTooltip } from '@cherrystudio/ui'
-
-// Use in components
-function MyComponent() {
-  return (
-    <div>
-      <Spinner size={24} />
-      <DividerWithText text="Divider Text" />
-      <InfoTooltip content="Tooltip message" />
-    </div>
-  )
-}
-```
-
-## Directory Structure
-
-```text
-@packages/ui/
-├── src/
-│   ├── components/         # Main components directory
-│   │   ├── base/           # Basic components (buttons, inputs, labels, etc.)
-│   │   ├── display/        # Display components (cards, lists, tables, etc.)
-│   │   ├── layout/         # Layout components (containers, grids, spacing, etc.)
-│   │   ├── icons/          # Icon components
-│   │   ├── interactive/    # Interactive components (modals, tooltips, dropdowns, etc.)
-│   │   └── composite/      # Composite components (made from multiple base components)
-│   ├── hooks/              # Custom React Hooks
-│   └── types/              # TypeScript type definitions
-```
-
-### Component Classification Guide
-
-When submitting PRs, please place components in the correct directory based on their function:
-
-- **base**: Most basic UI elements like buttons, inputs, switches, labels, etc.
-- **display**: Components for displaying content like cards, lists, tables, tabs, etc.
-- **layout**: Components for page layout like containers, grid systems, dividers, etc.
-- **icons**: All icon-related components
-- **interactive**: Components requiring user interaction like modals, drawers, tooltips, dropdowns, etc.
-- **composite**: Composite components made from multiple base components
-
-## Migration Overview
-
-- **Total Components**: 236
-- **Migrated**: 34
-- **Refactored**: 18
-- **Pending Migration**: 184
-
-## Component Status Table
-
-| Category          | Component Name            | Migration Status | Refactoring Status | Description                                                                                                                                                                    |
-| ----------------- | ------------------------- | ---------------- | ------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
-| **base**          |                           |                  |                    | Base components                                                                                                                                                                |
-|                   | CopyButton                | ✅                | ✅                  | Copy button                                                                                                                                                                    |
-|                   | CustomTag                 | ✅                | ✅                  | Custom tag                                                                                                                                                                     |
-|                   | DividerWithText           | ✅                | ✅                  | Divider with text                                                                                                                                                              |
-|                   | EmojiIcon                 | ✅                | ✅                  | Emoji icon                                                                                                                                                                     |
-|                   | ErrorBoundary             | ✅                | ✅                  | Error boundary (decoupled via props)                                                                                                                                           |
-|                   | StatusTag                 | ✅                | ✅                  | Unified status tag (merged ErrorTag, SuccessTag, WarnTag, InfoTag)                                                                                                             |
-|                   | IndicatorLight            | ✅                | ✅                  | Indicator light                                                                                                                                                                |
-|                   | Spinner                   | ✅                | ✅                  | Loading spinner                                                                                                                                                                |
-|                   | TextBadge                 | ✅                | ✅                  | Text badge                                                                                                                                                                     |
-|                   | CustomCollapse            | ✅                | ✅                  | Custom collapse panel                                                                                                                                                          |
-| **display**       |                           |                  |                    | Display components                                                                                                                                                             |
-|                   | Ellipsis                  | ✅                | ✅                  | Text ellipsis                                                                                                                                                                  |
-|                   | ExpandableText            | ✅                | ✅                  | Expandable text                                                                                                                                                                |
-|                   | ThinkingEffect            | ✅                | ✅                  | Thinking effect animation                                                                                                                                                      |
-|                   | EmojiAvatar               | ✅                | ✅                  | Emoji avatar                                                                                                                                                                   |
-|                   | ListItem                  | ✅                | ✅                  | List item                                                                                                                                                                      |
-|                   | MaxContextCount           | ✅                | ✅                  | Max context count display                                                                                                                                                      |
-|                   | ProviderAvatar            | ✅                | ✅                  | Provider avatar                                                                                                                                                                |
-|                   | CodeViewer                | ❌                | ❌                  | Code viewer (external deps)                                                                                                                                                    |
-|                   | OGCard                    | ❌                | ❌                  | OG card                                                                                                                                                                        |
-|                   | MarkdownShadowDOMRenderer | ❌                | ❌                  | Markdown renderer                                                                                                                                                              |
-|                   | Preview/*                 | ❌                | ❌                  | Preview components                                                                                                                                                             |
-| **layout**        |                           |                  |                    | Layout components                                                                                                                                                              |
-|                   | HorizontalScrollContainer | ✅                | ❌                  | Horizontal scroll container                                                                                                                                                    |
-|                   | Scrollbar                 | ✅                | ❌                  | Scrollbar                                                                                                                                                                      |
-|                   | Layout/*                  | ✅                | ✅                  | Layout components                                                                                                                                                              |
-|                   | Tab/*                     | ❌                | ❌                  | Tab (Redux dependency)                                                                                                                                                         |
-|                   | TopView                   | ❌                | ❌                  | Top view (window.api dependency)                                                                                                                                               |
-| **icons**         |                           |                  |                    | Icon components                                                                                                                                                                |
-|                   | Icon                      | ✅                | ✅                  | Icon factory function and predefined icons (merged CopyIcon, DeleteIcon, EditIcon, RefreshIcon, ResetIcon, ToolIcon, VisionIcon, WebSearchIcon, WrapIcon, UnWrapIcon, OcrIcon) |
-|                   | FileIcons                 | ✅                | ❌                  | File icons (FileSvgIcon, FilePngIcon)                                                                                                                                          |
-|                   | ReasoningIcon             | ✅                | ❌                  | Reasoning icon                                                                                                                                                                 |
-|                   | SvgSpinners180Ring        | ✅                | ❌                  | Spinner loading icon                                                                                                                                                           |
-|                   | ToolsCallingIcon          | ✅                | ❌                  | Tools calling icon                                                                                                                                                             |
-| **interactive**   |                           |                  |                    | Interactive components                                                                                                                                                         |
-|                   | InfoTooltip               | ✅                | ❌                  | Info tooltip                                                                                                                                                                   |
-|                   | HelpTooltip               | ✅                | ❌                  | Help tooltip                                                                                                                                                                   |
-|                   | WarnTooltip               | ✅                | ❌                  | Warning tooltip                                                                                                                                                                |
-|                   | EditableNumber            | ✅                | ❌                  | Editable number                                                                                                                                                                |
-|                   | InfoPopover               | ✅                | ❌                  | Info popover                                                                                                                                                                   |
-|                   | CollapsibleSearchBar      | ✅                | ❌                  | Collapsible search bar                                                                                                                                                         |
-|                   | ImageToolButton           | ✅                | ❌                  | Image tool button                                                                                                                                                              |
-|                   | DraggableList             | ✅                | ❌                  | Draggable list                                                                                                                                                                 |
-|                   | CodeEditor                | ✅                | ❌                  | Code editor                                                                                                                                                                    |
-|                   | EmojiPicker               | ❌                | ❌                  | Emoji picker (useTheme dependency)                                                                                                                                             |
-|                   | Selector                  | ✅                | ❌                  | Selector (i18n dependency)                                                                                                                                                     |
-|                   | ModelSelector             | ❌                | ❌                  | Model selector (Redux dependency)                                                                                                                                              |
-|                   | LanguageSelect            | ❌                | ❌                  | Language select                                                                                                                                                                |
-|                   | TranslateButton           | ❌                | ❌                  | Translate button (window.api dependency)                                                                                                                                       |
-| **composite**     |                           |                  |                    | Composite components                                                                                                                                                           |
-|                   | -                         | -                | -                  | No composite components yet                                                                                                                                                    |
-| **Uncategorized** |                           |                  |                    | Components needing categorization                                                                                                                                              |
-|                   | Popups/* (16+ files)      | ❌                | ❌                  | Popup components (business coupled)                                                                                                                                            |
-|                   | RichEditor/* (30+ files)  | ❌                | ❌                  | Rich text editor                                                                                                                                                               |
-|                   | MarkdownEditor/*          | ❌                | ❌                  | Markdown editor                                                                                                                                                                |
-|                   | MinApp/*                  | ❌                | ❌                  | Mini app (Redux dependency)                                                                                                                                                    |
-|                   | Avatar/*                  | ❌                | ❌                  | Avatar components                                                                                                                                                              |
-|                   | ActionTools/*             | ❌                | ❌                  | Action tools                                                                                                                                                                   |
-|                   | CodeBlockView/*           | ❌                | ❌                  | Code block view (window.api dependency)                                                                                                                                        |
-|                   | ContextMenu               | ❌                | ❌                  | Context menu (Electron API)                                                                                                                                                    |
-|                   | WindowControls            | ❌                | ❌                  | Window controls (Electron API)                                                                                                                                                 |
-|                   | ErrorBoundary             | ❌                | ❌                  | Error boundary (window.api dependency)                                                                                                                                         |
-
-## Migration Steps
-
-### Phase 1: Copy Migration (Current Phase)
-
-- Copy components as-is to @packages/ui
-- Retain original dependencies (antd, styled-components, etc.)
-- Add original path comment at file top
-
-### Phase 2: Refactor and Optimize
-
-- Remove antd dependencies, replace with HeroUI
-- Remove styled-components, replace with Tailwind CSS
-- Optimize component APIs and type definitions
-
-## Notes
-
-1. **Do NOT migrate** components with these dependencies (can be migrated after decoupling):
-   - window.api calls
-   - Redux (useSelector, useDispatch, etc.)
-   - Other external data sources
-
-2. **Can migrate** but need decoupling later:
-   - Components using i18n (change i18n to props)
-   - Components using antd (replace with HeroUI later)
-
-3. **Submission Guidelines**:
-   - Each PR should focus on one category of components
-   - Ensure all migrated components are exported
-   - Update migration status in this document

packages/ui/README.md

@@ -1,200 +0,0 @@
-# @cherrystudio/ui
-
-Cherry Studio UI 组件库 - 为 Cherry Studio 设计的 React 组件集合
-
-## 特性
-
-- 🎨 基于 Tailwind CSS 的现代化设计
-- 📦 支持 ESM 和 CJS 格式
-- 🔷 完整的 TypeScript 支持
-- 🚀 可以作为 npm 包发布
-- 🔧 开箱即用的常用 hooks 和工具函数
-
-## 安装
-
-```bash
-# 安装组件库
-npm install @cherrystudio/ui
-
-# 安装必需的 peer dependencies
-npm install @heroui/react framer-motion react react-dom tailwindcss
-```
-
-## 配置
-
-### 1. Tailwind CSS v4 配置
-
-本组件库使用 Tailwind CSS v4，配置方式已改变。在你的主 CSS 文件（如 `src/styles/tailwind.css`）中：
-
-```css
-@import 'tailwindcss';
-
-/* 必须扫描组件库文件以提取类名 */
-@source '../node_modules/@cherrystudio/ui/dist/**/*.{js,mjs}';
-
-/* 你的应用源文件 */
-@source './src/**/*.{js,ts,jsx,tsx}';
-
-/*
- * 如果你的应用直接使用 HeroUI 组件，需要添加：
- * @source '../node_modules/@heroui/theme/dist/**/*.{js,ts,jsx,tsx}';
- * @plugin '@heroui/react/plugin';
- */
-
-/* 自定义主题配置（可选） */
-@theme {
-  /* 你的主题扩展 */
-}
-```
-
-注意：Tailwind CSS v4 不再使用 `tailwind.config.js` 文件，所有配置都在 CSS 中完成。
-
-### 2. Provider 配置
-
-在你的 App 根组件中添加 HeroUI Provider：
-
-```tsx
-import { HeroUIProvider } from '@heroui/react'
-
-function App() {
-  return (
-    <HeroUIProvider>
-      {/* 你的应用内容 */}
-    </HeroUIProvider>
-  )
-}
-```
-
-## 使用
-
-### 基础组件
-
-```tsx
-import { Button, Input } from '@cherrystudio/ui'
-
-function App() {
-  return (
-    <div>
-      <Button variant="primary" size="md">
-        点击我
-      </Button>
-      <Input
-        type="text"
-        placeholder="请输入内容"
-        onChange={(value) => console.log(value)}
-      />
-    </div>
-  )
-}
-```
-
-### 分模块导入
-
-```tsx
-// 只导入组件
-import { Button } from '@cherrystudio/ui/components'
-
-// 只导入 hooks
-import { useDebounce, useLocalStorage } from '@cherrystudio/ui/hooks'
-
-// 只导入工具函数
-import { cn, formatFileSize } from '@cherrystudio/ui/utils'
-```
-
-## 开发
-
-```bash
-# 安装依赖
-yarn install
-
-# 开发模式（监听文件变化）
-yarn dev
-
-# 构建
-yarn build
-
-# 类型检查
-yarn type-check
-
-# 运行测试
-yarn test
-```
-
-## 目录结构
-
-```text
-src/
-├── components/          # React 组件
-│   ├── Button/         # 按钮组件
-│   ├── Input/          # 输入框组件
-│   └── index.ts        # 组件导出
-├── hooks/              # React Hooks
-├── utils/              # 工具函数
-├── types/              # 类型定义
-└── index.ts            # 主入口文件
-```
-
-## 组件列表
-
-### Button 按钮
-
-支持多种变体和尺寸的按钮组件。
-
-**Props:**
-
-- `variant`: 'primary' | 'secondary' | 'outline' | 'ghost' | 'danger'
-- `size`: 'sm' | 'md' | 'lg'
-- `loading`: boolean
-- `fullWidth`: boolean
-- `leftIcon` / `rightIcon`: React.ReactNode
-
-### Input 输入框
-
-带有错误处理和密码显示切换的输入框组件。
-
-**Props:**
-
-- `type`: 'text' | 'password' | 'email' | 'number'
-- `error`: boolean
-- `errorMessage`: string
-- `onChange`: (value: string) => void
-
-## Hooks
-
-### useDebounce
-
-防抖处理，延迟执行状态更新。
-
-### useLocalStorage
-
-本地存储的 React Hook 封装。
-
-### useClickOutside
-
-检测点击元素外部区域。
-
-### useCopyToClipboard
-
-复制文本到剪贴板。
-
-## 工具函数
-
-### cn(...inputs)
-
-基于 clsx 的类名合并工具，支持条件类名。
-
-### formatFileSize(bytes)
-
-格式化文件大小显示。
-
-### debounce(func, delay)
-
-防抖函数。
-
-### throttle(func, delay)
-
-节流函数。
-
-## 许可证
-
-MIT

packages/ui/components.json

@@ -1,21 +0,0 @@
-{
-  "$schema": "https://ui.shadcn.com/schema.json",
-  "aliases": {
-    "components": "@/components",
-    "hooks": "@/hooks",
-    "lib": "@/lib",
-    "ui": "@/components/ui",
-    "utils": "@/utils"
-  },
-  "iconLibrary": "lucide",
-  "rsc": false,
-  "style": "new-york",
-  "tailwind": {
-    "baseColor": "zinc",
-    "config": "",
-    "css": "src/styles/globals.css",
-    "cssVariables": true,
-    "prefix": ""
-  },
-  "tsx": true
-}

packages/ui/package.json

@@ -1,129 +0,0 @@
-{
-  "name": "@cherrystudio/ui",
-  "version": "1.0.0-alpha.1",
-  "description": "Cherry Studio UI Component Library - React Components for Cherry Studio",
-  "main": "dist/index.js",
-  "module": "dist/index.mjs",
-  "types": "dist/index.d.ts",
-  "react-native": "dist/index.js",
-  "scripts": {
-    "build": "tsdown",
-    "dev": "tsc -w",
-    "clean": "rm -rf dist",
-    "test": "vitest run",
-    "test:watch": "vitest",
-    "lint": "eslint src --ext .ts,.tsx --fix",
-    "type-check": "tsc --noEmit -p tsconfig.json --composite false",
-    "storybook": "storybook dev -p 6006",
-    "build-storybook": "storybook build"
-  },
-  "keywords": [
-    "ui",
-    "components",
-    "react",
-    "tailwindcss",
-    "typescript",
-    "cherry-studio"
-  ],
-  "author": "Cherry Studio",
-  "license": "MIT",
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/CherryHQ/cherry-studio.git"
-  },
-  "bugs": {
-    "url": "https://github.com/CherryHQ/cherry-studio/issues"
-  },
-  "homepage": "https://github.com/CherryHQ/cherry-studio#readme",
-  "peerDependencies": {
-    "@heroui/react": "^2.8.4",
-    "framer-motion": "^11.0.0 || ^12.0.0",
-    "react": "^19.0.0",
-    "react-dom": "^19.0.0",
-    "tailwindcss": "^4.1.13"
-  },
-  "dependencies": {
-    "@dnd-kit/core": "^6.3.1",
-    "@dnd-kit/modifiers": "^9.0.0",
-    "@dnd-kit/sortable": "^10.0.0",
-    "@dnd-kit/utilities": "^3.2.2",
-    "@radix-ui/react-dialog": "^1.1.15",
-    "@radix-ui/react-popover": "^1.1.15",
-    "@radix-ui/react-slot": "^1.2.3",
-    "@radix-ui/react-use-controllable-state": "^1.2.2",
-    "class-variance-authority": "^0.7.1",
-    "clsx": "^2.1.1",
-    "cmdk": "^1.1.1",
-    "lucide-react": "^0.545.0",
-    "react-dropzone": "^14.3.8",
-    "tailwind-merge": "^2.5.5"
-  },
-  "devDependencies": {
-    "@heroui/react": "^2.8.4",
-    "@storybook/addon-docs": "^9.1.6",
-    "@storybook/addon-themes": "^9.1.6",
-    "@storybook/react-vite": "^9.1.6",
-    "@types/react": "^19.0.12",
-    "@types/react-dom": "^19.0.4",
-    "@types/styled-components": "^5.1.34",
-    "@uiw/codemirror-extensions-langs": "^4.25.1",
-    "@uiw/codemirror-themes-all": "^4.25.1",
-    "@uiw/react-codemirror": "^4.25.1",
-    "antd": "^5.22.5",
-    "eslint-plugin-storybook": "9.1.6",
-    "framer-motion": "^12.23.12",
-    "linguist-languages": "^9.0.0",
-    "react": "^19.0.0",
-    "react-dom": "^19.0.0",
-    "storybook": "^9.1.6",
-    "styled-components": "^6.1.15",
-    "tsdown": "^0.15.5",
-    "tsx": "^4.20.5",
-    "typescript": "^5.6.2",
-    "vitest": "^3.2.4"
-  },
-  "resolutions": {
-    "@codemirror/language": "6.11.3",
-    "@codemirror/lint": "6.8.5",
-    "@codemirror/view": "6.38.1"
-  },
-  "sideEffects": false,
-  "engines": {
-    "node": ">=18.0.0"
-  },
-  "files": [
-    "dist",
-    "README.md"
-  ],
-  "exports": {
-    ".": {
-      "types": "./dist/index.d.ts",
-      "react-native": "./dist/index.js",
-      "import": "./dist/index.mjs",
-      "require": "./dist/index.js",
-      "default": "./dist/index.js"
-    },
-    "./components": {
-      "types": "./dist/components/index.d.ts",
-      "react-native": "./dist/components/index.js",
-      "import": "./dist/components/index.mjs",
-      "require": "./dist/components/index.js",
-      "default": "./dist/components/index.js"
-    },
-    "./hooks": {
-      "types": "./dist/hooks/index.d.ts",
-      "react-native": "./dist/hooks/index.js",
-      "import": "./dist/hooks/index.mjs",
-      "require": "./dist/hooks/index.js",
-      "default": "./dist/hooks/index.js"
-    },
-    "./utils": {
-      "types": "./dist/utils/index.d.ts",
-      "react-native": "./dist/utils/index.js",
-      "import": "./dist/utils/index.mjs",
-      "require": "./dist/utils/index.js",
-      "default": "./dist/utils/index.js"
-    }
-  },
-  "packageManager": "yarn@4.9.1"
-}

packages/ui/src/components/base/Avatar/EmojiAvatar.tsx

@@ -1,36 +0,0 @@
-import { cn } from '@heroui/react'
-import React, { memo } from 'react'
-
-interface EmojiAvatarProps {
-  children: string
-  size?: number
-  fontSize?: number
-  onClick?: React.MouseEventHandler<HTMLDivElement>
-  className?: string
-  style?: React.CSSProperties
-}
-
-const EmojiAvatar = ({ children, size = 31, fontSize, onClick, className, style }: EmojiAvatarProps) => (
-  <div
-    onClick={onClick}
-    className={cn(
-      'flex items-center justify-center',
-      'bg-background-soft border-border',
-      'rounded-[20%] cursor-pointer',
-      'transition-opacity hover:opacity-80',
-      'border-[0.5px]',
-      className
-    )}
-    style={{
-      width: size,
-      height: size,
-      fontSize: fontSize ?? size * 0.5,
-      ...style
-    }}>
-    {children}
-  </div>
-)
-
-EmojiAvatar.displayName = 'EmojiAvatar'
-
-export default memo(EmojiAvatar)

packages/ui/src/components/base/Avatar/index.tsx

@@ -1,26 +0,0 @@
-import type { AvatarProps as HeroUIAvatarProps } from '@heroui/react'
-import { Avatar as HeroUIAvatar, AvatarGroup as HeroUIAvatarGroup, cn } from '@heroui/react'
-
-import EmojiAvatar from './EmojiAvatar'
-
-export interface AvatarProps extends Omit<HeroUIAvatarProps, 'size'> {
-  size?: 'xs' | 'sm' | 'md' | 'lg'
-}
-
-const Avatar = (props: AvatarProps) => {
-  const { size, className = '', ...rest } = props
-  const isExtraSmall = size === 'xs'
-
-  const resolvedSize = isExtraSmall ? undefined : size
-  const mergedClassName = cn(isExtraSmall && 'w-6 h-6 text-tiny', 'shadow-lg', className)
-
-  return <HeroUIAvatar size={resolvedSize} className={mergedClassName} {...rest} />
-}
-
-Avatar.displayName = 'Avatar'
-
-const AvatarGroup = HeroUIAvatarGroup
-
-AvatarGroup.displayName = 'AvatarGroup'
-
-export { Avatar, AvatarGroup, EmojiAvatar }

packages/ui/src/components/base/Button/index.tsx

@@ -1,12 +0,0 @@
-import type { ButtonProps as HeroUIButtonProps } from '@heroui/react'
-import { Button as HeroUIButton } from '@heroui/react'
-
-export interface ButtonProps extends HeroUIButtonProps {}
-
-const Button = ({ ...props }: ButtonProps) => {
-  return <HeroUIButton {...props} />
-}
-
-Button.displayName = 'Button'
-
-export default Button

packages/ui/src/components/base/CopyButton/index.tsx

@@ -1,31 +0,0 @@
-// Original path: src/renderer/src/components/CopyButton.tsx
-import { Tooltip } from '@heroui/react'
-import { Copy } from 'lucide-react'
-import type { FC } from 'react'
-
-interface CopyButtonProps {
-  tooltip?: string
-  label?: string
-  size?: number
-  className?: string
-  [key: string]: any
-}
-
-const CopyButton: FC<CopyButtonProps> = ({ tooltip, label, size = 14, className = '', ...props }) => {
-  const button = (
-    <div
-      className={`flex flex-row items-center gap-1 cursor-pointer text-gray-600 dark:text-gray-400 transition-colors duration-200 hover:text-blue-600 dark:hover:text-blue-400 ${className}`}
-      {...props}>
-      <Copy size={size} className="transition-colors duration-200" />
-      {label && <span style={{ fontSize: `${size}px` }}>{label}</span>}
-    </div>
-  )
-
-  if (tooltip) {
-    return <Tooltip content={tooltip}>{button}</Tooltip>
-  }
-
-  return button
-}
-
-export default CopyButton

packages/ui/src/components/base/CustomCollapse/index.tsx

@@ -1,46 +0,0 @@
-import { Accordion, AccordionItem, type AccordionItemProps, type AccordionProps } from '@heroui/react'
-import type { FC } from 'react'
-import { memo } from 'react'
-
-// 重新导出 HeroUI 的组件，方便直接使用
-export { Accordion, AccordionItem } from '@heroui/react'
-
-interface CustomCollapseProps {
-  children: React.ReactNode
-  accordionProps?: Omit<AccordionProps, 'children'>
-  accordionItemProps?: Omit<AccordionItemProps, 'children'>
-}
-
-const CustomCollapse: FC<CustomCollapseProps> = ({ children, accordionProps = {}, accordionItemProps = {} }) => {
-  // 解构 Accordion 的 props
-  const {
-    defaultExpandedKeys = ['1'],
-    variant = 'bordered',
-    className = '',
-    isDisabled = false,
-    ...restAccordionProps
-  } = accordionProps
-
-  // 解构 AccordionItem 的 props
-  const { title = 'Collapse Panel', ...restAccordionItemProps } = accordionItemProps
-
-  return (
-    <Accordion
-      defaultExpandedKeys={defaultExpandedKeys}
-      variant={variant}
-      className={className}
-      isDisabled={isDisabled}
-      selectionMode="multiple"
-      {...restAccordionProps}>
-      <AccordionItem
-        key="1"
-        aria-label={typeof title === 'string' ? title : 'collapse-item'}
-        title={title}
-        {...restAccordionItemProps}>
-        {children}
-      </AccordionItem>
-    </Accordion>
-  )
-}
-
-export default memo(CustomCollapse)

packages/ui/src/components/base/CustomTag/index.tsx

@@ -1,87 +0,0 @@
-// Original path: src/renderer/src/components/Tags/CustomTag.tsx
-import { Tooltip } from '@heroui/react'
-import { X } from 'lucide-react'
-import type { CSSProperties, FC, MouseEventHandler } from 'react'
-import { memo, useMemo } from 'react'
-
-export interface CustomTagProps {
-  icon?: React.ReactNode
-  children?: React.ReactNode | string
-  color: string
-  size?: number
-  style?: CSSProperties
-  tooltip?: string
-  closable?: boolean
-  onClose?: () => void
-  onClick?: MouseEventHandler<HTMLDivElement>
-  disabled?: boolean
-  inactive?: boolean
-  className?: string
-}
-
-const CustomTag: FC<CustomTagProps> = ({
-  children,
-  icon,
-  color,
-  size = 12,
-  style,
-  tooltip,
-  closable = false,
-  onClose,
-  onClick,
-  disabled,
-  inactive,
-  className = ''
-}) => {
-  const actualColor = inactive ? '#aaaaaa' : color
-
-  const tagContent = useMemo(
-    () => (
-      <div
-        className={`inline-flex items-center gap-1 rounded-full whitespace-nowrap relative transition-opacity duration-200 ${
-          !disabled && onClick ? 'cursor-pointer hover:opacity-80' : disabled ? 'cursor-not-allowed' : 'cursor-auto'
-        } ${className}`}
-        style={{
-          padding: `${size / 3}px ${closable ? size * 1.8 : size * 0.8}px ${size / 3}px ${size * 0.8}px`,
-          color: actualColor,
-          backgroundColor: actualColor + '20',
-          fontSize: `${size}px`,
-          lineHeight: 1,
-          ...style
-        }}
-        onClick={disabled ? undefined : onClick}>
-        {icon && <span style={{ fontSize: `${size}px`, color: actualColor }}>{icon}</span>}
-        {children}
-        {closable && (
-          <div
-            className="absolute flex items-center justify-center cursor-pointer rounded-full transition-all duration-200 hover:bg-[#da8a8a] hover:text-white"
-            style={{
-              right: `${size * 0.2}px`,
-              top: `${size * 0.2}px`,
-              bottom: `${size * 0.2}px`,
-              fontSize: `${size * 0.8}px`,
-              color: actualColor,
-              aspectRatio: 1
-            }}
-            onClick={(e) => {
-              e.stopPropagation()
-              onClose?.()
-            }}>
-            <X size={size * 0.8} />
-          </div>
-        )}
-      </div>
-    ),
-    [actualColor, children, closable, disabled, icon, onClick, onClose, size, style, className]
-  )
-
-  return tooltip ? (
-    <Tooltip content={tooltip} delay={300}>
-      {tagContent}
-    </Tooltip>
-  ) : (
-    tagContent
-  )
-}
-
-export default memo(CustomTag)

packages/ui/src/components/base/DividerWithText/index.tsx

@@ -1,20 +0,0 @@
-// Original: src/renderer/src/components/DividerWithText.tsx
-import type { CSSProperties } from 'react'
-import React from 'react'
-
-interface DividerWithTextProps {
-  text: string
-  style?: CSSProperties
-  className?: string
-}
-
-const DividerWithText: React.FC<DividerWithTextProps> = ({ text, style, className = '' }) => {
-  return (
-    <div className={`flex items-center my-0 ${className}`} style={style}>
-      <span className="text-xs text-gray-600 dark:text-gray-400 mr-2">{text}</span>
-      <div className="flex-1 h-px bg-gray-200 dark:bg-gray-700" />
-    </div>
-  )
-}
-
-export default DividerWithText

packages/ui/src/components/base/EmojiIcon/index.tsx

@@ -1,34 +0,0 @@
-// Original path: src/renderer/src/components/EmojiIcon.tsx
-import type { FC } from 'react'
-
-interface EmojiIconProps {
-  emoji: string
-  className?: string
-  size?: number
-  fontSize?: number
-}
-
-const EmojiIcon: FC<EmojiIconProps> = ({ emoji, className = '', size = 26, fontSize = 15 }) => {
-  return (
-    <div
-      className={`flex items-center justify-center flex-shrink-0 relative overflow-hidden mr-1 rounded-full ${className}`}
-      style={{
-        width: `${size}px`,
-        height: `${size}px`,
-        borderRadius: `${size / 2}px`,
-        fontSize: `${fontSize}px`
-      }}>
-      <div
-        className="absolute inset-0 flex items-center justify-center blur-sm opacity-40"
-        style={{
-          fontSize: '200%',
-          transform: 'scale(1.5)'
-        }}>
-        {emoji || '⭐️'}
-      </div>
-      {emoji}
-    </div>
-  )
-}
-
-export default EmojiIcon

packages/ui/src/components/base/ErrorBoundary/index.tsx

@@ -1,94 +0,0 @@
-// Original path: src/renderer/src/components/ErrorBoundary.tsx
-import { Button } from '@heroui/react'
-import { AlertTriangle } from 'lucide-react'
-import type { ComponentType, ReactNode } from 'react'
-import type { FallbackProps } from 'react-error-boundary'
-import { ErrorBoundary } from 'react-error-boundary'
-
-import { formatErrorMessage } from './utils'
-
-interface CustomFallbackProps extends FallbackProps {
-  onDebugClick?: () => void | Promise<void>
-  onReloadClick?: () => void | Promise<void>
-  debugButtonText?: string
-  reloadButtonText?: string
-  errorMessage?: string
-}
-
-const DefaultFallback: ComponentType<CustomFallbackProps> = (props: CustomFallbackProps): ReactNode => {
-  const {
-    error,
-    onDebugClick,
-    onReloadClick,
-    debugButtonText = 'Open DevTools',
-    reloadButtonText = 'Reload',
-    errorMessage = 'An error occurred'
-  } = props
-
-  return (
-    <div className="flex justify-center items-center w-full p-2">
-      <div className="bg-red-50 dark:bg-red-900/20 border border-red-200 dark:border-red-800 rounded-lg p-4 w-full">
-        <div className="flex items-start gap-3">
-          <AlertTriangle className="text-red-500 dark:text-red-400 flex-shrink-0 mt-0.5" size={20} />
-          <div className="flex-1">
-            <h3 className="text-red-800 dark:text-red-200 font-medium text-sm mb-1">{errorMessage}</h3>
-            <p className="text-red-700 dark:text-red-300 text-sm mb-3">{formatErrorMessage(error)}</p>
-            <div className="flex gap-2">
-              {onDebugClick && (
-                <Button size="sm" variant="flat" color="danger" onPress={onDebugClick}>
-                  {debugButtonText}
-                </Button>
-              )}
-              {onReloadClick && (
-                <Button size="sm" variant="flat" color="danger" onPress={onReloadClick}>
-                  {reloadButtonText}
-                </Button>
-              )}
-            </div>
-          </div>
-        </div>
-      </div>
-    </div>
-  )
-}
-
-interface ErrorBoundaryCustomizedProps {
-  children: ReactNode
-  fallbackComponent?: ComponentType<CustomFallbackProps>
-  onDebugClick?: () => void | Promise<void>
-  onReloadClick?: () => void | Promise<void>
-  debugButtonText?: string
-  reloadButtonText?: string
-  errorMessage?: string
-}
-
-const ErrorBoundaryCustomized = ({
-  children,
-  fallbackComponent,
-  onDebugClick,
-  onReloadClick,
-  debugButtonText,
-  reloadButtonText,
-  errorMessage
-}: ErrorBoundaryCustomizedProps) => {
-  const FallbackComponent = fallbackComponent ?? DefaultFallback
-
-  return (
-    <ErrorBoundary
-      FallbackComponent={(props: FallbackProps) => (
-        <FallbackComponent
-          {...props}
-          onDebugClick={onDebugClick}
-          onReloadClick={onReloadClick}
-          debugButtonText={debugButtonText}
-          reloadButtonText={reloadButtonText}
-          errorMessage={errorMessage}
-        />
-      )}>
-      {children}
-    </ErrorBoundary>
-  )
-}
-
-export { ErrorBoundaryCustomized as ErrorBoundary }
-export type { CustomFallbackProps, ErrorBoundaryCustomizedProps }

packages/ui/src/components/base/ErrorBoundary/utils.ts

@@ -1,8 +0,0 @@
-// Utility functions for ErrorBoundary component
-
-export function formatErrorMessage(error: Error): string {
-  if (error.message) {
-    return error.message
-  }
-  return error.toString()
-}

packages/ui/src/components/base/IndicatorLight/index.tsx

@@ -1,37 +0,0 @@
-// Original: src/renderer/src/components/IndicatorLight.tsx
-import React from 'react'
-
-interface IndicatorLightProps {
-  color: string
-  size?: number
-  shadow?: boolean
-  style?: React.CSSProperties
-  animation?: boolean
-  className?: string
-}
-
-const IndicatorLight: React.FC<IndicatorLightProps> = ({
-  color,
-  size = 8,
-  shadow = true,
-  style,
-  animation = true,
-  className = ''
-}) => {
-  const actualColor = color === 'green' ? '#22c55e' : color
-
-  return (
-    <div
-      className={`rounded-full ${animation ? 'animate-pulse' : ''} ${className}`}
-      style={{
-        width: `${size}px`,
-        height: `${size}px`,
-        backgroundColor: actualColor,
-        boxShadow: shadow ? `0 0 6px ${actualColor}` : 'none',
-        ...style
-      }}
-    />
-  )
-}
-
-export default IndicatorLight

packages/ui/src/components/base/Selector/README.md

@@ -1,333 +0,0 @@
-# Selector 组件
-
-基于 HeroUI Select 封装的下拉选择组件，简化了 Set 和 Selection 的转换逻辑。
-
-## 核心特性
-
-- ✅ **类型安全**: 单选和多选自动推断回调类型
-- ✅ **智能转换**: 自动处理 `Set<Key>` 和原始值的转换
-- ✅ **HeroUI 风格**: 保持与 HeroUI 生态一致的 API
-- ✅ **支持数字和字符串**: 泛型支持，自动识别值类型
-
-## 基础用法
-
-### 单选模式（默认）
-
-```tsx
-import { Selector } from '@cherrystudio/ui'
-import { useState } from 'react'
-
-function Example() {
-  const [language, setLanguage] = useState('zh-CN')
-
-  const languageOptions = [
-    { label: '中文', value: 'zh-CN' },
-    { label: 'English', value: 'en-US' },
-    { label: '日本語', value: 'ja-JP' }
-  ]
-
-  return (
-    <Selector
-      selectedKeys={language}
-      onSelectionChange={(value) => {
-        // value 类型自动推断为 string
-        setLanguage(value)
-      }}
-      items={languageOptions}
-      placeholder="选择语言"
-    />
-  )
-}
-```
-
-### 多选模式
-
-```tsx
-import { Selector } from '@cherrystudio/ui'
-import { useState } from 'react'
-
-function Example() {
-  const [languages, setLanguages] = useState(['zh-CN', 'en-US'])
-
-  const languageOptions = [
-    { label: '中文', value: 'zh-CN' },
-    { label: 'English', value: 'en-US' },
-    { label: '日本語', value: 'ja-JP' },
-    { label: 'Français', value: 'fr-FR' }
-  ]
-
-  return (
-    <Selector
-      selectionMode="multiple"
-      selectedKeys={languages}
-      onSelectionChange={(values) => {
-        // values 类型自动推断为 string[]
-        setLanguages(values)
-      }}
-      items={languageOptions}
-      placeholder="选择语言"
-    />
-  )
-}
-```
-
-### 数字类型值
-
-```tsx
-import { Selector } from '@cherrystudio/ui'
-
-function Example() {
-  const [priority, setPriority] = useState<number>(1)
-
-  const priorityOptions = [
-    { label: '低', value: 1 },
-    { label: '中', value: 2 },
-    { label: '高', value: 3 }
-  ]
-
-  return (
-    <Selector<number>
-      selectedKeys={priority}
-      onSelectionChange={(value) => {
-        // value 类型为 number
-        setPriority(value)
-      }}
-      items={priorityOptions}
-    />
-  )
-}
-```
-
-### 禁用选项
-
-```tsx
-const options = [
-  { label: '选项 1', value: '1' },
-  { label: '选项 2 (禁用)', value: '2', disabled: true },
-  { label: '选项 3', value: '3' }
-]
-
-<Selector
-  selectedKeys="1"
-  onSelectionChange={handleChange}
-  items={options}
-/>
-```
-
-### 自定义 Label
-
-```tsx
-import { Flex } from '@cherrystudio/ui'
-
-const options = [
-  {
-    label: (
-      <Flex className="items-center gap-2">
-        <span>🇨🇳</span>
-        <span>中文</span>
-      </Flex>
-    ),
-    value: 'zh-CN'
-  },
-  {
-    label: (
-      <Flex className="items-center gap-2">
-        <span>🇺🇸</span>
-        <span>English</span>
-      </Flex>
-    ),
-    value: 'en-US'
-  }
-]
-
-<Selector
-  selectedKeys="zh-CN"
-  onSelectionChange={handleChange}
-  items={options}
-/>
-```
-
-## API
-
-### SelectorProps
-
-| 属性 | 类型 | 默认值 | 说明 |
-|------|------|--------|------|
-| `items` | `SelectorItem<V>[]` | - | 必填，选项列表 |
-| `selectedKeys` | `V` \| `V[]` | - | 受控的选中值（单选为单个值，多选为数组） |
-| `onSelectionChange` | `(key: V) => void` \| `(keys: V[]) => void` | - | 选择变化回调（类型根据 selectionMode 自动推断） |
-| `selectionMode` | `'single'` \| `'multiple'` | `'single'` | 选择模式 |
-| `placeholder` | `string` | - | 占位文本 |
-| `disabled` | `boolean` | `false` | 是否禁用 |
-| `isRequired` | `boolean` | `false` | 是否必填 |
-| `label` | `ReactNode` | - | 标签文本 |
-| `description` | `ReactNode` | - | 描述文本 |
-| `errorMessage` | `ReactNode` | - | 错误提示 |
-| ...rest | `SelectProps` | - | 其他 HeroUI Select 属性 |
-
-### SelectorItem
-
-```tsx
-interface SelectorItem<V = string | number> {
-  label: string | ReactNode  // 显示文本或自定义内容
-  value: V                   // 选项值
-  disabled?: boolean         // 是否禁用
-  [key: string]: any         // 其他自定义属性
-}
-```
-
-## 类型安全
-
-组件使用 TypeScript 条件类型，根据 `selectionMode` 自动推断回调类型：
-
-```tsx
-// 单选模式
-<Selector
-  selectionMode="single"  // 或省略（默认单选）
-  selectedKeys={value}    // 类型: V
-  onSelectionChange={(v) => ...}  // v 类型: V
-/>
-
-// 多选模式
-<Selector
-  selectionMode="multiple"
-  selectedKeys={values}   // 类型: V[]
-  onSelectionChange={(vs) => ...}  // vs 类型: V[]
-/>
-```
-
-## 与 HeroUI Select 的区别
-
-| 特性 | HeroUI Select | Selector (本组件) |
-|------|---------------|------------------|
-| `selectedKeys` | `Set<Key> \| 'all'` | `V` \| `V[]` (自动转换) |
-| `onSelectionChange` | `(keys: Selection) => void` | `(key: V) => void` \| `(keys: V[]) => void` |
-| 单选回调 | 返回 `Set` (需手动提取) | 直接返回单个值 |
-| 多选回调 | 返回 `Set` (需转数组) | 直接返回数组 |
-| 类型推断 | 无 | 根据 selectionMode 自动推断 |
-
-## 最佳实践
-
-### 1. 显式声明 selectionMode
-
-虽然单选是默认模式，但建议显式声明以提高代码可读性：
-
-```tsx
-// ✅ 推荐
-<Selector selectionMode="single" ... />
-
-// ⚠️ 可以但不够清晰
-<Selector ... />
-```
-
-### 2. 使用泛型指定值类型
-
-当值类型为数字或联合类型时，使用泛型获得更好的类型提示：
-
-```tsx
-// ✅ 推荐
-<Selector<number> selectedKeys={priority} ... />
-
-// ✅ 推荐（联合类型）
-type Status = 'pending' | 'approved' | 'rejected'
-<Selector<Status> selectedKeys={status} ... />
-```
-
-### 3. 避免在渲染时创建 items
-
-```tsx
-// ❌ 不推荐（每次渲染都创建新数组）
-<Selector items={[{ label: 'A', value: '1' }]} />
-
-// ✅ 推荐（在组件外或使用 useMemo）
-const items = [{ label: 'A', value: '1' }]
-<Selector items={items} />
-```
-
-## 迁移指南
-
-### 从 antd Select 迁移
-
-```tsx
-// antd Select
-import { Select } from 'antd'
-
-<Select
-  value={value}
-  onChange={(value) => onChange(value)}
-  options={[
-    { label: 'A', value: '1' },
-    { label: 'B', value: '2' }
-  ]}
-/>
-
-// 迁移到 Selector
-import { Selector } from '@cherrystudio/ui'
-
-<Selector
-  selectedKeys={value}           // value → selectedKeys
-  onSelectionChange={(value) => onChange(value)}  // onChange → onSelectionChange
-  items={[                       // options → items
-    { label: 'A', value: '1' },
-    { label: 'B', value: '2' }
-  ]}
-/>
-```
-
-### 从旧版 Selector 迁移
-
-```tsx
-// 旧版 Selector (返回数组)
-<Selector
-  onSelectionChange={(values) => {
-    const value = values[0]  // 需要手动提取
-    onChange(value)
-  }}
-/>
-
-// 新版 Selector (直接返回值)
-<Selector
-  selectionMode="single"
-  onSelectionChange={(value) => {
-    onChange(value)  // 直接使用
-  }}
-/>
-```
-
-## 常见问题
-
-### Q: 为什么单选模式下还需要 selectedKeys 而不是 selectedKey？
-
-A: 为了保持与 HeroUI API 命名的一致性，同时简化组件实现。组件内部会自动处理单个值和 Set 的转换。
-
-### Q: 如何清空选择？
-
-```tsx
-// 单选模式
-<Selector
-  selectedKeys={value}
-  onSelectionChange={setValue}
-  isClearable  // 添加清空按钮
-/>
-
-// 或手动设置为 undefined
-setValue(undefined)
-```
-
-### Q: 支持异步加载选项吗？
-
-支持，配合 `isLoading` 属性使用：
-
-```tsx
-const [items, setItems] = useState([])
-const [loading, setLoading] = useState(true)
-
-useEffect(() => {
-  fetchItems().then(data => {
-    setItems(data)
-    setLoading(false)
-  })
-}, [])
-
-<Selector items={items} isLoading={loading} />
-```

packages/ui/src/components/base/Selector/SearchableSelector.tsx

@@ -1,60 +0,0 @@
-import { Autocomplete, AutocompleteItem } from '@heroui/react'
-import type { Key } from '@react-types/shared'
-import { useMemo } from 'react'
-
-import type { SearchableSelectorItem, SearchableSelectorProps } from './types'
-
-const SearchableSelector = <T extends SearchableSelectorItem>(props: SearchableSelectorProps<T>) => {
-  const { items, onSelectionChange, selectedKeys, selectionMode = 'single', children, ...rest } = props
-
-  // 转换 selectedKeys: V | V[] → Key | undefined (Autocomplete 只支持单选)
-  const autocompleteSelectedKey = useMemo(() => {
-    if (selectedKeys === undefined) return undefined
-
-    if (selectionMode === 'multiple') {
-      // Autocomplete 不支持多选，取第一个
-      const keys = selectedKeys as T['value'][]
-      return keys.length > 0 ? String(keys[0]) : undefined
-    } else {
-      return String(selectedKeys)
-    }
-  }, [selectedKeys, selectionMode])
-
-  // 处理选择变化
-  const handleSelectionChange = (key: Key | null) => {
-    if (!onSelectionChange || key === null) return
-
-    const strKey = String(key)
-    // 尝试转换回数字类型
-    const num = Number(strKey)
-    const value = !isNaN(num) && items.some((item) => item.value === num) ? (num as T['value']) : (strKey as T['value'])
-
-    if (selectionMode === 'multiple') {
-      // 多选模式: 返回数组 (Autocomplete 只支持单选，这里简化处理)
-      ;(onSelectionChange as (keys: T['value'][]) => void)([value])
-    } else {
-      // 单选模式: 返回单个值
-      ;(onSelectionChange as (key: T['value']) => void)(value)
-    }
-  }
-
-  // 默认渲染函数
-  const defaultRenderItem = (item: T) => (
-    <AutocompleteItem key={String(item.value)} textValue={item.label ? String(item.label) : String(item.value)}>
-      {item.label ?? item.value}
-    </AutocompleteItem>
-  )
-
-  return (
-    <Autocomplete
-      {...rest}
-      items={items}
-      selectedKey={autocompleteSelectedKey}
-      onSelectionChange={handleSelectionChange}
-      allowsCustomValue={false}>
-      {children ?? defaultRenderItem}
-    </Autocomplete>
-  )
-}
-
-export default SearchableSelector

packages/ui/src/components/base/Selector/Selector.tsx

@@ -1,75 +0,0 @@
-import type { Selection } from '@heroui/react'
-import { Select, SelectItem } from '@heroui/react'
-import type { Key } from '@react-types/shared'
-import { useMemo } from 'react'
-
-import type { SelectorItem, SelectorProps } from './types'
-
-const Selector = <T extends SelectorItem>(props: SelectorProps<T>) => {
-  const { items, onSelectionChange, selectedKeys, selectionMode = 'single', children, ...rest } = props
-
-  // 转换 selectedKeys: V | V[] | undefined → Set<Key> | undefined
-  const heroUISelectedKeys = useMemo(() => {
-    if (selectedKeys === undefined) return undefined
-
-    if (selectionMode === 'multiple') {
-      // 多选模式: V[] → Set<Key>
-      return new Set((selectedKeys as T['value'][]).map((key) => String(key) as Key))
-    } else {
-      // 单选模式: V → Set<Key>
-      return new Set([String(selectedKeys) as Key])
-    }
-  }, [selectedKeys, selectionMode])
-
-  // 处理选择变化，转换 Selection → V | V[]
-  const handleSelectionChange = (keys: Selection) => {
-    if (!onSelectionChange) return
-
-    if (keys === 'all') {
-      // 如果是全选，返回所有非禁用项的值
-      const allValues = items.filter((item) => !item.disabled).map((item) => item.value)
-      if (selectionMode === 'multiple') {
-        ;(onSelectionChange as (keys: T['value'][]) => void)(allValues)
-      }
-      return
-    }
-
-    // 转换 Set<Key> 为原始类型
-    const keysArray = Array.from(keys).map((key) => {
-      const strKey = String(key)
-      // 尝试转换回数字类型（如果原始值是数字）
-      const num = Number(strKey)
-      return !isNaN(num) && items.some((item) => item.value === num) ? (num as T['value']) : (strKey as T['value'])
-    })
-
-    if (selectionMode === 'multiple') {
-      // 多选模式: 返回数组
-      ;(onSelectionChange as (keys: T['value'][]) => void)(keysArray)
-    } else {
-      // 单选模式: 返回单个值
-      if (keysArray.length > 0) {
-        ;(onSelectionChange as (key: T['value']) => void)(keysArray[0])
-      }
-    }
-  }
-
-  // 默认渲染函数
-  const defaultRenderItem = (item: T) => (
-    <SelectItem key={String(item.value)} textValue={item.label ? String(item.label) : String(item.value)}>
-      {item.label ?? item.value}
-    </SelectItem>
-  )
-
-  return (
-    <Select
-      {...rest}
-      items={items}
-      selectionMode={selectionMode}
-      selectedKeys={heroUISelectedKeys as 'all' | Iterable<Key> | undefined}
-      onSelectionChange={handleSelectionChange}>
-      {children ?? defaultRenderItem}
-    </Select>
-  )
-}
-
-export default Selector

packages/ui/src/components/base/Selector/index.tsx

@@ -1,13 +0,0 @@
-// 统一导出 Selector 相关组件和类型
-export { default as SearchableSelector } from './SearchableSelector'
-export { default } from './Selector'
-export type {
-  MultipleSearchableSelectorProps,
-  MultipleSelectorProps,
-  SearchableSelectorItem,
-  SearchableSelectorProps,
-  SelectorItem,
-  SelectorProps,
-  SingleSearchableSelectorProps,
-  SingleSelectorProps
-} from './types'