Skip to content

README_ZH.md

Latest commit

 

History

History
300 lines (216 loc) · 11.7 KB

README_ZH.md

File metadata and controls

300 lines (216 loc) · 11.7 KB
Raw

🔍 HuggingFace Model Filter — 中文文档

🇬🇧 English · 🇪🇸 Español · 🇨🇳 中文

GitHub GreasyFork License Version

一个功能强大的用户脚本，通过正面/负面关键词和正则表达式 Regex 过滤 Hugging Face 模型。支持浮动拖拽面板、多语言界面、自动无限滚动检测，以及用户/组织主页。 适用于 ViolentMonkey / TamperMonkey / Greasemonkey。

📸 预览截图

浮动面板 + 过滤结果 可拖拽的浮动过滤面板 — 毛玻璃设计，支持暗色模式。绿色 badge = 正面匹配，红色 badge = 负面匹配，半透明 = 被过滤

✨ 主要功能

  • ✅ 正面关键词过滤 — 仅显示与你关键词相符的模型
  • ❌ 负面关键词过滤 — 隐藏或淡化不想看到的模型
  • 🎨 现代浮动界面 — 可拖拽、可最小化、毛玻璃效果、自动暗色模式
  • 🔄 无限滚动 — 滚动时自动检测新加载的模型（兼容 SPA）
  • 👥 用户/组织页面 — 支持所有 Hugging Face 模型列表页面，包括用户和组织主页
  • 💾 完整持久化 — 关键词、选项和面板位置保存在 localStorage
  • 🏷️ 可视化徽章 — 每个模型卡片上的颜色标识（绿色/红色）
  • ⚡ 智能自动过滤 — 输入时自动应用过滤器（~800ms 防抖）
  • 🅰️ Regex 支持 — 支持正则表达式（Regex）高级搜索与模式匹配
  • 🌍 多语言支持 — 原生界面：English、Español、中文（简体）
  • 🌐 自动翻译（可选） — 支持 30+ 种语言，通过 Google Translate 翻译，始终由用户主动开启
  • 📊 实时统计计数 — 即时更新总数 / 可见数 / 过滤数

🤝 推荐配套脚本

推荐配合使用 PageTual — 该脚本可在滚动时自动加载下一页，无需手动点击翻页。它与 HuggingFace Model Filter 完美兼容，让你在过滤结果中实现无限滚动浏览。

📦 安装方法

1. 安装用户脚本管理器

浏览器 推荐扩展
Chrome / Edge / Brave Violentmonkey 或 Tampermonkey
Firefox Violentmonkey
Safari Userscripts（App Store）

2. 安装脚本

方式 A — GreasyFork（推荐）：

Install Userscript

方式 B — 手动安装：

  1. 在脚本管理器中新建一个脚本
  2. 复制并粘贴 huggingface-model-filter.user.js 的内容
  3. 保存（Ctrl+S）

3. 打开 Hugging Face

访问 https://huggingface.co/models， 浮动面板将出现在页面左上角。

🚀 快速入门

过滤示例

正面关键词 负面关键词 结果
uncensored, qwen beta, alpha 仅显示无审查 Qwen 模型，排除不稳定版本
gguf, 7b, 8b 13b, 70b GGUF 格式的小参数模型
llama, instruct deprecated 活跃的 LLaMA Instruct 模型
claude, thinking test, old 带 thinking 模式的 Claude 模型
mistral, mixtral sparse 仅显示稠密型 Mistral/Mixtral 模型

面板控制

  • 拖拽 — 按住顶部栏将面板拖动到任意位置
  • 最小化 — 点击 − 按钮折叠为紧凑条
  • 语言 — 原生选择器：English · Español · 中文（即时切换）
  • 自动翻译 — 可选复选框：从列表中选择任意语言，面板自动翻译
  • 应用 — 手动执行过滤
  • 重置 — 清除关键词并重新显示所有模型

🅰️ Regex 模式

过滤器支持正则表达式 (Regex) 进行高级模式匹配。在面板中切换关键词模式与 Regex 模式即可使用。

使用方法

  • 输入正面向 Regex 模式匹配你想看到的模型
  • 输入负面向 Regex 模式排除不需要的模型
  • 多个模式之间用逗号或换行分隔
  • 大小写匹配和全词匹配设置同样适用于 Regex 模式

预览

imagen

支持的语法

模式 说明 示例
keyword 简单匹配（同关键词模式） llama
llama|qwen 或 — 匹配任一条件 llama|qwen
(?=.*qwen)(?=.*uncensored) 正向先行断言 — 匹配满足所有条件的模型 (?=.*qwen)(?=.*uncensored)
^(?!.*beta) 负向先行断言 — 排除匹配条件的模型 ^(?!.*beta)
\b7b\b 词边界 — "7b" 不会匹配 "70b" \b7b\b
[0-9]+b 字符类和量词 7b|13b|70b

注意： 模式会与模型卡片文本进行比较。无效的 Regex 模式会被静默忽略并记录到控制台（HF Filter:）以供调试。

示例 Regex 过滤

正向 Regex 负向 Regex 结果
(?=.*qwen)(?=.*uncensored) 同时包含 "qwen" 和 "uncensored" 的模型
llama|mistral beta|alpha LLaMA 或 Mistral 模型，排除不稳定版本
\b7b\b \b70b\b 专门匹配 7B 模型，排除 70B

⚙️ 配置说明

