Files
fanqie-go/internal/handlers/content.go
T
chenxin 1a4997e031 ✨ 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 签名说明,示例更新
2026-10-09 21:01:18 +08:00

165 lines
4.3 KiB
Go

package handlers
import (
"fanqie/internal/config"
"fanqie/internal/fqapi"
"fmt"
"net/http"
)
// HandleContent 内容处理
func HandleContent(w http.ResponseWriter, r *http.Request) {
incrementStat("total", "content")
w.Header().Set("Content-Type", "application/json; charset=utf-8")
params, err := validateParams(r, "item_id")
if err != nil {
respondError(w, err.Error(), true)
return
}
itemID := params["item_id"]
// 获取URL参数(支持动态覆盖配置;image_mode/review 兼容 README 的 img_mode/review_mode 别名)
textMode := r.URL.Query().Get("text_mode") // plain/1=纯文本, html/0=HTML
imageMode := getQueryWithAlias(r, "image_mode", "img_mode")
reviewParam := getQueryWithAlias(r, "review", "review_mode") // keep/1=启用段评, remove/0=禁用段评
result, err := fqapi.HandleGetContent(itemID, textMode, imageMode)
if err != nil {
respondError(w, "获取内容失败: "+err.Error(), false)
return
}
// 判断是否启用段评功能
// 优先使用URL参数,如果没有则使用配置文件
var enableReview bool
if reviewParam == "" {
// 没有URL参数时,使用配置文件
cfg := config.GetConfig()
if cfg != nil {
enableReview = cfg.Fanqie.Content.EnableReview
}
} else {
enableReview = fqapi.ParseBoolParam(reviewParam)
}
// 如果启用了段评功能,处理正文内容添加段评标记
if enableReview {
result = addReviewToContent(result, itemID, r)
}
fmt.Fprint(w, result)
}
// HandleMultiContent 批量内容处理
func HandleMultiContent(w http.ResponseWriter, r *http.Request) {
incrementStat("total", "content")
w.Header().Set("Content-Type", "application/json; charset=utf-8")
params, err := validateParams(r, "book_id", "item_ids")
if err != nil {
respondError(w, err.Error(), true)
return
}
textMode := r.URL.Query().Get("text_mode")
imageMode := getQueryWithAlias(r, "image_mode", "img_mode")
ignoreFailed := r.URL.Query().Get("ignore_failed")
result, err := fqapi.HandleMultiContent(params["item_ids"], params["book_id"], textMode, imageMode, ignoreFailed)
if err != nil {
respondError(w, "批量获取内容失败: "+err.Error(), false)
return
}
fmt.Fprint(w, result)
}
// HandleItemSummary 章节摘要处理
func HandleItemSummary(w http.ResponseWriter, r *http.Request) {
w.Header().Set("Content-Type", "application/json; charset=utf-8")
params, err := validateParams(r, "book_id", "item_ids")
if err != nil {
respondError(w, err.Error(), true)
return
}
result, err := fqapi.HandleItemSummary(params["item_ids"], params["book_id"])
if err != nil {
respondError(w, "获取章节摘要失败: "+err.Error(), false)
return
}
fmt.Fprint(w, result)
}
// addReviewToContent 为正文内容添加段评标记
func addReviewToContent(jsonResult, itemID string, r *http.Request) string {
// 解析 JSON 结果
var resultData map[string]interface{}
if err := fqapi.ParseJSON([]byte(jsonResult), &resultData); err != nil {
return jsonResult
}
// 获取 data 字段
data, ok := resultData["data"].(map[string]interface{})
if !ok {
return jsonResult
}
// 获取 content 字段
content, ok := data["content"].(string)
if !ok || content == "" {
return jsonResult
}
// 从响应数据中提取 book_id (data.novel_data.book_id)
bookID := ""
if novelData, ok := data["novel_data"].(map[string]interface{}); ok {
if bookIDVal, ok := novelData["book_id"].(string); ok {
bookID = bookIDVal
} else if bookIDVal, ok := novelData["book_id"].(float64); ok {
bookID = fmt.Sprintf("%.0f", bookIDVal)
}
}
// 获取基础 URL
cfg := config.GetConfig()
baseURL := ""
if cfg != nil {
host := cfg.Server.Host
if host == "0.0.0.0" {
host = "localhost"
}
port := cfg.Server.Port
scheme := "http"
// 检查是否来自外部请求
if r.Host != "" {
baseURL = scheme + "://" + r.Host
} else {
baseURL = scheme + "://" + host + ":" + port
}
}
// 生成带段评标记的内容
newContent, err := fqapi.GenerateParagraphsWithComments(itemID, bookID, content, baseURL)
if err != nil {
// 如果失败,返回原始内容
return jsonResult
}
// 替换 content 字段
data["content"] = newContent
resultData["data"] = data
// 重新序列化为 JSON
newJSON, err := fqapi.ToJSON(resultData)
if err != nil {
return jsonResult
}
return newJSON
}