Sakura - Custom JS & CSS：本地优先的 Firefox 用户脚本与样式注入扩展 #

Sakura - Custom JS & CSS 是什么？ #

Sakura - Custom JS & CSS 是一款由开发者 Gidarai 打造的 Firefox 浏览器扩展，本质上是一个本地优先的用户脚本管理器（User Script Manager）。它允许你通过自定义 URL 匹配规则，将自己编写的 JavaScript 与 CSS 精确注入到目标网站中——无论是修改页面外观、屏蔽干扰元素，还是给网页添加独有功能，都可以借助 Sakura 完成。

与 Tampermonkey、Violentmonkey 等主流脚本管理器相比，Sakura 最大的差异化价值在于**「彻底的本地化」**：扩展完全在用户设备上运行，所有规则、脚本与设置都通过 storage.local 保存在浏览器本地，官方明确声明无远程请求、无外部服务器、无遥测，也不收集任何个人数据。这使 Sakura 成为对隐私高度敏感的开发者、极客用户以及对网页有深度定制需求的进阶用户的理想选择。扩展采用 Sakura 主题的 CodeMirror 编辑器，并支持规则的导入导出（JSON），方便跨设备迁移或团队共享。

Sakura - Custom JS & CSS 有哪些亮点特色？ #

• 按 URL 模式精准注入：每条规则都可以绑定自定义的 URL 匹配模式，只有命中目标站点的页面才会执行对应的 JavaScript 或 CSS，避免全局污染与误伤。
• Sakura 主题可视化编辑器：内置基于 CodeMirror 的代码编辑器，具备语法高亮与 Sakura 主题配色，编写 JS / CSS 规则更直观、更舒适。
• 规则搜索与一键开关：支持对已保存规则进行搜索过滤，并可通过开关按钮快速启用或禁用某条规则，所有改动均实时生效，无需刷新浏览器。
• JSON 导入 / 导出：规则集可以导出为 JSON 文件备份，也可以在另一台设备或另一位用户处导入，便于迁移与分享，降低规则重建成本。
• 绝对的本地化与隐私安全：官方明确表示扩展不进行任何远程请求、不使用外部服务器、不包含遥测，全部数据保存在浏览器本地的 storage.local 中。
• 零数据收集承诺：在 Mozilla 附加组件页面中，开发者声明该扩展「无需收集数据」，用户无需担心脚本内容或浏览行为被上传。
• MIT 开源许可：扩展以 MIT 许可证发布，源码开放透明，具备审计能力的用户可以自行检查实现细节。
• 轻量独立：扩展体积约 2.58 MB，无需搭配其他插件即可独立完成「编辑 → 匹配 → 注入」的完整工作流。

免费下载 Sakura - Custom JS & CSS #

以下为官方提供的 Firefox 扩展安装包，点击链接即可下载。

你也可以直接在 Mozilla 官方附加组件页面在线安装：https://addons.mozilla.org/zh-CN/firefox/addon/sakura-custom-js-css/

Sakura - Custom JS & CSS 如何使用？ #

Sakura 的核心使用逻辑是「新建规则 → 定义 URL 匹配模式 → 编写 JS/CSS → 启用」。以下为典型操作流程：

1. 安装并打开扩展：在 Firefox 中完成扩展安装后，点击工具栏中的 Sakura 图标，或通过 about:addons → 「扩展」→ Sakura → 「选项」进入扩展主界面。
2. 创建一条新规则：在规则管理面板中点击「新建」按钮，进入 Sakura 主题的 CodeMirror 编辑器页面。
3. 配置 URL 匹配模式：在规则中填写希望生效的网址模式。例如填写 https://example.com/* 表示仅在 example.com 站点生效；只有命中该模式的页面才会执行这条规则。
4. 编写 JavaScript / CSS：在同一规则下分别输入需要注入的 JS 与 CSS 代码。JS 用于改变页面行为（如自动点击、隐藏弹窗），CSS 用于调整外观（如自定义深色主题、隐藏广告位）。
5. 保存并启用：保存规则后，通过规则列表中的开关按钮启用它。所有变更实时生效，无需重启浏览器即可看到效果。
6. 导入 / 导出（可选）：如需备份或迁移，可在扩展中导出规则为 JSON 文件；在另一台设备上使用「导入」功能即可恢复全部规则。

提示：由于规则只在匹配 URL 的页面上执行，建议为每条规则使用尽可能精确的 URL 模式，避免规则之间互相干扰。

Sakura - Custom JS & CSS 的常见问题？ #

Sakura 会把我的脚本或浏览数据上传到服务器吗？ 不会。开发者明确声明扩展「不收集、不传输、不分析任何个人数据」，所有规则、脚本和设置都保存在浏览器的 storage.local 中，扩展不含任何远程请求与遥测机制。

