kpw2导入图书后不显示封面或元数据丢失？

Question

kpw2（Kindle Paperwhite 2）导入图书后封面不显示或元数据（如标题、作者、出版年份）丢失，是常见兼容性问题。根本原因多为电子书格式不规范：EPUB/MOBI文件若未嵌入标准OPF元数据、封面未正确声明为`cover.jpg`或未在`guide`/`spine`中正确定义，KPF固件（尤其旧版5.x系统）将无法解析；此外，Calibre转换时若勾选“移除现有元数据”或未启用“生成封面”，亦会导致信息清空；USB直传时若文件名含特殊字符（如中文、空格、括号），部分固件会跳过元数据读取。另需注意：KPW2不支持EPUB原生显示（仅通过转换），而第三方工具（如KindleUnpack）解包修改后若未重新签名或结构错乱，亦触发元数据丢弃。建议统一用Calibre 5.40+导出MOBI（含ASIN）、验证OPF完整性，并禁用“优化排版”选项以保留封面关联。

Answer 1

```html

一、现象层：KPW2图书导入后元数据与封面“消失”的可观测行为

• 设备端显示为默认灰色封面（或空白矩形），标题显示为“Unknown”或文件名（如 book.epub）；
• “我的图书馆”中作者字段为空，出版年份缺失，点击图书无详情页；
• 通过USB连接电脑查看 documents/ 目录下MOBI文件，其内部结构未包含 cover.jpg 或 content.opf 中 <meta name="cover" content="cover-img"/> 声明；
• 同一本书在Calibre预览窗中显示正常，但推送到KPW2后失效——典型“本地渲染OK，固件解析失败”特征。

二、协议层：KPW2固件（5.x系列）对电子书元数据的硬性解析规则

KPW2运行Amazon定制Linux内核 + KF8/KF7双模渲染引擎，其元数据提取严格依赖以下三重校验：

校验维度	合规要求	违规后果
OPF规范性	content.opf 必须含 <dc:title>, <dc:creator>, <dc:date> 且命名空间正确（http://purl.org/dc/elements/1.1/）	跳过整本元数据加载，回退至文件名解析
Cover声明	OPF中需有 <guide><reference type="cover" title="Cover" href="cover.jpg"/></guide>，且 cover.jpg 必须位于OEBPS根目录	封面不渲染，封面缩略图区域留白

三、工具链层：Calibre 5.40+ 配置关键路径与陷阱规避

1. 【输入】禁用“移除现有元数据”（Preferences → Conversion → Common Options → Remove metadata → ✅取消勾选）；
2. 【封面】启用“生成封面”并设置尺寸为 600x800（KPW2物理屏分辨率适配）；
3. 【输出】导出格式选择 MOBI (new)（即KFX兼容MOBI8），勾选 Include ASIN（触发固件元数据缓存重建）；
4. 【高级】在 Output profile 中选择 Kindle Paperwhite，并禁用“Optimize typography”（该选项会重排HTML结构，破坏OPF中spine顺序与cover绑定）。

四、传输层：USB直传的字符集与文件系统兼容性约束

KPW2固件5.6.5及更早版本使用FAT32文件系统驱动，对Unicode支持薄弱：

• 文件名含中文、空格、括号（如 《三体》.epub）→ 固件调用 libgen 解析时触发UTF-8截断，元数据读取中断；
• 推荐命名规范：Author_LastName_Title_Year.mobi（ASCII-only，下划线替代空格）；
• 验证方法：推送后执行 ssh root@kindle 'ls -l /mnt/us/documents/' | iconv -f utf8 -t ascii//ignore，若输出含 ? 则存在编码污染。

五、深度诊断：基于KindleUnpack与OPF结构完整性验证流程

graph TD
    A[原始EPUB/MOBI] --> B{KindleUnpack解包}
    B --> C[检查OEBPS/content.opf]
    C --> D[验证dc:title存在且非空]
    C --> E[验证guide/reference[@type='cover']]
    C --> F[验证spine/itemref[@idref]指向有效item]
    D & E & F --> G{全部通过？}
    G -->|Yes| H[重新打包+签名]
    G -->|No| I[用Calibre修复元数据后重导出]
    H --> J[推送至KPW2测试]

六、工程化建议：构建KPW2兼容性CI流水线（适用于企业级数字出版）

• 自动化脚本校验OPF：使用 python -m lxml.etree --noout content.opf 验证XML良构性；
• 元数据强制注入：通过 calibredb set_metadata --field=title:"${TITLE}" --field=author:"${AUTHOR}" 批量修正；
• 封面一致性检查：用ImageMagick验证 identify -format '%wx%h' cover.jpg 是否为600×800±5px；
• 固件模拟测试：在QEMU中运行KPW2 kernel镜像，挂载USB存储并监控 /var/log/messages 中 kindle-book-parser 日志。

```