AI-Powered Intelligent Bookmark Manager for Chrome & Edge
Smart Bookmark 是一个基于 Chrome/Edge 扩展的智能书签管理插件,设计目标是让书签收藏、搜索和跨设备同步更加智能、轻量和可维护。
扩展核心能力包括:AI 自动标签与摘要生成、语义化书签搜索、层级标签结构、WebDAV 同步、以及轻量本地存储策略。
- AI 自动标签生成:收藏网页时自动生成语义标签,减少手动分类成本
- 语义搜索:基于向量嵌入的语义搜索,支持自然语言查询
- AI 生成摘要:自动为书签生成摘要,快速预览页面内容
- 多级标签与层级展示:支持层级标签树、智能归类和标签筛选
- WebDAV 同步:支持用户自定义 WebDAV 服务器,实现跨设备书签同步
- 快捷键支持:
Ctrl/Cmd + K为快速搜索,Ctrl/Cmd + B为快速收藏 - 本地数据存储:书签和缓存信息存储于浏览器本地,保护用户隐私
- 层级书签展示视图(树形结构、标签筛选、拖拽宽度调整)
- 自定义筛选规则与过滤器
- 批量选择、编辑与删除书签
- 书签导入与导出
- 多 AI 服务支持:OpenAI、通义千问、智谱 GLM、Ollama、本地自定义 API
- 支持浅色/深色主题
Smart Bookmark 基于 Chrome 扩展 Manifest V3 架构设计,主流程使用 Service Worker 作为后台入口,前端通过 Popup、Side Panel、设置页和内容脚本与后台通信。
graph TD
User[用户]
QuickSave[快速收藏 Popup<br/>quickSave.html]
SidePanel[侧边栏主界面<br/>popup.html]
QuickSearch[快速搜索<br/>quickSearch.html]
Settings[设置页面<br/>settings.html]
Background[Service Worker<br/>background.js]
ContentScript[Content Script<br/>versionCheck.js]
Storage[本地存储<br/>chrome.storage.local]
AI[AI 服务层<br/>api.js]
Sync[同步层<br/>autoSync.js / webdavSync.js]
Search[搜索引擎<br/>search.js]
Model[数据模型与常量<br/>models.js / consts.js]
User -->|打开插件| QuickSave
User -->|打开侧边栏| SidePanel
User -->|快捷键| QuickSearch
User -->|打开设置| Settings
QuickSave -->|消息| Background
SidePanel -->|消息| Background
QuickSearch -->|消息| Background
Settings -->|消息| Background
Background -->|读写| Storage
Background -->|请求标签/摘要/嵌入| AI
Background -->|调度同步| Sync
QuickSearch -->|搜索逻辑| Search
Search -->|访问书签| Storage
Search -->|获取向量| AI
Background -->|数据模型| Model
manifest.json:扩展入口、权限、快捷键、侧边栏与选项页配置background.js:Service Worker,负责消息分发、存储访问、同步调度与全局运行时逻辑api.js:AI 接口层,封装多种 AI 服务、Embedding 请求、标签/摘要生成逻辑storageManager.js:封装 Chrome Storage 读写、书签缓存、增删改查与变更通知search.js:语义搜索与关键词匹配,负责计算相似度、结果评分与排序autoSync.js:自动同步调度与闹钟管理webdavSync.js:WebDAV 同步实现层settingsManager.js/syncSettingManager.js:配置读取、验证与持久化models.js:书签数据模型定义、版本字段与兼容性处理consts.js:消息类型、默认参数与功能开关logger.js:统一日志输出接口i18n.js:国际化文本支持build.py/build.sh:打包与发布辅助脚本
flowchart TD
A[用户点击收藏 / Ctrl+B]
B[quickSave.html / quickSave.js]
C[background.js]
D[api.js: 标签 + 摘要 + Embedding]
E[storageManager.js]
F[autoSync.js / webdavSync.js]
G[chrome.storage.local]
A --> B
B --> C
C --> D
D --> E
E --> G
E --> C
C -->|通知更新| B
E --> F
F -->|同步数据| G
flowchart TD
U[用户输入搜索词]
S[quickSearch.html / search.js]
V[searchHistoryManager]
W[api.js 获取查询向量]
B[storageManager.js 本地书签]
R[search.js 计算相似度]
O[展示搜索结果]
U --> S
S --> V
V -->|若无缓存| W
W --> R
B --> R
R --> O
flowchart TD
T[Chrome Alarm 定时触发]
A[autoSync.js]
C[syncSettingManager.js]
W[webdavSync.js]
L[chrome.storage.local]
B[background.js]
T --> A
A --> C
C --> W
W --> L
L --> B
B -->|通知 UI 更新| QuickSave
quickSave.html/quickSave.js:快速收藏弹窗popup.html/popup.js:侧边栏主界面quickSearch.html/quickSearch.js:快速搜索弹窗settings.html/settings.js:设置页面intro.html/intro.js:新用户引导页面
background.js:Service Worker 执行入口contentScript.js:页面脚本注入(本项目当前仅用于本地测试域名)versionCheck.js:版本检查脚本
api.js:AI 服务适配、Embedding 调用、标签与摘要生成storageManager.js:数据存储、书签 CRUD、缓存策略、消息通知search.js:搜索逻辑、向量相似度、关键词排序autoSync.js:自动同步调度、定时闹钟管理webdavClient.js/webdavSync.js:WebDAV 请求与数据同步实现settingsManager.js/syncSettingManager.js:配置读取、验证和同步models.js:统一书签数据模型定义consts.js:核心常量与功能开关定义logger.js:日志封装i18n.js:国际化文本支持util.js:公共工具函数config.js/env.json:本地环境与 API Key 配置build.py/build.sh:构建与打包脚本
- 克隆项目:
git clone https://github.com/howoii/SmartBookmark.git
cd SmartBookmark-
打开浏览器扩展页面:
- Chrome:
chrome://extensions/ - Edge:
edge://extensions/
- Chrome:
-
开启「开发者模式」,点击「加载已解压的扩展程序」,选择项目根目录。
- 修改代码后,在扩展页面点击
刷新 - Service Worker 修改需要重新加载扩展
- 使用浏览器开发者工具查看
logger.debug/info/error日志
- 复制
env.json并填写你的 AI API Key - 将
env.json保持为本地私密文件,不要提交到仓库
- Popup 页面:右键插件图标 → 检查
- Service Worker:扩展页面 → Service Worker → 检查
- 设置页和快速搜索页面同样可在控制台调试
# 手动打包
# 1. 删除 env.json 或确保敏感信息不包含在发布包中
# 2. 将项目目录压缩为 zip
# 3. 上传到 Chrome Web Store / Edge Add-ons- 所有浏览器存储访问集中在
storageManager.js - 使用
async/await保持异步逻辑清晰 - 使用
logger.debug/info/error统一日志风格 - 界面与业务逻辑分离,UI 页面通过消息与后台交互
- 使用
tagVersion管理数据模型变更与兼容性
api.js:多 AI 服务支持、Embedding 批量分批、token 估算search.js:混合语义搜索与关键词匹配、余弦相似度评分autoSync.js:通过chrome.alarms调度同步任务storageManager.js:本地缓存、消息广播、写入通知与防抖更新
manifest.json中声明:action.default_popup = quickSave.htmlside_panel.default_path = popup.htmloptions_page = settings.html- 权限:
tabs,storage,activeTab,scripting,sidePanel,bookmarks,unlimitedStorage,favicon,alarms - 快捷键:
quick-search,quick-save omnibox关键词:sb
欢迎任何开发者参与贡献。
- Fork 本仓库
- 新建分支:
git checkout -b feature/your-feature- 提交修改:
git commit -m "feat: 描述新增功能"- 推送分支并创建 Pull Request
feat:新功能fix:Bug 修复docs:文档更新refactor:代码重构style:代码格式调整test:测试相关
- GitHub Issues:https://github.com/howoii/SmartBookmark/issues
- 请提供复现步骤、浏览器版本、截图或日志
- OpenAI:
GPT-3.5-turbo,GPT-4,GPT-4-turbo - 通义千问:
qwen-turbo,qwen-plus,qwen-max - 智谱 GLM:
glm-3-turbo,glm-4 - Ollama:本地模型(如
llama2,mistral) - 自定义 API:兼容 OpenAI API 格式
- 书签数据存储在浏览器本地(
chrome.storage.local) - WebDAV 同步时,仅与用户配置的服务器交互
- 不会默认上传到第三方服务器
- 语义搜索依赖 Embedding API
- AI 标签与摘要生成需要模型调用
- 你也可以选择使用本地 Ollama 模型,减少云服务依赖
- 打开主界面
- 点击右上角菜单
- 选择「导出书签」
- 支持 JSON / HTML 格式
- 插件本体:约 2MB
- 书签数据大小与数量相关,1000 个书签(含向量)约 10-20MB
- 已申请
unlimitedStorage权限,可支持大规模书签存储
- 查看 README FAQ 是否已覆盖
- 在 GitHub Issues 搜索相关问题
- 如果问题未解决,请提交新 Issue
- GitHub Issues:https://github.com/howoii/SmartBookmark/issues
- Email:yz0917@foxmail.com
感谢所有参与贡献的开发者与用户,欢迎 Fork、优化与扩展本项目。
本项目采用 MIT 协议 开源。
欢迎自由使用、修改和分发,但请保留原作者信息。
如果这个项目对你有帮助,欢迎 ⭐ Star 支持一下!








