Chrome Tab Group Cleaner Vibe 项目
专为 Claude Code 用户打造的 Chrome 标签组批量清理工具
Chrome Tab Group Cleaner 是一款专为 Claude Code 用户打造的 Chrome 标签组批量清理工具。当 Claude Code 在项目中持续运行时,它会在 Chrome 中留下大量以项目名命名的标签组,久而久之积累数十乃至上百个,用户只能逐个右键删除,苦不堪言。Chrome 本身并未提供批量操作接口,这款工具正是为解决这一痛点而生。
核心功能
批量删除标签组
支持按多种条件筛选要删除的标签组:全部删除、按名称匹配(支持正则表达式)、仅删除 Claude 相关标签组、或仅清理孤立的孤立标签项。用户只需一条命令即可完成传统方式需要数十次操作才能完成的工作。
多浏览器与多配置文件支持
兼容 Chrome、Chromium、Brave、Edge 等基于 Chromium 内核的浏览器;支持指定配置文件目录或扫描本机所有配置文件,一次清理多台设备的混乱状态。
安全机制
每次删除操作都会自动对整个标签组存储数据库进行完整备份,备份文件保存于用户目录下的 .chrome-tab-group-cleaner/backups/ 目录中。一旦误删,用户可随时通过 restore 命令从指定备份文件恢复,撤回成本几乎为零。删除前默认执行预演模式(dry-run),仅展示即将删除的内容而不实际动手,用户确认无误后再正式执行。
Claude Code Skill 形式交付
该工具以 Claude Code Skill 的形式交付,用户将其克隆到 ~/.claude/skills/ 目录下并完成构建后,只需向 Claude Code 说一句「帮我清理掉所有 Claude 相关的标签组」,Claude Code 便会自动调用该 Skill 执行清理任务,全程无需用户手动输入命令。对于安全意识较强的用户,工具还提供了「先让 agent 阅读源代码再决定是否安装」的审慎安装流程,agent 会检查源码中的潜在风险,若发现问题会主动停止并报告。
与 Chrome Sync 的兼容处理
当 Chrome 账号开启了标签组同步功能时,工具的行为会稍有不同:直接删除操作会被 Chrome 重新下载恢复。对于这种情况,工具提供了 --sync-tombstone 参数,将删除标记为「已同步删除」,从而在同步层面完成清除,不过该功能在不同 Chrome 构建版本上的表现尚未经过真实账号验证,最坏情况是标签组重新出现。
技术实现
底层存储直接读取
Chrome 的标签组数据保存在用户配置文件目录下的 Sync Data/LevelDB 数据库中,格式为 LevelDB 的键值对存储,键名前缀为 saved_tab_group-dt-,每个键对应一条包含标签组元信息(创建时间、标题、颜色、位置)和该组下所有标签详情(URL、标题)的二进制数据。工具的 src/proto.ts 模块直接读取这一二进制格式,无需依赖任何外部 protobuf 库,实现了对 Chrome 内部数据结构的精确解析。
标签组与孤立标签的分离处理
Chrome 删除标签组时,如果只删除组实体而保留各标签,这些标签会变成「孤儿」状态残留在数据库中,与手动逐个关闭标签组的体验一致。工具内置了 --orphans 参数专门清理这类孤立标签,确保数据库不留残余。
依赖极简
仅需 Node.js 20 及以上版本运行时,无其他外部依赖。构建产物经过 gates 检查(类型检查、代码风格检查、测试、构建),测试用例直接构造真实 LevelDB 存储进行读写验证,不使用任何模拟对象。
快速上手
第一步,克隆仓库到 Claude Code 的 skills 目录:
git clone https://github.com/franzenzenhofer/chrome-tab-group-cleaner.git
~/.claude/skills/chrome-tab-group-cleaner
第二步,进入目录并安装依赖、构建:
cd ~/.claude/skills/chrome-tab-group-cleaner && npm install && npm run build
第三步,查看当前所有配置文件中的标签组:
node dist/cli.js list --all-profiles -v
第四步,预演删除 Claude 相关标签组:
node dist/cli.js delete --claude --dry-run
第五步,确认无误后执行正式删除并重启浏览器:
node dist/cli.js delete --claude --orphans --restart
适用人群
使用 Claude Code 进行开发工作的程序员,特别是同时处理多个项目、长期不关浏览器的开发者;需要维护多台开发机器标签组一致性的 DevOps 工程师;以及任何积累了大量 Chrome 标签组、深受手动清理之苦的用户。该工具以 MIT 协议开源,完全免费使用。
评论与建议
登录 后参与评论或提建议