openuserjs.org 暂未发现付费内容

用户脚本（userscript）是一段由浏览器在特定网页上自动执行的 JavaScript 代码，用来修改页面外观、增加功能或自动化重复操作。要使用它，你需要两样东西：一个用户脚本管理器（如 Tampermonkey、Greasemonkey 或 Violentmonkey），以及从脚本仓库（如 OpenUserJS）获取的脚本文件。安装管理器后，打开脚本页面点击安装，脚本就会在匹配的网站上生效。

用户脚本能做什么

用户脚本运行在网页加载之后，因此可以操作页面上的元素和数据。常见用途包括：

• 增强网页功能：给网站补上缺失的按钮、快捷键或批量操作。
• 过滤与清理：隐藏广告位、弹窗、推荐模块，让页面更干净。
• 自动化操作：自动填写表单、批量下载、定时刷新等重复性任务。
• 调整显示：改变字体、配色、布局，或把内容导出成其他格式。

脚本的生效范围由它自己声明的匹配规则决定，通常只在你指定的域名或路径下运行，不会作用于所有网站。

安装用户脚本管理器

用户脚本本身不能直接在浏览器里运行，需要先装一个管理器扩展。三者的定位大致如下：

安装方式是从对应浏览器的扩展商店搜索名称并添加。安装完成后，浏览器工具栏会出现管理器图标，表示它已就绪。

从 OpenUserJS 查找并安装脚本

OpenUserJS 是一个用户脚本仓库，提供脚本的浏览、搜索和下载。典型流程是：

1. 打开 OpenUserJS 网站，用搜索框或分类列表找到需要的脚本。
2. 进入脚本详情页，查看它的说明、适用网站和更新记录。
3. 点击安装按钮。如果已装管理器，浏览器会弹出安装确认页，显示脚本名称、来源和将要访问的网站。
4. 确认安装。脚本会出现在管理器的脚本列表中，并在匹配的页面上自动运行。

安装前建议先读脚本说明，确认它作用的域名与你的需求一致。来源不明或权限范围过大的脚本应谨慎安装。

启用、禁用与更新

脚本装好后，日常管理都在管理器里完成：

• 启用/禁用：在脚本列表中切换开关，临时停用某个脚本而不删除它。
• 更新：多数脚本会声明更新地址，管理器可定期检查并提示更新；也可手动触发检查。
• 删除：不再需要时从列表中移除。
• 查看运行情况：部分管理器提供日志或错误提示，脚本不生效时可从这里排查。

用户脚本的基本结构

一个用户脚本就是一段带元数据头的 JavaScript。元数据头用注释形式写在文件开头，告诉管理器脚本的名称、作用范围和运行时机。例如需要给某个网站加一个按钮，脚本大致包含：

• 元数据块：声明 @name（名称）、@match 或 @include（在哪些网址运行）、@grant（需要使用的管理器 API）等。
• 主体代码：在页面加载后执行的逻辑，比如查找元素、绑定事件、插入新节点。

@match 决定脚本的触发范围，写错会导致脚本完全不运行；@grant 决定脚本能否调用管理器的存储、跨域请求等能力。修改现成脚本时，通常先看这两项是否与目标网站匹配。

常见问题排查

• 脚本不生效：先确认管理器已启用、脚本处于开启状态，再检查 @match 是否覆盖当前网址（注意子域名和路径）。
• 页面加载后才出现的内容抓不到：脚本可能在目标元素生成前就执行了，需要等待元素出现或监听页面变化。
• 权限冲突或功能异常：多个脚本操作同一页面时可能互相干扰，可逐个禁用定位冲突来源。
• 网站改版后失效：脚本依赖的页面结构变了，需要更新脚本或等待作者修复。
• 安装时被拦截：部分浏览器或安全设置会阻止安装，需在管理器或浏览器设置中允许。

总体思路是：先装管理器，再从可信仓库安装匹配需求的脚本，遇到问题优先检查匹配规则和运行时机。

user.js 通常指用户脚本（userscript）的源码文件，扩展名写作 .user.js。它本质是一段 JavaScript 代码，配合脚本管理器（如 Tampermonkey、Greasemonkey）在网页加载时执行，用来改变页面行为或增加功能。安装的前提是浏览器里已经装好脚本管理器；只下载 .user.js 文件而不装管理器，脚本不会自动运行。

user.js 与用户脚本的关系

“用户脚本”是功能概念，“user.js / .user.js”是这类脚本常见的文件命名约定。仓库（如 OpenUserJS）把用户脚本以 .user.js 链接提供，浏览器识别到该后缀并检测到脚本管理器后，会弹出安装界面。

需要区分两类同名文件：

• 用户脚本文件：包含元数据块和 JavaScript 逻辑，由脚本管理器加载执行。
• 浏览器配置文件里的 user.js：Firefox 等浏览器用于覆盖首选项的配置文件，与用户脚本无关。看到 “user.js” 时先确认语境。

user.js 文件里通常有什么

