云书签
云书签是 BookmarkSync 的核心功能之一，允许用户将书签保存在云端而不占用浏览器书签栏空间。
功能概述
云书签提供了一个独立于浏览器书签栏的书签存储空间：
- 云端存储：书签保存在云端服务器，不占用浏览器书签栏
- 多设备同步：使用同一账号登录的设备自动同步云书签
- 分类管理：支持树形分类结构，可创建多级文件夹
- 快速搜索：支持按标题和网址搜索书签
- 拖拽排序：可自定义书签和分类的显示顺序
- 批量管理：支持批量移动、删除书签
使用场景
云书签适合以下使用场景：
- 备用网址保存：不常用但需要保留的网站
- 资源收藏：学习资料、教程、工具站等收藏
- 项目资源：按项目分类保存相关网站链接
- 书签栏瘦身：将低频访问的书签移至云端，保持书签栏简洁
- 跨设备访问：在任何设备上都能访问完整的书签库
如何使用
访问云书签
- 点击浏览器工具栏的 BookmarkSync 扩展图标
- 在主页选择"云书签"卡片
- 自动打开云书签管理页面
添加云书签
方式一：手动添加
- 在云书签管理页面点击右上角"添加书签"按钮
- 填写书签信息：
- 标题：网站名称或自定义标题
- 网址：完整的 URL 地址
- 选择所属分类（可选）
- 点击确认保存
方式二：快速添加当前页面
- 在扩展 Popup 中选择"云书签"模块
- 点击"添加当前页面"（如果提供此功能）
- 自动获取当前标签页的标题和网址
- 确认后保存
分类管理
云书签支持树形分类结构，可以创建多级文件夹组织书签。
创建分类：
- 点击右上角"添加分类"按钮
- 输入分类名称
- 选择父分类：
- 留空则创建为顶级分类
- 选择已有分类则创建为其子分类
- 点击确认创建
编辑分类：
- 点击"更多"下拉菜单，选择"分类编辑"
- 在分类编辑界面可以：
- 重命名分类
- 删除分类（需确认，会同时删除该分类下的所有书签）
- 调整分类层级关系
切换分类：
- 点击左侧分类树中的任意分类
- 右侧内容区会显示该分类下的所有书签
- 支持展开/折叠多级分类
书签操作
查看书签：
- 左侧分类树选择分类
- 右侧以卡片形式展示该分类下的书签
- 每个书签卡片显示：网站图标、标题、网址
打开书签：
- 点击书签卡片的标题或网址区域
- 在新标签页中打开该网址
编辑书签：
- 点击书签卡片右侧的"操作"按钮
- 选择"编辑"
- 可修改标题或网址
- 点击确认保存
移动书签：
- 点击书签卡片的"操作"按钮
- 选择"移动"
- 在弹出的分类选择器中选择目标分类
- 确认移动
删除书签：
- 点击书签卡片的"操作"按钮
- 选择"删除"
- 确认删除操作（不可恢复）
排序功能
书签排序：
- 点击右上角"更多"下拉菜单
- 选择"书签排序"
- 进入排序模式，书签卡片变为可拖拽状态
- 拖动书签卡片调整顺序
- 点击"保存"按钮确认新顺序
分类排序：
- 在"分类编辑"界面
- 拖拽分类节点调整顺序或层级
- 保存修改
搜索功能
- 在顶部搜索框输入关键词
- 支持搜索：
- 书签标题
- 网址内容
- 点击"搜索"按钮或按回车键
- 显示匹配的书签列表
- 点击"清空"按钮或删除关键词恢复全部书签
分页浏览
- 当书签数量较多时，自动分页显示
- 底部显示分页控件
- 可切换到不同页码查看更多书签
与浏览器书签的区别
| 特性 | 浏览器书签 | 云书签 |
|---|---|---|
| 存储位置 | 浏览器本地 + 浏览器同步服务 | BookmarkSync 云端 |
| 占用书签栏 | 是 | 否 |
| 访问方式 | 浏览器书签栏/管理器 | 扩展页面 |
| 同步要求 | 需要 Google 账号（Chrome） | 仅需 BookmarkSync 账号 |
| 存储限额 | 浏览器限制 | 1000条（免费额度） |
| 适用场景 | 高频访问的网站 | 低频但需保留的网站 |
与私密书签的区别
| 特性 | 云书签 | 私密书签 |
|---|---|---|
| 访问限制 | 登录即可访问 | 需要二次密码验证 |
| 安全级别 | 标准加密 | 增强加密 + 密码保护 |
| 使用场景 | 一般收藏 | 敏感/隐私内容 |
| 访问便利性 | 高 | 中（需输入密码） |
存储额度说明
- 免费额度：1000条书签（不包括分类文件夹本身）
- 共享配额：云书签和私密书签共享1000条额度
- 计数规则：
- 每个书签链接计为1条
- 分类文件夹不计入额度
- 额度查看：在设置页面可查看当前已使用的额度
- 超额处理：超过1000条后无法继续添加新书签
数据同步
自动同步
- 登录账号后，云书签数据自动与云端保持同步
- 添加、编辑、删除操作实时上传到云端
- 多设备间自动同步更新
同步状态
扩展会显示同步状态：
- 正常：数据已同步
- 同步中：正在上传或下载数据
- 冲突：检测到数据冲突（需手动处理）
- 网络中断：无法连接到服务器
冲突处理
当多设备同时修改同一书签时可能产生冲突：
- 扩展会提示数据冲突
- 可选择保留本地版本或云端版本
- 或手动合并两个版本的内容
数据安全
- 加密传输：所有数据通过 HTTPS 加密传输
- 加密存储：数据在云端加密存储
- 密钥隔离：加密密钥与数据分开存储
- 隐私保护：管理员无法查看用户的书签内容
常见问题
Q: 云书签和浏览器书签会冲突吗？
A: 不会。云书签是独立的存储空间，不会影响浏览器自带的书签功能。两者可以同时使用。
Q: 可以将浏览器书签导入到云书签吗？
A: 当前版本暂不支持批量导入功能。可以手动将常用书签添加到云书签，或等待未来版本提供导入功能。
Q: 云书签可以导出吗？
A: 当前版本暂不支持导出功能。如需备份，建议定期截图保存书签列表。
Q: 删除的云书签可以恢复吗？
A: 目前不支持回收站功能，删除的书签无法恢复。删除前请谨慎确认。
Q: 云书签的图标是如何获取的？
A: 扩展会自动从网站的 favicon 获取图标。如果网站没有设置图标，则显示默认的链接图标。
Q: 为什么我的云书签加载很慢？
A: 可能原因：
- 网络连接不稳定
- 书签数量过多（接近1000条）
- 服务器响应较慢
建议检查网络连接，或尝试刷新页面。
Q: 云书签会占用浏览器性能吗？
A: 不会。云书签数据存储在云端，只在打开管理页面时才加载，不会影响浏览器日常使用的性能。
技术实现
云书签基于以下技术架构实现：
- 模块名称：
cloudBookmark - 路由路径：
/cloudBookmark - 主要组件：
E:\bookmark_chrome\src\modules\cloudBookmark\index.ts- 模块定义E:\bookmark_chrome\src\modules\cloudBookmark\popup.vue- Popup 界面E:\bookmark_chrome\src\tab-app\views\user\Cloud.vue- 完整管理页面E:\bookmark_chrome\src\utils\bookmark.ts- 书签同步核心逻辑
- 数据存储：云端存储，通过 RESTful API 与服务器交互
- 通信机制：基于 Channel 通信系统实现跨组件消息传递
- API 端点：
bookmarks/overideData- 覆盖上传书签数据bookmarks/downloadData- 下载云端书签数据
开发者可参考以下文档了解详细架构：
E:\bookmark_chrome\CLAUDE.md- 项目开发规范E:\bookmark_chrome\docs\ARCHITECTURE.md- 架构说明E:\bookmark_chrome\docs\CORE_API.md- 核心 API 参考
最佳实践
分类组织建议
- 按主题分类：如"工作"、"学习"、"娱乐"等
- 按项目分类：每个项目创建独立分类
- 按用途分类：如"开发工具"、"设计资源"、"参考文档"等
- 多级分类：合理使用子分类，避免单层分类过多
命名建议
- 标题简洁明了：使用描述性的标题，方便搜索
- 分类名称规范：统一命名风格，如全部使用中文或英文
- 避免重复：定期检查并合并重复的书签
维护建议
- 定期清理：删除失效的书签链接
- 及时更新：网站地址变更时及时修改书签
- 合理分类：随着书签增多，及时调整分类结构
- 备份重要书签：对于特别重要的书签，建议同时保存在浏览器书签栏