v2.0.0: 云端架构迁移 + 多项功能迭代与修复
版本概述
本版本为重大架构升级,核心变化是将数据存储从本地 sql.js SQLite 迁移至 Cloudflare Worker + D1 云端数据库,同时包含多项新功能、性能优化和 Bug 修复。升级后应用依赖云端服务,旧版本本地数据不会自动迁移。
破坏性变更 (Breaking Changes)
| 变更 |
影响 |
迁移建议 |
| 移除 sql.js 本地 SQLite 依赖 |
本地数据库存储被完全移除 |
升级前请手动备份 v1.x 本地数据,升级后需重新注册云端账号 |
| 数据存储迁移至 Cloudflare Worker + D1 |
所有数据改为云端存储 |
首次使用需注册新账号,旧数据不会自动同步 |
| 认证方式改为 REST JWT |
本地 IndexedDB 认证被替换 |
需使用新注册流程登录 |
| Electron 移除本地数据桥接 |
preload 桥接接口变更 |
桌面端需更新到 v2.0.0 安装包 |
| 移除客户端加密服务 |
crypto.ts 被删除,安全由 Worker JWT + HTTPS 保障 |
无需操作,传输安全由 HTTPS 保障 |
新功能 (Features)
云端后端服务 (Cloudflare Worker)
- 完整的 Worker 后端:路由、JWT 认证、D1 数据库集成
- 18 个 RESTful API 模块:auth / sync / records / errors / exams / gamification / notes / materials / settings / habits / pomodoro / todos / rewards / statistics / templates / maimemo-proxy / wallpaper-proxy / health
- 认证中间件:jose JWT 签发与校验,bcrypt 密码哈希
- 安全加固:HTTP 安全响应头、登录/注册速率限制(IP 滑动窗口,3-10 req/min)
- D1 SQLite schema,参数化 SQL 防注入,CRUD 工厂模式
- 冒烟测试脚本
前端 API 客户端层
- 18 个类型的 API 客户端模块,映射全部后端端点
- 统一 API client:JWT 自动注入、keepalive 兜底推送、64KB 载荷安全上限
- CSP meta 标签,限制脚本/连接/图片来源
- 环境变量类型声明(VITE_API_BASE + VITE_MAIMEMO_TARGET)
认证与安全
- 登录/注册接入 Cloudflare Turnstile 人机验证
- 401 透传鉴权失败处理
- Worker 校验 Turnstile token 并代理墨墨 API
英语模块
- 词汇打卡列表与墨墨学习明细拉取,打卡状态本地持久化
- 墨墨 API 通过 Worker 代理绕过 CORS 限制
仪表盘
- 待办事项改为 Pointer 拖拽排序,store 新增 reorderTodos 替代上下箭头
番茄钟
- 移除白噪音 WebAudio,专注全屏改为大号时钟 + 名言
- 经 Worker 代理拉取 Unsplash 壁纸轮播背景
笔记
桌面端自动更新
- 集成 electron-updater,启动后自动检测 GitHub Release 更新
- 新增 UpdateDialog.vue 更新弹窗(版本号/发布说明分组/进度条/三态按钮)
- preload.cjs 桥接 window.updater API,Web 端自动隐藏
- 兼容 quitForUpdate 绕过托盘最小化拦截
CI/CD
- Cloudflare Workers 自动部署工作流(worker/ 目录变更触发)
- GitHub Pages 构建部署工作流
Bug 修复 (Bug Fixes)
| # |
描述 |
| 1 |
English.vue 模板中 window 访问改为 script 中 isDesktop 计算属性,修复网页端 TypeError |
| 2 |
墨墨 API 走主进程 IPC 代理绕过浏览器 CORS 限制 |
| 3 |
墨墨 API 解析修复:解包双层 data 响应结构,接口路径补 /memo,新增 is_finished 参数 |
| 4 |
更新错误在未弹窗时通过 toast 可见 |
| 5 |
设置页新增手动检查更新按钮 |
| 6 |
修复 GitHub Pages 白屏:新增 Actions 工作流构建 dist 部署 |
| 7 |
修复路由过渡空白:路由加载失败自愈刷新 |
| 8 |
删除笔记兜底保存逻辑,仅在编辑态持久化,防止清空笔记内容 |
| 9 |
Worker CORS 新增 Cloudflare Pages 和 GitHub Pages 域名 |
| 10 |
词汇图表近 14 个自然日补零填充,修复断档问题 |
| 11 |
Tailwind primary 色板补全 800/900 档,修复 dark 样式静默失效 |
| 12 |
番茄钟重构:移除不稳定的 WebAudio 白噪音实现 |
性能优化 (Performance)
- useChart 改 shallowRef 浅监听,容器尺寸驱动初始化
- Rewards 累计/新增双轴修正
- 防抖推送 + beforeunload keepalive 兜底,减少不必要的数据同步
文档 (Documentation)
- README 全面重构:HTML 卡片化布局,技术栈 badges,社交链接,效果图展示
- 新增社区治理文件:CODE_OF_CONDUCT.md / CONTRIBUTING.md / SECURITY.md
- 新增应用截图(5 张)和捐赠 QR 码(2 张)
- 新增 MIT LICENSE 文件
- 新增 AGENTS.md 项目编码与架构决策原则
已知问题 (Known Issues)
| 问题 |
状态 |
说明 |
| v1.x 本地数据不自动迁移 |
已知 |
升级到 v2.0.0 后旧数据无法自动同步到云端,需手动备份 |
| macOS 安装包未签名 |
已知 |
macOS 上可能出现安全警告,需手动允许运行 |
| 墨墨背单词 API 依赖官方公测 |
已知 |
墨墨 API 为公测阶段,接口可能变更 |
| 离线模式不可用 |
已知 |
云端架构下无网络连接时应用无法使用 |
技术栈
| 类别 |
技术 |
| 前端框架 |
Vue 3 + TypeScript + Vite 5 |
| 样式 |
Tailwind CSS 3 |
| 状态管理 |
Pinia 2 |
| 图表 |
ECharts 5 |
| 数学公式 |
KaTeX 0.16 |
| Markdown |
markdown-it 15 |
| PDF |
pdfjs-dist 6 |
| 桌面端 |
Electron 43 |
| 后端 |
Cloudflare Workers + D1 (SQLite) |
| 认证 |
jose JWT + bcrypt + Turnstile |
Assets 说明
| 文件 |
说明 |
专升本学习助手 Setup 2.0.0.exe |
Windows NSIS 安装包(x64) |
专升本学习助手 Setup 2.0.0.exe.blockmap |
增量更新 blockmap |
latest.yml |
electron-updater 更新清单 |
zsb-study-tracker-web-v2.0.0.zip |
Web 前端构建产物(dist/) |
zsb-study-tracker-worker-v2.0.0.zip |
Cloudflare Worker 后端源码 |
dependencies.txt |
运行时依赖清单 |
dependencies-dev.txt |
完整依赖清单(含开发依赖) |
升级指南
- Web 端:访问 演示站点 即可自动使用最新版本
- 桌面端:下载
专升本学习助手 Setup 2.0.0.exe 覆盖安装
- 自部署:参考 README 部署 Cloudflare Worker 和 Pages
Full Changelog: v1.1.0...v2.0.0