Repository navigation
Releases
v2.0.3
v2.0.3 正式版
这是 v2.0.3-beta.1(2026-08-07)之后的正式版本,基于 2026-10-06 的稳定代码发布。Beta 到正式版之间包含 406 个提交、448 个文件变更(+81,147 / -8,599 行),不只是版本号更新。
相比 v2.0.3-beta.1 的主要变化
数据同步、备份与可靠性
- 将学习数据同步升级为按记录增量同步,笔记正文独立存储并支持冲突对账,降低大快照同步的失败和覆盖风险。
- 增加离线 outbox、游标拉取、删除墓碑、并发写入保护、请求去重、重试和超时降级;账号切换、退出登录、多标签页和迟到响应均增加代次/会话守卫。
- 备份恢复支持大正文和大快照按 UTF-8 字节分块续传;被服务端拒绝的正文或元数据会保留在恢复队列,可在下一次同步重试,不再静默丢失。
- 修复番茄旧汇总并轨、重复打断事件、笔记正文对账和长下载会话生命周期问题。
- 新增 D1 迁移基线快照与一致性检查,正式版包含 0001–0011 共 11 条迁移,覆盖维护游标、R2 清理、奖励、番茄完成、学习隐私、资料收藏、错题复习、认证会话/举报和数据完整性。
认证、安全与服务端
- 存量 bcrypt 密码登录时透明升级到 PBKDF2;JWT 增加角色和会话版本校验,修改密码、跨标签页登录和退出可即时失效旧会话。
- 收紧 Cookie/CORS/CSRF、请求体大小、输入结构和资源权限校验;新增按用户维度限流、请求超时/重试、缓存隔离、游标分页和 Zod 校验。
- Turnstile SDK 加载去重,修复异步加载时调用
ready()导致的 3857 错误;脚本、渲染、挑战和卸载均有有限重试、超时和迟到回调保护。 - 点赞、举报、积分、徽章、通知和团队奖励改为事务化处理;并发操作幂等,计数与实际记录保持一致,举报和奖励记录增加唯一约束。
- 增加敏感词归一化过滤、管理员举报分页、R2 孤图清理和失败重试;统一错误状态与中文提示。
学习功能
- 新增学习路径推荐、考试倒计时、科目权重周计划、个人成长主页、热力图和学习统计。
- 待办支持按日期查看、标题编辑、删除确认、时间字段校验和前台提醒;提醒无系统通知权限时自动回退到应用内 Toast。
- 错题支持章节/题型元数据、间隔复习排期(1/2/4/7/15/30 天)和掌握度联动;资料支持关键词搜索、收藏、分页和附件编码修复。
- 番茄钟增加任务描述、完成明细、持久化、双人同步、提前结束语义和积分防重复;日总结、统计、习惯和刷题统一 UTC+8 与学习时长口径。
- 英语模块增加汉译英练习、词汇缓存隔离、阅读/听力/作文模板编辑和词数统计;PDF 改为 D1 分块存储并支持安全预览。
社区、搭子与小队
- 新增社区广场、帖子/评论/配图、提问与最佳答案、精华分区、标签筛选、热门话题、每日打卡榜、成长徽章、举报审核和管理员反馈。
- 新增圈子、关注、私信、通知、个人主页、访客模式和学习数据隐私开关;公开学习数据、榜单和推荐严格遵守授权。
- 新增学习搭子匹配、双人自习室、双人番茄钟、计划/复盘/分享、周报推送和历史记录;小队支持公开性、成员审批、队长转让、解散、挑战进度和批量同步。
- 帖子、评论、私信、通知、圈子、搭子和小队列表使用游标分页与稳定排序,减少深分页、重复数据和并发竞态。
界面与桌面端
- 完成全局主题、字体、图标、动效和共享组件重构,统一导航、弹窗、按钮、空态、加载态、错误态和 404 页面。
- 增加懒加载路由的全局加载和失败重试,首屏补水失败、离线同步和请求失败均提供可操作反馈;设置页分区锚点兼容旧地址并正确滚动。
- 补齐表单 label、键盘操作、焦点陷阱、移动端触摸目标、图片替代文本和窄屏布局,统一视觉与无障碍语义。
- Electron 增加导航/路径/CSP/权限白名单和渲染崩溃防护;自动更新支持取消、后台下载、超时兜底和平台判断,Windows 安装包使用稳定的 ASCII 文件名。
- PWA 支持离线核心阅读路径;图表升级到 ECharts 6,构建工具升级到 Vite 7,前端和 Worker 均采用模块化目录。
工程与验证
- 增加统一的
typecheck、lint、format:check、Electron/Worker 测试和 CI 门禁;Worker 测试从 Beta 的基础 smoke 扩展为 51 个回归/安全/并发测试文件。 - v2.0.3 发布前本地验证结果:420/420 测试通过,前端类型检查通过,ESLint 通过,Prettier 检查通过,Worker 类型检查通过,桌面渲染层生产构建通过。
升级提示
- Web 与 Worker 发布仍按
master的 GitHub Actions 流程执行;已有数据库请按worker/README.md的迁移登记流程应用 0001–0011,不能直接把完整schema.sql覆盖旧库。 - Windows 桌面安装包由
v2.0.3tag 的发布工作流构建;GitHub Release 草稿发布后,electron-updater 才会向用户提供更新。macOS 仍需本地手动构建。
v2.0.3-beta.1
🧪 专升本学习助手 v2.0.3-beta.1 预发布
⚠️ 这是一个预发布版本(Pre-release),主要用于内测和早期体验。普通用户请等待正式版 v2.0.3 发布。
📋 版本概览
| 项目 | 内容 |
|---|---|
| 版本号 | v2.0.3-beta.1 |
| 类型 | 预发布(Pre-release) |
| 发布日期 | 2026-08-07 |
| 上游版本 | v2.0.2 |
| 变更数 | 3 个功能/重构提交 |
✨ 本次更新内容
🔧 自动更新架构优化
重构了桌面端自动更新机制,提升更新检查和 Release Notes 获取的稳定性与可控性:
-
📡 Worker 中新增加
/api/latest-release接口(0a33d7c)- 中转 GitHub Releases API,统一控制更新策略
- 为后续实现灰度发布、内测通道、CDN 加速等打下基础
-
🔄 桌面端自动更新逻辑重构(
e33ae45)electron-updater的releaseNotes获取改为通过 Worker 中转- 不再直连 GitHub API,降低客户端对外部服务的直接依赖
- 更新弹窗展示的更新日志更加稳定可靠
-
🌐 Worker 域名迁移(
ac11a11)- 服务域名更新为
cn.zsbservice.de5.net - 更稳定的国内访问体验
- 服务域名更新为
📦 安装包
| 平台 | 文件 | 大小 |
|---|---|---|
| 🪟 Windows | 专升本学习助手 Setup 2.0.3-beta.1.exe |
~125 MB |
| 📁 便携版 | win-unpacked/ 目录 |
解压即用 |
⚙️ 文档更新
- API 文档:新增
GET /api/latest-release接口说明(Worker README 同步更新) - 开发指南:Worker 中转接口支持本地调试
wrangler dev
🔍 完整变更记录
89fd688 chore: bump version to 2.0.3-beta.1
ac11a11 chore: Worker 域名迁移至 cn.zsbservice.de5.net
e33ae45 refactor(electron): 自动更新 releaseNotes 通过 Worker 中转获取
0a33d7c feat(worker): 新增 /api/latest-release 中转 GitHub Releases API
🚀 已知问题
- 此为预发布版本,自动更新功能仅对勾选"接收预发布版"的用户生效
- macOS 和 Linux 构建需在对应平台执行
npm run dist:mac/ 手动打包
🙋 反馈渠道
如遇到任何问题,请在 GitHub Issues 中提交反馈,并标注版本号 v2.0.3-beta.1。
感谢参与内测! 🎉
v2.0.2
📋 版本概述
v2.0.2 是 v2.0.1 的紧急修复版本,针对桌面端自动更新通知中发布说明显示为空的问题。
🐛 Bug 修复
📥 桌面端更新通知 releaseNotes 为空
问题描述:桌面端检测到新版本后弹出更新通知,但发布说明区域显示「暂无详细更新说明」,用户无法了解更新内容。
根因分析:electron/main.cjs 中 fetchReleaseNotes() 使用 net.fetch(Electron net 模块的 fetch API)向 GitHub Releases API 发起 HTTPS 请求获取发布说明。该 API 对 Electron net.fetch 的支持不稳定,请求静默失败(无报错/无日志),返回空字符串,导致更新弹窗无法渲染 releaseNotes。
修复方案:
- 将
fetchReleaseNotes中的网络请求从net.fetch替换为node:https - 增加完整的错误处理链路:
- HTTP 状态码检查(非 200 时打印错误日志)
- JSON 解析异常捕获
- 请求超时保护(8 秒)
- 网络错误捕获
- 关键节点打印
console.error日志,便于后续通过 DevTools / 日志文件排查
修复前:net.fetch → 静默失败 → 空 releaseNotes
修复后:node:https → 状态码检查/JSON解析/超时保护 → 正常显示发布说明
📊 变更统计
v2.0.1 → v2.0.2: 2 files changed, +38 −6
| 文件 | 变更 |
|---|---|
electron/main.cjs |
fetchReleaseNotes 重写:net.fetch → node:https,增加日志和错误处理 |
package.json |
版本号 2.0.1 → 2.0.2 |
📥 Assets 说明
| 文件 | 说明 |
|---|---|
🖥️ zsb-study-tracker-setup-2.0.2.exe |
Windows NSIS 安装包(x64),支持自定义安装目录 |
📦 latest.yml |
electron-updater 自动更新清单,桌面端启动自动检测 |
🔄 zsb-study-tracker-setup-2.0.2.exe.blockmap |
增量更新块映射,减少更新下载量 |
Web 端用户:访问 演示站点 即可自动使用最新版本,无需手动更新。
🔗 相关链接
- Full Changelog: v2.0.1...v2.0.2
- 项目主页: https://github.com/Han050912/zsb-study-tracker
- 问题反馈: https://github.com/Han050912/zsb-study-tracker/issues
v2.0.1 → v2.0.2 升级无破坏性变更,已安装桌面端应用启动后会自动检测并提示更新。建议所有用户升级。
v2.0.1
📋 版本概述
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 端用户:访问 演示站点 即可自动使用最新版本,无需手动更新。
🔗 相关链接
- Full Changelog: v2.0.0...v2.0.1
- 项目主页: https://github.com/Han050912/zsb-study-tracker
- 问题反馈: https://github.com/Han050912/zsb-study-tracker/issues
v2.0.0 → v2.0.1 升级无破坏性变更,已安装桌面端应用启动后会自动检测并提示更新。建议所有用户升级。
v2.0.0
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 |
| 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
v1.1.0
新功能
八项功能大型迭代
- 统一提醒: notify.ts 统一服务,浏览器 Web Notification + Electron 原生通知,reminder.ts 统一调度,设置变更即时生效
- Markdown 引擎升级: markdown-it 替换自研正则渲染器,支持表格/代码块/任务列表/有序列表/引用/删除线/链接,对齐 Typora 标准,保留 KaTeX 公式,防 XSS
- 笔记页面重构: 新增 /notes 全屏页(左侧列表 + 右侧编辑/分栏/预览三态),废弃弹窗编辑,支持 PDF 导入(pdfjs-dist 文本提取)+ canvas 预览
- 番茄钟沉浸式重构: 柔和白噪音(布朗噪声+滤波链+淡入淡出+海浪LFO),Unsplash 主题背景图,实时时钟,随机名人名言
- 英语作文模板库: 一键生成 10 套内置高分模板(议论文5+图表文2+信件文3),分类多列布局,支持自定义与掌握评级
- 英语刷题题型: 按科目适配题型模板(单选/完形/阅读/翻译/写作),统计页动态聚合兼容历史数据
- 资料库上传改造: URL/文件双模式,拖拽上传+点击选择(<=8MB),dataURL 内嵌存储
- 墨墨背单词对接: 官方开放 API 同步今日新学/复习数据,Token 保存于设置,防重复打卡
桌面端自动更新
- 集成 electron-updater,启动后自动检测 GitHub Release 更新
- 新增 UpdateDialog.vue 更新弹窗(版本号/发布说明/进度条/三态按钮)
- preload.cjs 桥接 window.updater API,Web 端自动隐藏
Bug 修复
- 词汇图表近 14 个自然日补零填充,修复断档问题
- Tailwind primary 色板补全 800/900 档,修复 dark 样式静默失效
- GitHub Pages 白屏修复:新增 deploy-pages.yml CI 工作流(npm ci + vite build + upload + deploy)
兼容性
- 数据结构均为可选字段新增,旧版本本地存储数据完全兼容
v1.0.0 · 专升本学习助手首个正式版
专升本学习助手 v1.0.0
专升本备考一站式学习打卡管理助手,支持 Web 与 Windows 桌面端,数据本地加密存储,不上传任何服务器。
✨ 新增功能
- 学习打卡:按科目/章节/知识点记录学习时长,内置计时器
- 章节知识点:掌握度五星评估、重要程度分级(普通/重要/必考),双击即可编辑
- 刷题与错题本:题型分布统计、正确率趋势、错题复习追踪
- 番茄钟专注、每日待办、习惯追踪(好习惯打卡 + 坏习惯克制)
- 数据统计中心:学习热力图、时长柱状图(悬浮分科目统计/点击细分耗时)、情绪曲线
- 资料库:书籍/视频/链接/文档管理,阅读进度跟踪
- 游戏化激励:积分、连胜、等级、成就系统
- 账号体系:注册登录、数据 AES-GCM 加密存储、头像菜单(个人中心/切换账号/退出登录)
- Windows 桌面端:窗口/托盘/启动画面,可折叠侧边导航
🐛 Bug 修复
- 修复资料库「打开链接」跳转路径错误,兼容内网 IP/主机名与外网域名格式
🎨 体验优化
- 侧边栏支持折叠/展开,状态本地记忆
- 章节标题与知识点均支持双击行内编辑,实时保存回显
📦 兼容说明
- 安装包:Windows x64(NSIS),安装路径可自选(如 D 盘)
- Web 端:现代浏览器直接访问,数据保存在本机 SQLite
- 旧版本地数据自动迁移,无需手动操作