AI 自动化书签管理器

书签栏失控的工程问题

浏览器书签栏往往在半年内从十几个条目膨胀到几百个：开发文档、设计规范、新闻源、教程混杂在一起，根目录堆满 URL，手动移动和归类成本越来越高。AI 自动化书签管理器面向这类具体痛点，用脚本直接操作 Chrome Bookmarks 的嵌套 JSON 树，把整理过程变成可预览、可回滚的工程流程。

核心能力与工作方式

读取与统一模型：read_bookmarks.py 解析 Chrome、Edge、Brave、Chromium 的 Bookmarks 文件，转换为统一数据模型，支持 macOS/Linux/Windows 对应路径。

智能创建与归组：smart_create_bookmark.py 是推荐的创建入口。它会先分析当前书签栏结构，再决定新书签放入已有目录、新建分类目录还是留在根目录。当同类型书签在书签栏中出现 ≥2 个但没有统一目录时，脚本会自动创建中文命名的新目录，把散落书签归入其中，并返回 title、url、category、confidence、placement、action 等结构化字段。

AI 分类流程：先加载 prompts/classification.md 获取分类体系，再用 read_bookmarks.py --all 读取全部书签，由 AI 直接分析列表并生成分类方案。最终组织成 write_bookmarks.py --batch 可执行的 JSON 批量操作，而不是依赖只做关键词匹配且不写回的 classify_bookmark.py --commit。

写入与清理：write_bookmarks.py 是唯一写回引擎，支持 move、delete、reorder、clean 四种操作，可在写入前自动备份并清理空文件夹。

适用边界与注意点

• 写入前必须完全退出 Chrome，否则修改会被浏览器覆盖；
• 修改和删除默认进入预览模式，需显式加 --write 或 --confirm 才落盘；
• 移动操作不会自动清理变空的旧目录，需追加 --clean-empty；
• move_in_tree() 使用 URL 前缀匹配，短 URL 可能误匹配，建议使用完整 URL；
• 分类命名遵循中文优先、层级不超过 3 级、一级分类不超过 15 个等约束，避免重复分类。