Repository navigation
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 仍需本地手动构建。