Kindle 导入

解析 Kindle 笔记本导出文件（HTML 格式），并为用户的笔记创建 slipbox 条目。

输入格式

Kindle 导出文件为 XHTML 文件，结构如下：

图书标题
作者姓名
...
章节/小节名称
Highlight (yellow) - Section > Page X
书中高亮的文本
Note - Section > Page X
用户自己的笔记

关键区分规则：

• noteHeading 以 “Highlight” 开头 → 对应书中原文 → 跳过
• noteHeading 以 “Note” 开头 → 对应用户自己的思考 → 导入

解析规则

元数据提取

1. 图书标题：取 .bookTitle div 的内容
2. 作者：取 .authors div 的内容
3. 来源类型：book

正文内容提取

1. 查找所有 .noteHeading 元素
2. 若 heading 以 “Note” 开头 → 获取其后紧跟的 .noteText 内容 → 导入
3. 若 heading 以 “Highlight” 开头 → 跳过
4. 小节信息（例如 “Client-side/Stateless Sessions > Page 28”）可忽略

工作流程

1. 解析文件 → 提取图书标题与作者
2. 提取用户笔记 → 仅收集以 “Note” 开头的条目（不包括 Highlight）
3. 预检 → 向用户展示：图书标题、作者、笔记数量，并请求确认
4. 确认后 → 对每条笔记调用 slipbot：
   • 类型：note（以 - 为前缀）
   • 来源：~ book, {title} by {author}
   • 由 slipbot 自动处理：文件名、标签、链接、图谱更新等
5. 报告 → 显示成功创建的笔记数量

示例

输入文件元数据：

• 标题：“The JWT Handbook”
• 作者：“Sebastian E Peyrott”

解析出的条目：

Highlight (yellow) - Page 28: "This is easily solved by..." → SKIP
Note - Page 28: "Applications should not allow unsigned JWTs..." → IMPORT

slipbot 调用示例：

- Applications should not allow unsigned JWTs to be considered valid. ~ book, The JWT Handbook by Sebastian E Peyrott

边界情况处理

• 无用户笔记（仅有 Highlight）：报告“无笔记可导入”
• 多位作者：按文件中原样保留
• 作者缺失：作者字段设为 “Unknown”
• 标题/内容含特殊字符：原样保留
• HTML 实体：存储前需解码（如 & → & 等）

支持的文件类型

• Kindle 应用导出的 .html 文件
• XHTML 文件（结构相同）
• 通过 Telegram 发送的文件（MIME 类型为 application/xml 或 text/plain）