Skip to content

v2.0.0

Choose a tag to compare

@Han050912 Han050912 released this 05 Aug 23:27
· 476 commits to master since this release

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 完整依赖清单(含开发依赖)

升级指南

  1. Web 端:访问 演示站点 即可自动使用最新版本
  2. 桌面端:下载 专升本学习助手 Setup 2.0.0.exe 覆盖安装
  3. 自部署:参考 README 部署 Cloudflare Worker 和 Pages

Full Changelog: v1.1.0...v2.0.0