必须安装 Tampermonkey 扩展（v4.13+）才能在 Firefox 运行自定义 JS 脚本，通过 about:addons 安装或手动加载官方 XPI 文件，启用后右上角显示橙色猴子图标，并需将配置模式改为“初学者”以启用云同步功能。
要在火狐浏览器中运行自定义 JavaScript 脚本以增强网页功能或自动化操作，必须先配置油猴脚本管理工具——即 Tampermonkey 扩展，它替代了已停更的 Greasemonkey，是当前 Firefox 唯一稳定支持的用户脚本管理器，且需确保版本为 v4.13 或更高才能启用关键同步与云备份能力。
安装 Tampermonkey 扩展
打开火狐浏览器，在地址栏输入 about:addons 并回车 → 点击左侧“扩展”选项卡 → 在顶部搜索框中输入 Tampermonkey → 在结果中确认作者为 Jan Biniok 或 Tampermonkey Team → 点击右侧“添加到 Firefox”按钮 → 弹出权限提示后点击“添加”。
这一步操作起来很简单，直接按顺序点就行。安装成功后，右上角工具栏会立即出现一个橙色猴子图标，图标显示即代表扩展已加载并处于待命状态。
手动加载本地 XPI 文件（商店不可用时）
方法一：通过 about:config 关闭签名验证
在地址栏输入 about:config → 点击“接受风险并继续” → 搜索 xpinstall.signatures.required → 双击该项，将其值由 true 改为 false → 返回“扩展和主题”页面 → 点击右上角齿轮图标 → 选择“从文件安装附加组件” → 定位并选中已下载的 tampermonkey-*.xpi 文件 → 点击“打开”，再在弹窗中点击“添加”。
方法二：通过 about:debugging 临时加载（不改任何配置）
在地址栏输入 about:debugging#/runtime/this-firefox → 确保右上角“启用临时扩展”已开启 → 点击“加载临时扩展”按钮 → 选择已下载的 .xpi 文件 → 加载完成后，扩展条目出现在列表中，工具栏同步显示图标。
详细的 Three.js 3D 图形参考，涵盖场景设置、相机、几何体、材质、光照、动画、控制器、加载器、数学工具和调试。
【务必注意】两种方式都要求 XPI 文件来自 Tampermonkey 官方 GitHub Releases 页面（https://github.com/Tampermonkey/tampermonkey/releases），切勿使用第三方打包或篡改版本，否则可能触发 Firefox 的安全拦截或导致脚本执行异常。
验证安装与基础配置
第一步：点击右上角油猴图标 → 若弹出菜单含“仪表板”“管理面板”等选项，说明插件已正常初始化。
第二步：访问 https://www.tampermonkey.net/ → 查看页面底部 “Browser extension installed” 右侧是否显示绿色对勾图标。
第三步：打开管理面板 → 顶部菜单栏点击“设置” → 找到“配置模式” → 将其从默认的“新手”改为“初学者”。
第四步：在“安全”选项中，确认“允许运行来自未知来源的脚本”处于关闭状态，除非你明确信任所导入脚本的发布渠道。
改配置模式这一步不能跳过，否则后续无法进入「实用工具→云」功能入口，跨设备同步脚本将彻底失效。
导入首个用户脚本（验证功能闭环）
访问 https://greasyfork.org/zh-CN → 在搜索框输入“欢迎脚本”或“Hello World” → 找到评分高、更新时间近、匹配域名包含 greasyfork.org 的脚本 → 点击“安装此脚本” → Tampermonkey 弹窗中检查 @match 规则无误 → 点击“安装”。
安装完成后，刷新 Greasy Fork 首页，若页面顶部出现浮动提示文字（如“Hello, Tampermonkey!”），说明脚本已成功注入并执行。此时管理面板“已安装的脚本”列表中可见该条目，状态为启用。
