Violentmonkey：开源免费的用户脚本管理器 #

Violentmonkey 是什么？ #

Violentmonkey（中文常称“暴力猴”）是一款开源的用户脚本管理器浏览器扩展，为主流浏览器提供 userscript（用户脚本）支持。

它为网页脚本提供了完整的运行与管理环境：用户可以安装他人编写的现成脚本，也可以通过内置编辑器从零创建自己的脚本，用来定制网页外观、屏蔽干扰元素、增强站点功能或自动化日常重复操作。Violentmonkey 本身不包含任何广告，也不会主动修改网页内容——所有页面上的变化都来自用户安装的脚本。配合 Dropbox、OneDrive、Google Drive 或 WebDAV 云端同步，脚本还能在不同浏览器之间共享。对于希望把浏览器改造成“可编程工作台”的用户来说，它是一个轻量、透明且可信赖的选择。

Violentmonkey 有哪些亮点特色？ #

• 开源透明，隐私优先：项目源码完全公开，官方隐私政策明确承诺不收集任何个人数据，甚至连匿名的使用数据都不采集，也不使用 Google Analytics 等统计工具。
• 强大的网页定制与自动化能力：通过用户脚本可以自由修改网页样式与结构、自动化重复操作，把任意网站调整成符合自己习惯的样子。
• 云端同步，跨浏览器共享：支持同步到 Dropbox、OneDrive、Google Drive 或 WebDAV 服务，脚本可在 Chrome、Firefox、Edge 等不同浏览器之间同步，换设备、换浏览器都不必重新配置。
• 用户友好，开箱即用：官方强调“Keep simple, no need to make choices”，界面简洁直观，新建脚本、启用停用、排序管理都在一个面板内完成，新手无需复杂配置。
• 与外部编辑器通信：支持与外部代码编辑器联动，方便习惯在专业 IDE 中编写和调试脚本的进阶用户。
• 广泛的浏览器兼容性：基于 Web Extension API 构建，支持 Chrome Web Store、Firefox AMO、Microsoft Edge Addons 等多个官方分发渠道。
• 紧跟平台演进：Chrome Web Store 版本已升级至 Manifest V3，同时仍在 GitHub Releases 中提供包含 Beta 版与 MV2 版本在内的全部版本下载。
• 纯净无广告，行为可控：扩展本身不含广告，也不会自动修改任何网页；只有用户主动安装的脚本才会在匹配的页面上运行，权限边界清晰。

免费下载 Violentmonkey #

以下为官方提供的各版本安装包，点击链接即可下载。请注意区分 Manifest V3 版、WebExtension 通用版与 Firefox 专用安装包。

提示：官方同时通过 Chrome Web Store、Firefox AMO、Microsoft Edge Addons 和 GitHub Releases 分发稳定版，若不希望手动安装，可直接前往对应扩展商店搜索“Violentmonkey”。

Violentmonkey 如何使用？ #

第一步：确认安装并找到入口 安装完成后，浏览器工具栏上会出现一个猴子图标，这就是 Violentmonkey 的控制入口。点击图标即可打开管理面板，查看已安装的脚本列表。

第二步：安装现成的用户脚本 在脚本托管站点上找到你需要的脚本（例如去广告、网页增强类脚本），点击其安装按钮，Violentmonkey 会自动识别并弹出安装确认页，确认后脚本即刻生效。

第三步：为当前标签页新建脚本 点击工具栏图标，再点击面板中的 加号（+） 图标，即可为当前标签页的站点快速创建一个新脚本。

第四步：编写脚本内容 一个用户脚本由两部分组成：元数据块（metadata） 和 程序代码。元数据声明脚本的基本信息与运行规则，例如：

// ==UserScript==
// @name         New script
// @namespace    Violentmonkey Scripts
// @match        *://*/*
// @grant        none
// @version      1.0
// @author       -
// @description  3/8/2020, 8:42:28 PM
// ==/UserScript==

其中 @match 决定脚本在哪些网址上运行，@grant 声明脚本需要调用的 GM 接口权限。元数据块之后的代码，会像普通 JavaScript 一样在目标网页中执行。

第五步：保存并管理脚本 保存后脚本会自动在匹配的页面上运行。在管理面板中，你可以随时启用、停用、编辑、排序或删除脚本，也可以借助云端同步把脚本同步到其他浏览器。

注意：脚本代码直接在浏览器中执行，因此必须使用浏览器原生支持的语法。例如 ES modules 无法在用户脚本中工作（脚本需要以单文件形式注入网页）。若想使用较新的语法特性，可参考官网指南《How to use modern syntax in a userscript》。

Violentmonkey 的常见问题？ #

为什么 Violentmonkey 需要剪贴板权限？ 这是为了让 GM_setClipboard 在不同浏览器上都能正常工作。所需权限名为 clipboardWrite，只允许写入剪贴板，不能读取剪贴板内容。在 Chrome 上，扩展即使没有该权限也能在后台写入剪贴板，但在 Firefox 上不行，因此为了跨浏览器一致，扩展申请了该权限。

