本文介绍如何添加、编辑、删除、搜索、排序书签。

添加书签

方法一：快速添加当前网页（最常用）

1. 点击浏览器工具栏的云端书签图标，打开弹窗。
2. 点击「添加当前页面」按钮。
3. 会打开书签管理页，自动填好了当前网页的标题和网址。
4. 你可以补充填写：描述、备注、标签、选择文件夹、是否收藏。
5. 点击「保存」就完成了。保存完自动同步到云端。

方法二：快捷键添加

• 按 Ctrl+Shift+Z（Mac 是 Command+Shift+Z）。
• 会自动打开添加书签界面，已经填好当前页面信息。
• 你可以在浏览器 chrome://extensions/shortcuts 里自定义这个快捷键。

方法三：右键菜单添加

• 在网页空白处点击右键。
• 选择「添加到云端书签」。
• 同样会打开添加界面，自动填充信息。

方法四：在完整管理页添加

1. 从弹窗点击「进入完整界面」打开书签管理页。
2. 点击顶部「添加书签」按钮。
3. 手动填写标题和网址，填写其他信息。
4. 点击保存。

编辑书签

• 在书签卡片右上角找到铅笔图标。
• 点击铅笔图标，进入编辑界面。
• 修改完信息，点击保存。
• 保存后自动同步到云端。

删除书签

• 在书签卡片右上角找到垃圾桶图标。
• 点击垃圾桶图标。
• 会弹出确认框，确认后删除。
• 删除后自动同步到云端。

收藏书签

• 点击书签卡片右上角的星星图标。
• 空星（☆）变成实星（⭐）就是收藏成功了。
• 再次点击就取消收藏。
• 收藏的书签可以单独筛选出来，也可以设置排序让收藏的排在前面。

搜索书签

• 在书签管理页顶部或弹窗顶部有搜索框。
• 输入关键词，会实时过滤出匹配的书签。
• 标题、网址、描述、备注、标签里面都能搜到。
• 搜索框右边有个叉号按钮，点一下清空搜索。

筛选书签

按文件夹筛选

• 左侧文件夹列表点击某个文件夹。
• 右侧只显示这个文件夹里的书签。

按标签筛选

• 左侧标签列表点击某个标签。
• 右侧只显示带这个标签的书签。

按收藏筛选

• 顶部导航栏点击「收藏」按钮。
• 只显示已收藏的书签。

看最近添加

• 顶部导航栏点击「最近添加」按钮。
• 按创建时间倒序显示，最新添加的排在前面。

排序书签

点击顶部排序下拉菜单，可以选择排序方式：

1. 自定义排序（默认）：保留你拖拽调整的顺序，你说了算。
2. 按创建时间 - 最新在前：最近添加的排在最前面。
3. 按创建时间 - 最早在前：最早添加的排在最前面。
4. 按标题 - A 到 Z：按标题字母顺序升序。
5. 按标题 - Z 到 A：按标题字母顺序降序。
6. 收藏优先：已收藏的排在前面，未收藏的排在后面。

如果你不调整顺序，用默认的自定义排序就好。文件夹排序后，书签会自动按文件夹顺序排列。

调整顺序（拖拽排序）

调整书签顺序

在自定义排序模式下：

1. 按住书签卡片。
2. 拖动到你想要的位置。
3. 松开鼠标，顺序就改好了。
4. 修改自动保存并同步到云端。

调整文件夹顺序

在左侧文件夹列表：

1. 按住文件夹行。
2. 拖动到目标位置。
3. 松开就改好了顺序。
4. 文件夹顺序改完，书签会自动按新顺序重新排列。

批量移动书签

1. 在书签管理页顶部点击「批量操作」按钮。
2. 每个书签左边会出现复选框，勾选你要移动的书签。
3. 点击底部「批量移动」按钮。
4. 弹出对话框选择目标文件夹（或选择「未分类」）。
5. 确认后，所有选中的书签都会移动到目标文件夹。
6. 自动保存并同步到云端。
7. 完成后点击「退出批量模式」。

查看书签详情

点击书签卡片就会打开详情弹窗，可以看到：

• 完整标题
• 完整网址
• 描述
• 备注（多行显示）
• 标签
• 所属文件夹

点击网址可以直接访问网站，也可以复制链接。

检查失效链接

云端书签可以一键帮你找出打不开的网站：

1. 在书签管理页右上角找到「检测失效」按钮。
2. 点击开始检测，会逐个检查所有书签。
3. 检测完成后，弹出结果窗口，列出所有打不开的链接。
4. 显示每个失效链接的：网址、所在文件夹、状态码。
5. 你可以点击网址直接访问，确认是不是真的失效。
6. 勾选你要删除的，点击「删除选中」就一次性删掉了。
7. 删除后自动同步到云端。

切换视图模式

书签管理页右上角有视图切换按钮：

• 网格视图：卡片式布局，图文并茂，好看。
• 列表视图：更紧凑，显示更多文字，适合看备注。

点击按钮就能切换，你的选择会记住，下次打开还是你选的模式。

自定义显示内容

点击右上角「显示选项」按钮，可以勾选要不要显示：

• 网站图标
• 网址
• 描述
• 备注
• 标签

不想看的可以关掉，让界面更简洁。设置会记住并同步到云端。

常见问题

Q: 我不小心删错了书签能恢复吗？

A: 建议定期导出 JSON 备份，如果有备份可以从备份恢复。目前没有回收站功能。

Q: 一个书签能同时放在多个文件夹吗？

