Cookie Reader - Chrome 扩展

一个简洁高效的 Chrome 浏览器扩展，用于快速读取和复制当前网站的 Cookie。

功能特性

• ✅ 快速读取：点击图标即可查看当前网站的所有 Cookie
• ✅ 详细信息：显示 Cookie 的名称、值、域名、路径、过期时间、安全标记等
• ✅ 多种复制格式：
  • 键值对格式：name1=value1; name2=value2
  • JSON 格式：完整的 Cookie 对象数组
  • 请求头格式：Cookie: name1=value1; name2=value2
• ✅ 搜索过滤：实时搜索 Cookie 名称或值
• ✅ 包含 HttpOnly：可以读取所有 Cookie，包括 HttpOnly Cookie
• ✅ 现代化 UI：简洁美观的界面设计

安装方法

开发模式安装

1. 下载或克隆本项目到本地
2. 打开 Chrome 浏览器，访问 chrome://extensions/
3. 在右上角开启"开发者模式"
4. 点击"加载已解压的扩展程序"
5. 选择本项目的 chromium 文件夹
6. 安装完成！扩展图标会出现在浏览器工具栏

图标准备

由于项目包含 SVG 图标源文件，你需要将其转换为 PNG 格式：

方法 1：使用在线工具

1. 访问 CloudConvert 或类似工具
2. 上传 icon.svg 文件
3. 分别生成 16x16、48x48、128x128 三种尺寸的 PNG
4. 重命名为 icon16.png、icon48.png、icon128.png
5. 放置在项目根目录

方法 2：使用命令行（需要安装 ImageMagick）

convert -background none icon.svg -resize 16x16 icon16.png
convert -background none icon.svg -resize 48x48 icon48.png
convert -background none icon.svg -resize 128x128 icon128.png

方法 3：使用 Inkscape

inkscape icon.svg --export-filename=icon16.png --export-width=16 --export-height=16
inkscape icon.svg --export-filename=icon48.png --export-width=48 --export-height=48
inkscape icon.svg --export-filename=icon128.png --export-width=128 --export-height=128

使用方法

1. 访问网站：打开任意网站（如 https://www.example.com）
2. 点击图标：点击浏览器工具栏的 Cookie Reader 图标
3. 查看 Cookie：弹出窗口会显示该网站的所有 Cookie
4. 复制 Cookie：
   • 点击"复制所有 Cookie"按钮复制键值对格式
   • 点击"复制为 JSON"按钮复制 JSON 格式
   • 点击"复制为请求头"按钮复制 HTTP Header 格式
   • 点击单个 Cookie 的"复制"按钮复制该 Cookie
5. 搜索过滤：在搜索框输入关键词，实时过滤 Cookie 列表

权限说明

本扩展需要以下权限：

• cookies：读取网站的 Cookie 信息
• activeTab：获取当前标签页的 URL
• host_permissions: <all_urls>：允许访问所有网站的 Cookie

隐私承诺：

• 所有操作都在本地完成
• 不会上传或存储任何数据
• 不会发送网络请求
• 完全开源，代码透明

Cookie 信息说明

每个 Cookie 显示以下信息：

• 名称：Cookie 的键名
• 值：Cookie 的值（完整显示，可滚动）
• 域名：Cookie 所属的域名
• 路径：Cookie 的有效路径
• 过期时间：
  • 绝对时间：2026-01-27 15:30:45
  • 会话 Cookie：会话 (浏览器关闭时过期)
• 安全标记：
  • Secure：仅通过 HTTPS 传输
  • HttpOnly：禁止 JavaScript 访问（但扩展可以读取）
  • SameSite：跨站请求策略（Strict/Lax/None）

复制格式示例

键值对格式

sessionId=abc123; userId=12345; theme=dark

JSON 格式

[
  {
    "name": "sessionId",
    "value": "abc123",
    "domain": ".example.com",
    "path": "/",
    "secure": true,
    "httpOnly": true,
    "sameSite": "Lax",
    "expirationDate": 1738000000,
    "session": false
  }
]

请求头格式

Cookie: sessionId=abc123; userId=12345; theme=dark

技术栈

• Manifest Version: V3（Chrome 最新标准）
• API: Chrome Extensions API
  • chrome.tabs - 获取当前标签页
  • chrome.cookies - 读取 Cookie
• 前端: 原生 HTML + CSS + JavaScript（无框架依赖）

兼容性

• ✅ Chrome 88+
• ✅ Edge 88+
• ✅ Brave
• ✅ 其他基于 Chromium 的浏览器

常见问题

Q: 为什么看不到某些 Cookie？ A: 扩展只显示当前域名及其子域名的 Cookie。例如访问 www.example.com，会显示 www.example.com 和 .example.com 的 Cookie。

Q: HttpOnly Cookie 可以读取吗？ A: 可以！Chrome 扩展拥有特殊权限，可以读取所有 Cookie，包括 HttpOnly Cookie。

Q: 数据会被上传吗？ A: 不会。所有操作都在本地完成，不涉及任何网络请求。

Q: 可以编辑或删除 Cookie 吗？ A: 当前版本仅支持读取和复制。编辑和删除功能可能在未来版本中添加。

开发

项目结构

chromium/
├── manifest.json          # 扩展配置
├── popup.html            # 弹出窗口 HTML
├── popup.js              # 核心逻辑
├── popup.css             # 样式文件
├── icon.svg              # SVG 图标源文件
├── icon16.png            # 16x16 图标
├── icon48.png            # 48x48 图标
├── icon128.png           # 128x128 图标
├── README.md             # 本文件
└── CLAUDE.md             # 开发文档

本地开发

1. 修改代码后，访问 chrome://extensions/
2. 点击扩展卡片上的"刷新"按钮
3. 重新打开扩展测试

许可证

MIT License

贡献

欢迎提交 Issue 和 Pull Request！

更新日志

v1.0.0 (2026-01-24)

• 首次发布
• 支持读取和复制 Cookie
• 支持三种复制格式
• 支持搜索过滤
• 现代化 UI 设计