 chenxin
|
8bc6f5c2ae
|
🐛 fix(search): 按 tab_type 过滤搜索结果
- 上游 search/tab/v/ 固定返回所有 tab 的 search_tabs，此前原样转发导致传 tab_type 仍返回全部结果
- 新增 filterSearchTabs 只保留匹配项，无匹配时保留原样兜底
- 过滤路径用 UseNumber 解析重组，避免 19 位 book_id 经 float64 丢精度；解析失败退回原样转发
- 新增测试：过滤正确性、无匹配兜底、大整数精度保持
|
2026-09-29 23:54:27 +08:00 |
|
|
chenxin
|
bb0cc39950
|
📝 docs(readme): 同步近期改动并修正过时内容
- 补充 /healthz、protect_all 配置、错误响应规范（400/500/401）、缓存机制表
- 修正接口参数名与代码不符处：content 实为 item_id、multi-content 需 book_id、media 系列为 item_ids 等
- /vacuum 修正为 POST；技术栈删除已移除的 Gin，改为标准库 net/http
|
2026-09-29 23:52:10 +08:00 |
|
|
chenxin
|
586b714f3c
|
✨ feat(cache): 幂等只读接口接入缓存
- 新增 withCache 包装：命中直接返回，miss 回源后写入，仅缓存成功响应
- 详情/目录/批量详情/章节摘要缓存 24 小时；搜索/分类列表/分类详情短缓存 10 分钟
- 7 个 fqapi 处理函数原函数体不动、改名 fetchXxx，外层套缓存壳
- redisGetCache 补 3 秒读超时，与写路径一致，防远程 Redis 网络抖动拖垮请求
- 新增 TestWithCache：验证命中不回源、失败响应不缓存
|
2026-09-29 23:43:56 +08:00 |
|
|
chenxin
|
f0d89b462b
|
⚡️ perf(fqapi): 移除缓存层全局串行锁
- 删除 cache_manager/audio_proxy/device_key_pool 中 21 处 cacheMutex：database/sql 连接池本身并发安全，SQLite 已配 WAL + busy_timeout，PostgreSQL 无并发写限制
- contentRequestCount 三函数由互斥锁改为 atomic.Int64
- cache_manager 中 config.GetConfig() 改为 GetAppConfig()，消除配置未初始化时 log.Fatal 崩溃整个进程的隐患
- VACUUM 与写操作的低频并发冲突由 busy_timeout 兜底（已注释说明）
- 新增 TestConcurrentCacheAccess：8 goroutine 并发读写缓存，-race 验证无死锁无竞争
|
2026-09-29 23:21:10 +08:00 |
|
|
chenxin
|
24c7e4b6fd
|
🔒️ security(server): 业务接口保护开关与存活探针
- access_key 改用 subtle.ConstantTimeCompare 常量时间比较，防时序攻击
- 新增 server.protect_all 配置：开启后业务接口（/search、/content 等）也要求访问密钥
- 代理路由（/audio/proxy/、/manga/image/）不参与保护，其 URL 由服务端生成不含 key
- 新增 /healthz 存活探针（不校验密钥，供容器/反代使用）
- openapi.yaml 补 /healthz 定义，Unauthorized 描述说明 protect_all 行为
- 新增 3 个测试：保护开关放行、healthz、错误响应行为
|
2026-09-29 22:51:39 +08:00 |
|
|
chenxin
|
d1774a3902
|
🐛 fix(handlers): 统一错误响应为安全 JSON 并补参数校验
- 新增 respondError：JSON 安全编码，客户端错误返回 400，服务端错误返回 500
- 收编 book/content/media/category 中 13 处 fmt.Fprintf 内联 JSON，修复错误信息含引号/换行时产出非法 JSON 的问题
- search/detail/catalog/multi-detail/content/multi-content/item-summary/audio/video 补必需参数校验，缺参返回 400
- search 的 offset/tab_type 非数字时返回 400，不再静默置 0
- 补齐 multi-detail/multi-content 的请求统计计数
- 新增 error_response_test.go：3 个测试锁定错误响应行为
- openapi.yaml 新增 ServerError 响应组件，15 个业务接口补 400/500 响应定义
BREAKING CHANGE: 业务接口错误不再返回 HTTP 200，缺参返回 400，上游失败返回 500
|
2026-09-29 22:47:01 +08:00 |
|
|
chenxin
|
1eccebedf9
|
✨ feat(cache): 新增 Redis 缓存与 PostgreSQL 后端支持
- 新增 cache.redis 配置(独立 host/port/password/db 字段),启用后正文缓存与音频代理缓存走 Redis,键前缀 fq:cache:/fq:audio:,TTL 自动过期
- 新增 cache.backend: sqlite|postgres 切换,PG 连接用 net/url 构造 DSN,密码特殊字符自动转义;SQLite 顺手启用 WAL 与 busy_timeout
- SQL 方言收敛:q() 将 ? 占位符转换为 $n、INSERT OR IGNORE 与查询再插入统一为 ON CONFLICT、LastInsertId 改为 RETURNING id、建表 DDL 双版本分派
- PG 下 VACUUM 走 autovacuum 说明、状态页大小改查 pg_database_size
- 修复 PG 下设备保存失败:is_valid 列为 INTEGER,写入点补 boolToInt 转换
- 新增 .env 支持:敏感配置(密码/主机/访问密钥)由环境变量覆盖 config.yaml,.env 进 gitignore,仓库附 .env.example 模板
- 新增 openapi.yaml(OpenAPI 3.1):覆盖全部 24 个路径,含参数、响应结构与鉴权方案,README 增加指引
- 删除死代码 InitDevicePoolTable;新增 rebind_test.go 单测
- 更新 README 与 config.yaml 配置示例,go.mod 新增 go-redis/v9 与 pgx/v5 依赖
|
2026-09-29 20:33:37 +08:00 |
|
|
chenxin
|
d710d382ee
|
🐛 fix(server): 增加优雅退出与请求超时保护
- 新增 SIGINT/SIGTERM 信号处理与 http.Server.Shutdown,退出前确保统计数据保存、数据库正常关闭
- 为 http.Server 设置 ReadHeaderTimeout/ReadTimeout/WriteTimeout/IdleTimeout,防止慢客户端长期占用连接
- 全局配置指针改为 atomic.Pointer 并提供 GetAppConfig 访问器,消除配置热更新时的数据竞争,同时删除冗余的 manager.config 字段
- 请求统计九组计数器重构为 map[string]*atomic.Int64,统一 incrementStat/getStatsSnapshot 访问,精简约 40 行样板代码
- go mod tidy 清理 go.mod 与 go.sum 中的冗余依赖条目
|
2026-09-29 19:47:04 +08:00 |
|
|
chenxin
|
6981148727
|
🔧 chore: 初始化番茄小说 API 项目结构
新增项目基础框架，包含核心 API 实现、算法模块、HTTP 处理器等完整功能模块
|
2026-08-28 15:22:22 +08:00 |
|