A: 目前一个书签只能放在一个文件夹里。你可以用标签来实现分类到多个分类的效果。

Q: 最多能存多少个书签？

A: 没有限制，取决于你的 WebDAV 存储空间。一般几千个书签完全没问题。

设备管理功能可以让你看到哪些设备在用你的云端书签，支持移除不再使用的设备，还可以开启设备检测提高安全性。

什么是设备管理？

当你在多台电脑或手机上使用同一个 WebDAV 账号同步书签时，每台设备会在云端注册记录。你可以：

• 看到所有已登录的设备列表
• 移除不再使用的设备
• 开启设备检测，防止陌生设备访问你的数据

查看设备列表

1. 打开设置页面。
2. 往下找到「设备管理」区域。
3. 这里会显示：
   • 当前设备：显示你现在正在用的这台设备的名称和设备ID。
   • 其他设备：列出所有其他注册过的设备，显示设备名称、ID、创建时间、上次在线时间。

移除设备

如果你有一台设备不再用了，可以把它从列表里删掉：

1. 在设备列表找到要移除的设备。
2. 点击右边的「移除」按钮。
3. 确认删除。
4. 移除后，这个设备下次打开时，如果开启了设备检测，会被判定为未授权，清空本地数据。

更换设备后置换设备

如果你买了新电脑，想把旧设备换成新设备，可以这样：

1. 在新设备上装好插件，配置好同一个 WebDAV。
2. 新设备会自动注册到设备列表。
3. 在设置页设备列表里，找到你旧设备那条。
4. 点击「选为当前设备」。
5. 会把旧设备从列表删掉，当前设备信息换成你选的这条。
6. 配置自动同步到云端。

自定义设备名称

1. 在当前设备信息区域，点击「修改名称」按钮。
2. 输入你想要的名称，比如「我的办公电脑」。
3. 确认保存，自动同步到云端。

开启设备检测

设备检测可以提高安全性：

1. 在设备管理区域，勾选「开启设备检测」。
2. 勾选后立即同步到云端。
3. 作用：如果当前设备不在设备列表里，打开插件时会自动清空本地数据，防止别人拿到你的设备访问书签。

默认是关闭的，如果你很在意安全性，可以开启。

浏览器书签定时同步

这个功能可以把你浏览器原生书签栏里的书签，自动定时同步到云端书签的指定场景：

如何设置

1. 在设置页「存储设备管理」区域找到这个功能。
2. 下拉选择一个目标场景（就是同步到云端哪个场景）。
3. 点击「开始定时同步」按钮。
4. 插件会按照你设置的同步间隔，定时把浏览器原生书签同步到云端那个场景。

说明

• 这个功能和你弹窗里切换的场景没关系，相互独立。
• 每台设备可以单独设置，你这台设了不影响其他设备。
• 只有当浏览器里的书签比云端新的时候才会更新，不会覆盖别人改好的内容。
• 如果连续三次同步失败，会自动停止，需要你手动重新开启。
• 要停止同步，下拉选「不选择」，再点击「停止定时同步」。

常见问题

Q: 一定要开启设备检测吗？

A: 不是必需的。如果你就是自己一个人用，多台设备都是自己的，可以不开。如果担心设备丢了被别人用，建议开启。

Q: 设备ID是什么？

A: 每台设备第一次使用时，会自动生成一个唯一的ID，格式大概是这样：chrome_PC_abc123...，包含浏览器类型、设备类型、随机字符串，保证不重复。

Q: 我换浏览器了怎么办？

A: 新浏览器会注册新设备，你可以把旧的删掉。或者用「选为当前设备」把旧设备信息换到新浏览器上。

场景是云端书签最实用的功能之一，可以帮你把不同用途的书签分开管理，互相不干扰。

什么是场景？

举个例子：

• 家庭场景：存放你平时生活用的书签，比如购物网站、电影网站、旅行攻略等等。
• 公司场景：存放工作相关的书签，比如项目文档、开发工具、产品官网等等。
• 学习场景：存放学习资料、教程网站、课程链接等等。

每个场景的书签、文件夹都是完全分开的，你在哪个场景就只能看到那个场景的书签，不会混在一起。

默认场景

插件已经帮你建好了两个默认场景：

• 家庭（ID: home）
• 公司（ID: work）

这两个场景不能删除，防止你误操作把主要数据弄丢了。

如何添加新场景

1. 打开设置页面（点击插件图标 → 右上角设置按钮）。
2. 往下找到「场景管理」区域。
3. 点击「添加场景」按钮。
4. 在弹出框里填写：
   • 场景名称：给你的场景起个名字，比如「学习」。
   • 场景ID：只能用字母、数字、下划线，比如 study。
5. 点击确认保存。

插件会自动：

• 在本地和云端添加这个场景。
• 在 WebDAV 上新建一个独立文件存放这个场景的书签。

如何切换场景

在弹窗里切换

• 弹窗顶部显示当前场景名称。
• 点击场景名称，会下拉出所有场景列表。
• 点击你要切换的场景，等待几秒就切换好了。

在书签管理页切换

• 页面顶部导航栏有场景切换按钮。
• 点击后选择场景即可切换。

在设置页切换

• 场景管理区域里，每个场景右边都有「切换」按钮。
• 点击就切换到那个场景。

切换场景会自动从云端拉取这个场景的最新数据，保证你看到的总是最新的。

如何重命名场景

1. 在设置页的场景管理区域，找到要改名的场景。
2. 点击「重命名」按钮。
3. 输入新的名称，确认保存。

