feat: refactor text refinement flow

Author: yexia553

electron/README.md

@@ -19,7 +19,7 @@
 主进程核心模块：
 
 - `main.ts` - 应用入口、窗口管理、IPC 处理、PTT 流程编排
-- `audio/` - 音频处理流水线（录音会话、转换、ASR、LLM 润色、注入）
+- `audio/` - 音频处理流水线（录音会话、转换、ASR、文本润色、注入）
 - `hotkey/` - 快捷键解析与 PTT 行为绑定
 - `ipc/` - IPC 处理器（配置、会话、历史、日志、更新、浮窗）
 - `tray/` - 托盘菜单与本地化刷新
@@ -31,7 +31,7 @@
 - `hotkey-manager.ts` - 全局快捷键管理（基于 `globalShortcut`）
 - `iohook-manager.ts` - 低级键盘钩子（基于 `uiohook-napi`）
 - `asr-provider.ts` - GLM ASR 服务封装
-- `llm-provider.ts` - GLM 文本润色服务封装（Chat Completions HTTP API，复用 ASR 区域与 Key）
+- `refine/` - 文本润色模块（手动 OpenAI-compatible 配置、请求解析与连接测试）
 - `text-injector.ts` - 文本注入模拟（基于 `nut-js`）
 - `logger.ts` - 主进程日志与保留策略
 - `updater-manager.ts` - 版本检查与更新跳转
@@ -47,7 +47,7 @@ IPC 桥接层：
 跨进程共享代码：
 
 - `types.ts` - TypeScript 类型定义、IPC 通道常量
-- `constants.ts` - 应用级常量（GLM API 配置、默认快捷键、音频参数）
+- `constants.ts` - 应用级常量（GLM API 预设、通用 Chat 默认参数、默认快捷键、音频参数）
 
 ## 根文件
 
@@ -65,13 +65,13 @@ Electron 环境类型声明
 4. **数据传输** - 渲染进程将音频数据发送回主进程
 5. **格式转换** - `fluent-ffmpeg` 转换 WebM → MP3
 6. **语音识别** - `asr-provider` 调用 GLM API 转录
-7. **文本润色** - `llm-provider` 调用 GLM Chat Completions API 进行后处理（失败回退原文）
+7. **文本润色** - `refine/service` 根据手动填写的 OpenAI-compatible 配置调用 Chat Completions API 进行后处理（失败回退原文）
 8. **文本注入** - `text-injector` 模拟键盘输入到活动窗口
 
 ### 配置管理
 
 - 配置存储路径：`~/.config/voice-key/voice-key-config.json`（macOS/Linux）或 `%APPDATA%/voice-key/...`（Windows）
-- 内容：ASR 配置、LLM 润色开关配置、快捷键配置
+- 内容：ASR 配置、文本润色配置、快捷键配置
 - 通过 IPC 与设置页面同步
 
 ### IPC 通信架构

electron/main/README.md

@@ -1,19 +1,19 @@
 # main/
 
-Electron 主进程目录，负责窗口管理、IPC、录音流程、ASR/LLM 调用与文本注入。
+Electron 主进程目录，负责窗口管理、IPC、录音流程、ASR/文本润色调用与文本注入。
 
 ## 文件列表
 
-- `main.ts` - 应用入口；创建后台/设置/浮窗窗口、托盘菜单与 IPC 处理，协调 PTT 录音 → 转录 → LLM 润色 → 注入流程、会话取消与 FFmpeg 初始化，并向音频处理器注入 ASR/低音量模式配置（系统语言随窗口聚焦同步）。
+- `main.ts` - 应用入口；创建后台/设置/浮窗窗口、托盘菜单与 IPC 处理，协调 PTT 录音 → 转录 → 文本润色 → 注入流程、会话取消与 FFmpeg 初始化，并向音频处理器注入 ASR/润色服务（系统语言随窗口聚焦同步）。
 - `i18n.ts` - 主进程 i18next 初始化与语言切换，广播语言快照到各窗口。
 - `env.ts` - 运行时环境与资源路径解析（开发/生产）。
-- `config-manager.ts` - 使用 `electron-store` 持久化应用偏好、ASR 配置、LLM 润色开关与快捷键配置。
+- `config-manager.ts` - 使用 `electron-store` 持久化应用偏好、ASR 配置、文本润色配置与快捷键配置。
 - `logger.ts` - 初始化 `electron-log`，统一控制台写入与日志保留/轮转策略。
 - `history-manager.ts` - 录音历史存储（固定保留最近 90 天），提供增删清空与统计接口。
 - `hotkey-manager.ts` - 基于 `globalShortcut` 的全局快捷键注册/注销。
 - `iohook-manager.ts` - 基于 `uiohook-napi` 的键盘钩子，检测 PTT 组合键按住状态。
 - `asr-provider.ts` - 调用 GLM ASR API（axios + FormData）上传音频并返回转录结果。
