release: v1.6.2

Author: Jacobinwwey

README.md

@@ -279,9 +279,26 @@ npm start -- --path "E:/Knowledge/ObsidianVault" --no-gpu
 Managing your knowledge base source is now easier than ever.
 
 - **First Run Setup**: On first launch, you will be prompted to select your `Knowledge_Base` folder.
-- **Persistent Config**: Your selection is saved in `kb_config.json` and remembered across restarts.
+- **Persistent Config (`app_config.toml`)**: Your KB path, language, and multi-window preferences are saved in `%LOCALAPPDATA%/NoteConnection/app_config.toml` (Windows default) and remembered across restarts.
+- **Legacy Auto-Migration**: If a legacy `kb_config.json` exists in the same config directory, NoteConnection automatically migrates it to `app_config.toml`.
 - **Change Anytime**: Use the **File > Change Knowledge Base...** menu option to switch folders instantly.
 - **Reset**: Use **File > Reset to Default** to return to the bundled demo notes.
+- **Config Path Overrides**: Set `NOTE_CONNECTION_CONFIG_PATH` (full file path) or `NOTE_CONNECTION_CONFIG_DIR` (directory) to customize where `app_config.toml` is stored.
+- **Window Behavior Tuning**: Edit `[multi_window]` in `app_config.toml` (`single_window_mode`, `hide_tauri_when_pathmode_opens`, `restore_tauri_when_pathmode_exits`, `confirm_before_full_shutdown_from_godot`, `sync_language`).
+- **Detailed Config Guide**: See [`docs/en/app_config.toml_guide.md`](docs/en/app_config.toml_guide.md) and template [`docs/examples/app_config.template.toml`](docs/examples/app_config.template.toml).
+
+```toml
+# Minimal recommended app_config.toml
+knowledge_base_path = "E:/Knowledge_project/NoteConnection_app/Knowledge_Base"
+user_language = "en"
+
+[multi_window]
+single_window_mode = true
+hide_tauri_when_pathmode_opens = true
+restore_tauri_when_pathmode_exits = true
+confirm_before_full_shutdown_from_godot = true
+sync_language = true
+```
 
 ## 🏗️ Build & Deployment
 
@@ -1136,9 +1153,26 @@ npm start -- --path "E:/Knowledge/ObsidianVault" --no-gpu
 管理知识库源现在变得更加简单。
 
 - **首次运行设置**: 首次启动时，系统会提示您选择 `Knowledge_Base` 文件夹。
-- **持久化配置**: 您的选择保存在 `kb_config.json` 中，并在重启后自动加载。
+- **持久化配置 (`app_config.toml`)**: KB 路径、语言及多窗口偏好默认保存到 `%LOCALAPPDATA%/NoteConnection/app_config.toml`（Windows），重启后自动恢复。
+- **旧配置自动迁移**: 若同目录存在旧版 `kb_config.json`，启动时会自动迁移到 `app_config.toml`。
 - **随时更改**: 使用 **文件 > 更改知识库...** 菜单选项即时切换文件夹。
 - **重置**: 使用 **文件 > 重置为默认** 返回由捆绑的演示笔记。
+- **配置路径覆盖**: 可通过 `NOTE_CONNECTION_CONFIG_PATH`（完整文件路径）或 `NOTE_CONNECTION_CONFIG_DIR`（目录）自定义 `app_config.toml` 位置。
+- **窗口行为可调**: 在 `app_config.toml` 的 `[multi_window]` 段调整 `single_window_mode`、`hide_tauri_when_pathmode_opens`、`restore_tauri_when_pathmode_exits`、`confirm_before_full_shutdown_from_godot`、`sync_language`。
+- **详细配置说明**: 参见 [`docs/zh/app_config.toml_guide.md`](docs/zh/app_config.toml_guide.md) 与模板 [`docs/examples/app_config.template.toml`](docs/examples/app_config.template.toml)。
+
+```toml
+# 推荐最小 app_config.toml
+knowledge_base_path = "E:/Knowledge_project/NoteConnection_app/Knowledge_Base"
+user_language = "en"
+
+[multi_window]
+single_window_mode = true
+hide_tauri_when_pathmode_opens = true
+restore_tauri_when_pathmode_exits = true
+confirm_before_full_shutdown_from_godot = true
+sync_language = true
+```
 
 ## 🏗️ 构建与部署 (Build & Deployment)
 

