Hua/Hua.Todo
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
d94d1f36d29762d0b192996baee7c73574921a71
Hua.Todo/docs/manual/版本记录.md
T
ShaoHua d53828c150 feat: v1.2.0 开发进度更新 
### 新增功能
- **Linux 官方支持**：新增 Hua.Todo.Avalonia 项目，正式适配 Linux 平台，同时支持 Windows 和 macOS
- **Avalonia 桌面交互**：增加托盘菜单（显示/退出）、关闭隐藏到托盘、Windows 全局热键唤起主窗口、热键配置本地持久化
- **SQLite DateTime 兼容修复**：新增 LenientUtcDateTimeStringConverter，解决历史遗留的 DateTime 脏数据解析问题
- **用户文档完善**：新增 docs/manual/新手指南.md 和 docs/manual/用户指南.md
- **部署文档**：新增 docs/manual/部署文档.md，详细说明多平台发布流程

### 优化与修复
- **发布脚本整理**：拆分/对齐各平台发布入口，新增 publish.ps1 作为统一入口
- **Windows WebView2 优化**：数据目录调整到 %LocalAppData%\Hua.Todo\WebView2，修复 Runtime 误判问题
- **MAUI 多平台构建**：在 Windows 开发机上默认仅构建 Android + Windows 目标
- **SPA 路由回落**：修复 Release 模式下 /swagger 路径的 404 问题
- **Swagger 输出**：补齐 Dynamic API 端点，避免接口缺失

### 文档更新
- **版本记录**：更新 v1.2.0 开发进度和功能列表
- **技术设计文档**：添加 Avalonia 项目架构和模块设计
- **项目结构**：更新 README.md 中的项目结构说明

### 其他变更
- 新增 Directory.Build.props 和更新 Directory.Build.targets
- 调整 src/Hua.Todo.Avalonia 项目配置和资源文件
- 更新 src/Hua.Todo.Web 前端资源文件
- 修复 src/Hua.Todo.Maui 相关配置和打包脚本
2026-04-09 21:39:07 +08:00

4.9 KiB
Raw Blame History

版本更新历史

🔄 版本更新

版本策略

  • 采用语义化版本号：MAJOR.MINOR.PATCH
  • v1.0.0：初始 WPF 版本
  • v1.1.0：MAUI + WebView 跨平台版本
  • v1.2.0 (规划中)：Linux 支持与增强功能

v1.2.0（开发中，2026-04-07）

  • Linux 官方支持：新增 Hua.Todo.Avalonia 项目，正式适配 Linux 平台，同时支持 Windows 和 macOS。

  • Avalonia 桌面交互：增加托盘菜单（显示/退出）、关闭隐藏到托盘、Windows 全局热键唤起主窗口、热键配置本地持久化；并对齐 Avalonia 的 appsettings 默认值。

  • 关键词检索：主界面增加搜索框，按任务标题实时过滤；采用“命中即显示（含上下文）”策略；支持 Esc 清空；英文大小写不敏感。

  • 云同步（基础可用）：新增“云同步设置”弹窗，支持手动配置服务端地址（格式校验 + 保存时可达性/风险提示）；登录成功后拉取云端任务并刷新主界面（v1.2.0 为只读展示）；401/403 时会自动清会话并弹出登录入口。

  • MAUI（Windows）内嵌 API 文档：Debug 模式下，内嵌 WebServer 默认提供 Swagger UI（{HostUrl}/swagger）与 OpenAPI JSON（{HostUrl}/swagger/v1/swagger.json），便于本地接口调试。

  • Swagger 输出补齐 Dynamic API：任务管理等 Dynamic API 端点会出现在 swagger.json 中，避免“接口缺失”导致联调困难。

  • SQLite DateTime 兼容修复：新增 LenientUtcDateTimeStringConverter，本地数据库中若存在历史遗留的 DateTime “ticks/时间戳字符串”脏数据，读取时将被兼容解析，避免 /api/task 等查询因单条坏数据整体失败。

  • SPA 路由回落行为修复：当 Release/非 Debug 未启用 Swagger 时，/swagger 不再被当作“后端专用路径”排除，访问会按 SPA 路由规则回落到 /index.html，避免直接 404。

  • MAUI 多平台构建开关：在 Windows 开发机上默认仅构建 Android + Windows 目标，避免 iOS/MacCatalyst 目标在非 macOS 环境触发运行时包缺失（NETSDK1082）；在 macOS 上仍会包含 iOS/MacCatalyst 目标。

  • 发布脚本整理：拆分/对齐各平台发布入口，新增 publish.ps1 作为统一入口（默认发布 Windows + Linux），Windows 发布脚本支持开关打包与版本自增，发布产物会落盘到 artifacts/。

  • Windows 发布打包修复：Inno Setup 安装包文件名带版本号（Hua.Todo_Setup_vX.Y.Z.exe）；安装后快捷方式/启动项指向 Hua.Todo.Maui.exe；发布产物强制 IsUsingStatic=true。

  • Windows WebView2 数据目录调整：MAUI（Unpackaged）默认会在安装目录生成 Hua.Todo.Maui.exe.WebView2；现改为写入 %LocalAppData%\Hua.Todo\WebView2，避免污染安装目录。

  • Windows WebView2 Runtime 误判修复：当系统已安装 WebView2 Runtime 但发布产物缺少/裁剪 WebView2 托管程序集时，旧检测逻辑会误判为“未安装”；现改为优先从常见安装目录探测 Evergreen 版本，避免阻断主界面加载。

  • Windows 三件套开发体验：新增 start-host.ps1 / start-dev.ps1，并在 MAUI 中约定 IsUsingStatic=false 时不启动内置 WebServer，避免注入覆盖 Vite 的 /api -> 5173 代理配置。

  • 文档与部署指南：新增 docs/manual/部署文档.md，详细说明开发环境搭建、多平台发布流程（Windows/Linux/Docker）以及关键配置项；并在技术设计文档中建立链接。

  • 用户文档完善：新增 docs/manual/新手指南.md 和 docs/manual/用户指南.md，提供详细的使用说明和操作指南。 27→ 28→### v1.1.1 (2026-04-06)

  • 文档规范增强：新增文档同步规则，强制代码变更与文档更新保持同步。

  • 项目结构说明校准：修正 README.md 和技术文档中对 Hua.Todo.Host、Hua.Todo.Application 等模块的路径与职责描述。

  • 端口配置校准：修正文档中关于前端与后端 API 的端口说明（5173/5174）。

  • PRD 校准：移除 v1.2.0 PRD 中“本地迭代不支持”表述与“数据迁移（导入/导出）”小节。

  • PRD 校准：移除 v1.2.0 PRD 中“云同步”需求。

v1.1.0 更新内容

  • 重构为 MAUI + WebView 架构
  • 实现跨平台支持 (Windows, macOS, Android, iOS)
  • 使用 HTTP API 进行前后端通信
  • 采用 Vue.js 3 作为前端框架
  • 使用 SQLite 作为本地数据库
  • 实现子任务支持

v1.2.0 规划内容 (即将推出)

  • Linux 官方支持：正式适配 Linux 平台。
  • Linux 打包与交付：新增 .tar.gz 发布脚本与 Flatpak（manifest/desktop entry/AppStream）基础结构。
  • 关键词检索：支持按任务标题关键词搜索。
  • 标签系统：引入多标签支持，提升任务组织效率。
  • 暗色模式：全平台适配暗色/深色主题。
  • 数据导出导入（后续）：支持 JSON 格式数据备份与迁移（延期到后续版本）。
Reference in New Issue View Git Blame Copy Permalink