Repository navigation
v1.6.0
[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 通过后才发布