-- `llm-provider.ts` - GLM Chat Completions 文本润色适配层（axios HTTP），复用 ASR 区域与 API Key。
+- `refine/` - 文本润色模块；将手动填写的 OpenAI-compatible 配置解析成统一 Chat Completions 请求，并执行润色与连接测试。
 - `text-injector.ts` - 基于 `@nut-tree-fork/nut-js` 注入文本；Windows 使用剪贴板粘贴，macOS 校验辅助功能权限。
 - `updater-manager.ts` - 调用 GitHub Releases API 检查新版本，缓存结果并打开发布页下载链接。
 - `audio/` - 录音会话、音频转换与转写处理流水线。

electron/main/__tests__/README.md

@@ -4,7 +4,7 @@
 
 - `config-manager.test.ts` - 配置管理器单元测试。
 - `asr-provider.test.ts` - ASR Provider 请求与错误映射测试。
-- `llm-provider.test.ts` - GLM LLM Provider 端点解析、重试回退与错误映射测试。
+- `refine/__tests__/service.test.ts` - 文本润色服务的手动配置解析、endpoint 规范化、错误映射与连接测试。
 - `text-injector.test.ts` - 文本注入与权限检查测试。
 - `iohook-manager.test.ts` - 按键状态判定与修饰键精确匹配测试。
 - `history-manager.test.ts` - 历史记录增删清理与保留天数裁剪测试。

electron/main/__tests__/config-manager.test.ts

@@ -107,16 +107,97 @@ describe('ConfigManager', () => {
   it('returns default llm refine config', async () => {
     const configManager = await createManager()
     const config = configManager.getLLMRefineConfig()
-    expect(config.enabled).toBe(LLM_REFINE.ENABLED)
+    expect(config).toEqual({
+      enabled: LLM_REFINE.ENABLED,
+      endpoint: LLM_REFINE.ENDPOINT,
+      model: LLM_REFINE.MODEL,
+      apiKey: LLM_REFINE.API_KEY,
+    })
   })
 
   it('persists partial llm refine config', async () => {
     const configManager = await createManager()
     configManager.setLLMRefineConfig({
       enabled: false,
+      endpoint: 'https://example.com/v1',
+      model: 'gpt-4.1-mini',
+      apiKey: 'test-key',
+    })
+    expect(configManager.getLLMRefineConfig()).toMatchObject({
+      enabled: false,
+      endpoint: 'https://example.com/v1',
+      model: 'gpt-4.1-mini',
+      apiKey: 'test-key',
+    })
+  })
+
+  it('migrates legacy openai-compatible refine config to flat schema', async () => {
+    seedData = {
+      llmRefine: {
+        enabled: true,
+        provider: 'openai-compatible',
+        openaiCompatible: {
+          endpoint: 'https://example.com/v1',
+          model: 'gpt-4.1-mini',
+          apiKey: 'test-key',
+        },
+      },
+    }
+    const configManager = await createManager()
+    expect(configManager.getLLMRefineConfig()).toMatchObject({
+      enabled: true,
+      endpoint: 'https://example.com/v1',
+      model: 'gpt-4.1-mini',
+      apiKey: 'test-key',
     })
+  })
+
+  it('migrates legacy glm-shared refine config to disabled manual config', async () => {
+    seedData = {
+      llmRefine: {
+        enabled: true,
+        provider: 'glm-shared',
+      },
+    }
+    const configManager = await createManager()
     expect(configManager.getLLMRefineConfig()).toMatchObject({
       enabled: false,
+      endpoint: '',
+      model: '',
+      apiKey: '',
+    })
+  })
+
+  it('migrates legacy boolean-only refine config to disabled manual config', async () => {
+    seedData = {
+      llmRefine: {
+        enabled: true,
+      },
+    }
+    const configManager = await createManager()
+    expect(configManager.getLLMRefineConfig()).toMatchObject({
+      enabled: false,
+      endpoint: '',
+      model: '',
+      apiKey: '',
+    })
+  })
+
+  it('decrypts encrypted llm refine api keys on read', async () => {
+    seedData = {
+      llmRefine: {
+        enabled: true,
+        endpoint: 'https://example.com/v1',
+        model: 'gpt-4.1-mini',
+        apiKey: `enc:${Buffer.from('encrypted:refine-key').toString('base64')}`,
+      },
+    }
+    const configManager = await createManager()
+    expect(configManager.getLLMRefineConfig()).toMatchObject({
+      enabled: true,
+      endpoint: 'https://example.com/v1',
+      model: 'gpt-4.1-mini',
+      apiKey: 'refine-key',
     })
   })