From 1db2b8ff70f3cc6d897f1ba96fa4c8e2fbe25b2b Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E7=BB=9D=E5=B0=98?= <237809796@qq.com>
Date: Wed, 16 Sep 2026 00:12:54 +0800
Subject: [PATCH] =?UTF-8?q?=E6=9B=B4=E6=96=B0:=20=E7=89=88=E6=9C=AC?=
 =?UTF-8?q?=E5=8F=B7=200.4.1=20=E2=86=92=200.4.2?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- CHANGELOG 与内部日志补 0.4.2 修复段
- 功能清单与站点版本引用同步
- bindings 随 MovePath 注释再生成
---
 CHANGELOG.internal.md                 | 14 ++++++++++++++
 CHANGELOG.md                          | 13 +++++++++++++
 docs/07-项目管理/功能清单/功能清单.md |  4 ++--
 frontend/bindings/u-desk/app.ts       |  2 +-
 internal/service/version.go           |  2 +-
 wails.json                            |  2 +-
 6 files changed, 32 insertions(+), 5 deletions(-)

diff --git a/CHANGELOG.internal.md b/CHANGELOG.internal.md
index 2bd9f10..732b597 100644
--- a/CHANGELOG.internal.md
+++ b/CHANGELOG.internal.md
@@ -2,6 +2,20 @@
 
 > 本文档记录所有技术细节，包括代码重构、构建优化等内部改动
 
+## [0.4.2] - 2026-09-15
+
+- **初始化守卫**: 17 个 Wails 绑定方法加未就绪守卫，启动瞬间操作返回明确提示
+- **MovePath**: 跨盘剪切改 emitter 上报传输进度，失败自动清理残留文件
+- **SFTP 空目录**: 下载/上传目标 MkdirAll，空目录正确创建不丢失
+- **drawio 预览**: 首次下载失败时唤醒全部等待者，立即提示
+- **重试进度**: 网络重试后进度基线重置，失败条目显示错误状态
+- **连接回退**: 回退池校验，连接失败不回落本地磁盘列表
+- **OSS 签名**: base64 StdEncoding 兼容性修复
+- **errMessage 归一**: 错误消息统一提取
+- **slog 统一**: 日志输出统一 log/slog
+
+---
+
 ## [0.4.1] - 2026-05-01 ~ 05-16 (fs-only-v3)
 
 ---
diff --git a/CHANGELOG.md b/CHANGELOG.md
index 42d9ad3..64e2e02 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,5 +1,18 @@
 # 更新日志
 
+## [0.4.2] - 2026-09-15
+
+### 修复 🐛
+- **启动初始化**: 启动瞬间操作文件不再无响应,未就绪时给出明确提示
+- **跨盘剪切**: 大目录移动显示传输进度,失败自动清理残留文件
+- **SFTP 空目录**: 空目录下载/上传后正确创建,不再静默丢失
+- **drawio 预览**: 首次下载失败后立即提示,不再长时间无响应
+- **进度可靠性**: 网络重试后进度不再虚跳,失败条目正确显示错误状态
+- **连接回退**: 连接失败后不再错误回落到本地磁盘列表
+- **编码细节**: OSS 签名兼容性修复,batch 脚本 %1/%%i 变量高亮
+
+---
+
 ## [0.4.1] - 2026-05-16 (fs-only-v3)
 
 ### 新增 ✨
diff --git a/docs/07-项目管理/功能清单/功能清单.md b/docs/07-项目管理/功能清单/功能清单.md
index 395f12f..fc15e5b 100644
--- a/docs/07-项目管理/功能清单/功能清单.md
+++ b/docs/07-项目管理/功能清单/功能清单.md
@@ -1,6 +1,6 @@
 # U-Desk 功能清单
 
-> 应用版本：v0.3.3
+> 应用版本：v0.4.2
 > 更新时间：2026-02-28 10:00
 > 用途：测试、开发、迭代过程中验证核对
 > 核对状态：✅ 已通过Git版本对比 + 源码验证
@@ -489,7 +489,7 @@
 
 **文档维护**: 开发团队
 **最后更新**: 2026-02-28 10:00
-**应用版本**: v0.3.3
+**应用版本**: v0.4.2
 **核对状态**: ✅ 已通过Git版本对比 + 源码验证 + 需求对照
 **核对报告**: [功能清单核对报告.md](./功能清单核对报告.md)
 **下次审查**: 每次发版前
diff --git a/frontend/bindings/u-desk/app.ts b/frontend/bindings/u-desk/app.ts
index f960a49..c7a5952 100644
--- a/frontend/bindings/u-desk/app.ts
+++ b/frontend/bindings/u-desk/app.ts
@@ -336,7 +336,7 @@ export function LoadConnectionProfiles(): $CancellablePromise<{ [_ in string]?:
 }
 
 /**
- * MovePath 移动文件或目录（同盘重命名，跨盘复制后删除）
+ * MovePath 移动文件或目录（同盘重命名，跨盘复制后删除），跨盘时经 transfer-progress 事件推送进度
  */
 export function MovePath(src: string, dst: string): $CancellablePromise<void> {
     return $Call.ByID(2028899675, src, dst);
diff --git a/internal/service/version.go b/internal/service/version.go
index 0dd1488..57bda8c 100644
--- a/internal/service/version.go
+++ b/internal/service/version.go
@@ -15,7 +15,7 @@ import (
 // ==================== 常量定义 ====================
 
 // AppVersion 应用版本号（发布时直接修改此处）
-const AppVersion = "0.4.1"
+const AppVersion = "0.4.2"
 
 // 版本号缓存
 var (
diff --git a/wails.json b/wails.json
index 5dd346d..d56ba40 100644
--- a/wails.json
+++ b/wails.json
@@ -1,7 +1,7 @@
 {
   "name": "u-desk",
   "outputfilename": "u-desk",
-  "version": "0.4.1",
+  "version": "0.4.2",
   "frontend:install": "npm install",
   "frontend:build": "npm run build",
   "author": {