90 lines
5.1 KiB
Markdown
90 lines
5.1 KiB
Markdown
# Cookie Extract (Browser Extension)
|
||
|
||
[](https://addons.mozilla.org/zh-CN/firefox/addon/cookie-extract/) <!-- 在发布后替换 Firefox 链接 -->
|
||
[](https://chrome.google.com/webstore/detail/your-chrome-store-id) <!-- 在发布后替换 Chrome 链接 -->
|
||
[](https://microsoftedge.microsoft.com/addons/detail/your-edge-store-id) <!-- 在发布后替换 Edge 链接 -->
|
||
[](https://opensource.org/licenses/MIT) <!-- 如果你使用 MIT 协议 -->
|
||
|
||
一个简单的浏览器扩展，适用于 **Firefox, Chrome, 和 Edge**，可以帮助你快速提取和复制当前标签页中的 SESSION cookie 以及响应头中的 `Set-Cookie` 值。
|
||
|
||
## 功能
|
||
|
||
- **提取 SESSION Cookie:** 查找并显示当前页面域下的 `SESSION` cookie 值。
|
||
- **提取 Header Cookies:** 捕获并显示当前页面主文档（HTML）加载时的 `Set-Cookie` 响应头。
|
||
- **一键复制:** 提供单独的按钮，方便地将 `SESSION` cookie 或所有 Header Cookies 复制到剪贴板。
|
||
- **清晰展示:** 在扩展弹出窗口中清晰地列出提取到的 Cookie 信息。
|
||
|
||
## 安装方法
|
||
|
||
### 方式一：从官方商店 (推荐)
|
||
|
||
- Firefox:
|
||
1. 访问 [Cookie Extract on Firefox Add-ons](https://addons.mozilla.org/zh-CN/firefox/addon/cookie-extract/) <!-- 在发布后替换这里的链接 -->
|
||
2. 点击 "添加到 Firefox" 按钮。
|
||
- Chrome:
|
||
1. 访问 [Cookie Extract on Chrome Web Store](https://chrome.google.com/webstore/detail/your-chrome-store-id) <!-- 在发布后替换这里的链接 -->
|
||
2. 点击 "添加到 Chrome" 按钮。
|
||
- Microsoft Edge:
|
||
1. 访问 [Cookie Extract on Microsoft Edge Add-ons](https://microsoftedge.microsoft.com/addons/detail/your-edge-store-id) <!-- 在发布后替换这里的链接 -->
|
||
2. 点击 "获取" 按钮。
|
||
|
||
### 方式二：从源代码 (用于开发或测试)
|
||
|
||
1. 下载或克隆此仓库到本地文件夹。
|
||
2. 对于 Firefox:
|
||
- 打开 Firefox 浏览器。
|
||
- 在地址栏输入 `about:debugging#/runtime/this-firefox` 并回车。
|
||
- 点击 "加载临时附加组件..." 按钮。
|
||
- 导航到你保存扩展代码的文件夹，选择 `manifest.json` 文件并打开。
|
||
3. 对于 Chrome:
|
||
- 打开 Chrome 浏览器。
|
||
- 在地址栏输入 `chrome://extensions` 并回车。
|
||
- 确保右上角的 "开发者模式 (Developer mode)" 开关已启用。
|
||
- 点击左上角的 "加载已解压的扩展程序 (Load unpacked)" 按钮。
|
||
- 导航并选择包含扩展代码的**文件夹** (包含 `manifest.json` 的那个文件夹)，然后点击 "选择文件夹"。
|
||
4. 对于 Microsoft Edge:
|
||
- 打开 Edge 浏览器。
|
||
- 在地址栏输入 `edge://extensions` 并回车。
|
||
- 确保左下角的 "开发人员模式 (Developer mode)" 开关已启用。
|
||
- 点击 "加载解压缩的扩展 (Load unpacked)" 按钮。
|
||
- 导航并选择包含扩展代码的**文件夹** (包含 `manifest.json` 的那个文件夹)，然后点击 "选择文件夹"。
|
||
|
||
## 使用方法
|
||
|
||
1. 导航到你想要提取 Cookie 的网页。
|
||
2. 点击浏览器工具栏中的 "Cookie Extract" 图标（通常是一个小饼干或者你设置的图标）。
|
||
3. 扩展的弹出窗口将会显示：
|
||
- 当前页面的 `SESSION` cookie (如果存在)，格式为 `SESSION=xxx`。
|
||
- 页面加载时响应头中的所有 `Set-Cookie` 值列表 (如果存在)。
|
||
4. 点击对应的 "复制" 按钮，将所需信息复制到剪贴板。
|
||
|
||
## 权限说明
|
||
|
||
为了正常工作，此扩展需要以下权限：
|
||
|
||
- `cookies`: 读取当前标签页域下的 Cookie (用于获取 SESSION cookie)。
|
||
- `activeTab`: 允许扩展在用户点击图标时访问当前激活的标签页信息（如 URL），这是获取特定标签页 Cookie 和 Header 的安全方式。
|
||
- `webRequest`: 访问网络请求数据，特别是需要读取服务器响应头 (`Set-Cookie`)。
|
||
- `<all_urls>` 或特定主机权限 (例如 `*://*.example.com/*`): `cookies` 和 `webRequest` 权限需要指定作用域。`activeTab` 可以在用户交互时临时授权，但 `webRequest` 通常需要更明确的权限声明才能捕获后台请求的头信息。请根据你的 `manifest.json` 文件确认实际使用的权限。
|
||
- `clipboardWrite`: 将提取到的 Cookie 文本写入用户的剪贴板。
|
||
|
||
*注意：这些权限在 Firefox, Chrome, 和 Edge 上的功能类似。*
|
||
|
||
## 隐私政策
|
||
|
||
本扩展完全在你的本地浏览器中运行。它不会收集、存储或传输任何你的浏览数据或 Cookie 信息到任何外部服务器。所有处理都在本地完成。
|
||
|
||
## 图标替换说明
|
||
|
||
如果你是从源代码构建，可以替换 `images` 文件夹中的图标文件：
|
||
|
||
- `icon16.png` (16x16 像素)
|
||
- `icon48.png` (48x48 像素)
|
||
- `icon128.png` (128x128 像素)
|
||
|
||
你可以使用在线工具如 [Favicon Generator](https://favicon.io/) 来创建这些图标。
|
||
|
||
## 贡献 & 问题反馈
|
||
|
||
欢迎提出 Issue 或 Pull Request 来改进这个扩展！
|