📋 版本概述
v2.0.1 是 v2.0.0 的增量修复版本,核心变化包括:桌面端完全移除 Turnstile 人机验证、修复两项 PDF 笔记预览缺陷、完善 CI/CD 自动部署流程。所有已安装 v2.0.0 桌面端的用户将收到自动更新提示。
🚀 新功能
🔐 桌面端移除 Turnstile 人机验证
- 桌面端登录/注册不再需要人机验证,开箱即用
- 编译时通过
__DESKTOP_BUILD__ 常量实现 TurnstileWidget 组件整体 tree-shake
- 桌面端请求自动注入
X-Desktop-Token 认证头,Worker 端匹配后跳过 Turnstile 校验
- 暴力破解防护由 IP 滑动窗口频率限制(rateLimit)兜底,安全不降级
📦 桌面端 API 实现端到端可靠更新
electron-updater 集成 GitHub Releases 作为发布渠道
- 发布说明优先从
releaseNotes 字段读取,兜底调用 GitHub API 拉取
- 进程退出恢复绕过托盘最小化拦截,确保更新安装流程完整
🐛 Bug 修复
📄 PDF 笔记预览
| # |
问题 |
修复 |
| 1 |
PDF 上传后第一页不渲染,翻页再返回后才显示 |
PdfPreviewModal.vue:renderPage() 移至 loading=false 后执行,确保 <canvas> 已挂载到 DOM 再渲染 |
| 2 |
墨墨背单词笔记 PDF 解析失败,错误分类不准确 |
pdf.ts:适配旧版构建产物解析逻辑,新增错误分类函数 classifyPdfError() 提供更清晰的错误提示 |
| 3 |
编辑笔记时兜底保存逻辑误清空内容 |
Notes.vue:删除非编辑态的自动保存,仅在编辑态持久化 |
🔧 构建 & CI/CD
| # |
变更 |
说明 |
| 1 |
Worker 部署 Node.js 版本 20 → 22 |
Wrangler >=4.14 要求 Node.js >=22,修复自动部署失败 |
| 2 |
Worker 自动部署验证 |
push master + worker/** 变更 → 自动触发 Cloudflare Workers 部署 |
| 3 |
Worker 配置清理 |
移除 wrangler.toml 废弃的 [[env.production.vars]] 配置块 |
| 4 |
Worker 忽略构建产物 |
新增 worker/.gitignore 排除 dist-test/、dist/ |
| 5 |
CI 构建一致性 |
.env 纳入版本管理,修复 CI 环境 API 地址回退 |
📊 变更统计
v2.0.0 → v2.0.1: 19 files changed, +185 -86
| 模块 |
文件数 |
主要变更 |
| 桌面端 Turnstile |
6 |
vite.config.ts, TurnstileWidget.vue, Login.vue, client.ts, env.d.ts, worker/auth.ts |
| PDF 笔记 |
3 |
pdf.ts, PdfPreviewModal.vue, Notes.vue |
| CI/构建 |
6 |
deploy-worker.yml, package.json, .env, .gitignore, wrangler.toml, worker/.gitignore |
| Worker |
2 |
maimemo.ts (401→403), electron/main.cjs (更新兜底) |
📥 Assets 说明
| 文件 |
说明 |
🖥️ 专升本学习助手 Setup 2.0.1.exe |
Windows NSIS 安装包(x64),支持自定义安装目录 |
📦 latest.yml |
electron-updater 自动更新清单,桌面端启动自动检测 |
🔄 专升本学习助手 Setup 2.0.1.exe.blockmap |
增量更新块映射,减少更新下载量 |
Web 端用户:访问 演示站点 即可自动使用最新版本,无需手动更新。
🔗 相关链接
v2.0.0 → v2.0.1 升级无破坏性变更,已安装桌面端应用启动后会自动检测并提示更新。建议所有用户升级。