# RKNN SDK User Guide V2.3.2 — 校对记录

## 来源与处理边界

- 中文源：`02_Rockchip_RKNPU_User_Guide_RKNN_SDK_V2.3.2_CN.pdf`，165 页；英文源：`02_Rockchip_RKNPU_User_Guide_RKNN_SDK_V2.3.2_EN.pdf`，178 页。均为 V2.3.2。
- 技术正文均从 PDF 第 7 页开始，完整保留第 1–11 章至最后一页。第 1–6 页中的封面发布日期、密级、声明、联系信息、读者对象、文档修订表和原 PDF 目录不作为文章正文；技术版本及正文内版本要求保留。网站目录复用现有功能。
- 中文按中文原稿，英文按英文原稿，俄文和德文完整翻译英文原稿；不以一份原稿静默补改另一份。代码注释、日志字段、API、命令、路径和参数保持原文。没有执行代码、安装驱动或进行硬件测试。
- 适用性为 Rockchip 平台参考，不能据此断言所有 ArmSoM 板卡支持。具体板卡、SoC、SDK/BSP、内核/NPU 驱动、Runtime 与模型算子组合仍需实际确认。

## 完整性与资产

| 语言 | 正文源页 | 技术标题数 | 合并后的可编辑表格 | 代码/日志/公式块 | 图片引用 |
| --- | --- | --- | --- | --- | --- |
| 中文 | 7–165 | 217 | 45 | 243 | 68 |
| 英文 | 7–178 | 220 | 45 | 245 | 67 |
| 俄文 | 英文 7–178 | 220 | 45 | 245 | 67 |
| 德文 | 英文 7–178 | 220 | 45 | 245 | 67 |

标题计数不含文章总标题及新增适用说明。表格计数包含截图补转的 8 张数据表；跨页连续表格已合并，重复表头在完全相同时去重。代码块计数包含原稿代码/日志、9 个公式的可编辑记法，以及截图日志转录，不表示这些示例均可独立编译。

- 中文独立资产 68 张，英文独立资产 67 张，共 135 张；俄文、德文仅复用英文 URL，不复制或伪造中文图的英文版本。
- 除所有嵌入位图外，额外保留中文 p41/45/47/49、英文 p42/47/50/51 的矢量矩阵/布局图。图中文字原样保留；图注和 alt 按文章语言本地化。
- 量化式 (6-1)–(6-9) 的原图及可编辑记法均已补齐：中文 p113–115、英文 p119/121。`round` 对应原稿描述的四舍五入；不是将源码中的 floor/ceil 函数替换为其他函数。
- 从英文 p113、中文 p107 恢复文字提取漏掉的卷积形状 `C_out × C_in × K_h × K_w` 和输入/输出方向 `C_in`/`C_out`；从量化说明恢复所有可见变量和范数符号。
- 中文 p28/29/109/131–133/149 与英文 p30/32/116/138–140/157 的精度、性能、稀疏日志和错误截图保留原图，并补可复制文本或可编辑表格。原日志中的省略号和空格单元格不补造数据。
- 页级 JSON、完整页渲染图、联系表、稳定单元映射、逐段译文、图表转录、公式裁图清单和代码审计证据保存在本任务工作目录 `work/common-batch-091-095/092-rockchip-rknn-sdk-user-guide/`，不加入正式文章索引。

## 提取及排版修复

1. 依据原页灰色代码框边界和字符位置恢复缩进；跨页代码中文合并 26 对、英文合并 25 对。代码中的数值、标识符和原稿自身错误不因排版修复而改变。
2. 修复确认属于 PDF 软折行的 `rknn-`/`toolkit2` Docker 镜像名、wheel 文件名、`/proc/device-tree/compatible`、`site-packages` 路径、Docker 命令尾部 `/bin/bash`、两段精度日志注释、RKNNLite 注释及 QAT 的单行 `from ... import ...`。原页与稳定单元保留可追溯证据。
3. 连续表格跨页合并，表格与 source 注释间留空行；管道符、尖括号和下划线在正文/表格中保护，避免被 Markdown 误识别。代码块内部不做此类转义。
4. 英文 §10.4.1 在原稿换行的 `RKNN-`/`Toolkit2` 合并为同一标题；俄文、德文对应标题完整本地化。
5. 大幅技术图独立裁取，不使用整页图片代替正文。所有位图/矢量图保留比例和标签边界；截图本身已经缺失的部分单独注明。

## 同版本中英文差异

- 中文 p129 的性能分析流程图没有对应英文图；仅保留在中文文章，英文/俄文/德文不冒充已有该英文图。
- 英文 p113 §5.11.1 增加“稀疏权重通道数必须大于 32”的限制，中文 p107 同段未给出该句。各语按所用源保留，不据此新增通用平台结论。
- 中文 p56 内存评估示例为 Memory Profile Dump；英文 p57 对应部分实际重复 Network Layer Information / Operator Time 数据。英文及其译文忠实保留，不能把该内容当作已纠正的内存统计。
- 中文 §6.1.6 KL-Divergence 描述写“最小化两个分布的相似性”，英文描述为最大化相似性；各自保留源文，并标记为语义冲突，未用译文掩盖。
- 两份原稿页数、排版、部分示例输出、标题数及截图尺度不同。正文按各自源组织；同名版本号不意味着每个数值和示例均一致。

