Skip to content

v1.6.0

Choose a tag to compare

@Zoroaaa Zoroaaa released this 08 Nov 16:06

[v1.6.0] - 2026-11-08

本次版本覆盖 v1.5.0 以来的全部功能与审计修复,核心变化:新增帮助中心与统一通知收件箱;邮箱验证/邮件通知/后台邮件运维形成完整闭环;社区帖子浏览量按 24 小时去重;前端与共享包改为 TS paths + Vite alias 解析;数据库迁移扩展到 17 / 18 / 19。

新增

  • 帮助中心 /help:覆盖快速上手、为你推荐、JAV榜单、热门女优、搜索基础与各 Tab 差异、五类搜索、详情页、社区、关注女优、通知与邮件、账号安全、通用注意事项与 FAQ;每类统一为「功能介绍 + 使用步骤 + 注意事项」,并新增独立的通用注意事项章节
  • 统一通知收件箱:notifications 表((user_id, dedup_key) 唯一,重复触发幂等)+ 按类型偏好表;/api/notifications 提供收件箱分页、未读数、标记已读、删除、偏好读写;顶栏通知铃铛的未读数随 sync-state 返回,不增加首屏请求
  • 站点公告并入收件箱:公告不复制进 notifications,读取时与站内公告合并,仅用 user_announcement_reads 记录每个用户的已读/删除状态;新增 database/17_schema_announcement_reads.sql
  • 关注女优:/api/follows(关注上限 100,名字精确匹配才允许关注);actress_watch 全局一份,多人关注同一位只检查一次;关注时立即建立基线,首次检查不产生通知
  • 新作检测:新增 */30 * * * * 触发器,每轮最多检查 20 位,按番号集合对比,失败指数退避;新作通知按每人每轮每位女优合并为一条
  • 关注动态与关注管理:主页「关注动态」面板(新作 / 即将发售、服务端分页、未读标记);控制台新增我的关注、关注动态、通知三个页面;热门女优与搜索结果、影片详情演员旁均可直接关注
  • 邮件通知渠道:新作与社区互动通知可选邮件;通知进入 email_queue,*/15 任务按用户合并发送(最早一条攒够 10 分钟、每人每天最多 3 封、全站每天最多 90 封);失败按 30 分钟 × 2ⁿ 退避,连续 5 次放弃该批;发送前复核邮箱验证与偏好
  • 邮箱验证补入口:通知偏好页可直接发送并校验邮箱验证码,无需跳转到账号设置
  • 邮件隐私与退订:邮件主题保持中性、不含封面;支持「隐藏邮件详情」;每封通知邮件带 HMAC 签名的一键退订链接与 List-Unsubscribe 头,GET 仅展示确认页,POST 才执行
  • 后台邮件日志与队列:email_send_logs 记录类型、状态、用户、IP、限流键与错误信息;email_queue 可按 pending / sent / skipped / failed 查看摘要任务;后台新增对应管理页与接口 GET /api/config/email/logs、GET /api/config/email/queue
  • 公告邮件:发布公告时入队邮件,删除公告时清理待发送任务;用户之后开启公告邮件时,将最近 7 天内最多 20 条有效公告补发入队(按用户去重)
  • 社区帖子浏览去重:同一用户对同一帖子 24 小时内只计一次 view_count,作者本人访问不计数;新增 database/19_schema_community_post_views.sql
  • 邮件相关迁移:新增 database/16_email_notifications.sql(email_send_logs / email_queue / 退订令牌 / 通知偏好)
  • 历史通知补写:新增 database/18_backfill_community_notifications.sql,把历史社区互动补写为通知

