更新: 版本号 0.4.2 → 0.5.0

CHANGELOG.internal.md

@@ -2,6 +2,18 @@
 
 > 本文档记录所有技术细节，包括代码重构、构建优化等内部改动
 
+## [0.5.0] - 2026-10-01
+
+- **webview 尺寸兜底** (app_window_fix.go): wails alpha.92 WM_SIZE 竞态（resizePending 丢消息+过期 bounds 重放）致 webview 停在中间尺寸；WndProcInterceptor 挂 WM_SIZE 校验 + 3s 周期兜底双路，GetClientRect/SetWindowPos 直铺 Chrome_WidgetWin_0。坑：user32 只导出无后缀名（带 W 的 proc 找不到会 panic）；EnumChildWindows 回调须包级变量传目标（param 传栈地址恒不匹配）；windowsgui 下 goroutine panic 静默杀进程须 recover
+- **剪贴板文件粘贴** (app_clipboard.go): CF_HDROP(15) + LockOSThread + OpenClipboard 重试 20×10ms，DragQueryFileW 解析路径后复用拖入链路 handleExternalDrop
+- **预览联动**: switchConnection/handleGoToPath 后 syncPreviewToActiveProfile 按 profileId 过滤预览 Tab，跨服务器切换不再残留他机预览
+- **PDF 导出**: HTML 预览导出 PDF，成功后 explorer /select 定位文件；插桩日志 ~/.u-desk/logs/pdf-export.log 为临时诊断，后续可清理
+- **收藏栏**: 宽度拖拽 180-420 持久化、展示名自定义、置顶浅蓝（--arcoblue-1）、双菜单互斥；Sidebar stateDotClass 改 per-profile getProfileState（全局 state 不带 profile 维度会误染红）
+- **一键全连**: connectAllServers 用 Promise.allSettled 并发连接可见非 local 项，完成后恢复原焦点
+- **绑定坑**: wails3 generate bindings 必须带 -clean=true -ts（否则 app.ts 被覆盖为 .js）
+
+---
+
 ## [0.4.2] - 2026-09-15
 
 - **初始化守卫**: 17 个 Wails 绑定方法加未就绪守卫，启动瞬间操作返回明确提示