注意：场景 ID 不能改，只能改显示名称。默认场景不能重命名。

如何删除场景

1. 在设置页的场景管理区域，找到要删除的场景。
2. 点击「删除」按钮。
3. 会让你确认两次，防止误删。
4. 确认删除后：
   • 从场景列表里删掉。
   • 删除本地这个场景的所有书签。
   • 删除云端对应的文件。

默认场景不能删除。删除场景前建议先导出书签备份。

常见问题

Q: 切换场景为什么需要等几秒？

A: 因为每次切换都会从云端拉取这个场景的最新数据，保证你拿到的是最新的，所以需要一点时间。网越快等待时间越短。

Q: 我最多能建多少个场景？

A: 没有限制，你需要多少就能建多少。

Q: 不同场景的数据会混在一起吗？

A: 不会。每个场景存在云端不同文件里，搜索、筛选、显示都只显示当前场景，完全隔离。

云端书签支持密码保护功能，可以防止别人打开你的浏览器看到你的书签。

如何开启密码保护

1. 打开设置页面。
2. 找到「密码设置」区域。
3. 勾选「开启密码保护」。
4. 输入你的密码，再次确认。
5. 点击「保存设置」。

⚠️ 请记住你设置的密码，如果忘记了密码，你需要清除插件数据重新配置，会丢失本地数据。

使用方法

开启密码保护后：

• 打开弹窗需要输入密码。
• 打开书签管理页需要输入密码。
• 打开设置页需要输入密码。

输入正确密码后，只要你不关闭浏览器，下次打开不用再输。浏览器关掉再打开，需要重新输入密码。

如何关闭密码保护

1. 输入密码进入设置页。
2. 找到「密码设置」区域。
3. 取消勾选「开启密码保护」。
4. 点击「保存设置」。
5. 密码保护就关闭了。

如何修改密码

1. 输入密码进入设置页。
2. 在密码设置区域，直接输入新密码。
3. 再次确认新密码。
4. 点击「保存设置」。
5. 密码就改好了。

安全性说明

• 密码保存在浏览器本地存储。
• 密码不会传到云端，也不会传到任何第三方服务器。
• 如果别人用你的浏览器打开插件，没有密码打不开。
• 如果你清除浏览器数据，密码也会被清掉，需要重新配置。

常见问题

Q: 忘记密码了怎么办？

A: 没办法找回密码。只能在浏览器扩展管理页，把云端书签移除，再重新安装，然后重新配置 WebDAV 同步，从云端恢复数据。书签数据在云端不会丢，就是需要重新配置。

Q: 密码会同步到其他设备吗？

A: 不会，密码存在每台设备本地，不会传到云端，所以其他设备不会有这个密码，你需要在每台设备单独设置。

Q: 不开密码保护可以吗？

A: 完全可以。密码保护是可选功能，如果你就是自己一个人用电脑，不需要开。

云端书签通过 WebDAV 把书签同步到你的云盘，支持多设备共享。本文介绍同步机制和如何手动操作同步。

同步原理

基本概念

• 云端：你的 WebDAV 云盘（坚果云、Nextcloud、iCloud 等）。
• 本地：你的浏览器本地存储，就算没网也能看和编辑书签。
• 双向同步：本地改了会传到云端，云端改了会拉到本地。

自动同步

• 定时同步：插件按照你设置的同步间隔（默认 5 分钟），自动从云端拉取最新数据。
• 本地修改立即同步：你添加、修改、删除书签后，立即自动上传到云端。

所以一般情况下，你不用手动操作，自动就同步好了。

查看同步状态

在设置页看

• 设置页顶部会显示当前同步状态：
  • 空闲：没有正在同步。
  • 同步中：正在和云端同步。
  • 同步成功：最近一次同步成功了。
  • 同步失败：最近一次同步失败了，会显示错误信息。
• 还显示最后一次同步是什么时候。

在弹窗看

• 弹窗左下角有个小圆点和文字：
  • 绿色：已同步，没问题。
  • 黄色：正在同步中。
  • 红色：同步失败了，需要你检查。

手动同步

立即同步（双向同步）

• 在设置页点击「立即同步」按钮。
• 会同时从云端拉取最新数据，也把本地变化上传到云端。
• 适合你网断了很久刚恢复，或者你改了配置，想马上同步。

仅上传（只上传不下载）

• 在设置页点击「仅上传」按钮。
• 只会把本地变化上传到云端，不会从云端拉取数据。
• 如果你确定本地就是最新的，想强制上传，可以用这个。

在书签管理页同步

• 书签管理页右上角有个同步图标。
• 点击就会从云端拉取最新数据，刷新列表。

常见同步问题

Q: 提示同步失败怎么办？

A: 按这个顺序检查：

1. 检查网络能不能上网。
2. 检查 WebDAV 地址、用户名、密码对不对（去设置页看）。
3. 检查 WebDAV 服务是不是正常运行。
4. 如果是坚果云，确认你开启了第三方应用密码。

Q: 多个设备同时修改会怎么样？

A: 采用「最后修改优先」策略，哪个修改时间晚，哪个就保留。所以一般不会有问题。

Q: 切换场景为什么要重新拉取？

A: 为了保证你拿到的一定是云端最新的数据，不会因为本地缓存过时导致不同步。虽然多花几秒，但数据一致性更有保障。

Q: 离线了能用吗？

A: 完全可以。所有书签都存在本地，离线照样能看、能搜索、能编辑。等网络恢复后，会自动同步修改。

同步间隔设置

