Merge branch 'refactor/ocr' of github.com:CherryHQ/cherry-studio into refactor/ocr

Implement new service layer for OCR provider management following the IBaseService interface. Includes basic CRUD operations, pagination, and special methods for built-in providers. This is an early version pending final data architecture design.

.github/workflows/pr-ci.yml

@@ -58,7 +58,7 @@ jobs:
         run: yarn typecheck
 
       - name: i18n Check
-        run: yarn i18n:check
+        run: yarn check:i18n
 
       - name: Test
         run: yarn test

.vscode/settings.json

@@ -27,40 +27,27 @@
     "source.fixAll.biome": "explicit",
     "source.fixAll.eslint": "explicit",
     "source.fixAll.oxc": "explicit",
-    "source.organizeImports": "never",
-    "source.sort.json.biome": "always"
+    "source.organizeImports": "never"
   },
   "editor.formatOnSave": true,
   "files.associations": {
-    ".oxlintrc.json": "jsonc",
-    "*.css": "tailwindcss"
+    "*.css": "tailwindcss",
+    ".oxlintrc.json": "jsonc"
   },
   "files.eol": "\n",
-  // "i18n-ally.defaultNamespace": "translation",
   // "i18n-ally.displayLanguage": "zh-cn", // 界面显示语言
-  "i18n-ally.enabledFrameworks": [
-    "react-i18next",
-    "i18next"
-  ],
-  "i18n-ally.enabledParsers": [
-    "ts",
-    "js",
-    "json"
-  ], // 解析语言
+  "i18n-ally.enabledFrameworks": ["react-i18next", "i18next"],
+  "i18n-ally.enabledParsers": ["ts", "js", "json"], // 解析语言
   "i18n-ally.fullReloadOnChanged": true,
   "i18n-ally.keystyle": "nested", // 翻译路径格式
-  "i18n-ally.localesPaths": [
-    "src/renderer/src/i18n/locales"
-  ],
-  "i18n-ally.namespace": true, // 开启命名空间
+  "i18n-ally.localesPaths": ["src/renderer/src/i18n/locales"],
+  // "i18n-ally.namespace": true, // 开启命名空间
+  "i18n-ally.sortKeys": true, // 排序
   "i18n-ally.sourceLanguage": "zh-cn", // 翻译源语言
