高效管理与资源配置：益达规则仓库技术指南

一、基础认知：规则仓库核心架构

规则系统定义与价值

规则仓库是益达应用的核心组件，它通过结构化配置文件定义网络资源的获取与解析逻辑。该系统采用模块化设计，允许用户根据不同站点特性定制解析规则，实现多媒体内容的高效获取。其核心价值在于将复杂的网络请求与数据解析逻辑封装为可复用的规则文件，降低普通用户的使用门槛，同时为高级用户提供灵活的扩展能力。

目录结构解析

项目采用清晰的层级结构组织规则资源：

• siteRule/：核心规则目录，包含所有站点配置
  • video/：视频站点专用规则集，如1AV.yds、jable.yds等
  • ydSource.yds：主规则文件，聚合所有站点配置
• screenshot/：应用界面截图资源库
• Document.md：完整技术文档

规则文件基础规范

规则文件采用JSON格式存储，基本结构包含三个核心部分：

{
  "url": "https://example.com/api?query=$key",  // 请求URL模板，支持变量替换
  "method": "GET",  // HTTP请求方法
  "headers": {  // 请求头配置
    "User-Agent": "益达规则引擎/1.0"
  }
}

上述配置定义了基本的网络请求参数，其中$key为动态变量，在实际请求时会被具体值替换。

二、核心能力：规则引擎功能解析

视频资源嗅探机制

🔧 视频源提取技术

益达规则引擎内置强大的视频资源嗅探功能，通过正则表达式（用于文本模式匹配的工具）识别页面中的媒体资源链接。核心配置参数包括：

{
  "webview": true,  // 启用WebView渲染模式
  "sourceRegex": "(.m3u8|.mp4)",  // 匹配视频资源的正则表达式
  "webviewJsDelay": 3000  // 页面加载完成后等待时间(毫秒)
}

此配置会在WebView中加载目标页面，等待3秒后执行资源提取，确保动态加载的视频链接被正确识别。

多站点规则管理

📌 规则隔离与复用策略

系统采用"一站点一规则"的管理方式，每个站点规则独立存储在siteRule/video/目录下，如jm.yds对应"jm"站点的完整解析规则。这种设计带来两大优势：一是规则维护互不干扰，二是支持按需加载，提升应用启动速度。

规则复用通过"继承机制"实现，子规则可继承主规则(ydSource.yds)中的公共配置，仅需定义差异化部分：

{
  "extends": "baseRule",  // 继承基础规则配置
  "domain": "example.com",  // 站点域名
  "search": {  // 仅覆盖搜索相关配置
    "url": "https://example.com/search?q=$key"
  }
}

本地缓存优化

缓存机制是提升规则执行效率的关键技术，通过合理设置缓存参数可减少重复网络请求：

{
  "cache": {
    "enable": true,  // 启用缓存
    "expire": 3600,  // 缓存有效期(秒)
    "key": "$url"  // 缓存键生成规则
  }
}

当缓存启用时，相同URL的请求在有效期内将直接返回缓存结果，平均可减少60%的网络请求耗时。

三、实战应用：规则配置与部署流程

环境准备与仓库克隆

在开始使用前，需完成基础环境配置：

1. 确保系统已安装Git工具
2. 执行仓库克隆命令：

   git clone https://gitcode.com/gh_mirrors/yi/yidaRule
   

3. 进入项目目录：

   cd yidaRule
   

规则导入流程

将规则文件导入益达应用的标准步骤：

1. 打开益达应用，进入"规则管理"界面
2. 选择"导入本地规则"选项
3. 导航至项目目录下的siteRule/文件夹
4. 选择ydSource.yds主规则文件
5. 等待导入完成（通常耗时3-5秒）
6. 验证规则：在应用中访问已配置的站点，确认内容可正常加载

自定义规则开发

创建新站点规则的实操步骤：

