Skip to content

Releases

v2.0.3

Choose a tag to compare

@github-actions github-actions released this 06 Oct 15:37

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.3 tag 的发布工作流构建;GitHub Release 草稿发布后,electron-updater 才会向用户提供更新。macOS 仍需本地手动构建。

v2.0.3-beta.1

v2.0.3-beta.1 Pre-release
Pre-release

Choose a tag to compare

@Han050912 Han050912 released this 07 Aug 02:21

🧪 专升本学习助手 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

Choose a tag to compare

@Han050912 Han050912 released this 06 Aug 05:26

📋 版本概述

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 端用户:访问 演示站点 即可自动使用最新版本,无需手动更新。


🔗 相关链接


v2.0.1 → v2.0.2 升级无破坏性变更,已安装桌面端应用启动后会自动检测并提示更新。建议所有用户升级。

v2.0.1

Choose a tag to compare

@Han050912 Han050912 released this 06 Aug 04:32

📋 版本概述

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 升级无破坏性变更,已安装桌面端应用启动后会自动检测并提示更新。建议所有用户升级。

v2.0.0

Choose a tag to compare

@Han050912 Han050912 released this 05 Aug 23:27

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

v1.1.0

Choose a tag to compare

@Han050912 Han050912 released this 05 Aug 23:18

新功能

八项功能大型迭代

  • 统一提醒: 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 · 专升本学习助手首个正式版

Choose a tag to compare

@Han050912 Han050912 released this 03 Aug 07:05

专升本学习助手 v1.0.0

专升本备考一站式学习打卡管理助手,支持 Web 与 Windows 桌面端,数据本地加密存储,不上传任何服务器。

✨ 新增功能

  • 学习打卡:按科目/章节/知识点记录学习时长,内置计时器
  • 章节知识点:掌握度五星评估、重要程度分级(普通/重要/必考),双击即可编辑
  • 刷题与错题本:题型分布统计、正确率趋势、错题复习追踪
  • 番茄钟专注、每日待办、习惯追踪(好习惯打卡 + 坏习惯克制)
  • 数据统计中心:学习热力图、时长柱状图(悬浮分科目统计/点击细分耗时)、情绪曲线
  • 资料库:书籍/视频/链接/文档管理,阅读进度跟踪
  • 游戏化激励:积分、连胜、等级、成就系统
  • 账号体系:注册登录、数据 AES-GCM 加密存储、头像菜单(个人中心/切换账号/退出登录)
  • Windows 桌面端:窗口/托盘/启动画面,可折叠侧边导航

🐛 Bug 修复

  • 修复资料库「打开链接」跳转路径错误,兼容内网 IP/主机名与外网域名格式

🎨 体验优化

  • 侧边栏支持折叠/展开,状态本地记忆
  • 章节标题与知识点均支持双击行内编辑,实时保存回显

📦 兼容说明

  • 安装包:Windows x64(NSIS),安装路径可自选(如 D 盘)
  • Web 端:现代浏览器直接访问,数据保存在本机 SQLite
  • 旧版本地数据自动迁移,无需手动操作