1. 在设置页「云端同步配置」区域。
2. 修改「同步间隔（分钟）」。
3. 点击「保存配置」。
4. 后台就会按照你设置的间隔定时同步。

• 间隔越短，同步越及时，但是对网络和 WebDAV 压力越大。
• 默认 5 分钟，一般够用了。
• 最短可以设 1 分钟，最长没限制。

云端书签弹窗支持很多自定义设置，可以按照你的使用习惯调整。

打开弹窗设置

1. 打开设置页面。
2. 找到「弹窗与悬浮球设置」区域。
3. 这里有各种自定义选项。

目录展示方式

弹窗左侧目录支持两种展示方式：

树形结构（默认）

• 显示完整的文件夹层级，子文件夹缩进。
• 适合多级文件夹，结构清晰。
• 如果你文件夹层级比较多，推荐用这个。

横向标签

• 一级文件夹横向排列，点击文件夹显示它的子文件夹。
• 同一时间只显示一级文件夹，然后点击后显示子文件夹。
• 如果你的文件夹层级不多，推荐用这个。

怎么切换：

• 在设置里「目录展示方式」选择你要的方式。
• 保存设置后，下次打开弹窗就生效。

滚动位置记忆

• 开启：记住你上次关闭弹窗时滚动条的位置，下次打开自动滚到那个位置。
• 关闭：每次打开弹窗都从头开始。

如果你每次打开都想找上次看到哪里，建议开启。

注意：只有弹窗和悬浮球打开的弹窗会记住位置，完整书签管理页不需要。

回到顶部按钮

• 开启：滚动超过一屏后，右下角显示「回到顶部」按钮，点击一键回到顶部。
• 建议开启，使用体验更好。

弹窗高度自定义

你可以自定义弹窗打开时的高度，适配你的屏幕：

• PC 端弹窗高度：单位是像素，默认 600px。
• 移动端弹窗高度：单位是百分比，默认 80%（占屏幕高度的 80%）。

如果你的屏幕大，可以调大一点；屏幕小，可以调小一点。

显示更新按钮

• 勾选后，弹窗右上角会显示一个更新按钮，点击可以检查更新。
• 不需要可以关掉。

默认展开一级文件夹

• 勾选后，弹窗打开时默认展开所有一级文件夹。
• 不勾选，一级文件夹默认都是折叠的，需要你点开。

快捷键设置

添加书签的默认快捷键是：

• Windows/Linux: Ctrl+Shift+Z
• Mac: Command+Shift+Z

如果你想改快捷键：

1. 打开浏览器 chrome://extensions/shortcuts。
2. 找到「云端书签」。
3. 修改「打开添加书签对话框」的快捷键。
4. 改完立即生效。

收藏抽屉在弹窗打开时默认状态

• 打开：弹窗打开时默认展开收藏抽屉。
• 关闭：弹窗打开时默认收起收藏抽屉（推荐）。

保存设置

改完任何设置，都需要点击页面底部的「保存设置」按钮才会生效。保存后会同步到云端，下次打开弹窗就是你改后的设置。

标签和收藏是两种额外的书签分类方式，让你更快找到想要的书签。

标签功能

什么是标签？

标签可以给一个书签打多个标记，比如一个书签同时可以打「前端」「React」「教程」三个标签。和文件夹不同，一个书签可以有多个标签，方便跨文件夹筛选。

怎么添加标签？

添加或编辑书签的时候，在「标签」输入框里，用逗号分隔多个标签：

前端, React, 教程  

保存就可以了。

怎么用标签筛选？

在书签管理页左侧，有「标签」区域，显示当前场景所有用过的标签，每个标签后面显示有多少个书签用了这个标签。

点击某个标签，右侧书签列表就会只显示带这个标签的书签。

标签会自动汇总

你给书签添加标签后，插件会自动汇总所有用过的标签，显示在左侧列表。删除书签后，不用的标签会自动消失。

收藏功能

什么是收藏？

收藏就是把重要常用的书签标星，方便快速找到。

怎么收藏/取消收藏

• 在书签卡片上：点击右上角的星星图标，空心变实心就是收藏了。再点击就取消收藏。
• 编辑书签时：勾选「收藏」复选框就是收藏，取消勾选就是取消收藏。

怎么看收藏的书签

• 在书签管理页顶部，点击「收藏」按钮，就只显示已收藏的书签。
• 在弹窗里，打开左侧目录抽屉，点击「我的收藏」，就显示所有收藏书签。

收藏排序优先

在排序选项里选择「收藏优先」，所有已收藏的书签都会排在前面，未收藏的排在后面。这样你每次打开都能先看到重要书签。

使用技巧

文件夹 + 标签组合用法

• 文件夹：按内容大分类，比如「工作」「学习」「生活」。
• 标签：按属性或项目细分，比如「优先级高」「待读」「项目A」。

这样你可以先切到「工作」文件夹，再筛选标签「优先级高」，就能快速找到你现在要做的事情。

用标签做动态分类

比如你可以给想读的文章打「待读」标签，读完了删掉标签，这样不用移动文件夹就能管理阅读进度。

用收藏快速访问常用网站

把你每天都要用的网站收藏起来，打开弹窗直接点「我的收藏」就能找到，非常快。

常见问题

Q: 一个书签可以有多个标签吗？

A: 完全可以，逗号分隔就行，多少个都可以。

Q: 删除标签会删除书签吗？

A: 不会。只是把这个标签从书签上去掉，书签本身还在。

Q: 收藏和标签会同步到云端吗？

A: 会，收藏状态和标签都会正常同步，多设备共享。