所有设置自动保存在浏览器 localStorage 中，键名为 hf_model_filter_config。

JSON 结构

{
  "positiveKeywords": ["uncensored", "qwen"],
  "negativeKeywords": ["beta", "deprecated"],
  "hideOnNegative": true,
  "dimOnNegative": false,
  "highlightPositive": true,
  "caseSensitive": false,
  "matchFullWord": false,
  "showStats": true,
  "autoFilter": true,
  "locale": "zh",
  "autoTranslate": false,
  "autoTranslateLang": "",
  "position": { "x": 20, "y": 100 }
}

选项详解

选项 类型 说明
positiveKeywords string[] 仅显示包含至少一个这些词的模型
negativeKeywords string[] 匹配这些词的模型将被隐藏或淡化
hideOnNegative boolean true = 完全隐藏；false = 显示红色 badge
dimOnNegative boolean true = 淡化至 15% 而非完全隐藏
highlightPositive boolean true = 匹配的正面模型显示绿色边框和 badge
caseSensitive boolean 区分大小写
matchFullWord boolean 禁止部分匹配："test" 不会匹配 "testing"
showStats boolean true = 显示实时统计计数器
autoFilter boolean true = 输入时自动应用过滤器
locale "en" | "es" | "zh" 原生界面语言
autoTranslate boolean true = 启用 Google 自动翻译
autoTranslateLang string 目标语言 ISO 代码（如 fr、ja、de）
position {x, y} 面板保存位置（像素）

🌍 支持的语言

原生语言（无需 API，即时切换）

代码 语言
en English
es Español
zh 中文（简体）

Google Translate 自动翻译（可选）

自动翻译下拉列表包含 30 种语言：English、Español、中文、Français、Deutsch、Português、 Italiano、日本語、한국어、Русский、العربية、हिन्दी、Nederlands、Polski、Türkçe、 Tiếng Việt、ไทย、Svenska、Čeština、Ελληνικά、עברית、Українська、Română、Magyar、 Dansk、Suomi、Norsk、Bahasa Indonesia、Bahasa Melayu、বাংলা。

翻译结果会缓存在 localStorage（hf_filter_trans_cache）中，避免重复调用 API。

🛠️ 开发说明

项目结构

├── huggingface-model-filter.user.js  # 主脚本（~1148 行，纯原生 JS）
├── README.md                        # English documentation
├── README_ES.md                     # Documentación en español
├── README_ZH.md                     # 本文档（中文）
└── LICENSE                          # MIT License

依赖

  • 无。 脚本 100% 纯原生 JavaScript。
  • 仅使用 Violentmonkey / Tampermonkey 的 GM_addStyle 注入内联 CSS。
  • 无外部依赖，无打包工具，无需 npm。

调试方法

在浏览器中调试此脚本：

  1. 打开开发者工具（F12 → Console 标签页）
  2. 查找以 HF Filter: 开头的日志消息
  3. 可直接在控制台中输入 config 和 translationCache 查看状态
  4. 在 applyFilter() 函数中设置断点，检查模型卡片的 DOM 结构

🐛 常见问题

问题 解决方法
面板未显示 确保在 Hugging Face 模型列表页面（例如 huggingface.co/models 或 huggingface.co/:用户/models）
过滤器未生效 点击 应用过滤器 或停止输入约 800ms 后自动生效
所有模型都被隐藏 检查正面关键词是否过于严格，尝试刷新页面
面板遮挡内容 将其拖拽到其他角落，位置会自动保存
语言未切换 使用 Ctrl+Shift+R 强制刷新以清除用户脚本缓存
Google 翻译无法使用 可能被所在地区或广告拦截器阻止。界面仍可在原生语言下正常使用

📝 更新日志

v1.5（2026-06-26）

  • ✨ 支持正则表达式（Regex）高级搜索与模式匹配
  • 👥 支持用户和组织模型页面（huggingface.co/:用户/models）
  • 🧹 移除过时的"未来改进计划"章节

v1.4（2026-06-18）

  • 📝 文档大更新（新增 ES / EN / ZH 三版 README）
  • ✏️ 编辑修正与结构优化

v1.3（2026-06-18）

  • 🌍 完整的国际化（i18n）支持：界面支持 English、Español、中文
  • 🌐 Google Translate 自动翻译支持 30+ 种语言（始终 opt-in）
  • 🕹️ 手动语言选择器 + 持久化自动翻译选择器
  • 🗂️ 翻译缓存存入 localStorage，重复访问时即时加载

v1.2（2026-06-18）

  • ✅ 关键语法修复（config.negativeKeywords）
  • 🎨 界面优化：毛玻璃效果与更好的对比度
  • 🔄 SPA 导航支持（检测 URL 变化无需完全刷新）
  • 📊 实时统计计数器（总数 / 可见数 / 过滤数）

v1.1（2026-06-18）

  • ✨ 正面/负面关键词过滤功能
  • 🏷️ 匹配结果的视觉徽章
  • 💾 localStorage 配置持久化
  • 🖱️ 面板可拖拽与最小化

v1.0（2026-06-18）

  • 🚀 首次发布

📄 开源协议

本项目采用 MIT License。

🙏 致谢

  • Hugging Face 提供了优秀的开源模型平台
  • Violentmonkey 最佳用户脚本管理器
  • GreasyFork 社区的反馈与建议

为开源 AI 社区用心打造 ❤️