Repository navigation
v1.5.0
[v1.5.0] - 2026-11-04
Added - 一体化工作台 + 三语国际化 + 榜单与推荐体系 🚀
本次版本跨度 50 次提交,核心变化:主页面重构为一体化工作台;前端完成 zh-CN / zh-TW / en 三语国际化;JAV 榜单升级为 JavDB 周榜 / 月榜并接入热点推荐;搜索限流改为账号活跃度阶梯配额;后端完成 repository 分层与统一 zod 校验;小说搜索切换为多源跳转;管理后台新增用户活跃度排行。
核心新功能(一):一体化搜索工作台
- 主页面重构:搜索、快捷入口、公告与结果区域整合为单一工作台(
Workbench+SearchDock+SearchWorkspace),统一五类搜索结果的页面骨架 - 统一结果组件:新增
MediaCard/ResourceRow/GroupedSection/Pagination/Toolbar等工作台组件,类别结果共享同一套布局与交互 - 常驻配额展示:搜索页常驻展示当前档位与剩余配额,并说明晋升规则
- 认证跳转:登录 / 注册成功后统一进入主搜索页,不再跳转看板
核心新功能(二):三语国际化(i18n)
- 全量文案提取:前端硬编码中文迁移到 i18n,覆盖 auth / home / layout / search / jav / feedback / community / dashboard / admin / ui 等 18 个命名空间、约 800+ key
- 三语支持:zh-CN、zh-TW、en 完整词条;首次访问按浏览器语言自动选择,用户手动选择持久化
- 组件与接口:新增
LanguageSwitcher与languageStore;非组件环境统一走i18next.t() - 补齐遗漏:搜索命名空间 65 个缺失 key、设置 / 公告 / 趋势 / 帖子详情等残余硬编码文案全部补齐
核心新功能(三):JAV 榜单升级(JavDB 周榜 / 月榜)
- 四通道导入:JavDB 有码 / 无码 × 周榜 / 月榜;GitHub Actions 每日抓取并导入
- 历史保留:榜单作品与来源不删除,当前榜单只展示每个周期最新
fetchedAt快照 - 每小时补全:最多 20 条 / 小时通过 JavBus 抓取演员、标签、发行商;失败 3 次后停止重试但保留活跃
- 导入接口:新增内部密钥保护的
/api/internal/rankings/import,榜单写入data_records占位与data_record_sources名次 - 探测与容错:新增 JavDB 榜单探测 workflow;CI 导入补充浏览器请求头并识别 Cloudflare 403
- 封面:榜单封面 CDN
tp.spfcas.com加入图片代理白名单
核心新功能(四):热门女优榜与智能推荐
- 热门女优榜:站内近 30 天收藏 / 搜索热度 + 周榜 / 月榜上榜作品聚合,移除 JavBus 随机女优列表
- 为你推荐:12 个推荐位,top 5 标签各 2 位、top 2 演员各 3 位,名额不足从高分候选随机补位
- 相关推荐:8 个推荐位(演员 4 + 标签 4),标签桶随机轮转,每个标签最多 1 位;展示在多源聚合结果之前
- 随机与缓存:推荐接口
Cache-Control: no-store,前端请求加时间戳,每次刷新重新随机 - 标签过滤:高画质 / 蓝光 / 字幕 / 单体 / 有码无码 / DMM·FANZA 独家等技术与发行标签不参与匹配
- 降级修复:修复推荐结果固定不变、演员配比错误、标签数量不足等问题
核心新功能(五):搜索限流档位化
- 数据库:
12_schema_search_tier.sql新增搜索限流档位字段,13_backfill_search_tier.sql回填存量用户 - 阶梯配额:按账号活跃度动态分配搜索配额,替代固定限流
- 晋升规则:近 30 天内活跃 5 天即可晋升,前端展示当前档位与配额
- 注册防护:注册接口按出口 IP 多级限流(5 / 分、10 / 时、20 / 天),超限 429 并写入安全事件;GitHub / Google OAuth 仅自动注册分支共用配额;IPv6 按 /64 聚合,
CF-Connecting-IP优先
核心新功能(六):小说搜索多源化
- 知轩藏书接入:新增
zxcs.zip明文 HTML 直链源,置顶顺序调整为 zxcs → 奇书网 → Anna's Archive - Anna 改为跳转:Anna's Archive 人机验证无法稳定抓取,移除
NovelItem抓取,保留为跳转卡片 - 多源跳转卡片:新增 Z-Library / Anna / 知轩藏书 / 奇书网 / SoBooks / Lunarora / PDFs.top / 读书派 8 个跳转源
- 结果面板:小说搜索复用数据库驱动多源卡片,独立展示
核心新功能(七):管理后台
- 用户活跃度排行:新增
/admin-panel/activity-ranking,支持今日 / 7 天 / 30 天 / 全部;加权分数(搜索 ×2、收藏 ×3、登录 ×1、其他 ×1),今日按北京时间自然日 - 社区统计修复:修正统计字段别名与用户详情重复计数
Improved - 架构与性能 ⚡
- SearchProvider 契约扩展:
SearchOptions→SearchContext(db / user / categoryId / subMode / enabledSources),新增injectsUserSources与buildHistoryEnrichment;JAV 三子模式与 Novel 多源注入下沉 Provider,search.ts由 761 行降至约 400 行,路由零内联 SQL - Repository 分层:新增
search-source/search-history/user/email-verification/community/admin/recommendationrepository,统一 SQL 查询 - 鉴权性能:
authMiddleware单次 LEFT JOIN 加载 session + role + permissions,每请求 D1 查库由 2~3 次降为 1 次;admin/superAdmin/permission中间件改读上下文 - 统一校验:请求体统一为 zod
validateBody,注册强制邮箱验证码;邮箱变更与注册使用同一套长度 / 规范化 / 可信域规则 - 用户态缓存:JAV / Novel 搜索缓存键按用户隔离,缓存命中仍补写搜索历史
- React Query 收敛:收藏、搜索历史、搜索源、分类、分析页数据域统一到 react-query,删除双轨 hooks
- 番号识别:新增前后端共享
jav-code宽识别解析器,非标准番号自动回退标题 / 多源搜索;搜索建议兼容带 / 不带横杠写法
Fixed - 问题修复 🔧
- 女优数据源:minnano-av 上线反爬导致资料恒空,切换 JavBus
/searchstar+/star;资料源失败与未匹配分开展示,不再静默留白 - 女优跳转代理:女优面板、作品区、详情链接统一遵守用户网址跳转代理配置
- JAV 详情重试:详情获取失败支持卡片内重试,无需重新搜索
- 收藏标题:收藏标题长度上限由 100 提升至 300
- 榜单补全:补全改为全量使用 JavBus 字段,仅缺失时回退原值
- 榜单导入:补充浏览器 UA / Accept 头并识别 Cloudflare 403
- 注册校验:验证码校验收口为无条件执行,移除路由内可选死分支
Changed - 行为变更 ⚠️
- Anna's Archive:从抓取源改为跳转源,小说结果结构改为多源卡片
- 推荐缓存:推荐结果不再缓存,每次请求实时随机
- 榜单展示:周榜 / 月榜仅展示最新快照,历史作品保留但不在当前榜单出现
- 版本号:全项目版本号统一为
1.5.0(前端常量、后端APP_VERSION、workspace 包、品牌页)
Technical Details
- 新增文件:
backend/src/repositories/— admin / community / email-verification / recommendation / search-history / search-source / user repositorybackend/src/routes/rankings.ts/recommend.ts— 榜单导入与推荐接口backend/src/services/ranking-*.ts/recommendation*.ts/hot-*.ts/actress-ranking.ts/tag-filter.ts/tag-frequency.ts/search-tier.tsdatabase/12_schema_search_tier.sql/database/13_backfill_search_tier.sql.github/workflows/javdb-ranking-daily.yml/javdb-ranking-probe.ymlscripts/rankings/javdb-to-atlas.mjsfrontend/src/components/workbench/*— 工作台组件frontend/src/components/search/SearchDock.tsx/SearchWorkspace.tsx/SearchQuotaBadge.tsxfrontend/src/components/jav/JavRecommendationsPanel.tsxfrontend/src/i18n/*— 三语词条与初始化frontend/src/pages/admin/ActivityRankingTab.tsxpackages/shared/src/utils/jav-code.ts
- 修改文件:
backend/src/routes/search.ts— 路由收缩至编排层backend/src/middleware/auth.ts— 单 JOIN 权限加载backend/src/validation/index.ts— zod schema 统一backend/src/routes/jav.ts/user.ts/community.ts/admin.ts— 接入 repositoryfrontend/src/pages/MainSearchPage.tsx— 一体化工作台frontend/src/hooks/useSearch.ts/useJavSearchFlow.ts— 搜索结果与子模式frontend/src/i18n/locales/*.json— 三语词条README.md/README.zh-CN.md/docs/*— 版本与文档同步backend/wrangler.toml—APP_VERSION升级至1.5.0