本文档介绍如何安装云端书签插件并完成首次 WebDAV 配置。

安装扩展

Tips: 目前已经可以在浏览器插件商店进行下载

Chrome / Edge 浏览器

1. 打开浏览器，在地址栏输入：

   • Chrome: chrome://extensions/
   • Edge: edge://extensions/

2. 在右上角开启 开发者模式。

3. 点击 加载已解压的扩展程序。

4. 选择 cloud_bookmark 项目根目录。

5. 安装成功后，浏览器工具栏会出现「云端书签」图标。

Firefox 浏览器

1. 打开 about:debugging#/runtime/this-firefox。

2. 点击 临时载入附加组件。

3. 选择项目根目录下的 manifest.json。

4. 安装成功后，工具栏会出现插件图标。

注意：临时载入的扩展在浏览器重启后会失效，正式使用请打包为 .xpi 安装。

首次配置 WebDAV

打开设置页面

有两种方式进入设置：

• 方式一：点击工具栏插件图标 → 在弹窗右上角点击「设置」图标。
• 方式二：在扩展管理页面 → 找到「云端书签」→ 点击「扩展选项」。

填写配置信息

在「云端同步配置」区域填写以下信息：

测试并保存

1. 填写完成后点击 测试连接。

   • 成功：提示「连接成功」，可以继续保存。
   • 失败：根据错误提示检查地址、用户名、密码。

2. 点击 保存配置。

   • 插件会保存配置到本地。
   • 自动从云端拉取设置。
   • 注册当前设备。
   • 执行首次同步。

WebDAV 配置迁移

如果你已经在其他设备上配置好了，可以快速迁移配置：

从另一台设备导出

1. 在已配置好的设备上打开设置页。
2. 在「WebDAV 配置工具」区域点击 导出到剪贴板。
3. 配置会以三行格式复制到剪贴板：

   webdav地址  webdav用户  webdav密码  

在新设备导入

1. 在新设备设置页点击 导入配置。
2. 在弹出框中粘贴三行格式的配置。
3. 点击「导入」，表单会自动填充。
4. 检查无误后点击「保存配置」完成。

常见问题

Q: 提示「无法连接到 WebDAV 服务器」

A: 检查以下几点：

• 地址是否正确（必须包含完整路径，如 /dav/ 结尾）
• 服务端是否开启 HTTPS
• 用户名和密码是否正确
• 网络是否能访问该地址

Q: 保存配置后本地原有书签会丢失吗？

A: 不会。首次保存配置检测到本地已有书签时，会自动归档合并到云端，保证不会覆盖丢失。

Q: 支持哪些 WebDAV 服务？

A: 支持所有标准 WebDAV 协议服务，包括：

• 坚果云
• iCloud WebDAV
• Nextcloud
• ownCloud
• 阿里云盘 WebDAV
• 群晖 WebDAV
• 其他任何支持标准 WebDAV 的服务

云端书签支持多种方式导入导出书签，方便你从其他地方迁移过来，或者备份数据。

导入书签

从浏览器书签栏直接导入

这是最方便的，如果你之前把书签存在浏览器原生书签栏，可以直接导入：

1. 打开设置页面。
2. 找到「导入导出」区域。
3. 点击「从浏览器书签栏导入」。
4. 在弹出框选择要导入到哪个场景。
5. 点击确认，插件会自动读取浏览器书签。
6. 导入完成会告诉你新增了多少个书签。

注意：有些移动浏览器不支持书签 API，这种方法可能用不了，你可以用 HTML 文件导入。

从 HTML 文件导入

如果你从其他浏览器或其他书签工具导出了 HTML 文件，可以用这个方法：

1. 准备好 HTML 文件（一般浏览器书签导出都是这个格式）。
2. 在设置页点击「从文件导入」。
3. 选择你的 .html 文件。
4. 选择要导入到哪个场景。
5. 点击确认，插件会解析文件里的书签和文件夹结构。
6. 导入完成提示结果。

从 JSON 文件导入

如果你之前从云端书签导出过 JSON 备份，可以用这个方法恢复：

1. 在设置页点击「从文件导入」。
2. 选择 .json 文件。
3. 选择目标场景。
4. 确认导入。

导出书签

导出为 JSON 文件（推荐用于备份）

JSON 格式保留所有信息：书签、文件夹、备注、标签、收藏状态、排序都完整保留。建议定期导出备份。

导出方法：

• 方法一：在设置页 → 导入导出区域 → 点击「导出为 JSON」。
• 方法二：在书签管理页右上角 → 点击「导出」→ 选择「导出为 JSON」。

导出的文件可以保存到本地，万一出问题可以用这个恢复。

导出为 HTML 文件（用于迁移到浏览器）

HTML 格式是浏览器通用格式，可以导入到其他浏览器或其他书签工具：

导出方法：

• 方法一：在设置页 → 导入导出区域 → 点击「导出为 HTML」。
• 方法二：在书签管理页右上角 → 点击「导出」→ 选择「导出为 HTML」。

导出后，你可以打开浏览器书签管理器，导入这个 HTML 文件。

注意：不管哪种导出方式，都只导出当前场景的书签，其他场景不会导出。

WebDAV 配置导入导出

如果你要在多台设备上使用，不用每次手动输入 WebDAV 配置，可以一键导入导出：

导出配置