1. 在siteRule/video/目录下创建新文件，命名格式为"站点标识.yds"
2. 复制基础规则模板：

   {
     "name": "新站点规则",
     "domain": "newsite.com",
     "search": {
       "url": "https://newsite.com/search?keyword=$keyWord&page=$pageIndex",
       "listItem": ".video-item",  // 结果列表选择器
       "title": ".title",  // 标题选择器
       "cover": ".cover-img",  // 封面图选择器
       "url": ".link"  // 详情页链接选择器
     }
   }
   

3. 根据目标站点HTML结构调整选择器
4. 测试规则：通过应用的"规则调试"功能验证解析效果
5. 提交到主规则：在ydSource.yds中添加新规则引用

四、深度拓展：高级功能与优化策略

磁力链接配置进阶技巧

对于支持磁力链接的站点，可通过系统环境变量配置缓存目录，提升下载体验：

1. 打开系统环境变量设置界面
2. 新建系统变量：
   • 变量名：BTSERVER_DATA
   • 变量值：选择本地磁盘上的空闲目录（建议剩余空间>10GB）
3. 重启益达应用使配置生效

此配置可将磁力链接的临时文件存储到指定目录，避免系统盘空间不足问题。

规则性能优化指南

针对规则执行效率的优化建议：

1. 选择器优化：优先使用ID选择器（#id）和类选择器（.class），避免复杂的层级选择器
2. 正则表达式优化：减少贪婪匹配（.）的使用，明确匹配边界，如使用"[^"]+.m3u8"替代"..m3u8"
3. 并行请求控制：通过maxConcurrent参数限制并发请求数量，建议设置为3-5
4. 增量更新：对频繁变化的内容使用lastModified参数实现增量更新

常见问题解决方案

1. 规则导入后站点无法加载

问题分析：通常由于规则文件格式错误或站点结构变更导致。

解决步骤：

• 检查规则文件JSON格式是否正确（可使用在线JSON验证工具）
• 确认站点域名是否变更
• 查看应用日志（设置>高级>日志）中的具体错误信息
• 尝试更新到最新版本的规则文件

2. 视频播放卡顿或无法播放

问题分析：可能是视频源链接有效期短或网络环境问题。

解决步骤：

• 在规则中增加referer头信息："Referer": "https://targetsite.com"
• 启用retry机制："retry": 3（设置请求失败重试次数）
• 切换视频解析线路（如有多线路配置）
• 检查网络连接稳定性，建议使用WiFi环境

3. 搜索结果不完整

问题分析：分页参数配置错误或反爬机制限制。

解决步骤：

• 验证分页参数格式："pageIndex": {"start": 1, "step": 1}
• 添加延迟请求配置："delay": 1000（毫秒）
• 模拟浏览器行为：完善headers配置，包括Accept、Cookie等
• 检查是否需要设置"userAgentRotation": true启用UA轮换

自定义配置案例：多线路视频解析

以下是支持多线路解析的高级规则配置示例：

{
  "name": "多线路视频站点",
  "domain": "multiline.com",
  "play": {
    "lines": [
      {
        "name": "线路一",
        "url": "https://line1.multiline.com/play?id=$id",
        "sourceRegex": "var videoUrl = \"(.*?)\""
      },
      {
        "name": "线路二",
        "url": "https://line2.multiline.com/v/$id",
        "sourceRegex": "player.src\\('(.*?)'\\)"
      }
    ],
    "defaultLine": 0,  // 默认线路索引
    "autoSwitch": true  // 自动切换失败线路
  }
}

此配置实现了视频多线路解析功能，当默认线路解析失败时，系统会自动尝试其他线路，提升播放成功率。

项目资源目录指引

完整的项目资源结构如下：

• 核心规则目录：siteRule/
  • 主规则文件：ydSource.yds
  • 视频站点规则：video/（包含1AV.yds、jable.yds等）
• 文档资源：
  • 技术文档：Document.md
  • 使用说明：README.md
• 界面截图：screenshot/（包含各类功能界面示例）
• 许可协议：LICENSE

通过合理利用这些资源，用户可以全面掌握规则配置技巧，实现个性化的资源获取方案。