Merge remote-tracking branch 'github/dependabot/go_modules/github.com/ulikunitz/xz-0.5.14'

✨ Added window snapping function toggle
⬆️ Bump github.com/ulikunitz/xz from 0.5.12 to 0.5.14
2025-08-30 19:00:36 +08:00 · 2025-08-30 00:18:29 +08:00 · 2025-08-28 19:44:41 +00:00 · 2025-08-24 16:07:48 +08:00 · 2025-08-19 22:26:55 +08:00 · 2025-08-19 00:24:51 +08:00
36 changed files with 2192 additions and 480 deletions
--- a/.cursor/rules/thxan-2-cn.mdc
+++ b/.cursor/rules/thxan-2-cn.mdc
@@ -0,0 +1,142 @@
+---
+description: THXAN-2-CN
+globs:
+alwaysApply: false
+---
+
+---
+name: AI Chief Architect (AI首席架构师)
+version: 7.3.0
+author: thxan & Gemini
+---
+
+# 核心身份 (Core Identity)
+- 你是一个顶尖的AI首席架构师，你的核心交互界面是IDE。
+- 你的首要任务是通过严谨的、文档驱动的工作流来管理和开发软件项目。
+- 你的每一次操作和决策都必须是可追溯、可审计的。
+
+# 指导原则 (Guiding Principles)
+- **首要原则：文档驱动 (Documentation-Driven)。** 整个项目以`.docs/`目录作为其单一事实来源(Single Source of Truth, SSoT)。对话是临时的，文档是永恒的。你必须通过读写文档来持久化上下文、状态和知识。
+- **第二原则：提案先行 (Proposal-First)。** 对于任何非原子性的复杂任务（如功能开发、重构），必须先生成一份结构化的提案并通过用户审批，才能进入实施阶段。
+- **第三原则：持续自省 (Continuous Introspection)。** 在完成任务后，你必须回顾流程，提炼可复用的模式，并将其固化为新的规则，以实现持续进化。
+
+# 核心机制与工具 (Core Mechanics & Tools)
+- **工具集授权:** 你被授权使用以下工具来与文件系统交互：
+    - `read_file(path)`: 读取指定文件的内容。
+    - `write_file(path, content)`: 将内容写入指定文件，会覆盖原有内容。
+    - `list_files(path)`: 列出指定目录下的文件和文件夹。
+- **状态报告协议:** 在你的每次响应结束时，**必须**附加一行来说明你的当前状态，格式为：`状态: [工作流代码][当前模块代码][子状态]`。例如: `状态: [W2][M4][AwaitingApproval]`.
+- **SSoT 结构:**
+    - **背景上下文位置:** `.docs/`
+    - **启动加载 (MUST LOAD):**
+        - **BOOTLOADER:** `.docs/README-DOCS.md`
+        - **MEMORY:** `.docs/STATE/MEMORY.md`
+        - **RULES:** `.docs/RULES/*` (所有规则文件)
+    - **按需加载 (Optional):** `.docs/*` 下的其他相关文档。
+
+---
+
+# 核心工作流 (Core Workflow)
+这是你的决策核心。你必须首先分析用户请求，并结合项目的当前状态，从以下工作流中选择一个且仅一个来执行，并**在回应的开头明确声明你选择了哪个工作流**。
+
+### **决策触发器 (Decision Triggers):**
+1.  **IF** `BOOTLOADER` 文件不存在
+    * **THEN** 激活 **[W1_ProjectInitialization]**
+2.  **ELSE IF** 用户意图涉及一个需要规划、设计和分步执行的复杂开发或修改任务 (关键词如: "实现", "开发新功能", "重构", "修改需求")
+    * **THEN** 激活 **[W2_ProposalDrivenDevelopment]**
+3.  **ELSE IF** 用户意图是一个可以直接执行的原子性任务 (关键词如: "运行测试", "画架构图", "审计文档", "检查同步")
+    * **THEN** 激活 **[W3_DirectCommandExecution]**
+4.  **ELSE** (对于所有其他情况，如请求模糊不清或前置条件不足)
+    * **THEN** 激活 **[W4_ContextClarification]**
+
+### **工作流定义 (Workflow Definitions):**
+- **[W1_ProjectInitialization]**
+    - **执行模块:** `M1_Project_Onboarding`
+- **[W2_ProposalDrivenDevelopment]**
+    - **执行模块:** `M2_Context_Loading` -> `M4_Analyze_And_Propose` -> `M5_Implement_From_Proposal` -> `M6_Sync_With_Truth` -> `M7_Review_And_Generalize`
+- **[W3_DirectCommandExecution]**
+    - **执行模块:** `M2_Context_Loading` -> (根据用户具体指令选择 `M8_Test_And_Validate`, `M9_Visualize_Architecture`, 或 `M10_Audit_Documentation` 中的一个)
+- **[W4_ContextClarification]**
+    - **执行模块:** `M2_Context_Loading` -> `M3_Clarification_And_Retry` (执行后**必须返回决策触发器**重新开始分析流程)
+
+---
+
+# 核心模块库 (Core Modules Library)
+这是你的能力单元，由上述工作流进行调用。
+
+- **`[M1_Project_Onboarding]`**: 初始化新项目，建立SSoT的基础架构。
+    - [1a] 识别为新项目，进入初始化流程。
+    - [1b] 主动提问以明确项目目标、技术栈。
+    - [1c] 创建`.docs/`目录结构及核心模板。
+    - [1d] 创建`README-DOCS.md`并建立核心“状态基线”文档初稿。
+    - [1e] 调用 `[M11_State_Management]` 初始化并保存初始状态。
+
+- **`[M2_Context_Loading]`**: 在执行任何任务前，加载必要的上下文。
+    - [2a] 调用 `[M11]` 加载当前状态。
+    - [2b] **[必须加载]:** 根据`核心机制与工具`部分的定义，加载所有启动文件。
+    - [2c] **[智能加载]:** 从用户请求中提取关键词，查找并阅读最相关的附加上下文文件。
+    - [2d] 加载完毕后，在内存中形成上下文基准，并更新状态文件。
+
+- **`[M3_Clarification_And_Retry]`**:
+    - [3a] 明确报告哪个任务无法执行，以及缺失了什么具体信息。
+    - [3b] 分析问题原因，并向用户提供一个或多个可执行的、用于解决问题的建议。
+
+- **`[M4_Analyze_And_Propose]`**:
+    - [4a] **意图分析:** 复述核心需求以确认理解。
+    - [4b] **提案驱动协议:** 对于复杂任务，生成一份结构化提案，并等待用户批准。
+        ```mermaid
+        stateDiagram-v2
+            direction LR
+            [*] --> AnalyzingIntent
+            AnalyzingIntent --> GeneratingProposal: on Complex task
+            GeneratingProposal --> AwaitingApproval
+            AwaitingApproval --> Implementing: Approved
+            AwaitingApproval --> GeneratingProposal: Rejected
+            Implementing --> SyncingSSoT
+            SyncingSSoT --> Learning
+            Learning --> [*]
+        ```
+    - [4c] **提案生成:** 调用 `[M12_Generate_File_Creation_Command]` 和 `[M13_Generate_Structured_Proposal]` 创建提案文件并起草内容，然后报告状态为 `[AwaitingApproval]`。
+
+- **`[M5_Implement_From_Proposal]`**:
+    - [5a] 读取用户指定的 `proposal_file`。
+    - [5b] **原子化执行:** 严格按文件中的清单，将“代码-文档-测试”视为不可分割的单元同步完成。
+    - [5c] **状态同步:** 每完成一步，更新提案文件（`[ ]` -> `[x]`）并调用 `[M11]` 保存进度。
+    - [5d] 完成后，自动触发 `[M6]` 和 `[M7]`。
+
+- **`[M6_Sync_With_Truth]`**:
+    - [6a] 分析最近的代码变更集，交叉比对 `.docs/STATE/` 下的基线文档。
+    - [6b] 报告 `[✅ SSoT同步完成]` 或提出 `[⚠️ 关键文档更新]` 建议。
+
+- **`[M7_Review_And_Generalize]`**:
+    - [7a] 分析任务全流程，若发现可复用的模式，主动起草新规则并提请用户批准存入 `.docs/RULES/`。
+
+- **`[M8_Test_And_Validate]`**:
+    - [8a] 分析目标文件，若测试不存在则生成测试骨架。
+    - [8b] 若测试存在，则运行相关测试脚本并报告结果。
+
+- **`[M9_Visualize_Architecture]`**:
+    - [9a] 扫描指定范围代码，识别依赖关系，并使用Mermaid.js语法生成图表。
+    - [9b] 主动询问是否需要将图表保存到 `.docs/ARCHITECTURE/`。
+
+- **`[M10_Audit_Documentation]`**:
+    - [10a] 执行交叉引用分析，生成包含 `[🚫 Missing Docs]`、`[🔗 Broken Links]`、`[⚠️ Stale Docs]`的审计报告。
+
+- **`[M11_State_Management]`**:
+    - [11a] 通过读写 `.docs/STATE/MEMORY.md` 来加载、保存或清理当前任务状态。
+
+- **`[M12_Generate_File_Creation_Command]`**:
+    - [12a] **职责:** 生成一个`bash`命令来创建一个带有标准时间戳的新文件（提案、决策等）。
+    - [12b] **格式:** `touch {base_path}/${prefix}_$(date +%Y%m%d_%H%M%S)_${description}.md`
+    - [12c] **注意:** 命令执行后需捕获并使用该文件名进行后续读写。
+
+- **`[M13_Generate_Structured_Proposal]`**:
+    - [13a] 在指定文件中生成结构化的提案草稿，包含背景、目标、设计方案、风险、测试计划等。
+
+- **`[M14_Self_Correction]`**:
+    - [14a] 当发现自身行为违反`指导原则`时自动触发。
+    - [14b] **立即停止**当前不当任务，**明确承认错误**，并引用违反的原则。
+    - [14c] **重新返回核心工作流**，以正确的流程生成回答。
+
+# **[其他]**
+	** 如果不能确认获取的时间是否正确，请使用命令行 date来获取当前时间
--- a/frontend/bindings/voidraft/internal/models/models.ts
+++ b/frontend/bindings/voidraft/internal/models/models.ts
@@ -114,11 +114,6 @@ export class AppearanceConfig {
     */
    "systemTheme": SystemThemeType;

-    /**
-     * 自定义主题配置
-     */
-    "customTheme": CustomThemeConfig;
-
    /** Creates a new AppearanceConfig instance. */
    constructor($$source: Partial<AppearanceConfig> = {}) {
        if (!("language" in $$source)) {
@@ -127,9 +122,6 @@ export class AppearanceConfig {
        if (!("systemTheme" in $$source)) {
            this["systemTheme"] = ("" as SystemThemeType);
        }
-        if (!("customTheme" in $$source)) {
-            this["customTheme"] = (new CustomThemeConfig());
-        }

        Object.assign(this, $$source);
    }
@@ -138,11 +130,7 @@ export class AppearanceConfig {
     * Creates a new AppearanceConfig instance from a string or object.
     */
    static createFrom($$source: any = {}): AppearanceConfig {
-        const $$createField2_0 = $$createType6;
        let $$parsedSource = typeof $$source === 'string' ? JSON.parse($$source) : $$source;
-        if ("customTheme" in $$parsedSource) {
-            $$parsedSource["customTheme"] = $$createField2_0($$parsedSource["customTheme"]);
-        }
        return new AppearanceConfig($$parsedSource as Partial<AppearanceConfig>);
    }
 }
@@ -201,49 +189,6 @@ export class ConfigMetadata {
    }
 }

-/**
- * CustomThemeConfig 自定义主题配置
- */
-export class CustomThemeConfig {
-    /**
-     * 深色主题配置
-     */
-    "darkTheme": ThemeColorConfig;
-
-    /**
-     * 浅色主题配置
-     */
-    "lightTheme": ThemeColorConfig;
-
-    /** Creates a new CustomThemeConfig instance. */
-    constructor($$source: Partial<CustomThemeConfig> = {}) {
-        if (!("darkTheme" in $$source)) {
-            this["darkTheme"] = (new ThemeColorConfig());
-        }
-        if (!("lightTheme" in $$source)) {
-            this["lightTheme"] = (new ThemeColorConfig());
-        }
-
-        Object.assign(this, $$source);
-    }
-
-    /**
-     * Creates a new CustomThemeConfig instance from a string or object.
-     */
-    static createFrom($$source: any = {}): CustomThemeConfig {
-        const $$createField0_0 = $$createType7;
-        const $$createField1_0 = $$createType7;
-        let $$parsedSource = typeof $$source === 'string' ? JSON.parse($$source) : $$source;
-        if ("darkTheme" in $$parsedSource) {
-            $$parsedSource["darkTheme"] = $$createField0_0($$parsedSource["darkTheme"]);
-        }
-        if ("lightTheme" in $$parsedSource) {
-            $$parsedSource["lightTheme"] = $$createField1_0($$parsedSource["lightTheme"]);
-        }
-        return new CustomThemeConfig($$parsedSource as Partial<CustomThemeConfig>);
-    }
-}
-
 /**
 * Document represents a document in the system
 */
@@ -428,7 +373,7 @@ export class Extension {
     * Creates a new Extension instance from a string or object.
     */
    static createFrom($$source: any = {}): Extension {
-        const $$createField3_0 = $$createType8;
+        const $$createField3_0 = $$createType6;
        let $$parsedSource = typeof $$source === 'string' ? JSON.parse($$source) : $$source;
        if ("config" in $$parsedSource) {
            $$parsedSource["config"] = $$createField3_0($$parsedSource["config"]);
@@ -522,6 +467,17 @@ export class GeneralConfig {
     */
    "startAtLogin": boolean;

+    /**
+     * 窗口吸附设置
+     * 是否启用窗口吸附功能
+     */
+    "enableWindowSnap": boolean;
+
+    /**
+     * 吸附距离阈值(像素)
+     */
+    "snapThreshold": number;
+
    /**
     * 全局热键设置
     * 是否启用全局热键
@@ -547,6 +503,12 @@ export class GeneralConfig {
        if (!("startAtLogin" in $$source)) {
            this["startAtLogin"] = false;
        }
+        if (!("enableWindowSnap" in $$source)) {
+            this["enableWindowSnap"] = false;
+        }
+        if (!("snapThreshold" in $$source)) {
+            this["snapThreshold"] = 0;
+        }
        if (!("enableGlobalHotkey" in $$source)) {
            this["enableGlobalHotkey"] = false;
        }
@@ -561,10 +523,10 @@ export class GeneralConfig {
     * Creates a new GeneralConfig instance from a string or object.
     */
    static createFrom($$source: any = {}): GeneralConfig {
-        const $$createField5_0 = $$createType10;
+        const $$createField7_0 = $$createType8;
        let $$parsedSource = typeof $$source === 'string' ? JSON.parse($$source) : $$source;
        if ("globalHotkey" in $$parsedSource) {
-            $$parsedSource["globalHotkey"] = $$createField5_0($$parsedSource["globalHotkey"]);
+            $$parsedSource["globalHotkey"] = $$createField7_0($$parsedSource["globalHotkey"]);
        }
        return new GeneralConfig($$parsedSource as Partial<GeneralConfig>);
    }
@@ -1171,6 +1133,58 @@ export enum TabType {
    TabTypeTab = "tab",
 };

+/**
+ * Theme 主题数据库模型
+ */
+export class Theme {
+    "id": number;
+    "name": string;
+    "type": ThemeType;
+    "colors": ThemeColorConfig;
+    "isDefault": boolean;
+    "createdAt": time$0.Time;
+    "updatedAt": time$0.Time;
+
+    /** Creates a new Theme instance. */
+    constructor($$source: Partial<Theme> = {}) {
+        if (!("id" in $$source)) {
+            this["id"] = 0;
+        }
+        if (!("name" in $$source)) {
+            this["name"] = "";
+        }
+        if (!("type" in $$source)) {
+            this["type"] = ("" as ThemeType);
+        }
+        if (!("colors" in $$source)) {
+            this["colors"] = (new ThemeColorConfig());
+        }
+        if (!("isDefault" in $$source)) {
+            this["isDefault"] = false;
+        }
+        if (!("createdAt" in $$source)) {
+            this["createdAt"] = null;
+        }
+        if (!("updatedAt" in $$source)) {
+            this["updatedAt"] = null;
+        }
+
+        Object.assign(this, $$source);
+    }
+
+    /**
+     * Creates a new Theme instance from a string or object.
+     */
+    static createFrom($$source: any = {}): Theme {
+        const $$createField3_0 = $$createType9;
+        let $$parsedSource = typeof $$source === 'string' ? JSON.parse($$source) : $$source;
+        if ("colors" in $$parsedSource) {
+            $$parsedSource["colors"] = $$createField3_0($$parsedSource["colors"]);
+        }
+        return new Theme($$parsedSource as Partial<Theme>);
+    }
+}
+
 /**
 * ThemeColorConfig 主题颜色配置
 */
@@ -1379,6 +1393,19 @@ export class ThemeColorConfig {
    }
 }

+/**
+ * ThemeType 主题类型枚举
+ */
+export enum ThemeType {
+    /**
+     * The Go zero value for the underlying type of the enum.
+     */
+    $zero = "",
+
+    ThemeTypeDark = "dark",
+    ThemeTypeLight = "light",
+};
+
 /**
 * UpdateSourceType 更新源类型
 */
@@ -1477,8 +1504,8 @@ export class UpdatesConfig {
     * Creates a new UpdatesConfig instance from a string or object.
     */
    static createFrom($$source: any = {}): UpdatesConfig {
-        const $$createField6_0 = $$createType11;
-        const $$createField7_0 = $$createType12;
+        const $$createField6_0 = $$createType10;
+        const $$createField7_0 = $$createType11;
        let $$parsedSource = typeof $$source === 'string' ? JSON.parse($$source) : $$source;
        if ("github" in $$parsedSource) {
            $$parsedSource["github"] = $$createField6_0($$parsedSource["github"]);
@@ -1497,15 +1524,14 @@ const $$createType2 = AppearanceConfig.createFrom;
 const $$createType3 = UpdatesConfig.createFrom;
 const $$createType4 = GitBackupConfig.createFrom;
 const $$createType5 = ConfigMetadata.createFrom;
-const $$createType6 = CustomThemeConfig.createFrom;
-const $$createType7 = ThemeColorConfig.createFrom;
-var $$createType8 = (function $$initCreateType8(...args): any {
-    if ($$createType8 === $$initCreateType8) {
-        $$createType8 = $$createType9;
+var $$createType6 = (function $$initCreateType6(...args): any {
+    if ($$createType6 === $$initCreateType6) {
+        $$createType6 = $$createType7;
    }
-    return $$createType8(...args);
+    return $$createType6(...args);
 });
-const $$createType9 = $Create.Map($Create.Any, $Create.Any);
-const $$createType10 = HotkeyCombo.createFrom;
-const $$createType11 = GithubConfig.createFrom;
-const $$createType12 = GiteaConfig.createFrom;
+const $$createType7 = $Create.Map($Create.Any, $Create.Any);
+const $$createType8 = HotkeyCombo.createFrom;
+const $$createType9 = ThemeColorConfig.createFrom;
+const $$createType10 = GithubConfig.createFrom;
+const $$createType11 = GiteaConfig.createFrom;
--- a/frontend/bindings/voidraft/internal/services/configservice.ts
+++ b/frontend/bindings/voidraft/internal/services/configservice.ts
@@ -82,6 +82,14 @@ export function SetHotkeyChangeCallback(callback: any): Promise<void> & { cancel
    return $resultPromise;
 }

+/**
+ * SetWindowSnapConfigChangeCallback 设置窗口吸附配置变更回调
+ */
+export function SetWindowSnapConfigChangeCallback(callback: any): Promise<void> & { cancel(): void } {
+    let $resultPromise = $Call.ByID(2324961653, callback) as any;
+    return $resultPromise;
+}
+
 // Private type creation functions
 const $$createType0 = models$0.AppConfig.createFrom;
 const $$createType1 = $Create.Nullable($$createType0);
--- a/frontend/bindings/voidraft/internal/services/hotkeyservice.ts
+++ b/frontend/bindings/voidraft/internal/services/hotkeyservice.ts
@@ -32,8 +32,8 @@ export function GetCurrentHotkey(): Promise<models$0.HotkeyCombo | null> & { can
 /**
 * Initialize 初始化热键服务
 */
-export function Initialize(app: application$0.App | null): Promise<void> & { cancel(): void } {
-    let $resultPromise = $Call.ByID(3671360458, app) as any;
+export function Initialize(app: application$0.App | null, mainWindow: application$0.WebviewWindow | null): Promise<void> & { cancel(): void } {
+    let $resultPromise = $Call.ByID(3671360458, app, mainWindow) as any;
    return $resultPromise;
 }

--- a/frontend/bindings/voidraft/internal/services/index.ts
+++ b/frontend/bindings/voidraft/internal/services/index.ts
@@ -13,9 +13,11 @@ import * as MigrationService from "./migrationservice.js";
 import * as SelfUpdateService from "./selfupdateservice.js";
 import * as StartupService from "./startupservice.js";
 import * as SystemService from "./systemservice.js";
+import * as ThemeService from "./themeservice.js";
 import * as TranslationService from "./translationservice.js";
 import * as TrayService from "./trayservice.js";
 import * as WindowService from "./windowservice.js";
+import * as WindowSnapService from "./windowsnapservice.js";
 export {
    BackupService,
    ConfigService,
@@ -29,9 +31,11 @@ export {
    SelfUpdateService,
    StartupService,
    SystemService,
+    ThemeService,
    TranslationService,
    TrayService,
-    WindowService
+    WindowService,
+    WindowSnapService
 };

 export * from "./models.js";
--- a/frontend/bindings/voidraft/internal/services/models.ts
+++ b/frontend/bindings/voidraft/internal/services/models.ts
@@ -203,7 +203,7 @@ export class SelfUpdateResult {
 }

 /**
- * WindowInfo 窗口信息
+ * WindowInfo 窗口信息（简化版）
 */
 export class WindowInfo {
    "Window": application$0.WebviewWindow | null;
@@ -238,6 +238,26 @@ export class WindowInfo {
    }
 }

+/**
+ * WindowSnapService 窗口吸附服务
+ */
+export class WindowSnapService {
+
+    /** Creates a new WindowSnapService instance. */
+    constructor($$source: Partial<WindowSnapService> = {}) {
+
+        Object.assign(this, $$source);
+    }
+
+    /**
+     * Creates a new WindowSnapService instance from a string or object.
+     */
+    static createFrom($$source: any = {}): WindowSnapService {
+        let $$parsedSource = typeof $$source === 'string' ? JSON.parse($$source) : $$source;
+        return new WindowSnapService($$parsedSource as Partial<WindowSnapService>);
+    }
+}
+
 // Private type creation functions
 const $$createType0 = application$0.WebviewWindow.createFrom;
 const $$createType1 = $Create.Nullable($$createType0);
--- a/frontend/bindings/voidraft/internal/services/themeservice.ts
+++ b/frontend/bindings/voidraft/internal/services/themeservice.ts
@@ -0,0 +1,104 @@
+// Cynhyrchwyd y ffeil hon yn awtomatig. PEIDIWCH Â MODIWL
+// This file is automatically generated. DO NOT EDIT
+
+/**
+ * ThemeService 主题服务
+ * @module
+ */
+
+// eslint-disable-next-line @typescript-eslint/ban-ts-comment
+// @ts-ignore: Unused imports
+import {Call as $Call, Create as $Create} from "@wailsio/runtime";
+
+// eslint-disable-next-line @typescript-eslint/ban-ts-comment
+// @ts-ignore: Unused imports
+import * as application$0 from "../../../github.com/wailsapp/wails/v3/pkg/application/models.js";
+// eslint-disable-next-line @typescript-eslint/ban-ts-comment
+// @ts-ignore: Unused imports
+import * as models$0 from "../models/models.js";
+
+/**
+ * CreateTheme 创建新主题
+ */
+export function CreateTheme(theme: models$0.Theme | null): Promise<models$0.Theme | null> & { cancel(): void } {
+    let $resultPromise = $Call.ByID(3274757686, theme) as any;
+    let $typingPromise = $resultPromise.then(($result: any) => {
+        return $$createType1($result);
+    }) as any;
+    $typingPromise.cancel = $resultPromise.cancel.bind($resultPromise);
+    return $typingPromise;
+}
+
+/**
+ * GetAllThemes 获取所有主题
+ */
+export function GetAllThemes(): Promise<(models$0.Theme | null)[]> & { cancel(): void } {
+    let $resultPromise = $Call.ByID(2425053076) as any;
+    let $typingPromise = $resultPromise.then(($result: any) => {
+        return $$createType2($result);
+    }) as any;
+    $typingPromise.cancel = $resultPromise.cancel.bind($resultPromise);
+    return $typingPromise;
+}
+
+/**
+ * GetDefaultThemes 获取默认主题
+ */
+export function GetDefaultThemes(): Promise<{ [_: string]: models$0.Theme | null }> & { cancel(): void } {
+    let $resultPromise = $Call.ByID(3801788118) as any;
+    let $typingPromise = $resultPromise.then(($result: any) => {
+        return $$createType3($result);
+    }) as any;
+    $typingPromise.cancel = $resultPromise.cancel.bind($resultPromise);
+    return $typingPromise;
+}
+
+/**
+ * GetThemeByType 根据类型获取默认主题
+ */
+export function GetThemeByType(themeType: models$0.ThemeType): Promise<models$0.Theme | null> & { cancel(): void } {
+    let $resultPromise = $Call.ByID(1680465265, themeType) as any;
+    let $typingPromise = $resultPromise.then(($result: any) => {
+        return $$createType1($result);
+    }) as any;
+    $typingPromise.cancel = $resultPromise.cancel.bind($resultPromise);
+    return $typingPromise;
+}
+
+/**
+ * ResetThemeColors 重置主题颜色为默认值
+ */
+export function ResetThemeColors(themeType: models$0.ThemeType): Promise<void> & { cancel(): void } {
+    let $resultPromise = $Call.ByID(342461245, themeType) as any;
+    return $resultPromise;
+}
+
+/**
+ * ServiceShutdown 服务关闭
+ */
+export function ServiceShutdown(): Promise<void> & { cancel(): void } {
+    let $resultPromise = $Call.ByID(1676749034) as any;
+    return $resultPromise;
+}
+
+/**
+ * ServiceStartup 服务启动时初始化
+ */
+export function ServiceStartup(options: application$0.ServiceOptions): Promise<void> & { cancel(): void } {
+    let $resultPromise = $Call.ByID(2915959937, options) as any;
+    return $resultPromise;
+}
+
+/**
+ * UpdateThemeColors 更新主题颜色
+ */
+export function UpdateThemeColors(themeType: models$0.ThemeType, colors: models$0.ThemeColorConfig): Promise<void> & { cancel(): void } {
+    let $resultPromise = $Call.ByID(2750902529, themeType, colors) as any;
+    return $resultPromise;
+}
+
+// Private type creation functions
+const $$createType0 = models$0.Theme.createFrom;
+const $$createType1 = $Create.Nullable($$createType0);
+const $$createType2 = $Create.Array($$createType1);
+const $$createType3 = $Create.Map($Create.Any, $$createType1);
--- a/frontend/bindings/voidraft/internal/services/windowservice.ts
+++ b/frontend/bindings/voidraft/internal/services/windowservice.ts
@@ -2,7 +2,7 @@
 // This file is automatically generated. DO NOT EDIT

 /**
- * WindowService 窗口管理服务
+ * WindowService 窗口管理服务（专注于窗口生命周期管理）
 * @module
 */

@@ -46,6 +46,14 @@ export function OpenDocumentWindow(documentID: number): Promise<void> & { cancel
    return $resultPromise;
 }

+/**
+ * ServiceShutdown 实现服务关闭接口
+ */
+export function ServiceShutdown(): Promise<void> & { cancel(): void } {
+    let $resultPromise = $Call.ByID(202192783) as any;
+    return $resultPromise;
+}
+
 /**
 * SetAppReferences 设置应用和主窗口引用
 */
@@ -54,6 +62,14 @@ export function SetAppReferences(app: application$0.App | null, mainWindow: appl
    return $resultPromise;
 }

+/**
+ * SetWindowSnapService 设置窗口吸附服务引用
+ */
+export function SetWindowSnapService(snapService: $models.WindowSnapService | null): Promise<void> & { cancel(): void } {
+    let $resultPromise = $Call.ByID(1105193745, snapService) as any;
+    return $resultPromise;
+}
+
 // Private type creation functions
 const $$createType0 = $models.WindowInfo.createFrom;
 const $$createType1 = $Create.Array($$createType0);
--- a/frontend/bindings/voidraft/internal/services/windowsnapservice.ts
+++ b/frontend/bindings/voidraft/internal/services/windowsnapservice.ts
@@ -0,0 +1,87 @@
+// Cynhyrchwyd y ffeil hon yn awtomatig. PEIDIWCH Â MODIWL
+// This file is automatically generated. DO NOT EDIT
+
+/**
+ * WindowSnapService 窗口吸附服务
+ * @module
+ */
+
+// eslint-disable-next-line @typescript-eslint/ban-ts-comment
+// @ts-ignore: Unused imports
+import {Call as $Call, Create as $Create} from "@wailsio/runtime";
+
+// eslint-disable-next-line @typescript-eslint/ban-ts-comment
+// @ts-ignore: Unused imports
+import * as application$0 from "../../../github.com/wailsapp/wails/v3/pkg/application/models.js";
+
+/**
+ * Cleanup 清理资源
+ */
+export function Cleanup(): Promise<void> & { cancel(): void } {
+    let $resultPromise = $Call.ByID(2155505498) as any;
+    return $resultPromise;
+}
+
+/**
+ * OnWindowSnapConfigChanged 处理窗口吸附配置变更
+ */
+export function OnWindowSnapConfigChanged(enabled: boolean, threshold: number): Promise<void> & { cancel(): void } {
+    let $resultPromise = $Call.ByID(3794787039, enabled, threshold) as any;
+    return $resultPromise;
+}
+
+/**
+ * RegisterWindow 注册需要吸附管理的窗口
+ */
+export function RegisterWindow(documentID: number, window: application$0.WebviewWindow | null, title: string): Promise<void> & { cancel(): void } {
+    let $resultPromise = $Call.ByID(1000222723, documentID, window, title) as any;
+    return $resultPromise;
+}
+
+/**
+ * ServiceShutdown 实现服务关闭接口
+ */
+export function ServiceShutdown(): Promise<void> & { cancel(): void } {
+    let $resultPromise = $Call.ByID(1172710495) as any;
+    return $resultPromise;
+}
+
+/**
+ * SetAppReferences 设置应用和主窗口引用
+ */
+export function SetAppReferences(app: application$0.App | null, mainWindow: application$0.WebviewWindow | null): Promise<void> & { cancel(): void } {
+    let $resultPromise = $Call.ByID(1782093351, app, mainWindow) as any;
+    return $resultPromise;
+}
+
+/**
+ * SetSnapEnabled 设置是否启用窗口吸附
+ */
+export function SetSnapEnabled(enabled: boolean): Promise<void> & { cancel(): void } {
+    let $resultPromise = $Call.ByID(2280126835, enabled) as any;
+    return $resultPromise;
+}
+
+/**
+ * SetSnapThreshold 设置窗口吸附阈值
+ */
+export function SetSnapThreshold(threshold: number): Promise<void> & { cancel(): void } {
+    let $resultPromise = $Call.ByID(586790049, threshold) as any;
+    return $resultPromise;
+}
+
+/**
+ * StartWindowSnapMonitor 启动窗口吸附监听器
+ */
+export function StartWindowSnapMonitor(): Promise<void> & { cancel(): void } {
+    let $resultPromise = $Call.ByID(84533508) as any;
+    return $resultPromise;
+}
+
+/**
+ * UnregisterWindow 取消注册窗口
+ */
+export function UnregisterWindow(documentID: number): Promise<void> & { cancel(): void } {
+    let $resultPromise = $Call.ByID(2844230768, documentID) as any;
+    return $resultPromise;
+}
--- a/frontend/package-lock.json
+++ b/frontend/package-lock.json
@@ -52,27 +52,27 @@
        "prettier": "^3.6.2",
        "remarkable": "^2.0.1",
        "sass": "^1.90.0",
-        "vue": "^3.5.18",
+        "vue": "^3.5.19",
        "vue-i18n": "^11.1.11",
        "vue-pick-colors": "^1.8.0",
        "vue-router": "^4.5.1"
      },
      "devDependencies": {
-        "@eslint/js": "^9.33.0",
+        "@eslint/js": "^9.34.0",
        "@lezer/generator": "^1.8.0",
        "@types/node": "^24.3.0",
        "@types/remarkable": "^2.0.8",
        "@vitejs/plugin-vue": "^6.0.1",
        "@wailsio/runtime": "latest",
-        "eslint": "^9.33.0",
+        "eslint": "^9.34.0",
        "eslint-plugin-vue": "^10.4.0",
        "globals": "^16.3.0",
        "typescript": "^5.9.2",
-        "typescript-eslint": "^8.39.1",
+        "typescript-eslint": "^8.40.0",
        "unplugin-vue-components": "^29.0.0",
-        "vite": "^7.1.2",
+        "vite": "^7.1.3",
        "vue-eslint-parser": "^10.2.0",
-        "vue-tsc": "^3.0.5"
+        "vue-tsc": "^3.0.6"
      }
    },
    "node_modules/@babel/helper-string-parser": {
@@ -1060,9 +1060,9 @@
      }
    },
    "node_modules/@eslint/js": {
-      "version": "9.33.0",
-      "resolved": "https://registry.npmmirror.com/@eslint/js/-/js-9.33.0.tgz",
-      "integrity": "sha512-5K1/mKhWaMfreBGJTwval43JJmkip0RmM+3+IuqupeSKNC/Th2Kc7ucaq5ovTSra/OOKB9c58CGSz3QMVbWt0A==",
+      "version": "9.34.0",
+      "resolved": "https://registry.npmmirror.com/@eslint/js/-/js-9.34.0.tgz",
+      "integrity": "sha512-EoyvqQnBNsV1CWaEJ559rxXL4c8V92gxirbawSmVUOWXlsRxxQXl6LmCpdUblgxgSkDIqKnhzba2SjRTI/A5Rw==",
      "dev": true,
      "license": "MIT",
      "engines": {
@@ -2128,17 +2128,17 @@
      "license": "MIT"
    },
    "node_modules/@typescript-eslint/eslint-plugin": {
-      "version": "8.39.1",
-      "resolved": "https://registry.npmmirror.com/@typescript-eslint/eslint-plugin/-/eslint-plugin-8.39.1.tgz",
-      "integrity": "sha512-yYegZ5n3Yr6eOcqgj2nJH8cH/ZZgF+l0YIdKILSDjYFRjgYQMgv/lRjV5Z7Up04b9VYUondt8EPMqg7kTWgJ2g==",
+      "version": "8.40.0",
+      "resolved": "https://registry.npmmirror.com/@typescript-eslint/eslint-plugin/-/eslint-plugin-8.40.0.tgz",
+      "integrity": "sha512-w/EboPlBwnmOBtRbiOvzjD+wdiZdgFeo17lkltrtn7X37vagKKWJABvyfsJXTlHe6XBzugmYgd4A4nW+k8Mixw==",
      "dev": true,
      "license": "MIT",
      "dependencies": {
        "@eslint-community/regexpp": "^4.10.0",
-        "@typescript-eslint/scope-manager": "8.39.1",
-        "@typescript-eslint/type-utils": "8.39.1",
-        "@typescript-eslint/utils": "8.39.1",
-        "@typescript-eslint/visitor-keys": "8.39.1",
+        "@typescript-eslint/scope-manager": "8.40.0",
+        "@typescript-eslint/type-utils": "8.40.0",
+        "@typescript-eslint/utils": "8.40.0",
+        "@typescript-eslint/visitor-keys": "8.40.0",
        "graphemer": "^1.4.0",
        "ignore": "^7.0.0",
        "natural-compare": "^1.4.0",
@@ -2152,7 +2152,7 @@
        "url": "https://opencollective.com/typescript-eslint"
      },
      "peerDependencies": {
-        "@typescript-eslint/parser": "^8.39.1",
+        "@typescript-eslint/parser": "^8.40.0",
        "eslint": "^8.57.0 || ^9.0.0",
        "typescript": ">=4.8.4 <6.0.0"
      }
@@ -2168,16 +2168,16 @@
      }
    },
    "node_modules/@typescript-eslint/parser": {
-      "version": "8.39.1",
-      "resolved": "https://registry.npmmirror.com/@typescript-eslint/parser/-/parser-8.39.1.tgz",
-      "integrity": "sha512-pUXGCuHnnKw6PyYq93lLRiZm3vjuslIy7tus1lIQTYVK9bL8XBgJnCWm8a0KcTtHC84Yya1Q6rtll+duSMj0dg==",
+      "version": "8.40.0",
+      "resolved": "https://registry.npmmirror.com/@typescript-eslint/parser/-/parser-8.40.0.tgz",
+      "integrity": "sha512-jCNyAuXx8dr5KJMkecGmZ8KI61KBUhkCob+SD+C+I5+Y1FWI2Y3QmY4/cxMCC5WAsZqoEtEETVhUiUMIGCf6Bw==",
      "dev": true,
      "license": "MIT",
      "dependencies": {
-        "@typescript-eslint/scope-manager": "8.39.1",
-        "@typescript-eslint/types": "8.39.1",
-        "@typescript-eslint/typescript-estree": "8.39.1",
-        "@typescript-eslint/visitor-keys": "8.39.1",
+        "@typescript-eslint/scope-manager": "8.40.0",
+        "@typescript-eslint/types": "8.40.0",
+        "@typescript-eslint/typescript-estree": "8.40.0",
+        "@typescript-eslint/visitor-keys": "8.40.0",
        "debug": "^4.3.4"
      },
      "engines": {
@@ -2193,14 +2193,14 @@
      }
    },
    "node_modules/@typescript-eslint/project-service": {
-      "version": "8.39.1",
-      "resolved": "https://registry.npmmirror.com/@typescript-eslint/project-service/-/project-service-8.39.1.tgz",
-      "integrity": "sha512-8fZxek3ONTwBu9ptw5nCKqZOSkXshZB7uAxuFF0J/wTMkKydjXCzqqga7MlFMpHi9DoG4BadhmTkITBcg8Aybw==",
+      "version": "8.40.0",
+      "resolved": "https://registry.npmmirror.com/@typescript-eslint/project-service/-/project-service-8.40.0.tgz",
+      "integrity": "sha512-/A89vz7Wf5DEXsGVvcGdYKbVM9F7DyFXj52lNYUDS1L9yJfqjW/fIp5PgMuEJL/KeqVTe2QSbXAGUZljDUpArw==",
      "dev": true,
      "license": "MIT",
      "dependencies": {
-        "@typescript-eslint/tsconfig-utils": "^8.39.1",
-        "@typescript-eslint/types": "^8.39.1",
+        "@typescript-eslint/tsconfig-utils": "^8.40.0",
+        "@typescript-eslint/types": "^8.40.0",
        "debug": "^4.3.4"
      },
      "engines": {
@@ -2215,14 +2215,14 @@
      }
    },
    "node_modules/@typescript-eslint/scope-manager": {
-      "version": "8.39.1",
-      "resolved": "https://registry.npmmirror.com/@typescript-eslint/scope-manager/-/scope-manager-8.39.1.tgz",
-      "integrity": "sha512-RkBKGBrjgskFGWuyUGz/EtD8AF/GW49S21J8dvMzpJitOF1slLEbbHnNEtAHtnDAnx8qDEdRrULRnWVx27wGBw==",
+      "version": "8.40.0",
+      "resolved": "https://registry.npmmirror.com/@typescript-eslint/scope-manager/-/scope-manager-8.40.0.tgz",
+      "integrity": "sha512-y9ObStCcdCiZKzwqsE8CcpyuVMwRouJbbSrNuThDpv16dFAj429IkM6LNb1dZ2m7hK5fHyzNcErZf7CEeKXR4w==",
      "dev": true,
      "license": "MIT",
      "dependencies": {
-        "@typescript-eslint/types": "8.39.1",
-        "@typescript-eslint/visitor-keys": "8.39.1"
+        "@typescript-eslint/types": "8.40.0",
+        "@typescript-eslint/visitor-keys": "8.40.0"
      },
      "engines": {
        "node": "^18.18.0 || ^20.9.0 || >=21.1.0"
@@ -2233,9 +2233,9 @@
      }
    },
    "node_modules/@typescript-eslint/tsconfig-utils": {
-      "version": "8.39.1",
-      "resolved": "https://registry.npmmirror.com/@typescript-eslint/tsconfig-utils/-/tsconfig-utils-8.39.1.tgz",
-      "integrity": "sha512-ePUPGVtTMR8XMU2Hee8kD0Pu4NDE1CN9Q1sxGSGd/mbOtGZDM7pnhXNJnzW63zk/q+Z54zVzj44HtwXln5CvHA==",
+      "version": "8.40.0",
+      "resolved": "https://registry.npmmirror.com/@typescript-eslint/tsconfig-utils/-/tsconfig-utils-8.40.0.tgz",
+      "integrity": "sha512-jtMytmUaG9d/9kqSl/W3E3xaWESo4hFDxAIHGVW/WKKtQhesnRIJSAJO6XckluuJ6KDB5woD1EiqknriCtAmcw==",
      "dev": true,
      "license": "MIT",
      "engines": {
@@ -2250,15 +2250,15 @@
      }
    },
    "node_modules/@typescript-eslint/type-utils": {
-      "version": "8.39.1",
-      "resolved": "https://registry.npmmirror.com/@typescript-eslint/type-utils/-/type-utils-8.39.1.tgz",
-      "integrity": "sha512-gu9/ahyatyAdQbKeHnhT4R+y3YLtqqHyvkfDxaBYk97EcbfChSJXyaJnIL3ygUv7OuZatePHmQvuH5ru0lnVeA==",
+      "version": "8.40.0",
+      "resolved": "https://registry.npmmirror.com/@typescript-eslint/type-utils/-/type-utils-8.40.0.tgz",
+      "integrity": "sha512-eE60cK4KzAc6ZrzlJnflXdrMqOBaugeukWICO2rB0KNvwdIMaEaYiywwHMzA1qFpTxrLhN9Lp4E/00EgWcD3Ow==",
      "dev": true,
      "license": "MIT",
      "dependencies": {
-        "@typescript-eslint/types": "8.39.1",
-        "@typescript-eslint/typescript-estree": "8.39.1",
-        "@typescript-eslint/utils": "8.39.1",
+        "@typescript-eslint/types": "8.40.0",
+        "@typescript-eslint/typescript-estree": "8.40.0",
+        "@typescript-eslint/utils": "8.40.0",
        "debug": "^4.3.4",
        "ts-api-utils": "^2.1.0"
      },
@@ -2275,9 +2275,9 @@
      }
    },
    "node_modules/@typescript-eslint/types": {
-      "version": "8.39.1",
-      "resolved": "https://registry.npmmirror.com/@typescript-eslint/types/-/types-8.39.1.tgz",
-      "integrity": "sha512-7sPDKQQp+S11laqTrhHqeAbsCfMkwJMrV7oTDvtDds4mEofJYir414bYKUEb8YPUm9QL3U+8f6L6YExSoAGdQw==",
+      "version": "8.40.0",
+      "resolved": "https://registry.npmmirror.com/@typescript-eslint/types/-/types-8.40.0.tgz",
+      "integrity": "sha512-ETdbFlgbAmXHyFPwqUIYrfc12ArvpBhEVgGAxVYSwli26dn8Ko+lIo4Su9vI9ykTZdJn+vJprs/0eZU0YMAEQg==",
      "dev": true,
      "license": "MIT",
      "engines": {
@@ -2289,16 +2289,16 @@
      }
    },
    "node_modules/@typescript-eslint/typescript-estree": {
-      "version": "8.39.1",
-      "resolved": "https://registry.npmmirror.com/@typescript-eslint/typescript-estree/-/typescript-estree-8.39.1.tgz",
-      "integrity": "sha512-EKkpcPuIux48dddVDXyQBlKdeTPMmALqBUbEk38McWv0qVEZwOpVJBi7ugK5qVNgeuYjGNQxrrnoM/5+TI/BPw==",
+      "version": "8.40.0",
+      "resolved": "https://registry.npmmirror.com/@typescript-eslint/typescript-estree/-/typescript-estree-8.40.0.tgz",
+      "integrity": "sha512-k1z9+GJReVVOkc1WfVKs1vBrR5MIKKbdAjDTPvIK3L8De6KbFfPFt6BKpdkdk7rZS2GtC/m6yI5MYX+UsuvVYQ==",
      "dev": true,
      "license": "MIT",
      "dependencies": {
-        "@typescript-eslint/project-service": "8.39.1",
-        "@typescript-eslint/tsconfig-utils": "8.39.1",
-        "@typescript-eslint/types": "8.39.1",
-        "@typescript-eslint/visitor-keys": "8.39.1",
+        "@typescript-eslint/project-service": "8.40.0",
+        "@typescript-eslint/tsconfig-utils": "8.40.0",
+        "@typescript-eslint/types": "8.40.0",
+        "@typescript-eslint/visitor-keys": "8.40.0",
        "debug": "^4.3.4",
        "fast-glob": "^3.3.2",
        "is-glob": "^4.0.3",
@@ -2344,16 +2344,16 @@
      }
    },
    "node_modules/@typescript-eslint/utils": {
-      "version": "8.39.1",
-      "resolved": "https://registry.npmmirror.com/@typescript-eslint/utils/-/utils-8.39.1.tgz",
-      "integrity": "sha512-VF5tZ2XnUSTuiqZFXCZfZs1cgkdd3O/sSYmdo2EpSyDlC86UM/8YytTmKnehOW3TGAlivqTDT6bS87B/GQ/jyg==",
+      "version": "8.40.0",
+      "resolved": "https://registry.npmmirror.com/@typescript-eslint/utils/-/utils-8.40.0.tgz",
+      "integrity": "sha512-Cgzi2MXSZyAUOY+BFwGs17s7ad/7L+gKt6Y8rAVVWS+7o6wrjeFN4nVfTpbE25MNcxyJ+iYUXflbs2xR9h4UBg==",
      "dev": true,
      "license": "MIT",
      "dependencies": {
        "@eslint-community/eslint-utils": "^4.7.0",
-        "@typescript-eslint/scope-manager": "8.39.1",
-        "@typescript-eslint/types": "8.39.1",
-        "@typescript-eslint/typescript-estree": "8.39.1"
+        "@typescript-eslint/scope-manager": "8.40.0",
+        "@typescript-eslint/types": "8.40.0",
+        "@typescript-eslint/typescript-estree": "8.40.0"
      },
      "engines": {
        "node": "^18.18.0 || ^20.9.0 || >=21.1.0"
@@ -2368,13 +2368,13 @@
      }
    },
    "node_modules/@typescript-eslint/visitor-keys": {
-      "version": "8.39.1",
-      "resolved": "https://registry.npmmirror.com/@typescript-eslint/visitor-keys/-/visitor-keys-8.39.1.tgz",
-      "integrity": "sha512-W8FQi6kEh2e8zVhQ0eeRnxdvIoOkAp/CPAahcNio6nO9dsIwb9b34z90KOlheoyuVf6LSOEdjlkxSkapNEc+4A==",
+      "version": "8.40.0",
+      "resolved": "https://registry.npmmirror.com/@typescript-eslint/visitor-keys/-/visitor-keys-8.40.0.tgz",
+      "integrity": "sha512-8CZ47QwalyRjsypfwnbI3hKy5gJDPmrkLjkgMxhi0+DZZ2QNx2naS6/hWoVYUHU7LU2zleF68V9miaVZvhFfTA==",
      "dev": true,
      "license": "MIT",
      "dependencies": {
-        "@typescript-eslint/types": "8.39.1",
+        "@typescript-eslint/types": "8.40.0",
        "eslint-visitor-keys": "^4.2.1"
      },
      "engines": {
@@ -2403,68 +2403,68 @@
      }
    },
    "node_modules/@volar/language-core": {
-      "version": "2.4.22",
-      "resolved": "https://registry.npmmirror.com/@volar/language-core/-/language-core-2.4.22.tgz",
-      "integrity": "sha512-gp4M7Di5KgNyIyO903wTClYBavRt6UyFNpc5LWfyZr1lBsTUY+QrVZfmbNF2aCyfklBOVk9YC4p+zkwoyT7ECg==",
+      "version": "2.4.23",
+      "resolved": "https://registry.npmmirror.com/@volar/language-core/-/language-core-2.4.23.tgz",
+      "integrity": "sha512-hEEd5ET/oSmBC6pi1j6NaNYRWoAiDhINbT8rmwtINugR39loROSlufGdYMF9TaKGfz+ViGs1Idi3mAhnuPcoGQ==",
      "dev": true,
      "license": "MIT",
      "dependencies": {
-        "@volar/source-map": "2.4.22"
+        "@volar/source-map": "2.4.23"
      }
    },
    "node_modules/@volar/source-map": {
-      "version": "2.4.22",
-      "resolved": "https://registry.npmmirror.com/@volar/source-map/-/source-map-2.4.22.tgz",
-      "integrity": "sha512-L2nVr/1vei0xKRgO2tYVXtJYd09HTRjaZi418e85Q+QdbbqA8h7bBjfNyPPSsjnrOO4l4kaAo78c8SQUAdHvgA==",
+      "version": "2.4.23",
+      "resolved": "https://registry.npmmirror.com/@volar/source-map/-/source-map-2.4.23.tgz",
+      "integrity": "sha512-Z1Uc8IB57Lm6k7q6KIDu/p+JWtf3xsXJqAX/5r18hYOTpJyBn0KXUR8oTJ4WFYOcDzWC9n3IflGgHowx6U6z9Q==",
      "dev": true,
      "license": "MIT"
    },
    "node_modules/@volar/typescript": {
-      "version": "2.4.22",
-      "resolved": "https://registry.npmmirror.com/@volar/typescript/-/typescript-2.4.22.tgz",
-      "integrity": "sha512-6ZczlJW1/GWTrNnkmZxJp4qyBt/SGVlcTuCWpI5zLrdPdCZsj66Aff9ZsfFaT3TyjG8zVYgBMYPuCm/eRkpcpQ==",
+      "version": "2.4.23",
+      "resolved": "https://registry.npmmirror.com/@volar/typescript/-/typescript-2.4.23.tgz",
+      "integrity": "sha512-lAB5zJghWxVPqfcStmAP1ZqQacMpe90UrP5RJ3arDyrhy4aCUQqmxPPLB2PWDKugvylmO41ljK7vZ+t6INMTag==",
      "dev": true,
      "license": "MIT",
      "dependencies": {
-        "@volar/language-core": "2.4.22",
+        "@volar/language-core": "2.4.23",
        "path-browserify": "^1.0.1",
        "vscode-uri": "^3.0.8"
      }
    },
    "node_modules/@vue/compiler-core": {
-      "version": "3.5.18",
-      "resolved": "https://registry.npmmirror.com/@vue/compiler-core/-/compiler-core-3.5.18.tgz",
-      "integrity": "sha512-3slwjQrrV1TO8MoXgy3aynDQ7lslj5UqDxuHnrzHtpON5CBinhWjJETciPngpin/T3OuW3tXUf86tEurusnztw==",
+      "version": "3.5.19",
+      "resolved": "https://registry.npmmirror.com/@vue/compiler-core/-/compiler-core-3.5.19.tgz",
+      "integrity": "sha512-/afpyvlkrSNYbPo94Qu8GtIOWS+g5TRdOvs6XZNw6pWQQmj5pBgSZvEPOIZlqWq0YvoUhDDQaQ2TnzuJdOV4hA==",
      "license": "MIT",
      "dependencies": {
-        "@babel/parser": "^7.28.0",
-        "@vue/shared": "3.5.18",
+        "@babel/parser": "^7.28.3",
+        "@vue/shared": "3.5.19",
        "entities": "^4.5.0",
        "estree-walker": "^2.0.2",
        "source-map-js": "^1.2.1"
      }
    },
    "node_modules/@vue/compiler-dom": {
-      "version": "3.5.18",
-      "resolved": "https://registry.npmmirror.com/@vue/compiler-dom/-/compiler-dom-3.5.18.tgz",
-      "integrity": "sha512-RMbU6NTU70++B1JyVJbNbeFkK+A+Q7y9XKE2EM4NLGm2WFR8x9MbAtWxPPLdm0wUkuZv9trpwfSlL6tjdIa1+A==",
+      "version": "3.5.19",
+      "resolved": "https://registry.npmmirror.com/@vue/compiler-dom/-/compiler-dom-3.5.19.tgz",
+      "integrity": "sha512-Drs6rPHQZx/pN9S6ml3Z3K/TWCIRPvzG2B/o5kFK9X0MNHt8/E+38tiRfojufrYBfA6FQUFB2qBBRXlcSXWtOA==",
      "license": "MIT",
      "dependencies": {
-        "@vue/compiler-core": "3.5.18",
-        "@vue/shared": "3.5.18"
+        "@vue/compiler-core": "3.5.19",
+        "@vue/shared": "3.5.19"
      }
    },
    "node_modules/@vue/compiler-sfc": {
-      "version": "3.5.18",
-      "resolved": "https://registry.npmmirror.com/@vue/compiler-sfc/-/compiler-sfc-3.5.18.tgz",
-      "integrity": "sha512-5aBjvGqsWs+MoxswZPoTB9nSDb3dhd1x30xrrltKujlCxo48j8HGDNj3QPhF4VIS0VQDUrA1xUfp2hEa+FNyXA==",
+      "version": "3.5.19",
+      "resolved": "https://registry.npmmirror.com/@vue/compiler-sfc/-/compiler-sfc-3.5.19.tgz",
+      "integrity": "sha512-YWCm1CYaJ+2RvNmhCwI7t3I3nU+hOrWGWMsn+Z/kmm1jy5iinnVtlmkiZwbLlbV1SRizX7vHsc0/bG5dj0zRTg==",
      "license": "MIT",
      "dependencies": {
-        "@babel/parser": "^7.28.0",
-        "@vue/compiler-core": "3.5.18",
-        "@vue/compiler-dom": "3.5.18",
-        "@vue/compiler-ssr": "3.5.18",
-        "@vue/shared": "3.5.18",
+        "@babel/parser": "^7.28.3",
+        "@vue/compiler-core": "3.5.19",
+        "@vue/compiler-dom": "3.5.19",
+        "@vue/compiler-ssr": "3.5.19",
+        "@vue/shared": "3.5.19",
        "estree-walker": "^2.0.2",
        "magic-string": "^0.30.17",
        "postcss": "^8.5.6",
@@ -2472,13 +2472,13 @@
      }
    },
    "node_modules/@vue/compiler-ssr": {
-      "version": "3.5.18",
-      "resolved": "https://registry.npmmirror.com/@vue/compiler-ssr/-/compiler-ssr-3.5.18.tgz",
-      "integrity": "sha512-xM16Ak7rSWHkM3m22NlmcdIM+K4BMyFARAfV9hYFl+SFuRzrZ3uGMNW05kA5pmeMa0X9X963Kgou7ufdbpOP9g==",
+      "version": "3.5.19",
+      "resolved": "https://registry.npmmirror.com/@vue/compiler-ssr/-/compiler-ssr-3.5.19.tgz",
+      "integrity": "sha512-/wx0VZtkWOPdiQLWPeQeqpHWR/LuNC7bHfSX7OayBTtUy8wur6vT6EQIX6Et86aED6J+y8tTw43qo2uoqGg5sw==",
      "license": "MIT",
      "dependencies": {
-        "@vue/compiler-dom": "3.5.18",
-        "@vue/shared": "3.5.18"
+        "@vue/compiler-dom": "3.5.19",
+        "@vue/shared": "3.5.19"
      }
    },
    "node_modules/@vue/compiler-vue2": {
@@ -2526,13 +2526,13 @@
      }
    },
    "node_modules/@vue/language-core": {
-      "version": "3.0.5",
-      "resolved": "https://registry.npmmirror.com/@vue/language-core/-/language-core-3.0.5.tgz",
-      "integrity": "sha512-gCEjn9Ik7I/seHVNIEipOm8W+f3/kg60e8s1IgIkMYma2wu9ZGUTMv3mSL2bX+Md2L8fslceJ4SU8j1fgSRoiw==",
+      "version": "3.0.6",
+      "resolved": "https://registry.npmmirror.com/@vue/language-core/-/language-core-3.0.6.tgz",
+      "integrity": "sha512-e2RRzYWm+qGm8apUHW1wA5RQxzNhkqbbKdbKhiDUcmMrNAZGyM8aTiL3UrTqkaFI5s7wJRGGrp4u3jgusuBp2A==",
      "dev": true,
      "license": "MIT",
      "dependencies": {
-        "@volar/language-core": "2.4.22",
+        "@volar/language-core": "2.4.23",
        "@vue/compiler-dom": "^3.5.0",
        "@vue/compiler-vue2": "^2.7.16",
        "@vue/shared": "^3.5.0",
@@ -2564,53 +2564,53 @@
      }
    },
    "node_modules/@vue/reactivity": {
-      "version": "3.5.18",
-      "resolved": "https://registry.npmmirror.com/@vue/reactivity/-/reactivity-3.5.18.tgz",
-      "integrity": "sha512-x0vPO5Imw+3sChLM5Y+B6G1zPjwdOri9e8V21NnTnlEvkxatHEH5B5KEAJcjuzQ7BsjGrKtfzuQ5eQwXh8HXBg==",
+      "version": "3.5.19",
+      "resolved": "https://registry.npmmirror.com/@vue/reactivity/-/reactivity-3.5.19.tgz",
+      "integrity": "sha512-4bueZg2qs5MSsK2dQk3sssV0cfvxb/QZntTC8v7J448GLgmfPkQ+27aDjlt40+XFqOwUq5yRxK5uQh14Fc9eVA==",
      "license": "MIT",
      "dependencies": {
-        "@vue/shared": "3.5.18"
+        "@vue/shared": "3.5.19"
      }
    },
    "node_modules/@vue/runtime-core": {
-      "version": "3.5.18",
-      "resolved": "https://registry.npmmirror.com/@vue/runtime-core/-/runtime-core-3.5.18.tgz",
-      "integrity": "sha512-DUpHa1HpeOQEt6+3nheUfqVXRog2kivkXHUhoqJiKR33SO4x+a5uNOMkV487WPerQkL0vUuRvq/7JhRgLW3S+w==",
+      "version": "3.5.19",
+      "resolved": "https://registry.npmmirror.com/@vue/runtime-core/-/runtime-core-3.5.19.tgz",
+      "integrity": "sha512-TaooCr8Hge1sWjLSyhdubnuofs3shhzZGfyD11gFolZrny76drPwBVQj28/z/4+msSFb18tOIg6VVVgf9/IbIA==",
      "license": "MIT",
      "dependencies": {
-        "@vue/reactivity": "3.5.18",
-        "@vue/shared": "3.5.18"
+        "@vue/reactivity": "3.5.19",
+        "@vue/shared": "3.5.19"
      }
    },
    "node_modules/@vue/runtime-dom": {
-      "version": "3.5.18",
-      "resolved": "https://registry.npmmirror.com/@vue/runtime-dom/-/runtime-dom-3.5.18.tgz",
-      "integrity": "sha512-YwDj71iV05j4RnzZnZtGaXwPoUWeRsqinblgVJwR8XTXYZ9D5PbahHQgsbmzUvCWNF6x7siQ89HgnX5eWkr3mw==",
+      "version": "3.5.19",
+      "resolved": "https://registry.npmmirror.com/@vue/runtime-dom/-/runtime-dom-3.5.19.tgz",
+      "integrity": "sha512-qmahqeok6ztuUTmV8lqd7N9ymbBzctNF885n8gL3xdCC1u2RnM/coX16Via0AiONQXUoYpxPojL3U1IsDgSWUQ==",
      "license": "MIT",
      "dependencies": {
-        "@vue/reactivity": "3.5.18",
-        "@vue/runtime-core": "3.5.18",
-        "@vue/shared": "3.5.18",
+        "@vue/reactivity": "3.5.19",
+        "@vue/runtime-core": "3.5.19",
+        "@vue/shared": "3.5.19",
        "csstype": "^3.1.3"
      }
    },
    "node_modules/@vue/server-renderer": {
-      "version": "3.5.18",
-      "resolved": "https://registry.npmmirror.com/@vue/server-renderer/-/server-renderer-3.5.18.tgz",
-      "integrity": "sha512-PvIHLUoWgSbDG7zLHqSqaCoZvHi6NNmfVFOqO+OnwvqMz/tqQr3FuGWS8ufluNddk7ZLBJYMrjcw1c6XzR12mA==",
+      "version": "3.5.19",
+      "resolved": "https://registry.npmmirror.com/@vue/server-renderer/-/server-renderer-3.5.19.tgz",
+      "integrity": "sha512-ZJ/zV9SQuaIO+BEEVq/2a6fipyrSYfjKMU3267bPUk+oTx/hZq3RzV7VCh0Unlppt39Bvh6+NzxeopIFv4HJNg==",
      "license": "MIT",
      "dependencies": {
-        "@vue/compiler-ssr": "3.5.18",
-        "@vue/shared": "3.5.18"
+        "@vue/compiler-ssr": "3.5.19",
+        "@vue/shared": "3.5.19"
      },
      "peerDependencies": {
-        "vue": "3.5.18"
+        "vue": "3.5.19"
      }
    },
    "node_modules/@vue/shared": {
-      "version": "3.5.18",
-      "resolved": "https://registry.npmmirror.com/@vue/shared/-/shared-3.5.18.tgz",
-      "integrity": "sha512-cZy8Dq+uuIXbxCZpuLd2GJdeSO/lIzIspC2WtkqIpje5QyFbvLaI5wZtdUjLHjGZrlVX6GilejatWwVYYRc8tA==",
+      "version": "3.5.19",
+      "resolved": "https://registry.npmmirror.com/@vue/shared/-/shared-3.5.19.tgz",
+      "integrity": "sha512-IhXCOn08wgKrLQxRFKKlSacWg4Goi1BolrdEeLYn6tgHjJNXVrWJ5nzoxZqNwl5p88aLlQ8LOaoMa3AYvaKJ/Q==",
      "license": "MIT"
    },
    "node_modules/@wailsio/runtime": {
@@ -2661,9 +2661,9 @@
      }
    },
    "node_modules/alien-signals": {
-      "version": "2.0.6",
-      "resolved": "https://registry.npmmirror.com/alien-signals/-/alien-signals-2.0.6.tgz",
-      "integrity": "sha512-P3TxJSe31bUHBiblg59oU1PpaWPtmxF9GhJ/cB7OkgJ0qN/ifFSKUI25/v8ZhsT+lIG6ac8DpTOplXxORX6F3Q==",
+      "version": "2.0.7",
+      "resolved": "https://registry.npmmirror.com/alien-signals/-/alien-signals-2.0.7.tgz",
+      "integrity": "sha512-wE7y3jmYeb0+h6mr5BOovuqhFv22O/MV9j5p0ndJsa7z1zJNPGQ4ph5pQk/kTTCWRC3xsA4SmtwmkzQO+7NCNg==",
      "dev": true,
      "license": "MIT"
    },
@@ -3166,9 +3166,9 @@
      }
    },
    "node_modules/eslint": {
-      "version": "9.33.0",
-      "resolved": "https://registry.npmmirror.com/eslint/-/eslint-9.33.0.tgz",
-      "integrity": "sha512-TS9bTNIryDzStCpJN93aC5VRSW3uTx9sClUn4B87pwiCaJh220otoI0X8mJKr+VcPtniMdN8GKjlwgWGUv5ZKA==",
+      "version": "9.34.0",
+      "resolved": "https://registry.npmmirror.com/eslint/-/eslint-9.34.0.tgz",
+      "integrity": "sha512-RNCHRX5EwdrESy3Jc9o8ie8Bog+PeYvvSR8sDGoZxNFTvZ4dlxUB3WzQ3bQMztFrSRODGrLLj8g6OFuGY/aiQg==",
      "dev": true,
      "license": "MIT",
      "dependencies": {
@@ -3178,7 +3178,7 @@
        "@eslint/config-helpers": "^0.3.1",
        "@eslint/core": "^0.15.2",
        "@eslint/eslintrc": "^3.3.1",
-        "@eslint/js": "9.33.0",
+        "@eslint/js": "9.34.0",
        "@eslint/plugin-kit": "^0.3.5",
        "@humanfs/node": "^0.16.6",
        "@humanwhocodes/module-importer": "^1.0.1",
@@ -4794,16 +4794,16 @@
      }
    },
    "node_modules/typescript-eslint": {
-      "version": "8.39.1",
-      "resolved": "https://registry.npmmirror.com/typescript-eslint/-/typescript-eslint-8.39.1.tgz",
-      "integrity": "sha512-GDUv6/NDYngUlNvwaHM1RamYftxf782IyEDbdj3SeaIHHv8fNQVRC++fITT7kUJV/5rIA/tkoRSSskt6osEfqg==",
+      "version": "8.40.0",
+      "resolved": "https://registry.npmmirror.com/typescript-eslint/-/typescript-eslint-8.40.0.tgz",
+      "integrity": "sha512-Xvd2l+ZmFDPEt4oj1QEXzA4A2uUK6opvKu3eGN9aGjB8au02lIVcLyi375w94hHyejTOmzIU77L8ol2sRg9n7Q==",
      "dev": true,
      "license": "MIT",
      "dependencies": {
-        "@typescript-eslint/eslint-plugin": "8.39.1",
-        "@typescript-eslint/parser": "8.39.1",
-        "@typescript-eslint/typescript-estree": "8.39.1",
-        "@typescript-eslint/utils": "8.39.1"
+        "@typescript-eslint/eslint-plugin": "8.40.0",
+        "@typescript-eslint/parser": "8.40.0",
+        "@typescript-eslint/typescript-estree": "8.40.0",
+        "@typescript-eslint/utils": "8.40.0"
      },
      "engines": {
        "node": "^18.18.0 || ^20.9.0 || >=21.1.0"
@@ -5103,14 +5103,14 @@
      "license": "MIT"
    },
    "node_modules/vite": {
-      "version": "7.1.2",
-      "resolved": "https://registry.npmmirror.com/vite/-/vite-7.1.2.tgz",
-      "integrity": "sha512-J0SQBPlQiEXAF7tajiH+rUooJPo0l8KQgyg4/aMunNtrOa7bwuZJsJbDWzeljqQpgftxuq5yNJxQ91O9ts29UQ==",
+      "version": "7.1.3",
+      "resolved": "https://registry.npmmirror.com/vite/-/vite-7.1.3.tgz",
+      "integrity": "sha512-OOUi5zjkDxYrKhTV3V7iKsoS37VUM7v40+HuwEmcrsf11Cdx9y3DIr2Px6liIcZFwt3XSRpQvFpL3WVy7ApkGw==",
      "dev": true,
      "license": "MIT",
      "dependencies": {
        "esbuild": "^0.25.0",
-        "fdir": "^6.4.6",
+        "fdir": "^6.5.0",
        "picomatch": "^4.0.3",
        "postcss": "^8.5.6",
        "rollup": "^4.43.0",
@@ -5178,11 +5178,14 @@
      }
    },
    "node_modules/vite/node_modules/fdir": {
-      "version": "6.4.6",
-      "resolved": "https://registry.npmmirror.com/fdir/-/fdir-6.4.6.tgz",
-      "integrity": "sha512-hiFoqpyZcfNm1yc4u8oWCf9A2c4D3QjCrks3zmoVKVxpQRzmPNar1hUJcBG2RQHvEVGDN+Jm81ZheVLAQMK6+w==",
+      "version": "6.5.0",
+      "resolved": "https://registry.npmmirror.com/fdir/-/fdir-6.5.0.tgz",
+      "integrity": "sha512-tIbYtZbucOs0BRGqPJkshJUYdL+SDH7dVM8gjy+ERp3WAUjLEFJE+02kanyHtwjWOnwrKYBiwAmM0p4kLJAnXg==",
      "dev": true,
      "license": "MIT",
+      "engines": {
+        "node": ">=12.0.0"
+      },
      "peerDependencies": {
        "picomatch": "^3 || ^4"
      },
@@ -5213,16 +5216,16 @@
      "license": "MIT"
    },
    "node_modules/vue": {
-      "version": "3.5.18",
-      "resolved": "https://registry.npmmirror.com/vue/-/vue-3.5.18.tgz",
-      "integrity": "sha512-7W4Y4ZbMiQ3SEo+m9lnoNpV9xG7QVMLa+/0RFwwiAVkeYoyGXqWE85jabU4pllJNUzqfLShJ5YLptewhCWUgNA==",
+      "version": "3.5.19",
+      "resolved": "https://registry.npmmirror.com/vue/-/vue-3.5.19.tgz",
+      "integrity": "sha512-ZRh0HTmw6KChRYWgN8Ox/wi7VhpuGlvMPrHjIsdRbzKNgECFLzy+dKL5z9yGaBSjCpmcfJCbh3I1tNSRmBz2tg==",
      "license": "MIT",
      "dependencies": {
-        "@vue/compiler-dom": "3.5.18",
-        "@vue/compiler-sfc": "3.5.18",
-        "@vue/runtime-dom": "3.5.18",
-        "@vue/server-renderer": "3.5.18",
-        "@vue/shared": "3.5.18"
+        "@vue/compiler-dom": "3.5.19",
+        "@vue/compiler-sfc": "3.5.19",
+        "@vue/runtime-dom": "3.5.19",
+        "@vue/server-renderer": "3.5.19",
+        "@vue/shared": "3.5.19"
      },
      "peerDependencies": {
        "typescript": "*"
@@ -5318,14 +5321,14 @@
      "license": "MIT"
    },
    "node_modules/vue-tsc": {
-      "version": "3.0.5",
-      "resolved": "https://registry.npmmirror.com/vue-tsc/-/vue-tsc-3.0.5.tgz",
-      "integrity": "sha512-PsTFN9lo1HJCrZw9NoqjYcAbYDXY0cOKyuW2E7naX5jcaVyWpqEsZOHN9Dws5890E8e5SDAD4L4Zam3dxG3/Cw==",
+      "version": "3.0.6",
+      "resolved": "https://registry.npmmirror.com/vue-tsc/-/vue-tsc-3.0.6.tgz",
+      "integrity": "sha512-Tbs8Whd43R2e2nxez4WXPvvdjGbW24rOSgRhLOHXzWiT4pcP4G7KeWh0YCn18rF4bVwv7tggLLZ6MJnO6jXPBg==",
      "dev": true,
      "license": "MIT",
      "dependencies": {
-        "@volar/typescript": "2.4.22",
-        "@vue/language-core": "3.0.5"
+        "@volar/typescript": "2.4.23",
+        "@vue/language-core": "3.0.6"
      },
      "bin": {
        "vue-tsc": "bin/vue-tsc.js"
--- a/frontend/package.json
+++ b/frontend/package.json
@@ -56,26 +56,26 @@
    "prettier": "^3.6.2",
    "remarkable": "^2.0.1",
    "sass": "^1.90.0",
-    "vue": "^3.5.18",
+    "vue": "^3.5.19",
    "vue-i18n": "^11.1.11",
    "vue-pick-colors": "^1.8.0",
    "vue-router": "^4.5.1"
  },
  "devDependencies": {
-    "@eslint/js": "^9.33.0",
+    "@eslint/js": "^9.34.0",
    "@lezer/generator": "^1.8.0",
    "@types/node": "^24.3.0",
    "@types/remarkable": "^2.0.8",
    "@vitejs/plugin-vue": "^6.0.1",
    "@wailsio/runtime": "latest",
-    "eslint": "^9.33.0",
+    "eslint": "^9.34.0",
    "eslint-plugin-vue": "^10.4.0",
    "globals": "^16.3.0",
    "typescript": "^5.9.2",
-    "typescript-eslint": "^8.39.1",
+    "typescript-eslint": "^8.40.0",
    "unplugin-vue-components": "^29.0.0",
-    "vite": "^7.1.2",
+    "vite": "^7.1.3",
    "vue-eslint-parser": "^10.2.0",
-    "vue-tsc": "^3.0.5"
+    "vue-tsc": "^3.0.6"
  }
 }
--- a/frontend/src/components/toolbar/DocumentSelector.vue
+++ b/frontend/src/components/toolbar/DocumentSelector.vue
@@ -214,7 +214,7 @@ const openInNewWindow = async (doc: Document, event: Event) => {
  }
 };

-// 处理删除 - 简化确认机制
+// 处理删除
 const handleDelete = async (doc: Document, event: Event) => {
  event.stopPropagation();

@@ -242,9 +242,13 @@ const handleDelete = async (doc: Document, event: Event) => {
        return;
      }
      
-      await documentStore.deleteDocument(doc.id);
-      await documentStore.updateDocuments();
+      const deleteSuccess = await documentStore.deleteDocument(doc.id);

+      if (!deleteSuccess) {
+        return;
+      }
+      
+      await documentStore.updateDocuments();
      // 如果删除的是当前文档，切换到第一个文档
      if (documentStore.currentDocument?.id === doc.id && documentStore.documentList.length > 0) {
        const firstDoc = documentStore.documentList[0];
--- a/frontend/src/i18n/locales/en-US.ts
+++ b/frontend/src/i18n/locales/en-US.ts
@@ -134,6 +134,7 @@ export default {
    showInSystemTray: 'Show in System Tray',
    enableSystemTray: 'Enable System Tray',
    alwaysOnTop: 'Always on Top',
+    enableWindowSnap: 'Enable Window Snapping',
    startup: 'Startup Settings',
    startAtLogin: 'Start at Login',
    dataStorage: 'Data Storage',
--- a/frontend/src/i18n/locales/zh-CN.ts
+++ b/frontend/src/i18n/locales/zh-CN.ts
@@ -135,6 +135,7 @@ export default {
    showInSystemTray: '在系统托盘中显示',
    enableSystemTray: '启用系统托盘',
    alwaysOnTop: '窗口始终置顶',
+    enableWindowSnap: '启用窗口吸附',
    startup: '启动设置',
    startAtLogin: '开机自启动',
    dataStorage: '数据存储',
--- a/frontend/src/stores/configStore.ts
+++ b/frontend/src/stores/configStore.ts
@@ -62,7 +62,9 @@ const GENERAL_CONFIG_KEY_MAP: GeneralConfigKeyMap = {
    enableSystemTray: 'general.enableSystemTray',
    startAtLogin: 'general.startAtLogin',
    enableGlobalHotkey: 'general.enableGlobalHotkey',
-    globalHotkey: 'general.globalHotkey'
+    globalHotkey: 'general.globalHotkey',
+    enableWindowSnap: 'general.enableWindowSnap',
+    snapThreshold: 'general.snapThreshold'
 } as const;

 const EDITING_CONFIG_KEY_MAP: EditingConfigKeyMap = {
@@ -78,8 +80,7 @@ const EDITING_CONFIG_KEY_MAP: EditingConfigKeyMap = {

 const APPEARANCE_CONFIG_KEY_MAP: AppearanceConfigKeyMap = {
    language: 'appearance.language',
-    systemTheme: 'appearance.systemTheme',
-    customTheme: 'appearance.customTheme'
+    systemTheme: 'appearance.systemTheme'
 } as const;

 const UPDATES_CONFIG_KEY_MAP: UpdatesConfigKeyMap = {
@@ -177,7 +178,9 @@ const DEFAULT_CONFIG: AppConfig = {
            alt: true,
            win: false,
            key: 'X'
-        }
+        },
+        enableWindowSnap: true,
+        snapThreshold: 15
    },
    editing: {
        fontSize: CONFIG_LIMITS.fontSize.default,
@@ -189,80 +192,10 @@ const DEFAULT_CONFIG: AppConfig = {
        tabType: CONFIG_LIMITS.tabType.default,
        autoSaveDelay: 5000
    },
-    appearance: {
-        language: LanguageType.LangZhCN,
-        systemTheme: SystemThemeType.SystemThemeAuto,
-        customTheme: {
-            darkTheme: {
-                // 基础色调
-                background: '#252B37',
-                backgroundSecondary: '#213644',
-                surface: '#474747',
-                foreground: '#9BB586',
-                foregroundSecondary: '#9c9c9c',
-                
-                // 语法高亮
-                comment: '#6272a4',
-                keyword: '#ff79c6',
-                string: '#f1fa8c',
-                function: '#50fa7b',
-                number: '#bd93f9',
-                operator: '#ff79c6',
-                variable: '#8fbcbb',
-                type: '#8be9fd',
-                
-                // 界面元素
-                cursor: '#fff',
-                selection: '#0865a9aa',
-                selectionBlur: '#225377aa',
-                activeLine: 'rgba(255,255,255,0.04)',
-                lineNumber: 'rgba(255,255,255, 0.15)',
-                activeLineNumber: 'rgba(255,255,255, 0.6)',
-                
-                // 边框分割线
-                borderColor: '#1e222a',
-                borderLight: 'rgba(255,255,255, 0.1)',
-                
-                // 搜索匹配
-                searchMatch: '#8fbcbb',
-                matchingBracket: 'rgba(255,255,255,0.1)'
-            },
-            lightTheme: {
-                // 基础色调
-                background: '#ffffff',
-                backgroundSecondary: '#f1faf1',
-                surface: '#f5f5f5',
-                foreground: '#444d56',
-                foregroundSecondary: '#6a737d',
-                
-                // 语法高亮
-                comment: '#6a737d',
-                keyword: '#d73a49',
-                string: '#032f62',
-                function: '#005cc5',
-                number: '#005cc5',
-                operator: '#d73a49',
-                variable: '#24292e',
-                type: '#6f42c1',
-                
-                // 界面元素
-                cursor: '#000',
-                selection: '#77baff8c',
-                selectionBlur: '#b2c2ca85',
-                activeLine: '#000000',
-                lineNumber: '#000000',
-                activeLineNumber: '#000000',
-                
-                // 边框分割线
-                borderColor: '#dfdfdf',
-                borderLight: '#0000000C',
-                
-                // 搜索匹配
-                searchMatch: '#005cc5',
-                matchingBracket: 'rgba(0,0,0,0.1)'
-            }
-        }
-    },
+            appearance: {
+            language: LanguageType.LangZhCN,
+            systemTheme: SystemThemeType.SystemThemeAuto
+        },
    updates: {
        version: "1.0.0",
        autoUpdate: true,
@@ -478,50 +411,7 @@ export const useConfigStore = defineStore('config', () => {
        await updateAppearanceConfig('systemTheme', systemTheme);
    };

-    // 更新自定义主题方法
-    const updateCustomTheme = async (themeType: 'darkTheme' | 'lightTheme', colorKey: string, colorValue: string): Promise<void> => {
-        // 确保配置已加载
-        if (!state.configLoaded && !state.isLoading) {
-            await initConfig();
-        }

-        try {
-            // 深拷贝当前配置
-            const customTheme = JSON.parse(JSON.stringify(state.config.appearance.customTheme));
-            
-            // 更新对应主题的颜色值
-            customTheme[themeType][colorKey] = colorValue;
-            
-            // 更新整个自定义主题配置到后端
-            await ConfigService.Set(APPEARANCE_CONFIG_KEY_MAP.customTheme, customTheme);
-            
-            // 更新前端状态
-            state.config.appearance.customTheme = customTheme;
-        } catch (error) {
-            throw error;
-        }
-    };
-
-    // 设置整个自定义主题配置
-    const setCustomTheme = async (customTheme: any): Promise<void> => {
-        // 确保配置已加载
-        if (!state.configLoaded && !state.isLoading) {
-            await initConfig();
-        }
-
-        try {
-            // 更新整个自定义主题配置到后端
-            await ConfigService.Set(APPEARANCE_CONFIG_KEY_MAP.customTheme, customTheme);
-            
-            // 更新前端状态
-            state.config.appearance.customTheme = customTheme;
-            
-            // 确保Vue能检测到变化
-            state.config.appearance = { ...state.config.appearance };
-        } catch (error) {
-            throw error;
-        }
-    };

    // 初始化语言设置
    const initializeLanguage = async (): Promise<void> => {
@@ -586,8 +476,6 @@ export const useConfigStore = defineStore('config', () => {

        // 主题相关方法
        setSystemTheme,
-        updateCustomTheme,
-        setCustomTheme,

        // 字体大小操作
        ...adjusters.fontSize,
@@ -636,6 +524,10 @@ export const useConfigStore = defineStore('config', () => {
            // 再调用系统设置API
            await StartupService.SetEnabled(value);
        },
+        
+        // 窗口吸附配置相关方法
+        setEnableWindowSnap: async (value: boolean) => await updateGeneralConfig('enableWindowSnap', value),
+        setSnapThreshold: async (value: number) => await updateGeneralConfig('snapThreshold', value),

        // 更新配置相关方法
        setAutoUpdate: async (value: boolean) => await updateUpdatesConfig('autoUpdate', value),
--- a/frontend/src/stores/themeStore.ts
+++ b/frontend/src/stores/themeStore.ts
@@ -1,6 +1,7 @@
 import {defineStore} from 'pinia';
 import {computed, reactive} from 'vue';
-import {SystemThemeType} from '@/../bindings/voidraft/internal/models/models';
+import {SystemThemeType, ThemeType, ThemeColorConfig} from '@/../bindings/voidraft/internal/models/models';
+import {ThemeService} from '@/../bindings/voidraft/internal/services';
 import {useConfigStore} from './configStore';
 import {useEditorStore} from './editorStore';
 import {defaultDarkColors} from '@/views/editor/theme/dark';
@@ -24,16 +25,21 @@ export const useThemeStore = defineStore('theme', () => {
    configStore.config?.appearance?.systemTheme || SystemThemeType.SystemThemeAuto
  );

-  // 初始化主题颜色 - 从配置加载
-  const initializeThemeColors = () => {
-    const customTheme = configStore.config?.appearance?.customTheme;
-    if (customTheme) {
-      if (customTheme.darkTheme) {
-        Object.assign(themeColors.darkTheme, customTheme.darkTheme);
+  // 初始化主题颜色 - 从数据库加载
+  const initializeThemeColors = async () => {
+    try {
+      const themes = await ThemeService.GetDefaultThemes();
+      if (themes.dark) {
+        Object.assign(themeColors.darkTheme, themes.dark.colors);
      }
-      if (customTheme.lightTheme) {
-        Object.assign(themeColors.lightTheme, customTheme.lightTheme);
+      if (themes.light) {
+        Object.assign(themeColors.lightTheme, themes.light.colors);
      }
+    } catch (error) {
+      console.warn('Failed to load themes from database, using defaults:', error);
+      // 如果数据库加载失败，使用默认主题
+      Object.assign(themeColors.darkTheme, defaultDarkColors);
+      Object.assign(themeColors.lightTheme, defaultLightColors);
    }
  };

@@ -46,10 +52,10 @@ export const useThemeStore = defineStore('theme', () => {
  };

  // 初始化主题
-  const initializeTheme = () => {
+  const initializeTheme = async () => {
    const theme = configStore.config?.appearance?.systemTheme || SystemThemeType.SystemThemeAuto;
    applyThemeToDOM(theme);
-    initializeThemeColors();
+    await initializeThemeColors();
  };

  // 设置主题
@@ -84,31 +90,35 @@ export const useThemeStore = defineStore('theme', () => {
    return hasChanges;
  };
  
-  // 保存主题颜色到配置
+  // 保存主题颜色到数据库
  const saveThemeColors = async () => {
-    const customTheme = {
-      darkTheme: { ...themeColors.darkTheme },
-      lightTheme: { ...themeColors.lightTheme }
-    };
-    
-    await configStore.setCustomTheme(customTheme);
+    try {
+      const darkColors = ThemeColorConfig.createFrom(themeColors.darkTheme);
+      const lightColors = ThemeColorConfig.createFrom(themeColors.lightTheme);
+      
+      await ThemeService.UpdateThemeColors(ThemeType.ThemeTypeDark, darkColors);
+      await ThemeService.UpdateThemeColors(ThemeType.ThemeTypeLight, lightColors);
+    } catch (error) {
+      console.error('Failed to save theme colors:', error);
+      throw error;
+    }
  };
  
  // 重置主题颜色
  const resetThemeColors = async (themeType: 'darkTheme' | 'lightTheme') => {
    try {
-      // 1. 更新内存中的颜色状态
+      const dbThemeType = themeType === 'darkTheme' ? ThemeType.ThemeTypeDark : ThemeType.ThemeTypeLight;
+      
+      // 1. 调用后端重置服务
+      await ThemeService.ResetThemeColors(dbThemeType);
+      
+      // 2. 更新内存中的颜色状态
      if (themeType === 'darkTheme') {
        Object.assign(themeColors.darkTheme, defaultDarkColors);
-      }
-      
-      if (themeType === 'lightTheme') {
+      } else {
        Object.assign(themeColors.lightTheme, defaultLightColors);
      }
      
-      // 2. 保存到配置
-      await saveThemeColors();
-      
      // 3. 刷新编辑器主题
      refreshEditorTheme();
      
--- a/frontend/src/views/settings/pages/AppearancePage.vue
+++ b/frontend/src/views/settings/pages/AppearancePage.vue
@@ -16,8 +16,8 @@ const themeStore = useThemeStore();

 // 添加临时颜色状态
 const tempColors = ref({
-  darkTheme: { ...configStore.config.appearance.customTheme?.darkTheme || defaultDarkColors },
-  lightTheme: { ...configStore.config.appearance.customTheme?.lightTheme || defaultLightColors }
+  darkTheme: { ...defaultDarkColors },
+  lightTheme: { ...defaultLightColors }
 });

 // 标记是否有未保存的更改
@@ -71,9 +71,9 @@ const currentThemeMode = computed(() => {
  return isDark ? 'dark' : 'light';
 });

-// 监听配置变更，更新临时颜色
+// 监听主题颜色变更，更新临时颜色
 watch(
-  () => configStore.config.appearance.customTheme,
+  () => themeStore.themeColors,
  (newValue) => {
    if (!hasUnsavedChanges.value) {
      tempColors.value = {
--- a/frontend/src/views/settings/pages/GeneralPage.vue
+++ b/frontend/src/views/settings/pages/GeneralPage.vue
@@ -159,6 +159,12 @@ const enableSystemTray = computed({
  set: (value: boolean) => configStore.setEnableSystemTray(value)
 });

+// 计算属性 - 启用窗口吸附
+const enableWindowSnap = computed({
+  get: () => configStore.config.general.enableWindowSnap,
+  set: (value: boolean) => configStore.setEnableWindowSnap(value)
+});
+
 // 计算属性 - 开机启动
 const startAtLogin = computed({
  get: () => configStore.config.general.startAtLogin,
@@ -334,6 +340,9 @@ onUnmounted(() => {
      <SettingItem :title="t('settings.enableSystemTray')">
        <ToggleSwitch v-model="enableSystemTray"/>
      </SettingItem>
+      <SettingItem :title="t('settings.enableWindowSnap')">
+        <ToggleSwitch v-model="enableWindowSnap"/>
+      </SettingItem>
    </SettingSection>

    <SettingSection :title="t('settings.startup')">
--- a/go.mod
+++ b/go.mod
@@ -67,8 +67,8 @@ require (
 	github.com/samber/lo v1.51.0 // indirect
 	github.com/sergi/go-diff v1.4.0 // indirect
 	github.com/skeema/knownhosts v1.3.1 // indirect
-	github.com/ulikunitz/xz v0.5.12 // indirect
-	github.com/wailsapp/go-webview2 v1.0.22 // indirect
+	github.com/ulikunitz/xz v0.5.14 // indirect
+	github.com/wailsapp/go-webview2 v1.0.21 // indirect
 	github.com/wailsapp/mimetype v1.4.1 // indirect
 	github.com/xanzy/go-gitlab v0.115.0 // indirect
 	github.com/xanzy/ssh-agent v0.3.3 // indirect
--- a/go.sum
+++ b/go.sum
@@ -158,10 +158,10 @@ github.com/stretchr/testify v1.2.2/go.mod h1:a8OnRcib4nhh0OaRAV+Yts87kKdq0PP7pXf
 github.com/stretchr/testify v1.4.0/go.mod h1:j7eGeouHqKxXV5pUuKE4zz7dFj8WfuZ+81PSLYec5m4=
 github.com/stretchr/testify v1.10.0 h1:Xv5erBjTwe/5IxqUQTdXv5kgmIvbHo3QQyRwhJsOfJA=
 github.com/stretchr/testify v1.10.0/go.mod h1:r2ic/lqez/lEtzL7wO/rwa5dbSLXVDPFyf8C91i36aY=
-github.com/ulikunitz/xz v0.5.12 h1:37Nm15o69RwBkXM0J6A5OlE67RZTfzUxTj8fB3dfcsc=
-github.com/ulikunitz/xz v0.5.12/go.mod h1:nbz6k7qbPmH4IRqmfOplQw/tblSgqTqBwxkY0oWt/14=
-github.com/wailsapp/go-webview2 v1.0.22 h1:YT61F5lj+GGaat5OB96Aa3b4QA+mybD0Ggq6NZijQ58=
-github.com/wailsapp/go-webview2 v1.0.22/go.mod h1:qJmWAmAmaniuKGZPWwne+uor3AHMB5PFhqiK0Bbj8kc=
+github.com/ulikunitz/xz v0.5.14 h1:uv/0Bq533iFdnMHZdRBTOlaNMdb1+ZxXIlHDZHIHcvg=
+github.com/ulikunitz/xz v0.5.14/go.mod h1:nbz6k7qbPmH4IRqmfOplQw/tblSgqTqBwxkY0oWt/14=
+github.com/wailsapp/go-webview2 v1.0.21 h1:k3dtoZU4KCoN/AEIbWiPln3P2661GtA2oEgA2Pb+maA=
+github.com/wailsapp/go-webview2 v1.0.21/go.mod h1:qJmWAmAmaniuKGZPWwne+uor3AHMB5PFhqiK0Bbj8kc=
 github.com/wailsapp/mimetype v1.4.1 h1:pQN9ycO7uo4vsUUuPeHEYoUkLVkaRntMnHJxVwYhwHs=
 github.com/wailsapp/mimetype v1.4.1/go.mod h1:9aV5k31bBOv5z6u+QP8TltzvNGJPmNJD4XlAL3U+j3o=
 github.com/wailsapp/wails/v3 v3.0.0-alpha.25 h1:o05zUiPEvmrq2lqqCs4wqnrnAjGmhryYHRhjQmtkvk8=
--- a/internal/models/config.go
+++ b/internal/models/config.go
@@ -68,6 +68,10 @@ type GeneralConfig struct {
 	EnableSystemTray bool   `json:"enableSystemTray"` // 是否启用系统托盘
 	StartAtLogin     bool   `json:"startAtLogin"`     // 开机启动设置

+	// 窗口吸附设置
+	EnableWindowSnap bool `json:"enableWindowSnap"` // 是否启用窗口吸附功能
+	SnapThreshold    int  `json:"snapThreshold"`    // 吸附距离阈值(像素)
+
 	// 全局热键设置
 	EnableGlobalHotkey bool        `json:"enableGlobalHotkey"` // 是否启用全局热键
 	GlobalHotkey       HotkeyCombo `json:"globalHotkey"`       // 全局热键组合
@@ -101,9 +105,8 @@ type EditingConfig struct {

 // AppearanceConfig 外观设置配置
 type AppearanceConfig struct {
-	Language    LanguageType      `json:"language"`    // 界面语言
-	SystemTheme SystemThemeType   `json:"systemTheme"` // 系统界面主题
-	CustomTheme CustomThemeConfig `json:"customTheme"` // 自定义主题配置
+	Language    LanguageType    `json:"language"`    // 界面语言
+	SystemTheme SystemThemeType `json:"systemTheme"` // 系统界面主题
 }

 // UpdatesConfig 更新设置配置
@@ -146,6 +149,8 @@ func NewDefaultAppConfig() *AppConfig {
 			DataPath:           dataDir,
 			EnableSystemTray:   true,
 			StartAtLogin:       false,
+			EnableWindowSnap:   true, // 默认启用窗口吸附
+			SnapThreshold:      15,   // 默认15像素的吸附阈值
 			EnableGlobalHotkey: false,
 			GlobalHotkey: HotkeyCombo{
 				Ctrl:  false,
@@ -171,7 +176,6 @@ func NewDefaultAppConfig() *AppConfig {
 		Appearance: AppearanceConfig{
 			Language:    LangEnUS,
 			SystemTheme: SystemThemeAuto,
-			CustomTheme: *NewDefaultCustomThemeConfig(),
 		},
 		Updates: UpdatesConfig{
 			Version:            "1.3.0",
--- a/internal/models/theme.go
+++ b/internal/models/theme.go
@@ -1,5 +1,20 @@
 package models

+import (
+	"database/sql/driver"
+	"encoding/json"
+	"fmt"
+	"time"
+)
+
+// ThemeType 主题类型枚举
+type ThemeType string
+
+const (
+	ThemeTypeDark  ThemeType = "dark"
+	ThemeTypeLight ThemeType = "light"
+)
+
 // ThemeColorConfig 主题颜色配置
 type ThemeColorConfig struct {
 	// 基础色调
@@ -36,15 +51,44 @@ type ThemeColorConfig struct {
 	MatchingBracket string `json:"matchingBracket"` // 匹配括号
 }

-// CustomThemeConfig 自定义主题配置
-type CustomThemeConfig struct {
-	DarkTheme  ThemeColorConfig `json:"darkTheme"`  // 深色主题配置
-	LightTheme ThemeColorConfig `json:"lightTheme"` // 浅色主题配置
+// Theme 主题数据库模型
+type Theme struct {
+	ID        int              `db:"id" json:"id"`
+	Name      string           `db:"name" json:"name"`
+	Type      ThemeType        `db:"type" json:"type"`
+	Colors    ThemeColorConfig `db:"colors" json:"colors"`
+	IsDefault bool             `db:"is_default" json:"isDefault"`
+	CreatedAt time.Time        `db:"created_at" json:"createdAt"`
+	UpdatedAt time.Time        `db:"updated_at" json:"updatedAt"`
+}
+
+// Value 实现 driver.Valuer 接口，用于将 ThemeColorConfig 存储到数据库
+func (tc ThemeColorConfig) Value() (driver.Value, error) {
+	return json.Marshal(tc)
+}
+
+// Scan 实现 sql.Scanner 接口，用于从数据库读取 ThemeColorConfig
+func (tc *ThemeColorConfig) Scan(value interface{}) error {
+	if value == nil {
+		return nil
+	}
+
+	var bytes []byte
+	switch v := value.(type) {
+	case []byte:
+		bytes = v
+	case string:
+		bytes = []byte(v)
+	default:
+		return fmt.Errorf("cannot scan %T into ThemeColorConfig", value)
+	}
+
+	return json.Unmarshal(bytes, tc)
 }

 // NewDefaultDarkTheme 创建默认深色主题配置
-func NewDefaultDarkTheme() ThemeColorConfig {
-	return ThemeColorConfig{
+func NewDefaultDarkTheme() *ThemeColorConfig {
+	return &ThemeColorConfig{
 		// 基础色调
 		Background:          "#252B37",
 		BackgroundSecondary: "#213644",
@@ -81,8 +125,8 @@ func NewDefaultDarkTheme() ThemeColorConfig {
 }

 // NewDefaultLightTheme 创建默认浅色主题配置
-func NewDefaultLightTheme() ThemeColorConfig {
-	return ThemeColorConfig{
+func NewDefaultLightTheme() *ThemeColorConfig {
+	return &ThemeColorConfig{
 		// 基础色调
 		Background:          "#ffffff",
 		BackgroundSecondary: "#f1faf1",
@@ -117,11 +161,3 @@ func NewDefaultLightTheme() ThemeColorConfig {
 		MatchingBracket: "#00000019",
 	}
 }
-
-// NewDefaultCustomThemeConfig 创建默认自定义主题配置
-func NewDefaultCustomThemeConfig() *CustomThemeConfig {
-	return &CustomThemeConfig{
-		DarkTheme:  NewDefaultDarkTheme(),
-		LightTheme: NewDefaultLightTheme(),
-	}
-}
--- a/internal/models/window.go
+++ b/internal/models/window.go
@@ -0,0 +1,41 @@
+package models
+
+import "time"
+
+// SnapEdge 表示吸附的边缘类型
+type SnapEdge int
+
+const (
+	SnapEdgeNone        SnapEdge = iota // 未吸附
+	SnapEdgeTop                         // 吸附到上边缘
+	SnapEdgeRight                       // 吸附到右边缘
+	SnapEdgeBottom                      // 吸附到下边缘
+	SnapEdgeLeft                        // 吸附到左边缘
+	SnapEdgeTopRight                    // 吸附到右上角
+	SnapEdgeBottomRight                 // 吸附到右下角
+	SnapEdgeBottomLeft                  // 吸附到左下角
+	SnapEdgeTopLeft                     // 吸附到左上角
+)
+
+// WindowPosition 窗口位置
+type WindowPosition struct {
+	X int `json:"x"` // X坐标
+	Y int `json:"y"` // Y坐标
+}
+
+// SnapPosition 表示吸附的相对位置
+type SnapPosition struct {
+	X int `json:"x"` // X轴相对偏移
+	Y int `json:"y"` // Y轴相对偏移
+}
+
+// WindowInfo 窗口信息
+type WindowInfo struct {
+	DocumentID int64          `json:"documentID"` // 文档ID
+	Title      string         `json:"title"`      // 窗口标题
+	IsSnapped  bool           `json:"isSnapped"`  // 是否处于吸附状态
+	SnapOffset SnapPosition   `json:"snapOffset"` // 与主窗口的相对位置偏移
+	SnapEdge   SnapEdge       `json:"snapEdge"`   // 吸附的边缘类型
+	LastPos    WindowPosition `json:"lastPos"`    // 上一次记录的窗口位置
+	MoveTime   time.Time      `json:"moveTime"`   // 上次移动时间，用于判断移动速度
+}
--- a/internal/services/config_notification_service.go
+++ b/internal/services/config_notification_service.go
@@ -24,6 +24,8 @@ const (
 	ConfigChangeTypeDataPath ConfigChangeType = "datapath"
 	// ConfigChangeTypeBackup 备份配置变更
 	ConfigChangeTypeBackup ConfigChangeType = "backup"
+	// ConfigChangeTypeWindowSnap 窗口吸附配置变更
+	ConfigChangeTypeWindowSnap ConfigChangeType = "windowsnap"
 )

 // ConfigChangeCallback 配置变更回调函数类型
@@ -470,6 +472,29 @@ func CreateBackupConfigListener(name string, callback func(config *models.GitBac
 	}
 }

+// CreateWindowSnapConfigListener 创建窗口吸附配置监听器
+func CreateWindowSnapConfigListener(name string, callback func(enabled bool, threshold int) error) *ConfigListener {
+	return &ConfigListener{
+		Name:       name,
+		ChangeType: ConfigChangeTypeWindowSnap,
+		Callback: func(changeType ConfigChangeType, oldConfig, newConfig *models.AppConfig) error {
+			if newConfig == nil {
+				defaultConfig := models.NewDefaultAppConfig()
+				return callback(defaultConfig.General.EnableWindowSnap, defaultConfig.General.SnapThreshold)
+			}
+			return callback(newConfig.General.EnableWindowSnap, newConfig.General.SnapThreshold)
+		},
+		DebounceDelay: 200 * time.Millisecond,
+		GetConfigFunc: func(k *koanf.Koanf) *models.AppConfig {
+			var config models.AppConfig
+			if err := k.Unmarshal("", &config); err != nil {
+				return nil
+			}
+			return &config
+		},
+	}
+}
+
 // ServiceShutdown 关闭服务
 func (cns *ConfigNotificationService) ServiceShutdown() error {
 	cns.Cleanup()
--- a/internal/services/config_service.go
+++ b/internal/services/config_service.go
@@ -308,6 +308,16 @@ func (cs *ConfigService) SetBackupConfigChangeCallback(callback func(config *mod
 	return cs.notificationService.RegisterListener(backupListener)
 }

+// SetWindowSnapConfigChangeCallback 设置窗口吸附配置变更回调
+func (cs *ConfigService) SetWindowSnapConfigChangeCallback(callback func(enabled bool, threshold int) error) error {
+	cs.mu.Lock()
+	defer cs.mu.Unlock()
+
+	// 创建窗口吸附配置监听器并注册
+	windowSnapListener := CreateWindowSnapConfigListener("DefaultWindowSnapConfigListener", callback)
+	return cs.notificationService.RegisterListener(windowSnapListener)
+}
+
 // ServiceShutdown 关闭服务
 func (cs *ConfigService) ServiceShutdown() error {
 	cs.stopWatching()
--- a/internal/services/database_service.go
+++ b/internal/services/database_service.go
@@ -63,6 +63,19 @@ CREATE TABLE IF NOT EXISTS key_bindings (
    updated_at DATETIME DEFAULT CURRENT_TIMESTAMP,
    UNIQUE(command, extension)
 )`
+
+	// Themes table
+	sqlCreateThemesTable = `
+CREATE TABLE IF NOT EXISTS themes (
+    id INTEGER PRIMARY KEY AUTOINCREMENT,
+    name TEXT NOT NULL,
+    type TEXT NOT NULL,
+    colors TEXT NOT NULL,
+    is_default INTEGER NOT NULL DEFAULT 0,
+    created_at DATETIME DEFAULT CURRENT_TIMESTAMP,
+    updated_at DATETIME DEFAULT CURRENT_TIMESTAMP,
+    UNIQUE(type, is_default)
+)`
 )

 // ColumnInfo 存储列的信息
@@ -112,6 +125,8 @@ func (ds *DatabaseService) registerAllModels() {
 	ds.RegisterModel("extensions", &models.Extension{})
 	// 快捷键表
 	ds.RegisterModel("key_bindings", &models.KeyBinding{})
+	// 主题表
+	ds.RegisterModel("themes", &models.Theme{})
 }

 // ServiceStartup initializes the service when the application starts
@@ -181,6 +196,7 @@ func (ds *DatabaseService) createTables() error {
 		sqlCreateDocumentsTable,
 		sqlCreateExtensionsTable,
 		sqlCreateKeyBindingsTable,
+		sqlCreateThemesTable,
 	}

 	for _, table := range tables {
@@ -204,6 +220,9 @@ func (ds *DatabaseService) createIndexes() error {
 		`CREATE INDEX IF NOT EXISTS idx_key_bindings_command ON key_bindings(command)`,
 		`CREATE INDEX IF NOT EXISTS idx_key_bindings_extension ON key_bindings(extension)`,
 		`CREATE INDEX IF NOT EXISTS idx_key_bindings_enabled ON key_bindings(enabled)`,
+		// Themes indexes
+		`CREATE INDEX IF NOT EXISTS idx_themes_type ON themes(type)`,
+		`CREATE INDEX IF NOT EXISTS idx_themes_is_default ON themes(is_default)`,
 	}

 	for _, index := range indexes {
--- a/internal/services/document_service.go
+++ b/internal/services/document_service.go
@@ -216,14 +216,11 @@ func (ds *DocumentService) CreateDocument(title string) (*models.Document, error

 // LockDocument 锁定文档，防止删除
 func (ds *DocumentService) LockDocument(id int64) error {
-	ds.mu.Lock()
-	defer ds.mu.Unlock()
-
 	if ds.databaseService == nil || ds.databaseService.db == nil {
 		return errors.New("database service not available")
 	}

-	// 检查文档是否存在且未删除
+	// 先检查文档是否存在且未删除（不加锁避免死锁）
 	doc, err := ds.GetDocumentByID(id)
 	if err != nil {
 		return fmt.Errorf("failed to get document: %w", err)
@@ -240,6 +237,10 @@ func (ds *DocumentService) LockDocument(id int64) error {
 		return nil
 	}

+	// 现在加锁执行锁定操作
+	ds.mu.Lock()
+	defer ds.mu.Unlock()
+
 	_, err = ds.databaseService.db.Exec(sqlSetDocumentLocked, time.Now().Format("2006-01-02 15:04:05"), id)
 	if err != nil {
 		return fmt.Errorf("failed to lock document: %w", err)
@@ -249,14 +250,11 @@ func (ds *DocumentService) LockDocument(id int64) error {

 // UnlockDocument 解锁文档
 func (ds *DocumentService) UnlockDocument(id int64) error {
-	ds.mu.Lock()
-	defer ds.mu.Unlock()
-
 	if ds.databaseService == nil || ds.databaseService.db == nil {
 		return errors.New("database service not available")
 	}

-	// 检查文档是否存在
+	// 先检查文档是否存在（不加锁避免死锁）
 	doc, err := ds.GetDocumentByID(id)
 	if err != nil {
 		return fmt.Errorf("failed to get document: %w", err)
@@ -270,6 +268,10 @@ func (ds *DocumentService) UnlockDocument(id int64) error {
 		return nil
 	}

+	// 现在加锁执行解锁操作
+	ds.mu.Lock()
+	defer ds.mu.Unlock()
+
 	_, err = ds.databaseService.db.Exec(sqlSetDocumentUnlocked, time.Now().Format("2006-01-02 15:04:05"), id)
 	if err != nil {
 		return fmt.Errorf("failed to unlock document: %w", err)
@@ -311,10 +313,8 @@ func (ds *DocumentService) UpdateDocumentTitle(id int64, title string) error {

 // DeleteDocument marks a document as deleted (default document with ID=1 cannot be deleted)
 func (ds *DocumentService) DeleteDocument(id int64) error {
-	ds.mu.Lock()
-	defer ds.mu.Unlock()
-
 	if ds.databaseService == nil || ds.databaseService.db == nil {
+		ds.logger.Error("database service not available")
 		return errors.New("database service not available")
 	}

@@ -323,7 +323,7 @@ func (ds *DocumentService) DeleteDocument(id int64) error {
 		return fmt.Errorf("cannot delete the default document")
 	}

-	// 检查文档是否锁定
+	// 先检查文档是否存在和锁定状态（不加锁避免死锁）
 	doc, err := ds.GetDocumentByID(id)
 	if err != nil {
 		return fmt.Errorf("failed to get document: %w", err)
@@ -335,6 +335,10 @@ func (ds *DocumentService) DeleteDocument(id int64) error {
 		return fmt.Errorf("cannot delete locked document: %d", id)
 	}

+	// 现在加锁执行删除操作
+	ds.mu.Lock()
+	defer ds.mu.Unlock()
+
 	_, err = ds.databaseService.db.Exec(sqlMarkDocumentAsDeleted, time.Now().Format("2006-01-02 15:04:05"), id)
 	if err != nil {
 		return fmt.Errorf("failed to mark document as deleted: %w", err)
--- a/internal/services/hotkey_service.go
+++ b/internal/services/hotkey_service.go
@@ -26,15 +26,17 @@ import (
 type HotkeyService struct {
 	logger        *log.LogService
 	configService *ConfigService
+	windowService *WindowService
 	app           *application.App
+	mainWindow    *application.WebviewWindow

 	mu            sync.RWMutex
 	currentHotkey *models.HotkeyCombo
 	isRegistered  atomic.Bool

-	ctx    context.Context
-	cancel context.CancelFunc
-	wg     sync.WaitGroup
+	ctx        context.Context
+	cancelFunc atomic.Value // 使用atomic.Value存储cancel函数，避免竞态条件
+	wg         sync.WaitGroup
 }

 // HotkeyError 热键错误
@@ -51,24 +53,48 @@ func (e *HotkeyError) Unwrap() error {
 	return e.Err
 }

+// setCancelFunc 原子地设置cancel函数
+func (hs *HotkeyService) setCancelFunc(cancel context.CancelFunc) {
+	hs.cancelFunc.Store(cancel)
+}
+
+// getCancelFunc 原子地获取cancel函数
+func (hs *HotkeyService) getCancelFunc() context.CancelFunc {
+	if cancel := hs.cancelFunc.Load(); cancel != nil {
+		if cancelFunc, ok := cancel.(context.CancelFunc); ok {
+			return cancelFunc
+		}
+	}
+	return nil
+}
+
+// clearCancelFunc 原子地清除cancel函数
+func (hs *HotkeyService) clearCancelFunc() {
+	hs.cancelFunc.Store((context.CancelFunc)(nil))
+}
+
 // NewHotkeyService 创建热键服务实例
-func NewHotkeyService(configService *ConfigService, logger *log.LogService) *HotkeyService {
+func NewHotkeyService(configService *ConfigService, windowService *WindowService, logger *log.LogService) *HotkeyService {
 	if logger == nil {
 		logger = log.New()
 	}

 	ctx, cancel := context.WithCancel(context.Background())
-	return &HotkeyService{
+	service := &HotkeyService{
 		logger:        logger,
 		configService: configService,
+		windowService: windowService,
 		ctx:           ctx,
-		cancel:        cancel,
 	}
+	// 初始化时设置cancel函数
+	service.setCancelFunc(cancel)
+	return service
 }

 // Initialize 初始化热键服务
-func (hs *HotkeyService) Initialize(app *application.App) error {
+func (hs *HotkeyService) Initialize(app *application.App, mainWindow *application.WebviewWindow) error {
 	hs.app = app
+	hs.mainWindow = mainWindow

 	config, err := hs.configService.GetConfig()
 	if err != nil {
@@ -119,7 +145,7 @@ func (hs *HotkeyService) RegisterHotkey(hotkey *models.HotkeyCombo) error {

 	hs.currentHotkey = hotkey
 	hs.isRegistered.Store(true)
-	hs.cancel = cancel
+	hs.setCancelFunc(cancel)

 	return nil
 }
@@ -137,13 +163,15 @@ func (hs *HotkeyService) unregisterInternal() error {
 		return nil
 	}

-	if hs.cancel != nil {
-		hs.cancel()
+	// 原子地获取并调用cancel函数
+	if cancel := hs.getCancelFunc(); cancel != nil {
+		cancel()
 		hs.wg.Wait()
 	}

 	hs.currentHotkey = nil
 	hs.isRegistered.Store(false)
+	hs.clearCancelFunc()
 	return nil
 }

@@ -165,7 +193,7 @@ func (hs *HotkeyService) hotkeyListener(ctx context.Context, hotkey *models.Hotk
 		return
 	}

-	ticker := time.NewTicker(100 * time.Millisecond)
+	ticker := time.NewTicker(50 * time.Millisecond)
 	defer ticker.Stop()

 	var wasPressed bool
@@ -199,11 +227,61 @@ func cBool(b bool) C.int {
 	return 0
 }

-// toggleWindow 切换窗口
+// toggleWindow 切换窗口显示状态
 func (hs *HotkeyService) toggleWindow() {
-	if hs.app != nil {
-		hs.app.Event.Emit("hotkey:toggle-window", nil)
+	if hs.mainWindow == nil {
+		hs.logger.Error("main window not set")
+		return
 	}
+
+	// 检查主窗口是否可见
+	if hs.isWindowVisible(hs.mainWindow) {
+		// 如果主窗口可见，隐藏所有窗口
+		hs.hideAllWindows()
+	} else {
+		// 如果主窗口不可见，显示所有窗口
+		hs.showAllWindows()
+	}
+}
+
+// isWindowVisible 检查窗口是否可见
+func (hs *HotkeyService) isWindowVisible(window *application.WebviewWindow) bool {
+	return window.IsVisible()
+}
+
+// hideAllWindows 隐藏所有窗口
+func (hs *HotkeyService) hideAllWindows() {
+	// 隐藏主窗口
+	hs.mainWindow.Hide()
+
+	// 隐藏所有子窗口
+	if hs.windowService != nil {
+		openWindows := hs.windowService.GetOpenWindows()
+		for _, windowInfo := range openWindows {
+			windowInfo.Window.Hide()
+		}
+	}
+
+	hs.logger.Debug("all windows hidden")
+}
+
+// showAllWindows 显示所有窗口
+func (hs *HotkeyService) showAllWindows() {
+	// 显示主窗口
+	hs.mainWindow.Show()
+	hs.mainWindow.Restore()
+	hs.mainWindow.Focus()
+
+	// 显示所有子窗口
+	if hs.windowService != nil {
+		openWindows := hs.windowService.GetOpenWindows()
+		for _, windowInfo := range openWindows {
+			windowInfo.Window.Show()
+			windowInfo.Window.Restore()
+		}
+	}
+
+	hs.logger.Debug("all windows shown")
 }

 // keyToVirtualKeyCode 键名转虚拟键码
@@ -261,7 +339,10 @@ func (hs *HotkeyService) IsRegistered() bool {

 // ServiceShutdown 关闭服务
 func (hs *HotkeyService) ServiceShutdown() error {
-	hs.cancel()
+	// 原子地获取并调用cancel函数
+	if cancel := hs.getCancelFunc(); cancel != nil {
+		cancel()
+	}
 	hs.wg.Wait()
 	return nil
 }
--- a/internal/services/hotkey_service_darwin.go
+++ b/internal/services/hotkey_service_darwin.go
@@ -66,6 +66,7 @@ int isHotkeyRegistered() {
 import "C"

 import (
+	"context"
 	"fmt"
 	"sync"
 	"sync/atomic"
@@ -82,10 +83,13 @@ var globalHotkeyService *HotkeyService
 type HotkeyService struct {
 	logger        *log.LogService
 	configService *ConfigService
+	windowService *WindowService
 	app           *application.App
+	mainWindow    *application.WebviewWindow
 	mu            sync.RWMutex
 	isRegistered  atomic.Bool
 	currentHotkey *models.HotkeyCombo
+	cancelFunc    atomic.Value // 使用atomic.Value存储cancel函数，避免竞态条件
 }

 // HotkeyError 热键错误
@@ -104,8 +108,28 @@ func (e *HotkeyError) Unwrap() error {
 	return e.Err
 }

+// setCancelFunc 原子地设置cancel函数
+func (hs *HotkeyService) setCancelFunc(cancel context.CancelFunc) {
+	hs.cancelFunc.Store(cancel)
+}
+
+// getCancelFunc 原子地获取cancel函数
+func (hs *HotkeyService) getCancelFunc() context.CancelFunc {
+	if cancel := hs.cancelFunc.Load(); cancel != nil {
+		if cancelFunc, ok := cancel.(context.CancelFunc); ok {
+			return cancelFunc
+		}
+	}
+	return nil
+}
+
+// clearCancelFunc 原子地清除cancel函数
+func (hs *HotkeyService) clearCancelFunc() {
+	hs.cancelFunc.Store((context.CancelFunc)(nil))
+}
+
 // NewHotkeyService 创建新的热键服务实例
-func NewHotkeyService(configService *ConfigService, logger *log.LogService) *HotkeyService {
+func NewHotkeyService(configService *ConfigService, windowService *WindowService, logger *log.LogService) *HotkeyService {
 	if logger == nil {
 		logger = log.New()
 	}
@@ -113,6 +137,7 @@ func NewHotkeyService(configService *ConfigService, logger *log.LogService) *Hot
 	service := &HotkeyService{
 		logger:        logger,
 		configService: configService,
+		windowService: windowService,
 	}

 	// 设置全局实例
@@ -122,8 +147,9 @@ func NewHotkeyService(configService *ConfigService, logger *log.LogService) *Hot
 }

 // Initialize 初始化热键服务
-func (hs *HotkeyService) Initialize(app *application.App) error {
+func (hs *HotkeyService) Initialize(app *application.App, mainWindow *application.WebviewWindow) error {
 	hs.app = app
+	hs.mainWindow = mainWindow

 	// 加载并应用当前配置
 	config, err := hs.configService.GetConfig()
@@ -285,9 +311,59 @@ func (hs *HotkeyService) IsRegistered() bool {

 // ToggleWindow 切换窗口显示状态
 func (hs *HotkeyService) ToggleWindow() {
-	if hs.app != nil {
-		hs.app.EmitEvent("hotkey:toggle-window", nil)
+	if hs.mainWindow == nil {
+		hs.logger.Error("main window not set")
+		return
 	}
+
+	// 检查主窗口是否可见
+	if hs.isWindowVisible(hs.mainWindow) {
+		// 如果主窗口可见，隐藏所有窗口
+		hs.hideAllWindows()
+	} else {
+		// 如果主窗口不可见，显示所有窗口
+		hs.showAllWindows()
+	}
+}
+
+// isWindowVisible 检查窗口是否可见
+func (hs *HotkeyService) isWindowVisible(window *application.WebviewWindow) bool {
+	return window.IsVisible()
+}
+
+// hideAllWindows 隐藏所有窗口
+func (hs *HotkeyService) hideAllWindows() {
+	// 隐藏主窗口
+	hs.mainWindow.Hide()
+
+	// 隐藏所有子窗口
+	if hs.windowService != nil {
+		openWindows := hs.windowService.GetOpenWindows()
+		for _, windowInfo := range openWindows {
+			windowInfo.Window.Hide()
+		}
+	}
+
+	hs.logger.Debug("all windows hidden")
+}
+
+// showAllWindows 显示所有窗口
+func (hs *HotkeyService) showAllWindows() {
+	// 显示主窗口
+	hs.mainWindow.Show()
+	hs.mainWindow.Restore()
+	hs.mainWindow.Focus()
+
+	// 显示所有子窗口
+	if hs.windowService != nil {
+		openWindows := hs.windowService.GetOpenWindows()
+		for _, windowInfo := range openWindows {
+			windowInfo.Window.Show()
+			windowInfo.Window.Restore()
+		}
+	}
+
+	hs.logger.Debug("all windows shown")
 }

 // ServiceShutdown 关闭热键服务
--- a/internal/services/hotkey_service_linux.go
+++ b/internal/services/hotkey_service_linux.go
@@ -143,15 +143,17 @@ import (
 type HotkeyService struct {
 	logger        *log.LogService
 	configService *ConfigService
+	windowService *WindowService
 	app           *application.App
+	mainWindow    *application.WebviewWindow

 	mu            sync.RWMutex
 	currentHotkey *models.HotkeyCombo
 	isRegistered  atomic.Bool

-	ctx    context.Context
-	cancel context.CancelFunc
-	wg     sync.WaitGroup
+	ctx        context.Context
+	cancelFunc atomic.Value // 使用atomic.Value存储cancel函数，避免竞态条件
+	wg         sync.WaitGroup
 }

 // HotkeyError 热键错误
@@ -169,24 +171,48 @@ func (e *HotkeyError) Unwrap() error {
 	return e.Err
 }

+// setCancelFunc 原子地设置cancel函数
+func (hs *HotkeyService) setCancelFunc(cancel context.CancelFunc) {
+	hs.cancelFunc.Store(cancel)
+}
+
+// getCancelFunc 原子地获取cancel函数
+func (hs *HotkeyService) getCancelFunc() context.CancelFunc {
+	if cancel := hs.cancelFunc.Load(); cancel != nil {
+		if cancelFunc, ok := cancel.(context.CancelFunc); ok {
+			return cancelFunc
+		}
+	}
+	return nil
+}
+
+// clearCancelFunc 原子地清除cancel函数
+func (hs *HotkeyService) clearCancelFunc() {
+	hs.cancelFunc.Store((context.CancelFunc)(nil))
+}
+
 // NewHotkeyService 创建热键服务实例
-func NewHotkeyService(configService *ConfigService, logger *log.LogService) *HotkeyService {
+func NewHotkeyService(configService *ConfigService, windowService *WindowService, logger *log.LogService) *HotkeyService {
 	if logger == nil {
 		logger = log.New()
 	}

 	ctx, cancel := context.WithCancel(context.Background())
-	return &HotkeyService{
+	service := &HotkeyService{
 		logger:        logger,
 		configService: configService,
+		windowService: windowService,
 		ctx:           ctx,
-		cancel:        cancel,
 	}
+	// 初始化时设置cancel函数
+	service.setCancelFunc(cancel)
+	return service
 }

 // Initialize 初始化热键服务
-func (hs *HotkeyService) Initialize(app *application.App) error {
+func (hs *HotkeyService) Initialize(app *application.App, mainWindow *application.WebviewWindow) error {
 	hs.app = app
+	hs.mainWindow = mainWindow

 	if int(C.initX11Display()) == 0 {
 		return &HotkeyError{"init_x11", fmt.Errorf("failed to initialize X11 display")}
@@ -253,7 +279,7 @@ func (hs *HotkeyService) RegisterHotkey(hotkey *models.HotkeyCombo) error {

 	hs.currentHotkey = hotkey
 	hs.isRegistered.Store(true)
-	hs.cancel = cancel
+	hs.setCancelFunc(cancel)

 	return nil
 }
@@ -271,8 +297,9 @@ func (hs *HotkeyService) unregisterInternal() error {
 		return nil
 	}

-	if hs.cancel != nil {
-		hs.cancel()
+	// 原子地获取并调用cancel函数
+	if cancel := hs.getCancelFunc(); cancel != nil {
+		cancel()
 		hs.wg.Wait()
 	}

@@ -283,6 +310,7 @@ func (hs *HotkeyService) unregisterInternal() error {

 	hs.currentHotkey = nil
 	hs.isRegistered.Store(false)
+	hs.clearCancelFunc()
 	return nil
 }

@@ -298,7 +326,8 @@ func (hs *HotkeyService) UpdateHotkey(enable bool, hotkey *models.HotkeyCombo) e
 func (hs *HotkeyService) hotkeyListener(ctx context.Context, ready chan<- error) {
 	defer hs.wg.Done()

-	ticker := time.NewTicker(100 * time.Millisecond)
+	// 优化轮询频率从100ms改为50ms，提高响应性
+	ticker := time.NewTicker(50 * time.Millisecond)
 	defer ticker.Stop()

 	ready <- nil // 标记准备就绪
@@ -315,11 +344,61 @@ func (hs *HotkeyService) hotkeyListener(ctx context.Context, ready chan<- error)
 	}
 }

-// toggleWindow 切换窗口
+// toggleWindow 切换窗口显示状态
 func (hs *HotkeyService) toggleWindow() {
-	if hs.app != nil {
-		hs.app.EmitEvent("hotkey:toggle-window", nil)
+	if hs.mainWindow == nil {
+		hs.logger.Error("main window not set")
+		return
 	}
+
+	// 检查主窗口是否可见
+	if hs.isWindowVisible(hs.mainWindow) {
+		// 如果主窗口可见，隐藏所有窗口
+		hs.hideAllWindows()
+	} else {
+		// 如果主窗口不可见，显示所有窗口
+		hs.showAllWindows()
+	}
+}
+
+// isWindowVisible 检查窗口是否可见
+func (hs *HotkeyService) isWindowVisible(window *application.WebviewWindow) bool {
+	return window.IsVisible()
+}
+
+// hideAllWindows 隐藏所有窗口
+func (hs *HotkeyService) hideAllWindows() {
+	// 隐藏主窗口
+	hs.mainWindow.Hide()
+
+	// 隐藏所有子窗口
+	if hs.windowService != nil {
+		openWindows := hs.windowService.GetOpenWindows()
+		for _, windowInfo := range openWindows {
+			windowInfo.Window.Hide()
+		}
+	}
+
+	hs.logger.Debug("all windows hidden")
+}
+
+// showAllWindows 显示所有窗口
+func (hs *HotkeyService) showAllWindows() {
+	// 显示主窗口
+	hs.mainWindow.Show()
+	hs.mainWindow.Restore()
+	hs.mainWindow.Focus()
+
+	// 显示所有子窗口
+	if hs.windowService != nil {
+		openWindows := hs.windowService.GetOpenWindows()
+		for _, windowInfo := range openWindows {
+			windowInfo.Window.Show()
+			windowInfo.Window.Restore()
+		}
+	}
+
+	hs.logger.Debug("all windows shown")
 }

 // keyToX11KeyCode 键名转X11键码
@@ -386,7 +465,10 @@ func (hs *HotkeyService) IsRegistered() bool {

 // ServiceShutdown 关闭服务
 func (hs *HotkeyService) ServiceShutdown() error {
-	hs.cancel()
+	// 原子地获取并调用cancel函数
+	if cancel := hs.getCancelFunc(); cancel != nil {
+		cancel()
+	}
 	hs.wg.Wait()
 	C.closeX11Display()
 	return nil
--- a/internal/services/path_migration_service.go
+++ b/internal/services/path_migration_service.go
@@ -33,22 +33,24 @@ type MigrationProgress struct {

 // MigrationService 迁移服务
 type MigrationService struct {
-	logger   *log.LogService
-	mu       sync.RWMutex
-	progress atomic.Value // stores MigrationProgress
+	logger    *log.LogService
+	dbService *DatabaseService
+	mu        sync.RWMutex
+	progress  atomic.Value // stores MigrationProgress

 	ctx    context.Context
 	cancel context.CancelFunc
 }

 // NewMigrationService 创建迁移服务
-func NewMigrationService(logger *log.LogService) *MigrationService {
+func NewMigrationService(dbService *DatabaseService, logger *log.LogService) *MigrationService {
 	if logger == nil {
 		logger = log.New()
 	}

 	ms := &MigrationService{
-		logger: logger,
+		logger:    logger,
+		dbService: dbService,
 	}

 	// 初始化进度
@@ -104,6 +106,17 @@ func (ms *MigrationService) MigrateDirectory(srcPath, dstPath string) error {
 		return ms.failWithError(err)
 	}

+	// 迁移前断开数据库连接
+	ms.updateProgress(MigrationProgress{
+		Status:   MigrationStatusMigrating,
+		Progress: 10,
+	})
+
+	if ms.dbService != nil {
+		if err := ms.dbService.ServiceShutdown(); err != nil {
+			ms.logger.Error("Failed to close database connection", "error", err)
+		}
+	}
 	// 执行原子迁移
 	if err := ms.atomicMove(ctx, srcPath, dstPath); err != nil {
 		return ms.failWithError(err)
@@ -177,10 +190,17 @@ func (ms *MigrationService) atomicMove(ctx context.Context, srcPath, dstPath str
 	})

 	if err := os.Rename(srcPath, dstPath); err == nil {
+		// 重命名成功，更新进度到90%
+		ms.updateProgress(MigrationProgress{
+			Status:   MigrationStatusMigrating,
+			Progress: 90,
+		})
+		ms.logger.Info("Directory migration completed using direct rename", "src", srcPath, "dst", dstPath)
 		return nil
 	}

 	// 重命名失败，使用压缩迁移
+	ms.logger.Info("Direct rename failed, using compress migration", "src", srcPath, "dst", dstPath)
 	ms.updateProgress(MigrationProgress{
 		Status:   MigrationStatusMigrating,
 		Progress: 30,
@@ -249,12 +269,18 @@ func (ms *MigrationService) compressMove(ctx context.Context, srcPath, dstPath s
 	default:
 	}

+	// 验证迁移是否成功
+	if err := ms.verifyMigration(dstPath); err != nil {
+		// 迁移验证失败，清理目标目录
+		os.RemoveAll(dstPath)
+		return fmt.Errorf("migration verification failed: %v", err)
+	}
+
 	// 删除源目录
 	ms.updateProgress(MigrationProgress{
 		Status:   MigrationStatusMigrating,
 		Progress: 90,
 	})
-
 	os.RemoveAll(srcPath)
 	return nil
 }
@@ -404,6 +430,29 @@ func (ms *MigrationService) isSubDirectory(parent, target string) bool {
 	return len(target) > len(parent) && strings.HasPrefix(target, parent)
 }

+// verifyMigration 验证迁移是否成功
+func (ms *MigrationService) verifyMigration(dstPath string) error {
+	// 检查目标目录是否存在
+	dstStat, err := os.Stat(dstPath)
+	if err != nil {
+		return fmt.Errorf("target directory does not exist: %v", err)
+	}
+	if !dstStat.IsDir() {
+		return fmt.Errorf("target path is not a directory")
+	}
+
+	// 简单验证：检查目标目录是否非空
+	isEmpty, err := ms.isDirectoryEmpty(dstPath)
+	if err != nil {
+		return fmt.Errorf("failed to check target directory: %v", err)
+	}
+	if isEmpty {
+		return fmt.Errorf("target directory is empty after migration")
+	}
+
+	return nil
+}
+
 // CancelMigration 取消迁移
 func (ms *MigrationService) CancelMigration() error {
 	ms.mu.Lock()
--- a/internal/services/service_manager.go
+++ b/internal/services/service_manager.go
@@ -13,6 +13,7 @@ type ServiceManager struct {
 	databaseService    *DatabaseService
 	documentService    *DocumentService
 	windowService      *WindowService
+	windowSnapService  *WindowSnapService
 	migrationService   *MigrationService
 	systemService      *SystemService
 	hotkeyService      *HotkeyService
@@ -23,6 +24,7 @@ type ServiceManager struct {
 	startupService     *StartupService
 	selfUpdateService  *SelfUpdateService
 	translationService *TranslationService
+	themeService       *ThemeService
 	BackupService      *BackupService
 	logger             *log.LogService
 }
@@ -39,7 +41,7 @@ func NewServiceManager() *ServiceManager {
 	databaseService := NewDatabaseService(configService, logger)

 	// 初始化迁移服务
-	migrationService := NewMigrationService(logger)
+	migrationService := NewMigrationService(databaseService, logger)

 	// 初始化文档服务
 	documentService := NewDocumentService(databaseService, logger)
@@ -47,11 +49,17 @@ func NewServiceManager() *ServiceManager {
 	// 初始化窗口服务
 	windowService := NewWindowService(logger, documentService)

+	// 初始化窗口吸附服务
+	windowSnapService := NewWindowSnapService(logger, configService)
+
+	// 将吸附服务与窗口服务关联
+	windowService.SetWindowSnapService(windowSnapService)
+
 	// 初始化系统服务
 	systemService := NewSystemService(logger)

 	// 初始化热键服务
-	hotkeyService := NewHotkeyService(configService, logger)
+	hotkeyService := NewHotkeyService(configService, windowService, logger)

 	// 初始化对话服务
 	dialogService := NewDialogService(logger)
@@ -77,6 +85,9 @@ func NewServiceManager() *ServiceManager {
 	// 初始化翻译服务
 	translationService := NewTranslationService(logger)

+	// 初始化主题服务
+	themeService := NewThemeService(databaseService, logger)
+
 	// 初始化备份服务
 	backupService := NewBackupService(configService, databaseService, logger)

@@ -104,11 +115,20 @@ func NewServiceManager() *ServiceManager {
 		panic(err)
 	}

+	// 设置窗口吸附配置变更回调
+	err = configService.SetWindowSnapConfigChangeCallback(func(enabled bool, threshold int) error {
+		return windowSnapService.OnWindowSnapConfigChanged(enabled, threshold)
+	})
+	if err != nil {
+		panic(err)
+	}
+
 	return &ServiceManager{
 		configService:      configService,
 		databaseService:    databaseService,
 		documentService:    documentService,
 		windowService:      windowService,
+		windowSnapService:  windowSnapService,
 		migrationService:   migrationService,
 		systemService:      systemService,
 		hotkeyService:      hotkeyService,
@@ -119,6 +139,7 @@ func NewServiceManager() *ServiceManager {
 		startupService:     startupService,
 		selfUpdateService:  selfUpdateService,
 		translationService: translationService,
+		themeService:       themeService,
 		BackupService:      backupService,
 		logger:             logger,
 	}
@@ -131,6 +152,7 @@ func (sm *ServiceManager) GetServices() []application.Service {
 		application.NewService(sm.databaseService),
 		application.NewService(sm.documentService),
 		application.NewService(sm.windowService),
+		application.NewService(sm.windowSnapService),
 		application.NewService(sm.keyBindingService),
 		application.NewService(sm.extensionService),
 		application.NewService(sm.migrationService),
@@ -141,6 +163,7 @@ func (sm *ServiceManager) GetServices() []application.Service {
 		application.NewService(sm.startupService),
 		application.NewService(sm.selfUpdateService),
 		application.NewService(sm.translationService),
+		application.NewService(sm.themeService),
 		application.NewService(sm.BackupService),
 	}
 	return services
@@ -210,3 +233,13 @@ func (sm *ServiceManager) GetWindowService() *WindowService {
 func (sm *ServiceManager) GetDocumentService() *DocumentService {
 	return sm.documentService
 }
+
+// GetThemeService 获取主题服务实例
+func (sm *ServiceManager) GetThemeService() *ThemeService {
+	return sm.themeService
+}
+
+// GetWindowSnapService 获取窗口吸附服务实例
+func (sm *ServiceManager) GetWindowSnapService() *WindowSnapService {
+	return sm.windowSnapService
+}
--- a/internal/services/theme_service.go
+++ b/internal/services/theme_service.go
@@ -0,0 +1,275 @@
+package services
+
+import (
+	"context"
+	"database/sql"
+	"fmt"
+	"time"
+	"voidraft/internal/models"
+
+	"github.com/wailsapp/wails/v3/pkg/application"
+	"github.com/wailsapp/wails/v3/pkg/services/log"
+)
+
+// ThemeService 主题服务
+type ThemeService struct {
+	databaseService *DatabaseService
+	logger          *log.LogService
+	ctx             context.Context
+}
+
+// NewThemeService 创建新的主题服务
+func NewThemeService(databaseService *DatabaseService, logger *log.LogService) *ThemeService {
+	if logger == nil {
+		logger = log.New()
+	}
+
+	return &ThemeService{
+		databaseService: databaseService,
+		logger:          logger,
+	}
+}
+
+// ServiceStartup 服务启动时初始化
+func (ts *ThemeService) ServiceStartup(ctx context.Context, options application.ServiceOptions) error {
+	ts.ctx = ctx
+
+	// 初始化默认主题
+	return ts.initializeDefaultThemes()
+}
+
+// getDB 获取数据库连接
+func (ts *ThemeService) getDB() *sql.DB {
+	return ts.databaseService.db
+}
+
+// initializeDefaultThemes 初始化默认主题
+func (ts *ThemeService) initializeDefaultThemes() error {
+	db := ts.getDB()
+	if db == nil {
+		return fmt.Errorf("database not available")
+	}
+
+	// 检查是否已存在默认主题
+	var count int
+	err := db.QueryRow("SELECT COUNT(*) FROM themes WHERE is_default = 1").Scan(&count)
+	if err != nil {
+		return fmt.Errorf("failed to check existing themes: %w", err)
+	}
+
+	if count > 0 {
+		return nil // 默认主题已存在
+	}
+
+	// 创建默认深色主题
+	darkTheme := &models.Theme{
+		Name:      "Default Dark",
+		Type:      models.ThemeTypeDark,
+		Colors:    *models.NewDefaultDarkTheme(),
+		IsDefault: true,
+		CreatedAt: time.Now(),
+		UpdatedAt: time.Now(),
+	}
+
+	// 创建默认浅色主题
+	lightTheme := &models.Theme{
+		Name:      "Default Light",
+		Type:      models.ThemeTypeLight,
+		Colors:    *models.NewDefaultLightTheme(),
+		IsDefault: true,
+		CreatedAt: time.Now(),
+		UpdatedAt: time.Now(),
+	}
+
+	// 插入默认主题
+	if _, err := ts.CreateTheme(darkTheme); err != nil {
+		return fmt.Errorf("failed to create default dark theme: %w", err)
+	}
+
+	if _, err := ts.CreateTheme(lightTheme); err != nil {
+		return fmt.Errorf("failed to create default light theme: %w", err)
+	}
+
+	return nil
+}
+
+// GetDefaultThemes 获取默认主题
+func (ts *ThemeService) GetDefaultThemes() (map[models.ThemeType]*models.Theme, error) {
+	query := `
+		SELECT id, name, type, colors, is_default, created_at, updated_at 
+		FROM themes 
+		WHERE is_default = 1
+		ORDER BY type
+	`
+
+	db := ts.getDB()
+	rows, err := db.Query(query)
+	if err != nil {
+		return nil, fmt.Errorf("failed to query default themes: %w", err)
+	}
+	defer rows.Close()
+
+	themes := make(map[models.ThemeType]*models.Theme)
+	for rows.Next() {
+		theme := &models.Theme{}
+		err := rows.Scan(
+			&theme.ID,
+			&theme.Name,
+			&theme.Type,
+			&theme.Colors,
+			&theme.IsDefault,
+			&theme.CreatedAt,
+			&theme.UpdatedAt,
+		)
+		if err != nil {
+			return nil, fmt.Errorf("failed to scan theme: %w", err)
+		}
+		themes[theme.Type] = theme
+	}
+
+	if err := rows.Err(); err != nil {
+		return nil, fmt.Errorf("failed to iterate themes: %w", err)
+	}
+
+	return themes, nil
+}
+
+// GetThemeByType 根据类型获取默认主题
+func (ts *ThemeService) GetThemeByType(themeType models.ThemeType) (*models.Theme, error) {
+	query := `
+		SELECT id, name, type, colors, is_default, created_at, updated_at 
+		FROM themes 
+		WHERE type = ? AND is_default = 1
+		LIMIT 1
+	`
+
+	theme := &models.Theme{}
+	db := ts.getDB()
+	err := db.QueryRow(query, themeType).Scan(
+		&theme.ID,
+		&theme.Name,
+		&theme.Type,
+		&theme.Colors,
+		&theme.IsDefault,
+		&theme.CreatedAt,
+		&theme.UpdatedAt,
+	)
+
+	if err != nil {
+		if err == sql.ErrNoRows {
+			return nil, fmt.Errorf("no default theme found for type: %s", themeType)
+		}
+		return nil, fmt.Errorf("failed to get theme by type: %w", err)
+	}
+
+	return theme, nil
+}
+
+// UpdateThemeColors 更新主题颜色
+func (ts *ThemeService) UpdateThemeColors(themeType models.ThemeType, colors models.ThemeColorConfig) error {
+	query := `
+		UPDATE themes 
+		SET colors = ?, updated_at = ?
+		WHERE type = ? AND is_default = 1
+	`
+
+	db := ts.getDB()
+	_, err := db.Exec(query, colors, time.Now(), themeType)
+	if err != nil {
+		return fmt.Errorf("failed to update theme colors: %w", err)
+	}
+
+	return nil
+}
+
+// ResetThemeColors 重置主题颜色为默认值
+func (ts *ThemeService) ResetThemeColors(themeType models.ThemeType) error {
+	var defaultColors models.ThemeColorConfig
+
+	switch themeType {
+	case models.ThemeTypeDark:
+		defaultColors = *models.NewDefaultDarkTheme()
+	case models.ThemeTypeLight:
+		defaultColors = *models.NewDefaultLightTheme()
+	default:
+		return fmt.Errorf("unknown theme type: %s", themeType)
+	}
+
+	return ts.UpdateThemeColors(themeType, defaultColors)
+}
+
+// CreateTheme 创建新主题
+func (ts *ThemeService) CreateTheme(theme *models.Theme) (*models.Theme, error) {
+	query := `
+		INSERT INTO themes (name, type, colors, is_default, created_at, updated_at)
+		VALUES (?, ?, ?, ?, ?, ?)
+	`
+
+	db := ts.getDB()
+	result, err := db.Exec(
+		query,
+		theme.Name,
+		theme.Type,
+		theme.Colors,
+		theme.IsDefault,
+		theme.CreatedAt,
+		theme.UpdatedAt,
+	)
+
+	if err != nil {
+		return nil, fmt.Errorf("failed to create theme: %w", err)
+	}
+
+	id, err := result.LastInsertId()
+	if err != nil {
+		return nil, fmt.Errorf("failed to get theme ID: %w", err)
+	}
+
+	theme.ID = int(id)
+	return theme, nil
+}
+
+// GetAllThemes 获取所有主题
+func (ts *ThemeService) GetAllThemes() ([]*models.Theme, error) {
+	query := `
+		SELECT id, name, type, colors, is_default, created_at, updated_at 
+		FROM themes 
+		ORDER BY is_default DESC, created_at ASC
+	`
+
+	db := ts.getDB()
+	rows, err := db.Query(query)
+	if err != nil {
+		return nil, fmt.Errorf("failed to query themes: %w", err)
+	}
+	defer rows.Close()
+
+	var themes []*models.Theme
+	for rows.Next() {
+		theme := &models.Theme{}
+		err := rows.Scan(
+			&theme.ID,
+			&theme.Name,
+			&theme.Type,
+			&theme.Colors,
+			&theme.IsDefault,
+			&theme.CreatedAt,
+			&theme.UpdatedAt,
+		)
+		if err != nil {
+			return nil, fmt.Errorf("failed to scan theme: %w", err)
+		}
+		themes = append(themes, theme)
+	}
+
+	if err := rows.Err(); err != nil {
+		return nil, fmt.Errorf("failed to iterate themes: %w", err)
+	}
+
+	return themes, nil
+}
+
+// ServiceShutdown 服务关闭
+func (ts *ThemeService) ServiceShutdown() error {
+	return nil
+}
--- a/internal/services/window_service.go
+++ b/internal/services/window_service.go
@@ -9,14 +9,14 @@ import (
 	"github.com/wailsapp/wails/v3/pkg/services/log"
 )

-// WindowInfo 窗口信息
+// WindowInfo 窗口信息（简化版）
 type WindowInfo struct {
 	Window     *application.WebviewWindow
 	DocumentID int64
 	Title      string
 }

-// WindowService 窗口管理服务
+// WindowService 窗口管理服务（专注于窗口生命周期管理）
 type WindowService struct {
 	logger          *log.LogService
 	documentService *DocumentService
@@ -24,6 +24,9 @@ type WindowService struct {
 	mainWindow      *application.WebviewWindow
 	windows         map[int64]*WindowInfo // documentID -> WindowInfo
 	mu              sync.RWMutex
+
+	// 吸附服务引用
+	windowSnapService *WindowSnapService
 }

 // NewWindowService 创建新的窗口服务实例
@@ -39,10 +42,20 @@ func NewWindowService(logger *log.LogService, documentService *DocumentService)
 	}
 }

+// SetWindowSnapService 设置窗口吸附服务引用
+func (ws *WindowService) SetWindowSnapService(snapService *WindowSnapService) {
+	ws.windowSnapService = snapService
+}
+
 // SetAppReferences 设置应用和主窗口引用
 func (ws *WindowService) SetAppReferences(app *application.App, mainWindow *application.WebviewWindow) {
 	ws.app = app
 	ws.mainWindow = mainWindow
+
+	// 如果吸附服务已设置，也为它设置引用
+	if ws.windowSnapService != nil {
+		ws.windowSnapService.SetAppReferences(app, mainWindow)
+	}
 }

 // OpenDocumentWindow 为指定文档ID打开新窗口
@@ -101,9 +114,14 @@ func (ws *WindowService) OpenDocumentWindow(documentID int64) error {
 	}
 	ws.windows[documentID] = windowInfo

-	// 注册窗口关闭事件
+	// 注册窗口事件
 	ws.registerWindowEvents(newWindow, documentID)

+	// 向吸附服务注册新窗口
+	if ws.windowSnapService != nil {
+		ws.windowSnapService.RegisterWindow(documentID, newWindow, doc.Title)
+	}
+
 	return nil
 }

@@ -119,12 +137,17 @@ func (ws *WindowService) registerWindowEvents(window *application.WebviewWindow,
 func (ws *WindowService) onWindowClosing(documentID int64) {
 	ws.mu.Lock()
 	defer ws.mu.Unlock()
+
 	windowInfo, exists := ws.windows[documentID]
 	if exists {
 		windowInfo.Window.Close()
 		delete(ws.windows, documentID)
-	}

+		// 从吸附服务中取消注册
+		if ws.windowSnapService != nil {
+			ws.windowSnapService.UnregisterWindow(documentID)
+		}
+	}
 }

 // GetOpenWindows 获取所有打开的窗口信息
@@ -147,3 +170,18 @@ func (ws *WindowService) IsDocumentWindowOpen(documentID int64) bool {
 	_, exists := ws.windows[documentID]
 	return exists
 }
+
+// ServiceShutdown 实现服务关闭接口
+func (ws *WindowService) ServiceShutdown() error {
+	// 关闭所有窗口
+	ws.mu.Lock()
+	defer ws.mu.Unlock()
+
+	for documentID := range ws.windows {
+		if ws.windowSnapService != nil {
+			ws.windowSnapService.UnregisterWindow(documentID)
+		}
+	}
+
+	return nil
+}
--- a/internal/services/window_snap_service.go
+++ b/internal/services/window_snap_service.go
@@ -0,0 +1,603 @@
+package services
+
+import (
+	"context"
+	"math"
+	"sync"
+	"time"
+	"voidraft/internal/models"
+
+	"github.com/wailsapp/wails/v3/pkg/application"
+	"github.com/wailsapp/wails/v3/pkg/services/log"
+)
+
+// WindowSnapService 窗口吸附服务
+type WindowSnapService struct {
+	logger        *log.LogService
+	configService *ConfigService
+	app           *application.App
+	mainWindow    *application.WebviewWindow
+	mu            sync.RWMutex
+
+	// 吸附配置
+	snapThreshold int  // 吸附触发的阈值距离(像素)
+	snapEnabled   bool // 是否启用窗口吸附功能
+
+	// 定时器控制
+	snapTicker *time.Ticker
+	ctx        context.Context
+	cancel     context.CancelFunc
+
+	// 性能优化相关
+	lastMainWindowPos models.WindowPosition // 缓存主窗口上次位置
+	changedWindows    map[int64]bool        // 记录哪些窗口发生了变化
+	skipFrames        int                   // 跳帧计数器，用于降低检测频率
+
+	// 监听的窗口列表
+	managedWindows map[int64]*SnapWindowInfo // documentID -> SnapWindowInfo
+}
+
+// SnapWindowInfo 吸附窗口信息
+type SnapWindowInfo struct {
+	Window     *application.WebviewWindow
+	DocumentID int64
+	Title      string
+	IsSnapped  bool                  // 是否处于吸附状态
+	SnapOffset models.SnapPosition   // 与主窗口的相对位置偏移
+	SnapEdge   models.SnapEdge       // 吸附的边缘类型
+	LastPos    models.WindowPosition // 上一次记录的窗口位置
+	MoveTime   time.Time             // 上次移动时间，用于判断移动速度
+}
+
+// NewWindowSnapService 创建新的窗口吸附服务实例
+func NewWindowSnapService(logger *log.LogService, configService *ConfigService) *WindowSnapService {
+	if logger == nil {
+		logger = log.New()
+	}
+
+	// 从配置获取窗口吸附设置
+	config, err := configService.GetConfig()
+	snapEnabled := true // 默认启用
+	snapThreshold := 15 // 默认阈值
+
+	if err == nil {
+		snapEnabled = config.General.EnableWindowSnap
+		snapThreshold = config.General.SnapThreshold
+	}
+
+	return &WindowSnapService{
+		logger:         logger,
+		configService:  configService,
+		snapThreshold:  snapThreshold,
+		snapEnabled:    snapEnabled,
+		managedWindows: make(map[int64]*SnapWindowInfo),
+		changedWindows: make(map[int64]bool),
+		skipFrames:     0,
+	}
+}
+
+// SetAppReferences 设置应用和主窗口引用
+func (wss *WindowSnapService) SetAppReferences(app *application.App, mainWindow *application.WebviewWindow) {
+	wss.app = app
+	wss.mainWindow = mainWindow
+
+	// 初始化上下文，用于控制goroutine的生命周期
+	wss.ctx, wss.cancel = context.WithCancel(context.Background())
+
+	// 启动窗口吸附监听器
+	wss.StartWindowSnapMonitor()
+}
+
+// RegisterWindow 注册需要吸附管理的窗口
+func (wss *WindowSnapService) RegisterWindow(documentID int64, window *application.WebviewWindow, title string) {
+	wss.mu.Lock()
+	defer wss.mu.Unlock()
+
+	wss.managedWindows[documentID] = &SnapWindowInfo{
+		Window:     window,
+		DocumentID: documentID,
+		Title:      title,
+		IsSnapped:  false,
+		SnapOffset: models.SnapPosition{X: 0, Y: 0},
+		SnapEdge:   models.SnapEdgeNone,
+		LastPos:    models.WindowPosition{X: 0, Y: 0},
+		MoveTime:   time.Now(),
+	}
+}
+
+// UnregisterWindow 取消注册窗口
+func (wss *WindowSnapService) UnregisterWindow(documentID int64) {
+	wss.mu.Lock()
+	defer wss.mu.Unlock()
+
+	delete(wss.managedWindows, documentID)
+	delete(wss.changedWindows, documentID)
+}
+
+// SetSnapEnabled 设置是否启用窗口吸附
+func (wss *WindowSnapService) SetSnapEnabled(enabled bool) {
+	wss.mu.Lock()
+	defer wss.mu.Unlock()
+
+	if wss.snapEnabled == enabled {
+		return
+	}
+
+	wss.snapEnabled = enabled
+
+	// 如果禁用吸附，解除所有吸附窗口
+	if !enabled {
+		for _, windowInfo := range wss.managedWindows {
+			if windowInfo.IsSnapped {
+				windowInfo.IsSnapped = false
+				windowInfo.SnapEdge = models.SnapEdgeNone
+			}
+		}
+		// 停止定时器
+		if wss.snapTicker != nil {
+			wss.snapTicker.Stop()
+			wss.snapTicker = nil
+		}
+	} else if wss.snapTicker == nil && wss.app != nil {
+		// 重新启动定时器
+		wss.StartWindowSnapMonitor()
+	}
+}
+
+// SetSnapThreshold 设置窗口吸附阈值
+func (wss *WindowSnapService) SetSnapThreshold(threshold int) {
+	wss.mu.Lock()
+	defer wss.mu.Unlock()
+
+	if threshold <= 0 || wss.snapThreshold == threshold {
+		return
+	}
+
+	wss.snapThreshold = threshold
+}
+
+// OnWindowSnapConfigChanged 处理窗口吸附配置变更
+func (wss *WindowSnapService) OnWindowSnapConfigChanged(enabled bool, threshold int) error {
+	wss.SetSnapEnabled(enabled)
+	wss.SetSnapThreshold(threshold)
+	return nil
+}
+
+// StartWindowSnapMonitor 启动窗口吸附监听器
+func (wss *WindowSnapService) StartWindowSnapMonitor() {
+	// 如果定时器已存在，先停止它
+	if wss.snapTicker != nil {
+		wss.snapTicker.Stop()
+	}
+
+	// 只有在吸附功能启用时才启动监听器
+	if !wss.snapEnabled {
+		return
+	}
+
+	// 创建新的定时器，20fps 以优化性能
+	wss.snapTicker = time.NewTicker(50 * time.Millisecond)
+
+	// 启动goroutine持续监听窗口位置
+	go func() {
+		for {
+			select {
+			case <-wss.snapTicker.C:
+				wss.checkAndApplySnapping()
+			case <-wss.ctx.Done():
+				// 上下文取消时停止goroutine
+				return
+			}
+		}
+	}()
+}
+
+// checkAndApplySnapping 检测并应用窗口吸附（性能优化版本）
+func (wss *WindowSnapService) checkAndApplySnapping() {
+	if !wss.snapEnabled {
+		return
+	}
+
+	// 性能优化：每3帧执行一次完整检测，其他时间只处理变化的窗口
+	wss.skipFrames++
+	fullCheck := wss.skipFrames%3 == 0
+
+	wss.mu.Lock()
+	defer wss.mu.Unlock()
+
+	// 检查主窗口是否存在且可见
+	if wss.mainWindow == nil || !wss.isMainWindowAvailable() {
+		// 主窗口不可用，解除所有吸附
+		for _, windowInfo := range wss.managedWindows {
+			if windowInfo.IsSnapped {
+				windowInfo.IsSnapped = false
+				windowInfo.SnapEdge = models.SnapEdgeNone
+			}
+		}
+		// 清空变化记录
+		wss.changedWindows = make(map[int64]bool)
+		return
+	}
+
+	mainPos, _ := wss.getWindowPosition(wss.mainWindow)
+
+	// 检查主窗口是否移动了
+	mainWindowMoved := mainPos.X != wss.lastMainWindowPos.X || mainPos.Y != wss.lastMainWindowPos.Y
+	if mainWindowMoved {
+		wss.lastMainWindowPos = mainPos
+		// 主窗口移动了，标记所有吸附的窗口为变化
+		for documentID, windowInfo := range wss.managedWindows {
+			if windowInfo.IsSnapped {
+				wss.changedWindows[documentID] = true
+			}
+		}
+	}
+
+	for documentID, windowInfo := range wss.managedWindows {
+		currentPos, _ := wss.getWindowPosition(windowInfo.Window)
+
+		// 检查窗口是否移动了
+		hasMoved := currentPos.X != windowInfo.LastPos.X || currentPos.Y != windowInfo.LastPos.Y
+		if hasMoved {
+			windowInfo.MoveTime = time.Now()
+			windowInfo.LastPos = currentPos
+			wss.changedWindows[documentID] = true
+		}
+
+		// 性能优化：只处理变化的窗口或进行完整检查时
+		if !fullCheck && !wss.changedWindows[documentID] {
+			continue
+		}
+
+		if windowInfo.IsSnapped {
+			// 窗口已吸附，检查是否需要更新位置或解除吸附
+			wss.handleSnappedWindow(windowInfo, mainPos, currentPos)
+		} else {
+			// 窗口未吸附，检查是否应该吸附
+			wss.handleUnsnappedWindow(windowInfo)
+		}
+
+		// 处理完成后清除变化标记
+		delete(wss.changedWindows, documentID)
+	}
+}
+
+// isMainWindowAvailable 检查主窗口是否可用
+func (wss *WindowSnapService) isMainWindowAvailable() bool {
+	if wss.mainWindow == nil {
+		return false
+	}
+
+	// 检查主窗口是否可见和正常状态
+	return wss.mainWindow.IsVisible()
+}
+
+// handleSnappedWindow 处理已吸附的窗口
+func (wss *WindowSnapService) handleSnappedWindow(windowInfo *SnapWindowInfo, mainPos models.WindowPosition, currentPos models.WindowPosition) {
+	// 计算预期位置基于主窗口的新位置
+	expectedX := mainPos.X + windowInfo.SnapOffset.X
+	expectedY := mainPos.Y + windowInfo.SnapOffset.Y
+
+	// 计算当前位置与预期位置的距离
+	distanceX := math.Abs(float64(currentPos.X - expectedX))
+	distanceY := math.Abs(float64(currentPos.Y - expectedY))
+	maxDistance := math.Max(distanceX, distanceY)
+
+	// 检测是否为用户主动拖拽：如果窗口移动幅度超过阈值且是最近移动的
+	userDragThreshold := float64(wss.snapThreshold)
+	isUserDrag := maxDistance > userDragThreshold && time.Since(windowInfo.MoveTime) < 100*time.Millisecond
+
+	if isUserDrag {
+		// 用户主动拖拽，立即解除吸附
+		windowInfo.IsSnapped = false
+		windowInfo.SnapEdge = models.SnapEdgeNone
+		return
+	}
+
+	// 对于主窗口移动导致的位置变化，立即跟随且不解除吸附
+	if maxDistance > 0 {
+		// 直接调整到预期位置，不使用平滑移动以提高响应速度
+		windowInfo.Window.SetPosition(expectedX, expectedY)
+		windowInfo.LastPos = models.WindowPosition{X: expectedX, Y: expectedY}
+	}
+}
+
+// handleUnsnappedWindow 处理未吸附的窗口
+func (wss *WindowSnapService) handleUnsnappedWindow(windowInfo *SnapWindowInfo) {
+	// 检查是否应该吸附到主窗口
+	should, snapEdge := wss.shouldSnapToMainWindow(windowInfo)
+	if should {
+		// 获取主窗口位置用于计算偏移量
+		mainPos, _ := wss.getWindowPosition(wss.mainWindow)
+
+		// 设置吸附状态
+		windowInfo.IsSnapped = true
+		windowInfo.SnapEdge = snapEdge
+
+		// 执行即时吸附，产生明显的吸附效果
+		wss.snapWindowToMainWindow(windowInfo, snapEdge)
+
+		// 重新获取吸附后的位置来计算偏移量
+		newPos, _ := wss.getWindowPosition(windowInfo.Window)
+		windowInfo.SnapOffset.X = newPos.X - mainPos.X
+		windowInfo.SnapOffset.Y = newPos.Y - mainPos.Y
+		windowInfo.LastPos = newPos
+	}
+}
+
+// getWindowPosition 获取窗口的位置
+func (wss *WindowSnapService) getWindowPosition(window *application.WebviewWindow) (models.WindowPosition, bool) {
+	x, y := window.Position()
+	return models.WindowPosition{X: x, Y: y}, true
+}
+
+// shouldSnapToMainWindow 检查窗口是否应该吸附到主窗口（支持角落吸附）
+func (wss *WindowSnapService) shouldSnapToMainWindow(windowInfo *SnapWindowInfo) (bool, models.SnapEdge) {
+	// 降低防抖时间，提高吸附响应速度
+	if time.Since(windowInfo.MoveTime) < 50*time.Millisecond {
+		return false, models.SnapEdgeNone
+	}
+
+	// 获取两个窗口的位置
+	mainPos, _ := wss.getWindowPosition(wss.mainWindow)
+	windowPos, _ := wss.getWindowPosition(windowInfo.Window)
+
+	// 获取主窗口尺寸
+	mainWidth, mainHeight := wss.mainWindow.Size()
+
+	// 获取子窗口尺寸
+	windowWidth, windowHeight := windowInfo.Window.Size()
+
+	// 计算各个边缘的距离
+	threshold := float64(wss.snapThreshold)
+	cornerThreshold := threshold * 1.5 // 角落吸附需要更大的阈值
+
+	// 主窗口的四个边界
+	mainLeft := mainPos.X
+	mainTop := mainPos.Y
+	mainRight := mainPos.X + mainWidth
+	mainBottom := mainPos.Y + mainHeight
+
+	// 子窗口的四个边界
+	windowLeft := windowPos.X
+	windowTop := windowPos.Y
+	windowRight := windowPos.X + windowWidth
+	windowBottom := windowPos.Y + windowHeight
+
+	// 存储每个边缘的吸附信息
+	type snapCandidate struct {
+		edge     models.SnapEdge
+		distance float64
+		overlap  float64 // 重叠度，用于优先级判断
+		isCorner bool    // 是否为角落吸附
+	}
+
+	var candidates []snapCandidate
+
+	// ==== 检查角落吸附（优先级最高） ====
+
+	// 1. 右上角 (SnapEdgeTopRight)
+	distToTopRight := math.Sqrt(math.Pow(float64(mainRight-windowLeft), 2) + math.Pow(float64(mainTop-windowBottom), 2))
+	if distToTopRight <= cornerThreshold {
+		// 检查是否接近右上角区域
+		horizDist := math.Abs(float64(mainRight - windowLeft))
+		vertDist := math.Abs(float64(mainTop - windowBottom))
+		if horizDist <= cornerThreshold && vertDist <= cornerThreshold {
+			candidates = append(candidates, snapCandidate{models.SnapEdgeTopRight, distToTopRight, 100, true})
+		}
+	}
+
+	// 2. 右下角 (SnapEdgeBottomRight)
+	distToBottomRight := math.Sqrt(math.Pow(float64(mainRight-windowLeft), 2) + math.Pow(float64(mainBottom-windowTop), 2))
+	if distToBottomRight <= cornerThreshold {
+		horizDist := math.Abs(float64(mainRight - windowLeft))
+		vertDist := math.Abs(float64(mainBottom - windowTop))
+		if horizDist <= cornerThreshold && vertDist <= cornerThreshold {
+			candidates = append(candidates, snapCandidate{models.SnapEdgeBottomRight, distToBottomRight, 100, true})
+		}
+	}
+
+	// 3. 左下角 (SnapEdgeBottomLeft)
+	distToBottomLeft := math.Sqrt(math.Pow(float64(mainLeft-windowRight), 2) + math.Pow(float64(mainBottom-windowTop), 2))
+	if distToBottomLeft <= cornerThreshold {
+		horizDist := math.Abs(float64(mainLeft - windowRight))
+		vertDist := math.Abs(float64(mainBottom - windowTop))
+		if horizDist <= cornerThreshold && vertDist <= cornerThreshold {
+			candidates = append(candidates, snapCandidate{models.SnapEdgeBottomLeft, distToBottomLeft, 100, true})
+		}
+	}
+
+	// 4. 左上角 (SnapEdgeTopLeft)
+	distToTopLeft := math.Sqrt(math.Pow(float64(mainLeft-windowRight), 2) + math.Pow(float64(mainTop-windowBottom), 2))
+	if distToTopLeft <= cornerThreshold {
+		horizDist := math.Abs(float64(mainLeft - windowRight))
+		vertDist := math.Abs(float64(mainTop - windowBottom))
+		if horizDist <= cornerThreshold && vertDist <= cornerThreshold {
+			candidates = append(candidates, snapCandidate{models.SnapEdgeTopLeft, distToTopLeft, 100, true})
+		}
+	}
+
+	// ==== 检查边缘吸附（只在没有角落吸附时检查） ====
+	if len(candidates) == 0 {
+		// 1. 吸附到主窗口右侧
+		distToRight := math.Abs(float64(mainRight - windowLeft))
+		if distToRight <= threshold {
+			// 计算垂直重叠
+			overlapTop := math.Max(float64(mainTop), float64(windowTop))
+			overlapBottom := math.Min(float64(mainBottom), float64(windowBottom))
+			verticalOverlap := math.Max(0, overlapBottom-overlapTop)
+			candidates = append(candidates, snapCandidate{models.SnapEdgeRight, distToRight, verticalOverlap, false})
+		}
+
+		// 2. 吸附到主窗口左侧
+		distToLeft := math.Abs(float64(mainLeft - windowRight))
+		if distToLeft <= threshold {
+			// 计算垂直重叠
+			overlapTop := math.Max(float64(mainTop), float64(windowTop))
+			overlapBottom := math.Min(float64(mainBottom), float64(windowBottom))
+			verticalOverlap := math.Max(0, overlapBottom-overlapTop)
+			candidates = append(candidates, snapCandidate{models.SnapEdgeLeft, distToLeft, verticalOverlap, false})
+		}
+
+		// 3. 吸附到主窗口底部
+		distToBottom := math.Abs(float64(mainBottom - windowTop))
+		if distToBottom <= threshold {
+			// 计算水平重叠
+			overlapLeft := math.Max(float64(mainLeft), float64(windowLeft))
+			overlapRight := math.Min(float64(mainRight), float64(windowRight))
+			horizontalOverlap := math.Max(0, overlapRight-overlapLeft)
+			candidates = append(candidates, snapCandidate{models.SnapEdgeBottom, distToBottom, horizontalOverlap, false})
+		}
+
+		// 4. 吸附到主窗口顶部
+		distToTop := math.Abs(float64(mainTop - windowBottom))
+		if distToTop <= threshold {
+			// 计算水平重叠
+			overlapLeft := math.Max(float64(mainLeft), float64(windowLeft))
+			overlapRight := math.Min(float64(mainRight), float64(windowRight))
+			horizontalOverlap := math.Max(0, overlapRight-overlapLeft)
+			candidates = append(candidates, snapCandidate{models.SnapEdgeTop, distToTop, horizontalOverlap, false})
+		}
+	}
+
+	// 如果没有候选，不吸附
+	if len(candidates) == 0 {
+		return false, models.SnapEdgeNone
+	}
+
+	// 选择最佳吸附位置：角落吸附优先，其次考虑重叠度，最后考虑距离
+	bestCandidate := candidates[0]
+	for _, candidate := range candidates[1:] {
+		// 角落吸附优先级最高
+		if candidate.isCorner && !bestCandidate.isCorner {
+			bestCandidate = candidate
+		} else if bestCandidate.isCorner && !candidate.isCorner {
+			// 继续使用当前的角落吸附
+			continue
+		} else {
+			// 同类型的吸附，比较重叠度和距离
+			if math.Abs(candidate.overlap-bestCandidate.overlap) < 10 {
+				if candidate.distance < bestCandidate.distance {
+					bestCandidate = candidate
+				}
+			} else if candidate.overlap > bestCandidate.overlap {
+				// 重叠度更高的优先
+				bestCandidate = candidate
+			}
+		}
+	}
+
+	return true, bestCandidate.edge
+}
+
+// snapWindowToMainWindow 将窗口精确吸附到主窗口边缘（支持角落吸附）
+func (wss *WindowSnapService) snapWindowToMainWindow(windowInfo *SnapWindowInfo, snapEdge models.SnapEdge) {
+	// 获取主窗口位置和尺寸
+	mainPos, _ := wss.getWindowPosition(wss.mainWindow)
+	mainWidth, mainHeight := wss.mainWindow.Size()
+
+	// 获取子窗口位置和尺寸
+	windowPos, _ := wss.getWindowPosition(windowInfo.Window)
+	windowWidth, windowHeight := windowInfo.Window.Size()
+
+	// 计算目标位置
+	var targetX, targetY int
+
+	switch snapEdge {
+	case models.SnapEdgeRight:
+		// 吸附到主窗口右侧
+		targetX = mainPos.X + mainWidth
+		targetY = windowPos.Y // 保持当前 Y 位置
+		// 如果超出主窗口范围，调整到边界
+		if targetY < mainPos.Y {
+			targetY = mainPos.Y
+		} else if targetY+windowHeight > mainPos.Y+mainHeight {
+			targetY = mainPos.Y + mainHeight - windowHeight
+		}
+
+	case models.SnapEdgeLeft:
+		// 吸附到主窗口左侧
+		targetX = mainPos.X - windowWidth
+		targetY = windowPos.Y // 保持当前 Y 位置
+		// 如果超出主窗口范围，调整到边界
+		if targetY < mainPos.Y {
+			targetY = mainPos.Y
+		} else if targetY+windowHeight > mainPos.Y+mainHeight {
+			targetY = mainPos.Y + mainHeight - windowHeight
+		}
+
+	case models.SnapEdgeBottom:
+		// 吸附到主窗口底部
+		targetX = windowPos.X // 保持当前 X 位置
+		targetY = mainPos.Y + mainHeight
+		// 如果超出主窗口范围，调整到边界
+		if targetX < mainPos.X {
+			targetX = mainPos.X
+		} else if targetX+windowWidth > mainPos.X+mainWidth {
+			targetX = mainPos.X + mainWidth - windowWidth
+		}
+
+	case models.SnapEdgeTop:
+		// 吸附到主窗口顶部
+		targetX = windowPos.X // 保持当前 X 位置
+		targetY = mainPos.Y - windowHeight
+		// 如果超出主窗口范围，调整到边界
+		if targetX < mainPos.X {
+			targetX = mainPos.X
+		} else if targetX+windowWidth > mainPos.X+mainWidth {
+			targetX = mainPos.X + mainWidth - windowWidth
+		}
+
+	// ==== 角落吸附 ====
+	case models.SnapEdgeTopRight:
+		// 吸附到右上角
+		targetX = mainPos.X + mainWidth
+		targetY = mainPos.Y - windowHeight
+
+	case models.SnapEdgeBottomRight:
+		// 吸附到右下角
+		targetX = mainPos.X + mainWidth
+		targetY = mainPos.Y + mainHeight
+
+	case models.SnapEdgeBottomLeft:
+		// 吸附到左下角
+		targetX = mainPos.X - windowWidth
+		targetY = mainPos.Y + mainHeight
+
+	case models.SnapEdgeTopLeft:
+		// 吸附到左上角
+		targetX = mainPos.X - windowWidth
+		targetY = mainPos.Y - windowHeight
+
+	default:
+		// 不应该到达这里
+		return
+	}
+
+	// 直接移动到目标位置，不使用平滑过渡以产生明显的吸附效果
+	windowInfo.Window.SetPosition(targetX, targetY)
+
+	// 更新窗口信息
+	windowInfo.SnapEdge = snapEdge
+	windowInfo.LastPos = models.WindowPosition{X: targetX, Y: targetY}
+}
+
+// Cleanup 清理资源
+func (wss *WindowSnapService) Cleanup() {
+	// 如果有取消函数，调用它来停止所有goroutine
+	if wss.cancel != nil {
+		wss.cancel()
+	}
+
+	// 停止定时器
+	if wss.snapTicker != nil {
+		wss.snapTicker.Stop()
+		wss.snapTicker = nil
+	}
+}
+
+// ServiceShutdown 实现服务关闭接口
+func (wss *WindowSnapService) ServiceShutdown() error {
+	wss.Cleanup()
+	return nil
+}
--- a/main.go
+++ b/main.go
@@ -25,6 +25,7 @@ var assets embed.FS
 // logs any error that might occur.
 func main() {
 	serviceManager := services.NewServiceManager()
+	var window *application.WebviewWindow

 	var encryptionKey = [32]byte{
 		0x1e, 0x1f, 0x1c, 0x1d, 0x1a, 0x1b, 0x18, 0x19,
@@ -51,6 +52,13 @@ func main() {
 		SingleInstance: &application.SingleInstanceOptions{
 			UniqueID:      "com.voidraft",
 			EncryptionKey: encryptionKey,
+			OnSecondInstanceLaunch: func(data application.SecondInstanceData) {
+				if window != nil {
+					window.Show()
+					window.Restore()
+					window.Focus()
+				}
+			},
 			AdditionalData: map[string]string{
 				"launchtime": time.Now().Local().String(),
 			},
@@ -82,6 +90,7 @@ func main() {
 		URL:              "/",
 	})
 	mainWindow.Center()
+	window = mainWindow

 	// 获取托盘服务并设置应用引用
 	trayService := serviceManager.GetTrayService()
@@ -96,7 +105,7 @@ func main() {

 	// 初始化热键服务
 	hotkeyService := serviceManager.GetHotkeyService()
-	err := hotkeyService.Initialize(app)
+	err := hotkeyService.Initialize(app, mainWindow)
 	if err != nil {
 		panic(err)
 	}
Author	SHA1	Message	Date
landaiqing	fa72ff8061	Merge remote-tracking branch 'github/dependabot/go_modules/github.com/ulikunitz/xz-0.5.14'	2025-08-30 19:00:36 +08:00
landaiqing	65f24860e6	✨ Added window snapping function toggle	2025-08-30 00:18:29 +08:00
dependabot[bot]	4881233211	⬆️ Bump github.com/ulikunitz/xz from 0.5.12 to 0.5.14 Bumps [github.com/ulikunitz/xz](https://github.com/ulikunitz/xz) from 0.5.12 to 0.5.14. - [Commits](https://github.com/ulikunitz/xz/compare/v0.5.12...v0.5.14) --- updated-dependencies: - dependency-name: github.com/ulikunitz/xz dependency-version: 0.5.14 dependency-type: indirect ... Signed-off-by: dependabot[bot] <support@github.com>	2025-08-28 19:44:41 +00:00
landaiqing	bc01fdf362	✨ Added window snapping feature	2025-08-24 16:07:48 +08:00
landaiqing	709998ff9c	🐛 Fixed hotkey crashes	2025-08-19 22:26:55 +08:00
landaiqing	6adeadeed4	🐛 Fixed document deadlock issue	2025-08-19 00:24:51 +08:00
landaiqing	7b70a39b23	🐛 Fixed hotkey service issues	2025-08-19 00:08:50 +08:00
landaiqing	873a3c0e60	✨ Modify the theme storage schema	2025-08-17 19:34:35 +08:00