# 096 RKLLM SDK 1.2.3 校对记录

## 来源和边界

- 中文原稿：`cn/Common/NPU/rknpu2/Rockchip_RKLLM_SDK_CN_1.2.3.pdf`，65 页；英文原稿：对应 `en/Common/NPU/rknpu2/Rockchip_RKLLM_SDK_EN_1.2.3.pdf`，77 页。均为 1.2.3，不是内容完全相同的排版副本。
- 两稿第 7 页起至最后一章“相关资源”完整保留。第 1–6 页封面、文档修订记录、静态目录不作为正文；网站复用动态侧边目录。页眉公司名、网址、页码不混入正文。未修改 PDF；SHA-256 见本批来源清单。
- 中文以中文原稿为准；英文以英文原稿为准；俄文、德文全文和表格逐项翻译英文稿。代码、命令、API、路径、数值和原始日志保留英文稿写法；不把中文示例的不同参数静默覆盖英文稿。四语正文均有来源和适配声明。
- 原稿指定 RK3576/RK3588/RK3562/RV1126B；RKNPU 驱动检查 0.9.8；内核讨论 5.10.209/6.1.84。ArmSoM 具体板卡、SDK/BSP、内核、Runtime/Toolkit、模型组合未经硬件验证，仅为平台参考；不宣称所有板卡支持，不把原厂数据当 ArmSoM 实测。

## 配图与可编辑内容

- 中文 8 张独立原图；英文 8 张独立原图供 EN/RU/DE 共用，包括内核错误、性能输出、Flask 日志、Flask 流程、Gradio 页面、Gradio 日志、Gradio 流程、API 终端。来自原稿对应图像区域，没有用整页截图替代正文；图例和标签保留。
- 图像清单和页码见 `assets/` 文件名：CN 12/46/50/51/60/61/62/63，EN 13/56/60/61/72/74/74/76。
- 5 组日志另有可复制转录；原始终端账号已被原稿模糊，不尝试还原。模型回答福州地理信息不作事实背书，只保留原始生成示例。英文原图中的中文界面/模型回答没有伪称已英文化。
- API 表恢复为 Markdown 表；跨页 build 和 RKLLMParam 表合并续行，保留所有参数。模型架构字符图保留可编辑等宽文本。代码先于表格识别，避免灰底代码被误识别为多列表格。
- 修复 PDF 丢失空格、中文两字间的版面对齐空格、列表边界、URL 和参数软断行、字符串被分页切开的续行。跨页工具 JSON 和 multi-batch 示例连续保留；灰框末行按原始坐标恢复，未因字体下沿越界漏掉最后一行。

## 原文疑点（保留，未猜测修正）

1. §2.4 要求 driver 0.9.8，§3.3/3.4 图片示例却显示 Runtime 1.0.2b9 / driver 0.9.7。按历史原始示例保留，不能证明当前组合可用。
2. §3.1.3 英文 `normal_r[164]` 是原页可见写法，不擅自补 `~`；与 `gdq_r[1~64]`、示例算法名需对照 SDK 头文件/实现。部分 RK3562 量化类型不在总列表内，保留差异。
3. §3.1.4 `RKNN` 模型字样及代码全角右括号 `）` 是原稿写法；未按推测改成另一个 API 或可执行括号。
4. §3.1.6 QWen 类示例、§3.4 客户端响应解析示例原稿缩进不一致。已按源页物理缩进提取，不虚构正确控制流；不能直接保证运行。
5. RKLLMResult 的 `vocab_size` 说明指向 token_id；回调状态 `RKLLM_RUN_FINISH` 与 `LLM_RUN_FINISH` 不一致；`RKLLMPerStat`/`RKLLMPerfStat`、指针类型位置、`encoder mask` 空格等均保留并待查头文件。表 3-9 编号重复、Function Tools 表题与函数名不一致也未重编号掩盖。
6. §3.2 prompt cache 生成 `/data/prompt_cache.bin`，加载 `./prompt_cache.bin`；原稿 `ret` 检查的赋值关系需核对。多 batch 示例含重复分号、未定义 `exit_handler` 等，不宣称编译通过。
7. §3.3 `demo_Linux_aarch64` 与 `demo_linux_aarch64` 路径大小写不同；`example/` 与 `examples/`、部分脚本赋值处于注释内，均待核对。未将注释擅自变成可执行命令。
8. §3.4 请求示例混用 JSON `false` 与 Python `False`/`None`；响应 JSON 含尾逗号。`messages` 描述与响应 `message` 字段不同。按原文保留，不称标准 JSON 验证通过。
9. §3.4.2 英文图 3-6 图注写 Flask 而正文是 Gradio；一些图 3-2/3-3 交叉引用不一致，未静默改写。源码、图片与图注保持可追溯。
10. “最新版本”均限于本 PDF 1.2.3 的上下文，不承诺当前线上 SDK 最新版本或实时模型兼容性。

## 安全与未执行事项

原稿 `verify=False`、`trust_remote_code=True`、`chmod 777`、驱动覆盖、内核刷写、`0.0.0.0`、`share=True` 属于原始开发示例，已在四语正文提示风险。未运行模型、下载脚本、写板卡、公开服务或更改远端。示例私网 URL 不代表本网站预览地址。

2026-10-22 两篇统一验收完成：Jekyll 构建、8 个实际页面、四语搜索、sitemap、canonical/hreflang、桌面/390px 窄屏目录和图片 HTTP 检查通过，证据见 `docs/common-batch-096-097/`。未完成且不能替代的是实体硬件兼容性、模型运行及生产环境验证。新批次未 commit、未 push、未发布、未提交搜索引擎。