为什么使用第三方同步服务，而不是浏览器原生同步？ 因为 browser.storage.sync 是为同步偏好设置而设计的，而非大数据。它最多只能存储约 100 KB 数据（甚至比一个功能丰富的脚本还小），且只能在登录同一账号的同一款浏览器的多个实例间同步，无法在 Chrome 与 Firefox 之间共享，部分浏览器甚至未实现该 API。使用 Dropbox、Google Drive 等第三方服务后，可存储的数据更多，脚本还能在 Chrome、Firefox、Vivaldi、Maxthon 等多个浏览器间共享。

用户脚本存储在什么地方？ 脚本保存在浏览器扩展的本地存储区中。不同浏览器对存储的实现方式不同，因此无法确定具体位置与数据格式。也就是说，你无法在磁盘上以普通文件的形式找到脚本，它们可能存放在浏览器自行维护的数据库中。

为什么发布版代码是压缩（minified）的？ 官方解释是为了让代码更简洁高效。需要强调的是，发布版只是压缩，并没有混淆——这是一个 Web 应用普遍采用的编译与压缩工作流，使用的是全球广泛使用的成熟工具。完整源码可在 GitHub 上查看。

Violentmonkey 会自动修改网页或展示广告吗？ 不会。官方明确说明：该扩展不包含任何广告，也不会自动修改网页。页面上出现的一切变化，都来自用户自己安装的脚本。因此建议只安装你信任的脚本——脚本拥有较高权限的 API，例如可以携带你的登录凭据发送请求。

Violentmonkey 如何安装？ #

方式一：通过官方扩展商店安装（推荐）

1. Chrome 用户：访问 Chrome Web Store，搜索“Violentmonkey”，点击“添加至 Chrome”。目前商店版本已更新为 Manifest V3。
2. Firefox 用户：访问 Firefox AMO（addons.mozilla.org），搜索“Violentmonkey”，点击“添加到 Firefox”。
3. Microsoft Edge 用户：访问 Microsoft Edge Addons，搜索“Violentmonkey”，点击“获取”。
4. 安装完成后，浏览器工具栏会出现猴子图标，表示安装成功。

方式二：通过 GitHub Releases 手动安装

1. 打开官方 GitHub Releases 页面，或使用本文档下载表格中的安装包。
2. 如需包含 Beta 版本与 MV2 旧版的完整列表，可访问官网 Installation 一节提供的“View all versions”链接。

Chromium 内核浏览器（Chrome / Edge）手动加载 zip 包

1. 解压下载的 Violentmonkey-beta-mv3-v2.49.4.zip 或 Violentmonkey-beta-webext-v2.49.4.zip 到本地文件夹。
2. 在地址栏输入 chrome://extensions/（Edge 为 edge://extensions/）并回车。
3. 打开右上角的“开发者模式”开关。
4. 点击“加载已解压的扩展程序”，选择刚才解压出的文件夹。
5. 确认扩展已启用，工具栏出现猴子图标即安装完成。

Firefox 手动安装 .xpi 包

1. 打开 Firefox，在地址栏输入 about:addons 进入附加组件管理页面。
2. 点击齿轮图标，选择“从文件安装附加组件…”。
3. 选中下载的 violentmonkey-2.49.3b.xpi 文件并确认安装。
4. 若提示签名或安全警告，请确认文件来源可靠后继续。

注意：手动安装的版本不会自动更新，建议定期回到 GitHub Releases 查看新版本，或在条件允许时改用扩展商店版本。

Violentmonkey 如何卸载？ #

Chrome / Microsoft Edge（Chromium 内核）

1. 在地址栏输入 chrome://extensions/（Edge 为 edge://extensions/）并回车。
2. 在扩展列表中找到“Violentmonkey”。
3. 点击卡片上的“移除”按钮，在弹窗中确认即可。

Firefox

1. 打开菜单，进入“附加组件和主题”（或访问 about:addons）。
2. 在“扩展”列表中找到“Violentmonkey”。
3. 点击右侧的“…”或齿轮菜单，选择“移除”，然后确认。

手动加载的开发者模式版本

1. 进入浏览器的扩展管理页面。
2. 找到以“已解压”方式加载的 Violentmonkey 条目。
3. 点击“移除”，随后可自行删除本地解压出来的文件夹。

关于残留数据

用户脚本保存在浏览器扩展的本地存储区中，卸载扩展时通常会被一并清除。如果卸载后希望彻底清理，可检查浏览器的扩展数据目录或重装后确认脚本列表是否为空。由于脚本并非以普通文件形式存放在磁盘上，一般无需手动翻找文件。若你使用了云端同步，脚本仍保留在 Dropbox、Google Drive、OneDrive 或 WebDAV 服务中，重新安装扩展并登录同一同步账号即可恢复。