帮助与导入说明

返回首页
本页包含快捷键、核心功能介绍，以及书签导入的格式说明、排查与示例。

键盘快捷键

/
聚焦搜索框
全局（输入框中无效）
Ctrl+K
聚焦搜索框
全局，Mac 为 ⌘+K
N
打开「添加书签」对话框
全局（输入框中无效）
↑+↓
在搜索建议中切换高亮项
搜索下拉打开时
Enter
选中当前建议或提交搜索
搜索下拉打开时
Esc
关闭搜索建议 / 退出批量选择模式
Ctrl+A
全选当前视图书签
批量选择模式下，Mac 为 ⌘+A
双击分类名
重命名分类 / 子分类
侧边栏
Shift+滚轮
横向滚动子分类胶囊
详情视图（部分浏览器）

核心功能

智能搜索

支持搜索书签标题、URL、描述、标签和分类名。

  • 输入 tag:react 或 #react 只搜标签
  • 顶部 Filter 按钮可按分类/有描述筛选
  • 历史记录与建议联动，方向键导航
批量管理

在分类详情页右上角点击「选择」进入批量模式。

  • 多选后底部工具栏可移动 / 导出 / 删除
  • Ctrl + A 全选当前视图
  • Esc 退出选择模式
  • 侧边栏也有"批量管理分类"入口
删除撤销

所有删除操作（书签、子分类、分类、批量删除）都会弹出一条带「撤销」按钮的提示，5 秒内可恢复。

注意：仅保留最近一次快照，刷新页面后撤销窗口失效。

后台元数据增强

添加 / 导入书签后，系统会在后台自动抓取网站标题、描述、图标、封面图。

  • 预置 1000+ 常用站点离线数据库，零延迟
  • 顶部进度指示器显示完成度，可点击停止
  • 导入的书签会保留你原始的标题/描述，只补全缺失字段
分类与导航
  • 双击分类名即可重命名
  • 详情视图顶部面包屑可快速回溯
  • 侧边栏折叠后保留分类首字母快捷导航
  • URL 与分类/搜索状态双向绑定，可分享或刷新保留
显示设置

「⋯ 更多 → 显示」或「设置」面板可调整：

  • 封面 / 图标 / 标题 / 描述 / 网址 / 标签 显隐
  • 卡片密度：紧凑 / 舒适 / 宽松
  • 圆角样式与网格列数
  • 主题色与深浅色（设置面板内）
移动端与 PWA
  • 窄屏自动切换为抽屉式侧边栏，左上角汉堡按钮唤出
  • 支持安装到桌面 / 主屏（PWA），离线可用
  • 触控目标已优化，所有可点击区域 ≥ 40px
数据导入导出
  • 支持 HTML（浏览器书签）/ JSON 导入
  • 导出格式：HTML / JSON / CSV / TXT
  • 可按分类或子分类单独导出（侧边栏菜单）
  • 所有数据本地存储，不上传服务器

数据与隐私

所有书签、分类、设置都存储在浏览器 localStorage 中，不会上传到任何服务器。

  • 清除浏览器数据 / 切换浏览器 = 数据丢失，建议定期导出备份
  • 「设置 → 清空所有数据」提供两步确认的硬重置
  • 仅在你主动添加书签时，后台才会通过应用自身的代理接口抓取该 URL 的元数据；不会上报浏览行为
导入书签格式说明

支持的文件格式

HTML 格式

标准的浏览器书签导出格式，支持从 Chrome、Firefox、Safari、Edge 等浏览器导出的书签文件。

JSON 格式

自定义的 JSON 数据格式，支持完整的分类结构和书签信息，包括描述、创建时间等详细信息。

CSV 格式

简单的表格格式，包含标题、URL、描述和分类信息，便于在 Excel 中编辑。

导入逻辑说明

🔍 浏览器书签文件层级处理规则

书签栏特殊处理：
  • • 自动识别"书签栏"文件夹（支持中英文）
  • • 书签栏本身不会成为分类，其内容按以下规则处理
层级映射规则：
  • • 书签栏下的文件夹 → 一级分类
  • • 一级分类下的文件夹 → 二级分类
  • • 更深层的文件夹 → 扁平化到二级分类，用前缀标识
书签归类规则：
  • • 书签栏下的直接书签 → 放入"未分类书签"分类
  • • 一级分类下的直接书签 → 放入该分类的"未分组"子分类
  • • 深层文件夹中的书签 → 添加前缀标识来源文件夹

实际示例

原始结构：
书签栏/
├── Google (直接书签)
├── 开发工具/
│   ├── VSCode (直接书签)
│   ├── 前端工具/
│   │   └── React文档
│   └── 后端工具/
│       └── API工具/
│           └── Postman
导入后结构：
📂 未分类书签
  └── 📁 未分组
      └── 🔗 Google

📂 开发工具
  ├── 📁 未分组
  │   └── 🔗 VSCode
  ├── 📁 前端工具
  │   └── 🔗 React文档
  └── 📁 后端工具
      └── 🔗 [API工具] Postman

基本导入说明

  • 导入书签会添加到现有数据，不会覆盖
  • 支持任意层级的文件夹结构，所有书签都会被正确导入
  • JSON 格式支持完整的二级分类与详细信息
  • 支持拖拽或点击选择文件
  • 文件大小建议不超过 10MB

导入常见问题与排查

1. 中文乱码或编码异常

优先使用 UTF-8 编码的 HTML/JSON；若来自旧设备，建议在浏览器中重新导出一次再导入。

2. HTML 结构不完整（缺少 DL/DT/H3）

请确认是浏览器导出的书签 HTML 文件；不要将普通网页另存为 HTML 后导入。

3. JSON 字段缺失/类型错误

请对照下方“字段映射与数据结构”示例，确保 id/name/subCategoryId 等必需字段齐全且类型正确。

4. 文件过大或浏览器内存不足

建议分批导入或先在浏览器中清理无用书签。单文件建议不超过 10MB。

去重与合并策略 · 字段映射

去重与合并

  • 基于 URL 的精确去重：相同 URL 的条目按“先到先保留”策略处理，避免重复。
  • 同分类合并：导入到相同子分类时保留一条记录；若来自深层文件夹，会添加来源前缀标识。
  • 标题近似（可选/计划中）：未来可能增加相似标题提示，人工确认是否合并。

字段映射与数据结构

  • HTML：H3 → 文件夹，A → 书签链接，DL/DT 组织层级；ADD_DATE、LAST_MODIFIED 等属性会被忽略。
  • JSON：请参考“JSON 数据格式”章节的带注释示例，确保 id/name/subCategoryId 等字段正确。