一个用户脚本一般由两部分组成：

// ==UserScript==
// @name         示例脚本
// @namespace    https://example.com
// @version      1.0.0
// @description  在页面上做某件事
// @match        https://example.com/*
// @grant        none
// ==/UserScript==

(function () {
  'use strict';
  // 在这里操作页面
})();

• 元数据块：位于 ==UserScript== 与 ==/UserScript== 之间，声明名称、版本、生效网址（@match / @include）、权限（@grant）等。脚本管理器靠它决定何时运行、能否调用特权 API。
• JavaScript 代码：实际逻辑。@match 决定哪些页面会注入这段代码，写错匹配规则是脚本“不生效”的常见原因。

安装步骤

1. 安装脚本管理器。在浏览器扩展商店安装 Tampermonkey 或 Greasemonkey（Firefox 上还有 Violentmonkey 等）。这是运行 .user.js 的宿主。
2. 打开脚本页面。在 OpenUserJS 等仓库找到目标脚本，进入其详情页。
3. 点击安装。点击 Install / 安装按钮，浏览器会跳转到 .user.js 地址，脚本管理器拦截并显示安装确认页。
4. 确认安装。在确认页检查脚本名称、来源、@match 范围，确认后写入管理器。
5. 验证运行。打开脚本声明的目标网站，刷新页面。可在脚本管理器的管理面板查看该脚本是否处于启用状态。

预期结果：脚本出现在管理器的已安装列表中，并在匹配的网页上生效。

安装后的管理

• 启用 / 禁用：在管理器面板用开关控制，不必卸载。
• 更新：多数管理器会按元数据里的更新地址定期检查；也可手动触发“检查更新”。
• 删除：在管理面板移除，或直接删除对应脚本条目。
• 编辑：可直接在管理器内置编辑器里改代码，适合临时调试。

脚本不生效怎么排查

• 匹配网址不对：核对 @match / @include 是否覆盖当前页面，子域和路径常被漏写。
• 管理器未启用或脚本被禁用：检查扩展是否开启、脚本开关是否为开。
• 页面加载时机：脚本在 DOM 就绪前执行可能找不到元素，可用 @run-at 调整或在代码里等待元素出现。
• 与其他脚本或扩展冲突：逐个禁用定位。
• 浏览器限制：部分页面（如浏览器内置页、扩展商店页）不允许注入脚本。

安全提醒

用户脚本能读写你访问的页面内容，来源不明的脚本可能窃取数据或篡改页面。安装前查看代码、作者和更新记录，优先选择仓库中维护活跃、说明清晰的脚本；对要求宽泛权限（如跨大量站点）的脚本保持谨慎。

在用户脚本（userscript）语境下，repository 通常指集中托管 .user.js 脚本的在线仓库或目录，例如 OpenUserJS 这类站点。它的作用是让你搜索、浏览并获取脚本文件，而真正让脚本在浏览器里运行的是 Greasemonkey、Tampermonkey 等脚本管理器。也就是说：仓库负责“存放和分发”，管理器负责“安装和执行”，.user.js 文件本身才是脚本内容。三者不是一回事。

三个概念先分清

仓库本身不会执行脚本，它只是来源。你从仓库拿到脚本后，仍需要脚本管理器来安装和运行。

从仓库找到并安装脚本的步骤

1. 先装好脚本管理器。在浏览器扩展商店安装 Tampermonkey 或 Greasemonkey，这是运行脚本的前提。
2. 在仓库中搜索。打开 OpenUserJS 这类仓库，用关键词搜索你需要的功能或目标网站。
3. 查看脚本详情页。确认脚本用途、更新时间和作者信息，判断是否还在维护。
4. 点击安装。仓库页面通常提供安装入口，脚本管理器会拦截并弹出安装确认界面。
5. 在管理器中确认。检查脚本将访问哪些网站、请求哪些权限，确认无误后再完成安装。
6. 验证是否生效。打开脚本针对的网站，刷新页面，观察功能是否出现；也可在管理器面板中确认脚本处于启用状态。

预期结果是：脚本出现在管理器的已安装列表中，并在匹配的网站上运行。

安装前要检查什么

• 来源可信度：优先选择有说明、有更新记录、被较多用户使用的脚本。
• 权限范围：留意脚本声明要访问的域名和权限，范围过大要谨慎。
• 代码可读性：仓库一般提供源码查看，必要时可先浏览再决定是否安装。
• 更新状态：长期未更新的脚本可能因网站改版而失效。

常见卡点

• 点了安装却没反应：多半是没装脚本管理器，或浏览器拦截了安装请求。
• 装了但不生效：检查脚本匹配的网址是否与你当前访问的页面一致，并确认脚本已启用。
• 仓库打不开或脚本消失：仓库只是分发渠道，脚本可能被作者删除或迁移，可另找来源。

把仓库理解为“脚本的货架”，管理器理解为“运行环境”，就能清楚该在哪里找脚本、又该由谁来执行它。