1. 在已经配置好的设备上，打开设置页。
2. 找到「WebDAV 配置工具」区域。
3. 点击「导出到剪贴板」。
4. 你的配置就复制到剪贴板了，格式是三行：

   第一行：WebDAV 地址  第二行：用户名   第三行：密码   ```

导入配置

1. 在新设备上打开设置页。
2. 点击「导入配置」。
3. 在弹出框粘贴你刚才复制的三行配置。
4. 点击「导入」。
5. 地址、用户名、密码会自动填到表单里。
6. 你检查一下没错，点击「保存配置」就好了。

导入规则说明

• 自动去重：同一个网址在同一个场景里已经有了，不会重复导入。
• 保留文件夹结构：原来的文件夹层级会保留。
• 清理空文件夹：导入完会自动删掉没有用到的空文件夹。
• 你选择目标场景：所有导入的书签都会放到你选的场景里，不会影响其他场景。

常见问题

Q: 导入会覆盖我现有的书签吗？

A: 不会。导入是合并进去，只会新增，不会删除你现有的。只有网址完全一样才会跳过，不会覆盖。

Q: 支持什么格式的 HTML 文件？

A: 支持所有浏览器标准导出的 HTML 书签格式，Chrome、Edge、Firefox 导出的都能用。

Q: 我想把一个场景的书签复制到另一个场景怎么办？

A: 先从原场景导出 JSON，然后在新场景导入，就复制过去了。

云端书签支持多级文件夹，帮你分类整理书签。

什么是多级文件夹？

多级文件夹就是文件夹里面还能建文件夹，比如：

学习    前端开发    React    Vue  后端开发      Node.js生活    购物  旅行```    这样分类清晰，好找。    ---    ## 新建文件夹    1. 打开书签管理完整界面。  2. 在左侧「文件夹」区域，点击「新增文件夹」按钮。  3. 输入文件夹路径，比如：     - 直接输入 `项目` → 新建一级文件夹「项目」。     - 输入 `项目/前端` → 自动在「项目」下新建「前端」，如果「项目」不存在会自动创建。  4. 确认后就建好了。    > 提示：用 `/` 斜杠分隔就能创建多级文件夹。    ---    ## 重命名文件夹    1. 在左侧文件夹列表，找到你要改名的文件夹。  2. 点击文件夹右边的「…」按钮。  3. 选择「重命名」。  4. 输入新名称，确认保存。  5. 只改名称，位置不变。    ---    ## 移动文件夹    1. 在左侧文件夹列表，找到你要移动的文件夹。  2. 点击「…」按钮。  3. 选择「移动」。  4. 在弹出框里选择新的父文件夹。  5. 确认保存。  6. 这个文件夹和它里面所有子文件夹、书签都会一起移动过去。    ---    ## 删除文件夹    1. 在左侧文件夹列表，找到你要删除的文件夹。  2. 点击「…」按钮。  3. 选择「删除」。  4. 会提示你：删除会同时删除这个文件夹里面所有子文件夹和书签。  5. 确认删除后，文件夹和里面的内容都会被删除。    > ⚠️ 警告：删除操作请谨慎！建议删除前先导出书签备份。    ---    ## 调整文件夹顺序    ### 拖拽排序  1. 在左侧文件夹列表。  2. 按住你要调整的文件夹。  3. 拖动到想要的位置。  4. 松开鼠标，顺序就改好了。  5. 自动保存并同步到云端。    ### 上移/下移  1. 点击文件夹右边的「…」按钮。  2. 选择「上移」或「下移」。  3. 文件夹就会向上或向下移动一个位置。    > 文件夹排序后，书签会自动按照新的文件夹顺序重新排列。    ---    ## 展开和折叠文件夹（电脑端）    在电脑端：  - 点击已经折叠的文件夹行会展开，显示子文件夹。  - 点击已经展开的文件夹行会折叠，隐藏子文件夹。    在手机端：  - 点击文件夹只会筛选出这个文件夹的书签，不会展开折叠。    ---    ## 未分类书签    如果你的书签没有分配到任何文件夹，会在左侧文件夹列表顶部显示一个「未分类」入口。点击就能看到所有未分类的书签。    ---    ## 常见问题    ### Q: 支持多少级文件夹？  A: 理论上没有限制，你可以建很多级，但是建议不要超过三四级，不然找起来不方便。    ### Q: 删除文件夹会删除里面的书签吗？  A: 是的，删除文件夹会把这个文件夹里面所有子文件夹和书签一起删掉，所以一定要谨慎。    ### Q: 我导入了很多书签，空文件夹会被删掉吗？  A: 导入完成后会自动清理没有用到的空文件夹。如果你手动创建的空文件夹，会保留不会删。    <!--stackedit_data:eyJoaXN0b3J5IjpbMTkyNDk3NDA5MV19-->

悬浮球是一个可选的快捷入口，在网页右侧显示一个可拖动的小球，点击就能打开云端书签。

如何开启/关闭悬浮球

1. 打开设置页面。
2. 找到「悬浮球设置」区域。
3. 勾选「开启悬浮球」就开启，取消勾选就关闭。
4. 修改后立即生效，所有打开的网页都会自动显示或隐藏悬浮球。

默认是关闭的，你需要手动开启。

如何使用悬浮球

点击打开弹窗

• 单击悬浮球，就会打开云端书签弹窗，和你点击工具栏图标的效果一样。

拖动改变位置

• 按住悬浮球不要松开。
• 上下拖动就能改变它在屏幕右边的位置。
• 松开就停在那里。

自动贴边

• 你拖动完松开鼠标后，悬浮球会自动贴到屏幕边缘，减少遮挡网页内容。
• 只有你点击或拖动它时才会完全显示。

