帮助与导入说明

返回首页
本页介绍如何准备导入文件、导入逻辑与效果示例，并提供示例文件下载。
导入书签格式说明

支持的文件格式

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 等字段正确。