用户脚本

创建用户脚本

什么是用户脚本

用户脚本（UserScript）是一段 JavaScript 代码，通过 PageMod 注入到匹配的网页中运行，可以修改网页的外观、添加新功能、自动化操作等。PageMod 生成的脚本完全兼容 Tampermonkey 格式。

方式一：AI 对话创建（推荐）

1. 打开你想要修改或增强的目标网页。
2. 点击浏览器工具栏的 PageMod 图标，选择"打开侧边栏"（或使用快捷键）。
3. 在侧边栏的聊天 Tab 中，用自然语言描述你的需求。例如：
   • "帮我去掉这个网站的所有广告弹窗"
   • "把 Hacker News 改成现代卡片风格"
   • "自动展开这个页面上所有的折叠内容"
   • "记住我的表单信息，下次自动填充"
4. AI 会分析当前页面结构，生成用户脚本，并进入预览模式。
5. 预览模式下脚本立即生效，你可以实时看到效果。不满意可以继续在对话中提出修改要求。

方式二：人工编写代码

1. 在 Editor 面板中直接编写 JavaScript 代码。

管理脚本

查看脚本列表

在设置页面（右键 PageMod 图标 → 选项）中，可以看到所有已安装的脚本。每个脚本显示名称、版本、匹配规则和状态。

启用与禁用脚本

在脚本列表中，每个脚本右侧有启用/禁用开关。关闭开关后脚本不会在任何页面上运行，但保留代码和配置。你也可以在侧边栏的编辑器中直接切换脚本状态。

手动编辑脚本

1. 在侧边栏中切换到编辑器 Tab。
2. 从下拉列表中选择要编辑的脚本。
3. 编辑器支持 JavaScript 语法高亮、自动补全、括号匹配等功能。
4. 编辑过程中代码会自动保存为草稿，1 秒防抖后实时预览生效。
5. 你也可以在设置页面点击脚本进入全屏编辑模式。

脚本设置

每个脚本可以单独配置以下设置：

• 名称/描述/版本：脚本的标识信息，版本号影响更新检测。
• 匹配规则（@match）：控制脚本在哪些页面上运行。支持标准 match pattern（如 https://example.com/*）。
• 排除规则（@exclude）：排除特定页面不运行脚本。
• 运行时机（@run-at）：document_start（最早）、document_body、document_end、document_idle（默认）。
• @grant 权限：脚本需要的 GM API 权限。勾选后脚本才能调用对应的 GM_* 函数。
• @require 外部库：引用外部 JavaScript 库的 URL（如 jQuery）。
• @resource 资源：声明脚本可用的外部资源文件。

预览与发布脚本

1. AI 生成后自动预览：AI 创建或修改脚本后自动进入预览模式，脚本立即在匹配的页面上生效。
2. 手动预览：在编辑器中修改代码后，预览会在 1 秒内自动更新。
3. 发布：确认脚本效果满意后，点击编辑器中的"发布"按钮。预览版本会替换正式版本。
4. 撤销：如果预览效果不满意，点击"撤销"按钮恢复到修改前的版本。
5. 侧边栏关闭自动清理：关闭侧边栏时，未发布的预览脚本会自动清理，原脚本恢复运行。

删除脚本

在脚本列表中找到目标脚本，点击删除按钮。删除后脚本代码和配置会从浏览器本地存储中移除。已删除的脚本无法恢复，建议提前使用备份功能。