TEST_REPORT.md

@@ -1251,7 +1251,7 @@ Determine whether the Electron -> Tauri migration is currently complete enough t
 | Cache decision and restore flow | IPC `checkCache` + `restoreCache` | Sidecar APIs + Tauri commands + modal prompt in `source_manager.js` | **Migrated** |
 | Tutorial choice behavior | Welcome + tutorial choice | `welcome.js` + `tutorial.js` include skip/session guards | **Migrated** |
 | Menu language switch | Electron dynamic menu rebuild | Tauri menu rebuild in `set_user_language` | **Partially Migrated** |
-| Persistent KB path + language config | `kb_config.json` in Electron userData | Tauri currently defaults path, no equivalent persistent config file | **Not Fully Migrated** |
+| Persistent KB path + language config | `kb_config.json` in Electron userData | Tauri persists KB path + language + multi-window settings in `app_config.toml` (auto-migrates legacy `kb_config.json`) | **Migrated (v1.6.0+)** |
 | Godot process integration | N/A in Electron mainline release path | Tauri currently spawns Godot via hardcoded absolute path, not robust sidecar usage | **Not Fully Migrated** |
 | Sidecar/Godot lifecycle shutdown guarantees | Electron app lifecycle owns process lifetime | Tauri code does not implement explicit shutdown management verification for spawned children | **Partially Migrated** |
 | Release-ready path model | Electron used app-local protocol and known layout | Tauri sidecar paths are tuned for repo/dev layout (`dist/src/frontend`, `Knowledge_Base`) | **Partially Migrated** |
@@ -1272,9 +1272,9 @@ Determine whether the Electron -> Tauri migration is currently complete enough t
 
 #### 2) High-Risk Gaps Before Removing Electron
 
-- **Persistent user configuration parity is incomplete**:
+- **Persistent user configuration parity is now complete (updated 2026-03-25)**:
   - Electron persisted KB path and language in `kb_config.json`.
-  - Tauri currently returns default KB path and does not persist selected KB root across restarts in equivalent form.
+  - Tauri now persists KB path, language, and multi-window policy in `app_config.toml`, with startup auto-migration from legacy `kb_config.json`.
 - **Godot launch path is environment-coupled**:
   - `src-tauri/src/lib.rs` uses hardcoded absolute Windows paths for Godot executable/project.
   - This is not portable across machines or release packaging.
@@ -1366,7 +1366,7 @@ Electron -> Tauri migration is **functionally successful in current desktop deve
 - **Steps**:
   1. Ran `npm start`.
   2. Selected a custom folder in the First Run setup.
-  3. Verified `kb_config.json` was created in `AppData`.
+  3. Verified legacy `kb_config.json` was created in `AppData` (superseded by `app_config.toml` in v1.6.0+).
   4. Used "File > Reset to Default" and "File > Change Knowledge Base" menus.
 - **Result**: Config updates correctly; app reloads and loads the specific folder.
 - **Status**: **Pass**
@@ -3728,7 +3728,7 @@ Electron -> Tauri migration is **functionally successful in current desktop deve
 | 缓存提示与恢复 | IPC `checkCache`/`restoreCache` | sidecar API + Tauri 命令 + `source_manager.js` 弹窗 | **已迁移** |
 | 教程选择逻辑 | Welcome + Tutorial | `welcome.js` + `tutorial.js` 会话跳过保护 | **已迁移** |
 | 菜单语言切换 | Electron 动态重建菜单 | Tauri `set_user_language` 动态重建菜单 | **部分迁移** |
