\n 死侍 1-3\n
\n\n
\n \n \n 注：本片不适合公共场合观看
\n\n
\n \n \n \n \n
\n {{ .PluginName }} 管理界面
\n \n \n `\n ```\n\n5. **可选实现**: Web路由是**可选功能**，只有需要自定义HTTP接口的插件才需要实现\n\n### 2. Service层过滤控制详解\n\n#### 构造函数选择\n\n```go\n// 标准插件构造函数（默认启用Service层过滤）\nfunc NewStandardPlugin() *StandardPlugin {\n return &StandardPlugin{\n BaseAsyncPlugin: plugin.NewBaseAsyncPlugin(\"standard\", 3), // 默认skipServiceFilter=false\n }\n}\n\n// 磁力搜索插件构造函数（跳过Service层过滤）\nfunc NewMagnetPlugin() *MagnetPlugin {\n return &MagnetPlugin{\n BaseAsyncPlugin: plugin.NewBaseAsyncPluginWithFilter(\"magnet\", 4, true), // skipServiceFilter=true\n }\n}\n```\n\n#### 实际应用示例\n\n**ThePirateBay插件示例**:\n```go\n// thepiratebay插件的实际实现\nfunc NewThePirateBayPlugin() *ThePirateBayPlugin {\n return &ThePirateBayPlugin{\n BaseAsyncPlugin: plugin.NewBaseAsyncPluginWithFilter(\"thepiratebay\", 4, true), // 跳过Service层过滤\n optimizedClient: createOptimizedHTTPClient(),\n }\n}\n\nfunc (p *ThePirateBayPlugin) searchImpl(client *http.Client, keyword string, ext map[string]interface{}) ([]model.SearchResult, error) {\n // 支持英文搜索优化\n searchKeyword := keyword\n if ext != nil {\n if titleEn, exists := ext[\"title_en\"]; exists {\n if titleEnStr, ok := titleEn.(string); ok && titleEnStr != \"\" {\n searchKeyword = titleEnStr\n }\n }\n }\n \n // 获取搜索结果\n allResults := p.fetchAllResults(client, searchKeyword)\n \n // 标题格式优化：将'.'替换为空格，提高关键词匹配准确度\n for i := range allResults {\n allResults[i].Title = strings.ReplaceAll(allResults[i].Title, \".\", \" \")\n }\n \n // 插件层过滤（使用处理后的搜索关键词）\n filteredResults := plugin.FilterResultsByKeyword(allResults, searchKeyword)\n \n return filteredResults, nil\n // 注意：Service层会通过SkipServiceFilter()方法跳过二次过滤\n}\n```\n\n#### 过滤策略对比\n\n| 过滤类型 | 标准插件 | 磁力搜索插件 |\n|----------|----------|--------------|\n| **插件层过滤** | ✅ 使用原始关键词 | ✅ 使用searchKeyword（支持title_en） |\n| **Service层过滤** | ✅ 再次过滤 | ❌ 跳过过滤 |\n| **结果特点** | 精确匹配 | 宽泛搜索 |\n| **适用场景** | 中文网盘资源 | 英文磁力资源 |\n\n#### 动态过滤检测机制\n\nService层通过以下机制动态判断是否需要过滤：\n\n```go\n// service/search_service.go 中的实现\nfunc mergeResultsByType(...) {\n // 检查插件是否需要跳过Service层过滤\n var skipKeywordFilter bool = false\n if result.UniqueID != \"\" && strings.Contains(result.UniqueID, \"-\") {\n parts := strings.SplitN(result.UniqueID, \"-\", 2)\n if len(parts) >= 1 {\n pluginName := parts[0]\n // 通过插件注册表动态获取过滤设置\n if pluginInstance, exists := plugin.GetPluginByName(pluginName); exists {\n skipKeywordFilter = pluginInstance.SkipServiceFilter()\n }\n }\n }\n \n // 根据插件设置决定是否过滤\n if !skipKeywordFilter && keyword != \"\" && !strings.Contains(strings.ToLower(title), lowerKeyword) {\n continue // 过滤掉不匹配的结果\n }\n}\n```\n\n### 2. 扩展参数处理\n\n```go\n// 支持的扩展参数示例\next := map[string]interface{}{\n \"title_en\": \"English Title\", // 英文标题\n \"is_all\": true, // 全量搜索标志\n \"year\": 2023, // 年份限制\n \"type\": \"movie\", // 内容类型\n}\n\n// 在插件中处理\nfunc (p *MyPlugin) handleExtParams(ext map[string]interface{}) searchOptions {\n opts := searchOptions{}\n \n if titleEn, ok := ext[\"title_en\"].(string); ok {\n opts.TitleEn = titleEn\n }\n \n if isAll, ok := ext[\"is_all\"].(bool); ok {\n opts.IsAll = isAll\n }\n \n return opts\n}\n```\n\n### 2. 缓存策略\n\n```go\n// 设置缓存TTL\np.SetCacheTTL(2 * time.Hour)\n\n// 手动缓存更新\np.UpdateMainCache(cacheKey, results, ttl, true, keyword)\n```\n\n### 3. 错误处理\n\n```go\nfunc (p *MyPlugin) searchImpl(client *http.Client, keyword string, ext map[string]interface{}) ([]model.SearchResult, error) {\n // 网络错误处理\n resp, err := client.Get(url)\n if err != nil {\n return nil, fmt.Errorf(\"[%s] 网络请求失败: %w\", p.Name(), err)\n }\n \n // HTTP状态码检查\n if resp.StatusCode != 200 {\n return nil, fmt.Errorf(\"[%s] HTTP错误: %d\", p.Name(), resp.StatusCode)\n }\n \n // JSON解析错误 - 推荐使用项目统一的JSON工具\n body, err := io.ReadAll(resp.Body)\n if err != nil {\n return nil, fmt.Errorf(\"[%s] 读取响应失败: %w\", p.Name(), err)\n }\n \n var apiResp APIResponse\n if err := json.Unmarshal(body, &apiResp); err != nil {\n return nil, fmt.Errorf(\"[%s] JSON解析失败: %w\", p.Name(), err)\n }\n \n // 业务逻辑错误\n if apiResp.Code != 0 {\n return nil, fmt.Errorf(\"[%s] API错误: %s\", p.Name(), apiResp.Message)\n }\n \n return results, nil\n}\n```\n\n## 性能优化\n\n### 1. HTTP客户端优化\n\n```go\n// 使用连接池\nclient := &http.Client{\n Timeout: 30 * time.Second,\n Transport: &http.Transport{\n MaxIdleConns: 100,\n MaxIdleConnsPerHost: 10,\n IdleConnTimeout: 90 * time.Second,\n },\n}\n```\n\n### 2. 内存优化\n\n```go\n// 预分配切片容量\nresults := make([]model.SearchResult, 0, expectedCount)\n\n// 及时释放大对象\ndefer func() {\n apiResp = APIResponse{}\n}()\n```\n\n### 3. 并发控制\n\n```go\n// 使用插件内置的工作池，避免创建过多goroutine\n// BaseAsyncPlugin 已经提供了工作池管理\n```\n\n## 测试和调试\n\n### 1. 单元测试\n\n```go\nfunc TestMyPlugin_Search(t *testing.T) {\n plugin := &MyPlugin{\n BaseAsyncPlugin: plugin.NewBaseAsyncPlugin(\"test\", 3),\n }\n \n results, err := plugin.Search(\"测试关键词\", nil)\n assert.NoError(t, err)\n assert.NotEmpty(t, results)\n}\n```\n\n### 2. 集成测试\n\n```bash\n# 使用API测试插件\ncurl \"http://localhost:8888/api/search?kw=测试&plugins=myplugin\"\n```\n\n### 3. 性能测试\n\n```bash\n# 使用压力测试脚本\npython3 stress_test.py\n```\n\n## 部署和配置\n\n### 1. 插件注册\n\n确保在 `init()` 函数中注册插件：\n\n```go\nfunc init() {\n p := &MyPlugin{\n BaseAsyncPlugin: plugin.NewBaseAsyncPlugin(\"myplugin\", 3),\n }\n plugin.RegisterGlobalPlugin(p)\n}\n```\n\n### 2. 环境配置\n\n```bash\n# 异步插件配置\nexport ASYNC_PLUGIN_ENABLED=true\nexport ASYNC_RESPONSE_TIMEOUT=4\nexport ASYNC_MAX_BACKGROUND_WORKERS=40\nexport ASYNC_MAX_BACKGROUND_TASKS=200\n```\n\n### 3. 生产部署注意事项\n\n1. **资源限制**: 根据服务器配置调整工作池大小\n2. **监控告警**: 监控插件响应时间和错误率\n3. **日志管理**: 合理设置日志级别，避免日志过多\n4. **缓存配置**: 根据数据更新频率调整缓存TTL\n\n## 现有插件参考\n\n### 标准网盘搜索插件\n- **jikepan** - 标准网盘插件，启用Service层过滤\n- **pan666** - 标准网盘插件，启用Service层过滤\n- **hunhepan** - 标准网盘插件，启用Service层过滤\n- **pansearch** - 标准网盘插件，启用Service层过滤\n- **qupansou** - 标准网盘插件，启用Service层过滤\n- **panta** - 高质量网盘插件，启用Service层过滤\n\n### 特殊搜索插件\n- **thepiratebay** - 磁力搜索插件，跳过Service层过滤，支持title_en参数，标题格式化处理\n\n## 插件开发最佳实践 ⭐\n\n### 核心原则\n\n1. **命名规范**: 插件名使用小写字母和数字\n2. **优先级设置**: 1-2为高优先级，3为标准，4-5为低优先级\n3. **关键词过滤**: 使用 `FilterResultsByKeyword` 提高结果相关性\n4. **缓存友好**: 合理设置缓存TTL，避免频繁请求\n5. **资源清理**: 及时关闭连接和释放资源\n6. **过滤策略**: 根据插件类型选择合适的Service层过滤策略\n\n### 必须实现的优化点\n\n#### 1. Service层过滤策略选择 ⭐ 新功能\n\n```go\n// ✅ 磁力搜索插件 - 跳过Service层过滤\nfunc NewMagnetSearchPlugin() *MagnetSearchPlugin {\n return &MagnetSearchPlugin{\n BaseAsyncPlugin: plugin.NewBaseAsyncPluginWithFilter(\"magnet\", 4, true), // skipServiceFilter=true\n }\n}\n\n// ✅ 标准网盘插件 - 启用Service层过滤 \nfunc NewPanSearchPlugin() *PanSearchPlugin {\n return &PanSearchPlugin{\n BaseAsyncPlugin: plugin.NewBaseAsyncPlugin(\"pansearch\", 3), // 默认skipServiceFilter=false\n }\n}\n```\n\n**选择指南**:\n- **跳过过滤** (`true`): 磁力搜索、英文资源、特殊格式标题、聚合搜索\n- **启用过滤** (`false`): 网盘搜索、中文资源、API接口、标准格式标题\n\n**注意事项**:\n- 跳过Service层过滤的插件**必须**在插件内部进行`FilterResultsByKeyword`过滤\n- 插件层过滤使用的关键词应与实际搜索关键词一致（支持`title_en`等参数）\n- 标题格式化处理应在过滤之前进行（如将`\".\"` 替换为`\" \"`）\n\n#### 2. SearchResult字段设置规范 ⭐ 重要\n\n```go\n// ✅ 正确的SearchResult设置\nresult := model.SearchResult{\n UniqueID: fmt.Sprintf(\"%s-%s\", p.Name(), itemID), // 插件名-资源ID\n Title: title, // 资源标题\n Content: description, // 资源描述\n Links: downloadLinks, // 下载链接列表\n Tags: tags, // 分类标签\n Channel: \"\", // ⭐ 重要：插件搜索结果必须为空字符串\n Datetime: time.Now(), // 发布时间\n}\n\n// ❌ 错误的Channel设置\nresult.Channel = p.Name() // 不要设置为插件名！\n```\n\n**Channel字段使用规则**:\n- **插件搜索结果**: `Channel` 必须为空字符串 `\"\"`\n- **Telegram频道**: `Channel` 才设置为频道名称\n- **目的**: 区分搜索来源，便于前端展示和后端统计\n\n**Links字段处理规则** ⭐ 重要:\n- **必须有链接**: 系统会自动过滤掉 `Links` 为空或长度为0的结果\n- **链接质量**: 确保返回的链接都是有效的网盘链接，避免返回无效链接\n- **链接验证**: 建议使用 `isValidNetworkDriveURL()` 函数预先验证链接有效性\n\n#### 2. HTTP请求最佳实践 ⭐ 重要\n\n```go\n// ✅ 正确的请求实现\nfunc (p *MyPlugin) makeRequest(url string, client *http.Client) (*http.Response, error) {\n // 使用context控制超时\n ctx, cancel := context.WithTimeout(context.Background(), 30*time.Second)\n defer cancel()\n \n // 创建请求\n req, err := http.NewRequestWithContext(ctx, \"GET\", url, nil)\n if err != nil {\n return nil, err\n }\n \n // 设置完整的请求头（避免反爬虫）\n 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\")\n req.Header.Set(\"Accept\", \"text/html,application/xhtml+xml,application/xml;q=0.9,image/webp,*/*;q=0.8\")\n req.Header.Set(\"Accept-Language\", \"zh-CN,zh;q=0.9,en;q=0.8\")\n req.Header.Set(\"Connection\", \"keep-alive\")\n req.Header.Set(\"Referer\", \"https://example.com/\")\n \n // 使用重试机制\n return p.doRequestWithRetry(req, client)\n}\n\n// ❌ 错误的简单实现\nfunc (p *MyPlugin) badRequest(url string, client *http.Client) (*http.Response, error) {\n return client.Get(url) // 没有超时控制、没有请求头、没有重试\n}\n```\n\n#### 2. 实现高级搜索接口 ⭐ 推荐\n\n```go\n// ✅ 推荐：实现两个方法\nfunc (p *MyPlugin) Search(keyword string, ext map[string]interface{}) ([]model.SearchResult, error) {\n result, err := p.SearchWithResult(keyword, ext)\n if err != nil {\n return nil, err\n }\n return result.Results, nil\n}\n\nfunc (p *MyPlugin) SearchWithResult(keyword string, ext map[string]interface{}) (model.PluginSearchResult, error) {\n return p.AsyncSearchWithResult(keyword, p.searchImpl, p.MainCacheKey, ext)\n}\n```\n\n#### 3. 错误处理增强 ⭐ 重要\n\n```go\n// ✅ 详细的错误信息\nif resp.StatusCode != 200 {\n return nil, fmt.Errorf(\"[%s] 请求失败，状态码: %d\", p.Name(), resp.StatusCode)\n}\n\n// ✅ 包装外部错误\nif err := json.NewDecoder(resp.Body).Decode(&data); err != nil {\n return nil, fmt.Errorf(\"[%s] JSON解析失败: %w\", p.Name(), err)\n}\n```\n\n#### 4. 重试机制模板 ⭐ 复制可用\n\n```go\nfunc (p *MyPlugin) doRequestWithRetry(req *http.Request, client *http.Client) (*http.Response, error) {\n maxRetries := 3\n var lastErr error\n \n for i := 0; i < maxRetries; i++ {\n if i > 0 {\n backoff := time.Duration(1<Gin Handler]\n B --> C[参数解析与验证
GET/POST处理]\n C --> D[参数预处理
规范化处理]\n \n D --> E[SearchService
主搜索服务]\n E --> F{源类型判断
sourceType}\n \n F -->|TG| G[并行TG搜索]\n F -->|Plugin| H[并行插件搜索]\n F -->|All| I[TG+插件并行搜索]\n \n I --> G\n I --> H\n \n %% TG搜索分支\n G --> G1[生成TG缓存键
GenerateTGCacheKey]\n G1 --> G2{强制刷新?
forceRefresh}\n G2 -->|否| G3[检查二级缓存
EnhancedTwoLevelCache]\n G2 -->|是| G6[跳过缓存检查]\n \n G3 --> G4{缓存命中?}\n G4 -->|是| G5[缓存反序列化
直接返回结果]\n G4 -->|否| G6[执行TG频道搜索
多频道并行]\n G6 --> G7[HTML解析
链接提取]\n G7 --> G8[结果标准化]\n G8 --> G9[更新缓存
SetBothLevels]\n \n %% 插件搜索分支 - 详细的异步处理\n H --> H1[生成插件缓存键
GeneratePluginCacheKey]\n H1 --> H2{强制刷新?
forceRefresh}\n H2 -->|否| H3[检查二级缓存
EnhancedTwoLevelCache]\n H2 -->|是| H6[跳过缓存检查]\n \n H3 --> H4{缓存命中?}\n H4 -->|是| H5[缓存反序列化
直接返回结果]\n H4 -->|否| H6[插件管理器调度
PluginManager]\n \n %% 异步插件详细流程\n H6 --> H7[异步插件初始化
SetMainCacheKey]\n H7 --> H8[工作池任务提交
WorkerPool]\n \n %% 双级超时机制的并行处理\n H8 --> H9{异步并行处理}\n \n %% 快速响应分支 (4秒)\n H9 --> H10[短超时处理
4秒快速响应]\n H10 --> H11[HTTP请求
短超时模式]\n H11 --> H12[部分结果解析
快速过滤]\n H12 --> H13[部分结果缓存
isFinal=false]\n H13 --> H14[立即返回
部分结果给用户]\n \n %% 持续处理分支 (30秒)\n H9 --> H15[长超时后台处理
最长30秒持续]\n H15 --> H16[HTTP请求
长超时模式]\n H16 --> H17[完整结果解析
深度过滤]\n H17 --> H18[结果去重合并
最终处理]\n H18 --> H19[完整结果缓存
isFinal=true]\n H19 --> H20[主缓存异步更新
DelayedBatchWrite]\n \n %% 结果合并处理\n G5 --> J[结果合并
mergeSearchResults]\n G9 --> J\n H5 --> J\n H14 --> J\n \n J --> K[智能排序算法
时间+关键词+插件等级]\n K --> L[结果过滤
高质量结果筛选]\n L --> M[网盘类型分组
mergeResultsByType]\n M --> N{结果类型
resultType}\n \n N -->|merged_by_type| O[返回分组结果]\n N -->|results| P[返回原始结果]\n N -->|all| Q[返回完整结果]\n \n O --> R[JSON响应]\n P --> R\n Q --> R\n R --> S[用户]\n \n %% 后台持续更新（不影响用户响应）\n H20 --> T[后台缓存完善
下次请求更完整]\n T -.-> U[持续优化
用户体验]\n \n %% 缓存系统\n subgraph Cache[二级缓存系统]\n CA[分片内存缓存
LRU + 原子操作]\n CB[分片磁盘缓存
GOB序列化]\n CC[智能缓存写入管理器
DelayedBatchWriteManager]\n CD[全局缓冲区管理器
BufferByPlugin策略]\n end\n \n G3 -.-> CA\n H3 -.-> CA\n CA -.-> CB\n G9 -.-> CC\n H13 -.-> CC\n H20 -.-> CC\n CC -.-> CD\n \n %% 样式定义\n classDef cacheNode fill:#e1f5fe,stroke:#01579b,stroke-width:2px\n classDef pluginNode fill:#f3e5f5,stroke:#4a148c,stroke-width:2px\n classDef searchNode fill:#e8f5e8,stroke:#1b5e20,stroke-width:2px\n classDef fastResponse fill:#fff3e0,stroke:#e65100,stroke-width:2px\n classDef slowProcess fill:#fce4ec,stroke:#880e4f,stroke-width:2px\n classDef processNode fill:#f5f5f5,stroke:#424242,stroke-width:2px\n \n class G3,H3,G5,H5,G9,H13,H20,CA,CB,CC,CD cacheNode\n class H6,H7,H8 pluginNode\n class G6,G7,G8 searchNode\n class H10,H11,H12,H13,H14 fastResponse\n class H15,H16,H17,H18,H19,H20,T slowProcess\n class D,J,K,L,M processNode\n```\n\n### 2.2 异步插件工作流程\n\n```mermaid\nsequenceDiagram\n participant U as 用户\n participant API as API Handler\n participant S as SearchService\n participant SP as searchPlugins函数\n participant C as 二级缓存系统\n participant PM as PluginManager\n participant P as AsyncPlugin\n participant WP as WorkerPool\n participant BWM as BatchWriteManager\n participant EXT as 外部API\n\n %% 请求处理阶段\n U->>API: 🔍 搜索请求 (kw=关键词)\n API->>API: 参数解析与验证\n API->>API: 参数预处理规范化\n API->>S: Search(req.Keyword, ...)\n \n %% 并行搜索启动\n Note over S: 🚀 并行启动TG和插件搜索\n S->>SP: searchPlugins(keyword, plugins, ...)\n \n %% 缓存检查阶段\n SP->>SP: 生成插件缓存键\n SP->>SP: 检查forceRefresh标志\n \n alt forceRefresh = false\n SP->>C: 🔍 Get(cacheKey)\n alt 缓存命中\n C-->>SP: ✅ 返回缓存数据\n SP->>SP: 反序列化结果\n SP-->>S: 🎯 返回缓存结果 (<10ms)\n S-->>U: ⚡ 极速响应\n else 缓存未命中\n Note over SP: 🚨 执行异步插件搜索\n SP->>PM: 获取可用插件列表\n SP->>PM: 过滤指定插件\n end\n else forceRefresh = true\n Note over SP: 🔄 跳过缓存，强制搜索\n SP->>PM: 获取可用插件列表\n SP->>PM: 过滤指定插件\n end\n \n %% 异步搜索初始化\n PM->>P: 🎯 设置关键词和缓存键\n P->>P: SetMainCacheKey(cacheKey)\n P->>P: SetCurrentKeyword(keyword)\n P->>P: 注入缓存更新函数\n \n %% 🚀 异步插件的精髓：双级超时并行机制\n Note over P,EXT: 🔥 异步插件精髓：快速响应 + 持续处理\n \n P->>WP: 🚀 提交异步任务到工作池\n \n %% 快速响应路径 (4秒)\n par 🚀 快速响应路径 (4秒)\n Note over WP,EXT: ⚡ 第一阶段：快速响应用户\n WP->>EXT: HTTP请求 (短超时 4秒)\n EXT-->>WP: 部分响应数据\n WP->>P: 🔍 解析部分结果\n P->>P: 快速过滤和标准化\n P->>P: 📝 记录日志: 初始缓存创建\n \n %% 部分结果立即缓存和返回\n P->>BWM: 🗄️ 异步缓存更新 (isFinal=false)\n Note over BWM: 部分结果缓存，不等待写入完成\n P-->>SP: 📤 部分结果立即返回\n SP-->>S: 🎯 部分结果 (isFinal=false)\n S->>S: 与TG结果合并\n S-->>U: ⚡ 快速响应 (~4秒)\n \n and 🔄 持续处理路径 (最长30秒)\n Note over WP,EXT: 🔄 第二阶段：后台持续完善\n WP->>EXT: 继续HTTP请求 (长超时 30秒)\n EXT-->>WP: 完整响应数据\n WP->>P: 🔍 解析完整结果\n P->>P: 深度过滤和去重\n P->>P: 结果质量评估\n P->>P: 📝 记录日志: 缓存更新完成\n \n %% 完整结果的主缓存更新\n P->>BWM: 🗄️ 主缓存更新 (isFinal=true)\n Note over BWM: 完整结果写入，高优先级\n BWM->>BWM: 🧠 智能缓存写入策略\n BWM->>BWM: 🗂️ 全局缓冲区管理\n BWM->>C: 📀 批量写入磁盘缓存\n \n Note over C: 🎯 下次同样请求将获得完整结果\n end\n \n %% 缓存系统内部处理\n C->>C: ⚡ 立即更新内存缓存\n C->>C: 📀 延迟批量更新磁盘缓存\n C->>C: 🧹 自动清理过期缓存\n \n %% 持续优化标注\n Note over U,EXT: 💡 异步插件核心价值\n Note over U,EXT: ✅ 用户获得快速响应 (4秒内)\n Note over U,EXT: ✅ 系统持续完善结果 (30秒内) \n Note over U,EXT: ✅ 下次访问获得完整数据 (<100ms)\n Note over U,EXT: 🔄 完美平衡：速度 vs 完整性\n```\n\n### 2.3 核心组件\n\n#### 2.3.1 HTTP服务层 (`api/`)\n- **router.go**: 路由配置\n- **handler.go**: 请求处理逻辑\n- **middleware.go**: 中间件（日志、CORS等）\n\n#### 2.3.2 搜索服务层 (`service/`)\n- **search_service.go**: 核心搜索逻辑，结果合并\n\n#### 2.3.3 插件系统层 (`plugin/`)\n- **plugin.go**: 插件接口定义\n- **baseasyncplugin.go**: 异步插件基类\n- **各插件目录**: jikepan、pan666、hunhepan等\n\n#### 2.3.4 工具层 (`util/`)\n- **cache/**: 二级缓存系统实现\n- **pool/**: 工作池实现\n- **其他工具**: HTTP客户端、解析工具等\n\n---\n\n## 3. 异步插件系统\n\n### 3.1 设计理念\n\n异步插件系统解决传统同步搜索响应慢的问题，采用\"尽快响应，持续处理\"策略：\n- **4秒短超时**: 快速返回部分结果（`isFinal=false`）\n- **30秒长超时**: 后台继续处理，获得完整结果（`isFinal=true`）\n- **主动缓存更新**: 完整结果自动更新主缓存，下次访问更快\n\n### 3.2 插件接口实现\n\n基于`plugin/plugin.go`的实际接口：\n\n```go\ntype AsyncSearchPlugin interface {\n Name() string\n Priority() int\n \n AsyncSearch(keyword string, searchFunc func(*http.Client, string, map[string]interface{}) ([]model.SearchResult, error), \n mainCacheKey string, ext map[string]interface{}) ([]model.SearchResult, error)\n \n SetMainCacheKey(key string)\n SetCurrentKeyword(keyword string)\n Search(keyword string, ext map[string]interface{}) ([]model.SearchResult, error)\n}\n```\n\n### 3.3 基础插件类\n\n`plugin/baseasyncplugin.go`提供通用功能：\n\n```go\ntype BaseAsyncPlugin struct {\n name string\n priority int\n cacheTTL time.Duration\n mainCacheKey string\n currentKeyword string // 用于日志显示\n httpClient *http.Client\n mainCacheUpdater func(string, []model.SearchResult, time.Duration, bool, string) error\n}\n```\n\n### 3.4 已实现插件列表\n\n当前系统包含以下插件（基于`main.go`的导入）：\n- **hdr4k**\n- **hunhepan**\n- **jikepan**\n- **pan666**\n- **pansearch**\n- **panta**\n- **qupansou**\n- **susu**\n- **panyq**\n- **xuexizhinan**\n\n### 3.5 插件注册机制\n\n```go\n// 全局插件注册表（plugin/plugin.go）\nvar globalRegistry = make(map[string]AsyncSearchPlugin)\n\n// 插件通过init()函数自动注册\nfunc init() {\n p := &MyPlugin{\n BaseAsyncPlugin: plugin.NewBaseAsyncPlugin(\"myplugin\", 3),\n }\n plugin.RegisterGlobalPlugin(p)\n}\n```\n\n---\n\n## 4. 二级缓存系统\n\n### 4.1 实现架构\n\n基于`util/cache/`目录的实际实现：\n\n- **enhanced_two_level_cache.go**: 二级缓存主入口\n- **sharded_memory_cache.go**: 分片内存缓存（LRU+原子操作）\n- **sharded_disk_cache.go**: 分片磁盘缓存\n- **serializer.go**: GOB序列化器\n- **cache_key.go**: 缓存键生成和管理\n\n### 4.2 分片缓存设计\n\n#### 4.2.1 内存缓存分片\n```go\n// 基于CPU核心数的动态分片\ntype ShardedMemoryCache struct {\n shards []*MemoryCacheShard\n shardMask uint32\n}\n\n// 每个分片独立锁，减少竞争\ntype MemoryCacheShard struct {\n data map[string]*CacheItem\n lock sync.RWMutex\n}\n```\n\n#### 4.2.2 磁盘缓存分片\n```go\n// 磁盘缓存同样采用分片设计\ntype ShardedDiskCache struct {\n shards []*DiskCacheShard \n shardMask uint32\n basePath string\n}\n```\n\n### 4.3 缓存读写策略\n\n#### 4.3.1 读取流程\n1. **内存优先**: 先检查分片内存缓存\n2. **磁盘回源**: 内存未命中时读取磁盘缓存\n3. **异步加载**: 磁盘命中后异步加载到内存\n\n#### 4.3.2 写入流程 \n1. **智能写入策略**: 立即更新内存缓存，延迟批量写入磁盘\n2. **DelayedBatchWriteManager**: 智能缓存写入管理器，支持immediate和hybrid两种策略\n3. **原子操作**: 内存缓存使用原子操作\n4. **GOB序列化**: 磁盘存储使用GOB格式\n5. **数据安全保障**: 程序终止时自动保存所有待写入数据，防止数据丢失\n\n### 4.4 缓存键策略\n\n`cache_key.go`实现了智能缓存键生成：\n\n```go\n// TG搜索和插件搜索使用不同的缓存键前缀\nfunc GenerateTGCacheKey(keyword string, channels []string) string\nfunc GeneratePluginCacheKey(keyword string, plugins []string) string\n```\n\n**优势**:\n- 独立更新：TG和插件缓存互不影响\n- 提高命中率：精确的键匹配\n- 并发安全：分片设计减少锁竞争\n\n### 4.5 序列化性能\n\n使用GOB序列化（`serializer.go`）的实际优势：\n- **性能**: 比JSON序列化快约30%\n- **体积**: 比JSON小约20%\n- **兼容**: Go原生支持，无外部依赖\n\n---\n\n## 5. 核心组件实现\n\n### 5.1 工作池系统 (`util/pool/`)\n\n#### 5.1.1 worker_pool.go 实现\n- **批量任务处理**: `ExecuteBatchWithTimeout`方法\n- **超时控制**: 支持任务级别的超时设置\n- **并发限制**: 控制最大工作者数量\n\n#### 5.1.2 object_pool.go 实现 \n- **对象复用**: 减少内存分配和GC压力\n- **线程安全**: 支持并发访问\n\n### 5.2 HTTP服务配置\n\n#### 5.2.1 服务器优化（基于config/config.go）\n```go\n// 自动计算HTTP连接数，防止资源耗尽\nfunc getHTTPMaxConns() int {\n cpuCount := runtime.NumCPU()\n maxConns := cpuCount * 25 // 保守配置\n \n if maxConns < 100 {\n maxConns = 100\n }\n if maxConns > 500 {\n maxConns = 500 // 限制最大值\n }\n \n return maxConns\n}\n```\n\n#### 5.2.2 连接池配置（基于util/http_util.go）\n```go\n// HTTP客户端优化配置\ntransport := &http.Transport{\n MaxIdleConns: 100,\n MaxIdleConnsPerHost: 10,\n IdleConnTimeout: 90 * time.Second,\n}\n```\n\n### 5.3 结果处理系统\n\n#### 5.3.1 智能排序算法（service/search_service.go）\n\nPanSou 采用多维度综合评分排序算法，确保高质量结果优先展示：\n\n**评分公式**:\n```\n总得分 = 插件得分(1000/500/0/-200) + 时间得分(最高500) + 关键词得分(最高420)\n```\n\n**权重分配**:\n- 🥇 **插件等级**: ~52% (主导因素) - 等级1(1000分) > 等级2(500分) > 等级3(0分)\n- 🥈 **关键词匹配**: ~22% (重要因素) - \"合集\"(420分) > \"系列\"(350分) > \"全\"(280分)\n- 🥉 **时间新鲜度**: ~26% (重要因素) - 1天内(500分) > 3天内(400分) > 1周内(300分)\n\n**关键优化**:\n- **缓存性能**: 跳过空结果和重复数据的缓存更新，减少70%无效操作\n- **排序稳定性**: 修复map遍历随机性问题，确保merged_by_type保持排序\n- **插件管理**: 启动时按优先级排序显示已加载插件，便于监控\n\n#### 5.3.2 结果合并（mergeSearchResults函数）\n- **去重合并**: 基于UniqueID去重\n- **完整性选择**: 选择更完整的结果保留\n- **增量更新**: 新结果与缓存结果智能合并\n\n### 5.4 网盘类型识别\n\n支持自动识别的网盘类型（共12种）：\n- 百度网盘、阿里云盘、夸克网盘、天翼云盘\n- UC网盘、移动云盘、115网盘、PikPak\n- 迅雷网盘、123网盘、磁力链接、电驴链接\n\n---\n\n## 6. 智能排序算法详解\n\n### 6.1 算法概述\n\nPanSou 搜索引擎采用多维度综合评分排序算法，确保用户能够优先看到最相关、最新、最高质量的搜索结果。\n\n#### 6.1.1 核心设计理念\n\n1. **质量优先**：高等级插件的结果优先展示\n2. **时效性重要**：新发布的资源获得更高权重\n3. **相关性保证**：关键词匹配度影响排序\n4. **用户体验**：最终排序结果保持稳定性\n\n#### 6.1.2 排序流程\n\n```mermaid\ngraph TD\n A[搜索请求] --> B[获取搜索结果 allResults]\n B --> C[sortResultsByTimeAndKeywords]\n \n C --> D[为每个结果计算得分]\n D --> E[时间得分
最高500分]\n D --> F[关键词得分
最高420分]\n D --> G[插件得分
等级1=1000分
等级2=500分
等级3=0分]\n \n E --> H[总得分 = 时间得分 + 关键词得分 + 插件得分]\n F --> H\n G --> H\n \n H --> I[按总得分降序排序]\n I --> J[mergeResultsByType]\n \n J --> K[按原始顺序收集唯一链接
保持排序不被破坏]\n K --> L[按类型分组
生成merged_by_type]\n \n L --> M[返回最终结果]\n```\n\n### 6.2 评分算法详解\n\n#### 6.2.1 核心公式\n```\n总得分 = 时间得分 + 关键词得分 + 插件得分\n```\n\n#### 6.2.2 时间得分 (Time Score)\n\n时间得分反映资源的新鲜度，**最高 500 分**：\n\n| 时间范围 | 得分 | 说明 |\n|---------|------|------|\n| ≤ 1天 | 500 | 最新资源，最高优先级 |\n| ≤ 3天 | 400 | 非常新的资源 |\n| ≤ 1周 | 300 | 较新资源 |\n| ≤ 1月 | 200 | 相对较新 |\n| ≤ 3月 | 100 | 中等新鲜度 |\n| ≤ 1年 | 50 | 较旧资源 |\n| > 1年 | 20 | 旧资源 |\n| 无日期 | 0 | 未知时间 |\n\n#### 6.2.3 关键词得分 (Keyword Score)\n\n关键词得分基于搜索词在标题中的匹配情况，**最高 420 分**：\n\n| 优先关键词 | 得分 | 说明 |\n|-----------|------|------|\n| \"合集\" | 420 | 最高优先级 |\n| \"系列\" | 350 | 高优先级 |\n| \"全\" | 280 | 中高优先级 |\n| \"完\" | 210 | 中等优先级 |\n| \"最新\" | 140 | 较低优先级 |\n| \"附\" | 70 | 低优先级 |\n| 无匹配 | 0 | 无加分 |\n\n#### 6.2.4 插件得分 (Plugin Score)\n\n插件得分基于数据源的质量等级，体现资源可靠性：\n\n| 插件等级 | 得分 | 说明 |\n|---------|------|------|\n| 等级1 | 1000 | 顶级数据源 |\n| 等级2 | 500 | 优质数据源 |\n| 等级3 | 0 | 普通数据源 |\n| 等级4 | -200 | 低质量数据源 |\n\n### 6.3 权重分析与实际效果\n\n#### 6.3.1 权重分配\n\n| 维度 | 最高分值 | 权重占比 | 影响说明 |\n|------|---------|---------|----------|\n| 插件等级 | 1000 | ~52% | **主导因素**，决定基础排序 |\n| 关键词匹配 | 420 | ~22% | **重要因素**，优先关键词显著加分 |\n| 时间新鲜度 | 500 | ~26% | **重要因素**，同等级内排序关键 |\n\n#### 6.3.2 实际排序示例\n\n| 场景 | 插件等级 | 时间 | 关键词 | 总分 | 排序 |\n|------|---------|------|--------|------|------|\n| 等级1 + 1天内 + \"合集\" | 1000 | 500 | 420 | **1920** | 🥇 第1 |\n| 等级1 + 1天内 + \"系列\" | 1000 | 500 | 350 | **1850** | 🥈 第2 |\n| 等级1 + 1月内 + \"合集\" | 1000 | 200 | 420 | **1620** | 🥉 第3 |\n| 等级2 + 1天内 + \"合集\" | 500 | 500 | 420 | **1420** | 第4 |\n| 等级1 + 1天内 + 无关键词 | 1000 | 500 | 0 | **1500** | 第5 |\n\n---\n\n## 7. API接口设计\n\n### 7.1 核心接口实现（基于api/handler.go）\n\n#### 7.1.1 搜索接口\n```\nPOST /api/search\nGET /api/search\n```\n\n**核心参数**:\n- `kw`: 搜索关键词（必填）\n- `channels`: TG频道列表\n- `plugins`: 插件列表 \n- `cloud_types`: 网盘类型过滤\n- `ext`: 扩展参数（JSON格式）\n- `refresh`: 强制刷新缓存\n- `res`: 返回格式（merge/all/results）\n- `src`: 数据源（all/tg/plugin）\n\n#### 7.1.2 健康检查接口\n```\nGET /api/health\n```\n\n返回系统状态和已注册插件信息。\n\n### 6.2 中间件系统（api/middleware.go）\n\n- **日志中间件**: 记录请求响应，支持URL解码显示\n- **CORS中间件**: 跨域请求支持\n- **错误处理**: 统一错误响应格式\n\n### 6.3 扩展参数系统\n\n通过`ext`参数支持插件特定选项：\n```json\n{\n \"title_en\": \"English Title\",\n \"is_all\": true,\n \"year\": 2023\n}\n```\n\n---\n\n## 8. 认证系统设计\n\n### 8.1 系统概述\n\nPanSou认证系统是一个可选的安全访问控制模块，基于JWT（JSON Web Token）标准实现。该系统设计目标是在不影响现有用户的前提下，为需要私有部署的用户提供灵活的认证功能。\n\n#### 8.1.1 核心特性\n\n- **可选性**: 默认关闭，通过环境变量`AUTH_ENABLED`启用\n- **无状态**: 基于JWT，无需session存储\n- **标准化**: 采用RFC 7519 JWT标准\n- **灵活性**: 支持多用户配置\n- **安全性**: Token自动过期，防止长期有效性风险\n\n### 8.2 认证架构\n\n#### 8.2.1 认证流程\n\n```mermaid\nsequenceDiagram\n participant U as 用户\n participant F as 前端\n participant M as 认证中间件\n participant A as 认证接口\n participant S as 搜索服务\n \n Note over U,S: 初始访问阶段\n U->>F: 访问应用\n F->>F: 检查localStorage中的token\n alt token不存在或无效\n F->>U: 显示登录窗口\n U->>F: 输入账号密码\n F->>A: POST /api/auth/login\n A->>A: 验证账号密码\n A->>A: 生成JWT Token\n A-->>F: 返回Token\n F->>F: 存储Token到localStorage\n F->>U: 关闭登录窗口\n end\n \n Note over U,S: API调用阶段\n U->>F: 发起搜索请求\n F->>F: axios拦截器添加Authorization头\n F->>M: GET/POST /api/search + Token\n M->>M: 验证Token有效性\n alt Token有效\n M->>S: 转发请求\n S-->>M: 返回搜索结果\n M-->>F: 返回响应\n F-->>U: 显示结果\n else Token无效/过期\n M-->>F: 返回401 Unauthorized\n F->>F: 响应拦截器捕获401\n F->>U: 显示登录窗口\n end\n```\n\n#### 8.2.2 组件架构\n\n```\n┌─────────────────────────────────────────────────────────────┐\n│ 前端层 (Vue 3) │\n├─────────────────────────────────────────────────────────────┤\n│ ┌─────────────┐ ┌──────────────┐ ┌──────────────────┐ │\n│ │ LoginDialog │ │ HTTP拦截器 │ │ Token管理工具 │ │\n│ │ 登录组件 │ │ 自动添加Token │ │ LocalStorage │ │\n│ └─────────────┘ └──────────────┘ └──────────────────┘ │\n└─────────────────────────────────────────────────────────────┘\n ↕ HTTP (Authorization: Bearer)\n┌─────────────────────────────────────────────────────────────┐\n│ 后端层 (Go + Gin) │\n├─────────────────────────────────────────────────────────────┤\n│ ┌──────────────────────────────────────────────────────┐ │\n│ │ AuthMiddleware 认证中间件 │ │\n│ │ • 检查AUTH_ENABLED配置 │ │\n│ │ • 排除公开接口（/api/auth/login, /api/health） │ │\n│ │ • 验证JWT Token有效性 │ │\n│ │ • 提取用户信息到Context │ │\n│ └──────────────────────────────────────────────────────┘ │\n│ ↓ │\n│ ┌─────────────┐ ┌─────────────┐ ┌──────────────────┐ │\n│ │ 认证接口 │ │ JWT工具 │ │ 配置管理 │ │\n│ │ /auth/login │ │ util/jwt.go │ │ config/config.go │ │\n│ │ /auth/verify│ │ GenerateToken│ │ AuthEnabled │ │\n│ │ /auth/logout│ │ ValidateToken│ │ AuthUsers │ │\n│ └─────────────┘ └─────────────┘ └──────────────────┘ │\n└─────────────────────────────────────────────────────────────┘\n```\n\n### 8.3 后端实现细节\n\n#### 8.3.1 配置模块 (config/config.go)\n\n```go\ntype Config struct {\n // ... 现有配置 ...\n \n // 认证相关配置\n AuthEnabled bool // 是否启用认证\n AuthUsers map[string]string // 用户名:密码哈希映射\n AuthTokenExpiry time.Duration // Token有效期\n AuthJWTSecret string // JWT签名密钥\n}\n\n// 从环境变量读取认证配置\nfunc getAuthEnabled() bool {\n enabled := os.Getenv(\"AUTH_ENABLED\")\n return enabled == \"true\" || enabled == \"1\"\n}\n\nfunc getAuthUsers() map[string]string {\n usersEnv := os.Getenv(\"AUTH_USERS\")\n if usersEnv == \"\" {\n return nil\n }\n \n users := make(map[string]string)\n pairs := strings.Split(usersEnv, \",\")\n for _, pair := range pairs {\n parts := strings.SplitN(pair, \":\", 2)\n if len(parts) == 2 {\n username := strings.TrimSpace(parts[0])\n password := strings.TrimSpace(parts[1])\n // 实际使用时应该对密码进行哈希处理\n users[username] = password\n }\n }\n return users\n}\n```\n\n#### 8.3.2 JWT工具模块 (util/jwt.go)\n\n```go\npackage util\n\nimport (\n \"errors\"\n \"github.com/golang-jwt/jwt/v5\"\n \"time\"\n)\n\n// Claims JWT载荷结构\ntype Claims struct {\n Username string `json:\"username\"`\n jwt.RegisteredClaims\n}\n\n// GenerateToken 生成JWT token\nfunc GenerateToken(username string, secret string, expiry time.Duration) (string, error) {\n expirationTime := time.Now().Add(expiry)\n claims := &Claims{\n Username: username,\n RegisteredClaims: jwt.RegisteredClaims{\n ExpiresAt: jwt.NewNumericDate(expirationTime),\n IssuedAt: jwt.NewNumericDate(time.Now()),\n Issuer: \"pansou\",\n },\n }\n \n token := jwt.NewWithClaims(jwt.SigningMethodHS256, claims)\n return token.SignedString([]byte(secret))\n}\n\n// ValidateToken 验证JWT token\nfunc ValidateToken(tokenString string, secret string) (*Claims, error) {\n claims := &Claims{}\n \n token, err := jwt.ParseWithClaims(tokenString, claims, func(token *jwt.Token) (interface{}, error) {\n return []byte(secret), nil\n })\n \n if err != nil {\n return nil, err\n }\n \n if !token.Valid {\n return nil, errors.New(\"invalid token\")\n }\n \n return claims, nil\n}\n```\n\n#### 8.3.3 认证中间件 (api/middleware.go)\n\n```go\n// AuthMiddleware JWT认证中间件\nfunc AuthMiddleware() gin.HandlerFunc {\n return func(c *gin.Context) {\n // 如果未启用认证，直接放行\n if !config.AppConfig.AuthEnabled {\n c.Next()\n return\n }\n \n // 定义公开接口（不需要认证）\n publicPaths := []string{\n \"/api/auth/login\",\n \"/api/auth/verify\",\n \"/api/auth/logout\",\n \"/api/health\", // 可选：健康检查是否需要认证\n }\n \n // 检查当前路径是否是公开接口\n path := c.Request.URL.Path\n for _, p := range publicPaths {\n if strings.HasPrefix(path, p) {\n c.Next()\n return\n }\n }\n \n // 获取Authorization头\n authHeader := c.GetHeader(\"Authorization\")\n if authHeader == \"\" {\n c.JSON(401, gin.H{\n \"error\": \"未授权：缺少认证令牌\",\n \"code\": \"AUTH_TOKEN_MISSING\",\n })\n c.Abort()\n return\n }\n \n // 解析Bearer token\n const bearerPrefix = \"Bearer \"\n if !strings.HasPrefix(authHeader, bearerPrefix) {\n c.JSON(401, gin.H{\n \"error\": \"未授权：令牌格式错误\",\n \"code\": \"AUTH_TOKEN_INVALID_FORMAT\",\n })\n c.Abort()\n return\n }\n \n tokenString := strings.TrimPrefix(authHeader, bearerPrefix)\n \n // 验证token\n claims, err := util.ValidateToken(tokenString, config.AppConfig.AuthJWTSecret)\n if err != nil {\n c.JSON(401, gin.H{\n \"error\": \"未授权：令牌无效或已过期\",\n \"code\": \"AUTH_TOKEN_INVALID\",\n })\n c.Abort()\n return\n }\n \n // 将用户信息存入上下文，供后续处理使用\n c.Set(\"username\", claims.Username)\n c.Next()\n }\n}\n```\n\n#### 8.3.4 认证接口 (api/auth_handler.go)\n\n```go\npackage api\n\nimport (\n \"github.com/gin-gonic/gin\"\n \"pansou/config\"\n \"pansou/util\"\n \"time\"\n)\n\n// LoginRequest 登录请求结构\ntype LoginRequest struct {\n Username string `json:\"username\" binding:\"required\"`\n Password string `json:\"password\" binding:\"required\"`\n}\n\n// LoginResponse 登录响应结构\ntype LoginResponse struct {\n Token string `json:\"token\"`\n ExpiresAt int64 `json:\"expires_at\"`\n Username string `json:\"username\"`\n}\n\n// LoginHandler 处理用户登录\nfunc LoginHandler(c *gin.Context) {\n var req LoginRequest\n if err := c.ShouldBindJSON(&req); err != nil {\n c.JSON(400, gin.H{\"error\": \"参数错误\"})\n return\n }\n \n // 验证用户名和密码\n if config.AppConfig.AuthUsers == nil {\n c.JSON(500, gin.H{\"error\": \"认证系统未正确配置\"})\n return\n }\n \n storedPassword, exists := config.AppConfig.AuthUsers[req.Username]\n if !exists || storedPassword != req.Password {\n c.JSON(401, gin.H{\"error\": \"用户名或密码错误\"})\n return\n }\n \n // 生成JWT token\n token, err := util.GenerateToken(\n req.Username,\n config.AppConfig.AuthJWTSecret,\n config.AppConfig.AuthTokenExpiry,\n )\n if err != nil {\n c.JSON(500, gin.H{\"error\": \"生成令牌失败\"})\n return\n }\n \n // 返回token和过期时间\n expiresAt := time.Now().Add(config.AppConfig.AuthTokenExpiry).Unix()\n c.JSON(200, LoginResponse{\n Token: token,\n ExpiresAt: expiresAt,\n Username: req.Username,\n })\n}\n\n// VerifyHandler 验证token有效性\nfunc VerifyHandler(c *gin.Context) {\n // 如果能到达这里，说明中间件已经验证通过\n username, exists := c.Get(\"username\")\n if !exists {\n c.JSON(401, gin.H{\"error\": \"未授权\"})\n return\n }\n \n c.JSON(200, gin.H{\n \"valid\": true,\n \"username\": username,\n })\n}\n\n// LogoutHandler 退出登录（客户端删除token即可）\nfunc LogoutHandler(c *gin.Context) {\n c.JSON(200, gin.H{\"message\": \"退出成功\"})\n}\n```\n\n### 8.4 前端实现细节\n\n#### 8.4.1 API模块扩展 (src/api/index.ts)\n\n```typescript\n// 登录接口\nexport interface LoginParams {\n username: string;\n password: string;\n}\n\nexport interface LoginResponse {\n token: string;\n expires_at: number;\n username: string;\n}\n\nexport const login = async (params: LoginParams): Promise
\n \n AI小红书虚拟电商全链路实战课：从选品到变现的AI爆款打法\n \n
\n\n提取要素:\n- 标题: a 的文本内容或 title 属性\n- 详情页链接: a 的 href 属性\n```\n\n#### 分类标签 (.entry-cat-dot)\n```html\n\n\n提取要素:\n- 分类: 所有 a 标签的文本内容\n```\n\n#### 描述区域 (.entry-desc)\n```html\n\n AI小红书虚拟电商全链路实战课程概览 《AI小红书虚拟电商5.0实战课》是一门聚焦AI与小红书生态融合的系统课程，围绕AI赋能选品、创作、运营与变现四大环节展开...\n
\n\n提取要素:\n- 描述: div 的文本内容\n```\n\n#### 元数据栏 (.entry-meta)\n```html\n\n\n提取要素:\n- 发布时间: time 标签的 datetime 属性或文本内容\n```\n\n## 详情页面结构\n\n### 1. 详情页URL模式\n```\nhttps://www.ahhhhfs.com/{文章ID}/\n\n示例:\nhttps://www.ahhhhfs.com/76567/\n```\n\n### 2. 下载链接位置\n下载链接在文章正文内容中 `.post-content` 里面，通常在文章末尾部分。\n\n#### 下载链接格式示例\n```html\n\n 学习地址：\n 夸克\n
\n\n或者\n\n\n 下载地址：\n 百度网盘\n 提取码: xxxx\n
\n\n或者多个网盘链接：\n\n 阿里云盘：链接
\n 夸克网盘：链接
\n 百度网盘：链接 提取码: xxxx\n
` 标签分隔的下一行\n- 括号内: `(提取码: xxxx)`\n\n常见关键词：\n- 提取码\n- 密码\n- pwd\n- code\n- 取码\n\n### 3. 链接提取策略\n1. 先从搜索结果页获取文章列表\n2. 访问每篇文章的详情页\n3. 在详情页的 `.post-content` 中查找包含网盘域名的链接\n4. 提取链接和相应的提取码\n5. 如果文章没有网盘链接，则跳过\n\n### 4. 时间格式处理\n- 相对时间: \"1 周前\"、\"2 天前\" 需要转换为具体日期\n- 绝对时间: \"2025-10-18\" 可以直接使用\n- datetime 属性: \"2025-10-18T13:43:10+08:00\" 标准ISO格式\n\n### 5. 去重标识\n- 使用文章ID作为唯一标识: 从详情页URL中提取 `/76567/`\n\n## 注意事项\n\n1. **搜索结果可能为空**: 如果关键词没有匹配结果，页面会显示\"没有找到相关内容\"\n2. **分页**: 搜索结果可能有多页，但通常只抓取第一页即可\n3. **网盘链接位置不固定**: 链接可能在文章开头、中间或结尾，需要遍历整个 `.post-content`\n4. **广告干扰**: 页面包含广告，需要准确定位到实际内容区域\n5. **需要访问详情页**: 搜索结果页不包含下载链接，必须访问详情页才能获取\n6. **请求频率**: 需要访问详情页，建议控制请求频率避免被封\n\n## 示例数据流\n\n```\n1. 搜索请求: https://www.ahhhhfs.com/search/小红书\n ↓\n2. 解析搜索结果页，提取文章列表\n - 标题: \"AI小红书虚拟电商全链路实战课：从选品到变现的AI爆款打法\"\n - 详情页URL: https://www.ahhhhfs.com/76567/\n - 分类: [\"短视频\", \"资源\"]\n - 发布时间: 2025-10-18\n ↓\n3. 访问详情页: https://www.ahhhhfs.com/76567/\n ↓\n4. 解析详情页 .post-content，提取网盘链接\n - 夸克网盘: https://pan.quark.cn/s/c16a5ae18ea0\n - 提取码: (如果有)\n ↓\n5. 构建最终结果\n - UniqueID: ahhhhfs-76567\n - Title: \"AI小红书虚拟电商全链路实战课：从选品到变现的AI爆款打法\"\n - Content: 文章描述\n - Links: [{Type: \"quark\", URL: \"...\", Password: \"\"}]\n - Tags: [\"短视频\", \"资源\"]\n - Datetime: 2025-10-18T13:43:10+08:00\n```\n\n" }, { "path": "plugin/aikanzy/aikanzy.go", "content": "package aikanzy\n\nimport (\n\t\"context\"\n\t\"fmt\"\n\t\"net/http\"\n\t\"net/url\"\n\t\"pansou/model\"\n\t\"pansou/plugin\"\n\t\"regexp\"\n\t\"strings\"\n\t\"sync\"\n\t\"time\"\n\n\t\"github.com/PuerkitoBio/goquery\"\n)\n\n// 预编译的正则表达式\nvar (\n\t// 夸克网盘链接\n\tquarkLinkRegex = regexp.MustCompile(`https?://pan\\.quark\\.cn/s/[0-9a-zA-Z]+`)\n\t\n\t// UC网盘链接\n\tucLinkRegex = regexp.MustCompile(`https?://drive\\.uc\\.cn/s/[0-9a-zA-Z]+(\\?[^\"'\\s]*)?`)\n\t\n\t// 百度网盘链接\n\tbaiduLinkRegex = regexp.MustCompile(`https?://pan\\.baidu\\.com/s/[0-9a-zA-Z_-]+`)\n\t\n\t// 迅雷网盘链接\n\txunleiLinkRegex = regexp.MustCompile(`https?://pan\\.xunlei\\.com/s/[0-9a-zA-Z_-]+`)\n\t\n\t// 从URL中提取文章ID\n\tarticleIDRegex = regexp.MustCompile(`/([a-z]+)/(\\d+)\\.html`)\n\t\n\t// 提取阅读数\n\tviewCountRegex = regexp.MustCompile(`(\\d+)\\s*阅读`)\n)\n\n// 常量定义\nconst (\n\t// 插件名称\n\tpluginName = \"aikanzy\"\n\t\n\t// 搜索URL模板\n\tsearchURLTemplate = \"https://www.aikanzy.com/search?word=%s&molds=article\"\n\t\n\t// 默认优先级\n\tdefaultPriority = 3\n\t\n\t// 默认超时时间（秒）\n\tdefaultTimeout = 15\n\t\n\t// 详情页超时时间（秒）\n\tdetailTimeout = 8\n\t\n\t// 最大重试次数\n\tmaxRetries = 3\n\t\n\t// 详情页并发数\n\tdetailConcurrency = 15\n\t\n\t// 指数退避基数（毫秒）\n\tbackoffBase = 200\n)\n\n// AikanzyAsyncPlugin 是AikanZY网站的异步搜索插件实现\ntype AikanzyAsyncPlugin struct {\n\t*plugin.BaseAsyncPlugin\n\toptimizedClient *http.Client\n}\n\n// 确保AikanzyAsyncPlugin实现了AsyncSearchPlugin接口\nvar _ plugin.AsyncSearchPlugin = (*AikanzyAsyncPlugin)(nil)\n\n// 在包初始化时注册插件\nfunc init() {\n\tplugin.RegisterGlobalPlugin(NewAikanzyAsyncPlugin())\n}\n\n// createOptimizedHTTPClient 创建优化的HTTP客户端\nfunc createOptimizedHTTPClient() *http.Client {\n\ttransport := &http.Transport{\n\t\tMaxIdleConns: 100,\n\t\tMaxIdleConnsPerHost: 20,\n\t\tIdleConnTimeout: 90 * time.Second,\n\t\tDisableKeepAlives: false,\n\t}\n\n\treturn &http.Client{\n\t\tTransport: transport,\n\t\tTimeout: defaultTimeout * time.Second,\n\t}\n}\n\n// NewAikanzyAsyncPlugin 创建一个新的AikanZY异步插件实例\nfunc NewAikanzyAsyncPlugin() *AikanzyAsyncPlugin {\n\treturn &AikanzyAsyncPlugin{\n\t\tBaseAsyncPlugin: plugin.NewBaseAsyncPlugin(\"aikanzy\", defaultPriority),\n\t\toptimizedClient: createOptimizedHTTPClient(),\n\t}\n}\n\n// Name 返回插件名称\nfunc (p *AikanzyAsyncPlugin) Name() string {\n\treturn pluginName\n}\n\n// Priority 返回插件优先级\nfunc (p *AikanzyAsyncPlugin) Priority() int {\n\treturn defaultPriority\n}\n\n// Search 执行搜索并返回结果（兼容性方法）\nfunc (p *AikanzyAsyncPlugin) Search(keyword string, ext map[string]interface{}) ([]model.SearchResult, error) {\n\tresult, err := p.SearchWithResult(keyword, ext)\n\tif err != nil {\n\t\treturn nil, err\n\t}\n\treturn result.Results, nil\n}\n\n// SearchWithResult 执行搜索并返回包含IsFinal标记的结果\nfunc (p *AikanzyAsyncPlugin) SearchWithResult(keyword string, ext map[string]interface{}) (model.PluginSearchResult, error) {\n\treturn p.AsyncSearchWithResult(keyword, p.doSearch, p.MainCacheKey, ext)\n}\n\n// doSearch 执行具体的搜索逻辑\nfunc (p *AikanzyAsyncPlugin) doSearch(client *http.Client, keyword string, ext map[string]interface{}) ([]model.SearchResult, error) {\n\t// 使用优化的客户端\n\tif p.optimizedClient != nil {\n\t\tclient = p.optimizedClient\n\t}\n\t\n\t// 对关键词进行URL编码\n\tencodedKeyword := url.QueryEscape(keyword)\n\t\n\t// 构建搜索URL\n\tsearchURL := fmt.Sprintf(searchURLTemplate, encodedKeyword)\n\t\n\t// 创建一个带有超时的上下文\n\tctx, cancel := context.WithTimeout(context.Background(), defaultTimeout*time.Second)\n\tdefer cancel()\n\t\n\t// 创建请求\n\treq, err := http.NewRequestWithContext(ctx, \"GET\", searchURL, nil)\n\tif err != nil {\n\t\treturn nil, fmt.Errorf(\"[%s] 创建请求失败: %w\", p.Name(), err)\n\t}\n\t\n\t// 设置完整的请求头（避免反爬虫）\n\treq.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\")\n\treq.Header.Set(\"Accept\", \"text/html,application/xhtml+xml,application/xml;q=0.9,image/webp,*/*;q=0.8\")\n\treq.Header.Set(\"Accept-Language\", \"zh-CN,zh;q=0.9,en;q=0.8\")\n\treq.Header.Set(\"Connection\", \"keep-alive\")\n\treq.Header.Set(\"Referer\", \"https://www.aikanzy.com/\")\n\treq.Header.Set(\"Upgrade-Insecure-Requests\", \"1\")\n\treq.Header.Set(\"Cache-Control\", \"max-age=0\")\n\t\n\t// 使用带重试的请求方法发送HTTP请求\n\tresp, err := p.doRequestWithRetry(req, client)\n\tif err != nil {\n\t\treturn nil, fmt.Errorf(\"[%s] 请求搜索页面失败: %w\", p.Name(), err)\n\t}\n\tdefer resp.Body.Close()\n\t\n\t// 检查状态码\n\tif resp.StatusCode != http.StatusOK {\n\t\treturn nil, fmt.Errorf(\"[%s] 请求搜索页面失败，状态码: %d\", p.Name(), resp.StatusCode)\n\t}\n\t\n\t// 使用goquery解析HTML\n\tdoc, err := goquery.NewDocumentFromReader(resp.Body)\n\tif err != nil {\n\t\treturn nil, fmt.Errorf(\"[%s] 解析HTML失败: %w\", p.Name(), err)\n\t}\n\t\n\t// 解析搜索结果列表\n\tarticleItems := p.parseArticleList(doc)\n\tif len(articleItems) == 0 {\n\t\treturn []model.SearchResult{}, nil\n\t}\n\t\n\t// 并发抓取详情页获取网盘链接\n\tresults := p.fetchDetailsWithLinks(articleItems, client, keyword)\n\t\n\t// 使用过滤功能过滤结果\n\tfilteredResults := plugin.FilterResultsByKeyword(results, keyword)\n\t\n\treturn filteredResults, nil\n}\n\n// ArticleItem 文章基本信息\ntype ArticleItem struct {\n\tID string\n\tTitle string\n\tDetailURL string\n\tCategory string\n\tPublishDate string\n\tViewCount int\n\tSummary string\n\tImageURL string\n}\n\n// parseArticleList 解析文章列表\nfunc (p *AikanzyAsyncPlugin) parseArticleList(doc *goquery.Document) []ArticleItem {\n\tvar items []ArticleItem\n\t\n\t// 查找所有文章项\n\tdoc.Find(\"article.post-list.contt.blockimg\").Each(func(i int, s *goquery.Selection) {\n\t\t// 提取详情页链接\n\t\tdetailLink := s.Find(\"a[href]\").First()\n\t\tdetailURL, exists := detailLink.Attr(\"href\")\n\t\tif !exists || detailURL == \"\" {\n\t\t\treturn\n\t\t}\n\t\t\n\t\t// 提取文章ID\n\t\tarticleID := p.extractArticleID(detailURL)\n\t\tif articleID == \"\" {\n\t\t\treturn\n\t\t}\n\t\t\n\t\t// 提取标题\n\t\ttitle := strings.TrimSpace(s.Find(\"header.entry-header span.entry-title a\").Text())\n\t\t// 移除标题中的HTML标签（如）\n\t\ttitle = p.cleanHTMLTags(title)\n\t\tif title == \"\" {\n\t\t\treturn\n\t\t}\n\t\t\n\t\t// 提取分类\n\t\tcategory := strings.TrimSpace(s.Find(\"div.entry-meta > a\").First().Text())\n\t\t\n\t\t// 提取发布日期\n\t\tpublishDate := strings.TrimSpace(s.Find(\"time\").First().Text())\n\t\t\n\t\t// 提取阅读数\n\t\tmetaText := s.Find(\"div.entry-meta\").Text()\n\t\tviewCount := p.extractViewCount(metaText)\n\t\t\n\t\t// 提取摘要\n\t\tsummary := strings.TrimSpace(s.Find(\"div.entry-summary.ss p\").Text())\n\t\tsummary = p.cleanHTMLTags(summary)\n\t\t\n\t\t// 提取缩略图\n\t\timageURL, _ := s.Find(\"img.block-fea\").Attr(\"data-src\")\n\t\t\n\t\titems = append(items, ArticleItem{\n\t\t\tID: articleID,\n\t\t\tTitle: title,\n\t\t\tDetailURL: detailURL,\n\t\t\tCategory: category,\n\t\t\tPublishDate: publishDate,\n\t\t\tViewCount: viewCount,\n\t\t\tSummary: summary,\n\t\t\tImageURL: imageURL,\n\t\t})\n\t})\n\t\n\treturn items\n}\n\n// fetchDetailsWithLinks 并发抓取详情页获取网盘链接\nfunc (p *AikanzyAsyncPlugin) fetchDetailsWithLinks(items []ArticleItem, client *http.Client, keyword string) []model.SearchResult {\n\t// 创建结果通道和等待组\n\tresultChan := make(chan model.SearchResult, len(items))\n\tvar wg sync.WaitGroup\n\t\n\t// 创建信号量控制并发数\n\tsemaphore := make(chan struct{}, detailConcurrency)\n\t\n\t// 并发处理每个文章项\n\tfor _, item := range items {\n\t\twg.Add(1)\n\t\t\n\t\tgo func(item ArticleItem) {\n\t\t\tdefer wg.Done()\n\t\t\t\n\t\t\t// 获取信号量\n\t\t\tsemaphore <- struct{}{}\n\t\t\tdefer func() { <-semaphore }()\n\t\t\t\n\t\t\t// 抓取详情页\n\t\t\tlinks := p.fetchDetailPageLinks(item.DetailURL, client)\n\t\t\t\n\t\t\t// 只有包含链接的结果才添加\n\t\t\tif len(links) > 0 {\n\t\t\t\t// 解析发布时间\n\t\t\t\tpublishTime := p.parsePublishTime(item.PublishDate)\n\t\t\t\t\n\t\t\t\t// 组装内容\n\t\t\t\tvar contentParts []string\n\t\t\t\tif item.Summary != \"\" {\n\t\t\t\t\tcontentParts = append(contentParts, item.Summary)\n\t\t\t\t}\n\t\t\t\tif item.Category != \"\" {\n\t\t\t\t\tcontentParts = append(contentParts, item.Category)\n\t\t\t\t}\n\t\t\t\tif item.PublishDate != \"\" {\n\t\t\t\t\tcontentParts = append(contentParts, item.PublishDate)\n\t\t\t\t}\n\t\t\t\tif item.ViewCount > 0 {\n\t\t\t\t\tcontentParts = append(contentParts, fmt.Sprintf(\"%d阅读\", item.ViewCount))\n\t\t\t\t}\n\t\t\t\tcontent := strings.Join(contentParts, \" | \")\n\t\t\t\t\n\t\t\t\t// 组装标签\n\t\t\t\tvar tags []string\n\t\t\t\tif item.Category != \"\" {\n\t\t\t\t\ttags = append(tags, item.Category)\n\t\t\t\t}\n\t\t\t\t\n\t\t\t\tresult := model.SearchResult{\n\t\t\t\t\tUniqueID: fmt.Sprintf(\"aikanzy-%s\", item.ID),\n\t\t\t\t\tTitle: item.Title,\n\t\t\t\t\tContent: content,\n\t\t\t\t\tLinks: links,\n\t\t\t\t\tTags: tags,\n\t\t\t\t\tChannel: \"\", // 插件搜索结果Channel为空\n\t\t\t\t\tDatetime: publishTime,\n\t\t\t\t}\n\t\t\t\t\n\t\t\t\tresultChan <- result\n\t\t\t}\n\t\t}(item)\n\t}\n\t\n\t// 等待所有goroutine完成\n\tgo func() {\n\t\twg.Wait()\n\t\tclose(resultChan)\n\t}()\n\t\n\t// 收集所有结果\n\tvar results []model.SearchResult\n\tfor result := range resultChan {\n\t\tresults = append(results, result)\n\t}\n\t\n\treturn results\n}\n\n// fetchDetailPageLinks 抓取详情页的网盘链接\nfunc (p *AikanzyAsyncPlugin) fetchDetailPageLinks(detailURL string, client *http.Client) []model.Link {\n\t// 创建带超时的上下文\n\tctx, cancel := context.WithTimeout(context.Background(), detailTimeout*time.Second)\n\tdefer cancel()\n\t\n\t// 创建请求\n\treq, err := http.NewRequestWithContext(ctx, \"GET\", detailURL, nil)\n\tif err != nil {\n\t\treturn nil\n\t}\n\t\n\t// 设置请求头\n\treq.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\")\n\treq.Header.Set(\"Accept\", \"text/html,application/xhtml+xml,application/xml;q=0.9,image/webp,*/*;q=0.8\")\n\treq.Header.Set(\"Accept-Language\", \"zh-CN,zh;q=0.9,en;q=0.8\")\n\treq.Header.Set(\"Connection\", \"keep-alive\")\n\treq.Header.Set(\"Referer\", \"https://www.aikanzy.com/\")\n\treq.Header.Set(\"Upgrade-Insecure-Requests\", \"1\")\n\t\n\t// 发送请求（带重试）\n\tresp, err := p.doRequestWithRetry(req, client)\n\tif err != nil {\n\t\treturn nil\n\t}\n\tdefer resp.Body.Close()\n\t\n\t// 检查状态码\n\tif resp.StatusCode != http.StatusOK {\n\t\treturn nil\n\t}\n\t\n\t// 解析HTML\n\tdoc, err := goquery.NewDocumentFromReader(resp.Body)\n\tif err != nil {\n\t\treturn nil\n\t}\n\t\n\t// 提取网盘链接\n\treturn p.extractNetDiskLinks(doc)\n}\n\n// extractNetDiskLinks 从详情页提取网盘链接\nfunc (p *AikanzyAsyncPlugin) extractNetDiskLinks(doc *goquery.Document) []model.Link {\n\tvar links []model.Link\n\tfoundURLs := make(map[string]bool) // 用于去重\n\t\n\t// 方法1: 从标签的href属性提取\n\tdoc.Find(\"a[href*='pan.quark.cn'], a[href*='drive.uc.cn'], a[href*='pan.baidu.com'], a[href*='pan.xunlei.com']\").Each(func(i int, s *goquery.Selection) {\n\t\thref, exists := s.Attr(\"href\")\n\t\tif !exists || href == \"\" {\n\t\t\treturn\n\t\t}\n\t\t\n\t\t// 去重\n\t\tif foundURLs[href] {\n\t\t\treturn\n\t\t}\n\t\tfoundURLs[href] = true\n\t\t\n\t\t// 确定链接类型\n\t\tlinkType := p.determineLinkType(href)\n\t\tif linkType == \"\" {\n\t\t\treturn\n\t\t}\n\t\t\n\t\tlinks = append(links, model.Link{\n\t\t\tType: linkType,\n\t\t\tURL: href,\n\t\t\tPassword: p.extractPassword(href),\n\t\t})\n\t})\n\t\n\t// 方法2: 从页面HTML文本中提取（正则表达式）\n\tif len(links) == 0 {\n\t\thtml, _ := doc.Html()\n\t\t\n\t\t// 提取夸克网盘链接\n\t\tquarkLinks := quarkLinkRegex.FindAllString(html, -1)\n\t\tfor _, link := range quarkLinks {\n\t\t\tif !foundURLs[link] {\n\t\t\t\tfoundURLs[link] = true\n\t\t\t\tlinks = append(links, model.Link{\n\t\t\t\t\tType: \"quark\",\n\t\t\t\t\tURL: link,\n\t\t\t\t\tPassword: p.extractPassword(link),\n\t\t\t\t})\n\t\t\t}\n\t\t}\n\t\t\n\t\t// 提取UC网盘链接\n\t\tucLinks := ucLinkRegex.FindAllString(html, -1)\n\t\tfor _, link := range ucLinks {\n\t\t\tif !foundURLs[link] {\n\t\t\t\tfoundURLs[link] = true\n\t\t\t\tlinks = append(links, model.Link{\n\t\t\t\t\tType: \"uc\",\n\t\t\t\t\tURL: link,\n\t\t\t\t\tPassword: p.extractPassword(link),\n\t\t\t\t})\n\t\t\t}\n\t\t}\n\t\t\n\t\t// 提取百度网盘链接\n\t\tbaiduLinks := baiduLinkRegex.FindAllString(html, -1)\n\t\tfor _, link := range baiduLinks {\n\t\t\tif !foundURLs[link] {\n\t\t\t\tfoundURLs[link] = true\n\t\t\t\tlinks = append(links, model.Link{\n\t\t\t\t\tType: \"baidu\",\n\t\t\t\t\tURL: link,\n\t\t\t\t\tPassword: p.extractPassword(link),\n\t\t\t\t})\n\t\t\t}\n\t\t}\n\t\t\n\t\t// 提取迅雷网盘链接\n\t\txunleiLinks := xunleiLinkRegex.FindAllString(html, -1)\n\t\tfor _, link := range xunleiLinks {\n\t\t\tif !foundURLs[link] {\n\t\t\t\tfoundURLs[link] = true\n\t\t\t\tlinks = append(links, model.Link{\n\t\t\t\t\tType: \"xunlei\",\n\t\t\t\t\tURL: link,\n\t\t\t\t\tPassword: p.extractPassword(link),\n\t\t\t\t})\n\t\t\t}\n\t\t}\n\t}\n\t\n\treturn links\n}\n\n// determineLinkType 根据URL确定链接类型\nfunc (p *AikanzyAsyncPlugin) determineLinkType(urlStr string) string {\n\tlowerURL := strings.ToLower(urlStr)\n\t\n\tswitch {\n\tcase strings.Contains(lowerURL, \"pan.quark.cn\"):\n\t\treturn \"quark\"\n\tcase strings.Contains(lowerURL, \"drive.uc.cn\"):\n\t\treturn \"uc\"\n\tcase strings.Contains(lowerURL, \"pan.baidu.com\"):\n\t\treturn \"baidu\"\n\tcase strings.Contains(lowerURL, \"pan.xunlei.com\"):\n\t\treturn \"xunlei\"\n\tdefault:\n\t\treturn \"\"\n\t}\n}\n\n// extractArticleID 从URL中提取文章ID\nfunc (p *AikanzyAsyncPlugin) extractArticleID(urlStr string) string {\n\tmatches := articleIDRegex.FindStringSubmatch(urlStr)\n\tif len(matches) >= 3 {\n\t\treturn matches[2] // 返回数字ID\n\t}\n\treturn \"\"\n}\n\n// extractViewCount 提取阅读数\nfunc (p *AikanzyAsyncPlugin) extractViewCount(text string) int {\n\tmatches := viewCountRegex.FindStringSubmatch(text)\n\tif len(matches) >= 2 {\n\t\tvar count int\n\t\tfmt.Sscanf(matches[1], \"%d\", &count)\n\t\treturn count\n\t}\n\treturn 0\n}\n\n// cleanHTMLTags 清除HTML标签\nfunc (p *AikanzyAsyncPlugin) cleanHTMLTags(text string) string {\n\t// 移除标签\n\ttext = regexp.MustCompile(`
\n
\n 变形金刚 超能勇士崛起
\n \n \n \n\n \n \n \n
\n 视频下载 (夸克网盘)： \n \n https://pan.quark.cn/s/a372a91a0296\n \n
\n \n \n\n
\n \n \n
\n ![](\"douban_cache/xxx.jpg\")
\n HTML格式的完整帖子内容...
\",\n \"post_number\": 1,\n \"topic_id\": 1067663,\n \"link_counts\": [\n {\n \"url\": \"https://pan.quark.cn/s/d6b8b0908959\",\n \"internal\": false,\n \"reflection\": false,\n \"clicks\": 29\n },\n {\n \"url\": \"https://pan.baidu.com/s/1KJylsrBbKbMhi9e-i9YMVA?pwd=tn44\",\n \"internal\": false,\n \"reflection\": false,\n \"clicks\": 16\n }\n ]\n }\n ]\n },\n \"id\": 1067663,\n \"title\": \"遮天 第132集＆紫川2更15集 【4K高码】\",\n \"fancy_title\": \"遮天 第132集＆紫川2更15集 【4K高码】\",\n \"tags\": [\"夸克网盘\", \"影视\", \"百度网盘\", \"动漫\"],\n \"category_id\": 94\n}\n```\n\n### 关键字段说明\n\n#### post_stream.posts[0]（主帖内容）\n\n| 字段名 | 类型 | 说明 |\n|--------|------|------|\n| `cooked` | string | **HTML格式的完整帖子内容** |\n| `link_counts` | array | **所有外部链接列表（含网盘链接）** |\n\n#### link_counts 数组\n\n这是最可靠的链接提取来源，包含了帖子中所有外部链接：\n\n```json\n{\n \"url\": \"https://pan.quark.cn/s/d6b8b0908959\",\n \"internal\": false,\n \"reflection\": false,\n \"clicks\": 29\n}\n```\n\n| 字段名 | 类型 | 说明 |\n|--------|------|------|\n| `url` | string | **完整的链接URL** |\n| `internal` | bool | 是否为内部链接（false表示外部链接） |\n| `clicks` | int | 点击次数 |\n\n### 数据提取策略\n\n**推荐方式**：优先使用 `link_counts` 数组\n\n1. ✅ **最可靠**：由服务器解析，不会遗漏或截断\n2. ✅ **最完整**：包含所有外部链接\n3. ✅ **易解析**：结构化数据，无需正则表达式\n\n```go\n// 从 link_counts 提取网盘链接\nfor _, linkCount := range post.LinkCounts {\n // 跳过内部链接\n if linkCount.Internal {\n continue\n }\n \n // 判断是否为网盘链接\n if isNetDiskURL(linkCount.URL) {\n link := parseNetDiskLink(linkCount.URL)\n links = append(links, link)\n }\n}\n```\n\n**备用方式**：从 `cooked` HTML 中提取\n\n当 `link_counts` 为空或不完整时，可以从 HTML 中提取：\n\n```go\n// 使用 goquery 解析 HTML\ndoc, _ := goquery.NewDocumentFromReader(strings.NewReader(post.Cooked))\n\n// 提取所有 标签\ndoc.Find(\"a\").Each(func(i int, s *goquery.Selection) {\n href, exists := s.Attr(\"href\")\n if exists && isNetDiskURL(href) {\n link := parseNetDiskLink(href)\n links = append(links, link)\n }\n})\n```\n\n## 实现策略\n\n### 两步法获取完整数据\n\n1. **第一步：搜索API**\n - 获取帖子列表和基本信息\n - 从 `blurb` 快速提取部分链接\n - 获取 `topic_id` 用于详情请求\n\n2. **第二步：详情API**（按需）\n - 当 `blurb` 中链接不完整时\n - 或需要获取完整帖子内容时\n - 使用 `link_counts` 获取所有链接\n\n### 性能优化建议\n\n- ✅ **批量获取**：使用协程并发请求多个详情页\n- ✅ **智能跳过**：如果搜索结果已有完整链接，跳过详情请求\n- ✅ **缓存结果**：相同 `topic_id` 的详情可缓存\n- ⚠️ **速率限制**：避免请求过快被限流\n\n## 示例\n\n### 1. 搜索API 示例\n\n#### 请求\n```\nGET https://linux.do/search.json?q=%E9%81%AE%E5%A4%A9%20%23resource%3Acloud-asset%20in%3Atitle&page=1\n```\n\n#### 响应（简化）\n```json\n{\n \"posts\": [\n {\n \"id\": 9619992,\n \"username\": \"lxwh\",\n \"created_at\": \"2025-10-21T10:29:05.613Z\",\n \"blurb\": \"夸克网盘： https://pan.quark.cn/s/99758a147076\",\n \"topic_id\": 1067663\n }\n ],\n \"topics\": [\n {\n \"id\": 1067663,\n \"title\": \"遮天 第132集＆紫川2更15集 【4K高码】\",\n \"tags\": [\"夸克网盘\", \"影视\", \"动漫\"]\n }\n ]\n}\n```\n\n### 2. 详情API 示例\n\n#### 请求\n```\nGET https://linux.do/t/1067663.json?track_visit=true&forceLoad=true\n```\n\n#### 响应（简化）\n```json\n{\n \"post_stream\": {\n \"posts\": [\n {\n \"id\": 9619992,\n \"link_counts\": [\n {\n \"url\": \"https://pan.quark.cn/s/d6b8b0908959\",\n \"internal\": false,\n \"clicks\": 29\n },\n {\n \"url\": \"https://pan.baidu.com/s/1KJylsrBbKbMhi9e-i9YMVA?pwd=tn44\",\n \"internal\": false,\n \"clicks\": 16\n }\n ]\n }\n ]\n },\n \"title\": \"遮天 第132集＆紫川2更15集 【4K高码】\"\n}\n```\n\n" }, { "path": "plugin/djgou/djgou.go", "content": "package djgou\n\nimport (\n\t\"context\"\n\t\"fmt\"\n\t\"net/http\"\n\t\"net/url\"\n\t\"pansou/model\"\n\t\"pansou/plugin\"\n\t\"regexp\"\n\t\"strings\"\n\t\"sync\"\n\t\"time\"\n\n\t\"github.com/PuerkitoBio/goquery\"\n)\n\n// 预编译的正则表达式\nvar (\n\t// 夸克网盘链接正则表达式（网站只有夸克网盘）\n\t// 注意：夸克链接可能包含字母、数字、下划线、连字符等字符\n\tquarkLinkRegex = regexp.MustCompile(`https?://pan\\.quark\\.cn/s/[0-9a-zA-Z_\\-]+`)\n\t\n\t// 提取码正则表达式\n\tpwdRegex = regexp.MustCompile(`提取码[:：]\\s*([a-zA-Z0-9]{4})`)\n\t\n\t// 缓存相关\n\tdetailCache = sync.Map{} // 缓存详情页解析结果\n\tlastCleanupTime = time.Now()\n\tcacheTTL = 1 * time.Hour\n)\n\nconst (\n\t// 超时时间\n\tDefaultTimeout = 8 * time.Second\n\tDetailTimeout = 6 * time.Second\n\t\n\t// 并发数（精简后的代码使用较低的并发即可）\n\tMaxConcurrency = 15\n\t\n\t// HTTP连接池配置\n\tMaxIdleConns = 50\n\tMaxIdleConnsPerHost = 20\n\tMaxConnsPerHost = 30\n\tIdleConnTimeout = 90 * time.Second\n\t\n\t// 网站URL\n\tSiteURL = \"https://duanjugou.top\"\n)\n\n// 在init函数中注册插件\nfunc init() {\n\tplugin.RegisterGlobalPlugin(NewDjgouPlugin())\n\t\n\t// 启动缓存清理goroutine\n\tgo startCacheCleaner()\n}\n\n// startCacheCleaner 启动一个定期清理缓存的goroutine\nfunc startCacheCleaner() {\n\tticker := time.NewTicker(30 * time.Minute)\n\tdefer ticker.Stop()\n\t\n\tfor range ticker.C {\n\t\t// 清空所有缓存\n\t\tdetailCache = sync.Map{}\n\t\tlastCleanupTime = time.Now()\n\t}\n}\n\n// DjgouPlugin 短剧狗插件\ntype DjgouPlugin struct {\n\t*plugin.BaseAsyncPlugin\n\toptimizedClient *http.Client\n}\n\n// createOptimizedHTTPClient 创建优化的HTTP客户端\nfunc createOptimizedHTTPClient() *http.Client {\n\ttransport := &http.Transport{\n\t\tMaxIdleConns: MaxIdleConns,\n\t\tMaxIdleConnsPerHost: MaxIdleConnsPerHost,\n\t\tMaxConnsPerHost: MaxConnsPerHost,\n\t\tIdleConnTimeout: IdleConnTimeout,\n\t\tDisableKeepAlives: false,\n\t}\n\treturn &http.Client{Transport: transport, Timeout: DefaultTimeout}\n}\n\n// NewDjgouPlugin 创建新的短剧狗插件\nfunc NewDjgouPlugin() *DjgouPlugin {\n\treturn &DjgouPlugin{\n\t\tBaseAsyncPlugin: plugin.NewBaseAsyncPlugin(\"djgou\", 2), // 优先级2：质量良好的数据源\n\t\toptimizedClient: createOptimizedHTTPClient(),\n\t}\n}\n\n// Search 执行搜索并返回结果（兼容性方法）\nfunc (p *DjgouPlugin) Search(keyword string, ext map[string]interface{}) ([]model.SearchResult, error) {\n\tresult, err := p.SearchWithResult(keyword, ext)\n\tif err != nil {\n\t\treturn nil, err\n\t}\n\treturn result.Results, nil\n}\n\n// SearchWithResult 执行搜索并返回包含IsFinal标记的结果\nfunc (p *DjgouPlugin) SearchWithResult(keyword string, ext map[string]interface{}) (model.PluginSearchResult, error) {\n\treturn p.AsyncSearchWithResult(keyword, p.searchImpl, p.MainCacheKey, ext)\n}\n\n// searchImpl 实现具体的搜索逻辑\nfunc (p *DjgouPlugin) searchImpl(client *http.Client, keyword string, ext map[string]interface{}) ([]model.SearchResult, error) {\n\t// 1. 构建搜索URL\n\tsearchURL := fmt.Sprintf(\"%s/search.php?q=%s&page=1\", SiteURL, url.QueryEscape(keyword))\n\t\n\t// 2. 创建带超时的上下文\n\tctx, cancel := context.WithTimeout(context.Background(), DefaultTimeout)\n\tdefer cancel()\n\t\n\t// 3. 创建请求\n\treq, err := http.NewRequestWithContext(ctx, \"GET\", searchURL, nil)\n\tif err != nil {\n\t\treturn nil, fmt.Errorf(\"[%s] 创建请求失败: %w\", p.Name(), err)\n\t}\n\t\n\t// 4. 设置完整的请求头（避免反爬虫）\n\treq.Header.Set(\"User-Agent\", \"Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/114.0.0.0 Safari/537.36\")\n\treq.Header.Set(\"Accept\", \"text/html,application/xhtml+xml,application/xml;q=0.9,image/avif,image/webp,image/apng,*/*;q=0.8\")\n\treq.Header.Set(\"Accept-Language\", \"zh-CN,zh;q=0.9,en;q=0.8\")\n\treq.Header.Set(\"Connection\", \"keep-alive\")\n\treq.Header.Set(\"Upgrade-Insecure-Requests\", \"1\")\n\treq.Header.Set(\"Cache-Control\", \"max-age=0\")\n\treq.Header.Set(\"Referer\", SiteURL)\n\t\n\t// 5. 发送请求（带重试机制）\n\tresp, err := p.doRequestWithRetry(req, client)\n\tif err != nil {\n\t\treturn nil, fmt.Errorf(\"[%s] 搜索请求失败: %w\", p.Name(), err)\n\t}\n\tdefer resp.Body.Close()\n\t\n\tif resp.StatusCode != 200 {\n\t\treturn nil, fmt.Errorf(\"[%s] 搜索请求返回状态码: %d\", p.Name(), resp.StatusCode)\n\t}\n\t\n\t// 6. 解析搜索结果页面\n\tdoc, err := goquery.NewDocumentFromReader(resp.Body)\n\tif err != nil {\n\t\treturn nil, fmt.Errorf(\"[%s] 解析搜索页面失败: %w\", p.Name(), err)\n\t}\n\t\n\t// 7. 提取搜索结果\n\tvar results []model.SearchResult\n\t\n\t// 查找主列表容器\n\tmainListSection := doc.Find(\"div.erx-list-box\")\n\tif mainListSection.Length() == 0 {\n\t\treturn nil, fmt.Errorf(\"[%s] 未找到erx-list-box容器\", p.Name())\n\t}\n\t\n\t// 查找列表项\n\titems := mainListSection.Find(\"ul.erx-list li.item\")\n\tif items.Length() == 0 {\n\t\treturn []model.SearchResult{}, nil // 没有搜索结果\n\t}\n\t\n\t// 8. 解析每个搜索结果项\n\titems.Each(func(i int, s *goquery.Selection) {\n\t\tresult := p.parseSearchItem(s, keyword)\n\t\tif result.UniqueID != \"\" {\n\t\t\tresults = append(results, result)\n\t\t}\n\t})\n\t\n\t// 9. 异步获取详情页信息\n\tenhancedResults := p.enhanceWithDetails(client, results)\n\t\n\t// 10. 关键词过滤\n\treturn plugin.FilterResultsByKeyword(enhancedResults, keyword), nil\n}\n\n// parseSearchItem 解析单个搜索结果项\nfunc (p *DjgouPlugin) parseSearchItem(s *goquery.Selection, keyword string) model.SearchResult {\n\tresult := model.SearchResult{}\n\t\n\t// 提取标题区域\n\taDiv := s.Find(\"div.a\")\n\tif aDiv.Length() == 0 {\n\t\treturn result\n\t}\n\t\n\t// 提取链接和标题\n\tlinkElem := aDiv.Find(\"a.main\")\n\tif linkElem.Length() == 0 {\n\t\treturn result\n\t}\n\t\n\ttitle := strings.TrimSpace(linkElem.Text())\n\tlink, exists := linkElem.Attr(\"href\")\n\tif !exists || link == \"\" {\n\t\treturn result\n\t}\n\t\n\t// 处理相对路径\n\tif !strings.HasPrefix(link, \"http\") {\n\t\tif strings.HasPrefix(link, \"/\") {\n\t\t\tlink = SiteURL + link\n\t\t} else {\n\t\t\tlink = SiteURL + \"/\" + link\n\t\t}\n\t}\n\t\n\t// 提取时间\n\ttimeText := \"\"\n\tiDiv := s.Find(\"div.i\")\n\tif iDiv.Length() > 0 {\n\t\ttimeSpan := iDiv.Find(\"span.time\")\n\t\tif timeSpan.Length() > 0 {\n\t\t\ttimeText = strings.TrimSpace(timeSpan.Text())\n\t\t}\n\t}\n\t\n\t// 生成唯一ID（使用链接的路径部分）\n\titemID := strings.TrimPrefix(link, SiteURL)\n\titemID = strings.Trim(itemID, \"/\")\n\tresult.UniqueID = fmt.Sprintf(\"%s-%s\", p.Name(), url.QueryEscape(itemID))\n\t\n\tresult.Title = title\n\tresult.Datetime = p.parseTime(timeText)\n\tresult.Tags = []string{\"短剧\"}\n\tresult.Channel = \"\" // 插件搜索结果必须为空字符串\n\t\n\t// 将详情页链接存储在Content中，后续获取详情\n\tresult.Content = link\n\t\n\treturn result\n}\n\n// parseTime 解析时间字符串\nfunc (p *DjgouPlugin) parseTime(timeStr string) time.Time {\n\tif timeStr == \"\" {\n\t\treturn time.Now()\n\t}\n\t\n\t// 尝试多种时间格式\n\tformats := []string{\n\t\t\"2006-01-02 15:04:05\",\n\t\t\"2006-01-02 15:04\",\n\t\t\"2006-01-02\",\n\t\t\"2006/01/02 15:04:05\",\n\t\t\"2006/01/02 15:04\",\n\t\t\"2006/01/02\",\n\t}\n\t\n\tfor _, format := range formats {\n\t\tif t, err := time.Parse(format, timeStr); err == nil {\n\t\t\treturn t\n\t\t}\n\t}\n\t\n\treturn time.Now()\n}\n\n// enhanceWithDetails 异步获取详情页信息\nfunc (p *DjgouPlugin) enhanceWithDetails(client *http.Client, results []model.SearchResult) []model.SearchResult {\n\tvar wg sync.WaitGroup\n\tvar mu sync.Mutex\n\t\n\t// 使用信号量控制并发数\n\tsemaphore := make(chan struct{}, MaxConcurrency)\n\t\n\tenhancedResults := make([]model.SearchResult, 0, len(results))\n\t\n\tfor _, result := range results {\n\t\twg.Add(1)\n\t\tgo func(r model.SearchResult) {\n\t\t\tdefer wg.Done()\n\t\t\t\n\t\t\t// 获取信号量\n\t\t\tsemaphore <- struct{}{}\n\t\t\tdefer func() { <-semaphore }()\n\t\t\t\n\t\t\t// 从缓存或详情页获取链接\n\t\t\tlinks, content := p.getDetailInfo(client, r.Content)\n\t\t\t\n\t\t\t// 更新结果\n\t\t\tr.Links = links\n\t\t\tr.Content = content\n\t\t\t\n\t\t\t// 只添加有链接的结果\n\t\t\tif len(links) > 0 {\n\t\t\t\tmu.Lock()\n\t\t\t\tenhancedResults = append(enhancedResults, r)\n\t\t\t\tmu.Unlock()\n\t\t\t}\n\t\t}(result)\n\t}\n\t\n\twg.Wait()\n\treturn enhancedResults\n}\n\n// getDetailInfo 获取详情页信息（带缓存）\nfunc (p *DjgouPlugin) getDetailInfo(client *http.Client, detailURL string) ([]model.Link, string) {\n\t// 检查缓存\n\tif cached, ok := detailCache.Load(detailURL); ok {\n\t\tcachedData := cached.(DetailCacheData)\n\t\tif time.Since(cachedData.Timestamp) < cacheTTL {\n\t\t\treturn cachedData.Links, cachedData.Content\n\t\t}\n\t}\n\t\n\t// 获取详情页\n\tlinks, content := p.fetchDetailPage(client, detailURL)\n\t\n\t// 存入缓存\n\tif len(links) > 0 {\n\t\tdetailCache.Store(detailURL, DetailCacheData{\n\t\t\tLinks: links,\n\t\t\tContent: content,\n\t\t\tTimestamp: time.Now(),\n\t\t})\n\t}\n\t\n\treturn links, content\n}\n\n// DetailCacheData 详情页缓存数据\ntype DetailCacheData struct {\n\tLinks []model.Link\n\tContent string\n\tTimestamp time.Time\n}\n\n// fetchDetailPage 获取详情页信息\nfunc (p *DjgouPlugin) fetchDetailPage(client *http.Client, detailURL string) ([]model.Link, string) {\n\t// 创建带超时的上下文\n\tctx, cancel := context.WithTimeout(context.Background(), DetailTimeout)\n\tdefer cancel()\n\t\n\t// 创建请求\n\treq, err := http.NewRequestWithContext(ctx, \"GET\", detailURL, nil)\n\tif err != nil {\n\t\treturn nil, \"\"\n\t}\n\t\n\t// 设置请求头\n\treq.Header.Set(\"User-Agent\", \"Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/114.0.0.0 Safari/537.36\")\n\treq.Header.Set(\"Accept\", \"text/html,application/xhtml+xml,application/xml;q=0.9,image/avif,image/webp,image/apng,*/*;q=0.8\")\n\treq.Header.Set(\"Accept-Language\", \"zh-CN,zh;q=0.9,en;q=0.8\")\n\treq.Header.Set(\"Referer\", SiteURL)\n\t\n\t// 发送请求\n\tresp, err := client.Do(req)\n\tif err != nil {\n\t\treturn nil, \"\"\n\t}\n\tdefer resp.Body.Close()\n\t\n\tif resp.StatusCode != 200 {\n\t\treturn nil, \"\"\n\t}\n\t\n\t// 解析页面\n\tdoc, err := goquery.NewDocumentFromReader(resp.Body)\n\tif err != nil {\n\t\treturn nil, \"\"\n\t}\n\t\n\t// 查找主内容区域（用于提取简介）\n\tmainContent := doc.Find(\"div.erx-wrap\")\n\tif mainContent.Length() == 0 {\n\t\treturn nil, \"\"\n\t}\n\t\n\t// 提取网盘链接（从整个页面HTML中提取，不仅仅是mainContent）\n\tlinks := p.extractLinksFromDoc(doc)\n\t\n\t// 提取简介（从mainContent提取）\n\tcontent := p.extractContent(mainContent)\n\t\n\treturn links, content\n}\n\n// extractLinksFromDoc 从整个文档中提取夸克网盘链接（重要：从整个页面HTML中提取，不限于某个div）\nfunc (p *DjgouPlugin) extractLinksFromDoc(doc *goquery.Document) []model.Link {\n\tvar links []model.Link\n\tlinkMap := make(map[string]bool) // 去重\n\t\n\t// 获取整个页面的HTML内容（这是关键！）\n\thtmlContent, _ := doc.Html()\n\t\n\t// 提取提取码\n\tpassword := \"\"\n\tif match := pwdRegex.FindStringSubmatch(htmlContent); len(match) > 1 {\n\t\tpassword = match[1]\n\t}\n\t\n\t// 方法1：使用专用正则表达式提取夸克网盘链接\n\tquarkLinks := quarkLinkRegex.FindAllString(htmlContent, -1)\n\tfor _, quarkURL := range quarkLinks {\n\t\t// 去重\n\t\tif !linkMap[quarkURL] {\n\t\t\tlinkMap[quarkURL] = true\n\t\t\tlinks = append(links, model.Link{\n\t\t\t\tType: \"quark\",\n\t\t\t\tURL: quarkURL,\n\t\t\t\tPassword: password,\n\t\t\t})\n\t\t}\n\t}\n\t\n\t// 方法2：从所有标签中查找夸克链接（作为补充）\n\tdoc.Find(\"a\").Each(func(i int, s *goquery.Selection) {\n\t\thref, exists := s.Attr(\"href\")\n\t\tif !exists || href == \"\" {\n\t\t\treturn\n\t\t}\n\t\t\n\t\t// 检查是否是夸克网盘链接\n\t\tif strings.Contains(href, \"pan.quark.cn\") {\n\t\t\t// 去重\n\t\t\tif !linkMap[href] {\n\t\t\t\tlinkMap[href] = true\n\t\t\t\tlinks = append(links, model.Link{\n\t\t\t\t\tType: \"quark\",\n\t\t\t\t\tURL: href,\n\t\t\t\t\tPassword: password,\n\t\t\t\t})\n\t\t\t}\n\t\t}\n\t})\n\t\n\treturn links\n}\n\n// extractContent 提取简介\nfunc (p *DjgouPlugin) extractContent(mainContent *goquery.Selection) string {\n\tcontent := strings.TrimSpace(mainContent.Text())\n\t\n\t// 清理空白字符\n\tcontent = regexp.MustCompile(`\\s+`).ReplaceAllString(content, \" \")\n\t\n\t// 限制长度\n\tif len(content) > 300 {\n\t\tcontent = content[:300] + \"...\"\n\t}\n\t\n\treturn content\n}\n\n// doRequestWithRetry 带重试机制的HTTP请求\nfunc (p *DjgouPlugin) doRequestWithRetry(req *http.Request, client *http.Client) (*http.Response, error) {\n\tmaxRetries := 3\n\tvar lastErr error\n\t\n\tfor i := 0; i < maxRetries; i++ {\n\t\tif i > 0 {\n\t\t\t// 指数退避重试\n\t\t\tbackoff := time.Duration(1<\n
\n```\n\n### 单个搜索结果结构\n\n- **封面图片**: `.video-cover .module-item-cover .module-item-pic`\n- **详情页链接**: `href=\"/index.php/vod/detail/id/{ID}.html\"`\n- **标题**: `.video-info-header h3 a`\n- **资源状态**: `.video-serial`（如\"更新至11集\"）\n- **分类信息**: `.video-info-aux .tag-link`\n- **导演主演**: `.video-info-main .video-info-items`\n- **操作按钮**: `.video-info-footer`\n\n### 详情页面结构\n\n- **下载链接区域**: `#download-list`\n- **网盘类型**: `.module-tab-item span[data-dropdown-value]`\n- **下载链接**: `data-clipboard-text` 属性或 `.module-row-title p`\n\n## 与其他网站对比\n\n| 项目 | Duoduo (多多) | Labi | Shandian | Muou |\n|------|---------------|------|----------|------|\n| 域名 | tv.yydsys.top | xiaocge.fun | 1.95.79.193 | 123.666291.xyz |\n| 协议 | HTTPS | HTTP | HTTP | HTTP |\n| HTML结构 | **完全一致** | **完全一致** | **完全一致** | **完全一致** |\n| 模板系统 | DYXS2 | DYXS2 | DYXS2 | DYXS2 |\n\n## 提取逻辑\n\n与 Labi、Shandian、Muou 插件使用相同的提取逻辑：\n\n1. **搜索结果页面**: 查找 `.module-search-item` 元素\n2. **详情页面**: 查找 `#download-list .module-row-one` 获取下载链接\n3. **网盘类型**: 根据链接URL自动识别（可能是夸克、UC、百度等）\n\n## 重要发现和修正\n\n### 1. 详情页链接提取 ⚠️ 重要修正\n\n**错误的提取方式：**\n```html\n\n\n
\n\n
\n \n \n
\n \n \n
\n```\n\n**正确的提取方式：**\n```html\n\n\n
\n```\n\n### 2. 反爬虫机制 🚫\n\n网站具有时间限制的反爬虫遮罩层：\n- **限制时间**: 05:00-18:00 显示遮罩\n- **可用时间**: 18:00-05:00 不显示遮罩\n- **绕过方式**: 设置适当的请求头，模拟正常浏览器行为\n\n### 3. 网盘类型支持 💾\n\n该网站支持四种主要网盘：\n- **夸克网盘**: `https://pan.quark.cn/s/5c258bac77e9`\n- **百度网盘**: `https://pan.baidu.com/s/1-3T82ScmmHORlxNCzBiDxQ?pwd=yyds`\n- **UC网盘**: `https://drive.uc.cn/s/985330f160cd4`\n- **迅雷网盘**: `https://pan.xunlei.com/s/VOW914w3izuHrOBPtJlwFYkuA1?pwd=nxv9`\n\n### 4. 下载链接提取\n\n在详情页中，下载链接位于：\n```html\n\n```\n\n## 注意事项\n\n1. **协议**: 使用HTTPS，安全性更高\n2. **反爬虫**: 注意时间限制，可能需要在特定时间段访问\n3. **多网盘**: 支持夸克、百度、UC、迅雷四种网盘\n4. **链接提取**: 必须从 `.video-info-header h3 a` 提取详情页链接\n5. **域名稳定性**: 注意域名可能变化，需要支持域名切换"
},
{
"path": "plugin/dyyj/dyyj.go",
"content": "package dyyj\n\nimport (\n\t\"context\"\n\t\"fmt\"\n\t\"io\"\n\t\"log\"\n\t\"net/http\"\n\t\"net/url\"\n\t\"os\"\n\t\"regexp\"\n\t\"strings\"\n\t\"sync\"\n\t\"time\"\n\n\t\"github.com/PuerkitoBio/goquery\"\n\t\"pansou/model\"\n\t\"pansou/plugin\"\n)\n\nconst (\n\tPluginName = \"dyyj\"\n\tDisplayName = \"电影云集\"\n\tDescription = \"电影云集 - 影视资源网盘链接搜索\"\n\tBaseURL = \"https://bbs.dyyjmax.org\"\n\tSearchPath = \"/?q=%s\"\n\tUserAgent = \"Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/138.0.0.0 Safari/537.36\"\n\tMaxResults = 100\n\tMaxConcurrency = 100\n\tRequestTimeout = 30 * time.Second\n\t\n\t// HTTP连接池配置（性能优化）\n\tMaxIdleConns = 100 // 最大空闲连接数\n\tMaxIdleConnsPerHost = 100 // 每个主机的最大空闲连接数\n\tMaxConnsPerHost = 100 // 每个主机的最大连接数\n\tIdleConnTimeout = 90 * time.Second // 空闲连接超时\n\tTLSHandshakeTimeout = 10 * time.Second // TLS握手超时\n\tExpectContinueTimeout = 1 * time.Second // Expect: 100-continue超时\n)\n\n// 预编译的正则表达式（性能优化：避免重复编译）\nvar (\n\t// 提取文章ID的正则\n\tpostIDRegex = regexp.MustCompile(`/d/(\\d+)`)\n\t\n\t// 提取noscript标签的正则\n\tnoscriptRegex = regexp.MustCompile(`凡人修仙传真人剧
\n夸克[^<]*
\\s*百度[^<]* 阿里[^<]* 天翼[^<]* 迅雷[^<]* {网盘名}\")\n\t\t\t\t\thasLIInNoscript := strings.Contains(noscriptContent, \"
![](\"https://poster-url.jpg\")
![\"凡人修仙传\"](\"/upload/mxprocms/20250310-1/4dd2e7fd412a71590c02b9514bf1805c.gif\")
![\"凡人修仙传\"](\"/upload/vod/20250727-1/5a8143a6b2e3fea89e11df8090bbdeff.jpg\")
![](\"static/image/common/none.gif\")
![\"影片地址\"](\"/skin/images/tv.png\")
![\"夸克网盘\"](\"/skin/images/kk.png\")
![\"百度网盘\"](\"/skin/images/bd.png\")
![](\"https://img.kuakemao.com/.../c4ac4195bed96c7-220x150.webp\")
![\"折腰(臻彩)\"](\"https://wsrv.nl/?url=https://img9.doubanio.com/view/photo/s_ratio_poster/public/p2921477016.jpg\")
![\"Anime](\"/static/img/icons/nyaa/1_3.png\"){kind=icon}