✨ feat(api): 新增榜单书架历史与搜索续传并重构正文缓存链路

- 新增 /rank 免签名榜单接口(多域名容错)、/bookshelf 与 /read-history(sessionid 登录态,书架支持分组过滤)
- 搜索重写:翻页透传上游 passback/search_id/next_offset/corrected_query 并按 book_id 去重,15~20 位纯数字关键词直查详情(ID 直搜)
- 删除 /login/check 登录校验端点(login.go、路由与文档同步移除,sessionid 说明改为直接供书架/历史使用)
- 正文链路重构:singleflight 合并同章节并发回源防击穿,缓存与解析解耦统一在出口处理,decodeContentBody 按 crypt_status 分支并兜底 500003 明文
- 缓存层:SQL 持久层 TTL 与业务 TTL 解耦(不可变内容过期后由 SQL 回填),动态短缓存只走 Redis,withCache 合并并发 miss
- 密钥池:KeyTs 随正文请求上传降低密钥不匹配重试,密钥超 24 小时异步刷新并防刷新风暴,last_used_at 批量落库
- 签名补 X-Helios(与 X-Ladon 同值,对齐书源实现);设备注册版本号统一走 ClientVersionCode/Name
- 分类 landing 透传新版标签 selected_items;multi-detail 批量详情供书架/历史复用
- README 与 openapi.yaml 补充新接口文档
This commit is contained in:
chenxin committed 2026-10-12 14:49:14 +08:00
1 parent 8ca372050b
commit 84bd3238ab
28 files changed
+1180 -270

No files matched your search

+32 -1
View File
@@ -3,6 +3,7 @@ package fqapi
import (
"fanqie/internal/common"
"fmt"
"sort"
"strings"
"sync"
)
@@ -108,11 +109,41 @@ func chunkArray(arr []string, size int) [][]string {
// HandleGetMultiDetail 处理批量获取书籍详情,详情数据基本不变,缓存 24 小时
func HandleGetMultiDetail(bookID interface{}) (string, error) {
return withCache(fmt.Sprintf("multi_detail_%v", bookID), 86400, func() (string, error) {
// 缓存 key 归一化:ID 排序去重,相同集合不同顺序共享缓存
ids := normalizeIDList(bookID)
if ids == "" {
return fetchMultiDetail(bookID)
}
return withCache("multi_detail_"+ids, 86400, func() (string, error) {
return fetchMultiDetail(bookID)
})
}
// normalizeIDList 将 book_id 参数归一化为排序去重后的逗号串
func normalizeIDList(bookID interface{}) string {
var list []string
switch v := bookID.(type) {
case string:
list = strings.Split(v, ",")
case []string:
list = v
default:
return ""
}
seen := make(map[string]bool, len(list))
out := make([]string, 0, len(list))
for _, id := range list {
id = strings.TrimSpace(id)
if id == "" || seen[id] {
continue
}
seen[id] = true
out = append(out, id)
}
sort.Strings(out)
return strings.Join(out, ",")
}
func fetchMultiDetail(bookID interface{}) (string, error) {
if bookID == nil {
return BuildErrorResponse("需要参数 book_id"), nil