## 原稿疑点与待核对事项

| 位置 | 原文情况与处理 |
| --- | --- |
| EN §3.5.3.1 | PerGroup 说明将共同量化参数称为 `group_size`；照录并在译文说明是原稿表述。 |
| EN p45 MatMul 表 | `AC_quant_type` 描述复用了 `AC_layout` 的 `RKNN_MM_LAYOUT_NORM/NATIVE` 布局文字，未擅自替换成推测的量化枚举。 |
| EN p52 §3.5.4.1 | 同段先写所有平台支持 `RKNN_MM_LAYOUT_TP_NORM`，又排除 RK3566/RK3568；保留冲突，需以实际 SDK 验证。 |
| EN §3.5.4 | 混合类型示例与部分 API 表的类型说明可能不一致；原值保留，不推断所有芯片实现。 |
| EN §3.4.4、§4.1.4、§4.2.3 | 路径 `examples/resent18`、正文 `build-linsx.sh` 与其他处 `resnet18`/`build-linux.sh` 不一致；源拼写保留。 |
| EN p77 动态形状示例 | 原页可见算式 `1224+140=264`、`1112+180=192` 本身缺少通常预期的乘号；不猜补。`dynamic_input` 与 `dynamic_shapes` 变量名不一致也保留。 |
| EN §5.5 | `rknn_destory` 拼写与其他处 `rknn_destroy` 不同；prepare 回调的用途描述与“reserved for future”并存，均保留。 |
| EN §5.6 | 同时介绍 RK3588 三核和 RK3576 双核，但随后部分复制/线程数量文字仍按三核描述；不得据此认定 RK3576 有三核。 |
| EN p106–107 SRAM DTS | 原图的注释确有 `/* ... /`、`/ ... */` 缺星或不完整分隔符，不是提取时漏字。保留原例而非伪称为可直接运行的修正版。 |
| EN p113 / CN p107 | 中文文字引用“表5-16”，实际图后表题为“表5-10”；各源编号保留，不静默调整引用。 |
| EN p116 / CN p110 表5-12 | 数据类型原格为 `Int8 Float16 unsupported` / `Int8 Float16不支持`，无分隔标点；译文按“支持 Int8；Float16 不支持”理解，但源格无标点，仍待核对。原始文字和原图仍可追溯。 |
| EN/CN §5.12 | 正文称保存模型调用 `rknn.export`，与前文常用 `rknn.export_rknn` 不同；不擅自替换 API 名。 |
| EN p119 / CN p113 | 量化范围和截断范围的原文字面只给 `(q_min)`、`(c_min)`，未给完整上下界；按原稿恢复可见变量，不猜补区间。 |
| EN §6.2 | 与其他章节对比，旧式 `asymmetric_quantized-8` 及部分默认值表述可能不一致；按本节原文保留。 |
| EN p127 QAT 示例 | `torch.nn.Conv`、部分 Python 缩进和训练实参具有可疑之处，未执行。仅修复明确的 import 软折行，不把原示例重写成新程序。 |
| EN p130 §6.4.7 | 句末 `setting min to 0 and max to` 缺最大值。下一行确实是编号 3 的新条目；没有把 3 当作缺失最大值拼回。译文明确指出原文缺值。 |
| EN §8.5.2 | 原文指向 §8.4.1 的交叉引用保留，未推测作者真实意图。 |
| EN §9.4 | 模型共享/`rknn_dup_context` 说明不等于已核实所有 API 线程安全；保留原稿版本边界（含 1.5.0 及前后动态形状差异）。 |
| EN §10 | `RKNN_TENSOR_UIN8`、`1data_format`、`fp16(65536)`、部分 C API 输入格式表标题与说明冲突均照录，不修改标识符、数值或单位。 |
| EN p164 示例 | `input_size_list=1,...` 等代码本身可疑，未补括号猜改。 |
| 性能截图 | `WorkLoad=300.0%`、`Up:-200.0%` 等虽异常仍保留源值。EN p140/CN p133 图片本身裁切列和单元格，无法辨认处以 `[clipped]` 标记，不补造数字；EN p32/CN p29 的右边界文本仅转录可见范围。 |
| 错误截图 EN p157/CN p149 | 原图自身右侧截断，转录只保留可见字符片段，不拼接推测的模板错误全文。 |

## 验证范围

- 本篇四语自然正文与表格翻译单元均有映射，未用英文正文回退冒充俄文或德文；保留的英文是 API、代码、日志、路径或原图文字。
- EN/RU/DE 代码块按共同英文源装配，图片 URL 共用同一英文资产集；中文独立保留对应原稿差异。
- 逐页源图、公式、跨页代码、末章及 FAQ 已纳入核对。源文件不修改；章节覆盖和文件哈希核验记录由任务工作目录审计文件提供。
- 网站构建、正式 HTTPS canonical/hreflang、sitemap、搜索、robots、实际页面和窄屏交互由主任务统一验收，本记录不以生成 Markdown 代替这些检查；未进行搜索引擎提交、DNS 变更或硬件验证。