Proxy Switcher 项目使用教程

1. 项目的目录结构及介绍

Proxy Switcher 项目是一个用于修改 Firefox 浏览器代理设置的开源插件。以下是项目的目录结构及其介绍：

• .DS_Store：MacOS 系统生成的文件，通常包含文件夹的配置信息，无需关注。
• LICENSE：项目的许可证文件，本项目采用 MPL-2.0 许可。
• README.md：项目的说明文件，包含了项目的简介、功能、贡献方式等信息。
• 其他文件夹和文件：根据项目的具体实现可能还包含其他资源文件、脚本和文档等。

2. 项目的启动文件介绍

Proxy Switcher 插件的核心启动文件是浏览器扩展的入口文件，通常是 manifest.json 文件。这个文件定义了浏览器扩展的基本信息和权限，如下所示：

{
  "manifest_version": 2,
  "name": "Proxy Switcher",
  "version": "1.0",
  "description": "Modify Firefox's Proxy Settings from a Toolbar Panel",
  "permissions": [
    "proxy",
    "proxy:<all_urls>",
    "tabs",
    "storage"
  ],
  "background": {
    "scripts": ["background.js"],
    "persistent": false
  },
  "browser_action": {
    "default_popup": "popup.html",
    "default_icon": "icon.png"
  },
  "icons": {
    "48": "icon.png"
  }
}

这个文件指明了插件的名称、版本、描述、需要的权限、后台脚本、浏览器操作行为以及图标等。

3. 项目的配置文件介绍

Proxy Switcher 插件的配置文件通常用来保存用户的代理设置和配置信息。在扩展中，这些配置通常通过 storage API 来管理。

以下是一个配置文件示例，这可能是 background.js 文件中的一部分：

// 保存用户的代理配置
function saveProxyConfig(config) {
  browser.storage.local.set({proxyConfig: config}, function() {
    console.log('Proxy config saved');
  });
}

// 获取用户的代理配置
function getProxyConfig() {
  browser.storage.local.get('proxyConfig', function(result) {
    if (result.proxyConfig) {
      console.log('Proxy config retrieved:', result.proxyConfig);
    } else {
      console.log('No proxy config found');
    }
  });
}

这段代码演示了如何使用 browser.storage.local API 来保存和获取用户的代理配置信息。用户可以通过插件的界面来修改这些配置，并保存在浏览器的本地存储中。