v1.1.2

Author: Jacobinwwey

Interface Document.md

@@ -1,6 +1,6 @@
-# 2026-01-22 v1.1.1
+# 2026-01-23 v1.1.2
 
-# Interface Document (v1.1.1)
+# Interface Document (v1.1.2)
 
 This document defines the core interfaces for the NoteConnection system, separating backend processing from frontend visualization.
 
@@ -1006,7 +1006,9 @@ To provide a clearer initial layout, v1.0.1 adjusts the default values and adjus
 
 ---
 
-# 接口文档 (v1.0.1)
+# 2026-01-23 v1.1.2
+
+# 接口文档 (v1.1.2)
 
 本文档定义了 NoteConnection 系统核心接口，分离了后端处理与前端可视化。
 

README.md

@@ -1,4 +1,4 @@
-# 2026-01-22 v1.1.1
+# 2026-01-23 v1.1.2
 
 # NoteConnection Knowledge Graph
 
@@ -165,6 +165,7 @@ build_apk.bat
 ```
 
 This script automatically:
+
 1. Checks your environment (Node, Java, Android SDK).
 2. Installs dependencies.
 3. Builds web assets.
@@ -265,6 +266,15 @@ For optimal performance with "GPU Optimised Rendering", especially on AMD RDNA c
 
 ## 📅 Changelog
 
+### v1.1.2 - Path Resolution & UI Stability (2026-01-23)
+
+- **Backend Protocol Fix**:
+  - Improved `src/server.ts` to correctly handle URL query parameters (e.g., `?v=timestamp`) for static files.
+  - Resolves issues where cache-busting URLs would return 404 on Windows.
+- **UI Interaction Fix**:
+  - **Welcome Modal**: Fixed a bug in `welcome.js` where skipping the tutorial would cause the folder selection menu to become unresponsive due to `z-index` clobbering.
+  - Guaranteed `z-index: 1000` preservation for `#source-control` across all modal dismissal paths.
+
 ### v1.1.1 - Mobile Build Automation (2026-01-22)
 
 - **Mobile DevOps**:
@@ -836,6 +846,7 @@ build_apk.bat
 ```
 
 该脚本会自动：
+
 1. 检查您的环境 (Node, Java, Android SDK)。
 2. 安装依赖项。
 3. 构建 Web 资源。
@@ -923,6 +934,15 @@ npm start -- --path "E:/Knowledge/ObsidianVault" --no-gpu
 
 ## 📅 更新日志 (Changelog)
 
+### v1.1.2 - 路径解析与 UI 稳定性 (2026-01-23)
+
+- **后端协议修复**:
+  - 改进了 `src/server.ts`，使其能够正确处理静态文件的 URL 查询参数（如 `?v=timestamp`）。
+  - 解决了 Windows 环境下带缓存刷新参数的 URL 返回 404 的问题。
+- **UI 交互修复**:
+  - **欢迎弹窗**: 修复了 `welcome.js` 中的一个错误，即跳过教程会导致文件夹选择菜单因 `z-index` 被清除而无法响应的问题。
+  - 确保 `#source-control` 在所有弹窗关闭路径下都能保持 `z-index: 1000`。
+
 ### v1.1.1 - 移动端构建自动化 (2026-01-22)
 
 - **移动端运维**:

TODO.md

@@ -1,3 +1,12 @@
+# 2026-01-23 v1.1.2 - Path Resolution & UI Stability
+
+**Goal**: Resolve static file serving issues on Windows and fix UI unresponsiveness in the Welcome Modal.
+
+- [x] **Backend Fixes**
+  - [x] **URL Parsing**: Improved `server.ts` to ignore query strings when mapping static files, enabling cache-busting `data.js?v=...` to work correctly.
+- [x] **UI Stability**
+  - [x] **Z-Index Management**: Fixed `welcome.js` to explicitly restore `z-index: 1000` to the folder menu after skipping the tutorial.
+
 # 2026-01-22 v1.1.1 - Mobile Build Automation
 
 **Goal**: Automate the Android APK build process to lower the barrier for mobile deployment.
@@ -1161,6 +1170,15 @@ This document outlines the roadmap for building `NoteConnection`, a system capab
 
 ---
 
+# 2026-01-23 v1.1.2 - 路径解析与 UI 稳定性
+
+**目标**: 解决 Windows 上的静态文件服务问题并修复欢迎模态框中的 UI 无响应。
+
+- [x] **后端修复**
+  - [x] **URL 解析**: 改进了 `server.ts` 以在映射静态文件时忽略查询字符串，使缓存刷新 `data.js?v=...` 能够正常工作。
+- [x] **UI 稳定性**
+  - [x] **Z-Index 管理**: 修复了 `welcome.js` 以在跳过教程后显式恢复文件夹菜单的 `z-index: 1000`。
+
 # 2026-01-22 v1.1.1 - 移动端构建自动化 (Mobile Build Automation)
 
 **目标**: 自动化 Android APK 构建流程，降低移动端部署门槛。

package.json

@@ -1,6 +1,6 @@
 {
   "name": "noteconnection",
-  "version": "1.1.1",
+  "version": "1.1.2",
   "description": "Hierarchical Knowledge Graph Visualization System",
   "main": "dist/src/electron/main.js",
   "bin": {

src/frontend/locales/en.json

@@ -1,7 +1,7 @@
 {
   "app": {
     "name": "NoteConnection",
-    "version": "v1.0.0"
+    "version": "v1.1.2"
   },
   "menu": {
     "file": {

src/frontend/locales/zh.json

@@ -1,7 +1,7 @@
 {
   "app": {
     "name": "NoteConnection",
-    "version": "v1.0.0"
+    "version": "v1.1.2"
   },
   "menu": {
     "file": {

src/frontend/welcome.js

@@ -252,7 +252,7 @@ function showWelcomeModal(hasNodes = false) {
                  // Remove highlight
                  if (sourceControl) {
                      sourceControl.style.boxShadow = '';
-                     sourceControl.style.zIndex = '';
+                     sourceControl.style.zIndex = '1000';
                  }
 
                  // Mark as "seen" or just let them explore?

src/server.ts

@@ -273,7 +273,9 @@ export const startServer = async (options: { port?: number, targetPath?: string
             }
 
             // Serve Static Files
-            let urlPath = req.url === '/' ? 'index.html' : req.url!;
+            // v0.9.83 Fix: Strip query parameters (e.g. ?v=123) to verify file existence on disk
+            const urlObj = new URL(req.url!, `http://${req.headers.host}`);
+            let urlPath = urlObj.pathname === '/' ? 'index.html' : urlObj.pathname;
 
             // CLI Mode: Serve the specific CLI data file instead of the default data.js
             // This ensures the frontend loads the data calculated from the CLI parameters