Skip to content

Commit e539571

Browse files
gusibigusibi
authored andcommitted
update release description
1 parent 0fe3b80 commit e539571

File tree

3 files changed

+171
-30
lines changed

3 files changed

+171
-30
lines changed

.github/workflows/release.yml

Lines changed: 60 additions & 29 deletions
Original file line numberDiff line numberDiff line change
@@ -77,53 +77,84 @@ jobs:
7777
cat > RELEASE_NOTES.md << 'EOF'
7878
# MoliTodo v${{ steps.get_version.outputs.VERSION }} ✨
7979
80-
## 📄 About Page & Auto-Start Fix
80+
## ⚠️ 重要升级提醒
8181
82-
### New Features
83-
- **About Page**: Comprehensive about page with version info, project links, and update checking
84-
- **Version Management**: Built-in update checker and GitHub integration
85-
- **Project Information**: Easy access to license, author, and project details
82+
**升级前请务必备份数据!**
8683
87-
### Bug Fixes
88-
- **Auto-Start Setting**: Fixed error when enabling auto-start configuration
89-
- **Settings Reliability**: Improved startup settings handling and error prevention
84+
1. **升级前备份**: 建议在升级前先导出您的任务数据
85+
- 打开应用 → 设置 → 数据管理 → 导出任务
86+
- 保存导出的文件到安全位置
9087
91-
### 🍎 macOS Installation
88+
2. **升级后验证**: 升级完成后请检查应用是否正常工作
89+
- 确认任务数据完整
90+
- 测试基本功能(创建、编辑、删除任务)
9291
93-
Due to unsigned code, macOS users need to run this command after installation:
92+
3. **问题恢复**: 如果升级后遇到问题
93+
- 使用之前导出的任务文件进行恢复
94+
- 设置 → 数据管理 → 导入任务
95+
- 或联系技术支持获取帮助: [GitHub Issues](https://github.com/${{ github.repository }}/issues)
96+
97+
---
98+
99+
## 🔧 Windows SQLite 兼容性与性能优化
100+
101+
### 关键错误修复
102+
- **Windows SQLite 兼容性**: 修复了 Windows 系统上的 `getLastUpdatedTime is not a function` 错误
103+
- **数据库初始化**: 增强了 SQLite 初始化,支持 Windows 特定的文件锁定和权限检查
104+
- **跨平台路径处理**: 改进了路径标准化,提升 Windows 兼容性
105+
- **迁移顺序**: 修复了数据库迁移序列,防止表创建错误
106+
107+
### 性能改进
108+
- **SQLite 优化**: 添加了 Windows 特定的 SQLite 参数以提升性能
109+
- **错误处理**: 增强了数据库错误诊断和日志记录
110+
- **文件系统**: 改进了文件系统操作,支持正确的 Windows 路径处理
111+
- **数据完整性**: 加强了数据验证和一致性检查
112+
113+
### 🍎 macOS 安装说明
114+
115+
由于代码未签名,macOS 用户需要在安装后运行以下命令:
94116
95117
```bash
96118
sudo xattr -rd com.apple.quarantine /Applications/MoliTodo.app
97119
```
98120
99-
Run this command:
100-
- After first installation
101-
- After each update
102-
- If you see "cannot open application" error
121+
请在以下情况运行此命令:
122+
- 首次安装后
123+
- 每次更新后
124+
- 如果看到"无法打开应用程序"错误
125+
126+
### 📥 下载
127+
128+
- **macOS**: 选择适合您 Mac 的版本(Intel/Apple Silicon)
129+
- **Windows**: Windows 10+ 通用安装程序
130+
131+
### 主要改进
103132
104-
### 📥 Download
133+
- **Windows 兼容性**: 解决了 Windows 系统上的关键 SQLite 数据库错误
134+
- **数据库性能**: 增强了所有平台的 SQLite 初始化和优化
135+
- **错误诊断**: 改进了错误处理,提供详细的日志和诊断信息
136+
- **跨平台支持**: 更好的文件系统操作,支持 Windows、macOS 和 Linux
137+
- **数据完整性**: 加强了数据库验证和一致性检查
105138
106-
- **macOS**: Choose the appropriate version for your Mac (Intel/Apple Silicon)
107-
- **Windows**: Universal installer for Windows 10+
139+
### 技术细节
108140
109-
### Key Improvements
141+
此版本解决了 Windows 用户遇到的 `getLastUpdatedTime is not a function` 错误,该错误是由于 SQLite 初始化不完整导致的。修复包括:
110142
111-
- **About Page**: Access app info through Settings > About
112-
- **Update Checking**: Built-in update checker with GitHub integration
113-
- **Auto-Start Fix**: Startup settings now work reliably without errors
114-
- **Settings Stability**: Enhanced overall settings configuration management
143+
- 增强数据库初始化顺序
144+
- Windows 特定的 SQLite 配置
145+
- 改进的跨平台路径处理
146+
- 更好的错误处理和诊断
115147
116-
### Upgrade Notes
148+
### 升级说明
117149
118-
- All existing data and settings preserved
119-
- Auto-start setting now works correctly
120-
- New about page available immediately
121-
- No configuration required
150+
- 所有现有数据和设置都会保留
151+
- Windows 用户将不再遇到 SQLite 数据库错误
152+
- 所有平台的数据库性能都有提升
153+
- 无需配置 - 修复会自动生效
122154
123155
---
124156
125-
**Full Documentation**: [Release Notes](https://github.com/${{ github.repository }}/blob/main/docs/releases/v${{ steps.get_version.outputs.VERSION }}.md)
126-
**Issues & Support**: [GitHub Issues](https://github.com/${{ github.repository }}/issues)
157+
**完整文档**: [发布说明](https://github.com/${{ github.repository }}/blob/main/docs/releases/v${{ steps.get_version.outputs.VERSION }}.md)
127158
EOF
128159
- uses: softprops/action-gh-release@v2
129160
with:

docs/releases/v1.1.4.md

Lines changed: 110 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,110 @@
1+
# MoliTodo v1.1.4 Release Notes
2+
3+
*Released: September 27, 2025*
4+
5+
## 🔧 Critical Windows Compatibility Fix
6+
7+
### 🐛 Major Bug Fixes
8+
9+
#### Windows SQLite Database Issues
10+
- **Fixed `getLastUpdatedTime is not a function` Error**: Resolved critical error that prevented Windows users from using the application
11+
- **Database Initialization Order**: Fixed initialization sequence where migrations were attempted before base tables were created
12+
- **SQLite Compatibility**: Enhanced SQLite initialization with Windows-specific configurations and optimizations
13+
- **Cross-Platform Path Handling**: Implemented proper path normalization for Windows file system compatibility
14+
15+
#### Database Performance & Reliability
16+
- **Enhanced Error Handling**: Added comprehensive error diagnostics and logging for database operations
17+
- **Windows-Specific Optimizations**: Applied Windows-specific SQLite parameters for better performance and stability
18+
- **File System Operations**: Improved file system operations with proper Windows path handling and permissions
19+
- **Data Integrity**: Strengthened database validation and consistency checks across all platforms
20+
21+
## 🛠️ Technical Improvements
22+
23+
### Database Infrastructure
24+
- **SQLite Repository Enhancement**: Updated `sqlite-task-repository.js` with improved initialization logic
25+
- **Migration System**: Fixed database migration sequence to prevent `ALTER TABLE` operations on non-existent tables
26+
- **Path Normalization**: Added `normalizePath()` method for consistent cross-platform file path handling
27+
- **Error Diagnostics**: Enhanced error reporting with detailed database operation logging
28+
29+
### Cross-Platform Support
30+
- **Windows File Locking**: Implemented Windows-specific file locking and permission checks
31+
- **Path Separator Handling**: Proper handling of Windows vs Unix path separators
32+
- **Database Configuration**: Platform-specific SQLite configuration for optimal performance
33+
- **Compatibility Testing**: Added comprehensive Windows compatibility testing framework
34+
35+
## 🎯 User Impact
36+
37+
### Windows Users
38+
- **Application Functionality Restored**: Windows users can now use MoliTodo without database errors
39+
- **Improved Performance**: Enhanced database operations with Windows-specific optimizations
40+
- **Reliable Data Storage**: Consistent and reliable task data persistence across all operations
41+
- **Error-Free Experience**: Eliminated critical startup and operation errors on Windows systems
42+
43+
### All Platforms
44+
- **Enhanced Stability**: Improved database reliability and error handling across macOS, Windows, and Linux
45+
- **Better Performance**: Optimized SQLite operations for faster task management
46+
- **Robust Error Handling**: Comprehensive error diagnostics and recovery mechanisms
47+
- **Data Integrity**: Strengthened data validation and consistency checks
48+
49+
## 🔄 Technical Details
50+
51+
### Root Cause Analysis
52+
The issue was caused by incomplete SQLite initialization on Windows systems, where the application attempted to call database methods before the repository was fully initialized. This was particularly problematic on Windows due to:
53+
54+
1. **File System Differences**: Windows file locking and permission handling differs from Unix systems
55+
2. **Path Handling**: Windows path separators and file system operations required special handling
56+
3. **SQLite Configuration**: Windows-specific SQLite parameters were needed for optimal performance
57+
4. **Initialization Order**: Database migrations were attempted before base table creation
58+
59+
### Solution Implementation
60+
- **Enhanced Initialization**: Restructured database initialization to ensure proper order of operations
61+
- **Windows-Specific Code**: Added Windows-specific file system and SQLite handling
62+
- **Path Normalization**: Implemented cross-platform path handling with proper separator conversion
63+
- **Error Recovery**: Added comprehensive error handling and recovery mechanisms
64+
65+
## 🔄 Migration Notes
66+
67+
### Automatic Updates
68+
- **Seamless Upgrade**: All existing data and settings are automatically preserved
69+
- **No Configuration Required**: Fixes are applied automatically without user intervention
70+
- **Backward Compatibility**: Full compatibility with existing task data and application settings
71+
- **Instant Relief**: Windows users will immediately experience error-free operation
72+
73+
### Data Safety
74+
- **Zero Data Loss**: All existing tasks, lists, and settings remain intact
75+
- **Database Integrity**: Enhanced validation ensures data consistency during and after upgrade
76+
- **Backup Compatibility**: Existing backup and restore functionality remains unchanged
77+
78+
## 🚀 Installation Notes
79+
80+
### Windows Users
81+
- **Immediate Fix**: This release specifically addresses Windows compatibility issues
82+
- **Standard Installation**: No special installation steps required
83+
- **Performance Improvement**: Noticeable improvement in application startup and operation speed
84+
85+
### macOS Users
86+
Due to unsigned code, macOS users still need to run this command after installation:
87+
88+
```bash
89+
sudo xattr -rd com.apple.quarantine /Applications/MoliTodo.app
90+
```
91+
92+
## 📊 Quality Assurance
93+
94+
### Testing Coverage
95+
- **Windows Compatibility**: Comprehensive testing on Windows 10 and Windows 11
96+
- **Database Operations**: Full CRUD operation testing across all platforms
97+
- **Migration Testing**: Verified database migration and initialization processes
98+
- **Performance Testing**: Confirmed improved performance metrics on Windows systems
99+
100+
### Validation
101+
- **Error Resolution**: Confirmed elimination of `getLastUpdatedTime is not a function` error
102+
- **Cross-Platform**: Verified functionality across Windows, macOS, and Linux
103+
- **Data Integrity**: Validated data consistency and reliability across all operations
104+
- **Performance**: Measured and confirmed performance improvements on Windows
105+
106+
---
107+
108+
**Priority**: Critical Fix - Recommended for all Windows users
109+
**Compatibility**: Windows 10+, macOS 10.14+, Linux (Ubuntu 18.04+)
110+
**Download**: [GitHub Releases](https://github.com/gusi/MoliTodo/releases/tag/v1.1.4)

package.json

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
{
22
"name": "moli-todo",
3-
"version": "1.1.3",
3+
"version": "1.1.4",
44
"description": "一款常驻在桌面边缘的悬浮式待办事项应用",
55
"main": "src/main/main.js",
66
"scripts": {

0 commit comments

Comments
 (0)