自定义设置

默认位置

在设置里可以选择悬浮球默认出现在哪里：

• 自动：靠屏幕右边。
• 靠左：靠屏幕左边。
• 靠右：靠屏幕右边（默认）。

点击行为

可以设置点击悬浮球做什么：

• 打开弹窗（默认）：点击就打开云端书签弹窗。
• 一键保存当前页面：点击就直接把当前网页添加到书签，然后打开编辑界面。

调整大小

悬浮球默认大小是 48×48 像素。如果你觉得不合适，可以自己改大小：

1. 打开项目里的 content/floating-ball.js 文件。
2. 找到第 271 行左右的样式定义部分。
3. 修改 width、height 和 font-size 三个值：

小尺寸推荐：

width: 40px;  height: 40px;  font-size: 20px;  

默认尺寸（不用改就是这个）：

width: 48px;  height: 48px;  font-size: 24px;  

大尺寸推荐：

width: 56px;  height: 56px;  font-size: 28px;  

超大尺寸推荐：

width: 64px;  height: 64px;  font-size: 32px;  

4. 保存文件，然后在浏览器扩展管理页重新加载扩展。
5. 刷新网页，新大小就生效了。

提示：记得保持 width 和 height 相等，这样才是圆形。font-size 大约是 width 的一半比较好看。

常见问题

Q: 悬浮球会遮挡网页内容吗？

A: 不会。不用的时候它会自动贴边并且变半透明，只留很小一条边，很少会遮挡重要内容。

Q: 缩放网页后悬浮球会跑到屏幕外面吗？

A: 不会。代码会自动检查，保证悬浮球始终在可视区域内。改变浏览器窗口大小、缩放网页都会自动调整位置。

Q: 哪些浏览器支持悬浮球？

A: 所有支持扩展的现代浏览器都支持。Chrome、Edge、Firefox 在电脑和手机上都能用。

Q: 开启悬浮球后网页会卡吗？

A: 不会。悬浮球代码很轻量，只会在你拖动或点击的时候运行，不会影响网页性能。

本文档按功能分类整理了云端书签项目的历次功能更新和改进。

一、同步功能

同步策略改进

• 切换场景时，每次都从云端重新拉取最新数据，保证本地数据不会过时。
• 多个修改操作会排队依次上传到云端，避免同时上传导致数据混乱。
• 首次配置 WebDAV 时，如果本地已经有书签，会自动合并到云端，不会覆盖丢失原有书签。
• 你切换回浏览器窗口时，如果数据过期了会自动同步更新。
• 更换 WebDAV 账号后，会清空本地旧数据，重新从云端下载。

浏览器书签自动同步到云端

• 可以把你浏览器原生书签栏里的书签，自动定时同步到云端书签的某个场景中。
• 这个功能和你平时在弹窗里切换的场景没关系，相互独立。
• 只有当浏览器里的书签比云端新的时候才会更新，不会覆盖别人已经上传的内容。
• 如果连续三次同步都失败了，会自动停止，避免一直重试浪费资源。
• 每台设备可以单独设置要不要开启，互不影响。

使用体验改进

• 在设置页操作云端同步时，会显示蒙层等待操作完成，避免你重复点击。
• 弹窗左下角会显示同步状态：绿色表示已同步，黄色表示正在同步，红色表示同步失败。
• 可以手动点击「立即同步」来主动同步（同时拉取和上传），也可以点击「仅上传」只把本地变化传到云端。

二、场景管理

基础功能

• 场景是什么？ 场景就是把书签分开管理，比如一个放工作书签，一个放私人书签，互相不打扰。
• 插件默认有「家庭」和「公司」两个场景，这两个不能删除，防止误删。
• 你可以自己添加任意多个场景，比如「学习」「项目A」等等，可以改名，可以删除。
• 每个场景的书签、文件夹都存在云端单独的文件里，互不干扰。

使用体验改进

• 切换场景时，会显示提示告诉你正在切换，按钮变成加载状态，防止你重复点击。
• 切换场景后会自动清空搜索框，不会保留上个场景的搜索内容。
• 你创建的空文件夹不会莫名其妙消失，会一直保留。

三、书签管理

基础功能

• 多种添加方式：弹窗快速添加当前网页、快捷键添加、右键菜单添加、完整管理页手动添加。
• 可以批量勾选多个书签，一起移动到另一个文件夹。
• 可以用鼠标拖动书签和文件夹，调整它们的排列顺序，改完自动同步到云端。
• 支持多级文件夹（文件夹里面还能建文件夹），可以新建、改名、移动、删除。
• 点击书签可以查看完整信息，包括备注、标签等。
• 一键检查所有书签，找出打不开的失效链接，你确认后可以一次性删除。

排序

• 默认保留你拖拽调整的顺序，你说了算。
• 也可以选择按创建时间、按标题字母、按收藏优先来排序。
• 调整文件夹顺序后，书签会自动按照新的文件夹顺序重新排列。
• 新书签或新文件夹会自动插入到正确的位置，保持原有排序不乱。

搜索和筛选

• 输入关键词就能搜索，标题、网址、描述、备注、标签里面都能搜。
• 可以按文件夹筛选、按标签筛选、只看收藏、只看最近添加。
• 你搜过的内容会记住，下次打开还保留。

界面体验改进

