BarbarianLoot/cookie-log-manager

## 🎬 概述 **cookie-log-manager** 源于一个周末的突发奇想。我总是因为浏览器重启、扩展更新和配置文件切换而丢失会话状态 —— 而我试过的每一款“cookie 查看器”要么过于臃肿，要么充满广告，要么根本不是为这项任务设计的。因此，我开发了自己真正想要的工具：一款轻量级、独立的 Windows 应用程序，它能实时记录 cookie 活动，为每次更改打上时间戳，并允许您随时重播或导出历史记录。 这是一个**充满热情的项目**，而非企业的商业规划。每一个功能的出现都是因为我个人遇到了痛点并决定解决它。这意味着代码库始终保持精简，UI 界面保持真诚，并且除非您明确要求，否则程序绝对不会向外发送任何数据。如果您是正在调试会话持久化的开发者、追踪间歇性认证 Bug 的 QA 测试员，或者仅仅是一个好奇、想*看看*浏览器底层运行情况的技术折腾客 —— 这款工具就是为您准备的。 它的名字已经说明了一切：它是一个**用于 cookie 的日志管理器**。它不是抓取器，不是修改工具，更没有任何暗箱操作 —— 它只是通过一个尊重您时间的界面，为您提供干净、结构化且带有时间戳的 cookie 生命周期事件视图。

## 🧠 核心功能 - **实时捕获引擎** —— 监视实时的 cookie 写入、更新和过期事件，并将它们以可读的时间线形式流式呈现，而不是直接导出一堆杂乱的 JSON 数据。 - **会话快照** —— 随时冻结特定时刻的 cookie 状态，并以 diff（差异）视图的方式与之后的快照进行并排对比。 - **智能过滤** —— 无需编写任何查询语句，即可按域名、会话 ID、过期时间窗口或 secure/HTTP-only 标志对日志进行切片筛选。 - **本地优先存储** —— 每一条日志都保存在您机器本地由 SQLite 支持的文件中。除非*您*主动导出，否则任何数据都不会离开您的设备。 - **导出流水线** —— 一键将过滤后的日志导出为 CSV 或 JSON 格式，可直接用于电子表格、Bug 报告或与队友共同进行的调试环节。 - **标签与注释** —— 为特定的日志条目添加备注，以便未来的您还记得该 cookie 当初*为什么*重要。 - **多配置文件感知** —— 跟踪每个浏览器配置文件的活动，因此在五个不同账户间进行测试时，不会演变成一团糟的纠缠。 - **搜索即输入** —— 快速的内存索引意味着搜索数千条记录的体验是瞬时的，毫无卡顿感。 ## 🚀 快速开始 1. **访问主页。** 点击上方的下载按钮 —— 这是唯一的官方下载源。 2. **下载安装包。** 无需解压任何压缩包，无需四处寻找依赖项 —— 仅需一个可执行文件。 3. **运行程序。** Windows 可能会针对新工具弹出 SmartScreen 提示；请点击“更多信息 → 仍要运行”。 4. **连接到您的浏览器。** 新手引导向导将指导您启用日志记录桥接 —— 整个过程不到一分钟。 ## 🖥️ 系统要求 | 要求 | 详情 | |---|---| | **操作系统** | Windows 10 (64 位) 或 Windows 11 | | **依赖项** | 无 —— 完全独立运行，无需安装额外的运行时 | | **磁盘空间** | 安装后约占用 45 MB | | **内存 (RAM)** | 典型占用 150 MB，在密集记录日志时占用低于 300 MB | | **浏览器支持** | 基于 Chromium 和基于 Firefox 的浏览器 | | **网络连接** | 下载完成后无需联网 |    ## ⚙️ 工作原理 **cookie-log-manager** 会在您的浏览器旁运行一个小型的本地桥接进程。它不会向网页中注入任何内容 —— 它只是监听浏览器自身的调试协议所暴露的 cookie 存储事件，然后将其接收到的信息结构化。 1. **桥接进程连接**到浏览器的本地调试端点。 2. cookie 写入/更新/过期事件的**事件流**持续涌入。 3. **解析器将**每个事件标准化为结构化的日志条目。 4. **本地数据库**存储带有时间戳和元数据的条目。 5. **UI 渲染出**时间线，随时可供过滤、打标签和导出。 ``` flowchart LR Browser --> Bridge Bridge --> Parser Parser --> Database Database --> Timeline ``` ## 🔧 故障排除

桥接进程无法连接到我的浏览器。

请确保您的浏览器是在 cookie-log-manager *之后*启动的，并且没有其他调试工具已经连接到同一个端口。如果不确定，请重启这两者。

日志在会话中途停止更新了。

这通常是因为在运行期间浏览器进行了更新。请从工具栏重新连接桥接进程 —— 无需重启应用程序。

尽管能看到日志，但导出的文件是空的。

请检查您当前激活的过滤器 —— 导出操作会严格遵守当前应用的过滤条件。在导出完整日志之前，请先清除所有过滤器。

Windows 拦截/标记了安装程序。

对于未签名的小型工具来说这是正常现象。请核对主页上列出的哈希值，然后允许其通过 SmartScreen 拦截。

我能在 macOS 或 Linux 上运行它吗？

目前不行 —— 此版本仅适用于 Windows 10/11。跨平台支持是我们讨论过的未来方向，但目前不作任何承诺。

## 🎨 UI、UX 与快捷键 主题：**Midnight**、**Paper** 和 **High Contrast** —— 可从“设置 → 外观”中即时切换，无需重启。 设置以本地、按用户的方式进行持久化，因此同一台计算机上的多个 Windows 账户可以保留各自独立的偏好设置。 | 快捷键 | 操作 | |---|---| | `Ctrl + N` | 开启新的日志记录会话 | | `Ctrl + S` | 保存当前快照 | | `Ctrl + F` | 聚焦到搜索栏 | | `Ctrl + E` | 导出已过滤的日志 | | `Ctrl + Shift + C` | 清除所有已激活的过滤器 | | `Ctrl + T` | 切换主题 | | `Ctrl + ,` | 打开设置 | | `F5` | 刷新实时捕获视图 | | `Ctrl + Q` | 退出应用程序 | ## 📜 许可协议 采用 [MIT License](LICENSE) 发布，2026 年。 随意使用、复刻（fork）、二次开发 —— 只需保留许可协议声明即可。 ## ⚠️ 免责声明 **cookie-log-manager** 是一个个人独立维护的项目，按“原样”提供，不提供任何形式的保证。本工具仅供出于合法的调试、测试以及个人会话管理目的使用。您有责任确保遵守与其配合使用的任何浏览器或网站的服务条款。

标签：Cookie管理, SOC Prime, 会话调试, 后端开发, 多人体追踪, 开发工具, 桌面应用, 浏览器调试