# 097 Vendor Storage 校对记录

## 来源与范围

- 唯一原稿为 `cn/Common/NVM/RK_Vendor_Storage_Application_Note.pdf`，23 页，实际正文英文，文档 ID `Appnote_rk_storage_0001`，Rev.08。英文目录没有对应 PDF，不能伪称中英文各有一份。
- 完整保留第 4–23 页技术内容：概要、架构、全部存储布局、记录字段、全部 ID、64 字节对齐、U-Boot/Kernel/PC API、内核配置、PC 工具操作和最后 Linux 读写代码。前 3 页封面、修订表、静态目录和各页密级/页脚移除；不移除代码内技术注释。原 PDF 不修改，哈希见批次清单。
- 英文按原稿技术内容恢复；中文、俄文、德文完整翻译。四语共用该英文原稿的图，不是另行取得的中文图。原稿未明确 SoC/板卡/SDK/BSP/内核组合，全部标注平台参考，未进行硬件读写或掉电试验。

## 图片和提取修复

- 3 张矢量技术图按独立图像区域渲染：第 5 页架构、第 6 页 NOR/EMMC、第 7 页 NAND MTD/FTL。不保留封面/整页作为正文；全部图中文字、箭头和注释保留。初次裁图的边缘标签经原页对照扩宽，防止裁掉 NAND 注释和底部框。
- 6 张原始位图：第 14 页 Makefile/menuconfig 各一张，第 15–17 页 PC 操作各一张，第 18 页项目文件列表一张。四语共用 9 张英文原图，图注/alt 本地化。
- 第 8–10 页记录和 ID 表恢复为可编辑表；完整合并第 9–10 页 ID 列表，范围 0–65535 不变。Makefile/menuconfig 截图另转录为可复制文本；PC 文件名另转录，不猜被截断后缀。
- 修复签名跨行、列表符号、页脚侵入代码、C 缩进和源码换行；`Size – 0x08`、`0x524B5644`、`0x56524551`、IOCTL、ID 和缓冲区大小未改。API 参数表描述本地化，标识符保留。

## 原文疑点及安全边界

1. 第 6 页 SPI NOR 图标注 4K / 28K，展开区标出四个 4K 块；EMMC 为 3.5M / 256K，展开区四个 64K。只描述图上标签，不假设所有 BSP 使用同一偏移或把图当分区操作指令。
2. 第 8 页 `Item0->flag(reversed)` 中 `reversed` 原样保留，不擅自改成 `reserved`。
3. 第 9 页 ID 10 是 `ATTENTION KEY`，不猜测改名。第 10 页 ID 19/20 保留不同的 `HDCP_2X_RX_ID` / `HDCP_2X_HDMIRX_ID`。
4. 第 19–20 页为 Windows C++ 接口，`USHORT &nBufferSize` 引用参数、`BOOL`、`PBYTE`、`DWORD`、默认参数 0 原样保留，不冒充纯 C 接口。
5. 第 21 页定义 `uint16/uint32/uint8`，结构体却用 `u16/u32/u8`，示例未给这些别名；`unsigned long` 在不同 ABI 不保证 32 位。未按猜测替换类型或声称结构布局可直接通用。
6. 第 22–23 页 `ERROR`、`rknand_print_hex_data` 未定义；示例未关闭 `sys_fd`，读取示例有未使用变量。按原文保留，不宣称独立编译通过。
7. 写入示例会将 SN ID 1 改写为 32 字节递增值；四语开头明确警告。未执行原稿任何写操作，未访问设备节点，也未编造成功或耐掉电结果。

2026-10-22 两篇统一验收完成：Jekyll 构建、8 个实际页面、四语搜索、sitemap、canonical/hreflang、桌面/390px 窄屏目录及图片 HTTP 检查通过，证据见 `docs/common-batch-096-097/`。实体硬件兼容性、读写和掉电可靠性未验证。本地验收不等于上线；新文章等待用户发布指令，不自动 commit/push。