• 可以切换网格视图（卡片式）或列表视图（文字为主）。
• 可以自己选择要不要显示网站图标、网址、描述、备注、标签。
• 手机上添加书签时，界面会自动适应屏幕高度，不会被输入法挡住。
• 在目录点击某个文件夹，会自动滚动到书签列表里那个文件夹的位置，并打开它。
• 滚动浏览时，顶部会固定显示你当前正在看哪个文件夹，不容易迷路。

四、文件夹管理

功能改进

• 可以只改文件夹名字，不改变位置；也可以只移动文件夹到另一个父文件夹，不改名。
• 在电脑上，可以点击文件夹展开/折叠里面的子文件夹。
• 在手机上，点击文件夹只会筛选出该文件夹的书签，不会展开折叠，更适合小屏幕操作。
• 层级关系清晰，子文件夹会自动缩进显示。
• 空文件夹会保留，不会被自动删掉。
• 显示每个文件夹里面有多少个子文件夹。

操作体验改进

• 每个文件夹右边有个「…」按钮，点击弹出菜单选择重命名/移动/删除操作。
• 可以拖动文件夹调整顺序。

五、弹窗界面

目录导航

• 目录按钮固定在弹窗右上角，随时可以点击打开。
• 目录从侧边滑出覆盖在内容上面，点击空白地方就关闭。
• 支持两种显示方式：树形层级结构（默认）和横向标签，可以在设置里切换。
• 点击目录里的文件夹，右侧自动滚动到那个文件夹的位置。
• 目录里会高亮显示你当前正在看的文件夹。

滚动体验

• 可以选择记住弹窗滚动位置，下次打开自动滚到上次的位置。
• 滚动超过一屏后，会显示「回到顶部」按钮，点击一键返回顶部。
• 打开收藏抽屉时会自动隐藏回到顶部按钮。

布局和样式

• 电脑和手机都用统一的抽屉式目录设计。
• 字体更适合中文显示，看起来更均匀舒服。
• 颜色、圆角、阴影风格统一，简洁清爽。
• 可以自己设置电脑和手机端弹窗的高度，适配不同屏幕。

功能增强

• 弹窗有收藏快捷入口，快速查看所有你收藏过的书签。
• 在弹窗里删除书签后，立即同步到云端。
• 搜索框有个清空按钮，点一下就能清空搜索内容。
• 可以选择要不要在弹窗显示更新按钮。

六、悬浮球功能

基础功能

• 可以选择开启或关闭悬浮球，设置会同步到云端。
• 按住悬浮球可以在屏幕右边上下拖动，改变位置。
• 点击悬浮球就能打开插件弹窗，和点击工具栏图标一样。
• 可以设置悬浮球默认靠左边还是靠右边界。

使用体验改进

• 你不碰它的时候，它会自动贴到屏幕边缘，减少遮挡网页内容。
• 调整浏览器窗口大小或缩放网页时，会自动调整位置，保证悬浮球始终看得见。
• 你可以自己改悬浮球大小（需要改一点代码，文档里有现成例子）。
• 可以设置点击悬浮球是「打开弹窗」还是「一键保存当前网页」。

七、设备管理

基础功能

• 每台设备第一次使用时，会自动生成一个唯一的设备ID。
• 设置页能看到所有用过这个账号的设备列表，显示设备名称、什么时候创建的、上次在线时间。
• 可以把不用的设备从列表里删掉。
• 如果你换设备了，可以把列表里已有设备选为当前设备，不用重新添加。
• 可以自己改当前设备的显示名称。

设备检测

• 可以选择开启设备检测功能，默认关闭。
• 开启后，如果当前设备不在设备列表里，会清空本地数据，防止别人盗用。

浏览器书签同步设置

• 每台设备可以绑定一个云端场景，用来存放浏览器原生书签同步过来的内容。
• 每台设备可以单独开启或关闭自动同步。

八、密码保护

• 可以在设置里开启密码保护。
• 输入一次密码后，这次浏览器不关就不用再输。
• 浏览器关掉再打开，需要重新输入密码。
• 打开弹窗、管理页、设置页都需要输入密码。

九、导入导出

导入

• 可以直接从你浏览器的书签栏导入到云端书签，选个目标场景就行。
• 支持导入浏览器导出的 HTML 书签文件。
• 支持导入本插件导出的 JSON 备份文件。
• 同一个网址不会重复导入，自动去重。
• 会保留原来的文件夹结构。
• 导入完会告诉你新增了多少个书签。

导出

• 导出为 JSON 文件：包含完整的书签、文件夹、备注等所有信息，可以用来备份。
• 导出为 HTML 文件：标准格式，可以直接导入到其他浏览器或其他书签工具。
• 在书签管理页右上角就有导出按钮，很方便。

WebDAV 配置迁移

• 可以一键把当前配置导出到剪贴板，到新设备上一键导入，不用重新手动输入。
• 格式很简单：地址第一行，用户名第二行，密码第三行。

十、标签功能

• 你给书签加的标签，会自动汇总显示在左侧列表。
• 点击某个标签，就会只显示带这个标签的书签。
• 一个书签可以加多个标签。

十一、收藏功能

• 点击书签右上角的星星就能收藏或取消收藏。
• 可以筛选只看已收藏的书签。
• 可以设置排序让收藏的书签排在前面。
• 弹窗里有收藏快捷入口。
• 收藏状态改完立即同步到云端。

十二、兼容性和稳定性

• 同时支持 Chrome 和 Firefox 浏览器，电脑端和手机端都能用。
• 可以导出调试日志，遇到问题时方便排查，密码会自动打码不会泄露。
• 程序出错了会记录下来，不会直接崩溃。
• 手机端针对触摸操作和小屏幕做了专门优化。