update: details

Feat seo

.github/workflows/release.yml

@@ -1,5 +1,9 @@
 name: Release
 
+permissions:
+  contents: write
+  packages: read
+  id-token: write
 on:
   push:
     tags:
@@ -55,4 +59,4 @@ jobs:
         files: |
           urldb-${{ github.ref_name }}-linux-amd64
           frontend-${{ github.ref_name }}.tar.gz
-        generate_release_notes: true
+        generate_release_notes: true

ChangeLog.md

@@ -1,10 +1,21 @@
-### v1.2.6
-1. 支持迅雷云盘
-2. 优化热播剧采集和页面显示
-3. 首页添加标签显示
-4. 后端 UI 优化
-5. 新增 Telegram Bot
-6. 新增扩容
+### v1.3.3
+1. 公众号自动回复
+
+### v1.3.2
+1. 二维码美化
+2. TelegramBot参数调整
+3. 修复一些问题
+
+### v1.3.1
+1. 添加API访问日志
+2. 添加首页公告
+3. TG机器人，添加资源选择模式
+
+### v1.3.0
+1. 新增 Telegram Bot
+2. 新增扩容
+3. 支持迅雷云盘
+4. UI优化
 
 ### v1.2.5
 1. 修复一些Bug

README.md

@@ -10,6 +10,10 @@
 
 **一个现代化的网盘资源数据库，支持多网盘自动化转存分享，支持百度网盘，阿里云盘，夸克网盘， 天翼云盘，迅雷云盘，123云盘，115网盘，UC网盘 **
 
+免费电报资源频道： [@xypan](https://t.me/xypan)  自动推送资源
+
+免费电报资源机器人:  [@L9ResBot](https://t.me/L9ResBot)  发送 搜索 + 名字 可搜索资源  
+
 🌐 [在线演示](https://pan.l9.lc) | 📖 [文档](https://ecn5khs4t956.feishu.cn/wiki/PsnDwtxghiP0mLkTiruczKtxnwd?from=from_copylink) | 🐛 [问题反馈](https://github.com/ctwj/urldb/issues) | ⭐ [给个星标](https://github.com/ctwj/urldb)
 
 ### 支持的网盘平台
@@ -34,23 +38,21 @@
 - [文档说明](https://ecn5khs4t956.feishu.cn/wiki/PsnDwtxghiP0mLkTiruczKtxnwd?from=from_copylink)
 - [服务器要求](https://ecn5khs4t956.feishu.cn/wiki/W8YBww1Mmiu4Cdkp5W4c8pFNnMf?from=from_copylink) 
 - [QQ机器人](https://github.com/ctwj/astrbot_plugin_urldb) 
+- [Telegram机器人](https://ecn5khs4t956.feishu.cn/wiki/SwkQw6AzRiFes7kxJXac3pd2ncb?from=from_copylink)
+- [微信公众号自动回复](https://ecn5khs4t956.feishu.cn/wiki/APOEwOyDYicKGHk7gTzcQKpynkf?from=from_copylink)
 
-### v1.2.5
-1. 修复一些Bug
+### v1.3.3
+1. 新增公众号自动回复
+2. 修复一些问题
 
-### v1.2.4
-
-1. 搜索增强，毫秒级响应，关键字高亮显示
-2. 修复版本显示不正确的问题
-3. 配置项新增Meilisearch配置
 
 [详细改动记录](https://github.com/ctwj/urldb/blob/main/ChangeLog.md) 
 
 当前特性
 1. 支持API，手动批量录入资源
 2. 支持，自动判断资源有效性
-3. 支持自动转存（Quark）
-4. 支持平台多账号管理（Quark）
+3. 支持自动转存
+4. 支持平台多账号管理
 5. 支持简单的数据统计
 6. 支持Meilisearch
 
@@ -121,17 +123,12 @@ PORT=8080
 
 # 时区配置
 TIMEZONE=Asia/Shanghai
-```
-
-### 镜像构建
 
+# 日志配置
+LOG_LEVEL=INFO          # 日志级别 (DEBUG, INFO, WARN, ERROR, FATAL)
+DEBUG=false             # 调试模式开关
+STRUCTURED_LOG=false    # 结构化日志开关 (JSON格式)
 ```
-docker build -t ctwj/urldb-frontend:1.0.7 --target frontend .
-docker build -t ctwj/urldb-backend:1.0.7 --target backend .
-docker push ctwj/urldb-frontend:1.0.7
-docker push ctwj/urldb-backend:1.0.7
-```
-
 ---
 
 ## 📄 许可证
@@ -151,11 +148,8 @@ docker push ctwj/urldb-backend:1.0.7
 
 ---
 
-## 📞 联系我们
-
-- **项目地址**: [https://github.com/ctwj/urldb](https://github.com/ctwj/urldb)
-- **问题反馈**: [Issues](https://github.com/ctwj/urldb/issues)
-- **邮箱**: 510199617@qq.com
+## 📞 交流群
+- **TG**: [Telegram 技术交流群](https://t.me/+QF9OMpOv-PBjZGEx)
 
 ---
 

VERSION

@@ -1 +1 @@
-1.3.0
+1.3.4

common/xunlei_credentials.go

@@ -0,0 +1,39 @@
+package pan
+
+import "encoding/json"
+
+// XunleiAccountCredentials 迅雷账号凭据结构
+type XunleiAccountCredentials struct {
+	Username     string `json:"username"`     // 手机号（不包含+86前缀）
+	Password     string `json:"password"`     // 密码
+	RefreshToken string `json:"refresh_token"` // 当前有效的refresh_token
+}
+
+// ParseCredentialsFromCk 从ck字段解析账号凭据
+func ParseCredentialsFromCk(ck string) (*XunleiAccountCredentials, error) {
+	var credentials XunleiAccountCredentials
+	if err := json.Unmarshal([]byte(ck), &credentials); err != nil {
+		return nil, err
+	}
+	return &credentials, nil
+}
+
+// IsAccountCredentials 检查ck是否包含账号密码信息
+func IsAccountCredentials(ck string) bool {
+	var credentials map[string]interface{}
+	if err := json.Unmarshal([]byte(ck), &credentials); err != nil {
+		return false
+	}
+	_, hasUsername := credentials["username"]
+	_, hasPassword := credentials["password"]
+	return hasUsername && hasPassword
+}
+
+// ToJsonString 转换为JSON字符串
+func (c *XunleiAccountCredentials) ToJsonString() (string, error) {
+	data, err := json.Marshal(c)
+	if err != nil {
+		return "", err
+	}
+	return string(data), nil
+}

common/xunlei_login.go

@@ -0,0 +1,232 @@
+package pan
+
+import (
+	"bytes"
+	"crypto/md5"
+	"encoding/hex"
+	"encoding/json"
+	"fmt"
+	"io/ioutil"
+	"log"
+	"net/http"
+	"strings"
+	"time"
+)
+
+// 新增常量定义
+const (
+	XLUSER_CLIENT_ID = "XW5SkOhLDjnOZP7J" // 登录
+	PAN_CLIENT_ID    = "Xqp0kJBXWhwaTpB6" // 获取文件列表
+	CLIENT_SECRET    = "Og9Vr1L8Ee6bh0olFxFDRg"
+	CLIENT_VERSION   = "1.92.9" // 更新为与xunlei_3项目相同的版本
+	PACKAG_ENAME     = "pan.xunlei.com"
+)
+
+var SALTS = []string{
+	"QG3/GhopO+5+T",
+	"1Sv94+ANND3lDmmw",
+	"q2eTxRva8b3B5d",
+	"m2",
+	"VIc5CZRBMU71ENfbOh0+RgWIuzLy",
+	"66M8Wpw6nkBEekOtL6e",
+	"N0rucK7S8W/vrRkfPto5urIJJS8dVY0S",
+	"oLAR7pdUVUAp9xcuHWzrU057aUhdCJrt",
+	"6lxcykBSsfI//GR9",
+	"r50cz+1I4gbU/fk8",
+	"tdwzrTc4SNFC4marNGTgf05flC85A",
+	"qvNVUDFjfsOMqvdi2gB8gCvtaJAIqxXs",
+}
+
+// captchaSign 生成验证码签名 - 完全复制自xunlei_3项目
+func (x *XunleiPanService) captchaSign(clientId string, deviceID string, timestamp string) string {
+	sign := clientId + CLIENT_VERSION + PACKAG_ENAME + deviceID + timestamp
+	log.Printf("urldb 签名基础字符串: %s", sign)
+	for _, salt := range SALTS { // salt =
+		hash := md5.Sum([]byte(sign + salt))
+		sign = hex.EncodeToString(hash[:])
+	}
+	log.Printf("urldb 最终签名: 1.%s", sign)
+	return fmt.Sprintf("1.%s", sign)
+}
+
+// getTimestamp 获取当前时间戳
+func (x *XunleiPanService) getTimestamp() int64 {
+	return time.Now().UnixMilli()
+}
+
+// LoginWithCredentials 使用账号密码登录
+func (x *XunleiPanService) LoginWithCredentials(username, password string) (XunleiTokenData, error) {
+	loginURL := "https://xluser-ssl.xunlei.com/v1/auth/signin"
+
+	// 初始化验证码 - 完全模仿xunlei_3的CaptchaInit方法
+	captchaURL := "https://xluser-ssl.xunlei.com/v1/shield/captcha/init"
+
+	// 构造meta参数（完全模仿xunlei_3，只包含phone_number）
+	meta := map[string]interface{}{
+		"phone_number": "+86" + username,
+	}
+
+	// 构造验证码请求（完全模仿xunlei_3）
+	captchaBody := map[string]interface{}{
+		"client_id": XLUSER_CLIENT_ID,
+		"action":    "POST:/v1/auth/signin",
+		"device_id": x.deviceId,
+		"meta":      meta,
+	}
+
+	log.Printf("发送验证码初始化请求: %+v", captchaBody)
+	resp, err := x.sendCaptchaRequest(captchaURL, captchaBody)
+	if err != nil {
+		return XunleiTokenData{}, fmt.Errorf("获取验证码失败: %v", err)
+	}
+
+	if resp["captcha_token"] == nil {
+		return XunleiTokenData{}, fmt.Errorf("获取验证码失败: 响应中没有captcha_token")
+	}
+
+	captchaToken, ok := resp["captcha_token"].(string)
+	if !ok {
+		return XunleiTokenData{}, fmt.Errorf("获取验证码失败: captcha_token格式错误")
+	}
+	log.Printf("成功获取captcha_token: %s", captchaToken)
+
+	// 构造登录请求数据
+	loginData := map[string]interface{}{
+		"client_id":     XLUSER_CLIENT_ID,
+		"client_secret": CLIENT_SECRET,
+		"password":      password,
+		"username":      "+86 " + username,
+		"captcha_token": captchaToken,
+	}
+
+	// 发送登录请求
+	userInfo, err := x.sendCaptchaRequest(loginURL, loginData)
+	if err != nil {
+		return XunleiTokenData{}, fmt.Errorf("登录请求失败: %v", err)
+	}
+
+	// 提取token信息
+	accessToken, ok := userInfo["access_token"].(string)
+	if !ok {
+		return XunleiTokenData{}, fmt.Errorf("登录响应中没有access_token")
+	}
+
+	refreshToken, ok := userInfo["refresh_token"].(string)
+	if !ok {
+		return XunleiTokenData{}, fmt.Errorf("登录响应中没有refresh_token")
+	}
+
+	sub, ok := userInfo["sub"].(string)
+	if !ok {
+		sub = ""
+	}
+
+	// 计算过期时间
+	expiresIn := int64(3600) // 默认1小时
+	if exp, ok := userInfo["expires_in"].(float64); ok {
+		expiresIn = int64(exp)
+	}
+	expiresAt := time.Now().Unix() + expiresIn - 60 // 减去60秒缓冲
+
+	log.Printf("登录成功，获取到token")
+	return XunleiTokenData{
+		AccessToken:  accessToken,
+		RefreshToken: refreshToken,
+		ExpiresIn:    expiresIn,
+		ExpiresAt:    expiresAt,
+		Sub:          sub,
+		TokenType:    "Bearer",
+		UserId:       sub,
+	}, nil
+}
+
+// sendCaptchaRequest 发送验证码请求 - 完全复制xunlei_3的sendRequest实现
+func (x *XunleiPanService) sendCaptchaRequest(url string, data map[string]interface{}) (map[string]interface{}, error) {
+	jsonData, err := json.Marshal(data)
+	if err != nil {
+		return nil, err
+	}
+
+	log.Printf("发送验证码请求URL: %s", url)
+	log.Printf("发送验证码请求数据: %s", string(jsonData))
+
+	req, err := http.NewRequest("POST", url, bytes.NewBuffer(jsonData))
+	if err != nil {
+		return nil, err
+	}
+
+	// 完全复制xunlei_3的请求头设置
+	reqHeaders := x.getHeadersForRequest(nil)
+	// 添加特定的headers
+	reqHeaders["Content-Type"] = "application/x-www-form-urlencoded"
+	reqHeaders["User-Agent"] = "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/91.0.4472.124 Safari/537.36"
+
+	for k, v := range reqHeaders {
+		req.Header.Set(k, v)
+	}
+
+	// 根据URL确定使用哪个client_id
+	if strings.Contains(url, "shield/captcha/init") {
+		// 对于验证码初始化，如果数据中指定了client_id，则使用该client_id
+		if clientID, ok := data["client_id"].(string); ok {
+			req.Header.Set("X-Client-Id", clientID)
+		} else {
+			// 默认使用PAN_CLIENT_ID用于API相关的验证码
+			req.Header.Set("X-Client-Id", PAN_CLIENT_ID)
+		}
+	} else if strings.Contains(url, "auth/") {
+		// 对于认证相关的请求，使用登录相关的client_id
+		req.Header.Set("X-Client-Id", XLUSER_CLIENT_ID)
+	} else {
+		// 对于一般的API请求，使用PAN_CLIENT_ID
+		req.Header.Set("X-Client-Id", PAN_CLIENT_ID)
+	}
+
+	client := &http.Client{Timeout: 10 * time.Second}
+	resp, err := client.Do(req)
+	if err != nil {
+		return nil, err
+	}
+	defer resp.Body.Close()
+
+	body, err := ioutil.ReadAll(resp.Body)
+	if err != nil {
+		return nil, err
+	}
+
+	log.Printf("验证码响应状态码: %d", resp.StatusCode)
+	log.Printf("验证码响应内容: %s", string(body))
+
+	var result map[string]interface{}
+	if err := json.Unmarshal(body, &result); err != nil {
+		return nil, fmt.Errorf("JSON 解析失败: %v, raw: %s", err, string(body))
+	}
+
+	log.Printf("解析后的响应: %+v", result)
+	return result, nil
+}
+
+// getHeadersForRequest 获取请求头
+func (x *XunleiPanService) getHeadersForRequest(accessToken *string) map[string]string {
+	headers := map[string]string{
+		"Content-Type": "application/json; charset=utf-8",
+	}
+
+	// 这里我们简化处理，因为验证码请求不需要这些
+	// if x.CaptchaToken != nil {
+	// 	headers["User-Agent"] = x.buildCustomUserAgent()
+	// 	headers["X-Captcha-Token"] = *x.CaptchaToken
+	// } else {
+	headers["User-Agent"] = "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/126.0.0.0 Safari/537.36"
+	// }
+
+	// if accessToken != nil {
+	// 	headers["Authorization"] = fmt.Sprintf("Bearer %s", *accessToken)
+	// }
+
+	// if x.DeviceID != "" {
+	// 	headers["X-Device-Id"] = x.DeviceID
+	// }
+
+	return headers
+}

common/xunlei_pan.bak

@@ -0,0 +1,897 @@
+package pan
+
+import (
+	"encoding/json"
+	"fmt"
+	"log"
+	"net/http"
+	"strconv"
+	"strings"
+	"sync"
+	"time"
+
+	"github.com/ctwj/urldb/db/entity"
+	"github.com/ctwj/urldb/db/repo"
+)
+
+// CaptchaData 存储在数据库中的验证码令牌数据
+type CaptchaData struct {
+	CaptchaToken string `json:"captcha_token"`
+	ExpiresAt    int64  `json:"expires_at"`
+}
+
+// XunleiExtraData 所有额外数据的容器
+type XunleiTokenData struct {
+	AccessToken  string `json:"access_token"`
+	RefreshToken string `json:"refresh_token"`
+	ExpiresIn    int64  `json:"expires_in"`
+	ExpiresAt    int64  `json:"expires_at"`
+	Sub          string `json:"sub"`
+	TokenType    string `json:"token_type"`
+	UserId       string `json:"user_id"`
+}
+
+type XunleiExtraData struct {
+	Captcha *CaptchaData
+	Token   *XunleiTokenData
+}
+
+type XunleiPanService struct {
+	*BasePanService
+	configMutex sync.RWMutex
+	clientId    string
+	deviceId    string
+	entity      entity.Cks
+	cksRepo     repo.CksRepository
+	extra       XunleiExtraData // 需要保存到数据库的token信息
+}
+
+// 配置化 API Host
+func (x *XunleiPanService) apiHost(apiType string) string {
+	if apiType == "user" {
+		return "https://xluser-ssl.xunlei.com"
+	}
+	return "https://api-pan.xunlei.com"
+}
+
+func (x *XunleiPanService) setCommonHeader(req *http.Request) {
+	for k, v := range x.headers {
+		req.Header.Set(k, v)
+	}
+}
+
+// NewXunleiPanService 创建迅雷网盘服务
+func NewXunleiPanService(config *PanConfig) *XunleiPanService {
+	xunleiInstance := &XunleiPanService{
+		BasePanService: NewBasePanService(config),
+		clientId:       "Xqp0kJBXWhwaTpB6",
+		deviceId:       "925b7631473a13716b791d7f28289cad",
+		extra:          XunleiExtraData{}, // Initialize extra with zero values
+	}
+	xunleiInstance.SetHeaders(map[string]string{
+		"Accept":             "*/;",
+		"Accept-Encoding":    "deflate",
+		"Accept-Language":    "zh-CN,zh;q=0.9",
+		"Cache-Control":      "no-cache",
+		"Content-Type":       "application/json",
+		"Origin":             "https://pan.xunlei.com",
+		"Pragma":             "no-cache",
+		"Priority":           "u=1,i",
+		"Referer":            "https://pan.xunlei.com/",
+		"sec-ch-ua":          `"Not;A=Brand";v="99", "Google Chrome";v="139", "Chromium";v="139"`,
+		"sec-ch-ua-mobile":   "?0",
+		"sec-ch-ua-platform": `"Windows"`,
+		"sec-fetch-dest":     "empty",
+		"sec-fetch-mode":     "cors",
+		"sec-fetch-site":     "same-site",
+		"User-Agent":         "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/139.0.0.0 Safari/537.36",
+		"Authorization":      "",
+		"x-captcha-token":    "",
+		"x-client-id":        xunleiInstance.clientId,
+		"x-device-id":        xunleiInstance.deviceId,
+	})
+
+	xunleiInstance.UpdateConfig(config)
+	return xunleiInstance
+}
+
+// SetCKSRepository 设置 CksRepository 和 entity
+func (x *XunleiPanService) SetCKSRepository(cksRepo repo.CksRepository, entity entity.Cks) {
+	x.cksRepo = cksRepo
+	x.entity = entity
+	var extra XunleiExtraData
+	if err := json.Unmarshal([]byte(x.entity.Extra), &extra); err != nil {
+		log.Printf("解析 extra 数据失败: %v，使用空数据", err)
+	}
+	x.extra = extra
+}
+
+// GetXunleiInstance 获取迅雷网盘服务单例实例
+func GetXunleiInstance() *XunleiPanService {
+	return NewXunleiPanService(nil)
+}
+
+func (x *XunleiPanService) GetAccessTokenByRefreshToken(refreshToken string) (XunleiTokenData, error) {
+	// 构造请求体
+	body := map[string]interface{}{
+		"client_id":     x.clientId,
+		"grant_type":    "refresh_token",
+		"refresh_token": refreshToken,
+	}
+
+	// 过滤 headers（移除 Authorization 和 x-captcha-token）
+	filteredHeaders := make(map[string]string)
+	for k, v := range x.headers {
+		if k != "Authorization" && k != "x-captcha-token" {
+			filteredHeaders[k] = v
+		}
+	}
+
+	// 调用 API 获取新的 token
+	resp, err := x.requestXunleiApi("https://xluser-ssl.xunlei.com/v1/auth/token", "POST", body, nil, filteredHeaders)
+	if err != nil {
+		return XunleiTokenData{}, fmt.Errorf("获取 access_token 请求失败: %v", err)
+	}
+
+	// 正确做法：用 exists 判断
+	if _, exists := resp["access_token"]; exists {
+		// 会输出，即使值为 nil
+	} else {
+		return XunleiTokenData{}, fmt.Errorf("获取 access_token 请求失败: %v 不存在", "access_token")
+	}
+
+	// 计算过期时间（当前时间 + expires_in - 60 秒缓冲）
+	currentTime := time.Now().Unix()
+	expiresAt := currentTime + int64(resp["expires_in"].(float64)) - 60
+	resp["expires_at"] = expiresAt
+	jsonBytes, _ := json.Marshal(resp)
+
+	var result XunleiTokenData
+	json.Unmarshal(jsonBytes, &result)
+	return result, nil
+}
+
+// getAccessToken 获取 Access Token（内部包含缓存判断、刷新、保存）- 匹配 PHP 版本
+func (x *XunleiPanService) getAccessToken() (string, error) {
+	// 检查 Access Token 是否有效
+	currentTime := time.Now().Unix()
+	if x.extra.Token != nil && x.extra.Token.AccessToken != "" && x.extra.Token.ExpiresAt > currentTime {
+		return x.extra.Token.AccessToken, nil
+	}
+	newData, err := x.GetAccessTokenByRefreshToken(x.extra.Token.RefreshToken)
+	if err != nil {
+		return "", fmt.Errorf("获取 access_token 失败: %v", err)
+	}
+
+	x.extra.Token.AccessToken = newData.AccessToken
+	x.extra.Token.ExpiresAt = newData.ExpiresAt
+
+	// 保存到数据库
+	extraBytes, err := json.Marshal(x.extra)
+	if err != nil {
+		return "", fmt.Errorf("序列化 extra 数据失败: %v", err)
+	}
+	x.entity.Extra = string(extraBytes)
+	if err := x.cksRepo.UpdateWithAllFields(&x.entity); err != nil {
+		return "", fmt.Errorf("保存 access_token 到数据库失败: %v", err)
+	}
+	return newData.AccessToken, nil
+}
+
+// getCaptchaToken 获取 captcha_token - 匹配 PHP 版本
+func (x *XunleiPanService) getCaptchaToken() (string, error) {
+	// 检查 Captcha Token 是否有效
+	currentTime := time.Now().Unix()
+	if x.extra.Captcha != nil && x.extra.Captcha.CaptchaToken != "" && x.extra.Captcha.ExpiresAt > currentTime {
+		return x.extra.Captcha.CaptchaToken, nil
+	}
+
+	// 构造请求体
+	body := map[string]interface{}{
+		"client_id": x.clientId,
+		"action":    "get:/drive/v1/share",
+		"device_id": x.deviceId,
+		"meta": map[string]interface{}{
+			"username":       "",
+			"phone_number":   "",
+			"email":          "",
+			"package_name":   "pan.xunlei.com",
+			"client_version": "1.45.0",
+			"captcha_sign":   "1.fe2108ad808a74c9ac0243309242726c",
+			"timestamp":      "1645241033384",
+			"user_id":        "0",
+		},
+	}
+
+	captchaHeaders := map[string]string{
+		"Content-Type": "application/json",
+		"User-Agent":   "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/91.0.4472.124 Safari/537.36",
+	}
+
+	// 调用 API 获取 captcha_token
+	resp, err := x.requestXunleiApi("https://xluser-ssl.xunlei.com/v1/shield/captcha/init", "POST", body, nil, captchaHeaders)
+	if err != nil {
+		return "", fmt.Errorf("获取 captcha_token 请求失败: %v", err)
+	}
+
+	if resp["captcha_token"] != nil && resp["captcha_token"] != "" {
+		//
+	} else {
+		return "", fmt.Errorf("获取 captcha_token 失败: %v", resp)
+	}
+
+	// 计算过期时间（当前时间 + expires_in - 10 秒缓冲）
+	expiresAt := currentTime + int64(resp["expires_in"].(float64)) - 10
+
+	// 更新 extra 数据
+	if x.extra.Captcha == nil {
+		x.extra.Captcha = &CaptchaData{}
+	}
+	x.extra.Captcha.CaptchaToken = resp["captcha_token"].(string)
+	x.extra.Captcha.ExpiresAt = expiresAt
+
+	// 保存到数据库
+	extraBytes, err := json.Marshal(x.extra)
+	if err != nil {
+		return "", fmt.Errorf("序列化 extra 数据失败: %v", err)
+	}
+	x.entity.Extra = string(extraBytes)
+	if err := x.cksRepo.UpdateWithAllFields(&x.entity); err != nil {
+		return "", fmt.Errorf("保存 captcha_token 到数据库失败: %v", err)
+	}
+
+	return resp["captcha_token"].(string), nil
+}
+
+// requestXunleiApi 迅雷 API 通用请求方法 - 使用 BasePanService 方法
+func (x *XunleiPanService) requestXunleiApi(url string, method string, data map[string]interface{}, queryParams map[string]string, headers map[string]string) (map[string]interface{}, error) {
+	var respData []byte
+	var err error
+
+	// 先更新当前请求的 headers
+	originalHeaders := make(map[string]string)
+	for k, v := range x.headers {
+		originalHeaders[k] = v
+	}
+
+	// 临时设置请求的 headers
+	for k, v := range headers {
+		x.SetHeader(k, v)
+	}
+	defer func() {
+		// 恢复原始 headers
+		for k, v := range originalHeaders {
+			x.SetHeader(k, v)
+		}
+	}()
+
+	// 根据方法调用相应的 BasePanService 方法
+	if method == "GET" {
+		respData, err = x.HTTPGet(url, queryParams)
+	} else if method == "POST" {
+		respData, err = x.HTTPPost(url, data, queryParams)
+	} else {
+		return nil, fmt.Errorf("不支持的HTTP方法: %s", method)
+	}
+
+	if err != nil {
+		return nil, err
+	}
+
+	var result map[string]interface{}
+	if err := json.Unmarshal(respData, &result); err != nil {
+		return nil, fmt.Errorf("JSON 解析失败: %v, raw: %s", err, string(respData))
+	}
+
+	return result, nil
+}
+
+func (x *XunleiPanService) UpdateConfig(config *PanConfig) {
+	if config == nil {
+		return
+	}
+	x.configMutex.Lock()
+	defer x.configMutex.Unlock()
+	x.config = config
+	if config.Cookie != "" {
+		x.SetHeader("Cookie", config.Cookie)
+	}
+}
+
+// GetServiceType 获取服务类型
+func (x *XunleiPanService) GetServiceType() ServiceType {
+	return Xunlei
+}
+
+func extractCode(url string) string {
+	// 查找 pwd= 的位置
+	if pwdIndex := strings.Index(url, "pwd="); pwdIndex != -1 {
+		code := url[pwdIndex+4:]
+		// 移除 # 及后面的内容（如果存在）
+		if hashIndex := strings.Index(code, "#"); hashIndex != -1 {
+			code = code[:hashIndex]
+		}
+		return code
+	}
+	return ""
+}
+
+// Transfer 转存分享链接 - 实现 PanService 接口，匹配 XunleiPan.php 的逻辑
+func (x *XunleiPanService) Transfer(shareID string) (*TransferResult, error) {
+	// 读取配置（线程安全）
+	x.configMutex.RLock()
+	config := x.config
+	x.configMutex.RUnlock()
+
+	log.Printf("开始处理迅雷分享: %s", shareID)
+
+	// 1️⃣ 获取 AccessToken 和 CaptchaToken
+	accessToken, err := x.getAccessToken()
+	if err != nil {
+		return ErrorResult(fmt.Sprintf("获取accessToken失败: %v", err)), nil
+	}
+
+	captchaToken, err := x.getCaptchaToken()
+	if err != nil {
+		return ErrorResult(fmt.Sprintf("获取captchaToken失败: %v", err)), nil
+	}
+
+	// 转存模式：实现完整的转存流程
+	thisCode := extractCode(config.URL)
+
+	// 获取分享详情
+	shareDetail, err := x.getShare(shareID, thisCode, accessToken, captchaToken)
+	if err != nil {
+		return ErrorResult(fmt.Sprintf("获取分享详情失败: %v", err)), nil
+	}
+	if shareDetail["share_status"].(string) != "OK" {
+		return ErrorResult(fmt.Sprintf("获取分享详情失败: %v", "分享状态异常")), nil
+	}
+	if shareDetail["file_num"].(string) == "0" {
+		return ErrorResult(fmt.Sprintf("获取分享详情失败: %v", "文件列表为空")), nil
+	}
+
+	parent_id := "" // 默认存储路径
+
+	// 检查是否为检验模式
+	if config.IsType == 1 {
+		// 检验模式：直接获取分享信息
+		urls := map[string]interface{}{
+			"title":     shareDetail["title"],
+			"share_url": config.URL,
+			"stoken":    "",
+		}
+		return SuccessResult("检验成功", urls), nil
+	}
+
+	// files := shareDetail["files"].([]interface{})
+	// fileIDs := make([]string, 0)
+	// for _, file := range files {
+	// 	fileMap := file.(map[string]interface{})
+	// 	if fid, ok := fileMap["id"].(string); ok {
+	// 		fileIDs = append(fileIDs, fid)
+	// 	}
+	// }
+
+	// 处理广告过滤（这里简化处理）
+	// TODO: 添加广告文件过滤逻辑
+
+	// 转存资源
+	restoreResult, err := x.getRestore(shareID, shareDetail, accessToken, captchaToken, parent_id)
+	if err != nil {
+		return ErrorResult(fmt.Sprintf("转存失败: %v", err)), nil
+	}
+
+	// 获取转存任务信息
+	taskID := restoreResult["restore_task_id"].(string)
+
+	// 等待转存完成
+	taskResp, err := x.waitForTask(taskID, accessToken, captchaToken)
+	if err != nil {
+		return ErrorResult(fmt.Sprintf("等待转存完成失败: %v", err)), nil
+	}
+
+	// 获取任务结果以获取文件ID
+	existingFileIds := make([]string, 0)
+	if params, ok2 := taskResp["params"].(map[string]interface{}); ok2 {
+		if traceIds, ok3 := params["trace_file_ids"].(string); ok3 {
+			traceData := make(map[string]interface{})
+			json.Unmarshal([]byte(traceIds), &traceData)
+			for _, fid := range traceData {
+				existingFileIds = append(existingFileIds, fid.(string))
+			}
+		}
+	}
+
+	// 创建分享链接
+	expirationDays := "-1"
+	if config.ExpiredType == 2 {
+		expirationDays = "2"
+	}
+
+	// 根据share_id获取到分享链接
+	shareResult, err := x.getSharePassword(existingFileIds, accessToken, captchaToken, expirationDays)
+	if err != nil {
+		return ErrorResult(fmt.Sprintf("创建分享链接失败: %v", err)), nil
+	}
+
+	var fid string
+	if len(existingFileIds) > 1 {
+		fid = strings.Join(existingFileIds, ",")
+	} else {
+		fid = existingFileIds[0]
+	}
+
+	result := map[string]interface{}{
+		"title":    "",
+		"shareUrl": shareResult["share_url"].(string) + "?pwd=" + shareResult["pass_code"].(string),
+		"code":     shareResult["pass_code"].(string),
+		"fid":      fid,
+	}
+
+	return SuccessResult("转存成功", result), nil
+}
+
+// waitForTask 等待任务完成 - 使用 HTTPGet 方法
+func (x *XunleiPanService) waitForTask(taskID string, accessToken, captchaToken string) (map[string]interface{}, error) {
+	maxRetries := 50
+	retryDelay := 2 * time.Second
+
+	for retryIndex := 0; retryIndex < maxRetries; retryIndex++ {
+		result, err := x.getTaskStatus(taskID, retryIndex, accessToken, captchaToken)
+		if err != nil {
+			return nil, err
+		}
+
+		if int64(result["progress"].(float64)) == 100 { // 任务完成
+			return result, nil
+		}
+
+		time.Sleep(retryDelay)
+	}
+
+	return nil, fmt.Errorf("任务超时")
+}
+
+// getTaskStatus 获取任务状态 - 使用 HTTPGet 方法
+func (x *XunleiPanService) getTaskStatus(taskID string, retryIndex int, accessToken, captchaToken string) (map[string]interface{}, error) {
+	apiURL := x.apiHost("") + "/drive/v1/tasks/" + taskID
+	queryParams := map[string]string{}
+
+	// 设置 request 所需的 headers
+	headers := map[string]string{
+		"Authorization":   "Bearer " + accessToken,
+		"x-captcha-token": captchaToken,
+	}
+
+	resp, err := x.requestXunleiApi(apiURL, "GET", nil, queryParams, headers)
+	if err != nil {
+		return nil, err
+	}
+	return resp, nil
+}
+
+// GetUserInfoByEntity 根据 entity.Cks 获取用户信息（待实现）
+func (x *XunleiPanService) GetUserInfoByEntity(cks entity.Cks) (*UserInfo, error) {
+	return nil, nil
+}
+
+// getShare 获取分享详情 - 匹配 PHP 版本
+func (x *XunleiPanService) getShare(shareID, passCode, accessToken, captchaToken string) (map[string]interface{}, error) {
+	// 设置 headers
+	headers := make(map[string]string)
+	for k, v := range x.headers {
+		headers[k] = v
+	}
+	headers["Authorization"] = "Bearer " + accessToken
+	headers["x-captcha-token"] = captchaToken
+
+	queryParams := map[string]string{
+		"share_id":        shareID,
+		"pass_code":       passCode,
+		"limit":           "100",
+		"pass_code_token": "",
+		"page_token":      "",
+		"thumbnail_size":  "SIZE_SMALL",
+	}
+
+	return x.requestXunleiApi("https://api-pan.xunlei.com/drive/v1/share", "GET", nil, queryParams, headers)
+}
+
+// getRestore 转存到网盘 - 匹配 PHP 版本
+func (x *XunleiPanService) getRestore(shareID string, infoData map[string]interface{}, accessToken, captchaToken, parentID string) (map[string]interface{}, error) {
+	ids := make([]string, 0)
+	if files, ok := infoData["files"].([]interface{}); ok {
+		for _, file := range files {
+			if fileMap, ok2 := file.(map[string]interface{}); ok2 {
+				if id, ok3 := fileMap["id"].(string); ok3 {
+					ids = append(ids, id)
+				}
+			}
+		}
+	}
+
+	passCodeToken := ""
+	if token, ok := infoData["pass_code_token"]; ok {
+		if tokenStr, ok2 := token.(string); ok2 {
+			passCodeToken = tokenStr
+		}
+	}
+
+	data := map[string]interface{}{
+		"parent_id":         parentID,
+		"share_id":          shareID,
+		"pass_code_token":   passCodeToken,
+		"ancestor_ids":      []string{},
+		"specify_parent_id": true,
+		"file_ids":          ids,
+	}
+
+	headers := make(map[string]string)
+	for k, v := range x.headers {
+		headers[k] = v
+	}
+	headers["Authorization"] = "Bearer " + accessToken
+	headers["x-captcha-token"] = captchaToken
+
+	return x.requestXunleiApi("https://api-pan.xunlei.com/drive/v1/share/restore", "POST", data, nil, headers)
+}
+
+// getTasks 获取转存任务状态 - 匹配 PHP 版本
+func (x *XunleiPanService) getTasks(taskID, accessToken, captchaToken string) (map[string]interface{}, error) {
+	headers := make(map[string]string)
+	for k, v := range x.headers {
+		headers[k] = v
+	}
+	headers["Authorization"] = "Bearer " + accessToken
+	headers["x-captcha-token"] = captchaToken
+
+	return x.requestXunleiApi("https://api-pan.xunlei.com/drive/v1/tasks/"+taskID, "GET", nil, nil, headers)
+}
+
+// getSharePassword 创建分享链接 - 匹配 PHP 版本
+func (x *XunleiPanService) getSharePassword(fileIDs []string, accessToken, captchaToken, expirationDays string) (map[string]interface{}, error) {
+	data := map[string]interface{}{
+		"file_ids": fileIDs,
+		"share_to": "copy",
+		"params": map[string]interface{}{
+			"subscribe_push":     "false",
+			"WithPassCodeInLink": "true",
+		},
+		"title":           "云盘资源分享",
+		"restore_limit":   "-1",
+		"expiration_days": expirationDays,
+	}
+
+	headers := make(map[string]string)
+	for k, v := range x.headers {
+		headers[k] = v
+	}
+	headers["Authorization"] = "Bearer " + accessToken
+	headers["x-captcha-token"] = captchaToken
+
+	return x.requestXunleiApi("https://api-pan.xunlei.com/drive/v1/share", "POST", data, nil, headers)
+}
+
+// getShareInfo 获取分享信息（用于检验模式）
+func (x *XunleiPanService) getShareInfo(shareID string) (*XLShareInfo, error) {
+	// 使用现有的 GetShareFolder 方法获取分享信息
+	shareDetail, err := x.GetShareFolder(shareID, "", "")
+	if err != nil {
+		return nil, err
+	}
+
+	// 构造分享信息
+	shareInfo := &XLShareInfo{
+		ShareID: shareID,
+		Title:   fmt.Sprintf("迅雷分享_%s", shareID),
+		Files:   make([]XLFileInfo, 0),
+	}
+
+	// 处理文件信息
+	for _, file := range shareDetail.Data.Files {
+		shareInfo.Files = append(shareInfo.Files, XLFileInfo{
+			FileID: file.FileID,
+			Name:   file.Name,
+		})
+	}
+
+	return shareInfo, nil
+}
+
+// GetFiles 获取文件列表 - 匹配 PHP 版本接口调用
+func (x *XunleiPanService) GetFiles(pdirFid string) (*TransferResult, error) {
+	log.Printf("开始获取迅雷网盘文件列表，目录ID: %s", pdirFid)
+
+	// 获取 tokens
+	accessToken, err := x.getAccessToken()
+	if err != nil {
+		return ErrorResult(fmt.Sprintf("获取accessToken失败: %v", err)), nil
+	}
+
+	captchaToken, err := x.getCaptchaToken()
+	if err != nil {
+		return ErrorResult(fmt.Sprintf("获取captchaToken失败: %v", err)), nil
+	}
+
+	// 设置 headers
+	headers := make(map[string]string)
+	for k, v := range x.headers {
+		headers[k] = v
+	}
+	headers["Authorization"] = "Bearer " + accessToken
+	headers["x-captcha-token"] = captchaToken
+
+	filters := map[string]interface{}{
+		"phase": map[string]interface{}{
+			"eq": "PHASE_TYPE_COMPLETE",
+		},
+		"trashed": map[string]interface{}{
+			"eq": false,
+		},
+	}
+
+	filtersStr, _ := json.Marshal(filters)
+	queryParams := map[string]string{
+		"parent_id":      pdirFid,
+		"filters":        string(filtersStr),
+		"with_audit":     "true",
+		"thumbnail_size": "SIZE_SMALL",
+		"limit":          "50",
+	}
+
+	result, err := x.requestXunleiApi("https://api-pan.xunlei.com/drive/v1/files", "GET", nil, queryParams, headers)
+	if err != nil {
+		return ErrorResult(fmt.Sprintf("获取文件列表失败: %v", err)), nil
+	}
+
+	if code, ok := result["code"].(float64); ok && code != 0 {
+		return ErrorResult("获取文件列表失败"), nil
+	}
+
+	if data, ok := result["data"].(map[string]interface{}); ok {
+		if files, ok2 := data["files"]; ok2 {
+			return SuccessResult("获取成功", files), nil
+		}
+	}
+
+	return SuccessResult("获取成功", []interface{}{}), nil
+}
+
+// DeleteFiles 删除文件 - 实现 PanService 接口
+func (x *XunleiPanService) DeleteFiles(fileList []string) (*TransferResult, error) {
+	log.Printf("开始删除迅雷网盘文件，文件数量: %d", len(fileList))
+
+	// 使用现有的 ShareBatchDelete 方法删除分享
+	result, err := x.ShareBatchDelete(fileList)
+	if err != nil {
+		return ErrorResult(fmt.Sprintf("删除文件失败: %v", err)), nil
+	}
+
+	if result.Code != 0 {
+		return ErrorResult(fmt.Sprintf("删除文件失败: %s", result.Msg)), nil
+	}
+
+	return SuccessResult("删除成功", nil), nil
+}
+
+// GetUserInfo 获取用户信息 - 实现 PanService 接口，cookie 参数为 refresh_token，先获取 access_token 再访问 API
+func (x *XunleiPanService) GetUserInfo(cookie *string) (*UserInfo, error) {
+	userInfo := &UserInfo{}
+	accessToken, err := x.getAccessToken()
+	if err != nil {
+		return nil, err
+	}
+
+	captchaToken, err := x.getCaptchaToken()
+	if err != nil {
+		return nil, err
+	}
+
+	headers := make(map[string]string)
+	for k, v := range x.headers {
+		headers[k] = v
+	}
+	headers["Authorization"] = "Bearer " + accessToken
+	headers["x-captcha-token"] = captchaToken
+
+	resp, err := x.requestXunleiApi("https://api-pan.xunlei.com/drive/v1/about", "GET", nil, nil, headers)
+	if err != nil {
+		return nil, fmt.Errorf("获取用户信息失败: %v", err)
+	}
+	limit := resp["quota"].(map[string]interface{})["limit"].(string)
+	limitInt, _ := strconv.ParseInt(limit, 10, 64)
+	used := resp["quota"].(map[string]interface{})["usage"].(string)
+	usedInt, _ := strconv.ParseInt(used, 10, 64)
+	userInfo.TotalSpace = limitInt
+	userInfo.UsedSpace = usedInt
+
+	// 获取用户信息
+	respData, err := x.requestXunleiApi(x.apiHost("user")+"/v1/user/me", "GET", nil, nil, headers)
+	if err != nil {
+		return nil, fmt.Errorf("获取用户信息失败: %v", err)
+	}
+
+	vipInfo := respData["vip_info"].([]interface{})
+	isVip := vipInfo[0].(map[string]interface{})["is_vip"].(string) != "0"
+
+	userInfo.Username = respData["name"].(string)
+	userInfo.ServiceType = x.GetServiceType().String()
+	userInfo.VIPStatus = isVip
+	return userInfo, nil
+}
+
+// GetShareList 严格对齐 GET + query（使用 BasePanService）
+func (x *XunleiPanService) GetShareList(pageToken string) (*XLShareListResp, error) {
+	api := x.apiHost("") + "/drive/v1/share/list"
+	queryParams := map[string]string{
+		"limit":          "100",
+		"thumbnail_size": "SIZE_SMALL",
+	}
+	if pageToken != "" {
+		queryParams["page_token"] = pageToken
+	}
+
+	respData, err := x.HTTPGet(api, queryParams)
+	if err != nil {
+		return nil, fmt.Errorf("获取分享列表失败: %v", err)
+	}
+
+	var data XLShareListResp
+	if err := json.Unmarshal(respData, &data); err != nil {
+		return nil, fmt.Errorf("解析分享列表失败: %v", err)
+	}
+	return &data, nil
+}
+
+// FileBatchShare 创建分享（使用 BasePanService）
+func (x *XunleiPanService) FileBatchShare(ids []string, needPassword bool, expirationDays int) (*XLBatchShareResp, error) {
+	apiURL := x.apiHost("") + "/drive/v1/share/batch"
+	body := map[string]interface{}{
+		"file_ids":        ids,
+		"need_password":   needPassword,
+		"expiration_days": expirationDays,
+	}
+
+	respData, err := x.HTTPPost(apiURL, body, nil)
+	if err != nil {
+		return nil, fmt.Errorf("创建分享失败: %v", err)
+	}
+
+	var data XLBatchShareResp
+	if err := json.Unmarshal(respData, &data); err != nil {
+		return nil, fmt.Errorf("解析分享响应失败: %v", err)
+	}
+	return &data, nil
+}
+
+// ShareBatchDelete 取消分享（使用 BasePanService）
+func (x *XunleiPanService) ShareBatchDelete(ids []string) (*XLCommonResp, error) {
+	apiURL := x.apiHost("") + "/drive/v1/share/batch/delete"
+	body := map[string]interface{}{
+		"share_ids": ids,
+	}
+
+	respData, err := x.HTTPPost(apiURL, body, nil)
+	if err != nil {
+		return nil, fmt.Errorf("删除分享失败: %v", err)
+	}
+
+	var data XLCommonResp
+	if err := json.Unmarshal(respData, &data); err != nil {
+		return nil, fmt.Errorf("解析删除响应失败: %v", err)
+	}
+	return &data, nil
+}
+
+// GetShareFolder 获取分享内容（使用 BasePanService）
+func (x *XunleiPanService) GetShareFolder(shareID, passCodeToken, parentID string) (*XLShareFolderResp, error) {
+	apiURL := x.apiHost("") + "/drive/v1/share/detail"
+	body := map[string]interface{}{
+		"share_id":        shareID,
+		"pass_code_token": passCodeToken,
+		"parent_id":       parentID,
+		"limit":           100,
+		"thumbnail_size":  "SIZE_LARGE",
+		"order":           "6",
+	}
+
+	respData, err := x.HTTPPost(apiURL, body, nil)
+	if err != nil {
+		return nil, fmt.Errorf("获取分享文件夹失败: %v", err)
+	}
+
+	var data XLShareFolderResp
+	if err := json.Unmarshal(respData, &data); err != nil {
+		return nil, fmt.Errorf("解析分享文件夹失败: %v", err)
+	}
+	return &data, nil
+}
+
+// Restore 转存（使用 BasePanService）
+func (x *XunleiPanService) Restore(shareID, passCodeToken string, fileIDs []string) (*XLRestoreResp, error) {
+	apiURL := x.apiHost("") + "/drive/v1/share/restore"
+	body := map[string]interface{}{
+		"share_id":          shareID,
+		"pass_code_token":   passCodeToken,
+		"file_ids":          fileIDs,
+		"folder_type":       "NORMAL",
+		"specify_parent_id": true,
+		"parent_id":         "",
+	}
+
+	respData, err := x.HTTPPost(apiURL, body, nil)
+	if err != nil {
+		return nil, fmt.Errorf("转存失败: %v", err)
+	}
+
+	var data XLRestoreResp
+	if err := json.Unmarshal(respData, &data); err != nil {
+		return nil, fmt.Errorf("解析转存响应失败: %v", err)
+	}
+	return &data, nil
+}
+
+// 结构体完全对齐 xunleix
+type XLShareListResp struct {
+	Data struct {
+		List []struct {
+			ShareID string `json:"share_id"`
+			Title   string `json:"title"`
+		} `json:"list"`
+	} `json:"data"`
+	Code int    `json:"code"`
+	Msg  string `json:"msg"`
+}
+
+type XLBatchShareResp struct {
+	Data struct {
+		ShareURL string `json:"share_url"`
+	} `json:"data"`
+	Code int    `json:"code"`
+	Msg  string `json:"msg"`
+}
+
+type XLCommonResp struct {
+	Code int    `json:"code"`
+	Msg  string `json:"msg"`
+}
+
+type XLShareFolderResp struct {
+	Data struct {
+		Files []struct {
+			FileID string `json:"file_id"`
+			Name   string `json:"name"`
+		} `json:"files"`
+	} `json:"data"`
+	Code int    `json:"code"`
+	Msg  string `json:"msg"`
+}
+
+type XLRestoreResp struct {
+	Data struct {
+		TaskID string `json:"task_id"`
+	} `json:"data"`
+	Code int    `json:"code"`
+	Msg  string `json:"msg"`
+}
+
+// 新增辅助结构体
+type XLShareInfo struct {
+	ShareID string       `json:"share_id"`
+	Title   string       `json:"title"`
+	Files   []XLFileInfo `json:"files"`
+}
+
+type XLFileInfo struct {
+	FileID string `json:"file_id"`
+	Name   string `json:"name"`
+}
+
+type XLTaskResult struct {
+	Status int    `json:"status"`
+	TaskID string `json:"task_id"`
+	Data   struct {
+		ShareID string `json:"share_id"`
+	} `json:"data"`
+}

common/xunlei_pan.go

@@ -3,6 +3,7 @@ package pan
 import (
 	"encoding/json"
 	"fmt"
+	"io/ioutil"
 	"log"
 	"net/http"
 	"strconv"
@@ -32,8 +33,9 @@ type XunleiTokenData struct {
 }
 
 type XunleiExtraData struct {
-	Captcha *CaptchaData
-	Token   *XunleiTokenData
+	Captcha     *CaptchaData              `json:"captcha,omitempty"`
+	Token       *XunleiTokenData          `json:"token,omitempty"`
+	Credentials *XunleiAccountCredentials `json:"credentials,omitempty"` // 账号密码信息
 }
 
 type XunleiPanService struct {
@@ -100,9 +102,19 @@ func (x *XunleiPanService) SetCKSRepository(cksRepo repo.CksRepository, entity e
 	x.cksRepo = cksRepo
 	x.entity = entity
 	var extra XunleiExtraData
-	if err := json.Unmarshal([]byte(x.entity.Extra), &extra); err != nil {
-		log.Printf("解析 extra 数据失败: %v，使用空数据", err)
+
+	// 解析extra字段
+	if x.entity.Extra != "" {
+		if err := json.Unmarshal([]byte(x.entity.Extra), &extra); err != nil {
+			log.Printf("解析 extra 数据失败: %v", err)
+		}
 	}
+
+	// 从ck字段解析账号密码
+	if credentials, err := ParseCredentialsFromCk(x.entity.Ck); err == nil {
+		extra.Credentials = credentials
+	}
+
 	x.extra = extra
 }
 
@@ -151,20 +163,66 @@ func (x *XunleiPanService) GetAccessTokenByRefreshToken(refreshToken string) (Xu
 	return result, nil
 }
 
-// getAccessToken 获取 Access Token（内部包含缓存判断、刷新、保存）- 匹配 PHP 版本
+// reloginWithCredentials 使用账号密码重新登录
+func (x *XunleiPanService) reloginWithCredentials() (XunleiTokenData, error) {
+	if x.extra.Credentials == nil {
+		return XunleiTokenData{}, fmt.Errorf("无账号密码信息")
+	}
+
+	tokenData, err := x.LoginWithCredentials(x.extra.Credentials.Username, x.extra.Credentials.Password)
+	if err != nil {
+		return XunleiTokenData{}, fmt.Errorf("账号密码登录失败: %v", err)
+	}
+
+	log.Printf("账号 %s 重新登录成功", x.extra.Credentials.Username)
+	return tokenData, nil
+}
+
+// getAccessToken 获取 Access Token（内部包含缓存判断、刷新、重新登录、保存）
 func (x *XunleiPanService) getAccessToken() (string, error) {
 	// 检查 Access Token 是否有效
 	currentTime := time.Now().Unix()
 	if x.extra.Token != nil && x.extra.Token.AccessToken != "" && x.extra.Token.ExpiresAt > currentTime {
 		return x.extra.Token.AccessToken, nil
 	}
-	newData, err := x.GetAccessTokenByRefreshToken(x.extra.Token.RefreshToken)
-	if err != nil {
-		return "", fmt.Errorf("获取 access_token 失败: %v", err)
+
+	// 尝试使用refresh_token刷新
+	var newData XunleiTokenData
+	var err error
+
+	if x.extra.Token != nil && x.extra.Token.RefreshToken != "" {
+		newData, err = x.GetAccessTokenByRefreshToken(x.extra.Token.RefreshToken)
+		if err != nil {
+			log.Printf("refresh_token刷新失败: %v，尝试使用账号密码重新登录", err)
+
+			// 如果refresh_token失效且有账号密码信息，尝试重新登录
+			if x.extra.Credentials != nil && x.extra.Credentials.Username != "" && x.extra.Credentials.Password != "" {
+				newData, err = x.reloginWithCredentials()
+				if err != nil {
+					return "", fmt.Errorf("重新登录失败: %v", err)
+				}
+			} else {
+				return "", fmt.Errorf("refresh_token失效且无账号密码信息，无法重新登录: %v", err)
+			}
+		}
+	} else {
+		return "", fmt.Errorf("无有效的refresh_token")
 	}
 
+	// 更新token信息
+	if x.extra.Token == nil {
+		x.extra.Token = &XunleiTokenData{}
+	}
 	x.extra.Token.AccessToken = newData.AccessToken
+	x.extra.Token.RefreshToken = newData.RefreshToken
 	x.extra.Token.ExpiresAt = newData.ExpiresAt
+	x.extra.Token.ExpiresIn = newData.ExpiresIn
+	x.extra.Token.Sub = newData.Sub
+	x.extra.Token.TokenType = newData.TokenType
+	x.extra.Token.UserId = newData.UserId
+
+	// 更新ck字段中的refresh_token（保持向后兼容）
+	x.entity.Ck = newData.RefreshToken
 
 	// 保存到数据库
 	extraBytes, err := json.Marshal(x.extra)
@@ -175,6 +233,7 @@ func (x *XunleiPanService) getAccessToken() (string, error) {
 	if err := x.cksRepo.UpdateWithAllFields(&x.entity); err != nil {
 		return "", fmt.Errorf("保存 access_token 到数据库失败: %v", err)
 	}
+
 	return newData.AccessToken, nil
 }
 
@@ -248,6 +307,12 @@ func (x *XunleiPanService) requestXunleiApi(url string, method string, data map[
 	var respData []byte
 	var err error
 
+	// 检查是否是验证码初始化请求
+	if strings.Contains(url, "shield/captcha/init") {
+		// 对于验证码初始化，直接发送HTTP请求，不使用BasePanService，使用sendCaptchaRequestForGeneralAPI
+		return x.sendCaptchaRequestForGeneralAPI(url, data)
+	}
+
 	// 先更新当前请求的 headers
 	originalHeaders := make(map[string]string)
 	for k, v := range x.headers {
@@ -832,6 +897,51 @@ func (x *XunleiPanService) Restore(shareID, passCodeToken string, fileIDs []stri
 	return &data, nil
 }
 
+// sendCaptchaRequestForGeneralAPI 发送验证码请求 - 用于非登录场景的验证码请求
+func (x *XunleiPanService) sendCaptchaRequestForGeneralAPI(url string, data map[string]interface{}) (map[string]interface{}, error) {
+	jsonData, err := json.Marshal(data)
+	if err != nil {
+		return nil, err
+	}
+
+	log.Printf("发送验证码请求URL: %s", url)
+	log.Printf("发送验证码请求数据: %s", string(jsonData))
+
+	req, err := http.NewRequest("POST", url, strings.NewReader(string(jsonData)))
+	if err != nil {
+		return nil, err
+	}
+
+	// 设置请求头
+	req.Header.Set("Content-Type", "application/json")
+	req.Header.Set("User-Agent", "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/91.0.4472.124 Safari/537.36")
+	req.Header.Set("X-Client-Id", x.clientId)
+	req.Header.Set("X-Device-Id", x.deviceId)
+
+	client := &http.Client{Timeout: 10 * time.Second}
+	resp, err := client.Do(req)
+	if err != nil {
+		return nil, err
+	}
+	defer resp.Body.Close()
+
+	body, err := ioutil.ReadAll(resp.Body)
+	if err != nil {
+		return nil, err
+	}
+
+	log.Printf("验证码响应状态码: %d", resp.StatusCode)
+	log.Printf("验证码响应内容: %s", string(body))
+
+	var result map[string]interface{}
+	if err := json.Unmarshal(body, &result); err != nil {
+		return nil, fmt.Errorf("JSON 解析失败: %v, raw: %s", err, string(body))
+	}
+
+	log.Printf("解析后的响应: %+v", result)
+	return result, nil
+}
+
 // 结构体完全对齐 xunleix
 type XLShareListResp struct {
 	Data struct {
@@ -894,4 +1004,4 @@ type XLTaskResult struct {
 	Data   struct {
 		ShareID string `json:"share_id"`
 	} `json:"data"`
-}
+}

config/config.go

@@ -0,0 +1,676 @@
+package config
+
+import (
+	"encoding/json"
+	"fmt"
+	"os"
+	"strconv"
+	"strings"
+	"sync"
+	"time"
+
+	"github.com/ctwj/urldb/db/entity"
+	"github.com/ctwj/urldb/db/repo"
+	"github.com/ctwj/urldb/utils"
+)
+
+// ConfigManager 统一配置管理器
+type ConfigManager struct {
+	repo *repo.RepositoryManager
+
+	// 内存缓存
+	cache      map[string]*ConfigItem
+	cacheMutex sync.RWMutex
+	cacheOnce  sync.Once
+
+	// 配置更新通知
+	configUpdateCh chan string
+	watchers       []chan string
+	watcherMutex   sync.Mutex
+
+	// 加载时间
+	lastLoadTime time.Time
+}
+
+// ConfigItem 配置项结构
+type ConfigItem struct {
+	Key        string      `json:"key"`
+	Value      string      `json:"value"`
+	Type       string      `json:"type"`
+	UpdatedAt  time.Time   `json:"updated_at"`
+	Group      string      `json:"group"`    // 配置分组
+	Category   string      `json:"category"` // 配置分类
+	IsSensitive bool      `json:"is_sensitive"` // 是否是敏感信息
+}
+
+// ConfigGroup 配置分组
+type ConfigGroup string
+
+const (
+	GroupDatabase   ConfigGroup = "database"
+	GroupServer     ConfigGroup = "server"
+	GroupSecurity   ConfigGroup = "security"
+	GroupSearch     ConfigGroup = "search"
+	GroupTelegram   ConfigGroup = "telegram"
+	GroupCache      ConfigGroup = "cache"
+	GroupMeilisearch ConfigGroup = "meilisearch"
+	GroupSEO        ConfigGroup = "seo"
+	GroupAutoProcess ConfigGroup = "auto_process"
+	GroupOther      ConfigGroup = "other"
+)
+
+// NewConfigManager 创建配置管理器
+func NewConfigManager(repoManager *repo.RepositoryManager) *ConfigManager {
+	cm := &ConfigManager{
+		repo:           repoManager,
+		cache:          make(map[string]*ConfigItem),
+		configUpdateCh: make(chan string, 100), // 缓冲通道防止阻塞
+	}
+
+	// 启动配置更新监听器
+	go cm.startConfigUpdateListener()
+
+	return cm
+}
+
+// startConfigUpdateListener 启动配置更新监听器
+func (cm *ConfigManager) startConfigUpdateListener() {
+	for key := range cm.configUpdateCh {
+		cm.notifyWatchers(key)
+	}
+}
+
+// notifyWatchers 通知所有监听器配置已更新
+func (cm *ConfigManager) notifyWatchers(key string) {
+	cm.watcherMutex.Lock()
+	defer cm.watcherMutex.Unlock()
+
+	for _, watcher := range cm.watchers {
+		select {
+		case watcher <- key:
+		default:
+			// 如果通道阻塞，跳过该监听器
+			utils.Warn("配置监听器通道阻塞，跳过通知: %s", key)
+		}
+	}
+}
+
+// AddConfigWatcher 添加配置变更监听器
+func (cm *ConfigManager) AddConfigWatcher() chan string {
+	cm.watcherMutex.Lock()
+	defer cm.watcherMutex.Unlock()
+
+	watcher := make(chan string, 10) // 为每个监听器创建缓冲通道
+	cm.watchers = append(cm.watchers, watcher)
+	return watcher
+}
+
+// GetConfig 获取配置项
+func (cm *ConfigManager) GetConfig(key string) (*ConfigItem, error) {
+	// 先尝试从内存缓存获取
+	item, exists := cm.getCachedConfig(key)
+	if exists {
+		return item, nil
+	}
+
+	// 如果缓存中没有，从数据库获取
+	config, err := cm.repo.SystemConfigRepository.FindByKey(key)
+	if err != nil {
+		return nil, err
+	}
+
+	// 将数据库配置转换为ConfigItem并缓存
+	item = &ConfigItem{
+		Key:       config.Key,
+		Value:     config.Value,
+		Type:      config.Type,
+		UpdatedAt: time.Now(),
+	}
+
+	if group := cm.getGroupByConfigKey(key); group != "" {
+		item.Group = string(group)
+	}
+
+	if category := cm.getCategoryByConfigKey(key); category != "" {
+		item.Category = category
+	}
+
+	item.IsSensitive = cm.isSensitiveConfig(key)
+
+	// 缓存配置
+	cm.setCachedConfig(key, item)
+
+	return item, nil
+}
+
+// GetConfigValue 获取配置值
+func (cm *ConfigManager) GetConfigValue(key string) (string, error) {
+	item, err := cm.GetConfig(key)
+	if err != nil {
+		return "", err
+	}
+	return item.Value, nil
+}
+
+// GetConfigBool 获取布尔值配置
+func (cm *ConfigManager) GetConfigBool(key string) (bool, error) {
+	value, err := cm.GetConfigValue(key)
+	if err != nil {
+		return false, err
+	}
+
+	switch strings.ToLower(value) {
+	case "true", "1", "yes", "on":
+		return true, nil
+	case "false", "0", "no", "off", "":
+		return false, nil
+	default:
+		return false, fmt.Errorf("无法将配置值 '%s' 转换为布尔值", value)
+	}
+}
+
+// GetConfigInt 获取整数值配置
+func (cm *ConfigManager) GetConfigInt(key string) (int, error) {
+	value, err := cm.GetConfigValue(key)
+	if err != nil {
+		return 0, err
+	}
+
+	return strconv.Atoi(value)
+}
+
+// GetConfigInt64 获取64位整数值配置
+func (cm *ConfigManager) GetConfigInt64(key string) (int64, error) {
+	value, err := cm.GetConfigValue(key)
+	if err != nil {
+		return 0, err
+	}
+
+	return strconv.ParseInt(value, 10, 64)
+}
+
+// GetConfigFloat64 获取浮点数配置
+func (cm *ConfigManager) GetConfigFloat64(key string) (float64, error) {
+	value, err := cm.GetConfigValue(key)
+	if err != nil {
+		return 0, err
+	}
+
+	return strconv.ParseFloat(value, 64)
+}
+
+// SetConfig 设置配置值
+func (cm *ConfigManager) SetConfig(key, value string) error {
+	// 更新数据库
+	config := &entity.SystemConfig{
+		Key:   key,
+		Value: value,
+		Type:  "string", // 默认类型，实际类型应该从现有配置中获取
+	}
+
+	// 获取现有配置以确定类型
+	existing, err := cm.repo.SystemConfigRepository.FindByKey(key)
+	if err == nil {
+		config.Type = existing.Type
+	} else {
+		// 如果配置不存在，尝试从默认配置中获取类型
+		config.Type = cm.getDefaultConfigType(key)
+	}
+
+	// 保存到数据库
+	err = cm.repo.SystemConfigRepository.UpsertConfigs([]entity.SystemConfig{*config})
+	if err != nil {
+		return fmt.Errorf("保存配置失败: %v", err)
+	}
+
+	// 更新缓存
+	item := &ConfigItem{
+		Key:       config.Key,
+		Value:     config.Value,
+		Type:      config.Type,
+		UpdatedAt: time.Now(),
+	}
+
+	if group := cm.getGroupByConfigKey(key); group != "" {
+		item.Group = string(group)
+	}
+
+	if category := cm.getCategoryByConfigKey(key); category != "" {
+		item.Category = category
+	}
+
+	item.IsSensitive = cm.isSensitiveConfig(key)
+
+	cm.setCachedConfig(key, item)
+
+	// 发送更新通知
+	cm.configUpdateCh <- key
+
+	utils.Info("配置已更新: %s = %s", key, value)
+
+	return nil
+}
+
+// SetConfigWithType 设置配置值（指定类型）
+func (cm *ConfigManager) SetConfigWithType(key, value, configType string) error {
+	config := &entity.SystemConfig{
+		Key:   key,
+		Value: value,
+		Type:  configType,
+	}
+
+	err := cm.repo.SystemConfigRepository.UpsertConfigs([]entity.SystemConfig{*config})
+	if err != nil {
+		return fmt.Errorf("保存配置失败: %v", err)
+	}
+
+	// 更新缓存
+	item := &ConfigItem{
+		Key:       config.Key,
+		Value:     config.Value,
+		Type:      config.Type,
+		UpdatedAt: time.Now(),
+	}
+
+	if group := cm.getGroupByConfigKey(key); group != "" {
+		item.Group = string(group)
+	}
+
+	if category := cm.getCategoryByConfigKey(key); category != "" {
+		item.Category = category
+	}
+
+	item.IsSensitive = cm.isSensitiveConfig(key)
+
+	cm.setCachedConfig(key, item)
+
+	// 发送更新通知
+	cm.configUpdateCh <- key
+
+	utils.Info("配置已更新: %s = %s (type: %s)", key, value, configType)
+
+	return nil
+}
+
+// getGroupByConfigKey 根据配置键获取分组
+func (cm *ConfigManager) getGroupByConfigKey(key string) ConfigGroup {
+	switch {
+	case strings.HasPrefix(key, "database_"), strings.HasPrefix(key, "db_"):
+		return GroupDatabase
+	case strings.HasPrefix(key, "server_"), strings.HasPrefix(key, "port"), strings.HasPrefix(key, "host"):
+		return GroupServer
+	case strings.HasPrefix(key, "api_"), strings.HasPrefix(key, "jwt_"), strings.HasPrefix(key, "password"):
+		return GroupSecurity
+	case strings.Contains(key, "meilisearch"):
+		return GroupMeilisearch
+	case strings.Contains(key, "telegram"):
+		return GroupTelegram
+	case strings.Contains(key, "cache"), strings.Contains(key, "redis"):
+		return GroupCache
+	case strings.Contains(key, "seo"), strings.Contains(key, "title"), strings.Contains(key, "keyword"):
+		return GroupSEO
+	case strings.Contains(key, "auto_"):
+		return GroupAutoProcess
+	case strings.Contains(key, "forbidden"), strings.Contains(key, "ad_"):
+		return GroupOther
+	default:
+		return GroupOther
+	}
+}
+
+// getCategoryByConfigKey 根据配置键获取分类
+func (cm *ConfigManager) getCategoryByConfigKey(key string) string {
+	switch {
+	case key == entity.ConfigKeySiteTitle || key == entity.ConfigKeySiteDescription:
+		return "basic_info"
+	case key == entity.ConfigKeyKeywords || key == entity.ConfigKeyAuthor:
+		return "seo"
+	case key == entity.ConfigKeyAutoProcessReadyResources || key == entity.ConfigKeyAutoProcessInterval:
+		return "auto_process"
+	case key == entity.ConfigKeyAutoTransferEnabled || key == entity.ConfigKeyAutoTransferLimitDays:
+		return "auto_transfer"
+	case key == entity.ConfigKeyMeilisearchEnabled || key == entity.ConfigKeyMeilisearchHost:
+		return "search"
+	case key == entity.ConfigKeyTelegramBotEnabled || key == entity.ConfigKeyTelegramBotApiKey:
+		return "telegram"
+	case key == entity.ConfigKeyMaintenanceMode || key == entity.ConfigKeyEnableRegister:
+		return "system"
+	case key == entity.ConfigKeyForbiddenWords || key == entity.ConfigKeyAdKeywords:
+		return "filtering"
+	default:
+		return "other"
+	}
+}
+
+// isSensitiveConfig 判断是否是敏感配置
+func (cm *ConfigManager) isSensitiveConfig(key string) bool {
+	switch key {
+	case entity.ConfigKeyApiToken,
+		entity.ConfigKeyMeilisearchMasterKey,
+		entity.ConfigKeyTelegramBotApiKey,
+		entity.ConfigKeyTelegramProxyUsername,
+		entity.ConfigKeyTelegramProxyPassword:
+		return true
+	default:
+		return strings.Contains(strings.ToLower(key), "password") ||
+			strings.Contains(strings.ToLower(key), "secret") ||
+			strings.Contains(strings.ToLower(key), "key") ||
+			strings.Contains(strings.ToLower(key), "token")
+	}
+}
+
+// getDefaultConfigType 获取默认配置类型
+func (cm *ConfigManager) getDefaultConfigType(key string) string {
+	switch key {
+	case entity.ConfigKeyAutoProcessReadyResources,
+		entity.ConfigKeyAutoTransferEnabled,
+		entity.ConfigKeyAutoFetchHotDramaEnabled,
+		entity.ConfigKeyMaintenanceMode,
+		entity.ConfigKeyEnableRegister,
+		entity.ConfigKeyMeilisearchEnabled,
+		entity.ConfigKeyTelegramBotEnabled:
+		return entity.ConfigTypeBool
+	case entity.ConfigKeyAutoProcessInterval,
+		entity.ConfigKeyAutoTransferLimitDays,
+		entity.ConfigKeyAutoTransferMinSpace,
+		entity.ConfigKeyPageSize:
+		return entity.ConfigTypeInt
+	case entity.ConfigKeyAnnouncements:
+		return entity.ConfigTypeJSON
+	default:
+		return entity.ConfigTypeString
+	}
+}
+
+// LoadAllConfigs 加载所有配置到缓存
+func (cm *ConfigManager) LoadAllConfigs() error {
+	configs, err := cm.repo.SystemConfigRepository.FindAll()
+	if err != nil {
+		return fmt.Errorf("加载所有配置失败: %v", err)
+	}
+
+	cm.cacheMutex.Lock()
+	defer cm.cacheMutex.Unlock()
+
+	// 清空现有缓存
+	cm.cache = make(map[string]*ConfigItem)
+
+	// 更新缓存
+	for _, config := range configs {
+		item := &ConfigItem{
+			Key:       config.Key,
+			Value:     config.Value,
+			Type:      config.Type,
+			UpdatedAt: time.Now(), // 实际应该从数据库获取
+		}
+
+		if group := cm.getGroupByConfigKey(config.Key); group != "" {
+			item.Group = string(group)
+		}
+
+		if category := cm.getCategoryByConfigKey(config.Key); category != "" {
+			item.Category = category
+		}
+
+		item.IsSensitive = cm.isSensitiveConfig(config.Key)
+
+		cm.cache[config.Key] = item
+	}
+
+	cm.lastLoadTime = time.Now()
+
+	utils.Info("已加载 %d 个配置项到缓存", len(configs))
+
+	return nil
+}
+
+// RefreshConfigCache 刷新配置缓存
+func (cm *ConfigManager) RefreshConfigCache() error {
+	return cm.LoadAllConfigs()
+}
+
+// GetCachedConfig 获取缓存的配置
+func (cm *ConfigManager) getCachedConfig(key string) (*ConfigItem, bool) {
+	cm.cacheMutex.RLock()
+	defer cm.cacheMutex.RUnlock()
+
+	item, exists := cm.cache[key]
+	return item, exists
+}
+
+// setCachedConfig 设置缓存的配置
+func (cm *ConfigManager) setCachedConfig(key string, item *ConfigItem) {
+	cm.cacheMutex.Lock()
+	defer cm.cacheMutex.Unlock()
+
+	cm.cache[key] = item
+}
+
+// GetConfigByGroup 按分组获取配置
+func (cm *ConfigManager) GetConfigByGroup(group ConfigGroup) (map[string]*ConfigItem, error) {
+	cm.cacheMutex.RLock()
+	defer cm.cacheMutex.RUnlock()
+
+	result := make(map[string]*ConfigItem)
+
+	for key, item := range cm.cache {
+		if ConfigGroup(item.Group) == group {
+			result[key] = item
+		}
+	}
+
+	return result, nil
+}
+
+// GetConfigByCategory 按分类获取配置
+func (cm *ConfigManager) GetConfigByCategory(category string) (map[string]*ConfigItem, error) {
+	cm.cacheMutex.RLock()
+	defer cm.cacheMutex.RUnlock()
+
+	result := make(map[string]*ConfigItem)
+
+	for key, item := range cm.cache {
+		if item.Category == category {
+			result[key] = item
+		}
+	}
+
+	return result, nil
+}
+
+// DeleteConfig 删除配置
+func (cm *ConfigManager) DeleteConfig(key string) error {
+	// 先查找配置获取ID
+	config, err := cm.repo.SystemConfigRepository.FindByKey(key)
+	if err != nil {
+		return fmt.Errorf("查找配置失败: %v", err)
+	}
+
+	// 从数据库删除
+	err = cm.repo.SystemConfigRepository.Delete(config.ID)
+	if err != nil {
+		return fmt.Errorf("删除配置失败: %v", err)
+	}
+
+	// 从缓存中移除
+	cm.cacheMutex.Lock()
+	delete(cm.cache, key)
+	cm.cacheMutex.Unlock()
+
+	utils.Info("配置已删除: %s", key)
+
+	return nil
+}
+
+// GetSensitiveConfigKeys 获取所有敏感配置键
+func (cm *ConfigManager) GetSensitiveConfigKeys() []string {
+	cm.cacheMutex.RLock()
+	defer cm.cacheMutex.RUnlock()
+
+	var sensitiveKeys []string
+	for key, item := range cm.cache {
+		if item.IsSensitive {
+			sensitiveKeys = append(sensitiveKeys, key)
+		}
+	}
+
+	return sensitiveKeys
+}
+
+// GetConfigWithMask 获取配置值（敏感配置会被遮蔽）
+func (cm *ConfigManager) GetConfigWithMask(key string) (*ConfigItem, error) {
+	item, err := cm.GetConfig(key)
+	if err != nil {
+		return nil, err
+	}
+
+	if item.IsSensitive {
+		// 创建副本并遮蔽敏感值
+		maskedItem := *item
+		maskedItem.Value = cm.maskSensitiveValue(item.Value)
+		return &maskedItem, nil
+	}
+
+	return item, nil
+}
+
+// maskSensitiveValue 遮蔽敏感值
+func (cm *ConfigManager) maskSensitiveValue(value string) string {
+	if len(value) <= 4 {
+		return "****"
+	}
+
+	// 保留前2个和后2个字符，中间用****替代
+	return value[:2] + "****" + value[len(value)-2:]
+}
+
+// GetConfigAsJSON 获取配置为JSON格式
+func (cm *ConfigManager) GetConfigAsJSON() ([]byte, error) {
+	cm.cacheMutex.RLock()
+	defer cm.cacheMutex.RUnlock()
+
+	// 创建副本，敏感配置使用遮蔽值
+	configMap := make(map[string]*ConfigItem)
+	for key, item := range cm.cache {
+		if item.IsSensitive {
+			maskedItem := *item
+			maskedItem.Value = cm.maskSensitiveValue(item.Value)
+			configMap[key] = &maskedItem
+		} else {
+			configMap[key] = item
+		}
+	}
+
+	return json.MarshalIndent(configMap, "", "  ")
+}
+
+// GetConfigStatistics 获取配置统计信息
+func (cm *ConfigManager) GetConfigStatistics() map[string]interface{} {
+	cm.cacheMutex.RLock()
+	defer cm.cacheMutex.RUnlock()
+
+	stats := map[string]interface{}{
+		"total_configs":          len(cm.cache),
+		"last_load_time":         cm.lastLoadTime,
+		"cache_size_bytes":       len(cm.cache) * 100, // 估算每个配置约100字节
+		"groups":                 make(map[string]int),
+		"types":                  make(map[string]int),
+		"categories":             make(map[string]int),
+		"sensitive_configs":      0,
+		"config_keys":            make([]string, 0),
+	}
+
+	groups := make(map[string]int)
+	types := make(map[string]int)
+	categories := make(map[string]int)
+
+	for key, item := range cm.cache {
+		// 统计分组
+		groups[item.Group]++
+
+		// 统计类型
+		types[item.Type]++
+
+		// 统计分类
+		categories[item.Category]++
+
+		// 统计敏感配置
+		if item.IsSensitive {
+			stats["sensitive_configs"] = stats["sensitive_configs"].(int) + 1
+		}
+
+		// 添加配置键到列表
+		keys := stats["config_keys"].([]string)
+		keys = append(keys, key)
+		stats["config_keys"] = keys
+	}
+
+	stats["groups"] = groups
+	stats["types"] = types
+	stats["categories"] = categories
+
+	return stats
+}
+
+// GetEnvironmentConfig 从环境变量获取配置
+func (cm *ConfigManager) GetEnvironmentConfig(key string) (string, bool) {
+	value := os.Getenv(key)
+	if value != "" {
+		return value, true
+	}
+
+	// 尝试使用大写版本的键
+	value = os.Getenv(strings.ToUpper(key))
+	if value != "" {
+		return value, true
+	}
+
+	// 尝试使用大写带下划线的格式
+	upperKey := strings.ToUpper(strings.ReplaceAll(key, ".", "_"))
+	value = os.Getenv(upperKey)
+	if value != "" {
+		return value, true
+	}
+
+	return "", false
+}
+
+// GetConfigWithEnvFallback 获取配置，环境变量优先
+func (cm *ConfigManager) GetConfigWithEnvFallback(configKey, envKey string) (string, error) {
+	// 优先从环境变量获取
+	if envValue, exists := cm.GetEnvironmentConfig(envKey); exists {
+		return envValue, nil
+	}
+
+	// 如果环境变量不存在，从数据库获取
+	return cm.GetConfigValue(configKey)
+}
+
+// GetConfigIntWithEnvFallback 获取整数配置，环境变量优先
+func (cm *ConfigManager) GetConfigIntWithEnvFallback(configKey, envKey string) (int, error) {
+	// 优先从环境变量获取
+	if envValue, exists := cm.GetEnvironmentConfig(envKey); exists {
+		return strconv.Atoi(envValue)
+	}
+
+	// 如果环境变量不存在，从数据库获取
+	return cm.GetConfigInt(configKey)
+}
+
+// GetConfigBoolWithEnvFallback 获取布尔配置，环境变量优先
+func (cm *ConfigManager) GetConfigBoolWithEnvFallback(configKey, envKey string) (bool, error) {
+	// 优先从环境变量获取
+	if envValue, exists := cm.GetEnvironmentConfig(envKey); exists {
+		switch strings.ToLower(envValue) {
+		case "true", "1", "yes", "on":
+			return true, nil
+		case "false", "0", "no", "off", "":
+			return false, nil
+		default:
+			return false, fmt.Errorf("无法将环境变量值 '%s' 转换为布尔值", envValue)
+		}
+	}
+
+	// 如果环境变量不存在，从数据库获取
+	return cm.GetConfigBool(configKey)
+}

config/global.go

@@ -0,0 +1,124 @@
+package config
+
+import (
+	"sync"
+)
+
+var (
+	globalConfigManager *ConfigManager
+	once                sync.Once
+)
+
+// SetGlobalConfigManager 设置全局配置管理器
+func SetGlobalConfigManager(cm *ConfigManager) {
+	globalConfigManager = cm
+}
+
+// GetGlobalConfigManager 获取全局配置管理器
+func GetGlobalConfigManager() *ConfigManager {
+	return globalConfigManager
+}
+
+// GetConfig 获取配置值（全局函数）
+func GetConfig(key string) (*ConfigItem, error) {
+	if globalConfigManager == nil {
+		return nil, ErrConfigManagerNotInitialized
+	}
+	return globalConfigManager.GetConfig(key)
+}
+
+// GetConfigValue 获取配置值（全局函数）
+func GetConfigValue(key string) (string, error) {
+	if globalConfigManager == nil {
+		return "", ErrConfigManagerNotInitialized
+	}
+	return globalConfigManager.GetConfigValue(key)
+}
+
+// GetConfigBool 获取布尔配置值（全局函数）
+func GetConfigBool(key string) (bool, error) {
+	if globalConfigManager == nil {
+		return false, ErrConfigManagerNotInitialized
+	}
+	return globalConfigManager.GetConfigBool(key)
+}
+
+// GetConfigInt 获取整数配置值（全局函数）
+func GetConfigInt(key string) (int, error) {
+	if globalConfigManager == nil {
+		return 0, ErrConfigManagerNotInitialized
+	}
+	return globalConfigManager.GetConfigInt(key)
+}
+
+// GetConfigInt64 获取64位整数配置值（全局函数）
+func GetConfigInt64(key string) (int64, error) {
+	if globalConfigManager == nil {
+		return 0, ErrConfigManagerNotInitialized
+	}
+	return globalConfigManager.GetConfigInt64(key)
+}
+
+// GetConfigFloat64 获取浮点数配置值（全局函数）
+func GetConfigFloat64(key string) (float64, error) {
+	if globalConfigManager == nil {
+		return 0, ErrConfigManagerNotInitialized
+	}
+	return globalConfigManager.GetConfigFloat64(key)
+}
+
+// SetConfig 设置配置值（全局函数）
+func SetConfig(key, value string) error {
+	if globalConfigManager == nil {
+		return ErrConfigManagerNotInitialized
+	}
+	return globalConfigManager.SetConfig(key, value)
+}
+
+// SetConfigWithType 设置配置值（指定类型，全局函数）
+func SetConfigWithType(key, value, configType string) error {
+	if globalConfigManager == nil {
+		return ErrConfigManagerNotInitialized
+	}
+	return globalConfigManager.SetConfigWithType(key, value, configType)
+}
+
+// GetConfigWithEnvFallback 获取配置值（环境变量优先，全局函数）
+func GetConfigWithEnvFallback(configKey, envKey string) (string, error) {
+	if globalConfigManager == nil {
+		return "", ErrConfigManagerNotInitialized
+	}
+	return globalConfigManager.GetConfigWithEnvFallback(configKey, envKey)
+}
+
+// GetConfigIntWithEnvFallback 获取整数配置值（环境变量优先，全局函数）
+func GetConfigIntWithEnvFallback(configKey, envKey string) (int, error) {
+	if globalConfigManager == nil {
+		return 0, ErrConfigManagerNotInitialized
+	}
+	return globalConfigManager.GetConfigIntWithEnvFallback(configKey, envKey)
+}
+
+// GetConfigBoolWithEnvFallback 获取布尔配置值（环境变量优先，全局函数）
+func GetConfigBoolWithEnvFallback(configKey, envKey string) (bool, error) {
+	if globalConfigManager == nil {
+		return false, ErrConfigManagerNotInitialized
+	}
+	return globalConfigManager.GetConfigBoolWithEnvFallback(configKey, envKey)
+}
+
+// ErrConfigManagerNotInitialized 配置管理器未初始化错误
+var ErrConfigManagerNotInitialized = &ConfigError{
+	Code:    "CONFIG_MANAGER_NOT_INITIALIZED",
+	Message: "配置管理器未初始化",
+}
+
+// ConfigError 配置错误
+type ConfigError struct {
+	Code    string
+	Message string
+}
+
+func (e *ConfigError) Error() string {
+	return e.Message
+}

config/sync.go

@@ -0,0 +1,31 @@
+package config
+
+import (
+	"github.com/ctwj/urldb/db/repo"
+	"github.com/ctwj/urldb/utils"
+)
+
+// SyncWithRepository 同步配置管理器与Repository的缓存
+func (cm *ConfigManager) SyncWithRepository(repoManager *repo.RepositoryManager) {
+	// 监听配置变更事件并同步缓存
+	// 这是一个抽象概念，实际实现需要修改Repository接口
+
+	// 当配置更新时，通知Repository清理缓存
+	go func() {
+		watcher := cm.AddConfigWatcher()
+		for {
+			select {
+			case key := <-watcher:
+				// 通知Repository层清理缓存（如果Repository支持）
+				utils.Debug("配置 %s 已更新，可能需要同步到Repository缓存", key)
+			}
+		}
+	}()
+}
+
+// UpdateRepositoryCache 当配置管理器更新配置时，通知Repository层同步
+func (cm *ConfigManager) UpdateRepositoryCache(repoManager *repo.RepositoryManager) {
+	// 这个函数需要Repository支持特定的缓存清理方法
+	// 由于现有Repository没有提供这样的接口，我们只能依赖数据库同步
+	utils.Info("配置已通过配置管理器更新，Repository层将从数据库重新加载")
+}

db/connection.go

@@ -2,7 +2,9 @@ package db
 
 import (
 	"fmt"
+	"log"
 	"os"
+	"strconv"
 	"time"
 
 	"github.com/ctwj/urldb/db/entity"
@@ -45,8 +47,22 @@ func InitDB() error {
 		host, port, user, password, dbname)
 
 	var err error
+	// 配置慢查询日志
+	slowThreshold := getEnvInt("DB_SLOW_THRESHOLD_MS", 200)
+	logLevel := logger.Info
+	if os.Getenv("ENV") == "production" {
+		logLevel = logger.Warn
+	}
+
 	DB, err = gorm.Open(postgres.Open(dsn), &gorm.Config{
-		Logger: logger.Default.LogMode(logger.Info),
+		Logger: logger.New(
+			log.New(os.Stdout, "\r\n", log.LstdFlags),
+			logger.Config{
+				SlowThreshold: time.Duration(slowThreshold) * time.Millisecond,
+				LogLevel:      logLevel,
+				Colorful:      true,
+			},
+		),
 	})
 	if err != nil {
 		return err
@@ -58,10 +74,17 @@ func InitDB() error {
 		return err
 	}
 
-	// 设置连接池参数
-	sqlDB.SetMaxIdleConns(10)           // 最大空闲连接数
-	sqlDB.SetMaxOpenConns(100)          // 最大打开连接数
-	sqlDB.SetConnMaxLifetime(time.Hour) // 连接最大生命周期
+	// 优化数据库连接池参数
+	maxOpenConns := getEnvInt("DB_MAX_OPEN_CONNS", 50)
+	maxIdleConns := getEnvInt("DB_MAX_IDLE_CONNS", 20)
+	connMaxLifetime := getEnvInt("DB_CONN_MAX_LIFETIME_MINUTES", 30)
+
+	sqlDB.SetMaxOpenConns(maxOpenConns)                               // 最大打开连接数
+	sqlDB.SetMaxIdleConns(maxIdleConns)                               // 最大空闲连接数
+	sqlDB.SetConnMaxLifetime(time.Duration(connMaxLifetime) * time.Minute) // 连接最大生命周期
+
+	utils.Info("数据库连接池配置 - 最大连接: %d, 空闲连接: %d, 生命周期: %d分钟",
+		maxOpenConns, maxIdleConns, connMaxLifetime)
 
 	// 检查是否需要迁移（只在开发环境或首次启动时）
 	if shouldRunMigration() {
@@ -83,6 +106,11 @@ func InitDB() error {
 			&entity.TaskItem{},
 			&entity.File{},
 			&entity.TelegramChannel{},
+			&entity.APIAccessLog{},
+			&entity.APIAccessLogStats{},
+			&entity.APIAccessLogSummary{},
+			&entity.Report{},
+			&entity.CopyrightClaim{},
 		)
 		if err != nil {
 			utils.Fatal("数据库迁移失败: %v", err)
@@ -183,7 +211,15 @@ func createIndexes(db *gorm.DB) {
 	db.Exec("CREATE INDEX IF NOT EXISTS idx_resource_tags_resource_id ON resource_tags(resource_id)")
 	db.Exec("CREATE INDEX IF NOT EXISTS idx_resource_tags_tag_id ON resource_tags(tag_id)")
 
-	utils.Info("数据库索引创建完成（已移除全文搜索索引，准备使用Meilisearch）")
+	// API访问日志表索引 - 高性能查询优化
+	db.Exec("CREATE INDEX IF NOT EXISTS idx_api_access_logs_created_at ON api_access_logs(created_at DESC)")
+	db.Exec("CREATE INDEX IF NOT EXISTS idx_api_access_logs_endpoint_status ON api_access_logs(endpoint, response_status)")
+	db.Exec("CREATE INDEX IF NOT EXISTS idx_api_access_logs_ip_created ON api_access_logs(ip, created_at DESC)")
+	db.Exec("CREATE INDEX IF NOT EXISTS idx_api_access_logs_method_endpoint ON api_access_logs(method, endpoint)")
+	db.Exec("CREATE INDEX IF NOT EXISTS idx_api_access_logs_response_time ON api_access_logs(processing_time)")
+	db.Exec("CREATE INDEX IF NOT EXISTS idx_api_access_logs_error_logs ON api_access_logs(response_status, created_at DESC) WHERE response_status >= 400")
+
+	utils.Info("数据库索引创建完成（已移除全文搜索索引，准备使用Meilisearch，新增API访问日志性能索引）")
 }
 
 // insertDefaultDataIfEmpty 只在数据库为空时插入默认数据
@@ -297,3 +333,19 @@ func insertDefaultDataIfEmpty() error {
 	utils.Info("默认数据插入完成")
 	return nil
 }
+
+// getEnvInt 获取环境变量中的整数值，如果不存在则返回默认值
+func getEnvInt(key string, defaultValue int) int {
+	value := os.Getenv(key)
+	if value == "" {
+		return defaultValue
+	}
+
+	intValue, err := strconv.Atoi(value)
+	if err != nil {
+		utils.Warn("环境变量 %s 的值 '%s' 不是有效的整数，使用默认值 %d", key, value, defaultValue)
+		return defaultValue
+	}
+
+	return intValue
+}

db/converter/api_access_log_converter.go

@@ -0,0 +1,66 @@
+package converter
+
+import (
+	"github.com/ctwj/urldb/db/dto"
+	"github.com/ctwj/urldb/db/entity"
+)
+
+// ToAPIAccessLogResponse 将APIAccessLog实体转换为APIAccessLogResponse
+func ToAPIAccessLogResponse(log *entity.APIAccessLog) dto.APIAccessLogResponse {
+	return dto.APIAccessLogResponse{
+		ID:             log.ID,
+		IP:             log.IP,
+		UserAgent:      log.UserAgent,
+		Endpoint:       log.Endpoint,
+		Method:         log.Method,
+		RequestParams:  log.RequestParams,
+		ResponseStatus: log.ResponseStatus,
+		ResponseData:   log.ResponseData,
+		ProcessCount:   log.ProcessCount,
+		ErrorMessage:   log.ErrorMessage,
+		ProcessingTime: log.ProcessingTime,
+		CreatedAt:      log.CreatedAt,
+	}
+}
+
+// ToAPIAccessLogResponseList 将APIAccessLog实体列表转换为APIAccessLogResponse列表
+func ToAPIAccessLogResponseList(logs []entity.APIAccessLog) []dto.APIAccessLogResponse {
+	responses := make([]dto.APIAccessLogResponse, len(logs))
+	for i, log := range logs {
+		responses[i] = ToAPIAccessLogResponse(&log)
+	}
+	return responses
+}
+
+// ToAPIAccessLogSummaryResponse 将APIAccessLogSummary实体转换为APIAccessLogSummaryResponse
+func ToAPIAccessLogSummaryResponse(summary *entity.APIAccessLogSummary) dto.APIAccessLogSummaryResponse {
+	return dto.APIAccessLogSummaryResponse{
+		TotalRequests: summary.TotalRequests,
+		TodayRequests: summary.TodayRequests,
+		WeekRequests:  summary.WeekRequests,
+		MonthRequests: summary.MonthRequests,
+		ErrorRequests: summary.ErrorRequests,
+		UniqueIPs:     summary.UniqueIPs,
+	}
+}
+
+// ToAPIAccessLogStatsResponse 将APIAccessLogStats实体转换为APIAccessLogStatsResponse
+func ToAPIAccessLogStatsResponse(stat entity.APIAccessLogStats) dto.APIAccessLogStatsResponse {
+	return dto.APIAccessLogStatsResponse{
+		Endpoint:       stat.Endpoint,
+		Method:         stat.Method,
+		RequestCount:   stat.RequestCount,
+		ErrorCount:     stat.ErrorCount,
+		AvgProcessTime: stat.AvgProcessTime,
+		LastAccess:     stat.LastAccess,
+	}
+}
+
+// ToAPIAccessLogStatsResponseList 将APIAccessLogStats实体列表转换为APIAccessLogStatsResponse列表
+func ToAPIAccessLogStatsResponseList(stats []entity.APIAccessLogStats) []dto.APIAccessLogStatsResponse {
+	responses := make([]dto.APIAccessLogStatsResponse, len(stats))
+	for i, stat := range stats {
+		responses[i] = ToAPIAccessLogStatsResponse(stat)
+	}
+	return responses
+}

db/converter/converter.go

@@ -12,6 +12,7 @@ import (
 func ToResourceResponse(resource *entity.Resource) dto.ResourceResponse {
 	response := dto.ResourceResponse{
 		ID:                  resource.ID,
+		Key:                 resource.Key,
 		Title:               resource.Title,
 		Description:         resource.Description,
 		URL:                 resource.URL,
@@ -36,6 +37,18 @@ func ToResourceResponse(resource *entity.Resource) dto.ResourceResponse {
 		response.CategoryName = resource.Category.Name
 	}
 
+	// 设置平台信息
+	if resource.Pan.ID != 0 {
+		panResponse := dto.PanResponse{
+			ID:     resource.Pan.ID,
+			Name:   resource.Pan.Name,
+			Key:    resource.Pan.Key,
+			Icon:   resource.Pan.Icon,
+			Remark: resource.Pan.Remark,
+		}
+		response.Pan = &panResponse
+	}
+
 	// 转换标签
 	response.Tags = make([]dto.TagResponse, len(resource.Tags))
 	for i, tag := range resource.Tags {
@@ -73,6 +86,9 @@ func ToResourceResponseFromMeilisearch(doc interface{}) dto.ResourceResponse {
 	if urlField := docValue.FieldByName("URL"); urlField.IsValid() {
 		response.URL = urlField.String()
 	}
+	if coverField := docValue.FieldByName("Cover"); coverField.IsValid() {
+		response.Cover = coverField.String()
+	}
 	if saveURLField := docValue.FieldByName("SaveURL"); saveURLField.IsValid() {
 		response.SaveURL = saveURLField.String()
 	}

db/converter/copyright_claim_converter.go

@@ -0,0 +1,95 @@
+package converter
+
+import (
+	"time"
+	"github.com/ctwj/urldb/db/dto"
+	"github.com/ctwj/urldb/db/entity"
+)
+
+// CopyrightClaimToResponseWithResources 将版权申述实体和关联资源转换为响应对象
+func CopyrightClaimToResponseWithResources(claim *entity.CopyrightClaim, resources []*entity.Resource) *dto.CopyrightClaimResponse {
+	if claim == nil {
+		return nil
+	}
+
+	// 转换关联的资源信息
+	var resourceInfos []dto.ResourceInfo
+	for _, resource := range resources {
+		categoryName := ""
+		if resource.Category.ID != 0 {
+			categoryName = resource.Category.Name
+		}
+
+		panName := ""
+		if resource.Pan.ID != 0 {
+			panName = resource.Pan.Name
+		}
+
+		resourceInfo := dto.ResourceInfo{
+			ID:          resource.ID,
+			Title:       resource.Title,
+			Description: resource.Description,
+			URL:         resource.URL,
+			SaveURL:     resource.SaveURL,
+			FileSize:    resource.FileSize,
+			Category:    categoryName,
+			PanName:     panName,
+			ViewCount:   resource.ViewCount,
+			IsValid:     resource.IsValid,
+			CreatedAt:   resource.CreatedAt.Format(time.RFC3339),
+		}
+		resourceInfos = append(resourceInfos, resourceInfo)
+	}
+
+	return &dto.CopyrightClaimResponse{
+		ID:           claim.ID,
+		ResourceKey:  claim.ResourceKey,
+		Identity:     claim.Identity,
+		ProofType:    claim.ProofType,
+		Reason:       claim.Reason,
+		ContactInfo:  claim.ContactInfo,
+		ClaimantName: claim.ClaimantName,
+		ProofFiles:   claim.ProofFiles,
+		UserAgent:    claim.UserAgent,
+		IPAddress:    claim.IPAddress,
+		Status:       claim.Status,
+		Note:         claim.Note,
+		CreatedAt:    claim.CreatedAt.Format(time.RFC3339),
+		UpdatedAt:    claim.UpdatedAt.Format(time.RFC3339),
+		Resources:    resourceInfos,
+	}
+}
+
+// CopyrightClaimToResponse 将版权申述实体转换为响应对象（不包含资源详情）
+func CopyrightClaimToResponse(claim *entity.CopyrightClaim) *dto.CopyrightClaimResponse {
+	if claim == nil {
+		return nil
+	}
+
+	return &dto.CopyrightClaimResponse{
+		ID:           claim.ID,
+		ResourceKey:  claim.ResourceKey,
+		Identity:     claim.Identity,
+		ProofType:    claim.ProofType,
+		Reason:       claim.Reason,
+		ContactInfo:  claim.ContactInfo,
+		ClaimantName: claim.ClaimantName,
+		ProofFiles:   claim.ProofFiles,
+		UserAgent:    claim.UserAgent,
+		IPAddress:    claim.IPAddress,
+		Status:       claim.Status,
+		Note:         claim.Note,
+		CreatedAt:    claim.CreatedAt.Format(time.RFC3339),
+		UpdatedAt:    claim.UpdatedAt.Format(time.RFC3339),
+		Resources:   []dto.ResourceInfo{}, // 空的资源列表
+	}
+}
+
+// CopyrightClaimsToResponse 将版权申述实体列表转换为响应对象列表
+func CopyrightClaimsToResponse(claims []*entity.CopyrightClaim) []*dto.CopyrightClaimResponse {
+	var responses []*dto.CopyrightClaimResponse
+	for _, claim := range claims {
+		responses = append(responses, CopyrightClaimToResponse(claim))
+	}
+	return responses
+}

db/converter/report_converter.go

@@ -0,0 +1,89 @@
+package converter
+
+import (
+	"time"
+	"github.com/ctwj/urldb/db/dto"
+	"github.com/ctwj/urldb/db/entity"
+)
+
+// ReportToResponseWithResources 将举报实体和关联资源转换为响应对象
+func ReportToResponseWithResources(report *entity.Report, resources []*entity.Resource) *dto.ReportResponse {
+	if report == nil {
+		return nil
+	}
+
+	// 转换关联的资源信息
+	var resourceInfos []dto.ResourceInfo
+	for _, resource := range resources {
+		categoryName := ""
+		if resource.Category.ID != 0 {
+			categoryName = resource.Category.Name
+		}
+
+		panName := ""
+		if resource.Pan.ID != 0 {
+			panName = resource.Pan.Name
+		}
+
+		resourceInfo := dto.ResourceInfo{
+			ID:          resource.ID,
+			Title:       resource.Title,
+			Description: resource.Description,
+			URL:         resource.URL,
+			SaveURL:     resource.SaveURL,
+			FileSize:    resource.FileSize,
+			Category:    categoryName,
+			PanName:     panName,
+			ViewCount:   resource.ViewCount,
+			IsValid:     resource.IsValid,
+			CreatedAt:   resource.CreatedAt.Format(time.RFC3339),
+		}
+		resourceInfos = append(resourceInfos, resourceInfo)
+	}
+
+	return &dto.ReportResponse{
+		ID:          report.ID,
+		ResourceKey: report.ResourceKey,
+		Reason:      report.Reason,
+		Description: report.Description,
+		Contact:     report.Contact,
+		UserAgent:   report.UserAgent,
+		IPAddress:   report.IPAddress,
+		Status:      report.Status,
+		Note:        report.Note,
+		CreatedAt:   report.CreatedAt.Format(time.RFC3339),
+		UpdatedAt:   report.UpdatedAt.Format(time.RFC3339),
+		Resources:   resourceInfos,
+	}
+}
+
+// ReportToResponse 将举报实体转换为响应对象（不包含资源详情）
+func ReportToResponse(report *entity.Report) *dto.ReportResponse {
+	if report == nil {
+		return nil
+	}
+
+	return &dto.ReportResponse{
+		ID:          report.ID,
+		ResourceKey: report.ResourceKey,
+		Reason:      report.Reason,
+		Description: report.Description,
+		Contact:     report.Contact,
+		UserAgent:   report.UserAgent,
+		IPAddress:   report.IPAddress,
+		Status:      report.Status,
+		Note:        report.Note,
+		CreatedAt:   report.CreatedAt.Format(time.RFC3339),
+		UpdatedAt:   report.UpdatedAt.Format(time.RFC3339),
+		Resources:   []dto.ResourceInfo{}, // 空的资源列表
+	}
+}
+
+// ReportsToResponse 将举报实体列表转换为响应对象列表
+func ReportsToResponse(reports []*entity.Report) []*dto.ReportResponse {
+	var responses []*dto.ReportResponse
+	for _, report := range reports {
+		responses = append(responses, ReportToResponse(report))
+	}
+	return responses
+}

db/converter/system_config_converter.go

@@ -1,6 +1,7 @@
 package converter
 
 import (
+	"encoding/json"
 	"strconv"
 	"time"
 
@@ -90,6 +91,27 @@ func SystemConfigToResponse(configs []entity.SystemConfig) *dto.SystemConfigResp
 			response.MeilisearchMasterKey = config.Value
 		case entity.ConfigKeyMeilisearchIndexName:
 			response.MeilisearchIndexName = config.Value
+		case entity.ConfigKeyEnableAnnouncements:
+			if val, err := strconv.ParseBool(config.Value); err == nil {
+				response.EnableAnnouncements = val
+			}
+		case entity.ConfigKeyAnnouncements:
+			if config.Value == "" || config.Value == "[]" {
+				response.Announcements = ""
+			} else {
+				// 在响应时保持为字符串，后续由前端处理
+				response.Announcements = config.Value
+			}
+		case entity.ConfigKeyEnableFloatButtons:
+			if val, err := strconv.ParseBool(config.Value); err == nil {
+				response.EnableFloatButtons = val
+			}
+		case entity.ConfigKeyWechatSearchImage:
+			response.WechatSearchImage = config.Value
+		case entity.ConfigKeyTelegramQrImage:
+			response.TelegramQrImage = config.Value
+		case entity.ConfigKeyQrCodeStyle:
+			response.QrCodeStyle = config.Value
 		}
 	}
 
@@ -221,6 +243,35 @@ func RequestToSystemConfig(req *dto.SystemConfigRequest) []entity.SystemConfig {
 		updatedKeys = append(updatedKeys, entity.ConfigKeyMeilisearchIndexName)
 	}
 
+	// 界面配置处理
+	if req.EnableAnnouncements != nil {
+		configs = append(configs, entity.SystemConfig{Key: entity.ConfigKeyEnableAnnouncements, Value: strconv.FormatBool(*req.EnableAnnouncements), Type: entity.ConfigTypeBool})
+		updatedKeys = append(updatedKeys, entity.ConfigKeyEnableAnnouncements)
+	}
+	if req.Announcements != nil {
+		// 将数组转换为JSON字符串
+		if jsonBytes, err := json.Marshal(*req.Announcements); err == nil {
+			configs = append(configs, entity.SystemConfig{Key: entity.ConfigKeyAnnouncements, Value: string(jsonBytes), Type: entity.ConfigTypeJSON})
+			updatedKeys = append(updatedKeys, entity.ConfigKeyAnnouncements)
+		}
+	}
+	if req.EnableFloatButtons != nil {
+		configs = append(configs, entity.SystemConfig{Key: entity.ConfigKeyEnableFloatButtons, Value: strconv.FormatBool(*req.EnableFloatButtons), Type: entity.ConfigTypeBool})
+		updatedKeys = append(updatedKeys, entity.ConfigKeyEnableFloatButtons)
+	}
+	if req.WechatSearchImage != nil {
+		configs = append(configs, entity.SystemConfig{Key: entity.ConfigKeyWechatSearchImage, Value: *req.WechatSearchImage, Type: entity.ConfigTypeString})
+		updatedKeys = append(updatedKeys, entity.ConfigKeyWechatSearchImage)
+	}
+	if req.TelegramQrImage != nil {
+		configs = append(configs, entity.SystemConfig{Key: entity.ConfigKeyTelegramQrImage, Value: *req.TelegramQrImage, Type: entity.ConfigTypeString})
+		updatedKeys = append(updatedKeys, entity.ConfigKeyTelegramQrImage)
+	}
+	if req.QrCodeStyle != nil {
+		configs = append(configs, entity.SystemConfig{Key: entity.ConfigKeyQrCodeStyle, Value: *req.QrCodeStyle, Type: entity.ConfigTypeString})
+		updatedKeys = append(updatedKeys, entity.ConfigKeyQrCodeStyle)
+	}
+
 	// 记录更新的配置项
 	if len(updatedKeys) > 0 {
 		utils.Info("配置更新 - 被修改的配置项: %v", updatedKeys)
@@ -229,39 +280,27 @@ func RequestToSystemConfig(req *dto.SystemConfigRequest) []entity.SystemConfig {
 	return configs
 }
 
-// SystemConfigToPublicResponse 返回不含 api_token 的系统配置响应
+// SystemConfigToPublicResponse 返回不含敏感配置的系统配置响应
 func SystemConfigToPublicResponse(configs []entity.SystemConfig) map[string]interface{} {
 	response := map[string]interface{}{
-		entity.ConfigResponseFieldID:                        0,
-		entity.ConfigResponseFieldCreatedAt:                 utils.GetCurrentTimeString(),
-		entity.ConfigResponseFieldUpdatedAt:                 utils.GetCurrentTimeString(),
-		entity.ConfigResponseFieldSiteTitle:                 entity.ConfigDefaultSiteTitle,
-		entity.ConfigResponseFieldSiteDescription:           entity.ConfigDefaultSiteDescription,
-		entity.ConfigResponseFieldKeywords:                  entity.ConfigDefaultKeywords,
-		entity.ConfigResponseFieldAuthor:                    entity.ConfigDefaultAuthor,
-		entity.ConfigResponseFieldCopyright:                 entity.ConfigDefaultCopyright,
-		"site_logo":                                         "",
-		entity.ConfigResponseFieldAutoProcessReadyResources: false,
-		entity.ConfigResponseFieldAutoProcessInterval:       30,
-		entity.ConfigResponseFieldAutoTransferEnabled:       false,
-		entity.ConfigResponseFieldAutoTransferLimitDays:     0,
-		entity.ConfigResponseFieldAutoTransferMinSpace:      100,
-		entity.ConfigResponseFieldAutoFetchHotDramaEnabled:  false,
-		entity.ConfigResponseFieldForbiddenWords:            "",
-		entity.ConfigResponseFieldAdKeywords:                "",
-		entity.ConfigResponseFieldAutoInsertAd:              "",
-		entity.ConfigResponseFieldPageSize:                  100,
-		entity.ConfigResponseFieldMaintenanceMode:           false,
-		entity.ConfigResponseFieldEnableRegister:            true, // 默认开启注册功能
-		entity.ConfigResponseFieldThirdPartyStatsCode:       "",
-		entity.ConfigResponseFieldMeilisearchEnabled:        false,
-		entity.ConfigResponseFieldMeilisearchHost:           "localhost",
-		entity.ConfigResponseFieldMeilisearchPort:           "7700",
-		entity.ConfigResponseFieldMeilisearchMasterKey:      "",
-		entity.ConfigResponseFieldMeilisearchIndexName:      "resources",
+		entity.ConfigResponseFieldID:                  0,
+		entity.ConfigResponseFieldCreatedAt:           utils.GetCurrentTimeString(),
+		entity.ConfigResponseFieldUpdatedAt:           utils.GetCurrentTimeString(),
+		entity.ConfigResponseFieldSiteTitle:           entity.ConfigDefaultSiteTitle,
+		entity.ConfigResponseFieldSiteDescription:     entity.ConfigDefaultSiteDescription,
+		entity.ConfigResponseFieldKeywords:            entity.ConfigDefaultKeywords,
+		entity.ConfigResponseFieldAuthor:              entity.ConfigDefaultAuthor,
+		entity.ConfigResponseFieldCopyright:           entity.ConfigDefaultCopyright,
+		"site_logo":                                   "",
+		entity.ConfigResponseFieldAdKeywords:          "",
+		entity.ConfigResponseFieldAutoInsertAd:        "",
+		entity.ConfigResponseFieldPageSize:            100,
+		entity.ConfigResponseFieldMaintenanceMode:     false,
+		entity.ConfigResponseFieldEnableRegister:      true, // 默认开启注册功能
+		entity.ConfigResponseFieldThirdPartyStatsCode: "",
 	}
 
-	// 将键值对转换为map
+	// 将键值对转换为map，过滤掉敏感配置
 	for _, config := range configs {
 		switch config.Key {
 		case entity.ConfigKeySiteTitle:
@@ -276,32 +315,6 @@ func SystemConfigToPublicResponse(configs []entity.SystemConfig) map[string]inte
 			response[entity.ConfigResponseFieldCopyright] = config.Value
 		case entity.ConfigKeySiteLogo:
 			response["site_logo"] = config.Value
-		case entity.ConfigKeyAutoProcessReadyResources:
-			if val, err := strconv.ParseBool(config.Value); err == nil {
-				response[entity.ConfigResponseFieldAutoProcessReadyResources] = val
-			}
-		case entity.ConfigKeyAutoProcessInterval:
-			if val, err := strconv.Atoi(config.Value); err == nil {
-				response[entity.ConfigResponseFieldAutoProcessInterval] = val
-			}
-		case entity.ConfigKeyAutoTransferEnabled:
-			if val, err := strconv.ParseBool(config.Value); err == nil {
-				response[entity.ConfigResponseFieldAutoTransferEnabled] = val
-			}
-		case entity.ConfigKeyAutoTransferLimitDays:
-			if val, err := strconv.Atoi(config.Value); err == nil {
-				response[entity.ConfigResponseFieldAutoTransferLimitDays] = val
-			}
-		case entity.ConfigKeyAutoTransferMinSpace:
-			if val, err := strconv.Atoi(config.Value); err == nil {
-				response[entity.ConfigResponseFieldAutoTransferMinSpace] = val
-			}
-		case entity.ConfigKeyAutoFetchHotDramaEnabled:
-			if val, err := strconv.ParseBool(config.Value); err == nil {
-				response[entity.ConfigResponseFieldAutoFetchHotDramaEnabled] = val
-			}
-		case entity.ConfigKeyForbiddenWords:
-			response[entity.ConfigResponseFieldForbiddenWords] = config.Value
 		case entity.ConfigKeyAdKeywords:
 			response[entity.ConfigResponseFieldAdKeywords] = config.Value
 		case entity.ConfigKeyAutoInsertAd:
@@ -320,18 +333,41 @@ func SystemConfigToPublicResponse(configs []entity.SystemConfig) map[string]inte
 			}
 		case entity.ConfigKeyThirdPartyStatsCode:
 			response[entity.ConfigResponseFieldThirdPartyStatsCode] = config.Value
-		case entity.ConfigKeyMeilisearchEnabled:
+		case entity.ConfigKeyEnableAnnouncements:
 			if val, err := strconv.ParseBool(config.Value); err == nil {
-				response[entity.ConfigResponseFieldMeilisearchEnabled] = val
+				response["enable_announcements"] = val
 			}
+		case entity.ConfigKeyAnnouncements:
+			if config.Value == "" || config.Value == "[]" {
+				response["announcements"] = ""
+			} else {
+				response["announcements"] = config.Value
+			}
+		case entity.ConfigKeyEnableFloatButtons:
+			if val, err := strconv.ParseBool(config.Value); err == nil {
+				response["enable_float_buttons"] = val
+			}
+		case entity.ConfigKeyWechatSearchImage:
+			response["wechat_search_image"] = config.Value
+		case entity.ConfigKeyTelegramQrImage:
+			response["telegram_qr_image"] = config.Value
+		case entity.ConfigKeyQrCodeStyle:
+			response["qr_code_style"] = config.Value
+		// 跳过不需要返回给公众的配置
+		case entity.ConfigKeyAutoProcessReadyResources:
+		case entity.ConfigKeyAutoProcessInterval:
+		case entity.ConfigKeyAutoTransferEnabled:
+		case entity.ConfigKeyAutoTransferLimitDays:
+		case entity.ConfigKeyAutoTransferMinSpace:
+		case entity.ConfigKeyAutoFetchHotDramaEnabled:
+		case entity.ConfigKeyMeilisearchEnabled:
 		case entity.ConfigKeyMeilisearchHost:
-			response[entity.ConfigResponseFieldMeilisearchHost] = config.Value
 		case entity.ConfigKeyMeilisearchPort:
-			response[entity.ConfigResponseFieldMeilisearchPort] = config.Value
 		case entity.ConfigKeyMeilisearchMasterKey:
-			response[entity.ConfigResponseFieldMeilisearchMasterKey] = config.Value
 		case entity.ConfigKeyMeilisearchIndexName:
-			response[entity.ConfigResponseFieldMeilisearchIndexName] = config.Value
+		case entity.ConfigKeyForbiddenWords:
+			// 这些配置不返回给公众
+			continue
 		}
 	}
 
@@ -372,5 +408,11 @@ func getDefaultConfigResponse() *dto.SystemConfigResponse {
 		MeilisearchPort:           entity.ConfigDefaultMeilisearchPort,
 		MeilisearchMasterKey:      entity.ConfigDefaultMeilisearchMasterKey,
 		MeilisearchIndexName:      entity.ConfigDefaultMeilisearchIndexName,
+		EnableAnnouncements:       false,
+		Announcements:             "",
+		EnableFloatButtons:        false,
+		WechatSearchImage:         entity.ConfigDefaultWechatSearchImage,
+		TelegramQrImage:           entity.ConfigDefaultTelegramQrImage,
+		QrCodeStyle:               entity.ConfigDefaultQrCodeStyle,
 	}
 }

db/converter/telegram_channel_converter.go

@@ -24,6 +24,8 @@ func TelegramChannelToResponse(channel entity.TelegramChannel) dto.TelegramChann
 		ContentCategories: channel.ContentCategories,
 		ContentTags:       channel.ContentTags,
 		IsActive:          channel.IsActive,
+		ResourceStrategy:  channel.ResourceStrategy,
+		TimeLimit:         channel.TimeLimit,
 		LastPushAt:        channel.LastPushAt,
 		RegisteredBy:      channel.RegisteredBy,
 		RegisteredAt:      channel.RegisteredAt,
@@ -41,7 +43,7 @@ func TelegramChannelsToResponse(channels []entity.TelegramChannel) []dto.Telegra
 
 // RequestToTelegramChannel 将请求DTO转换为TelegramChannel实体
 func RequestToTelegramChannel(req dto.TelegramChannelRequest, registeredBy string) entity.TelegramChannel {
-	return entity.TelegramChannel{
+	channel := entity.TelegramChannel{
 		ChatID:            req.ChatID,
 		ChatName:          req.ChatName,
 		ChatType:          req.ChatType,
@@ -55,6 +57,21 @@ func RequestToTelegramChannel(req dto.TelegramChannelRequest, registeredBy strin
 		RegisteredBy:      registeredBy,
 		RegisteredAt:      time.Now(),
 	}
+
+	// 设置默认值（如果为空）
+	if req.ResourceStrategy == "" {
+		channel.ResourceStrategy = "random"
+	} else {
+		channel.ResourceStrategy = req.ResourceStrategy
+	}
+
+	if req.TimeLimit == "" {
+		channel.TimeLimit = "none"
+	} else {
+		channel.TimeLimit = req.TimeLimit
+	}
+
+	return channel
 }
 
 // TelegramBotConfigToResponse 将Telegram bot配置转换为响应DTO

db/converter/wechat_bot_converter.go

@@ -0,0 +1,88 @@
+package converter
+
+import (
+	"strconv"
+
+	"github.com/ctwj/urldb/db/dto"
+	"github.com/ctwj/urldb/db/entity"
+)
+
+// WechatBotConfigRequestToSystemConfigs 将微信机器人配置请求转换为系统配置实体
+func WechatBotConfigRequestToSystemConfigs(req dto.WechatBotConfigRequest) []entity.SystemConfig {
+	configs := []entity.SystemConfig{
+		{Key: entity.ConfigKeyWechatBotEnabled, Value: wechatBoolToString(req.Enabled)},
+		{Key: entity.ConfigKeyWechatAppId, Value: req.AppID},
+		{Key: entity.ConfigKeyWechatAppSecret, Value: req.AppSecret},
+		{Key: entity.ConfigKeyWechatToken, Value: req.Token},
+		{Key: entity.ConfigKeyWechatEncodingAesKey, Value: req.EncodingAesKey},
+		{Key: entity.ConfigKeyWechatWelcomeMessage, Value: req.WelcomeMessage},
+		{Key: entity.ConfigKeyWechatAutoReplyEnabled, Value: wechatBoolToString(req.AutoReplyEnabled)},
+		{Key: entity.ConfigKeyWechatSearchLimit, Value: wechatIntToString(req.SearchLimit)},
+	}
+	return configs
+}
+
+// SystemConfigToWechatBotConfig 将系统配置转换为微信机器人配置响应
+func SystemConfigToWechatBotConfig(configs []entity.SystemConfig) dto.WechatBotConfigResponse {
+	resp := dto.WechatBotConfigResponse{
+		Enabled:          false,
+		AppID:            "",
+		AppSecret:        "",
+		Token:            "",
+		EncodingAesKey:   "",
+		WelcomeMessage:   "欢迎关注老九网盘资源库！发送关键词即可搜索资源。",
+		AutoReplyEnabled: true,
+		SearchLimit:      5,
+	}
+
+	for _, config := range configs {
+		switch config.Key {
+		case entity.ConfigKeyWechatBotEnabled:
+			resp.Enabled = config.Value == "true"
+		case entity.ConfigKeyWechatAppId:
+			resp.AppID = config.Value
+		case entity.ConfigKeyWechatAppSecret:
+			resp.AppSecret = config.Value
+		case entity.ConfigKeyWechatToken:
+			resp.Token = config.Value
+		case entity.ConfigKeyWechatEncodingAesKey:
+			resp.EncodingAesKey = config.Value
+		case entity.ConfigKeyWechatWelcomeMessage:
+			if config.Value != "" {
+				resp.WelcomeMessage = config.Value
+			}
+		case entity.ConfigKeyWechatAutoReplyEnabled:
+			resp.AutoReplyEnabled = config.Value == "true"
+		case entity.ConfigKeyWechatSearchLimit:
+			if config.Value != "" {
+				resp.SearchLimit = wechatStringToInt(config.Value)
+			}
+		}
+	}
+
+	return resp
+}
+
+// 辅助函数 - 使用大写名称避免与其他文件中的函数冲突
+func wechatBoolToString(b bool) string {
+	if b {
+		return "true"
+	}
+	return "false"
+}
+
+func wechatIntToString(i int) string {
+	return strconv.Itoa(i)
+}
+
+func wechatStringToInt(s string) int {
+	if s == "" {
+		return 0
+	}
+
+	i, err := strconv.Atoi(s)
+	if err != nil {
+		return 0
+	}
+	return i
+}

db/dto/api_access_log.go

@@ -0,0 +1,55 @@
+package dto
+
+import "time"
+
+// APIAccessLogResponse API访问日志响应
+type APIAccessLogResponse struct {
+	ID             uint      `json:"id"`
+	IP             string    `json:"ip"`
+	UserAgent      string    `json:"user_agent"`
+	Endpoint       string    `json:"endpoint"`
+	Method         string    `json:"method"`
+	RequestParams  string    `json:"request_params"`
+	ResponseStatus int       `json:"response_status"`
+	ResponseData   string    `json:"response_data"`
+	ProcessCount   int       `json:"process_count"`
+	ErrorMessage   string    `json:"error_message"`
+	ProcessingTime int64     `json:"processing_time"`
+	CreatedAt      time.Time `json:"created_at"`
+}
+
+// APIAccessLogSummaryResponse API访问日志汇总响应
+type APIAccessLogSummaryResponse struct {
+	TotalRequests int64 `json:"total_requests"`
+	TodayRequests int64 `json:"today_requests"`
+	WeekRequests  int64 `json:"week_requests"`
+	MonthRequests int64 `json:"month_requests"`
+	ErrorRequests int64 `json:"error_requests"`
+	UniqueIPs     int64 `json:"unique_ips"`
+}
+
+// APIAccessLogStatsResponse 按端点统计响应
+type APIAccessLogStatsResponse struct {
+	Endpoint       string    `json:"endpoint"`
+	Method         string    `json:"method"`
+	RequestCount   int64     `json:"request_count"`
+	ErrorCount     int64     `json:"error_count"`
+	AvgProcessTime int64     `json:"avg_process_time"`
+	LastAccess     time.Time `json:"last_access"`
+}
+
+// APIAccessLogListResponse API访问日志列表响应
+type APIAccessLogListResponse struct {
+	Data  []APIAccessLogResponse `json:"data"`
+	Total int64                  `json:"total"`
+}
+
+// APIAccessLogFilterRequest API访问日志过滤请求
+type APIAccessLogFilterRequest struct {
+	StartDate string `json:"start_date,omitempty"`
+	EndDate   string `json:"end_date,omitempty"`
+	Endpoint  string `json:"endpoint,omitempty"`
+	IP        string `json:"ip,omitempty"`
+	Page      int    `json:"page,omitempty" default:"1"`
+	PageSize  int    `json:"page_size,omitempty" default:"20"`
+}

db/dto/copyright_claim.go

@@ -0,0 +1,46 @@
+package dto
+
+// CopyrightClaimCreateRequest 版权申述创建请求
+type CopyrightClaimCreateRequest struct {
+	ResourceKey  string `json:"resource_key" validate:"required,max=255"`
+	Identity     string `json:"identity" validate:"required,max=50"`
+	ProofType    string `json:"proof_type" validate:"required,max=50"`
+	Reason       string `json:"reason" validate:"required,max=2000"`
+	ContactInfo  string `json:"contact_info" validate:"required,max=255"`
+	ClaimantName string `json:"claimant_name" validate:"required,max=100"`
+	ProofFiles   string `json:"proof_files" validate:"omitempty,max=2000"`
+	UserAgent    string `json:"user_agent" validate:"omitempty,max=1000"`
+	IPAddress    string `json:"ip_address" validate:"omitempty,max=45"`
+}
+
+// CopyrightClaimUpdateRequest 版权申述更新请求
+type CopyrightClaimUpdateRequest struct {
+	Status string `json:"status" validate:"required,oneof=pending approved rejected"`
+	Note   string `json:"note" validate:"omitempty,max=1000"`
+}
+
+// CopyrightClaimResponse 版权申述响应
+type CopyrightClaimResponse struct {
+	ID           uint          `json:"id"`
+	ResourceKey  string        `json:"resource_key"`
+	Identity     string        `json:"identity"`
+	ProofType    string        `json:"proof_type"`
+	Reason       string        `json:"reason"`
+	ContactInfo  string        `json:"contact_info"`
+	ClaimantName string        `json:"claimant_name"`
+	ProofFiles   string        `json:"proof_files"`
+	UserAgent    string        `json:"user_agent"`
+	IPAddress    string        `json:"ip_address"`
+	Status       string        `json:"status"`
+	Note         string        `json:"note"`
+	CreatedAt    string        `json:"created_at"`
+	UpdatedAt    string        `json:"updated_at"`
+	Resources    []ResourceInfo `json:"resources"`
+}
+
+// CopyrightClaimListRequest 版权申述列表请求
+type CopyrightClaimListRequest struct {
+	Page     int    `query:"page" validate:"omitempty,min=1"`
+	PageSize int    `query:"page_size" validate:"omitempty,min=1,max=100"`
+	Status   string `query:"status" validate:"omitempty,oneof=pending approved rejected"`
+}

db/dto/report.go

@@ -0,0 +1,55 @@
+package dto
+
+// ReportCreateRequest 举报创建请求
+type ReportCreateRequest struct {
+	ResourceKey string `json:"resource_key" validate:"required,max=255"`
+	Reason      string `json:"reason" validate:"required,max=100"`
+	Description string `json:"description" validate:"required,max=1000"`
+	Contact     string `json:"contact" validate:"omitempty,max=255"`
+	UserAgent   string `json:"user_agent" validate:"omitempty,max=1000"`
+	IPAddress   string `json:"ip_address" validate:"omitempty,max=45"`
+}
+
+// ReportUpdateRequest 举报更新请求
+type ReportUpdateRequest struct {
+	Status string `json:"status" validate:"required,oneof=pending approved rejected"`
+	Note   string `json:"note" validate:"omitempty,max=1000"`
+}
+
+// ResourceInfo 资源信息
+type ResourceInfo struct {
+	ID          uint   `json:"id"`
+	Title       string `json:"title"`
+	Description string `json:"description"`
+	URL         string `json:"url"`
+	SaveURL     string `json:"save_url"`
+	FileSize    string `json:"file_size"`
+	Category    string `json:"category"`
+	PanName     string `json:"pan_name"`
+	ViewCount   int    `json:"view_count"`
+	IsValid     bool   `json:"is_valid"`
+	CreatedAt   string `json:"created_at"`
+}
+
+// ReportResponse 举报响应
+type ReportResponse struct {
+	ID          uint           `json:"id"`
+	ResourceKey string         `json:"resource_key"`
+	Reason      string         `json:"reason"`
+	Description string         `json:"description"`
+	Contact     string         `json:"contact"`
+	UserAgent   string         `json:"user_agent"`
+	IPAddress   string         `json:"ip_address"`
+	Status      string         `json:"status"`
+	Note        string         `json:"note"`
+	CreatedAt   string         `json:"created_at"`
+	UpdatedAt   string         `json:"updated_at"`
+	Resources   []ResourceInfo `json:"resources"` // 关联的资源列表
+}
+
+// ReportListRequest 举报列表请求
+type ReportListRequest struct {
+	Page     int    `query:"page" validate:"omitempty,min=1"`
+	PageSize int    `query:"page_size" validate:"omitempty,min=1,max=100"`
+	Status   string `query:"status" validate:"omitempty,oneof=pending approved rejected"`
+}

db/dto/response.go

@@ -13,6 +13,7 @@ type SearchResponse struct {
 // ResourceResponse 资源响应
 type ResourceResponse struct {
 	ID                  uint          `json:"id"`
+	Key                 string        `json:"key"`
 	Title               string        `json:"title"`
 	Description         string        `json:"description"`
 	URL                 string        `json:"url"`
@@ -32,6 +33,7 @@ type ResourceResponse struct {
 	ErrorMsg            string        `json:"error_msg"`
 	SyncedToMeilisearch bool          `json:"synced_to_meilisearch"`
 	SyncedAt            *time.Time    `json:"synced_at"`
+	Pan                 *PanResponse  `json:"pan,omitempty"` // 平台信息
 	// 高亮字段
 	TitleHighlight       string   `json:"title_highlight,omitempty"`
 	DescriptionHighlight string   `json:"description_highlight,omitempty"`
@@ -72,19 +74,20 @@ type PanResponse struct {
 
 // CksResponse Cookie响应
 type CksResponse struct {
-	ID          uint         `json:"id"`
-	PanID       uint         `json:"pan_id"`
-	Idx         int          `json:"idx"`
-	Ck          string       `json:"ck"`
-	IsValid     bool         `json:"is_valid"`
-	Space       int64        `json:"space"`
-	LeftSpace   int64        `json:"left_space"`
-	UsedSpace   int64        `json:"used_space"`
-	Username    string       `json:"username"`
-	VipStatus   bool         `json:"vip_status"`
-	ServiceType string       `json:"service_type"`
-	Remark      string       `json:"remark"`
-	Pan         *PanResponse `json:"pan,omitempty"`
+	ID                uint         `json:"id"`
+	PanID             uint         `json:"pan_id"`
+	Idx               int          `json:"idx"`
+	Ck                string       `json:"ck"`
+	IsValid           bool         `json:"is_valid"`
+	Space             int64        `json:"space"`
+	LeftSpace         int64        `json:"left_space"`
+	UsedSpace         int64        `json:"used_space"`
+	Username          string       `json:"username"`
+	VipStatus         bool         `json:"vip_status"`
+	ServiceType       string       `json:"service_type"`
+	Remark            string       `json:"remark"`
+	TransferredCount  int64        `json:"transferred_count"` // 已转存资源数
+	Pan               *PanResponse `json:"pan,omitempty"`
 }
 
 // ReadyResourceResponse 待处理资源响应

db/dto/system_config.go

@@ -42,6 +42,14 @@ type SystemConfigRequest struct {
 	MeilisearchPort      *string `json:"meilisearch_port,omitempty"`
 	MeilisearchMasterKey *string `json:"meilisearch_master_key,omitempty"`
 	MeilisearchIndexName *string `json:"meilisearch_index_name,omitempty"`
+
+	// 界面配置
+	EnableAnnouncements *bool     `json:"enable_announcements,omitempty"`
+	Announcements       *[]map[string]interface{} `json:"announcements,omitempty"`
+	EnableFloatButtons  *bool     `json:"enable_float_buttons,omitempty"`
+	WechatSearchImage   *string   `json:"wechat_search_image,omitempty"`
+	TelegramQrImage     *string   `json:"telegram_qr_image,omitempty"`
+	QrCodeStyle         *string   `json:"qr_code_style,omitempty"`
 }
 
 // SystemConfigResponse 系统配置响应
@@ -90,6 +98,14 @@ type SystemConfigResponse struct {
 	MeilisearchPort      string `json:"meilisearch_port"`
 	MeilisearchMasterKey string `json:"meilisearch_master_key"`
 	MeilisearchIndexName string `json:"meilisearch_index_name"`
+
+	// 界面配置
+	EnableAnnouncements bool     `json:"enable_announcements"`
+	Announcements       string   `json:"announcements"`
+	EnableFloatButtons  bool     `json:"enable_float_buttons"`
+	WechatSearchImage   string   `json:"wechat_search_image"`
+	TelegramQrImage     string   `json:"telegram_qr_image"`
+	QrCodeStyle         string   `json:"qr_code_style"`
 }
 
 // SystemConfigItem 单个配置项

db/dto/telegram_channel.go

@@ -14,6 +14,8 @@ type TelegramChannelRequest struct {
 	ContentCategories string `json:"content_categories"`
 	ContentTags       string `json:"content_tags"`
 	IsActive          bool   `json:"is_active"`
+	ResourceStrategy  string `json:"resource_strategy"`
+	TimeLimit         string `json:"time_limit"`
 }
 
 // TelegramChannelUpdateRequest 更新 Telegram 频道/群组请求（ChatID可选）
@@ -28,6 +30,8 @@ type TelegramChannelUpdateRequest struct {
 	ContentCategories string `json:"content_categories"`
 	ContentTags       string `json:"content_tags"`
 	IsActive          bool   `json:"is_active"`
+	ResourceStrategy  string `json:"resource_strategy"`
+	TimeLimit         string `json:"time_limit"`
 }
 
 // TelegramChannelResponse Telegram 频道/群组响应
@@ -43,6 +47,8 @@ type TelegramChannelResponse struct {
 	ContentCategories string     `json:"content_categories"`
 	ContentTags       string     `json:"content_tags"`
 	IsActive          bool       `json:"is_active"`
+	ResourceStrategy  string     `json:"resource_strategy"`
+	TimeLimit         string     `json:"time_limit"`
 	LastPushAt        *time.Time `json:"last_push_at"`
 	RegisteredBy      string     `json:"registered_by"`
 	RegisteredAt      time.Time  `json:"registered_at"`

db/dto/wechat_bot.go

@@ -0,0 +1,25 @@
+package dto
+
+// WechatBotConfigRequest 微信公众号机器人配置请求
+type WechatBotConfigRequest struct {
+	Enabled         bool   `json:"enabled"`
+	AppID           string `json:"app_id"`
+	AppSecret       string `json:"app_secret"`
+	Token           string `json:"token"`
+	EncodingAesKey  string `json:"encoding_aes_key"`
+	WelcomeMessage  string `json:"welcome_message"`
+	AutoReplyEnabled bool   `json:"auto_reply_enabled"`
+	SearchLimit     int    `json:"search_limit"`
+}
+
+// WechatBotConfigResponse 微信公众号机器人配置响应
+type WechatBotConfigResponse struct {
+	Enabled         bool   `json:"enabled"`
+	AppID           string `json:"app_id"`
+	AppSecret       string `json:"app_secret"`
+	Token           string `json:"token"`
+	EncodingAesKey  string `json:"encoding_aes_key"`
+	WelcomeMessage  string `json:"welcome_message"`
+	AutoReplyEnabled bool   `json:"auto_reply_enabled"`
+	SearchLimit     int    `json:"search_limit"`
+}

db/entity/api_access_log.go

@@ -0,0 +1,50 @@
+package entity
+
+import (
+	"time"
+
+	"gorm.io/gorm"
+)
+
+// APIAccessLog API访问日志模型
+type APIAccessLog struct {
+	ID             uint           `json:"id" gorm:"primaryKey;autoIncrement"`
+	IP             string         `json:"ip" gorm:"size:45;not null;comment:客户端IP地址"`
+	UserAgent      string         `json:"user_agent" gorm:"size:500;comment:用户代理"`
+	Endpoint       string         `json:"endpoint" gorm:"size:255;not null;comment:访问的接口路径"`
+	Method         string         `json:"method" gorm:"size:10;not null;comment:HTTP方法"`
+	RequestParams  string         `json:"request_params" gorm:"type:text;comment:查询参数(JSON格式)"`
+	ResponseStatus int            `json:"response_status" gorm:"default:200;comment:响应状态码"`
+	ResponseData   string         `json:"response_data" gorm:"type:text;comment:响应数据(JSON格式)"`
+	ProcessCount   int            `json:"process_count" gorm:"default:0;comment:处理数量(查询结果数或添加的数量)"`
+	ErrorMessage   string         `json:"error_message" gorm:"size:500;comment:错误消息"`
+	ProcessingTime int64          `json:"processing_time" gorm:"comment:处理时间(毫秒)"`
+	CreatedAt      time.Time      `json:"created_at"`
+	UpdatedAt      time.Time      `json:"updated_at"`
+	DeletedAt      gorm.DeletedAt `json:"deleted_at" gorm:"index"`
+}
+
+// TableName 指定表名
+func (APIAccessLog) TableName() string {
+	return "api_access_logs"
+}
+
+// APIAccessLogSummary API访问日志汇总统计
+type APIAccessLogSummary struct {
+	TotalRequests int64 `json:"total_requests"`
+	TodayRequests int64 `json:"today_requests"`
+	WeekRequests  int64 `json:"week_requests"`
+	MonthRequests int64 `json:"month_requests"`
+	ErrorRequests int64 `json:"error_requests"`
+	UniqueIPs     int64 `json:"unique_ips"`
+}
+
+// APIAccessLogStats 按端点统计
+type APIAccessLogStats struct {
+	Endpoint       string    `json:"endpoint"`
+	Method         string    `json:"method"`
+	RequestCount   int64     `json:"request_count"`
+	ErrorCount     int64     `json:"error_count"`
+	AvgProcessTime int64     `json:"avg_process_time"`
+	LastAccess     time.Time `json:"last_access"`
+}

db/entity/copyright_claim.go

@@ -0,0 +1,32 @@
+package entity
+
+import (
+	"gorm.io/gorm"
+	"time"
+)
+
+// CopyrightClaim 版权申述实体
+type CopyrightClaim struct {
+	ID           uint           `gorm:"primaryKey" json:"id"`
+	ResourceKey  string         `gorm:"type:varchar(255);not null;index" json:"resource_key"` // 资源唯一标识
+	Identity     string         `gorm:"type:varchar(50);not null" json:"identity"`            // 申述人身份
+	ProofType    string         `gorm:"type:varchar(50);not null" json:"proof_type"`          // 证明类型
+	Reason       string         `gorm:"type:text;not null" json:"reason"`                     // 申述理由
+	ContactInfo  string         `gorm:"type:varchar(255);not null" json:"contact_info"`       // 联系信息
+	ClaimantName string         `gorm:"type:varchar(100);not null" json:"claimant_name"`      // 申述人姓名
+	ProofFiles   string         `gorm:"type:text" json:"proof_files"`                         // 证明文件（JSON格式）
+	UserAgent    string         `gorm:"type:text" json:"user_agent"`                          // 用户代理
+	IPAddress    string         `gorm:"type:varchar(45)" json:"ip_address"`                   // IP地址
+	Status       string         `gorm:"type:varchar(20);default:'pending'" json:"status"`     // 处理状态: pending, approved, rejected
+	ProcessedAt  *time.Time     `json:"processed_at"`                                         // 处理时间
+	ProcessedBy  *uint          `json:"processed_by"`                                         // 处理人ID
+	Note         string         `gorm:"type:text" json:"note"`                                // 处理备注
+	CreatedAt    time.Time      `json:"created_at"`
+	UpdatedAt    time.Time      `json:"updated_at"`
+	DeletedAt    gorm.DeletedAt `json:"deleted_at"`
+}
+
+// TableName 表名
+func (CopyrightClaim) TableName() string {
+	return "copyright_claims"
+}

db/entity/report.go

@@ -0,0 +1,29 @@
+package entity
+
+import (
+	"gorm.io/gorm"
+	"time"
+)
+
+// Report 举报实体
+type Report struct {
+	ID          uint           `gorm:"primaryKey" json:"id"`
+	ResourceKey string         `gorm:"type:varchar(255);not null;index" json:"resource_key"` // 资源唯一标识
+	Reason      string         `gorm:"type:varchar(100);not null" json:"reason"`             // 举报原因
+	Description string         `gorm:"type:text" json:"description"`                         // 详细描述
+	Contact     string         `gorm:"type:varchar(255)" json:"contact"`                     // 联系方式
+	UserAgent   string         `gorm:"type:text" json:"user_agent"`                          // 用户代理
+	IPAddress   string         `gorm:"type:varchar(45)" json:"ip_address"`                   // IP地址
+	Status      string         `gorm:"type:varchar(20);default:'pending'" json:"status"`     // 处理状态: pending, approved, rejected
+	ProcessedAt *time.Time     `json:"processed_at"`                                         // 处理时间
+	ProcessedBy *uint          `json:"processed_by"`                                         // 处理人ID
+	Note        string         `gorm:"type:text" json:"note"`                                // 处理备注
+	CreatedAt   time.Time      `json:"created_at"`
+	UpdatedAt   time.Time      `json:"updated_at"`
+	DeletedAt   gorm.DeletedAt `json:"deleted_at"`
+}
+
+// TableName 表名
+func (Report) TableName() string {
+	return "reports"
+}

db/entity/system_config_constants.go

@@ -56,6 +56,24 @@ const (
 	ConfigKeyTelegramProxyPort          = "telegram_proxy_port"
 	ConfigKeyTelegramProxyUsername      = "telegram_proxy_username"
 	ConfigKeyTelegramProxyPassword      = "telegram_proxy_password"
+
+	// 微信公众号配置
+	ConfigKeyWechatBotEnabled         = "wechat_bot_enabled"
+	ConfigKeyWechatAppId              = "wechat_app_id"
+	ConfigKeyWechatAppSecret          = "wechat_app_secret"
+	ConfigKeyWechatToken              = "wechat_token"
+	ConfigKeyWechatEncodingAesKey     = "wechat_encoding_aes_key"
+	ConfigKeyWechatWelcomeMessage     = "wechat_welcome_message"
+	ConfigKeyWechatAutoReplyEnabled   = "wechat_auto_reply_enabled"
+	ConfigKeyWechatSearchLimit        = "wechat_search_limit"
+
+	// 界面配置
+	ConfigKeyEnableAnnouncements = "enable_announcements"
+	ConfigKeyAnnouncements       = "announcements"
+	ConfigKeyEnableFloatButtons  = "enable_float_buttons"
+	ConfigKeyWechatSearchImage   = "wechat_search_image"
+	ConfigKeyTelegramQrImage     = "telegram_qr_image"
+	ConfigKeyQrCodeStyle         = "qr_code_style"
 )
 
 // ConfigType 配置类型常量
@@ -126,6 +144,24 @@ const (
 	ConfigResponseFieldTelegramProxyPort          = "telegram_proxy_port"
 	ConfigResponseFieldTelegramProxyUsername      = "telegram_proxy_username"
 	ConfigResponseFieldTelegramProxyPassword      = "telegram_proxy_password"
+
+	// 微信公众号配置字段
+	ConfigResponseFieldWechatBotEnabled         = "wechat_bot_enabled"
+	ConfigResponseFieldWechatAppId              = "wechat_app_id"
+	ConfigResponseFieldWechatAppSecret          = "wechat_app_secret"
+	ConfigResponseFieldWechatToken              = "wechat_token"
+	ConfigResponseFieldWechatEncodingAesKey     = "wechat_encoding_aes_key"
+	ConfigResponseFieldWechatWelcomeMessage     = "wechat_welcome_message"
+	ConfigResponseFieldWechatAutoReplyEnabled   = "wechat_auto_reply_enabled"
+	ConfigResponseFieldWechatSearchLimit        = "wechat_search_limit"
+
+	// 界面配置字段
+	ConfigResponseFieldEnableAnnouncements = "enable_announcements"
+	ConfigResponseFieldAnnouncements       = "announcements"
+	ConfigResponseFieldEnableFloatButtons  = "enable_float_buttons"
+	ConfigResponseFieldWechatSearchImage   = "wechat_search_image"
+	ConfigResponseFieldTelegramQrImage     = "telegram_qr_image"
+	ConfigResponseFieldQrCodeStyle         = "qr_code_style"
 )
 
 // ConfigDefaultValue 配置默认值常量
@@ -183,4 +219,22 @@ const (
 	ConfigDefaultTelegramProxyPort          = "8080"
 	ConfigDefaultTelegramProxyUsername      = ""
 	ConfigDefaultTelegramProxyPassword      = ""
+
+	// 微信公众号配置默认值
+	ConfigDefaultWechatBotEnabled         = "false"
+	ConfigDefaultWechatAppId              = ""
+	ConfigDefaultWechatAppSecret          = ""
+	ConfigDefaultWechatToken              = ""
+	ConfigDefaultWechatEncodingAesKey     = ""
+	ConfigDefaultWechatWelcomeMessage     = "欢迎关注老九网盘资源库！发送关键词即可搜索资源。"
+	ConfigDefaultWechatAutoReplyEnabled   = "true"
+	ConfigDefaultWechatSearchLimit        = "5"
+
+	// 界面配置默认值
+	ConfigDefaultEnableAnnouncements = "false"
+	ConfigDefaultAnnouncements       = ""
+	ConfigDefaultEnableFloatButtons  = "false"
+	ConfigDefaultWechatSearchImage   = ""
+	ConfigDefaultTelegramQrImage     = ""
+	ConfigDefaultQrCodeStyle         = "Plain"
 )

db/entity/telegram_channel.go

@@ -36,6 +36,10 @@ type TelegramChannel struct {
 	Token           string `json:"token" gorm:"size:255;comment:访问令牌"`
 	ApiType         string `json:"api_type" gorm:"size:50;comment:API类型"`
 	IsPushSavedInfo bool   `json:"is_push_saved_info" gorm:"default:false;comment:是否只推送已转存资源"`
+
+	// 资源策略和时间限制配置
+	ResourceStrategy string `json:"resource_strategy" gorm:"size:20;default:'random';comment:资源策略：latest-最新优先,transferred-已转存优先,random-纯随机"`
+	TimeLimit        string `json:"time_limit" gorm:"size:20;default:'none';comment:时间限制：none-无限制,week-一周内,month-一月内"`
 }
 
 // TableName 指定表名

db/repo/api_access_log_repository.go

@@ -0,0 +1,169 @@
+package repo
+
+import (
+	"encoding/json"
+	"time"
+
+	"github.com/ctwj/urldb/db/entity"
+	"github.com/ctwj/urldb/utils"
+
+	"gorm.io/gorm"
+)
+
+// APIAccessLogRepository API访问日志Repository接口
+type APIAccessLogRepository interface {
+	BaseRepository[entity.APIAccessLog]
+	RecordAccess(ip, userAgent, endpoint, method string, requestParams interface{}, responseStatus int, responseData interface{}, processCount int, errorMessage string, processingTime int64) error
+	GetSummary() (*entity.APIAccessLogSummary, error)
+	GetStatsByEndpoint() ([]entity.APIAccessLogStats, error)
+	FindWithFilters(page, limit int, startDate, endDate *time.Time, endpoint, ip string) ([]entity.APIAccessLog, int64, error)
+	ClearOldLogs(days int) error
+}
+
+// APIAccessLogRepositoryImpl API访问日志Repository实现
+type APIAccessLogRepositoryImpl struct {
+	BaseRepositoryImpl[entity.APIAccessLog]
+}
+
+// NewAPIAccessLogRepository 创建API访问日志Repository
+func NewAPIAccessLogRepository(db *gorm.DB) APIAccessLogRepository {
+	return &APIAccessLogRepositoryImpl{
+		BaseRepositoryImpl: BaseRepositoryImpl[entity.APIAccessLog]{db: db},
+	}
+}
+
+// RecordAccess 记录API访问
+func (r *APIAccessLogRepositoryImpl) RecordAccess(ip, userAgent, endpoint, method string, requestParams interface{}, responseStatus int, responseData interface{}, processCount int, errorMessage string, processingTime int64) error {
+	log := entity.APIAccessLog{
+		IP:             ip,
+		UserAgent:      userAgent,
+		Endpoint:       endpoint,
+		Method:         method,
+		ResponseStatus: responseStatus,
+		ProcessCount:   processCount,
+		ErrorMessage:   errorMessage,
+		ProcessingTime: processingTime,
+	}
+
+	// 序列化请求参数
+	if requestParams != nil {
+		if paramsJSON, err := json.Marshal(requestParams); err == nil {
+			log.RequestParams = string(paramsJSON)
+		}
+	}
+
+	// 序列化响应数据（限制大小，避免存储大量数据）
+	if responseData != nil {
+		if dataJSON, err := json.Marshal(responseData); err == nil {
+			// 限制响应数据长度，避免存储过多数据
+			dataStr := string(dataJSON)
+			if len(dataStr) > 2000 {
+				dataStr = dataStr[:2000] + "..."
+			}
+			log.ResponseData = dataStr
+		}
+	}
+
+	return r.db.Create(&log).Error
+}
+
+// GetSummary 获取访问日志汇总
+func (r *APIAccessLogRepositoryImpl) GetSummary() (*entity.APIAccessLogSummary, error) {
+	var summary entity.APIAccessLogSummary
+	now := utils.GetCurrentTime()
+	todayStr := now.Format(utils.TimeFormatDate)
+	weekStart := now.AddDate(0, 0, -int(now.Weekday())+1).Format(utils.TimeFormatDate)
+	monthStart := now.Format("2006-01") + "-01"
+
+	// 总请求数
+	if err := r.db.Model(&entity.APIAccessLog{}).Count(&summary.TotalRequests).Error; err != nil {
+		return nil, err
+	}
+
+	// 今日请求数
+	if err := r.db.Model(&entity.APIAccessLog{}).Where("DATE(created_at) = ?", todayStr).Count(&summary.TodayRequests).Error; err != nil {
+		return nil, err
+	}
+
+	// 本周请求数
+	if err := r.db.Model(&entity.APIAccessLog{}).Where("created_at >= ?", weekStart).Count(&summary.WeekRequests).Error; err != nil {
+		return nil, err
+	}
+
+	// 本月请求数
+	if err := r.db.Model(&entity.APIAccessLog{}).Where("created_at >= ?", monthStart).Count(&summary.MonthRequests).Error; err != nil {
+		return nil, err
+	}
+
+	// 错误请求数
+	if err := r.db.Model(&entity.APIAccessLog{}).Where("response_status >= 400").Count(&summary.ErrorRequests).Error; err != nil {
+		return nil, err
+	}
+
+	// 唯一IP数
+	if err := r.db.Model(&entity.APIAccessLog{}).Distinct("ip").Count(&summary.UniqueIPs).Error; err != nil {
+		return nil, err
+	}
+
+	return &summary, nil
+}
+
+// GetStatsByEndpoint 按端点获取统计
+func (r *APIAccessLogRepositoryImpl) GetStatsByEndpoint() ([]entity.APIAccessLogStats, error) {
+	var stats []entity.APIAccessLogStats
+
+	query := `
+		SELECT
+			endpoint,
+			method,
+			COUNT(*) as request_count,
+			SUM(CASE WHEN response_status >= 400 THEN 1 ELSE 0 END) as error_count,
+			AVG(processing_time) as avg_process_time,
+			MAX(created_at) as last_access
+		FROM api_access_logs
+		WHERE deleted_at IS NULL
+		GROUP BY endpoint, method
+		ORDER BY request_count DESC
+	`
+
+	err := r.db.Raw(query).Scan(&stats).Error
+	return stats, err
+}
+
+// FindWithFilters 带过滤条件的分页查找访问日志
+func (r *APIAccessLogRepositoryImpl) FindWithFilters(page, limit int, startDate, endDate *time.Time, endpoint, ip string) ([]entity.APIAccessLog, int64, error) {
+	var logs []entity.APIAccessLog
+	var total int64
+
+	offset := (page - 1) * limit
+	query := r.db.Model(&entity.APIAccessLog{})
+
+	// 添加过滤条件
+	if startDate != nil {
+		query = query.Where("created_at >= ?", *startDate)
+	}
+	if endDate != nil {
+		query = query.Where("created_at <= ?", *endDate)
+	}
+	if endpoint != "" {
+		query = query.Where("endpoint LIKE ?", "%"+endpoint+"%")
+	}
+	if ip != "" {
+		query = query.Where("ip = ?", ip)
+	}
+
+	// 获取总数
+	if err := query.Count(&total).Error; err != nil {
+		return nil, 0, err
+	}
+
+	// 获取分页数据，按创建时间倒序排列
+	err := query.Order("created_at DESC").Offset(offset).Limit(limit).Find(&logs).Error
+	return logs, total, err
+}
+
+// ClearOldLogs 清理旧日志
+func (r *APIAccessLogRepositoryImpl) ClearOldLogs(days int) error {
+	cutoffDate := utils.GetCurrentTime().AddDate(0, 0, -days)
+	return r.db.Where("created_at < ?", cutoffDate).Delete(&entity.APIAccessLog{}).Error
+}

db/repo/cks_repository.go

@@ -1,7 +1,10 @@
 package repo
 
 import (
+	"time"
+
 	"github.com/ctwj/urldb/db/entity"
+	"github.com/ctwj/urldb/utils"
 
 	"gorm.io/gorm"
 )
@@ -66,20 +69,28 @@ func (r *CksRepositoryImpl) FindAll() ([]entity.Cks, error) {
 
 // FindByID 根据ID查找Cks，预加载Pan关联数据
 func (r *CksRepositoryImpl) FindByID(id uint) (*entity.Cks, error) {
+	startTime := utils.GetCurrentTime()
 	var cks entity.Cks
 	err := r.db.Preload("Pan").First(&cks, id).Error
+	queryDuration := time.Since(startTime)
 	if err != nil {
+		utils.Debug("FindByID失败: ID=%d, 错误=%v, 查询耗时=%v", id, err, queryDuration)
 		return nil, err
 	}
+	utils.Debug("FindByID成功: ID=%d, 查询耗时=%v", id, queryDuration)
 	return &cks, nil
 }
 
 func (r *CksRepositoryImpl) FindByIds(ids []uint) ([]*entity.Cks, error) {
+	startTime := utils.GetCurrentTime()
 	var cks []*entity.Cks
 	err := r.db.Preload("Pan").Where("id IN ?", ids).Find(&cks).Error
+	queryDuration := time.Since(startTime)
 	if err != nil {
+		utils.Debug("FindByIds失败: IDs数量=%d, 错误=%v, 查询耗时=%v", len(ids), err, queryDuration)
 		return nil, err
 	}
+	utils.Debug("FindByIds成功: 找到%d个账号，查询耗时=%v", len(cks), queryDuration)
 	return cks, nil
 }
 

db/repo/copyright_claim_repository.go

@@ -0,0 +1,87 @@
+package repo
+
+import (
+	"gorm.io/gorm"
+	"github.com/ctwj/urldb/db/entity"
+)
+
+// CopyrightClaimRepository 版权申述Repository接口
+type CopyrightClaimRepository interface {
+	BaseRepository[entity.CopyrightClaim]
+	GetByResourceKey(resourceKey string) ([]*entity.CopyrightClaim, error)
+	List(status string, page, pageSize int) ([]*entity.CopyrightClaim, int64, error)
+	UpdateStatus(id uint, status string, processedBy *uint, note string) error
+	// 兼容原有方法名
+	GetByID(id uint) (*entity.CopyrightClaim, error)
+}
+
+// CopyrightClaimRepositoryImpl 版权申述Repository实现
+type CopyrightClaimRepositoryImpl struct {
+	BaseRepositoryImpl[entity.CopyrightClaim]
+}
+
+// NewCopyrightClaimRepository 创建版权申述Repository
+func NewCopyrightClaimRepository(db *gorm.DB) CopyrightClaimRepository {
+	return &CopyrightClaimRepositoryImpl{
+		BaseRepositoryImpl: BaseRepositoryImpl[entity.CopyrightClaim]{db: db},
+	}
+}
+
+// Create 创建版权申述
+func (r *CopyrightClaimRepositoryImpl) Create(claim *entity.CopyrightClaim) error {
+	return r.GetDB().Create(claim).Error
+}
+
+// GetByID 根据ID获取版权申述
+func (r *CopyrightClaimRepositoryImpl) GetByID(id uint) (*entity.CopyrightClaim, error) {
+	var claim entity.CopyrightClaim
+	err := r.GetDB().Where("id = ?", id).First(&claim).Error
+	return &claim, err
+}
+
+// GetByResourceKey 获取某个资源的所有版权申述
+func (r *CopyrightClaimRepositoryImpl) GetByResourceKey(resourceKey string) ([]*entity.CopyrightClaim, error) {
+	var claims []*entity.CopyrightClaim
+	err := r.GetDB().Where("resource_key = ?", resourceKey).Find(&claims).Error
+	return claims, err
+}
+
+// List 获取版权申述列表
+func (r *CopyrightClaimRepositoryImpl) List(status string, page, pageSize int) ([]*entity.CopyrightClaim, int64, error) {
+	var claims []*entity.CopyrightClaim
+	var total int64
+
+	query := r.GetDB().Model(&entity.CopyrightClaim{})
+
+	if status != "" {
+		query = query.Where("status = ?", status)
+	}
+
+	// 获取总数
+	query.Count(&total)
+
+	// 分页查询
+	offset := (page - 1) * pageSize
+	err := query.Offset(offset).Limit(pageSize).Order("created_at DESC").Find(&claims).Error
+	return claims, total, err
+}
+
+// Update 更新版权申述
+func (r *CopyrightClaimRepositoryImpl) Update(claim *entity.CopyrightClaim) error {
+	return r.GetDB().Save(claim).Error
+}
+
+// UpdateStatus 更新版权申述状态
+func (r *CopyrightClaimRepositoryImpl) UpdateStatus(id uint, status string, processedBy *uint, note string) error {
+	return r.GetDB().Model(&entity.CopyrightClaim{}).Where("id = ?", id).Updates(map[string]interface{}{
+		"status":        status,
+		"processed_at":  gorm.Expr("NOW()"),
+		"processed_by":  processedBy,
+		"note":          note,
+	}).Error
+}
+
+// Delete 删除版权申述
+func (r *CopyrightClaimRepositoryImpl) Delete(id uint) error {
+	return r.GetDB().Delete(&entity.CopyrightClaim{}, id).Error
+}

db/repo/manager.go

@@ -21,6 +21,9 @@ type RepositoryManager struct {
 	TaskItemRepository        TaskItemRepository
 	FileRepository            FileRepository
 	TelegramChannelRepository TelegramChannelRepository
+	APIAccessLogRepository    APIAccessLogRepository
+	ReportRepository          ReportRepository
+	CopyrightClaimRepository  CopyrightClaimRepository
 }
 
 // NewRepositoryManager 创建Repository管理器
@@ -41,5 +44,8 @@ func NewRepositoryManager(db *gorm.DB) *RepositoryManager {
 		TaskItemRepository:        NewTaskItemRepository(db),
 		FileRepository:            NewFileRepository(db),
 		TelegramChannelRepository: NewTelegramChannelRepository(db),
+		APIAccessLogRepository:    NewAPIAccessLogRepository(db),
+		ReportRepository:          NewReportRepository(db),
+		CopyrightClaimRepository:  NewCopyrightClaimRepository(db),
 	}
 }

db/repo/pagination.go

@@ -0,0 +1,114 @@
+package repo
+
+import (
+	"gorm.io/gorm"
+)
+
+// PaginationResult 分页查询结果
+type PaginationResult[T any] struct {
+	Data       []T   `json:"data"`
+	Total      int64 `json:"total"`
+	Page       int   `json:"page"`
+	PageSize   int   `json:"page_size"`
+	TotalPages int   `json:"total_pages"`
+}
+
+// PaginationOptions 分页查询选项
+type PaginationOptions struct {
+	Page     int                    `json:"page"`
+	PageSize int                    `json:"page_size"`
+	OrderBy  string                 `json:"order_by"`
+	OrderDir string                 `json:"order_dir"` // asc or desc
+	Preloads []string               `json:"preloads"`  // 需要预加载的关联
+	Filters  map[string]interface{} `json:"filters"`   // 过滤条件
+}
+
+// DefaultPaginationOptions 默认分页选项
+func DefaultPaginationOptions() *PaginationOptions {
+	return &PaginationOptions{
+		Page:     1,
+		PageSize: 20,
+		OrderBy:  "id",
+		OrderDir: "desc",
+		Preloads: []string{},
+		Filters:  make(map[string]interface{}),
+	}
+}
+
+// PaginatedQuery 通用分页查询函数
+func PaginatedQuery[T any](db *gorm.DB, options *PaginationOptions) (*PaginationResult[T], error) {
+	// 验证分页参数
+	if options.Page < 1 {
+		options.Page = 1
+	}
+	if options.PageSize < 1 || options.PageSize > 1000 {
+		options.PageSize = 20
+	}
+
+	// 应用预加载
+	query := db.Model(new(T))
+	for _, preload := range options.Preloads {
+		query = query.Preload(preload)
+	}
+
+	// 应用过滤条件
+	for key, value := range options.Filters {
+		// 处理特殊过滤条件
+		switch key {
+		case "search":
+			// 搜索条件需要特殊处理
+			if searchStr, ok := value.(string); ok && searchStr != "" {
+				query = query.Where("title ILIKE ? OR description ILIKE ?", "%"+searchStr+"%", "%"+searchStr+"%")
+			}
+		case "category_id":
+			if categoryID, ok := value.(uint); ok {
+				query = query.Where("category_id = ?", categoryID)
+			}
+		case "pan_id":
+			if panID, ok := value.(uint); ok {
+				query = query.Where("pan_id = ?", panID)
+			}
+		case "is_valid":
+			if isValid, ok := value.(bool); ok {
+				query = query.Where("is_valid = ?", isValid)
+			}
+		case "is_public":
+			if isPublic, ok := value.(bool); ok {
+				query = query.Where("is_public = ?", isPublic)
+			}
+		default:
+			// 通用过滤条件
+			query = query.Where(key+" = ?", value)
+		}
+	}
+
+	// 应用排序
+	orderClause := options.OrderBy + " " + options.OrderDir
+	query = query.Order(orderClause)
+
+	// 计算偏移量
+	offset := (options.Page - 1) * options.PageSize
+
+	// 获取总数
+	var total int64
+	if err := query.Count(&total).Error; err != nil {
+		return nil, err
+	}
+
+	// 查询数据
+	var data []T
+	if err := query.Offset(offset).Limit(options.PageSize).Find(&data).Error; err != nil {
+		return nil, err
+	}
+
+	// 计算总页数
+	totalPages := int((total + int64(options.PageSize) - 1) / int64(options.PageSize))
+
+	return &PaginationResult[T]{
+		Data:       data,
+		Total:      total,
+		Page:       options.Page,
+		PageSize:   options.PageSize,
+		TotalPages: totalPages,
+	}, nil
+}

db/repo/report_repository.go

@@ -0,0 +1,87 @@
+package repo
+
+import (
+	"gorm.io/gorm"
+	"github.com/ctwj/urldb/db/entity"
+)
+
+// ReportRepository 举报Repository接口
+type ReportRepository interface {
+	BaseRepository[entity.Report]
+	GetByResourceKey(resourceKey string) ([]*entity.Report, error)
+	List(status string, page, pageSize int) ([]*entity.Report, int64, error)
+	UpdateStatus(id uint, status string, processedBy *uint, note string) error
+	// 兼容原有方法名
+	GetByID(id uint) (*entity.Report, error)
+}
+
+// ReportRepositoryImpl 举报Repository实现
+type ReportRepositoryImpl struct {
+	BaseRepositoryImpl[entity.Report]
+}
+
+// NewReportRepository 创建举报Repository
+func NewReportRepository(db *gorm.DB) ReportRepository {
+	return &ReportRepositoryImpl{
+		BaseRepositoryImpl: BaseRepositoryImpl[entity.Report]{db: db},
+	}
+}
+
+// Create 创建举报
+func (r *ReportRepositoryImpl) Create(report *entity.Report) error {
+	return r.GetDB().Create(report).Error
+}
+
+// GetByID 根据ID获取举报
+func (r *ReportRepositoryImpl) GetByID(id uint) (*entity.Report, error) {
+	var report entity.Report
+	err := r.GetDB().Where("id = ?", id).First(&report).Error
+	return &report, err
+}
+
+// GetByResourceKey 获取某个资源的所有举报
+func (r *ReportRepositoryImpl) GetByResourceKey(resourceKey string) ([]*entity.Report, error) {
+	var reports []*entity.Report
+	err := r.GetDB().Where("resource_key = ?", resourceKey).Find(&reports).Error
+	return reports, err
+}
+
+// List 获取举报列表
+func (r *ReportRepositoryImpl) List(status string, page, pageSize int) ([]*entity.Report, int64, error) {
+	var reports []*entity.Report
+	var total int64
+
+	query := r.GetDB().Model(&entity.Report{})
+
+	if status != "" {
+		query = query.Where("status = ?", status)
+	}
+
+	// 获取总数
+	query.Count(&total)
+
+	// 分页查询
+	offset := (page - 1) * pageSize
+	err := query.Offset(offset).Limit(pageSize).Order("created_at DESC").Find(&reports).Error
+	return reports, total, err
+}
+
+// Update 更新举报
+func (r *ReportRepositoryImpl) Update(report *entity.Report) error {
+	return r.GetDB().Save(report).Error
+}
+
+// UpdateStatus 更新举报状态
+func (r *ReportRepositoryImpl) UpdateStatus(id uint, status string, processedBy *uint, note string) error {
+	return r.GetDB().Model(&entity.Report{}).Where("id = ?", id).Updates(map[string]interface{}{
+		"status":        status,
+		"processed_at":  gorm.Expr("NOW()"),
+		"processed_by":  processedBy,
+		"note":          note,
+	}).Error
+}
+
+// Delete 删除举报
+func (r *ReportRepositoryImpl) Delete(id uint) error {
+	return r.GetDB().Delete(&entity.Report{}, id).Error
+}

db/repo/resource_repository.go

@@ -2,9 +2,12 @@ package repo
 
 import (
 	"fmt"
+	"strconv"
+	"strings"
 	"time"
 
 	"github.com/ctwj/urldb/db/entity"
+	"github.com/ctwj/urldb/utils"
 	"gorm.io/gorm"
 )
 
@@ -43,6 +46,11 @@ type ResourceRepository interface {
 	MarkAllAsUnsyncedToMeilisearch() error
 	FindAllWithPagination(page, limit int) ([]entity.Resource, int64, error)
 	GetRandomResourceWithFilters(categoryFilter, tagFilter string, isPushSavedInfo bool) (*entity.Resource, error)
+	DeleteRelatedResources(ckID uint) (int64, error)
+	CountResourcesByCkID(ckID uint) (int64, error)
+	FindByResourceKey(key string) ([]entity.Resource, error)
+	FindByKey(key string) ([]entity.Resource, error)
+	GetHotResources(limit int) ([]entity.Resource, error)
 }
 
 // ResourceRepositoryImpl Resource的Repository实现
@@ -68,38 +76,21 @@ func (r *ResourceRepositoryImpl) FindWithRelations() ([]entity.Resource, error)
 
 // FindWithRelationsPaginated 分页查找包含关联关系的资源
 func (r *ResourceRepositoryImpl) FindWithRelationsPaginated(page, limit int) ([]entity.Resource, int64, error) {
-	var resources []entity.Resource
-	var total int64
-
-	offset := (page - 1) * limit
-
-	// 优化查询：只预加载必要的关联，并添加排序
-	db := r.db.Model(&entity.Resource{}).
-		Preload("Category").
-		Preload("Pan").
-		Order("updated_at DESC") // 按更新时间倒序，显示最新内容
-
-	// 获取总数（使用缓存键）
-	cacheKey := fmt.Sprintf("resources_total_%d_%d", page, limit)
-	if cached, exists := r.cache[cacheKey]; exists {
-		if totalCached, ok := cached.(int64); ok {
-			total = totalCached
-		}
-	} else {
-		if err := db.Count(&total).Error; err != nil {
-			return nil, 0, err
-		}
-		// 缓存总数（5分钟）
-		r.cache[cacheKey] = total
-		go func() {
-			time.Sleep(5 * time.Minute)
-			delete(r.cache, cacheKey)
-		}()
+	// 使用新的分页查询功能
+	options := &PaginationOptions{
+		Page:     page,
+		PageSize: limit,
+		OrderBy:  "updated_at",
+		OrderDir: "desc",
+		Preloads: []string{"Category", "Pan"},
 	}
 
-	// 获取分页数据
-	err := db.Offset(offset).Limit(limit).Find(&resources).Error
-	return resources, total, err
+	result, err := PaginatedQuery[entity.Resource](r.db, options)
+	if err != nil {
+		return nil, 0, err
+	}
+
+	return result.Data, result.Total, nil
 }
 
 // FindByCategoryID 根据分类ID查找
@@ -218,6 +209,7 @@ func (r *ResourceRepositoryImpl) SearchByPanID(query string, panID uint, page, l
 
 // SearchWithFilters 根据参数进行搜索
 func (r *ResourceRepositoryImpl) SearchWithFilters(params map[string]interface{}) ([]entity.Resource, int64, error) {
+	startTime := utils.GetCurrentTime()
 	var resources []entity.Resource
 	var total int64
 
@@ -255,6 +247,23 @@ func (r *ResourceRepositoryImpl) SearchWithFilters(params map[string]interface{}
 						Where("resource_tags.tag_id = ?", tagEntity.ID)
 				}
 			}
+		case "tag_ids": // 添加tag_ids参数支持（标签ID列表）
+			if tagIdsStr, ok := value.(string); ok && tagIdsStr != "" {
+				// 将逗号分隔的标签ID字符串转换为整数ID数组
+				tagIdStrs := strings.Split(tagIdsStr, ",")
+				var tagIds []uint
+				for _, idStr := range tagIdStrs {
+					idStr = strings.TrimSpace(idStr) // 去除空格
+					if id, err := strconv.ParseUint(idStr, 10, 32); err == nil {
+						tagIds = append(tagIds, uint(id))
+					}
+				}
+				if len(tagIds) > 0 {
+					// 通过中间表查找包含任一标签的资源
+					db = db.Joins("JOIN resource_tags ON resources.id = resource_tags.resource_id").
+						Where("resource_tags.tag_id IN ?", tagIds)
+				}
+			}
 		case "pan_id": // 添加pan_id参数支持
 			if panID, ok := value.(uint); ok {
 				db = db.Where("pan_id = ?", panID)
@@ -292,6 +301,20 @@ func (r *ResourceRepositoryImpl) SearchWithFilters(params map[string]interface{}
 					db = db.Where("pan_id = ?", panEntity.ID)
 				}
 			}
+		case "exclude_ids": // 添加exclude_ids参数支持
+			if excludeIDs, ok := value.([]uint); ok && len(excludeIDs) > 0 {
+				// 限制排除ID的数量，避免SQL语句过长
+				maxExcludeIDs := 5000 // 限制排除ID数量，避免SQL语句过长
+				if len(excludeIDs) > maxExcludeIDs {
+					// 只取最近的maxExcludeIDs个ID进行排除
+					startIndex := len(excludeIDs) - maxExcludeIDs
+					truncatedExcludeIDs := excludeIDs[startIndex:]
+					db = db.Where("id NOT IN ?", truncatedExcludeIDs)
+					utils.Debug("SearchWithFilters: 排除ID数量过多，截取最近%d个ID", len(truncatedExcludeIDs))
+				} else {
+					db = db.Where("id NOT IN ?", excludeIDs)
+				}
+			}
 		}
 	}
 
@@ -334,9 +357,37 @@ func (r *ResourceRepositoryImpl) SearchWithFilters(params map[string]interface{}
 	// 计算偏移量
 	offset := (page - 1) * pageSize
 
-	// 获取分页数据，按更新时间倒序
-	err := db.Order("updated_at DESC").Offset(offset).Limit(pageSize).Find(&resources).Error
-	fmt.Printf("查询结果: 总数=%d, 当前页数据量=%d, pageSize=%d\n", total, len(resources), pageSize)
+	// 处理排序参数
+	orderBy := "updated_at"
+	orderDir := "DESC"
+
+	if orderByVal, ok := params["order_by"].(string); ok && orderByVal != "" {
+		// 验证排序字段，防止SQL注入
+		validOrderByFields := map[string]bool{
+			"created_at":  true,
+			"updated_at":  true,
+			"view_count":  true,
+			"title":       true,
+			"id":          true,
+		}
+		if validOrderByFields[orderByVal] {
+			orderBy = orderByVal
+		}
+	}
+
+	if orderDirVal, ok := params["order_dir"].(string); ok && orderDirVal != "" {
+		// 验证排序方向
+		if orderDirVal == "ASC" || orderDirVal == "DESC" {
+			orderDir = orderDirVal
+		}
+	}
+
+	// 获取分页数据，应用排序
+	queryStart := utils.GetCurrentTime()
+	err := db.Order(fmt.Sprintf("%s %s", orderBy, orderDir)).Offset(offset).Limit(pageSize).Find(&resources).Error
+	queryDuration := time.Since(queryStart)
+	totalDuration := time.Since(startTime)
+	utils.Debug("SearchWithFilters完成: 总数=%d, 当前页数据量=%d, 排序=%s %s, 查询耗时=%v, 总耗时=%v", total, len(resources), orderBy, orderDir, queryDuration, totalDuration)
 	return resources, total, err
 }
 
@@ -469,11 +520,15 @@ func (r *ResourceRepositoryImpl) GetResourcesForTransfer(panID uint, sinceTime t
 
 // GetByURL 根据URL获取资源
 func (r *ResourceRepositoryImpl) GetByURL(url string) (*entity.Resource, error) {
+	startTime := utils.GetCurrentTime()
 	var resource entity.Resource
 	err := r.db.Where("url = ?", url).First(&resource).Error
+	queryDuration := time.Since(startTime)
 	if err != nil {
+		utils.Debug("GetByURL失败: URL=%s, 错误=%v, 查询耗时=%v", url, err, queryDuration)
 		return nil, err
 	}
+	utils.Debug("GetByURL成功: URL=%s, 查询耗时=%v", url, queryDuration)
 	return &resource, nil
 }
 
@@ -658,3 +713,89 @@ func (r *ResourceRepositoryImpl) GetRandomResourceWithFilters(categoryFilter, ta
 
 	return &resource, nil
 }
+
+// DeleteRelatedResources 删除关联资源，清空 fid、ck_id 和 save_url 三个字段
+func (r *ResourceRepositoryImpl) DeleteRelatedResources(ckID uint) (int64, error) {
+	result := r.db.Model(&entity.Resource{}).
+		Where("ck_id = ?", ckID).
+		Updates(map[string]interface{}{
+			"fid":      nil, // 清空 fid 字段
+			"ck_id":    0,   // 清空 ck_id 字段
+			"save_url": "",  // 清空 save_url 字段
+		})
+
+	if result.Error != nil {
+		return 0, result.Error
+	}
+
+	return result.RowsAffected, nil
+}
+
+// CountResourcesByCkID 统计指定账号ID的资源数量
+func (r *ResourceRepositoryImpl) CountResourcesByCkID(ckID uint) (int64, error) {
+	var count int64
+	err := r.db.Model(&entity.Resource{}).
+		Where("ck_id = ?", ckID).
+		Count(&count).Error
+	return count, err
+}
+
+// FindByKey 根据Key查找资源（同一组资源）
+func (r *ResourceRepositoryImpl) FindByKey(key string) ([]entity.Resource, error) {
+	var resources []entity.Resource
+	err := r.db.Where("key = ?", key).
+		Preload("Category").
+		Preload("Pan").
+		Preload("Tags").
+		Order("pan_id ASC").
+		Find(&resources).Error
+	return resources, err
+}
+
+// GetHotResources 获取热门资源（按查看次数排序，去重，限制数量）
+func (r *ResourceRepositoryImpl) GetHotResources(limit int) ([]entity.Resource, error) {
+	var resources []entity.Resource
+
+	// 按key分组，获取每个key中查看次数最高的资源，然后按查看次数排序
+	err := r.db.Table("resources").
+		Select(`
+			resources.*,
+			ROW_NUMBER() OVER (PARTITION BY key ORDER BY view_count DESC) as rn
+		`).
+		Where("is_public = ? AND view_count > 0", true).
+		Preload("Category").
+		Preload("Pan").
+		Preload("Tags").
+		Order("view_count DESC").
+		Limit(limit * 2). // 获取更多数据以确保去重后有足够的结果
+		Find(&resources).Error
+
+	if err != nil {
+		return nil, err
+	}
+
+	// 按key去重，保留每个key的第一个（即查看次数最高的）
+	seenKeys := make(map[string]bool)
+	var hotResources []entity.Resource
+	for _, resource := range resources {
+		if !seenKeys[resource.Key] {
+			seenKeys[resource.Key] = true
+			hotResources = append(hotResources, resource)
+			if len(hotResources) >= limit {
+				break
+			}
+		}
+	}
+
+	return hotResources, nil
+}
+
+// FindByResourceKey 根据资源Key查找资源
+func (r *ResourceRepositoryImpl) FindByResourceKey(key string) ([]entity.Resource, error) {
+	var resources []entity.Resource
+	err := r.GetDB().Where("key = ?", key).Find(&resources).Error
+	if err != nil {
+		return nil, err
+	}
+	return resources, nil
+}

db/repo/system_config_repository.go

@@ -3,6 +3,7 @@ package repo
 import (
 	"fmt"
 	"sync"
+	"time"
 
 	"github.com/ctwj/urldb/db/entity"
 	"github.com/ctwj/urldb/utils"
@@ -100,8 +101,11 @@ func (r *SystemConfigRepositoryImpl) UpsertConfigs(configs []entity.SystemConfig
 
 // GetOrCreateDefault 获取配置或创建默认配置
 func (r *SystemConfigRepositoryImpl) GetOrCreateDefault() ([]entity.SystemConfig, error) {
+	startTime := utils.GetCurrentTime()
 	configs, err := r.FindAll()
+	initialQueryDuration := time.Since(startTime)
 	if err != nil {
+		utils.Error("获取所有系统配置失败: %v，耗时: %v", err, initialQueryDuration)
 		return nil, err
 	}
 
@@ -133,13 +137,24 @@ func (r *SystemConfigRepositoryImpl) GetOrCreateDefault() ([]entity.SystemConfig
 			{Key: entity.ConfigKeyMeilisearchPort, Value: entity.ConfigDefaultMeilisearchPort, Type: entity.ConfigTypeString},
 			{Key: entity.ConfigKeyMeilisearchMasterKey, Value: entity.ConfigDefaultMeilisearchMasterKey, Type: entity.ConfigTypeString},
 			{Key: entity.ConfigKeyMeilisearchIndexName, Value: entity.ConfigDefaultMeilisearchIndexName, Type: entity.ConfigTypeString},
+			{Key: entity.ConfigKeyEnableAnnouncements, Value: entity.ConfigDefaultEnableAnnouncements, Type: entity.ConfigTypeBool},
+			{Key: entity.ConfigKeyAnnouncements, Value: entity.ConfigDefaultAnnouncements, Type: entity.ConfigTypeJSON},
+			{Key: entity.ConfigKeyEnableFloatButtons, Value: entity.ConfigDefaultEnableFloatButtons, Type: entity.ConfigTypeBool},
+			{Key: entity.ConfigKeyWechatSearchImage, Value: entity.ConfigDefaultWechatSearchImage, Type: entity.ConfigTypeString},
+			{Key: entity.ConfigKeyTelegramQrImage, Value: entity.ConfigDefaultTelegramQrImage, Type: entity.ConfigTypeString},
+			{Key: entity.ConfigKeyQrCodeStyle, Value: entity.ConfigDefaultQrCodeStyle, Type: entity.ConfigTypeString},
 		}
 
+		createStart := utils.GetCurrentTime()
 		err = r.UpsertConfigs(defaultConfigs)
+		createDuration := time.Since(createStart)
 		if err != nil {
+			utils.Error("创建默认系统配置失败: %v，耗时: %v", err, createDuration)
 			return nil, err
 		}
 
+		totalDuration := time.Since(startTime)
+		utils.Info("创建默认系统配置成功，数量: %d，总耗时: %v", len(defaultConfigs), totalDuration)
 		return defaultConfigs, nil
 	}
 
@@ -169,6 +184,11 @@ func (r *SystemConfigRepositoryImpl) GetOrCreateDefault() ([]entity.SystemConfig
 		entity.ConfigKeyMeilisearchPort:           {Key: entity.ConfigKeyMeilisearchPort, Value: entity.ConfigDefaultMeilisearchPort, Type: entity.ConfigTypeString},
 		entity.ConfigKeyMeilisearchMasterKey:      {Key: entity.ConfigKeyMeilisearchMasterKey, Value: entity.ConfigDefaultMeilisearchMasterKey, Type: entity.ConfigTypeString},
 		entity.ConfigKeyMeilisearchIndexName:      {Key: entity.ConfigKeyMeilisearchIndexName, Value: entity.ConfigDefaultMeilisearchIndexName, Type: entity.ConfigTypeString},
+		entity.ConfigKeyEnableAnnouncements:       {Key: entity.ConfigKeyEnableAnnouncements, Value: entity.ConfigDefaultEnableAnnouncements, Type: entity.ConfigTypeBool},
+		entity.ConfigKeyAnnouncements:             {Key: entity.ConfigKeyAnnouncements, Value: entity.ConfigDefaultAnnouncements, Type: entity.ConfigTypeJSON},
+		entity.ConfigKeyEnableFloatButtons:        {Key: entity.ConfigKeyEnableFloatButtons, Value: entity.ConfigDefaultEnableFloatButtons, Type: entity.ConfigTypeBool},
+		entity.ConfigKeyWechatSearchImage:         {Key: entity.ConfigKeyWechatSearchImage, Value: entity.ConfigDefaultWechatSearchImage, Type: entity.ConfigTypeString},
+		entity.ConfigKeyTelegramQrImage:           {Key: entity.ConfigKeyTelegramQrImage, Value: entity.ConfigDefaultTelegramQrImage, Type: entity.ConfigTypeString},
 	}
 
 	// 检查现有配置中是否有缺失的配置项
@@ -187,17 +207,24 @@ func (r *SystemConfigRepositoryImpl) GetOrCreateDefault() ([]entity.SystemConfig
 
 	// 如果有缺失的配置项，则添加它们
 	if len(missingConfigs) > 0 {
+		upsertStart := utils.GetCurrentTime()
 		err = r.UpsertConfigs(missingConfigs)
+		upsertDuration := time.Since(upsertStart)
 		if err != nil {
+			utils.Error("添加缺失的系统配置失败: %v，耗时: %v", err, upsertDuration)
 			return nil, err
 		}
+		utils.Debug("添加缺失的系统配置完成，数量: %d，耗时: %v", len(missingConfigs), upsertDuration)
 		// 重新获取所有配置
 		configs, err = r.FindAll()
 		if err != nil {
+			utils.Error("重新获取所有系统配置失败: %v", err)
 			return nil, err
 		}
 	}
 
+	totalDuration := time.Since(startTime)
+	utils.Debug("GetOrCreateDefault完成，总数: %d，总耗时: %v", len(configs), totalDuration)
 	return configs, nil
 }
 

db/repo/task_item_repository.go

@@ -1,7 +1,10 @@
 package repo
 
 import (
+	"time"
+
 	"github.com/ctwj/urldb/db/entity"
+	"github.com/ctwj/urldb/utils"
 	"gorm.io/gorm"
 )
 
@@ -58,8 +61,15 @@ func (r *TaskItemRepositoryImpl) DeleteByTaskID(taskID uint) error {
 
 // GetByTaskIDAndStatus 根据任务ID和状态获取任务项
 func (r *TaskItemRepositoryImpl) GetByTaskIDAndStatus(taskID uint, status string) ([]*entity.TaskItem, error) {
+	startTime := utils.GetCurrentTime()
 	var items []*entity.TaskItem
 	err := r.db.Where("task_id = ? AND status = ?", taskID, status).Order("id ASC").Find(&items).Error
+	queryDuration := time.Since(startTime)
+	if err != nil {
+		utils.Error("GetByTaskIDAndStatus失败: 任务ID=%d, 状态=%s, 错误=%v, 查询耗时=%v", taskID, status, err, queryDuration)
+		return nil, err
+	}
+	utils.Debug("GetByTaskIDAndStatus成功: 任务ID=%d, 状态=%s, 数量=%d, 查询耗时=%v", taskID, status, len(items), queryDuration)
 	return items, err
 }
 
@@ -93,19 +103,36 @@ func (r *TaskItemRepositoryImpl) GetListByTaskID(taskID uint, page, pageSize int
 
 // UpdateStatus 更新任务项状态
 func (r *TaskItemRepositoryImpl) UpdateStatus(id uint, status string) error {
-	return r.db.Model(&entity.TaskItem{}).Where("id = ?", id).Update("status", status).Error
+	startTime := utils.GetCurrentTime()
+	err := r.db.Model(&entity.TaskItem{}).Where("id = ?", id).Update("status", status).Error
+	updateDuration := time.Since(startTime)
+	if err != nil {
+		utils.Error("UpdateStatus失败: ID=%d, 状态=%s, 错误=%v, 更新耗时=%v", id, status, err, updateDuration)
+		return err
+	}
+	utils.Debug("UpdateStatus成功: ID=%d, 状态=%s, 更新耗时=%v", id, status, updateDuration)
+	return nil
 }
 
 // UpdateStatusAndOutput 更新任务项状态和输出数据
 func (r *TaskItemRepositoryImpl) UpdateStatusAndOutput(id uint, status, outputData string) error {
-	return r.db.Model(&entity.TaskItem{}).Where("id = ?", id).Updates(map[string]interface{}{
+	startTime := utils.GetCurrentTime()
+	err := r.db.Model(&entity.TaskItem{}).Where("id = ?", id).Updates(map[string]interface{}{
 		"status":      status,
 		"output_data": outputData,
 	}).Error
+	updateDuration := time.Since(startTime)
+	if err != nil {
+		utils.Error("UpdateStatusAndOutput失败: ID=%d, 状态=%s, 错误=%v, 更新耗时=%v", id, status, err, updateDuration)
+		return err
+	}
+	utils.Debug("UpdateStatusAndOutput成功: ID=%d, 状态=%s, 更新耗时=%v", id, status, updateDuration)
+	return nil
 }
 
 // GetStatsByTaskID 获取任务项统计信息
 func (r *TaskItemRepositoryImpl) GetStatsByTaskID(taskID uint) (map[string]int, error) {
+	startTime := utils.GetCurrentTime()
 	var results []struct {
 		Status string
 		Count  int
@@ -117,7 +144,9 @@ func (r *TaskItemRepositoryImpl) GetStatsByTaskID(taskID uint) (map[string]int,
 		Group("status").
 		Find(&results).Error
 
+	queryDuration := time.Since(startTime)
 	if err != nil {
+		utils.Error("GetStatsByTaskID失败: 任务ID=%d, 错误=%v, 查询耗时=%v", taskID, err, queryDuration)
 		return nil, err
 	}
 
@@ -134,12 +163,22 @@ func (r *TaskItemRepositoryImpl) GetStatsByTaskID(taskID uint) (map[string]int,
 		stats["total"] += result.Count
 	}
 
+	totalDuration := time.Since(startTime)
+	utils.Debug("GetStatsByTaskID成功: 任务ID=%d, 统计信息=%v, 查询耗时=%v, 总耗时=%v", taskID, stats, queryDuration, totalDuration)
 	return stats, nil
 }
 
 // ResetProcessingItems 重置处理中的任务项为pending状态
 func (r *TaskItemRepositoryImpl) ResetProcessingItems(taskID uint) error {
-	return r.db.Model(&entity.TaskItem{}).
+	startTime := utils.GetCurrentTime()
+	err := r.db.Model(&entity.TaskItem{}).
 		Where("task_id = ? AND status = ?", taskID, "processing").
 		Update("status", "pending").Error
+	updateDuration := time.Since(startTime)
+	if err != nil {
+		utils.Error("ResetProcessingItems失败: 任务ID=%d, 错误=%v, 更新耗时=%v", taskID, err, updateDuration)
+		return err
+	}
+	utils.Debug("ResetProcessingItems成功: 任务ID=%d, 更新耗时=%v", taskID, updateDuration)
+	return nil
 }

db/repo/task_repository.go

@@ -4,6 +4,7 @@ import (
 	"time"
 
 	"github.com/ctwj/urldb/db/entity"
+	"github.com/ctwj/urldb/utils"
 	"gorm.io/gorm"
 )
 
@@ -35,11 +36,15 @@ func NewTaskRepository(db *gorm.DB) TaskRepository {
 
 // GetByID 根据ID获取任务
 func (r *TaskRepositoryImpl) GetByID(id uint) (*entity.Task, error) {
+	startTime := utils.GetCurrentTime()
 	var task entity.Task
 	err := r.db.First(&task, id).Error
+	queryDuration := time.Since(startTime)
 	if err != nil {
+		utils.Debug("GetByID失败: ID=%d, 错误=%v, 查询耗时=%v", id, err, queryDuration)
 		return nil, err
 	}
+	utils.Debug("GetByID成功: ID=%d, 查询耗时=%v", id, queryDuration)
 	return &task, nil
 }
 
@@ -55,6 +60,7 @@ func (r *TaskRepositoryImpl) Delete(id uint) error {
 
 // GetList 获取任务列表
 func (r *TaskRepositoryImpl) GetList(page, pageSize int, taskType, status string) ([]*entity.Task, int64, error) {
+	startTime := utils.GetCurrentTime()
 	var tasks []*entity.Task
 	var total int64
 
@@ -69,84 +75,171 @@ func (r *TaskRepositoryImpl) GetList(page, pageSize int, taskType, status string
 	}
 
 	// 获取总数
+	countStart := utils.GetCurrentTime()
 	err := query.Count(&total).Error
+	countDuration := time.Since(countStart)
 	if err != nil {
+		utils.Error("GetList获取总数失败: 错误=%v, 查询耗时=%v", err, countDuration)
 		return nil, 0, err
 	}
 
 	// 分页查询
 	offset := (page - 1) * pageSize
+	queryStart := utils.GetCurrentTime()
 	err = query.Offset(offset).Limit(pageSize).Order("created_at DESC").Find(&tasks).Error
+	queryDuration := time.Since(queryStart)
 	if err != nil {
+		utils.Error("GetList查询失败: 错误=%v, 查询耗时=%v", err, queryDuration)
 		return nil, 0, err
 	}
 
+	totalDuration := time.Since(startTime)
+	utils.Debug("GetList完成: 任务类型=%s, 状态=%s, 页码=%d, 页面大小=%d, 总数=%d, 结果数=%d, 总耗时=%v", taskType, status, page, pageSize, total, len(tasks), totalDuration)
 	return tasks, total, nil
 }
 
 // UpdateStatus 更新任务状态
 func (r *TaskRepositoryImpl) UpdateStatus(id uint, status string) error {
-	return r.db.Model(&entity.Task{}).Where("id = ?", id).Update("status", status).Error
+	startTime := utils.GetCurrentTime()
+	err := r.db.Model(&entity.Task{}).Where("id = ?", id).Update("status", status).Error
+	updateDuration := time.Since(startTime)
+	if err != nil {
+		utils.Error("UpdateStatus失败: ID=%d, 状态=%s, 错误=%v, 更新耗时=%v", id, status, err, updateDuration)
+		return err
+	}
+	utils.Debug("UpdateStatus成功: ID=%d, 状态=%s, 更新耗时=%v", id, status, updateDuration)
+	return nil
 }
 
 // UpdateProgress 更新任务进度
 func (r *TaskRepositoryImpl) UpdateProgress(id uint, progress float64, progressData string) error {
+	startTime := utils.GetCurrentTime()
 	// 检查progress和progress_data字段是否存在
 	var count int64
 	err := r.db.Raw("SELECT COUNT(*) FROM information_schema.columns WHERE table_name = 'tasks' AND column_name = 'progress'").Count(&count).Error
 	if err != nil || count == 0 {
 		// 如果检查失败或字段不存在，只更新processed_items等现有字段
-		return r.db.Model(&entity.Task{}).Where("id = ?", id).Updates(map[string]interface{}{
+		updateStart := utils.GetCurrentTime()
+		err := r.db.Model(&entity.Task{}).Where("id = ?", id).Updates(map[string]interface{}{
 			"processed_items": progress, // 使用progress作为processed_items的近似值
 		}).Error
+		updateDuration := time.Since(updateStart)
+		totalDuration := time.Since(startTime)
+		if err != nil {
+			utils.Error("UpdateProgress失败(字段不存在): ID=%d, 进度=%f, 错误=%v, 更新耗时=%v, 总耗时=%v", id, progress, err, updateDuration, totalDuration)
+			return err
+		}
+		utils.Debug("UpdateProgress成功(字段不存在): ID=%d, 进度=%f, 更新耗时=%v, 总耗时=%v", id, progress, updateDuration, totalDuration)
+		return nil
 	}
 
 	// 字段存在，正常更新
-	return r.db.Model(&entity.Task{}).Where("id = ?", id).Updates(map[string]interface{}{
+	updateStart := utils.GetCurrentTime()
+	err = r.db.Model(&entity.Task{}).Where("id = ?", id).Updates(map[string]interface{}{
 		"progress":      progress,
 		"progress_data": progressData,
 	}).Error
+	updateDuration := time.Since(updateStart)
+	totalDuration := time.Since(startTime)
+	if err != nil {
+		utils.Error("UpdateProgress失败: ID=%d, 进度=%f, 错误=%v, 更新耗时=%v, 总耗时=%v", id, progress, err, updateDuration, totalDuration)
+		return err
+	}
+	utils.Debug("UpdateProgress成功: ID=%d, 进度=%f, 更新耗时=%v, 总耗时=%v", id, progress, updateDuration, totalDuration)
+	return nil
 }
 
 // UpdateStatusAndMessage 更新任务状态和消息
 func (r *TaskRepositoryImpl) UpdateStatusAndMessage(id uint, status, message string) error {
+	startTime := utils.GetCurrentTime()
 	// 检查message字段是否存在
 	var count int64
 	err := r.db.Raw("SELECT COUNT(*) FROM information_schema.columns WHERE table_name = 'tasks' AND column_name = 'message'").Count(&count).Error
 	if err != nil {
 		// 如果检查失败，只更新状态
-		return r.db.Model(&entity.Task{}).Where("id = ?", id).Update("status", status).Error
+		updateStart := utils.GetCurrentTime()
+		err := r.db.Model(&entity.Task{}).Where("id = ?", id).Update("status", status).Error
+		updateDuration := time.Since(updateStart)
+		totalDuration := time.Since(startTime)
+		if err != nil {
+			utils.Error("UpdateStatusAndMessage失败(检查失败): ID=%d, 状态=%s, 错误=%v, 更新耗时=%v, 总耗时=%v", id, status, err, updateDuration, totalDuration)
+			return err
+		}
+		utils.Debug("UpdateStatusAndMessage成功(检查失败): ID=%d, 状态=%s, 更新耗时=%v, 总耗时=%v", id, status, updateDuration, totalDuration)
+		return nil
 	}
 
 	if count > 0 {
 		// message字段存在，更新状态和消息
-		return r.db.Model(&entity.Task{}).Where("id = ?", id).Updates(map[string]interface{}{
+		updateStart := utils.GetCurrentTime()
+		err := r.db.Model(&entity.Task{}).Where("id = ?", id).Updates(map[string]interface{}{
 			"status":  status,
 			"message": message,
 		}).Error
+		updateDuration := time.Since(updateStart)
+		totalDuration := time.Since(startTime)
+		if err != nil {
+			utils.Error("UpdateStatusAndMessage失败(字段存在): ID=%d, 状态=%s, 错误=%v, 更新耗时=%v, 总耗时=%v", id, status, err, updateDuration, totalDuration)
+			return err
+		}
+		utils.Debug("UpdateStatusAndMessage成功(字段存在): ID=%d, 状态=%s, 更新耗时=%v, 总耗时=%v", id, status, updateDuration, totalDuration)
+		return nil
 	} else {
 		// message字段不存在，只更新状态
-		return r.db.Model(&entity.Task{}).Where("id = ?", id).Update("status", status).Error
+		updateStart := utils.GetCurrentTime()
+		err := r.db.Model(&entity.Task{}).Where("id = ?", id).Update("status", status).Error
+		updateDuration := time.Since(updateStart)
+		totalDuration := time.Since(startTime)
+		if err != nil {
+			utils.Error("UpdateStatusAndMessage失败(字段不存在): ID=%d, 状态=%s, 错误=%v, 更新耗时=%v, 总耗时=%v", id, status, err, updateDuration, totalDuration)
+			return err
+		}
+		utils.Debug("UpdateStatusAndMessage成功(字段不存在): ID=%d, 状态=%s, 更新耗时=%v, 总耗时=%v", id, status, updateDuration, totalDuration)
+		return nil
 	}
 }
 
 // UpdateTaskStats 更新任务统计信息
 func (r *TaskRepositoryImpl) UpdateTaskStats(id uint, processed, success, failed int) error {
-	return r.db.Model(&entity.Task{}).Where("id = ?", id).Updates(map[string]interface{}{
+	startTime := utils.GetCurrentTime()
+	err := r.db.Model(&entity.Task{}).Where("id = ?", id).Updates(map[string]interface{}{
 		"processed_items": processed,
 		"success_items":   success,
 		"failed_items":    failed,
 	}).Error
+	updateDuration := time.Since(startTime)
+	if err != nil {
+		utils.Error("UpdateTaskStats失败: ID=%d, 处理数=%d, 成功数=%d, 失败数=%d, 错误=%v, 更新耗时=%v", id, processed, success, failed, err, updateDuration)
+		return err
+	}
+	utils.Debug("UpdateTaskStats成功: ID=%d, 处理数=%d, 成功数=%d, 失败数=%d, 更新耗时=%v", id, processed, success, failed, updateDuration)
+	return nil
 }
 
 // UpdateStartedAt 更新任务开始时间
 func (r *TaskRepositoryImpl) UpdateStartedAt(id uint) error {
+	startTime := utils.GetCurrentTime()
 	now := time.Now()
-	return r.db.Model(&entity.Task{}).Where("id = ?", id).Update("started_at", now).Error
+	err := r.db.Model(&entity.Task{}).Where("id = ?", id).Update("started_at", now).Error
+	updateDuration := time.Since(startTime)
+	if err != nil {
+		utils.Error("UpdateStartedAt失败: ID=%d, 错误=%v, 更新耗时=%v", id, err, updateDuration)
+		return err
+	}
+	utils.Debug("UpdateStartedAt成功: ID=%d, 更新耗时=%v", id, updateDuration)
+	return nil
 }
 
 // UpdateCompletedAt 更新任务完成时间
 func (r *TaskRepositoryImpl) UpdateCompletedAt(id uint) error {
+	startTime := utils.GetCurrentTime()
 	now := time.Now()
-	return r.db.Model(&entity.Task{}).Where("id = ?", id).Update("completed_at", now).Error
+	err := r.db.Model(&entity.Task{}).Where("id = ?", id).Update("completed_at", now).Error
+	updateDuration := time.Since(startTime)
+	if err != nil {
+		utils.Error("UpdateCompletedAt失败: ID=%d, 错误=%v, 更新耗时=%v", id, err, updateDuration)
+		return err
+	}
+	utils.Debug("UpdateCompletedAt成功: ID=%d, 更新耗时=%v", id, updateDuration)
+	return nil
 }

db/repo/telegram_channel_repository.go

@@ -16,6 +16,7 @@ type TelegramChannelRepository interface {
 	UpdateLastPushAt(id uint, lastPushAt time.Time) error
 	FindDueForPush() ([]entity.TelegramChannel, error)
 	CleanupDuplicateChannels() error
+	FindActiveChannelsByTypes(chatTypes []string) ([]entity.TelegramChannel, error)
 }
 
 type TelegramChannelRepositoryImpl struct {
@@ -80,6 +81,13 @@ func (r *TelegramChannelRepositoryImpl) FindByChatType(chatType string) ([]entit
 	return channels, err
 }
 
+// FindActiveChannelsByTypes 根据多个类型查找活跃频道/群组
+func (r *TelegramChannelRepositoryImpl) FindActiveChannelsByTypes(chatTypes []string) ([]entity.TelegramChannel, error) {
+	var channels []entity.TelegramChannel
+	err := r.db.Where("chat_type IN (?) AND is_active = ?", chatTypes, true).Find(&channels).Error
+	return channels, err
+}
+
 // UpdateLastPushAt 更新最后推送时间
 func (r *TelegramChannelRepositoryImpl) UpdateLastPushAt(id uint, lastPushAt time.Time) error {
 	return r.db.Model(&entity.TelegramChannel{}).Where("id = ?", id).Update("last_push_at", lastPushAt).Error

docker-compose.yml

@@ -20,7 +20,7 @@ services:
       - app-network
 
   backend:
-    image: ctwj/urldb-backend:1.2.5
+    image: ctwj/urldb-backend:1.3.4
     environment:
       DB_HOST: postgres
       DB_PORT: 5432
@@ -38,7 +38,7 @@ services:
       - app-network
 
   frontend:
-    image: ctwj/urldb-frontend:1.2.5
+    image: ctwj/urldb-frontend:1.3.4
     environment:
       NODE_ENV: production
       NUXT_PUBLIC_API_SERVER: http://backend:8080/api

docs/logging.md

@@ -0,0 +1,132 @@
+# 日志系统说明
+
+## 概述
+
+本项目使用自定义的日志系统，支持多种日志级别、环境差异化配置和结构化日志记录。
+
+## 日志级别
+
+日志系统支持以下级别（按严重程度递增）：
+
+1. **DEBUG** - 调试信息，用于开发和故障排除
+2. **INFO** - 一般信息，记录系统正常运行状态
+3. **WARN** - 警告信息，表示可能的问题但不影响系统运行
+4. **ERROR** - 错误信息，表示系统错误但可以继续运行
+5. **FATAL** - 致命错误，系统将退出
+
+## 环境配置
+
+### 日志级别配置
+
+可以通过环境变量配置日志级别：
+
+```bash
+# 设置日志级别（DEBUG, INFO, WARN, ERROR, FATAL）
+LOG_LEVEL=DEBUG
+
+# 或者启用调试模式（等同于DEBUG级别）
+DEBUG=true
+```
+
+默认情况下，开发环境使用DEBUG级别，生产环境使用INFO级别。
+
+### 结构化日志
+
+可以通过环境变量启用结构化日志（JSON格式）：
+
+```bash
+# 启用结构化日志
+STRUCTURED_LOG=true
+```
+
+## 使用方法
+
+### 基本日志记录
+
+```go
+import "github.com/ctwj/urldb/utils"
+
+// 基本日志记录
+utils.Debug("调试信息: %s", debugInfo)
+utils.Info("一般信息: %s", info)
+utils.Warn("警告信息: %s", warning)
+utils.Error("错误信息: %s", err)
+utils.Fatal("致命错误: %s", fatalErr) // 程序将退出
+```
+
+### 结构化日志记录
+
+结构化日志允许添加额外的字段信息，便于日志分析：
+
+```go
+// 带字段的结构化日志
+utils.DebugWithFields(map[string]interface{}{
+    "user_id": 123,
+    "action": "login",
+    "ip": "192.168.1.1",
+}, "用户登录调试信息")
+
+utils.InfoWithFields(map[string]interface{}{
+    "task_id": 456,
+    "status": "completed",
+    "duration_ms": 1250,
+}, "任务处理完成")
+
+utils.ErrorWithFields(map[string]interface{}{
+    "error_code": 500,
+    "error": "database connection failed",
+    "component": "database",
+}, "数据库连接失败: %v", err)
+```
+
+## 日志输出
+
+日志默认输出到：
+- 控制台（标准输出）
+- 文件（logs目录下的app_日期.log文件）
+
+日志文件支持轮转，单个文件最大100MB，最多保留5个备份文件，日志文件最长保留30天。
+
+## 最佳实践
+
+1. **选择合适的日志级别**：
+   - DEBUG：详细的调试信息，仅在开发和故障排除时使用
+   - INFO：重要的业务流程和状态变更
+   - WARN：可预期的问题和异常情况
+   - ERROR：系统错误和异常
+   - FATAL：系统无法继续运行的致命错误
+
+2. **使用结构化日志**：
+   - 对于需要后续分析的日志，使用结构化日志
+   - 添加有意义的字段，如用户ID、任务ID、请求ID等
+   - 避免在字段中包含敏感信息
+
+3. **性能监控**：
+   - 记录关键操作的执行时间
+   - 使用duration_ms字段记录毫秒级耗时
+
+4. **安全日志**：
+   - 记录所有认证和授权相关的操作
+   - 包含客户端IP和用户信息
+   - 记录失败的访问尝试
+
+## 示例
+
+```go
+// 性能监控示例
+startTime := time.Now()
+// 执行操作...
+duration := time.Since(startTime)
+utils.DebugWithFields(map[string]interface{}{
+    "operation": "database_query",
+    "duration_ms": duration.Milliseconds(),
+}, "数据库查询完成，耗时: %v", duration)
+
+// 安全日志示例
+utils.InfoWithFields(map[string]interface{}{
+    "user_id": userID,
+    "ip": clientIP,
+    "action": "login",
+    "status": "success",
+}, "用户登录成功 - 用户ID: %d, IP: %s", userID, clientIP)
+```

env.example

@@ -14,4 +14,9 @@ TIMEZONE=Asia/Shanghai
 
 # 文件上传配置
 UPLOAD_DIR=./uploads
-MAX_FILE_SIZE=5MB 
+MAX_FILE_SIZE=5MB 
+
+# 日志配置
+LOG_LEVEL=INFO          # 日志级别 (DEBUG, INFO, WARN, ERROR, FATAL)
+DEBUG=false             # 调试模式开关
+STRUCTURED_LOG=false  

go.mod

@@ -1,10 +1,9 @@
 module github.com/ctwj/urldb
 
-go 1.23.0
-
-toolchain go1.23.3
+go 1.24.0
 
 require (
+	github.com/fogleman/gg v1.3.0
 	github.com/gin-contrib/cors v1.4.0
 	github.com/gin-gonic/gin v1.10.1
 	github.com/go-resty/resty/v2 v2.16.5
@@ -12,15 +11,33 @@ require (
 	github.com/golang-jwt/jwt/v5 v5.2.0
 	github.com/joho/godotenv v1.5.1
 	github.com/meilisearch/meilisearch-go v0.33.1
+	github.com/prometheus/client_golang v1.23.2
 	github.com/robfig/cron/v3 v3.0.1
-	golang.org/x/crypto v0.40.0
+	github.com/silenceper/wechat/v2 v2.1.10
+	golang.org/x/crypto v0.41.0
 	gorm.io/driver/postgres v1.6.0
 	gorm.io/gorm v1.30.0
 )
 
 require (
 	github.com/andybalholm/brotli v1.1.1 // indirect
+	github.com/beorn7/perks v1.0.1 // indirect
+	github.com/bradfitz/gomemcache v0.0.0-20220106215444-fb4bf637b56d // indirect
+	github.com/cespare/xxhash/v2 v2.3.0 // indirect
+	github.com/dgryski/go-rendezvous v0.0.0-20200823014737-9f7001d12a5f // indirect
+	github.com/go-redis/redis/v8 v8.11.5 // indirect
 	github.com/golang-jwt/jwt/v4 v4.5.2 // indirect
+	github.com/golang/freetype v0.0.0-20170609003504-e2365dfdc4a0 // indirect
+	github.com/munnerz/goautoneg v0.0.0-20191010083416-a7dc8b61c822 // indirect
+	github.com/prometheus/client_model v0.6.2 // indirect
+	github.com/prometheus/common v0.66.1 // indirect
+	github.com/prometheus/procfs v0.16.1 // indirect
+	github.com/sirupsen/logrus v1.9.0 // indirect
+	github.com/tidwall/gjson v1.14.1 // indirect
+	github.com/tidwall/match v1.1.1 // indirect
+	github.com/tidwall/pretty v1.2.0 // indirect
+	go.yaml.in/yaml/v2 v2.4.2 // indirect
+	golang.org/x/image v0.32.0 // indirect
 )
 
 require (
@@ -31,7 +48,7 @@ require (
 	github.com/gin-contrib/sse v1.1.0 // indirect
 	github.com/go-playground/locales v0.14.1 // indirect
 	github.com/go-playground/universal-translator v0.18.1 // indirect
-	github.com/go-playground/validator/v10 v10.27.0 // indirect
+	github.com/go-playground/validator/v10 v10.27.0
 	github.com/goccy/go-json v0.10.5 // indirect
 	github.com/jackc/pgpassfile v1.0.0 // indirect
 	github.com/jackc/pgservicefile v0.0.0-20240606120523-5a60cdf6a761 // indirect
@@ -41,7 +58,6 @@ require (
 	github.com/jinzhu/now v1.1.5 // indirect
 	github.com/json-iterator/go v1.1.12 // indirect
 	github.com/klauspost/cpuid/v2 v2.3.0 // indirect
-	github.com/kr/pretty v0.3.1 // indirect
 	github.com/leodido/go-urn v1.4.0 // indirect
 	github.com/matoous/go-nanoid/v2 v2.1.0
 	github.com/mattn/go-isatty v0.0.20 // indirect
@@ -52,10 +68,10 @@ require (
 	github.com/twitchyliquid64/golang-asm v0.15.1 // indirect
 	github.com/ugorji/go/codec v1.3.0 // indirect
 	golang.org/x/arch v0.19.0 // indirect
-	golang.org/x/net v0.42.0
-	golang.org/x/sync v0.16.0 // indirect
-	golang.org/x/sys v0.34.0 // indirect
-	golang.org/x/text v0.27.0 // indirect
-	google.golang.org/protobuf v1.36.6 // indirect
+	golang.org/x/net v0.43.0
+	golang.org/x/sync v0.17.0 // indirect
+	golang.org/x/sys v0.35.0 // indirect
+	golang.org/x/text v0.30.0 // indirect
+	google.golang.org/protobuf v1.36.8 // indirect
 	gopkg.in/yaml.v3 v3.0.1 // indirect
 )

go.sum

@@ -1,10 +1,24 @@
+github.com/alicebob/gopher-json v0.0.0-20200520072559-a9ecdc9d1d3a h1:HbKu58rmZpUGpz5+4FfNmIU+FmZg2P3Xaj2v2bfNWmk=
+github.com/alicebob/gopher-json v0.0.0-20200520072559-a9ecdc9d1d3a/go.mod h1:SGnFV6hVsYE877CKEZ6tDNTjaSXYUk6QqoIK6PrAtcc=
+github.com/alicebob/miniredis/v2 v2.30.0 h1:uA3uhDbCxfO9+DI/DuGeAMr9qI+noVWwGPNTFuKID5M=
+github.com/alicebob/miniredis/v2 v2.30.0/go.mod h1:84TWKZlxYkfgMucPBf5SOQBYJceZeQRFIaQgNMiCX6Q=
 github.com/andybalholm/brotli v1.1.1 h1:PR2pgnyFznKEugtsUo0xLdDop5SKXd5Qf5ysW+7XdTA=
 github.com/andybalholm/brotli v1.1.1/go.mod h1:05ib4cKhjx3OQYUY22hTVd34Bc8upXjOLL2rKwwZBoA=
+github.com/beorn7/perks v1.0.1 h1:VlbKKnNfV8bJzeqoa4cOKqO6bYr3WgKZxO8Z16+hsOM=
+github.com/beorn7/perks v1.0.1/go.mod h1:G2ZrVWU2WbWT9wwq4/hrbKbnv/1ERSJQ0ibhJ6rlkpw=
+github.com/bradfitz/gomemcache v0.0.0-20220106215444-fb4bf637b56d h1:pVrfxiGfwelyab6n21ZBkbkmbevaf+WvMIiR7sr97hw=
+github.com/bradfitz/gomemcache v0.0.0-20220106215444-fb4bf637b56d/go.mod h1:H0wQNHz2YrLsuXOZozoeDmnHXkNCRmMW0gwFWDfEZDA=
 github.com/bytedance/sonic v1.13.3 h1:MS8gmaH16Gtirygw7jV91pDCN33NyMrPbN7qiYhEsF0=
 github.com/bytedance/sonic v1.13.3/go.mod h1:o68xyaF9u2gvVBuGHPlUVCy+ZfmNNO5ETf1+KgkJhz4=
 github.com/bytedance/sonic/loader v0.1.1/go.mod h1:ncP89zfokxS5LZrJxl5z0UJcsk4M4yY2JpfqGeCtNLU=
 github.com/bytedance/sonic/loader v0.3.0 h1:dskwH8edlzNMctoruo8FPTJDF3vLtDT0sXZwvZJyqeA=
 github.com/bytedance/sonic/loader v0.3.0/go.mod h1:N8A3vUdtUebEY2/VQC0MyhYeKUFosQU6FxH2JmUe6VI=
+github.com/cespare/xxhash/v2 v2.1.2/go.mod h1:VGX0DQ3Q6kWi7AoAeZDth3/j3BFtOZR5XLFGgcrjCOs=
+github.com/cespare/xxhash/v2 v2.3.0 h1:UL815xU9SqsFlibzuggzjXhog7bL6oX9BbNZnL2UFvs=
+github.com/cespare/xxhash/v2 v2.3.0/go.mod h1:VGX0DQ3Q6kWi7AoAeZDth3/j3BFtOZR5XLFGgcrjCOs=
+github.com/chzyer/logex v1.1.10/go.mod h1:+Ywpsq7O8HXn0nuIou7OrIPyXbp3wmkHB+jjWRnGsAI=
+github.com/chzyer/readline v0.0.0-20180603132655-2972be24d48e/go.mod h1:nSuG5e5PlCu98SY8svDHJxuZscDgtXS6KTTbou5AhLI=
+github.com/chzyer/test v0.0.0-20180213035817-a1ea475d72b1/go.mod h1:Q3SI9o4m/ZMnBNeIyt5eFwwo7qiLfzFZmjNmxjkiQlU=
 github.com/cloudwego/base64x v0.1.5 h1:XPciSp1xaq2VCSt6lF0phncD4koWyULpl5bUxbfCyP4=
 github.com/cloudwego/base64x v0.1.5/go.mod h1:0zlkT4Wn5C6NdauXdJRhSKRlJvmclQ1hhJgA0rcu/8w=
 github.com/cloudwego/iasm v0.2.0/go.mod h1:8rXZaNYT2n95jn+zTI1sDr+IgcD2GVs0nlbbQPiEFhY=
@@ -12,6 +26,14 @@ github.com/creack/pty v1.1.9/go.mod h1:oKZEueFk5CKHvIhNR5MUki03XCEU+Q6VDXinZuGJ3
 github.com/davecgh/go-spew v1.1.0/go.mod h1:J7Y8YcW2NihsgmVo/mv3lAwl/skON4iLHjSsI+c5H38=
 github.com/davecgh/go-spew v1.1.1 h1:vj9j/u1bqnvCEfJOwUhtlOARqs3+rkHYY13jYWTU97c=
 github.com/davecgh/go-spew v1.1.1/go.mod h1:J7Y8YcW2NihsgmVo/mv3lAwl/skON4iLHjSsI+c5H38=
+github.com/dgryski/go-rendezvous v0.0.0-20200823014737-9f7001d12a5f h1:lO4WD4F/rVNCu3HqELle0jiPLLBs70cWOduZpkS1E78=
+github.com/dgryski/go-rendezvous v0.0.0-20200823014737-9f7001d12a5f/go.mod h1:cuUVRXasLTGF7a8hSLbxyZXjz+1KgoB3wDUb6vlszIc=
+github.com/fatih/structs v1.1.0/go.mod h1:9NiDSp5zOcgEDl+j00MP/WkGVPOlPRLejGD8Ga6PJ7M=
+github.com/fogleman/gg v1.3.0 h1:/7zJX8F6AaYQc57WQCyN9cAIz+4bCJGO9B+dyW29am8=
+github.com/fogleman/gg v1.3.0/go.mod h1:R/bRT+9gY/C5z7JzPU0zXsXHKM4/ayA+zqcVNZzPa1k=
+github.com/fsnotify/fsnotify v1.4.7/go.mod h1:jwhsz4b93w/PPRr/qN1Yymfu8t87LnFCMoQvtojpjFo=
+github.com/fsnotify/fsnotify v1.4.9 h1:hsms1Qyu0jgnwNXIxa+/V/PDsU6CfLf6CNO8H7IWoS4=
+github.com/fsnotify/fsnotify v1.4.9/go.mod h1:znqG4EE+3YCdAaPaxE2ZRY/06pZUdp0tY4IgpuI1SZQ=
 github.com/gabriel-vasile/mimetype v1.4.9 h1:5k+WDwEsD9eTLL8Tz3L0VnmVh9QxGjRmjBvAG7U/oYY=
 github.com/gabriel-vasile/mimetype v1.4.9/go.mod h1:WnSQhFKJuBlRyLiKohA/2DtIlPFAbguNaG7QCHcyGok=
 github.com/gin-contrib/cors v1.4.0 h1:oJ6gwtUl3lqV0WEIwM/LxPF1QZ5qe2lGWdY2+bz7y0g=
@@ -34,8 +56,11 @@ github.com/go-playground/universal-translator v0.18.1/go.mod h1:xekY+UJKNuX9WP91
 github.com/go-playground/validator/v10 v10.10.0/go.mod h1:74x4gJWsvQexRdW8Pn3dXSGrTK4nAUsbPlLADvpJkos=
 github.com/go-playground/validator/v10 v10.27.0 h1:w8+XrWVMhGkxOaaowyKH35gFydVHOvC0/uWoy2Fzwn4=
 github.com/go-playground/validator/v10 v10.27.0/go.mod h1:I5QpIEbmr8On7W0TktmJAumgzX4CA1XNl4ZmDuVHKKo=
+github.com/go-redis/redis/v8 v8.11.5 h1:AcZZR7igkdvfVmQTPnu9WE37LRrO/YrBH5zWyjDC0oI=
+github.com/go-redis/redis/v8 v8.11.5/go.mod h1:gREzHqY1hg6oD9ngVRbLStwAWKhA0FEgq8Jd4h5lpwo=
 github.com/go-resty/resty/v2 v2.16.5 h1:hBKqmWrr7uRc3euHVqmh1HTHcKn99Smr7o5spptdhTM=
 github.com/go-resty/resty/v2 v2.16.5/go.mod h1:hkJtXbA2iKHzJheXYvQ8snQES5ZLGKMwQ07xAwp/fiA=
+github.com/go-task/slim-sprig v0.0.0-20210107165309-348f09dbbbc0/go.mod h1:fyg7847qk6SyHyPtNmDHnmrv/HOrqktSC+C9fM+CJOE=
 github.com/go-telegram-bot-api/telegram-bot-api/v5 v5.5.1 h1:wG8n/XJQ07TmjbITcGiUaOtXxdrINDz1b0J1w0SzqDc=
 github.com/go-telegram-bot-api/telegram-bot-api/v5 v5.5.1/go.mod h1:A2S0CWkNylc2phvKXWBBdD3K0iGnDBGbzRpISP2zBl8=
 github.com/goccy/go-json v0.9.7/go.mod h1:6MelG93GURQebXPDq3khkgXZkazVtN9CRI+MGFi0w8I=
@@ -45,11 +70,29 @@ github.com/golang-jwt/jwt/v4 v4.5.2 h1:YtQM7lnr8iZ+j5q71MGKkNw9Mn7AjHM68uc9g5fXe
 github.com/golang-jwt/jwt/v4 v4.5.2/go.mod h1:m21LjoU+eqJr34lmDMbreY2eSTRJ1cv77w39/MY0Ch0=
 github.com/golang-jwt/jwt/v5 v5.2.0 h1:d/ix8ftRUorsN+5eMIlF4T6J8CAt9rch3My2winC1Jw=
 github.com/golang-jwt/jwt/v5 v5.2.0/go.mod h1:pqrtFR0X4osieyHYxtmOUWsAWrfe1Q5UVIyoH402zdk=
+github.com/golang/freetype v0.0.0-20170609003504-e2365dfdc4a0 h1:DACJavvAHhabrF08vX0COfcOBJRhZ8lUbR+ZWIs0Y5g=
+github.com/golang/freetype v0.0.0-20170609003504-e2365dfdc4a0/go.mod h1:E/TSTwGwJL78qG/PmXZO1EjYhfJinVAhrmmHX6Z8B9k=
+github.com/golang/protobuf v1.2.0/go.mod h1:6lQm79b+lXiMfvg/cZm0SGofjICqVBUtrP5yJMmIC1U=
+github.com/golang/protobuf v1.4.0-rc.1/go.mod h1:ceaxUfeHdC40wWswd/P6IGgMaK3YpKi5j83Wpe3EHw8=
+github.com/golang/protobuf v1.4.0-rc.1.0.20200221234624-67d41d38c208/go.mod h1:xKAWHe0F5eneWXFV3EuXVDTCmh+JuBKY0li0aMyXATA=
+github.com/golang/protobuf v1.4.0-rc.2/go.mod h1:LlEzMj4AhA7rCAGe4KMBDvJI+AwstrUpVNzEA03Pprs=
+github.com/golang/protobuf v1.4.0-rc.4.0.20200313231945-b860323f09d0/go.mod h1:WU3c8KckQ9AFe+yFwt9sWVRKCVIyN9cPHBJSNnbL67w=
+github.com/golang/protobuf v1.4.0/go.mod h1:jodUvKwWbYaEsadDk5Fwe5c77LiNKVO9IDvqG2KuDX0=
+github.com/golang/protobuf v1.4.2/go.mod h1:oDoupMAO8OvCJWAcko0GGGIgR6R6ocIYbsSw735rRwI=
 github.com/golang/protobuf v1.5.0/go.mod h1:FsONVRAS9T7sI+LIUmWTfcYkHO4aIWwzhcaSAoJOfIk=
+github.com/golang/protobuf v1.5.2/go.mod h1:XVQd3VNwM+JqD3oG2Ue2ip4fOMUkwXdXDdiuN0vRsmY=
+github.com/google/go-cmp v0.3.0/go.mod h1:8QqcDgzrUqlUb/G2PQTWiueGozuR1884gddMywk6iLU=
+github.com/google/go-cmp v0.3.1/go.mod h1:8QqcDgzrUqlUb/G2PQTWiueGozuR1884gddMywk6iLU=
+github.com/google/go-cmp v0.4.0/go.mod h1:v8dTdLbMG2kIc/vJvl+f65V22dbkXbowE6jgT/gNBxE=
 github.com/google/go-cmp v0.5.5/go.mod h1:v8dTdLbMG2kIc/vJvl+f65V22dbkXbowE6jgT/gNBxE=
 github.com/google/go-cmp v0.7.0 h1:wk8382ETsv4JYUZwIsn6YpYiWiBsYLSJiTsyBybVuN8=
 github.com/google/go-cmp v0.7.0/go.mod h1:pXiqmnSA92OHEEa9HXL2W4E7lf9JzCmGVUdgjX3N/iU=
 github.com/google/gofuzz v1.0.0/go.mod h1:dBl0BpW6vV/+mYPU4Po3pmUjxk6FQPldtuIdl/M65Eg=
+github.com/google/pprof v0.0.0-20210407192527-94a9f03dee38/go.mod h1:kpwsk12EmLew5upagYY7GY0pfYCcupk39gWOCRROcvE=
+github.com/h2non/parth v0.0.0-20190131123155-b4df798d6542 h1:2VTzZjLZBgl62/EtslCrtky5vbi9dd7HrQPQIx6wqiw=
+github.com/h2non/parth v0.0.0-20190131123155-b4df798d6542/go.mod h1:Ow0tF8D4Kplbc8s8sSb3V2oUCygFHVp8gC3Dn6U4MNI=
+github.com/hpcloud/tail v1.0.0/go.mod h1:ab1qPbhIpdTxEkNHXyeSf5vhxWSCs/tWer42PpOxQnU=
+github.com/ianlancetaylor/demangle v0.0.0-20200824232613-28f6c0f3b639/go.mod h1:aSSvb/t6k1mPoxDqO4vJh6VOCGPwU4O0C2/Eqndh1Sc=
 github.com/jackc/pgpassfile v1.0.0 h1:/6Hmqy13Ss2zCq62VdNG8tM1wchn8zjSGOBJ6icpsIM=
 github.com/jackc/pgpassfile v1.0.0/go.mod h1:CEx0iS5ambNFdcRtxPj5JhEz+xB6uRky5eyVu/W2HEg=
 github.com/jackc/pgservicefile v0.0.0-20240606120523-5a60cdf6a761 h1:iCEnooe7UlwOQYpKFhBabPMi4aNAfoODPEFNiAnClxo=
@@ -66,6 +109,8 @@ github.com/joho/godotenv v1.5.1 h1:7eLL/+HRGLY0ldzfGMeQkb7vMd0as4CfYvUVzLqw0N0=
 github.com/joho/godotenv v1.5.1/go.mod h1:f4LDr5Voq0i2e/R5DDNOoa2zzDfwtkZa6DnEwAbqwq4=
 github.com/json-iterator/go v1.1.12 h1:PV8peI4a0ysnczrg+LtxykD8LfKY9ML6u2jnxaEnrnM=
 github.com/json-iterator/go v1.1.12/go.mod h1:e30LSqwooZae/UwlEbR2852Gd8hjQvJoHmT4TnhNGBo=
+github.com/klauspost/compress v1.18.0 h1:c/Cqfb0r+Yi+JtIEq73FWXVkRonBlf0CRNYc8Zttxdo=
+github.com/klauspost/compress v1.18.0/go.mod h1:2Pp+KzxcywXVXMr50+X0Q/Lsb43OQHYWRCY2AiWywWQ=
 github.com/klauspost/cpuid/v2 v2.0.9/go.mod h1:FInQzS24/EEf25PyTYn52gqo7WaD8xa0213Md/qVLRg=
 github.com/klauspost/cpuid/v2 v2.3.0 h1:S4CRMLnYUhGeDFDqkGriYKdfoFlDnMtqTiI/sFzhA9Y=
 github.com/klauspost/cpuid/v2 v2.3.0/go.mod h1:hqwkgyIinND0mEev00jJYCxPNVRVXFQeu1XKlok6oO0=
@@ -79,6 +124,8 @@ github.com/kr/pty v1.1.1/go.mod h1:pFQYn66WHrOpPYNljwOMqo10TkYh1fy3cYio2l3bCsQ=
 github.com/kr/text v0.1.0/go.mod h1:4Jbv+DJW3UT/LiOwJeYQe1efqtUx/iVham/4vfdArNI=
 github.com/kr/text v0.2.0 h1:5Nx0Ya0ZqY2ygV366QzturHI13Jq95ApcVaJBhpS+AY=
 github.com/kr/text v0.2.0/go.mod h1:eLer722TekiGuMkidMxC/pM04lWEeraHUUmBw8l2grE=
+github.com/kylelemons/godebug v1.1.0 h1:RPNrshWIDI6G2gRW9EHilWtl7Z6Sb1BR0xunSBf0SNc=
+github.com/kylelemons/godebug v1.1.0/go.mod h1:9/0rRGxNHcop5bhtWyNeEfOS8JIWk580+fNqagV/RAw=
 github.com/leodido/go-urn v1.2.1/go.mod h1:zt4jvISO2HfUBqxjfIshjdMTYS56ZS/qv49ictyFfxY=
 github.com/leodido/go-urn v1.4.0 h1:WT9HwE9SGECu3lg4d/dIA+jxlljEa1/ffXKmRjqdmIQ=
 github.com/leodido/go-urn v1.4.0/go.mod h1:bvxc+MVxLKB4z00jd1z+Dvzr47oO32F/QSNjSBOlFxI=
@@ -94,30 +141,67 @@ github.com/modern-go/concurrent v0.0.0-20180306012644-bacd9c7ef1dd h1:TRLaZ9cD/w
 github.com/modern-go/concurrent v0.0.0-20180306012644-bacd9c7ef1dd/go.mod h1:6dJC0mAP4ikYIbvyc7fijjWJddQyLn8Ig3JB5CqoB9Q=
 github.com/modern-go/reflect2 v1.0.2 h1:xBagoLtFs94CBntxluKeaWgTMpvLxC4ur3nMaC9Gz0M=
 github.com/modern-go/reflect2 v1.0.2/go.mod h1:yWuevngMOJpCy52FWWMvUC8ws7m/LJsjYzDa0/r8luk=
+github.com/munnerz/goautoneg v0.0.0-20191010083416-a7dc8b61c822 h1:C3w9PqII01/Oq1c1nUAm88MOHcQC9l5mIlSMApZMrHA=
+github.com/munnerz/goautoneg v0.0.0-20191010083416-a7dc8b61c822/go.mod h1:+n7T8mK8HuQTcFwEeznm/DIxMOiR9yIdICNftLE1DvQ=
+github.com/nbio/st v0.0.0-20140626010706-e9e8d9816f32/go.mod h1:9wM+0iRr9ahx58uYLpLIr5fm8diHn0JbqRycJi6w0Ms=
+github.com/nxadm/tail v1.4.4/go.mod h1:kenIhsEOeOJmVchQTgglprH7qJGnHDVpk1VPCcaMI8A=
+github.com/nxadm/tail v1.4.8 h1:nPr65rt6Y5JFSKQO7qToXr7pePgD6Gwiw05lkbyAQTE=
+github.com/nxadm/tail v1.4.8/go.mod h1:+ncqLTQzXmGhMZNUePPaPqPvBxHAIsmXswZKocGu+AU=
+github.com/onsi/ginkgo v1.6.0/go.mod h1:lLunBs/Ym6LB5Z9jYTR76FiuTmxDTDusOGeTQH+WWjE=
+github.com/onsi/ginkgo v1.12.1/go.mod h1:zj2OWP4+oCPe1qIXoGWkgMRwljMUYCdkwsT2108oapk=
+github.com/onsi/ginkgo v1.16.4/go.mod h1:dX+/inL/fNMqNlz0e9LfyB9TswhZpCVdJM/Z6Vvnwo0=
+github.com/onsi/ginkgo v1.16.5 h1:8xi0RTUf59SOSfEtZMvwTvXYMzG4gV23XVHOZiXNtnE=
+github.com/onsi/ginkgo v1.16.5/go.mod h1:+E8gABHa3K6zRBolWtd+ROzc/U5bkGt0FwiG042wbpU=
+github.com/onsi/ginkgo/v2 v2.0.0/go.mod h1:vw5CSIxN1JObi/U8gcbwft7ZxR2dgaR70JSE3/PpL4c=
+github.com/onsi/gomega v1.7.1/go.mod h1:XdKZgCCFLUoM/7CFJVPcG8C1xQ1AJ0vpAezJrB7JYyY=
+github.com/onsi/gomega v1.10.1/go.mod h1:iN09h71vgCQne3DLsj+A5owkum+a2tYe+TOCB1ybHNo=
+github.com/onsi/gomega v1.17.0/go.mod h1:HnhC7FXeEQY45zxNK3PPoIUhzk/80Xly9PcubAlGdZY=
+github.com/onsi/gomega v1.18.1 h1:M1GfJqGRrBrrGGsbxzV5dqM2U2ApXefZCQpkukxYRLE=
+github.com/onsi/gomega v1.18.1/go.mod h1:0q+aL8jAiMXy9hbwj2mr5GziHiwhAIQpFmmtT5hitRs=
 github.com/pelletier/go-toml/v2 v2.0.1/go.mod h1:r9LEWfGN8R5k0VXJ+0BkIe7MYkRdwZOjgMj2KwnJFUo=
 github.com/pelletier/go-toml/v2 v2.2.4 h1:mye9XuhQ6gvn5h28+VilKrrPoQVanw5PMw/TB0t5Ec4=
 github.com/pelletier/go-toml/v2 v2.2.4/go.mod h1:2gIqNv+qfxSVS7cM2xJQKtLSTLUE9V8t9Stt+h56mCY=
 github.com/pkg/diff v0.0.0-20210226163009-20ebb0f2a09e/go.mod h1:pJLUxLENpZxwdsKMEsNbx1VGcRFpLqf3715MtcvvzbA=
 github.com/pmezard/go-difflib v1.0.0 h1:4DBwDE0NGyQoBHbLQYPwSUPoCMWR5BEzIk/f1lZbAQM=
 github.com/pmezard/go-difflib v1.0.0/go.mod h1:iKH77koFhYxTK1pcRnkKkqfTogsbg7gZNVY4sRDYZ/4=
+github.com/prometheus/client_golang v1.23.2 h1:Je96obch5RDVy3FDMndoUsjAhG5Edi49h0RJWRi/o0o=
+github.com/prometheus/client_golang v1.23.2/go.mod h1:Tb1a6LWHB3/SPIzCoaDXI4I8UHKeFTEQ1YCr+0Gyqmg=
+github.com/prometheus/client_model v0.6.2 h1:oBsgwpGs7iVziMvrGhE53c/GrLUsZdHnqNwqPLxwZyk=
+github.com/prometheus/client_model v0.6.2/go.mod h1:y3m2F6Gdpfy6Ut/GBsUqTWZqCUvMVzSfMLjcu6wAwpE=
+github.com/prometheus/common v0.66.1 h1:h5E0h5/Y8niHc5DlaLlWLArTQI7tMrsfQjHV+d9ZoGs=
+github.com/prometheus/common v0.66.1/go.mod h1:gcaUsgf3KfRSwHY4dIMXLPV0K/Wg1oZ8+SbZk/HH/dA=
+github.com/prometheus/procfs v0.16.1 h1:hZ15bTNuirocR6u0JZ6BAHHmwS1p8B4P6MRqxtzMyRg=
+github.com/prometheus/procfs v0.16.1/go.mod h1:teAbpZRB1iIAJYREa1LsoWUXykVXA1KlTmWl8x/U+Is=
 github.com/robfig/cron/v3 v3.0.1 h1:WdRxkvbJztn8LMz/QEvLN5sBU+xKpSqwwUO1Pjr4qDs=
 github.com/robfig/cron/v3 v3.0.1/go.mod h1:eQICP3HwyT7UooqI/z+Ov+PtYAWygg1TEWWzGIFLtro=
 github.com/rogpeppe/go-internal v1.6.1/go.mod h1:xXDCJY+GAPziupqXw64V24skbSoqbTEfhy4qGm1nDQc=
 github.com/rogpeppe/go-internal v1.8.0/go.mod h1:WmiCO8CzOY8rg0OYDC4/i/2WRWAB6poM+XZ2dLUbcbE=
-github.com/rogpeppe/go-internal v1.9.0/go.mod h1:WtVeX8xhTBvf0smdhujwtBcq4Qrzq/fJaraNFVN+nFs=
 github.com/rogpeppe/go-internal v1.11.0 h1:cWPaGQEPrBb5/AsnsZesgZZ9yb1OQ+GOISoDNXVBh4M=
 github.com/rogpeppe/go-internal v1.11.0/go.mod h1:ddIwULY96R17DhadqLgMfk9H9tvdUzkipdSkR5nkCZA=
+github.com/silenceper/wechat/v2 v2.1.10 h1:jMg0//CZBIuogEvuXgxJQuJ47SsPPAqFrrbOtro2pko=
+github.com/silenceper/wechat/v2 v2.1.10/go.mod h1:7Iu3EhQYVtDUJAj+ZVRy8yom75ga7aDWv8RurLkVm0s=
+github.com/sirupsen/logrus v1.9.0 h1:trlNQbNUG3OdDrDil03MCb1H2o9nJ1x4/5LYw7byDE0=
+github.com/sirupsen/logrus v1.9.0/go.mod h1:naHLuLoDiP4jHNo9R0sCBMtWGeIprob74mVsIT4qYEQ=
+github.com/spf13/cast v1.4.1/go.mod h1:Qx5cxh0v+4UWYiBimWS+eyWzqEqokIECu5etghLkUJE=
 github.com/stretchr/objx v0.1.0/go.mod h1:HFkY916IF+rwdDfMAkV7OtwuqBVzrE8GR6GFx+wExME=
 github.com/stretchr/objx v0.4.0/go.mod h1:YvHI0jy2hoMjB+UWwv71VJQ9isScKT/TqJzVSSt89Yw=
 github.com/stretchr/objx v0.5.0/go.mod h1:Yh+to48EsGEfYuaHDzXPcE3xhTkx73EhmCGUpEOglKo=
+github.com/stretchr/testify v1.2.2/go.mod h1:a8OnRcib4nhh0OaRAV+Yts87kKdq0PP7pXfy6kDkUVs=
 github.com/stretchr/testify v1.3.0/go.mod h1:M5WIy9Dh21IEIfnGCwXGc5bZfKNJtfHm1UVUgZn+9EI=
+github.com/stretchr/testify v1.5.1/go.mod h1:5W2xD1RspED5o8YsWQXVCued0rvSQ+mT+I5cxcmMvtA=
 github.com/stretchr/testify v1.6.1/go.mod h1:6Fq8oRcR53rry900zMqJjRRixrwX3KX962/h/Wwjteg=
 github.com/stretchr/testify v1.7.0/go.mod h1:6Fq8oRcR53rry900zMqJjRRixrwX3KX962/h/Wwjteg=
 github.com/stretchr/testify v1.7.1/go.mod h1:6Fq8oRcR53rry900zMqJjRRixrwX3KX962/h/Wwjteg=
 github.com/stretchr/testify v1.8.0/go.mod h1:yNjHg4UonilssWZ8iaSj1OCr/vHnekPRkoO+kdMU+MU=
 github.com/stretchr/testify v1.8.1/go.mod h1:w2LPCIKwWwSfY2zedu0+kehJoqGctiVI29o6fzry7u4=
-github.com/stretchr/testify v1.10.0 h1:Xv5erBjTwe/5IxqUQTdXv5kgmIvbHo3QQyRwhJsOfJA=
-github.com/stretchr/testify v1.10.0/go.mod h1:r2ic/lqez/lEtzL7wO/rwa5dbSLXVDPFyf8C91i36aY=
+github.com/stretchr/testify v1.11.1 h1:7s2iGBzp5EwR7/aIZr8ao5+dra3wiQyKjjFuvgVKu7U=
+github.com/stretchr/testify v1.11.1/go.mod h1:wZwfW3scLgRK+23gO65QZefKpKQRnfz6sD981Nm4B6U=
+github.com/tidwall/gjson v1.14.1 h1:iymTbGkQBhveq21bEvAQ81I0LEBork8BFe1CUZXdyuo=
+github.com/tidwall/gjson v1.14.1/go.mod h1:/wbyibRr2FHMks5tjHJ5F8dMZh3AcwJEMf5vlfC0lxk=
+github.com/tidwall/match v1.1.1 h1:+Ho715JplO36QYgwN9PGYNhgZvoUSc9X2c80KVTi+GA=
+github.com/tidwall/match v1.1.1/go.mod h1:eRSPERbgtNPcGhD8UCthc6PmLEQXEWd3PRB5JTxsfmM=
+github.com/tidwall/pretty v1.2.0 h1:RWIZEg2iJ8/g6fDDYzMpobmaoGh5OLl4AXtGUGPcqCs=
+github.com/tidwall/pretty v1.2.0/go.mod h1:ITEVvHYasfjBbM0u2Pg8T2nJnzm8xPwvNhhsoaGGjNU=
 github.com/twitchyliquid64/golang-asm v0.15.1 h1:SU5vSMR7hnwNxj24w34ZyCi/FmDZTkS4MhqMhdFk5YI=
 github.com/twitchyliquid64/golang-asm v0.15.1/go.mod h1:a1lVb/DtPvCB8fslRZhAngC2+aY1QWCk3Cedj/Gdt08=
 github.com/ugorji/go v1.2.7/go.mod h1:nF9osbDWLy6bDVv/Rtoh6QgnvNDpmCalQV5urGCCS6M=
@@ -126,41 +210,101 @@ github.com/ugorji/go/codec v1.3.0 h1:Qd2W2sQawAfG8XSvzwhBeoGq71zXOC/Q1E9y/wUcsUA
 github.com/ugorji/go/codec v1.3.0/go.mod h1:pRBVtBSKl77K30Bv8R2P+cLSGaTtex6fsA2Wjqmfxj4=
 github.com/xyproto/randomstring v1.0.5 h1:YtlWPoRdgMu3NZtP45drfy1GKoojuR7hmRcnhZqKjWU=
 github.com/xyproto/randomstring v1.0.5/go.mod h1:rgmS5DeNXLivK7YprL0pY+lTuhNQW3iGxZ18UQApw/E=
+github.com/yuin/goldmark v1.2.1/go.mod h1:3hX8gzYuyVAZsxl0MRgGTJEmQBFcNTphYh9decYSb74=
+github.com/yuin/gopher-lua v0.0.0-20220504180219-658193537a64 h1:5mLPGnFdSsevFRFc9q3yYbBkB6tsm4aCwwQV/j1JQAQ=
+github.com/yuin/gopher-lua v0.0.0-20220504180219-658193537a64/go.mod h1:GBR0iDaNXjAgGg9zfCvksxSRnQx76gclCIb7kdAd1Pw=
+go.uber.org/goleak v1.3.0 h1:2K3zAYmnTNqV73imy9J1T3WC+gmCePx2hEGkimedGto=
+go.uber.org/goleak v1.3.0/go.mod h1:CoHD4mav9JJNrW/WLlf7HGZPjdw8EucARQHekz1X6bE=
+go.yaml.in/yaml/v2 v2.4.2 h1:DzmwEr2rDGHl7lsFgAHxmNz/1NlQ7xLIrlN2h5d1eGI=
+go.yaml.in/yaml/v2 v2.4.2/go.mod h1:081UH+NErpNdqlCXm3TtEran0rJZGxAYx9hb/ELlsPU=
 golang.org/x/arch v0.19.0 h1:LmbDQUodHThXE+htjrnmVD73M//D9GTH6wFZjyDkjyU=
 golang.org/x/arch v0.19.0/go.mod h1:bdwinDaKcfZUGpH09BB7ZmOfhalA8lQdzl62l8gGWsk=
+golang.org/x/crypto v0.0.0-20190308221718-c2843e01d9a2/go.mod h1:djNgcEr1/C05ACkg1iLfiJU5Ep61QUkGW8qpdssI0+w=
+golang.org/x/crypto v0.0.0-20191011191535-87dc89f01550/go.mod h1:yigFU9vqHzYiE8UmvKecakEJjdnWj3jj499lnFckfCI=
+golang.org/x/crypto v0.0.0-20200622213623-75b288015ac9/go.mod h1:LzIPMQfyMNhhGPhUkYOs5KpL4U8rLKemX1yGLhDgUto=
 golang.org/x/crypto v0.0.0-20210711020723-a769d52b0f97/go.mod h1:GvvjBRRGRdwPK5ydBHafDWAxML/pGHZbMvKqRZ5+Abc=
-golang.org/x/crypto v0.40.0 h1:r4x+VvoG5Fm+eJcxMaY8CQM7Lb0l1lsmjGBQ6s8BfKM=
-golang.org/x/crypto v0.40.0/go.mod h1:Qr1vMER5WyS2dfPHAlsOj01wgLbsyWtFn/aY+5+ZdxY=
+golang.org/x/crypto v0.0.0-20220622213112-05595931fe9d/go.mod h1:IxCIyHEi3zRg3s0A5j5BB6A9Jmi73HwBIUl50j+osU4=
+golang.org/x/crypto v0.41.0 h1:WKYxWedPGCTVVl5+WHSSrOBT0O8lx32+zxmHxijgXp4=
+golang.org/x/crypto v0.41.0/go.mod h1:pO5AFd7FA68rFak7rOAGVuygIISepHftHnr8dr6+sUc=
+golang.org/x/image v0.32.0 h1:6lZQWq75h7L5IWNk0r+SCpUJ6tUVd3v4ZHnbRKLkUDQ=
+golang.org/x/image v0.32.0/go.mod h1:/R37rrQmKXtO6tYXAjtDLwQgFLHmhW+V6ayXlxzP2Pc=
+golang.org/x/mod v0.3.0/go.mod h1:s0Qsj1ACt9ePp/hMypM3fl4fZqREWJwdYDEqhRiZZUA=
+golang.org/x/net v0.0.0-20180906233101-161cd47e91fd/go.mod h1:mL1N/T3taQHkDXs73rZJwtUhF3w3ftmwwsq0BUmARs4=
+golang.org/x/net v0.0.0-20190404232315-eb5bcb51f2a3/go.mod h1:t9HGtf8HONx5eT2rtn7q6eTqICYqUVnKs3thJo3Qplg=
+golang.org/x/net v0.0.0-20190620200207-3b0461eec859/go.mod h1:z5CRVTTTmAJ677TzLLGU+0bjPO0LkuOLi4/5GtJWs/s=
+golang.org/x/net v0.0.0-20200520004742-59133d7f0dd7/go.mod h1:qpuaurCH72eLCgpAm/N6yyVIVM9cpaDIP3A8BGJEC5A=
+golang.org/x/net v0.0.0-20201021035429-f5854403a974/go.mod h1:sp8m0HH+o8qH0wwXwYZr8TS3Oi6o0r6Gce1SSxlDquU=
 golang.org/x/net v0.0.0-20210226172049-e18ecbb05110/go.mod h1:m0MpNAwzfU5UDzcl9v0D8zg8gWTRqZa9RBIspLL5mdg=
-golang.org/x/net v0.42.0 h1:jzkYrhi3YQWD6MLBJcsklgQsoAcw89EcZbJw8Z614hs=
-golang.org/x/net v0.42.0/go.mod h1:FF1RA5d3u7nAYA4z2TkclSCKh68eSXtiFwcWQpPXdt8=
-golang.org/x/sync v0.16.0 h1:ycBJEhp9p4vXvUZNszeOq0kGTPghopOL8q0fq3vstxw=
-golang.org/x/sync v0.16.0/go.mod h1:1dzgHSNfp02xaA81J2MS99Qcpr2w7fw1gpm99rleRqA=
+golang.org/x/net v0.0.0-20210428140749-89ef3d95e781/go.mod h1:OJAsFXCWl8Ukc7SiCT/9KSuxbyM7479/AVlXFRxuMCk=
+golang.org/x/net v0.0.0-20211112202133-69e39bad7dc2/go.mod h1:9nx3DQGgdP8bBQD5qxJ1jj9UTztislL4KSBs9R2vV5Y=
+golang.org/x/net v0.43.0 h1:lat02VYK2j4aLzMzecihNvTlJNQUq316m2Mr9rnM6YE=
+golang.org/x/net v0.43.0/go.mod h1:vhO1fvI4dGsIjh73sWfUVjj3N7CA9WkKJNQm2svM6Jg=
+golang.org/x/sync v0.0.0-20180314180146-1d60e4601c6f/go.mod h1:RxMgew5VJxzue5/jJTE5uejpjVlOe/izrB70Jof72aM=
+golang.org/x/sync v0.0.0-20190423024810-112230192c58/go.mod h1:RxMgew5VJxzue5/jJTE5uejpjVlOe/izrB70Jof72aM=
+golang.org/x/sync v0.0.0-20201020160332-67f06af15bc9/go.mod h1:RxMgew5VJxzue5/jJTE5uejpjVlOe/izrB70Jof72aM=
+golang.org/x/sync v0.17.0 h1:l60nONMj9l5drqw6jlhIELNv9I0A4OFgRsG9k2oT9Ug=
+golang.org/x/sync v0.17.0/go.mod h1:9KTHXmSnoGruLpwFjVSX0lNNA75CykiMECbovNTZqGI=
+golang.org/x/sys v0.0.0-20180909124046-d0be0721c37e/go.mod h1:STP8DvDyc/dI5b8T5hshtkjS+E42TnysNCUPdjciGhY=
+golang.org/x/sys v0.0.0-20190204203706-41f3e6584952/go.mod h1:STP8DvDyc/dI5b8T5hshtkjS+E42TnysNCUPdjciGhY=
+golang.org/x/sys v0.0.0-20190215142949-d0b11bdaac8a/go.mod h1:STP8DvDyc/dI5b8T5hshtkjS+E42TnysNCUPdjciGhY=
+golang.org/x/sys v0.0.0-20190412213103-97732733099d/go.mod h1:h1NjWce9XRLGQEsW7wpKNCjG9DtNlClVuFLEZdDNbEs=
+golang.org/x/sys v0.0.0-20190904154756-749cb33beabd/go.mod h1:h1NjWce9XRLGQEsW7wpKNCjG9DtNlClVuFLEZdDNbEs=
+golang.org/x/sys v0.0.0-20191005200804-aed5e4c7ecf9/go.mod h1:h1NjWce9XRLGQEsW7wpKNCjG9DtNlClVuFLEZdDNbEs=
+golang.org/x/sys v0.0.0-20191120155948-bd437916bb0e/go.mod h1:h1NjWce9XRLGQEsW7wpKNCjG9DtNlClVuFLEZdDNbEs=
+golang.org/x/sys v0.0.0-20191204072324-ce4227a45e2e/go.mod h1:h1NjWce9XRLGQEsW7wpKNCjG9DtNlClVuFLEZdDNbEs=
+golang.org/x/sys v0.0.0-20200323222414-85ca7c5b95cd/go.mod h1:h1NjWce9XRLGQEsW7wpKNCjG9DtNlClVuFLEZdDNbEs=
+golang.org/x/sys v0.0.0-20200930185726-fdedc70b468f/go.mod h1:h1NjWce9XRLGQEsW7wpKNCjG9DtNlClVuFLEZdDNbEs=
 golang.org/x/sys v0.0.0-20201119102817-f84b799fce68/go.mod h1:h1NjWce9XRLGQEsW7wpKNCjG9DtNlClVuFLEZdDNbEs=
+golang.org/x/sys v0.0.0-20210112080510-489259a85091/go.mod h1:h1NjWce9XRLGQEsW7wpKNCjG9DtNlClVuFLEZdDNbEs=
+golang.org/x/sys v0.0.0-20210423082822-04245dca01da/go.mod h1:h1NjWce9XRLGQEsW7wpKNCjG9DtNlClVuFLEZdDNbEs=
 golang.org/x/sys v0.0.0-20210615035016-665e8c7367d1/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg=
 golang.org/x/sys v0.0.0-20210630005230-0f9fa26af87c/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg=
 golang.org/x/sys v0.0.0-20210806184541-e5e7981a1069/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg=
+golang.org/x/sys v0.0.0-20211216021012-1d35b9e2eb4e/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg=
+golang.org/x/sys v0.0.0-20220715151400-c0bba94af5f8/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg=
 golang.org/x/sys v0.6.0/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg=
-golang.org/x/sys v0.34.0 h1:H5Y5sJ2L2JRdyv7ROF1he/lPdvFsd0mJHFw2ThKHxLA=
-golang.org/x/sys v0.34.0/go.mod h1:BJP2sWEmIv4KK5OTEluFJCKSidICx8ciO85XgH3Ak8k=
+golang.org/x/sys v0.35.0 h1:vz1N37gP5bs89s7He8XuIYXpyY0+QlsKmzipCbUtyxI=
+golang.org/x/sys v0.35.0/go.mod h1:BJP2sWEmIv4KK5OTEluFJCKSidICx8ciO85XgH3Ak8k=
 golang.org/x/term v0.0.0-20201126162022-7de9c90e9dd1/go.mod h1:bj7SfCRtBDWHUb9snDiAeCFNEtKQo2Wmx5Cou7ajbmo=
+golang.org/x/text v0.3.0/go.mod h1:NqM8EUOU14njkJ3fqMW+pc6Ldnwhi/IjpwHt7yyuwOQ=
 golang.org/x/text v0.3.3/go.mod h1:5Zoc/QRtKVWzQhOtBMvqHzDpF6irO9z98xDceosuGiQ=
 golang.org/x/text v0.3.6/go.mod h1:5Zoc/QRtKVWzQhOtBMvqHzDpF6irO9z98xDceosuGiQ=
-golang.org/x/text v0.27.0 h1:4fGWRpyh641NLlecmyl4LOe6yDdfaYNrGb2zdfo4JV4=
-golang.org/x/text v0.27.0/go.mod h1:1D28KMCvyooCX9hBiosv5Tz/+YLxj0j7XhWjpSUF7CU=
+golang.org/x/text v0.30.0 h1:yznKA/E9zq54KzlzBEAWn1NXSQ8DIp/NYMy88xJjl4k=
+golang.org/x/text v0.30.0/go.mod h1:yDdHFIX9t+tORqspjENWgzaCVXgk0yYnYuSZ8UzzBVM=
 golang.org/x/time v0.6.0 h1:eTDhh4ZXt5Qf0augr54TN6suAUudPcawVZeIAPU7D4U=
 golang.org/x/time v0.6.0/go.mod h1:3BpzKBy/shNhVucY/MWOyx10tF3SFh9QdLuxbVysPQM=
 golang.org/x/tools v0.0.0-20180917221912-90fa682c2a6e/go.mod h1:n7NCudcB/nEzxVGmLbDWY5pfWTLqBcC2KZ6jyYvM4mQ=
+golang.org/x/tools v0.0.0-20191119224855-298f0cb1881e/go.mod h1:b+2E5dAYhXwXZwtnZ6UAqBI28+e2cm9otk0dWdXHAEo=
+golang.org/x/tools v0.0.0-20201224043029-2b0845dc783e/go.mod h1:emZCQorbCU4vsT4fOWvOPXz4eW1wZW4PmDk9uLelYpA=
+golang.org/x/xerrors v0.0.0-20190717185122-a985d3407aa7/go.mod h1:I/5z698sn9Ka8TeJc9MKroUUfqBBauWjQqLJ2OPfmY0=
+golang.org/x/xerrors v0.0.0-20191011141410-1b5146add898/go.mod h1:I/5z698sn9Ka8TeJc9MKroUUfqBBauWjQqLJ2OPfmY0=
 golang.org/x/xerrors v0.0.0-20191204190536-9bdfabe68543/go.mod h1:I/5z698sn9Ka8TeJc9MKroUUfqBBauWjQqLJ2OPfmY0=
+golang.org/x/xerrors v0.0.0-20200804184101-5ec99f83aff1/go.mod h1:I/5z698sn9Ka8TeJc9MKroUUfqBBauWjQqLJ2OPfmY0=
+google.golang.org/protobuf v0.0.0-20200109180630-ec00e32a8dfd/go.mod h1:DFci5gLYBciE7Vtevhsrf46CRTquxDuWsQurQQe4oz8=
+google.golang.org/protobuf v0.0.0-20200221191635-4d8936d0db64/go.mod h1:kwYJMbMJ01Woi6D6+Kah6886xMZcty6N08ah7+eCXa0=
+google.golang.org/protobuf v0.0.0-20200228230310-ab0ca4ff8a60/go.mod h1:cfTl7dwQJ+fmap5saPgwCLgHXTUD7jkjRqWcaiX5VyM=
+google.golang.org/protobuf v1.20.1-0.20200309200217-e05f789c0967/go.mod h1:A+miEFZTKqfCUM6K7xSMQL9OKL/b6hQv+e19PK+JZNE=
+google.golang.org/protobuf v1.21.0/go.mod h1:47Nbq4nVaFHyn7ilMalzfO3qCViNmqZ2kzikPIcrTAo=
+google.golang.org/protobuf v1.23.0/go.mod h1:EGpADcykh3NcUnDUJcl1+ZksZNG86OlYog2l/sGQquU=
 google.golang.org/protobuf v1.26.0-rc.1/go.mod h1:jlhhOSvTdKEhbULTjvd4ARK9grFBp09yW+WbY/TyQbw=
+google.golang.org/protobuf v1.26.0/go.mod h1:9q0QmTI4eRPtz6boOQmLYwt+qCgq0jsYwAQnmE0givc=
 google.golang.org/protobuf v1.28.0/go.mod h1:HV8QOd/L58Z+nl8r43ehVNZIU/HEI6OcFqwMG9pJV4I=
-google.golang.org/protobuf v1.36.6 h1:z1NpPI8ku2WgiWnf+t9wTPsn6eP1L7ksHUlkfLvd9xY=
-google.golang.org/protobuf v1.36.6/go.mod h1:jduwjTPXsFjZGTmRluh+L6NjiWu7pchiJ2/5YcXBHnY=
+google.golang.org/protobuf v1.36.8 h1:xHScyCOEuuwZEc6UtSOvPbAT4zRh0xcNRYekJwfqyMc=
+google.golang.org/protobuf v1.36.8/go.mod h1:fuxRtAxBytpl4zzqUh6/eyUujkJdNiuEkXntxiD/uRU=
 gopkg.in/check.v1 v0.0.0-20161208181325-20d25e280405/go.mod h1:Co6ibVJAznAaIkqp8huTwlJQCZ016jof/cbN4VW5Yz0=
 gopkg.in/check.v1 v1.0.0-20180628173108-788fd7840127/go.mod h1:Co6ibVJAznAaIkqp8huTwlJQCZ016jof/cbN4VW5Yz0=
 gopkg.in/check.v1 v1.0.0-20201130134442-10cb98267c6c h1:Hei/4ADfdWqJk1ZMxUNpqntNwaWcugrBjAiHlqqRiVk=
 gopkg.in/check.v1 v1.0.0-20201130134442-10cb98267c6c/go.mod h1:JHkPIbrfpd72SG/EVd6muEfDQjcINNoR0C8j2r3qZ4Q=
 gopkg.in/errgo.v2 v2.1.0/go.mod h1:hNsd1EY+bozCKY1Ytp96fpM3vjJbqLJn88ws8XvfDNI=
+gopkg.in/fsnotify.v1 v1.4.7/go.mod h1:Tz8NjZHkW78fSQdbUxIjBTcgA1z1m8ZHf0WmKUhAMys=
+gopkg.in/h2non/gock.v1 v1.1.2 h1:jBbHXgGBK/AoPVfJh5x4r/WxIrElvbLel8TCZkkZJoY=
+gopkg.in/h2non/gock.v1 v1.1.2/go.mod h1:n7UGz/ckNChHiK05rDoiC4MYSunEC/lyaUm2WWaDva0=
+gopkg.in/tomb.v1 v1.0.0-20141024135613-dd632973f1e7 h1:uRGJdciOHaEIrze2W8Q3AKkepLTh2hOroT7a+7czfdQ=
+gopkg.in/tomb.v1 v1.0.0-20141024135613-dd632973f1e7/go.mod h1:dt/ZhP58zS4L8KSrWDmTeBkI65Dw0HsyUHuEVlX15mw=
+gopkg.in/yaml.v2 v2.2.2/go.mod h1:hI93XBmqTisBFMUTm0b8Fm+jr3Dg1NNxqwp+5A1VGuI=
+gopkg.in/yaml.v2 v2.2.4/go.mod h1:hI93XBmqTisBFMUTm0b8Fm+jr3Dg1NNxqwp+5A1VGuI=
+gopkg.in/yaml.v2 v2.3.0/go.mod h1:hI93XBmqTisBFMUTm0b8Fm+jr3Dg1NNxqwp+5A1VGuI=
+gopkg.in/yaml.v2 v2.4.0 h1:D8xgwECY7CYvx+Y2n4sBz93Jn9JRvxdiyyo8CTfuKaY=
 gopkg.in/yaml.v2 v2.4.0/go.mod h1:RDklbk79AGWmwhnvt/jBztapEOGDOx6ZbXqjP6csGnQ=
 gopkg.in/yaml.v3 v3.0.0-20200313102051-9f266ea9e77c/go.mod h1:K4uyk7z7BCEPqu6E+C64Yfv1cQ7kz7rIZviUmN+EgEM=
 gopkg.in/yaml.v3 v3.0.0-20210107192922-496545a6307b/go.mod h1:K4uyk7z7BCEPqu6E+C64Yfv1cQ7kz7rIZviUmN+EgEM=

handlers/api_access_log_handler.go

@@ -0,0 +1,100 @@
+package handlers
+
+import (
+	"net/http"
+	"strconv"
+	"time"
+
+	"github.com/ctwj/urldb/db/converter"
+
+	"github.com/gin-gonic/gin"
+)
+
+// GetAPIAccessLogs 获取API访问日志
+func GetAPIAccessLogs(c *gin.Context) {
+	page, _ := strconv.Atoi(c.DefaultQuery("page", "1"))
+	pageSize, _ := strconv.Atoi(c.DefaultQuery("page_size", "20"))
+	startDateStr := c.Query("start_date")
+	endDateStr := c.Query("end_date")
+	endpoint := c.Query("endpoint")
+	ip := c.Query("ip")
+
+	var startDate, endDate *time.Time
+
+	if startDateStr != "" {
+		if parsed, err := time.Parse("2006-01-02", startDateStr); err == nil {
+			startDate = &parsed
+		}
+	}
+
+	if endDateStr != "" {
+		if parsed, err := time.Parse("2006-01-02", endDateStr); err == nil {
+			// 设置为当天结束时间
+			endOfDay := parsed.Add(24*time.Hour - time.Second)
+			endDate = &endOfDay
+		}
+	}
+
+	// 获取分页数据
+	logs, total, err := repoManager.APIAccessLogRepository.FindWithFilters(page, pageSize, startDate, endDate, endpoint, ip)
+	if err != nil {
+		ErrorResponse(c, "获取API访问日志失败: "+err.Error(), http.StatusInternalServerError)
+		return
+	}
+
+	response := converter.ToAPIAccessLogResponseList(logs)
+
+	SuccessResponse(c, gin.H{
+		"data":  response,
+		"total": int(total),
+		"page":  page,
+		"limit": pageSize,
+	})
+}
+
+// GetAPIAccessLogSummary 获取API访问日志汇总
+func GetAPIAccessLogSummary(c *gin.Context) {
+	summary, err := repoManager.APIAccessLogRepository.GetSummary()
+	if err != nil {
+		ErrorResponse(c, "获取API访问日志汇总失败: "+err.Error(), 500)
+		return
+	}
+
+	response := converter.ToAPIAccessLogSummaryResponse(summary)
+	SuccessResponse(c, response)
+}
+
+// GetAPIAccessLogStats 获取API访问日志统计
+func GetAPIAccessLogStats(c *gin.Context) {
+	stats, err := repoManager.APIAccessLogRepository.GetStatsByEndpoint()
+	if err != nil {
+		ErrorResponse(c, "获取API访问日志统计失败: "+err.Error(), http.StatusInternalServerError)
+		return
+	}
+
+	response := converter.ToAPIAccessLogStatsResponseList(stats)
+	SuccessResponse(c, response)
+}
+
+// ClearAPIAccessLogs 清理API访问日志
+func ClearAPIAccessLogs(c *gin.Context) {
+	daysStr := c.Query("days")
+	if daysStr == "" {
+		ErrorResponse(c, "请提供要清理的天数参数", http.StatusBadRequest)
+		return
+	}
+
+	days, err := strconv.Atoi(daysStr)
+	if err != nil || days < 1 {
+		ErrorResponse(c, "无效的天数参数", http.StatusBadRequest)
+		return
+	}
+
+	err = repoManager.APIAccessLogRepository.ClearOldLogs(days)
+	if err != nil {
+		ErrorResponse(c, "清理API访问日志失败: "+err.Error(), http.StatusInternalServerError)
+		return
+	}
+
+	SuccessResponse(c, gin.H{"message": "API访问日志清理成功"})
+}

handlers/cks_handler.go

@@ -2,6 +2,7 @@ package handlers
 
 import (
 	"encoding/json"
+	"log"
 	"net/http"
 	"strconv"
 	"strings"
@@ -22,7 +23,49 @@ func GetCks(c *gin.Context) {
 		return
 	}
 
-	responses := converter.ToCksResponseList(cks)
+	// 使用新的逻辑创建 CksResponse
+	var responses []dto.CksResponse
+	for _, ck := range cks {
+		// 获取平台信息
+		var pan *dto.PanResponse
+		if ck.PanID != 0 {
+			panEntity, err := repoManager.PanRepository.FindByID(ck.PanID)
+			if err == nil && panEntity != nil {
+				pan = &dto.PanResponse{
+					ID:     panEntity.ID,
+					Name:   panEntity.Name,
+					Key:    panEntity.Key,
+					Icon:   panEntity.Icon,
+					Remark: panEntity.Remark,
+				}
+			}
+		}
+
+		// 统计转存资源数
+		count, err := repoManager.ResourceRepository.CountResourcesByCkID(ck.ID)
+		if err != nil {
+			count = 0 // 统计失败时设为0
+		}
+
+		response := dto.CksResponse{
+			ID:               ck.ID,
+			PanID:            ck.PanID,
+			Idx:              ck.Idx,
+			Ck:               ck.Ck,
+			IsValid:          ck.IsValid,
+			Space:            ck.Space,
+			LeftSpace:        ck.LeftSpace,
+			UsedSpace:        ck.UsedSpace,
+			Username:         ck.Username,
+			VipStatus:        ck.VipStatus,
+			ServiceType:      ck.ServiceType,
+			Remark:           ck.Remark,
+			TransferredCount: count,
+			Pan:              pan,
+		}
+		responses = append(responses, response)
+	}
+
 	SuccessResponse(c, responses)
 }
 
@@ -68,32 +111,81 @@ func CreateCks(c *gin.Context) {
 	}
 
 	var cks *entity.Cks
-	// 迅雷网盘，添加的时候 只获取token就好， 然后刷新的时候， 再补充用户信息等
+	// 迅雷网盘，使用账号密码登录
 	if serviceType == panutils.Xunlei {
-		xunleiService := service.(*panutils.XunleiPanService)
-		tokenData, err := xunleiService.GetAccessTokenByRefreshToken(req.Ck)
+		// 解析账号密码信息
+		credentials, err := panutils.ParseCredentialsFromCk(req.Ck)
 		if err != nil {
-			ErrorResponse(c, "无法获取有效token: "+err.Error(), http.StatusBadRequest)
+			ErrorResponse(c, "账号密码格式错误: "+err.Error(), http.StatusBadRequest)
 			return
 		}
+
+		// 验证账号密码
+		if credentials.Username == "" || credentials.Password == "" {
+			ErrorResponse(c, "请提供完整的账号和密码", http.StatusBadRequest)
+			return
+		}
+
+		var tokenData *panutils.XunleiTokenData
+		var username string
+
+		// 使用账号密码登录
+		xunleiService := service.(*panutils.XunleiPanService)
+		token, err := xunleiService.LoginWithCredentials(credentials.Username, credentials.Password)
+		if err != nil {
+			ErrorResponse(c, "账号密码登录失败: "+err.Error(), http.StatusBadRequest)
+			return
+		}
+		tokenData = &token
+		username = credentials.Username
+
+		// 构建extra数据
 		extra := panutils.XunleiExtraData{
-			Token:   &tokenData,
+			Token:   tokenData,
 			Captcha: &panutils.CaptchaData{},
 		}
+
+		// 如果有账号密码信息，保存到extra中
+		if credentials.Username != "" && credentials.Password != "" {
+			extra.Credentials = credentials
+		}
+
 		extraStr, _ := json.Marshal(extra)
 
+		// 声明userInfo变量
+		var userInfo *panutils.UserInfo
+
+		// 设置CKSRepository以便获取用户信息
+		xunleiService.SetCKSRepository(repoManager.CksRepository, entity.Cks{})
+
+		// 获取用户信息
+		userInfo, err = xunleiService.GetUserInfo(nil)
+		if err != nil {
+			log.Printf("获取迅雷用户信息失败，使用默认值: %v", err)
+			// 如果获取失败，使用默认值
+			userInfo = &panutils.UserInfo{
+				Username:    username,
+				VIPStatus:   false,
+				ServiceType: "xunlei",
+				TotalSpace:  0,
+				UsedSpace:   0,
+			}
+		}
+
+		leftSpaceBytes := userInfo.TotalSpace - userInfo.UsedSpace
+
 		// 创建Cks实体
 		cks = &entity.Cks{
 			PanID:       req.PanID,
 			Idx:         req.Idx,
-			Ck:          tokenData.RefreshToken,
-			IsValid:     true, // 根据VIP状态设置有效性
-			Space:       0,
-			LeftSpace:   0,
-			UsedSpace:   0,
-			Username:    "-",
-			VipStatus:   false,
-			ServiceType: "xunlei",
+			Ck:          req.Ck, // 保持原始输入
+			IsValid:     userInfo.VIPStatus, // 根据VIP状态设置有效性
+			Space:       userInfo.TotalSpace,
+			LeftSpace:   leftSpaceBytes,
+			UsedSpace:   userInfo.UsedSpace,
+			Username:    userInfo.Username,
+			VipStatus:   userInfo.VIPStatus,
+			ServiceType: userInfo.ServiceType,
 			Extra:       string(extraStr),
 			Remark:      req.Remark,
 		}
@@ -346,14 +438,16 @@ func RefreshCapacity(c *gin.Context) {
 
 	var userInfo *panutils.UserInfo
 	service.SetCKSRepository(repoManager.CksRepository, *cks) // 迅雷需要初始化 token 后才能获取，
-	userInfo, err = service.GetUserInfo(&cks.Ck)
-	// switch s := service.(type) {
-	// case *panutils.XunleiPanService:
 
-	// 	userInfo, err = s.GetUserInfo(nil)
-	// default:
-	// 	userInfo, err = service.GetUserInfo(&cks.Ck)
-	// }
+	// 根据服务类型调用不同的GetUserInfo方法
+	switch s := service.(type) {
+	case *panutils.XunleiPanService:
+		// 迅雷网盘使用存储在extra中的token，不需要传递ck参数
+		userInfo, err = s.GetUserInfo(nil)
+	default:
+		// 其他网盘使用ck参数
+		userInfo, err = service.GetUserInfo(&cks.Ck)
+	}
 	if err != nil {
 		ErrorResponse(c, "无法获取用户信息，刷新失败: "+err.Error(), http.StatusBadRequest)
 		return
@@ -380,3 +474,25 @@ func RefreshCapacity(c *gin.Context) {
 		"cks":     converter.ToCksResponse(cks),
 	})
 }
+
+// DeleteRelatedResources 删除关联资源
+func DeleteRelatedResources(c *gin.Context) {
+	idStr := c.Param("id")
+	id, err := strconv.ParseUint(idStr, 10, 32)
+	if err != nil {
+		ErrorResponse(c, "无效的ID", http.StatusBadRequest)
+		return
+	}
+
+	// 调用资源库删除关联资源
+	affectedRows, err := repoManager.ResourceRepository.DeleteRelatedResources(uint(id))
+	if err != nil {
+		ErrorResponse(c, "删除关联资源失败: "+err.Error(), http.StatusInternalServerError)
+		return
+	}
+
+	SuccessResponse(c, gin.H{
+		"message":       "关联资源删除成功",
+		"affected_rows": affectedRows,
+	})
+}

handlers/copyright_claim_handler.go

@@ -0,0 +1,312 @@
+package handlers
+
+import (
+	"net/http"
+	"strconv"
+	"github.com/ctwj/urldb/db/converter"
+	"github.com/ctwj/urldb/db/dto"
+	"github.com/ctwj/urldb/db/entity"
+	"github.com/ctwj/urldb/db/repo"
+	"github.com/ctwj/urldb/middleware"
+
+	"github.com/gin-gonic/gin"
+	"github.com/go-playground/validator/v10"
+	"gorm.io/gorm"
+)
+
+type CopyrightClaimHandler struct {
+	copyrightClaimRepo repo.CopyrightClaimRepository
+	resourceRepo       repo.ResourceRepository
+	validate           *validator.Validate
+}
+
+func NewCopyrightClaimHandler(copyrightClaimRepo repo.CopyrightClaimRepository, resourceRepo repo.ResourceRepository) *CopyrightClaimHandler {
+	return &CopyrightClaimHandler{
+		copyrightClaimRepo: copyrightClaimRepo,
+		resourceRepo:       resourceRepo,
+		validate:           validator.New(),
+	}
+}
+
+// CreateCopyrightClaim 创建版权申述
+// @Summary 创建版权申述
+// @Description 提交资源版权申述
+// @Tags CopyrightClaim
+// @Accept json
+// @Produce json
+// @Param request body dto.CopyrightClaimCreateRequest true "版权申述信息"
+// @Success 200 {object} Response{data=dto.CopyrightClaimResponse}
+// @Failure 400 {object} Response
+// @Failure 500 {object} Response
+// @Router /copyright-claims [post]
+func (h *CopyrightClaimHandler) CreateCopyrightClaim(c *gin.Context) {
+	var req dto.CopyrightClaimCreateRequest
+	if err := c.ShouldBindJSON(&req); err != nil {
+		ErrorResponse(c, "参数错误: "+err.Error(), http.StatusBadRequest)
+		return
+	}
+
+	// 验证参数
+	if err := h.validate.Struct(req); err != nil {
+		ErrorResponse(c, "参数验证失败: "+err.Error(), http.StatusBadRequest)
+		return
+	}
+
+	// 创建版权申述实体
+	claim := &entity.CopyrightClaim{
+		ResourceKey:  req.ResourceKey,
+		Identity:     req.Identity,
+		ProofType:    req.ProofType,
+		Reason:       req.Reason,
+		ContactInfo:  req.ContactInfo,
+		ClaimantName: req.ClaimantName,
+		ProofFiles:   req.ProofFiles,
+		UserAgent:    req.UserAgent,
+		IPAddress:    req.IPAddress,
+		Status:       "pending", // 默认为待处理
+	}
+
+	// 保存到数据库
+	if err := h.copyrightClaimRepo.Create(claim); err != nil {
+		ErrorResponse(c, "创建版权申述失败: "+err.Error(), http.StatusInternalServerError)
+		return
+	}
+
+	// 返回响应
+	response := converter.CopyrightClaimToResponse(claim)
+	SuccessResponse(c, response)
+}
+
+// GetCopyrightClaim 获取版权申述详情
+// @Summary 获取版权申述详情
+// @Description 根据ID获取版权申述详情
+// @Tags CopyrightClaim
+// @Produce json
+// @Param id path int true "版权申述ID"
+// @Success 200 {object} Response{data=dto.CopyrightClaimResponse}
+// @Failure 400 {object} Response
+// @Failure 404 {object} Response
+// @Failure 500 {object} Response
+// @Router /copyright-claims/{id} [get]
+func (h *CopyrightClaimHandler) GetCopyrightClaim(c *gin.Context) {
+	id, err := strconv.ParseUint(c.Param("id"), 10, 32)
+	if err != nil {
+		ErrorResponse(c, "无效的ID", http.StatusBadRequest)
+		return
+	}
+
+	claim, err := h.copyrightClaimRepo.GetByID(uint(id))
+	if err != nil {
+		if err == gorm.ErrRecordNotFound {
+			ErrorResponse(c, "版权申述不存在", http.StatusNotFound)
+			return
+		}
+		ErrorResponse(c, "获取版权申述失败: "+err.Error(), http.StatusInternalServerError)
+		return
+	}
+
+	SuccessResponse(c, converter.CopyrightClaimToResponse(claim))
+}
+
+// ListCopyrightClaims 获取版权申述列表
+// @Summary 获取版权申述列表
+// @Description 获取版权申述列表（支持分页和状态筛选）
+// @Tags CopyrightClaim
+// @Produce json
+// @Param page query int false "页码" default(1)
+// @Param page_size query int false "每页数量" default(10)
+// @Param status query string false "处理状态"
+// @Success 200 {object} Response{data=object{items=[]dto.CopyrightClaimResponse,total=int}}
+// @Failure 400 {object} Response
+// @Failure 500 {object} Response
+// @Router /copyright-claims [get]
+func (h *CopyrightClaimHandler) ListCopyrightClaims(c *gin.Context) {
+	var req dto.CopyrightClaimListRequest
+	if err := c.ShouldBindQuery(&req); err != nil {
+		ErrorResponse(c, "参数错误: "+err.Error(), http.StatusBadRequest)
+		return
+	}
+
+	// 设置默认值
+	if req.Page == 0 {
+		req.Page = 1
+	}
+	if req.PageSize == 0 {
+		req.PageSize = 10
+	}
+
+	// 验证参数
+	if err := h.validate.Struct(req); err != nil {
+		ErrorResponse(c, "参数验证失败: "+err.Error(), http.StatusBadRequest)
+		return
+	}
+
+	claims, total, err := h.copyrightClaimRepo.List(req.Status, req.Page, req.PageSize)
+	if err != nil {
+		ErrorResponse(c, "获取版权申述列表失败: "+err.Error(), http.StatusInternalServerError)
+		return
+	}
+
+	// 转换为包含资源信息的响应
+	var responses []*dto.CopyrightClaimResponse
+	for _, claim := range claims {
+		// 查询关联的资源信息
+		resources, err := h.getResourcesByResourceKey(claim.ResourceKey)
+		if err != nil {
+			// 如果查询资源失败，使用空资源列表
+			responses = append(responses, converter.CopyrightClaimToResponse(claim))
+		} else {
+			// 使用包含资源详情的转换函数
+			responses = append(responses, converter.CopyrightClaimToResponseWithResources(claim, resources))
+		}
+	}
+
+	PageResponse(c, responses, total, req.Page, req.PageSize)
+}
+
+// getResourcesByResourceKey 根据资源key获取关联的资源列表
+func (h *CopyrightClaimHandler) getResourcesByResourceKey(resourceKey string) ([]*entity.Resource, error) {
+	// 从资源仓库获取与key关联的所有资源
+	resources, err := h.resourceRepo.FindByResourceKey(resourceKey)
+	if err != nil {
+		return nil, err
+	}
+
+	// 将 []entity.Resource 转换为 []*entity.Resource
+	var resourcePointers []*entity.Resource
+	for i := range resources {
+		resourcePointers = append(resourcePointers, &resources[i])
+	}
+
+	return resourcePointers, nil
+}
+
+// UpdateCopyrightClaim 更新版权申述状态
+// @Summary 更新版权申述状态
+// @Description 更新版权申述处理状态
+// @Tags CopyrightClaim
+// @Accept json
+// @Produce json
+// @Param id path int true "版权申述ID"
+// @Param request body dto.CopyrightClaimUpdateRequest true "更新信息"
+// @Success 200 {object} Response{data=dto.CopyrightClaimResponse}
+// @Failure 400 {object} Response
+// @Failure 404 {object} Response
+// @Failure 500 {object} Response
+// @Router /copyright-claims/{id} [put]
+func (h *CopyrightClaimHandler) UpdateCopyrightClaim(c *gin.Context) {
+	id, err := strconv.ParseUint(c.Param("id"), 10, 32)
+	if err != nil {
+		ErrorResponse(c, "无效的ID", http.StatusBadRequest)
+		return
+	}
+
+	var req dto.CopyrightClaimUpdateRequest
+	if err := c.ShouldBindJSON(&req); err != nil {
+		ErrorResponse(c, "参数错误: "+err.Error(), http.StatusBadRequest)
+		return
+	}
+
+	// 验证参数
+	if err := h.validate.Struct(req); err != nil {
+		ErrorResponse(c, "参数验证失败: "+err.Error(), http.StatusBadRequest)
+		return
+	}
+
+	// 获取当前版权申述
+	_, err = h.copyrightClaimRepo.GetByID(uint(id))
+	if err != nil {
+		if err == gorm.ErrRecordNotFound {
+			ErrorResponse(c, "版权申述不存在", http.StatusNotFound)
+			return
+		}
+		ErrorResponse(c, "获取版权申述失败: "+err.Error(), http.StatusInternalServerError)
+		return
+	}
+
+	// 更新状态
+	processedBy := uint(0) // 从上下文获取当前用户ID，如果存在的话
+	if currentUser := c.GetUint("user_id"); currentUser > 0 {
+		processedBy = currentUser
+	}
+
+	if err := h.copyrightClaimRepo.UpdateStatus(uint(id), req.Status, &processedBy, req.Note); err != nil {
+		ErrorResponse(c, "更新版权申述状态失败: "+err.Error(), http.StatusInternalServerError)
+		return
+	}
+
+	// 获取更新后的版权申述信息
+	updatedClaim, err := h.copyrightClaimRepo.GetByID(uint(id))
+	if err != nil {
+		ErrorResponse(c, "获取更新后版权申述信息失败: "+err.Error(), http.StatusInternalServerError)
+		return
+	}
+
+	SuccessResponse(c, converter.CopyrightClaimToResponse(updatedClaim))
+}
+
+// DeleteCopyrightClaim 删除版权申述
+// @Summary 删除版权申述
+// @Description 删除版权申述记录
+// @Tags CopyrightClaim
+// @Produce json
+// @Param id path int true "版权申述ID"
+// @Success 200 {object} Response
+// @Failure 400 {object} Response
+// @Failure 500 {object} Response
+// @Router /copyright-claims/{id} [delete]
+func (h *CopyrightClaimHandler) DeleteCopyrightClaim(c *gin.Context) {
+	id, err := strconv.ParseUint(c.Param("id"), 10, 32)
+	if err != nil {
+		ErrorResponse(c, "无效的ID", http.StatusBadRequest)
+		return
+	}
+
+	if err := h.copyrightClaimRepo.Delete(uint(id)); err != nil {
+		ErrorResponse(c, "删除版权申述失败: "+err.Error(), http.StatusInternalServerError)
+		return
+	}
+
+	SuccessResponse(c, nil)
+}
+
+// GetCopyrightClaimByResource 获取某个资源的版权申述列表
+// @Summary 获取资源版权申述列表
+// @Description 获取某个资源的所有版权申述记录
+// @Tags CopyrightClaim
+// @Produce json
+// @Param resource_key path string true "资源Key"
+// @Success 200 {object} Response{data=[]dto.CopyrightClaimResponse}
+// @Failure 400 {object} Response
+// @Failure 500 {object} Response
+// @Router /copyright-claims/resource/{resource_key} [get]
+func (h *CopyrightClaimHandler) GetCopyrightClaimByResource(c *gin.Context) {
+	resourceKey := c.Param("resource_key")
+	if resourceKey == "" {
+		ErrorResponse(c, "资源Key不能为空", http.StatusBadRequest)
+		return
+	}
+
+	claims, err := h.copyrightClaimRepo.GetByResourceKey(resourceKey)
+	if err != nil {
+		ErrorResponse(c, "获取资源版权申述失败: "+err.Error(), http.StatusInternalServerError)
+		return
+	}
+
+	SuccessResponse(c, converter.CopyrightClaimsToResponse(claims))
+}
+
+// RegisterCopyrightClaimRoutes 注册版权申述相关路由
+func RegisterCopyrightClaimRoutes(router *gin.RouterGroup, copyrightClaimRepo repo.CopyrightClaimRepository, resourceRepo repo.ResourceRepository) {
+	handler := NewCopyrightClaimHandler(copyrightClaimRepo, resourceRepo)
+
+	claims := router.Group("/copyright-claims")
+	{
+		claims.POST("", handler.CreateCopyrightClaim)                    // 创建版权申述
+		claims.GET("/:id", handler.GetCopyrightClaim)                    // 获取版权申述详情
+		claims.GET("", middleware.AuthMiddleware(), middleware.AdminMiddleware(), handler.ListCopyrightClaims)                      // 获取版权申述列表
+		claims.PUT("/:id", middleware.AuthMiddleware(), middleware.AdminMiddleware(), handler.UpdateCopyrightClaim)                 // 更新版权申述状态
+		claims.DELETE("/:id", middleware.AuthMiddleware(), middleware.AdminMiddleware(), handler.DeleteCopyrightClaim)              // 删除版权申述
+		claims.GET("/resource/:resource_key", handler.GetCopyrightClaimByResource) // 获取资源版权申述列表
+	}
+}

handlers/file_handler.go

@@ -440,3 +440,80 @@ func (h *FileHandler) calculateFileHash(filePath string) (string, error) {
 	}
 	return fmt.Sprintf("%x", hash.Sum(nil)), nil
 }
+
+// UploadWechatVerifyFile 上传微信公众号验证文件（TXT文件）
+// 无需认证，仅支持TXT文件，不记录数据库，直接保存到uploads目录
+func (h *FileHandler) UploadWechatVerifyFile(c *gin.Context) {
+	// 获取上传的文件
+	file, err := c.FormFile("file")
+	if err != nil {
+		ErrorResponse(c, "未提供文件", http.StatusBadRequest)
+		return
+	}
+
+	// 验证文件扩展名必须是.txt
+	ext := strings.ToLower(filepath.Ext(file.Filename))
+	if ext != ".txt" {
+		ErrorResponse(c, "仅支持TXT文件", http.StatusBadRequest)
+		return
+	}
+
+	// 验证文件大小（限制1MB）
+	if file.Size > 1*1024*1024 {
+		ErrorResponse(c, "文件大小不能超过1MB", http.StatusBadRequest)
+		return
+	}
+
+	// 生成文件名（使用原始文件名，但确保是安全的）
+	originalName := filepath.Base(file.Filename)
+	safeFileName := h.makeSafeFileName(originalName)
+
+	// 确保uploads目录存在
+	uploadsDir := "./uploads"
+	if err := os.MkdirAll(uploadsDir, 0755); err != nil {
+		ErrorResponse(c, "创建上传目录失败", http.StatusInternalServerError)
+		return
+	}
+
+	// 构建完整文件路径
+	filePath := filepath.Join(uploadsDir, safeFileName)
+
+	// 保存文件
+	if err := c.SaveUploadedFile(file, filePath); err != nil {
+		ErrorResponse(c, "保存文件失败", http.StatusInternalServerError)
+		return
+	}
+
+	// 设置文件权限
+	if err := os.Chmod(filePath, 0644); err != nil {
+		utils.Warn("设置文件权限失败: %v", err)
+	}
+
+	// 返回成功响应
+	accessURL := fmt.Sprintf("/%s", safeFileName)
+	response := map[string]interface{}{
+		"success":    true,
+		"message":    "验证文件上传成功",
+		"file_name":  safeFileName,
+		"access_url": accessURL,
+	}
+
+	SuccessResponse(c, response)
+}
+
+// makeSafeFileName 生成安全的文件名，移除危险字符
+func (h *FileHandler) makeSafeFileName(filename string) string {
+	// 移除路径分隔符和特殊字符
+	safeName := strings.ReplaceAll(filename, "/", "_")
+	safeName = strings.ReplaceAll(safeName, "\\", "_")
+	safeName = strings.ReplaceAll(safeName, "..", "_")
+
+	// 限制文件名长度
+	if len(safeName) > 100 {
+		ext := filepath.Ext(safeName)
+		name := safeName[:100-len(ext)]
+		safeName = name + ext
+	}
+
+	return safeName
+}

handlers/log_handler.go

@@ -0,0 +1,188 @@
+package handlers
+
+import (
+	"net/http"
+	"strconv"
+	"time"
+
+	"github.com/ctwj/urldb/utils"
+
+	"github.com/gin-gonic/gin"
+)
+
+// GetSystemLogs 获取系统日志
+func GetSystemLogs(c *gin.Context) {
+	page, _ := strconv.Atoi(c.DefaultQuery("page", "1"))
+	pageSize, _ := strconv.Atoi(c.DefaultQuery("page_size", "50"))
+	level := c.Query("level")
+	startDateStr := c.Query("start_date")
+	endDateStr := c.Query("end_date")
+	search := c.Query("search")
+
+	var startDate, endDate *time.Time
+
+	if startDateStr != "" {
+		if parsed, err := time.Parse("2006-01-02", startDateStr); err == nil {
+			startDate = &parsed
+		}
+	}
+
+	if endDateStr != "" {
+		if parsed, err := time.Parse("2006-01-02", endDateStr); err == nil {
+			// 设置为当天结束时间
+			endOfDay := parsed.Add(24*time.Hour - time.Second)
+			endDate = &endOfDay
+		}
+	}
+
+	// 使用日志查看器获取日志
+	logViewer := utils.NewLogViewer("logs")
+
+	// 获取日志文件列表
+	logFiles, err := logViewer.GetLogFiles()
+	if err != nil {
+		ErrorResponse(c, "获取日志文件失败: "+err.Error(), http.StatusInternalServerError)
+		return
+	}
+
+	// 如果指定了日期范围，只选择对应日期的日志文件
+	if startDate != nil || endDate != nil {
+		var filteredFiles []string
+		for _, file := range logFiles {
+			fileInfo, err := utils.GetFileInfo(file)
+			if err != nil {
+				continue
+			}
+
+			shouldInclude := true
+			if startDate != nil {
+				if fileInfo.ModTime().Before(*startDate) {
+					shouldInclude = false
+				}
+			}
+			if endDate != nil {
+				if fileInfo.ModTime().After(*endDate) {
+					shouldInclude = false
+				}
+			}
+
+			if shouldInclude {
+				filteredFiles = append(filteredFiles, file)
+			}
+		}
+		logFiles = filteredFiles
+	}
+
+	// 限制读取的文件数量以提高性能
+	if len(logFiles) > 10 {
+		logFiles = logFiles[:10] // 只处理最近的10个文件
+	}
+
+	var allLogs []utils.LogEntry
+	for _, file := range logFiles {
+		// 读取日志文件
+		fileLogs, err := logViewer.ParseLogEntriesFromFile(file, level, search)
+		if err != nil {
+			utils.Error("解析日志文件失败 %s: %v", file, err)
+			continue
+		}
+		allLogs = append(allLogs, fileLogs...)
+	}
+
+	// 按时间排序（最新的在前）
+	utils.SortLogEntriesByTime(allLogs, false)
+
+	// 应用分页
+	start := (page - 1) * pageSize
+	end := start + pageSize
+	if start > len(allLogs) {
+		start = len(allLogs)
+	}
+	if end > len(allLogs) {
+		end = len(allLogs)
+	}
+
+	pagedLogs := allLogs[start:end]
+
+	SuccessResponse(c, gin.H{
+		"data":  pagedLogs,
+		"total": len(allLogs),
+		"page":  page,
+		"limit": pageSize,
+	})
+}
+
+// GetSystemLogFiles 获取系统日志文件列表
+func GetSystemLogFiles(c *gin.Context) {
+	logViewer := utils.NewLogViewer("logs")
+	files, err := logViewer.GetLogFiles()
+	if err != nil {
+		ErrorResponse(c, "获取日志文件列表失败: "+err.Error(), http.StatusInternalServerError)
+		return
+	}
+
+	// 获取每个文件的详细信息
+	var fileInfos []gin.H
+	for _, file := range files {
+		info, err := utils.GetFileInfo(file)
+		if err != nil {
+			continue
+		}
+		fileInfos = append(fileInfos, gin.H{
+			"name":     info.Name(),
+			"size":     info.Size(),
+			"mod_time": info.ModTime(),
+			"path":     file,
+		})
+	}
+
+	SuccessResponse(c, gin.H{
+		"data": fileInfos,
+	})
+}
+
+// GetSystemLogSummary 获取系统日志统计摘要
+func GetSystemLogSummary(c *gin.Context) {
+	logViewer := utils.NewLogViewer("logs")
+	files, err := logViewer.GetLogFiles()
+	if err != nil {
+		ErrorResponse(c, "获取日志文件列表失败: "+err.Error(), http.StatusInternalServerError)
+		return
+	}
+
+	// 获取统计信息
+	stats, err := logViewer.GetLogStats(files)
+	if err != nil {
+		ErrorResponse(c, "获取日志统计信息失败: "+err.Error(), http.StatusInternalServerError)
+		return
+	}
+
+	SuccessResponse(c, gin.H{
+		"summary":    stats,
+		"files_count": len(files),
+	})
+}
+
+// ClearSystemLogs 清理系统日志
+func ClearSystemLogs(c *gin.Context) {
+	daysStr := c.Query("days")
+	if daysStr == "" {
+		ErrorResponse(c, "请提供要清理的天数参数", http.StatusBadRequest)
+		return
+	}
+
+	days, err := strconv.Atoi(daysStr)
+	if err != nil || days < 1 {
+		ErrorResponse(c, "无效的天数参数", http.StatusBadRequest)
+		return
+	}
+
+	logViewer := utils.NewLogViewer("logs")
+	err = logViewer.CleanOldLogs(days)
+	if err != nil {
+		ErrorResponse(c, "清理系统日志失败: "+err.Error(), http.StatusInternalServerError)
+		return
+	}
+
+	SuccessResponse(c, gin.H{"message": "系统日志清理成功"})
+}

handlers/og_image.go

@@ -0,0 +1,565 @@
+package handlers
+
+import (
+	"bytes"
+	"fmt"
+	"net/http"
+	"strconv"
+	"strings"
+
+	"github.com/ctwj/urldb/utils"
+	"github.com/ctwj/urldb/db"
+	"github.com/ctwj/urldb/db/entity"
+	"github.com/gin-gonic/gin"
+	"github.com/fogleman/gg"
+	"image/color"
+	"image"
+	_ "image/jpeg"
+	_ "image/png"
+	"io"
+)
+
+// OGImageHandler 处理OG图片生成请求
+type OGImageHandler struct{}
+
+// NewOGImageHandler 创建新的OG图片处理器
+func NewOGImageHandler() *OGImageHandler {
+	return &OGImageHandler{}
+}
+
+// Resource 简化的资源结构体
+type Resource struct {
+	Title       string
+	Description string
+	Cover       string
+	Key         string
+}
+
+// getResourceByKey 通过key获取资源信息
+func (h *OGImageHandler) getResourceByKey(key string) (*Resource, error) {
+	// 这里简化处理，实际应该从数据库查询
+	// 为了演示，我们先返回一个模拟的资源
+	// 在实际应用中，您需要连接数据库并查询
+
+	// 模拟数据库查询 - 实际应用中请替换为真实的数据库查询
+	dbInstance := db.DB
+	if dbInstance == nil {
+		return nil, fmt.Errorf("数据库连接失败")
+	}
+
+	var resource entity.Resource
+	result := dbInstance.Where("key = ?", key).First(&resource)
+	if result.Error != nil {
+		return nil, result.Error
+	}
+
+	return &Resource{
+		Title:       resource.Title,
+		Description: resource.Description,
+		Cover:       resource.Cover,
+		Key:         resource.Key,
+	}, nil
+}
+
+// GenerateOGImage 生成OG图片
+func (h *OGImageHandler) GenerateOGImage(c *gin.Context) {
+	// 获取请求参数
+	key := strings.TrimSpace(c.Query("key"))
+	title := strings.TrimSpace(c.Query("title"))
+	description := strings.TrimSpace(c.Query("description"))
+	siteName := strings.TrimSpace(c.Query("site_name"))
+	theme := strings.TrimSpace(c.Query("theme"))
+	coverUrl := strings.TrimSpace(c.Query("cover"))
+
+	width, _ := strconv.Atoi(c.Query("width"))
+	height, _ := strconv.Atoi(c.Query("height"))
+
+	// 如果提供了key，从数据库获取资源信息
+	if key != "" {
+		resource, err := h.getResourceByKey(key)
+		if err == nil && resource != nil {
+			if title == "" {
+				title = resource.Title
+			}
+			if description == "" {
+				description = resource.Description
+			}
+			if coverUrl == "" && resource.Cover != "" {
+				coverUrl = resource.Cover
+			}
+		}
+	}
+
+	// 设置默认值
+	if title == "" {
+		title = "老九网盘资源数据库"
+	}
+	if siteName == "" {
+		siteName = "老九网盘"
+	}
+	if width <= 0 || width > 2000 {
+		width = 1200
+	}
+	if height <= 0 || height > 2000 {
+		height = 630
+	}
+
+	// 获取当前请求的域名
+	scheme := "http"
+	if c.Request.TLS != nil {
+		scheme = "https"
+	}
+	host := c.Request.Host
+	domain := scheme + "://" + host
+
+	// 生成图片
+	imageBuffer, err := createOGImage(title, description, siteName, theme, width, height, coverUrl, key, domain)
+	if err != nil {
+		utils.Error("生成OG图片失败: %v", err)
+		c.JSON(http.StatusInternalServerError, gin.H{
+			"error": "Failed to generate image: " + err.Error(),
+		})
+		return
+	}
+
+	// 返回图片
+	c.Data(http.StatusOK, "image/png", imageBuffer.Bytes())
+	c.Header("Content-Type", "image/png")
+	c.Header("Cache-Control", "public, max-age=3600")
+}
+
+// createOGImage 创建OG图片
+func createOGImage(title, description, siteName, theme string, width, height int, coverUrl, key, domain string) (*bytes.Buffer, error) {
+	dc := gg.NewContext(width, height)
+
+	// 设置圆角裁剪区域
+	cornerRadius := 20.0
+	dc.DrawRoundedRectangle(0, 0, float64(width), float64(height), cornerRadius)
+
+	// 设置背景色
+	bgColor := getBackgroundColor(theme)
+	dc.SetColor(bgColor)
+	dc.Fill()
+
+	// 绘制渐变效果
+	gradient := gg.NewLinearGradient(0, 0, float64(width), float64(height))
+	gradient.AddColorStop(0, getGradientStartColor(theme))
+	gradient.AddColorStop(1, getGradientEndColor(theme))
+	dc.SetFillStyle(gradient)
+	dc.Fill()
+
+	// 定义布局区域
+	imageAreaWidth := width / 3  // 左侧1/3用于图片
+	textAreaWidth := width * 2 / 3  // 右侧2/3用于文案
+	textAreaX := imageAreaWidth  // 文案区域起始X坐标
+
+	// 统一的字体加载函数，确保中文显示正常
+	loadChineseFont := func(fontSize float64) bool {
+		// 优先使用项目字体
+		if err := dc.LoadFontFace("font/SourceHanSansSC-Regular.otf", fontSize); err == nil {
+			return true
+		}
+
+		// Windows系统常见字体，按优先级顺序尝试
+		commonFonts := []string{
+			"C:/Windows/Fonts/msyh.ttc",     // 微软雅黑
+			"C:/Windows/Fonts/simhei.ttf",   // 黑体
+			"C:/Windows/Fonts/simsun.ttc",   // 宋体
+		}
+
+		for _, fontPath := range commonFonts {
+			if err := dc.LoadFontFace(fontPath, fontSize); err == nil {
+				return true
+			}
+		}
+
+		// 如果都失败了，尝试使用粗体版本
+		boldFonts := []string{
+			"C:/Windows/Fonts/msyhbd.ttc",   // 微软雅黑粗体
+			"C:/Windows/Fonts/simhei.ttf",   // 黑体
+		}
+
+		for _, fontPath := range boldFonts {
+			if err := dc.LoadFontFace(fontPath, fontSize); err == nil {
+				return true
+			}
+		}
+
+		return false
+	}
+
+	// 加载基础字体（24px）
+	fontLoaded := loadChineseFont(24)
+	dc.SetHexColor("#ffffff")
+
+	// 绘制封面图片（如果存在）
+	if coverUrl != "" {
+		if err := drawCoverImageInLeftArea(dc, coverUrl, width, height, imageAreaWidth); err != nil {
+			utils.Error("绘制封面图片失败: %v", err)
+		}
+	}
+
+	// 设置站点标识
+	dc.DrawStringAnchored(siteName, float64(textAreaX)+60, 50, 0, 0.5)
+
+	// 绘制标题
+	dc.SetHexColor("#ffffff")
+
+	// 标题在右侧区域显示，考虑文案宽度限制
+	maxTitleWidth := float64(textAreaWidth - 120)  // 右侧区域减去左右边距
+
+	// 动态调整字体大小以适应文案区域，使用统一的字体加载逻辑
+	fontSize := 48.0
+	titleFontLoaded := false
+	for fontSize > 24 {  // 最小字体24
+		// 优先使用项目粗体字体
+		if err := dc.LoadFontFace("font/SourceHanSansSC-Bold.otf", fontSize); err == nil {
+			titleWidth, _ := dc.MeasureString(title)
+			if titleWidth <= maxTitleWidth {
+				titleFontLoaded = true
+				break
+			}
+		} else {
+			// 尝试系统粗体字体
+			boldFonts := []string{
+				"C:/Windows/Fonts/msyhbd.ttc",   // 微软雅黑粗体
+				"C:/Windows/Fonts/simhei.ttf",   // 黑体
+			}
+			for _, fontPath := range boldFonts {
+				if err := dc.LoadFontFace(fontPath, fontSize); err == nil {
+					titleWidth, _ := dc.MeasureString(title)
+					if titleWidth <= maxTitleWidth {
+						titleFontLoaded = true
+						break
+					}
+					break  // 找到可用字体就跳出内层循环
+				}
+			}
+			if titleFontLoaded {
+				break
+			}
+		}
+		fontSize -= 4
+	}
+
+	// 如果粗体字体都失败了，使用常规字体
+	if !titleFontLoaded {
+		loadChineseFont(36) // 使用稍大的常规字体
+	}
+
+	// 标题左对齐显示在右侧区域
+	titleX := float64(textAreaX) + 60
+	titleY := float64(height)/2 - 80
+	dc.DrawString(title, titleX, titleY)
+
+	// 绘制描述
+	if description != "" {
+		dc.SetHexColor("#e5e7eb")
+		// 使用统一的字体加载逻辑
+		loadChineseFont(28)
+
+		// 自动换行处理，适配右侧区域宽度
+		wrappedDesc := wrapText(dc, description, float64(textAreaWidth-120))
+		descY := titleY + 60  // 标题下方
+
+		for i, line := range wrappedDesc {
+			y := descY + float64(i)*30  // 行高30像素
+			dc.DrawString(line, titleX, y)
+		}
+	}
+
+	// 添加装饰性元素
+	drawDecorativeElements(dc, width, height, theme)
+
+	// 绘制底部URL访问地址
+	if key != "" && domain != "" {
+		resourceURL := domain + "/r/" + key
+		dc.SetHexColor("#d1d5db") // 浅灰色
+
+		// 使用统一的字体加载逻辑
+		loadChineseFont(20)
+
+		// URL位置：底部居中，距离底部边缘40像素，给更多空间
+		urlY := float64(height) - 40
+
+		dc.DrawStringAnchored(resourceURL, float64(width)/2, urlY, 0.5, 0.5)
+	}
+
+	// 添加调试信息（仅在开发环境）
+	if title == "DEBUG" {
+		dc.SetHexColor("#ff0000")
+		dc.DrawString("Font loaded: "+strconv.FormatBool(fontLoaded), 50, float64(height)-80)
+	}
+
+	// 生成图片
+	buf := &bytes.Buffer{}
+	err := dc.EncodePNG(buf)
+	if err != nil {
+		return nil, err
+	}
+
+	return buf, nil
+}
+
+// getBackgroundColor 获取背景色
+func getBackgroundColor(theme string) color.RGBA {
+	switch theme {
+	case "dark":
+		return color.RGBA{31, 41, 55, 255} // slate-800
+	case "blue":
+		return color.RGBA{29, 78, 216, 255} // blue-700
+	case "green":
+		return color.RGBA{6, 95, 70, 255} // emerald-800
+	case "purple":
+		return color.RGBA{109, 40, 217, 255} // violet-700
+	default:
+		return color.RGBA{55, 65, 81, 255} // gray-800
+	}
+}
+
+// getGradientStartColor 获取渐变起始色
+func getGradientStartColor(theme string) color.Color {
+	switch theme {
+	case "dark":
+		return color.RGBA{15, 23, 42, 255} // slate-900
+	case "blue":
+		return color.RGBA{30, 58, 138, 255} // blue-900
+	case "green":
+		return color.RGBA{6, 78, 59, 255} // emerald-900
+	case "purple":
+		return color.RGBA{91, 33, 182, 255} // violet-800
+	default:
+		return color.RGBA{31, 41, 55, 255} // gray-800
+	}
+}
+
+// getGradientEndColor 获取渐变结束色
+func getGradientEndColor(theme string) color.Color {
+	switch theme {
+	case "dark":
+		return color.RGBA{55, 65, 81, 255} // slate-700
+	case "blue":
+		return color.RGBA{59, 130, 246, 255} // blue-500
+	case "green":
+		return color.RGBA{16, 185, 129, 255} // emerald-500
+	case "purple":
+		return color.RGBA{139, 92, 246, 255} // violet-500
+	default:
+		return color.RGBA{75, 85, 99, 255} // gray-600
+	}
+}
+
+// wrapText 文本自动换行处理
+func wrapText(dc *gg.Context, text string, maxWidth float64) []string {
+	var lines []string
+	words := []rune(text)
+
+	currentLine := ""
+	for _, word := range words {
+		testLine := currentLine + string(word)
+		width, _ := dc.MeasureString(testLine)
+
+		if width > maxWidth && len(currentLine) > 0 {
+			lines = append(lines, currentLine)
+			currentLine = string(word)
+		} else {
+			currentLine = testLine
+		}
+	}
+
+	if currentLine != "" {
+		lines = append(lines, currentLine)
+	}
+
+	// 最多显示3行
+	if len(lines) > 3 {
+		lines = lines[:3]
+		// 在最后一行添加省略号
+		if len(lines[2]) > 3 {
+			lines[2] = lines[2][:len(lines[2])-3] + "..."
+		}
+	}
+
+	return lines
+}
+
+// drawDecorativeElements 绘制装饰性元素
+func drawDecorativeElements(dc *gg.Context, width, height int, theme string) {
+	// 绘制装饰性圆点
+	dc.SetHexColor("#ffffff")
+	dc.SetLineWidth(2)
+
+	for i := 0; i < 5; i++ {
+		x := float64(100 + i*150)
+		y := float64(100 + (i%2)*200)
+		dc.DrawCircle(x, y, 8)
+		dc.Stroke()
+	}
+
+	// 绘制底部装饰线
+	dc.DrawLine(60, float64(height-80), float64(width-60), float64(height-80))
+	dc.Stroke()
+}
+
+// drawCoverImageInLeftArea 在左侧1/3区域绘制封面图片
+func drawCoverImageInLeftArea(dc *gg.Context, coverUrl string, width, height int, imageAreaWidth int) error {
+	// 下载封面图片
+	resp, err := http.Get(coverUrl)
+	if err != nil {
+		return err
+	}
+	defer resp.Body.Close()
+
+	// 读取图片数据
+	imgData, err := io.ReadAll(resp.Body)
+	if err != nil {
+		return err
+	}
+
+	// 解码图片
+	img, _, err := image.Decode(bytes.NewReader(imgData))
+	if err != nil {
+		return err
+	}
+
+	// 获取图片尺寸和宽高比
+	bounds := img.Bounds()
+	imgWidth := bounds.Dx()
+	imgHeight := bounds.Dy()
+	aspectRatio := float64(imgWidth) / float64(imgHeight)
+
+	// 计算图片区域的可显示尺寸，留出边距
+	padding := 40
+	maxImageWidth := imageAreaWidth - padding*2
+	maxImageHeight := height - padding*2
+
+	var scaledImg image.Image
+	var drawWidth, drawHeight, drawX, drawY int
+
+	// 判断是竖图还是横图，采用不同的缩放策略
+	if aspectRatio < 1.0 {
+		// 竖图：充满整个左侧区域（去掉边距）
+		drawHeight = height - padding*2  // 留上下边距
+		drawWidth = int(float64(drawHeight) * aspectRatio)
+
+		// 如果宽度超出左侧区域，则以宽度为准充满整个区域宽度
+		if drawWidth > imageAreaWidth - padding*2 {
+			drawWidth = imageAreaWidth - padding*2
+			drawHeight = int(float64(drawWidth) / aspectRatio)
+		}
+
+		// 缩放图片
+		scaledImg = scaleImage(img, drawWidth, drawHeight)
+
+		// 垂直居中，水平居左
+		drawX = padding
+		drawY = (height - drawHeight) / 2
+	} else {
+		// 横图：优先占满宽度
+		drawWidth = maxImageWidth
+		drawHeight = int(float64(drawWidth) / aspectRatio)
+
+		// 如果高度超出限制，则以高度为准
+		if drawHeight > maxImageHeight {
+			drawHeight = maxImageHeight
+			drawWidth = int(float64(drawHeight) * aspectRatio)
+		}
+
+		// 缩放图片
+		scaledImg = scaleImage(img, drawWidth, drawHeight)
+
+		// 水平居中，垂直居中
+		drawX = (imageAreaWidth - drawWidth) / 2
+		drawY = (height - drawHeight) / 2
+	}
+
+	// 绘制图片
+	dc.DrawImage(scaledImg, drawX, drawY)
+
+	// 添加半透明遮罩效果，让文字更清晰（仅在有图片时添加）
+	maskColor := color.RGBA{0, 0, 0, 80} // 半透明黑色，透明度稍低
+	dc.SetColor(maskColor)
+	dc.DrawRectangle(float64(drawX), float64(drawY), float64(drawWidth), float64(drawHeight))
+	dc.Fill()
+
+	return nil
+}
+
+// scaleImage 图片缩放函数
+func scaleImage(img image.Image, width, height int) image.Image {
+	// 使用 gg 库的 Scale 变换来实现缩放
+	srcWidth := img.Bounds().Dx()
+	srcHeight := img.Bounds().Dy()
+
+	// 创建目标尺寸的画布
+	dc := gg.NewContext(width, height)
+
+	// 计算缩放比例
+	scaleX := float64(width) / float64(srcWidth)
+	scaleY := float64(height) / float64(srcHeight)
+
+	// 应用缩放变换并绘制图片
+	dc.Scale(scaleX, scaleY)
+	dc.DrawImage(img, 0, 0)
+
+	return dc.Image()
+}
+
+// drawCoverImage 绘制封面图片（保留原函数作为备用）
+func drawCoverImage(dc *gg.Context, coverUrl string, width, height int) error {
+	// 下载封面图片
+	resp, err := http.Get(coverUrl)
+	if err != nil {
+		return err
+	}
+	defer resp.Body.Close()
+
+	// 读取图片数据
+	imgData, err := io.ReadAll(resp.Body)
+	if err != nil {
+		return err
+	}
+
+	// 解码图片
+	img, _, err := image.Decode(bytes.NewReader(imgData))
+	if err != nil {
+		return err
+	}
+
+	// 计算封面图片的位置和大小，放置在左侧
+	coverWidth := 200  // 封面图宽度
+	coverHeight := 280 // 封面图高度
+	coverX := 50
+	coverY := (height - coverHeight) / 2
+
+	// 绘制封面图片（按比例缩放）
+	bounds := img.Bounds()
+	imgWidth := bounds.Dx()
+	imgHeight := bounds.Dy()
+
+	// 计算缩放比例，保持宽高比
+	scaleX := float64(coverWidth) / float64(imgWidth)
+	scaleY := float64(coverHeight) / float64(imgHeight)
+	scale := scaleX
+	if scaleY < scaleX {
+		scale = scaleY
+	}
+
+	// 计算缩放后的尺寸
+	newWidth := int(float64(imgWidth) * scale)
+	newHeight := int(float64(imgHeight) * scale)
+
+	// 居中绘制
+	offsetX := coverX + (coverWidth-newWidth)/2
+	offsetY := coverY + (coverHeight-newHeight)/2
+
+	dc.DrawImage(img, offsetX, offsetY)
+
+	// 添加半透明遮罩效果，让文字更清晰
+	maskColor := color.RGBA{0, 0, 0, 120} // 半透明黑色
+	dc.SetColor(maskColor)
+	dc.DrawRectangle(float64(coverX), float64(coverY), float64(coverWidth), float64(coverHeight))
+	dc.Fill()
+
+	return nil
+}

handlers/public_api_handler.go

@@ -1,8 +1,10 @@
 package handlers
 
 import (
+	"encoding/json"
 	"strconv"
 	"strings"
+	"time"
 
 	"github.com/ctwj/urldb/db/dto"
 	"github.com/ctwj/urldb/db/entity"
@@ -69,6 +71,32 @@ func (h *PublicAPIHandler) filterForbiddenWords(resources []entity.Resource) ([]
 	return filteredResources, uniqueForbiddenWords
 }
 
+// logAPIAccess 记录API访问日志
+func (h *PublicAPIHandler) logAPIAccess(c *gin.Context, startTime time.Time, processCount int, responseData interface{}, errorMessage string) {
+	endpoint := c.Request.URL.Path
+	method := c.Request.Method
+	ip := c.ClientIP()
+	userAgent := c.GetHeader("User-Agent")
+
+	// 计算处理时间
+	processingTime := time.Since(startTime).Milliseconds()
+
+	// 获取查询参数
+	var requestParams interface{}
+	if method == "GET" {
+		requestParams = c.Request.URL.Query()
+	} else {
+		// 对于POST请求，尝试从上下文中获取请求体（如果之前已解析）
+		if req, exists := c.Get("request_body"); exists {
+			requestParams = req
+		}
+	}
+
+	// 记录API访问日志 - 使用简单日志记录
+	h.recordAPIAccessToDB(ip, userAgent, endpoint, method, requestParams,
+		c.Writer.Status(), responseData, processCount, errorMessage, processingTime)
+}
+
 // AddBatchResources godoc
 // @Summary 批量添加资源
 // @Description 通过公开API批量添加多个资源到待处理列表
@@ -83,17 +111,28 @@ func (h *PublicAPIHandler) filterForbiddenWords(resources []entity.Resource) ([]
 // @Failure 500 {object} map[string]interface{} "服务器内部错误"
 // @Router /api/public/resources/batch-add [post]
 func (h *PublicAPIHandler) AddBatchResources(c *gin.Context) {
+	startTime := time.Now()
+
 	var req dto.BatchReadyResourceRequest
 	if err := c.ShouldBindJSON(&req); err != nil {
+		h.logAPIAccess(c, startTime, 0, nil, "请求参数错误: "+err.Error())
 		ErrorResponse(c, "请求参数错误: "+err.Error(), 400)
 		return
 	}
 
+	// 存储请求体用于日志记录
+	c.Set("request_body", req)
+
 	if len(req.Resources) == 0 {
 		ErrorResponse(c, "资源列表不能为空", 400)
 		return
 	}
 
+	// 记录API访问安全日志
+	clientIP := c.ClientIP()
+	userAgent := c.GetHeader("User-Agent")
+	utils.Info("PublicAPI.AddBatchResources - API访问 - IP: %s, UserAgent: %s, 资源数量: %d", clientIP, userAgent, len(req.Resources))
+
 	// 收集所有待提交的URL，去重
 	urlSet := make(map[string]struct{})
 	for _, resource := range req.Resources {
@@ -125,6 +164,7 @@ func (h *PublicAPIHandler) AddBatchResources(c *gin.Context) {
 		// 生成 key（每组同一个 key）
 		key, err := repoManager.ReadyResourceRepository.GenerateUniqueKey()
 		if err != nil {
+			h.logAPIAccess(c, startTime, len(createdResources), nil, "生成资源组标识失败: "+err.Error())
 			ErrorResponse(c, "生成资源组标识失败: "+err.Error(), 500)
 			return
 		}
@@ -156,10 +196,12 @@ func (h *PublicAPIHandler) AddBatchResources(c *gin.Context) {
 		}
 	}
 
-	SuccessResponse(c, gin.H{
+	responseData := gin.H{
 		"created_count": len(createdResources),
 		"created_ids":   createdResources,
-	})
+	}
+	h.logAPIAccess(c, startTime, len(createdResources), responseData, "")
+	SuccessResponse(c, responseData)
 }
 
 // SearchResources godoc
@@ -179,7 +221,11 @@ func (h *PublicAPIHandler) AddBatchResources(c *gin.Context) {
 // @Failure 500 {object} map[string]interface{} "服务器内部错误"
 // @Router /api/public/resources/search [get]
 func (h *PublicAPIHandler) SearchResources(c *gin.Context) {
-	// 获取查询参数
+	startTime := time.Now()
+
+	// 记录API访问安全日志
+	clientIP := c.ClientIP()
+	userAgent := c.GetHeader("User-Agent")
 	keyword := c.Query("keyword")
 	tag := c.Query("tag")
 	category := c.Query("category")
@@ -187,6 +233,9 @@ func (h *PublicAPIHandler) SearchResources(c *gin.Context) {
 	pageStr := c.DefaultQuery("page", "1")
 	pageSizeStr := c.DefaultQuery("page_size", "20")
 
+	utils.Info("PublicAPI.SearchResources - API访问 - IP: %s, UserAgent: %s, Keyword: %s, Tag: %s, Category: %s, PanID: %s",
+		clientIP, userAgent, keyword, tag, category, panID)
+
 	page, err := strconv.Atoi(pageStr)
 	if err != nil || page < 1 {
 		page = 1
@@ -236,6 +285,7 @@ func (h *PublicAPIHandler) SearchResources(c *gin.Context) {
 						FileSize:    doc.FileSize,
 						Key:         doc.Key,
 						PanID:       doc.PanID,
+						Cover:       doc.Cover,
 						CreatedAt:   doc.CreatedAt,
 						UpdatedAt:   doc.UpdatedAt,
 					}
@@ -276,6 +326,7 @@ func (h *PublicAPIHandler) SearchResources(c *gin.Context) {
 		// 执行数据库搜索
 		resources, total, err = repoManager.ResourceRepository.SearchWithFilters(params)
 		if err != nil {
+			h.logAPIAccess(c, startTime, 0, nil, "搜索失败: "+err.Error())
 			ErrorResponse(c, "搜索失败: "+err.Error(), 500)
 			return
 		}
@@ -304,6 +355,7 @@ func (h *PublicAPIHandler) SearchResources(c *gin.Context) {
 			"view_count":  processedResource.ViewCount,
 			"created_at":  processedResource.CreatedAt.Format("2006-01-02 15:04:05"),
 			"updated_at":  processedResource.UpdatedAt.Format("2006-01-02 15:04:05"),
+			"cover":       processedResource.Cover, // 添加封面字段
 		}
 
 		// 添加违禁词标记
@@ -320,6 +372,7 @@ func (h *PublicAPIHandler) SearchResources(c *gin.Context) {
 		"limit": pageSize,
 	}
 
+	h.logAPIAccess(c, startTime, len(resourceResponses), responseData, "")
 	SuccessResponse(c, responseData)
 }
 
@@ -337,9 +390,16 @@ func (h *PublicAPIHandler) SearchResources(c *gin.Context) {
 // @Failure 500 {object} map[string]interface{} "服务器内部错误"
 // @Router /api/public/hot-dramas [get]
 func (h *PublicAPIHandler) GetHotDramas(c *gin.Context) {
+	startTime := time.Now()
+
+	// 记录API访问安全日志
+	clientIP := c.ClientIP()
+	userAgent := c.GetHeader("User-Agent")
 	pageStr := c.DefaultQuery("page", "1")
 	pageSizeStr := c.DefaultQuery("page_size", "20")
 
+	utils.Info("PublicAPI.GetHotDramas - API访问 - IP: %s, UserAgent: %s", clientIP, userAgent)
+
 	page, err := strconv.Atoi(pageStr)
 	if err != nil || page < 1 {
 		page = 1
@@ -353,6 +413,7 @@ func (h *PublicAPIHandler) GetHotDramas(c *gin.Context) {
 	// 获取热门剧
 	hotDramas, total, err := repoManager.HotDramaRepository.FindAll(page, pageSize)
 	if err != nil {
+		h.logAPIAccess(c, startTime, 0, nil, "获取热门剧失败: "+err.Error())
 		ErrorResponse(c, "获取热门剧失败: "+err.Error(), 500)
 		return
 	}
@@ -376,10 +437,58 @@ func (h *PublicAPIHandler) GetHotDramas(c *gin.Context) {
 		})
 	}
 
-	SuccessResponse(c, gin.H{
+	responseData := gin.H{
 		"hot_dramas": hotDramaResponses,
 		"total":      total,
 		"page":       page,
 		"page_size":  pageSize,
-	})
+	}
+	h.logAPIAccess(c, startTime, len(hotDramaResponses), responseData, "")
+	SuccessResponse(c, responseData)
+}
+
+// recordAPIAccessToDB 记录API访问日志到数据库
+func (h *PublicAPIHandler) recordAPIAccessToDB(ip, userAgent, endpoint, method string,
+	requestParams interface{}, responseStatus int, responseData interface{},
+	processCount int, errorMessage string, processingTime int64) {
+
+	// 只记录重要的API访问（有错误或处理时间较长的）
+	if errorMessage == "" && processingTime < 1000 && responseStatus < 400 {
+		return // 跳过正常的快速请求
+	}
+
+	// 转换参数为JSON字符串
+	var requestParamsStr, responseDataStr string
+	if requestParams != nil {
+		if jsonBytes, err := json.Marshal(requestParams); err == nil {
+			requestParamsStr = string(jsonBytes)
+		}
+	}
+	if responseData != nil {
+		if jsonBytes, err := json.Marshal(responseData); err == nil {
+			responseDataStr = string(jsonBytes)
+		}
+	}
+
+	// 创建日志记录
+	logEntry := &entity.APIAccessLog{
+		IP:             ip,
+		UserAgent:      userAgent,
+		Endpoint:       endpoint,
+		Method:         method,
+		RequestParams:  requestParamsStr,
+		ResponseStatus: responseStatus,
+		ResponseData:   responseDataStr,
+		ProcessCount:   processCount,
+		ErrorMessage:   errorMessage,
+		ProcessingTime: processingTime,
+	}
+
+	// 异步保存到数据库（避免影响API性能）
+	go func() {
+		if err := repoManager.APIAccessLogRepository.Create(logEntry); err != nil {
+			// 记录失败只输出到系统日志，不影响API
+			utils.Error("保存API访问日志失败: %v", err)
+		}
+	}()
 }

handlers/report_handler.go

@@ -0,0 +1,310 @@
+package handlers
+
+import (
+	"net/http"
+	"strconv"
+	"github.com/ctwj/urldb/db/converter"
+	"github.com/ctwj/urldb/db/dto"
+	"github.com/ctwj/urldb/db/entity"
+	"github.com/ctwj/urldb/db/repo"
+
+	"github.com/gin-gonic/gin"
+	"github.com/go-playground/validator/v10"
+	"gorm.io/gorm"
+)
+
+type ReportHandler struct {
+	reportRepo    repo.ReportRepository
+	resourceRepo  repo.ResourceRepository
+	validate      *validator.Validate
+}
+
+func NewReportHandler(reportRepo repo.ReportRepository, resourceRepo repo.ResourceRepository) *ReportHandler {
+	return &ReportHandler{
+		reportRepo:   reportRepo,
+		resourceRepo: resourceRepo,
+		validate:     validator.New(),
+	}
+}
+
+// CreateReport 创建举报
+// @Summary 创建举报
+// @Description 提交资源举报
+// @Tags Report
+// @Accept json
+// @Produce json
+// @Param request body dto.ReportCreateRequest true "举报信息"
+// @Success 200 {object} Response{data=dto.ReportResponse}
+// @Failure 400 {object} Response
+// @Failure 500 {object} Response
+// @Router /reports [post]
+func (h *ReportHandler) CreateReport(c *gin.Context) {
+	var req dto.ReportCreateRequest
+	if err := c.ShouldBindJSON(&req); err != nil {
+		ErrorResponse(c, "参数错误: "+err.Error(), http.StatusBadRequest)
+		return
+	}
+
+	// 验证参数
+	if err := h.validate.Struct(req); err != nil {
+		ErrorResponse(c, "参数验证失败: "+err.Error(), http.StatusBadRequest)
+		return
+	}
+
+	// 创建举报实体
+	report := &entity.Report{
+		ResourceKey: req.ResourceKey,
+		Reason:      req.Reason,
+		Description: req.Description,
+		Contact:     req.Contact,
+		UserAgent:   req.UserAgent,
+		IPAddress:   req.IPAddress,
+		Status:      "pending", // 默认为待处理
+	}
+
+	// 保存到数据库
+	if err := h.reportRepo.Create(report); err != nil {
+		ErrorResponse(c, "创建举报失败: "+err.Error(), http.StatusInternalServerError)
+		return
+	}
+
+	// 返回响应
+	response := converter.ReportToResponse(report)
+	SuccessResponse(c, response)
+}
+
+// GetReport 获取举报详情
+// @Summary 获取举报详情
+// @Description 根据ID获取举报详情
+// @Tags Report
+// @Produce json
+// @Param id path int true "举报ID"
+// @Success 200 {object} Response{data=dto.ReportResponse}
+// @Failure 400 {object} Response
+// @Failure 404 {object} Response
+// @Failure 500 {object} Response
+// @Router /reports/{id} [get]
+func (h *ReportHandler) GetReport(c *gin.Context) {
+	id, err := strconv.ParseUint(c.Param("id"), 10, 32)
+	if err != nil {
+		ErrorResponse(c, "无效的ID", http.StatusBadRequest)
+		return
+	}
+
+	report, err := h.reportRepo.GetByID(uint(id))
+	if err != nil {
+		if err == gorm.ErrRecordNotFound {
+			ErrorResponse(c, "举报不存在", http.StatusNotFound)
+			return
+		}
+		ErrorResponse(c, "获取举报失败: "+err.Error(), http.StatusInternalServerError)
+		return
+	}
+
+	response := converter.ReportToResponse(report)
+	SuccessResponse(c, response)
+}
+
+// ListReports 获取举报列表
+// @Summary 获取举报列表
+// @Description 获取举报列表（支持分页和状态筛选）
+// @Tags Report
+// @Produce json
+// @Param page query int false "页码" default(1)
+// @Param page_size query int false "每页数量" default(10)
+// @Param status query string false "处理状态"
+// @Success 200 {object} Response{data=object{items=[]dto.ReportResponse,total=int}}
+// @Failure 400 {object} Response
+// @Failure 500 {object} Response
+// @Router /reports [get]
+func (h *ReportHandler) ListReports(c *gin.Context) {
+	var req dto.ReportListRequest
+	if err := c.ShouldBindQuery(&req); err != nil {
+		ErrorResponse(c, "参数错误: "+err.Error(), http.StatusBadRequest)
+		return
+	}
+
+	// 设置默认值
+	if req.Page == 0 {
+		req.Page = 1
+	}
+	if req.PageSize == 0 {
+		req.PageSize = 10
+	}
+
+	// 验证参数
+	if err := h.validate.Struct(req); err != nil {
+		ErrorResponse(c, "参数验证失败: "+err.Error(), http.StatusBadRequest)
+		return
+	}
+
+	reports, total, err := h.reportRepo.List(req.Status, req.Page, req.PageSize)
+	if err != nil {
+		ErrorResponse(c, "获取举报列表失败: "+err.Error(), http.StatusInternalServerError)
+		return
+	}
+
+	// 获取每个举报关联的资源
+	var reportResponses []*dto.ReportResponse
+	for _, report := range reports {
+		// 通过资源key查找关联的资源
+		resources, err := h.getResourcesByResourceKey(report.ResourceKey)
+		if err != nil {
+			// 如果获取资源失败，仍然返回基本的举报信息
+			reportResponses = append(reportResponses, converter.ReportToResponse(report))
+		} else {
+			// 使用包含资源详情的转换函数
+			response := converter.ReportToResponseWithResources(report, resources)
+			reportResponses = append(reportResponses, response)
+		}
+	}
+
+	PageResponse(c, reportResponses, total, req.Page, req.PageSize)
+}
+
+// getResourcesByResourceKey 根据资源key获取关联的资源列表
+func (h *ReportHandler) getResourcesByResourceKey(resourceKey string) ([]*entity.Resource, error) {
+	// 从资源仓库获取与key关联的所有资源
+	resources, err := h.resourceRepo.FindByResourceKey(resourceKey)
+	if err != nil {
+		return nil, err
+	}
+
+	// 将 []entity.Resource 转换为 []*entity.Resource
+	var resourcePointers []*entity.Resource
+	for i := range resources {
+		resourcePointers = append(resourcePointers, &resources[i])
+	}
+
+	return resourcePointers, nil
+}
+
+// UpdateReport 更新举报状态
+// @Summary 更新举报状态
+// @Description 更新举报处理状态
+// @Tags Report
+// @Accept json
+// @Produce json
+// @Param id path int true "举报ID"
+// @Param request body dto.ReportUpdateRequest true "更新信息"
+// @Success 200 {object} Response{data=dto.ReportResponse}
+// @Failure 400 {object} Response
+// @Failure 404 {object} Response
+// @Failure 500 {object} Response
+// @Router /reports/{id} [put]
+func (h *ReportHandler) UpdateReport(c *gin.Context) {
+	id, err := strconv.ParseUint(c.Param("id"), 10, 32)
+	if err != nil {
+		ErrorResponse(c, "无效的ID", http.StatusBadRequest)
+		return
+	}
+
+	var req dto.ReportUpdateRequest
+	if err := c.ShouldBindJSON(&req); err != nil {
+		ErrorResponse(c, "参数错误: "+err.Error(), http.StatusBadRequest)
+		return
+	}
+
+	// 验证参数
+	if err := h.validate.Struct(req); err != nil {
+		ErrorResponse(c, "参数验证失败: "+err.Error(), http.StatusBadRequest)
+		return
+	}
+
+	// 获取当前举报
+	_, err = h.reportRepo.GetByID(uint(id))
+	if err != nil {
+		if err == gorm.ErrRecordNotFound {
+			ErrorResponse(c, "举报不存在", http.StatusNotFound)
+			return
+		}
+		ErrorResponse(c, "获取举报失败: "+err.Error(), http.StatusInternalServerError)
+		return
+	}
+
+	// 更新状态
+	processedBy := uint(0) // 从上下文获取当前用户ID，如果存在的话
+	if currentUser := c.GetUint("user_id"); currentUser > 0 {
+		processedBy = currentUser
+	}
+
+	if err := h.reportRepo.UpdateStatus(uint(id), req.Status, &processedBy, req.Note); err != nil {
+		ErrorResponse(c, "更新举报状态失败: "+err.Error(), http.StatusInternalServerError)
+		return
+	}
+
+	// 获取更新后的举报信息
+	updatedReport, err := h.reportRepo.GetByID(uint(id))
+	if err != nil {
+		ErrorResponse(c, "获取更新后举报信息失败: "+err.Error(), http.StatusInternalServerError)
+		return
+	}
+
+	SuccessResponse(c, converter.ReportToResponse(updatedReport))
+}
+
+// DeleteReport 删除举报
+// @Summary 删除举报
+// @Description 删除举报记录
+// @Tags Report
+// @Produce json
+// @Param id path int true "举报ID"
+// @Success 200 {object} Response
+// @Failure 400 {object} Response
+// @Failure 500 {object} Response
+// @Router /reports/{id} [delete]
+func (h *ReportHandler) DeleteReport(c *gin.Context) {
+	id, err := strconv.ParseUint(c.Param("id"), 10, 32)
+	if err != nil {
+		ErrorResponse(c, "无效的ID", http.StatusBadRequest)
+		return
+	}
+
+	if err := h.reportRepo.Delete(uint(id)); err != nil {
+		ErrorResponse(c, "删除举报失败: "+err.Error(), http.StatusInternalServerError)
+		return
+	}
+
+	SuccessResponse(c, nil)
+}
+
+// GetReportByResource 获取某个资源的举报列表
+// @Summary 获取资源举报列表
+// @Description 获取某个资源的所有举报记录
+// @Tags Report
+// @Produce json
+// @Param resource_key path string true "资源Key"
+// @Success 200 {object} Response{data=[]dto.ReportResponse}
+// @Failure 400 {object} Response
+// @Failure 500 {object} Response
+// @Router /reports/resource/{resource_key} [get]
+func (h *ReportHandler) GetReportByResource(c *gin.Context) {
+	resourceKey := c.Param("resource_key")
+	if resourceKey == "" {
+		ErrorResponse(c, "资源Key不能为空", http.StatusBadRequest)
+		return
+	}
+
+	reports, err := h.reportRepo.GetByResourceKey(resourceKey)
+	if err != nil {
+		ErrorResponse(c, "获取资源举报失败: "+err.Error(), http.StatusInternalServerError)
+		return
+	}
+
+	SuccessResponse(c, converter.ReportsToResponse(reports))
+}
+
+// RegisterReportRoutes 注册举报相关路由
+func RegisterReportRoutes(router *gin.RouterGroup, reportRepo repo.ReportRepository, resourceRepo repo.ResourceRepository) {
+	handler := NewReportHandler(reportRepo, resourceRepo)
+
+	reports := router.Group("/reports")
+	{
+		reports.POST("", handler.CreateReport)                    // 创建举报
+		reports.GET("/:id", handler.GetReport)                    // 获取举报详情
+		reports.GET("", handler.ListReports)                      // 获取举报列表
+		reports.PUT("/:id", handler.UpdateReport)                 // 更新举报状态
+		reports.DELETE("/:id", handler.DeleteReport)              // 删除举报
+		reports.GET("/resource/:resource_key", handler.GetReportByResource) // 获取资源举报列表
+	}
+}

handlers/resource_handler.go

@@ -4,8 +4,11 @@ import (
 	"fmt"
 	"net/http"
 	"strconv"
+	"strings"
+	"time"
 
 	pan "github.com/ctwj/urldb/common"
+	panutils "github.com/ctwj/urldb/common"
 	commonutils "github.com/ctwj/urldb/common/utils"
 	"github.com/ctwj/urldb/db/converter"
 	"github.com/ctwj/urldb/db/dto"
@@ -162,6 +165,7 @@ func GetResources(c *gin.Context) {
 
 		resourceResponse := gin.H{
 			"id":          processedResource.ID,
+			"key":         processedResource.Key, // 添加key字段
 			"title":       forbiddenInfo.ProcessedTitle, // 使用处理后的标题
 			"url":         processedResource.URL,
 			"description": forbiddenInfo.ProcessedDesc, // 使用处理后的描述
@@ -188,6 +192,7 @@ func GetResources(c *gin.Context) {
 			}
 		}
 		resourceResponse["tags"] = tagResponses
+		resourceResponse["cover"] = originalResource.Cover
 
 		resourceResponses = append(resourceResponses, resourceResponse)
 	}
@@ -222,6 +227,51 @@ func GetResourceByID(c *gin.Context) {
 	SuccessResponse(c, response)
 }
 
+// GetResourcesByKey 根据Key获取资源组
+func GetResourcesByKey(c *gin.Context) {
+	key := c.Param("key")
+	if key == "" {
+		ErrorResponse(c, "Key参数不能为空", http.StatusBadRequest)
+		return
+	}
+
+	resources, err := repoManager.ResourceRepository.FindByKey(key)
+	if err != nil {
+		ErrorResponse(c, "资源不存在", http.StatusNotFound)
+		return
+	}
+
+	if len(resources) == 0 {
+		ErrorResponse(c, "资源不存在", http.StatusNotFound)
+		return
+	}
+
+	// 转换为响应格式并处理违禁词
+	cleanWords, err := utils.GetForbiddenWordsFromConfig(func() (string, error) {
+		return repoManager.SystemConfigRepository.GetConfigValue(entity.ConfigKeyForbiddenWords)
+	})
+	if err != nil {
+		utils.Error("获取违禁词配置失败: %v", err)
+		cleanWords = []string{}
+	}
+
+	var responses []dto.ResourceResponse
+	for _, resource := range resources {
+		response := converter.ToResourceResponse(&resource)
+		// 检查违禁词
+		forbiddenInfo := utils.CheckResourceForbiddenWords(response.Title, response.Description, cleanWords)
+		response.HasForbiddenWords = forbiddenInfo.HasForbiddenWords
+		response.ForbiddenWords = forbiddenInfo.ForbiddenWords
+		responses = append(responses, response)
+	}
+
+	SuccessResponse(c, gin.H{
+		"resources": responses,
+		"total":     len(responses),
+		"key":       key,
+	})
+}
+
 // CheckResourceExists 检查资源是否存在（测试FindExists函数）
 func CheckResourceExists(c *gin.Context) {
 	url := c.Query("url")
@@ -394,12 +444,29 @@ func DeleteResource(c *gin.Context) {
 		return
 	}
 
+	// 先从数据库中删除资源
 	err = repoManager.ResourceRepository.Delete(uint(id))
 	if err != nil {
 		ErrorResponse(c, err.Error(), http.StatusInternalServerError)
 		return
 	}
 
+	// 如果启用了Meilisearch，尝试从Meilisearch中删除对应数据
+	if meilisearchManager != nil && meilisearchManager.IsEnabled() {
+		go func() {
+			service := meilisearchManager.GetService()
+			if service != nil {
+				if err := service.DeleteDocument(uint(id)); err != nil {
+					utils.Error("从Meilisearch删除资源失败 (ID: %d): %v", uint(id), err)
+				} else {
+					utils.Info("成功从Meilisearch删除资源 (ID: %d)", uint(id))
+				}
+			} else {
+				utils.Error("无法获取Meilisearch服务进行资源删除 (ID: %d)", uint(id))
+			}
+		}()
+	}
+
 	SuccessResponse(c, gin.H{"message": "资源删除成功"})
 }
 
@@ -512,12 +579,39 @@ func BatchDeleteResources(c *gin.Context) {
 		ErrorResponse(c, "参数错误", 400)
 		return
 	}
+
 	count := 0
+	var deletedIDs []uint
+
+	// 先删除数据库中的资源
 	for _, id := range req.IDs {
 		if err := repoManager.ResourceRepository.Delete(id); err == nil {
 			count++
+			deletedIDs = append(deletedIDs, id)
 		}
 	}
+
+	// 如果启用了Meilisearch，异步删除对应的搜索数据
+	if meilisearchManager != nil && meilisearchManager.IsEnabled() && len(deletedIDs) > 0 {
+		go func() {
+			service := meilisearchManager.GetService()
+			if service != nil {
+				deletedCount := 0
+				for _, id := range deletedIDs {
+					if err := service.DeleteDocument(id); err != nil {
+						utils.Error("从Meilisearch批量删除资源失败 (ID: %d): %v", id, err)
+					} else {
+						deletedCount++
+						utils.Info("成功从Meilisearch批量删除资源 (ID: %d)", id)
+					}
+				}
+				utils.Info("批量删除完成：成功删除 %d 个资源，Meilisearch删除 %d 个资源", count, deletedCount)
+			} else {
+				utils.Error("批量删除时无法获取Meilisearch服务")
+			}
+		}()
+	}
+
 	SuccessResponse(c, gin.H{"deleted": count, "message": "批量删除成功"})
 }
 
@@ -810,6 +904,591 @@ func transferSingleResource(resource *entity.Resource, account entity.Cks, facto
 	}
 }
 
+// GetHotResources 获取热门资源
+func GetHotResources(c *gin.Context) {
+	limit, _ := strconv.Atoi(c.DefaultQuery("limit", "10"))
+
+	utils.Info("获取热门资源请求 - limit: %d", limit)
+
+	// 限制最大请求数量
+	if limit > 20 {
+		limit = 20
+	}
+	if limit <= 0 {
+		limit = 10
+	}
+
+	// 使用公共缓存机制
+	cacheKey := fmt.Sprintf("hot_resources_%d", limit)
+	ttl := time.Hour // 1小时缓存
+	cacheManager := utils.GetHotResourcesCache()
+
+	// 尝试从缓存获取
+	if cachedData, found := cacheManager.Get(cacheKey, ttl); found {
+		utils.Info("使用热门资源缓存 - key: %s", cacheKey)
+		c.Header("Cache-Control", "public, max-age=3600")
+		c.Header("ETag", fmt.Sprintf("hot-resources-%d", len(cachedData.([]gin.H))))
+
+		// 转换为正确的类型
+		if data, ok := cachedData.([]gin.H); ok {
+			SuccessResponse(c, gin.H{
+				"data":    data,
+				"total":   len(data),
+				"limit":   limit,
+				"cached":  true,
+			})
+		}
+		return
+	}
+
+	// 缓存未命中，从数据库获取
+	resources, err := repoManager.ResourceRepository.GetHotResources(limit)
+	if err != nil {
+		utils.Error("获取热门资源失败: %v", err)
+		ErrorResponse(c, "获取热门资源失败", http.StatusInternalServerError)
+		return
+	}
+
+	// 获取违禁词配置
+	cleanWords, err := utils.GetForbiddenWordsFromConfig(func() (string, error) {
+		return repoManager.SystemConfigRepository.GetConfigValue(entity.ConfigKeyForbiddenWords)
+	})
+	if err != nil {
+		utils.Error("获取违禁词配置失败: %v", err)
+		cleanWords = []string{}
+	}
+
+	// 处理违禁词并转换为响应格式
+	var resourceResponses []gin.H
+	for _, resource := range resources {
+		// 检查违禁词
+		forbiddenInfo := utils.CheckResourceForbiddenWords(resource.Title, resource.Description, cleanWords)
+
+		resourceResponse := gin.H{
+			"id":          resource.ID,
+			"key":         resource.Key,
+			"title":       forbiddenInfo.ProcessedTitle,
+			"url":         resource.URL,
+			"description": forbiddenInfo.ProcessedDesc,
+			"pan_id":      resource.PanID,
+			"view_count":  resource.ViewCount,
+			"created_at":  resource.CreatedAt.Format("2006-01-02 15:04:05"),
+			"updated_at":  resource.UpdatedAt.Format("2006-01-02 15:04:05"),
+			"cover":       resource.Cover,
+			"author":      resource.Author,
+			"file_size":   resource.FileSize,
+		}
+
+		// 添加违禁词标记
+		resourceResponse["has_forbidden_words"] = forbiddenInfo.HasForbiddenWords
+		resourceResponse["forbidden_words"] = forbiddenInfo.ForbiddenWords
+
+		// 添加标签信息
+		var tagResponses []gin.H
+		if len(resource.Tags) > 0 {
+			for _, tag := range resource.Tags {
+				tagResponse := gin.H{
+					"id":          tag.ID,
+					"name":        tag.Name,
+					"description": tag.Description,
+				}
+				tagResponses = append(tagResponses, tagResponse)
+			}
+		}
+		resourceResponse["tags"] = tagResponses
+
+		resourceResponses = append(resourceResponses, resourceResponse)
+	}
+
+	// 存储到缓存
+	cacheManager.Set(cacheKey, resourceResponses)
+	utils.Info("热门资源已缓存 - key: %s, count: %d", cacheKey, len(resourceResponses))
+
+	// 设置缓存头
+	c.Header("Cache-Control", "public, max-age=3600")
+	c.Header("ETag", fmt.Sprintf("hot-resources-%d", len(resourceResponses)))
+
+	SuccessResponse(c, gin.H{
+		"data":    resourceResponses,
+		"total":   len(resourceResponses),
+		"limit":   limit,
+		"cached":  false,
+	})
+}
+
+// GetRelatedResources 获取相关资源
+func GetRelatedResources(c *gin.Context) {
+	// 获取查询参数
+	key := c.Query("key")                   // 当前资源的key
+	limit, _ := strconv.Atoi(c.DefaultQuery("limit", "8"))
+	page, _ := strconv.Atoi(c.DefaultQuery("page", "1"))
+
+	utils.Info("获取相关资源请求 - key: %s, limit: %d", key, limit)
+
+	if key == "" {
+		ErrorResponse(c, "缺少资源key参数", http.StatusBadRequest)
+		return
+	}
+
+	// 首先通过key获取当前资源信息
+	currentResources, err := repoManager.ResourceRepository.FindByKey(key)
+	if err != nil {
+		utils.Error("获取当前资源失败: %v", err)
+		ErrorResponse(c, "资源不存在", http.StatusNotFound)
+		return
+	}
+
+	if len(currentResources) == 0 {
+		ErrorResponse(c, "资源不存在", http.StatusNotFound)
+		return
+	}
+
+	currentResource := &currentResources[0] // 取第一个资源作为当前资源
+
+	var resources []entity.Resource
+	var total int64
+
+	// 获取当前资源的标签ID列表
+	var tagIDsList []string
+	if currentResource.Tags != nil {
+		for _, tag := range currentResource.Tags {
+			tagIDsList = append(tagIDsList, strconv.Itoa(int(tag.ID)))
+		}
+	}
+
+	utils.Info("当前资源标签: %v", tagIDsList)
+
+	// 1. 优先使用Meilisearch进行标签搜索
+	if meilisearchManager != nil && meilisearchManager.IsEnabled() && len(tagIDsList) > 0 {
+		service := meilisearchManager.GetService()
+		if service != nil {
+			// 使用标签进行搜索
+			filters := make(map[string]interface{})
+			filters["tag_ids"] = tagIDsList
+
+			// 使用当前资源的标题作为搜索关键词，提高相关性
+			searchQuery := currentResource.Title
+			if searchQuery == "" {
+				searchQuery = strings.Join(tagIDsList, " ") // 如果没有标题，使用标签作为搜索词
+			}
+
+			docs, docTotal, err := service.Search(searchQuery, filters, page, limit)
+			if err == nil && len(docs) > 0 {
+				// 转换为Resource实体
+				for _, doc := range docs {
+					// 排除当前资源
+					if doc.Key == key {
+						continue
+					}
+					resource := entity.Resource{
+						ID:          doc.ID,
+						Title:       doc.Title,
+						Description: doc.Description,
+						URL:         doc.URL,
+						SaveURL:     doc.SaveURL,
+						FileSize:    doc.FileSize,
+						Key:         doc.Key,
+						PanID:       doc.PanID,
+						ViewCount:   0, // Meilisearch文档中没有ViewCount字段，设为默认值
+						CreatedAt:   doc.CreatedAt,
+						UpdatedAt:   doc.UpdatedAt,
+						Cover:       doc.Cover,
+						Author:      doc.Author,
+					}
+					resources = append(resources, resource)
+				}
+				total = docTotal
+				utils.Info("Meilisearch搜索到 %d 个相关资源", len(resources))
+			} else {
+				utils.Error("Meilisearch搜索失败，回退到标签搜索: %v", err)
+			}
+		}
+	}
+
+	// 2. 如果Meilisearch未启用、搜索失败或没有结果，使用数据库标签搜索
+	if len(resources) == 0 {
+		params := map[string]interface{}{
+			"page":      page,
+			"page_size": limit,
+			"is_public": true,
+			"order_by":  "updated_at",
+			"order_dir": "desc",
+		}
+
+		// 使用当前资源的标签进行搜索
+		if len(tagIDsList) > 0 {
+			params["tag_ids"] = strings.Join(tagIDsList, ",")
+		} else {
+			// 如果没有标签，使用当前资源的分类作为搜索条件
+			if currentResource.CategoryID != nil && *currentResource.CategoryID > 0 {
+				params["category_id"] = *currentResource.CategoryID
+			}
+		}
+
+		var err error
+		resources, total, err = repoManager.ResourceRepository.SearchWithFilters(params)
+		if err != nil {
+			utils.Error("搜索相关资源失败: %v", err)
+			ErrorResponse(c, "搜索相关资源失败", http.StatusInternalServerError)
+			return
+		}
+
+		// 排除当前资源
+		var filteredResources []entity.Resource
+		for _, resource := range resources {
+			if resource.Key != key {
+				filteredResources = append(filteredResources, resource)
+			}
+		}
+		resources = filteredResources
+		total = int64(len(filteredResources))
+	}
+
+	utils.Info("标签搜索到 %d 个相关资源", len(resources))
+
+	// 获取违禁词配置
+	cleanWords, err := utils.GetForbiddenWordsFromConfig(func() (string, error) {
+		return repoManager.SystemConfigRepository.GetConfigValue(entity.ConfigKeyForbiddenWords)
+	})
+	if err != nil {
+		utils.Error("获取违禁词配置失败: %v", err)
+		cleanWords = []string{}
+	}
+
+	// 处理违禁词并转换为响应格式
+	var resourceResponses []gin.H
+	for _, resource := range resources {
+		// 检查违禁词
+		forbiddenInfo := utils.CheckResourceForbiddenWords(resource.Title, resource.Description, cleanWords)
+
+		resourceResponse := gin.H{
+			"id":          resource.ID,
+			"key":         resource.Key,
+			"title":       forbiddenInfo.ProcessedTitle,
+			"url":         resource.URL,
+			"description": forbiddenInfo.ProcessedDesc,
+			"pan_id":      resource.PanID,
+			"view_count":  resource.ViewCount,
+			"created_at":  resource.CreatedAt.Format("2006-01-02 15:04:05"),
+			"updated_at":  resource.UpdatedAt.Format("2006-01-02 15:04:05"),
+			"cover":       resource.Cover,
+			"author":      resource.Author,
+			"file_size":   resource.FileSize,
+		}
+
+		// 添加违禁词标记
+		resourceResponse["has_forbidden_words"] = forbiddenInfo.HasForbiddenWords
+		resourceResponse["forbidden_words"] = forbiddenInfo.ForbiddenWords
+
+		// 添加标签信息
+		var tagResponses []gin.H
+		if len(resource.Tags) > 0 {
+			for _, tag := range resource.Tags {
+				tagResponse := gin.H{
+					"id":          tag.ID,
+					"name":        tag.Name,
+					"description": tag.Description,
+				}
+				tagResponses = append(tagResponses, tagResponse)
+			}
+		}
+		resourceResponse["tags"] = tagResponses
+
+		resourceResponses = append(resourceResponses, resourceResponse)
+	}
+
+	// 构建响应数据
+	responseData := gin.H{
+		"data":      resourceResponses,
+		"total":     total,
+		"page":      page,
+		"page_size": limit,
+		"source":    "database",
+	}
+
+	if meilisearchManager != nil && meilisearchManager.IsEnabled() && len(tagIDsList) > 0 {
+		responseData["source"] = "meilisearch"
+	}
+
+	SuccessResponse(c, responseData)
+}
+
+// CheckResourceValidity 检查资源链接有效性
+func CheckResourceValidity(c *gin.Context) {
+	idStr := c.Param("id")
+	id, err := strconv.ParseUint(idStr, 10, 32)
+	if err != nil {
+		ErrorResponse(c, "无效的资源ID", http.StatusBadRequest)
+		return
+	}
+
+	// 查询资源信息
+	resource, err := repoManager.ResourceRepository.FindByID(uint(id))
+	if err != nil {
+		ErrorResponse(c, "资源不存在", http.StatusNotFound)
+		return
+	}
+
+	utils.Info("开始检测资源有效性 - ID: %d, URL: %s", resource.ID, resource.URL)
+
+	// 检查缓存
+	cacheKey := fmt.Sprintf("resource_validity_%d", resource.ID)
+	cacheManager := utils.GetResourceValidityCache()
+	ttl := 5 * time.Minute // 5分钟缓存
+
+	if cachedData, found := cacheManager.Get(cacheKey, ttl); found {
+		if result, ok := cachedData.(gin.H); ok {
+			utils.Info("使用资源有效性缓存 - ID: %d", resource.ID)
+			result["cached"] = true
+			SuccessResponse(c, result)
+			return
+		}
+	}
+
+	// 执行检测：只使用深度检测实现
+	isValid, detectionMethod, err := performAdvancedValidityCheck(resource)
+
+	if err != nil {
+		utils.Error("深度检测资源链接失败 - ID: %d, Error: %v", resource.ID, err)
+
+		// 深度检测失败，但不标记为无效（用户可自行验证）
+		result := gin.H{
+			"resource_id":      resource.ID,
+			"url":             resource.URL,
+			"is_valid":        resource.IsValid, // 保持原始状态
+			"last_checked":    time.Now().Format(time.RFC3339),
+			"error":           err.Error(),
+			"detection_method": detectionMethod,
+			"cached":          false,
+			"note":            "当前网盘暂不支持自动检测，建议用户自行验证",
+		}
+		cacheManager.Set(cacheKey, result)
+		SuccessResponse(c, result)
+		return
+	}
+
+	// 只有明确检测出无效的资源才更新数据库状态
+	// 如果检测成功且结果与数据库状态不同，则更新
+	if detectionMethod == "quark_deep" && isValid != resource.IsValid {
+		resource.IsValid = isValid
+		updateErr := repoManager.ResourceRepository.Update(resource)
+		if updateErr != nil {
+			utils.Error("更新资源有效性状态失败 - ID: %d, Error: %v", resource.ID, updateErr)
+		} else {
+			utils.Info("更新资源有效性状态 - ID: %d, Status: %v, Method: %s", resource.ID, isValid, detectionMethod)
+		}
+	}
+
+	// 构建检测结果
+	result := gin.H{
+		"resource_id":      resource.ID,
+		"url":             resource.URL,
+		"is_valid":        isValid,
+		"last_checked":    time.Now().Format(time.RFC3339),
+		"detection_method": detectionMethod,
+		"cached":          false,
+	}
+
+	// 缓存检测结果
+	cacheManager.Set(cacheKey, result)
+
+	utils.Info("资源有效性检测完成 - ID: %d, Valid: %v, Method: %s", resource.ID, isValid, detectionMethod)
+	SuccessResponse(c, result)
+}
+
+// performAdvancedValidityCheck 执行深度检测（只使用具体网盘服务）
+func performAdvancedValidityCheck(resource *entity.Resource) (bool, string, error) {
+	// 提取分享ID和服务类型
+	shareID, serviceType := panutils.ExtractShareId(resource.URL)
+	if serviceType == panutils.NotFound {
+		return false, "unsupported", fmt.Errorf("不支持的网盘服务: %s", resource.URL)
+	}
+
+	utils.Info("开始深度检测 - Service: %s, ShareID: %s", serviceType.String(), shareID)
+
+	// 根据服务类型选择检测策略
+	switch serviceType {
+	case panutils.Quark:
+		return performQuarkValidityCheck(resource, shareID)
+	case panutils.Alipan:
+		return performAlipanValidityCheck(resource, shareID)
+	case panutils.BaiduPan, panutils.UC, panutils.Xunlei, panutils.Tianyi, panutils.Pan123, panutils.Pan115:
+		// 这些网盘暂未实现深度检测，返回不支持提示
+		return false, "unsupported", fmt.Errorf("当前网盘类型 %s 暂不支持深度检测，请等待后续更新", serviceType.String())
+	default:
+		return false, "unsupported", fmt.Errorf("未知的网盘服务类型: %s", serviceType.String())
+	}
+}
+
+// performQuarkValidityCheck 夸克网盘深度检测
+func performQuarkValidityCheck(resource *entity.Resource, shareID string) (bool, string, error) {
+	// 获取夸克网盘账号
+	panID, err := getQuarkPanID()
+	if err != nil {
+		return false, "quark_failed", fmt.Errorf("获取夸克平台ID失败: %v", err)
+	}
+
+	accounts, err := repoManager.CksRepository.FindByPanID(panID)
+	if err != nil {
+		return false, "quark_failed", fmt.Errorf("获取夸克网盘账号失败: %v", err)
+	}
+
+	if len(accounts) == 0 {
+		return false, "quark_failed", fmt.Errorf("没有可用的夸克网盘账号")
+	}
+
+	// 选择第一个有效账号
+	var selectedAccount *entity.Cks
+	for _, account := range accounts {
+		if account.IsValid {
+			selectedAccount = &account
+			break
+		}
+	}
+
+	if selectedAccount == nil {
+		return false, "quark_failed", fmt.Errorf("没有有效的夸克网盘账号")
+	}
+
+	// 创建网盘服务配置
+	config := &pan.PanConfig{
+		URL:         resource.URL,
+		Code:        "",
+		IsType:      1, // 只获取基本信息，不转存
+		ExpiredType: 1,
+		AdFid:       "",
+		Stoken:      "",
+		Cookie:      selectedAccount.Ck,
+	}
+
+	// 创建夸克网盘服务
+	factory := pan.NewPanFactory()
+	panService, err := factory.CreatePanService(resource.URL, config)
+	if err != nil {
+		return false, "quark_failed", fmt.Errorf("创建夸克网盘服务失败: %v", err)
+	}
+
+	// 执行深度检测（Transfer方法）
+	utils.Info("执行夸克网盘深度检测 - ShareID: %s", shareID)
+	result, err := panService.Transfer(shareID)
+	if err != nil {
+		return false, "quark_failed", fmt.Errorf("夸克网盘检测失败: %v", err)
+	}
+
+	if !result.Success {
+		return false, "quark_failed", fmt.Errorf("夸克网盘链接无效: %s", result.Message)
+	}
+
+	utils.Info("夸克网盘深度检测成功 - ShareID: %s", shareID)
+	return true, "quark_deep", nil
+}
+
+// performAlipanValidityCheck 阿里云盘深度检测
+func performAlipanValidityCheck(resource *entity.Resource, shareID string) (bool, string, error) {
+	// 阿里云盘深度检测暂未实现
+	utils.Info("阿里云盘暂不支持深度检测 - ShareID: %s", shareID)
+	return false, "unsupported", fmt.Errorf("阿里云盘暂不支持深度检测，请等待后续更新")
+}
+
+
+// BatchCheckResourceValidity 批量检查资源链接有效性
+func BatchCheckResourceValidity(c *gin.Context) {
+	var req struct {
+		IDs []uint `json:"ids" binding:"required"`
+	}
+	if err := c.ShouldBindJSON(&req); err != nil {
+		ErrorResponse(c, "参数错误: "+err.Error(), http.StatusBadRequest)
+		return
+	}
+
+	if len(req.IDs) == 0 {
+		ErrorResponse(c, "ID列表不能为空", http.StatusBadRequest)
+		return
+	}
+
+	if len(req.IDs) > 20 {
+		ErrorResponse(c, "单次最多检测20个资源", http.StatusBadRequest)
+		return
+	}
+
+	utils.Info("开始批量检测资源有效性 - Count: %d", len(req.IDs))
+
+	cacheManager := utils.GetResourceValidityCache()
+	ttl := 5 * time.Minute
+	results := make([]gin.H, 0, len(req.IDs))
+
+	for _, id := range req.IDs {
+		// 查询资源信息
+		resource, err := repoManager.ResourceRepository.FindByID(id)
+		if err != nil {
+			results = append(results, gin.H{
+				"resource_id": id,
+				"is_valid":    false,
+				"error":       "资源不存在",
+				"cached":      false,
+			})
+			continue
+		}
+
+		// 检查缓存
+		cacheKey := fmt.Sprintf("resource_validity_%d", id)
+		if cachedData, found := cacheManager.Get(cacheKey, ttl); found {
+			if result, ok := cachedData.(gin.H); ok {
+				result["cached"] = true
+				results = append(results, result)
+				continue
+			}
+		}
+
+		// 执行深度检测
+		isValid, detectionMethod, err := performAdvancedValidityCheck(resource)
+
+		if err != nil {
+			// 深度检测失败，但不标记为无效（用户可自行验证）
+			result := gin.H{
+				"resource_id":      id,
+				"url":             resource.URL,
+				"is_valid":        resource.IsValid, // 保持原始状态
+				"last_checked":    time.Now().Format(time.RFC3339),
+				"error":           err.Error(),
+				"detection_method": detectionMethod,
+				"cached":          false,
+				"note":            "当前网盘暂不支持自动检测，建议用户自行验证",
+			}
+			cacheManager.Set(cacheKey, result)
+			results = append(results, result)
+			continue
+		}
+
+		// 只有明确检测出无效的资源才更新数据库状态
+		if detectionMethod == "quark_deep" && isValid != resource.IsValid {
+			resource.IsValid = isValid
+			updateErr := repoManager.ResourceRepository.Update(resource)
+			if updateErr != nil {
+				utils.Error("更新资源有效性状态失败 - ID: %d, Error: %v", id, updateErr)
+			}
+		}
+
+		result := gin.H{
+			"resource_id":      id,
+			"url":             resource.URL,
+			"is_valid":        isValid,
+			"last_checked":    time.Now().Format(time.RFC3339),
+			"detection_method": detectionMethod,
+			"cached":          false,
+		}
+
+		cacheManager.Set(cacheKey, result)
+		results = append(results, result)
+	}
+
+	utils.Info("批量检测资源有效性完成 - Count: %d", len(results))
+	SuccessResponse(c, gin.H{
+		"results": results,
+		"total":   len(results),
+	})
+}
+
 // getQuarkPanID 获取夸克网盘ID
 func getQuarkPanID() (uint, error) {
 	// 通过FindAll方法查找所有平台，然后过滤出quark平台

handlers/stats_handler.go

@@ -22,16 +22,20 @@ func GetStats(c *gin.Context) {
 	db.DB.Model(&entity.Tag{}).Count(&totalTags)
 	db.DB.Model(&entity.Resource{}).Select("COALESCE(SUM(view_count), 0)").Scan(&totalViews)
 
-	// 获取今日数据
-	today := utils.GetTodayString()
+	// 获取今日数据（在UTC+8时区的0点开始统计）
+	now := utils.GetCurrentTime()
+	// 使用UTC+8时区的今天0点
+	loc, _ := time.LoadLocation("Asia/Shanghai") // UTC+8
+	startOfToday := time.Date(now.Year(), now.Month(), now.Day(), 0, 0, 0, 0, loc)
+	endOfToday := startOfToday.Add(24 * time.Hour)
 
-	// 今日新增资源数量
+	// 今日新增资源数量（从0点开始）
 	var todayResources int64
-	db.DB.Model(&entity.Resource{}).Where("DATE(created_at) = ?", today).Count(&todayResources)
+	db.DB.Model(&entity.Resource{}).Where("created_at >= ? AND created_at < ?", startOfToday, endOfToday).Count(&todayResources)
 
-	// 今日更新资源数量（包括新增和修改）
+	// 今日更新资源数量（包括新增和修改，从0点开始）
 	var todayUpdates int64
-	db.DB.Model(&entity.Resource{}).Where("DATE(updated_at) = ?", today).Count(&todayUpdates)
+	db.DB.Model(&entity.Resource{}).Where("updated_at >= ? AND updated_at < ?", startOfToday, endOfToday).Count(&todayUpdates)
 
 	// 今日浏览量 - 使用访问记录表统计今日访问量
 	var todayViews int64
@@ -41,9 +45,9 @@ func GetStats(c *gin.Context) {
 		todayViews = 0
 	}
 
-	// 今日搜索量
+	// 今日搜索量（从0点开始）
 	var todaySearches int64
-	db.DB.Model(&entity.SearchStat{}).Where("DATE(date) = ?", today).Count(&todaySearches)
+	db.DB.Model(&entity.SearchStat{}).Where("date >= ? AND date < ?", startOfToday.Format(utils.TimeFormatDate), endOfToday.Format(utils.TimeFormatDate)).Count(&todaySearches)
 
 	// 添加调试日志
 	utils.Info("统计数据 - 总资源: %d, 总分类: %d, 总标签: %d, 总浏览量: %d",

handlers/system_config_handler.go

@@ -125,10 +125,15 @@ func GetSystemConfig(c *gin.Context) {
 func UpdateSystemConfig(c *gin.Context) {
 	var req dto.SystemConfigRequest
 	if err := c.ShouldBindJSON(&req); err != nil {
+		utils.Error("JSON绑定失败: %v", err)
 		ErrorResponse(c, "请求参数错误", http.StatusBadRequest)
 		return
 	}
 
+	adminUsername, _ := c.Get("username")
+	clientIP, _ := c.Get("client_ip")
+	utils.Info("UpdateSystemConfig - 管理员更新系统配置 - 管理员: %s, IP: %s", adminUsername, clientIP)
+
 	// 调试信息
 	utils.Info("接收到的配置请求: %+v", req)
 
@@ -140,42 +145,61 @@ func UpdateSystemConfig(c *gin.Context) {
 		utils.Info("当前配置数量: %d", len(currentConfigs))
 	}
 
-	// 验证参数 - 只验证提交的字段
-	if req.SiteTitle != nil && (len(*req.SiteTitle) < 1 || len(*req.SiteTitle) > 100) {
-		ErrorResponse(c, "网站标题长度必须在1-100字符之间", http.StatusBadRequest)
-		return
+	// 验证参数 - 只验证提交的字段，仅在验证失败时记录日志
+	if req.SiteTitle != nil {
+		if len(*req.SiteTitle) < 1 || len(*req.SiteTitle) > 100 {
+			utils.Warn("配置验证失败 - SiteTitle长度无效: %d", len(*req.SiteTitle))
+			ErrorResponse(c, "网站标题长度必须在1-100字符之间", http.StatusBadRequest)
+			return
+		}
 	}
 
-	if req.AutoProcessInterval != nil && (*req.AutoProcessInterval < 1 || *req.AutoProcessInterval > 1440) {
-		ErrorResponse(c, "自动处理间隔必须在1-1440分钟之间", http.StatusBadRequest)
-		return
+	if req.AutoProcessInterval != nil {
+		if *req.AutoProcessInterval < 1 || *req.AutoProcessInterval > 1440 {
+			utils.Warn("配置验证失败 - AutoProcessInterval超出范围: %d", *req.AutoProcessInterval)
+			ErrorResponse(c, "自动处理间隔必须在1-1440分钟之间", http.StatusBadRequest)
+			return
+		}
 	}
 
-	if req.PageSize != nil && (*req.PageSize < 10 || *req.PageSize > 500) {
-		ErrorResponse(c, "每页显示数量必须在10-500之间", http.StatusBadRequest)
-		return
+	if req.PageSize != nil {
+		if *req.PageSize < 10 || *req.PageSize > 500 {
+			utils.Warn("配置验证失败 - PageSize超出范围: %d", *req.PageSize)
+			ErrorResponse(c, "每页显示数量必须在10-500之间", http.StatusBadRequest)
+			return
+		}
 	}
 
 	// 验证自动转存配置
-	if req.AutoTransferLimitDays != nil && (*req.AutoTransferLimitDays < 0 || *req.AutoTransferLimitDays > 365) {
-		ErrorResponse(c, "自动转存限制天数必须在0-365之间", http.StatusBadRequest)
-		return
+	if req.AutoTransferLimitDays != nil {
+		if *req.AutoTransferLimitDays < 0 || *req.AutoTransferLimitDays > 365 {
+			utils.Warn("配置验证失败 - AutoTransferLimitDays超出范围: %d", *req.AutoTransferLimitDays)
+			ErrorResponse(c, "自动转存限制天数必须在0-365之间", http.StatusBadRequest)
+			return
+		}
 	}
 
-	if req.AutoTransferMinSpace != nil && (*req.AutoTransferMinSpace < 100 || *req.AutoTransferMinSpace > 1024) {
-		ErrorResponse(c, "最小存储空间必须在100-1024GB之间", http.StatusBadRequest)
-		return
+	if req.AutoTransferMinSpace != nil {
+		if *req.AutoTransferMinSpace < 5 || *req.AutoTransferMinSpace > 1024 {
+			utils.Warn("配置验证失败 - AutoTransferMinSpace超出范围: %d", *req.AutoTransferMinSpace)
+			ErrorResponse(c, "最小存储空间必须在5-1024GB之间", http.StatusBadRequest)
+			return
+		}
+	}
+
+	// 验证公告相关字段
+	if req.Announcements != nil {
+		// 简化验证，仅在需要时添加逻辑
 	}
 
 	// 转换为实体
 	configs := converter.RequestToSystemConfig(&req)
 	if configs == nil {
+		utils.Error("配置数据转换失败")
 		ErrorResponse(c, "数据转换失败", http.StatusInternalServerError)
 		return
 	}
 
-	utils.Info("准备更新配置，配置项数量: %d", len(configs))
-
 	// 保存配置
 	err = repoManager.SystemConfigRepository.UpsertConfigs(configs)
 	if err != nil {
@@ -184,7 +208,7 @@ func UpdateSystemConfig(c *gin.Context) {
 		return
 	}
 
-	utils.Info("配置保存成功")
+	utils.Info("系统配置更新成功 - 更新项数: %d", len(configs))
 
 	// 安全刷新系统配置缓存
 	if err := repoManager.SystemConfigRepository.SafeRefreshConfigCache(); err != nil {
@@ -297,6 +321,10 @@ func ToggleAutoProcess(c *gin.Context) {
 		return
 	}
 
+	adminUsername, _ := c.Get("username")
+	clientIP, _ := c.Get("client_ip")
+	utils.Info("ToggleAutoProcess - 管理员切换自动处理配置 - 管理员: %s, 启用: %t, IP: %s", adminUsername, req.AutoProcessReadyResources, clientIP)
+
 	// 获取当前配置
 	configs, err := repoManager.SystemConfigRepository.GetOrCreateDefault()
 	if err != nil {

handlers/task_handler.go

@@ -51,6 +51,10 @@ func (h *TaskHandler) CreateBatchTransferTask(c *gin.Context) {
 		return
 	}
 
+	username, _ := c.Get("username")
+	clientIP, _ := c.Get("client_ip")
+	utils.Info("CreateBatchTransferTask - 用户创建批量转存任务 - 用户: %s, 任务标题: %s, 资源数量: %d, IP: %s", username, req.Title, len(req.Resources), clientIP)
+
 	utils.Debug("创建批量转存任务: %s，资源数量: %d，选择账号数量: %d", req.Title, len(req.Resources), len(req.SelectedAccounts))
 
 	// 构建任务配置
@@ -124,6 +128,10 @@ func (h *TaskHandler) StartTask(c *gin.Context) {
 		return
 	}
 
+	username, _ := c.Get("username")
+	clientIP, _ := c.Get("client_ip")
+	utils.Info("StartTask - 用户启动任务 - 用户: %s, 任务ID: %d, IP: %s", username, taskID, clientIP)
+
 	err = h.taskManager.StartTask(uint(taskID))
 	if err != nil {
 		utils.Error("启动任务失败: %v", err)
@@ -147,6 +155,10 @@ func (h *TaskHandler) StopTask(c *gin.Context) {
 		return
 	}
 
+	username, _ := c.Get("username")
+	clientIP, _ := c.Get("client_ip")
+	utils.Info("StopTask - 用户停止任务 - 用户: %s, 任务ID: %d, IP: %s", username, taskID, clientIP)
+
 	err = h.taskManager.StopTask(uint(taskID))
 	if err != nil {
 		utils.Error("停止任务失败: %v", err)
@@ -170,6 +182,10 @@ func (h *TaskHandler) PauseTask(c *gin.Context) {
 		return
 	}
 
+	username, _ := c.Get("username")
+	clientIP, _ := c.Get("client_ip")
+	utils.Info("PauseTask - 用户暂停任务 - 用户: %s, 任务ID: %d, IP: %s", username, taskID, clientIP)
+
 	err = h.taskManager.PauseTask(uint(taskID))
 	if err != nil {
 		utils.Error("暂停任务失败: %v", err)
@@ -360,8 +376,13 @@ func (h *TaskHandler) DeleteTask(c *gin.Context) {
 		return
 	}
 
+	username, _ := c.Get("username")
+	clientIP, _ := c.Get("client_ip")
+	utils.Info("DeleteTask - 用户删除任务 - 用户: %s, 任务ID: %d, IP: %s", username, taskID, clientIP)
+
 	// 检查任务是否在运行
 	if h.taskManager.IsTaskRunning(uint(taskID)) {
+		utils.Warn("DeleteTask - 尝试删除正在运行的任务 - 用户: %s, 任务ID: %d, IP: %s", username, taskID, clientIP)
 		ErrorResponse(c, "任务正在运行中，无法删除", http.StatusBadRequest)
 		return
 	}
@@ -383,6 +404,7 @@ func (h *TaskHandler) DeleteTask(c *gin.Context) {
 	}
 
 	utils.Debug("任务删除成功: %d", taskID)
+	utils.Info("DeleteTask - 任务删除成功 - 用户: %s, 任务ID: %d, IP: %s", username, taskID, clientIP)
 
 	SuccessResponse(c, gin.H{
 		"message": "任务删除成功",
@@ -402,6 +424,10 @@ func (h *TaskHandler) CreateExpansionTask(c *gin.Context) {
 		return
 	}
 
+	username, _ := c.Get("username")
+	clientIP, _ := c.Get("client_ip")
+	utils.Info("CreateExpansionTask - 用户创建扩容任务 - 用户: %s, 账号ID: %d, IP: %s", username, req.PanAccountID, clientIP)
+
 	utils.Debug("创建扩容任务: 账号ID %d", req.PanAccountID)
 
 	// 获取账号信息，用于构建任务标题

handlers/telegram_handler.go

@@ -80,16 +80,40 @@ func (h *TelegramHandler) UpdateBotConfig(c *gin.Context) {
 		return
 	}
 
-	// 配置更新完成后，尝试启动机器人（如果未运行且配置有效）
-	if startErr := h.telegramBotService.Start(); startErr != nil {
-		utils.Warn("[TELEGRAM:HANDLER] 配置更新后尝试启动机器人失败: %v", startErr)
-		// 启动失败不影响配置保存，只记录警告
+	// 根据配置状态决定启动或停止机器人
+	botEnabled := false
+	for _, config := range configs {
+		if config.Key == "telegram_bot_enabled" {
+			botEnabled = config.Value == "true"
+			break
+		}
+	}
+
+	if botEnabled {
+		// 机器人已启用，尝试启动机器人
+		if startErr := h.telegramBotService.Start(); startErr != nil {
+			utils.Warn("[TELEGRAM:HANDLER] 配置更新后尝试启动机器人失败: %v", startErr)
+			// 启动失败不影响配置保存，只记录警告
+		}
+	} else {
+		// 机器人已禁用，停止机器人服务
+		if stopErr := h.telegramBotService.Stop(); stopErr != nil {
+			utils.Warn("[TELEGRAM:HANDLER] 配置更新后停止机器人失败: %v", stopErr)
+			// 停止失败不影响配置保存，只记录警告
+		}
 	}
 
 	// 返回成功
+	var message string
+	if botEnabled {
+		message = "配置更新成功，机器人已尝试启动"
+	} else {
+		message = "配置更新成功，机器人已停止"
+	}
+
 	SuccessResponse(c, map[string]interface{}{
 		"success": true,
-		"message": "配置更新成功，机器人已尝试启动",
+		"message": message,
 	})
 }
 
@@ -206,6 +230,9 @@ func (h *TelegramHandler) UpdateChannel(c *gin.Context) {
 		return
 	}
 
+	utils.Info("[TELEGRAM:HANDLER] 接收到频道更新请求: ID=%s, ChatName=%s, PushStartTime=%s, PushEndTime=%s, ResourceStrategy=%s, TimeLimit=%s",
+		idStr, req.ChatName, req.PushStartTime, req.PushEndTime, req.ResourceStrategy, req.TimeLimit)
+
 	// 查找现有频道
 	channel, err := h.telegramChannelRepo.FindByID(uint(id))
 	if err != nil {
@@ -213,6 +240,10 @@ func (h *TelegramHandler) UpdateChannel(c *gin.Context) {
 		return
 	}
 
+	// 保存前的日志
+	utils.Info("[TELEGRAM:HANDLER] 更新前频道状态: PushStartTime=%s, PushEndTime=%s, ResourceStrategy=%s, TimeLimit=%s",
+		channel.PushStartTime, channel.PushEndTime, channel.ResourceStrategy, channel.TimeLimit)
+
 	// 如果前端传递了ChatID，验证它是否与现有频道匹配
 	if req.ChatID != 0 && req.ChatID != channel.ChatID {
 		ErrorResponse(c, "ChatID不匹配，无法更新此频道", http.StatusBadRequest)
@@ -229,12 +260,18 @@ func (h *TelegramHandler) UpdateChannel(c *gin.Context) {
 	channel.ContentCategories = req.ContentCategories
 	channel.ContentTags = req.ContentTags
 	channel.IsActive = req.IsActive
+	channel.ResourceStrategy = req.ResourceStrategy
+	channel.TimeLimit = req.TimeLimit
 
 	if err := h.telegramChannelRepo.Update(channel); err != nil {
 		ErrorResponse(c, "更新频道失败", http.StatusInternalServerError)
 		return
 	}
 
+	// 保存后的日志
+	utils.Info("[TELEGRAM:HANDLER] 更新后频道状态: PushStartTime=%s, PushEndTime=%s, ResourceStrategy=%s, TimeLimit=%s",
+		channel.PushStartTime, channel.PushEndTime, channel.ResourceStrategy, channel.TimeLimit)
+
 	response := converter.TelegramChannelToResponse(*channel)
 	SuccessResponse(c, response)
 }
@@ -278,13 +315,18 @@ func (h *TelegramHandler) RegisterChannelByCommand(chatID int64, chatName, chatT
 
 	// 创建新的频道记录
 	channel := entity.TelegramChannel{
-		ChatID:        chatID,
-		ChatName:      chatName,
-		ChatType:      chatType,
-		PushEnabled:   true,
-		PushFrequency: 5, // 默认5分钟
-		IsActive:      true,
-		RegisteredBy:  "bot_command",
+		ChatID:           chatID,
+		ChatName:         chatName,
+		ChatType:         chatType,
+		PushEnabled:      true,
+		PushFrequency:    15,      // 默认15分钟
+		PushStartTime:    "08:30", // 默认开始时间8:30
+		PushEndTime:      "11:30", // 默认结束时间11:30
+		IsActive:         true,
+		RegisteredBy:     "bot_command",
+		RegisteredAt:     time.Now(),
+		ResourceStrategy: "random", // 默认纯随机
+		TimeLimit:        "none",   // 默认无限制
 	}
 
 	return h.telegramChannelRepo.Create(&channel)

handlers/user_handler.go

@@ -1,6 +1,7 @@
 package handlers
 
 import (
+	"fmt"
 	"net/http"
 	"strconv"
 
@@ -8,6 +9,7 @@ import (
 	"github.com/ctwj/urldb/db/dto"
 	"github.com/ctwj/urldb/db/entity"
 	"github.com/ctwj/urldb/middleware"
+	"github.com/ctwj/urldb/utils"
 
 	"github.com/gin-gonic/gin"
 )
@@ -20,18 +22,24 @@ func Login(c *gin.Context) {
 		return
 	}
 
+	clientIP, _ := c.Get("client_ip")
+	utils.Info("Login - 尝试登录 - 用户名: %s, IP: %s", req.Username, clientIP)
+
 	user, err := repoManager.UserRepository.FindByUsername(req.Username)
 	if err != nil {
+		utils.Warn("Login - 用户不存在或密码错误 - 用户名: %s, IP: %s", req.Username, clientIP)
 		ErrorResponse(c, "用户名或密码错误", http.StatusUnauthorized)
 		return
 	}
 
 	if !user.IsActive {
+		utils.Warn("Login - 账户已被禁用 - 用户名: %s, IP: %s", req.Username, clientIP)
 		ErrorResponse(c, "账户已被禁用", http.StatusUnauthorized)
 		return
 	}
 
 	if !middleware.CheckPassword(req.Password, user.Password) {
+		utils.Warn("Login - 密码错误 - 用户名: %s, IP: %s", req.Username, clientIP)
 		ErrorResponse(c, "用户名或密码错误", http.StatusUnauthorized)
 		return
 	}
@@ -42,10 +50,13 @@ func Login(c *gin.Context) {
 	// 生成JWT令牌
 	token, err := middleware.GenerateToken(user)
 	if err != nil {
+		utils.Error("Login - 生成令牌失败 - 用户名: %s, IP: %s, Error: %v", req.Username, clientIP, err)
 		ErrorResponse(c, "生成令牌失败", http.StatusInternalServerError)
 		return
 	}
 
+	utils.Info("Login - 登录成功 - 用户名: %s(ID:%d), IP: %s", req.Username, user.ID, clientIP)
+
 	response := dto.LoginResponse{
 		Token: token,
 		User:  converter.ToUserResponse(user),
@@ -62,9 +73,13 @@ func Register(c *gin.Context) {
 		return
 	}
 
+	clientIP, _ := c.Get("client_ip")
+	utils.Info("Register - 尝试注册 - 用户名: %s, 邮箱: %s, IP: %s", req.Username, req.Email, clientIP)
+
 	// 检查用户名是否已存在
 	existingUser, _ := repoManager.UserRepository.FindByUsername(req.Username)
 	if existingUser != nil {
+		utils.Warn("Register - 用户名已存在 - 用户名: %s, IP: %s", req.Username, clientIP)
 		ErrorResponse(c, "用户名已存在", http.StatusBadRequest)
 		return
 	}
@@ -72,6 +87,7 @@ func Register(c *gin.Context) {
 	// 检查邮箱是否已存在
 	existingEmail, _ := repoManager.UserRepository.FindByEmail(req.Email)
 	if existingEmail != nil {
+		utils.Warn("Register - 邮箱已存在 - 邮箱: %s, IP: %s", req.Email, clientIP)
 		ErrorResponse(c, "邮箱已存在", http.StatusBadRequest)
 		return
 	}
@@ -79,6 +95,7 @@ func Register(c *gin.Context) {
 	// 哈希密码
 	hashedPassword, err := middleware.HashPassword(req.Password)
 	if err != nil {
+		utils.Error("Register - 密码加密失败 - 用户名: %s, IP: %s, Error: %v", req.Username, clientIP, err)
 		ErrorResponse(c, "密码加密失败", http.StatusInternalServerError)
 		return
 	}
@@ -93,10 +110,13 @@ func Register(c *gin.Context) {
 
 	err = repoManager.UserRepository.Create(user)
 	if err != nil {
+		utils.Error("Register - 创建用户失败 - 用户名: %s, IP: %s, Error: %v", req.Username, clientIP, err)
 		ErrorResponse(c, err.Error(), http.StatusInternalServerError)
 		return
 	}
 
+	utils.Info("Register - 注册成功 - 用户名: %s(ID:%d), 邮箱: %s, IP: %s", req.Username, user.ID, req.Email, clientIP)
+
 	SuccessResponse(c, gin.H{
 		"message": "注册成功",
 		"user":    converter.ToUserResponse(user),
@@ -123,9 +143,14 @@ func CreateUser(c *gin.Context) {
 		return
 	}
 
+	adminUsername, _ := c.Get("username")
+	clientIP, _ := c.Get("client_ip")
+	utils.Info("CreateUser - 管理员创建用户 - 管理员: %s, 新用户名: %s, IP: %s", adminUsername, req.Username, clientIP)
+
 	// 检查用户名是否已存在
 	existingUser, _ := repoManager.UserRepository.FindByUsername(req.Username)
 	if existingUser != nil {
+		utils.Warn("CreateUser - 用户名已存在 - 管理员: %s, 用户名: %s, IP: %s", adminUsername, req.Username, clientIP)
 		ErrorResponse(c, "用户名已存在", http.StatusBadRequest)
 		return
 	}
@@ -133,6 +158,7 @@ func CreateUser(c *gin.Context) {
 	// 检查邮箱是否已存在
 	existingEmail, _ := repoManager.UserRepository.FindByEmail(req.Email)
 	if existingEmail != nil {
+		utils.Warn("CreateUser - 邮箱已存在 - 管理员: %s, 邮箱: %s, IP: %s", adminUsername, req.Email, clientIP)
 		ErrorResponse(c, "邮箱已存在", http.StatusBadRequest)
 		return
 	}
@@ -140,6 +166,7 @@ func CreateUser(c *gin.Context) {
 	// 哈希密码
 	hashedPassword, err := middleware.HashPassword(req.Password)
 	if err != nil {
+		utils.Error("CreateUser - 密码加密失败 - 管理员: %s, 用户名: %s, IP: %s, Error: %v", adminUsername, req.Username, clientIP, err)
 		ErrorResponse(c, "密码加密失败", http.StatusInternalServerError)
 		return
 	}
@@ -154,10 +181,13 @@ func CreateUser(c *gin.Context) {
 
 	err = repoManager.UserRepository.Create(user)
 	if err != nil {
+		utils.Error("CreateUser - 创建用户失败 - 管理员: %s, 用户名: %s, IP: %s, Error: %v", adminUsername, req.Username, clientIP, err)
 		ErrorResponse(c, err.Error(), http.StatusInternalServerError)
 		return
 	}
 
+	utils.Info("CreateUser - 用户创建成功 - 管理员: %s, 用户名: %s(ID:%d), 角色: %s, IP: %s", adminUsername, req.Username, user.ID, req.Role, clientIP)
+
 	SuccessResponse(c, gin.H{
 		"message": "用户创建成功",
 		"user":    converter.ToUserResponse(user),
@@ -179,12 +209,21 @@ func UpdateUser(c *gin.Context) {
 		return
 	}
 
+	adminUsername, _ := c.Get("username")
+	clientIP, _ := c.Get("client_ip")
+	utils.Info("UpdateUser - 管理员更新用户 - 管理员: %s, 目标用户ID: %d, IP: %s", adminUsername, id, clientIP)
+
 	user, err := repoManager.UserRepository.FindByID(uint(id))
 	if err != nil {
+		utils.Warn("UpdateUser - 目标用户不存在 - 管理员: %s, 用户ID: %d, IP: %s", adminUsername, id, clientIP)
 		ErrorResponse(c, "用户不存在", http.StatusNotFound)
 		return
 	}
 
+	// 记录变更前的信息
+	oldInfo := fmt.Sprintf("用户名:%s,邮箱:%s,角色:%s,状态:%t", user.Username, user.Email, user.Role, user.IsActive)
+	utils.Debug("UpdateUser - 更新前用户信息 - 管理员: %s, 用户ID: %d, 信息: %s", adminUsername, id, oldInfo)
+
 	if req.Username != "" {
 		user.Username = req.Username
 	}
@@ -198,10 +237,15 @@ func UpdateUser(c *gin.Context) {
 
 	err = repoManager.UserRepository.Update(user)
 	if err != nil {
+		utils.Error("UpdateUser - 更新用户失败 - 管理员: %s, 用户ID: %d, IP: %s, Error: %v", adminUsername, id, clientIP, err)
 		ErrorResponse(c, err.Error(), http.StatusInternalServerError)
 		return
 	}
 
+	// 记录变更后信息
+	newInfo := fmt.Sprintf("用户名:%s,邮箱:%s,角色:%s,状态:%t", user.Username, user.Email, user.Role, user.IsActive)
+	utils.Info("UpdateUser - 用户更新成功 - 管理员: %s, 用户ID: %d, 更新前: %s, 更新后: %s, IP: %s", adminUsername, id, oldInfo, newInfo, clientIP)
+
 	SuccessResponse(c, gin.H{"message": "用户更新成功"})
 }
 
@@ -220,8 +264,13 @@ func ChangePassword(c *gin.Context) {
 		return
 	}
 
+	adminUsername, _ := c.Get("username")
+	clientIP, _ := c.Get("client_ip")
+	utils.Info("ChangePassword - 管理员修改用户密码 - 管理员: %s, 目标用户ID: %d, IP: %s", adminUsername, id, clientIP)
+
 	user, err := repoManager.UserRepository.FindByID(uint(id))
 	if err != nil {
+		utils.Warn("ChangePassword - 目标用户不存在 - 管理员: %s, 用户ID: %d, IP: %s", adminUsername, id, clientIP)
 		ErrorResponse(c, "用户不存在", http.StatusNotFound)
 		return
 	}
@@ -229,6 +278,7 @@ func ChangePassword(c *gin.Context) {
 	// 哈希新密码
 	hashedPassword, err := middleware.HashPassword(req.NewPassword)
 	if err != nil {
+		utils.Error("ChangePassword - 密码加密失败 - 管理员: %s, 用户ID: %d, IP: %s, Error: %v", adminUsername, id, clientIP, err)
 		ErrorResponse(c, "密码加密失败", http.StatusInternalServerError)
 		return
 	}
@@ -236,10 +286,13 @@ func ChangePassword(c *gin.Context) {
 	user.Password = hashedPassword
 	err = repoManager.UserRepository.Update(user)
 	if err != nil {
+		utils.Error("ChangePassword - 更新密码失败 - 管理员: %s, 用户ID: %d, IP: %s, Error: %v", adminUsername, id, clientIP, err)
 		ErrorResponse(c, err.Error(), http.StatusInternalServerError)
 		return
 	}
 
+	utils.Info("ChangePassword - 密码修改成功 - 管理员: %s, 用户名: %s(ID:%d), IP: %s", adminUsername, user.Username, id, clientIP)
+
 	SuccessResponse(c, gin.H{"message": "密码修改成功"})
 }
 
@@ -252,12 +305,27 @@ func DeleteUser(c *gin.Context) {
 		return
 	}
 
+	adminUsername, _ := c.Get("username")
+	clientIP, _ := c.Get("client_ip")
+	utils.Info("DeleteUser - 管理员删除用户 - 管理员: %s, 目标用户ID: %d, IP: %s", adminUsername, id, clientIP)
+
+	// 先获取用户信息用于日志记录
+	user, err := repoManager.UserRepository.FindByID(uint(id))
+	if err != nil {
+		utils.Warn("DeleteUser - 目标用户不存在 - 管理员: %s, 用户ID: %d, IP: %s", adminUsername, id, clientIP)
+		ErrorResponse(c, "用户不存在", http.StatusNotFound)
+		return
+	}
+
 	err = repoManager.UserRepository.Delete(uint(id))
 	if err != nil {
+		utils.Error("DeleteUser - 删除用户失败 - 管理员: %s, 用户ID: %d, IP: %s, Error: %v", adminUsername, id, clientIP, err)
 		ErrorResponse(c, err.Error(), http.StatusInternalServerError)
 		return
 	}
 
+	utils.Info("DeleteUser - 用户删除成功 - 管理员: %s, 用户名: %s(ID:%d), IP: %s", adminUsername, user.Username, id, clientIP)
+
 	SuccessResponse(c, gin.H{"message": "用户删除成功"})
 }
 
@@ -269,12 +337,18 @@ func GetProfile(c *gin.Context) {
 		return
 	}
 
+	username, _ := c.Get("username")
+	clientIP, _ := c.Get("client_ip")
+	utils.Info("GetProfile - 用户获取个人资料 - 用户名: %s(ID:%d), IP: %s", username, userID, clientIP)
+
 	user, err := repoManager.UserRepository.FindByID(userID.(uint))
 	if err != nil {
+		utils.Warn("GetProfile - 用户不存在 - 用户名: %s(ID:%d), IP: %s", username, userID, clientIP)
 		ErrorResponse(c, "用户不存在", http.StatusNotFound)
 		return
 	}
 
 	response := converter.ToUserResponse(user)
+	utils.Debug("GetProfile - 成功获取个人资料 - 用户名: %s(ID:%d), IP: %s", username, userID, clientIP)
 	SuccessResponse(c, response)
 }

handlers/wechat_handler.go

@@ -0,0 +1,286 @@
+package handlers
+
+import (
+	"crypto/sha1"
+	"encoding/xml"
+	"fmt"
+	"io"
+	"net/http"
+	"sort"
+	"strings"
+	"time"
+
+	"github.com/ctwj/urldb/db/converter"
+	"github.com/ctwj/urldb/db/dto"
+	"github.com/ctwj/urldb/db/entity"
+	"github.com/ctwj/urldb/db/repo"
+	"github.com/ctwj/urldb/services"
+	"github.com/ctwj/urldb/utils"
+	"github.com/gin-gonic/gin"
+	"github.com/silenceper/wechat/v2/officialaccount/message"
+)
+
+// WechatHandler 微信公众号处理器
+type WechatHandler struct {
+	wechatService    services.WechatBotService
+	systemConfigRepo repo.SystemConfigRepository
+}
+
+// NewWechatHandler 创建微信公众号处理器
+func NewWechatHandler(
+	wechatService services.WechatBotService,
+	systemConfigRepo repo.SystemConfigRepository,
+) *WechatHandler {
+	return &WechatHandler{
+		wechatService:    wechatService,
+		systemConfigRepo: systemConfigRepo,
+	}
+}
+
+// HandleWechatMessage 处理微信消息推送
+func (h *WechatHandler) HandleWechatMessage(c *gin.Context) {
+	// 验证微信消息签名
+	if !h.validateSignature(c) {
+		utils.Error("[WECHAT:VALIDATE] 签名验证失败")
+		c.String(http.StatusForbidden, "签名验证失败")
+		return
+	}
+
+	// 处理微信验证请求
+	if c.Request.Method == "GET" {
+		echostr := c.Query("echostr")
+		utils.Info("[WECHAT:VERIFY] 微信服务器验证成功, echostr=%s", echostr)
+		c.String(http.StatusOK, echostr)
+		return
+	}
+
+	// 读取请求体
+	body, err := io.ReadAll(c.Request.Body)
+	if err != nil {
+		utils.Error("[WECHAT:MESSAGE] 读取请求体失败: %v", err)
+		c.String(http.StatusBadRequest, "读取请求体失败")
+		return
+	}
+
+	// 解析微信消息
+	var msg message.MixMessage
+	if err := xml.Unmarshal(body, &msg); err != nil {
+		utils.Error("[WECHAT:MESSAGE] 解析微信消息失败: %v", err)
+		c.String(http.StatusBadRequest, "消息格式错误")
+		return
+	}
+
+	// 处理消息
+	reply, err := h.wechatService.HandleMessage(&msg)
+	if err != nil {
+		utils.Error("[WECHAT:MESSAGE] 处理微信消息失败: %v", err)
+		c.String(http.StatusInternalServerError, "处理失败")
+		return
+	}
+
+	utils.Info("[WECHAT:MESSAGE] 回复对象: %v", reply)
+
+	// 如果有回复内容，发送回复
+	if reply != nil {
+		// 为微信消息设置正确的ToUserName和FromUserName
+		switch v := reply.(type) {
+		case *message.Text:
+			if v.CommonToken.ToUserName == "" {
+				v.CommonToken.ToUserName = msg.FromUserName
+			}
+			if v.CommonToken.FromUserName == "" {
+				v.CommonToken.FromUserName = msg.ToUserName
+			}
+			if v.CommonToken.CreateTime == 0 {
+				v.CommonToken.CreateTime = time.Now().Unix()
+			}
+			// 确保MsgType正确设置
+			if v.CommonToken.MsgType == "" {
+				v.CommonToken.MsgType = message.MsgTypeText
+			}
+		case *message.Image:
+			if v.CommonToken.ToUserName == "" {
+				v.CommonToken.ToUserName = msg.FromUserName
+			}
+			if v.CommonToken.FromUserName == "" {
+				v.CommonToken.FromUserName = msg.ToUserName
+			}
+			if v.CommonToken.CreateTime == 0 {
+				v.CommonToken.CreateTime = time.Now().Unix()
+			}
+			// 确保MsgType正确设置
+			if v.CommonToken.MsgType == "" {
+				v.CommonToken.MsgType = message.MsgTypeImage
+			}
+		}
+
+		responseXML, err := xml.Marshal(reply)
+		if err != nil {
+			utils.Error("[WECHAT:MESSAGE] 序列化回复消息失败: %v", err)
+			c.String(http.StatusInternalServerError, "回复失败")
+			return
+		}
+		utils.Info("[WECHAT:MESSAGE] 回复XML: %s", string(responseXML))
+		c.Data(http.StatusOK, "application/xml", responseXML)
+	} else {
+		utils.Warn("[WECHAT:MESSAGE] 没有回复内容，返回success")
+		c.String(http.StatusOK, "success")
+	}
+}
+
+// GetBotConfig 获取微信机器人配置
+func (h *WechatHandler) GetBotConfig(c *gin.Context) {
+	configs, err := h.systemConfigRepo.GetOrCreateDefault()
+	if err != nil {
+		ErrorResponse(c, "获取配置失败", http.StatusInternalServerError)
+		return
+	}
+
+	botConfig := converter.SystemConfigToWechatBotConfig(configs)
+	SuccessResponse(c, botConfig)
+}
+
+// UpdateBotConfig 更新微信机器人配置
+func (h *WechatHandler) UpdateBotConfig(c *gin.Context) {
+	var req dto.WechatBotConfigRequest
+	if err := c.ShouldBindJSON(&req); err != nil {
+		ErrorResponse(c, "请求参数错误", http.StatusBadRequest)
+		return
+	}
+
+	// 转换为系统配置实体
+	configs := converter.WechatBotConfigRequestToSystemConfigs(req)
+
+	// 保存配置
+	if len(configs) > 0 {
+		err := h.systemConfigRepo.UpsertConfigs(configs)
+		if err != nil {
+			ErrorResponse(c, "保存配置失败", http.StatusInternalServerError)
+			return
+		}
+	}
+
+	// 重新加载配置缓存
+	if err := h.systemConfigRepo.SafeRefreshConfigCache(); err != nil {
+		ErrorResponse(c, "刷新配置缓存失败", http.StatusInternalServerError)
+		return
+	}
+
+	// 重新加载机器人服务配置
+	if err := h.wechatService.ReloadConfig(); err != nil {
+		ErrorResponse(c, "重新加载机器人配置失败", http.StatusInternalServerError)
+		return
+	}
+
+	// 配置更新完成后，尝试启动机器人（如果未运行且配置有效）
+	if startErr := h.wechatService.Start(); startErr != nil {
+		utils.Warn("[WECHAT:HANDLER] 配置更新后尝试启动机器人失败: %v", startErr)
+		// 启动失败不影响配置保存，只记录警告
+	}
+
+	// 返回成功
+	SuccessResponse(c, map[string]interface{}{
+		"success": true,
+		"message": "配置更新成功，机器人已尝试启动",
+	})
+}
+
+// GetBotStatus 获取机器人状态
+func (h *WechatHandler) GetBotStatus(c *gin.Context) {
+	// 获取机器人运行时状态
+	runtimeStatus := h.wechatService.GetRuntimeStatus()
+
+	// 获取配置状态
+	configs, err := h.systemConfigRepo.GetOrCreateDefault()
+	if err != nil {
+		ErrorResponse(c, "获取配置失败", http.StatusInternalServerError)
+		return
+	}
+
+	// 解析配置状态
+	configStatus := map[string]interface{}{
+		"enabled":            false,
+		"auto_reply_enabled": false,
+		"app_id_configured":  false,
+		"token_configured":   false,
+	}
+
+	for _, config := range configs {
+		switch config.Key {
+		case entity.ConfigKeyWechatBotEnabled:
+			configStatus["enabled"] = config.Value == "true"
+		case entity.ConfigKeyWechatAutoReplyEnabled:
+			configStatus["auto_reply_enabled"] = config.Value == "true"
+		case entity.ConfigKeyWechatAppId:
+			configStatus["app_id_configured"] = config.Value != ""
+		case entity.ConfigKeyWechatToken:
+			configStatus["token_configured"] = config.Value != ""
+		}
+	}
+
+	// 合并状态信息
+	status := map[string]interface{}{
+		"config":         configStatus,
+		"runtime":        runtimeStatus,
+		"overall_status": runtimeStatus["is_running"].(bool),
+		"status_text": func() string {
+			if runtimeStatus["is_running"].(bool) {
+				return "运行中"
+			} else if configStatus["enabled"].(bool) {
+				return "已启用但未运行"
+			} else {
+				return "已停止"
+			}
+		}(),
+	}
+
+	SuccessResponse(c, status)
+}
+
+// validateSignature 验证微信消息签名
+func (h *WechatHandler) validateSignature(c *gin.Context) bool {
+	// 获取配置中的Token
+	configs, err := h.systemConfigRepo.GetOrCreateDefault()
+	if err != nil {
+		utils.Error("[WECHAT:VALIDATE] 获取配置失败: %v", err)
+		return false
+	}
+
+	var token string
+	for _, config := range configs {
+		if config.Key == entity.ConfigKeyWechatToken {
+			token = config.Value
+			break
+		}
+	}
+
+	utils.Debug("[WECHAT:VALIDATE] Token配置状态: %t", token != "")
+
+	if token == "" {
+		// 如果没有配置Token，跳过签名验证（开发模式）
+		utils.Warn("[WECHAT:VALIDATE] 未配置Token，跳过签名验证")
+		return true
+	}
+
+	signature := c.Query("signature")
+	timestamp := c.Query("timestamp")
+	nonce := c.Query("nonce")
+
+	utils.Debug("[WECHAT:VALIDATE] 接收到的参数 - signature: %s, timestamp: %s, nonce: %s", signature, timestamp, nonce)
+
+	// 验证签名
+	tmpArr := []string{token, timestamp, nonce}
+	sort.Strings(tmpArr)
+	tmpStr := strings.Join(tmpArr, "")
+	tmpStr = fmt.Sprintf("%x", sha1.Sum([]byte(tmpStr)))
+
+	utils.Debug("[WECHAT:VALIDATE] 计算出的签名: %s, 微信提供的签名: %s", tmpStr, signature)
+
+	if tmpStr == signature {
+		utils.Info("[WECHAT:VALIDATE] 签名验证成功")
+		return true
+	} else {
+		utils.Error("[WECHAT:VALIDATE] 签名验证失败 - 计算出的签名: %s, 微信提供的签名: %s", tmpStr, signature)
+		return false
+	}
+}

main.go

@@ -4,13 +4,18 @@ import (
 	"fmt"
 	"log"
 	"os"
+	"os/signal"
 	"strings"
+	"syscall"
+	"time"
 
+	"github.com/ctwj/urldb/config"
 	"github.com/ctwj/urldb/db"
 	"github.com/ctwj/urldb/db/entity"
 	"github.com/ctwj/urldb/db/repo"
 	"github.com/ctwj/urldb/handlers"
 	"github.com/ctwj/urldb/middleware"
+	"github.com/ctwj/urldb/monitor"
 	"github.com/ctwj/urldb/scheduler"
 	"github.com/ctwj/urldb/services"
 	"github.com/ctwj/urldb/task"
@@ -35,10 +40,9 @@ func main() {
 	}
 
 	// 初始化日志系统
-	if err := utils.InitLogger(nil); err != nil {
+	if err := utils.InitLogger(); err != nil {
 		log.Fatal("初始化日志系统失败:", err)
 	}
-	defer utils.GetLogger().Close()
 
 	// 加载环境变量
 	if err := godotenv.Load(); err != nil {
@@ -82,9 +86,22 @@ func main() {
 		utils.Fatal("数据库连接失败: %v", err)
 	}
 
+	// 日志系统已简化，无需额外初始化
+
 	// 创建Repository管理器
 	repoManager := repo.NewRepositoryManager(db.DB)
 
+	// 创建配置管理器
+	configManager := config.NewConfigManager(repoManager)
+
+	// 设置全局配置管理器
+	config.SetGlobalConfigManager(configManager)
+
+	// 加载所有配置到缓存
+	if err := configManager.LoadAllConfigs(); err != nil {
+		utils.Error("加载配置缓存失败: %v", err)
+	}
+
 	// 创建任务管理器
 	taskManager := task.NewTaskManager(repoManager)
 
@@ -112,7 +129,22 @@ func main() {
 	utils.Info("任务管理器初始化完成")
 
 	// 创建Gin实例
-	r := gin.Default()
+	r := gin.New()
+
+	// 创建监控和错误处理器
+	metrics := monitor.GetGlobalMetrics()
+	errorHandler := monitor.GetGlobalErrorHandler()
+	if errorHandler == nil {
+		errorHandler = monitor.NewErrorHandler(1000, 24*time.Hour)
+		monitor.SetGlobalErrorHandler(errorHandler)
+	}
+
+	// 添加中间件
+	r.Use(gin.Logger())                     // Gin日志中间件
+	r.Use(errorHandler.RecoverMiddleware()) // Panic恢复中间件
+	r.Use(errorHandler.ErrorMiddleware())   // 错误处理中间件
+	r.Use(metrics.MetricsMiddleware())      // 监控中间件
+	r.Use(gin.Recovery())                   // Gin恢复中间件
 
 	// 配置CORS
 	config := cors.DefaultConfig()
@@ -124,9 +156,15 @@ func main() {
 	// 将Repository管理器注入到handlers中
 	handlers.SetRepositoryManager(repoManager)
 
+	// 将Repository管理器注入到services中
+	services.SetRepositoryManager(repoManager)
+
 	// 设置Meilisearch管理器到handlers中
 	handlers.SetMeilisearchManager(meilisearchManager)
 
+	// 设置Meilisearch管理器到services中
+	services.SetMeilisearchManager(meilisearchManager)
+
 	// 设置全局调度器的Meilisearch管理器
 	scheduler.SetGlobalMeilisearchManager(meilisearchManager)
 
@@ -170,6 +208,13 @@ func main() {
 	// 创建Meilisearch处理器
 	meilisearchHandler := handlers.NewMeilisearchHandler(meilisearchManager)
 
+	// 创建OG图片处理器
+	ogImageHandler := handlers.NewOGImageHandler()
+
+	// 创建举报和版权申述处理器
+	reportHandler := handlers.NewReportHandler(repoManager.ReportRepository, repoManager.ResourceRepository)
+	copyrightClaimHandler := handlers.NewCopyrightClaimHandler(repoManager.CopyrightClaimRepository, repoManager.ResourceRepository)
+
 	// API路由
 	api := r.Group("/api")
 	{
@@ -192,13 +237,18 @@ func main() {
 
 		// 资源管理
 		api.GET("/resources", handlers.GetResources)
+		api.GET("/resources/hot", handlers.GetHotResources)
 		api.POST("/resources", middleware.AuthMiddleware(), middleware.AdminMiddleware(), handlers.CreateResource)
 		api.PUT("/resources/:id", middleware.AuthMiddleware(), middleware.AdminMiddleware(), handlers.UpdateResource)
 		api.DELETE("/resources/:id", middleware.AuthMiddleware(), middleware.AdminMiddleware(), handlers.DeleteResource)
 		api.GET("/resources/:id", handlers.GetResourceByID)
+		api.GET("/resources/key/:key", handlers.GetResourcesByKey)
 		api.GET("/resources/check-exists", handlers.CheckResourceExists)
+		api.GET("/resources/related", handlers.GetRelatedResources)
 		api.POST("/resources/:id/view", handlers.IncrementResourceViewCount)
 		api.GET("/resources/:id/link", handlers.GetResourceLink)
+		api.GET("/resources/:id/validity", handlers.CheckResourceValidity)
+		api.POST("/resources/validity/batch", handlers.BatchCheckResourceValidity)
 		api.DELETE("/resources/batch", middleware.AuthMiddleware(), middleware.AdminMiddleware(), handlers.BatchDeleteResources)
 
 		// 分类管理
@@ -231,6 +281,7 @@ func main() {
 		api.DELETE("/cks/:id", middleware.AuthMiddleware(), middleware.AdminMiddleware(), handlers.DeleteCks)
 		api.GET("/cks/:id", middleware.AuthMiddleware(), middleware.AdminMiddleware(), handlers.GetCksByID)
 		api.POST("/cks/:id/refresh-capacity", middleware.AuthMiddleware(), middleware.AdminMiddleware(), handlers.RefreshCapacity)
+		api.POST("/cks/:id/delete-related-resources", middleware.AuthMiddleware(), middleware.AdminMiddleware(), handlers.DeleteRelatedResources)
 
 		// 标签管理
 		api.GET("/tags", handlers.GetTags)
@@ -272,6 +323,18 @@ func main() {
 		api.POST("/search-stats/record", handlers.RecordSearch)
 		api.GET("/search-stats/summary", handlers.GetSearchStatsSummary)
 
+		// API访问日志路由
+		api.GET("/api-access-logs", middleware.AuthMiddleware(), middleware.AdminMiddleware(), handlers.GetAPIAccessLogs)
+		api.GET("/api-access-logs/summary", middleware.AuthMiddleware(), middleware.AdminMiddleware(), handlers.GetAPIAccessLogSummary)
+		api.GET("/api-access-logs/stats", middleware.AuthMiddleware(), middleware.AdminMiddleware(), handlers.GetAPIAccessLogStats)
+		api.DELETE("/api-access-logs", middleware.AuthMiddleware(), middleware.AdminMiddleware(), handlers.ClearAPIAccessLogs)
+
+		// 系统日志路由
+		api.GET("/system-logs", middleware.AuthMiddleware(), middleware.AdminMiddleware(), handlers.GetSystemLogs)
+		api.GET("/system-logs/files", middleware.AuthMiddleware(), middleware.AdminMiddleware(), handlers.GetSystemLogFiles)
+		api.GET("/system-logs/summary", middleware.AuthMiddleware(), middleware.AdminMiddleware(), handlers.GetSystemLogSummary)
+		api.DELETE("/system-logs", middleware.AuthMiddleware(), middleware.AdminMiddleware(), handlers.ClearSystemLogs)
+
 		// 系统配置路由
 		api.GET("/system/config", middleware.AuthMiddleware(), middleware.AdminMiddleware(), handlers.GetSystemConfig)
 		api.POST("/system/config", middleware.AuthMiddleware(), middleware.AdminMiddleware(), handlers.UpdateSystemConfig)
@@ -323,6 +386,8 @@ func main() {
 		api.GET("/files", middleware.AuthMiddleware(), fileHandler.GetFileList)
 		api.DELETE("/files", middleware.AuthMiddleware(), fileHandler.DeleteFiles)
 		api.PUT("/files", middleware.AuthMiddleware(), fileHandler.UpdateFile)
+		// 微信公众号验证文件上传（无需认证，仅支持TXT文件）
+		api.POST("/wechat/verify-file", fileHandler.UploadWechatVerifyFile)
 
 		// 创建Telegram Bot服务
 		telegramBotService := services.NewTelegramBotService(
@@ -337,6 +402,18 @@ func main() {
 			utils.Error("启动Telegram Bot服务失败: %v", err)
 		}
 
+		// 创建微信公众号机器人服务
+		wechatBotService := services.NewWechatBotService(
+			repoManager.SystemConfigRepository,
+			repoManager.ResourceRepository,
+			repoManager.ReadyResourceRepository,
+		)
+
+		// 启动微信公众号机器人服务
+		if err := wechatBotService.Start(); err != nil {
+			utils.Error("启动微信公众号机器人服务失败: %v", err)
+		}
+
 		// Telegram相关路由
 		telegramHandler := handlers.NewTelegramHandler(
 			repoManager.TelegramChannelRepository,
@@ -358,8 +435,50 @@ func main() {
 		api.GET("/telegram/logs/stats", middleware.AuthMiddleware(), middleware.AdminMiddleware(), telegramHandler.GetTelegramLogStats)
 		api.POST("/telegram/logs/clear", middleware.AuthMiddleware(), middleware.AdminMiddleware(), telegramHandler.ClearTelegramLogs)
 		api.POST("/telegram/webhook", telegramHandler.HandleWebhook)
+
+		// 微信公众号相关路由
+		wechatHandler := handlers.NewWechatHandler(
+			wechatBotService,
+			repoManager.SystemConfigRepository,
+		)
+		api.GET("/wechat/bot-config", middleware.AuthMiddleware(), middleware.AdminMiddleware(), wechatHandler.GetBotConfig)
+		api.PUT("/wechat/bot-config", middleware.AuthMiddleware(), middleware.AdminMiddleware(), wechatHandler.UpdateBotConfig)
+		api.GET("/wechat/bot-status", middleware.AuthMiddleware(), middleware.AdminMiddleware(), wechatHandler.GetBotStatus)
+		api.POST("/wechat/callback", wechatHandler.HandleWechatMessage)
+		api.GET("/wechat/callback", wechatHandler.HandleWechatMessage)
+
+		// OG图片生成路由
+		api.GET("/og-image", ogImageHandler.GenerateOGImage)
+
+		// 举报和版权申述路由
+		api.POST("/reports", reportHandler.CreateReport)
+		api.GET("/reports/:id", reportHandler.GetReport)
+		api.GET("/reports", middleware.AuthMiddleware(), middleware.AdminMiddleware(), reportHandler.ListReports)
+		api.PUT("/reports/:id", middleware.AuthMiddleware(), middleware.AdminMiddleware(), reportHandler.UpdateReport)
+		api.DELETE("/reports/:id", middleware.AuthMiddleware(), middleware.AdminMiddleware(), reportHandler.DeleteReport)
+		api.GET("/reports/resource/:resource_key", reportHandler.GetReportByResource)
+
+		api.POST("/copyright-claims", copyrightClaimHandler.CreateCopyrightClaim)
+		api.GET("/copyright-claims/:id", copyrightClaimHandler.GetCopyrightClaim)
+		api.GET("/copyright-claims", middleware.AuthMiddleware(), middleware.AdminMiddleware(), copyrightClaimHandler.ListCopyrightClaims)
+		api.PUT("/copyright-claims/:id", middleware.AuthMiddleware(), middleware.AdminMiddleware(), copyrightClaimHandler.UpdateCopyrightClaim)
+		api.DELETE("/copyright-claims/:id", middleware.AuthMiddleware(), middleware.AdminMiddleware(), copyrightClaimHandler.DeleteCopyrightClaim)
+		api.GET("/copyright-claims/resource/:resource_key", copyrightClaimHandler.GetCopyrightClaimByResource)
 	}
 
+	// 设置监控系统
+	monitor.SetupMonitoring(r)
+
+	// 启动监控服务器
+	metricsConfig := &monitor.MetricsConfig{
+		Enabled:       true,
+		ListenAddress: ":9090",
+		MetricsPath:   "/metrics",
+		Namespace:     "urldb",
+		Subsystem:     "api",
+	}
+	metrics.StartMetricsServer(metricsConfig)
+
 	// 静态文件服务
 	r.Static("/uploads", "./uploads")
 
@@ -378,6 +497,21 @@ func main() {
 		port = "8080"
 	}
 
-	utils.Info("服务器启动在端口 %s", port)
-	r.Run(":" + port)
+	// 设置优雅关闭
+	quit := make(chan os.Signal, 1)
+	signal.Notify(quit, syscall.SIGINT, syscall.SIGTERM)
+
+	// 在goroutine中启动服务器
+	go func() {
+		utils.Info("服务器启动在端口 %s", port)
+		if err := r.Run(":" + port); err != nil && err.Error() != "http: Server closed" {
+			utils.Fatal("服务器启动失败: %v", err)
+		}
+	}()
+
+	// 等待信号
+	<-quit
+	utils.Info("收到关闭信号，开始优雅关闭...")
+
+	utils.Info("服务器已优雅关闭")
 }

middleware/auth.go

@@ -27,11 +27,14 @@ type Claims struct {
 func AuthMiddleware() gin.HandlerFunc {
 	return func(c *gin.Context) {
 		authHeader := c.GetHeader("Authorization")
-		// utils.Info("AuthMiddleware - 收到请求: %s %s", c.Request.Method, c.Request.URL.Path)
-		// utils.Info("AuthMiddleware - Authorization头: %s", authHeader)
+		clientIP := c.ClientIP()
+		userAgent := c.Request.UserAgent()
+
+		utils.Debug("AuthMiddleware - 认证请求: %s %s, IP: %s, UserAgent: %s",
+			c.Request.Method, c.Request.URL.Path, clientIP, userAgent)
 
 		if authHeader == "" {
-			utils.Error("AuthMiddleware - 未提供认证令牌")
+			// utils.Warn("AuthMiddleware - 未提供认证令牌 - IP: %s, Path: %s", clientIP, c.Request.URL.Path)
 			c.JSON(http.StatusUnauthorized, gin.H{"error": "未提供认证令牌"})
 			c.Abort()
 			return
@@ -39,29 +42,31 @@ func AuthMiddleware() gin.HandlerFunc {
 
 		// 检查Bearer前缀
 		if !strings.HasPrefix(authHeader, "Bearer ") {
-			// utils.Error("AuthMiddleware - 无效的认证格式: %s", authHeader)
+			utils.Warn("AuthMiddleware - 无效的认证格式 - IP: %s, Header: %s", clientIP, authHeader)
 			c.JSON(http.StatusUnauthorized, gin.H{"error": "无效的认证格式"})
 			c.Abort()
 			return
 		}
 
 		tokenString := strings.TrimPrefix(authHeader, "Bearer ")
-		// utils.Info("AuthMiddleware - 解析令牌: %s", tokenString[:10]+"...")
+		utils.Debug("AuthMiddleware - 解析令牌: %s...", tokenString[:utils.Min(len(tokenString), 10)])
 
 		claims, err := parseToken(tokenString)
 		if err != nil {
-			// utils.Error("AuthMiddleware - 令牌解析失败: %v", err)
+			utils.Warn("AuthMiddleware - 令牌解析失败 - IP: %s, Error: %v", clientIP, err)
 			c.JSON(http.StatusUnauthorized, gin.H{"error": "无效的令牌"})
 			c.Abort()
 			return
 		}
 
-		// utils.Info("AuthMiddleware - 令牌验证成功，用户: %s, 角色: %s", claims.Username, claims.Role)
+		// utils.Info("AuthMiddleware - 认证成功 - 用户: %s(ID:%d), 角色: %s, IP: %s",
+		// 	claims.Username, claims.UserID, claims.Role, clientIP)
 
 		// 将用户信息存储到上下文中
 		c.Set("user_id", claims.UserID)
 		c.Set("username", claims.Username)
 		c.Set("role", claims.Role)
+		c.Set("client_ip", clientIP)
 
 		c.Next()
 	}
@@ -71,18 +76,23 @@ func AuthMiddleware() gin.HandlerFunc {
 func AdminMiddleware() gin.HandlerFunc {
 	return func(c *gin.Context) {
 		role, exists := c.Get("role")
+		username, _ := c.Get("username")
+		clientIP, _ := c.Get("client_ip")
+
 		if !exists {
-			// c.JSON(http.StatusUnauthorized, gin.H{"error": "未认证"})
+			utils.Warn("AdminMiddleware - 未认证访问管理员接口 - IP: %s, Path: %s", clientIP, c.Request.URL.Path)
 			c.Abort()
 			return
 		}
 
 		if role != "admin" {
-			// c.JSON(http.StatusForbidden, gin.H{"error": "需要管理员权限"})
+			utils.Warn("AdminMiddleware - 非管理员用户尝试访问管理员接口 - 用户: %s, 角色: %s, IP: %s, Path: %s",
+				username, role, clientIP, c.Request.URL.Path)
 			c.Abort()
 			return
 		}
 
+		utils.Debug("AdminMiddleware - 管理员访问接口 - 用户: %s, IP: %s, Path: %s", username, clientIP, c.Request.URL.Path)
 		c.Next()
 	}
 }

middleware/logging.go

@@ -4,6 +4,7 @@ import (
 	"bytes"
 	"io"
 	"net/http"
+	"strings"
 	"time"
 
 	"github.com/ctwj/urldb/utils"
@@ -55,41 +56,71 @@ func LoggingMiddleware(next http.Handler) http.Handler {
 	})
 }
 
-// logRequest 记录请求日志
+// logRequest 记录请求日志 - 恢复正常请求日志记录
 func logRequest(r *http.Request, rw *responseWriter, duration time.Duration, requestBody []byte) {
 	// 获取客户端IP
 	clientIP := getClientIP(r)
 
-	// 获取用户代理
-	userAgent := r.UserAgent()
-	if userAgent == "" {
-		userAgent = "Unknown"
-	}
+	// 判断是否需要详细记录日志的条件
+	shouldDetailLog := rw.statusCode >= 400 || // 错误状态码
+		duration > 5*time.Second || // 耗时过长
+		shouldLogPath(r.URL.Path) || // 关键路径
+		isAdminPath(r.URL.Path) // 管理员路径
 
-	// 记录请求信息
-	utils.Info("HTTP请求 - %s %s - IP: %s - User-Agent: %s - 状态码: %d - 耗时: %v",
-		r.Method, r.URL.Path, clientIP, userAgent, rw.statusCode, duration)
-
-	// 如果是错误状态码，记录详细信息
+	// 所有API请求都记录基本信息，但详细日志只记录重要请求
 	if rw.statusCode >= 400 {
-		utils.Error("HTTP错误 - %s %s - 状态码: %d - 响应体: %s",
-			r.Method, r.URL.Path, rw.statusCode, rw.body.String())
+		// 错误请求记录详细信息
+		utils.Error("HTTP异常 - %s %s - IP: %s - 状态码: %d - 耗时: %v",
+			r.Method, r.URL.Path, clientIP, rw.statusCode, duration)
+
+		// 仅在错误状态下记录简要的请求信息
+		if len(requestBody) > 0 && len(requestBody) <= 500 {
+			utils.Error("请求详情: %s", string(requestBody))
+		}
+	} else if duration > 5*time.Second {
+		// 慢请求警告
+		utils.Warn("HTTP慢请求 - %s %s - IP: %s - 耗时: %v",
+			r.Method, r.URL.Path, clientIP, duration)
+	} else if shouldDetailLog {
+		// 关键路径的正常请求
+		utils.Info("HTTP关键请求 - %s %s - IP: %s - 状态码: %d - 耗时: %v",
+			r.Method, r.URL.Path, clientIP, rw.statusCode, duration)
+	} else {
+		// 普通API请求记录简化日志 - 使用Info级别确保能被看到
+		// utils.Info("HTTP请求 - %s %s - 状态码: %d - 耗时: %v",
+		// 	r.Method, r.URL.Path, rw.statusCode, duration)
+	}
+}
+
+// shouldLogPath 判断路径是否需要记录日志
+func shouldLogPath(path string) bool {
+	// 定义需要记录日志的关键路径
+	keyPaths := []string{
+		"/api/public/resources",
+		"/api/admin/config",
+		"/api/admin/users",
+		"/telegram/webhook",
+		"/api/resources",
+		"/api/version",
+		"/api/cks",
+		"/api/pans",
+		"/api/categories",
+		"/api/tags",
+		"/api/tasks",
 	}
 
-	// 记录请求参数（仅对POST/PUT请求）
-	if (r.Method == "POST" || r.Method == "PUT") && len(requestBody) > 0 {
-		// 限制日志长度，避免日志文件过大
-		if len(requestBody) > 1000 {
-			utils.Debug("请求体(截断): %s...", string(requestBody[:1000]))
-		} else {
-			utils.Debug("请求体: %s", string(requestBody))
+	for _, keyPath := range keyPaths {
+		if strings.HasPrefix(path, keyPath) {
+			return true
 		}
 	}
+	return false
+}
 
-	// 记录查询参数
-	if len(r.URL.RawQuery) > 0 {
-		utils.Debug("查询参数: %s", r.URL.RawQuery)
-	}
+// isAdminPath 判断是否为管理员路径
+func isAdminPath(path string) bool {
+	return strings.HasPrefix(path, "/api/admin/") ||
+		strings.HasPrefix(path, "/admin/")
 }
 
 // getClientIP 获取客户端真实IP地址

migrations/telegram_channels.sql

@@ -28,6 +28,12 @@ CREATE TABLE telegram_channels (
     token VARCHAR(255) COMMENT '访问令牌',
     api_type VARCHAR(50) COMMENT 'API类型',
     is_push_saved_info BOOLEAN DEFAULT FALSE COMMENT '是否只推送已转存资源',
+
+    -- 资源策略和时间限制配置
+    resource_strategy VARCHAR(20) DEFAULT 'random' COMMENT '资源策略：latest-最新优先,transferred-已转存优先,random-纯随机',
+    time_limit VARCHAR(20) DEFAULT 'none' COMMENT '时间限制：none-无限制,week-一周内,month-一月内',
+    push_start_time VARCHAR(10) COMMENT '推送开始时间，格式HH:mm',
+    push_end_time VARCHAR(10) COMMENT '推送结束时间，格式HH:mm',
    
     -- 索引
     INDEX idx_chat_id (chat_id),

monitor/error_handler.go

@@ -0,0 +1,327 @@
+package monitor
+
+import (
+	"fmt"
+	"net/http"
+	"runtime"
+	"strings"
+	"sync"
+	"time"
+
+	"github.com/ctwj/urldb/utils"
+
+	"github.com/gin-gonic/gin"
+)
+
+// ErrorInfo 错误信息结构
+type ErrorInfo struct {
+	ID          string    `json:"id"`
+	Timestamp   time.Time `json:"timestamp"`
+	Message     string    `json:"message"`
+	StackTrace  string    `json:"stack_trace"`
+	RequestInfo *RequestInfo `json:"request_info,omitempty"`
+	Level       string    `json:"level"` // error, warn, info
+	Count       int       `json:"count"`
+}
+
+// RequestInfo 请求信息结构
+type RequestInfo struct {
+	Method      string            `json:"method"`
+	URL         string            `json:"url"`
+	Headers     map[string]string `json:"headers"`
+	RemoteAddr  string            `json:"remote_addr"`
+	UserAgent   string            `json:"user_agent"`
+	RequestBody string            `json:"request_body"`
+}
+
+// ErrorHandler 错误处理器
+type ErrorHandler struct {
+	errors     map[string]*ErrorInfo
+	mu         sync.RWMutex
+	maxErrors  int
+	retention  time.Duration
+}
+
+// NewErrorHandler 创建新的错误处理器
+func NewErrorHandler(maxErrors int, retention time.Duration) *ErrorHandler {
+	eh := &ErrorHandler{
+		errors:    make(map[string]*ErrorInfo),
+		maxErrors: maxErrors,
+		retention: retention,
+	}
+
+	// 启动错误清理协程
+	go eh.cleanupRoutine()
+
+	return eh
+}
+
+// RecoverMiddleware panic恢复中间件
+func (eh *ErrorHandler) RecoverMiddleware() gin.HandlerFunc {
+	return func(c *gin.Context) {
+		defer func() {
+			if err := recover(); err != nil {
+				// 记录错误信息
+				stackTrace := getStackTrace()
+
+				errorInfo := &ErrorInfo{
+					ID:         fmt.Sprintf("panic_%d", time.Now().UnixNano()),
+					Timestamp:  time.Now(),
+					Message:    fmt.Sprintf("%v", err),
+					StackTrace: stackTrace,
+					RequestInfo: &RequestInfo{
+						Method:     c.Request.Method,
+						URL:        c.Request.URL.String(),
+						RemoteAddr: c.ClientIP(),
+						UserAgent:  c.GetHeader("User-Agent"),
+					},
+					Level: "error",
+					Count: 1,
+				}
+
+				// 保存错误信息
+				eh.saveError(errorInfo)
+
+				utils.Error("Panic recovered: %v\nStack trace: %s", err, stackTrace)
+
+				// 返回错误响应
+				c.JSON(http.StatusInternalServerError, gin.H{
+					"error": "Internal server error",
+					"code":  "INTERNAL_ERROR",
+				})
+
+				// 不继续处理
+				c.Abort()
+			}
+		}()
+
+		c.Next()
+	}
+}
+
+// ErrorMiddleware 通用错误处理中间件
+func (eh *ErrorHandler) ErrorMiddleware() gin.HandlerFunc {
+	return func(c *gin.Context) {
+		c.Next()
+
+		// 检查是否有错误
+		if len(c.Errors) > 0 {
+			for _, ginErr := range c.Errors {
+				errorInfo := &ErrorInfo{
+					ID:        fmt.Sprintf("error_%d_%s", time.Now().UnixNano(), ginErr.Type),
+					Timestamp: time.Now(),
+					Message:   ginErr.Error(),
+					Level:     "error",
+					Count:     1,
+					RequestInfo: &RequestInfo{
+						Method:     c.Request.Method,
+						URL:        c.Request.URL.String(),
+						RemoteAddr: c.ClientIP(),
+						UserAgent:  c.GetHeader("User-Agent"),
+					},
+				}
+
+				eh.saveError(errorInfo)
+			}
+		}
+	}
+}
+
+// saveError 保存错误信息
+func (eh *ErrorHandler) saveError(errorInfo *ErrorInfo) {
+	eh.mu.Lock()
+	defer eh.mu.Unlock()
+
+	key := errorInfo.Message
+	if existing, exists := eh.errors[key]; exists {
+		// 如果错误已存在，增加计数
+		existing.Count++
+		existing.Timestamp = time.Now()
+	} else {
+		// 如果是新错误，添加到映射中
+		eh.errors[key] = errorInfo
+	}
+
+	// 如果错误数量超过限制，清理旧错误
+	if len(eh.errors) > eh.maxErrors {
+		eh.cleanupOldErrors()
+	}
+}
+
+// GetErrors 获取错误列表
+func (eh *ErrorHandler) GetErrors() []*ErrorInfo {
+	eh.mu.RLock()
+	defer eh.mu.RUnlock()
+
+	errors := make([]*ErrorInfo, 0, len(eh.errors))
+	for _, errorInfo := range eh.errors {
+		errors = append(errors, errorInfo)
+	}
+
+	return errors
+}
+
+// GetErrorByID 根据ID获取错误
+func (eh *ErrorHandler) GetErrorByID(id string) (*ErrorInfo, bool) {
+	eh.mu.RLock()
+	defer eh.mu.RUnlock()
+
+	for _, errorInfo := range eh.errors {
+		if errorInfo.ID == id {
+			return errorInfo, true
+		}
+	}
+
+	return nil, false
+}
+
+// ClearErrors 清空所有错误
+func (eh *ErrorHandler) ClearErrors() {
+	eh.mu.Lock()
+	defer eh.mu.Unlock()
+
+	eh.errors = make(map[string]*ErrorInfo)
+}
+
+// cleanupOldErrors 清理旧错误
+func (eh *ErrorHandler) cleanupOldErrors() {
+	// 简单策略：保留最近的错误，删除旧的
+	errors := make([]*ErrorInfo, 0, len(eh.errors))
+	for _, errorInfo := range eh.errors {
+		errors = append(errors, errorInfo)
+	}
+
+	// 按时间戳排序
+	for i := 0; i < len(errors)-1; i++ {
+		for j := i + 1; j < len(errors); j++ {
+			if errors[i].Timestamp.Before(errors[j].Timestamp) {
+				errors[i], errors[j] = errors[j], errors[i]
+			}
+		}
+	}
+
+	// 保留最新的maxErrors/2个错误
+	keep := eh.maxErrors / 2
+	if keep < 1 {
+		keep = 1
+	}
+
+	if len(errors) > keep {
+		// 重建错误映射
+		newErrors := make(map[string]*ErrorInfo)
+		for i := 0; i < keep; i++ {
+			newErrors[errors[i].Message] = errors[i]
+		}
+		eh.errors = newErrors
+	}
+}
+
+// cleanupRoutine 定期清理过期错误的协程
+func (eh *ErrorHandler) cleanupRoutine() {
+	ticker := time.NewTicker(5 * time.Minute) // 每5分钟清理一次
+	defer ticker.Stop()
+
+	for range ticker.C {
+		eh.mu.Lock()
+		for key, errorInfo := range eh.errors {
+			if time.Since(errorInfo.Timestamp) > eh.retention {
+				delete(eh.errors, key)
+			}
+		}
+		eh.mu.Unlock()
+	}
+}
+
+// getStackTrace 获取堆栈跟踪信息
+func getStackTrace() string {
+	var buf [4096]byte
+	n := runtime.Stack(buf[:], false)
+	return string(buf[:n])
+}
+
+// GetErrorStatistics 获取错误统计信息
+func (eh *ErrorHandler) GetErrorStatistics() map[string]interface{} {
+	eh.mu.RLock()
+	defer eh.mu.RUnlock()
+
+	totalErrors := len(eh.errors)
+	totalCount := 0
+	errorTypes := make(map[string]int)
+
+	for _, errorInfo := range eh.errors {
+		totalCount += errorInfo.Count
+		// 提取错误类型（基于错误消息的前几个单词）
+		parts := strings.Split(errorInfo.Message, " ")
+		if len(parts) > 0 {
+			errorType := strings.Join(parts[:min(3, len(parts))], " ")
+			errorTypes[errorType]++
+		}
+	}
+
+	return map[string]interface{}{
+		"total_errors":  totalErrors,
+		"total_count":   totalCount,
+		"error_types":   errorTypes,
+		"max_errors":    eh.maxErrors,
+		"retention":     eh.retention,
+		"active_errors": len(eh.errors),
+	}
+}
+
+// min 辅助函数
+func min(a, b int) int {
+	if a < b {
+		return a
+	}
+	return b
+}
+
+// GlobalErrorHandler 全局错误处理器
+var globalErrorHandler *ErrorHandler
+
+// InitGlobalErrorHandler 初始化全局错误处理器
+func InitGlobalErrorHandler(maxErrors int, retention time.Duration) {
+	globalErrorHandler = NewErrorHandler(maxErrors, retention)
+}
+
+// GetGlobalErrorHandler 获取全局错误处理器
+func GetGlobalErrorHandler() *ErrorHandler {
+	if globalErrorHandler == nil {
+		InitGlobalErrorHandler(100, 24*time.Hour)
+	}
+	return globalErrorHandler
+}
+
+// Recover 全局panic恢复函数
+func Recover() gin.HandlerFunc {
+	if globalErrorHandler == nil {
+		InitGlobalErrorHandler(100, 24*time.Hour)
+	}
+	return globalErrorHandler.RecoverMiddleware()
+}
+
+// Error 全局错误处理函数
+func Error() gin.HandlerFunc {
+	if globalErrorHandler == nil {
+		InitGlobalErrorHandler(100, 24*time.Hour)
+	}
+	return globalErrorHandler.ErrorMiddleware()
+}
+
+// RecordError 记录错误（全局函数）
+func RecordError(message string, level string) {
+	if globalErrorHandler == nil {
+		InitGlobalErrorHandler(100, 24*time.Hour)
+		return
+	}
+
+	errorInfo := &ErrorInfo{
+		ID:        fmt.Sprintf("%s_%d", level, time.Now().UnixNano()),
+		Timestamp: time.Now(),
+		Message:   message,
+		Level:     level,
+		Count:     1,
+	}
+
+	globalErrorHandler.saveError(errorInfo)
+}

monitor/metrics.go

@@ -0,0 +1,458 @@
+package monitor
+
+import (
+	"fmt"
+	"net/http"
+	"runtime"
+	"sync"
+	"time"
+
+	"github.com/ctwj/urldb/utils"
+	"github.com/gin-gonic/gin"
+	"github.com/prometheus/client_golang/prometheus"
+	"github.com/prometheus/client_golang/prometheus/promauto"
+	"github.com/prometheus/client_golang/prometheus/promhttp"
+)
+
+// Metrics 监控指标
+type Metrics struct {
+	// HTTP请求指标
+	RequestsTotal    *prometheus.CounterVec
+	RequestDuration  *prometheus.HistogramVec
+	RequestSize      *prometheus.SummaryVec
+	ResponseSize     *prometheus.SummaryVec
+
+	// 数据库指标
+	DatabaseQueries  *prometheus.CounterVec
+	DatabaseErrors   *prometheus.CounterVec
+	DatabaseDuration *prometheus.HistogramVec
+
+	// 系统指标
+	MemoryUsage      prometheus.Gauge
+	Goroutines       prometheus.Gauge
+	GCStats          *prometheus.CounterVec
+
+	// 业务指标
+	ResourcesCreated *prometheus.CounterVec
+	ResourcesViewed  *prometheus.CounterVec
+	Searches         *prometheus.CounterVec
+	Transfers        *prometheus.CounterVec
+
+	// 错误指标
+	ErrorsTotal      *prometheus.CounterVec
+
+	// 自定义指标
+	CustomCounters   map[string]prometheus.Counter
+	CustomGauges     map[string]prometheus.Gauge
+	mu               sync.RWMutex
+}
+
+// MetricsConfig 监控配置
+type MetricsConfig struct {
+	Enabled        bool
+	ListenAddress  string
+	MetricsPath    string
+	Namespace      string
+	Subsystem      string
+}
+
+// DefaultMetricsConfig 默认监控配置
+func DefaultMetricsConfig() *MetricsConfig {
+	return &MetricsConfig{
+		Enabled:       true,
+		ListenAddress: ":9090",
+		MetricsPath:   "/metrics",
+		Namespace:     "urldb",
+		Subsystem:     "api",
+	}
+}
+
+// GlobalMetrics 全局监控实例
+var (
+	globalMetrics *Metrics
+	once          sync.Once
+)
+
+// NewMetrics 创建新的监控指标
+func NewMetrics(config *MetricsConfig) *Metrics {
+	if config == nil {
+		config = DefaultMetricsConfig()
+	}
+
+	namespace := config.Namespace
+	subsystem := config.Subsystem
+
+	m := &Metrics{
+		// HTTP请求指标
+		RequestsTotal: promauto.NewCounterVec(
+			prometheus.CounterOpts{
+				Namespace: namespace,
+				Subsystem: subsystem,
+				Name:      "http_requests_total",
+				Help:      "Total number of HTTP requests",
+			},
+			[]string{"method", "endpoint", "status"},
+		),
+		RequestDuration: promauto.NewHistogramVec(
+			prometheus.HistogramOpts{
+				Namespace: namespace,
+				Subsystem: subsystem,
+				Name:      "http_request_duration_seconds",
+				Help:      "HTTP request duration in seconds",
+				Buckets:   prometheus.DefBuckets,
+			},
+			[]string{"method", "endpoint", "status"},
+		),
+		RequestSize: promauto.NewSummaryVec(
+			prometheus.SummaryOpts{
+				Namespace:  namespace,
+				Subsystem:  subsystem,
+				Name:       "http_request_size_bytes",
+				Help:       "HTTP request size in bytes",
+				Objectives: map[float64]float64{0.5: 0.05, 0.9: 0.01, 0.99: 0.001},
+			},
+			[]string{"method", "endpoint"},
+		),
+		ResponseSize: promauto.NewSummaryVec(
+			prometheus.SummaryOpts{
+				Namespace:  namespace,
+				Subsystem:  subsystem,
+				Name:       "http_response_size_bytes",
+				Help:       "HTTP response size in bytes",
+				Objectives: map[float64]float64{0.5: 0.05, 0.9: 0.01, 0.99: 0.001},
+			},
+			[]string{"method", "endpoint"},
+		),
+
+		// 数据库指标
+		DatabaseQueries: promauto.NewCounterVec(
+			prometheus.CounterOpts{
+				Namespace: namespace,
+				Subsystem: "database",
+				Name:      "queries_total",
+				Help:      "Total number of database queries",
+			},
+			[]string{"table", "operation"},
+		),
+		DatabaseErrors: promauto.NewCounterVec(
+			prometheus.CounterOpts{
+				Namespace: namespace,
+				Subsystem: "database",
+				Name:      "errors_total",
+				Help:      "Total number of database errors",
+			},
+			[]string{"table", "operation", "error"},
+		),
+		DatabaseDuration: promauto.NewHistogramVec(
+			prometheus.HistogramOpts{
+				Namespace: namespace,
+				Subsystem: "database",
+				Name:      "query_duration_seconds",
+				Help:      "Database query duration in seconds",
+				Buckets:   prometheus.DefBuckets,
+			},
+			[]string{"table", "operation"},
+		),
+
+		// 系统指标
+		MemoryUsage: promauto.NewGauge(
+			prometheus.GaugeOpts{
+				Namespace: namespace,
+				Subsystem: "system",
+				Name:      "memory_usage_bytes",
+				Help:      "Current memory usage in bytes",
+			},
+		),
+		Goroutines: promauto.NewGauge(
+			prometheus.GaugeOpts{
+				Namespace: namespace,
+				Subsystem: "system",
+				Name:      "goroutines",
+				Help:      "Number of goroutines",
+			},
+		),
+		GCStats: promauto.NewCounterVec(
+			prometheus.CounterOpts{
+				Namespace: namespace,
+				Subsystem: "system",
+				Name:      "gc_stats_total",
+				Help:      "Garbage collection statistics",
+			},
+			[]string{"type"},
+		),
+
+		// 业务指标
+		ResourcesCreated: promauto.NewCounterVec(
+			prometheus.CounterOpts{
+				Namespace: namespace,
+				Subsystem: "business",
+				Name:      "resources_created_total",
+				Help:      "Total number of resources created",
+			},
+			[]string{"category", "platform"},
+		),
+		ResourcesViewed: promauto.NewCounterVec(
+			prometheus.CounterOpts{
+				Namespace: namespace,
+				Subsystem: "business",
+				Name:      "resources_viewed_total",
+				Help:      "Total number of resources viewed",
+			},
+			[]string{"category"},
+		),
+		Searches: promauto.NewCounterVec(
+			prometheus.CounterOpts{
+				Namespace: namespace,
+				Subsystem: "business",
+				Name:      "searches_total",
+				Help:      "Total number of searches",
+			},
+			[]string{"platform"},
+		),
+		Transfers: promauto.NewCounterVec(
+			prometheus.CounterOpts{
+				Namespace: namespace,
+				Subsystem: "business",
+				Name:      "transfers_total",
+				Help:      "Total number of transfers",
+			},
+			[]string{"platform", "status"},
+		),
+
+		// 错误指标
+		ErrorsTotal: promauto.NewCounterVec(
+			prometheus.CounterOpts{
+				Namespace: namespace,
+				Subsystem: "errors",
+				Name:      "total",
+				Help:      "Total number of errors",
+			},
+			[]string{"type", "endpoint"},
+		),
+
+		// 自定义指标
+		CustomCounters: make(map[string]prometheus.Counter),
+		CustomGauges:   make(map[string]prometheus.Gauge),
+	}
+
+	// 启动系统指标收集
+	go m.collectSystemMetrics()
+
+	return m
+}
+
+// GetGlobalMetrics 获取全局监控实例
+func GetGlobalMetrics() *Metrics {
+	once.Do(func() {
+		globalMetrics = NewMetrics(DefaultMetricsConfig())
+	})
+	return globalMetrics
+}
+
+// SetGlobalMetrics 设置全局监控实例
+func SetGlobalMetrics(metrics *Metrics) {
+	globalMetrics = metrics
+}
+
+// collectSystemMetrics 收集系统指标
+func (m *Metrics) collectSystemMetrics() {
+	ticker := time.NewTicker(10 * time.Second)
+	defer ticker.Stop()
+
+	for range ticker.C {
+		// 收集内存使用情况
+		var ms runtime.MemStats
+		runtime.ReadMemStats(&ms)
+		m.MemoryUsage.Set(float64(ms.Alloc))
+
+		// 收集goroutine数量
+		m.Goroutines.Set(float64(runtime.NumGoroutine()))
+
+		// 收集GC统计
+		m.GCStats.WithLabelValues("alloc").Add(float64(ms.TotalAlloc))
+		m.GCStats.WithLabelValues("sys").Add(float64(ms.Sys))
+		m.GCStats.WithLabelValues("lookups").Add(float64(ms.Lookups))
+		m.GCStats.WithLabelValues("mallocs").Add(float64(ms.Mallocs))
+		m.GCStats.WithLabelValues("frees").Add(float64(ms.Frees))
+	}
+}
+
+// MetricsMiddleware 监控中间件
+func (m *Metrics) MetricsMiddleware() gin.HandlerFunc {
+	return func(c *gin.Context) {
+		start := time.Now()
+		path := c.FullPath()
+
+		// 如果没有匹配的路由，使用请求路径
+		if path == "" {
+			path = c.Request.URL.Path
+		}
+
+		// 记录请求大小
+		requestSize := float64(c.Request.ContentLength)
+		m.RequestSize.WithLabelValues(c.Request.Method, path).Observe(requestSize)
+
+		c.Next()
+
+		// 记录响应信息
+		status := c.Writer.Status()
+		latency := time.Since(start).Seconds()
+		responseSize := float64(c.Writer.Size())
+
+		// 更新指标
+		m.RequestsTotal.WithLabelValues(c.Request.Method, path, fmt.Sprintf("%d", status)).Inc()
+		m.RequestDuration.WithLabelValues(c.Request.Method, path, fmt.Sprintf("%d", status)).Observe(latency)
+		m.ResponseSize.WithLabelValues(c.Request.Method, path).Observe(responseSize)
+
+		// 如果是错误状态码，记录错误
+		if status >= 400 {
+			m.ErrorsTotal.WithLabelValues("http", path).Inc()
+		}
+	}
+}
+
+// StartMetricsServer 启动监控服务器
+func (m *Metrics) StartMetricsServer(config *MetricsConfig) {
+	if config == nil {
+		config = DefaultMetricsConfig()
+	}
+
+	if !config.Enabled {
+		utils.Info("监控服务器未启用")
+		return
+	}
+
+	// 创建新的Gin路由器
+	router := gin.New()
+	router.Use(gin.Recovery())
+
+	// 注册Prometheus指标端点
+	router.GET(config.MetricsPath, gin.WrapH(promhttp.Handler()))
+
+	// 启动HTTP服务器
+	go func() {
+		utils.Info("监控服务器启动在 %s", config.ListenAddress)
+		if err := router.Run(config.ListenAddress); err != nil {
+			utils.Error("监控服务器启动失败: %v", err)
+		}
+	}()
+
+	utils.Info("监控服务器已启动，指标路径: %s%s", config.ListenAddress, config.MetricsPath)
+}
+
+// IncrementDatabaseQuery 增加数据库查询计数
+func (m *Metrics) IncrementDatabaseQuery(table, operation string) {
+	m.DatabaseQueries.WithLabelValues(table, operation).Inc()
+}
+
+// IncrementDatabaseError 增加数据库错误计数
+func (m *Metrics) IncrementDatabaseError(table, operation, error string) {
+	m.DatabaseErrors.WithLabelValues(table, operation, error).Inc()
+}
+
+// ObserveDatabaseDuration 记录数据库查询耗时
+func (m *Metrics) ObserveDatabaseDuration(table, operation string, duration float64) {
+	m.DatabaseDuration.WithLabelValues(table, operation).Observe(duration)
+}
+
+// IncrementResourceCreated 增加资源创建计数
+func (m *Metrics) IncrementResourceCreated(category, platform string) {
+	m.ResourcesCreated.WithLabelValues(category, platform).Inc()
+}
+
+// IncrementResourceViewed 增加资源查看计数
+func (m *Metrics) IncrementResourceViewed(category string) {
+	m.ResourcesViewed.WithLabelValues(category).Inc()
+}
+
+// IncrementSearch 增加搜索计数
+func (m *Metrics) IncrementSearch(platform string) {
+	m.Searches.WithLabelValues(platform).Inc()
+}
+
+// IncrementTransfer 增加转存计数
+func (m *Metrics) IncrementTransfer(platform, status string) {
+	m.Transfers.WithLabelValues(platform, status).Inc()
+}
+
+// IncrementError 增加错误计数
+func (m *Metrics) IncrementError(errorType, endpoint string) {
+	m.ErrorsTotal.WithLabelValues(errorType, endpoint).Inc()
+}
+
+// AddCustomCounter 添加自定义计数器
+func (m *Metrics) AddCustomCounter(name, help string, labels []string) prometheus.Counter {
+	m.mu.Lock()
+	defer m.mu.Unlock()
+
+	key := fmt.Sprintf("%s_%v", name, labels)
+	if counter, exists := m.CustomCounters[key]; exists {
+		return counter
+	}
+
+	counter := promauto.NewCounterVec(
+		prometheus.CounterOpts{
+			Namespace: "urldb",
+			Name:      name,
+			Help:      help,
+		},
+		labels,
+	).WithLabelValues() // 如果没有标签，返回默认实例
+
+	m.CustomCounters[key] = counter
+	return counter
+}
+
+// AddCustomGauge 添加自定义仪表盘
+func (m *Metrics) AddCustomGauge(name, help string, labels []string) prometheus.Gauge {
+	m.mu.Lock()
+	defer m.mu.Unlock()
+
+	key := fmt.Sprintf("%s_%v", name, labels)
+	if gauge, exists := m.CustomGauges[key]; exists {
+		return gauge
+	}
+
+	gauge := promauto.NewGaugeVec(
+		prometheus.GaugeOpts{
+			Namespace: "urldb",
+			Name:      name,
+			Help:      help,
+		},
+		labels,
+	).WithLabelValues() // 如果没有标签，返回默认实例
+
+	m.CustomGauges[key] = gauge
+	return gauge
+}
+
+// GetMetricsSummary 获取指标摘要
+func (m *Metrics) GetMetricsSummary() map[string]interface{} {
+	// 这里可以实现获取当前指标摘要的逻辑
+	// 由于Prometheus指标不能直接读取，我们只能返回一些基本的统计信息
+	return map[string]interface{}{
+		"timestamp": time.Now(),
+		"status":    "running",
+		"info":      "使用 /metrics 端点获取详细指标",
+	}
+}
+
+// HealthCheck 健康检查
+func (m *Metrics) HealthCheck(c *gin.Context) {
+	c.JSON(http.StatusOK, gin.H{
+		"status":    "healthy",
+		"timestamp": time.Now().Unix(),
+		"version":   "1.0.0",
+	})
+}
+
+// SetupHealthCheck 设置健康检查端点
+func (m *Metrics) SetupHealthCheck(router *gin.Engine) {
+	router.GET("/health", m.HealthCheck)
+	router.GET("/healthz", m.HealthCheck)
+}
+
+// MetricsHandler 指标处理器
+func (m *Metrics) MetricsHandler() gin.HandlerFunc {
+	return gin.WrapH(promhttp.Handler())
+}

monitor/setup.go

@@ -0,0 +1,25 @@
+package monitor
+
+import (
+	"github.com/ctwj/urldb/utils"
+	"github.com/gin-gonic/gin"
+)
+
+// SetupMonitoring 设置完整的监控系统
+func SetupMonitoring(router *gin.Engine) {
+	// 获取全局监控实例
+	metrics := GetGlobalMetrics()
+
+	// 设置健康检查端点
+	metrics.SetupHealthCheck(router)
+
+	// 设置指标端点
+	router.GET("/metrics", metrics.MetricsHandler())
+
+	utils.Info("监控系统已设置完成")
+}
+
+// SetGlobalErrorHandler 设置全局错误处理器
+func SetGlobalErrorHandler(eh *ErrorHandler) {
+	globalErrorHandler = eh
+}

nginx/conf.d/default.conf

@@ -60,17 +60,38 @@ server {
         proxy_set_header X-Real-IP $remote_addr;
         proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
         proxy_set_header X-Forwarded-Proto $scheme;
-        
+
         # 缓存设置
         expires 1y;
         add_header Cache-Control "public, immutable";
-        
+
         # 允许跨域访问
         add_header Access-Control-Allow-Origin "*";
         add_header Access-Control-Allow-Methods "GET, OPTIONS";
         add_header Access-Control-Allow-Headers "Origin, Content-Type, Accept";
     }
 
+    # 微信公众号验证文件路由 - 根目录的TXT文件直接访问后端uploads目录
+    location ~ ^/[^/]+\.txt$ {
+        # 检查文件是否存在于uploads目录
+        set $uploads_path /uploads$uri;
+        if (-f $uploads_path) {
+            proxy_pass http://backend;
+
+            # 缓存设置
+            expires 1h;
+            add_header Cache-Control "public";
+
+            # 允许跨域访问
+            add_header Access-Control-Allow-Origin "*";
+            add_header Access-Control-Allow-Methods "GET, OPTIONS";
+            add_header Access-Control-Allow-Headers "Origin, Content-Type, Accept";
+            break;
+        }
+        # 如果文件不存在，返回404
+        return 404;
+    }
+
     # 健康检查
     location /health {
         proxy_pass http://backend/health;

scheduler/cache_cleaner.go

@@ -0,0 +1,96 @@
+package scheduler
+
+import (
+	"time"
+	"github.com/ctwj/urldb/utils"
+)
+
+// CacheCleaner 缓存清理调度器
+type CacheCleaner struct {
+	baseScheduler *BaseScheduler
+	running       bool
+	ticker        *time.Ticker
+	stopChan      chan bool
+}
+
+// NewCacheCleaner 创建缓存清理调度器
+func NewCacheCleaner(baseScheduler *BaseScheduler) *CacheCleaner {
+	return &CacheCleaner{
+		baseScheduler: baseScheduler,
+		running:       false,
+		ticker:        time.NewTicker(time.Hour), // 每小时执行一次
+		stopChan:      make(chan bool),
+	}
+}
+
+// Start 启动缓存清理任务
+func (cc *CacheCleaner) Start() {
+	if cc.running {
+		utils.Warn("缓存清理任务已在运行中")
+		return
+	}
+
+	cc.running = true
+	utils.Info("启动缓存清理任务")
+
+	go func() {
+		for {
+			select {
+			case <-cc.ticker.C:
+				cc.cleanCache()
+			case <-cc.stopChan:
+				cc.running = false
+				utils.Info("缓存清理任务已停止")
+				return
+			}
+		}
+	}()
+}
+
+// Stop 停止缓存清理任务
+func (cc *CacheCleaner) Stop() {
+	if !cc.running {
+		return
+	}
+
+	close(cc.stopChan)
+	cc.ticker.Stop()
+}
+
+// cleanCache 执行缓存清理
+func (cc *CacheCleaner) cleanCache() {
+	utils.Debug("开始清理过期缓存")
+
+	// 清理过期缓存（1小时TTL）
+	utils.CleanAllExpiredCaches(time.Hour)
+	utils.Debug("定期清理过期缓存完成")
+
+	// 可以在这里添加其他缓存清理逻辑，比如：
+	// - 清理特定模式的缓存
+	// - 记录缓存统计信息
+	cc.logCacheStats()
+}
+
+// logCacheStats 记录缓存统计信息
+func (cc *CacheCleaner) logCacheStats() {
+	hotCacheSize := utils.GetHotResourcesCache().Size()
+	relatedCacheSize := utils.GetRelatedResourcesCache().Size()
+	systemConfigSize := utils.GetSystemConfigCache().Size()
+	categoriesSize := utils.GetCategoriesCache().Size()
+	tagsSize := utils.GetTagsCache().Size()
+
+	totalSize := hotCacheSize + relatedCacheSize + systemConfigSize + categoriesSize + tagsSize
+
+	utils.Debug("缓存统计 - 热门资源: %d, 相关资源: %d, 系统配置: %d, 分类: %d, 标签: %d, 总计: %d",
+		hotCacheSize, relatedCacheSize, systemConfigSize, categoriesSize, tagsSize, totalSize)
+
+	// 如果缓存过多，可以记录警告
+	if totalSize > 1000 {
+		utils.Warn("缓存项数量过多: %d，建议检查缓存策略", totalSize)
+	}
+}
+
+// IsRunning 检查是否正在运行
+func (cc *CacheCleaner) IsRunning() bool {
+	return cc.running
+}

services/base.go

@@ -0,0 +1,102 @@
+package services
+
+import (
+	"github.com/ctwj/urldb/db/entity"
+	"github.com/ctwj/urldb/db/repo"
+	"github.com/ctwj/urldb/utils"
+)
+
+var repoManager *repo.RepositoryManager
+var meilisearchManager *MeilisearchManager
+
+// SetRepositoryManager 设置Repository管理器
+func SetRepositoryManager(manager *repo.RepositoryManager) {
+	repoManager = manager
+}
+
+// SetMeilisearchManager 设置Meilisearch管理器
+func SetMeilisearchManager(manager *MeilisearchManager) {
+	meilisearchManager = manager
+}
+
+// UnifiedSearchResources 执行统一搜索（优先使用Meilisearch，否则使用数据库搜索）并处理违禁词
+func UnifiedSearchResources(keyword string, limit int, systemConfigRepo repo.SystemConfigRepository, resourceRepo repo.ResourceRepository) ([]entity.Resource, error) {
+	var resources []entity.Resource
+	var total int64
+	var err error
+
+	// 如果启用了Meilisearch，优先使用Meilisearch搜索
+	if meilisearchManager != nil && meilisearchManager.IsEnabled() {
+		// 构建MeiliSearch过滤器
+		filters := make(map[string]interface{})
+
+		// 使用Meilisearch搜索
+		service := meilisearchManager.GetService()
+		if service != nil {
+			docs, docTotal, err := service.Search(keyword, filters, 1, limit)
+			if err == nil {
+				// 将Meilisearch文档转换为Resource实体
+				for _, doc := range docs {
+					resource := entity.Resource{
+						ID:          doc.ID,
+						Title:       doc.Title,
+						Description: doc.Description,
+						URL:         doc.URL,
+						SaveURL:     doc.SaveURL,
+						FileSize:    doc.FileSize,
+						Key:         doc.Key,
+						PanID:       doc.PanID,
+						CreatedAt:   doc.CreatedAt,
+						UpdatedAt:   doc.UpdatedAt,
+					}
+					resources = append(resources, resource)
+				}
+				total = docTotal
+
+				// 获取违禁词配置并处理违禁词
+				cleanWords, err := utils.GetForbiddenWordsFromConfig(func() (string, error) {
+					return systemConfigRepo.GetConfigValue(entity.ConfigKeyForbiddenWords)
+				})
+				if err != nil {
+					utils.Error("获取违禁词配置失败: %v", err)
+					cleanWords = []string{} // 如果获取失败，使用空列表
+				}
+
+				// 处理违禁词替换
+				if len(cleanWords) > 0 {
+					resources = utils.ProcessResourcesForbiddenWords(resources, cleanWords)
+				}
+
+				return resources, nil
+			} else {
+				utils.Error("MeiliSearch搜索失败，回退到数据库搜索: %v", err)
+			}
+		}
+	}
+
+	// 如果MeiliSearch未启用、搜索失败或没有搜索关键词，使用数据库搜索
+	resources, total, err = resourceRepo.Search(keyword, nil, 1, limit)
+	if err != nil {
+		return nil, err
+	}
+
+	if total == 0 {
+		return []entity.Resource{}, nil
+	}
+
+	// 获取违禁词配置并处理违禁词
+	cleanWords, err := utils.GetForbiddenWordsFromConfig(func() (string, error) {
+		return systemConfigRepo.GetConfigValue(entity.ConfigKeyForbiddenWords)
+	})
+	if err != nil {
+		utils.Error("获取违禁词配置失败: %v", err)
+		cleanWords = []string{} // 如果获取失败，使用空列表
+	}
+
+	// 处理违禁词替换
+	if len(cleanWords) > 0 {
+		resources = utils.ProcessResourcesForbiddenWords(resources, cleanWords)
+	}
+
+	return resources, nil
+}

services/meilisearch_manager.go

@@ -240,8 +240,33 @@ func (m *MeilisearchManager) SyncResourceToMeilisearch(resource *entity.Resource
 		return fmt.Errorf("创建Meilisearch索引失败: %v", err)
 	}
 
-	doc := m.convertResourceToDocument(resource)
-	err := m.service.BatchAddDocuments([]MeilisearchDocument{doc})
+	// 重新加载资源及其关联数据，确保Tags被正确加载
+	resourcesWithRelations, err := m.repoMgr.ResourceRepository.FindByIDs([]uint{resource.ID})
+	if err != nil {
+		utils.Error(fmt.Sprintf("重新加载资源失败: %v", err))
+		return fmt.Errorf("重新加载资源失败: %v", err)
+	}
+
+	if len(resourcesWithRelations) == 0 {
+		utils.Error(fmt.Sprintf("资源未找到: %d", resource.ID))
+		return fmt.Errorf("资源未找到: %d", resource.ID)
+	}
+
+	resourceWithRelations := resourcesWithRelations[0]
+	doc := m.convertResourceToDocument(&resourceWithRelations)
+
+	// 添加调试日志，记录标签数量
+	utils.Debug(fmt.Sprintf("资源ID %d 的标签数量: %d", resource.ID, len(resourceWithRelations.Tags)))
+	for i, tag := range resourceWithRelations.Tags {
+		utils.Debug(fmt.Sprintf("  标签 %d: ID=%d, Name=%s", i+1, tag.ID, tag.Name))
+	}
+
+	// 验证转换后的文档
+	utils.Debug(fmt.Sprintf("转换后的文档标签数量: %d", len(doc.Tags)))
+	if len(doc.Tags) > 0 {
+		utils.Debug(fmt.Sprintf("转换后的文档标签内容: %v", doc.Tags))
+	}
+	err = m.service.BatchAddDocuments([]MeilisearchDocument{doc})
 	if err != nil {
 		return err
 	}
@@ -410,11 +435,14 @@ func (m *MeilisearchManager) syncAllResourcesInternal() {
 			default:
 			}
 
-			// 转换为Meilisearch文档（使用缓存）
+			// 转换为Meilisearch文档（确保Tags被正确加载）
 			var docs []MeilisearchDocument
 			for _, resource := range resources {
+				utils.Debug(fmt.Sprintf("批量同步开始处理资源 %d，标签数量: %d", resource.ID, len(resource.Tags)))
+				// 使用带缓存的转换方法，但传入的资源已经预加载了Tags数据
 				doc := m.convertResourceToDocumentWithCache(&resource, categoryCache, panCache)
 				docs = append(docs, doc)
+				utils.Debug(fmt.Sprintf("批量同步资源 %d 处理完成，最终标签数量: %d", resource.ID, len(doc.Tags)))
 			}
 
 			// 检查是否需要停止
@@ -636,12 +664,22 @@ func (m *MeilisearchManager) convertResourceToDocument(resource *entity.Resource
 
 	// 获取标签 - 从关联的Tags字段获取
 	var tagNames []string
-	if resource.Tags != nil {
-		for _, tag := range resource.Tags {
-			tagNames = append(tagNames, tag.Name)
+	if len(resource.Tags) > 0 {
+		utils.Debug(fmt.Sprintf("处理资源 %d 的 %d 个标签", resource.ID, len(resource.Tags)))
+		for i, tag := range resource.Tags {
+			if tag.Name != "" {
+				utils.Debug(fmt.Sprintf("标签 %d: ID=%d, Name='%s'", i+1, tag.ID, tag.Name))
+				tagNames = append(tagNames, tag.Name)
+			} else {
+				utils.Debug(fmt.Sprintf("标签 %d: ID=%d, Name为空，跳过", i+1, tag.ID))
+			}
 		}
+	} else {
+		utils.Debug(fmt.Sprintf("资源 %d 没有关联的标签", resource.ID))
 	}
 
+	utils.Debug(fmt.Sprintf("资源 %d 最终标签数量: %d", resource.ID, len(tagNames)))
+
 	return MeilisearchDocument{
 		ID:          resource.ID,
 		Title:       resource.Title,
@@ -655,6 +693,7 @@ func (m *MeilisearchManager) convertResourceToDocument(resource *entity.Resource
 		PanName:     panName,
 		PanID:       resource.PanID,
 		Author:      resource.Author,
+		Cover:       resource.Cover,
 		CreatedAt:   resource.CreatedAt,
 		UpdatedAt:   resource.UpdatedAt,
 	}
@@ -679,12 +718,22 @@ func (m *MeilisearchManager) convertResourceToDocumentWithCache(resource *entity
 
 	// 获取标签 - 从关联的Tags字段获取
 	var tagNames []string
-	if resource.Tags != nil {
-		for _, tag := range resource.Tags {
-			tagNames = append(tagNames, tag.Name)
+	if len(resource.Tags) > 0 {
+		utils.Debug(fmt.Sprintf("批量同步处理资源 %d 的 %d 个标签", resource.ID, len(resource.Tags)))
+		for i, tag := range resource.Tags {
+			if tag.Name != "" {
+				utils.Debug(fmt.Sprintf("批量同步标签 %d: ID=%d, Name='%s'", i+1, tag.ID, tag.Name))
+				tagNames = append(tagNames, tag.Name)
+			} else {
+				utils.Debug(fmt.Sprintf("批量同步标签 %d: ID=%d, Name为空，跳过", i+1, tag.ID))
+			}
 		}
+	} else {
+		utils.Debug(fmt.Sprintf("批量同步资源 %d 没有关联的标签", resource.ID))
 	}
 
+	utils.Debug(fmt.Sprintf("批量同步资源 %d 最终标签数量: %d", resource.ID, len(tagNames)))
+
 	return MeilisearchDocument{
 		ID:          resource.ID,
 		Title:       resource.Title,
@@ -698,6 +747,7 @@ func (m *MeilisearchManager) convertResourceToDocumentWithCache(resource *entity
 		PanName:     panName,
 		PanID:       resource.PanID,
 		Author:      resource.Author,
+		Cover:       resource.Cover,
 		CreatedAt:   resource.CreatedAt,
 		UpdatedAt:   resource.UpdatedAt,
 	}

services/meilisearch_service.go

@@ -24,6 +24,7 @@ type MeilisearchDocument struct {
 	PanName     string    `json:"pan_name"`
 	PanID       *uint     `json:"pan_id"`
 	Author      string    `json:"author"`
+	Cover       string    `json:"cover"`
 	CreatedAt   time.Time `json:"created_at"`
 	UpdatedAt   time.Time `json:"updated_at"`
 	// 高亮字段
@@ -212,7 +213,10 @@ func (m *MeilisearchService) BatchAddDocuments(docs []MeilisearchDocument) error
 	// 转换为interface{}切片
 	var documents []interface{}
 	for i, doc := range docs {
-		utils.Debug(fmt.Sprintf("转换文档 %d - ID: %d, 标题: %s", i+1, doc.ID, doc.Title))
+		utils.Debug(fmt.Sprintf("转换文档 %d - ID: %d, 标题: %s, 标签数量: %d", i+1, doc.ID, doc.Title, len(doc.Tags)))
+		if len(doc.Tags) > 0 {
+			utils.Debug(fmt.Sprintf("文档 %d 的标签: %v", i+1, doc.Tags))
+		}
 		documents = append(documents, doc)
 	}
 
@@ -413,6 +417,13 @@ func (m *MeilisearchService) Search(query string, filters map[string]interface{}
 							doc.Author = author
 						}
 					}
+				case "cover":
+					if rawCover, ok := value.(json.RawMessage); ok {
+						var cover string
+						if err := json.Unmarshal(rawCover, &cover); err == nil {
+							doc.Cover = cover
+						}
+					}
 				case "created_at":
 					if rawCreatedAt, ok := value.(json.RawMessage); ok {
 						var createdAt string
@@ -544,6 +555,25 @@ func (m *MeilisearchService) GetIndexStats() (map[string]interface{}, error) {
 	return result, nil
 }
 
+// DeleteDocument 删除单个文档
+func (m *MeilisearchService) DeleteDocument(documentID uint) error {
+	if !m.enabled {
+		return fmt.Errorf("Meilisearch未启用")
+	}
+
+	utils.Debug("开始删除Meilisearch文档 - ID: %d", documentID)
+
+	// 删除单个文档
+	documentIDStr := fmt.Sprintf("%d", documentID)
+	_, err := m.index.DeleteDocument(documentIDStr)
+	if err != nil {
+		return fmt.Errorf("删除Meilisearch文档失败: %v", err)
+	}
+
+	utils.Debug("成功删除Meilisearch文档 - ID: %d", documentID)
+	return nil
+}
+
 // ClearIndex 清空索引
 func (m *MeilisearchService) ClearIndex() error {
 	if !m.enabled {

services/search_session.go

@@ -0,0 +1,231 @@
+package services
+
+import (
+	"sync"
+	"time"
+
+	"github.com/ctwj/urldb/db/entity"
+)
+
+// SearchSession 搜索会话
+type SearchSession struct {
+	UserID      string              // 用户ID
+	Keyword     string              // 搜索关键字
+	Resources   []entity.Resource   // 搜索结果
+	PageSize    int                 // 每页数量
+	CurrentPage int                 // 当前页码
+	TotalPages  int                 // 总页数
+	LastAccess  time.Time           // 最后访问时间
+}
+
+// SearchSessionManager 搜索会话管理器
+type SearchSessionManager struct {
+	sessions map[string]*SearchSession  // 用户ID -> 搜索会话
+	mutex    sync.RWMutex
+}
+
+// NewSearchSessionManager 创建搜索会话管理器
+func NewSearchSessionManager() *SearchSessionManager {
+	manager := &SearchSessionManager{
+		sessions: make(map[string]*SearchSession),
+	}
+
+	// 启动清理过期会话的goroutine
+	go manager.cleanupExpiredSessions()
+
+	return manager
+}
+
+// CreateSession 创建或更新搜索会话
+func (m *SearchSessionManager) CreateSession(userID, keyword string, resources []entity.Resource, pageSize int) *SearchSession {
+	m.mutex.Lock()
+	defer m.mutex.Unlock()
+
+	session := &SearchSession{
+		UserID:      userID,
+		Keyword:     keyword,
+		Resources:   resources,
+		PageSize:    pageSize,
+		CurrentPage: 1,
+		TotalPages:  (len(resources) + pageSize - 1) / pageSize,
+		LastAccess:  time.Now(),
+	}
+
+	m.sessions[userID] = session
+	return session
+}
+
+// GetSession 获取搜索会话
+func (m *SearchSessionManager) GetSession(userID string) *SearchSession {
+	m.mutex.RLock()
+	defer m.mutex.RUnlock()
+
+	session, exists := m.sessions[userID]
+	if !exists {
+		return nil
+	}
+
+	// 更新最后访问时间
+	m.mutex.RUnlock()
+	m.mutex.Lock()
+	session.LastAccess = time.Now()
+	m.mutex.Unlock()
+	m.mutex.RLock()
+
+	return session
+}
+
+// SetCurrentPage 设置当前页
+func (m *SearchSessionManager) SetCurrentPage(userID string, page int) bool {
+	m.mutex.Lock()
+	defer m.mutex.Unlock()
+
+	session, exists := m.sessions[userID]
+	if !exists {
+		return false
+	}
+
+	if page < 1 || page > session.TotalPages {
+		return false
+	}
+
+	session.CurrentPage = page
+	session.LastAccess = time.Now()
+	return true
+}
+
+// GetPageResources 获取指定页的资源
+func (m *SearchSessionManager) GetPageResources(userID string, page int) []entity.Resource {
+	m.mutex.RLock()
+	session, exists := m.sessions[userID]
+	m.mutex.RUnlock()
+
+	if !exists {
+		return nil
+	}
+
+	if page < 1 || page > session.TotalPages {
+		return nil
+	}
+
+	start := (page - 1) * session.PageSize
+	end := start + session.PageSize
+	if end > len(session.Resources) {
+		end = len(session.Resources)
+	}
+
+	// 更新当前页和最后访问时间
+	m.mutex.Lock()
+	session.CurrentPage = page
+	session.LastAccess = time.Now()
+	m.mutex.Unlock()
+
+	return session.Resources[start:end]
+}
+
+// GetCurrentPageResources 获取当前页的资源
+func (m *SearchSessionManager) GetCurrentPageResources(userID string) []entity.Resource {
+	m.mutex.RLock()
+	session, exists := m.sessions[userID]
+	m.mutex.RUnlock()
+
+	if !exists {
+		return nil
+	}
+
+	return m.GetPageResources(userID, session.CurrentPage)
+}
+
+// HasNextPage 是否有下一页
+func (m *SearchSessionManager) HasNextPage(userID string) bool {
+	m.mutex.RLock()
+	defer m.mutex.RUnlock()
+
+	session, exists := m.sessions[userID]
+	if !exists {
+		return false
+	}
+
+	return session.CurrentPage < session.TotalPages
+}
+
+// HasPrevPage 是否有上一页
+func (m *SearchSessionManager) HasPrevPage(userID string) bool {
+	m.mutex.RLock()
+	defer m.mutex.RUnlock()
+
+	session, exists := m.sessions[userID]
+	if !exists {
+		return false
+	}
+
+	return session.CurrentPage > 1
+}
+
+// NextPage 下一页
+func (m *SearchSessionManager) NextPage(userID string) []entity.Resource {
+	m.mutex.Lock()
+	session, exists := m.sessions[userID]
+	m.mutex.Unlock()
+
+	if !exists {
+		return nil
+	}
+
+	if session.CurrentPage >= session.TotalPages {
+		return nil
+	}
+
+	return m.GetPageResources(userID, session.CurrentPage+1)
+}
+
+// PrevPage 上一页
+func (m *SearchSessionManager) PrevPage(userID string) []entity.Resource {
+	m.mutex.Lock()
+	session, exists := m.sessions[userID]
+	m.mutex.Unlock()
+
+	if !exists {
+		return nil
+	}
+
+	if session.CurrentPage <= 1 {
+		return nil
+	}
+
+	return m.GetPageResources(userID, session.CurrentPage-1)
+}
+
+// GetPageInfo 获取分页信息
+func (m *SearchSessionManager) GetPageInfo(userID string) (currentPage, totalPages int, hasPrev, hasNext bool) {
+	m.mutex.RLock()
+	defer m.mutex.RUnlock()
+
+	session, exists := m.sessions[userID]
+	if !exists {
+		return 0, 0, false, false
+	}
+
+	return session.CurrentPage, session.TotalPages, session.CurrentPage > 1, session.CurrentPage < session.TotalPages
+}
+
+// cleanupExpiredSessions 清理过期会话（超过1小时未访问）
+func (m *SearchSessionManager) cleanupExpiredSessions() {
+	ticker := time.NewTicker(10 * time.Minute)
+	defer ticker.Stop()
+
+	for range ticker.C {
+		m.mutex.Lock()
+		now := time.Now()
+		for userID, session := range m.sessions {
+			// 如果超过1小时未访问，清理该会话
+			if now.Sub(session.LastAccess) > time.Hour {
+				delete(m.sessions, userID)
+			}
+		}
+		m.mutex.Unlock()
+	}
+}
+
+// GlobalSearchSessionManager 全局搜索会话管理器
+var GlobalSearchSessionManager = NewSearchSessionManager()

services/telegram_bot_service.go

@@ -5,9 +5,12 @@ import (
 	"fmt"
 	"net/http"
 	"net/url"
+	"os"
+	"path/filepath"
 	"regexp"
 	"strconv"
 	"strings"
+	"sync"
 	"time"
 
 	"github.com/ctwj/urldb/db/entity"
@@ -47,6 +50,9 @@ type TelegramBotServiceImpl struct {
 	readyRepo        repo.ReadyResourceRepository
 	cronScheduler    *cron.Cron
 	config           *TelegramBotConfig
+	pushHistory      map[int64][]uint // 每个频道的推送历史记录，最多100条
+	mu               sync.RWMutex     // 用于保护pushHistory的读写锁
+	stopChan         chan struct{}    // 用于停止消息循环的channel
 }
 
 type TelegramBotConfig struct {
@@ -78,6 +84,8 @@ func NewTelegramBotService(
 		readyRepo:        readyResourceRepo,
 		cronScheduler:    cron.New(),
 		config:           &TelegramBotConfig{},
+		pushHistory:      make(map[int64][]uint),
+		stopChan:         make(chan struct{}),
 	}
 }
 
@@ -105,74 +113,90 @@ func (s *TelegramBotServiceImpl) loadConfig() error {
 	s.config.ProxyUsername = ""
 	s.config.ProxyPassword = ""
 
+	// 统计配置项数量，用于汇总日志
+	configCount := 0
+
 	for _, config := range configs {
 		switch config.Key {
 		case entity.ConfigKeyTelegramBotEnabled:
 			s.config.Enabled = config.Value == "true"
-			utils.Info("[TELEGRAM:CONFIG] 加载配置 %s = %s (Enabled: %v)", config.Key, config.Value, s.config.Enabled)
 		case entity.ConfigKeyTelegramBotApiKey:
 			s.config.ApiKey = config.Value
-			utils.Info("[TELEGRAM:CONFIG] 加载配置 %s = [HIDDEN]", config.Key)
 		case entity.ConfigKeyTelegramAutoReplyEnabled:
 			s.config.AutoReplyEnabled = config.Value == "true"
-			utils.Info("[TELEGRAM:CONFIG] 加载配置 %s = %s (AutoReplyEnabled: %v)", config.Key, config.Value, s.config.AutoReplyEnabled)
 		case entity.ConfigKeyTelegramAutoReplyTemplate:
 			if config.Value != "" {
 				s.config.AutoReplyTemplate = config.Value
 			}
-			utils.Info("[TELEGRAM:CONFIG] 加载配置 %s = %s", config.Key, config.Value)
 		case entity.ConfigKeyTelegramAutoDeleteEnabled:
 			s.config.AutoDeleteEnabled = config.Value == "true"
-			utils.Info("[TELEGRAM:CONFIG] 加载配置 %s = %s (AutoDeleteEnabled: %v)", config.Key, config.Value, s.config.AutoDeleteEnabled)
 		case entity.ConfigKeyTelegramAutoDeleteInterval:
 			if config.Value != "" {
 				fmt.Sscanf(config.Value, "%d", &s.config.AutoDeleteInterval)
 			}
-			utils.Info("[TELEGRAM:CONFIG] 加载配置 %s = %s (AutoDeleteInterval: %d)", config.Key, config.Value, s.config.AutoDeleteInterval)
 		case entity.ConfigKeyTelegramProxyEnabled:
 			s.config.ProxyEnabled = config.Value == "true"
-			utils.Info("[TELEGRAM:CONFIG] 加载配置 %s = %s (ProxyEnabled: %v)", config.Key, config.Value, s.config.ProxyEnabled)
 		case entity.ConfigKeyTelegramProxyType:
 			s.config.ProxyType = config.Value
-			utils.Info("[TELEGRAM:CONFIG] 加载配置 %s = %s (ProxyType: %s)", config.Key, config.Value, s.config.ProxyType)
 		case entity.ConfigKeyTelegramProxyHost:
 			s.config.ProxyHost = config.Value
-			utils.Info("[TELEGRAM:CONFIG] 加载配置 %s = %s", config.Key, "[HIDDEN]")
 		case entity.ConfigKeyTelegramProxyPort:
 			if config.Value != "" {
 				fmt.Sscanf(config.Value, "%d", &s.config.ProxyPort)
 			}
-			utils.Info("[TELEGRAM:CONFIG] 加载配置 %s = %s (ProxyPort: %d)", config.Key, config.Value, s.config.ProxyPort)
 		case entity.ConfigKeyTelegramProxyUsername:
 			s.config.ProxyUsername = config.Value
-			utils.Info("[TELEGRAM:CONFIG] 加载配置 %s = %s", config.Key, "[HIDDEN]")
 		case entity.ConfigKeyTelegramProxyPassword:
 			s.config.ProxyPassword = config.Value
-			utils.Info("[TELEGRAM:CONFIG] 加载配置 %s = %s", config.Key, "[HIDDEN]")
 		default:
-			utils.Debug("未知配置: %s = %s", config.Key, config.Value)
+			utils.Debug("未知Telegram配置: %s", config.Key)
 		}
+		configCount++
 	}
 
-	utils.Info("[TELEGRAM:SERVICE] Telegram Bot 配置加载完成: Enabled=%v, AutoReplyEnabled=%v, ApiKey长度=%d",
-		s.config.Enabled, s.config.AutoReplyEnabled, len(s.config.ApiKey))
+	// 汇总输出配置加载结果，避免逐项日志
+	proxyStatus := "禁用"
+	if s.config.ProxyEnabled {
+		proxyStatus = "启用"
+	}
+
+	utils.TelegramInfo("配置加载完成 - Bot启用: %v, 自动回复: %v, 代理: %s, 配置项数: %d",
+		s.config.Enabled, s.config.AutoReplyEnabled, proxyStatus, configCount)
 	return nil
 }
 
 // Start 启动机器人服务
 func (s *TelegramBotServiceImpl) Start() error {
-	if s.isRunning {
+	// 确保机器人完全停止状态
+	if s.isRunning && s.bot != nil {
 		utils.Info("[TELEGRAM:SERVICE] Telegram Bot 服务已经在运行中")
 		return nil
 	}
 
+	// 如果isRunning为true但bot为nil，说明状态不一致，需要清理
+	if s.isRunning && s.bot == nil {
+		utils.Info("[TELEGRAM:SERVICE] 检测到不一致状态，清理残留资源")
+		s.isRunning = false
+	}
+
 	// 加载配置
 	if err := s.loadConfig(); err != nil {
 		return fmt.Errorf("加载配置失败: %v", err)
 	}
 
+	// 加载推送历史记录
+	if err := s.loadPushHistory(); err != nil {
+		utils.Error("[TELEGRAM:SERVICE] 加载推送历史记录失败: %v", err)
+		// 不返回错误，继续启动服务
+	}
+
 	if !s.config.Enabled || s.config.ApiKey == "" {
 		utils.Info("[TELEGRAM:SERVICE] Telegram Bot 未启用或 API Key 未配置")
+		// 如果机器人当前正在运行，需要停止它
+		if s.isRunning {
+			utils.Info("[TELEGRAM:SERVICE] 机器人已被禁用，停止正在运行的服务")
+			s.Stop()
+		}
 		return nil
 	}
 
@@ -247,6 +271,9 @@ func (s *TelegramBotServiceImpl) Start() error {
 	s.bot = bot
 	s.isRunning = true
 
+	// 重置停止信号channel
+	s.stopChan = make(chan struct{})
+
 	utils.Info("[TELEGRAM:SERVICE] Telegram Bot (@%s) 已启动", s.GetBotUsername())
 
 	// 启动推送调度器
@@ -269,12 +296,26 @@ func (s *TelegramBotServiceImpl) Stop() error {
 		return nil
 	}
 
+	utils.Info("[TELEGRAM:SERVICE] 开始停止 Telegram Bot 服务")
+
 	s.isRunning = false
 
+	// 安全地发送停止信号给消息循环
+	select {
+	case <-s.stopChan:
+		// channel 已经关闭
+	default:
+		// channel 未关闭，安全关闭
+		close(s.stopChan)
+	}
+
 	if s.cronScheduler != nil {
 		s.cronScheduler.Stop()
 	}
 
+	// 清理机器人实例以避免冲突
+	s.bot = nil
+
 	utils.Info("[TELEGRAM:SERVICE] Telegram Bot 服务已停止")
 	return nil
 }
@@ -495,6 +536,12 @@ func (s *TelegramBotServiceImpl) setupWebhook() error {
 func (s *TelegramBotServiceImpl) messageLoop() {
 	utils.Info("[TELEGRAM:MESSAGE] 开始监听 Telegram 消息更新...")
 
+	// 确保机器人实例存在
+	if s.bot == nil {
+		utils.Error("[TELEGRAM:MESSAGE] 机器人实例为空，无法启动消息监听循环")
+		return
+	}
+
 	u := tgbotapi.NewUpdate(0)
 	u.Timeout = 60
 
@@ -502,20 +549,39 @@ func (s *TelegramBotServiceImpl) messageLoop() {
 
 	utils.Info("[TELEGRAM:MESSAGE] 消息监听循环已启动，等待消息...")
 
-	for update := range updates {
-		if update.Message != nil {
-			utils.Info("[TELEGRAM:MESSAGE] 接收到新消息更新")
-			s.handleMessage(update.Message)
-		} else {
-			utils.Debug("[TELEGRAM:MESSAGE] 接收到其他类型更新: %v", update)
+	for {
+		select {
+		case <-s.stopChan:
+			utils.Info("[TELEGRAM:MESSAGE] 收到停止信号，退出消息监听循环")
+			return
+		case update, ok := <-updates:
+			if !ok {
+				utils.Info("[TELEGRAM:MESSAGE] updates channel 已关闭，退出消息监听循环")
+				return
+			}
+			// 在处理消息前检查机器人是否仍在运行
+			if !s.isRunning || s.bot == nil {
+				utils.Info("[TELEGRAM:MESSAGE] 机器人已停止，忽略接收到的消息")
+				return
+			}
+			if update.Message != nil {
+				utils.Info("[TELEGRAM:MESSAGE] 接收到新消息更新")
+				s.handleMessage(update.Message)
+			} else {
+				utils.Debug("[TELEGRAM:MESSAGE] 接收到其他类型更新: %v", update)
+			}
 		}
 	}
-
-	utils.Info("[TELEGRAM:MESSAGE] 消息监听循环已结束")
 }
 
 // handleMessage 处理接收到的消息
 func (s *TelegramBotServiceImpl) handleMessage(message *tgbotapi.Message) {
+	// 检查机器人是否正在运行且已启用
+	if !s.isRunning || !s.config.Enabled {
+		utils.Info("[TELEGRAM:MESSAGE] 机器人已停止或禁用，跳过消息处理: ChatID=%d", message.Chat.ID)
+		return
+	}
+
 	chatID := message.Chat.ID
 	text := strings.TrimSpace(message.Text)
 
@@ -539,6 +605,18 @@ func (s *TelegramBotServiceImpl) handleMessage(message *tgbotapi.Message) {
 		return
 	}
 
+	// 处理 /s 命令
+	if strings.HasPrefix(strings.ToLower(text), "/s ") {
+		utils.Info("[TELEGRAM:MESSAGE] 处理 /s 命令 from ChatID=%d", chatID)
+		// 提取搜索关键词
+		keyword := strings.TrimSpace(text[3:]) // 去掉 "/s " 前缀
+		if keyword != "" {
+			utils.Info("[TELEGRAM:MESSAGE] 处理搜索请求 from ChatID=%d: %s", chatID, keyword)
+			s.handleSearchRequest(message, keyword)
+			return
+		}
+	}
+
 	if len(text) == 0 {
 		return
 	}
@@ -601,10 +679,11 @@ func (s *TelegramBotServiceImpl) handleRegisterCommand(message *tgbotapi.Message
 			return
 		}
 
-		// 检查是否已经注册了群组
-		if s.hasActiveGroup() {
-			errorMsg := "❌ *注册限制*\n\n系统最多只支持注册一个群组用于推送。\n\n请先注销现有群组，然后再注册新的群组。"
-			s.sendReply(message, errorMsg)
+		// 检查当前活跃的Telegram项目总数（频道+群组）
+		activeItemCount := s.hasActiveTelegramItems()
+		if activeItemCount >= 3 {
+			errorMsg := "❌ *注册限制*\n\n系统最多支持注册3个频道/群组用于推送。\n\n当前已注册: %d个，请先注销现有频道/群组，然后再注册新的。"
+			s.sendReply(message, fmt.Sprintf(errorMsg, activeItemCount))
 			return
 		}
 
@@ -701,6 +780,7 @@ func (s *TelegramBotServiceImpl) handleStartCommand(message *tgbotapi.Message) {
 	welcomeMsg := `🤖 欢迎使用老九网盘资源机器人！
 
 • 发送 搜索 + 关键词 进行资源搜索
+• 发送 /s 关键词 进行资源搜索（命令形式）
 • 发送 /register 注册当前频道或群组，用于主动推送资源
 • 私聊中使用 /register help 获取注册帮助
 • 发送 /start 获取帮助信息
@@ -791,7 +871,7 @@ func (s *TelegramBotServiceImpl) handleSearchRequest(message *tgbotapi.Message,
 		resultText += fmt.Sprintf("... 还有 %d 个结果\n\n", total-5)
 	}
 
-	resultText += "<i>如果资源失效请访问，发送搜索 + 关键字，可以搜索资源， 或者访问 https://pan.l9.lc 搜索最新资源</i>"
+	resultText += "<i>如果资源失效请访问，发送搜索 + 关键字，可以搜索资源</i>"
 
 	// 使用包含资源的自动删除功能
 	s.sendReplyWithResourceAutoDelete(message, resultText)
@@ -895,9 +975,16 @@ func (s *TelegramBotServiceImpl) pushContentToChannels() {
 		return
 	}
 
-	utils.Info("[TELEGRAM:PUSH] 开始推送内容到 %d 个频道", len(channels))
+	// 过滤出在允许推送时间段内的频道
+	validChannels := s.filterChannelsByTimeRange(channels)
+	if len(validChannels) == 0 {
+		utils.Info("[TELEGRAM:PUSH] 所有频道都不在推送时间段内")
+		return
+	}
 
-	for _, channel := range channels {
+	utils.Info("[TELEGRAM:PUSH] 开始推送内容到 %d 个频道（过滤前: %d 个频道）", len(validChannels), len(channels))
+
+	for _, channel := range validChannels {
 		go s.pushToChannel(channel)
 	}
 }
@@ -930,6 +1017,21 @@ func (s *TelegramBotServiceImpl) pushToChannel(channel entity.TelegramChannel) {
 		return
 	}
 
+	// 5. 记录推送的资源ID到历史记录，避免重复推送
+	for _, resource := range resources {
+		var resourceID uint
+		switch r := resource.(type) {
+		case *entity.Resource:
+			resourceID = r.ID
+		case entity.Resource:
+			resourceID = r.ID
+		default:
+			utils.Error("[TELEGRAM:PUSH] 无效的资源类型: %T", resource)
+			continue
+		}
+		s.addPushedResourceID(channel.ChatID, resourceID)
+	}
+
 	utils.Info("[TELEGRAM:PUSH:SUCCESS] 成功推送内容到频道: %s (%d 条资源)", channel.ChatName, len(resources))
 }
 
@@ -937,6 +1039,187 @@ func (s *TelegramBotServiceImpl) pushToChannel(channel entity.TelegramChannel) {
 func (s *TelegramBotServiceImpl) findResourcesForChannel(channel entity.TelegramChannel) []interface{} {
 	utils.Info("[TELEGRAM:PUSH] 开始为频道 %s (%d) 查找资源", channel.ChatName, channel.ChatID)
 
+	// 获取最近推送的历史资源ID，避免重复推送
+	excludeResourceIDs := s.getRecentlyPushedResourceIDs(channel.ChatID)
+
+	// 解析资源策略
+	strategy := channel.ResourceStrategy
+	if strategy == "" {
+		strategy = "random" // 默认纯随机
+	}
+
+	utils.Info("[TELEGRAM:PUSH] 使用策略: %s, 时间限制: %s, 排除最近推送资源数: %d",
+		strategy, channel.TimeLimit, len(excludeResourceIDs))
+
+	// 根据策略获取资源
+	switch strategy {
+	case "latest":
+		// 最新优先策略 - 获取最近的资源
+		return s.findLatestResources(channel, excludeResourceIDs)
+	case "transferred":
+		// 已转存优先策略 - 优先获取有转存链接的资源
+		return s.findTransferredResources(channel, excludeResourceIDs)
+	case "random":
+		// 纯随机策略（原逻辑）
+		return s.findRandomResources(channel, excludeResourceIDs)
+	default:
+		// 默认随机策略
+		return s.findRandomResources(channel, excludeResourceIDs)
+	}
+}
+
+// findLatestResources 查找最新资源
+func (s *TelegramBotServiceImpl) findLatestResources(channel entity.TelegramChannel, excludeResourceIDs []uint) []interface{} {
+	params := s.buildFilterParams(channel)
+
+	// 在数据库查询中排除已推送的资源
+	if len(excludeResourceIDs) > 0 {
+		params["exclude_ids"] = excludeResourceIDs
+	}
+
+	// 使用现有的搜索功能，按更新时间倒序获取最新资源
+	resources, _, err := s.resourceRepo.SearchWithFilters(params)
+	if err != nil {
+		utils.Error("[TELEGRAM:PUSH] 获取最新资源失败: %v", err)
+		return s.findRandomResources(channel, excludeResourceIDs) // 回退到随机策略
+	}
+
+	// 应用时间限制
+	if channel.TimeLimit != "none" && len(resources) > 0 {
+		resources = s.applyTimeFilter(resources, channel.TimeLimit)
+	}
+
+	if len(resources) == 0 {
+		utils.Info("[TELEGRAM:PUSH] 没有找到符合条件的最新资源，尝试获取随机资源")
+		return s.findRandomResources(channel, excludeResourceIDs) // 回退到随机策略
+	}
+
+	// 返回最新资源（第一条）
+	utils.Info("[TELEGRAM:PUSH] 成功获取最新资源: %s", resources[0].Title)
+	return []interface{}{&resources[0]}
+}
+
+// findTransferredResources 查找已转存资源
+func (s *TelegramBotServiceImpl) findTransferredResources(channel entity.TelegramChannel, excludeResourceIDs []uint) []interface{} {
+	params := s.buildFilterParams(channel)
+
+	// 添加转存链接条件
+	params["has_save_url"] = true
+
+	// 在数据库查询中排除已推送的资源
+	if len(excludeResourceIDs) > 0 {
+		params["exclude_ids"] = excludeResourceIDs
+	}
+
+	// 优先获取有转存链接的资源
+	resources, _, err := s.resourceRepo.SearchWithFilters(params)
+	if err != nil {
+		utils.Error("[TELEGRAM:PUSH] 获取已转存资源失败: %v", err)
+		return []interface{}{}
+	}
+
+	// 应用时间限制
+	if channel.TimeLimit != "none" && len(resources) > 0 {
+		resources = s.applyTimeFilter(resources, channel.TimeLimit)
+	}
+
+	if len(resources) == 0 {
+		utils.Info("[TELEGRAM:PUSH] 没有找到符合条件的已转存资源，尝试获取随机资源")
+		// 如果没有已转存资源，回退到随机策略
+		return s.findRandomResources(channel, excludeResourceIDs)
+	}
+
+	// 返回第一个有转存链接的资源
+	utils.Info("[TELEGRAM:PUSH] 成功获取已转存资源: %s", resources[0].Title)
+	return []interface{}{&resources[0]}
+}
+
+// findRandomResources 查找随机资源（原有逻辑）
+func (s *TelegramBotServiceImpl) findRandomResources(channel entity.TelegramChannel, excludeResourceIDs []uint) []interface{} {
+	params := s.buildFilterParams(channel)
+
+	// 如果是已转存优先策略但没有找到转存资源，这里会回退到随机策略
+	// 此时不需要额外的转存链接条件，让随机函数处理
+
+	// 在数据库查询中排除已推送的资源
+	if len(excludeResourceIDs) > 0 {
+		params["exclude_ids"] = excludeResourceIDs
+	}
+
+	// 使用搜索功能获取候选资源，然后过滤
+	params["limit"] = 100 // 获取更多候选资源
+	candidateResources, _, err := s.resourceRepo.SearchWithFilters(params)
+	if err != nil {
+		utils.Error("[TELEGRAM:PUSH] 获取候选资源失败: %v", err)
+		return []interface{}{}
+	}
+
+	// 应用时间限制
+	if channel.TimeLimit != "none" && len(candidateResources) > 0 {
+		candidateResources = s.applyTimeFilter(candidateResources, channel.TimeLimit)
+	}
+
+	// 如果还有候选资源，随机选择一个
+	if len(candidateResources) > 0 {
+		// 简单随机选择（未来可以考虑使用更好的随机算法）
+		randomIndex := time.Now().Nanosecond() % len(candidateResources)
+		selectedResource := candidateResources[randomIndex]
+
+		utils.Info("[TELEGRAM:PUSH] 成功获取随机资源: %s (从 %d 个候选资源中选择)",
+			selectedResource.Title, len(candidateResources))
+		return []interface{}{&selectedResource}
+	}
+
+	// 如果候选资源不足，回退到数据库随机函数
+	defer func() {
+		if r := recover(); r != nil {
+			utils.Warn("[TELEGRAM:PUSH] 随机查询失败，回退到传统方法: %v", r)
+		}
+	}()
+
+	randomResource, err := s.resourceRepo.GetRandomResourceWithFilters(params["category"].(string), params["tag"].(string), channel.IsPushSavedInfo)
+	if err == nil && randomResource != nil {
+		utils.Info("[TELEGRAM:PUSH] 使用数据库随机函数获取资源: %s", randomResource.Title)
+		return []interface{}{randomResource}
+	}
+
+	return []interface{}{}
+}
+
+// applyTimeFilter 应用时间限制过滤
+func (s *TelegramBotServiceImpl) applyTimeFilter(resources []entity.Resource, timeLimit string) []entity.Resource {
+	now := time.Now()
+	var filtered []entity.Resource
+
+	for _, resource := range resources {
+		include := false
+
+		switch timeLimit {
+		case "week":
+			// 一周内
+			if resource.CreatedAt.After(now.AddDate(0, 0, -7)) {
+				include = true
+			}
+		case "month":
+			// 一月内
+			if resource.CreatedAt.After(now.AddDate(0, -1, 0)) {
+				include = true
+			}
+		case "none":
+			// 无限制，包含所有
+			include = true
+		}
+
+		if include {
+			filtered = append(filtered, resource)
+		}
+	}
+
+	return filtered
+}
+
+// buildFilterParams 构建过滤参数
+func (s *TelegramBotServiceImpl) buildFilterParams(channel entity.TelegramChannel) map[string]interface{} {
 	params := map[string]interface{}{"category": "", "tag": ""}
 
 	if channel.ContentCategories != "" {
@@ -955,25 +1238,23 @@ func (s *TelegramBotServiceImpl) findResourcesForChannel(channel entity.Telegram
 		params["tag"] = tags[0]
 	}
 
-	// 尝试使用 PostgreSQL 的随机功能
-	defer func() {
-		if r := recover(); r != nil {
-			utils.Warn("[TELEGRAM:PUSH] 随机查询失败，回退到传统方法: %v", r)
-		}
-	}()
-
-	randomResource, err := s.resourceRepo.GetRandomResourceWithFilters(params["category"].(string), params["tag"].(string), channel.IsPushSavedInfo)
-	if err == nil && randomResource != nil {
-		utils.Info("[TELEGRAM:PUSH] 成功获取随机资源: %s", randomResource.Title)
-		return []interface{}{randomResource}
-	}
-
-	return []interface{}{}
+	return params
 }
 
 // buildPushMessage 构建推送消息
 func (s *TelegramBotServiceImpl) buildPushMessage(channel entity.TelegramChannel, resources []interface{}) (string, string) {
-	resource := resources[0].(*entity.Resource)
+	var resource *entity.Resource
+
+	// 处理两种可能的类型：*entity.Resource 或 entity.Resource
+	switch r := resources[0].(type) {
+	case *entity.Resource:
+		resource = r
+	case entity.Resource:
+		resource = &r
+	default:
+		utils.Error("[TELEGRAM:PUSH] 无效的资源类型: %T", resources[0])
+		return "", ""
+	}
 
 	message := fmt.Sprintf("🆕 <b>%s</b>\n", s.cleanMessageTextForHTML(resource.Title))
 
@@ -1001,18 +1282,18 @@ func (s *TelegramBotServiceImpl) buildPushMessage(channel entity.TelegramChannel
 		img = resource.Cover
 	} else {
 		// 从 readyRepo 中取出 extra 字段，解析 JSON 获取 fid，用于构造图片URL
-		readyResources, err := s.readyRepo.FindByKey(resource.Key)
-		if err == nil && len(readyResources) > 0 {
-			readyResource := readyResources[0]
-			if readyResource.Extra != "" {
-				var extraData map[string]interface{}
-				if err := json.Unmarshal([]byte(readyResource.Extra), &extraData); err == nil {
-					if fid, ok := extraData["fid"].(string); ok && fid != "" {
-						img = fid
-					}
-				}
-			}
-		}
+		// readyResources, err := s.readyRepo.FindByKey(resource.Key)
+		// if err == nil && len(readyResources) > 0 {
+		// 	readyResource := readyResources[0]
+		// 	if readyResource.Extra != "" {
+		// 		var extraData map[string]interface{}
+		// 		if err := json.Unmarshal([]byte(readyResource.Extra), &extraData); err == nil {
+		// 			if fid, ok := extraData["fid"].(string); ok && fid != "" {
+		// 				img = fid
+		// 			}
+		// 		}
+		// 	}
+		// }
 	}
 
 	return message, img
@@ -1032,6 +1313,12 @@ func (s *TelegramBotServiceImpl) GetBotUsername() string {
 
 // SendMessage 发送消息（默认使用 HTML 格式）
 func (s *TelegramBotServiceImpl) SendMessage(chatID int64, text string, img string) error {
+	// 检查机器人是否正在运行且已启用
+	if !s.isRunning || !s.config.Enabled {
+		utils.Info("[TELEGRAM:MESSAGE] 机器人已停止或禁用，跳过发送消息: ChatID=%d", chatID)
+		return fmt.Errorf("机器人已停止或禁用")
+	}
+
 	if img == "" {
 		msg := tgbotapi.NewMessage(chatID, text)
 		msg.ParseMode = "HTML"
@@ -1091,16 +1378,20 @@ func (s *TelegramBotServiceImpl) RegisterChannel(chatID int64, chatName, chatTyp
 		ChatName:          chatName,
 		ChatType:          chatType,
 		PushEnabled:       true,
-		PushFrequency:     5, // 默认5分钟
+		PushFrequency:     5,       // 默认5分钟
+		PushStartTime:     "08:30", // 默认开始时间8:30
+		PushEndTime:       "11:30", // 默认结束时间11:30
 		IsActive:          true,
 		RegisteredBy:      "bot_command",
 		RegisteredAt:      time.Now(),
 		ContentCategories: "",
 		ContentTags:       "",
-		API:               "",    // 后续可配置
-		Token:             "",    // 后续可配置
-		ApiType:           "l9",  // 默认l9类型
-		IsPushSavedInfo:   false, // 默认推送所有资源
+		API:               "",       // 后续可配置
+		Token:             "",       // 后续可配置
+		ApiType:           "l9",     // 默认l9类型
+		IsPushSavedInfo:   false,    // 默认推送所有资源
+		ResourceStrategy:  "random", // 默认纯随机
+		TimeLimit:         "none",   // 默认无限制
 	}
 
 	return s.channelRepo.Create(&channel)
@@ -1170,38 +1461,51 @@ func (s *TelegramBotServiceImpl) isBotAdministrator(chatID int64) bool {
 	return botStatus == "administrator" || botStatus == "creator"
 }
 
-// hasActiveGroup 检查是否已经注册了活跃的群组
-func (s *TelegramBotServiceImpl) hasActiveGroup() bool {
+// hasActiveGroup 检查当前活跃的群组数量
+func (s *TelegramBotServiceImpl) hasActiveGroup() int {
 	channels, err := s.channelRepo.FindByChatType("group")
 	if err != nil {
 		utils.Error("[TELEGRAM:LIMIT] 检查活跃群组失败: %v", err)
-		return false
+		return 0
 	}
 
-	// 检查是否有活跃的群组
+	// 统计活跃的群组数量
+	activeCount := 0
 	for _, channel := range channels {
 		if channel.IsActive {
-			return true
+			activeCount++
 		}
 	}
-	return false
+	return activeCount
 }
 
-// hasActiveChannel 检查是否已经注册了活跃的频道
-func (s *TelegramBotServiceImpl) hasActiveChannel() bool {
+// hasActiveChannel 检查当前活跃的频道数量
+func (s *TelegramBotServiceImpl) hasActiveChannel() int {
 	channels, err := s.channelRepo.FindByChatType("channel")
 	if err != nil {
 		utils.Error("[TELEGRAM:LIMIT] 检查活跃频道失败: %v", err)
-		return false
+		return 0
 	}
 
-	// 检查是否有活跃的频道
+	// 统计活跃的频道数量
+	activeCount := 0
 	for _, channel := range channels {
 		if channel.IsActive {
-			return true
+			activeCount++
 		}
 	}
-	return false
+	return activeCount
+}
+
+// hasActiveTelegramItems 检查当前活跃的Telegram项目（频道+群组）总数
+func (s *TelegramBotServiceImpl) hasActiveTelegramItems() int {
+	chatTypes := []string{"channel", "group"}
+	channels, err := s.channelRepo.FindActiveChannelsByTypes(chatTypes)
+	if err != nil {
+		utils.Error("[TELEGRAM:LIMIT] 检查活跃Telegram项目失败: %v", err)
+		return 0
+	}
+	return len(channels)
 }
 
 // handleChannelRegistration 处理频道注册（支持频道ID和用户名）
@@ -1366,10 +1670,11 @@ func (s *TelegramBotServiceImpl) handleChannelRegistration(message *tgbotapi.Mes
 			return
 		}
 
-		// 检查是否已经注册了频道
-		if s.hasActiveChannel() {
-			errorMsg := "❌ *注册限制*\n\n系统最多只支持注册一个频道用于推送。\n\n请先注销现有频道，然后再注册新的频道。"
-			s.sendReply(message, errorMsg)
+		// 检查当前活跃的Telegram项目总数（频道+群组）
+		activeItemCount := s.hasActiveTelegramItems()
+		if activeItemCount >= 3 {
+			errorMsg := "❌ *注册限制*\n\n系统最多支持注册3个频道/群组用于推送。\n\n当前已注册: %d个，请先注销现有频道/群组，然后再注册新的。"
+			s.sendReply(message, fmt.Sprintf(errorMsg, activeItemCount))
 			return
 		}
 
@@ -1396,6 +1701,21 @@ func (s *TelegramBotServiceImpl) handleChannelRegistration(message *tgbotapi.Mes
 		if existingChannel.ApiType == "" {
 			existingChannel.ApiType = "telegram"
 		}
+		if existingChannel.ResourceStrategy == "" {
+			existingChannel.ResourceStrategy = "random"
+		}
+		if existingChannel.TimeLimit == "" {
+			existingChannel.TimeLimit = "none"
+		}
+		if existingChannel.PushFrequency == 0 {
+			existingChannel.PushFrequency = 5
+		}
+		if existingChannel.PushStartTime == "" {
+			existingChannel.PushStartTime = "08:30"
+		}
+		if existingChannel.PushEndTime == "" {
+			existingChannel.PushEndTime = "11:30"
+		}
 
 		err := s.channelRepo.Update(existingChannel)
 		if err != nil {
@@ -1415,7 +1735,7 @@ func (s *TelegramBotServiceImpl) handleChannelRegistration(message *tgbotapi.Mes
 		ChatName:          chat.Title,
 		ChatType:          "channel",
 		PushEnabled:       true,
-		PushFrequency:     60, // 默认1小时
+		PushFrequency:     1, // 默认1分钟
 		IsActive:          true,
 		RegisteredBy:      message.From.UserName,
 		RegisteredAt:      time.Now(),
@@ -1464,3 +1784,236 @@ func (s *TelegramBotServiceImpl) CleanupDuplicateChannels() error {
 	utils.Info("[TELEGRAM:CLEANUP:SUCCESS] 成功清理重复的频道记录")
 	return nil
 }
+
+// savePushHistory 保存指定频道的推送历史记录到文件（每行一个消息ID）
+func (s *TelegramBotServiceImpl) savePushHistory(chatID int64) {
+	// 获取指定频道的历史记录
+	history, exists := s.pushHistory[chatID]
+	if !exists {
+		history = []uint{}
+	}
+
+	// 确保目录存在
+	dir := "./data/telegram_push_history"
+	if err := os.MkdirAll(dir, 0755); err != nil {
+		utils.Error("[TELEGRAM:PUSH] 创建数据目录失败: %v", err)
+		return
+	}
+
+	// 写入文件，每个频道一个文件，每行一个消息ID
+	filename := filepath.Join(dir, fmt.Sprintf("%d.txt", chatID))
+
+	// 构建文件内容（每行一个消息ID）
+	var content strings.Builder
+	for _, resourceID := range history {
+		content.WriteString(fmt.Sprintf("%d\n", resourceID))
+	}
+
+	if err := os.WriteFile(filename, []byte(content.String()), 0644); err != nil {
+		utils.Error("[TELEGRAM:PUSH] 保存推送历史记录到文件失败: %v", err)
+		return
+	}
+
+	utils.Debug("[TELEGRAM:PUSH] 成功保存频道 %d 的推送历史记录到文件: %s", chatID, filename)
+}
+
+// addPushedResourceID 添加已推送的资源ID到历史记录
+func (s *TelegramBotServiceImpl) addPushedResourceID(chatID int64, resourceID uint) {
+	s.mu.Lock()
+	defer s.mu.Unlock()
+
+	// 获取当前频道的历史记录
+	history := s.pushHistory[chatID]
+	if history == nil {
+		history = []uint{}
+	}
+
+	// 检查是否已经超过5000条记录
+	if len(history) >= 5000 {
+		// 移除旧的2500条记录，保留最新的2500条记录
+		startIndex := len(history) - 2500
+		history = history[startIndex:]
+		utils.Info("[TELEGRAM:PUSH] 频道 %d 推送历史记录已满(5000条)，移除旧的2500条记录，保留最新的2500条", chatID)
+	}
+
+	// 添加新的资源ID到历史记录
+	history = append(history, resourceID)
+	s.pushHistory[chatID] = history
+
+	utils.Debug("[TELEGRAM:PUSH] 添加推送历史，ChatID: %d, ResourceID: %d, 当前历史记录数: %d",
+		chatID, resourceID, len(history))
+
+	// 保存到文件（只保存当前频道）
+	s.savePushHistory(chatID)
+}
+
+// loadPushHistory 从文件加载推送历史记录（每行一个消息ID）
+func (s *TelegramBotServiceImpl) loadPushHistory() error {
+	s.mu.Lock()
+	defer s.mu.Unlock()
+
+	// 检查目录是否存在
+	dir := "./data/telegram_push_history"
+	if _, err := os.Stat(dir); os.IsNotExist(err) {
+		utils.Info("[TELEGRAM:PUSH] 推送历史记录目录不存在，使用空的历史记录")
+		return nil
+	}
+
+	// 读取目录中的所有文件
+	files, err := os.ReadDir(dir)
+	if err != nil {
+		utils.Error("[TELEGRAM:PUSH] 读取推送历史记录目录失败: %v", err)
+		return err
+	}
+
+	// 初始化推送历史记录映射
+	s.pushHistory = make(map[int64][]uint)
+
+	// 遍历所有文件
+	for _, file := range files {
+		if file.IsDir() {
+			continue
+		}
+
+		// 检查文件名格式是否为 *.txt
+		filename := file.Name()
+		if !strings.HasSuffix(filename, ".txt") {
+			continue
+		}
+
+		// 提取chatID
+		chatIDStr := strings.TrimSuffix(filename, ".txt")
+		chatID, err := strconv.ParseInt(chatIDStr, 10, 64)
+		if err != nil {
+			utils.Warn("[TELEGRAM:PUSH] 无法解析频道ID文件名: %s", filename)
+			continue
+		}
+
+		// 读取文件内容
+		fullPath := filepath.Join(dir, filename)
+		data, err := os.ReadFile(fullPath)
+		if err != nil {
+			utils.Error("[TELEGRAM:PUSH] 读取推送历史记录文件失败: %s, %v", fullPath, err)
+			continue
+		}
+
+		// 解析每行的消息ID
+		lines := strings.Split(string(data), "\n")
+		var resourceIDs []uint
+
+		for _, line := range lines {
+			line = strings.TrimSpace(line)
+			if line == "" {
+				continue
+			}
+
+			resourceID, err := strconv.ParseUint(line, 10, 32)
+			if err != nil {
+				utils.Warn("[TELEGRAM:PUSH] 无法解析消息ID: %s in file %s", line, filename)
+				continue
+			}
+
+			resourceIDs = append(resourceIDs, uint(resourceID))
+		}
+
+		// 只保留最多5000条记录
+		if len(resourceIDs) > 5000 {
+			// 保留最新的5000条记录
+			startIndex := len(resourceIDs) - 5000
+			resourceIDs = resourceIDs[startIndex:]
+		}
+
+		s.pushHistory[chatID] = resourceIDs
+		utils.Debug("[TELEGRAM:PUSH] 加载频道 %d 的历史记录，共 %d 条", chatID, len(resourceIDs))
+	}
+
+	utils.Info("[TELEGRAM:PUSH] 成功从文件加载推送历史记录，共 %d 个频道", len(s.pushHistory))
+	return nil
+}
+
+// getRecentlyPushedResourceIDs 获取最近推送过的资源ID列表
+func (s *TelegramBotServiceImpl) getRecentlyPushedResourceIDs(chatID int64) []uint {
+	s.mu.RLock()
+	defer s.mu.RUnlock()
+
+	// 返回该频道的推送历史记录
+	if history, exists := s.pushHistory[chatID]; exists {
+		utils.Debug("[TELEGRAM:PUSH] 获取推送历史，ChatID: %d, 历史记录数: %d", chatID, len(history))
+		// 返回副本，避免外部修改
+		result := make([]uint, len(history))
+		copy(result, history)
+		return result
+	}
+
+	utils.Debug("[TELEGRAM:PUSH] 获取推送历史，ChatID: %d, 无历史记录", chatID)
+	return []uint{}
+}
+
+// excludePushedResources 从候选资源中排除已推送过的资源
+func (s *TelegramBotServiceImpl) excludePushedResources(resources []entity.Resource, excludeIDs []uint) []entity.Resource {
+	if len(excludeIDs) == 0 {
+		return resources
+	}
+
+	utils.Debug("[TELEGRAM:PUSH] 排除 %d 个已推送资源", len(excludeIDs))
+
+	// 创建排除ID的映射，提高查找效率
+	excludeMap := make(map[uint]bool)
+	for _, id := range excludeIDs {
+		excludeMap[id] = true
+	}
+
+	// 过滤资源列表
+	var filtered []entity.Resource
+	for _, resource := range resources {
+		if !excludeMap[resource.ID] {
+			filtered = append(filtered, resource)
+		}
+	}
+
+	utils.Debug("[TELEGRAM:PUSH] 过滤后剩余 %d 个资源", len(filtered))
+	return filtered
+}
+
+// filterChannelsByTimeRange 过滤出在允许推送时间段内的频道
+func (s *TelegramBotServiceImpl) filterChannelsByTimeRange(channels []entity.TelegramChannel) []entity.TelegramChannel {
+	now := time.Now()
+	currentTime := now.Format("15:04") // HH:MM 格式
+
+	var filteredChannels []entity.TelegramChannel
+
+	for _, channel := range channels {
+		// 检查是否在推送时间段内
+		if !s.isChannelInPushTimeRange(channel, currentTime) {
+			utils.Info("[TELEGRAM:PUSH] 频道 %s 不在推送时间段内 (当前: %s, 允许: %s-%s)",
+				channel.ChatName, currentTime, channel.PushStartTime, channel.PushEndTime)
+			continue
+		}
+
+		filteredChannels = append(filteredChannels, channel)
+	}
+
+	utils.Info("[TELEGRAM:PUSH] 时间段过滤结果: %d/%d 个频道在允许推送时间段内",
+		len(filteredChannels), len(channels))
+	return filteredChannels
+}
+
+// isChannelInPushTimeRange 检查频道是否在推送时间段内
+func (s *TelegramBotServiceImpl) isChannelInPushTimeRange(channel entity.TelegramChannel, currentTime string) bool {
+	// 如果开始时间或结束时间为空，允许推送
+	if channel.PushStartTime == "" || channel.PushEndTime == "" {
+		return true
+	}
+
+	startTime := channel.PushStartTime
+	endTime := channel.PushEndTime
+
+	// 比较时间（假设时间格式为 HH:MM）
+	if startTime <= endTime {
+		// 同一天时间段，例如 08:30 - 11:30
+		return currentTime >= startTime && currentTime <= endTime
+	} else {
+		// 跨天时间段，例如 22:00 - 06:00
+		return currentTime >= startTime || currentTime <= endTime
+	}
+}

services/wechat_bot_service.go

@@ -0,0 +1,58 @@
+package services
+
+import (
+	"github.com/ctwj/urldb/db/repo"
+	"github.com/silenceper/wechat/v2/officialaccount"
+	"github.com/silenceper/wechat/v2/officialaccount/message"
+)
+
+// WechatBotService 微信公众号机器人服务接口
+type WechatBotService interface {
+	Start() error
+	Stop() error
+	IsRunning() bool
+	ReloadConfig() error
+	HandleMessage(msg *message.MixMessage) (interface{}, error)
+	SendWelcomeMessage(openID string) error
+	GetRuntimeStatus() map[string]interface{}
+	GetConfig() *WechatBotConfig
+}
+
+// WechatBotConfig 微信公众号机器人配置
+type WechatBotConfig struct {
+	Enabled         bool
+	AppID           string
+	AppSecret       string
+	Token           string
+	EncodingAesKey  string
+	WelcomeMessage  string
+	AutoReplyEnabled bool
+	SearchLimit     int
+}
+
+// WechatBotServiceImpl 微信公众号机器人服务实现
+type WechatBotServiceImpl struct {
+	isRunning        bool
+	systemConfigRepo repo.SystemConfigRepository
+	resourceRepo     repo.ResourceRepository
+	readyRepo        repo.ReadyResourceRepository
+	config           *WechatBotConfig
+	wechatClient     *officialaccount.OfficialAccount
+	searchSessionManager *SearchSessionManager
+}
+
+// NewWechatBotService 创建微信公众号机器人服务
+func NewWechatBotService(
+	systemConfigRepo repo.SystemConfigRepository,
+	resourceRepo repo.ResourceRepository,
+	readyResourceRepo repo.ReadyResourceRepository,
+) WechatBotService {
+	return &WechatBotServiceImpl{
+		isRunning:        false,
+		systemConfigRepo: systemConfigRepo,
+		resourceRepo:     resourceRepo,
+		readyRepo:        readyResourceRepo,
+		config:           &WechatBotConfig{},
+		searchSessionManager: GlobalSearchSessionManager,
+	}
+}

services/wechat_bot_service_impl.go

@@ -0,0 +1,524 @@
+package services
+
+import (
+	"fmt"
+	"strconv"
+	"strings"
+
+	"github.com/ctwj/urldb/db/entity"
+	"github.com/ctwj/urldb/utils"
+	"github.com/silenceper/wechat/v2/cache"
+	"github.com/silenceper/wechat/v2/officialaccount"
+	"github.com/silenceper/wechat/v2/officialaccount/config"
+	"github.com/silenceper/wechat/v2/officialaccount/message"
+)
+
+// loadConfig 加载微信配置
+func (s *WechatBotServiceImpl) loadConfig() error {
+	configs, err := s.systemConfigRepo.GetOrCreateDefault()
+	if err != nil {
+		return fmt.Errorf("加载配置失败: %v", err)
+	}
+
+	utils.Info("[WECHAT] 从数据库加载到 %d 个配置项", len(configs))
+
+	// 初始化默认值
+	s.config.Enabled = false
+	s.config.AppID = ""
+	s.config.AppSecret = ""
+	s.config.Token = ""
+	s.config.EncodingAesKey = ""
+	s.config.WelcomeMessage = "欢迎关注老九网盘资源库！发送关键词即可搜索资源。"
+	s.config.AutoReplyEnabled = true
+	s.config.SearchLimit = 5
+
+	for _, config := range configs {
+		switch config.Key {
+		case entity.ConfigKeyWechatBotEnabled:
+			s.config.Enabled = config.Value == "true"
+			utils.Info("[WECHAT:CONFIG] 加载配置 %s = %s (Enabled: %v)", config.Key, config.Value, s.config.Enabled)
+		case entity.ConfigKeyWechatAppId:
+			s.config.AppID = config.Value
+			utils.Info("[WECHAT:CONFIG] 加载配置 %s = [HIDDEN]", config.Key)
+		case entity.ConfigKeyWechatAppSecret:
+			s.config.AppSecret = config.Value
+			utils.Info("[WECHAT:CONFIG] 加载配置 %s = [HIDDEN]", config.Key)
+		case entity.ConfigKeyWechatToken:
+			s.config.Token = config.Value
+			utils.Info("[WECHAT:CONFIG] 加载配置 %s = [HIDDEN]", config.Key)
+		case entity.ConfigKeyWechatEncodingAesKey:
+			s.config.EncodingAesKey = config.Value
+			utils.Info("[WECHAT:CONFIG] 加载配置 %s = [HIDDEN]", config.Key)
+		case entity.ConfigKeyWechatWelcomeMessage:
+			if config.Value != "" {
+				s.config.WelcomeMessage = config.Value
+			}
+			utils.Info("[WECHAT:CONFIG] 加载配置 %s = %s", config.Key, config.Value)
+		case entity.ConfigKeyWechatAutoReplyEnabled:
+			s.config.AutoReplyEnabled = config.Value == "true"
+			utils.Info("[WECHAT:CONFIG] 加载配置 %s = %s (AutoReplyEnabled: %v)", config.Key, config.Value, s.config.AutoReplyEnabled)
+		case entity.ConfigKeyWechatSearchLimit:
+			if config.Value != "" {
+				limit, err := strconv.Atoi(config.Value)
+				if err == nil && limit > 0 {
+					s.config.SearchLimit = limit
+				}
+			}
+			utils.Info("[WECHAT:CONFIG] 加载配置 %s = %s (SearchLimit: %d)", config.Key, config.Value, s.config.SearchLimit)
+		}
+	}
+
+	utils.Info("[WECHAT:SERVICE] 微信公众号机器人配置加载完成: Enabled=%v, AutoReplyEnabled=%v",
+		s.config.Enabled, s.config.AutoReplyEnabled)
+	return nil
+}
+
+// Start 启动微信公众号机器人服务
+func (s *WechatBotServiceImpl) Start() error {
+	if s.isRunning {
+		utils.Info("[WECHAT:SERVICE] 微信公众号机器人服务已经在运行中")
+		return nil
+	}
+
+	// 加载配置
+	if err := s.loadConfig(); err != nil {
+		return fmt.Errorf("加载配置失败: %v", err)
+	}
+
+	if !s.config.Enabled || s.config.AppID == "" || s.config.AppSecret == "" {
+		utils.Info("[WECHAT:SERVICE] 微信公众号机器人未启用或配置不完整")
+		return nil
+	}
+
+	// 创建微信客户端
+	cfg := &config.Config{
+		AppID:          s.config.AppID,
+		AppSecret:      s.config.AppSecret,
+		Token:          s.config.Token,
+		EncodingAESKey: s.config.EncodingAesKey,
+		Cache:          cache.NewMemory(),
+	}
+	s.wechatClient = officialaccount.NewOfficialAccount(cfg)
+
+	s.isRunning = true
+	utils.Info("[WECHAT:SERVICE] 微信公众号机器人服务已启动")
+	return nil
+}
+
+// Stop 停止微信公众号机器人服务
+func (s *WechatBotServiceImpl) Stop() error {
+	if !s.isRunning {
+		return nil
+	}
+
+	s.isRunning = false
+	utils.Info("[WECHAT:SERVICE] 微信公众号机器人服务已停止")
+	return nil
+}
+
+// IsRunning 检查微信公众号机器人服务是否正在运行
+func (s *WechatBotServiceImpl) IsRunning() bool {
+	return s.isRunning
+}
+
+// ReloadConfig 重新加载微信公众号机器人配置
+func (s *WechatBotServiceImpl) ReloadConfig() error {
+	utils.Info("[WECHAT:SERVICE] 开始重新加载配置...")
+
+	// 重新加载配置
+	if err := s.loadConfig(); err != nil {
+		utils.Error("[WECHAT:SERVICE] 重新加载配置失败: %v", err)
+		return fmt.Errorf("重新加载配置失败: %v", err)
+	}
+
+	utils.Info("[WECHAT:SERVICE] 配置重新加载完成: Enabled=%v, AutoReplyEnabled=%v",
+		s.config.Enabled, s.config.AutoReplyEnabled)
+	return nil
+}
+
+// GetRuntimeStatus 获取微信公众号机器人运行时状态
+func (s *WechatBotServiceImpl) GetRuntimeStatus() map[string]interface{} {
+	status := map[string]interface{}{
+		"is_running":    s.IsRunning(),
+		"config_loaded": s.config != nil,
+		"app_id":        s.config.AppID,
+	}
+
+	return status
+}
+
+// GetConfig 获取当前配置
+func (s *WechatBotServiceImpl) GetConfig() *WechatBotConfig {
+	return s.config
+}
+
+// HandleMessage 处理微信消息
+func (s *WechatBotServiceImpl) HandleMessage(msg *message.MixMessage) (interface{}, error) {
+	utils.Info("[WECHAT:MESSAGE] 收到消息: FromUserName=%s, MsgType=%s, Event=%s, Content=%s",
+		msg.FromUserName, msg.MsgType, msg.Event, msg.Content)
+
+	switch msg.MsgType {
+	case message.MsgTypeText:
+		return s.handleTextMessage(msg)
+	case message.MsgTypeEvent:
+		return s.handleEventMessage(msg)
+	default:
+		return nil, nil // 不处理其他类型消息
+	}
+}
+
+// handleTextMessage 处理文本消息
+func (s *WechatBotServiceImpl) handleTextMessage(msg *message.MixMessage) (interface{}, error) {
+	utils.Debug("[WECHAT:MESSAGE] 处理文本消息 - AutoReplyEnabled: %v", s.config.AutoReplyEnabled)
+	if !s.config.AutoReplyEnabled {
+		utils.Info("[WECHAT:MESSAGE] 自动回复未启用")
+		return nil, nil
+	}
+
+	keyword := strings.TrimSpace(msg.Content)
+	utils.Info("[WECHAT:MESSAGE] 搜索关键词: '%s'", keyword)
+
+	// 检查是否是分页命令
+	if keyword == "上一页" || keyword == "prev" {
+		return s.handlePrevPage(string(msg.FromUserName))
+	}
+
+	if keyword == "下一页" || keyword == "next" {
+		return s.handleNextPage(string(msg.FromUserName))
+	}
+
+	// 检查是否是获取命令（例如：获取 1, 获取2等）
+	if strings.HasPrefix(keyword, "获取") || strings.HasPrefix(keyword, "get") {
+		return s.handleGetResource(string(msg.FromUserName), keyword)
+	}
+
+	if keyword == "" {
+		utils.Info("[WECHAT:MESSAGE] 关键词为空，返回提示消息")
+		return message.NewText("请输入搜索关键词"), nil
+	}
+
+	// 检查搜索关键词是否包含违禁词
+	cleanWords, err := utils.GetForbiddenWordsFromConfig(func() (string, error) {
+		return s.systemConfigRepo.GetConfigValue(entity.ConfigKeyForbiddenWords)
+	})
+	if err != nil {
+		utils.Error("获取违禁词配置失败: %v", err)
+		cleanWords = []string{} // 如果获取失败，使用空列表
+	}
+
+	// 检查关键词是否包含违禁词
+	if len(cleanWords) > 0 {
+		containsForbidden, matchedWords := utils.CheckContainsForbiddenWords(keyword, cleanWords)
+		if containsForbidden {
+			utils.Info("[WECHAT:MESSAGE] 搜索关键词包含违禁词: %v", matchedWords)
+			return message.NewText("您的搜索关键词包含违禁内容，不予处理"), nil
+		}
+	}
+
+	// 搜索资源
+	utils.Debug("[WECHAT:MESSAGE] 开始搜索资源，限制数量: %d", s.config.SearchLimit)
+	resources, err := s.SearchResources(keyword)
+	if err != nil {
+		utils.Error("[WECHAT:SEARCH] 搜索失败: %v", err)
+		return message.NewText("搜索服务暂时不可用，请稍后重试"), nil
+	}
+
+	utils.Info("[WECHAT:MESSAGE] 搜索完成，找到 %d 个资源", len(resources))
+	if len(resources) == 0 {
+		utils.Info("[WECHAT:MESSAGE] 未找到相关资源，返回提示消息")
+		return message.NewText(fmt.Sprintf("未找到关键词\"%s\"相关的资源，请尝试其他关键词", keyword)), nil
+	}
+
+	// 创建搜索会话并保存第一页结果
+	s.searchSessionManager.CreateSession(string(msg.FromUserName), keyword, resources, 4)
+	pageResources := s.searchSessionManager.GetCurrentPageResources(string(msg.FromUserName))
+
+	// 格式化第一页搜索结果
+	resultText := s.formatSearchResultsWithPagination(keyword, pageResources, string(msg.FromUserName))
+	utils.Info("[WECHAT:MESSAGE] 格式化搜索结果，返回文本长度: %d", len(resultText))
+	return message.NewText(resultText), nil
+}
+
+// handlePrevPage 处理上一页命令
+func (s *WechatBotServiceImpl) handlePrevPage(userID string) (interface{}, error) {
+	session := s.searchSessionManager.GetSession(userID)
+	if session == nil {
+		return message.NewText("没有找到搜索记录，请先进行搜索"), nil
+	}
+
+	if !s.searchSessionManager.HasPrevPage(userID) {
+		return message.NewText("已经是第一页了"), nil
+	}
+
+	prevResources := s.searchSessionManager.PrevPage(userID)
+	if prevResources == nil {
+		return message.NewText("获取上一页失败"), nil
+	}
+
+	currentPage, totalPages, _, _ := s.searchSessionManager.GetPageInfo(userID)
+	resultText := s.formatPageResources(session.Keyword, prevResources, currentPage, totalPages, userID)
+	return message.NewText(resultText), nil
+}
+
+// handleNextPage 处理下一页命令
+func (s *WechatBotServiceImpl) handleNextPage(userID string) (interface{}, error) {
+	session := s.searchSessionManager.GetSession(userID)
+	if session == nil {
+		return message.NewText("没有找到搜索记录，请先进行搜索"), nil
+	}
+
+	if !s.searchSessionManager.HasNextPage(userID) {
+		return message.NewText("已经是最后一页了"), nil
+	}
+
+	nextResources := s.searchSessionManager.NextPage(userID)
+	if nextResources == nil {
+		return message.NewText("获取下一页失败"), nil
+	}
+
+	currentPage, totalPages, _, _ := s.searchSessionManager.GetPageInfo(userID)
+	resultText := s.formatPageResources(session.Keyword, nextResources, currentPage, totalPages, userID)
+	return message.NewText(resultText), nil
+}
+
+// handleGetResource 处理获取资源命令
+func (s *WechatBotServiceImpl) handleGetResource(userID, command string) (interface{}, error) {
+	session := s.searchSessionManager.GetSession(userID)
+	if session == nil {
+		return message.NewText("没有找到搜索记录，请先进行搜索"), nil
+	}
+
+	// 检查是否只输入了"获取"或"get"，没有指定编号
+	if command == "获取" || command == "get" {
+		return message.NewText("📌 请输入要获取的资源编号\n\n💡 提示：回复\"获取 1\"或\"get 1\"获取第一个资源的详细信息"), nil
+	}
+
+	// 解析命令，例如："获取 1" 或 "get 2"
+	// 支持"获取4"这种没有空格的格式
+	var index int
+	_, err := fmt.Sscanf(command, "获取%d", &index)
+	if err != nil {
+		_, err = fmt.Sscanf(command, "获取 %d", &index)
+		if err != nil {
+			_, err = fmt.Sscanf(command, "get%d", &index)
+			if err != nil {
+				_, err = fmt.Sscanf(command, "get %d", &index)
+				if err != nil {
+					return message.NewText("❌ 命令格式错误\n\n📌 正确格式：\n   • 获取 1\n   • get 1\n   • 获取1\n   • get1"), nil
+				}
+			}
+		}
+	}
+
+	if index < 1 || index > len(session.Resources) {
+		return message.NewText(fmt.Sprintf("❌ 资源编号超出范围\n\n📌 请输入 1-%d 之间的数字\n💡 提示：回复\"获取 %d\"获取第%d个资源", len(session.Resources), index, index)), nil
+	}
+
+	// 获取指定资源
+	resource := session.Resources[index-1]
+
+	// 格式化资源详细信息（美化输出）
+	var result strings.Builder
+	// result.WriteString(fmt.Sprintf("📌 资源详情\n\n"))
+
+	// 标题
+	result.WriteString(fmt.Sprintf("📌 标题: %s\n", resource.Title))
+
+	// 描述
+	if resource.Description != "" {
+		result.WriteString(fmt.Sprintf("\n📝 描述:\n   %s\n", resource.Description))
+	}
+
+	// 文件大小
+	if resource.FileSize != "" {
+		result.WriteString(fmt.Sprintf("\n📊 大小: %s\n", resource.FileSize))
+	}
+
+	// 作者
+	if resource.Author != "" {
+		result.WriteString(fmt.Sprintf("\n👤 作者: %s\n", resource.Author))
+	}
+
+	// 分类
+	if resource.Category.Name != "" {
+		result.WriteString(fmt.Sprintf("\n📂 分类: %s\n", resource.Category.Name))
+	}
+
+	// 标签
+	if len(resource.Tags) > 0 {
+		result.WriteString("\n🏷️ 标签: ")
+		var tags []string
+		for _, tag := range resource.Tags {
+			tags = append(tags, tag.Name)
+		}
+		result.WriteString(fmt.Sprintf("%s\n", strings.Join(tags, " ")))
+	}
+
+	// 链接（美化）
+	if resource.SaveURL != "" {
+		result.WriteString(fmt.Sprintf("\n📥 转存链接:\n   %s", resource.SaveURL))
+	} else if resource.URL != "" {
+		result.WriteString(fmt.Sprintf("\n🔗 资源链接:\n   %s", resource.URL))
+	}
+
+	// 添加操作提示
+	result.WriteString(fmt.Sprintf("\n\n💡 提示：回复\"获取 %d\"可再次查看此资源", index))
+
+	return message.NewText(result.String()), nil
+}
+
+// formatSearchResultsWithPagination 格式化带分页的搜索结果
+func (s *WechatBotServiceImpl) formatSearchResultsWithPagination(keyword string, resources []entity.Resource, userID string) string {
+	currentPage, totalPages, _, _ := s.searchSessionManager.GetPageInfo(userID)
+	return s.formatPageResources(keyword, resources, currentPage, totalPages, userID)
+}
+
+// formatPageResources 格式化页面资源
+// 根据用户需求，搜索结果中不显示资源链接，只显示标题和描述
+func (s *WechatBotServiceImpl) formatPageResources(keyword string, resources []entity.Resource, currentPage, totalPages int, userID string) string {
+	var result strings.Builder
+	result.WriteString(fmt.Sprintf("🔍 搜索\"%s\"的结果（第%d/%d页）：\n\n", keyword, currentPage, totalPages))
+
+	for i, resource := range resources {
+		// 构建当前资源的文本表示
+		var resourceText strings.Builder
+
+		// 计算全局索引（当前页的第i个资源在整个结果中的位置）
+		globalIndex := (currentPage-1)*4 + i + 1
+		resourceText.WriteString(fmt.Sprintf("%d. 📌 %s\n", globalIndex, resource.Title))
+
+		if resource.Description != "" {
+			// 限制描述长度以避免消息过长（正确处理中文字符）
+			desc := resource.Description
+			// 将字符串转换为 rune 切片以正确处理中文字符
+			runes := []rune(desc)
+			if len(runes) > 50 {
+				desc = string(runes[:50]) + "..."
+			}
+			resourceText.WriteString(fmt.Sprintf("   📝 %s\n", desc))
+		}
+
+		// 添加标签显示（格式：🏷️标签,空格,再接别的标签）
+		if len(resource.Tags) > 0 {
+			var tags []string
+			for _, tag := range resource.Tags {
+				tags = append(tags, "🏷️"+tag.Name)
+			}
+			// 限制标签数量以避免消息过长
+			if len(tags) > 5 {
+				tags = tags[:5]
+			}
+			resourceText.WriteString(fmt.Sprintf("   %s\n", strings.Join(tags, " ")))
+		}
+
+		resourceText.WriteString(fmt.Sprintf("   👉 回复\"获取 %d\"查看详细信息\n", globalIndex))
+		resourceText.WriteString("\n")
+
+		// 预计算添加当前资源后的消息长度
+		tempMessage := result.String() + resourceText.String()
+
+		// 添加分页提示和预留空间
+		if currentPage > 1 || currentPage < totalPages {
+			tempMessage += "💡 提示：回复\""
+			if currentPage > 1 && currentPage < totalPages {
+				tempMessage += "上一页\"或\"下一页"
+			} else if currentPage > 1 {
+				tempMessage += "上一页"
+			} else {
+				tempMessage += "下一页"
+			}
+			tempMessage += "\"翻页\n"
+		}
+
+		// 检查添加当前资源后是否会超过微信限制
+		tempRunes := []rune(tempMessage)
+		if len(tempRunes) > 550 {
+			result.WriteString("💡 内容较多，请翻页查看更多\n")
+			break
+		}
+
+		// 如果不会超过限制，则添加当前资源到结果中
+		result.WriteString(resourceText.String())
+	}
+
+	// 添加分页提示
+	var pageTips []string
+	if currentPage > 1 {
+		pageTips = append(pageTips, "上一页")
+	}
+	if currentPage < totalPages {
+		pageTips = append(pageTips, "下一页")
+	}
+
+	if len(pageTips) > 0 {
+		result.WriteString(fmt.Sprintf("💡 提示：回复\"%s\"翻页\n", strings.Join(pageTips, "\"或\"")))
+	}
+
+	// 确保消息不超过微信限制（正确处理中文字符）
+	message := result.String()
+	// 将字符串转换为 rune 切片以正确处理中文字符
+	runes := []rune(message)
+	if len(runes) > 600 {
+		// 如果还是超过限制，截断消息（微信建议不超过600个字符）
+		message = string(runes[:597]) + "..."
+	}
+
+	return message
+}
+
+// handleEventMessage 处理事件消息
+func (s *WechatBotServiceImpl) handleEventMessage(msg *message.MixMessage) (interface{}, error) {
+	if msg.Event == message.EventSubscribe {
+		// 新用户关注
+		return message.NewText(s.config.WelcomeMessage), nil
+	}
+	return nil, nil
+}
+
+// SearchResources 搜索资源
+func (s *WechatBotServiceImpl) SearchResources(keyword string) ([]entity.Resource, error) {
+	// 使用统一搜索函数（包含Meilisearch优先搜索和违禁词处理）
+	return UnifiedSearchResources(keyword, s.config.SearchLimit, s.systemConfigRepo, s.resourceRepo)
+}
+
+// formatSearchResults 格式化搜索结果
+func (s *WechatBotServiceImpl) formatSearchResults(keyword string, resources []entity.Resource) string {
+	var result strings.Builder
+	result.WriteString(fmt.Sprintf("🔍 搜索\"%s\"的结果（共%d条）：\n\n", keyword, len(resources)))
+
+	for i, resource := range resources {
+		result.WriteString(fmt.Sprintf("%d. %s\n", i+1, resource.Title))
+		if resource.Cover != "" {
+			result.WriteString(fmt.Sprintf("   ![封面](%s)\n", resource.Cover))
+		}
+		if resource.Description != "" {
+			desc := resource.Description
+			if len(desc) > 50 {
+				desc = desc[:50] + "..."
+			}
+			result.WriteString(fmt.Sprintf("   %s\n", desc))
+		}
+		if resource.SaveURL != "" {
+			result.WriteString(fmt.Sprintf("   转存链接：%s\n", resource.SaveURL))
+		} else if resource.URL != "" {
+			result.WriteString(fmt.Sprintf("   资源链接：%s\n", resource.URL))
+		}
+		result.WriteString("\n")
+	}
+
+	result.WriteString("💡 提示：回复资源编号可获取详细信息")
+	return result.String()
+}
+
+// SendWelcomeMessage 发送欢迎消息（预留接口，实际通过事件处理）
+func (s *WechatBotServiceImpl) SendWelcomeMessage(openID string) error {
+	// 实际上欢迎消息是通过关注事件自动发送的
+	// 这里提供一个手动发送的接口
+	if !s.isRunning || s.wechatClient == nil {
+		return fmt.Errorf("微信客户端未初始化")
+	}
+
+	// 注意：Customer API 需要额外的权限，这里仅作示例
+	// 实际应用中可能需要使用模板消息或其他方式
+	return nil
+}

task/expansion_processor.go

@@ -53,25 +53,47 @@ type ExpansionOutput struct {
 
 // Process 处理扩容任务项
 func (ep *ExpansionProcessor) Process(ctx context.Context, taskID uint, item *entity.TaskItem) error {
-	utils.Info("开始处理扩容任务项: %d", item.ID)
+	startTime := utils.GetCurrentTime()
+	utils.InfoWithFields(map[string]interface{}{
+		"task_item_id": item.ID,
+		"task_id":      taskID,
+	}, "开始处理扩容任务项: %d", item.ID)
 
 	// 解析输入数据
+	parseStart := utils.GetCurrentTime()
 	var input ExpansionInput
 	if err := json.Unmarshal([]byte(item.InputData), &input); err != nil {
+		parseDuration := time.Since(parseStart)
+		utils.ErrorWithFields(map[string]interface{}{
+		"error":       err.Error(),
+		"duration_ms": parseDuration.Milliseconds(),
+	}, "解析输入数据失败: %v，耗时: %v", err, parseDuration)
 		return fmt.Errorf("解析输入数据失败: %v", err)
 	}
+	parseDuration := time.Since(parseStart)
+	utils.DebugWithFields(map[string]interface{}{
+		"duration_ms": parseDuration.Milliseconds(),
+	}, "解析输入数据完成，耗时: %v", parseDuration)
 
 	// 验证输入数据
+	validateStart := utils.GetCurrentTime()
 	if err := ep.validateInput(&input); err != nil {
+		validateDuration := time.Since(validateStart)
+		utils.Error("输入数据验证失败: %v，耗时: %v", err, validateDuration)
 		return fmt.Errorf("输入数据验证失败: %v", err)
 	}
+	validateDuration := time.Since(validateStart)
+	utils.Debug("输入数据验证完成，耗时: %v", validateDuration)
 
 	// 检查账号是否已经扩容过
+	checkExpansionStart := utils.GetCurrentTime()
 	exists, err := ep.checkExpansionExists(input.PanAccountID)
+	checkExpansionDuration := time.Since(checkExpansionStart)
 	if err != nil {
-		utils.Error("检查扩容记录失败: %v", err)
+		utils.Error("检查扩容记录失败: %v，耗时: %v", err, checkExpansionDuration)
 		return fmt.Errorf("检查扩容记录失败: %v", err)
 	}
+	utils.Debug("检查扩容记录完成，耗时: %v", checkExpansionDuration)
 
 	if exists {
 		output := ExpansionOutput{
@@ -89,7 +111,9 @@ func (ep *ExpansionProcessor) Process(ctx context.Context, taskID uint, item *en
 	}
 
 	// 检查账号类型（只支持quark账号）
+	checkAccountTypeStart := utils.GetCurrentTime()
 	if err := ep.checkAccountType(input.PanAccountID); err != nil {
+		checkAccountTypeDuration := time.Since(checkAccountTypeStart)
 		output := ExpansionOutput{
 			Success: false,
 			Message: "账号类型不支持扩容",
@@ -100,12 +124,16 @@ func (ep *ExpansionProcessor) Process(ctx context.Context, taskID uint, item *en
 		outputJSON, _ := json.Marshal(output)
 		item.OutputData = string(outputJSON)
 
-		utils.Error("账号类型不支持扩容: %v", err)
+		utils.Error("账号类型不支持扩容: %v，耗时: %v", err, checkAccountTypeDuration)
 		return err
 	}
+	checkAccountTypeDuration := time.Since(checkAccountTypeStart)
+	utils.Debug("检查账号类型完成，耗时: %v", checkAccountTypeDuration)
 
 	// 执行扩容操作（传入数据源）
+	expansionStart := utils.GetCurrentTime()
 	transferred, err := ep.performExpansion(ctx, input.PanAccountID, input.DataSource)
+	expansionDuration := time.Since(expansionStart)
 	if err != nil {
 		output := ExpansionOutput{
 			Success: false,
@@ -117,9 +145,10 @@ func (ep *ExpansionProcessor) Process(ctx context.Context, taskID uint, item *en
 		outputJSON, _ := json.Marshal(output)
 		item.OutputData = string(outputJSON)
 
-		utils.Error("扩容任务项处理失败: %d, 错误: %v", item.ID, err)
+		utils.Error("扩容任务项处理失败: %d, 错误: %v，总耗时: %v", item.ID, err, expansionDuration)
 		return fmt.Errorf("扩容失败: %v", err)
 	}
+	utils.Debug("扩容操作完成，耗时: %v", expansionDuration)
 
 	// 扩容成功
 	output := ExpansionOutput{
@@ -132,27 +161,44 @@ func (ep *ExpansionProcessor) Process(ctx context.Context, taskID uint, item *en
 	outputJSON, _ := json.Marshal(output)
 	item.OutputData = string(outputJSON)
 
-	utils.Info("扩容任务项处理完成: %d, 账号ID: %d", item.ID, input.PanAccountID)
+	elapsedTime := time.Since(startTime)
+	utils.InfoWithFields(map[string]interface{}{
+		"task_item_id": item.ID,
+		"account_id":   input.PanAccountID,
+		"duration_ms":  elapsedTime.Milliseconds(),
+	}, "扩容任务项处理完成: %d, 账号ID: %d, 总耗时: %v", item.ID, input.PanAccountID, elapsedTime)
 	return nil
 }
 
 // validateInput 验证输入数据
 func (ep *ExpansionProcessor) validateInput(input *ExpansionInput) error {
+	startTime := utils.GetCurrentTime()
+
 	if input.PanAccountID == 0 {
+		utils.Error("账号ID验证失败，账号ID不能为空，耗时: %v", time.Since(startTime))
 		return fmt.Errorf("账号ID不能为空")
 	}
+
+	utils.Debug("输入数据验证完成，耗时: %v", time.Since(startTime))
 	return nil
 }
 
 // checkExpansionExists 检查账号是否已经扩容过
 func (ep *ExpansionProcessor) checkExpansionExists(panAccountID uint) (bool, error) {
+	startTime := utils.GetCurrentTime()
+
 	// 查询所有expansion类型的任务
+	tasksStart := utils.GetCurrentTime()
 	tasks, _, err := ep.repoMgr.TaskRepository.GetList(1, 1000, "expansion", "completed")
+	tasksDuration := time.Since(tasksStart)
 	if err != nil {
+		utils.Error("获取扩容任务列表失败: %v，耗时: %v", err, tasksDuration)
 		return false, fmt.Errorf("获取扩容任务列表失败: %v", err)
 	}
+	utils.Debug("获取扩容任务列表完成，找到 %d 个任务，耗时: %v", len(tasks), tasksDuration)
 
 	// 检查每个任务的配置中是否包含该账号ID
+	checkStart := utils.GetCurrentTime()
 	for _, task := range tasks {
 		if task.Config != "" {
 			var taskConfig map[string]interface{}
@@ -162,6 +208,8 @@ func (ep *ExpansionProcessor) checkExpansionExists(panAccountID uint) (bool, err
 						// 找到了该账号的扩容任务，检查任务状态
 						if task.Status == "completed" {
 							// 如果任务已完成，说明已经扩容过
+							checkDuration := time.Since(checkStart)
+							utils.Debug("检查扩容记录完成，账号已扩容，耗时: %v", checkDuration)
 							return true, nil
 						}
 					}
@@ -169,40 +217,63 @@ func (ep *ExpansionProcessor) checkExpansionExists(panAccountID uint) (bool, err
 			}
 		}
 	}
+	checkDuration := time.Since(checkStart)
+	utils.Debug("检查扩容记录完成，账号未扩容，耗时: %v", checkDuration)
 
+	totalDuration := time.Since(startTime)
+	utils.Debug("检查扩容记录完成，账号未扩容，总耗时: %v", totalDuration)
 	return false, nil
 }
 
 // checkAccountType 检查账号类型（只支持quark账号）
 func (ep *ExpansionProcessor) checkAccountType(panAccountID uint) error {
+	startTime := utils.GetCurrentTime()
+
 	// 获取账号信息
+	accountStart := utils.GetCurrentTime()
 	cks, err := ep.repoMgr.CksRepository.FindByID(panAccountID)
+	accountDuration := time.Since(accountStart)
 	if err != nil {
+		utils.Error("获取账号信息失败: %v，耗时: %v", err, accountDuration)
 		return fmt.Errorf("获取账号信息失败: %v", err)
 	}
+	utils.Debug("获取账号信息完成，耗时: %v", accountDuration)
 
 	// 检查是否为quark账号
+	serviceCheckStart := utils.GetCurrentTime()
 	if cks.ServiceType != "quark" {
+		serviceCheckDuration := time.Since(serviceCheckStart)
+		utils.Error("账号类型检查失败，当前账号类型: %s，耗时: %v", cks.ServiceType, serviceCheckDuration)
 		return fmt.Errorf("只支持quark账号扩容，当前账号类型: %s", cks.ServiceType)
 	}
+	serviceCheckDuration := time.Since(serviceCheckStart)
+	utils.Debug("账号类型检查完成，为quark账号，耗时: %v", serviceCheckDuration)
 
+	totalDuration := time.Since(startTime)
+	utils.Debug("账号类型检查完成，总耗时: %v", totalDuration)
 	return nil
 }
 
 // performExpansion 执行扩容操作
 func (ep *ExpansionProcessor) performExpansion(ctx context.Context, panAccountID uint, dataSource map[string]interface{}) ([]TransferredResource, error) {
 	rand.Seed(time.Now().UnixNano())
+	startTime := utils.GetCurrentTime()
 	utils.Info("执行扩容操作，账号ID: %d, 数据源: %v", panAccountID, dataSource)
 
 	transferred := []TransferredResource{}
 
 	// 获取账号信息
+	accountStart := utils.GetCurrentTime()
 	account, err := ep.repoMgr.CksRepository.FindByID(panAccountID)
+	accountDuration := time.Since(accountStart)
 	if err != nil {
+		utils.Error("获取账号信息失败: %v，耗时: %v", err, accountDuration)
 		return nil, fmt.Errorf("获取账号信息失败: %v", err)
 	}
+	utils.Debug("获取账号信息完成，耗时: %v", accountDuration)
 
 	// 创建网盘服务工厂
+	serviceStart := utils.GetCurrentTime()
 	factory := pan.NewPanFactory()
 	service, err := factory.CreatePanServiceByType(pan.Quark, &pan.PanConfig{
 		URL:         "",
@@ -210,10 +281,13 @@ func (ep *ExpansionProcessor) performExpansion(ctx context.Context, panAccountID
 		IsType:      0,
 		Cookie:      account.Ck,
 	})
+	serviceDuration := time.Since(serviceStart)
 	if err != nil {
+		utils.Error("创建网盘服务失败: %v，耗时: %v", err, serviceDuration)
 		return nil, fmt.Errorf("创建网盘服务失败: %v", err)
 	}
 	service.SetCKSRepository(ep.repoMgr.CksRepository, *account)
+	utils.Debug("创建网盘服务完成，耗时: %v", serviceDuration)
 
 	// 定义扩容分类列表（按优先级排序）
 	categories := []string{
@@ -246,11 +320,14 @@ func (ep *ExpansionProcessor) performExpansion(ctx context.Context, panAccountID
 		utils.Info("开始处理分类: %s", category)
 
 		// 获取该分类的资源
+		resourcesStart := utils.GetCurrentTime()
 		resources, err := ep.getHotResources(category)
+		resourcesDuration := time.Since(resourcesStart)
 		if err != nil {
-			utils.Error("获取分类 %s 的资源失败: %v", category, err)
+			utils.Error("获取分类 %s 的资源失败: %v，耗时: %v", category, err, resourcesDuration)
 			continue
 		}
+		utils.Debug("获取分类 %s 的资源完成，耗时: %v", category, resourcesDuration)
 
 		if len(resources) == 0 {
 			utils.Info("分类 %s 没有可用资源，跳过", category)
@@ -269,11 +346,14 @@ func (ep *ExpansionProcessor) performExpansion(ctx context.Context, panAccountID
 			}
 
 			// 检查是否还有存储空间
+			storageCheckStart := utils.GetCurrentTime()
 			hasSpace, err := ep.checkStorageSpace(service, &account.Ck)
+			storageCheckDuration := time.Since(storageCheckStart)
 			if err != nil {
-				utils.Error("检查存储空间失败: %v", err)
+				utils.Error("检查存储空间失败: %v，耗时: %v", err, storageCheckDuration)
 				return transferred, fmt.Errorf("检查存储空间失败: %v", err)
 			}
+			utils.Debug("检查存储空间完成，耗时: %v", storageCheckDuration)
 
 			if !hasSpace {
 				utils.Info("存储空间不足，停止扩容，但保存已转存的资源")
@@ -282,24 +362,30 @@ func (ep *ExpansionProcessor) performExpansion(ctx context.Context, panAccountID
 			}
 
 			// 获取资源 , dataSourceType, thirdPartyURL
+			resourceGetStart := utils.GetCurrentTime()
 			resource, err := ep.getResourcesByHot(resource, dataSourceType, thirdPartyURL, *account, service)
+			resourceGetDuration := time.Since(resourceGetStart)
 			if resource == nil || err != nil {
 				if resource != nil {
-					utils.Error("获取资源失败: %s, 错误: %v", resource.Title, err)
+					utils.Error("获取资源失败: %s, 错误: %v，耗时: %v", resource.Title, err, resourceGetDuration)
 				} else {
-					utils.Error("获取资源失败, 错误: %v", err)
+					utils.Error("获取资源失败, 错误: %v，耗时: %v", err, resourceGetDuration)
 				}
 				totalFailed++
 				continue
 			}
+			utils.Debug("获取资源完成，耗时: %v", resourceGetDuration)
 
 			// 执行转存
+			transferStart := utils.GetCurrentTime()
 			saveURL, err := ep.transferResource(ctx, service, resource, *account)
+			transferDuration := time.Since(transferStart)
 			if err != nil {
-				utils.Error("转存资源失败: %s, 错误: %v", resource.Title, err)
+				utils.Error("转存资源失败: %s, 错误: %v，耗时: %v", resource.Title, err, transferDuration)
 				totalFailed++
 				continue
 			}
+			utils.Debug("转存资源完成，耗时: %v", transferDuration)
 
 			// 随机休眠1-3秒，避免请求过于频繁
 			sleepDuration := time.Duration(rand.Intn(3)+1) * time.Second
@@ -324,7 +410,8 @@ func (ep *ExpansionProcessor) performExpansion(ctx context.Context, panAccountID
 		utils.Info("分类 %s 处理完成，转存 %d 个资源", category, transferredCount)
 	}
 
-	utils.Info("扩容完成，总共转存: %d 个资源，失败: %d 个资源", totalTransferred, totalFailed)
+	elapsedTime := time.Since(startTime)
+	utils.Info("扩容完成，总共转存: %d 个资源，失败: %d 个资源，总耗时: %v", totalTransferred, totalFailed, elapsedTime)
 	return transferred, nil
 }
 
@@ -335,27 +422,45 @@ func (ep *ExpansionProcessor) getResourcesByHot(
 	entity entity.Cks,
 	service pan.PanService,
 ) (*entity.Resource, error) {
+	startTime := utils.GetCurrentTime()
+
 	if dataSourceType == "third-party" && thirdPartyURL != "" {
 		// 从第三方API获取资源
-		return ep.getResourcesFromThirdPartyAPI(resource, thirdPartyURL)
+		thirdPartyStart := utils.GetCurrentTime()
+		result, err := ep.getResourcesFromThirdPartyAPI(resource, thirdPartyURL)
+		thirdPartyDuration := time.Since(thirdPartyStart)
+		utils.Debug("从第三方API获取资源完成，耗时: %v", thirdPartyDuration)
+		return result, err
 	}
 
 	// 从内部数据库获取资源
-	return ep.getResourcesFromInternalDB(resource, entity, service)
+	internalStart := utils.GetCurrentTime()
+	result, err := ep.getResourcesFromInternalDB(resource, entity, service)
+	internalDuration := time.Since(internalStart)
+	utils.Debug("从内部数据库获取资源完成，耗时: %v", internalDuration)
+
+	totalDuration := time.Since(startTime)
+	utils.Debug("获取资源完成: %s，总耗时: %v", resource.Title, totalDuration)
+	return result, err
 }
 
 // getResourcesFromInternalDB 根据 HotDrama 的title 获取数据库中资源，并且资源的类型和 account 的资源类型一致
 func (ep *ExpansionProcessor) getResourcesFromInternalDB(HotDrama *entity.HotDrama, account entity.Cks, service pan.PanService) (*entity.Resource, error) {
+	startTime := utils.GetCurrentTime()
+
 	// 修改配置 isType = 1 只检测，不转存
+	configStart := utils.GetCurrentTime()
 	service.UpdateConfig(&pan.PanConfig{
 		URL:         "",
 		ExpiredType: 0,
 		IsType:      1,
 		Cookie:      account.Ck,
 	})
+	utils.Debug("更新服务配置完成，耗时: %v", time.Since(configStart))
 	panID := account.PanID
 
 	// 1. 搜索标题
+	searchStart := utils.GetCurrentTime()
 	params := map[string]interface{}{
 		"search":    HotDrama.Title,
 		"pan_id":    panID,
@@ -364,11 +469,15 @@ func (ep *ExpansionProcessor) getResourcesFromInternalDB(HotDrama *entity.HotDra
 		"page_size": 10,
 	}
 	resources, _, err := ep.repoMgr.ResourceRepository.SearchWithFilters(params)
+	searchDuration := time.Since(searchStart)
 	if err != nil {
+		utils.Error("搜索资源失败: %v，耗时: %v", err, searchDuration)
 		return nil, fmt.Errorf("搜索资源失败: %v", err)
 	}
+	utils.Debug("搜索资源完成，找到 %d 个资源，耗时: %v", len(resources), searchDuration)
 
 	// 检查结果是否有效，通过服务验证
+	validateStart := utils.GetCurrentTime()
 	for _, res := range resources {
 		if res.IsValid && res.URL != "" {
 			// 使用服务验证资源是否可转存
@@ -376,38 +485,59 @@ func (ep *ExpansionProcessor) getResourcesFromInternalDB(HotDrama *entity.HotDra
 			if shareID != "" {
 				result, err := service.Transfer(shareID)
 				if err == nil && result != nil && result.Success {
+					validateDuration := time.Since(validateStart)
+					utils.Debug("验证资源成功: %s，耗时: %v", res.Title, validateDuration)
 					return &res, nil
 				}
 			}
 		}
 	}
+	validateDuration := time.Since(validateStart)
+	utils.Debug("验证资源完成，未找到有效资源，耗时: %v", validateDuration)
 
+	totalDuration := time.Since(startTime)
+	utils.Debug("从内部数据库获取资源完成: %s，总耗时: %v", HotDrama.Title, totalDuration)
 	// 3. 没有有效资源，返回错误信息
 	return nil, fmt.Errorf("未找到有效的资源")
 }
 
 // getResourcesFromInternalDB 从内部数据库获取资源
 func (ep *ExpansionProcessor) getHotResources(category string) ([]*entity.HotDrama, error) {
+	startTime := utils.GetCurrentTime()
+
 	// 获取该分类下sub_type为"排行"的资源
+	rankedStart := utils.GetCurrentTime()
 	dramas, _, err := ep.repoMgr.HotDramaRepository.FindByCategoryAndSubType(category, "排行", 1, 20)
+	rankedDuration := time.Since(rankedStart)
 	if err != nil {
+		utils.Error("获取分类 %s 的排行资源失败: %v，耗时: %v", category, err, rankedDuration)
 		return nil, fmt.Errorf("获取分类 %s 的资源失败: %v", category, err)
 	}
+	utils.Debug("获取分类 %s 的排行资源完成，找到 %d 个资源，耗时: %v", category, len(dramas), rankedDuration)
 
 	// 如果没有找到"排行"类型的资源，尝试获取该分类下的所有资源
 	if len(dramas) == 0 {
+		allStart := utils.GetCurrentTime()
 		dramas, _, err = ep.repoMgr.HotDramaRepository.FindByCategory(category, 1, 20)
+		allDuration := time.Since(allStart)
 		if err != nil {
+			utils.Error("获取分类 %s 的所有资源失败: %v，耗时: %v", category, err, allDuration)
 			return nil, fmt.Errorf("获取分类 %s 的资源失败: %v", category, err)
 		}
+		utils.Debug("获取分类 %s 的所有资源完成，找到 %d 个资源，耗时: %v", category, len(dramas), allDuration)
 	}
 
 	// 转换为指针数组
+	convertStart := utils.GetCurrentTime()
 	result := make([]*entity.HotDrama, len(dramas))
 	for i := range dramas {
 		result[i] = &dramas[i]
 	}
+	convertDuration := time.Since(convertStart)
+	utils.Debug("转换资源数组完成，耗时: %v", convertDuration)
 
+	totalDuration := time.Since(startTime)
+	utils.Debug("获取热门资源完成: 分类 %s，总数 %d，总耗时: %v", category, len(result), totalDuration)
 	return result, nil
 }
 
@@ -423,50 +553,69 @@ func (ep *ExpansionProcessor) getResourcesFromThirdPartyAPI(resource *entity.Hot
 
 // checkStorageSpace 检查存储空间是否足够
 func (ep *ExpansionProcessor) checkStorageSpace(service pan.PanService, ck *string) (bool, error) {
+	startTime := utils.GetCurrentTime()
+
+	userInfoStart := utils.GetCurrentTime()
 	userInfo, err := service.GetUserInfo(ck)
+	userInfoDuration := time.Since(userInfoStart)
 	if err != nil {
-		utils.Error("获取用户信息失败: %v", err)
+		utils.Error("获取用户信息失败: %v，耗时: %v", err, userInfoDuration)
 		// 如果无法获取用户信息，假设还有空间继续
 		return true, nil
 	}
+	utils.Debug("获取用户信息完成，耗时: %v", userInfoDuration)
 
 	// 检查是否还有足够的空间（保留至少10GB空间）
 	const reservedSpaceGB = 100
 	reservedSpaceBytes := int64(reservedSpaceGB * 1024 * 1024 * 1024)
 
 	if userInfo.TotalSpace-userInfo.UsedSpace <= reservedSpaceBytes {
-		utils.Info("存储空间不足，已使用: %d bytes，总容量: %d bytes",
-			userInfo.UsedSpace, userInfo.TotalSpace)
+		utils.Info("存储空间不足，已使用: %d bytes，总容量: %d bytes，检查耗时: %v",
+			userInfo.UsedSpace, userInfo.TotalSpace, time.Since(startTime))
 		return false, nil
 	}
 
+	totalDuration := time.Since(startTime)
+	utils.Debug("存储空间检查完成，有足够空间，耗时: %v", totalDuration)
 	return true, nil
 }
 
 // transferResource 执行单个资源的转存
 func (ep *ExpansionProcessor) transferResource(ctx context.Context, service pan.PanService, res *entity.Resource, account entity.Cks) (string, error) {
+	startTime := utils.GetCurrentTime()
+
 	// 修改配置 isType = 0 转存
+	configStart := utils.GetCurrentTime()
 	service.UpdateConfig(&pan.PanConfig{
 		URL:         "",
 		ExpiredType: 0,
 		IsType:      0,
 		Cookie:      account.Ck,
 	})
+	utils.Debug("更新服务配置完成，耗时: %v", time.Since(configStart))
 
 	// 如果没有URL，跳过转存
 	if res.URL == "" {
+		utils.Error("资源 %s 没有有效的URL", res.URL)
 		return "", fmt.Errorf("资源 %s 没有有效的URL", res.URL)
 	}
 
 	// 提取分享ID
+	extractStart := utils.GetCurrentTime()
 	shareID, _ := pan.ExtractShareId(res.URL)
+	extractDuration := time.Since(extractStart)
 	if shareID == "" {
+		utils.Error("无法从URL %s 提取分享ID，耗时: %v", res.URL, extractDuration)
 		return "", fmt.Errorf("无法从URL %s 提取分享ID", res.URL)
 	}
+	utils.Debug("提取分享ID完成: %s，耗时: %v", shareID, extractDuration)
 
 	// 执行转存
+	transferStart := utils.GetCurrentTime()
 	result, err := service.Transfer(shareID)
+	transferDuration := time.Since(transferStart)
 	if err != nil {
+		utils.Error("转存失败: %v，耗时: %v", err, transferDuration)
 		return "", fmt.Errorf("转存失败: %v", err)
 	}
 
@@ -475,10 +624,12 @@ func (ep *ExpansionProcessor) transferResource(ctx context.Context, service pan.
 		if result != nil {
 			errorMsg = result.Message
 		}
+		utils.Error("转存结果失败: %s，耗时: %v", errorMsg, time.Since(transferStart))
 		return "", fmt.Errorf("转存失败: %s", errorMsg)
 	}
 
 	// 提取转存链接
+	extractURLStart := utils.GetCurrentTime()
 	var saveURL string
 	if result.Data != nil {
 		if data, ok := result.Data.(map[string]interface{}); ok {
@@ -490,11 +641,14 @@ func (ep *ExpansionProcessor) transferResource(ctx context.Context, service pan.
 	if saveURL == "" {
 		saveURL = result.ShareURL
 	}
-
 	if saveURL == "" {
+		extractURLDuration := time.Since(extractURLStart)
+		utils.Error("转存成功但未获取到分享链接，耗时: %v", extractURLDuration)
 		return "", fmt.Errorf("转存成功但未获取到分享链接")
 	}
 
+	totalDuration := time.Since(startTime)
+	utils.Debug("转存资源完成: %s -> %s，总耗时: %v", res.Title, saveURL, totalDuration)
 	return saveURL, nil
 }
 

task/task_processor.go

@@ -5,6 +5,7 @@ import (
 	"encoding/json"
 	"fmt"
 	"sync"
+	"time"
 
 	"github.com/ctwj/urldb/db/entity"
 	"github.com/ctwj/urldb/db/repo"
@@ -90,7 +91,9 @@ func (tm *TaskManager) StartTask(taskID uint) error {
 	// 启动后台任务
 	go tm.processTask(ctx, task, processor)
 
-	utils.Info("StartTask: 任务 %d 启动成功", taskID)
+	utils.InfoWithFields(map[string]interface{}{
+		"task_id": taskID,
+	}, "StartTask: 任务 %d 启动成功", taskID)
 	return nil
 }
 
@@ -185,14 +188,29 @@ func (tm *TaskManager) StopTask(taskID uint) error {
 
 // processTask 处理任务
 func (tm *TaskManager) processTask(ctx context.Context, task *entity.Task, processor TaskProcessor) {
+	startTime := utils.GetCurrentTime()
+
+	// 记录任务开始
+	utils.Info("任务开始 - ID: %d, 类型: %s", task.ID, task.Type)
+
 	defer func() {
 		tm.mu.Lock()
 		delete(tm.running, task.ID)
 		tm.mu.Unlock()
-		utils.Debug("processTask: 任务 %d 处理完成，清理资源", task.ID)
+
+		elapsedTime := time.Since(startTime)
+		// 使用业务事件记录任务完成，只有异常情况才输出详细日志
+		if elapsedTime > 30*time.Second {
+			utils.Warn("任务处理耗时较长 - ID: %d, 类型: %s, 耗时: %v", task.ID, task.Type, elapsedTime)
+		}
+
+		utils.Info("任务完成 - ID: %d, 类型: %s, 耗时: %v", task.ID, task.Type, elapsedTime)
 	}()
 
-	utils.Debug("processTask: 开始处理任务: %d, 类型: %s", task.ID, task.Type)
+	utils.InfoWithFields(map[string]interface{}{
+		"task_id":   task.ID,
+		"task_type": task.Type,
+	}, "processTask: 开始处理任务: %d, 类型: %s", task.ID, task.Type)
 
 	// 更新任务状态为运行中
 	err := tm.repoMgr.TaskRepository.UpdateStatus(task.ID, "running")
@@ -208,7 +226,9 @@ func (tm *TaskManager) processTask(ctx context.Context, task *entity.Task, proce
 	}
 
 	// 获取任务项统计信息，用于计算正确的进度
+	statsStart := utils.GetCurrentTime()
 	stats, err := tm.repoMgr.TaskItemRepository.GetStatsByTaskID(task.ID)
+	statsDuration := time.Since(statsStart)
 	if err != nil {
 		utils.Error("获取任务项统计失败: %v", err)
 		stats = map[string]int{
@@ -218,14 +238,20 @@ func (tm *TaskManager) processTask(ctx context.Context, task *entity.Task, proce
 			"completed":  0,
 			"failed":     0,
 		}
+	} else {
+		utils.Debug("获取任务项统计完成，耗时: %v", statsDuration)
 	}
 
 	// 获取待处理的任务项
+	itemsStart := utils.GetCurrentTime()
 	items, err := tm.repoMgr.TaskItemRepository.GetByTaskIDAndStatus(task.ID, "pending")
+	itemsDuration := time.Since(itemsStart)
 	if err != nil {
 		utils.Error("获取任务项失败: %v", err)
 		tm.markTaskFailed(task.ID, fmt.Sprintf("获取任务项失败: %v", err))
 		return
+	} else {
+		utils.Debug("获取任务项完成，数量: %d，耗时: %v", len(items), itemsDuration)
 	}
 
 	// 计算总任务项数和已完成的项数
@@ -236,10 +262,14 @@ func (tm *TaskManager) processTask(ctx context.Context, task *entity.Task, proce
 
 	// 如果当前批次有处理中的任务项，重置它们为pending状态（服务器重启恢复）
 	if processingItems > 0 {
-		utils.Debug("任务 %d 发现 %d 个处理中的任务项，重置为pending状态", task.ID, processingItems)
+		utils.Info("任务 %d 发现 %d 个处理中的任务项，重置为pending状态", task.ID, processingItems)
+		resetStart := utils.GetCurrentTime()
 		err = tm.repoMgr.TaskItemRepository.ResetProcessingItems(task.ID)
+		resetDuration := time.Since(resetStart)
 		if err != nil {
 			utils.Error("重置处理中任务项失败: %v", err)
+		} else {
+			utils.Debug("重置处理中任务项完成，耗时: %v", resetDuration)
 		}
 		// 重新获取待处理的任务项
 		items, err = tm.repoMgr.TaskItemRepository.GetByTaskIDAndStatus(task.ID, "pending")
@@ -258,21 +288,35 @@ func (tm *TaskManager) processTask(ctx context.Context, task *entity.Task, proce
 	utils.Debug("任务 %d 统计信息: 总计=%d, 已完成=%d, 已失败=%d, 待处理=%d",
 		task.ID, totalItems, completedItems, failedItems, currentBatchItems)
 
-	for _, item := range items {
+	// 记录处理开始时间
+	batchStartTime := utils.GetCurrentTime()
+
+	for i, item := range items {
 		select {
 		case <-ctx.Done():
 			utils.Debug("任务 %d 被取消", task.ID)
 			return
 		default:
+			// 记录单个任务项处理开始时间
+			itemStartTime := utils.GetCurrentTime()
+
 			// 处理单个任务项
 			err := tm.processTaskItem(ctx, task.ID, item, processor)
 			processedItems++
 
+			// 记录单个任务项处理耗时
+			itemDuration := time.Since(itemStartTime)
+
 			if err != nil {
 				failedItems++
-				utils.Error("处理任务项 %d 失败: %v", item.ID, err)
+				utils.ErrorWithFields(map[string]interface{}{
+		"task_item_id": item.ID,
+		"error":        err.Error(),
+		"duration_ms":  itemDuration.Milliseconds(),
+	}, "处理任务项 %d 失败: %v，耗时: %v", item.ID, err, itemDuration)
 			} else {
 				successItems++
+				utils.Info("处理任务项 %d 成功，耗时: %v", item.ID, itemDuration)
 			}
 
 			// 更新任务进度（基于总任务项数）
@@ -280,9 +324,21 @@ func (tm *TaskManager) processTask(ctx context.Context, task *entity.Task, proce
 				progress := float64(processedItems) / float64(totalItems) * 100
 				tm.updateTaskProgress(task.ID, progress, processedItems, successItems, failedItems)
 			}
+
+			// 每处理10个任务项记录一次批处理进度
+			if (i+1)%10 == 0 || i == len(items)-1 {
+				batchDuration := time.Since(batchStartTime)
+				utils.Info("任务 %d 批处理进度: 已处理 %d/%d 项，成功 %d 项，失败 %d 项，当前批处理耗时: %v",
+					task.ID, processedItems, totalItems, successItems, failedItems, batchDuration)
+			}
 		}
 	}
 
+	// 记录整个批处理耗时
+	batchDuration := time.Since(batchStartTime)
+	utils.Info("任务 %d 批处理完成: 总计 %d 项，成功 %d 项，失败 %d 项，总耗时: %v",
+		task.ID, len(items), successItems, failedItems, batchDuration)
+
 	// 任务完成
 	status := "completed"
 	message := fmt.Sprintf("任务完成，共处理 %d 项，成功 %d 项，失败 %d 项", processedItems, successItems, failedItems)
@@ -308,25 +364,41 @@ func (tm *TaskManager) processTask(ctx context.Context, task *entity.Task, proce
 		}
 	}
 
-	utils.Info("任务 %d 处理完成: %s", task.ID, message)
+	utils.InfoWithFields(map[string]interface{}{
+		"task_id": task.ID,
+		"message": message,
+	}, "任务 %d 处理完成: %s", task.ID, message)
 }
 
 // processTaskItem 处理单个任务项
 func (tm *TaskManager) processTaskItem(ctx context.Context, taskID uint, item *entity.TaskItem, processor TaskProcessor) error {
+	itemStartTime := utils.GetCurrentTime()
+	utils.Debug("开始处理任务项: %d (任务ID: %d)", item.ID, taskID)
+
 	// 更新任务项状态为处理中
+	updateStart := utils.GetCurrentTime()
 	err := tm.repoMgr.TaskItemRepository.UpdateStatus(item.ID, "processing")
+	updateDuration := time.Since(updateStart)
 	if err != nil {
+		utils.Error("更新任务项状态失败: %v，耗时: %v", err, updateDuration)
 		return fmt.Errorf("更新任务项状态失败: %v", err)
+	} else {
+		utils.Debug("更新任务项状态为处理中完成，耗时: %v", updateDuration)
 	}
 
 	// 处理任务项
+	processStart := utils.GetCurrentTime()
 	err = processor.Process(ctx, taskID, item)
+	processDuration := time.Since(processStart)
 
 	if err != nil {
 		// 处理失败
+		utils.Error("处理任务项 %d 失败: %v，处理耗时: %v", item.ID, err, processDuration)
+
 		outputData := map[string]interface{}{
 			"error": err.Error(),
 			"time":  utils.GetCurrentTime(),
+			"duration_ms": processDuration.Milliseconds(),
 		}
 		outputJSON, _ := json.Marshal(outputData)
 
@@ -338,25 +410,49 @@ func (tm *TaskManager) processTaskItem(ctx context.Context, taskID uint, item *e
 	}
 
 	// 处理成功
+	utils.Info("处理任务项 %d 成功，处理耗时: %v", item.ID, processDuration)
+
 	// 如果处理器已经设置了 output_data（比如 ExpansionProcessor），则不覆盖
 	var outputJSON string
 	if item.OutputData == "" {
 		outputData := map[string]interface{}{
 			"success": true,
 			"time":    utils.GetCurrentTime(),
+			"duration_ms": processDuration.Milliseconds(),
 		}
 		outputBytes, _ := json.Marshal(outputData)
 		outputJSON = string(outputBytes)
 	} else {
-		// 使用处理器设置的 output_data
-		outputJSON = item.OutputData
+		// 使用处理器设置的 output_data，并添加处理时间信息
+		var existingOutput map[string]interface{}
+		if json.Unmarshal([]byte(item.OutputData), &existingOutput) == nil {
+			existingOutput["duration_ms"] = processDuration.Milliseconds()
+			outputBytes, _ := json.Marshal(existingOutput)
+			outputJSON = string(outputBytes)
+		} else {
+			// 如果无法解析现有输出，保留原样并添加时间信息
+			outputData := map[string]interface{}{
+				"original_output": item.OutputData,
+				"success": true,
+				"time":    utils.GetCurrentTime(),
+				"duration_ms": processDuration.Milliseconds(),
+			}
+			outputBytes, _ := json.Marshal(outputData)
+			outputJSON = string(outputBytes)
+		}
 	}
 
+	updateSuccessStart := utils.GetCurrentTime()
 	err = tm.repoMgr.TaskItemRepository.UpdateStatusAndOutput(item.ID, "completed", outputJSON)
+	updateSuccessDuration := time.Since(updateSuccessStart)
 	if err != nil {
-		utils.Error("更新成功任务项状态失败: %v", err)
+		utils.Error("更新成功任务项状态失败: %v，耗时: %v", err, updateSuccessDuration)
+	} else {
+		utils.Debug("更新成功任务项状态完成，耗时: %v", updateSuccessDuration)
 	}
 
+	itemDuration := time.Since(itemStartTime)
+	utils.Debug("任务项 %d 处理完成，总耗时: %v", item.ID, itemDuration)
 	return nil
 }
 

task/transfer_processor.go

@@ -51,20 +51,42 @@ type TransferOutput struct {
 
 // Process 处理转存任务项
 func (tp *TransferProcessor) Process(ctx context.Context, taskID uint, item *entity.TaskItem) error {
-	utils.Info("开始处理转存任务项: %d", item.ID)
+	startTime := utils.GetCurrentTime()
+	utils.InfoWithFields(map[string]interface{}{
+		"task_item_id": item.ID,
+		"task_id":      taskID,
+	}, "开始处理转存任务项: %d", item.ID)
 
 	// 解析输入数据
+	parseStart := utils.GetCurrentTime()
 	var input TransferInput
 	if err := json.Unmarshal([]byte(item.InputData), &input); err != nil {
+		parseDuration := time.Since(parseStart)
+		utils.ErrorWithFields(map[string]interface{}{
+		"error":       err.Error(),
+		"duration_ms": parseDuration.Milliseconds(),
+	}, "解析输入数据失败: %v，耗时: %v", err, parseDuration)
 		return fmt.Errorf("解析输入数据失败: %v", err)
 	}
+	parseDuration := time.Since(parseStart)
+	utils.DebugWithFields(map[string]interface{}{
+		"duration_ms": parseDuration.Milliseconds(),
+	}, "解析输入数据完成，耗时: %v", parseDuration)
 
 	// 验证输入数据
+	validateStart := utils.GetCurrentTime()
 	if err := tp.validateInput(&input); err != nil {
+		validateDuration := time.Since(validateStart)
+		utils.Error("输入数据验证失败: %v，耗时: %v", err, validateDuration)
 		return fmt.Errorf("输入数据验证失败: %v", err)
 	}
+	validateDuration := time.Since(validateStart)
+	utils.DebugWithFields(map[string]interface{}{
+		"duration_ms": validateDuration.Milliseconds(),
+	}, "输入数据验证完成，耗时: %v", validateDuration)
 
 	// 获取任务配置中的账号信息
+	configStart := utils.GetCurrentTime()
 	var selectedAccounts []uint
 	task, err := tp.repoMgr.TaskRepository.GetByID(taskID)
 	if err == nil && task.Config != "" {
@@ -79,15 +101,21 @@ func (tp *TransferProcessor) Process(ctx context.Context, taskID uint, item *ent
 			}
 		}
 	}
+	configDuration := time.Since(configStart)
+	utils.Debug("获取任务配置完成，耗时: %v", configDuration)
 
 	if len(selectedAccounts) == 0 {
 		utils.Error("失败: %v", "没有指定转存账号")
 	}
 
 	// 检查资源是否已存在
+	checkStart := utils.GetCurrentTime()
 	exists, existingResource, err := tp.checkResourceExists(input.URL)
+	checkDuration := time.Since(checkStart)
 	if err != nil {
-		utils.Error("检查资源是否存在失败: %v", err)
+		utils.Error("检查资源是否存在失败: %v，耗时: %v", err, checkDuration)
+	} else {
+		utils.Debug("检查资源是否存在完成，耗时: %v", checkDuration)
 	}
 
 	if exists {
@@ -107,19 +135,26 @@ func (tp *TransferProcessor) Process(ctx context.Context, taskID uint, item *ent
 			outputJSON, _ := json.Marshal(output)
 			item.OutputData = string(outputJSON)
 
-			utils.Info("资源已存在且有转存链接，跳过转存: %s", input.Title)
+			elapsedTime := time.Since(startTime)
+			utils.Info("资源已存在且有转存链接，跳过转存: %s，总耗时: %v", input.Title, elapsedTime)
 			return nil
 		}
 	}
 
 	// 查询出 账号列表
+	cksStart := utils.GetCurrentTime()
 	cks, err := tp.repoMgr.CksRepository.FindByIds(selectedAccounts)
+	cksDuration := time.Since(cksStart)
 	if err != nil {
-		utils.Error("读取账号失败: %v", err)
+		utils.Error("读取账号失败: %v，耗时: %v", err, cksDuration)
+	} else {
+		utils.Debug("读取账号完成，账号数量: %d，耗时: %v", len(cks), cksDuration)
 	}
 
 	// 执行转存操作
+	transferStart := utils.GetCurrentTime()
 	resourceID, saveURL, err := tp.performTransfer(ctx, &input, cks)
+	transferDuration := time.Since(transferStart)
 	if err != nil {
 		// 转存失败，更新输出数据
 		output := TransferOutput{
@@ -131,7 +166,13 @@ func (tp *TransferProcessor) Process(ctx context.Context, taskID uint, item *ent
 		outputJSON, _ := json.Marshal(output)
 		item.OutputData = string(outputJSON)
 
-		utils.Error("转存任务项处理失败: %d, 错误: %v", item.ID, err)
+		elapsedTime := time.Since(startTime)
+		utils.ErrorWithFields(map[string]interface{}{
+			"task_item_id": item.ID,
+			"error":        err.Error(),
+			"duration_ms":  transferDuration.Milliseconds(),
+			"total_ms":     elapsedTime.Milliseconds(),
+		}, "转存任务项处理失败: %d, 错误: %v，转存耗时: %v，总耗时: %v", item.ID, err, transferDuration, elapsedTime)
 		return fmt.Errorf("转存失败: %v", err)
 	}
 
@@ -146,7 +187,8 @@ func (tp *TransferProcessor) Process(ctx context.Context, taskID uint, item *ent
 		outputJSON, _ := json.Marshal(output)
 		item.OutputData = string(outputJSON)
 
-		utils.Error("转存任务项处理失败: %d, 未获取到分享链接", item.ID)
+		elapsedTime := time.Since(startTime)
+		utils.Error("转存任务项处理失败: %d, 未获取到分享链接，总耗时: %v", item.ID, elapsedTime)
 		return fmt.Errorf("转存成功但未获取到分享链接")
 	}
 
@@ -161,7 +203,14 @@ func (tp *TransferProcessor) Process(ctx context.Context, taskID uint, item *ent
 	outputJSON, _ := json.Marshal(output)
 	item.OutputData = string(outputJSON)
 
-	utils.Info("转存任务项处理完成: %d, 资源ID: %d, 转存链接: %s", item.ID, resourceID, saveURL)
+	elapsedTime := time.Since(startTime)
+	utils.InfoWithFields(map[string]interface{}{
+		"task_item_id":     item.ID,
+		"resource_id":      resourceID,
+		"save_url":         saveURL,
+		"transfer_duration_ms": transferDuration.Milliseconds(),
+		"total_duration_ms":    elapsedTime.Milliseconds(),
+	}, "转存任务项处理完成: %d, 资源ID: %d, 转存链接: %s，转存耗时: %v，总耗时: %v", item.ID, resourceID, saveURL, transferDuration, elapsedTime)
 	return nil
 }
 

utils/cache.go

@@ -0,0 +1,204 @@
+package utils
+
+import (
+	"sync"
+	"time"
+)
+
+// CacheData 缓存数据结构
+type CacheData struct {
+	Data      interface{}
+	UpdatedAt time.Time
+}
+
+// CacheManager 通用缓存管理器
+type CacheManager struct {
+	cache map[string]*CacheData
+	mutex sync.RWMutex
+}
+
+// NewCacheManager 创建缓存管理器
+func NewCacheManager() *CacheManager {
+	return &CacheManager{
+		cache: make(map[string]*CacheData),
+	}
+}
+
+// Set 设置缓存
+func (cm *CacheManager) Set(key string, data interface{}) {
+	cm.mutex.Lock()
+	defer cm.mutex.Unlock()
+	cm.cache[key] = &CacheData{
+		Data:      data,
+		UpdatedAt: time.Now(),
+	}
+}
+
+// Get 获取缓存
+func (cm *CacheManager) Get(key string, ttl time.Duration) (interface{}, bool) {
+	cm.mutex.RLock()
+	defer cm.mutex.RUnlock()
+
+	if cachedData, exists := cm.cache[key]; exists {
+		if time.Since(cachedData.UpdatedAt) < ttl {
+			return cachedData.Data, true
+		}
+		// 缓存过期，删除
+		delete(cm.cache, key)
+	}
+	return nil, false
+}
+
+// GetWithTTL 获取缓存并返回剩余TTL
+func (cm *CacheManager) GetWithTTL(key string, ttl time.Duration) (interface{}, bool, time.Duration) {
+	cm.mutex.RLock()
+	defer cm.mutex.RUnlock()
+
+	if cachedData, exists := cm.cache[key]; exists {
+		elapsed := time.Since(cachedData.UpdatedAt)
+		if elapsed < ttl {
+			return cachedData.Data, true, ttl - elapsed
+		}
+		// 缓存过期，删除
+		delete(cm.cache, key)
+	}
+	return nil, false, 0
+}
+
+// Delete 删除缓存
+func (cm *CacheManager) Delete(key string) {
+	cm.mutex.Lock()
+	defer cm.mutex.Unlock()
+	delete(cm.cache, key)
+}
+
+// DeletePattern 删除匹配模式的缓存
+func (cm *CacheManager) DeletePattern(pattern string) {
+	cm.mutex.Lock()
+	defer cm.mutex.Unlock()
+
+	for key := range cm.cache {
+		// 简单的字符串匹配，可以根据需要扩展为正则表达式
+		if len(pattern) > 0 && (key == pattern || (len(key) >= len(pattern) && key[:len(pattern)] == pattern)) {
+			delete(cm.cache, key)
+		}
+	}
+}
+
+// Clear 清空所有缓存
+func (cm *CacheManager) Clear() {
+	cm.mutex.Lock()
+	defer cm.mutex.Unlock()
+	cm.cache = make(map[string]*CacheData)
+}
+
+// Size 获取缓存项数量
+func (cm *CacheManager) Size() int {
+	cm.mutex.RLock()
+	defer cm.mutex.RUnlock()
+	return len(cm.cache)
+}
+
+// CleanExpired 清理过期缓存
+func (cm *CacheManager) CleanExpired(ttl time.Duration) int {
+	cm.mutex.Lock()
+	defer cm.mutex.Unlock()
+
+	cleaned := 0
+	now := time.Now()
+	for key, cachedData := range cm.cache {
+		if now.Sub(cachedData.UpdatedAt) >= ttl {
+			delete(cm.cache, key)
+			cleaned++
+		}
+	}
+	return cleaned
+}
+
+// GetKeys 获取所有缓存键
+func (cm *CacheManager) GetKeys() []string {
+	cm.mutex.RLock()
+	defer cm.mutex.RUnlock()
+
+	keys := make([]string, 0, len(cm.cache))
+	for key := range cm.cache {
+		keys = append(keys, key)
+	}
+	return keys
+}
+
+// 全局缓存管理器实例
+var (
+	// 热门资源缓存
+	HotResourcesCache = NewCacheManager()
+
+	// 相关资源缓存
+	RelatedResourcesCache = NewCacheManager()
+
+	// 系统配置缓存
+	SystemConfigCache = NewCacheManager()
+
+	// 分类缓存
+	CategoriesCache = NewCacheManager()
+
+	// 标签缓存
+	TagsCache = NewCacheManager()
+
+	// 资源有效性检测缓存
+	ResourceValidityCache = NewCacheManager()
+)
+
+// GetHotResourcesCache 获取热门资源缓存管理器
+func GetHotResourcesCache() *CacheManager {
+	return HotResourcesCache
+}
+
+// GetRelatedResourcesCache 获取相关资源缓存管理器
+func GetRelatedResourcesCache() *CacheManager {
+	return RelatedResourcesCache
+}
+
+// GetSystemConfigCache 获取系统配置缓存管理器
+func GetSystemConfigCache() *CacheManager {
+	return SystemConfigCache
+}
+
+// GetCategoriesCache 获取分类缓存管理器
+func GetCategoriesCache() *CacheManager {
+	return CategoriesCache
+}
+
+// GetTagsCache 获取标签缓存管理器
+func GetTagsCache() *CacheManager {
+	return TagsCache
+}
+
+// GetResourceValidityCache 获取资源有效性检测缓存管理器
+func GetResourceValidityCache() *CacheManager {
+	return ResourceValidityCache
+}
+
+// ClearAllCaches 清空所有全局缓存
+func ClearAllCaches() {
+	HotResourcesCache.Clear()
+	RelatedResourcesCache.Clear()
+	SystemConfigCache.Clear()
+	CategoriesCache.Clear()
+	TagsCache.Clear()
+	ResourceValidityCache.Clear()
+}
+
+// CleanAllExpiredCaches 清理所有过期缓存
+func CleanAllExpiredCaches(ttl time.Duration) {
+	totalCleaned := 0
+	totalCleaned += HotResourcesCache.CleanExpired(ttl)
+	totalCleaned += RelatedResourcesCache.CleanExpired(ttl)
+	totalCleaned += SystemConfigCache.CleanExpired(ttl)
+	totalCleaned += CategoriesCache.CleanExpired(ttl)
+	totalCleaned += TagsCache.CleanExpired(ttl)
+	totalCleaned += ResourceValidityCache.CleanExpired(ttl)
+
+	if totalCleaned > 0 {
+		Info("清理过期缓存完成，共清理 %d 个缓存项", totalCleaned)
+	}
+}

utils/forbidden_words.go

@@ -130,7 +130,7 @@ func (p *ForbiddenWordsProcessor) ProcessForbiddenWords(text string, forbiddenWo
 
 // ParseForbiddenWordsConfig 解析违禁词配置字符串
 // 参数：
-//   - config: 违禁词配置字符串，多个词用逗号分隔
+//   - config: 违禁词配置字符串，多个词用逗号或换行符分隔
 //
 // 返回：
 //   - []string: 处理后的违禁词列表
@@ -139,16 +139,21 @@ func (p *ForbiddenWordsProcessor) ParseForbiddenWordsConfig(config string) []str
 		return nil
 	}
 
-	words := strings.Split(config, ",")
-	var cleanWords []string
-	for _, word := range words {
-		word = strings.TrimSpace(word)
-		if word != "" {
-			cleanWords = append(cleanWords, word)
+	var words []string
+	// 首先尝试用换行符分割
+	lines := strings.Split(config, "\n")
+	for _, line := range lines {
+		// 对每一行再用逗号分割（兼容两种格式）
+		parts := strings.Split(line, ",")
+		for _, part := range parts {
+			word := strings.TrimSpace(part)
+			if word != "" {
+				words = append(words, word)
+			}
 		}
 	}
 
-	return cleanWords
+	return words
 }
 
 // 全局实例，方便直接调用

utils/log_telegram.go

@@ -28,23 +28,40 @@ func GetTelegramLogs(startTime *time.Time, endTime *time.Time, limit int) ([]Tel
 		return []TelegramLogEntry{}, nil
 	}
 
-	files, err := filepath.Glob(filepath.Join(logDir, "app_*.log"))
+	// 查找所有日志文件，包括当前的app.log和历史日志文件
+	allFiles, err := filepath.Glob(filepath.Join(logDir, "*.log"))
 	if err != nil {
 		return nil, fmt.Errorf("查找日志文件失败: %v", err)
 	}
 
-	if len(files) == 0 {
+	if len(allFiles) == 0 {
 		return []TelegramLogEntry{}, nil
 	}
 
-	// 按时间排序，最近的在前面
-	sort.Sort(sort.Reverse(sort.StringSlice(files)))
+	// 将app.log放在最前面，其他文件按时间排序
+	var files []string
+	var otherFiles []string
+
+	for _, file := range allFiles {
+		if filepath.Base(file) == "app.log" {
+			files = append(files, file) // 当前日志文件优先
+		} else {
+			otherFiles = append(otherFiles, file)
+		}
+	}
+
+	// 其他文件按时间排序，最近的在前面
+	sort.Sort(sort.Reverse(sort.StringSlice(otherFiles)))
+	files = append(files, otherFiles...)
+
+	// files现在已经是app.log优先，然后是其他文件按时间倒序排列
 
 	var allEntries []TelegramLogEntry
 
 	// 编译Telegram相关的正则表达式
 	telegramRegex := regexp.MustCompile(`(?i)(\[TELEGRAM.*?\])`)
-	messageRegex := regexp.MustCompile(`\[(\w+)\]\s+(\d{4}/\d{2}/\d{2}\s+\d{2}:\d{2}:\d{2})\s+\[.*?\]\s+(.*)`)
+	// 修正正则表达式以匹配实际的日志格式: 2025/01/20 14:30:15 [INFO] [file:line] [TELEGRAM] message
+	messageRegex := regexp.MustCompile(`(\d{4}/\d{2}/\d{2}\s+\d{2}:\d{2}:\d{2})\s+\[(\w+)\]\s+\[.*?:\d+\]\s+\[TELEGRAM.*?\]\s+(.*)`)
 
 	for _, file := range files {
 		entries, err := parseTelegramLogsFromFile(file, telegramRegex, messageRegex, startTime, endTime)
@@ -119,18 +136,23 @@ func parseTelegramLogsFromFile(filePath string, telegramRegex, messageRegex *reg
 
 // parseLogLine 解析单行日志
 func parseLogLine(line string, messageRegex *regexp.Regexp) (TelegramLogEntry, error) {
-	// 匹配日志格式: [LEVEL] 2006/01/02 15:04:05 [file:line] message
+	// 匹配日志格式: 2006/01/02 15:04:05 [LEVEL] [file:line] [TELEGRAM] message
 	matches := messageRegex.FindStringSubmatch(line)
 	if len(matches) < 4 {
 		return TelegramLogEntry{}, fmt.Errorf("无法解析日志行: %s", line)
 	}
 
-	level := matches[1]
-	timeStr := matches[2]
+	timeStr := matches[1]
+	level := matches[2]
 	message := matches[3]
 
-	// 解析时间
-	timestamp, err := time.Parse("2006/01/02 15:04:05", timeStr)
+	// 解析时间（使用本地时区）
+	location, err := time.LoadLocation("Asia/Shanghai")
+	if err != nil {
+		return TelegramLogEntry{}, fmt.Errorf("加载时区失败: %v", err)
+	}
+
+	timestamp, err := time.ParseInLocation("2006/01/02 15:04:05", timeStr, location)
 	if err != nil {
 		return TelegramLogEntry{}, fmt.Errorf("时间解析失败: %v", err)
 	}
@@ -203,7 +225,7 @@ func ClearOldTelegramLogs(daysToKeep int) error {
 		return nil // 日志目录不存在，无需清理
 	}
 
-	files, err := filepath.Glob(filepath.Join(logDir, "app_*.log"))
+	files, err := filepath.Glob(filepath.Join(logDir, "*.log"))
 	if err != nil {
 		return fmt.Errorf("查找日志文件失败: %v", err)
 	}

utils/log_viewer.go

@@ -2,6 +2,7 @@ package utils
 
 import (
 	"bufio"
+	"encoding/json"
 	"fmt"
 	"os"
 	"path/filepath"
@@ -13,11 +14,23 @@ import (
 
 // LogEntry 日志条目
 type LogEntry struct {
-	Timestamp time.Time
-	Level     string
-	Message   string
-	File      string
-	Line      int
+	Timestamp time.Time `json:"timestamp"`
+	Level     string    `json:"level"`
+	Message   string    `json:"message"`
+	File      string    `json:"file"`
+	Line      int       `json:"line"`
+}
+
+// 为LogEntry实现自定义JSON序列化
+func (le LogEntry) MarshalJSON() ([]byte, error) {
+	type Alias LogEntry
+	return json.Marshal(&struct {
+		*Alias
+		Timestamp string `json:"timestamp"`
+	}{
+		Alias:     (*Alias)(&le),
+		Timestamp: le.Timestamp.Format("2006-01-02T15:04:05Z07:00"),
+	})
 }
 
 // LogViewer 日志查看器
@@ -201,6 +214,76 @@ func (lv *LogViewer) GetLogStats(files []string) (map[string]int, error) {
 	return stats, nil
 }
 
+// ParseLogEntriesFromFile 从文件中解析日志条目
+func (lv *LogViewer) ParseLogEntriesFromFile(filename string, levelFilter string, searchFilter string) ([]LogEntry, error) {
+	file, err := os.Open(filename)
+	if err != nil {
+		return nil, err
+	}
+	defer file.Close()
+
+	var results []LogEntry
+	scanner := bufio.NewScanner(file)
+	lineNum := 0
+
+	for scanner.Scan() {
+		lineNum++
+		line := scanner.Text()
+
+		// 如果指定了级别过滤器，检查日志级别
+		if levelFilter != "" {
+			levelPrefix := "[" + strings.ToUpper(levelFilter) + "]"
+			if !strings.Contains(line, levelPrefix) {
+				continue
+			}
+		}
+
+		// 如果指定了搜索过滤器，检查是否包含搜索词
+		if searchFilter != "" {
+			if !strings.Contains(strings.ToLower(line), strings.ToLower(searchFilter)) {
+				continue
+			}
+		}
+
+		entry := lv.parseLogLine(line)
+		// 如果解析失败且行不为空，创建一个基本条目
+		if entry.Message == line && entry.Level == "" {
+			// 尝试从行中提取级别
+			if strings.Contains(line, "[DEBUG]") {
+				entry.Level = "DEBUG"
+			} else if strings.Contains(line, "[INFO]") {
+				entry.Level = "INFO"
+			} else if strings.Contains(line, "[WARN]") {
+				entry.Level = "WARN"
+			} else if strings.Contains(line, "[ERROR]") {
+				entry.Level = "ERROR"
+			} else if strings.Contains(line, "[FATAL]") {
+				entry.Level = "FATAL"
+			} else {
+				entry.Level = "UNKNOWN"
+			}
+		}
+		results = append(results, entry)
+	}
+
+	return results, scanner.Err()
+}
+
+// SortLogEntriesByTime 按时间对日志条目进行排序
+func SortLogEntriesByTime(entries []LogEntry, ascending bool) {
+	sort.Slice(entries, func(i, j int) bool {
+		if ascending {
+			return entries[i].Timestamp.Before(entries[j].Timestamp)
+		}
+		return entries[i].Timestamp.After(entries[j].Timestamp)
+	})
+}
+
+// GetFileInfo 获取文件信息
+func GetFileInfo(filepath string) (os.FileInfo, error) {
+	return os.Stat(filepath)
+}
+
 // getFileStats 获取单个文件的统计信息
 func (lv *LogViewer) getFileStats(filename string) (map[string]int, error) {
 	file, err := os.Open(filename)

utils/logger.go

@@ -7,8 +7,8 @@ import (
 	"os"
 	"path/filepath"
 	"runtime"
+	"strings"
 	"sync"
-	"time"
 )
 
 // LogLevel 日志级别
@@ -22,7 +22,7 @@ const (
 	FATAL
 )
 
-// String 返回日志级别的字符串表示
+// String 返回级别的字符串表示
 func (l LogLevel) String() string {
 	switch l {
 	case DEBUG:
@@ -40,186 +40,76 @@ func (l LogLevel) String() string {
 	}
 }
 
-// Logger 统一日志器
+// Logger 简化的日志器
 type Logger struct {
-	debugLogger *log.Logger
-	infoLogger  *log.Logger
-	warnLogger  *log.Logger
-	errorLogger *log.Logger
-	fatalLogger *log.Logger
-
+	level  LogLevel
+	logger *log.Logger
 	file   *os.File
-	mu     sync.Mutex
-	config *LogConfig
-}
-
-// LogConfig 日志配置
-type LogConfig struct {
-	LogDir         string   // 日志目录
-	LogLevel       LogLevel // 日志级别
-	MaxFileSize    int64    // 单个日志文件最大大小（MB）
-	MaxBackups     int      // 最大备份文件数
-	MaxAge         int      // 日志文件最大保留天数
-	EnableConsole  bool     // 是否启用控制台输出
-	EnableFile     bool     // 是否启用文件输出
-	EnableRotation bool     // 是否启用日志轮转
-}
-
-// DefaultConfig 默认配置
-func DefaultConfig() *LogConfig {
-	return &LogConfig{
-		LogDir:         "logs",
-		LogLevel:       INFO,
-		MaxFileSize:    100, // 100MB
-		MaxBackups:     5,
-		MaxAge:         30, // 30天
-		EnableConsole:  true,
-		EnableFile:     true,
-		EnableRotation: true,
-	}
+	mu     sync.RWMutex
 }
 
 var (
 	globalLogger *Logger
-	onceLogger   sync.Once
+	loggerOnce   sync.Once
 )
 
-// InitLogger 初始化全局日志器
-func InitLogger(config *LogConfig) error {
+// InitLogger 初始化日志器
+func InitLogger() error {
 	var err error
-	onceLogger.Do(func() {
-		if config == nil {
-			config = DefaultConfig()
+	loggerOnce.Do(func() {
+		globalLogger = &Logger{
+			level:  INFO,
+			logger: log.New(os.Stdout, "", log.LstdFlags),
 		}
 
-		globalLogger, err = NewLogger(config)
+		// 创建日志目录
+		logDir := "logs"
+		if err = os.MkdirAll(logDir, 0755); err != nil {
+			return
+		}
+
+		// 创建日志文件
+		logFile := filepath.Join(logDir, "app.log")
+		globalLogger.file, err = os.OpenFile(logFile, os.O_CREATE|os.O_WRONLY|os.O_APPEND, 0666)
+		if err != nil {
+			return
+		}
+
+		// 同时输出到控制台和文件
+		globalLogger.logger = log.New(io.MultiWriter(os.Stdout, globalLogger.file), "", log.LstdFlags)
 	})
+
 	return err
 }
 
 // GetLogger 获取全局日志器
 func GetLogger() *Logger {
 	if globalLogger == nil {
-		InitLogger(nil)
+		InitLogger()
 	}
 	return globalLogger
 }
 
-// NewLogger 创建新的日志器
-func NewLogger(config *LogConfig) (*Logger, error) {
-	if config == nil {
-		config = DefaultConfig()
-	}
-
-	logger := &Logger{
-		config: config,
-	}
-
-	// 创建日志目录
-	if config.EnableFile {
-		if err := os.MkdirAll(config.LogDir, 0755); err != nil {
-			return nil, fmt.Errorf("创建日志目录失败: %v", err)
-		}
-	}
-
-	// 初始化日志文件
-	if err := logger.initLogFile(); err != nil {
-		return nil, err
-	}
-
-	// 初始化日志器
-	logger.initLoggers()
-
-	// 启动日志轮转检查
-	if config.EnableRotation {
-		go logger.startRotationCheck()
-	}
-
-	return logger, nil
-}
-
-// initLogFile 初始化日志文件
-func (l *Logger) initLogFile() error {
-	if !l.config.EnableFile {
-		return nil
-	}
-
-	l.mu.Lock()
-	defer l.mu.Unlock()
-
-	// 关闭现有文件
-	if l.file != nil {
-		l.file.Close()
-	}
-
-	// 创建新的日志文件
-	logFile := filepath.Join(l.config.LogDir, fmt.Sprintf("app_%s.log", GetCurrentTime().Format("2006-01-02")))
-	file, err := os.OpenFile(logFile, os.O_CREATE|os.O_WRONLY|os.O_APPEND, 0666)
-	if err != nil {
-		return fmt.Errorf("创建日志文件失败: %v", err)
-	}
-
-	l.file = file
-	return nil
-}
-
-// initLoggers 初始化各个级别的日志器
-func (l *Logger) initLoggers() {
-	var writers []io.Writer
-
-	// 添加控制台输出
-	if l.config.EnableConsole {
-		writers = append(writers, os.Stdout)
-	}
-
-	// 添加文件输出
-	if l.config.EnableFile && l.file != nil {
-		writers = append(writers, l.file)
-	}
-
-	multiWriter := io.MultiWriter(writers...)
-
-	// 创建各个级别的日志器
-	l.debugLogger = log.New(multiWriter, "[DEBUG] ", log.LstdFlags)
-	l.infoLogger = log.New(multiWriter, "[INFO] ", log.LstdFlags)
-	l.warnLogger = log.New(multiWriter, "[WARN] ", log.LstdFlags)
-	l.errorLogger = log.New(multiWriter, "[ERROR] ", log.LstdFlags)
-	l.fatalLogger = log.New(multiWriter, "[FATAL] ", log.LstdFlags)
-}
-
 // log 内部日志方法
 func (l *Logger) log(level LogLevel, format string, args ...interface{}) {
-	if level < l.config.LogLevel {
+	if level < l.level {
 		return
 	}
 
 	// 获取调用者信息
 	_, file, line, ok := runtime.Caller(2)
-	if !ok {
-		file = "unknown"
-		line = 0
+	caller := "unknown"
+	if ok {
+		caller = fmt.Sprintf("%s:%d", filepath.Base(file), line)
 	}
 
-	// 提取文件名
-	fileName := filepath.Base(file)
-
-	// 格式化消息
 	message := fmt.Sprintf(format, args...)
+	logMessage := fmt.Sprintf("[%s] [%s] %s", level.String(), caller, message)
 
-	// 添加调用位置信息
-	fullMessage := fmt.Sprintf("[%s:%d] %s", fileName, line, message)
+	l.logger.Println(logMessage)
 
-	switch level {
-	case DEBUG:
-		l.debugLogger.Println(fullMessage)
-	case INFO:
-		l.infoLogger.Println(fullMessage)
-	case WARN:
-		l.warnLogger.Println(fullMessage)
-	case ERROR:
-		l.errorLogger.Println(fullMessage)
-	case FATAL:
-		l.fatalLogger.Println(fullMessage)
+	// Fatal级别终止程序
+	if level == FATAL {
 		os.Exit(1)
 	}
 }
@@ -249,94 +139,72 @@ func (l *Logger) Fatal(format string, args ...interface{}) {
 	l.log(FATAL, format, args...)
 }
 
-// startRotationCheck 启动日志轮转检查
-func (l *Logger) startRotationCheck() {
-	ticker := time.NewTicker(1 * time.Hour) // 每小时检查一次
-	defer ticker.Stop()
-
-	for range ticker.C {
-		l.checkRotation()
-	}
+// TelegramDebug Telegram调试日志
+func (l *Logger) TelegramDebug(format string, args ...interface{}) {
+	l.log(DEBUG, "[TELEGRAM] "+format, args...)
 }
 
-// checkRotation 检查是否需要轮转日志
-func (l *Logger) checkRotation() {
-	if !l.config.EnableFile || l.file == nil {
-		return
-	}
-
-	// 检查文件大小
-	fileInfo, err := l.file.Stat()
-	if err != nil {
-		return
-	}
-
-	// 如果文件超过最大大小，进行轮转
-	if fileInfo.Size() > l.config.MaxFileSize*1024*1024 {
-		l.rotateLog()
-	}
-
-	// 清理旧日志文件
-	l.cleanOldLogs()
+// TelegramInfo Telegram信息日志
+func (l *Logger) TelegramInfo(format string, args ...interface{}) {
+	l.log(INFO, "[TELEGRAM] "+format, args...)
 }
 
-// rotateLog 轮转日志文件
-func (l *Logger) rotateLog() {
+// TelegramWarn Telegram警告日志
+func (l *Logger) TelegramWarn(format string, args ...interface{}) {
+	l.log(WARN, "[TELEGRAM] "+format, args...)
+}
+
+// TelegramError Telegram错误日志
+func (l *Logger) TelegramError(format string, args ...interface{}) {
+	l.log(ERROR, "[TELEGRAM] "+format, args...)
+}
+
+// DebugWithFields 带字段的调试日志
+func (l *Logger) DebugWithFields(fields map[string]interface{}, format string, args ...interface{}) {
+	message := fmt.Sprintf(format, args...)
+	if len(fields) > 0 {
+		var fieldStrs []string
+		for k, v := range fields {
+			fieldStrs = append(fieldStrs, fmt.Sprintf("%s=%v", k, v))
+		}
+		message = fmt.Sprintf("%s [%s]", message, strings.Join(fieldStrs, ", "))
+	}
+	l.log(DEBUG, message)
+}
+
+// InfoWithFields 带字段的信息日志
+func (l *Logger) InfoWithFields(fields map[string]interface{}, format string, args ...interface{}) {
+	message := fmt.Sprintf(format, args...)
+	if len(fields) > 0 {
+		var fieldStrs []string
+		for k, v := range fields {
+			fieldStrs = append(fieldStrs, fmt.Sprintf("%s=%v", k, v))
+		}
+		message = fmt.Sprintf("%s [%s]", message, strings.Join(fieldStrs, ", "))
+	}
+	l.log(INFO, message)
+}
+
+// ErrorWithFields 带字段的错误日志
+func (l *Logger) ErrorWithFields(fields map[string]interface{}, format string, args ...interface{}) {
+	message := fmt.Sprintf(format, args...)
+	if len(fields) > 0 {
+		var fieldStrs []string
+		for k, v := range fields {
+			fieldStrs = append(fieldStrs, fmt.Sprintf("%s=%v", k, v))
+		}
+		message = fmt.Sprintf("%s [%s]", message, strings.Join(fieldStrs, ", "))
+	}
+	l.log(ERROR, message)
+}
+
+// Close 关闭日志文件
+func (l *Logger) Close() {
 	l.mu.Lock()
 	defer l.mu.Unlock()
-
-	// 关闭当前文件
 	if l.file != nil {
 		l.file.Close()
 	}
-
-	// 重命名当前日志文件
-	currentLogFile := filepath.Join(l.config.LogDir, fmt.Sprintf("app_%s.log", GetCurrentTime().Format("2006-01-02")))
-	backupLogFile := filepath.Join(l.config.LogDir, fmt.Sprintf("app_%s_%s.log", GetCurrentTime().Format("2006-01-02"), GetCurrentTime().Format("15-04-05")))
-
-	if _, err := os.Stat(currentLogFile); err == nil {
-		os.Rename(currentLogFile, backupLogFile)
-	}
-
-	// 创建新的日志文件
-	l.initLogFile()
-	l.initLoggers()
-}
-
-// cleanOldLogs 清理旧日志文件
-func (l *Logger) cleanOldLogs() {
-	if l.config.MaxAge <= 0 {
-		return
-	}
-
-	files, err := filepath.Glob(filepath.Join(l.config.LogDir, "app_*.log"))
-	if err != nil {
-		return
-	}
-
-	cutoffTime := GetCurrentTime().AddDate(0, 0, -l.config.MaxAge)
-
-	for _, file := range files {
-		fileInfo, err := os.Stat(file)
-		if err != nil {
-			continue
-		}
-
-		if fileInfo.ModTime().Before(cutoffTime) {
-			os.Remove(file)
-		}
-	}
-}
-
-// Close 关闭日志器
-func (l *Logger) Close() error {
-	l.mu.Lock()
-	defer l.mu.Unlock()
-
-	if l.file != nil {
-		return l.file.Close()
-	}
-	return nil
 }
 
 // 全局便捷函数
@@ -359,3 +227,40 @@ func Error(format string, args ...interface{}) {
 func Fatal(format string, args ...interface{}) {
 	GetLogger().Fatal(format, args...)
 }
+
+func TelegramDebug(format string, args ...interface{}) {
+	GetLogger().TelegramDebug(format, args...)
+}
+
+func TelegramInfo(format string, args ...interface{}) {
+	GetLogger().TelegramInfo(format, args...)
+}
+
+func TelegramWarn(format string, args ...interface{}) {
+	GetLogger().TelegramWarn(format, args...)
+}
+
+func TelegramError(format string, args ...interface{}) {
+	GetLogger().TelegramError(format, args...)
+}
+
+func DebugWithFields(fields map[string]interface{}, format string, args ...interface{}) {
+	GetLogger().DebugWithFields(fields, format, args...)
+}
+
+func InfoWithFields(fields map[string]interface{}, format string, args ...interface{}) {
+	GetLogger().InfoWithFields(fields, format, args...)
+}
+
+func ErrorWithFields(fields map[string]interface{}, format string, args ...interface{}) {
+	GetLogger().ErrorWithFields(fields, format, args...)
+}
+
+// Min 返回两个整数中的较小值
+func Min(a, b int) int {
+	if a < b {
+		return a
+	}
+	return b
+}
+

web/.env.example

@@ -0,0 +1,5 @@
+# API Server Configuration
+NUXT_PUBLIC_API_SERVER=http://localhost:8080/api
+
+# OG Image Service Configuration
+NUXT_PUBLIC_OG_API_URL=http://localhost:8081/api/og-image

web/assets/css/main.css

@@ -8,6 +8,53 @@
   }
 }
 
+/* 二维码动态动画 */
+@keyframes gradientShift {
+  0% {
+    background-position: 0% 50%;
+  }
+  50% {
+    background-position: 100% 50%;
+  }
+  100% {
+    background-position: 0% 50%;
+  }
+}
+
+@keyframes rainbowMove {
+  0% {
+    background-position: 0% 50%;
+  }
+  50% {
+    background-position: 100% 50%;
+  }
+  100% {
+    background-position: 200% 50%;
+  }
+}
+
+@keyframes neonPulse {
+  0%, 100% {
+    box-shadow: 0 0 20px rgba(0, 255, 136, 0.5), 0 0 40px rgba(0, 255, 136, 0.3), 0 0 60px rgba(0, 255, 136, 0.1);
+  }
+  50% {
+    box-shadow: 0 0 30px rgba(0, 255, 136, 0.8), 0 0 50px rgba(0, 255, 136, 0.5), 0 0 70px rgba(0, 255, 136, 0.3);
+  }
+}
+
+/* 动态预设的动画类 */
+.qr-dynamic {
+  animation: gradientShift 3s ease infinite;
+}
+
+.qr-rainbow {
+  animation: rainbowMove 4s linear infinite;
+}
+
+.qr-neon {
+  animation: neonPulse 2s ease-in-out infinite;
+}
+
 @layer components {
   .btn-primary {
     @apply bg-blue-600 hover:bg-blue-700 text-white font-medium py-2 px-4 rounded-lg transition-colors duration-200;

web/components.d.ts

@@ -15,6 +15,7 @@ declare module 'vue' {
     NButtonGroup: typeof import('naive-ui')['NButtonGroup']
     NCard: typeof import('naive-ui')['NCard']
     NCheckbox: typeof import('naive-ui')['NCheckbox']
+    NCode: typeof import('naive-ui')['NCode']
     NCollapse: typeof import('naive-ui')['NCollapse']
     NCollapseItem: typeof import('naive-ui')['NCollapseItem']
     NDataTable: typeof import('naive-ui')['NDataTable']
@@ -33,6 +34,7 @@ declare module 'vue' {
     NInputNumber: typeof import('naive-ui')['NInputNumber']
     NList: typeof import('naive-ui')['NList']
     NListItem: typeof import('naive-ui')['NListItem']
+    NMarquee: typeof import('naive-ui')['NMarquee']
     NMessageProvider: typeof import('naive-ui')['NMessageProvider']
     NModal: typeof import('naive-ui')['NModal']
     NNotificationProvider: typeof import('naive-ui')['NNotificationProvider']

web/components/Admin/AnnouncementConfig.vue

@@ -0,0 +1,203 @@
+<template>
+  <div class="space-y-4">
+    <div class="flex items-center justify-between">
+      <div class="flex items-center space-x-2">
+        <label class="text-lg font-semibold text-gray-800 dark:text-gray-200">公告配置</label>
+        <span class="text-xs text-gray-500 dark:text-gray-400">开启后可在网站显示公告信息</span>
+      </div>
+      <n-button v-if="modelValue.enable_announcements" @click="addAnnouncement" type="primary" size="small">
+        <template #icon>
+          <i class="fas fa-plus"></i>
+        </template>
+        添加公告
+      </n-button>
+    </div>
+    <n-switch v-model:value="enableAnnouncements" />
+
+    <!-- 公告列表 -->
+    <div v-if="modelValue.enable_announcements && modelValue.announcements && modelValue.announcements.length > 0" class="announcement-list space-y-3">
+      <div v-for="(announcement, index) in modelValue.announcements" :key="index" class="announcement-item border rounded-lg p-3 bg-gray-50 dark:bg-gray-800">
+        <div class="flex items-center justify-between mb-2">
+          <div class="flex items-center space-x-3">
+            <h4 class="text-sm font-medium text-gray-900 dark:text-gray-100">公告 {{ index + 1 }}</h4>
+            <n-switch :value="announcement.enabled" @update:value="handleEnabledChange(index, $event)" size="small" />
+          </div>
+          <div class="flex items-center space-x-1">
+            <n-button text @click="moveAnnouncementUp(index)" :disabled="index === 0" size="small">
+              <template #icon>
+                <i class="fas fa-arrow-up"></i>
+              </template>
+            </n-button>
+            <n-button text @click="moveAnnouncementDown(index)" :disabled="index === modelValue.announcements.length - 1" size="small">
+              <template #icon>
+                <i class="fas fa-arrow-down"></i>
+              </template>
+            </n-button>
+            <n-button text @click="removeAnnouncement(index)" type="error" size="small">
+              <template #icon>
+                <i class="fas fa-trash"></i>
+              </template>
+            </n-button>
+          </div>
+        </div>
+
+        <div class="space-y-2">
+          <n-input
+            :value="announcement.content"
+            @update:value="handleContentChange(index, $event)"
+            placeholder="公告内容，支持HTML标签"
+            type="textarea"
+            :rows="2"
+            size="small"
+          />
+        </div>
+      </div>
+    </div>
+  </div>
+</template>
+
+<script setup lang="ts">
+// 公告接口
+interface Announcement {
+  content: string
+  enabled: boolean
+}
+
+// 配置数据接口
+interface ConfigData {
+  enable_announcements: boolean
+  announcements: Announcement[]
+}
+
+// Props
+const props = defineProps<{
+  modelValue: ConfigData
+}>()
+
+// Emits
+const emit = defineEmits<{
+  'update:modelValue': [value: ConfigData]
+}>()
+
+// 计算属性用于双向绑定
+const enableAnnouncements = computed({
+  get: () => props.modelValue.enable_announcements,
+  set: (value: boolean) => {
+    emit('update:modelValue', {
+      enable_announcements: value,
+      announcements: props.modelValue.announcements
+    })
+  }
+})
+
+
+// 更新数据
+const updateValue = (newValue: ConfigData) => {
+  emit('update:modelValue', newValue)
+}
+
+// 监听单个公告内容变化
+const handleContentChange = (index: number, content: string) => {
+  const newAnnouncements = [...props.modelValue.announcements]
+  newAnnouncements[index] = { ...newAnnouncements[index], content }
+  emit('update:modelValue', {
+    enable_announcements: props.modelValue.enable_announcements,
+    announcements: newAnnouncements
+  })
+}
+
+// 监听单个公告启用状态变化
+const handleEnabledChange = (index: number, enabled: boolean) => {
+  const newAnnouncements = [...props.modelValue.announcements]
+  newAnnouncements[index] = { ...newAnnouncements[index], enabled }
+  emit('update:modelValue', {
+    enable_announcements: props.modelValue.enable_announcements,
+    announcements: newAnnouncements
+  })
+}
+
+// 计算属性用于公告内容双向绑定
+const announcementContent = (index: number) => computed({
+  get: () => props.modelValue.announcements[index]?.content || '',
+  set: (value: string) => {
+    const newAnnouncements = [...props.modelValue.announcements]
+    newAnnouncements[index] = { ...newAnnouncements[index], content: value }
+    updateValue({
+      enable_announcements: props.modelValue.enable_announcements,
+      announcements: newAnnouncements
+    })
+  }
+})
+
+// 计算属性用于公告启用状态双向绑定
+const announcementEnabled = (index: number) => computed({
+  get: () => props.modelValue.announcements[index]?.enabled || false,
+  set: (value: boolean) => {
+    const newAnnouncements = [...props.modelValue.announcements]
+    newAnnouncements[index] = { ...newAnnouncements[index], enabled: value }
+    updateValue({
+      enable_announcements: props.modelValue.enable_announcements,
+      announcements: newAnnouncements
+    })
+  }
+})
+
+// 添加公告
+const addAnnouncement = () => {
+  const newAnnouncements = [...props.modelValue.announcements, {
+    content: '',
+    enabled: true
+  }]
+  emit('update:modelValue', {
+    enable_announcements: props.modelValue.enable_announcements,
+    announcements: newAnnouncements
+  })
+}
+
+// 删除公告
+const removeAnnouncement = (index: number) => {
+  const currentAnnouncements = Array.isArray(props.modelValue.announcements) ? props.modelValue.announcements : []
+  const newAnnouncements = currentAnnouncements.filter((_, i) => i !== index)
+  emit('update:modelValue', {
+    enable_announcements: props.modelValue.enable_announcements,
+    announcements: newAnnouncements
+  })
+}
+
+// 上移公告
+const moveAnnouncementUp = (index: number) => {
+  if (index > 0) {
+    const currentAnnouncements = Array.isArray(props.modelValue.announcements) ? props.modelValue.announcements : []
+    const newAnnouncements = [...currentAnnouncements]
+    const temp = newAnnouncements[index]
+    newAnnouncements[index] = newAnnouncements[index - 1]
+    newAnnouncements[index - 1] = temp
+    emit('update:modelValue', {
+      enable_announcements: props.modelValue.enable_announcements,
+      announcements: newAnnouncements
+    })
+  }
+}
+
+// 下移公告
+const moveAnnouncementDown = (index: number) => {
+  const currentAnnouncements = Array.isArray(props.modelValue.announcements) ? props.modelValue.announcements : []
+  if (index < currentAnnouncements.length - 1) {
+    const newAnnouncements = [...currentAnnouncements]
+    const temp = newAnnouncements[index]
+    newAnnouncements[index] = newAnnouncements[index + 1]
+    newAnnouncements[index + 1] = temp
+    emit('update:modelValue', {
+      enable_announcements: props.modelValue.enable_announcements,
+      announcements: newAnnouncements
+    })
+  }
+}
+</script>
+
+<style scoped>
+.announcement-list {
+  max-height: 400px;
+  overflow-y: auto;
+}
+</style>

web/components/Admin/FloatButtonsConfig.vue

@@ -0,0 +1,171 @@
+<template>
+  <div class="space-y-4">
+    <div class="flex items-center space-x-2">
+      <label class="text-lg font-semibold text-gray-800 dark:text-gray-200">浮动按钮配置</label>
+      <span class="text-xs text-gray-500 dark:text-gray-400">开启后显示右下角浮动按钮</span>
+    </div>
+    <n-switch v-model:value="enableFloatButtons" />
+
+    <!-- 浮动按钮设置 -->
+    <div v-if="modelValue.enable_float_buttons" class="float-buttons-config space-y-4">
+      <!-- 微信搜一搜图片 -->
+      <div class="space-y-2">
+        <div class="flex items-center space-x-2">
+          <label class="text-base font-semibold text-gray-800 dark:text-gray-200">微信搜一搜图片</label>
+          <span class="text-xs text-gray-500 dark:text-gray-400">选择微信搜一搜的二维码图片</span>
+        </div>
+        <div class="flex items-center space-x-4">
+          <div v-if="modelValue.wechat_search_image" class="flex-shrink-0">
+            <n-image
+              :src="getImageUrl(modelValue.wechat_search_image)"
+              alt="微信搜一搜"
+              width="80"
+              height="80"
+              object-fit="cover"
+              class="rounded-lg border"
+            />
+          </div>
+          <div class="flex-1">
+            <n-button type="primary" @click="openWechatSelector">
+              <template #icon>
+                <i class="fas fa-image"></i>
+              </template>
+              {{ modelValue.wechat_search_image ? '更换图片' : '选择图片' }}
+            </n-button>
+            <n-button v-if="modelValue.wechat_search_image" @click="clearWechatImage" class="ml-2">
+              <template #icon>
+                <i class="fas fa-times"></i>
+              </template>
+              清除
+            </n-button>
+          </div>
+        </div>
+      </div>
+
+      <!-- Telegram二维码 -->
+      <div class="space-y-2">
+        <div class="flex items-center space-x-2">
+          <label class="text-base font-semibold text-gray-800 dark:text-gray-200">Telegram二维码</label>
+          <span class="text-xs text-gray-500 dark:text-gray-400">选择Telegram群组的二维码图片</span>
+        </div>
+        <div class="flex items-center space-x-4">
+          <div v-if="modelValue.telegram_qr_image" class="flex-shrink-0">
+            <n-image
+              :src="getImageUrl(modelValue.telegram_qr_image)"
+              alt="Telegram二维码"
+              width="80"
+              height="80"
+              object-fit="cover"
+              class="rounded-lg border"
+            />
+          </div>
+          <div class="flex-1">
+            <n-button type="primary" @click="openTelegramSelector">
+              <template #icon>
+                <i class="fas fa-image"></i>
+              </template>
+              {{ modelValue.telegram_qr_image ? '更换图片' : '选择图片' }}
+            </n-button>
+            <n-button v-if="modelValue.telegram_qr_image" @click="clearTelegramImage" class="ml-2">
+              <template #icon>
+                <i class="fas fa-times"></i>
+              </template>
+              清除
+            </n-button>
+          </div>
+        </div>
+      </div>
+    </div>
+  </div>
+</template>
+
+// 使用图片URL composable
+const { getImageUrl } = useImageUrl()
+
+<script setup lang="ts">
+import ImageSelectorModal from '~/components/Admin/ImageSelectorModal.vue'
+// 配置数据接口
+interface ConfigData {
+  enable_float_buttons: boolean
+  wechat_search_image: string
+  telegram_qr_image: string
+}
+
+// Props
+const props = defineProps<{
+  modelValue: ConfigData
+}>()
+
+// Emits
+const emit = defineEmits<{
+  'update:modelValue': [value: ConfigData]
+  'openWechatSelector': []
+  'openTelegramSelector': []
+}>()
+
+// 计算属性用于双向绑定
+const enableFloatButtons = computed({
+  get: () => props.modelValue.enable_float_buttons,
+  set: (value: boolean) => {
+    emit('update:modelValue', {
+      enable_float_buttons: value,
+      wechat_search_image: props.modelValue.wechat_search_image,
+      telegram_qr_image: props.modelValue.telegram_qr_image
+    })
+  }
+})
+
+// 使用图片URL composable
+const { getImageUrl } = useImageUrl()
+
+// 选择器状态
+const showWechatSelector = ref(false)
+const showTelegramSelector = ref(false)
+
+// 清除微信图片
+const clearWechatImage = () => {
+  emit('update:modelValue', {
+    enable_float_buttons: props.modelValue.enable_float_buttons,
+    wechat_search_image: '',
+    telegram_qr_image: props.modelValue.telegram_qr_image
+  })
+}
+
+// 清除Telegram图片
+const clearTelegramImage = () => {
+  emit('update:modelValue', {
+    enable_float_buttons: props.modelValue.enable_float_buttons,
+    wechat_search_image: props.modelValue.wechat_search_image,
+    telegram_qr_image: ''
+  })
+}
+
+// 打开微信选择器
+const openWechatSelector = () => {
+  emit('openWechatSelector')
+}
+
+// 打开Telegram选择器
+const openTelegramSelector = () => {
+  emit('openTelegramSelector')
+}
+
+// 处理微信图片选择
+const handleWechatImageSelect = (file: any) => {
+  emit('update:modelValue', {
+    enable_float_buttons: props.modelValue.enable_float_buttons,
+    wechat_search_image: file.access_url,
+    telegram_qr_image: props.modelValue.telegram_qr_image
+  })
+}
+
+// 处理Telegram图片选择
+const handleTelegramImageSelect = (file: any) => {
+  emit('update:modelValue', {
+    enable_float_buttons: props.modelValue.enable_float_buttons,
+    wechat_search_image: props.modelValue.wechat_search_image,
+    telegram_qr_image: file.access_url
+  })
+}
+</script>
+

web/components/Admin/ImageSelectorModal.vue

@@ -0,0 +1,256 @@
+<template>
+  <n-modal v-model:show="showModal" preset="card" :title="title" style="width: 90vw; max-width: 1200px; max-height: 80vh;">
+    <div class="space-y-4">
+      <!-- 搜索 -->
+      <div class="flex gap-4">
+        <n-input
+          v-model:value="searchKeyword"
+          placeholder="搜索文件名..."
+          @keyup.enter="handleSearch"
+          class="flex-1"
+          clearable
+        >
+          <template #prefix>
+            <i class="fas fa-search"></i>
+          </template>
+        </n-input>
+
+        <n-button type="primary" @click="handleSearch" class="w-20">
+          <template #icon>
+            <i class="fas fa-search"></i>
+          </template>
+          搜索
+        </n-button>
+      </div>
+
+      <!-- 文件列表 -->
+      <div v-if="loading" class="flex items-center justify-center py-8">
+        <n-spin size="large" />
+      </div>
+
+      <div v-else-if="fileList.length === 0" class="text-center py-8">
+        <i class="fas fa-file-upload text-4xl text-gray-400 mb-4"></i>
+        <p class="text-gray-500">暂无图片文件</p>
+      </div>
+
+      <div v-else class="file-grid">
+        <div
+          v-for="file in fileList"
+          :key="file.id"
+          class="file-item cursor-pointer hover:bg-gray-50 dark:hover:bg-gray-800 rounded-lg p-3 transition-colors"
+          :class="{ 'bg-blue-50 dark:bg-blue-900/20 border-2 border-blue-300 dark:border-blue-600': selectedFileId === file.id }"
+          @click="selectFile(file)"
+        >
+          <div class="image-preview">
+            <n-image
+              :src="getImageUrl(file.access_url)"
+              :alt="file.original_name"
+              :lazy="false"
+              object-fit="cover"
+              class="preview-image rounded"
+              @error="handleImageError"
+              @load="handleImageLoad"
+            />
+
+            <div class="image-info mt-2">
+              <div class="file-name text-sm font-medium text-gray-900 dark:text-gray-100 truncate">
+                {{ file.original_name }}
+              </div>
+              <div class="file-size text-xs text-gray-500 dark:text-gray-400">
+                {{ formatFileSize(file.file_size) }}
+              </div>
+            </div>
+          </div>
+        </div>
+      </div>
+
+      <!-- 分页 -->
+      <div class="pagination-wrapper">
+        <n-pagination
+          v-model:page="pagination.page"
+          v-model:page-size="pagination.pageSize"
+          :page-count="Math.ceil(pagination.total / pagination.pageSize)"
+          :page-sizes="pagination.pageSizes"
+          show-size-picker
+          @update:page="handlePageChange"
+          @update:page-size="handlePageSizeChange"
+        />
+      </div>
+    </div>
+
+    <template #footer>
+      <n-space justify="end">
+        <n-button @click="closeModal">取消</n-button>
+        <n-button
+          type="primary"
+          @click="confirmSelection"
+          :disabled="!selectedFileId"
+        >
+          确认选择
+        </n-button>
+      </n-space>
+    </template>
+  </n-modal>
+</template>
+
+<script setup lang="ts">
+// Props
+const props = defineProps<{
+  show: boolean
+  title: string
+}>()
+
+// Emits
+const emit = defineEmits<{
+  'update:show': [value: boolean]
+  'select': [file: any]
+}>()
+
+// 使用图片URL composable
+const { getImageUrl } = useImageUrl()
+
+// 响应式数据
+const showModal = computed({
+  get: () => props.show,
+  set: (value) => emit('update:show', value)
+})
+
+const loading = ref(false)
+const fileList = ref<any[]>([])
+const selectedFileId = ref<number | null>(null)
+const searchKeyword = ref('')
+
+const pagination = ref({
+  page: 1,
+  pageSize: 20,
+  total: 0,
+  pageSizes: [10, 20, 50, 100]
+})
+
+// 监听show变化，重新加载数据
+watch(() => props.show, (newValue) => {
+  if (newValue) {
+    loadFileList()
+  } else {
+    // 重置状态
+    selectedFileId.value = null
+    searchKeyword.value = ''
+  }
+})
+
+// 加载文件列表
+const loadFileList = async () => {
+  try {
+    loading.value = true
+    const { useFileApi } = await import('~/composables/useFileApi')
+    const fileApi = useFileApi()
+
+    const response = await fileApi.getFileList({
+      page: pagination.value.page,
+      pageSize: pagination.value.pageSize,
+      search: searchKeyword.value,
+      fileType: 'image',
+      status: 'active'
+    }) as any
+
+    if (response && response.data) {
+      fileList.value = response.data.files || []
+      pagination.value.total = response.data.total || 0
+    }
+  } catch (error) {
+    console.error('获取文件列表失败:', error)
+  } finally {
+    loading.value = false
+  }
+}
+
+// 搜索处理
+const handleSearch = () => {
+  pagination.value.page = 1
+  loadFileList()
+}
+
+// 分页处理
+const handlePageChange = (page: number) => {
+  pagination.value.page = page
+  loadFileList()
+}
+
+const handlePageSizeChange = (pageSize: number) => {
+  pagination.value.pageSize = pageSize
+  pagination.value.page = 1
+  loadFileList()
+}
+
+// 文件选择
+const selectFile = (file: any) => {
+  selectedFileId.value = file.id
+}
+
+// 确认选择
+const confirmSelection = () => {
+  if (selectedFileId.value) {
+    const file = fileList.value.find(f => f.id === selectedFileId.value)
+    if (file) {
+      emit('select', file)
+      closeModal()
+    }
+  }
+}
+
+// 关闭模态框
+const closeModal = () => {
+  showModal.value = false
+}
+
+// 文件大小格式化
+const formatFileSize = (size: number) => {
+  if (size < 1024) return size + ' B'
+  if (size < 1024 * 1024) return (size / 1024).toFixed(1) + ' KB'
+  if (size < 1024 * 1024 * 1024) return (size / (1024 * 1024)).toFixed(1) + ' MB'
+  return (size / (1024 * 1024 * 1024)).toFixed(1) + ' GB'
+}
+
+// 图片加载处理
+const handleImageError = (event: any) => {
+  console.error('图片加载失败:', event)
+}
+
+const handleImageLoad = (event: any) => {
+  console.log('图片加载成功:', event)
+}
+</script>
+
+<style scoped>
+.file-grid {
+  display: grid;
+  grid-template-columns: repeat(auto-fill, minmax(200px, 1fr));
+  gap: 1rem;
+  max-height: 400px;
+  overflow-y: auto;
+}
+
+.file-item {
+  border: 1px solid #e5e7eb;
+  transition: all 0.2s ease;
+}
+
+.file-item:hover {
+  transform: translateY(-2px);
+  box-shadow: 0 4px 6px -1px rgba(0, 0, 0, 0.1);
+}
+
+.preview-image {
+  width: 100%;
+  height: 120px;
+  object-fit: cover;
+  border: 1px solid #e5e7eb;
+  border-radius: 4px;
+}
+
+.pagination-wrapper {
+  display: flex;
+  justify-content: center;
+  margin-top: 1rem;
+}
+</style>

web/components/Admin/QRCodeStyleSelector.vue

@@ -0,0 +1,285 @@
+<template>
+  <n-modal
+    :show="show"
+    :mask-closable="true"
+    preset="card"
+    title="选择二维码样式"
+    style="width: 90%; max-width: 900px;"
+    @close="handleClose"
+    @update:show="handleShowUpdate"
+  >
+    <div class="qr-style-selector">
+      <!-- 样式选择区域 -->
+      <div class="styles-section">
+        <div class="styles-grid">
+          <div
+            v-for="preset in allQrCodePresets"
+            :key="preset.name"
+            class="style-item"
+            :class="{ active: selectedPreset?.name === preset.name }"
+            @click="selectPreset(preset)"
+          >
+            <div class="qr-preview" :style="preset.style">
+              <div :ref="el => setQRContainer(el, preset.name)" v-if="preset"></div>
+              <!-- 选中状态指示器 -->
+              <div v-if="selectedPreset?.name === preset.name" class="selected-indicator">
+                <i class="fas fa-check"></i>
+              </div>
+            </div>
+            <div class="style-name">{{ preset.name }}</div>
+          </div>
+        </div>
+      </div>
+
+      <!-- 操作按钮 -->
+      <div class="action-buttons">
+        <n-button @click="handleClose">取消</n-button>
+        <n-button type="primary" @click="confirmSelection">
+          确认选择
+        </n-button>
+      </div>
+    </div>
+  </n-modal>
+</template>
+
+<script setup lang="ts">
+import QRCodeStyling from 'qr-code-styling'
+import { allQrCodePresets, type Preset } from '~/components/QRCode/presets'
+
+// Props
+const props = defineProps<{
+  show: boolean
+  currentStyle?: string
+}>()
+
+// Emits
+const emit = defineEmits<{
+  'update:show': [value: boolean]
+  'select': [preset: Preset]
+}>()
+
+// 示例数据
+const sampleData = ref('https://pan.l9.lc')
+
+// 当前选中的预设
+const selectedPreset = ref<Preset | null>(null)
+
+// QR码实例映射
+const qrInstances = ref<Map<string, QRCodeStyling>>(new Map())
+
+// 监听显示状态变化
+watch(() => props.show, (newShow) => {
+  if (newShow) {
+    // 查找当前样式对应的预设
+    const currentPreset = allQrCodePresets.find(preset => preset.name === props.currentStyle)
+    selectedPreset.value = currentPreset || allQrCodePresets[0] // 默认选择 Plain
+
+    // 延迟渲染QR码，确保DOM已经准备好
+    nextTick(() => {
+      renderAllQRCodes()
+    })
+  }
+})
+
+// 设置QR码容器
+const setQRContainer = (el: HTMLElement, presetName: string) => {
+  if (el) {
+    // 先清空容器内容，防止重复添加
+    el.innerHTML = ''
+
+    const preset = allQrCodePresets.find(p => p.name === presetName)
+    if (preset) {
+      const qrInstance = new QRCodeStyling({
+        data: sampleData.value,
+        ...preset,
+        width: 80,
+        height: 80
+      })
+      qrInstance.append(el)
+
+      // 保存实例引用
+      qrInstances.value.set(presetName, qrInstance)
+    }
+  }
+}
+
+// 渲染所有QR码
+const renderAllQRCodes = () => {
+  // 这个函数会在 setQRContainer 中被调用
+  // 这里不需要额外操作，因为每个组件都会自己渲染
+}
+
+// 选择预设
+const selectPreset = (preset: Preset) => {
+  selectedPreset.value = preset
+}
+
+// 确认选择
+const confirmSelection = () => {
+  if (selectedPreset.value) {
+    emit('select', selectedPreset.value)
+    handleClose()
+  }
+}
+
+// 处理显示状态更新
+const handleShowUpdate = (value: boolean) => {
+  emit('update:show', value)
+}
+
+// 关闭弹窗
+const handleClose = () => {
+  emit('update:show', false)
+}
+</script>
+
+<style scoped>
+.qr-style-selector {
+  padding: 20px;
+}
+
+/* 样式选择区域 */
+.styles-section h3 {
+  margin-bottom: 20px;
+  color: var(--color-text-1);
+  font-size: 18px;
+  font-weight: 600;
+}
+
+.styles-grid {
+  display: grid;
+  grid-template-columns: repeat(auto-fill, minmax(120px, 1fr));
+  gap: 20px;
+  margin-bottom: 30px;
+  max-height: 400px;
+  overflow-y: auto;
+  padding: 10px;
+}
+
+.style-item {
+  display: flex;
+  flex-direction: column;
+  align-items: center;
+  gap: 10px;
+  padding: 15px;
+  border: 2px solid transparent;
+  border-radius: 12px;
+  cursor: pointer;
+  transition: all 0.3s ease;
+  background: var(--color-card-bg);
+}
+
+.style-item:hover {
+  border-color: var(--color-primary-soft);
+  transform: translateY(-2px);
+  box-shadow: 0 4px 12px rgba(0, 0, 0, 0.1);
+}
+
+.style-item.active {
+  border-color: var(--color-primary);
+  background: var(--color-primary-soft);
+  box-shadow: 0 0 0 2px rgba(24, 160, 88, 0.2);
+}
+
+.qr-preview {
+  display: flex;
+  justify-content: center;
+  align-items: center;
+  padding: 10px;
+  border-radius: 6px;
+  transition: all 0.3s ease;
+  position: relative;
+}
+
+/* 选中状态指示器 */
+.selected-indicator {
+  position: absolute;
+  top: 5px;
+  right: 5px;
+  width: 24px;
+  height: 24px;
+  background: var(--color-primary);
+  border-radius: 50%;
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  color: white;
+  font-size: 12px;
+  box-shadow: 0 2px 4px rgba(0, 0, 0, 0.2);
+  z-index: 10;
+}
+
+.style-name {
+  font-size: 12px;
+  font-weight: 500;
+  color: var(--color-text-2);
+  text-align: center;
+}
+
+.style-item.active .style-name {
+  color: var(--color-primary);
+  font-weight: 600;
+}
+
+/* 操作按钮 */
+.action-buttons {
+  display: flex;
+  justify-content: flex-end;
+  gap: 12px;
+  padding-top: 20px;
+  border-top: 1px solid var(--color-border);
+}
+
+/* 暗色主题适配 */
+.dark .styles-grid {
+  background: var(--color-dark-bg);
+}
+
+.dark .style-item {
+  background: var(--color-dark-card);
+}
+
+.dark .style-item:hover {
+  background: var(--color-dark-card-hover);
+}
+
+.dark .style-item.active {
+  background: rgba(24, 160, 88, 0.1);
+}
+
+/* 响应式 */
+@media (max-width: 768px) {
+  .qr-style-selector {
+    padding: 15px;
+  }
+
+  .styles-grid {
+    grid-template-columns: repeat(auto-fill, minmax(100px, 1fr));
+    gap: 15px;
+    max-height: 300px;
+  }
+
+  .style-item {
+    padding: 10px;
+  }
+}
+
+/* 滚动条样式 */
+.styles-grid::-webkit-scrollbar {
+  width: 6px;
+}
+
+.styles-grid::-webkit-scrollbar-track {
+  background: var(--color-border);
+  border-radius: 3px;
+}
+
+.styles-grid::-webkit-scrollbar-thumb {
+  background: var(--color-text-3);
+  border-radius: 3px;
+}
+
+.styles-grid::-webkit-scrollbar-thumb:hover {
+  background: var(--color-text-2);
+}
+</style>

web/components/Announcement.vue

@@ -0,0 +1,198 @@
+<template>
+  <div v-if="shouldShowAnnouncement" class="announcement-container px-3 py-1">
+    <!-- 桌面端：显示完整公告内容 -->
+    <div v-if="!isMobile" class="flex items-center justify-between min-h-[24px]">
+      <div class="flex items-center gap-2 flex-1 overflow-hidden">
+        <i class="fas fa-bullhorn text-blue-600 dark:text-blue-400 text-sm flex-shrink-0"></i>
+        <div class="announcement-content overflow-hidden">
+          <div class="announcement-item active">
+            <span class="text-sm text-gray-700 dark:text-gray-300 truncate" v-html="validAnnouncements[currentIndex].content"></span>
+          </div>
+        </div>
+      </div>
+      <div class="flex items-center gap-1 text-xs text-gray-500 dark:text-gray-400 flex-shrink-0 ml-2">
+        <span>{{ (currentIndex + 1) }}/{{ validAnnouncements.length }}</span>
+        <button @click="nextAnnouncement" class="hover:text-blue-500 transition-colors">
+          <i class="fas fa-chevron-right text-xs"></i>
+        </button>
+      </div>
+    </div>
+
+    <!-- 移动端：使用 Marquee 滚动显示 -->
+    <div v-else class="flex items-center gap-2 min-h-[24px]">
+      <i class="fas fa-bullhorn text-blue-600 dark:text-blue-400 text-sm flex-shrink-0"></i>
+      <div class="flex-1 overflow-hidden">
+        <n-marquee
+          :speed="30"
+          :delay="0"
+          :loop="true"
+          :auto-play="true"
+          :pause-on-hover="true"
+        >
+          <span
+            v-for="(announcement, index) in validAnnouncements"
+            :key="index"
+            class="text-sm text-gray-700 dark:text-gray-300 inline-block mx-4"
+            v-html="announcement.content"
+          ></span>
+        </n-marquee>
+      </div>
+    </div>
+  </div>
+</template>
+
+<script setup lang="ts">
+// 使用系统配置store获取公告数据
+import { useSystemConfigStore } from '~/stores/systemConfig'
+const systemConfigStore = useSystemConfigStore()
+await systemConfigStore.initConfig(false, false)
+const systemConfig = computed(() => systemConfigStore.config)
+
+interface AnnouncementItem {
+  content: string
+  enabled: boolean
+}
+
+// 移动端检测
+const isMobile = ref(false)
+
+// 检测是否为移动端
+const checkMobile = () => {
+  if (process.client) {
+    // 检测屏幕宽度
+    isMobile.value = window.innerWidth < 768
+
+    // 也可以使用用户代理检测
+    const userAgent = navigator.userAgent.toLowerCase()
+    const mobileKeywords = ['android', 'iphone', 'ipad', 'ipod', 'blackberry', 'windows phone']
+    const isMobileDevice = mobileKeywords.some(keyword => userAgent.includes(keyword))
+
+    // 结合屏幕宽度和设备类型判断
+    isMobile.value = isMobile.value || isMobileDevice
+  }
+}
+
+const currentIndex = ref(0)
+const interval = ref<NodeJS.Timeout | null>(null)
+
+// 计算有效公告（开启状态且有内容的公告）
+const validAnnouncements = computed(() => {
+  if (!systemConfig.value?.announcements) return []
+
+  const announcements = Array.isArray(systemConfig.value.announcements)
+    ? systemConfig.value.announcements
+    : JSON.parse(systemConfig.value.announcements || '[]')
+
+  return announcements.filter((item: AnnouncementItem) =>
+    item.enabled && item.content && item.content.trim()
+  )
+})
+
+// 判断是否应该显示公告
+const shouldShowAnnouncement = computed(() => {
+  return systemConfig.value?.enable_announcements && validAnnouncements.value.length > 0
+})
+
+// 自动切换公告
+const startAutoSwitch = () => {
+  if (validAnnouncements.value.length > 1) {
+    interval.value = setInterval(() => {
+      currentIndex.value = (currentIndex.value + 1) % validAnnouncements.value.length
+    }, 4000) // 每4秒切换一次
+  }
+}
+
+// 手动切换到下一条公告
+const nextAnnouncement = () => {
+  currentIndex.value = (currentIndex.value + 1) % validAnnouncements.value.length
+}
+
+// 监听公告数据变化，重新开始自动切换（仅桌面端）
+watch(() => validAnnouncements.value.length, (newLength) => {
+  if (newLength > 0) {
+    currentIndex.value = 0
+    stopAutoSwitch()
+    if (!isMobile.value) {
+      startAutoSwitch()
+    }
+  }
+})
+
+// 清理定时器
+const stopAutoSwitch = () => {
+  if (interval.value) {
+    clearInterval(interval.value)
+    interval.value = null
+  }
+}
+
+onMounted(() => {
+  // 初始化移动端检测
+  checkMobile()
+
+  // 监听窗口大小变化
+  if (process.client) {
+    window.addEventListener('resize', checkMobile)
+  }
+
+  if (shouldShowAnnouncement.value && !isMobile.value) {
+    // 桌面端才启动自动切换
+    startAutoSwitch()
+  }
+})
+
+onUnmounted(() => {
+  stopAutoSwitch()
+
+  // 清理事件监听器
+  if (process.client) {
+    window.removeEventListener('resize', checkMobile)
+  }
+})
+</script>
+
+<style scoped>
+.announcement-content {
+  position: relative;
+  height: 20px; /* 固定高度 */
+}
+
+.announcement-item {
+  opacity: 0;
+  transform: translateY(5px);
+  transition: all 0.5s ease-in-out;
+}
+
+.announcement-item.active {
+  opacity: 1;
+  transform: translateY(0);
+}
+
+/* 移动端 Marquee 样式优化 */
+@media (max-width: 767px) {
+  .announcement-container {
+    background: linear-gradient(90deg, transparent 0%, rgba(59, 130, 246, 0.05) 50%, transparent 100%);
+    border-radius: 6px;
+  }
+}
+
+/* Marquee 内文字样式 */
+:deep(.n-marquee) {
+  --n-bezier: cubic-bezier(0.4, 0, 0.2, 1);
+}
+
+:deep(.n-marquee__content) {
+  display: flex;
+  align-items: center;
+  min-height: 20px;
+}
+
+/* 暗色主题适配 */
+.dark-theme .announcement-container {
+  background: transparent;
+}
+
+.dark .announcement-container {
+  background: linear-gradient(90deg, transparent 0%, rgba(59, 130, 246, 0.1) 50%, transparent 100%);
+}
+</style>

web/components/AppFooter.vue

@@ -28,7 +28,7 @@ import { useSystemConfigStore } from '~/stores/systemConfig'
 const systemConfigStore = useSystemConfigStore()
 await systemConfigStore.initConfig(false, false)
 const systemConfig = computed(() => systemConfigStore.config)
-console.log(systemConfig.value)
+// console.log(systemConfig.value)
 
 // 组件挂载时获取版本信息
 onMounted(() => {

web/components/CopyrightModal.vue

@@ -0,0 +1,293 @@
+<template>
+  <n-modal
+    :show="visible"
+    @update:show="handleClose"
+    :mask-closable="true"
+    preset="card"
+    title="版权申述"
+    class="max-w-lg w-full"
+    :style="{ maxWidth: '95vw' }"
+  >
+
+    <div class="space-y-4">
+      <div class="bg-blue-50 dark:bg-blue-500/10 border border-blue-200 dark:border-blue-400/30 rounded-lg p-4">
+        <div class="flex items-start gap-2">
+          <i class="fas fa-info-circle text-blue-600 dark:text-blue-400 mt-0.5"></i>
+          <div class="text-sm text-blue-800 dark:text-blue-200">
+            <p class="font-medium mb-1">版权申述说明：</p>
+            <ul class="space-y-1 text-xs">
+              <li>• 请确保您是版权所有者或授权代表</li>
+              <li>• 提供真实准确的版权证明材料</li>
+              <li>• 虚假申述可能承担法律责任</li>
+              <li>• 我们会在收到申述后及时处理</li>
+            </ul>
+          </div>
+        </div>
+      </div>
+
+      <n-form
+        ref="formRef"
+        :model="formData"
+        :rules="rules"
+        label-placement="top"
+        require-mark-placement="right-hanging"
+      >
+        <n-form-item label="申述人身份" path="identity">
+          <n-select
+            v-model:value="formData.identity"
+            :options="identityOptions"
+            placeholder="请选择您的身份"
+            :loading="loading"
+          />
+        </n-form-item>
+
+        <n-form-item label="权利证明" path="proof_type">
+          <n-select
+            v-model:value="formData.proof_type"
+            :options="proofOptions"
+            placeholder="请选择权利证明类型"
+          />
+        </n-form-item>
+
+        <n-form-item label="版权证明文件" path="proof_files">
+          <n-upload
+            v-model:file-list="formData.proof_files"
+            :max="5"
+            :default-upload="false"
+            accept=".pdf,.jpg,.jpeg,.png,.gif"
+            @change="handleFileChange"
+          >
+            <n-upload-dragger>
+              <div class="text-center">
+                <i class="fas fa-cloud-upload-alt text-4xl text-gray-400 mb-2"></i>
+                <p class="text-gray-600 dark:text-gray-300">
+                  点击或拖拽上传版权证明文件
+                </p>
+                <p class="text-xs text-gray-500 dark:text-gray-400 mt-1">
+                  支持 PDF、JPG、PNG 格式，最多5个文件
+                </p>
+              </div>
+            </n-upload-dragger>
+          </n-upload>
+        </n-form-item>
+
+        <n-form-item label="申述理由" path="reason">
+          <n-input
+            v-model:value="formData.reason"
+            type="textarea"
+            placeholder="请详细说明版权申述理由，包括具体的侵权情况..."
+            :autosize="{ minRows: 4, maxRows: 8 }"
+            maxlength="1000"
+            show-count
+          />
+        </n-form-item>
+
+        <n-form-item label="联系信息" path="contact_info">
+          <n-input
+            v-model:value="formData.contact_info"
+            placeholder="请提供有效的联系方式（邮箱/电话），以便我们与您联系"
+          />
+        </n-form-item>
+
+        <n-form-item label="申述人姓名" path="claimant_name">
+          <n-input
+            v-model:value="formData.claimant_name"
+            placeholder="请填写申述人真实姓名或公司名称"
+          />
+        </n-form-item>
+
+        <n-form-item>
+          <n-checkbox v-model:checked="formData.agreement">
+            我确认以上信息真实有效，并承担相应的法律责任
+          </n-checkbox>
+        </n-form-item>
+      </n-form>
+
+      <div class="text-xs text-red-600 dark:text-red-400 bg-red-50 dark:bg-red-500/10 rounded p-3">
+        <i class="fas fa-exclamation-triangle mr-1"></i>
+        请谨慎提交版权申述，虚假申述可能承担法律责任
+      </div>
+    </div>
+
+    <template #footer>
+      <div class="flex justify-end gap-3">
+        <n-button @click="handleClose" :disabled="submitting">
+          取消
+        </n-button>
+        <n-button
+          type="primary"
+          :loading="submitting"
+          :disabled="!formData.agreement"
+          @click="handleSubmit"
+        >
+          提交申述
+        </n-button>
+      </div>
+    </template>
+  </n-modal>
+</template>
+
+<script setup lang="ts">
+import { useMessage } from 'naive-ui'
+import { useResourceApi } from '~/composables/useApi'
+
+const resourceApi = useResourceApi()
+
+interface Props {
+  visible: boolean
+  resourceKey: string
+}
+
+interface Emits {
+  (e: 'close'): void
+  (e: 'submitted'): void
+}
+
+const props = defineProps<Props>()
+const emit = defineEmits<Emits>()
+
+const message = useMessage()
+
+// 表单数据
+const formData = ref({
+  identity: '',
+  proof_type: '',
+  proof_files: [],
+  reason: '',
+  contact_info: '',
+  claimant_name: '',
+  agreement: false
+})
+
+// 表单引用
+const formRef = ref()
+
+// 状态
+const loading = ref(false)
+const submitting = ref(false)
+
+// 身份选项
+const identityOptions = [
+  { label: '版权所有者', value: 'copyright_owner' },
+  { label: '授权代表', value: 'authorized_agent' },
+  { label: '律师事务所', value: 'law_firm' },
+  { label: '其他', value: 'other' }
+]
+
+// 证明类型选项
+const proofOptions = [
+  { label: '版权登记证书', value: 'copyright_certificate' },
+  { label: '作品首发证明', value: 'first_publish_proof' },
+  { label: '授权委托书', value: 'authorization_letter' },
+  { label: '身份证明文件', value: 'identity_document' },
+  { label: '其他证明材料', value: 'other_proof' }
+]
+
+// 表单验证规则
+const rules = {
+  identity: {
+    required: true,
+    message: '请选择申述人身份',
+    trigger: ['blur', 'change']
+  },
+  proof_type: {
+    required: true,
+    message: '请选择权利证明类型',
+    trigger: ['blur', 'change']
+  },
+  reason: {
+    required: true,
+    message: '请详细说明申述理由',
+    trigger: 'blur'
+  },
+  contact_info: {
+    required: true,
+    message: '请提供联系信息',
+    trigger: 'blur'
+  },
+  claimant_name: {
+    required: true,
+    message: '请填写申述人姓名',
+    trigger: 'blur'
+  }
+}
+
+// 处理文件变化
+const handleFileChange = (options: any) => {
+  console.log('文件变化:', options)
+}
+
+// 关闭模态框
+const handleClose = () => {
+  if (!submitting.value) {
+    emit('close')
+    resetForm()
+  }
+}
+
+// 重置表单
+const resetForm = () => {
+  formData.value = {
+    identity: '',
+    proof_type: '',
+    proof_files: [],
+    reason: '',
+    contact_info: '',
+    claimant_name: '',
+    agreement: false
+  }
+  formRef.value?.restoreValidation()
+}
+
+// 提交申述
+const handleSubmit = async () => {
+  try {
+    await formRef.value?.validate()
+
+    if (!formData.value.agreement) {
+      message.warning('请确认申述信息真实有效并承担相应法律责任')
+      return
+    }
+
+    submitting.value = true
+
+    // 构建证明文件数组（从文件列表转换为字符串）
+    const proofFilesArray = formData.value.proof_files.map((file: any) => ({
+      id: file.id,
+      name: file.name,
+      status: file.status,
+      percentage: file.percentage
+    }))
+
+    // 调用实际的版权申述API
+    const copyrightData = {
+      resource_key: props.resourceKey,
+      identity: formData.value.identity,
+      proof_type: formData.value.proof_type,
+      reason: formData.value.reason,
+      contact_info: formData.value.contact_info,
+      claimant_name: formData.value.claimant_name,
+      proof_files: JSON.stringify(proofFilesArray), // 将文件信息转换为JSON字符串
+      user_agent: navigator.userAgent,
+      ip_address: '' // 服务端获取IP
+    }
+
+    const result = await resourceApi.submitCopyrightClaim(copyrightData)
+    console.log('版权申述提交结果:', result)
+
+    message.success('版权申述提交成功，我们会在24小时内处理并回复')
+    emit('submitted') // 发送提交事件
+  } catch (error: any) {
+    console.error('提交版权申述失败:', error)
+    let errorMessage = '提交失败，请重试'
+    if (error && typeof error === 'object' && error.data) {
+      errorMessage = error.data.message || errorMessage
+    } else if (error && typeof error === 'object' && error.message) {
+      errorMessage = error.message
+    }
+    message.error(errorMessage)
+  } finally {
+    submitting.value = false
+  }
+}
+</script>

web/components/FloatButtons.vue

@@ -0,0 +1,246 @@
+<template>
+  <div v-if="enableFloatButtons" class="float-right float-buttons">
+
+   <!-- 返回顶部按钮 -->
+   <a class="float-btn ontop fade show" @click="scrollToTop" title="返回顶部">
+     <i class="fa fa-angle-up em12" style="color: #3498db;"></i>
+   </a>
+
+   <!-- 扫一扫在手机上体验 -->
+   <span class="float-btn qrcode-btn hover-show">
+     <i class="fa fa-qrcode" style="color: #27ae60;"></i>
+     <div class="hover-show-con dropdown-menu qrcode-btn" style="width: 150px; height: auto;">
+       <div class="qrcode" data-size="100">
+         <QRCodeDisplay
+           v-if="qrCodePreset"
+           :data="currentUrl"
+           :preset="qrCodePreset"
+           :width="100"
+           :height="100"
+         />
+         <n-qr-code v-else :value="currentUrl" :size="100" :bordered="false" />
+       </div>
+       <div class="mt6 px12 muted-color">扫一扫在手机上体验</div>
+     </div>
+   </span>
+
+   <!-- Telegram -->
+   <span v-if="telegramQrImage" class="newadd-btns hover-show float-btn telegram-btn">
+     <i class="fab fa-telegram-plane" style="color: #0088cc;"></i>
+     <div class="hover-show-con dropdown-menu drop-newadd newadd-btns" style="width: 200px; height: auto;">
+       <div class="image" data-size="100">
+         <n-image :src="getImageUrl(telegramQrImage)" width="180" height="180" />
+       </div>
+       <div class="mt6 px12 muted-color text-center">扫码加入Telegram群组</div>
+     </div>
+   </span>
+
+   <!-- 微信公众号 -->
+   <a v-if="wechatSearchImage" class="float-btn service-wechat hover-show nowave" title="扫码添加微信" href="javascript:;">
+     <i class="fab fa-weixin" style="color: #07c160;"></i>
+     <div class="hover-show-con dropdown-menu service-wechat" style="width: 300px; height: auto;">
+        <!-- <div class="image" data-size="100"> -->
+         <n-image :src="getImageUrl(wechatSearchImage)" class="radius4" />
+        <!-- </div> -->
+     </div>
+   </a>
+
+  </div>
+</template>
+
+<script setup lang="ts">
+// 导入系统配置store
+import { useSystemConfigStore } from '~/stores/systemConfig'
+import { QRCodeDisplay, findPresetByName } from '~/components/QRCode'
+
+// 获取系统配置store
+const systemConfigStore = useSystemConfigStore()
+
+// 使用图片URL composable
+const { getImageUrl } = useImageUrl()
+
+// 计算属性：是否启用浮动按钮
+const enableFloatButtons = computed(() => {
+  return systemConfigStore.config?.enable_float_buttons || false
+})
+
+// 计算属性：微信搜一搜图片
+const wechatSearchImage = computed(() => {
+  return systemConfigStore.config?.wechat_search_image || ''
+})
+
+// 计算属性：Telegram二维码图片
+const telegramQrImage = computed(() => {
+  return systemConfigStore.config?.telegram_qr_image || ''
+})
+
+// 计算属性：二维码样式预设
+const qrCodePreset = computed(() => {
+  const styleName = systemConfigStore.config?.qr_code_style || 'Plain'
+  return findPresetByName(styleName)
+})
+
+// 滚动到顶部
+const scrollToTop = () => {
+  window.scrollTo({
+    top: 0,
+    behavior: 'smooth'
+  })
+}
+
+// 获取当前页面URL
+const currentUrl = computed(() => {
+  if (typeof window !== 'undefined') {
+    return window.location.href
+  }
+  return ''
+})
+</script>
+
+<style scoped>
+/* 悬浮按钮容器 */
+.float-right {
+  position: fixed;
+  right: 20px;
+  bottom: 60px;
+  z-index: 1030;
+  display: flex;
+  flex-direction: column;
+  gap: 10px;
+  padding-bottom: env(safe-area-inset-bottom);
+}
+
+/* 悬浮按钮基础样式 */
+.float-btn {
+  width: 40px;
+  height: 40px;
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  background: rgba(200, 200, 200, 0.4);
+  border-radius: 50%;
+  color: #666;
+  font-size: 18px;
+  cursor: pointer;
+  transition: all 0.3s ease;
+}
+
+.float-btn:hover {
+  background: rgba(200, 200, 200, 0.6);
+  transform: translateY(-2px);
+}
+
+/* 返回顶部按钮特殊样式 */
+.float-btn.ontop {
+  opacity: 0;
+  transform: translateY(10px);
+  visibility: hidden;
+}
+
+.ontop.show {
+  opacity: 1;
+  transform: translateY(0);
+  visibility: visible;
+}
+
+/* 悬浮菜单 */
+.hover-show-con {
+  position: absolute;
+  right: 50px;
+  background: #fff;
+  border-radius: 8px;
+  box-shadow: 0 4px 20px rgba(0, 0, 0, 0.15);
+  padding: 10px;
+  opacity: 0;
+  visibility: hidden;
+  transform: translateY(10px);
+  transition: all 0.3s ease;
+  z-index: 1001;
+}
+
+.hover-show:hover .hover-show-con {
+  opacity: 1;
+  visibility: visible;
+  transform: translateY(0);
+}
+
+/* 按钮位置样式 */
+.hover-show-con.qrcode-btn {
+  top: -60px;
+}
+
+.hover-show-con.newadd-btns {
+  top: -100px;
+}
+
+.hover-show-con.service-wechat {
+  top: -100px;
+}
+
+/* 图片容器 */
+.image {
+  text-align: center;
+  padding: 5px;
+}
+
+.image .n-image {
+  border-radius: 8px;
+  overflow: hidden;
+}
+
+/* 居中文字 */
+.text-center {
+  text-align: center;
+  margin-top: 8px;
+  color: #666;
+  font-size: 12px;
+}
+
+/* 悬浮菜单中的文字 */
+.hover-show-con .muted-color {
+  font-size: 12px;
+}
+
+/* 二维码容器 */
+.qr-container {
+  height: 200px;
+  width: 200px;
+  background-color: #F5F5F5;
+}
+
+.n-qr-code {
+  padding: 0 !important;
+}
+
+/* 响应式 */
+@media (max-width: 768px) {
+  .float-right {
+    right: 10px;
+    gap: 8px;
+  }
+
+  .float-btn {
+    width: 36px;
+    height: 36px;
+    font-size: 16px;
+  }
+
+  .hover-show-con {
+    right: 46px;
+    min-width: 140px;
+  }
+
+  /* 小屏下隐藏二维码和Telegram按钮 */
+  .float-btn.qrcode-btn {
+    display: none;
+  }
+}
+float-buttons {
+  font-size: 8px;
+}
+.dropdown-menu {
+  display: flex;
+  flex-direction: column;
+  align-items: center;
+}
+</style>