书签主页

一个本地运行的书签导航页。页面由项目自带的便携 Python 在 127.0.0.1:8765 提供服务，支持分类浏览、搜索、主题切换以及快捷方式图标联动。

外观与布局

• 8 套页面主题：极光、赛博、余烬、宣纸、星海、幻彩、墨金、深海。
• 3 种卡片布局：标准、紧凑、列表。
• 8 种网站图标风格，以及悬浮、呼吸、流光、静止 4 种图标动效。
• 所有选择都会保存在浏览器本地；关闭“动态效果”后会同时停用背景和图标动画。

快速使用

Windows

• 项目已包含 64 位便携 Python 3.13.13，不需要在电脑上另行安装 Python。
• 首次使用或移动项目后，双击 launchers/windows/shortcut.bat 生成根目录和桌面的“书签”快捷方式。
• 双击根目录的 书签.lnk：隐藏启动本地服务并打开页面，不会自动同步浏览器书签，也不会弹出控制台。
• 双击 launchers/windows/sync-chrome.bat：手动把当前 Chrome 活动账号的书签同步到页面。
• 双击 launchers/windows/sync-edge.bat：手动把当前 Edge 活动账号的收藏夹同步到页面。
• 双击 launchers/windows/replace.bat：选择一个 Chrome 导出的 HTML 文件并替换书签源数据。
• launchers/windows/start.bat：用于排查启动问题，会保留控制台窗口并显示错误。

macOS

• 双击 launchers/macos/open.command 或 launchers/macos/Bookmark.app 打开页面。
• 双击 launchers/macos/sync-chrome.command：手动把当前 Google Chrome 账号的书签同步到页面。
• 双击 launchers/macos/sync-safari.command：手动把 Safari 书签同步到页面。
• launchers/macos/replace.command 用于导入书签 HTML。

目录结构

Bookmark/
├─ 书签.lnk                 Windows 日常入口
├─ README.md                项目说明
├─ web/                     网页文件
│  ├─ index.html            页面、样式和交互
│  ├─ data.example.js       公开的示例书签数据
│  └─ data.js               本地生成的私人书签数据（Git 忽略）
├─ data/                    书签源数据
│  ├─ bookmarks.example.html 公开的示例书签
│  └─ bookmarks.html        本地私人书签（Git 忽略）
├─ assets/
│  └─ icons/                快捷方式和应用图标
├─ runtime/
│  └─ python/               Windows 便携 Python 运行时
├─ scripts/                 Python 管理脚本
│  ├─ manage.py             构建数据、同步 Chrome/Edge/Safari、启动服务
│  ├─ shortcut.py           创建快捷方式并更新图标
│  └─ _make_icons.py        生成图标资源
└─ launchers/
   ├─ windows/              Windows 启动、同步和导入脚本
   └─ macos/                macOS 启动器和应用包

数据流程

本地书签数据：

data/bookmarks.html → scripts/manage.py → web/data.js → web/index.html

如果本地不存在 data/bookmarks.html，构建脚本会读取公开的 data/bookmarks.example.html。页面始终先加载 web/data.example.js，存在本地生成的 web/data.js 时再用它覆盖示例数据。

Chrome 手动同步：

Chrome 当前活动 Profile 的 AccountBookmarks/Bookmarks
    → scripts/manage.py --sync-chrome
    → data/bookmarks.html
    → web/data.js

Chrome 新版本登录账号后的书签通常保存在 AccountBookmarks，旧版本或本地书签保存在 Bookmarks。脚本会优先读取当前活动 Profile 的 AccountBookmarks。

Edge 手动同步使用相同流程，从当前活动 Profile 的 AccountBookmarks/Bookmarks 读取收藏夹，并通过 scripts/manage.py --sync-edge 更新本地页面。

macOS 上 Chrome 同步会读取 ~/Library/Application Support/Google/Chrome 中的当前 Profile；Safari 同步会读取 ~/Library/Safari/Bookmarks.plist。Safari 数据受 macOS 隐私保护，首次同步时可能需要在系统设置中允许 Terminal 访问。

常用命令

在项目根目录运行：

# 从 data/bookmarks.html 重新生成页面数据
runtime\python\python.exe -X utf8 scripts/manage.py --build

# 手动同步当前 Chrome 活动账号的书签
runtime\python\python.exe -X utf8 scripts/manage.py --sync-chrome --build

# 手动同步当前 Edge 活动账号的收藏夹
runtime\python\python.exe -X utf8 scripts/manage.py --sync-edge --build

# 创建或修复 Windows 快捷方式
runtime\python\python.exe -X utf8 scripts/shortcut.py

# 启动本地服务并打开页面
runtime\python\python.exe -X utf8 scripts/manage.py

注意事项

• data/bookmarks.html 和 web/data.js 包含私人书签，已被 Git 忽略，不能使用 git add -f 强制提交。
• web/data.js 是本地生成文件，不建议手工编辑；公开示例位于 data/bookmarks.example.html 和 web/data.example.js。
• 普通打开“书签”快捷方式或 Bookmark.app 不会同步浏览器；只有执行对应的手动同步脚本或命令时才会更新。
• Bookmark.app 每次打开都会使用当前的 UI 和 web/data.js；如果书签源文件更新较晚，会先重新生成页面数据。
• 手动同步只读取浏览器本机缓存，不会修改浏览器内的书签；同步结果会覆盖 data/bookmarks.html 并保留为下次打开时的本地快照。
• 页面默认端口是 8765。
• Windows 启动脚本统一使用 runtime/python/python.exe，隐藏启动使用同目录的 pythonw.exe。
• 便携运行时适用于 64 位 Windows，并包含项目所需的 Pillow；macOS 仍使用系统的 python3。