-| KB 路径/语言持久化 | Electron `kb_config.json` | Tauri 尚无等价持久化配置文件闭环 | **未完全迁移** |
+| KB 路径/语言持久化 | Electron `kb_config.json` | Tauri 已在 `app_config.toml` 持久化 KB 路径、语言与多窗口设置（启动自动迁移旧 `kb_config.json`） | **已迁移（v1.6.0+）** |
 | Godot 进程集成 | Electron 期未形成统一方案 | Tauri 仍使用硬编码绝对路径拉起 Godot | **未完全迁移** |
 | 子进程生命周期收敛 | Electron 生命周期统一管理 | Tauri 未完成显式关闭与回收验证 | **部分迁移** |
 | 发布态路径模型 | Electron `app://` + 明确资源关系 | Tauri 仍偏向仓库开发目录路径假设 | **部分迁移** |
@@ -3749,9 +3749,9 @@ Electron -> Tauri migration is **functionally successful in current desktop deve
 
 #### 2) 立即删除 Electron 前的高风险缺口
 
-- **用户配置持久化对等性不足**：
-  - Electron 有 `kb_config.json` 持久化。
-  - Tauri 尚未形成等价的 KB 路径与语言持久化闭环。
+- **用户配置持久化对等性已补齐（更新于 2026-03-25）**：
+  - Electron 时代使用 `kb_config.json` 持久化。
+  - Tauri 已使用 `app_config.toml` 持久化 KB 路径、语言与多窗口策略，并在启动时自动迁移旧版 `kb_config.json`。
 - **Godot 启动路径耦合开发机**：
   - `src-tauri/src/lib.rs` 使用硬编码绝对路径。
   - 换机或发布环境极易失效。
