JSON 规则插件 URL 导入 — 写一段 JSON 就能自定义过滤

JSON 规则插件是什么

BiliPai 插件系统中最轻量的一种——不是编译好的二进制插件，而是一段 JSON 格式的规则文本。你可以：

• 自己写一段 JSON（零代码基础也能学）
• 从社区论坛、Telegram 群获取别人分享的规则 URL
• 复制粘贴到 BiliPai 里，立即生效

相比内置插件的硬编码能力，JSON 规则插件的优势是无限灵活——社区分享的规则只有你想不到，没有做不到。

BiliPai 支持的 JSON 插件能力

JSON 规则可以作用在三个层面：

URL 导入步骤

1. 设置 → 插件中心 → 下拉到底部 → JSON 规则插件 区域
2. 点击 添加规则 → 选择 从 URL 导入
3. 粘贴规则的 URL（必须是公开可访问的链接）
4. BiliPai 会拉取 JSON 内容，显示规则名称、描述、声明的权限
5. 确认无误 → 点击 启用
6. 规则立即生效

粘贴文本导入

如果你拿到的是一段 JSON 文本而不是 URL：

1. 选 粘贴 JSON 文本
2. 粘贴 → 确认格式正确 → 启用

JSON 规则示例

下面是一个最简单的推荐流过滤规则——过滤掉标题包含"AI"关键词的视频：

{
  "name": "过滤 AI 内容",
  "description": "推荐流中不显示标题含 AI 的视频",
  "version": "1.0",
  "capabilities": ["FEED_FILTER"],
  "rules": [
    {
      "field": "title",
      "operator": "contains",
      "value": "AI",
      "action": "remove"
    }
  ]
}

弹幕过滤示例

过滤掉包含"剧透"两个字的弹幕：

{
  "name": "防剧透弹幕",
  "description": "弹幕中不显示剧透内容",
  "version": "1.0",
  "capabilities": ["DANMAKU_FILTER"],
  "rules": [
    {
      "field": "text",
      "operator": "contains",
      "value": "剧透",
      "action": "hide"
    }
  ]
}

高亮 UP 主视频示例

把关注的 UP 主视频在推荐流里标记高亮：

{
  "name": "置顶关注 UP 主",
  "description": "关注的 UP 主视频在推荐流里置顶并高亮",
  "version": "1.0",
  "capabilities": ["FEED_SORTER", "FEED_HIGHLIGHT"],
  "rules": [
    {
      "field": "uploader",
      "operator": "in",
      "value": ["老番茄", "何同学", "罗翔说刑法"],
      "action": "pin_and_highlight"
    }
  ]
}

规则语法速查

社区规则分享

BiliPai 的 JSON 规则插件在社区非常活跃：

• Telegram 群组有专门的规则分享频道
• GitHub Issues 里有用户提交的规则
• MT 论坛、酷安等社区有人整理好规则集

使用社区规则前一定要审阅——看清楚它声明了哪些 capabilities，如果包含 NETWORK、LOCAL_HISTORY_READ 等敏感能力就要谨慎。下一页会详细讲 敏感权限插件审阅。

规则维护

• 启用 / 停用：在 JSON 规则插件区域切换开关
• 编辑：点规则卡片 → 查看 / 修改 JSON 内容
• 更新：URL 导入的规则会定期自动拉取最新版（可以在设置里手动触发）
• 删除：左滑规则卡片 → 删除

规则 vs 内置插件