修改

  • 社区通知 Tab 下线:社区页不再有独立通知 Tab,原 /api/community/notifications 等旧接口删除;点赞、评论、收藏、举报处理结果统一进入 /dashboard/notifications
  • 女优收藏并入关注:搜索结果与详情页不再提供女优收藏爱心,只保留「+ 关注」;后端拒绝新的 actress: 收藏并返回 USE_FOLLOW;database/15_migrate_actress_favorites_to_follows.sql 负责迁移存量数据
  • 热门女优与推荐口径调整:热门女优得分改为「四个榜单上榜作品数 × 5 + 被关注人数 × 2」;为你推荐只使用标签 + 发行商(4:1),女优收藏不再计入画像
  • 统一邮件发送器:事务邮件(验证码 / 找回密码 / 改邮箱 / 反馈回复)与通知邮件走同一发送器;事务邮件不受通知偏好和退订控制
  • 共享包解析方式:前端不再依赖 node_modules 软链接,改为 frontend/tsconfig.json 的 paths + frontend/vite.config.ts 的 alias 直接指向 packages/shared/src;后端仍由 npm workspaces 链接 + 包 exports 解析
  • 全站命名统一:所有 UI、文案、导航、帮助中心与三语文案中的「JAV番号搜索」统一改为「JAV搜索」
  • 榜单与缓存:榜单增加名次变化(↑ / ↓ / NEW),后端榜单与女优缓存调整为 6 小时
  • 收藏与历史:改为服务端分页并返回总数,控制台统计改为服务端聚合;新增 sync-state 跨设备缓存校验
  • 公告读取方式:公告由「复制进通知表」改为「读取时合并」,避免公告更新后收件箱内容不一致
  • 数据库迁移顺序:全新库需按 01 → 19 执行;08 / 12 修复幂等性,17 / 18 / 19 为 v1.6.0 新增
  • 版本号:统一升级到 1.6.0(根与各 workspace 包、APP_VERSION、前后端版本常量、README 徽章、文档)

修复

  • 登录失败锁定:security_lockouts 写入补全 identifier_hash,统一使用 hashToken 生成,所有查询/清理路径按该字段匹配,避免 NOT NULL 约束异常被吞导致锁定失效
  • 迁移脚本幂等性:08 不再引用不存在的表/列,12 不再重复加列,10 修复依赖顺序;全新库与已升级库均可安全重复执行
  • 用户配置越权:/user-configs/:userId、/export-user-configs/:userId 校验请求者是资源所有者或管理员,复用 /with-user-config 的权限判断
  • 社区异常吞没:发帖 / 更新 / 删除不再吞异常,失败时向上抛出真实错误,避免前端假成功导致数据丢失
  • 搜索竞态:搜索请求增加 requestId/序号,仅接受最后一次请求的响应
  • 401 刷新:收到 401 时先尝试一次单飞 token 刷新,失败后再登出,避免并发请求重复刷新
  • 导出鉴权:CSV / OPML 导出改用带鉴权请求,后端错误 JSON 不再被写入导出文件
  • 邮件验证码:统一按 email_hash + code_hash 匹配、写入 max_attempts、先校验状态再比对、超限提示与实际逻辑一致;失败计数统一由 verifyCodeWithAttempts 处理
  • 公开接口敏感配置:所有公开接口过滤 is_sensitive=1 或未标记为公开的配置项
  • 公告删除:同步清理关联的待发送邮件队列,避免无效任务堆积
  • 局部更新与 NOT NULL 字段:局部更新使用动态 SET,INSERT/REPLACE 补全全部 NOT NULL 字段,避免意外清空或静默写入失败
  • 权限一致性:标签、源、帖子、配置等资源的写操作统一在执行前校验权限
  • 计数与清理任务:补齐计数、统计与定时清理的调用方,避免死代码和永久堆积数据
  • 前端审计项:i18n 首次访问语言检测、管理端分页边界、重复请求与缓存失效等问题一并修复
  • 数据库迁移:INSERT OR IGNORE / 条件冲突更新替代无条件覆盖,避免级联操作清空用户自定义数据

优化

  • 首屏与请求:收藏 / 历史服务端分页、屏幕外面板懒加载、跨设备缓存校验,减少无效请求
  • 缓存:推荐画像 5 分钟、热度信号 1 小时、榜单与女优 6 小时,降低上游抓取压力
  • 搜索:档位配额与提示保持一致,搜索缓存键按用户隔离
  • 邮件:摘要合并、每日上限、退避重试与补发去重,降低 Resend 额度消耗与重复打扰
  • 通知:(user_id, dedup_key) 保证重复触发幂等;公告读时合并减少冗余写入
  • 社区浏览:24 小时去重表 + (user_id, post_id) 主键 upsert,避免高频刷浏览量
  • 文档与部署:README 与 docs/ 全面校准到 v1.6.0,部署文档支持全新库一次跑通;新增本 CHANGELOG 章节
  • CI:后端部署工作流固定 Node 20 + npm 缓存,类型检查与 lint 通过后才发布