@@ -3859,7 +3859,7 @@ Electron -> Tauri 在**桌面开发态**已达到可用水平，但按 `docs/tau
 - **步骤**:
   1. 运行 `npm start`。
   2. 在首次运行设置中选择自定义文件夹。
-  3. 验证 `kb_config.json` 已在 `AppData` 中创建。
+  3. 验证旧版 `kb_config.json` 已在 `AppData` 中创建（该方案已在 v1.6.0+ 由 `app_config.toml` 取代）。
   4. 使用“文件 > 重置为默认”和“文件 > 更改知识库”菜单。
 - **结果**: 配置更新正确；应用重载并加载指定文件夹。
 - **状态**: **通过**

TODO.md

@@ -3785,7 +3785,7 @@ Convert the last open `v1.5.9` sign-off item (Capacitor physical-device checklis
 
 ### Phase P0 - Must Complete Before Electron Removal
 
-- [x] **Implement Tauri persistent config parity (`kb_config` equivalent)**
+- [x] **Implement Tauri persistent config parity (`app_config.toml` + legacy `kb_config` auto-migration)**
   - [x] Persist selected KB path in Tauri app data.
   - [x] Persist user language in Tauri app data.
   - [x] Load both values on startup before frontend initialization.
@@ -4183,7 +4183,7 @@ Convert the last open `v1.5.9` sign-off item (Capacitor physical-device checklis
   - [x] **CSP Enhancement**: Updated Content Security Policy to allow external font loading (Google Fonts).
   - [x] **Security Hardening**: Removed insecure `enableBlinkFeatures` flag.
 - [x] **User-Defined Knowledge Base**
-  - [x] **Persistence**: Implemented `kb_config.json` to store user-selected paths.
+  - [x] **Persistence**: Implemented `app_config.toml` to store user-selected paths (with legacy `kb_config.json` auto-migration).
   - [x] **First-Run Experience**: Added setup wizard for selecting initial KB folder.
   - [x] **Menu Integration**: Added "Change Knowledge Base" and "Reset to Default" to File menu.
 - [x] **Stability & Installer Reliability**
@@ -6127,7 +6127,7 @@ This document outlines the roadmap for building `NoteConnection`, a system capab
 
 ### 阶段 P0 - 移除 Electron 前必须完成
 
-- [x] **实现 Tauri 持久化配置对等能力（等价 `kb_config`）**
+- [x] **实现 Tauri 持久化配置对等能力（`app_config.toml` + 旧版 `kb_config` 自动迁移）**
   - [x] 在 Tauri 应用数据目录持久化 KB 路径。
   - [x] 在 Tauri 应用数据目录持久化语言设置。
   - [x] 启动时在前端初始化前读取并应用。

docs/BILINGUAL_INDEX.md

@@ -1,4 +1,4 @@
-# 2026-03-24 v1.6.0 - Bilingual Docs Pair Index
+# 2026-03-25 v1.6.0 - Bilingual Docs Pair Index
 
 ## English Document
 
@@ -9,9 +9,9 @@
 
 ### Summary
 
-- English files: `18`
-- Chinese files: `17`
-- Bilingual pairs: `17`
+- English files: `19`
+- Chinese files: `18`
+- Bilingual pairs: `18`
 - English-only files: `1`
 - Chinese-only files: `0`
 
@@ -36,6 +36,7 @@
 | 15 | `TODO.md` | `docs/en/TODO.md` | `docs/zh/TODO.md` | Paired |
 | 16 | `User_Manual.md` | `docs/en/User_Manual.md` | `docs/zh/User_Manual.md` | Paired |
 | 17 | `walkthrough.md` | `docs/en/walkthrough.md` | `docs/zh/walkthrough.md` | Paired |
+| 18 | `app_config.toml_guide.md` | `docs/en/app_config.toml_guide.md` | `docs/zh/app_config.toml_guide.md` | Paired |
 
 ### Unmatched Files
 
@@ -55,9 +56,9 @@
 
 ### 汇总
 
-- 英文文件数：`18`
-- 中文文件数：`17`
-- 中英配对数：`17`
+- 英文文件数：`19`
+- 中文文件数：`18`
+- 中英配对数：`18`
 - 仅英文文件数：`1`
 - 仅中文文件数：`0`
 
@@ -82,6 +83,7 @@
 | 15 | `TODO.md` | `docs/en/TODO.md` | `docs/zh/TODO.md` | 已配对 |
 | 16 | `User_Manual.md` | `docs/en/User_Manual.md` | `docs/zh/User_Manual.md` | 已配对 |
 | 17 | `walkthrough.md` | `docs/en/walkthrough.md` | `docs/zh/walkthrough.md` | 已配对 |
+| 18 | `app_config.toml_guide.md` | `docs/en/app_config.toml_guide.md` | `docs/zh/app_config.toml_guide.md` | 已配对 |
 
 ### 未配对文件
 

docs/diataxis-map.json

@@ -38,6 +38,18 @@
         "diataxis": "docs/diataxis/zh/how-to/single-window-runtime.md"
       }
     },
+    {
+      "id": "configure-app-config",
+      "category": "how-to",
+      "en": {
+        "canonical": ["docs/en/app_config.toml_guide.md", "docs/en/User_Manual.md", "docs/en/README.md"],
+        "diataxis": "docs/diataxis/en/how-to/configure-app-config.md"
+      },
+      "zh": {
+        "canonical": ["docs/zh/app_config.toml_guide.md", "docs/zh/User_Manual.md", "docs/zh/README.md"],
+        "diataxis": "docs/diataxis/zh/how-to/configure-app-config.md"
+      }
+    },
     {
       "id": "interfaces-and-runtime",
       "category": "reference",
@@ -50,6 +62,18 @@
         "diataxis": "docs/diataxis/zh/reference/interfaces-and-runtime.md"
       }
     },
+    {
+      "id": "app-config-schema",
+      "category": "reference",
+      "en": {
+        "canonical": ["docs/en/app_config.toml_guide.md", "docs/en/Interface Document.md"],
+        "diataxis": "docs/diataxis/en/reference/app-config-schema.md"
+      },
+      "zh": {
+        "canonical": ["docs/zh/app_config.toml_guide.md", "docs/zh/Interface Document.md"],
+        "diataxis": "docs/diataxis/zh/reference/app-config-schema.md"
+      }
+    },
     {
       "id": "release-and-governance",
       "category": "reference",

docs/diataxis/en/how-to/configure-app-config.md

@@ -0,0 +1,47 @@
+# How-To: Configure app_config.toml
+
+Use this guide to safely customize local runtime behavior (KB path, language, and single-window policy).
+
+## Step 1: Locate the Active Config File
+
+NoteConnection resolves config in this order:
+
+1. `NOTE_CONNECTION_CONFIG_PATH`
+2. `NOTE_CONNECTION_CONFIG_DIR` + `app_config.toml`
+3. `%LOCALAPPDATA%/NoteConnection/app_config.toml` (Windows default)
+
+## Step 2: Start from the Official Template
+
+Copy from:
+
+- [`docs/examples/app_config.template.toml`](../../../examples/app_config.template.toml)
+
+## Step 3: Apply Your Policy
+
+Recommended single-window profile:
+
+```toml
+[multi_window]
+single_window_mode = true
+hide_tauri_when_pathmode_opens = true
+restore_tauri_when_pathmode_exits = true
+confirm_before_full_shutdown_from_godot = true
+sync_language = true
+```
+
+## Step 4: Save and Restart
+
+1. Exit NoteConnection.
+2. Save config as UTF-8 text.
+3. Restart and verify Path Mode window handoff.
+
+## Step 5: Verify Language + KB Persistence
+
+- Confirm selected KB path persists across restart.
+- Confirm language is applied on startup.
+- Confirm language sync in Path Mode if `sync_language = true`.
+
+## Canonical Detailed Sources
+
+- [docs/en/app_config.toml_guide.md](../../../en/app_config.toml_guide.md)
+- [docs/en/User_Manual.md](../../../en/User_Manual.md)

docs/diataxis/en/how-to/single-window-runtime.md

@@ -24,3 +24,4 @@ Use this guide to verify and operate Tauri/Godot single-window behavior.
 
 - [docs/en/single_window_migration_plan.md](../../../en/single_window_migration_plan.md)
 - [docs/en/User_Manual.md](../../../en/User_Manual.md)
+- [docs/en/app_config.toml_guide.md](../../../en/app_config.toml_guide.md)

docs/diataxis/en/overview.md

@@ -27,4 +27,10 @@ mkdocs build --config-file mkdocs.yml
 - Product overview: [docs/en/README.md](../../en/README.md)
 - Interface contracts: [docs/en/Interface Document.md](../../en/Interface%20Document.md)
 - User manual: [docs/en/User_Manual.md](../../en/User_Manual.md)
+- app_config guide: [docs/en/app_config.toml_guide.md](../../en/app_config.toml_guide.md)
 - Release compare report: [docs/en/release_v1.6.0_report.md](../../en/release_v1.6.0_report.md)
+
+## Runtime Config Entry Points
+
+- How-to: [Configure app_config.toml](./how-to/configure-app-config.md)
+- Reference: [app_config.toml Schema](./reference/app-config-schema.md)

docs/diataxis/en/reference/app-config-schema.md

@@ -0,0 +1,68 @@
+# Reference: app_config.toml Schema
+
+This page defines the authoritative `app_config.toml` runtime schema for NoteConnection `v1.6.0+`.
+
+## File Resolution Priority
+
+1. `NOTE_CONNECTION_CONFIG_PATH`
+2. `NOTE_CONNECTION_CONFIG_DIR` + `app_config.toml`
+3. `%LOCALAPPDATA%/NoteConnection/app_config.toml` (Windows default)
+
+Legacy file migration:
+
+- Legacy `kb_config.json` in the same config directory is auto-migrated to TOML at startup.
+
+## Schema
+
+```toml
+knowledge_base_path = "E:/Knowledge_project/NoteConnection_app/Knowledge_Base"
+user_language = "en"
+
+[multi_window]
+single_window_mode = true
+hide_tauri_when_pathmode_opens = true
+restore_tauri_when_pathmode_exits = true
+confirm_before_full_shutdown_from_godot = true
+sync_language = true
+```
+
+## Key Contract Table
+
+| Key | Type | Default | Constraints | Runtime Contract |
+|---|---|---|---|---|
+| `knowledge_base_path` | `string` | auto default KB root | must be an existing directory | Persisted KB root. Normalized to `Knowledge_Base` root if path points inside it. |
+| `user_language` | `string` | `"en"` | `"en"` or `"zh"` (`"zh-CN"` is not accepted and falls back to `"en"`) | Controls startup language and menu language. |
+| `multi_window.single_window_mode` | `bool` | `true` | boolean | Governs single-window startup/handoff policy and Godot launch visibility mode. |
+| `multi_window.hide_tauri_when_pathmode_opens` | `bool` | `true` | boolean | If true, `toggle_pathmode_window(show_godot=true)` hides Tauri main window. |
+| `multi_window.restore_tauri_when_pathmode_exits` | `bool` | `true` | boolean | If true, `toggle_pathmode_window(show_godot=false)` restores and focuses Tauri window. |
+| `multi_window.confirm_before_full_shutdown_from_godot` | `bool` | `true` | boolean | If true, Godot close flow requires confirmation ("return" vs "close all"). |
+| `multi_window.sync_language` | `bool` | `true` | boolean | If true, language updates emit runtime sync event payload to frontend windows. |
+
+## Backward-Compatible Aliases
+
+| Canonical | Legacy Alias |
+|---|---|
+| `knowledge_base_path` | `knowledgeBasePath` |
+| `user_language` | `userLanguage` |
+| `[multi_window]` | `[multiWindow]` |
+| `single_window_mode` | `singleWindowMode` |
+| `hide_tauri_when_pathmode_opens` | `hideTauriWhenPathmodeOpens` |
+| `restore_tauri_when_pathmode_exits` | `restoreTauriWhenPathmodeExits` |
+| `confirm_before_full_shutdown_from_godot` | `confirmBeforeFullShutdownFromGodot` |
+| `sync_language` | `syncLanguage` |
+
+## Runtime Projection to Frontend
+
+Frontend hydration uses `invoke('get_app_runtime_config')` and projects values to:
+
+- `window.__NC_APP_CONFIG.language`
+- `window.__NC_APP_CONFIG.multiWindow.singleWindowMode`
+- `window.__NC_APP_CONFIG.multiWindow.hideTauriWhenPathmodeOpens`
+- `window.__NC_APP_CONFIG.multiWindow.restoreTauriWhenPathmodeExits`
+- `window.__NC_APP_CONFIG.multiWindow.confirmBeforeFullShutdownFromGodot`
+- `window.__NC_APP_CONFIG.multiWindow.syncLanguage`
+
+## Canonical Detailed Sources
+
+- [docs/en/app_config.toml_guide.md](../../../en/app_config.toml_guide.md)
+- [docs/en/Interface Document.md](../../../en/Interface%20Document.md)

docs/diataxis/en/reference/interfaces-and-runtime.md

@@ -14,8 +14,20 @@ This reference tracks canonical API/runtime contracts.
   - `invoke('get_sidecar_runtime_config')`
 - Rust sidecar runtime config command:
   - `get_sidecar_runtime_config`
+- Rust app runtime config command:
+  - `get_app_runtime_config`
 - Runtime bridge readiness sequencing via `whenReady()`.
 
+## app_config Runtime Contract Hook
+
+- Frontend app-config hydration command:
+  - `invoke('get_app_runtime_config')`
+- Hydrated projection:
+  - `window.__NC_APP_CONFIG.language`
+  - `window.__NC_APP_CONFIG.multiWindow.*`
+- Detailed schema reference:
+  - [app_config.toml Schema](./app-config-schema.md)
+
 ## Policy Gate Families
 
 - PathBridge strict schema