Cookie AutoDelete 安装与使用教程

1. 项目目录结构及介绍

Cookie AutoDelete 的源码组织如下：

.
├── dist                    # 构建后的扩展程序文件
├── src                      # 源代码目录
│   ├── background.js        # 后台脚本，处理自动删除饼干的逻辑
│   ├── content_script.js    # 内容脚本，在页面上下文中运行
│   ├── icons                 # 扩展图标文件
│   ├── manifest.json         # 浏览器扩展元数据
│   └── options.html          # 用户设置界面
├── .editorconfig            # 编辑器配置
├── .eslintrc.json           # ESLint 配置
├── .gitignore               # Git 忽略规则
├── .lintstagedrc.json       # LintStaged 配置
├── LICENSE                  # 许可证文件
├── package-lock.json        # 依赖锁定文件
├── package.json             # 项目包描述文件
└── README.md                # 项目README文件

这里的主要文件包括：

• manifest.json: 浏览器扩展的配置文件，定义了扩展的基本信息、权限请求等。
• src/background.js: 这是后台脚本，负责监控标签关闭事件并执行饼干清除操作。
• src/content_script.js: 在浏览器标签内运行的脚本，与网页交互以实现功能。
• src/options.html: 设置界面的HTML文件，允许用户定制扩展的行为。

2. 项目的启动文件介绍

由于这是一个浏览器扩展，没有传统意义上的“启动文件”。不过，两个关键的脚本——background.js 和 content_script.js 在扩展安装后会被浏览器加载。

• background.js 是扩展的后台服务，它在浏览器启动时加载并在后台持续运行，监听如标签关闭这样的事件，然后根据配置删除不再使用的饼干。
• content_script.js 是在每个打开的网页中运行的脚本，它与网页DOM交互，例如，当用户改变白名单或灰名单时，该脚本更新状态。

3. 项目的配置文件介绍

manifest.json

这是浏览器扩展的配置文件，包含了关于扩展的重要信息，例如：

• name: 扩展的名字。
• version: 版本号。
• description: 简短描述。
• permissions: 请求的权限，比如访问所有网站的数据。
• background: 包含背景脚本的信息。
• browser_action: 针对浏览器动作的设置，如弹出框和图标。

例如：

{
  "manifest_version": 2,
  "name": "Cookie AutoDelete",
  "version": "3.5.3",
  "description": "Controls your cookies.",
  ...
  "permissions": [
    "cookies",
    "storage",
    "<all_urls>"
  ],
  "background": {
    "scripts": ["src/background.js"],
    "persistent": false
  },
  ...
}

此外，options_ui 部分指定了用户设置界面的位置：

"options_ui": {
  "page": "options.html",
  "open_in_tab": true
},

.eslintrc.json

.eslintrc.json 文件包含了ESLint的规则配置，用于保证代码风格的一致性。

package.json

这是Node.js项目常见的配置文件，包含了项目信息、依赖项和其他构建相关的脚本。例如，构建扩展的命令通常在这里定义。

{
  "name": "cookie-autodelete",
  "version": "3.5.3",
  "description": "Automatically deletes cookies when a tab closes and more!",
  ...
  "scripts": {
    "build": "webext build --overwrite-dest && npm run lint",
    "lint": "eslint --ext .js,.jsx,.json,.md src test"
  },
  ...
}

通过以上信息，您可以了解如何编译项目以及如何配置Cookie AutoDelete来满足您的需求。要实际安装到浏览器，您可能需要使用像WebExt之类的工具，或者从Firefox或Chrome的附加组件商店下载已经打包好的版本。