为什么某些网站上的规则没有生效？ 最常见的原因是 URL 匹配模式设置过窄或过宽。请确认规则中填写的匹配模式与目标页面的实际 URL 一致；此外，某些使用 CSP（内容安全策略）严格的站点可能会限制脚本注入行为，可尝试调整注入方式或更换目标页面。

Sakura 与 Tampermonkey / Violentmonkey 有什么区别？ Tampermonkey / Violentmonkey 侧重于加载外部编写的 .user.js 脚本生态，脚本来源通常需要从脚本市场获取；Sakura 则更专注于「自给自足」——由用户自己在扩展内编写 JS / CSS，所有内容完全本地存储，隐私性更强，但社区脚本生态相对有限。

扩展需要哪些权限？会不会有安全风险？ 根据 Mozilla 官方页面，Sakura 请求的权限是「访问您在所有网站的数据」，这是所有需要注入任意站点的用户脚本管理器所必需的权限。开发者同时声明不收集任何数据，且扩展以 MIT 许可证开源，用户可以自行审计源码。

可以在多台设备之间同步规则吗？ 扩展本身不提供云端同步功能。由于所有数据保存在本地，跨设备同步需要通过「导出规则为 JSON → 在另一台设备导入」的方式手动完成。

Sakura 支持哪些版本的 Firefox？ 该扩展发布于 Mozilla 官方附加组件平台（AMO），适用于主流 Firefox 版本。建议使用较新的 Firefox 稳定版或 ESR 版本以获得最佳兼容性；具体版本要求请以 AMO 页面显示为准。

Sakura - Custom JS & CSS 如何安装？ #

由于 Sakura 是 Firefox 浏览器扩展，安装方式主要有在线安装和离线安装两种，均以 Firefox 为唯一目标浏览器。

方式一：通过 Mozilla 官方商店在线安装（推荐） #

1. 打开 Firefox 浏览器，访问扩展官方页面：https://addons.mozilla.org/zh-CN/firefox/addon/sakura-custom-js-css/
2. 点击页面上的「添加到 Firefox」按钮。
3. 在弹出的权限确认窗口中点击「添加」，Firefox 会自动完成下载与安装。
4. 安装完成后，Sakura 图标会出现在浏览器工具栏，可随时点击使用。

方式二：通过 XPI 安装包离线安装 #

1. 使用本文上方提供的下载表格链接，下载 sakura_custom_js_css-1.0.0.xpi 文件到本地。
2. 在 Firefox 地址栏输入 about:addons 并回车，进入「附加组件管理器」。
3. 点击右上角的齿轮图标，选择「从文件安装附加组件…」。
4. 在弹出的文件选择框中选中刚才下载的 .xpi 文件并确认。
5. 阅读权限提示后点击「添加」，完成安装。

注意：手动安装 XPI 需要 Firefox 允许该来源的扩展安装；若使用 Firefox 正式版，官方签名的 XPI 可直接安装，未经签名的开发版 XPI 可能需要使用 Firefox Developer Edition 或 Nightly 并开启相关调试选项。

Sakura - Custom JS & CSS 如何卸载？ #

在 Firefox 中卸载（适用于 Windows / macOS / Linux） #

1. 打开 Firefox 浏览器，在地址栏输入 about:addons 并回车，进入附加组件管理器。
2. 在左侧选择「扩展」类别，在列表中找到 Sakura - Custom JS & CSS。
3. 点击该扩展条目右侧的「…」更多按钮，选择「移除」。
4. 在确认弹窗中点击「移除」，扩展即被卸载，工具栏图标随之消失。

从 Firefox for Android 中卸载 #

1. 打开 Firefox for Android，点击右上角菜单进入「附加组件」或「扩展」管理界面。
2. 找到 Sakura - Custom JS & CSS 条目。
3. 点击「移除」并确认即可。

清理残留数据 #

Sakura 的所有规则、脚本与设置均通过 storage.local 保存在浏览器本地。正常情况下，卸载扩展时 Firefox 会自动清除其对应的本地存储数据，无需手动清理。如果你希望彻底确认无残留，可：

1. 在卸载前通过扩展的「导出规则」功能备份你的规则 JSON（如日后需要恢复）。
2. 卸载后如需进一步清理，可在 about:config 中搜索与扩展 ID 相关的 storage.local 键值（此操作涉及浏览器底层配置，请谨慎处理，避免影响其他扩展）。
3. 若你曾通过账号同步过 Firefox 附加组件，可在 Firefox 账号的同步设置中检查并移除该扩展的同步记录。

提示：卸载扩展不会影响你已注入到网页中的临时脚本效果在刷新后即消失，因为所有注入行为只在扩展启用且页面加载时生效。