-  "i18n-ally.usage.derivedKeyRules": [
-    "{key}_one",
-    "{key}_other"
-  ], // 标记单复数形式的键为已翻译
+  "i18n-ally.usage.derivedKeyRules": ["{key}_one", "{key}_other"], // 标记单复数形式的键为已翻译
   "search.exclude": {
-    ".yarn/releases/**": true,
-    "**/dist/**": true
+    "**/dist/**": true,
+    ".yarn/releases/**": true
   },
   "tailwindCSS.classAttributes": [
     "className",

CLAUDE.md

@@ -19,7 +19,7 @@ This file provides guidance to AI coding assistants when working with code in th
 - **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 i18n:sync` first to sync template
+  - 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**:

biome.jsonc

@@ -8,7 +8,7 @@
         "useSortedKeys": {
           "level": "on",
           "options": {
-            "sortOrder": "natural"
+            "sortOrder": "lexicographic"
           }
         }
       }

docs/technical/how-to-i18n-en.md

@@ -107,7 +107,7 @@ By avoiding template strings, you gain better developer experience, more reliabl
 
 The project includes several scripts to automate i18n-related tasks:
 
-### `i18n:check` - Validate i18n Structure
+### `check:i18n` - Validate i18n Structure
 
 This script checks:
 
@@ -116,30 +116,28 @@ This script checks:
 - Whether keys are properly sorted
 
 ```bash
-yarn i18n:check
+yarn check:i18n
 ```
 
-### `i18n:sync` - Synchronize JSON Structure and Sort Order
+### `sync:i18n` - Synchronize JSON Structure and Sort Order
 
-By default, this script uses `en-us.json` as the source of truth to sync structure across all language files, including:
+This script uses `zh-cn.json` as the source of truth to sync structure across all language files, including:
 
 1. Adding missing keys, with placeholder `[to be translated]`
 2. Removing obsolete keys
 3. Sorting keys automatically
 
-You can override this behavior by setting the `BASE_LOCALE` environment variable.
-
 ```bash
-yarn i18n:sync
+yarn sync:i18n
 ```
 
-### `i18n:auto` - Automatically Translate Pending Texts
+### `auto:i18n` - Automatically Translate Pending Texts
 
-This script automatically translates texts marked as `[to be translated]` using machine translation. Similar to `i18n:sync`, it defaults to using `en-us.json` as the base, but you can override this behavior by setting the `BASE_LOCALE` environment variable.
+This script fills in texts marked as `[to be translated]` using machine translation.
 
-Typically, after adding required texts to `en-us.json`, running `i18n:sync && i18n:auto` will automatically complete the translations.
+Typically, after adding new texts in `zh-cn.json`, run `sync:i18n`, then `auto:i18n` to complete translations.
 
-Before using this script, you need to configure environment variables, for example:
+Before using this script, set the required environment variables:
 
 ```bash
 API_KEY="sk-xxx"
@@ -147,23 +145,33 @@ BASE_URL="https://dashscope.aliyuncs.com/compatible-mode/v1/"
 MODEL="qwen-plus-latest"
 ```
 
-You can also add environment variables by directly editing the `.env` file.
+Alternatively, add these variables directly to your `.env` file.
 
 ```bash
-yarn i18n:auto
+yarn auto:i18n
+```
+
+### `update:i18n` - Object-level Translation Update
+
+Updates translations in language files under `src/renderer/src/i18n/translate` at the object level, preserving existing translations and only updating new content.
+
+**Not recommended** — prefer `auto:i18n` for translation tasks.
+
+```bash
+yarn update:i18n
 ```
 
 ### Workflow
 
-1. During development, first add the required text in `en-us.json`. You can use the quick fix functionality provided by the i18n-ally plugin to easily accomplish this.
-2. Confirm the text displays correctly in the UI
-3. Use `yarn i18n:sync` to sync the text to other language files
-4. Use `yarn i18n:auto` to perform automatic translation
-5. Grab a coffee and wait for the translation to complete!
+1. During development, first add the required text in `zh-cn.json`
+2. Confirm it displays correctly in the Chinese environment
+3. Run `yarn sync:i18n` to propagate the keys to other language files
+4. Run `yarn auto:i18n` to perform machine translation
+5. Grab a coffee and let the magic happen!
 
 ## Best Practices
 
-1. **Use English as Source Language**: All development starts in English, then translates to other languages.
-2. **Run Check Script Before Commit**: Use `yarn i18n:check` to catch i18n issues early.
+1. **Use Chinese as Source Language**: All development starts in Chinese, then translates to other languages.
+2. **Run Check Script Before Commit**: Use `yarn check:i18n` to catch i18n issues early.
 3. **Translate in Small Increments**: Avoid accumulating a large backlog of untranslated content.
 4. **Keep Keys Semantically Clear**: Keys should clearly express their purpose, e.g., `user.profile.avatar.upload.error`

docs/technical/how-to-i18n-zh.md

@@ -23,9 +23,9 @@ i18n ally是一个强大的VSCode插件，它能在开发阶段提供实时反
 
 ## i18n 约定
 
-### **避免使用flat格式**
+### **绝对避免使用flat格式**
 
-避免使用flat格式，如`"add.button.tip": "添加"`。应采用清晰的嵌套结构：
+绝对避免使用flat格式，如`"add.button.tip": "添加"`。应采用清晰的嵌套结构：
 
 ```json
 // 错误示例 - flat结构
@@ -101,7 +101,7 @@ export const getThemeModeLabel = (key: string): string => {
 
 项目中有一系列脚本来自动化i18n相关任务：
 
-### `i18n:check` - 检查i18n结构
+### `check:i18n` - 检查i18n结构
 
 此脚本会检查：
 
@@ -111,28 +111,26 @@ export const getThemeModeLabel = (key: string): string => {
 - 是否已经有序
 
 ```bash
-yarn i18n:check
+yarn check:i18n
 ```
 
-### `i18n:sync` - 同步json结构与排序
+### `sync:i18n` - 同步json结构与排序
 
-此脚本默认以`en-us.json`文件为基准，将结构同步到其他语言文件，包括：
+此脚本以`zh-cn.json`文件为基准，将结构同步到其他语言文件，包括：
 
 1. 添加缺失的键。缺少的翻译内容会以`[to be translated]`标记
 2. 删除多余的键
 3. 自动排序
 
-你也可以设置环境变量`BASE_LOCALE`来覆盖这一行为。
-
 ```bash
-yarn i18n:auto
+yarn sync:i18n
 ```
 
-### `i18n:auto` - 自动翻译待翻译文本
+### `auto:i18n` - 自动翻译待翻译文本
 
-此脚本自动将标记为待翻译的文本通过机器翻译填充。与 `i18n:sync` 相同，默认以`en-us.json`文件为基准，也可以设置环境变量`BASE_LOCALE`来覆盖这一行为。
+次脚本自动将标记为待翻译的文本通过机器翻译填充。
 
-通常，在`en-us.json`中添加所需文案后，执行`i18n:sync && i18n:auto`即可自动完成翻译。
+通常，在`zh-cn.json`中添加所需文案后，执行`sync:i18n`即可自动完成翻译。
 
 使用该脚本前，需要配置环境变量，例如：
 
@@ -145,19 +143,29 @@ MODEL="qwen-plus-latest"
 你也可以通过直接编辑`.env`文件来添加环境变量。
 
 ```bash
-yarn i18n:auto
+yarn auto:i18n
+```
+
+### `update:i18n` - 对象级别翻译更新
+
+对`src/renderer/src/i18n/translate`中的语言文件进行对象级别的翻译更新，保留已有翻译，只更新新增内容。
+
+**不建议**使用该脚本，更推荐使用`auto:i18n`进行翻译。
+
+```bash
+yarn update:i18n
 ```
 
 ### 工作流
 
-1. 开发阶段，先在`en-us.json`中添加所需文案。你可以利用 i18n-ally 插件提供的快速修复功能轻松完成这一点。
-2. 确认文案在 UI 中显示无误后，使用`yarn i18n:sync`将文案同步到其他语言文件
-3. 使用`yarn i18n:auto`进行自动翻译
+1. 开发阶段，先在`zh-cn.json`中添加所需文案
+2. 确认在中文环境下显示无误后，使用`yarn sync:i18n`将文案同步到其他语言文件
+3. 使用`yarn auto:i18n`进行自动翻译
 4. 喝杯咖啡，等翻译完成吧！
 
 ## 最佳实践
 
-1. **以英文为源语言**：所有开发首先使用英文，再翻译为其他语言
-2. **提交前运行检查脚本**：使用`yarn i18n:check`检查i18n是否有问题
+1. **以中文为源语言**：所有开发首先使用中文，再翻译为其他语言
+2. **提交前运行检查脚本**：使用`yarn check:i18n`检查i18n是否有问题
 3. **小步提交翻译**：避免积累大量未翻译文本
 4. **保持key语义明确**：key应能清晰表达其用途，如`user.profile.avatar.upload.error`

docs/technical/ocr-architecture.md

@@ -0,0 +1,260 @@
+> [!NOTE]
+> This technical documentation was automatically generated by Claude Code based on analysis of the current OCR implementation in the codebase. The content reflects the architecture as of the current branch state.
+
+# OCR Architecture
+
+## Overview
+
+Cherry Studio's OCR (Optical Character Recognition) system is a modular, extensible architecture designed to support multiple OCR providers and file types. The architecture follows a layered approach with clear separation of concerns between data access, business logic, and provider implementations.
+
+## Architecture Layers
+
+The OCR architecture follows a layered approach where data interactions occur through RESTful APIs, while IPC serves as part of the API layer, allowing the renderer to interact directly with the business layer:
+
+### 1. API Layer
+**Location**: `src/main/data/api/handlers/`, `src/main/ipc.ts`, `src/preload/index.ts`
+
+- **IPC Bridge**: Serves as API layer connecting renderer to main process
+- **Request Routing**: Routes IPC calls to appropriate service methods
+- **Type Safety**: Zod schemas for request/response validation
+- **Error Handling**: Centralized error propagation across process boundaries
+- **Security**: Secure communication sandbox between renderer and main processes
+
+### 2. OCR Service Layer (Business Layer)
+**Location**: `src/main/services/ocr/`
+
+- **OcrService**: Main business logic orchestrator and central coordinator
+- **Provider Registry**: Manages registered OCR providers
+- **Data Integration**: Direct interaction with data layer for provider management
+- **Lifecycle Management**: Handles provider initialization and disposal
+- **Validation**: Ensures provider availability and data integrity
+- **Orchestration**: Coordinates between providers and data services
+- **Direct IPC Access**: Renderer can directly invoke business layer methods via IPC
+
+### 3. Provider Services Layer
+**Location**: `src/main/services/ocr/builtin/`
+
+- **Base Service**: Abstract `OcrBaseService` defines common interface
+- **Data Independence**: No direct database interactions, relies on injected data
+- **Built-in Providers**:
+  - `TesseractService`: Local Tesseract.js implementation
+  - `SystemOcrService`: Platform-specific system OCR
+  - `PpocrService`: PaddleOCR integration
+  - `OvOcrService`: Intel OpenVINO (NPU) OCR
+- **Pure OCR Logic**: Focus solely on OCR processing capabilities
+
+### 4. Data Layer
+**Location**: `src/main/data/db/schemas/ocr/`, `src/main/data/repositories/`
+
+- **Database Schema**: Uses Drizzle ORM with SQLite database
+- **Repository Pattern**: `OcrProviderRepository` handles all database operations
+- **Provider Storage**: Stores provider configurations in `ocr_provider` table
+- **JSON Configuration**: Polymorphic `config` field stores provider-specific settings
+- **Data Access**: Exclusively accessed by OCR Service layer
+
+### 5. Frontend Layer
+**Location**: `src/renderer/src/services/ocr/`, `src/renderer/src/hooks/ocr/`
+
+- **Direct IPC Communication**: Direct interaction with business layer via IPC
+- **React Hooks**: Custom hooks for OCR operations and state management
+- **Configuration UI**: Settings pages for provider configuration
+- **State Management**: Frontend state synchronization with backend data
+
+## Data Flow
+
+```mermaid
+graph TD
+    A[Frontend UI] --> B[Frontend OCR Service]
+    B --> C[API Layer - IPC Bridge]
+    C --> D[OCR Service Layer - Business Logic]
+    D --> E[Data Layer - Provider Repository]
+    D --> F[Provider Services Layer]
+    F --> G[OCR Processing]
+    G --> H[Result]
+    H --> F
+    F --> D
+    D --> C
+    C --> B
+    B --> A
+
+    style D fill:#e1f5fe
+    style F fill:#f3e5f5
+    style E fill:#e8f5e8
+    style C fill:#fff3e0
+```
+
+**Key Flow Characteristics:**
+- **Direct Business Access**: Frontend communicates directly with OCR Service layer via IPC
+- **IPC as API Gateway**: IPC bridge functions as the API layer, handling routing and validation
+- **Data Isolation**: Only business layer interacts with data persistence
+- **Provider Independence**: OCR providers remain isolated from data concerns
+
+## Provider System
+
+### Provider Registration
+- **Built-in Providers**: Automatically registered on service initialization
+- **Custom Providers**: Support for extensible provider system
+- **Configuration**: Each provider has its own configuration schema
+
+### Provider Capabilities
+```typescript
+interface OcrProviderCapabilityRecord {
+  image?: boolean    // Image file OCR support
+  pdf?: boolean      // PDF file OCR support (future)
+}
+```
+
+### Configuration Architecture
+- **Polymorphic Config**: JSON-based configuration adapts to provider needs
+- **Type Safety**: Zod schemas validate provider-specific configurations
+- **Runtime Validation**: Configuration validation before OCR operations
+
+## Type System
+
+### Core Types
+- **`OcrProvider`**: Base provider interface
+- **`OcrParams`**: OCR operation parameters
+- **`OcrResult`**: Standardized OCR result format
+- **`SupportedOcrFile`**: File types supported for OCR
+
+### Business Types
+- **`OcrProviderBusiness`**: Domain-level provider representation
+- **Operations**: Create, Update, Replace, Delete operations
+- **Queries**: List providers with filtering options
+
+### Provider-Specific Types
+- **TesseractConfig**: Language selection, model paths
+- **SystemOcrConfig**: Language preferences
+- **PaddleOCRConfig**: API endpoints, authentication
+- **OpenVINOConfig**: Device selection, model paths
+
+## Built-in Providers
+
+### Tesseract OCR
+- **Engine**: Tesseract.js
+- **Languages**: Multi-language support with automatic download
+- **Configuration**: Language selection, cache management
+- **Performance**: Worker pooling for concurrent processing
+
+### System OCR
+- **Windows**: Windows Media Foundation OCR
+- **macOS**: Vision framework OCR
+- **Linux**: Platform-specific implementations
+- **Features**: Native performance, system integration
+
+### PaddleOCR
+- **Deployment**: Remote API integration
+- **Languages**: Chinese, English, and mixed language support
+- **Configuration**: API endpoints and authentication
+
+### Intel OpenVINO OCR
+- **Hardware**: NPU acceleration support
+- **Performance**: Optimized for Intel hardware
+- **Use Case**: High-performance OCR scenarios
+
+## Configuration Management
+
+### Database Schema
+```sql
+CREATE TABLE ocr_provider (
+  id TEXT PRIMARY KEY,
+  name TEXT NOT NULL,
+  capabilities TEXT NOT NULL,  -- JSON
+  config TEXT NOT NULL,        -- JSON
+  created_at INTEGER NOT NULL,
+  updated_at INTEGER NOT NULL
+);
+```
+
+### Provider Defaults
+- **Initial Configuration**: Defined in `packages/shared/config/ocr.ts`
+- **Migration System**: Automatic provider initialization on startup
+- **User Customization**: Runtime configuration updates
+
+## Error Handling
+
+### Error Categories
+- **Provider Errors**: OCR engine failures, missing dependencies
+- **Configuration Errors**: Invalid settings, missing parameters
+- **File Errors**: Unsupported formats, corrupted files
+- **System Errors**: Resource exhaustion, permissions
+
+### Error Propagation
+- **Logging**: Centralized logging with context
+- **User Feedback**: Translated error messages
+- **Recovery**: Graceful fallback options
+
+## Performance Considerations
+
+### Resource Management
+- **Worker Disposal**: Proper cleanup of OCR workers
+- **Memory Management**: Limits on file sizes and concurrent operations
+- **Caching**: Model and result caching where applicable
+
+### Optimization
+- **Lazy Loading**: Providers initialized on demand
+- **Concurrent Processing**: Multiple workers for parallel operations
+- **Hardware Acceleration**: NPU and GPU support where available
+
+## Security
+
+### Input Validation
+- **File Type Checking**: Strict validation of supported formats
+- **Size Limits**: Protection against resource exhaustion
+- **Path Validation**: Prevention of path traversal attacks
+
+### Configuration Security
+- **API Key Storage**: Secure storage of sensitive configuration
+- **Validation**: Runtime validation of configuration parameters
+- **Sandboxing**: Isolated execution of OCR operations
+
+## Extension Points
+
+### Custom Providers
+- **Interface**: Implement `OcrBaseService` for new providers
+- **Registration**: Dynamic provider registration system
+- **Configuration**: Extensible configuration schemas
+
+### File Type Support
+- **Handlers**: Modular file type processors
+- **Capabilities**: Declarative provider capabilities
+- **Future Support**: PDF, document formats planned
+
+## Migration Strategy
+
+### Legacy System
+- **Data Migration**: Automatic migration from old configuration formats
+- **Compatibility**: Backward compatibility during transition
+- **Testing**: Comprehensive test coverage for migration paths
+
+### Future Enhancements
+- **PDF Support**: Planned extension to document OCR
+- **Cloud Providers**: API-based OCR services integration
+- **AI Enhancement**: Post-processing and accuracy improvements
+
+## Development Guidelines
+
+### Adding New Providers
+1. Create provider service extending `OcrBaseService`
+2. Define provider-specific configuration schema
+3. Register provider in `OcrService`
+4. Add configuration UI components
+5. Include comprehensive tests
+
+> [!WARNING]
+> Provider services should never directly access the data layer. All data operations must go through the OCR Service layer to maintain proper separation of concerns.
+
+### Configuration Changes
+1. Update provider configuration schema
+2. Add migration logic for existing configurations
+3. Update UI validation and error handling
+4. Test with various configuration scenarios
+
+> [!WARNING]
+> Always validate configuration changes before saving to the database. Use Zod schemas for runtime validation to prevent corrupted provider configurations.
+
+### Testing
+- **Unit Tests**: Provider implementation testing
+- **Integration Tests**: End-to-end OCR workflows
+- **Performance Tests**: Resource usage and timing
+- **Error Scenarios**: Comprehensive error handling testing

docs/technical/ocr-architecture.zh.md

@@ -0,0 +1,260 @@
+> [!NOTE]
+> 本技术文档由 Claude Code 基于对当前代码库中 OCR 实现的分析自动生成。内容反映了当前分支状态的架构设计。
+
+# OCR 架构文档
+
+## 概述
+
+Cherry Studio 的 OCR（光学字符识别）系统是一个模块化、可扩展的架构，旨在支持多个 OCR 提供商和文件类型。该架构采用分层设计，在数据访问、业务逻辑和提供商实现之间有明确的关注点分离。
+
+## 架构分层
+
+OCR 架构采用分层方法，其中数据交互通过 RESTful API 进行，而 IPC 作为 API 层的一部分，允许 Renderer 直接与业务层交互：
+
+### 1. API 层
+**位置**: `src/main/data/api/handlers/`, `src/main/ipc.ts`, `src/preload/index.ts`
+
+- **IPC 桥接**: 作为 API 层连接 Renderer 到主进程
+- **请求路由**: 将 IPC 调用路由到相应的服务方法
+- **类型安全**: 使用 Zod 模式进行请求/响应验证
+- **错误处理**: 跨进程边界的集中式错误传播
+- **安全**: Renderer 和主进程之间的安全通信沙盒
+
+### 2. OCR 服务层（业务层）
+**位置**: `src/main/services/ocr/`
+
+- **OcrService**: 主要业务逻辑协调器和中央协调器
+- **提供商注册表**: 管理已注册的 OCR 提供商
+- **数据集成**: 与数据层直接交互进行提供商管理
+- **生命周期管理**: 处理提供商初始化和销毁
+- **验证**: 确保提供商可用性和数据完整性
+- **协调**: 协调提供商和数据服务之间的交互
+- **直接 IPC 访问**: Renderer 可通过 IPC 直接调用业务层方法
+
+### 3. 提供商服务层
+**位置**: `src/main/services/ocr/builtin/`
+
+- **基础服务**: 抽象的 `OcrBaseService` 定义通用接口
+- **数据独立性**: 无直接数据库交互，依赖外部传入的数据
+- **内置提供商**:
+  - `TesseractService`: 本地 Tesseract.js 实现
+  - `SystemOcrService`: 平台特定的系统 OCR
+  - `PpocrService`: PaddleOCR 集成
+  - `OvOcrService`: Intel OpenVINO (NPU) OCR
+- **纯 OCR 逻辑**: 专注于 OCR 处理能力
+
+### 4. 数据层
+**位置**: `src/main/data/db/schemas/ocr/`, `src/main/data/repositories/`
+
+- **数据库架构**: 使用 Drizzle ORM 和 SQLite 数据库
+- **仓储模式**: `OcrProviderRepository` 处理所有数据库操作
+- **提供商存储**: 在 `ocr_provider` 表中存储提供商配置
+- **JSON 配置**: 多态的 `config` 字段存储提供商特定的设置
+- **数据访问**: 仅由 OCR 服务层访问
+
+### 5. Renderer 层
+**位置**: `src/renderer/src/services/ocr/`, `src/renderer/src/hooks/ocr/`
+
+- **直接 IPC 通信**: 通过 IPC 与业务层直接交互
+- **React Hooks**: 用于 OCR 操作和状态管理的自定义钩子
+- **配置 UI**: 提供商配置的设置页面
+- **状态管理**: Renderer 状态与后端数据同步
+
+## 数据流
+
+```mermaid
+graph TD
+    A[Renderer UI] --> B[Renderer OCR 服务]
+    B --> C[API 层 - IPC 桥接]
+    C --> D[OCR 服务层 - 业务逻辑]
+    D --> E[数据层 - 提供商仓储]
+    D --> F[提供商服务层]
+    F --> G[OCR 处理]
+    G --> H[结果]
+    H --> F
+    F --> D
+    D --> C
+    C --> B
+    B --> A
+
+    style D fill:#e1f5fe
+    style F fill:#f3e5f5
+    style E fill:#e8f5e8
+    style C fill:#fff3e0
+```
+
+**关键流程特征**:
+- **直接业务访问**: Renderer 通过 IPC 与 OCR 服务层直接通信
+- **IPC 作为 API 网关**: IPC 桥接作为 API 层，处理路由和验证
+- **数据隔离**: 只有业务层与数据持久化交互
+- **提供商独立性**: OCR 提供商保持与数据关注点的隔离
+
+## 提供商系统
+
+### 提供商注册
+- **内置提供商**: 在服务初始化时自动注册
+- **自定义提供商**: 支持可扩展的提供商系统
+- **配置**: 每个提供商都有自己的配置模式
+
+### 提供商能力
+```typescript
+interface OcrProviderCapabilityRecord {
+  image?: boolean    // 图像文件 OCR 支持
+  pdf?: boolean      // PDF 文件 OCR 支持（未来）
+}
+```
+
+### 配置架构
+- **多态配置**: 基于 JSON 的配置适应提供商需求
+- **类型安全**: Zod 模式验证提供商特定的配置
+- **运行时验证**: OCR 操作前的配置验证
+
+## 类型系统
+
+### 核心类型
+- **`OcrProvider`**: 基础提供商接口
+- **`OcrParams`**: OCR 操作参数
+- **`OcrResult`**: 标准化的 OCR 结果格式
+- **`SupportedOcrFile`**: 支持 OCR 的文件类型
+
+### 业务类型
+- **`OcrProviderBusiness`**: 域级别的提供商表示
+- **操作**: 创建、更新、替换、删除操作
+- **查询**: 带过滤选项的提供商列表
+
+### 提供商特定类型
+- **TesseractConfig**: 语言选择、模型路径
+- **SystemOcrConfig**: 语言偏好
+- **PaddleOCRConfig**: API 端点、认证
+- **OpenVINOConfig**: 设备选择、模型路径
+
+## 内置提供商
+
+### Tesseract OCR
+- **引擎**: Tesseract.js
+- **语言**: 支持多语言，自动下载
+- **配置**: 语言选择、缓存管理
+- **性能**: 工作池用于并发处理
+
+### 系统 OCR
+- **Windows**: Windows Media Foundation OCR
+- **macOS**: Vision 框架 OCR
+- **Linux**: 平台特定实现
+- **特性**: 原生性能、系统集成
+
+### PaddleOCR
+- **部署**: 远程 API 集成
+- **语言**: 中文、英文和混合语言支持
+- **配置**: API 端点和认证
+
+### Intel OpenVINO OCR
+- **硬件**: NPU 加速支持
+- **性能**: 为 Intel 硬件优化
+- **用例**: 高性能 OCR 场景
+
+## 配置管理
+
+### 数据库架构
+```sql
+CREATE TABLE ocr_provider (
+  id TEXT PRIMARY KEY,
+  name TEXT NOT NULL,
+  capabilities TEXT NOT NULL,  -- JSON
+  config TEXT NOT NULL,        -- JSON
+  created_at INTEGER NOT NULL,
+  updated_at INTEGER NOT NULL
+);
+```
+
+### 提供商默认值
+- **初始配置**: 在 `packages/shared/config/ocr.ts` 中定义
+- **迁移系统**: 启动时自动提供商初始化
+- **用户自定义**: 运行时配置更新
+
+## 错误处理
+
+### 错误类别
+- **提供商错误**: OCR 引擎故障、缺少依赖
+- **配置错误**: 无效设置、缺少参数
+- **文件错误**: 不支持的格式、损坏的文件
+- **系统错误**: 资源耗尽、权限问题
+
+### 错误传播
+- **日志**: 带上下文的集中日志记录
+- **用户反馈**: 翻译的错误消息
+- **恢复**: 优雅的回退选项
+
+## 性能考虑
+
+### 资源管理
+- **工作器销毁**: OCR 工作器的适当清理
+- **内存管理**: 文件大小和并发操作限制
+- **缓存**: 模型和结果缓存（如适用）
+
+### 优化
+- **延迟加载**: 按需初始化提供商
+- **并发处理**: 多工作器用于并行操作
+- **硬件加速**: NPU 和 GPU 支持（如可用）
+
+## 安全
+
+### 输入验证
+- **文件类型检查**: 严格验证支持的格式
+- **大小限制**: 防止资源耗尽
+- **路径验证**: 防止路径遍历攻击
+
+### 配置安全
+- **API 密钥存储**: 敏感配置的安全存储
+- **验证**: 配置参数的运行时验证
+- **沙盒**: OCR 操作的隔离执行
+
+## 扩展点
+
+### 自定义提供商
+- **接口**: 为新提供商实现 `OcrBaseService`
+- **注册**: 动态提供商注册系统
+- **配置**: 可扩展的配置模式
+
+### 文件类型支持
+- **处理器**: 模块化文件类型处理器
+- **能力**: 声明式提供商能力
+- **未来支持**: PDF、文档格式计划中
+
+## 迁移策略
+
+### 遗留系统
+- **数据迁移**: 从旧配置格式自动迁移
+- **兼容性**: 过渡期间的向后兼容性
+- **测试**: 迁移路径的全面测试覆盖
+
+### 未来增强
+- **PDF 支持**: 计划扩展到文档 OCR
+- **云提供商**: 基于 API 的 OCR 服务集成
+- **AI 增强**: 后处理和准确性改进
+
+## 开发指南
+
+### 添加新提供商
+1. 创建扩展 `OcrBaseService` 的提供商服务
+2. 定义提供商特定的配置模式
+3. 在 `OcrService` 中注册提供商
+4. 添加配置 UI 组件
+5. 包含全面的测试
+
+> [!WARNING]
+> 提供商服务绝不应直接访问数据层。所有数据操作必须通过 OCR 服务层进行，以保持适当的关注点分离。
+
+### 配置更改
+1. 更新提供商配置模式
+2. 为现有配置添加迁移逻辑
+3. 更新 UI 验证和错误处理
+4. 测试各种配置场景
+
+> [!WARNING]
+> 在保存到数据库之前，务必验证配置更改。使用 Zod 模式进行运行时验证，防止提供商配置损坏。
+
+### 测试
+- **单元测试**: 提供商实现测试
+- **集成测试**: 端到端 OCR 工作流
+- **性能测试**: 资源使用和时间
+- **错误场景**: 全面的错误处理测试

i18next.config.ts

@@ -1,19 +0,0 @@
-import { defineConfig } from 'i18next-cli'
-
-/** @see https://github.com/i18next/i18next-cli */
-export default defineConfig({
-  locales: ['en-us', 'zh-cn', 'zh-tw', 'de-de', 'el-gr', 'es-es', 'fr-fr', 'ja-jp', 'pt-pt', 'ru-ru'],
-  extract: {
-    input: 'src/renderer/src/**/*.{ts,tsx}',
-    output: 'src/renderer/src/i18n/locales/{{language}}.json',
-    defaultValue: (_1, _2, _3, value) => `[to be translated]${value}`,
-    primaryLanguage: 'en-us',
-    removeUnusedKeys: false
-  },
-  types: {
-    input: ['src/renderer/src/i18n/locales/en-us.json'],
-    output: 'src/renderer/src/i18n/i18next.d.ts',
-    resourcesFile: 'src/renderer/src/i18n/resources.d.ts',
-    enableSelector: true
-  }
-})

migrations/sqlite-drizzle/0001_previous_sir_ram.sql

@@ -0,0 +1,10 @@
+CREATE TABLE `ocr_provider` (
+	`id` text PRIMARY KEY NOT NULL,
+	`name` text NOT NULL,
+	`capabilities` text NOT NULL,
+	`config` text NOT NULL,
+	`created_at` integer,
+	`updated_at` integer
+);
+--> statement-breakpoint
+CREATE INDEX `name` ON `ocr_provider` (`name`);

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

@@ -0,0 +1,172 @@
+{
+  "version": "6",
+  "dialect": "sqlite",
+  "id": "64f7ad88-7111-4574-988c-d7ef429e375d",
+  "prevId": "de8009d7-95b9-4f99-99fa-4b8795708f21",
+  "tables": {
+    "app_state": {
+      "name": "app_state",
+      "columns": {
+        "key": {
+          "name": "key",
+          "type": "text",
+          "primaryKey": true,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "value": {
+          "name": "value",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "description": {
+          "name": "description",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "created_at": {
+          "name": "created_at",
+          "type": "integer",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "updated_at": {
+          "name": "updated_at",
+          "type": "integer",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        }
+      },
+      "indexes": {},
+      "foreignKeys": {},
+      "compositePrimaryKeys": {},
+      "uniqueConstraints": {},
+      "checkConstraints": {}
+    },
+    "ocr_provider": {
+      "name": "ocr_provider",
+      "columns": {
+        "id": {
+          "name": "id",
+          "type": "text",
+          "primaryKey": true,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "name": {
+          "name": "name",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "capabilities": {
+          "name": "capabilities",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "config": {
+          "name": "config",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "created_at": {
+          "name": "created_at",
+          "type": "integer",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "updated_at": {
+          "name": "updated_at",
+          "type": "integer",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        }
+      },
+      "indexes": {
+        "name": {
+          "name": "name",
+          "columns": ["name"],
+          "isUnique": false
+        }
+      },
+      "foreignKeys": {},
+      "compositePrimaryKeys": {},
+      "uniqueConstraints": {},
+      "checkConstraints": {}
+    },
+    "preference": {
+      "name": "preference",
+      "columns": {
+        "scope": {
+          "name": "scope",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "key": {
+          "name": "key",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "value": {
+          "name": "value",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "created_at": {
+          "name": "created_at",
+          "type": "integer",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "updated_at": {
+          "name": "updated_at",
+          "type": "integer",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        }
+      },
+      "indexes": {
+        "scope_name_idx": {
+          "name": "scope_name_idx",
+          "columns": ["scope", "key"],
+          "isUnique": false
+        }
+      },
+      "foreignKeys": {},
+      "compositePrimaryKeys": {},
+      "uniqueConstraints": {},
+      "checkConstraints": {}
+    }
+  },
+  "views": {},
+  "enums": {},
+  "_meta": {
+    "schemas": {},
+    "tables": {},
+    "columns": {}
+  },
+  "internal": {
+    "indexes": {}
+  }
+}

migrations/sqlite-drizzle/meta/_journal.json

@@ -7,6 +7,13 @@
       "tag": "0000_solid_lord_hawal",
       "version": "6",
       "when": 1754745234572
+    },
+    {
+      "idx": 1,
+      "version": "6",
+      "when": 1760969721294,
+      "tag": "0001_previous_sir_ram",
+      "breakpoints": true
     }
   ],
   "version": "7"

package.json

@@ -54,11 +54,10 @@
     "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",
-    "i18n:check": "dotenv -e .env -- tsx scripts/check-i18n.ts",
-    "i18n:sync": "i18next-cli sync",
-    "i18n:auto": "dotenv -e .env -- tsx scripts/auto-translate-i18n.ts",
-    "i18n:status": "i18next-cli status",
-    "i18n:extract": "i18next-cli extract",
+    "check:i18n": "dotenv -e .env -- tsx scripts/check-i18n.ts",
+    "sync:i18n": "dotenv -e .env -- 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",
     "test": "vitest run --silent",
     "test:main": "vitest run --project main",
@@ -70,7 +69,7 @@
     "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 i18n:check && yarn format:check",
+    "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",
     "format": "biome format --write && biome lint --write",
     "format:check": "biome format && biome lint",
@@ -86,6 +85,7 @@
     "@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",
+    "@radix-ui/react-tabs": "^1.1.13",
     "@strongtz/win32-arm64-msvc": "^0.4.7",
     "express": "^5.1.0",
     "font-list": "^2.0.0",
@@ -95,7 +95,7 @@
     "officeparser": "^4.2.0",
     "os-proxy-config": "^1.1.2",
     "selection-hook": "^1.0.12",
-    "sharp": "^0.34.3",
+    "sharp": "0.34.4",
     "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",
@@ -285,7 +285,6 @@
     "htmlparser2": "^10.0.0",
     "husky": "^9.1.7",
     "i18next": "^23.11.5",
-    "i18next-cli": "^1.12.0",
     "iconv-lite": "^0.6.3",
     "ipaddr.js": "^2.2.0",
     "isbinaryfile": "5.0.4",
@@ -392,12 +391,12 @@
     "vite": "npm:rolldown-vite@7.1.5",
     "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",
-    "@img/sharp-darwin-arm64": "0.34.3",
-    "@img/sharp-darwin-x64": "0.34.3",
-    "@img/sharp-linux-arm": "0.34.3",
-    "@img/sharp-linux-arm64": "0.34.3",
-    "@img/sharp-linux-x64": "0.34.3",
-    "@img/sharp-win32-x64": "0.34.3",
+    "@img/sharp-darwin-arm64": "0.34.4",
+    "@img/sharp-darwin-x64": "0.34.4",
+    "@img/sharp-linux-arm": "0.34.4",
+    "@img/sharp-linux-arm64": "0.34.4",
+    "@img/sharp-linux-x64": "0.34.4",
+    "@img/sharp-win32-x64": "0.34.4",
     "openai@npm:5.12.2": "npm:@cherrystudio/openai@6.5.0"
   },
   "packageManager": "yarn@4.9.1",

packages/shared/IpcChannel.ts

@@ -369,8 +369,7 @@ export enum IpcChannel {
   CodeTools_RemoveCustomTerminalPath = 'code-tools:remove-custom-terminal-path',
 
   // OCR
-  OCR_ocr = 'ocr:ocr',
-  OCR_ListProviders = 'ocr:list-providers',
+  OCR_Ocr = 'ocr:ocr',
 
   // OVMS
   Ovms_AddModel = 'ovms:add-model',

packages/shared/config/ocr.ts

@@ -0,0 +1,176 @@
+import type {
+  BuiltinOcrProvider,
+  BuiltinOcrProviderId,
+  OcrOvProvider,
+  OcrPpocrProvider,
+  OcrSystemProvider,
+  OcrTesseractProvider,
+  TesseractLangCode
+} from '@types'
+
+import type { TranslateLanguageCode } from '../../../src/renderer/src/types/translate'
+
+export const tesseract: OcrTesseractProvider = {
+  id: 'tesseract',
+  name: 'Tesseract',
+  capabilities: {
+    image: true
+  },
+  config: {
+    langs: {
+      chi_sim: true,
+      chi_tra: true,
+      eng: true
+    },
+    enabled: false
+  }
+} as const
+
+export const systemOcr: OcrSystemProvider = {
+  id: 'system',
+  name: 'System',
+  capabilities: {
+    image: true
+    // pdf: true
+  },
+  config: {
+    langs: ['en-us'],
+    enabled: false
+  }
+} as const satisfies OcrSystemProvider
+
+export const ppocrOcr: OcrPpocrProvider = {
+  id: 'paddleocr',
+  name: 'PaddleOCR',
+  capabilities: {
+    image: true
+    // pdf: true
+  },
+  config: { apiUrl: '', enabled: false }
+} as const
+
+export const ovOcr: OcrOvProvider = {
+  id: 'ovocr',
+  name: 'Intel OV(NPU) OCR',
+  capabilities: {
+    image: true
+    // pdf: true
+  },
+  config: {
+    enabled: false
+  }
+} as const satisfies OcrOvProvider
+
+export const INITIAL_BUILTIN_OCR_PROVIDER_MAP = {
+  tesseract,
+  system: systemOcr,
+  paddleocr: ppocrOcr,
+  ovocr: ovOcr
+} as const satisfies Record<BuiltinOcrProviderId, BuiltinOcrProvider>
+
+export const BUILTIN_OCR_PROVIDERS: BuiltinOcrProvider[] = Object.values(INITIAL_BUILTIN_OCR_PROVIDER_MAP)
+
+export const TESSERACT_LANG_MAP: Record<TranslateLanguageCode, TesseractLangCode> = {
+  'af-za': 'afr',
+  'am-et': 'amh',
+  'ar-sa': 'ara',
+  'as-in': 'asm',
+  'az-az': 'aze',
+  'az-cyrl-az': 'aze_cyrl',
+  'be-by': 'bel',
+  'bn-bd': 'ben',
+  'bo-cn': 'bod',
+  'bs-ba': 'bos',
+  'bg-bg': 'bul',
+  'ca-es': 'cat',
+  'ceb-ph': 'ceb',
+  'cs-cz': 'ces',
+  'zh-cn': 'chi_sim',
+  'zh-tw': 'chi_tra',
+  'chr-us': 'chr',
+  'cy-gb': 'cym',
+  'da-dk': 'dan',
+  'de-de': 'deu',
+  'dz-bt': 'dzo',
+  'el-gr': 'ell',
+  'en-us': 'eng',
+  'enm-gb': 'enm',
+  'eo-world': 'epo',
+  'et-ee': 'est',
+  'eu-es': 'eus',
+  'fa-ir': 'fas',
+  'fi-fi': 'fin',
+  'fr-fr': 'fra',
+  'frk-de': 'frk',
+  'frm-fr': 'frm',
+  'ga-ie': 'gle',
+  'gl-es': 'glg',
+  'grc-gr': 'grc',
+  'gu-in': 'guj',
+  'ht-ht': 'hat',
+  'he-il': 'heb',
+  'hi-in': 'hin',
+  'hr-hr': 'hrv',
+  'hu-hu': 'hun',
+  'iu-ca': 'iku',
+  'id-id': 'ind',
+  'is-is': 'isl',
+  'it-it': 'ita',
+  'ita-it': 'ita_old',
+  'jv-id': 'jav',
+  'ja-jp': 'jpn',
+  'kn-in': 'kan',
+  'ka-ge': 'kat',
+  'kat-ge': 'kat_old',
+  'kk-kz': 'kaz',
+  'km-kh': 'khm',
+  'ky-kg': 'kir',
+  'ko-kr': 'kor',
+  'ku-tr': 'kur',
+  'la-la': 'lao',
+  'la-va': 'lat',
+  'lv-lv': 'lav',
+  'lt-lt': 'lit',
+  'ml-in': 'mal',
+  'mr-in': 'mar',
+  'mk-mk': 'mkd',
+  'mt-mt': 'mlt',
+  'ms-my': 'msa',
+  'my-mm': 'mya',
+  'ne-np': 'nep',
+  'nl-nl': 'nld',
+  'no-no': 'nor',
+  'or-in': 'ori',
+  'pa-in': 'pan',
+  'pl-pl': 'pol',
+  'pt-pt': 'por',
+  'ps-af': 'pus',
+  'ro-ro': 'ron',
+  'ru-ru': 'rus',
+  'sa-in': 'san',
+  'si-lk': 'sin',
+  'sk-sk': 'slk',
+  'sl-si': 'slv',
+  'es-es': 'spa',
+  'spa-es': 'spa_old',
+  'sq-al': 'sqi',
+  'sr-rs': 'srp',
+  'sr-latn-rs': 'srp_latn',
+  'sw-tz': 'swa',
+  'sv-se': 'swe',
+  'syr-sy': 'syr',
+  'ta-in': 'tam',
+  'te-in': 'tel',
+  'tg-tj': 'tgk',
+  'tl-ph': 'tgl',
+  'th-th': 'tha',
+  'ti-er': 'tir',
+  'tr-tr': 'tur',
+  'ug-cn': 'uig',
+  'uk-ua': 'ukr',
+  'ur-pk': 'urd',
+  'uz-uz': 'uzb',
+  'uz-cyrl-uz': 'uzb_cyrl',
+  'vi-vn': 'vie',
+  'yi-us': 'yid'
+}

packages/shared/data/api/apiSchemas.ts

@@ -1,5 +1,18 @@
 // NOTE: Types are defined inline in the schema for simplicity
 // If needed, specific types can be imported from './apiModels'
+import type {
+  CreateOcrProviderRequest,
+  CreateOcrProviderResponse,
+  GetOcrProviderResponse,
+  ListOcrProvidersQuery,
+  ListOcrProvidersResponse,
+  OcrProviderId,
+  ReplaceOcrProviderRequest,
+  ReplaceOcrProviderResponse,
+  UpdateOcrProviderRequest,
+  UpdateOcrProviderResponse
+} from '@types'
+
 import type { BodyForPath, ConcreteApiPaths, QueryParamsForPath, ResponseForPath } from './apiPaths'
 import type { HttpMethod, PaginatedResponse, PaginationParams } from './apiTypes'
 
@@ -345,6 +358,38 @@ export interface ApiSchemas {
       }>
     }
   }
+
+  '/ocr/providers': {
+    GET: {
+      query: ListOcrProvidersQuery
+      response: ListOcrProvidersResponse
+    }
+    POST: {
+      body: CreateOcrProviderRequest
+      response: CreateOcrProviderResponse
+    }
+  }
+
+  '/ocr/providers/:id': {
+    GET: {
+      params: { id: OcrProviderId }
+      response: GetOcrProviderResponse
+    }
+    PATCH: {
+      params: { id: OcrProviderId }
+      body: UpdateOcrProviderRequest
+      response: UpdateOcrProviderResponse
+    }
+    PUT: {
+      params: { id: OcrProviderId }
+      body: ReplaceOcrProviderRequest
+      response: ReplaceOcrProviderResponse
+    }
+    DELETE: {
+      params: { id: OcrProviderId }
+      response: void
+    }
+  }
 }
 
 /**

packages/shared/data/preference/preferenceSchemas.ts

@@ -351,6 +351,8 @@ export interface PreferenceSchemas {
     'feature.translate.model_prompt': string
     // redux/settings/targetLanguage
     'feature.translate.target_language': string
+    // redux/ocr/imageProviderId
+    'ocr.settings.image_provider_id': string | null
     // redux/shortcuts/shortcuts.exit_fullscreen
     'shortcut.app.exit_fullscreen': Record<string, unknown>
     // redux/shortcuts/shortcuts.search_message
@@ -612,6 +614,7 @@ export const DefaultPreferences: PreferenceSchemas = {
     'feature.selection.trigger_mode': PreferenceTypes.SelectionTriggerMode.Selected,
     'feature.translate.model_prompt': TRANSLATE_PROMPT,
     'feature.translate.target_language': 'en-us',
+    'ocr.settings.image_provider_id': null,
     'shortcut.app.exit_fullscreen': { editable: false, enabled: true, key: ['Escape'], system: true },
     'shortcut.app.search_message': {
       editable: true,

packages/shared/utils/index.ts

@@ -0,0 +1,2 @@
+export * from './json'
+export * from './net'

packages/shared/utils/json.ts

@@ -0,0 +1,7 @@
+export function safeParseJson(text: string): unknown | null {
+  try {
+    return JSON.parse(text)
+  } catch {
+    return null
+  }
+}

packages/ui/src/components/index.ts

@@ -87,3 +87,5 @@ export * from './primitives/dialog'
 export * from './primitives/popover'
 export * from './primitives/radioGroup'
 export * from './primitives/shadcn-io/dropzone'
+export * from './primitives/shadcn-io/skeleton'
+export * from './primitives/shadcn-io/tabs'

packages/ui/src/components/primitives/shadcn-io/skeleton/index.tsx

@@ -0,0 +1,7 @@
+import { cn } from '@cherrystudio/ui/utils'
+
+function Skeleton({ className, ...props }: React.ComponentProps<'div'>) {
+  return <div data-slot="skeleton" className={cn('bg-accent animate-pulse rounded-md', className)} {...props} />
+}
+
+export { Skeleton }

packages/ui/src/components/primitives/shadcn-io/tabs/index.tsx

@@ -0,0 +1,39 @@
+import { cn } from '@cherrystudio/ui/utils'
+import * as TabsPrimitive from '@radix-ui/react-tabs'
+import * as React from 'react'
+
+function Tabs({ className, ...props }: React.ComponentProps<typeof TabsPrimitive.Root>) {
+  return <TabsPrimitive.Root data-slot="tabs" className={cn('flex flex-col gap-2', className)} {...props} />
+}
+
+function TabsList({ className, ...props }: React.ComponentProps<typeof TabsPrimitive.List>) {
+  return (
+    <TabsPrimitive.List
+      data-slot="tabs-list"
+      className={cn(
+        'bg-muted text-muted-foreground inline-flex h-9 w-fit items-center justify-center rounded-lg p-[3px]',
+        className
+      )}
+      {...props}
+    />
+  )
+}
+
+function TabsTrigger({ className, ...props }: React.ComponentProps<typeof TabsPrimitive.Trigger>) {
+  return (
+    <TabsPrimitive.Trigger
+      data-slot="tabs-trigger"
+      className={cn(
+        "data-[state=active]:bg-background dark:data-[state=active]:text-foreground focus-visible:border-ring focus-visible:ring-ring/50 focus-visible:outline-ring dark:data-[state=active]:border-input dark:data-[state=active]:bg-input/30 text-foreground dark:text-muted-foreground inline-flex h-[calc(100%-1px)] flex-1 items-center justify-center gap-1.5 rounded-md border border-transparent px-2 py-1 text-sm font-medium whitespace-nowrap transition-[color,box-shadow] focus-visible:ring-[3px] focus-visible:outline-1 disabled:pointer-events-none disabled:opacity-50 data-[state=active]:shadow-sm [&_svg]:pointer-events-none [&_svg]:shrink-0 [&_svg:not([class*='size-'])]:size-4",
+        className
+      )}
+      {...props}
+    />
+  )
+}
+
+function TabsContent({ className, ...props }: React.ComponentProps<typeof TabsPrimitive.Content>) {
+  return <TabsPrimitive.Content data-slot="tabs-content" className={cn('flex-1 outline-none', className)} {...props} />
+}
+
+export { Tabs, TabsContent, TabsList, TabsTrigger }

scripts/auto-translate-i18n.ts

@@ -48,7 +48,7 @@ Usage Instructions:
    - pt-pt (Portuguese)
 
 Run Command:
-yarn i18n:auto
+yarn auto:i18n
 
 Performance Optimization Recommendations:
 - For stable API services: MAX_CONCURRENT_TRANSLATIONS=8, TRANSLATION_DELAY_MS=50
@@ -257,6 +257,7 @@ const main = async () => {
   validateConfig()
 
   const localesDir = path.join(__dirname, '../src/renderer/src/i18n/locales')
+  const translateDir = path.join(__dirname, '../src/renderer/src/i18n/translate')
   const baseLocale = process.env.TRANSLATION_BASE_LOCALE ?? 'en-us'
   const baseFileName = `${baseLocale}.json`
   const baseLocalePath = path.join(__dirname, '../src/renderer/src/i18n/locales', baseFileName)
@@ -271,16 +272,19 @@ const main = async () => {
   console.log('')
 
   // Process files using ES6+ array methods
-  const files = fs
-    .readdirSync(localesDir)
-    .filter((file) => {
-      const filename = file.replace('.json', '')
-      return file.endsWith('.json') && file !== baseFileName && !SCRIPT_CONFIG.SKIP_LANGUAGES.includes(filename)
-    })
-    .map((filename) => path.join(localesDir, filename))
+  const getFiles = (dir: string) =>
+    fs
+      .readdirSync(dir)
+      .filter((file) => {
+        const filename = file.replace('.json', '')
+        return file.endsWith('.json') && file !== baseFileName && !SCRIPT_CONFIG.SKIP_LANGUAGES.includes(filename)
+      })
+      .map((filename) => path.join(dir, filename))
+  const localeFiles = getFiles(localesDir)
+  const translateFiles = getFiles(translateDir)
+  const files = [...localeFiles, ...translateFiles]
 
   console.info(`📂 Base Locale: ${baseLocale}`)
-
   console.info('📂 Files to translate:')
   files.forEach((filePath) => {
     const filename = path.basename(filePath, '.json')

scripts/before-pack.js

@@ -4,9 +4,9 @@ const { downloadNpmPackage } = require('./utils')
 // if you want to add new prebuild binaries packages with different architectures, you can add them here
 // please add to allX64 and allArm64 from yarn.lock
 const allArm64 = {
-  '@img/sharp-darwin-arm64': '0.34.3',
-  '@img/sharp-win32-arm64': '0.34.3',
-  '@img/sharp-linux-arm64': '0.34.3',
+  '@img/sharp-darwin-arm64': '0.34.4',
+  '@img/sharp-win32-arm64': '0.34.4',
+  '@img/sharp-linux-arm64': '0.34.4',
 
   '@img/sharp-libvips-darwin-arm64': '1.2.0',
   '@img/sharp-libvips-linux-arm64': '1.2.0',
@@ -20,9 +20,9 @@ const allArm64 = {
 }
 
 const allX64 = {
-  '@img/sharp-darwin-x64': '0.34.3',
-  '@img/sharp-linux-x64': '0.34.3',
-  '@img/sharp-win32-x64': '0.34.3',
+  '@img/sharp-darwin-x64': '0.34.4',
+  '@img/sharp-linux-x64': '0.34.4',
+  '@img/sharp-win32-x64': '0.34.4',
 
   '@img/sharp-libvips-darwin-x64': '1.2.0',
   '@img/sharp-libvips-linux-x64': '1.2.0',

scripts/check-i18n.ts

@@ -4,7 +4,7 @@ import * as path from 'path'
 import { sortedObjectByKeys } from './sort'
 
 const translationsDir = path.join(__dirname, '../src/renderer/src/i18n/locales')
-const baseLocale = process.env.BASE_LOCALE ?? 'en-us'
+const baseLocale = process.env.BASE_LOCALE ?? 'zh-cn'
 const baseFileName = `${baseLocale}.json`
 const baseFilePath = path.join(translationsDir, baseFileName)
 
@@ -12,41 +12,39 @@ type I18NValue = string | { [key: string]: I18NValue }
 type I18N = { [key: string]: I18NValue }
 
 /**
- * Recursively check and synchronize the key-value structure of target object with template object
- * 1. If target object is missing keys from template object, throw error
- * 2. If target object has keys that don't exist in template object, throw error
- * 3. For nested objects, recursively perform synchronization operation
+ * 递归检查并同步目标对象与模板对象的键值结构
+ * 1. 如果目标对象缺少模板对象中的键，抛出错误
+ * 2. 如果目标对象存在模板对象中不存在的键，抛出错误
+ * 3. 对于嵌套对象，递归执行同步操作
  *
- * This function ensures all translation files maintain completely consistent key-value structure
- * with the base template (usually the base translation file).
- * Any structural differences will cause errors to be thrown for timely detection and fixing
- * of translation file issues.
+ * 该函数用于确保所有翻译文件与基准模板（通常是中文翻译文件）保持完全一致的键值结构。
+ * 任何结构上的差异都会导致错误被抛出，以便及时发现和修复翻译文件中的问题。
  *
- * @param target The target translation object to check
- * @param template The template object used as base (usually the base translation file)
- * @throws {Error} Thrown when key-value structure mismatch is found
+ * @param target 需要检查的目标翻译对象
+ * @param template 作为基准的模板对象（通常是中文翻译文件）
+ * @throws {Error} 当发现键值结构不匹配时抛出错误
  */
 function checkRecursively(target: I18N, template: I18N): void {
   for (const key in template) {
     if (!(key in target)) {
-      throw new Error(`Missing property ${key}`)
+      throw new Error(`缺少属性 ${key}`)
     }
     if (key.includes('.')) {
-      throw new Error(`Should use strict nested structure for key ${key}`)
+      throw new Error(`应该使用严格嵌套结构 ${key}`)
     }
     if (typeof template[key] === 'object' && template[key] !== null) {
       if (typeof target[key] !== 'object' || target[key] === null) {
-        throw new Error(`Property ${key} is not an object`)
+        throw new Error(`属性 ${key} 不是对象`)
       }
-      // Recursively check child objects
+      // 递归检查子对象
       checkRecursively(target[key], template[key])
     }
   }
 
-  // Remove keys that exist in target but not in template
+  // 删除 target 中存在但 template 中没有的 key
   for (const targetKey in target) {
     if (!(targetKey in template)) {
-      throw new Error(`Extra property ${targetKey}`)
+      throw new Error(`多余属性 ${targetKey}`)
     }
   }
 }
@@ -58,9 +56,9 @@ function isSortedI18N(obj: I18N): boolean {
 }
 
 /**
- * Check for duplicate keys in JSON object and collect all duplicate keys
- * @param obj The object to check
- * @returns Array of duplicate keys (returns empty array if no duplicates)
+ * 检查 JSON 对象中是否存在重复键，并收集所有重复键
+ * @param obj 要检查的对象
+ * @returns 返回重复键的数组（若无重复则返回空数组）
  */
 function checkDuplicateKeys(obj: I18N): string[] {
   const keys = new Set<string>()
@@ -71,7 +69,7 @@ function checkDuplicateKeys(obj: I18N): string[] {
       const fullPath = path ? `${path}.${key}` : key
 
       if (keys.has(fullPath)) {
-        // When duplicate key is found, add to array (avoid duplicate additions)
+        // 发现重复键时，添加到数组中（避免重复添加）
         if (!duplicateKeys.includes(fullPath)) {
           duplicateKeys.push(fullPath)
         }
@@ -79,7 +77,7 @@ function checkDuplicateKeys(obj: I18N): string[] {
         keys.add(fullPath)
       }
 
-      // Recursively check child objects
+      // 递归检查子对象
       if (typeof obj[key] === 'object' && obj[key] !== null) {
         checkObject(obj[key], fullPath)
       }
@@ -92,7 +90,7 @@ function checkDuplicateKeys(obj: I18N): string[] {
 
 function checkTranslations() {
   if (!fs.existsSync(baseFilePath)) {
-    throw new Error(`Base template file ${baseFileName} does not exist, please check path or filename`)
+    throw new Error(`主模板文件 ${baseFileName} 不存在，请检查路径或文件名`)
   }
 
   const baseContent = fs.readFileSync(baseFilePath, 'utf-8')
@@ -100,23 +98,23 @@ function checkTranslations() {
   try {
     baseJson = JSON.parse(baseContent)
   } catch (error) {
-    throw new Error(`Error parsing ${baseFileName}. ${error}`)
+    throw new Error(`解析 ${baseFileName} 出错。${error}`)
   }
 
-  // Check if base template has duplicate keys
+  // 检查主模板是否存在重复键
   const duplicateKeys = checkDuplicateKeys(baseJson)
   if (duplicateKeys.length > 0) {
-    throw new Error(`Base template file ${baseFileName} has the following duplicate keys:\n${duplicateKeys.join('\n')}`)
+    throw new Error(`主模板文件 ${baseFileName} 存在以下重复键：\n${duplicateKeys.join('\n')}`)
   }
 
-  // Check if base template is sorted
+  // 检查主模板是否有序
   if (!isSortedI18N(baseJson)) {
-    throw new Error(`Base template file ${baseFileName} keys are not sorted in dictionary order.`)
+    throw new Error(`主模板文件 ${baseFileName} 的键值未按字典序排序。`)
   }
 
   const files = fs.readdirSync(translationsDir).filter((file) => file.endsWith('.json') && file !== baseFileName)
 
-  // Sync keys
+  // 同步键
   for (const file of files) {
     const filePath = path.join(translationsDir, file)
     let targetJson: I18N = {}
@@ -124,19 +122,19 @@ function checkTranslations() {
       const fileContent = fs.readFileSync(filePath, 'utf-8')
       targetJson = JSON.parse(fileContent)
     } catch (error) {
-      throw new Error(`Error parsing ${file}.`)
+      throw new Error(`解析 ${file} 出错。`)
     }
 
-    // Check if sorted
+    // 检查有序性
     if (!isSortedI18N(targetJson)) {
-      throw new Error(`Translation file ${file} keys are not sorted.`)
+      throw new Error(`翻译文件 ${file} 的键值未按字典序排序。`)
     }
 
     try {
       checkRecursively(targetJson, baseJson)
     } catch (e) {
       console.error(e)
-      throw new Error(`Error while checking ${filePath}`)
+      throw new Error(`在检查 ${filePath} 时出错`)
     }
   }
 }
@@ -144,10 +142,10 @@ function checkTranslations() {
 export function main() {
   try {
     checkTranslations()
-    console.log('i18n check passed')
+    console.log('i18n 检查已通过')
   } catch (e) {
     console.error(e)
-    throw new Error(`Check failed. Try running yarn i18n:sync to fix the issue.`)
+    throw new Error(`检查未通过。尝试运行 yarn sync:i18n 以解决问题。`)
   }
 }
 

scripts/sort.ts

@@ -1,27 +1,34 @@
+// https://github.com/Gudahtt/prettier-plugin-sort-json/blob/main/src/index.ts
 /**
- * Natural sort function for strings, meant to be used as the sort
+ * Lexical sort function for strings, meant to be used as the sort
  * function for `Array.prototype.sort`.
  *
  * @param a - First element to compare.
  * @param b - Second element to compare.
  * @returns A number indicating which element should come first.
  */
-function naturalSort(a: string, b: string): number {
-  return a.localeCompare(b, undefined, { numeric: true, sensitivity: 'base' })
+function lexicalSort(a: string, b: string): number {
+  if (a > b) {
+    return 1
+  }
+  if (a < b) {
+    return -1
+  }
+  return 0
 }
 
 /**
- * Sort object keys in dictionary order (supports nested objects)
- * @param obj The object to be sorted
- * @returns A new object with sorted keys
+ * 对对象的键按照字典序进行排序（支持嵌套对象）
+ * @param obj 需要排序的对象
+ * @returns 返回排序后的新对象
  */
 export function sortedObjectByKeys(obj: object): object {
-  const sortedKeys = Object.keys(obj).sort(naturalSort)
+  const sortedKeys = Object.keys(obj).sort(lexicalSort)
 
   const sortedObj = {}
   for (const key of sortedKeys) {
     let value = obj[key]
-    // If the value is an object, sort it recursively
+    // 如果值是对象，递归排序
     if (typeof value === 'object' && value !== null && !Array.isArray(value)) {
       value = sortedObjectByKeys(value)
     }

scripts/update-i18n.ts

@@ -0,0 +1,147 @@
+/**
+ * 使用 OpenAI 兼容的模型生成 i18n 文本，并更新到 translate 目录
+ *
+ * API_KEY=sk-xxxx BASE_URL=xxxx MODEL=xxxx ts-node scripts/update-i18n.ts
+ */
+
+import OpenAI from '@cherrystudio/openai'
+import cliProgress from 'cli-progress'
+import fs from 'fs'
+
+type I18NValue = string | { [key: string]: I18NValue }
+type I18N = { [key: string]: I18NValue }
+
+const API_KEY = process.env.API_KEY
+const BASE_URL = process.env.BASE_URL || 'https://dashscope.aliyuncs.com/compatible-mode/v1/'
+const MODEL = process.env.MODEL || 'qwen-plus-latest'
+
+const INDEX = [
+  // 语言的名称代码用来翻译的模型
+  { name: 'France', code: 'fr-fr', model: MODEL },
+  { name: 'Spanish', code: 'es-es', model: MODEL },
+  { name: 'Portuguese', code: 'pt-pt', model: MODEL },
+  { name: 'Greek', code: 'el-gr', model: MODEL }
+]
+
+const zh = JSON.parse(fs.readFileSync('src/renderer/src/i18n/locales/zh-cn.json', 'utf8')) as I18N
+
+const openai = new OpenAI({
+  apiKey: API_KEY,
+  baseURL: BASE_URL
+})
+
+// 递归遍历翻译
+async function translate(baseObj: I18N, targetObj: I18N, targetLang: string, model: string, updateFile) {
+  const toTranslateTexts: { [key: string]: string } = {}
+  for (const key in baseObj) {
+    if (typeof baseObj[key] == 'object') {
+      // 遍历下一层
+      if (!targetObj[key] || typeof targetObj[key] != 'object') targetObj[key] = {}
+      await translate(baseObj[key], targetObj[key], targetLang, model, updateFile)
+    } else if (
+      !targetObj[key] ||
+      typeof targetObj[key] != 'string' ||
+      (typeof targetObj[key] === 'string' && targetObj[key].startsWith('[to be translated]'))
+    ) {
+      // 加入到本层待翻译列表
+      toTranslateTexts[key] = baseObj[key]
+    }
+  }
+  if (Object.keys(toTranslateTexts).length > 0) {
+    const completion = await openai.chat.completions.create({
+      model: model,
+      response_format: { type: 'json_object' },
+      messages: [
+        {
+          role: 'user',
+          content: `
+You are a robot specifically designed for translation tasks. As a model that has been extensively fine-tuned on Russian language corpora, you are proficient in using the Russian language.
+Now, please output the translation based on the input content. The input will include both Chinese and English key values, and you should output the corresponding key values in the Russian language.
+When translating, ensure that no key value is omitted, and maintain the accuracy and fluency of the translation. Pay attention to the capitalization rules in the output to match the source text, and especially pay attention to whether to capitalize the first letter of each word except for prepositions. For strings containing \`{{value}}\`, ensure that the format is not disrupted.
+Output in JSON.
+######################################################
+INPUT
+######################################################
+${JSON.stringify({
+  confirm: '确定要备份数据吗？',
+  select_model: '选择模型',
+  title: '文件',
+  deeply_thought: '已深度思考（用时 {{seconds}} 秒）'
+})}
+######################################################
+MAKE SURE TO OUTPUT IN Russian. DO NOT OUTPUT IN UNSPECIFIED LANGUAGE.
+######################################################
+                `
+        },
+        {
+          role: 'assistant',
+          content: JSON.stringify({
+            confirm: 'Подтвердите резервное копирование данных?',
+            select_model: 'Выберите Модель',
+            title: 'Файл',
+            deeply_thought: 'Глубоко продумано (заняло {{seconds}} секунд)'
+          })
+        },
+        {
+          role: 'user',
+          content: `
+You are a robot specifically designed for translation tasks. As a model that has been extensively fine-tuned on ${targetLang} language corpora, you are proficient in using the ${targetLang} language.
+Now, please output the translation based on the input content. The input will include both Chinese and English key values, and you should output the corresponding key values in the ${targetLang} language.
+When translating, ensure that no key value is omitted, and maintain the accuracy and fluency of the translation. Pay attention to the capitalization rules in the output to match the source text, and especially pay attention to whether to capitalize the first letter of each word except for prepositions. For strings containing \`{{value}}\`, ensure that the format is not disrupted.
+Output in JSON.
+######################################################
+INPUT
+######################################################
+${JSON.stringify(toTranslateTexts)}
+######################################################
+MAKE SURE TO OUTPUT IN ${targetLang}. DO NOT OUTPUT IN UNSPECIFIED LANGUAGE.
+######################################################
+                `
+        }
+      ]
+    })
+    // 添加翻译后的键值，并打印错译漏译内容
+    try {
+      const result = JSON.parse(completion.choices[0].message.content!)
+      // console.debug('result', result)
+      for (const e in toTranslateTexts) {
+        if (result[e] && typeof result[e] === 'string') {
+          targetObj[e] = result[e]
+        } else {
+          console.warn(`missing value "${e}" in ${targetLang} translation`)
+        }
+      }
+    } catch (e) {
+      console.error(e)
+      for (const e in toTranslateTexts) {
+        console.warn(`missing value "${e}" in ${targetLang} translation`)
+      }
+    }
+  }
+  // 删除多余的键值
+  for (const e in targetObj) {
+    if (!baseObj[e]) {
+      delete targetObj[e]
+    }
+  }
+  // 更新文件
+  updateFile()
+}
+
+let count = 0
+
+;(async () => {
+  const bar = new cliProgress.SingleBar({}, cliProgress.Presets.shades_classic)
+  bar.start(INDEX.length, 0)
+  for (const { name, code, model } of INDEX) {
+    const obj = fs.existsSync(`src/renderer/src/i18n/translate/${code}.json`)
+      ? (JSON.parse(fs.readFileSync(`src/renderer/src/i18n/translate/${code}.json`, 'utf8')) as I18N)
+      : {}
+    await translate(zh, obj, name, model, () => {
+      fs.writeFileSync(`src/renderer/src/i18n/translate/${code}.json`, JSON.stringify(obj, null, 2), 'utf8')
+    })
+    count += 1
+    bar.update(count)
+  }
+  bar.stop()
+})()

src/main/data/api/handlers/index.ts

@@ -5,6 +5,7 @@
  * TypeScript will error if any endpoint is missing.
  */
 
+import { ocrService } from '@main/services/ocr/OcrService'
 import type { ApiImplementation } from '@shared/data/api/apiSchemas'
 
 import { TestService } from '../services/TestService'
@@ -12,6 +13,7 @@ import { TestService } from '../services/TestService'
 // Service instances
 const testService = TestService.getInstance()
 
+// Defining all handlers here feels a bit bloated; perhaps we should modularize things?
 /**
  * Complete API handlers implementation
  * Must implement every path+method combination from ApiSchemas
@@ -207,5 +209,40 @@ export const apiHandlers: ApiImplementation = {
         data: { executed: true, timestamp: new Date().toISOString() }
       }))
     }
+  },
+
+  '/ocr/providers': {
+    GET: async ({ query }) => {
+      const result = await ocrService.listProviders(query)
+      return { data: result }
+    },
+    POST: async ({ body }) => {
+      const result = await ocrService.createProvider(body)
+      return { data: result }
+    }
+  },
+
+  '/ocr/providers/:id': {
+    GET: async ({ params }) => {
+      const result = await ocrService.getProvider(params.id)
+      return { data: result }
+    },
+    PATCH: async ({ params, body }) => {
+      if (params.id !== body.id) {
+        throw new Error('Provider ID in path does not match ID in body')
+      }
+      const result = await ocrService.updateProvider(params.id, body)
+      return { data: result }
+    },
+    PUT: async ({ params, body }) => {
+      if (params.id !== body.id) {
+        throw new Error('Provider ID in path does not match ID in body')
+      }
+      const result = await ocrService.replaceProvider(body)
+      return { data: result }
+    },
+    DELETE: async ({ params }) => {
+      return ocrService.deleteProvider(params.id)
+    }
   }
 }

src/main/data/api/services/IBaseService.ts

@@ -3,6 +3,9 @@ import type { PaginationParams, ServiceOptions } from '@shared/data/api/apiTypes
 /**
  * Standard service interface for data operations
  * Defines the contract that all services should implement
+ * @template T - Type of the entity returned by service methods
+ * @template TCreate - Type of the data required to create a new entity
+ * @template TUpdate - Type of the data required to update an existing entity
  */
 export interface IBaseService<T = any, TCreate = any, TUpdate = any> {
   /**

src/main/data/api/services/OcrProviderService.ts

@@ -0,0 +1,299 @@
+import { loggerService } from '@logger'
+import { dbService } from '@main/data/db/DbService'
+import { ocrProviderTable } from '@main/data/db/schemas/ocrProvider'
+import type { PaginationParams, ServiceOptions } from '@shared/data/api/apiTypes'
+import type { DbOcrProvider, DbOcrProviderCreate, DbOcrProviderReplace, DbOcrProviderUpdate } from '@types'
+import { BuiltinOcrProviderIds, isDbOcrProvider } from '@types'
+import dayjs from 'dayjs'
+import { eq } from 'drizzle-orm'
+import { merge } from 'lodash'
+
+import type { IBaseService } from './IBaseService'
+
+const logger = loggerService.withContext('OcrProviderService')
+
+/**
+ * Service layer for OCR providers
+ * Implements the standard service interface and handles all OCR provider operations
+ * NOTE: Not completely finished since data architecture is not completely designed and implemented.
+ *       It's a early version.
+ */
+export class OcrProviderService implements IBaseService<DbOcrProvider, DbOcrProviderCreate, DbOcrProviderUpdate> {
+  /**
+   * Find OCR provider by ID
+   */
+  async findById(id: string, _options?: ServiceOptions): Promise<DbOcrProvider | null> {
+    try {
+      const providers = await dbService
+        .getDb()
+        .select()
+        .from(ocrProviderTable)
+        .where(eq(ocrProviderTable.id, id))
+        .limit(1)
+
+      if (providers.length === 0) {
+        logger.warn(`OCR provider ${id} not found`)
+        return null
+      }
+
+      logger.debug(`Retrieved OCR provider: ${id}`)
+      return providers[0]
+    } catch (error) {
+      logger.error(`Failed to find OCR provider ${id}`, error as Error)
+      throw error
+    }
+  }
+
+  /**
+   * Find multiple OCR providers with pagination
+   */
+  async findMany(
+    params: PaginationParams & Record<string, any>,
+    _options?: ServiceOptions
+  ): Promise<{
+    items: DbOcrProvider[]
+    total: number
+    hasNext?: boolean
+    nextCursor?: string
+  }> {
+    try {
+      const { page = 1, limit = 20, cursor } = params
+
+      let providers = await dbService.getDb().select().from(ocrProviderTable)
+
+      // Apply filters if provided
+      if (params.registered) {
+        // This filter would need access to the OCR service registry
+        // For now, we'll return all providers and let the service layer filter
+        logger.debug('Registered filter requested - returning all providers for service layer filtering')
+      }
+
+      const total = providers.length
+
+      // Apply pagination
+      if (cursor) {
+        // Cursor-based pagination
+        const index = providers.findIndex((p) => p.id === cursor)
+        if (index !== -1) {
+          providers = providers.slice(index + 1, index + 1 + limit)
+        }
+      } else {
+        // Offset-based pagination
+        const startIndex = (page - 1) * limit
+        providers = providers.slice(startIndex, startIndex + limit)
+      }
+
+      const hasNext =
+        providers.length === limit && (cursor ? providers[providers.length - 1] !== undefined : page * limit < total)
+
+      logger.debug(`Retrieved ${providers.length} OCR providers`, { total, page, limit })
+
+      return {
+        items: providers,
+        total,
+        hasNext,
+        nextCursor: hasNext && providers.length > 0 ? providers[providers.length - 1].id : undefined
+      }
+    } catch (error) {
+      logger.error('Failed to find OCR providers', error as Error)
+      throw error
+    }
+  }
+
+  /**
+   * Create new OCR provider
+   */
+  async create(data: DbOcrProviderCreate, _options?: ServiceOptions): Promise<DbOcrProvider> {
+    try {
+      // Check if provider already exists
+      const existing = await this.findById(data.id)
+      if (existing) {
+        throw new Error(`OCR provider ${data.id} already exists`)
+      }
+
+      const timestamp = dayjs().valueOf()
+      const newProvider = {
+        ...data,
+        createdAt: timestamp,
+        updatedAt: timestamp
+      } satisfies DbOcrProvider
+
+      // Validate data structure
+      if (!isDbOcrProvider(newProvider)) {
+        throw new Error('Invalid OCR provider data')
+      }
+
+      const [created] = await dbService.getDb().insert(ocrProviderTable).values(newProvider).returning()
+
+      logger.info(`Created OCR provider: ${data.id}`)
+      return created
+    } catch (error) {
+      logger.error(`Failed to create OCR provider ${data.id}`, error as Error)
+      throw error
+    }
+  }
+
+  /**
+   * Update existing OCR provider
+   */
+  async update(id: string, data: DbOcrProviderUpdate, _options?: ServiceOptions): Promise<DbOcrProvider> {
+    try {
+      const existing = await this.findById(id)
+      if (!existing) {
+        throw new Error(`OCR provider ${id} not found`)
+      }
+
+      const newProvider = {
+        ...merge({}, existing, data),
+        updatedAt: dayjs().valueOf()
+      } satisfies DbOcrProvider
+
+      // Validate data structure
+      if (!isDbOcrProvider(newProvider)) {
+        throw new Error('Invalid OCR provider data')
+      }
+
+      const [updated] = await dbService
+        .getDb()
+        .update(ocrProviderTable)
+        .set(newProvider)
+        .where(eq(ocrProviderTable.id, id))
+        .returning()
+
+      logger.info(`Updated OCR provider: ${id}`)
+      return updated
+    } catch (error) {
+      logger.error(`Failed to update OCR provider ${id}`, error as Error)
+      throw error
+    }
+  }
+
+  /**
+   * Delete OCR provider
+   */
+  async delete(id: string, _options?: ServiceOptions): Promise<void> {
+    try {
+      // Check if it's a built-in provider
+      if (BuiltinOcrProviderIds.some((pid) => pid === id)) {
+        throw new Error('Built-in OCR providers cannot be deleted.')
+      }
+
+      // Check if provider exists
+      const existing = await this.findById(id)
+      if (!existing) {
+        throw new Error(`OCR provider ${id} not found`)
+      }
+
+      await dbService.getDb().delete(ocrProviderTable).where(eq(ocrProviderTable.id, id))
+
+      logger.info(`Deleted OCR provider: ${id}`)
+    } catch (error) {
+      logger.error(`Failed to delete OCR provider ${id}`, error as Error)
+      throw error
+    }
+  }
+
+  /**
+   * Check if OCR provider exists
+   */
+  async exists(id: string, _options?: ServiceOptions): Promise<boolean> {
+    try {
+      const provider = await this.findById(id)
+      return provider !== null
+    } catch (error) {
+      logger.error(`Failed to check if OCR provider ${id} exists`, error as Error)
+      throw error
+    }
+  }
+
+  /**
+   * Replace OCR provider (full update)
+   * This method is specific to OCR providers and not part of IBaseService
+   */
+  async replace(data: DbOcrProviderReplace): Promise<DbOcrProvider> {
+    try {
+      // Check if it's a built-in provider
+      if (BuiltinOcrProviderIds.some((pid) => pid === data.id)) {
+        throw new Error('Built-in OCR providers cannot be modified with PUT method.')
+      }
+
+      const timestamp = dayjs().valueOf()
+      const existing = await this.exists(data.id)
+
+      let newProvider: DbOcrProvider
+
+      if (existing) {
+        // Update existing
+        const current = await this.findById(data.id)
+        if (!current) {
+          throw new Error(`OCR provider ${data.id} not found during replace operation`)
+        }
+        newProvider = {
+          ...data,
+          updatedAt: timestamp,
+          createdAt: current.createdAt
+        }
+      } else {
+        // Create new
+        newProvider = {
+          ...data,
+          createdAt: timestamp,
+          updatedAt: timestamp
+        }
+      }
+
+      // Validate data structure
+      if (!isDbOcrProvider(newProvider)) {
+        throw new Error('Invalid OCR provider data')
+      }
+
+      const [saved] = await dbService
+        .getDb()
+        .insert(ocrProviderTable)
+        .values(newProvider)
+        .onConflictDoUpdate({
+          target: ocrProviderTable.id,
+          set: newProvider
+        })
+        .returning()
+
+      logger.info(`Replaced OCR provider: ${data.id}`)
+      return saved
+    } catch (error) {
+      logger.error(`Failed to replace OCR provider ${data.id}`, error as Error)
+      throw error
+    }
+  }
+
+  /**
+   * Initialize built-in providers in database
+   * This method is specific to OCR providers and not part of IBaseService
+   */
+  async initializeBuiltInProviders(): Promise<void> {
+    try {
+      // Import built-in provider configurations
+      const { BUILTIN_OCR_PROVIDERS } = await import('@shared/config/ocr')
+
+      logger.info('Initializing built-in OCR providers')
+
+      // Check and create each built-in provider if it doesn't exist
+      for (const provider of BUILTIN_OCR_PROVIDERS) {
+        const exists = await this.exists(provider.id)
+        if (!exists) {
+          logger.info(`Creating built-in OCR provider: ${provider.id}`)
+          await this.create(provider)
+        } else {
+          logger.debug(`Built-in OCR provider already exists: ${provider.id}`)
+        }
+      }
+
+      logger.info(`Initialized ${BUILTIN_OCR_PROVIDERS.length} built-in OCR providers`)
+    } catch (error) {
+      logger.error('Failed to initialize built-in OCR providers', error as Error)
+      throw error
+    }
+  }
+}
+
+// Export singleton instance
+export const ocrProviderService = new OcrProviderService()

src/main/data/db/schemas/ocrProvider.ts

@@ -0,0 +1,49 @@
+import type { OcrProviderCapabilityRecord, OcrProviderConfig } from '@types'
+import { index, sqliteTable, text } from 'drizzle-orm/sqlite-core'
+
+import { createUpdateTimestamps } from './columnHelpers'
+
+export const ocrProviderTable = sqliteTable(
+  'ocr_provider',
+  {
+    /**
+     * Unique identifier for the provider.
+     * For built-in providers, it's 'tesseract', 'system', etc.
+     * For custom providers, it can be any unique string (we typically use UUID v4).
+     * As the primary key, it ensures the uniqueness of each provider.
+     */
+    id: text('id').primaryKey(),
+
+    /**
+     * Display name of the provider, e.g., "Tesseract OCR".
+     * For built-in providers, this value is used internally and is not exposed to users; the display name shown in the UI is locale-based by i18n.
+     * Cannot be null.
+     */
+    name: text('name').notNull(),
+
+    /**
+     * Object describing the provider's capabilities, e.g., { image: true }.
+     * Stored as JSON in a text column. Drizzle's `mode: 'json'` handles
+     * serialization and deserialization automatically. `$type` provides strong typing.
+     * Cannot be null; should store an empty object `{}` even if no specific capabilities.
+     */
+    capabilities: text('capabilities', { mode: 'json' }).$type<OcrProviderCapabilityRecord>().notNull(),
+
+    /**
+     * Provider-specific configuration. This is a polymorphic field, its structure varies by provider type.
+     * For example, Tesseract's configuration is entirely different from PaddleOCR's.
+     * Storing it as JSON is the most flexible approach to accommodate any configuration structure.
+     * Since this is a polymorphic field, both frontend and backend must validate
+     * that the structure matches the expected schema for the corresponding provider type
+     * before saving.
+     */
+    config: text('config', { mode: 'json' }).$type<OcrProviderConfig>().notNull(),
+
+    /** Unix timestamp (milliseconds since epoch) for creation and last update. */
+    ...createUpdateTimestamps
+  },
+  (t) => [index('name').on(t.name)]
+)
+
+export type OcrProviderInsert = typeof ocrProviderTable.$inferInsert
+export type OcrProviderSelect = typeof ocrProviderTable.$inferSelect

src/main/data/migrate/dataRefactor/migrators/PreferencesMappings.ts

@@ -8,6 +8,8 @@
  * === AUTO-GENERATED CONTENT START ===
  */
 
+import type { PreferenceSchemas } from '@shared/data/preference/preferenceSchemas'
+
 /**
  * ElectronStore映射关系 - 简单一层结构
  *
@@ -252,6 +254,8 @@ export const REDUX_STORE_MAPPINGS = {
     },
     {
       originalKey: 'mathEngine',
+      // TODO
+      // @ts-expect-error check how to fix it later
       targetKey: 'chat.message.math_engine'
     },
     {
@@ -336,6 +340,8 @@ export const REDUX_STORE_MAPPINGS = {
     },
     {
       originalKey: 'topicNamingPrompt',
+      // TODO
+      // @ts-expect-error check how to fix it later
       targetKey: 'topic.naming.prompt'
     },
     {
@@ -664,6 +670,8 @@ export const REDUX_STORE_MAPPINGS = {
     },
     {
       originalKey: 'nutstoreSyncState',
+      // TODO
+      // @ts-expect-error check how to fix it later
       targetKey: 'data.backup.nutstore.sync_state'
     },
     {
@@ -736,8 +744,17 @@ export const REDUX_STORE_MAPPINGS = {
       originalKey: 'shortcuts.exit_fullscreen',
       targetKey: 'shortcut.app.exit_fullscreen'
     }
+  ],
+  ocr: [
+    {
+      originalKey: 'ocr.imageProviderId',
+      targetKey: 'ocr.settings.image_provider_id'
+    }
   ]
-} as const
+} as const satisfies Record<
+  string,
+  Array<{ originalKey: string; targetKey: keyof PreferenceSchemas[keyof PreferenceSchemas] }>
+>
 
 // === AUTO-GENERATED CONTENT END ===
 

src/main/data/repositories/OcrProviderRepository.ts

@@ -0,0 +1,256 @@
+import { dbService } from '@data/db/DbService'
+import { ocrProviderTable } from '@data/db/schemas/ocrProvider'
+import { loggerService } from '@logger'
+import type {
+  DbOcrProvider,
+  DbOcrProviderCreate,
+  DbOcrProviderReplace,
+  DbOcrProviderUpdate,
+  OcrProviderId
+} from '@types'
+import { BuiltinOcrProviderIds, isDbOcrProvider } from '@types'
+import dayjs from 'dayjs'
+import { eq } from 'drizzle-orm'
+import { merge } from 'lodash'
+
+const logger = loggerService.withContext('OcrProviderRepository')
+
+/**
+ * Data access layer for OCR providers
+ * Handles all database operations and data validation
+ *
+ * TODO: This class is already functional, but the data interaction service should be
+ *       migrated to src/main/data/api/services.
+ *
+ *       The reason why the migration hasn't been completed yet is that the data
+ *       architecture is still under development, and we need to wait until the
+ *       architectural design is finalized before proceeding with the migration.
+ */
+export class OcrProviderRepository {
+  /**
+   * Get all OCR providers
+   */
+  public async findAll(): Promise<DbOcrProvider[]> {
+    try {
+      const providers = await dbService.getDb().select().from(ocrProviderTable)
+
+      return providers
+    } catch (error) {
+      logger.error('Failed to find all OCR providers', error as Error)
+      throw error
+    }
+  }
+
+  /**
+   * Get OCR provider by ID
+   */
+  public async findById(id: OcrProviderId): Promise<DbOcrProvider> {
+    try {
+      const providers = await dbService
+        .getDb()
+        .select()
+        .from(ocrProviderTable)
+        .where(eq(ocrProviderTable.id, id))
+        .limit(1)
+
+      if (providers.length === 0) {
+        throw new Error(`OCR provider ${id} not found`)
+      }
+
+      return providers[0]
+    } catch (error) {
+      logger.error(`Failed to find OCR provider ${id}`, error as Error)
+      throw error
+    }
+  }
+
+  /**
+   * Check if provider exists
+   */
+  public async exists(id: OcrProviderId): Promise<boolean> {
+    try {
+      const providers = await dbService
+        .getDb()
+        .select({ id: ocrProviderTable.id })
+        .from(ocrProviderTable)
+        .where(eq(ocrProviderTable.id, id))
+        .limit(1)
+
+      return providers.length > 0
+    } catch (error) {
+      logger.error(`Failed to check if OCR provider ${id} exists`, error as Error)
+      throw error
+    }
+  }
+
+  /**
+   * Create new OCR provider
+   */
+  public async create(param: DbOcrProviderCreate): Promise<DbOcrProvider> {
+    try {
+      // Check if provider already exists
+      if (await this.exists(param.id)) {
+        throw new Error(`OCR provider ${param.id} already exists`)
+      }
+
+      const timestamp = dayjs().valueOf()
+      const newProvider = {
+        ...param,
+        createdAt: timestamp,
+        updatedAt: timestamp
+      } satisfies DbOcrProvider
+
+      // Validate data structure
+      if (!isDbOcrProvider(newProvider)) {
+        throw new Error('Invalid OCR provider data')
+      }
+
+      const [created] = await dbService.getDb().insert(ocrProviderTable).values(newProvider).returning()
+
+      logger.info(`Created OCR provider: ${param.id}`)
+      return created
+    } catch (error) {
+      logger.error(`Failed to create OCR provider ${param.id}`, error as Error)
+      throw error
+    }
+  }
+
+  /**
+   * Update OCR provider (partial update)
+   */
+  public async update(id: OcrProviderId, update: DbOcrProviderUpdate): Promise<DbOcrProvider> {
+    try {
+      const existing = await this.findById(id)
+
+      const newProvider = {
+        ...merge({}, existing, update),
+        updatedAt: dayjs().valueOf()
+      } satisfies DbOcrProvider
+
+      // Validate data structure
+      if (!isDbOcrProvider(newProvider)) {
+        throw new Error('Invalid OCR provider data')
+      }
+
+      const [updated] = await dbService
+        .getDb()
+        .update(ocrProviderTable)
+        .set(newProvider)
+        .where(eq(ocrProviderTable.id, id))
+        .returning()
+
+      logger.info(`Updated OCR provider: ${id}`)
+      return updated
+    } catch (error) {
+      logger.error(`Failed to update OCR provider ${id}`, error as Error)
+      throw error
+    }
+  }
+
+  /**
+   * Replace OCR provider (full update)
+   */
+  public async replace(data: DbOcrProviderReplace): Promise<DbOcrProvider> {
+    try {
+      // Check if it's a built-in provider
+      if (BuiltinOcrProviderIds.some((pid) => pid === data.id)) {
+        throw new Error('Built-in OCR providers cannot be modified with PUT method.')
+      }
+
+      const timestamp = dayjs().valueOf()
+      const existing = await this.exists(data.id)
+
+      let newProvider: DbOcrProvider
+
+      if (existing) {
+        // Update existing
+        const current = await this.findById(data.id)
+        newProvider = {
+          ...data,
+          updatedAt: timestamp,
+          createdAt: current.createdAt
+        }
+      } else {
+        // Create new
+        newProvider = {
+          ...data,
+          createdAt: timestamp,
+          updatedAt: timestamp
+        }
+      }
+
+      // Validate data structure
+      if (!isDbOcrProvider(newProvider)) {
+        throw new Error('Invalid OCR provider data')
+      }
+
+      const [saved] = await dbService
+        .getDb()
+        .insert(ocrProviderTable)
+        .values(newProvider)
+        .onConflictDoUpdate({
+          target: ocrProviderTable.id,
+          set: newProvider
+        })
+        .returning()
+
+      logger.info(`Replaced OCR provider: ${data.id}`)
+      return saved
+    } catch (error) {
+      logger.error(`Failed to replace OCR provider ${data.id}`, error as Error)
+      throw error
+    }
+  }
+
+  /**
+   * Delete OCR provider
+   */
+  public async delete(id: OcrProviderId): Promise<void> {
+    try {
+      // Check if it's a built-in provider
+      if (BuiltinOcrProviderIds.some((pid) => pid === id)) {
+        throw new Error('Built-in OCR providers cannot be deleted.')
+      }
+
+      // Check if provider exists
+      await this.findById(id)
+
+      await dbService.getDb().delete(ocrProviderTable).where(eq(ocrProviderTable.id, id))
+
+      logger.info(`Deleted OCR provider: ${id}`)
+    } catch (error) {
+      logger.error(`Failed to delete OCR provider ${id}`, error as Error)
+      throw error
+    }
+  }
+
+  /**
+   * Initialize built-in providers in database
+   */
+  public async initializeBuiltInProviders(): Promise<void> {
+    try {
+      // Import built-in provider configurations
+      const { BUILTIN_OCR_PROVIDERS } = await import('@shared/config/ocr')
+
+      logger.info('Initializing built-in OCR providers')
+
+      // Check and create each built-in provider if it doesn't exist
+      for (const provider of BUILTIN_OCR_PROVIDERS) {
+        const exists = await this.exists(provider.id)
+        if (!exists) {
+          logger.info(`Creating built-in OCR provider: ${provider.id}`)
+          await this.create(provider)
+        } else {
+          logger.debug(`Built-in OCR provider already exists: ${provider.id}`)
+        }
+      }
+
+      logger.info(`Initialized ${BUILTIN_OCR_PROVIDERS.length} built-in OCR providers`)
+    } catch (error) {
+      logger.error('Failed to initialize built-in OCR providers', error as Error)
+      throw error
+    }
+  }
+}
+
+export const ocrProviderRepository = new OcrProviderRepository()

src/main/index.ts

@@ -36,8 +36,6 @@ import { dataRefactorMigrateService } from './data/migrate/dataRefactor/DataRefa
 import { dataApiService } from '@data/DataApiService'
 import { cacheService } from '@data/CacheService'
 import { initWebviewHotkeys } from './services/WebviewService'
-import { i18n } from './utils/language'
-import { defaultLanguage } from '@shared/config/constant'
 
 const logger = loggerService.withContext('MainEntry')
 
@@ -171,22 +169,6 @@ if (!app.requestSingleInstanceLock()) {
 
     await preferenceService.initialize()
 
-    const userLanguage = preferenceService.get('app.language')
-    if (userLanguage) {
-      i18n.changeLanguage(userLanguage)
-      // Do not care about cleanup because it spans the whole lifecyle of the app
-      preferenceService.subscribeChange('app.language', (newLang) => {
-        if (newLang) {
-          i18n.changeLanguage(newLang)
-        } else {
-          logger.error('New langauge is null, skip.')
-        }
-      })
-    } else {
-      logger.error('No user language preference found, falling back to default language')
-      i18n.changeLanguage(defaultLanguage)
-    }
-
     // Initialize DataApiService
     await dataApiService.initialize()
 

src/main/ipc.ts

@@ -18,7 +18,7 @@ import type {
   AgentPersistedMessage,
   FileMetadata,
   Notification,
-  OcrProvider,
+  OcrParams,
   Provider,
   Shortcut,
   SupportedOcrFile
@@ -875,10 +875,7 @@ export function registerIpc(mainWindow: BrowserWindow, app: Electron.App) {
   )
 
   // OCR
-  ipcMain.handle(IpcChannel.OCR_ocr, (_, file: SupportedOcrFile, provider: OcrProvider) =>
-    ocrService.ocr(file, provider)
-  )
-  ipcMain.handle(IpcChannel.OCR_ListProviders, () => ocrService.listProviderIds())
+  ipcMain.handle(IpcChannel.OCR_Ocr, (_, file: SupportedOcrFile, params: OcrParams) => ocrService.ocr(file, params))
 
   // OVMS
   ipcMain.handle(IpcChannel.Ovms_AddModel, (_, modelName: string, modelId: string, modelSource: string, task: string) =>

src/main/services/ContextMenu.ts

@@ -1,4 +1,4 @@
-import { t } from '@main/utils/language'
+import { getI18n } from '@main/utils/language'
 import type { MenuItemConstructorOptions } from 'electron'
 import { Menu } from 'electron'
 
@@ -26,10 +26,12 @@ class ContextMenu {
   }
 
   private createInspectMenuItems(w: Electron.WebContents): MenuItemConstructorOptions[] {
+    const i18n = getI18n()
+    const { common } = i18n.translation
     const template: MenuItemConstructorOptions[] = [
       {
         id: 'inspect',
-        label: t('common.inspect'),
+        label: common.inspect,
         click: () => {
           w.toggleDevTools()
         },
@@ -41,27 +43,29 @@ class ContextMenu {
   }
 
   private createEditMenuItems(properties: Electron.ContextMenuParams): MenuItemConstructorOptions[] {
+    const i18n = getI18n()
+    const { common } = i18n.translation
     const hasText = properties.selectionText.trim().length > 0
     const can = (type: string) => properties.editFlags[`can${type}`] && hasText
 
     const template: MenuItemConstructorOptions[] = [
       {
         id: 'copy',
-        label: t('common.copy'),
+        label: common.copy,
         role: 'copy',
         enabled: can('Copy'),
         visible: properties.isEditable || hasText
       },
       {
         id: 'paste',
-        label: t('common.paste'),
+        label: common.paste,
         role: 'paste',
         enabled: properties.editFlags.canPaste,
         visible: properties.isEditable
       },
       {
         id: 'cut',
-        label: t('common.cut'),
+        label: common.cut,
         role: 'cut',
         enabled: can('Cut'),
         visible: properties.isEditable

src/main/services/TrayService.ts

@@ -1,6 +1,6 @@
 import { preferenceService } from '@data/PreferenceService'
 import { isLinux, isMac, isWin } from '@main/constant'
-import { t } from '@main/utils/language'
+import { getI18n } from '@main/utils/language'
 import type { MenuItemConstructorOptions } from 'electron'
 import { app, Menu, nativeImage, nativeTheme, Tray } from 'electron'
 
@@ -72,20 +72,23 @@ export class TrayService {
   }
 
   private updateContextMenu() {
+    const i18n = getI18n()
+    const { tray: trayLocale, selection: selectionLocale } = i18n.translation
+
     const quickAssistantEnabled = preferenceService.get('feature.quick_assistant.enabled')
     const selectionAssistantEnabled = preferenceService.get('feature.selection.enabled')
 
     const template = [
       {
-        label: t('tray.show_window'),
+        label: trayLocale.show_window,
         click: () => windowService.showMainWindow()
       },
       quickAssistantEnabled && {
-        label: t('tray.show_mini_window'),
+        label: trayLocale.show_mini_window,
         click: () => windowService.showMiniWindow()
       },
       (isWin || isMac) && {
-        label: t('selection.name') + (selectionAssistantEnabled ? ' - On' : ' - Off'),
+        label: selectionLocale.name + (selectionAssistantEnabled ? ' - On' : ' - Off'),
         click: () => {
           if (selectionService) {
             selectionService.toggleEnabled()
@@ -95,7 +98,7 @@ export class TrayService {
       },
       { type: 'separator' },
       {
-        label: t('tray.quit'),
+        label: trayLocale.quit,
         click: () => this.quit()
       }
     ].filter(Boolean) as MenuItemConstructorOptions[]

src/main/services/ocr/OcrService.ts

@@ -1,8 +1,21 @@
 import { loggerService } from '@logger'
-import { isLinux } from '@main/constant'
-import type { OcrHandler, OcrProvider, OcrResult, SupportedOcrFile } from '@types'
-import { BuiltinOcrProviderIds } from '@types'
+import { ocrProviderRepository } from '@main/data/repositories/OcrProviderRepository'
+import type {
+  DbOcrProvider,
+  ListOcrProvidersQuery,
+  OcrParams,
+  OcrProvider,
+  OcrProviderBusiness,
+  OcrProviderCreateBusiness,
+  OcrProviderKeyBusiness,
+  OcrProviderReplaceBusiness,
+  OcrProviderUpdateBusiness,
+  OcrResult,
+  SupportedOcrFile
+} from '@types'
+import { BuiltinOcrProviderIdMap } from '@types'
 
+import type { OcrBaseService } from './builtin/OcrBaseService'
 import { ovOcrService } from './builtin/OvOcrService'
 import { ppocrService } from './builtin/PpocrService'
 import { systemOcrService } from './builtin/SystemOcrService'
@@ -10,40 +23,285 @@ import { tesseractService } from './builtin/TesseractService'
 
 const logger = loggerService.withContext('OcrService')
 
-export class OcrService {
-  private registry: Map<string, OcrHandler> = new Map()
+/**
+ * Business logic layer for OCR operations
+ * Handles OCR provider registration, orchestration, and core OCR functionality
+ */
+class OcrService {
+  private registry: Map<OcrProviderKeyBusiness, OcrBaseService> = new Map()
+  private initialized: boolean = false
 
-  register(providerId: string, handler: OcrHandler): void {
-    if (this.registry.has(providerId)) {
-      logger.warn(`Provider ${providerId} has existing handler. Overwrited.`)
+  constructor() {
+    this.registerBuiltinProviders()
+  }
+
+  /**
+   * Ensure the service is initialized
+   */
+  private async ensureInitialized(): Promise<void> {
+    if (!this.initialized) {
+      await this.initializeBuiltinProviders()
+      this.initialized = true
     }
-    this.registry.set(providerId, handler)
   }
 
-  unregister(providerId: string): void {
-    this.registry.delete(providerId)
+  /**
+   * Initialize built-in OCR providers
+   */
+  private async initializeBuiltinProviders(): Promise<void> {
+    try {
+      // Ensure built-in providers exist in database
+      await ocrProviderRepository.initializeBuiltInProviders()
+
+      logger.info('OCR service initialized with built-in providers')
+    } catch (error) {
+      logger.error('Failed to initialize OCR service', error as Error)
+      throw error
+    }
   }
 
-  public listProviderIds(): string[] {
+  /**
+   * Register built-in providers (sync)
+   */
+  private registerBuiltinProviders(): void {
+    this.register(BuiltinOcrProviderIdMap.tesseract, tesseractService)
+
+    if (systemOcrService) {
+      this.register(BuiltinOcrProviderIdMap.system, systemOcrService)
+    }
+
+    this.register(BuiltinOcrProviderIdMap.paddleocr, ppocrService)
+
+    if (ovOcrService) {
+      this.register(BuiltinOcrProviderIdMap.ovocr, ovOcrService)
+    }
+  }
+
+  /**
+   * Register an OCR provider service
+   */
+  private register(providerId: OcrProviderKeyBusiness, service: OcrBaseService): void {
+    if (this.registry.has(providerId)) {
+      logger.warn(`Provider ${providerId} already registered. Overwriting.`)
+    }
+    this.registry.set(providerId, service)
+    logger.info(`Registered OCR provider: ${providerId}`)
+  }
+
+  // Not sure when it will be needed.
+  /**
+   * Unregister an OCR provider service
+   */
+  // private unregister(providerId: OcrProviderId): void {
+  //   if (this.registry.delete(providerId)) {
+  //     logger.info(`Unregistered OCR provider: ${providerId}`)
+  //   }
+  // }
+
+  /**
+   * Get all registered provider IDs
+   */
+  public getRegisteredProviderIds(): OcrProviderKeyBusiness[] {
     return Array.from(this.registry.keys())
   }
 
-  public async ocr(file: SupportedOcrFile, provider: OcrProvider): Promise<OcrResult> {
-    const handler = this.registry.get(provider.id)
-    if (!handler) {
-      throw new Error(`Provider ${provider.id} is not registered`)
+  /**
+   * Check if a provider is registered
+   */
+  public isProviderRegistered(providerId: OcrProviderKeyBusiness): boolean {
+    return this.registry.has(providerId)
+  }
+
+  /**
+   * Get list of OCR providers
+   */
+  public async listProviders(query?: ListOcrProvidersQuery): Promise<OcrProviderBusiness[]> {
+    try {
+      await this.ensureInitialized()
+      const providers = await ocrProviderRepository.findAll()
+
+      let result = providers
+      if (query?.registered) {
+        // Filter by registered providers
+        const registeredIds = this.getRegisteredProviderIds()
+        result = providers.filter((provider) => registeredIds.includes(provider.id))
+      }
+
+      logger.debug(`Listed ${result.length} OCR providers`)
+      return result
+    } catch (error) {
+      logger.error('Failed to list OCR providers', error as Error)
+      throw error
     }
-    return handler(file, provider.config)
+  }
+
+  /**
+   * Get OCR provider by ID
+   */
+  public async getProvider(providerId: OcrProviderKeyBusiness): Promise<OcrProviderBusiness> {
+    try {
+      await this.ensureInitialized()
+      const provider = await ocrProviderRepository.findById(providerId)
+      logger.debug(`Retrieved OCR provider: ${providerId}`)
+      return provider
+    } catch (error) {
+      logger.error(`Failed to get OCR provider ${providerId}`, error as Error)
+      throw error
+    }
+  }
+
+  /**
+   * Create new OCR provider
+   */
+  public async createProvider(data: OcrProviderCreateBusiness): Promise<OcrProviderBusiness> {
+    try {
+      await this.ensureInitialized()
+      const result = await ocrProviderRepository.create(data)
+      logger.info(`Created OCR provider: ${data.id}`)
+      return result
+    } catch (error) {
+      logger.error(`Failed to create OCR provider ${data.id}`, error as Error)
+      throw error
+    }
+  }
+
+  /**
+   * Update OCR provider (partial update)
+   */
+  public async updateProvider(
+    id: OcrProviderKeyBusiness,
+    data: OcrProviderUpdateBusiness
+  ): Promise<OcrProviderBusiness> {
+    try {
+      await this.ensureInitialized()
+      const result = await ocrProviderRepository.update(id, data)
+      logger.info(`Updated OCR provider: ${id}`)
+      return result
+    } catch (error) {
+      logger.error(`Failed to update OCR provider ${id}`, error as Error)
+      throw error
+    }
+  }
+
+  /**
+   * Replace OCR provider (full update)
+   */
+  public async replaceProvider(data: OcrProviderReplaceBusiness): Promise<OcrProviderBusiness> {
+    try {
+      await this.ensureInitialized()
+      const result = await ocrProviderRepository.replace(data)
+      logger.info(`Replaced OCR provider: ${data.id}`)
+      return result
+    } catch (error) {
+      logger.error(`Failed to replace OCR provider ${data.id}`, error as Error)
+      throw error
+    }
+  }
+
+  /**
+   * Delete OCR provider
+   */
+  public async deleteProvider(id: OcrProviderKeyBusiness): Promise<void> {
+    try {
+      await this.ensureInitialized()
+      await ocrProviderRepository.delete(id)
+      logger.info(`Deleted OCR provider: ${id}`)
+    } catch (error) {
+      logger.error(`Failed to delete OCR provider ${id}`, error as Error)
+      throw error
+    }
+  }
+
+  /**
+   * Perform OCR on a file using the specified provider
+   */
+  public async ocr(file: SupportedOcrFile, params: OcrParams): Promise<OcrResult> {
+    try {
+      await this.ensureInitialized()
+      const service = this.registry.get(params.providerId)
+      if (!service) {
+        throw new Error(`Provider ${params.providerId} is not registered`)
+      }
+
+      // Validate that the provider exists in database
+      const provider = await this.getProvider(params.providerId)
+
+      logger.debug(`Performing OCR with provider: ${JSON.stringify(provider, undefined, 2)}`)
+      const result = await service.ocr(file, provider.config)
+
+      logger.info(`OCR completed successfully with provider: ${params.providerId}`)
+      return result
+    } catch (error) {
+      logger.error(`OCR failed with provider ${params.providerId}`, error as Error)
+      throw error
+    }
+  }
+
+  /**
+   * Check if a provider is available and ready
+   */
+  public async isProviderAvailable(providerId: OcrProviderKeyBusiness): Promise<boolean> {
+    try {
+      const service = this.registry.get(providerId)
+      if (!service) {
+        return false
+      }
+
+      // Check if provider exists in database
+      await this.getProvider(providerId)
+
+      // Additional availability checks can be added here
+      return true
+    } catch (error) {
+      logger.debug(`Provider ${providerId} is not available`, error as Error)
+      return false
+    }
+  }
+
+  private async _isProviderAvailable(provider: OcrProvider): Promise<boolean> {
+    try {
+      return this.registry.get(provider.id) !== undefined
+    } catch (error) {
+      logger.debug(`Provider ${provider.id} is not available`, error as Error)
+      return false
+    }
+  }
+
+  /**
+   * Get available providers
+   * It's only for image type. May re-designed for a specific file type in the future.
+   *
+   */
+  public async getAvailableProvidersForFile(): Promise<DbOcrProvider[]> {
+    try {
+      const providers = await this.listProviders()
+
+      // Filter providers that can handle the file type
+      // This logic can be extended based on file type and provider capabilities
+      const availableProviders: DbOcrProvider[] = []
+      const capFilter = (provider: OcrProvider) => provider.capabilities.image
+
+      for (const provider of providers.filter(capFilter)) {
+        if (await this._isProviderAvailable(provider)) {
+          availableProviders.push(provider)
+        }
+      }
+
+      logger.debug(`Found ${availableProviders.length} available providers for file`)
+      return availableProviders
+    } catch (error) {
+      logger.error('Failed to get available providers for file', error as Error)
+      throw error
+    }
+  }
+
+  /**
+   * Cleanup resources
+   */
+  public dispose(): void {
+    this.registry.clear()
+    logger.info('OCR service disposed')
   }
 }
 
 export const ocrService = new OcrService()
-
-// Register built-in providers
-ocrService.register(BuiltinOcrProviderIds.tesseract, tesseractService.ocr.bind(tesseractService))
-
-!isLinux && ocrService.register(BuiltinOcrProviderIds.system, systemOcrService.ocr.bind(systemOcrService))
-
-ocrService.register(BuiltinOcrProviderIds.paddleocr, ppocrService.ocr.bind(ppocrService))
-
-ovOcrService.isAvailable() && ocrService.register(BuiltinOcrProviderIds.ovocr, ovOcrService.ocr.bind(ovOcrService))

src/main/services/ocr/builtin/OvOcrService.ts

@@ -1,7 +1,7 @@
 import { loggerService } from '@logger'
 import { isWin } from '@main/constant'
-import type { OcrOvConfig, OcrResult, SupportedOcrFile } from '@types'
-import { isImageFileMetadata } from '@types'
+import type { OcrOvConfig, OcrProviderConfig, OcrResult, SupportedOcrFile } from '@types'
+import { isImageFileMetadata, isOcrOvConfig } from '@types'
 import { exec } from 'child_process'
 import * as fs from 'fs'
 import * as os from 'os'
@@ -15,20 +15,17 @@ const execAsync = promisify(exec)
 
 const PATH_BAT_FILE = path.join(os.homedir(), '.cherrystudio', 'ovms', 'ovocr', 'run.npu.bat')
 
+const isOvAvailable =
+  isWin &&
+  os.cpus()[0].model.toLowerCase().includes('intel') &&
+  os.cpus()[0].model.toLowerCase().includes('ultra') &&
+  fs.existsSync(PATH_BAT_FILE)
+
 export class OvOcrService extends OcrBaseService {
   constructor() {
     super()
   }
 
-  public isAvailable(): boolean {
-    return (
-      isWin &&
-      os.cpus()[0].model.toLowerCase().includes('intel') &&
-      os.cpus()[0].model.toLowerCase().includes('ultra') &&
-      fs.existsSync(PATH_BAT_FILE)
-    )
-  }
-
   private getOvOcrPath(): string {
     return path.join(os.homedir(), '.cherrystudio', 'ovms', 'ovocr')
   }
@@ -81,8 +78,8 @@ export class OvOcrService extends OcrBaseService {
     }
   }
 
-  private async ocrImage(filePath: string, options?: OcrOvConfig): Promise<OcrResult> {
-    logger.info(`OV OCR called on ${filePath} with options ${JSON.stringify(options)}`)
+  private async ocrImage(filePath: string, config?: OcrOvConfig): Promise<OcrResult> {
+    logger.info(`OV OCR called on ${filePath} with options ${JSON.stringify(config)}`)
 
     try {
       // 1. Clear img directory and output directory
@@ -117,13 +114,16 @@ export class OvOcrService extends OcrBaseService {
     }
   }
 
-  public ocr = async (file: SupportedOcrFile, options?: OcrOvConfig): Promise<OcrResult> => {
+  public ocr = async (file: SupportedOcrFile, config?: OcrProviderConfig): Promise<OcrResult> => {
+    if (!isOcrOvConfig(config)) {
+      throw new Error('Invalid OCR OV config')
+    }
     if (isImageFileMetadata(file)) {
-      return this.ocrImage(file.path, options)
+      return this.ocrImage(file.path, config)
     } else {
       throw new Error('Unsupported file type, currently only image files are supported')
     }
   }
 }
 
-export const ovOcrService = new OvOcrService()
+export const ovOcrService = isOvAvailable ? new OvOcrService() : undefined

src/main/services/ocr/builtin/PpocrService.ts

@@ -1,6 +1,6 @@
 import { loadOcrImage } from '@main/utils/ocr'
 import type { ImageFileMetadata, OcrPpocrConfig, OcrResult, SupportedOcrFile } from '@types'
-import { isImageFileMetadata } from '@types'
+import { isImageFileMetadata, isOcrPpocrConfig } from '@types'
 import { net } from 'electron'
 import * as z from 'zod'
 
@@ -40,14 +40,17 @@ const OcrResponseSchema = z.object({
 })
 
 export class PpocrService extends OcrBaseService {
-  public ocr = async (file: SupportedOcrFile, options?: OcrPpocrConfig): Promise<OcrResult> => {
+  public ocr = async (file: SupportedOcrFile, config?: OcrPpocrConfig): Promise<OcrResult> => {
+    if (!isOcrPpocrConfig(config)) {
+      throw new Error('Invalid OCR config')
+    }
     if (!isImageFileMetadata(file)) {
       throw new Error('Only image files are supported currently')
     }
-    if (!options) {
+    if (!config) {
       throw new Error('config is required')
     }
-    return this.imageOcr(file, options)
+    return this.imageOcr(file, config)
   }
 
   private async imageOcr(file: ImageFileMetadata, options: OcrPpocrConfig): Promise<OcrResult> {

src/main/services/ocr/builtin/SystemOcrService.ts

@@ -1,8 +1,8 @@
 import { isLinux, isWin } from '@main/constant'
 import { loadOcrImage } from '@main/utils/ocr'
 import { OcrAccuracy, recognize } from '@napi-rs/system-ocr'
-import type { ImageFileMetadata, OcrResult, OcrSystemConfig, SupportedOcrFile } from '@types'
-import { isImageFileMetadata } from '@types'
+import type { ImageFileMetadata, OcrProviderConfig, OcrResult, OcrSystemConfig, SupportedOcrFile } from '@types'
+import { isImageFileMetadata, isOcrSystemConfig } from '@types'
 
 import { OcrBaseService } from './OcrBaseService'
 
@@ -12,23 +12,26 @@ export class SystemOcrService extends OcrBaseService {
     super()
   }
 
-  private async ocrImage(file: ImageFileMetadata, options?: OcrSystemConfig): Promise<OcrResult> {
+  private async ocrImage(file: ImageFileMetadata, config?: OcrSystemConfig): Promise<OcrResult> {
     if (isLinux) {
       return { text: '' }
     }
     const buffer = await loadOcrImage(file)
-    const langs = isWin ? options?.langs : undefined
+    const langs = isWin ? config?.langs : undefined
     const result = await recognize(buffer, OcrAccuracy.Accurate, langs)
     return { text: result.text }
   }
 
-  public ocr = async (file: SupportedOcrFile, options?: OcrSystemConfig): Promise<OcrResult> => {
+  public ocr = async (file: SupportedOcrFile, config?: OcrProviderConfig): Promise<OcrResult> => {
+    if (!isOcrSystemConfig(config)) {
+      throw new Error('Invalid OCR configuration')
+    }
     if (isImageFileMetadata(file)) {
-      return this.ocrImage(file, options)
+      return this.ocrImage(file, config)
     } else {
       throw new Error('Unsupported file type, currently only image files are supported')
     }
   }
 }
 
-export const systemOcrService = new SystemOcrService()
+export const systemOcrService = !isLinux ? new SystemOcrService() : undefined

src/main/services/ocr/builtin/TesseractService.ts

@@ -2,8 +2,8 @@ import { loggerService } from '@logger'
 import { getIpCountry } from '@main/utils/ipService'
 import { loadOcrImage } from '@main/utils/ocr'
 import { MB } from '@shared/config/constant'
-import type { ImageFileMetadata, OcrResult, OcrTesseractConfig, SupportedOcrFile } from '@types'
-import { isImageFileMetadata } from '@types'
+import type { ImageFileMetadata, OcrProviderConfig, OcrResult, OcrTesseractConfig, SupportedOcrFile } from '@types'
+import { isImageFileMetadata, isOcrTesseractConfig } from '@types'
 import { app } from 'electron'
 import fs from 'fs'
 import { isEqual } from 'lodash'
@@ -70,8 +70,8 @@ export class TesseractService extends OcrBaseService {
     return this.worker
   }
 
-  private async imageOcr(file: ImageFileMetadata, options?: OcrTesseractConfig): Promise<OcrResult> {
-    const worker = await this.getWorker(options)
+  private async imageOcr(file: ImageFileMetadata, config?: OcrTesseractConfig): Promise<OcrResult> {
+    const worker = await this.getWorker(config)
     const stat = await fs.promises.stat(file.path)
     if (stat.size > MB_SIZE_THRESHOLD * MB) {
       throw new Error(`This image is too large (max ${MB_SIZE_THRESHOLD}MB)`)
@@ -81,11 +81,14 @@ export class TesseractService extends OcrBaseService {
     return { text: result.data.text }
   }
 
-  public ocr = async (file: SupportedOcrFile, options?: OcrTesseractConfig): Promise<OcrResult> => {
+  public ocr = async (file: SupportedOcrFile, config?: OcrProviderConfig): Promise<OcrResult> => {
+    if (!isOcrTesseractConfig(config)) {
+      throw new Error('Invalid Tesseract config')
+    }
     if (!isImageFileMetadata(file)) {
       throw new Error('Only image files are supported currently')
     }
-    return this.imageOcr(file, options)
+    return this.imageOcr(file, config)
   }
 
   private async _getLangPath(): Promise<string> {

src/main/utils/language.ts

@@ -1,57 +1,33 @@
 import { preferenceService } from '@data/PreferenceService'
-import { loggerService } from '@logger'
 import { defaultLanguage } from '@shared/config/constant'
 import type { LanguageVarious } from '@shared/data/preference/preferenceTypes'
 import { app } from 'electron'
-import i18n from 'i18next'
 
-import enUS from '../../renderer/src/i18n/locales/en-us.json'
-import zhCN from '../../renderer/src/i18n/locales/zh-cn.json'
-import zhTW from '../../renderer/src/i18n/locales/zh-tw.json'
-// import deDE from '../../renderer/src/i18n/locales/de-de.json'
-// import elGR from '../../renderer/src/i18n/locales/el-gr.json'
-// import esES from '../../renderer/src/i18n/locales/es-es.json'
-// import frFR from '../../renderer/src/i18n/locales/fr-fr.json'
-// import JaJP from '../../renderer/src/i18n/locales/ja-jp.json'
-// import ptPT from '../../renderer/src/i18n/locales/pt-pt.json'
-// import RuRu from '../../renderer/src/i18n/locales/ru-ru.json'
+import EnUs from '../../renderer/src/i18n/locales/en-us.json'
+import ZhCn from '../../renderer/src/i18n/locales/zh-cn.json'
+import ZhTw from '../../renderer/src/i18n/locales/zh-tw.json'
+// Machine translation
 import deDE from '../../renderer/src/i18n/translate/de-de.json'
 import elGR from '../../renderer/src/i18n/translate/el-gr.json'
 import esES from '../../renderer/src/i18n/translate/es-es.json'
 import frFR from '../../renderer/src/i18n/translate/fr-fr.json'
-import jaJP from '../../renderer/src/i18n/translate/ja-jp.json'
+import JaJP from '../../renderer/src/i18n/translate/ja-jp.json'
 import ptPT from '../../renderer/src/i18n/translate/pt-pt.json'
-import ruRU from '../../renderer/src/i18n/translate/ru-ru.json'
+import RuRu from '../../renderer/src/i18n/translate/ru-ru.json'
 
-const logger = loggerService.withContext('main:i18n')
-
-// const resources = Object.fromEntries([
-//   ['en-US', enUS],
-//   ['zh-CN', zhCN],
-//   ['zh-TW', zhTW],
-//   ['de-DE', deDE],
-//   ['el-GR', elGR],
-//   ['es-ES', esES],
-//   ['fr-FR', frFR],
-//   ['ja-JP', jaJP],
-//   ['pt-PT', ptPT],
-//   ['ru-RU', ruRU]
-// ] as const)
-const resources = Object.fromEntries(
-  (
-    [
-      ['en-US', enUS],
-      ['zh-CN', zhCN],
-      ['zh-TW', zhTW],
-      ['de-DE', deDE],
-      ['el-GR', elGR],
-      ['es-ES', esES],
-      ['fr-FR', frFR],
-      ['ja-JP', jaJP],
-      ['pt-PT', ptPT],
-      ['ru-RU', ruRU]
-    ] as const
-  ).map(([key, translation]) => [key, { translation }])
+export const locales = Object.fromEntries(
+  [
+    ['en-US', EnUs],
+    ['zh-CN', ZhCn],
+    ['zh-TW', ZhTw],
+    ['ja-JP', JaJP],
+    ['ru-RU', RuRu],
+    ['de-DE', deDE],
+    ['el-GR', elGR],
+    ['es-ES', esES],
+    ['fr-FR', frFR],
+    ['pt-PT', ptPT]
+  ].map(([locale, translation]) => [locale, { translation }])
 )
 
 export const getAppLanguage = (): LanguageVarious => {
@@ -62,44 +38,10 @@ export const getAppLanguage = (): LanguageVarious => {
     return language
   }
 
-  return (Object.keys(resources).includes(appLocale) ? appLocale : defaultLanguage) as LanguageVarious
+  return (Object.keys(locales).includes(appLocale) ? appLocale : defaultLanguage) as LanguageVarious
 }
 
 export const getI18n = (): Record<string, any> => {
   const language = getAppLanguage()
-  return resources[language]
+  return locales[language]
 }
-
-let t: (key: string) => string = () => {
-  logger.error('i18n not inialized')
-  return ''
-}
-
-let changeLang: (lang: LanguageVarious) => void = () => {
-  logger.error('i18n not inialized')
-}
-
-i18n
-  .init({
-    resources,
-    lng: getAppLanguage(),
-    fallbackLng: defaultLanguage,
-    ns: 'translation',
-    interpolation: {
-      escapeValue: false
-    },
-    saveMissing: true,
-    missingKeyHandler: (_1, _2, key) => {
-      logger.error(`Missing key: ${key}`)
-    }
-  })
-  .then((tfn) => {
-    changeLang = (lang: LanguageVarious) => {
-      i18n.changeLanguage(lang)
-    }
-    t = (key: string) => tfn(key)
-    const lng = getAppLanguage()
-    logger.debug('i18n context', { lng, resource: resources[lng] })
-  })
-
-export { changeLang, i18n, t }

src/preload/index.ts

@@ -12,7 +12,7 @@ import type {
 } from '@shared/data/preference/preferenceTypes'
 import type { UpgradeChannel } from '@shared/data/preference/preferenceTypes'
 import { IpcChannel } from '@shared/IpcChannel'
-import type { Notification } from '@types'
+import type { Notification, OcrParams } from '@types'
 import type {
   AddMemoryOptions,
   AssistantMessage,
@@ -27,7 +27,6 @@ import type {
   MemoryConfig,
   MemoryListOptions,
   MemorySearchOptions,
-  OcrProvider,
   OcrResult,
   Provider,
   RestartApiServerStatusResult,
@@ -476,9 +475,8 @@ const api = {
       ipcRenderer.invoke(IpcChannel.CodeTools_RemoveCustomTerminalPath, terminalId)
   },
   ocr: {
-    ocr: (file: SupportedOcrFile, provider: OcrProvider): Promise<OcrResult> =>
-      ipcRenderer.invoke(IpcChannel.OCR_ocr, file, provider),
-    listProviders: (): Promise<string[]> => ipcRenderer.invoke(IpcChannel.OCR_ListProviders)
+    ocr: (file: SupportedOcrFile, params: OcrParams): Promise<OcrResult> =>
+      ipcRenderer.invoke(IpcChannel.OCR_Ocr, file, params)
   },
   cherryai: {
     generateSignature: (params: { method: string; path: string; query: string; body: Record<string, any> }) =>

src/renderer/src/components/S3BackupManager.tsx

@@ -3,7 +3,7 @@ import { Button, Tooltip } from '@cherrystudio/ui'
 import { restoreFromS3 } from '@renderer/services/BackupService'
 import type { S3Config } from '@renderer/types'
 import { formatFileSize } from '@renderer/utils'
-import { Modal, Space, Table } from 'antd'
+import { Modal, Table } from 'antd'
 import dayjs from 'dayjs'
 import { useCallback, useEffect, useState } from 'react'
 import { useTranslation } from 'react-i18next'

src/renderer/src/config/ocr.ts

@@ -1,182 +1 @@
-import type {
-  BuiltinOcrProvider,
-  BuiltinOcrProviderId,
-  OcrOvProvider,
-  OcrPpocrProvider,
-  OcrProviderCapability,
-  OcrSystemProvider,
-  OcrTesseractProvider,
-  TesseractLangCode,
-  TranslateLanguageCode
-} from '@renderer/types'
-
-import { isMac, isWin } from './constant'
-
-const tesseract: OcrTesseractProvider = {
-  id: 'tesseract',
-  name: 'Tesseract',
-  capabilities: {
-    image: true
-  },
-  config: {
-    langs: {
-      chi_sim: true,
-      chi_tra: true,
-      eng: true
-    }
-  }
-} as const
-
-const systemOcr: OcrSystemProvider = {
-  id: 'system',
-  name: 'System',
-  config: {
-    langs: isWin ? ['en-us'] : undefined
-  },
-  capabilities: {
-    image: true
-    // pdf: true
-  }
-} as const satisfies OcrSystemProvider
-
-const ppocrOcr: OcrPpocrProvider = {
-  id: 'paddleocr',
-  name: 'PaddleOCR',
-  config: {
-    apiUrl: ''
-  },
-  capabilities: {
-    image: true
-    // pdf: true
-  }
-} as const
-
-const ovOcr: OcrOvProvider = {
-  id: 'ovocr',
-  name: 'Intel OV(NPU) OCR',
-  config: {
-    langs: isWin ? ['en-us', 'zh-cn'] : undefined
-  },
-  capabilities: {
-    image: true
-    // pdf: true
-  }
-} as const satisfies OcrOvProvider
-
-export const BUILTIN_OCR_PROVIDERS_MAP = {
-  tesseract,
-  system: systemOcr,
-  paddleocr: ppocrOcr,
-  ovocr: ovOcr
-} as const satisfies Record<BuiltinOcrProviderId, BuiltinOcrProvider>
-
-export const BUILTIN_OCR_PROVIDERS: BuiltinOcrProvider[] = Object.values(BUILTIN_OCR_PROVIDERS_MAP)
-
-export const DEFAULT_OCR_PROVIDER = {
-  image: isWin || isMac ? systemOcr : tesseract
-} as const satisfies Record<OcrProviderCapability, BuiltinOcrProvider>
-
-export const TESSERACT_LANG_MAP: Record<TranslateLanguageCode, TesseractLangCode> = {
-  'af-za': 'afr',
-  'am-et': 'amh',
-  'ar-sa': 'ara',
-  'as-in': 'asm',
-  'az-az': 'aze',
-  'az-cyrl-az': 'aze_cyrl',
-  'be-by': 'bel',
-  'bn-bd': 'ben',
-  'bo-cn': 'bod',
-  'bs-ba': 'bos',
-  'bg-bg': 'bul',
-  'ca-es': 'cat',
-  'ceb-ph': 'ceb',
-  'cs-cz': 'ces',
-  'zh-cn': 'chi_sim',
-  'zh-tw': 'chi_tra',
-  'chr-us': 'chr',
-  'cy-gb': 'cym',
-  'da-dk': 'dan',
-  'de-de': 'deu',
-  'dz-bt': 'dzo',
-  'el-gr': 'ell',
-  'en-us': 'eng',
-  'enm-gb': 'enm',
-  'eo-world': 'epo',
-  'et-ee': 'est',
-  'eu-es': 'eus',
-  'fa-ir': 'fas',
-  'fi-fi': 'fin',
-  'fr-fr': 'fra',
-  'frk-de': 'frk',
-  'frm-fr': 'frm',
-  'ga-ie': 'gle',
-  'gl-es': 'glg',
-  'grc-gr': 'grc',
-  'gu-in': 'guj',
-  'ht-ht': 'hat',
-  'he-il': 'heb',
-  'hi-in': 'hin',
-  'hr-hr': 'hrv',
-  'hu-hu': 'hun',
-  'iu-ca': 'iku',
-  'id-id': 'ind',
-  'is-is': 'isl',
-  'it-it': 'ita',
-  'ita-it': 'ita_old',
-  'jv-id': 'jav',
-  'ja-jp': 'jpn',
-  'kn-in': 'kan',
-  'ka-ge': 'kat',
-  'kat-ge': 'kat_old',
-  'kk-kz': 'kaz',
-  'km-kh': 'khm',
-  'ky-kg': 'kir',
-  'ko-kr': 'kor',
-  'ku-tr': 'kur',
-  'la-la': 'lao',
-  'la-va': 'lat',
-  'lv-lv': 'lav',
-  'lt-lt': 'lit',
-  'ml-in': 'mal',
-  'mr-in': 'mar',
-  'mk-mk': 'mkd',
-  'mt-mt': 'mlt',
-  'ms-my': 'msa',
-  'my-mm': 'mya',
-  'ne-np': 'nep',
-  'nl-nl': 'nld',
-  'no-no': 'nor',
-  'or-in': 'ori',
-  'pa-in': 'pan',
-  'pl-pl': 'pol',
-  'pt-pt': 'por',
-  'ps-af': 'pus',
-  'ro-ro': 'ron',
-  'ru-ru': 'rus',
-  'sa-in': 'san',
-  'si-lk': 'sin',
-  'sk-sk': 'slk',
-  'sl-si': 'slv',
-  'es-es': 'spa',
-  'spa-es': 'spa_old',
-  'sq-al': 'sqi',
-  'sr-rs': 'srp',
-  'sr-latn-rs': 'srp_latn',
-  'sw-tz': 'swa',
-  'sv-se': 'swe',
-  'syr-sy': 'syr',
-  'ta-in': 'tam',
-  'te-in': 'tel',
-  'tg-tj': 'tgk',
-  'tl-ph': 'tgl',
-  'th-th': 'tha',
-  'ti-er': 'tir',
-  'tr-tr': 'tur',
-  'ug-cn': 'uig',
-  'uk-ua': 'ukr',
-  'ur-pk': 'urd',
-  'uz-uz': 'uzb',
-  'uz-cyrl-uz': 'uzb_cyrl',
-  'vi-vn': 'vie',
-  'yi-us': 'yid'
-}
+// All config are migrated to @shared/config/ocr

src/renderer/src/hooks/ocr/useOcr.ts

@@ -1,18 +1,21 @@
 import { loggerService } from '@logger'
 import * as OcrService from '@renderer/services/ocr/OcrService'
-import type { ImageFileMetadata, SupportedOcrFile } from '@renderer/types'
+import type { ImageFileMetadata, OcrProvider, SupportedOcrFile } from '@renderer/types'
 import { isImageFileMetadata } from '@renderer/types'
 import { formatErrorMessage } from '@renderer/utils/error'
 import { useCallback } from 'react'
 import { useTranslation } from 'react-i18next'
 
-import { useOcrProviders } from './useOcrProvider'
+import { useOcrImageProvider } from './useOcrImageProvider'
 
 const logger = loggerService.withContext('useOcr')
 
+const isProviderAvailable = (provider: OcrProvider | undefined | null): provider is OcrProvider =>
+  provider !== undefined
+
 export const useOcr = () => {
   const { t } = useTranslation()
-  const { imageProvider } = useOcrProviders()
+  const { imageProvider, imageProviderId } = useOcrImageProvider()
 
   /**
    * 对图片文件进行OCR识别
@@ -22,10 +25,16 @@ export const useOcr = () => {
    */
   const ocrImage = useCallback(
     async (image: ImageFileMetadata) => {
-      logger.debug('ocrImage', { config: imageProvider.config })
-      return OcrService.ocr(image, imageProvider)
+      if (isProviderAvailable(imageProvider)) {
+        logger.debug('ocrImage', { provider: imageProvider })
+        return OcrService.ocr(image, {
+          providerId: imageProvider.id
+        })
+      } else {
+        throw new Error(t('ocr.error.provider.not_availabel', { provider: imageProviderId }))
+      }
     },
-    [imageProvider]
+    [imageProvider, imageProviderId, t]
   )
 
   /**

src/renderer/src/hooks/ocr/useOcrImageProvider.ts

@@ -0,0 +1,9 @@
+import { usePreference } from '@data/hooks/usePreference'
+
+import { useOcrProvider } from './useOcrProvider'
+
+export const useOcrImageProvider = () => {
+  const [imageProviderId, setImageProviderId] = usePreference('ocr.settings.image_provider_id')
+  const { provider: imageProvider, mutating, loading, error, updateConfig } = useOcrProvider(imageProviderId)
+  return { imageProvider, loading, mutating, error, updateConfig, imageProviderId, setImageProviderId }
+}

src/renderer/src/hooks/ocr/useOcrProvider.ts

@@ -0,0 +1,37 @@
+import { useMutation, useQuery } from '@data/hooks/useDataApi'
+import type { OcrProviderConfig } from '@renderer/types'
+import { getErrorMessage } from '@renderer/utils'
+import type { ConcreteApiPaths } from '@shared/data/api'
+import { useCallback } from 'react'
+import { useTranslation } from 'react-i18next'
+
+// const logger = loggerService.withContext('useOcrProvider')
+
+export const useOcrProvider = (id: string | null) => {
+  const { t } = useTranslation()
+
+  const path: ConcreteApiPaths = `/ocr/providers/${id}`
+  const { data, loading, error } = useQuery(path)
+  const { mutate, loading: mutating } = useMutation('PATCH', path)
+
+  const updateConfig = useCallback(
+    async (update: Partial<OcrProviderConfig>) => {
+      if (!id) return
+      try {
+        await mutate({ body: { id, config: update } })
+      } catch (e) {
+        window.toast.error({ title: t('ocr.provider.config.patch.error.failed'), description: getErrorMessage(e) })
+      }
+    },
+    [id, mutate, t]
+  )
+
+  return {
+    /** undefined: loading; null: invalid, id is null */
+    provider: id ? data?.data : null,
+    loading,
+    mutating,
+    error,
+    updateConfig
+  }
+}

src/renderer/src/hooks/ocr/useOcrProviders.ts

@@ -0,0 +1,19 @@
+import { useQuery } from '@data/hooks/useDataApi'
+import { getBuiltinOcrProviderLabel } from '@renderer/i18n/label'
+import type { ListOcrProvidersQuery, OcrProvider } from '@renderer/types'
+import { isBuiltinOcrProvider } from '@renderer/types'
+
+export const useOcrProviders = (query?: ListOcrProvidersQuery) => {
+  const { data, loading, error } = useQuery('/ocr/providers', { query })
+
+  const getOcrProviderName = (p: OcrProvider) => {
+    return isBuiltinOcrProvider(p) ? getBuiltinOcrProviderLabel(p.id) : p.name
+  }
+
+  return {
+    providers: data?.data,
+    loading,
+    error,
+    getOcrProviderName
+  }
+}

src/renderer/src/hooks/useOcrProvider.tsx

@@ -1,148 +0,0 @@
-import { Avatar } from '@cherrystudio/ui'
-import { loggerService } from '@logger'
-import IntelLogo from '@renderer/assets/images/providers/intel.png'
-import PaddleocrLogo from '@renderer/assets/images/providers/paddleocr.png'
-import TesseractLogo from '@renderer/assets/images/providers/Tesseract.js.png'
-import { BUILTIN_OCR_PROVIDERS_MAP, DEFAULT_OCR_PROVIDER } from '@renderer/config/ocr'
-import { getBuiltinOcrProviderLabel } from '@renderer/i18n/label'
-import { useAppSelector } from '@renderer/store'
-import { addOcrProvider, removeOcrProvider, setImageOcrProviderId, updateOcrProviderConfig } from '@renderer/store/ocr'
-import type { ImageOcrProvider, OcrProvider, OcrProviderConfig } from '@renderer/types'
-import { isBuiltinOcrProvider, isBuiltinOcrProviderId, isImageOcrProvider } from '@renderer/types'
-import { FileQuestionMarkIcon, MonitorIcon } from 'lucide-react'
-import { useCallback, useEffect, useState } from 'react'
-import { useTranslation } from 'react-i18next'
-import { useDispatch } from 'react-redux'
-
-const logger = loggerService.withContext('useOcrProvider')
-
-export const useOcrProviders = () => {
-  const providers = useAppSelector((state) => state.ocr.providers)
-  const imageProviders = providers.filter(isImageOcrProvider)
-  const imageProviderId = useAppSelector((state) => state.ocr.imageProviderId)
-  const [imageProvider, setImageProvider] = useState<ImageOcrProvider>(DEFAULT_OCR_PROVIDER.image)
-  const dispatch = useDispatch()
-  const { t } = useTranslation()
-
-  /**
-   * 添加一个新的OCR服务提供者
-   * @param provider - OCR提供者对象，包含id和其他配置信息
-   * @throws {Error} 当尝试添加一个已存在ID的提供者时抛出错误
-   */
-  const addProvider = useCallback(
-    (provider: OcrProvider) => {
-      if (providers.some((p) => p.id === provider.id)) {
-        const msg = `Provider with id ${provider.id} already exists`
-        logger.error(msg)
-        window.toast.error(t('ocr.error.provider.existing'))
-        throw new Error(msg)
-      }
-      dispatch(addOcrProvider(provider))
-    },
-    [dispatch, providers, t]
-  )
-
-  /**
-   * 移除一个OCR服务提供者
-   * @param id - 要移除的OCR提供者ID
-   * @throws {Error} 当尝试移除一个内置提供商时抛出错误
-   */
-  const removeProvider = (id: string) => {
-    if (isBuiltinOcrProviderId(id)) {
-      const msg = `Cannot remove builtin provider ${id}`
-      logger.error(msg)
-      window.toast.error(t('ocr.error.provider.cannot_remove_builtin'))
-      throw new Error(msg)
-    }
-
-    dispatch(removeOcrProvider(id))
-  }
-
-  const setImageProviderId = useCallback(
-    (id: string) => {
-      dispatch(setImageOcrProviderId(id))
-    },
-    [dispatch]
-  )
-
-  const getOcrProviderName = (p: OcrProvider) => {
-    return isBuiltinOcrProvider(p) ? getBuiltinOcrProviderLabel(p.id) : p.name
-  }
-
-  const OcrProviderLogo = ({ provider: p, size = 14 }: { provider: OcrProvider; size?: number }) => {
-    if (isBuiltinOcrProvider(p)) {
-      switch (p.id) {
-        case 'tesseract':
-          return <Avatar src={TesseractLogo} style={{ width: size, height: size }} />
-        case 'system':
-          return <MonitorIcon size={size} />
-        case 'paddleocr':
-          return <Avatar src={PaddleocrLogo} style={{ width: size, height: size }} />
-        case 'ovocr':
-          return <Avatar src={IntelLogo} style={{ width: size, height: size }} />
-      }
-    }
-    return <FileQuestionMarkIcon size={size} />
-  }
-
-  useEffect(() => {
-    const actualImageProvider = imageProviders.find((p) => p.id === imageProviderId)
-    if (!actualImageProvider) {
-      if (isBuiltinOcrProviderId(imageProviderId)) {
-        logger.warn(`Builtin ocr provider ${imageProviderId} not exist. Will add it to providers.`)
-        addProvider(BUILTIN_OCR_PROVIDERS_MAP[imageProviderId])
-      }
-      setImageProviderId(DEFAULT_OCR_PROVIDER.image.id)
-      setImageProvider(DEFAULT_OCR_PROVIDER.image)
-    } else {
-      setImageProviderId(actualImageProvider.id)
-      setImageProvider(actualImageProvider)
-    }
-  }, [addProvider, imageProviderId, imageProviders, setImageProviderId])
-
-  return {
-    providers,
-    imageProvider,
-    addProvider,
-    removeProvider,
-    setImageProviderId,
-    getOcrProviderName,
-    OcrProviderLogo
-  }
-}
-
-export const useOcrProvider = (id: string) => {
-  const { t } = useTranslation()
-  const dispatch = useDispatch()
-  const { providers, addProvider } = useOcrProviders()
-  let provider = providers.find((p) => p.id === id)
-
-  // safely fallback
-  if (!provider) {
-    logger.error(`Ocr Provider ${id} not found`)
-    window.toast.error(t('ocr.error.provider.not_found'))
-    if (isBuiltinOcrProviderId(id)) {
-      try {
-        addProvider(BUILTIN_OCR_PROVIDERS_MAP[id])
-      } catch (e) {
-        logger.warn(`Add ${BUILTIN_OCR_PROVIDERS_MAP[id].name} failed. Just use temp provider from config.`)
-        window.toast.warning(t('ocr.warning.provider.fallback', { name: BUILTIN_OCR_PROVIDERS_MAP[id].name }))
-      } finally {
-        provider = BUILTIN_OCR_PROVIDERS_MAP[id]
-      }
-    } else {
-      logger.warn(`Fallback to tesseract`)
-      window.toast.warning(t('ocr.warning.provider.fallback', { name: 'Tesseract' }))
-      provider = BUILTIN_OCR_PROVIDERS_MAP.tesseract
-    }
-  }
-
-  const updateConfig = (update: Partial<OcrProviderConfig>) => {
-    dispatch(updateOcrProviderConfig({ id: provider.id, update }))
-  }
-
-  return {
-    provider,
-    updateConfig
-  }
-}

src/renderer/src/i18n/index.ts

@@ -4,16 +4,11 @@ import { defaultLanguage } from '@shared/config/constant'
 import i18n from 'i18next'
 import { initReactI18next } from 'react-i18next'
 
+// Original translation
 import enUS from './locales/en-us.json'
 import zhCN from './locales/zh-cn.json'
 import zhTW from './locales/zh-tw.json'
-// import deDE from './locales/de-de.json'
-// import elGR from './locales/el-gr.json'
-// import esES from './locales/es-es.json'
-// import frFR from './locales/fr-fr.json'
-// import jaJP from './locales/ja-jp.json'
-// import ptPT from './locales/pt-pt.json'
-// import ruRU from './locales/ru-ru.json'
+// Machine translation
 import deDE from './translate/de-de.json'
 import elGR from './translate/el-gr.json'
 import esES from './translate/es-es.json'
@@ -22,35 +17,21 @@ import jaJP from './translate/ja-jp.json'
 import ptPT from './translate/pt-pt.json'
 import ruRU from './translate/ru-ru.json'
 
-const logger = loggerService.withContext('renderer:i18n')
+const logger = loggerService.withContext('I18N')
 
-// const resources = Object.fromEntries([
-//   ['en-US', enUS],
-//   ['zh-CN', zhCN],
-//   ['zh-TW', zhTW],
-//   ['de-DE', deDE],
-//   ['el-GR', elGR],
-//   ['es-ES', esES],
-//   ['fr-FR', frFR],
-//   ['ja-JP', jaJP],
-//   ['pt-PT', ptPT],
-//   ['ru-RU', ruRU]
-// ])
 const resources = Object.fromEntries(
-  (
-    [
-      ['en-US', enUS],
-      ['zh-CN', zhCN],
-      ['zh-TW', zhTW],
-      ['de-DE', deDE],
-      ['el-GR', elGR],
-      ['es-ES', esES],
-      ['fr-FR', frFR],
-      ['ja-JP', jaJP],
-      ['pt-PT', ptPT],
-      ['ru-RU', ruRU]
-    ] as const
-  ).map(([key, translation]) => [key, { translation }])
+  [
+    ['en-US', enUS],
+    ['ja-JP', jaJP],
+    ['ru-RU', ruRU],
+    ['zh-CN', zhCN],
+    ['zh-TW', zhTW],
+    ['de-DE', deDE],
+    ['el-GR', elGR],
+    ['es-ES', esES],
+    ['fr-FR', frFR],
+    ['pt-PT', ptPT]
+  ].map(([locale, translation]) => [locale, { translation }])
 )
 
 export const getLanguage = async () => {

src/renderer/src/i18n/locales/README.md

@@ -1,3 +0,0 @@
-仅 en-us, zh-cn, zh-tw 经过人工确认，其他翻译文件由机器翻译生成
-Only en-us, zh-cn, zh-tw are manually maintained; other translation files are machine-translated.
-

src/renderer/src/i18n/locales/en-us.json

@@ -1129,8 +1129,8 @@
     "pause_placeholder": "Paused",
     "prompt": "Prompt",
     "provider": "Provider",
-    "provider_disabled": "Model provider is not enabled",
     "providerId": "Provider ID",
+    "provider_disabled": "Model provider is not enabled",
     "reason": "Reason",
     "render": {
       "description": "Failed to render message content. Please check if the message content format is correct",
@@ -1780,9 +1780,9 @@
       "goBack": "Go Back",
       "goForward": "Go Forward",
       "minimize": "Minimize MinApp",
+      "openExternal": "Open in Browser",
       "open_link_external_off": "Current: Open links in default window",
       "open_link_external_on": "Current: Open links in browser",
-      "openExternal": "Open in Browser",
       "refresh": "Refresh",
       "rightclick_copyurl": "Right-click to copy URL"
     },
@@ -2055,6 +2055,7 @@
         "cannot_remove_builtin": "Cannot delete built-in provider",
         "existing": "The provider already exists",
         "get_providers": "Failed to get available providers",
+        "not_availabel": "Provide {{provider}} is not available",
         "not_found": "OCR provider does not exist",
         "update_failed": "Failed to update configuration"
       },
@@ -2064,6 +2065,40 @@
       "not_supported": "Unsupported file type {{type}}"
     },
     "processing": "OCR processing...",
+    "provider": {
+      "config": {
+        "patch": {
+          "error": {
+            "failed": "Failed to update config"
+          }
+        }
+      },
+      "create": {
+        "error": {
+          "failed": "Failed to create provider"
+        }
+      },
+      "delete": {
+        "error": {
+          "failed": "Failed to delete provider {{provider}}"
+        }
+      },
+      "get": {
+        "error": {
+          "failed": "Failed to get provider {{provider}}"
+        }
+      },
+      "list": {
+        "error": {
+          "failed": "Failed to list providers"
+        }
+      },
+      "update": {
+        "error": {
+          "failed": "Failed to update the provider"
+        }
+      }
+    },
     "warning": {
       "provider": {
         "fallback": "Reverted to {{name}}, which may cause issues"
@@ -2570,9 +2605,9 @@
       "uploadError": "Image upload failed",
       "uploadFile": "Upload file",
       "uploadHint": "Supports JPG, PNG, GIF and other formats, max 10MB",
-      "uploading": "Uploading image",
       "uploadSuccess": "Image uploaded successfully",
       "uploadText": "Click or drag image here to upload",
+      "uploading": "Uploading image",
       "urlPlaceholder": "Paste image link",
       "urlRequired": "Please enter image URL"
     },
@@ -2803,11 +2838,11 @@
   },
   "settings": {
     "about": {
-      "checkingUpdate": "Checking for updates...",
       "checkUpdate": {
         "available": "Update",
         "label": "Check Update"
       },
+      "checkingUpdate": "Checking for updates...",
       "contact": {
         "button": "Email",
         "title": "Contact"

src/renderer/src/i18n/locales/zh-cn.json

@@ -1129,8 +1129,8 @@
     "pause_placeholder": "已中断",
     "prompt": "提示词",
     "provider": "提供商",
-    "provider_disabled": "模型提供商未启用",
     "providerId": "提供商 ID",
+    "provider_disabled": "模型提供商未启用",
     "reason": "原因",
     "render": {
       "description": "消息内容渲染失败，请检查消息内容格式是否正确",
@@ -1780,9 +1780,9 @@
       "goBack": "后退",
       "goForward": "前进",
       "minimize": "最小化小程序",
+      "openExternal": "在浏览器中打开",
       "open_link_external_off": "当前：使用默认窗口打开链接",
       "open_link_external_on": "当前：在浏览器中打开链接",
-      "openExternal": "在浏览器中打开",
       "refresh": "刷新",
       "rightclick_copyurl": "右键复制 URL"
     },
@@ -2055,6 +2055,7 @@
         "cannot_remove_builtin": "不能删除内置提供商",
         "existing": "提供商已存在",
         "get_providers": "获取可用提供商失败",
+        "not_availabel": "{{provider}} 暂不可用",
         "not_found": "OCR 提供商不存在",
         "update_failed": "更新配置失败"
       },
@@ -2064,6 +2065,40 @@
       "not_supported": "不支持的文件类型 {{type}}"
     },
     "processing": "OCR 处理中...",
+    "provider": {
+      "config": {
+        "patch": {
+          "error": {
+            "failed": "更新配置失败"
+          }
+        }
+      },
+      "create": {
+        "error": {
+          "failed": "创建提供商失败"
+        }
+      },
+      "delete": {
+        "error": {
+          "failed": "删除提供商 {{provider}} 失败"
+        }
+      },
+      "get": {
+        "error": {
+          "failed": "获取提供商 {{provider}} 失败"
+        }
+      },
+      "list": {
+        "error": {
+          "failed": "获取提供商列表失败"
+        }
+      },
+      "update": {
+        "error": {
+          "failed": "更新提供商失败"
+        }
+      }
+    },
     "warning": {
       "provider": {
         "fallback": "已回退到 {{name}}，这可能导致问题"
@@ -2570,9 +2605,9 @@
       "uploadError": "图片上传失败",
       "uploadFile": "上传文件",
       "uploadHint": "支持 JPG、PNG、GIF 等格式，最大 10MB",
-      "uploading": "正在上传图片",
       "uploadSuccess": "图片上传成功",
       "uploadText": "点击或拖拽图片到此处上传",
+      "uploading": "正在上传图片",
       "urlPlaceholder": "粘贴图片链接地址",
       "urlRequired": "请输入图片链接地址"
     },
@@ -2803,11 +2838,11 @@
   },
   "settings": {
     "about": {
-      "checkingUpdate": "正在检查更新...",
       "checkUpdate": {
         "available": "立即更新",
         "label": "检查更新"
       },
+      "checkingUpdate": "正在检查更新...",
       "contact": {
         "button": "邮件",
         "title": "邮件联系"

src/renderer/src/i18n/locales/zh-tw.json

@@ -1129,8 +1129,8 @@
     "pause_placeholder": "回應已暫停",
     "prompt": "提示詞",
     "provider": "提供商",
-    "provider_disabled": "模型供應商未啟用",
     "providerId": "提供者 ID",
+    "provider_disabled": "模型供應商未啟用",
     "reason": "原因",
     "render": {
       "description": "消息內容渲染失敗，請檢查消息內容格式是否正確",
@@ -1780,9 +1780,9 @@
       "goBack": "上一頁",
       "goForward": "下一頁",
       "minimize": "最小化小工具",
+      "openExternal": "在瀏覽器中開啟",
       "open_link_external_off": "当前：使用預設視窗開啟連結",
       "open_link_external_on": "当前：在瀏覽器中開啟連結",
-      "openExternal": "在瀏覽器中開啟",
       "refresh": "重新整理",
       "rightclick_copyurl": "右鍵複製 URL"
     },
@@ -2055,6 +2055,7 @@
         "cannot_remove_builtin": "不能刪除內建提供者",
         "existing": "提供者已存在",
         "get_providers": "取得可用提供者失敗",
+        "not_availabel": "提供 {{provider}} 不可用",
         "not_found": "OCR 提供者不存在",
         "update_failed": "更新配置失敗"
       },
@@ -2064,6 +2065,40 @@
       "not_supported": "不支持的文件類型 {{type}}"
     },
     "processing": "OCR 處理中...",
+    "provider": {
+      "config": {
+        "patch": {
+          "error": {
+            "failed": "更新設定失敗"
+          }
+        }
+      },
+      "create": {
+        "error": {
+          "failed": "無法建立提供者"
+        }
+      },
+      "delete": {
+        "error": {
+          "failed": "刪除提供者 {{provider}} 失敗"
+        }
+      },
+      "get": {
+        "error": {
+          "failed": "無法取得提供者 {{provider}}"
+        }
+      },
+      "list": {
+        "error": {
+          "failed": "無法列出提供者"
+        }
+      },
+      "update": {
+        "error": {
+          "failed": "無法更新提供者"
+        }
+      }
+    },
     "warning": {
       "provider": {
         "fallback": "已回退到 {{name}}，這可能導致問題"
@@ -2570,9 +2605,9 @@
       "uploadError": "圖片上傳失敗",
       "uploadFile": "上傳檔案",
       "uploadHint": "支援 JPG、PNG、GIF 等格式，最大 10MB",
-      "uploading": "正在上傳圖片",
       "uploadSuccess": "圖片上傳成功",
       "uploadText": "點擊或拖拽圖片到此處上傳",
+      "uploading": "正在上傳圖片",
       "urlPlaceholder": "貼上圖片連結地址",
       "urlRequired": "請輸入圖片連結地址"
     },
@@ -2803,11 +2838,11 @@
   },
   "settings": {
     "about": {
-      "checkingUpdate": "正在檢查更新...",
       "checkUpdate": {
         "available": "立即更新",
         "label": "檢查更新"
       },
+      "checkingUpdate": "正在檢查更新...",
       "contact": {
         "button": "電子郵件",
         "title": "聯絡方式"

src/renderer/src/i18n/translate/de-de.json

@@ -1129,8 +1129,8 @@
     "pause_placeholder": "Unterbrochen",
     "prompt": "Prompt",
     "provider": "Anbieter",
-    "provider_disabled": "Modellanbieter nicht aktiviert",
     "providerId": "Anbieter-ID",
+    "provider_disabled": "Modellanbieter nicht aktiviert",
     "reason": "Grund",
     "render": {
       "description": "Rendering der Nachricht fehlgeschlagen. Bitte überprüfen Sie das Format des Nachrichteninhalts",
@@ -1780,9 +1780,9 @@
       "goBack": "Zurück",
       "goForward": "Vorwärts",
       "minimize": "Mini-App minimieren",
+      "openExternal": "In Browser öffnen",
       "open_link_external_off": "Aktuell: Links im Standardfenster öffnen",
       "open_link_external_on": "Aktuell: Links im Browser öffnen",
-      "openExternal": "In Browser öffnen",
       "refresh": "Aktualisieren",
       "rightclick_copyurl": "Rechtsklick zum Kopieren der URL"
     },
@@ -2055,6 +2055,7 @@
         "cannot_remove_builtin": "Eingebauter Anbieter kann nicht entfernt werden",
         "existing": "Anbieter existiert bereits",
         "get_providers": "Failed to obtain available providers",
+        "not_availabel": "{{provider}} ist nicht verfügbar",
         "not_found": "OCR-Anbieter nicht gefunden",
         "update_failed": "Konfiguration aktualisieren fehlgeschlagen"
       },
@@ -2064,6 +2065,40 @@
       "not_supported": "Nicht unterstützter Dateityp {{type}}"
     },
     "processing": "OCR wird verarbeitet...",
+    "provider": {
+      "config": {
+        "patch": {
+          "error": {
+            "failed": "Fehler beim Aktualisieren der Konfiguration"
+          }
+        }
+      },
+      "create": {
+        "error": {
+          "failed": "Fehler beim Erstellen des Anbieters"
+        }
+      },
+      "delete": {
+        "error": {
+          "failed": "Fehler beim Löschen des Anbieters {{provider}}"
+        }
+      },
+      "get": {
+        "error": {
+          "failed": "Fehler beim Abrufen des Anbieters {{provider}}"
+        }
+      },
+      "list": {
+        "error": {
+          "failed": "Anbieter konnten nicht aufgelistet werden"
+        }
+      },
+      "update": {
+        "error": {
+          "failed": "Fehler beim Aktualisieren des Anbieters"
+        }
+      }
+    },
     "warning": {
       "provider": {
         "fallback": "Auf {{name}} zurückgefallen, dies kann zu Problemen führen"
@@ -2570,9 +2605,9 @@
       "uploadError": "Bild-Upload fehlgeschlagen",
       "uploadFile": "Datei hochladen",
       "uploadHint": "Unterstützt JPG, PNG, GIF usw., maximal 10 MB",
-      "uploading": "Bild wird hochgeladen",
       "uploadSuccess": "Bild erfolgreich hochgeladen",
       "uploadText": "Klicken oder Bild hierher ziehen zum Hochladen",
+      "uploading": "Bild wird hochgeladen",
       "urlPlaceholder": "Bildlink-Adresse einfügen",
       "urlRequired": "Bitte Bildlink-Adresse eingeben"
     },
@@ -2803,11 +2838,11 @@
   },
   "settings": {
     "about": {
-      "checkingUpdate": "Sucht nach Updates...",
       "checkUpdate": {
         "available": "Jetzt aktualisieren",
         "label": "Auf Updates prüfen"
       },
+      "checkingUpdate": "Sucht nach Updates...",
       "contact": {
         "button": "E-Mail",
         "title": "E-Mail-Kontakt"

src/renderer/src/i18n/translate/el-gr.json

@@ -1129,8 +1129,8 @@
     "pause_placeholder": "Διακόπηκε",
     "prompt": "συμβουλές",
     "provider": "πάροχος",
-    "provider_disabled": "Ο παρεχόμενος παροχός του μοντέλου δεν είναι ενεργοποιημένος",
     "providerId": "Αναγνωριστικό παρόχου",
+    "provider_disabled": "Ο παρεχόμενος παροχός του μοντέλου δεν είναι ενεργοποιημένος",
     "reason": "αιτία",
     "render": {
       "description": "Απέτυχε η ώθηση της εξίσωσης, παρακαλώ ελέγξτε το σωστό μορφάτι της",
@@ -1780,9 +1780,9 @@
       "goBack": "Πίσω",
       "goForward": "Μπροστά",
       "minimize": "Ελαχιστοποίηση της εφαρμογής",
+      "openExternal": "Άνοιγμα στον περιηγητή",
       "open_link_external_off": "Τρέχον: Άνοιγμα συνδέσμου χρησιμοποιώντας το προεπιλεγμένο παράθυρο",
       "open_link_external_on": "Τρέχον: Άνοιγμα συνδέσμου στον περιηγητή",
-      "openExternal": "Άνοιγμα στον περιηγητή",
       "refresh": "Ανανέωση",
       "rightclick_copyurl": "Αντιγραφή URL με δεξί κλικ"
     },
@@ -2055,6 +2055,7 @@
         "cannot_remove_builtin": "Δεν είναι δυνατή η διαγραφή του ενσωματωμένου παρόχου",
         "existing": "Ο πάροχος υπηρεσιών υπάρχει ήδη",
         "get_providers": "Αποτυχία λήψης διαθέσιμων παρόχων",
+        "not_availabel": "Ο πάροχος {{provider}} δεν είναι διαθέσιμος",
         "not_found": "Ο πάροχος OCR δεν υπάρχει",
         "update_failed": "Αποτυχία ενημέρωσης της διαμόρφωσης"
       },
@@ -2064,6 +2065,40 @@
       "not_supported": "Μη υποστηριζόμενος τύπος αρχείου {{type}}"
     },
     "processing": "Η επεξεργασία OCR βρίσκεται σε εξέλιξη...",
+    "provider": {
+      "config": {
+        "patch": {
+          "error": {
+            "failed": "Αποτυχία ενημέρωσης ρυθμίσεων"
+          }
+        }
+      },
+      "create": {
+        "error": {
+          "failed": "Αποτυχία δημιουργίας παρόχου"
+        }
+      },
+      "delete": {
+        "error": {
+          "failed": "Αποτυχία διαγραφής του παρόχου {{provider}}"
+        }
+      },
+      "get": {
+        "error": {
+          "failed": "Αποτυχία λήψης του παρόχου {{provider}}"
+        }
+      },
+      "list": {
+        "error": {
+          "failed": "Αποτυχία καταγραφής παρόχων"
+        }
+      },
+      "update": {
+        "error": {
+          "failed": "Αποτυχία ενημέρωσης του παρόχου"
+        }
+      }
+    },
     "warning": {
       "provider": {
         "fallback": "Επαναφέρθηκε στο {{name}}, το οποίο μπορεί να προκαλέσει προβλήματα"
@@ -2570,9 +2605,9 @@
       "uploadError": "Η μεταφόρτωση της εικόνας απέτυχε",
       "uploadFile": "Ανέβασμα αρχείου",
       "uploadHint": "Υποστηρίζει μορφές όπως JPG, PNG, GIF, μέγιστο μέγεθος 10MB",
-      "uploading": "Ανεβάζει εικόνα",
       "uploadSuccess": "Η εικόνα ανέβηκε με επιτυχία",
       "uploadText": "Κάντε κλικ ή σύρετε την εικόνα εδώ για μεταφόρτωση",
+      "uploading": "Ανεβάζει εικόνα",
       "urlPlaceholder": "Επικολλήστε τη διεύθυνση συνδέσμου της εικόνας",
       "urlRequired": "Παρακαλώ εισαγάγετε τη διεύθυνση σύνδεσης της εικόνας"
     },
@@ -2803,11 +2838,11 @@
   },
   "settings": {
     "about": {
-      "checkingUpdate": "Ελέγχω ενημερώσεις...",
       "checkUpdate": {
         "available": "Άμεση ενημέρωση",
         "label": "Έλεγχος ενημερώσεων"
       },
+      "checkingUpdate": "Ελέγχω ενημερώσεις...",
       "contact": {
         "button": "Ταχυδρομείο",
         "title": "Επικοινωνία μέσω ταχυδρομείου"

src/renderer/src/i18n/translate/es-es.json

@@ -1129,8 +1129,8 @@
     "pause_placeholder": "Interrumpido",
     "prompt": "prompt",
     "provider": "proveedor",
-    "provider_disabled": "El proveedor de modelos no está habilitado",
     "providerId": "ID del proveedor",
+    "provider_disabled": "El proveedor de modelos no está habilitado",
     "reason": "causa",
     "render": {
       "description": "Error al renderizar la fórmula, por favor, compruebe si el formato de la fórmula es correcto",
@@ -1780,9 +1780,9 @@
       "goBack": "Retroceder",
       "goForward": "Avanzar",
       "minimize": "Minimizar la aplicación",
+      "openExternal": "Abrir en el navegador",
       "open_link_external_off": "Actual: Abrir enlaces en ventana predeterminada",
       "open_link_external_on": "Actual: Abrir enlaces en el navegador",
-      "openExternal": "Abrir en el navegador",
       "refresh": "Actualizar",
       "rightclick_copyurl": "Copiar URL con clic derecho"
     },
@@ -2055,6 +2055,7 @@
         "cannot_remove_builtin": "No se puede eliminar el proveedor integrado",
         "existing": "El proveedor ya existe",
         "get_providers": "Error al obtener proveedores disponibles",
+        "not_availabel": "Proporcionar {{provider}} no está disponible",
         "not_found": "El proveedor de OCR no existe",
         "update_failed": "Actualización de la configuración fallida"
       },
@@ -2064,6 +2065,40 @@
       "not_supported": "Tipo de archivo no compatible {{type}}"
     },
     "processing": "Procesando OCR...",
+    "provider": {
+      "config": {
+        "patch": {
+          "error": {
+            "failed": "Error al actualizar la configuración"
+          }
+        }
+      },
+      "create": {
+        "error": {
+          "failed": "Error al crear el proveedor"
+        }
+      },
+      "delete": {
+        "error": {
+          "failed": "Error al eliminar el proveedor {{provider}}"
+        }
+      },
+      "get": {
+        "error": {
+          "failed": "Error al obtener el proveedor {{provider}}"
+        }
+      },
+      "list": {
+        "error": {
+          "failed": "Error al listar proveedores"
+        }
+      },
+      "update": {
+        "error": {
+          "failed": "Error al actualizar el proveedor"
+        }
+      }
+    },
     "warning": {
       "provider": {
         "fallback": "Se ha revertido a {{name}}, lo que podría causar problemas"
@@ -2570,9 +2605,9 @@
       "uploadError": "La subida de la imagen falló",
       "uploadFile": "subir archivo",
       "uploadHint": "Admite formatos como JPG, PNG, GIF, entre otros, con un tamaño máximo de 10MB",
-      "uploading": "Subiendo imágenes",
       "uploadSuccess": "Imagen subida con éxito",
       "uploadText": "Haz clic o arrastra la imagen aquí para subirla",
+      "uploading": "Subiendo imágenes",
       "urlPlaceholder": "pegar el enlace de la imagen",
       "urlRequired": "Por favor, introduce la dirección del enlace de la imagen"
     },
@@ -2803,11 +2838,11 @@
   },
   "settings": {
     "about": {
-      "checkingUpdate": "Verificando actualizaciones...",
       "checkUpdate": {
         "available": "Actualizar ahora",
         "label": "Comprobar actualizaciones"
       },
+      "checkingUpdate": "Verificando actualizaciones...",
       "contact": {
         "button": "Correo electrónico",
         "title": "Contacto por correo electrónico"

src/renderer/src/i18n/translate/fr-fr.json

@@ -1129,8 +1129,8 @@
     "pause_placeholder": "Прервано",
     "prompt": "mot-clé",
     "provider": "fournisseur",
-    "provider_disabled": "Le fournisseur de modèles n'est pas activé",
     "providerId": "ID du fournisseur",
+    "provider_disabled": "Le fournisseur de modèles n'est pas activé",
     "reason": "raison",
     "render": {
       "description": "La formule n'a pas été rendue avec succès, veuillez vérifier si le format de la formule est correct",
@@ -1780,9 +1780,9 @@
       "goBack": "Reculer",
       "goForward": "Avancer",
       "minimize": "Свернуть мини-программу",
+      "openExternal": "Открыть в браузере",
       "open_link_external_off": "Текущий: открывать ссылки в окне по умолчанию",
       "open_link_external_on": "Текущий: открывать ссылки в браузере",
-      "openExternal": "Открыть в браузере",
       "refresh": "Обновить",
       "rightclick_copyurl": "Скопировать URL через правую кнопку мыши"
     },
@@ -2055,6 +2055,7 @@
         "cannot_remove_builtin": "Impossible de supprimer le fournisseur intégré",
         "existing": "Le fournisseur existe déjà",
         "get_providers": "Échec de l'obtention des fournisseurs disponibles",
+        "not_availabel": "Fournir {{provider}} n’est pas disponible",
         "not_found": "Le fournisseur OCR n'existe pas",
         "update_failed": "Échec de la mise à jour de la configuration"
       },
@@ -2064,6 +2065,40 @@
       "not_supported": "Type de fichier non pris en charge {{type}}"
     },
     "processing": "Traitement OCR en cours...",
+    "provider": {
+      "config": {
+        "patch": {
+          "error": {
+            "failed": "Échec de la mise à jour de la configuration"
+          }
+        }
+      },
+      "create": {
+        "error": {
+          "failed": "Échec de la création du fournisseur"
+        }
+      },
+      "delete": {
+        "error": {
+          "failed": "Échec de la suppression du fournisseur {{provider}}"
+        }
+      },
+      "get": {
+        "error": {
+          "failed": "Échec de l'obtention du fournisseur {{provider}}"
+        }
+      },
+      "list": {
+        "error": {
+          "failed": "Échec de la liste des fournisseurs"
+        }
+      },
+      "update": {
+        "error": {
+          "failed": "Échec de la mise à jour du fournisseur"
+        }
+      }
+    },
     "warning": {
       "provider": {
         "fallback": "Revenu à {{name}}, ce qui pourrait entraîner des problèmes"
@@ -2570,9 +2605,9 @@
       "uploadError": "Échec du téléversement de l'image",
       "uploadFile": "télécharger un fichier",
       "uploadHint": "prend en charge les formats JPG, PNG, GIF, etc., jusqu'à 10 Mo max.",
-      "uploading": "Téléchargement de l'image en cours",
       "uploadSuccess": "L'image a été téléchargée avec succès",
       "uploadText": "Cliquez ou faites glisser l'image ici pour la télécharger",
+      "uploading": "Téléchargement de l'image en cours",
       "urlPlaceholder": "coller l'URL de l'image",
       "urlRequired": "Veuillez entrer l'URL de l'image"
     },
@@ -2803,11 +2838,11 @@
   },
   "settings": {
     "about": {
-      "checkingUpdate": "Vérification des mises à jour en cours...",
       "checkUpdate": {
         "available": "Mettre à jour maintenant",
         "label": "Vérifier les mises à jour"
       },
+      "checkingUpdate": "Vérification des mises à jour en cours...",
       "contact": {
         "button": "Courriel",
         "title": "Contactez-nous par courriel"

src/renderer/src/i18n/translate/ja-jp.json

@@ -1129,8 +1129,8 @@
     "pause_placeholder": "応答を一時停止しました",
     "prompt": "プロンプトを表示する",
     "provider": "プロバイダー",
-    "provider_disabled": "モデルプロバイダーが有効になっていません",
     "providerId": "プロバイダーID",
+    "provider_disabled": "モデルプロバイダーが有効になっていません",
     "reason": "原因",
     "render": {
       "description": "メッセージの内容のレンダリングに失敗しました。メッセージの内容の形式が正しいか確認してください",
@@ -1780,9 +1780,9 @@
       "goBack": "戻る",
       "goForward": "進む",
       "minimize": "ミニアプリを最小化",
+      "openExternal": "ブラウザで開く",
       "open_link_external_off": "現在：デフォルトのウィンドウで開く",
       "open_link_external_on": "現在：ブラウザで開く",
-      "openExternal": "ブラウザで開く",
       "refresh": "更新",
       "rightclick_copyurl": "右クリックでURLをコピー"
     },
@@ -2055,6 +2055,7 @@
         "cannot_remove_builtin": "組み込みプロバイダーは削除できません",
         "existing": "プロバイダーはすでに存在します",
         "get_providers": "利用可能なプロバイダーの取得に失敗しました",
+        "not_availabel": "{{provider}}が利用できません",
         "not_found": "OCRプロバイダーが存在しません",
         "update_failed": "更新構成に失敗しました"
       },
@@ -2064,6 +2065,40 @@
       "not_supported": "サポートされていないファイルタイプ {{type}}"
     },
     "processing": "OCR処理中...",
+    "provider": {
+      "config": {
+        "patch": {
+          "error": {
+            "failed": "設定の更新に失敗しました"
+          }
+        }
+      },
+      "create": {
+        "error": {
+          "failed": "プロバイダーの作成に失敗しました"
+        }
+      },
+      "delete": {
+        "error": {
+          "failed": "プロバイダー {{provider}} の削除に失敗しました"
+        }
+      },
+      "get": {
+        "error": {
+          "failed": "プロバイダー {{provider}} の取得に失敗しました"
+        }
+      },
+      "list": {
+        "error": {
+          "failed": "プロバイダーの一覧取得に失敗しました"
+        }
+      },
+      "update": {
+        "error": {
+          "failed": "プロバイダーの更新に失敗しました"
+        }
+      }
+    },
     "warning": {
       "provider": {
         "fallback": "{{name}} に戻されました。これにより問題が発生する可能性があります。"
@@ -2570,9 +2605,9 @@
       "uploadError": "画像のアップロードに失敗しました",
       "uploadFile": "ファイルをアップロード",
       "uploadHint": "JPG、PNG、GIFおよびその他の形式をサポートし、最大10MB",
-      "uploading": "写真のアップロード",
       "uploadSuccess": "画像アップロードに正常にアップロードします",
       "uploadText": "画像をクリックまたはドラッグしてここにアップロードします",
+      "uploading": "写真のアップロード",
       "urlPlaceholder": "画像リンクアドレスを貼り付けます",
       "urlRequired": "画像リンクアドレスを入力してください"
     },
@@ -2803,11 +2838,11 @@
   },
   "settings": {
     "about": {
-      "checkingUpdate": "更新を確認中...",
       "checkUpdate": {
         "available": "今すぐ更新",
         "label": "更新を確認"
       },
+      "checkingUpdate": "更新を確認中...",
       "contact": {
         "button": "メール",
         "title": "連絡先"

src/renderer/src/i18n/translate/pt-pt.json

@@ -1129,8 +1129,8 @@
     "pause_placeholder": "Interrompido",
     "prompt": "prompt",
     "provider": "fornecedor",
-    "provider_disabled": "O provedor de modelos está desativado",
     "providerId": "ID do fornecedor",
+    "provider_disabled": "O provedor de modelos está desativado",
     "reason": "causa",
     "render": {
       "description": "Falha ao renderizar a fórmula, por favor verifique se o formato da fórmula está correto",
@@ -1780,9 +1780,9 @@
       "goBack": "Voltar",
       "goForward": "Avançar",
       "minimize": "Minimizar aplicativo",
+      "openExternal": "Abrir no navegador",
       "open_link_external_off": "Atual: Abrir links em janela padrão",
       "open_link_external_on": "Atual: Abrir links no navegador",
-      "openExternal": "Abrir no navegador",
       "refresh": "Atualizar",
       "rightclick_copyurl": "Copiar URL com botão direito"
     },
@@ -2055,6 +2055,7 @@
         "cannot_remove_builtin": "Não é possível excluir o provedor integrado",
         "existing": "O provedor já existe",
         "get_providers": "Falha ao obter provedores disponíveis",
+        "not_availabel": "Fornecedor {{provider}} não está disponível",
         "not_found": "O provedor OCR não existe",
         "update_failed": "Falha ao atualizar a configuração"
       },
@@ -2064,6 +2065,40 @@
       "not_supported": "Tipo de arquivo não suportado {{type}}"
     },
     "processing": "Processamento OCR em andamento...",
+    "provider": {
+      "config": {
+        "patch": {
+          "error": {
+            "failed": "Falha ao atualizar a configuração"
+          }
+        }
+      },
+      "create": {
+        "error": {
+          "failed": "Falha ao criar o provedor"
+        }
+      },
+      "delete": {
+        "error": {
+          "failed": "Falha ao excluir o provedor {{provider}}"
+        }
+      },
+      "get": {
+        "error": {
+          "failed": "Falha ao obter o provedor {{provider}}"
+        }
+      },
+      "list": {
+        "error": {
+          "failed": "Falha ao listar provedores"
+        }
+      },
+      "update": {
+        "error": {
+          "failed": "Falha ao atualizar o provedor"
+        }
+      }
+    },
     "warning": {
       "provider": {
         "fallback": "Revertido para {{name}}, o que pode causar problemas"
@@ -2570,9 +2605,9 @@
       "uploadError": "Falha no carregamento da imagem",
       "uploadFile": "enviar arquivo",
       "uploadHint": "Compatível com formatos como JPG, PNG, GIF, etc., tamanho máximo de 10MB",
-      "uploading": "enviando imagem",
       "uploadSuccess": "Imagem enviada com sucesso",
       "uploadText": "Clique ou arraste a imagem aqui para enviar",
+      "uploading": "enviando imagem",
       "urlPlaceholder": "colar o endereço do link da imagem",
       "urlRequired": "Por favor, insira o endereço do link da imagem"
     },
@@ -2803,11 +2838,11 @@
   },
   "settings": {
     "about": {
-      "checkingUpdate": "Verificando atualizações...",
       "checkUpdate": {
         "available": "Atualizar agora",
         "label": "Verificar atualizações"
       },
+      "checkingUpdate": "Verificando atualizações...",
       "contact": {
         "button": "E-mail",
         "title": "Contato por e-mail"

src/renderer/src/i18n/translate/ru-ru.json

@@ -1129,8 +1129,8 @@
     "pause_placeholder": "Получение ответа приостановлено",
     "prompt": "подсказка",
     "provider": "поставщик",
-    "provider_disabled": "Провайдер моделей не включен",
     "providerId": "ID поставщика",
+    "provider_disabled": "Провайдер моделей не включен",
     "reason": "причина",
     "render": {
       "description": "Не удалось рендерить содержимое сообщения. Пожалуйста, проверьте, правильно ли формат содержимого сообщения",
@@ -1780,9 +1780,9 @@
       "goBack": "Назад",
       "goForward": "Вперед",
       "minimize": "Свернуть встроенное приложение",
+      "openExternal": "Открыть в браузере",
       "open_link_external_off": "Текущий: Открыть ссылки в окне по умолчанию",
       "open_link_external_on": "Текущий: Открыть ссылки в браузере",
-      "openExternal": "Открыть в браузере",
       "refresh": "Обновить",
       "rightclick_copyurl": "ПКМ → Копировать URL"
     },
@@ -2055,6 +2055,7 @@
         "cannot_remove_builtin": "Не удается удалить встроенного поставщика",
         "existing": "Поставщик уже существует",
         "get_providers": "Не удалось получить доступных поставщиков",
+        "not_availabel": "Поставщик {{provider}} недоступен",
         "not_found": "Поставщик OCR отсутствует",
         "update_failed": "Обновление конфигурации не удалось"
       },
@@ -2064,6 +2065,40 @@
       "not_supported": "Неподдерживаемый тип файла {{type}}"
     },
     "processing": "Обработка OCR...",
+    "provider": {
+      "config": {
+        "patch": {
+          "error": {
+            "failed": "Не удалось обновить конфигурацию"
+          }
+        }
+      },
+      "create": {
+        "error": {
+          "failed": "Не удалось создать поставщика"
+        }
+      },
+      "delete": {
+        "error": {
+          "failed": "Не удалось удалить поставщика {{provider}}"
+        }
+      },
+      "get": {
+        "error": {
+          "failed": "Не удалось получить поставщика {{provider}}"
+        }
+      },
+      "list": {
+        "error": {
+          "failed": "Не удалось получить список поставщиков"
+        }
+      },
+      "update": {
+        "error": {
+          "failed": "Не удалось обновить поставщика"
+        }
+      }
+    },
     "warning": {
       "provider": {
         "fallback": "Возвращено к {{name}}, это может вызвать проблемы"
@@ -2570,9 +2605,9 @@
       "uploadError": "Загрузка изображения не удалась",
       "uploadFile": "Загрузить файл",
       "uploadHint": "Поддерживает JPG, PNG, GIF и другие форматы, до 10 МБ",
-      "uploading": "Загрузка изображений",
       "uploadSuccess": "Загрузка изображения успешно",
       "uploadText": "Нажмите или перетащите изображение, чтобы загрузить здесь",
+      "uploading": "Загрузка изображений",
       "urlPlaceholder": "Вставьте адрес ссылки изображения",
       "urlRequired": "Пожалуйста, введите адрес ссылки изображения"
     },
@@ -2803,11 +2838,11 @@
   },
   "settings": {
     "about": {
-      "checkingUpdate": "Проверка обновлений...",
       "checkUpdate": {
         "available": "Обновить",
         "label": "Проверить обновления"
       },
+      "checkingUpdate": "Проверка обновлений...",
       "contact": {
         "button": "Электронная почта",
         "title": "Контакты"

src/renderer/src/pages/home/Messages/MessageVideo.tsx

@@ -27,7 +27,7 @@ const MessageVideo: FC<Props> = ({ block }) => {
   const renderLocalVideo = () => {
     if (!block.filePath) {
       logger.warn('Local video was requested but block.filePath is missing.')
-      return <div>{t('message.message.video.error.local_file_missing')}</div>
+      return <div>{t('message.video.error.local_file_missing')}</div>
     }
 
     const videoSrc = `file://${block.metadata?.video.path}`
@@ -67,7 +67,7 @@ const MessageVideo: FC<Props> = ({ block }) => {
         }
 
         logger.warn(`Unsupported video type: ${block.metadata?.type} or missing necessary data.`)
-        return <div>{t('message.message.video.error.unsupported_type')}</div>
+        return <div>{t('message.video.error.unsupported_type')}</div>
     }
   }
 

src/renderer/src/pages/notes/NotesSidebar.tsx

@@ -490,7 +490,7 @@ const NotesSidebar: FC<NotesSidebarProps> = ({
         const result = await SaveToKnowledgePopup.showForNote(note)
 
         if (result?.success) {
-          window.toast.success(t('notes.export_success'))
+          window.toast.success(t('notes.export_success', { count: result.savedCount }))
         }
       } catch (error) {
         window.toast.error(t('notes.export_failed'))

src/renderer/src/pages/settings/AgentSettings/ToolingSettings.tsx

@@ -502,13 +502,22 @@ export const ToolingSettings: FC<AgentToolingSettingsProps> = ({ agentBase, upda
                 })}
               </Chip>
               <Chip variant="flat" color="default">
-                {t('agent.settings.tooling.review.autoTools')}: {autoCount}
+                {t('agent.settings.tooling.review.autoTools', {
+                  defaultValue: `Auto: ${autoCount}`,
+                  count: autoCount
+                })}
               </Chip>
               <Chip variant="flat" color="success">
-                {t('agent.settings.tooling.review.customTools')}: {customCount}
+                {t('agent.settings.tooling.review.customTools', {
+                  defaultValue: `Custom: ${customCount}`,
+                  count: customCount
+                })}
               </Chip>
               <Chip variant="flat" color="warning">
-                {t('agent.settings.tooling.review.mcp')}: {agentSummary.mcps}
+                {t('agent.settings.tooling.review.mcp', {
+                  defaultValue: `MCP: ${agentSummary.mcps}`,
+                  count: agentSummary.mcps
+                })}
               </Chip>
             </div>
             <span className="text-foreground-500 text-xs">

src/renderer/src/pages/settings/DocProcessSettings/OcrImageSettings.tsx

@@ -1,93 +1,85 @@
-import { Alert, Skeleton } from '@heroui/react'
-import { loggerService } from '@logger'
+import { Skeleton } from '@cherrystudio/ui'
+import { Alert } from '@heroui/react'
 import { ErrorTag } from '@renderer/components/Tags/ErrorTag'
 import { isMac, isWin } from '@renderer/config/constant'
-import { useOcrProviders } from '@renderer/hooks/useOcrProvider'
-import type { ImageOcrProvider, OcrProvider } from '@renderer/types'
-import { BuiltinOcrProviderIds, isImageOcrProvider } from '@renderer/types'
+import { useOcrImageProvider } from '@renderer/hooks/ocr/useOcrImageProvider'
+import { useOcrProviders } from '@renderer/hooks/ocr/useOcrProviders'
+import { BuiltinOcrProviderIdMap, isImageOcrProvider } from '@renderer/types'
 import { getErrorMessage } from '@renderer/utils'
 import { Select } from 'antd'
-import { useCallback, useEffect, useMemo } from 'react'
+import { useCallback, useMemo } from 'react'
 import { useTranslation } from 'react-i18next'
-import useSWRImmutable from 'swr/immutable'
 
 import { SettingRow, SettingRowTitle } from '..'
 
-const logger = loggerService.withContext('OcrImageSettings')
+// const logger = loggerService.withContext('OcrImageSettings')
 
-type Props = {
-  setProvider: (provider: OcrProvider) => void
-}
-
-const OcrImageSettings = ({ setProvider }: Props) => {
+const OcrImageSettings = () => {
   const { t } = useTranslation()
-  const { providers, imageProvider, getOcrProviderName, setImageProviderId } = useOcrProviders()
-  const fetcher = useCallback(() => {
-    return window.api.ocr.listProviders()
-  }, [])
+  const { providers, loading, error, getOcrProviderName } = useOcrProviders({ registered: true })
+  const { imageProvider, setImageProviderId, imageProviderId } = useOcrImageProvider()
 
-  const { data: validProviders, isLoading, error } = useSWRImmutable('ocr/providers', fetcher)
+  const imageProviders = useMemo(() => providers?.filter((p) => isImageOcrProvider(p)) ?? [], [providers])
 
-  const imageProviders = providers.filter((p) => isImageOcrProvider(p))
-
-  // 挂载时更新外部状态
-  // FIXME: Just keep the imageProvider always valid, so we don't need update it in this component.
-  useEffect(() => {
-    setProvider(imageProvider)
-  }, [imageProvider, setProvider])
-
-  const setImageProvider = (id: string) => {
-    const provider = imageProviders.find((p) => p.id === id)
-    if (!provider) {
-      logger.error(`Failed to find image provider by id: ${id}`)
-      window.toast.error(t('settings.tool.ocr.image.error.provider_not_found'))
-      return
-    }
-
-    setProvider(provider)
-    setImageProviderId(id)
-  }
+  const setImageProvider = useCallback(
+    (id: string) => {
+      setImageProviderId(id)
+    },
+    [setImageProviderId]
+  )
 
   const platformSupport = isMac || isWin
   const options = useMemo(() => {
-    if (!validProviders) return []
-    const platformFilter = platformSupport ? () => true : (p: ImageOcrProvider) => p.id !== BuiltinOcrProviderIds.system
-    const validFilter = (p: ImageOcrProvider) => validProviders.includes(p.id)
-    return imageProviders
-      .filter(platformFilter)
-      .filter(validFilter)
-      .map((p) => ({
-        value: p.id,
-        label: getOcrProviderName(p)
-      }))
-  }, [getOcrProviderName, imageProviders, platformSupport, validProviders])
+    return imageProviders.map((p) => ({
+      value: p.id,
+      label: getOcrProviderName(p)
+    }))
+  }, [getOcrProviderName, imageProviders])
 
-  const isSystem = imageProvider.id === BuiltinOcrProviderIds.system
+  const isSystem = imageProvider?.id === BuiltinOcrProviderIdMap.system
+
+  const content = useMemo(() => {
+    if (loading) {
+      return <Skeleton className="h-full w-50" />
+    }
+
+    if (error) {
+      return (
+        <Alert
+          color="danger"
+          title={t('ocr.provider.get.error.failed', { provider: imageProviderId })}
+          description={getErrorMessage(error)}
+        />
+      )
+    }
+
+    if (!imageProvider) {
+      return <Alert color="danger" title={t('ocr.error.provider.not_found')} />
+    }
+
+    return (
+      <>
+        {!platformSupport && isSystem && <ErrorTag message={t('settings.tool.ocr.error.not_system')} />}
+        {!loading && !error && (
+          <Select
+            value={imageProvider.id}
+            className="w-50"
+            onChange={(id: string) => setImageProvider(id)}
+            options={options}
+          />
+        )}
+        {!loading && error && (
+          <Alert color="danger" title={t('ocr.error.provider.get_providers')} description={getErrorMessage(error)} />
+        )}
+      </>
+    )
+  }, [error, imageProvider, imageProviderId, isSystem, loading, options, platformSupport, setImageProvider, t])
 
   return (
     <>
       <SettingRow>
         <SettingRowTitle>{t('settings.tool.ocr.image_provider')}</SettingRowTitle>
-        <div style={{ display: 'flex', gap: '8px', alignItems: 'center' }}>
-          {!platformSupport && isSystem && <ErrorTag message={t('settings.tool.ocr.error.not_system')} />}
-          <Skeleton isLoaded={!isLoading}>
-            {!error && (
-              <Select
-                value={imageProvider.id}
-                style={{ width: '200px' }}
-                onChange={(id: string) => setImageProvider(id)}
-                options={options}
-              />
-            )}
-            {error && (
-              <Alert
-                color="danger"
-                title={t('ocr.error.provider.get_providers')}
-                description={getErrorMessage(error)}
-              />
-            )}
-          </Skeleton>
-        </div>
+        <div className="flex items-center gap-2 self-stretch">{content}</div>
       </SettingRow>
     </>
   )

src/renderer/src/pages/settings/DocProcessSettings/OcrOVSettings.tsx

@@ -1,6 +1,4 @@
 import { Flex } from '@cherrystudio/ui'
-import { useOcrProvider } from '@renderer/hooks/useOcrProvider'
-import { BuiltinOcrProviderIds, isOcrOVProvider } from '@renderer/types'
 import { Tag } from 'antd'
 import { useTranslation } from 'react-i18next'
 
@@ -8,11 +6,6 @@ import { SettingRow, SettingRowTitle } from '..'
 
 export const OcrOVSettings = () => {
   const { t } = useTranslation()
-  const { provider } = useOcrProvider(BuiltinOcrProviderIds.ovocr)
-
-  if (!isOcrOVProvider(provider)) {
-    throw new Error('Not OV OCR provider.')
-  }
 
   return (
     <>

src/renderer/src/pages/settings/DocProcessSettings/OcrPpocrSettings.tsx

@@ -1,19 +1,26 @@
 import { ErrorBoundary } from '@renderer/components/ErrorBoundary'
-import { useOcrProvider } from '@renderer/hooks/useOcrProvider'
-import { BuiltinOcrProviderIds, isOcrPpocrProvider } from '@renderer/types'
+import type { OcrPpocrConfig, OcrPpocrProvider, OcrProviderConfig } from '@renderer/types'
+import { isOcrPpocrProvider } from '@renderer/types'
 import { Input } from 'antd'
 import { startTransition, useCallback, useState } from 'react'
 import { useTranslation } from 'react-i18next'
 
 import { SettingHelpLink, SettingHelpText, SettingHelpTextRow, SettingRow, SettingRowTitle } from '..'
 
-export const OcrPpocrSettings = () => {
+export const OcrPpocrSettings = ({
+  provider,
+  updateConfig: _updateConfig
+}: {
+  provider: OcrPpocrProvider
+  updateConfig: (config: Partial<OcrProviderConfig>) => Promise<void>
+}) => {
+  const updateConfig = _updateConfig as (config: Partial<OcrPpocrConfig>) => Promise<void>
+
   // Hack: Hard-coded for now
   const SERVING_DOC_URL = 'https://www.paddleocr.ai/latest/version3.x/deployment/serving.html'
   const AISTUDIO_URL = 'https://aistudio.baidu.com/pipeline/mine'
 
   const { t } = useTranslation()
-  const { provider, updateConfig } = useOcrProvider(BuiltinOcrProviderIds.paddleocr)
 
   if (!isOcrPpocrProvider(provider)) {
     throw new Error('Not PaddleOCR provider.')

src/renderer/src/pages/settings/DocProcessSettings/OcrProviderSettings.tsx

@@ -1,13 +1,23 @@
 // import { loggerService } from '@logger'
-import { Flex } from '@cherrystudio/ui'
+import { Avatar, Flex } from '@cherrystudio/ui'
+import IntelLogo from '@renderer/assets/images/providers/intel.png'
+import PaddleocrLogo from '@renderer/assets/images/providers/paddleocr.png'
+import TesseractLogo from '@renderer/assets/images/providers/Tesseract.js.png'
 import { ErrorBoundary } from '@renderer/components/ErrorBoundary'
 import { isMac, isWin } from '@renderer/config/constant'
 import { useTheme } from '@renderer/context/ThemeProvider'
-import { useOcrProviders } from '@renderer/hooks/useOcrProvider'
-import type { OcrProvider } from '@renderer/types'
-import { isBuiltinOcrProvider, isOcrSystemProvider } from '@renderer/types'
+import { useOcrProviders } from '@renderer/hooks/ocr/useOcrProviders'
+import type { OcrProvider, OcrProviderConfig } from '@renderer/types'
+import {
+  isBuiltinOcrProvider,
+  isOcrOVProvider,
+  isOcrPpocrProvider,
+  isOcrSystemProvider,
+  isOcrTesseractProvider
+} from '@renderer/types'
 import { Divider } from 'antd'
-import styled from 'styled-components'
+import { FileQuestionMarkIcon, MonitorIcon } from 'lucide-react'
+import { useMemo } from 'react'
 
 import { SettingGroup, SettingTitle } from '..'
 import { OcrOVSettings } from './OcrOVSettings'
@@ -18,34 +28,37 @@ import { OcrTesseractSettings } from './OcrTesseractSettings'
 // const logger = loggerService.withContext('OcrTesseractSettings')
 
 type Props = {
-  provider: OcrProvider
+  provider: OcrProvider | undefined | null
+  updateConfig: (config: Partial<OcrProviderConfig>) => Promise<void>
 }
 
-const OcrProviderSettings = ({ provider }: Props) => {
+const OcrProviderSettings = ({ provider, updateConfig }: Props) => {
   const { theme: themeMode } = useTheme()
-  const { OcrProviderLogo, getOcrProviderName } = useOcrProviders()
+  const { getOcrProviderName } = useOcrProviders()
 
-  if (!isWin && !isMac && isOcrSystemProvider(provider)) {
-    return null
-  }
-
-  const ProviderSettings = () => {
+  const settings = useMemo(() => {
+    if (!provider) return null
     if (isBuiltinOcrProvider(provider)) {
-      switch (provider.id) {
-        case 'tesseract':
-          return <OcrTesseractSettings />
-        case 'system':
-          return <OcrSystemSettings />
-        case 'paddleocr':
-          return <OcrPpocrSettings />
-        case 'ovocr':
-          return <OcrOVSettings />
-        default:
-          return null
+      if (isOcrTesseractProvider(provider)) {
+        return <OcrTesseractSettings provider={provider} updateConfig={updateConfig} />
       }
+      if (isOcrSystemProvider(provider)) {
+        return <OcrSystemSettings provider={provider} updateConfig={updateConfig} />
+      }
+      if (isOcrPpocrProvider(provider)) {
+        return <OcrPpocrSettings provider={provider} updateConfig={updateConfig} />
+      }
+      if (isOcrOVProvider(provider)) {
+        return <OcrOVSettings />
+      }
+      return null
     } else {
       throw new Error('Not supported OCR provider')
     }
+  }, [provider, updateConfig])
+
+  if (!provider || (!isWin && !isMac && isOcrSystemProvider(provider))) {
+    return null
   }
 
   return (
@@ -53,20 +66,29 @@ const OcrProviderSettings = ({ provider }: Props) => {
       <SettingTitle>
         <Flex className="items-center gap-2">
           <OcrProviderLogo provider={provider} />
-          <ProviderName> {getOcrProviderName(provider)}</ProviderName>
+          <span className="font-semibold text-sm"> {getOcrProviderName(provider)}</span>
         </Flex>
       </SettingTitle>
       <Divider style={{ width: '100%', margin: '10px 0' }} />
-      <ErrorBoundary>
-        <ProviderSettings />
-      </ErrorBoundary>
+      <ErrorBoundary>{settings}</ErrorBoundary>
     </SettingGroup>
   )
 }
 
-const ProviderName = styled.span`
-  font-size: 14px;
-  font-weight: 500;
-`
+const OcrProviderLogo = ({ provider: p, size = 14 }: { provider: OcrProvider; size?: number }) => {
+  if (isBuiltinOcrProvider(p)) {
+    switch (p.id) {
+      case 'tesseract':
+        return <Avatar src={TesseractLogo} style={{ width: size, height: size }} />
+      case 'system':
+        return <MonitorIcon size={size} />
+      case 'paddleocr':
+        return <Avatar src={PaddleocrLogo} style={{ width: size, height: size }} />
+      case 'ovocr':
+        return <Avatar src={IntelLogo} style={{ width: size, height: size }} />
+    }
+  }
+  return <FileQuestionMarkIcon size={size} />
+}
 
 export default OcrProviderSettings

src/renderer/src/pages/settings/DocProcessSettings/OcrSettings.tsx

@@ -1,42 +1,88 @@
-import { PictureOutlined } from '@ant-design/icons'
 import { ErrorBoundary } from '@renderer/components/ErrorBoundary'
 import { useTheme } from '@renderer/context/ThemeProvider'
-import { useOcrProviders } from '@renderer/hooks/useOcrProvider'
-import type { OcrProvider } from '@renderer/types'
-import type { TabsProps } from 'antd'
-import { Tabs } from 'antd'
+import { useOcrImageProvider } from '@renderer/hooks/ocr/useOcrImageProvider'
 import type { FC } from 'react'
-import { useState } from 'react'
 import { useTranslation } from 'react-i18next'
 
 import { SettingDivider, SettingGroup, SettingTitle } from '..'
 import OcrImageSettings from './OcrImageSettings'
 import OcrProviderSettings from './OcrProviderSettings'
 
+// const TabSchema = z.enum(['image'])
+// type Tab = z.infer<typeof TabSchema>
+// const isValidTab = (value: string): value is Tab => TabSchema.safeParse(value).success
+// type TabItem = {
+//   name: string
+//   value: Tab
+//   icon: ReactNode
+//   content: ReactNode
+// }
+
 const OcrSettings: FC = () => {
   const { t } = useTranslation()
   const { theme: themeMode } = useTheme()
-  const { imageProvider } = useOcrProviders()
-  const [provider, setProvider] = useState<OcrProvider>(imageProvider) // since default to image provider
+  const { imageProvider: provider, updateConfig } = useOcrImageProvider()
+  // const [activeTab, setActiveTab] = useState<Tab>('image')
+  // const provider = useMemo(() => {
+  //   switch (activeTab) {
+  //     case 'image':
+  //       return imageProvider
+  //     default:
+  //       return undefined
+  //   }
+  // }, [imageProvider, activeTab])
 
-  const tabs: TabsProps['items'] = [
-    {
-      key: 'image',
-      label: t('settings.tool.ocr.image.title'),
-      icon: <PictureOutlined />,
-      children: <OcrImageSettings setProvider={setProvider} />
-    }
-  ]
+  // const tabs = [
+  //   {
+  //     name: t('settings.tool.ocr.image.title'),
+  //     value: 'image',
+  //     icon: <PictureOutlined />,
+  //     content: <OcrImageSettings />
+  //   }
+  // ] satisfies TabItem[]
+
+  // const handleTabChange = useCallback((value: string) => {
+  //   if (isValidTab(value)) {
+  //     setActiveTab(value)
+  //   } else {
+  //     window.toast.error('Unexpected behavior: Not a valid tab.')
+  //   }
+  // }, [])
 
   return (
     <ErrorBoundary>
       <SettingGroup theme={themeMode}>
         <SettingTitle>{t('settings.tool.ocr.title')}</SettingTitle>
         <SettingDivider />
-        <Tabs defaultActiveKey="image" items={tabs} />
+        {/* <Tabs value={activeTab} onValueChange={handleTabChange}>
+          <TabsList>
+            {tabs.map((tab) => {
+              return (
+                <TabsTrigger key={tab.value} value={tab.value} className="cursor-pointer">
+                  <div className={cn('flex items-center gap-1', tab.value === activeTab && 'text-primary')}>
+                    {tab.icon}
+                    {tab.name}
+                  </div>
+                </TabsTrigger>
+              )
+            })}
+          </TabsList>
+          {tabs.map((tab) => {
+            return (
+              <TabsContent key={tab.value} value={tab.value} className="pl-1">
+                {tab.content}
+              </TabsContent>
+            )
+          })}
+        </Tabs> */}
+
+        {/* Since only image is supported for now, we just don't use tabs component,
+            but keep code of tabs. */}
+        <OcrImageSettings />
       </SettingGroup>
+
       <ErrorBoundary>
-        <OcrProviderSettings provider={provider} />
+        <OcrProviderSettings provider={provider} updateConfig={updateConfig} />
       </ErrorBoundary>
     </ErrorBoundary>
   )

src/renderer/src/pages/settings/DocProcessSettings/OcrSystemSettings.tsx

@@ -3,10 +3,8 @@ import { Flex } from '@cherrystudio/ui'
 import { InfoTooltip } from '@cherrystudio/ui'
 import { SuccessTag } from '@renderer/components/Tags/SuccessTag'
 import { isMac, isWin } from '@renderer/config/constant'
-import { useOcrProvider } from '@renderer/hooks/useOcrProvider'
 import useTranslate from '@renderer/hooks/useTranslate'
-import type { TranslateLanguageCode } from '@renderer/types'
-import { BuiltinOcrProviderIds, isOcrSystemProvider } from '@renderer/types'
+import type { OcrProviderConfig, OcrSystemConfig, OcrSystemProvider, TranslateLanguageCode } from '@renderer/types'
 import { Select } from 'antd'
 import { startTransition, useCallback, useMemo, useState } from 'react'
 import { useTranslation } from 'react-i18next'
@@ -15,21 +13,24 @@ import { SettingRow, SettingRowTitle } from '..'
 
 // const logger = loggerService.withContext('OcrSystemSettings')
 
-export const OcrSystemSettings = () => {
+export const OcrSystemSettings = ({
+  provider,
+  updateConfig: _updateConfig
+}: {
+  provider: OcrSystemProvider
+  updateConfig: (config: Partial<OcrProviderConfig>) => Promise<void>
+}) => {
+  const updateConfig = _updateConfig as (config: Partial<OcrSystemConfig>) => Promise<void>
+
   const { t } = useTranslation()
   // 和翻译自定义语言耦合了，应该还ok
   const { translateLanguages } = useTranslate()
-  const { provider, updateConfig } = useOcrProvider(BuiltinOcrProviderIds.system)
-
-  if (!isOcrSystemProvider(provider)) {
-    throw new Error('Not system provider.')
-  }
 
   if (!isWin && !isMac) {
     throw new Error('Only Windows and MacOS is supported.')
   }
 
-  const [langs, setLangs] = useState<TranslateLanguageCode[]>(provider.config?.langs ?? [])
+  const [langs, setLangs] = useState<TranslateLanguageCode[]>(provider.config.langs ?? [])
 
   // currently static
   const options = useMemo(

src/renderer/src/pages/settings/DocProcessSettings/OcrTesseractSettings.tsx

@@ -2,11 +2,10 @@
 import { Flex } from '@cherrystudio/ui'
 import { InfoTooltip } from '@cherrystudio/ui'
 import CustomTag from '@renderer/components/Tags/CustomTag'
-import { TESSERACT_LANG_MAP } from '@renderer/config/ocr'
-import { useOcrProvider } from '@renderer/hooks/useOcrProvider'
 import useTranslate from '@renderer/hooks/useTranslate'
-import type { TesseractLangCode } from '@renderer/types'
-import { BuiltinOcrProviderIds, isOcrTesseractProvider } from '@renderer/types'
+import type { OcrProviderConfig, OcrTesseractConfig, OcrTesseractProvider, TesseractLangCode } from '@renderer/types'
+import { objectEntries } from '@renderer/types'
+import { TESSERACT_LANG_MAP } from '@shared/config/ocr'
 import { Select } from 'antd'
 import { useCallback, useMemo, useState } from 'react'
 import { useTranslation } from 'react-i18next'
@@ -15,15 +14,18 @@ import { SettingRow, SettingRowTitle } from '..'
 
 // const logger = loggerService.withContext('OcrTesseractSettings')
 
-export const OcrTesseractSettings = () => {
+export const OcrTesseractSettings = ({
+  provider,
+  updateConfig: _updateConfig
+}: {
+  provider: OcrTesseractProvider
+  updateConfig: (config: Partial<OcrProviderConfig>) => Promise<void>
+}) => {
+  const updateConfig = _updateConfig as (config: Partial<OcrTesseractConfig>) => Promise<void>
+
   const { t } = useTranslation()
-  const { provider, updateConfig } = useOcrProvider(BuiltinOcrProviderIds.tesseract)
 
-  if (!isOcrTesseractProvider(provider)) {
-    throw new Error('Not tesseract provider.')
-  }
-
-  const [langs, setLangs] = useState<Partial<Record<TesseractLangCode, boolean>>>(provider.config?.langs ?? {})
+  const [langs, setLangs] = useState<OcrTesseractConfig['langs'] | undefined>(provider?.config.langs)
   const { translateLanguages } = useTranslate()
 
   const options = useMemo(
@@ -37,14 +39,12 @@ export const OcrTesseractSettings = () => {
     [translateLanguages]
   )
 
-  // TODO: type safe objectKeys
-  const value = useMemo(
-    () =>
-      Object.entries(langs)
-        .filter(([, enabled]) => enabled)
-        .map(([lang]) => lang) as TesseractLangCode[],
-    [langs]
-  )
+  const selectedLangs = useMemo(() => {
+    if (!langs) return
+    return objectEntries(langs)
+      .filter(([, enabled]) => enabled)
+      .map(([lang]) => lang) as TesseractLangCode[]
+  }, [langs])
 
   const onChange = useCallback((values: TesseractLangCode[]) => {
     setLangs(() => {
@@ -69,11 +69,11 @@ export const OcrTesseractSettings = () => {
             <InfoTooltip content={t('settings.tool.ocr.tesseract.langs_tooltip')} />
           </Flex>
         </SettingRowTitle>
-        <div style={{ display: 'flex', gap: '8px' }}>
+        <div className="flex gap-2">
           <Select
             mode="multiple"
             style={{ minWidth: 200 }}
-            value={value}
+            value={selectedLangs}
             options={options}
             maxTagCount={1}
             onChange={onChange}

src/renderer/src/pages/settings/DocProcessSettings/PreprocessProviderSettings.tsx

@@ -141,6 +141,41 @@ const PreprocessProviderSettings: FC<Props> = ({ provider: _provider }) => {
           </Flex>
         </>
       )}
+
+      {/* 这部分看起来暂时用不上了 */}
+      {/* {hasObjectKey(preprocessProvider, 'options') && preprocessProvider.id === 'system' && (
+        <>
+          <SettingDivider style={{ marginTop: 15, marginBottom: 12 }} />
+          <SettingRow>
+            <SettingRowTitle>{t('settings.tool.preprocess.mac_system_ocr_options.mode.title')}</SettingRowTitle>
+            <Segmented
+              options={[
+                {
+                  label: t('settings.tool.preprocess.mac_system_ocr_options.mode.accurate'),
+                  value: 1
+                },
+                {
+                  label: t('settings.tool.preprocess.mac_system_ocr_options.mode.fast'),
+                  value: 0
+                }
+              ]}
+              value={options.recognitionLevel}
+              onChange={(value) => onUpdateOptions('recognitionLevel', value)}
+            />
+          </SettingRow>
+          <SettingDivider style={{ marginTop: 15, marginBottom: 12 }} />
+          <SettingRow>
+            <SettingRowTitle>{t('settings.tool.preprocess.mac_system_ocr_options.min_confidence')}</SettingRowTitle>
+            <InputNumber
+              value={options.minConfidence}
+              onChange={(value) => onUpdateOptions('minConfidence', value)}
+              min={0}
+              max={1}
+              step={0.1}
+            />
+          </SettingRow>
+        </>
+      )} */}
     </>
   )
 }

src/renderer/src/pages/settings/TranslateSettingsPopup/CustomLanguageModal.tsx

@@ -144,6 +144,9 @@ const CustomLanguageModal = ({ isOpen, editingCustomLanguage, onAdd, onEdit, onC
           rules={[
             { required: true, message: t('settings.translate.custom.error.langCode.empty') },
             {
+              // TODO: use TranslateLanguageCodeSchema here. Modify it when migrating to new UI.
+              // NOTE: Since any uppercase will be converted to lowercase before it's save to indexedDB,
+              //       it's safe to replace it with case sensitive TranslateLanguageCodeSchema.
               pattern: /^[a-zA-Z]{2,3}(-[a-zA-Z]{2,3})?$/,
               message: t('settings.translate.custom.error.langCode.invalid')
             },

src/renderer/src/pages/translate/TranslatePage.tsx

@@ -9,10 +9,10 @@ import { isEmbeddingModel, isRerankModel, isTextToImageModel } from '@renderer/c
 import { LanguagesEnum, UNKNOWN } from '@renderer/config/translate'
 import { useCodeStyle } from '@renderer/context/CodeStyleProvider'
 import db from '@renderer/databases'
+import { useOcr } from '@renderer/hooks/ocr/useOcr'
 import { useDefaultModel } from '@renderer/hooks/useAssistant'
 import { useDrag } from '@renderer/hooks/useDrag'
 import { useFiles } from '@renderer/hooks/useFiles'
-import { useOcr } from '@renderer/hooks/useOcr'
 import { useTemporaryValue } from '@renderer/hooks/useTemporaryValue'
 import { useTimer } from '@renderer/hooks/useTimer'
 import useTranslate from '@renderer/hooks/useTranslate'
@@ -29,7 +29,7 @@ import {
   type TranslateHistory,
   type TranslateLanguage
 } from '@renderer/types'
-import { getFileExtension, isTextFile, runAsyncFunction, uuid } from '@renderer/utils'
+import { getErrorMessage, getFileExtension, isTextFile, runAsyncFunction, uuid } from '@renderer/utils'
 import { abortCompletion } from '@renderer/utils/abortController'
 import { isAbortError } from '@renderer/utils/error'
 import { formatErrorMessage } from '@renderer/utils/error'
@@ -671,7 +671,7 @@ const TranslatePage: FC = () => {
           await processFile(selectedFile)
         } catch (error) {
           logger.error('onPaste:', error as Error)
-          window.toast.error(t('chat.input.file_error'))
+          window.toast.error({ title: t('chat.input.file_error'), description: getErrorMessage(error) })
         }
       }
       setIsProcessing(false)

src/renderer/src/services/ocr/OcrService.ts

@@ -1,8 +1,5 @@
 import { loggerService } from '@logger'
-import type { OcrProvider, OcrResult, SupportedOcrFile } from '@renderer/types'
-import { isOcrApiProvider } from '@renderer/types'
-
-import { OcrApiClientFactory } from './clients/OcrApiClientFactory'
+import type { OcrParams, OcrResult, SupportedOcrFile } from '@renderer/types'
 
 const logger = loggerService.withContext('renderer:OcrService')
 
@@ -13,12 +10,7 @@ const logger = loggerService.withContext('renderer:OcrService')
  * @returns ocr result
  * @throws {Error}
  */
-export const ocr = async (file: SupportedOcrFile, provider: OcrProvider): Promise<OcrResult> => {
+export const ocr = async (file: SupportedOcrFile, params: OcrParams): Promise<OcrResult> => {
   logger.info(`ocr file ${file.path}`)
-  if (isOcrApiProvider(provider)) {
-    const client = OcrApiClientFactory.create(provider)
-    return client.ocr(file, provider.config)
-  } else {
-    return window.api.ocr.ocr(file, provider)
-  }
+  return window.api.ocr.ocr(file, params)
 }

src/renderer/src/services/ocr/clients/OcrApiClientFactory.ts

@@ -1,27 +1,29 @@
 import { loggerService } from '@logger'
-import type { OcrApiProvider } from '@renderer/types'
+import type { OcrApiProvider, OcrApiProviderConfig } from '@renderer/types'
 
 import type { OcrBaseApiClient } from './OcrBaseApiClient'
 import { OcrExampleApiClient } from './OcrExampleApiClient'
 
 const logger = loggerService.withContext('OcrApiClientFactory')
 
+// Not being used for now.
+// TODO: Migrate to main in the future.
 export class OcrApiClientFactory {
   /**
    * Create an ApiClient instance for the given provider
    * 为给定的提供者创建ApiClient实例
    */
-  static create(provider: OcrApiProvider): OcrBaseApiClient {
+  static create(provider: OcrApiProvider, config: OcrApiProviderConfig): OcrBaseApiClient {
     logger.debug(`Creating ApiClient for provider:`, {
       id: provider.id,
-      config: provider.config
+      config
     })
 
     let instance: OcrBaseApiClient
 
     // Extend other clients here
     // eslint-disable-next-line prefer-const
-    instance = new OcrExampleApiClient(provider)
+    instance = new OcrExampleApiClient(provider, config)
 
     return instance
   }

src/renderer/src/services/ocr/clients/OcrBaseApiClient.ts

@@ -1,26 +1,31 @@
 import { cacheService } from '@data/CacheService'
-import type { OcrApiProvider, OcrHandler } from '@renderer/types'
+import type { OcrApiProvider, OcrApiProviderConfig, OcrHandler } from '@renderer/types'
+
+// Not being used for now.
+// TODO: Migrate to main in the future.
 export abstract class OcrBaseApiClient {
   public provider: OcrApiProvider
+  public config: OcrApiProviderConfig
   protected host: string
   protected apiKey: string
 
-  constructor(provider: OcrApiProvider) {
+  constructor(provider: OcrApiProvider, config: OcrApiProviderConfig) {
     this.provider = provider
     this.host = this.getHost()
     this.apiKey = this.getApiKey()
+    this.config = config
   }
 
   abstract ocr: OcrHandler
 
   // copy from BaseApiClient
   public getHost(): string {
-    return this.provider.config.api.apiHost
+    return this.config.api.apiHost
   }
 
   // copy from BaseApiClient
   public getApiKey() {
-    const keys = this.provider.config.api.apiKey.split(',').map((key) => key.trim())
+    const keys = this.config.api.apiKey.split(',').map((key) => key.trim())
     const keyName = `ocr_provider:${this.provider.id}:last_used_key`
 
     if (keys.length === 1) {

src/renderer/src/services/ocr/clients/OcrExampleApiClient.ts

@@ -1,12 +1,14 @@
-import type { OcrApiProvider, SupportedOcrFile } from '@renderer/types'
+import type { OcrApiProvider, OcrApiProviderConfig, SupportedOcrFile } from '@renderer/types'
 
 import { OcrBaseApiClient } from './OcrBaseApiClient'
 
 export type OcrExampleProvider = OcrApiProvider
 
+// Not being used for now.
+// TODO: Migrate to main in the future.
 export class OcrExampleApiClient extends OcrBaseApiClient {
-  constructor(provider: OcrApiProvider) {
-    super(provider)
+  constructor(provider: OcrApiProvider, config: OcrApiProviderConfig) {
+    super(provider, config)
   }
 
   public ocr = async (file: SupportedOcrFile) => {

src/renderer/src/store/migrate.ts

@@ -11,7 +11,6 @@ import {
   isNotSupportedTextDelta,
   SYSTEM_MODELS
 } from '@renderer/config/models'
-import { BUILTIN_OCR_PROVIDERS, BUILTIN_OCR_PROVIDERS_MAP, DEFAULT_OCR_PROVIDER } from '@renderer/config/ocr'
 import {
   isSupportArrayContentProvider,
   isSupportDeveloperRoleProvider,
@@ -33,7 +32,10 @@ import type {
 } from '@renderer/types'
 import { isSystemProvider, SystemProviderIds } from '@renderer/types'
 import { getDefaultGroupName, getLeadingEmoji, runAsyncFunction, uuid } from '@renderer/utils'
+import { getDefaultOcrProvider } from '@renderer/utils/ocr'
 import { defaultByPassRules } from '@shared/config/constant'
+import { BUILTIN_OCR_PROVIDERS } from '@shared/config/ocr'
+import { INITIAL_BUILTIN_OCR_PROVIDER_MAP } from '@shared/config/ocr'
 import { TRANSLATE_PROMPT } from '@shared/config/prompts'
 import { DefaultPreferences } from '@shared/data/preference/preferenceSchemas'
 import { UpgradeChannel } from '@shared/data/preference/preferenceTypes'
@@ -2235,7 +2237,7 @@ const migrateConfig = {
     try {
       state.ocr = {
         providers: BUILTIN_OCR_PROVIDERS,
-        imageProviderId: DEFAULT_OCR_PROVIDER.image.id
+        imageProviderId: getDefaultOcrProvider('image').id
       }
       state.translate.translateInput = ''
       return state
@@ -2246,7 +2248,7 @@ const migrateConfig = {
   },
   '138': (state: RootState) => {
     try {
-      addOcrProvider(state, BUILTIN_OCR_PROVIDERS_MAP.system)
+      addOcrProvider(state, INITIAL_BUILTIN_OCR_PROVIDER_MAP.system)
       return state
     } catch (error) {
       logger.error('migrate 138 error', error as Error)
@@ -2426,7 +2428,7 @@ const migrateConfig = {
   },
   '148': (state: RootState) => {
     try {
-      addOcrProvider(state, BUILTIN_OCR_PROVIDERS_MAP.paddleocr)
+      addOcrProvider(state, INITIAL_BUILTIN_OCR_PROVIDER_MAP.paddleocr)
       return state
     } catch (error) {
       logger.error('migrate 148 error', error as Error)
@@ -2675,7 +2677,7 @@ const migrateConfig = {
   },
   '163': (state: RootState) => {
     try {
-      addOcrProvider(state, BUILTIN_OCR_PROVIDERS_MAP.ovocr)
+      addOcrProvider(state, INITIAL_BUILTIN_OCR_PROVIDER_MAP.ovocr)
       state.llm.providers.forEach((provider) => {
         if (provider.id === 'cherryin') {
           provider.anthropicApiHost = 'https://open.cherryin.net'

src/renderer/src/store/ocr.ts

@@ -1,7 +1,8 @@
-import type { PayloadAction } from '@reduxjs/toolkit'
+/** @deprecated All migrated. */
 import { createSlice } from '@reduxjs/toolkit'
-import { BUILTIN_OCR_PROVIDERS, DEFAULT_OCR_PROVIDER } from '@renderer/config/ocr'
-import type { OcrProvider, OcrProviderConfig } from '@renderer/types'
+import type { OcrProvider } from '@renderer/types'
+import { getDefaultOcrProvider } from '@renderer/utils/ocr'
+import { BUILTIN_OCR_PROVIDERS } from '@shared/config/ocr'
 
 export interface OcrState {
   providers: OcrProvider[]
@@ -10,7 +11,7 @@ export interface OcrState {
 
 const initialState: OcrState = {
   providers: BUILTIN_OCR_PROVIDERS,
-  imageProviderId: DEFAULT_OCR_PROVIDER.image.id
+  imageProviderId: getDefaultOcrProvider('image').id
 }
 
 const ocrSlice = createSlice({
@@ -22,48 +23,48 @@ const ocrSlice = createSlice({
     }
   },
   reducers: {
-    setOcrProviders(state, action: PayloadAction<OcrProvider[]>) {
-      state.providers = action.payload
-    },
-    addOcrProvider(state, action: PayloadAction<OcrProvider>) {
-      state.providers.push(action.payload)
-    },
-    removeOcrProvider(state, action: PayloadAction<string>) {
-      state.providers = state.providers.filter((provider) => provider.id !== action.payload)
-    },
-    updateOcrProvider(state, action: PayloadAction<Partial<OcrProvider>>) {
-      const index = state.providers.findIndex((provider) => provider.id === action.payload.id)
-      if (index !== -1) {
-        Object.assign(state.providers[index], action.payload)
-      }
-    },
-    updateOcrProviderConfig(
-      state,
-      action: PayloadAction<{ id: string; update: Omit<Partial<OcrProviderConfig>, 'id'> }>
-    ) {
-      const index = state.providers.findIndex((provider) => provider.id === action.payload.id)
-      if (index !== -1) {
-        if (!state.providers[index].config) {
-          state.providers[index].config = {}
-        }
-        Object.assign(state.providers[index].config, action.payload.update)
-      }
-    },
-    setImageOcrProviderId(state, action: PayloadAction<string>) {
-      state.imageProviderId = action.payload
-    }
+    // setOcrProviders(state, action: PayloadAction<OcrProvider[]>) {
+    //   state.providers = action.payload
+    // },
+    // addOcrProvider(state, action: PayloadAction<OcrProvider>) {
+    //   state.providers.push(action.payload)
+    // },
+    // removeOcrProvider(state, action: PayloadAction<string>) {
+    //   state.providers = state.providers.filter((provider) => provider.id !== action.payload)
+    // },
+    // updateOcrProvider(state, action: PayloadAction<Partial<OcrProvider>>) {
+    //   const index = state.providers.findIndex((provider) => provider.id === action.payload.id)
+    //   if (index !== -1) {
+    //     Object.assign(state.providers[index], action.payload)
+    //   }
+    // },
+    // updateOcrProviderConfig(
+    //   state,
+    //   action: PayloadAction<{ id: string; update: Omit<Partial<OcrProviderConfig>, 'id'> }>
+    // ) {
+    //   const index = state.providers.findIndex((provider) => provider.id === action.payload.id)
+    //   if (index !== -1) {
+    //     if (!state.providers[index].config) {
+    //       state.providers[index].config = {}
+    //     }
+    //     Object.assign(state.providers[index].config, action.payload.update)
+    //   }
+    // },
+    // setImageOcrProviderId(state, action: PayloadAction<string>) {
+    //   state.imageProviderId = action.payload
+    // }
   }
 })
 
-export const {
-  setOcrProviders,
-  addOcrProvider,
-  removeOcrProvider,
-  updateOcrProvider,
-  updateOcrProviderConfig,
-  setImageOcrProviderId
-} = ocrSlice.actions
+// export const {
+// setOcrProviders,
+// addOcrProvider,
+// removeOcrProvider,
+// updateOcrProvider,
+// updateOcrProviderConfig,
+// setImageOcrProviderId
+// } = ocrSlice.actions
 
-export const { getImageProvider } = ocrSlice.selectors
+// export const { getImageProvider } = ocrSlice.selectors
 
 export default ocrSlice.reducer

src/renderer/src/types/index.ts

@@ -14,6 +14,7 @@ import type { KnowledgeBase, KnowledgeReference } from './knowledge'
 import type { MCPConfigSample, McpServerType } from './mcp'
 import type { Message } from './newMessage'
 import type { BaseTool, MCPTool } from './tool'
+import { type TranslateLanguage } from './translate'
 
 export * from './agent'
 export * from './apiModels'
@@ -23,6 +24,7 @@ export * from './mcp'
 export * from './notification'
 export * from './ocr'
 export * from './provider'
+export * from './translate'
 
 export type Assistant = {
   id: string
@@ -494,48 +496,6 @@ export type GenerateImageResponse = {
   images: string[]
 }
 
-// 为了支持自定义语言，设置为string别名
-/** zh-cn, en-us, etc. */
-export type TranslateLanguageCode = string
-
-// langCode应当能够唯一确认一种语言
-export type TranslateLanguage = {
-  value: string
-  langCode: TranslateLanguageCode
-  label: () => string
-  emoji: string
-}
-
-export interface TranslateHistory {
-  id: string
-  sourceText: string
-  targetText: string
-  sourceLanguage: TranslateLanguageCode
-  targetLanguage: TranslateLanguageCode
-  createdAt: string
-  /** 收藏状态 */
-  star?: boolean
-}
-
-export type CustomTranslateLanguage = {
-  id: string
-  langCode: TranslateLanguageCode
-  value: string
-  emoji: string
-}
-
-export const AutoDetectionMethods = {
-  franc: 'franc',
-  llm: 'llm',
-  auto: 'auto'
-} as const
-
-export type AutoDetectionMethod = keyof typeof AutoDetectionMethods
-
-export const isAutoDetectionMethod = (method: string): method is AutoDetectionMethod => {
-  return Object.hasOwn(AutoDetectionMethods, method)
-}
-
 // by fullex @ data refactor
 // export type SidebarIcon =
 //   | 'assistants'

src/renderer/src/types/ocr.ts

@@ -1,208 +0,0 @@
-import type Tesseract from 'tesseract.js'
-
-import type { FileMetadata, ImageFileMetadata, TranslateLanguageCode } from '.'
-import { isImageFileMetadata } from '.'
-
-export const BuiltinOcrProviderIds = {
-  tesseract: 'tesseract',
-  system: 'system',
-  paddleocr: 'paddleocr',
-  ovocr: 'ovocr'
-} as const
-
-export type BuiltinOcrProviderId = keyof typeof BuiltinOcrProviderIds
-
-export const isBuiltinOcrProviderId = (id: string): id is BuiltinOcrProviderId => {
-  return Object.hasOwn(BuiltinOcrProviderIds, id)
-}
-
-// extensible
-export const OcrProviderCapabilities = {
-  image: 'image'
-  // pdf: 'pdf'
-} as const
-
-export type OcrProviderCapability = keyof typeof OcrProviderCapabilities
-
-export const isOcrProviderCapability = (cap: string): cap is OcrProviderCapability => {
-  return Object.hasOwn(OcrProviderCapabilities, cap)
-}
-
-export type OcrProviderCapabilityRecord = Partial<Record<OcrProviderCapability, boolean>>
-
-// OCR models and providers share the same type definition.
-// A provider can offer capabilities to process multiple file types,
-// while a model belonging to that provider may be limited to processing only one specific file type.
-export type OcrModelCapabilityRecord = OcrProviderCapabilityRecord
-
-export interface OcrModel {
-  id: string
-  name: string
-  providerId: string
-  capabilities: OcrModelCapabilityRecord
-}
-
-/**
- * Extend this type to define provider-specefic config types.
- */
-export type OcrProviderApiConfig = {
-  apiKey: string
-  apiHost: string
-  apiVersion?: string
-}
-
-export const isOcrProviderApiConfig = (config: unknown): config is OcrProviderApiConfig => {
-  return (
-    typeof config === 'object' &&
-    config !== null &&
-    'apiKey' in config &&
-    typeof config.apiKey === 'string' &&
-    'apiHost' in config &&
-    typeof config.apiHost === 'string' &&
-    (!('apiVersion' in config) || typeof config.apiVersion === 'string')
-  )
-}
-
-/**
- * For future. Model based ocr, api based ocr. May different api client.
- *
- * Extend this type to define provider-specific config types.
- */
-export type OcrProviderBaseConfig = {
-  /** Not used for now. Could safely remove. */
-  api?: OcrProviderApiConfig
-  /** Not used for now. Could safely remove. */
-  models?: OcrModel[]
-  /** Not used for now. Could safely remove. */
-  enabled?: boolean
-}
-
-export type OcrProviderConfig = OcrApiProviderConfig | OcrTesseractConfig | OcrSystemConfig | OcrPpocrConfig
-
-export type OcrProvider = {
-  id: string
-  name: string
-  capabilities: OcrProviderCapabilityRecord
-  config?: OcrProviderBaseConfig
-}
-
-export type OcrApiProviderConfig = OcrProviderBaseConfig & {
-  api: OcrProviderApiConfig
-}
-
-export type OcrApiProvider = OcrProvider & {
-  config: OcrApiProviderConfig
-}
-
-export const isOcrApiProvider = (p: OcrProvider): p is OcrApiProvider => {
-  return !!(p.config && p.config.api && isOcrProviderApiConfig(p.config.api))
-}
-
-export type BuiltinOcrProvider = OcrProvider & {
-  id: BuiltinOcrProviderId
-}
-
-export const isBuiltinOcrProvider = (p: OcrProvider): p is BuiltinOcrProvider => {
-  return isBuiltinOcrProviderId(p.id)
-}
-
-// Not sure compatible api endpoint exists. May not support custom ocr provider
-export type CustomOcrProvider = OcrProvider & {
-  id: Exclude<string, BuiltinOcrProviderId>
-}
-
-export type ImageOcrProvider = OcrProvider & {
-  capabilities: OcrProviderCapabilityRecord & {
-    [OcrProviderCapabilities.image]: true
-  }
-}
-
-// export type PdfOcrProvider = OcrProvider & {
-//   capabilities: OcrProviderCapabilityRecord & {
-//     [OcrProviderCapabilities.pdf]: true
-//   }
-// }
-
-export const isImageOcrProvider = (p: OcrProvider): p is ImageOcrProvider => {
-  return p.capabilities.image === true
-}
-
-export type SupportedOcrFile = ImageFileMetadata
-
-export const isSupportedOcrFile = (file: FileMetadata): file is SupportedOcrFile => {
-  return isImageFileMetadata(file)
-}
-
-export type OcrResult = {
-  text: string
-}
-
-export type OcrHandler = (file: SupportedOcrFile, options?: OcrProviderBaseConfig) => Promise<OcrResult>
-
-export type OcrImageHandler = (file: ImageFileMetadata, options?: OcrProviderBaseConfig) => Promise<OcrResult>
-
-// Tesseract Types
-export type OcrTesseractConfig = OcrProviderBaseConfig & {
-  langs?: Partial<Record<TesseractLangCode, boolean>>
-}
-
-export type OcrTesseractProvider = {
-  id: 'tesseract'
-  config: OcrTesseractConfig
-} & ImageOcrProvider &
-  BuiltinOcrProvider
-
-export const isOcrTesseractProvider = (p: OcrProvider): p is OcrTesseractProvider => {
-  return p.id === BuiltinOcrProviderIds.tesseract
-}
-
-export type TesseractLangCode = Tesseract.LanguageCode
-
-// System Types
-export type OcrSystemConfig = OcrProviderBaseConfig & {
-  langs?: TranslateLanguageCode[]
-}
-
-export type OcrSystemProvider = {
-  id: 'system'
-  config: OcrSystemConfig
-} & ImageOcrProvider &
-  // PdfOcrProvider &
-  BuiltinOcrProvider
-
-export const isOcrSystemProvider = (p: OcrProvider): p is OcrSystemProvider => {
-  return p.id === BuiltinOcrProviderIds.system
-}
-
-// PaddleOCR Types
-export type OcrPpocrConfig = OcrProviderBaseConfig & {
-  apiUrl?: string
-  accessToken?: string
-}
-
-export type OcrPpocrProvider = {
-  id: 'paddleocr'
-  config: OcrPpocrConfig
-} & ImageOcrProvider &
-  // PdfOcrProvider &
-  BuiltinOcrProvider
-
-export const isOcrPpocrProvider = (p: OcrProvider): p is OcrPpocrProvider => {
-  return p.id === BuiltinOcrProviderIds.paddleocr
-}
-
-// OV OCR Types
-export type OcrOvConfig = OcrProviderBaseConfig & {
-  langs?: TranslateLanguageCode[]
-}
-
-export type OcrOvProvider = {
-  id: 'ovocr'
-  config: OcrOvConfig
-} & ImageOcrProvider &
-  // PdfOcrProvider &
-  BuiltinOcrProvider
-
-export const isOcrOVProvider = (p: OcrProvider): p is OcrOvProvider => {
-  return p.id === BuiltinOcrProviderIds.ovocr
-}

src/renderer/src/types/ocr/api.ts

@@ -0,0 +1,61 @@
+import * as z from 'zod'
+
+import { DbOcrProviderSchema } from './data'
+import { OcrProviderSchema } from './provider/base'
+import { OcrProviderNameSchema } from './provider/base'
+import { OcrProviderIdSchema } from './provider/base'
+import { OcrProviderConfigSchema } from './provider/base'
+
+// ==========================================================
+//    API layer Types
+// ==========================================================
+
+export type ListOcrProvidersQuery = { registered?: boolean }
+export const ListOcrProvidersResponseSchema = z.object({
+  data: z.array(DbOcrProviderSchema)
+})
+export type ListOcrProvidersResponse = z.infer<typeof ListOcrProvidersResponseSchema>
+export const GetOcrProviderResponseSchema = z.object({
+  data: DbOcrProviderSchema
+})
+export type GetOcrProviderResponse = z.infer<typeof GetOcrProviderResponseSchema>
+
+/**
+ * Request payload for updating an OCR provider.
+ * Only the following fields are modifiable:
+ * - `name`: provider display name
+ * - `config`: provider-specific configuration object (all properties optional)
+ */
+export const UpdateOcrProviderRequestSchema = z.object({
+  id: OcrProviderIdSchema,
+  name: OcrProviderNameSchema.optional(),
+  config: OcrProviderConfigSchema.partial().optional()
+})
+
+export type UpdateOcrProviderRequest = z.infer<typeof UpdateOcrProviderRequestSchema>
+
+export const UpdateOcrProviderResponseSchema = z.object({
+  data: DbOcrProviderSchema
+})
+
+export type UpdateOcrProviderResponse = z.infer<typeof UpdateOcrProviderResponseSchema>
+
+export const CreateOcrProviderRequestSchema = OcrProviderSchema
+
+export type CreateOcrProviderRequest = z.infer<typeof CreateOcrProviderRequestSchema>
+
+export const CreateOcrProviderResponseSchema = z.object({
+  data: DbOcrProviderSchema
+})
+
+export type CreateOcrProviderResponse = z.infer<typeof CreateOcrProviderResponseSchema>
+
+export const ReplaceOcrProviderRequestSchema = OcrProviderSchema
+
+export type ReplaceOcrProviderRequest = z.infer<typeof ReplaceOcrProviderRequestSchema>
+
+export const ReplaceOcrProviderResponseSchema = z.object({
+  data: DbOcrProviderSchema
+})
+
+export type ReplaceOcrProviderResponse = z.infer<typeof ReplaceOcrProviderResponseSchema>

src/renderer/src/types/ocr/base.ts

@@ -0,0 +1,20 @@
+import type { FileMetadata, ImageFileMetadata, OcrProviderConfig } from '..'
+import { isImageFileMetadata } from '..'
+
+export type SupportedOcrFile = ImageFileMetadata
+
+export const isSupportedOcrFile = (file: FileMetadata): file is SupportedOcrFile => {
+  return isImageFileMetadata(file)
+}
+
+export type OcrParams = {
+  providerId: string
+}
+
+export type OcrResult = {
+  text: string
+}
+
+export type OcrHandler = (file: SupportedOcrFile, config?: OcrProviderConfig) => Promise<OcrResult>
+
+export type OcrImageHandler = (file: ImageFileMetadata, config?: OcrProviderConfig) => Promise<OcrResult>

src/renderer/src/types/ocr/business.ts

@@ -0,0 +1,31 @@
+import type { DbOcrProviderCreate } from './data'
+import type { DbOcrProviderUpdate } from './data'
+import type { DbOcrProviderReplace } from './data'
+import type { DbOcrProviderKey } from './data'
+import type { DbOcrProvider } from './data'
+
+// ==========================================================
+//    Business layer Types
+// ==========================================================
+/**
+ * Business-level representation of an OCR provider.
+ * Mirrors the data layer but is intended for use in domain/business logic.
+ */
+
+export type OcrProviderBusiness = DbOcrProvider /**
+ * Business-level representation of an OCR provider creation payload.
+ */
+
+export type OcrProviderCreateBusiness = DbOcrProviderCreate /**
+ * Business-level representation of an OCR provider update payload.
+ */
+
+export type OcrProviderUpdateBusiness = DbOcrProviderUpdate /**
+ * Business-level representation of an OCR provider replacement payload.
+ */
+
+export type OcrProviderReplaceBusiness = DbOcrProviderReplace /**
+ * Business-level key type for identifying an OCR provider.
+ */
+
+export type OcrProviderKeyBusiness = DbOcrProviderKey

src/renderer/src/types/ocr/data.ts

@@ -0,0 +1,25 @@
+import * as z from 'zod'
+
+import { type UpdateOcrProviderRequest } from './api'
+import { type OcrProvider } from './provider/base'
+import { OcrProviderSchema } from './provider/base'
+
+// ==========================================================
+//    Data layer Types
+//
+//    NOTE: Timestamp operations are not exposed to outside.
+// ==========================================================
+export const TimestampExtendShape = {
+  createdAt: z.number().nullable(),
+  updatedAt: z.number().nullable()
+}
+export const DbOcrProviderSchema = OcrProviderSchema.extend(TimestampExtendShape)
+export type DbOcrProvider = z.infer<typeof DbOcrProviderSchema>
+export function isDbOcrProvider(p: unknown): p is DbOcrProvider {
+  return DbOcrProviderSchema.safeParse(p).success
+}
+
+export type DbOcrProviderCreate = OcrProvider
+export type DbOcrProviderUpdate = UpdateOcrProviderRequest
+export type DbOcrProviderReplace = OcrProvider
+export type DbOcrProviderKey = DbOcrProvider['id']

src/renderer/src/types/ocr/index.ts

@@ -0,0 +1,6 @@
+export * from './api'
+export * from './base'
+export * from './business'
+export * from './data'
+export * from './model'
+export * from './provider'

src/renderer/src/types/ocr/model.ts

@@ -0,0 +1,17 @@
+import * as z from 'zod'
+
+import type { OcrProviderCapabilityRecord } from './provider/base'
+import { OcrProviderCapabilityRecordSchema } from './provider/base'
+
+// OCR models and providers share the same type definition.
+// A provider can offer capabilities to process multiple file types,
+// while a model belonging to that provider may be limited to processing only one specific file type.
+
+export type OcrModelCapabilityRecord = OcrProviderCapabilityRecord
+export const OcrModelSchema = z.object({
+  id: z.string(),
+  name: z.string(),
+  providerId: z.string(),
+  capabilities: OcrProviderCapabilityRecordSchema
+})
+export type OcrModel = z.infer<typeof OcrModelSchema>

src/renderer/src/types/ocr/provider/base.ts

@@ -0,0 +1,118 @@
+import { objectValues } from '@types'
+import * as z from 'zod'
+
+export const BuiltinOcrProviderIdMap = {
+  tesseract: 'tesseract',
+  system: 'system',
+  paddleocr: 'paddleocr',
+  ovocr: 'ovocr'
+} as const satisfies Record<string, BuiltinOcrProviderId>
+
+export const BuiltinOcrProviderIds = Object.freeze(objectValues(BuiltinOcrProviderIdMap))
+
+export const BuiltinOcrProviderIdSchema = z.enum(['tesseract', 'system', 'paddleocr', 'ovocr'])
+
+export type BuiltinOcrProviderId = z.infer<typeof BuiltinOcrProviderIdSchema>
+
+export const isBuiltinOcrProviderId = (id: string): id is BuiltinOcrProviderId => {
+  return BuiltinOcrProviderIdSchema.safeParse(id).success
+} // extensible
+
+export const OcrProviderCapabilities = {
+  image: 'image'
+  // pdf: 'pdf'
+} as const satisfies Record<string, OcrProviderCapability>
+
+export const OcrProviderCapabilitySchema = z.enum(['image'])
+
+export type OcrProviderCapability = z.infer<typeof OcrProviderCapabilitySchema>
+
+export const isOcrProviderCapability = (cap: string): cap is OcrProviderCapability => {
+  return OcrProviderCapabilitySchema.safeParse(cap).success
+}
+
+export const OcrProviderCapabilityRecordSchema = z.partialRecord(OcrProviderCapabilitySchema, z.boolean())
+
+export type OcrProviderCapabilityRecord = z.infer<typeof OcrProviderCapabilityRecordSchema>
+
+/**
+ * Extend this type to define provider-specefic config types.
+ */
+export const OcrProviderApiConfigSchema = z.object({
+  apiKey: z.string(),
+  apiHost: z.string(),
+  apiVersion: z.string().optional()
+})
+export type OcrProviderApiConfig = z.infer<typeof OcrProviderApiConfigSchema>
+export const isOcrProviderApiConfig = (config: unknown): config is OcrProviderApiConfig => {
+  return OcrProviderApiConfigSchema.safeParse(config).success
+} /**
+ * For future. Model based ocr, api based ocr. May different api client.
+ *
+ * Extend this type to define provider-specific config types.
+ */
+
+export const OcrProviderBaseConfigSchema = z.object({
+  enabled: z.boolean().default(false)
+})
+
+export type OcrProviderBaseConfig = z.infer<typeof OcrProviderBaseConfigSchema>
+
+export const OcrProviderConfigSchema = OcrProviderBaseConfigSchema.loose()
+
+export type OcrProviderConfig = z.infer<typeof OcrProviderConfigSchema>
+
+export const OcrProviderIdSchema = z.string()
+
+export type OcrProviderId = z.infer<typeof OcrProviderIdSchema>
+
+export const OcrProviderNameSchema = z.string()
+
+export const OcrProviderSchema = z.object({
+  id: OcrProviderIdSchema,
+  name: OcrProviderNameSchema,
+  capabilities: OcrProviderCapabilityRecordSchema,
+  config: OcrProviderConfigSchema
+})
+
+export type OcrProvider = z.infer<typeof OcrProviderSchema>
+
+export const isOcrProvider = (p: unknown): p is OcrProvider => {
+  return OcrProviderSchema.safeParse(p).success
+}
+
+export const OcrApiProviderConfigSchema = OcrProviderBaseConfigSchema.extend({
+  api: OcrProviderApiConfigSchema
+})
+export type OcrApiProviderConfig = z.infer<typeof OcrApiProviderConfigSchema>
+export const isOcrApiProviderConfig = (config: unknown): config is OcrApiProviderConfig => {
+  return OcrApiProviderConfigSchema.safeParse(config).success
+}
+
+export const OcrApiProviderSchema = OcrProviderSchema
+/** Currently, there is no API provider yet, but we've left room for expansion. */
+export type OcrApiProvider = z.infer<typeof OcrApiProviderSchema>
+export const isOcrApiProvider = (p: unknown): p is OcrApiProvider => {
+  return OcrApiProviderSchema.safeParse(p).success
+}
+
+export type BuiltinOcrProvider = OcrProvider & {
+  id: BuiltinOcrProviderId
+}
+export const isBuiltinOcrProvider = (p: OcrProvider): p is BuiltinOcrProvider => {
+  return isBuiltinOcrProviderId(p.id)
+}
+
+// Not sure compatible api endpoint exists. May not support custom ocr provider
+export type CustomOcrProvider = OcrProvider & {
+  id: Exclude<string, BuiltinOcrProviderId>
+}
+
+export type ImageOcrProvider = OcrProvider & {
+  capabilities: OcrProviderCapabilityRecord & {
+    [OcrProviderCapabilities.image]: true
+  }
+}
+export const isImageOcrProvider = (p: OcrProvider): p is ImageOcrProvider => {
+  return p.capabilities.image === true
+}

src/renderer/src/types/ocr/provider/index.ts

@@ -0,0 +1,5 @@
+export * from './base'
+export * from './ov'
+export * from './paddle'
+export * from './system'
+export * from './tesseract'

src/renderer/src/types/ocr/provider/ov.ts

@@ -0,0 +1,29 @@
+import type * as z from 'zod'
+
+import type { ImageOcrProvider } from './base'
+import type { BuiltinOcrProvider } from './base'
+import type { OcrProvider } from './base'
+import { OcrProviderBaseConfigSchema } from './base'
+import { BuiltinOcrProviderIdMap } from './base'
+
+// ==========================================================
+//    OV OCR Types
+// ==========================================================
+
+export const OcrOvConfigSchema = OcrProviderBaseConfigSchema.extend({
+  // It's not configurable for now.
+  // langs: z.array(TranslateLanguageCodeSchema).optional()
+})
+export type OcrOvConfig = z.infer<typeof OcrOvConfigSchema>
+export const isOcrOvConfig = (config: unknown): config is OcrOvConfig => {
+  return OcrOvConfigSchema.safeParse(config).success
+}
+export type OcrOvProvider = {
+  id: 'ovocr'
+  config: OcrOvConfig
+} & ImageOcrProvider &
+  // PdfOcrProvider &
+  BuiltinOcrProvider
+export const isOcrOVProvider = (p: OcrProvider): p is OcrOvProvider => {
+  return p.id === BuiltinOcrProviderIdMap.ovocr
+}

src/renderer/src/types/ocr/provider/paddle.ts

@@ -0,0 +1,29 @@
+import * as z from 'zod'
+
+import type { ImageOcrProvider } from './base'
+import type { BuiltinOcrProvider } from './base'
+import type { OcrProvider } from './base'
+import { OcrProviderBaseConfigSchema } from './base'
+import { BuiltinOcrProviderIdMap } from './base'
+
+// ==========================================================
+//    PaddleOCR Types
+// ==========================================================
+
+export const OcrPpocrConfigSchema = OcrProviderBaseConfigSchema.extend({
+  apiUrl: z.string().optional(),
+  accessToken: z.string().optional()
+})
+export type OcrPpocrConfig = z.infer<typeof OcrPpocrConfigSchema>
+export const isOcrPpocrConfig = (config: unknown): config is OcrPpocrConfig => {
+  return OcrPpocrConfigSchema.safeParse(config).success
+}
+export type OcrPpocrProvider = {
+  id: 'paddleocr'
+  config: OcrPpocrConfig
+} & ImageOcrProvider &
+  // PdfOcrProvider &
+  BuiltinOcrProvider
+export const isOcrPpocrProvider = (p: OcrProvider): p is OcrPpocrProvider => {
+  return p.id === BuiltinOcrProviderIdMap.paddleocr
+}

src/renderer/src/types/ocr/provider/system.ts

@@ -0,0 +1,31 @@
+import * as z from 'zod'
+
+import { TranslateLanguageCodeSchema } from '../../translate'
+import type { OcrProvider } from './base'
+import { type ImageOcrProvider, OcrProviderBaseConfigSchema } from './base'
+import { type BuiltinOcrProvider } from './base'
+import { BuiltinOcrProviderIdMap } from './base'
+
+// ==========================================================
+//    System OCR Types
+// ==========================================================
+
+export const OcrSystemConfigSchema = OcrProviderBaseConfigSchema.extend({
+  langs: z.array(TranslateLanguageCodeSchema).optional()
+})
+
+export type OcrSystemConfig = z.infer<typeof OcrSystemConfigSchema>
+export const isOcrSystemConfig = (c: unknown): c is OcrSystemConfig => {
+  return OcrSystemConfigSchema.safeParse(c).success
+}
+
+export type OcrSystemProvider = {
+  id: 'system'
+  config: OcrSystemConfig
+} & ImageOcrProvider &
+  // PdfOcrProvider &
+  BuiltinOcrProvider
+
+export const isOcrSystemProvider = (p: OcrProvider): p is OcrSystemProvider => {
+  return p.id === BuiltinOcrProviderIdMap.system
+}

src/renderer/src/types/ocr/provider/tesseract.ts

@@ -0,0 +1,35 @@
+import type Tesseract from 'tesseract.js'
+import * as z from 'zod'
+
+import { TranslateLanguageCodeSchema } from '../../translate'
+import type { ImageOcrProvider } from './base'
+import type { BuiltinOcrProvider } from './base'
+import type { OcrProvider } from './base'
+import { OcrProviderBaseConfigSchema } from './base'
+import { BuiltinOcrProviderIdMap } from './base'
+
+// ==========================================================
+//    Tesseract OCR Types
+// ==========================================================
+
+export const OcrTesseractConfigSchema = OcrProviderBaseConfigSchema.extend({
+  langs: z.record(TranslateLanguageCodeSchema, z.boolean()).optional()
+})
+
+export type OcrTesseractConfig = z.infer<typeof OcrTesseractConfigSchema>
+
+export const isOcrTesseractConfig = (value: unknown): value is OcrTesseractConfig => {
+  return OcrTesseractConfigSchema.safeParse(value).success
+}
+
+export type OcrTesseractProvider = {
+  id: 'tesseract'
+  config: OcrTesseractConfig
+} & ImageOcrProvider &
+  BuiltinOcrProvider
+
+export const isOcrTesseractProvider = (p: OcrProvider): p is OcrTesseractProvider => {
+  return p.id === BuiltinOcrProviderIdMap.tesseract
+}
+
+export type TesseractLangCode = Tesseract.LanguageCode

src/renderer/src/types/translate.ts

@@ -0,0 +1,48 @@
+import * as z from 'zod'
+
+/**
+ * Language code pattern used for translation features.
+ * Examples: "zh-cn", "en-us", "fr-fr", etc.
+ * Must be lowercase and follow the format: 2-3 letter language code
+ * followed by a hyphen and 2-letter region code.
+ */
+export const TranslateLanguageCodeSchema = z.string().regex(/^[a-z]{2,3}(-[a-z]{2,3})$/)
+
+export type TranslateLanguageCode = z.infer<typeof TranslateLanguageCodeSchema> // langCode应当能够唯一确认一种语言
+
+export type TranslateLanguage = {
+  value: string
+  langCode: TranslateLanguageCode
+  label: () => string
+  emoji: string
+}
+
+export interface TranslateHistory {
+  id: string
+  sourceText: string
+  targetText: string
+  sourceLanguage: TranslateLanguageCode
+  targetLanguage: TranslateLanguageCode
+  createdAt: string
+  /** 收藏状态 */
+  star?: boolean
+}
+
+export type CustomTranslateLanguage = {
+  id: string
+  langCode: TranslateLanguageCode
+  value: string
+  emoji: string
+}
+
+export const AutoDetectionMethods = {
+  franc: 'franc',
+  llm: 'llm',
+  auto: 'auto'
+} as const
+
+export type AutoDetectionMethod = keyof typeof AutoDetectionMethods
+
+export const isAutoDetectionMethod = (method: string): method is AutoDetectionMethod => {
+  return Object.hasOwn(AutoDetectionMethods, method)
+}

src/renderer/src/utils/ocr.ts

@@ -0,0 +1,10 @@
+import { isMac, isWin } from '@renderer/config/constant'
+import type { OcrProviderCapability } from '@renderer/types'
+import { systemOcr, tesseract } from '@shared/config/ocr'
+
+export const getDefaultOcrProvider = (cap: OcrProviderCapability) => {
+  switch (cap) {
+    case 'image':
+      return isWin || isMac ? systemOcr : tesseract
+  }
+}

tsconfig.node.json

@@ -5,13 +5,13 @@
     "src/main/**/*",
     "src/preload/**/*",
     "src/main/env.d.ts",
-    "src/renderer/src/types/*",
+    "src/renderer/src/types/**/*",
     "packages/shared/**/*",
     "scripts",
     "packages/mcp-trace/**/*",
     "src/renderer/src/services/traceApi.ts",
     "tests/__mocks__/**/*"
-  ],
+, "src/renderer/src/types/ocr/base.ts"  ],
   "compilerOptions": {
     "composite": true,
     "incremental": true,