logo

ScriptCat

UTags Advanced Filter

pipecraft
•
Created at 8 days ago
•
Updated at a day ago
Real-time filters for list items on any website. Hides items that don't match your criteria, without reloading the page. Supports Greasy Fork and will support more sites via rules.
Total Installs
75
Today's New
+0
User Rating
- / 5.0 (0)
Current Version
0.1.2
Install Script
Script Details
Applicable Sites
LicenseMIT

UTags Advanced Filter

一个在任意网站对列表型内容进行实时过滤与隐藏的工具，提供用户脚本和浏览器扩展两种版本。区别于站点自身的搜索/筛选，它在页面内直接隐藏不满足条件的条目，支持即时切换与叠加条件查看过滤后的结果。

当前已适配 Greasy Fork 的脚本列表，后续将通过“规则”适配更多站点。

screenshots

核心特性 (Key Features)

  • 页面内实时过滤，支持条件叠加，统计即时反馈。
  • 主开关与安全重置（延迟显示、二次确认）。
  • 按站点持久化设置；性能缓存避免重复解析。
  • 全局评分机制：面板顶部提供全局分数阈值（默认 15）。各筛选项命中时贡献分数——关键字（每项默认 5 分）、更新/创建/安装量（每类默认 20 分）、作者（每位作者可单独设置分数，默认 20 分）。在默认值下，任一非关键字条件命中即隐藏；用户可将各类或作者分数调低，使多个条件累计达到阈值后再隐藏。
  • 支持负分抵消：关键字与作者都支持负分，可用于抵消隐藏，实现更细粒度的组合控制。
  • 关键字过滤：列表管理、逐项开关、分数可编辑；范围（标题/描述/标题+描述）；大小写敏感与正则（/regex/flags）；支持负分用于抵消隐藏。
  • 作者过滤：表格管理（ID/用户名），逐项启用/禁用、内联编辑、删除、添加行；表头主复选框；从页面采集作者并批量添加。
  • 日期过滤：更新日期与创建日期（更早/更近），支持模式（天/月）、预设与自定义天数。
  • 安装量过滤：总安装量与日安装量阈值。
  • 样式隔离：ShadowRoot 承载 UI；统一组件（日期预设、下拉菜单）。
  • 深色模式兼容：面板与表单控件强制浅色渲染，保持一致外观。
  • 调试开关：在统计旁提供开关，一键互换“显示/隐藏”的项目，便于确认与调试筛选结果。

已实现功能 (Implemented Features)

UI & UX

  • 样式隔离: 使用 ShadowRoot 承载 UI，完全避免目标网站的 CSS 样式污染。
  • 悬浮面板: 筛选器 UI 以一个可拖拽的悬浮面板形式呈现，固定在页面右侧。
  • 可折叠设计: 面板可折叠为一个半透明的 UTags 品牌图标，鼠标悬停时不透明；折叠状态会被持久化。
  • 优化的布局:
    • 双行结构: 顶部为标题和操作区（重置、折叠），下方为统计和总开关。
    • 安全重置: “重置”按钮默认隐藏，鼠标悬停 3 秒后才显示，且点击后有二次确认弹窗，防止误操作。
    • 主控开关: 在统计信息左侧提供一个主复选框，可一键启用/禁用所有筛选器，并在部分启用时显示为“半选”状态。
    • 快捷控制: 将“更新/创建”日期筛选以统一的行形式呈现，支持复选框启用、模式切换（天/月）、预设与自定义天数；右侧统计会实时显示“显示 X | 隐藏 X”。
  • 统一的组件:
    • 日期预设组件: 将日期筛选（更新日期、创建日期）封装为可复用的 createDatePresetInput 组件，支持“半年/一年/两年”等预设及自定义天数。
    • 下拉菜单: 支持按 Esc 键关闭，拥有独立的边框和阴影样式。
    • 统一的复选框样式: 所有复选框使用统一的 utaf-checkbox CSS 类，增大了点击区域。

过滤能力 (Filtering) - Greasy Fork

  • 更新日期: 隐藏超过指定时间（如 N 天/月/年）未更新的脚本。
  • 创建日期:
    • 隐藏创建于指定日期之前的脚本。
    • 隐藏创建于指定日期之内的脚本。
  • 安装量:
    • 隐藏总安装量小于 N 的脚本。
    • 隐藏日安装量小于 N 的脚本。
  • 关键字:
    • 以列表管理关键字（逐项开关、编辑、删除、分数设置，默认 5）。
    • 支持设置隐藏阈值（如 15），当脚本标题/描述出现多个关键字且分数累计 ≥ 阈值时隐藏。
    • 重复出现的同一关键字只记一次分数。
    • 支持范围选择：仅标题、仅描述、标题+描述。
    • 支持大小写敏感与正则匹配（输入 /regex/flags 格式，如 /foo/i）。
    • 支持负分抵消：负分可用于为“有价值的关键字”降低总分，避免被隐藏。示例：阈值为 4，foo 5 分、bar -2 分；两者同时命中时总分为 3，不会隐藏；仅命中 foo 时总分为 5，会隐藏。
  • 作者:
    • 作者表格管理: 以表格形式管理作者（ID、用户名），支持逐项启用/禁用、删除，支持内联编辑 ID/用户名，以及“添加”行快速录入。
    • 主复选框: 表头提供主复选框，支持全启用/全禁用，并显示“半选”状态。
    • 作者采集器: 可从当前页面采集作者列表，支持“全选/全不选”“刷新”“添加选中”“关闭”等操作，避免手动输入。
    • 即时持久化: 所有作者相关变更即时保存，并与其他筛选器共同实时更新统计。
  • 即时生效: 所有筛选条件的变更都会立即应用，并实时更新“显示/隐藏”统计。

数据与状态 (Data & State)

  • 按站点存储: 过滤设置按域名独立存储，键名格式为 utaf_{hostname}_filters，确保不同站点的配置互不干扰。
  • 首次使用检测: 通过全局状态 utaf_global_state 中的 isFirstUse 字段判断，首次在任意网站使用时，面板默认为展开状态，之后默认为折叠。
  • 性能缓存: 使用 WeakMap 缓存已解析的列表项指标（如时间戳、安装量），在重复过滤时避免重复的 DOM 查询和解析，提升性能。

安装与使用

未来规划 (Future Plans)

  • 规则引擎: 抽象统一的站点适配接口，通过外部规则配置（如 JSON）即可轻松适配新网站，而无需修改主脚本。规划中的规则将包含：
    • 站点检测: 域名、路径匹配。
    • 列表项选择器: 定义列表容器与条目。
    • 指标解析器: 如何从条目中提取更新时间、创建时间、安装量等数据。
  • 适配更多站点:
    • 论坛类: Discourse, Flarum 等。
    • 代码托管: GitHub Issues/PRs。
    • 社区: Reddit, V2EX 等。
  • 功能增强:
    • 设置同步: 提供导入/导出功能，或通过云服务同步配置。
    • 单项隐藏: 为列表中的每个项目添加独立的“隐藏”按钮，并持久化记录。

License

Copyright (c) 2025 Pipecraft. Licensed under the MIT License.