✨ feat(api): 统一响应格式并完善参数体系与文档

- 正文参数支持语义值(plain/html/keep/remove)与别名(img_mode/review_mode)，URL 参数优先于配置
- 修复纯文本被段评强制包回 HTML、HTML 模式段评注入失效的问题
- 修复 PKCS7 填充弱校验导致漫画/正文偶发解密乱码返回 200 的问题
- 搜索结果展平：去 search_tabs 层与 selected_tab_idx/server_ab_params，提升 has_more/next_offset
- 全接口解包字符串形式的 JSON 字段(category_schema 等)，缓存出口幂等处理
- 序列化关闭 HTML 转义，video/audio 播放链接可直接复制播放
- video 响应透传 CENC 加密状态(key_seed/kid/encryption_method)
- 新增 gzip 中间件，JSON/文本响应压缩约 81%，二进制透传
- 漫画默认输出模式改为 proxy(url 模式链接 404 且内容加密不可用)
- openapi.yaml：补全 23 个路径参数定义、tab_type 完整枚举、CDN 签名说明，示例更新

internal/fqapi/content_utils.go

@@ -1,6 +1,7 @@
 package fqapi
 
 import (
+	"bytes"
 	"encoding/json"
 	"fanqie/internal/config"
 	"sort"
@@ -66,11 +67,16 @@ func removeBlankLines(content string) string {
 
 // ============ 参数解析工具函数 ============
 
-// parseBoolParam 解析布尔参数
-func parseBoolParam(param interface{}) bool {
+// ParseBoolParam 解析布尔参数，支持 1/0、true/false 及语义别名
+// text_mode: plain(纯文本)=true / html=false
+// image_mode、review: keep(保留/启用)=true / remove(移除/禁用)=false
+func ParseBoolParam(param interface{}) bool {
 	switch v := param.(type) {
 	case string:
-		return v == "true" || v == "1" || strings.ToLower(v) == "true"
+		switch strings.ToLower(v) {
+		case "1", "true", "plain", "keep":
+			return true
+		}
 	case bool:
 		return v
 	}
@@ -82,7 +88,7 @@ func parseBoolParamDefault(param interface{}, defaultVal bool) bool {
 	if param == nil || param == "" {
 		return defaultVal
 	}
-	return parseBoolParam(param)
+	return ParseBoolParam(param)
 }
 
 // ============ JSON 处理工具函数 ============
@@ -100,6 +106,78 @@ func buildJSONResponse(data interface{}) string {
 	return escapeJSON(string(resultBytes))
 }
 
+// marshalNoEscape 序列化 JSON 时不做 HTML 转义。
+// json.Marshal 默认把 URL 中的 & < > 转义为 & 等,直接从响应文本复制
+// URL 到浏览器会因字面转义序列打不开;含播放/下载链接的响应用本函数
+func marshalNoEscape(v interface{}) string {
+	var buf bytes.Buffer
+	enc := json.NewEncoder(&buf)
+	enc.SetEscapeHTML(false)
+	if err := enc.Encode(v); err != nil {
+		return "{}"
+	}
+	return strings.TrimSuffix(buf.String(), "\n")
+}
+
+// UnwrapJSONStrings 递归解包字符串形式的 JSON 值。上游常把对象/数组
+// 双重编码为字符串(如 category_schema: "[{\"category_id\":718,...}]"),
+// 本函数将其还原为真正的对象/数组。仅处理以 { 或 [ 开头且能完整解析
+// 为 object/array 的字符串,普通文本与数字字符串不受影响;嵌套解析使用
+// UseNumber,大整数 ID 不丢精度。
+func UnwrapJSONStrings(v interface{}) interface{} {
+	switch t := v.(type) {
+	case map[string]interface{}:
+		for k, val := range t {
+			t[k] = UnwrapJSONStrings(val)
+		}
+		return t
+	case []interface{}:
+		for i, val := range t {
+			t[i] = UnwrapJSONStrings(val)
+		}
+		return t
+	case []map[string]interface{}:
+		for i, val := range t {
+			t[i] = UnwrapJSONStrings(val).(map[string]interface{})
+		}
+		return t
+	case map[string]map[string]interface{}:
+		m := make(map[string]interface{}, len(t))
+		for k, val := range t {
+			m[k] = UnwrapJSONStrings(val)
+		}
+		return m
+	case string:
+		s := strings.TrimSpace(t)
+		if len(s) > 1 && (s[0] == '{' || s[0] == '[') {
+			dec := json.NewDecoder(strings.NewReader(s))
+			dec.UseNumber()
+			var parsed interface{}
+			if err := dec.Decode(&parsed); err == nil {
+				switch parsed.(type) {
+				case map[string]interface{}, []interface{}:
+					return UnwrapJSONStrings(parsed)
+				}
+			}
+		}
+		return t
+	default:
+		return v
+	}
+}
+
+// reencodeUnwrapped 解析上游响应文本,解包 JSON 字符串后重新序列化。
+// 解析失败时原样返回;UseNumber 保证大整数 ID 不丢精度
+func reencodeUnwrapped(text string) string {
+	dec := json.NewDecoder(strings.NewReader(text))
+	dec.UseNumber()
+	var v interface{}
+	if err := dec.Decode(&v); err != nil {
+		return text
+	}
+	return marshalNoEscape(UnwrapJSONStrings(v))
+}
+
 // ============ 设备和密钥管理 ============
 
 // getDeviceHeader 获取设备header（从设备池）