编辑日志
2024.6.5-2024.7.11 完全重译“树莓派启动盘制作工具”https://github.com/raspberrypi/rpi-imager/pull/879
2024.7.11 “入门”校对完成
2024.7.12 “树莓派系统(Raspberry Pi OS)”校对完成
2024.7.16 对 16 个树莓派系统部件进行了翻译,已合并 15 个。1 个项目已弃用
2024.6.5-2024.7.16 改正了官方文档原文中的两个错误,补充了一个摄像机型号。已合并
2024.7.21 "系统配置"校对完成
2024.8.1
“config.txt”校对完成
“RP1”校对完成
2024.8.9 同步至官方文档的 2024.8.9 版本
2024.8.15 实现代码高亮
2024.9.4
同步至官方文档的 2024.9.4 版本。
“旧版
config.txt参数”校对完成将发现的一个命令错误,一个排版问题提交到树莓派上游,已合并
2024.9.7 请求树莓派上游更新树莓派启动盘制作工具的版本以包含最新的简中翻译,https://github.com/raspberrypi/rpi-imager/issues/915
2024.9.8 同步至官方文档的 2024.9.8 版本。
2024.9.12
树莓派上游发布了树莓派启动盘制作工具v1.9.0
测试了树莓派启动盘制作工具v1.9.0
将本项目的翻译、图片同步到树莓派启动盘制作工具v1.9.0
修正了关于树莓派启动盘制作工具v1.9.0 翻译的几处小错误 https://github.com/raspberrypi/rpi-imager/pull/922,已经合并,预计随 v1.9.1 分发
“Linux 内核”校对完成
2024.9.14 “远程访问”图片本地化
2026.10.18
重写 AGENTS.md 使其适配本项目(原为 FreeBSD 手册项目模板):更正同步基线为 1b7709f(2024.9.8,此前误记为 f0511a2),补充原文获取、同步上游、翻译校对等工作流及本项目实际格式规范
核对 27 个中文页面与上游 1b7709f 结构一一对应,SUMMARY.md 无缺失条目
修复 mu-lu.md 微控制器表格:5 张卡片误入 3 列表格,导致 MicroPython、C/C++ SDK 两卡在渲染时被丢弃;C/C++ SDK 卡片误链 micropython.md 并误用 TV HAT 配图,已改为正确链接与官方 C-and-CPP.png 配图
mu-lu.md 保持手工维护的 HTML 卡片目录页(不采用 SUMMARY 自动副本方案);AGENTS.md 适配新增的 GitHub Actions 自动化(sync-headers、markdownlint、check-images、links 等)
同步「远程访问」页至当前上游:树莓派配置改为控制中心(Control Centre)、Imager 步骤改为 Remote Access 标签页开关式流程、新增「限制可连接的用户」一节(AllowUsers/DenyUsers)、Apache 教程上游已删除改为指向官方文档、网络启动改「树莓派 3 或更新机型」、MAC 地址节更新为「树莓派 4 及后续旗舰机型」
「远程访问」全页逐段逐句校对(约 160 处):补全漏译(Connect 的公网 IP/防火墙与 Wayland 远程 shell 能力、default-jre 安装命令)、术语统一(NFS export → 导出,已补录词汇表)、修正语态错误与病句、直引号改中文曲引号、修正上游原文笔误 2 处(IPv6 网络启动一节 FTP 应为 TFTP、/proc/mounts 反引号错位;另有 Atfer→After 拼写错误属上游原文,中文不受影响,待向上游反馈)
「远程访问」图片同步:raspberry-pi-configuration.png、vnc-enable.png 更新为当前上游 Control Centre 版截图(中文 UI 重制版待后续在中文系统上重截)
「计算模块硬件」同步至当前上游(CM5 时代):总述改写与型号总表(新增 CM5)、IO 板与兼容性总表、新增「CM5 与 CM5IO 配件」(机箱/天线/散热器)、刷写流程更新(CM5IO、Windows 11、mass-storage-gadget64)、CM5 设备树与内核要求、摄像头新增 CM5 跳线步骤、显示屏一节改为指向触摸显示屏页面、规格新增 CM5/CM5IO 数据表并更新全部设计文件链接
结构核对:当前上游新增 accessories 11 页(AI Camera、AI HAT+、Bumper、CM5 Programming Jig、Monitor、SD Cards、Smart Display Module、SSD Kit、SSDs、Touch Display 2、USB 等)、computers 6 页(AI、IO Controllers、Keyboard Computers、SBCs、Software Sources、Zero)、microcontrollers 2 页(Radio Modules、Microcontroller Chips 重组)、security 板块 5 页、services 2 页(Bookshelf、Connect for Organisations),待后续补遗
补遗完成 21 个新页面:computers 新增经典型单板计算机、键盘计算机、Zero 型号、I/O 控制器、软件来源、人工智能软件;配件新增 SD 卡、SSD、SSD 套件、触摸显示屏 2、显示器、AI 摄像头、USB 配件、AI HAT+(AI HATs)、CM5 编程治具、智能显示模块、Bumper 保护壳;新增「安全」板块 5 页(安全概述、安全架构、安全启动配置器、运营安全、使用 UFW 的防火墙);服务新增 Connect 企业版、书架(Bookshelf)
SUMMARY.md 按上游导航全面重排(computers/accessories/microcontrollers/services/security 五板块顺序),服务标题去掉 Beta 版;mu-lu.md 卡片同步(配件 20 张、服务 4 张、安全 5 张)
记录上游原文异常(待向上游反馈):SBC 页 Raspberry Pi 4B 节误写为 Raspberry Pi 5;键盘计算机页 io-controllers xref 语法损坏;AI 摄像头页 IMX5000 应为 IMX500、"the the" 重复;安全启动配置器页 image 属性多余引号;运营安全页 fail2ban 示例缺少等号
2026.10.20
F 波 13 路代理完成 52 页中最后 15 页的上游同步,至此全书 52 页全部完成结构对应与内容同步(CP-2、CP-3 通过)
全新同步 11 页:入门(Imager 新版 UI、关机选项等)、树莓派系统(Trixie、Lite 转桌面、69,000 软件包)、系统配置(15 节,含进一步参考)、
config.txt(全文重写,989→1316 行,默认值全面核对)、旧版config.txt参数(删除已迁移参数节)、微控制器 3 页(调试套件改 VS Code 扩展路线、MicroPython 链接更新、SDK Blink universal)重写 2 页:Pico 系列(上游结构重构,新增 Pico 2 W 与带排针型号、datasheets→pip.raspberrypi.com 全部链接迁移)、
config.txt多管道核验补齐 6 页:零型、人工智能软件、经典型单板计算机、键盘计算机、软件来源、服务 4 页
处理记录:F6 首轮报告失实(编辑器缓冲未刷盘),打回后二次重做通过;F3 初轮漏译 reference 全节,打回后补录通过;F12 无报告失联,3 页成果经自动提交落盘,由 F13 接替完成服务 4 页核验
词汇表补录 46 条新术语(均先在实际页面验证用例);修正 AI Kit→AI 套件大小写
登记上游原文异常 17 条(详见 TASKS.md 第七节),待向上游反馈
52 页已同步,下一阶段为逐页三轮校对,从已同步列表推进:远程访问、计算硬件、摄像头软件、处理器、Pico 系列、零型等
2026.10.20(遗留问题处置)
词汇表补录 I/O 控制器页 5 条术语(I/O controller、ISP front-end、USB host controller、single-board computer、pin spacing),累计 F 波补录 51 条
换行符统一:实际 LF 文件共 27 个(26 个内容页 + TASKS/AGENTS/mu-lu),已全部转为 CRLF,全仓库一致
图片本地化完成:通过上游 GitHub 仓库浅克隆按文件名定位,301 张下载至
.gitbook/assets/,39 页 317 处引用替换;6 处上游已移除的图片(build-hat 页 GIF 与 tall-headers.png)保留原链待处理硬件页缺节确认并派 F14 补录:上游
boot-eeprom.adoc(重置/配置/自动更新/发布状态 4 节)与bootflow-legacy.adoc(BCM2837 旧版引导顺序)在中文页无对应,此前 B1 疑点坐实
2026.10.20(F14 收尾与缺节误判澄清)
主线程通过 GitHub API 核对上游
computers/raspberry-pi/目录,确认该目录下恰有 27 个.adoc子页;中文「树莓派硬件」页经 grep 统计同样为 27 个 H2,与上游 1:1 对应,无缺失F14 拟补的两节实为误判:
boot-eeprom.adoc已对应中文「## 树莓派引导 EEPROM」(line 144,含重置/配置/自动更新/发布状态 4 个 H3,内容完整);bootflow-legacy.adoc上游标题即 "Boot sequence",已对应中文「## 引导顺序」(line 1126,含 BCM2837/BCM2837B0 IMPORTANT 提示块与bootcode.bin流程,结尾 usbboot GitHub 句与上游一致),内容完整结论:硬件页 27/27 节完整,无需新增任何内容;此前「缺两节」判断系结构核对疏漏,已在 TASKS.md 勘误
CP-3 抽查硬件页:0 个「」、0 个 xref:/link:/image:: 残留、代码围栏 224(偶数)、弯引号 12/12 配对、无行尾
+软换行、CRLF 保留;合规TASKS.md 更新:4.1 硬件页行负责人改 F14(主线程复核)、第五节 F14 行标记完成、六节 P0(F 波)/P1(硬件页缺节)均标记为完成并澄清误判
注:F14 代理在续跑请求时连续两次遇框架层 500 错误,因主线程已确权无需补录,该渠道故障不影响收尾
2026.10.20(三轮逐句校对启动)
主线程完成 3 页三轮校对与复查:「处理器」(11 处修订,含提示块
>后多余空格 5 处、heat spreader 译法、potentially误译、双重「的」与并列结构)、「无线电模块」(6 处修订,含补译漏句「本页仅介绍 RM2。」并校正其位于 RM1/RM2 列表之后)、「微控制器芯片」(3 处修订,「带插针」改「带排针」与 Pico 页统一、架构切换句语序、licence 句宾语错位)术语表:
heat spreader由「散热片」改「均热盖」,新增heatsink→「散热片」,避免同页两词混同换行符:
CHANGELOG.md此前为 LF,转为 CRLF,全仓库 55 个 Markdown 文件换行符一致子代理并行推进 33 页三轮校对(计算模块、摄像头软件、系统配置、树莓派硬件、config.txt 两页、键盘计算机与内核、Build HAT 与音频板、摄像头与显示四页、配件若干、安全 5 页),逐个文件验收
H4 验收通过:「入门」「树莓派系统」两页各 20 处修订(Full 术语、硬编码引用内部化、逻辑反转句、上游无对应的 GitHub 增补句删除),主线程逐一核对 diff 与 10 个跨页锚点;遗留 raspberry-pi-os L514 锚点待 CI 验证;H4 另报 11 条上游异常
H12 因 429 频率限制中断(56 分钟),主线程接手安全板块五页:逐句对照上游 2304 行,验收 H12 已落盘 43 行改动(「一线安全披露」=Frontline security disclosure、「OTP 内存」「一次性可编程」均经上游与词汇表核实正确),补 2 处「存储卡」→「microSD 卡」;记录上游异常:operational-security.adoc 两处 ini 代码块缺 jail.conf 语法必需的等号
进度:52 页中 11 页复查通过(树莓派 4、微控制器 2、安全 5),安全板块 100%;mu-lu.md 补缺「键盘计算机」卡片(CP-4 复核发现树莓派板块 16/17 张);CHANGELOG 由 LF 转 CRLF,全仓库换行符统一
微控制器板块收官(6/6 复查通过):主线程逐句校对 micropython / c-c++-sdk / debug-probe / pico 四页;Debug Probe 全仓译法统一为「调试套件」42 处并修订词汇表(Debug Probe/Probe → 调试套件,GDB 语境保留「调试器」);修复主线程提示块脚本误改的 3 行 gdb 代码块(代码块内
>前缀恢复);Pico 页修复 4 处直引号与有序列表编号;c-c++-sdk 修复 H4 改标题导致的失效锚点服务板块:书架页零修改通过;账号页 1 处半角括号;短页校对补齐
全局工程修复:80 处提示块
>空格清零、29 处正文直引号、3 处标题句号、上轮 mu-lu 补卡图片引用修复:6 个板块目录下 39 个页面共 323 处
](.gitbook/assets/…)补全../前缀;修复后全仓 368 处图片/视频引用经相对路径解析验证 100% 命中根目录.gitbook/assets/,外部报告的 226 项缺失全部闭环;check-images.yml的误导性计数(把引用字符串当文件路径)不改变仓库实际状态进度盘点与规则更新(供下次更新接手):README「版本说明」重写为当前状态(52 页已同步上游 master、29 页复查通过及板块明细,替换过时的 2024.9.8 表述);AGENTS.md 新增「当前进度快照」段(29/52、剩余队列、工程项清零状态、新规提醒);本日全量成果:安全板块 5 页与微控制器板块收官、配件 10 页/树莓派 6 页/服务 2 页复查通过、图片引用 323 处补 ../ 前缀并 368/368 验证、提示块空格 80 处与正文直引号 29 处清零、GPG 提交环境修复、新规禁止日式引号「」『』(AGENTS.md f354d7f)
项目收官:52/52 页全部完成三轮逐句校对 + 复查(100%)。服务板块最后两页(Connect 1269 行 vs 上游 9 文件 1373 行、Connect 企业版 2080 行 vs organisations.adoc 2532 行)零新增修改通过——脚本比对管理 API 端点 27/27、HTTP 状态码 8/8、字段定义 26/26 全对齐,批量预配 8 步逐字核对;README 与 AGENTS.md 进度快照同步更新为 52/52(100%)
清理非项目必需文件:删除逐页任务书 TASKS.md(402 行,三轮校对已全部完成,进度改由 AGENTS.md 快照与本日志承载)、上游重复副本 state/(6 个 adoc,与 script/upstream-security/ 逐字节相同)、抓取失败残留 script/upstream-security/secure-boot.adoc(内容为 "404: Not Found")、临时基线 script_baseline_cam.txt、临时目录 .kbc_tmp/ 及会话备份;AGENTS.md 改写开头为「下次同步上游时怎么做」六步流程,README 移除 TASKS.md 链接并更新项目结构表
工作流改为按需拉取上游 diff(2026-10-21):因 script/ 基准目录已删除,AGENTS.md 新增「下次同步上游时怎么做(按需 diff 增量增补)」七步流程——临时目录克隆上游 master、git diff BASE..HEAD 生成差异清单、52 页中文页↔上游 adoc 路径映射表(全部线上验证可达)、只增补受影响页、内联质量门禁脚本、收尾登记(CHANGELOG/README/GPG 提交/清理临时目录);README 校对标准与项目结构表同步改写;仓库内严禁再建 script/ 或 upstream-* 目录
文档职责重整(2026-10-21):校对翻译相关规范集中至 AGENTS.md——「原文获取」节新增 GitHub 提交数虚高警示、git diff 仅作定位工具(译文仍以官方网页为权威)、DeepL 禁令完整条文;CONTRIBUTING.md 的「追踪上游的人的建议」节精简为指向 AGENTS.md 的索引(保留 DeepL 警告与 issue/PR 指引);恢复「比对脚本与日志放在 script/ 目录(不存在时创建)」的约定(上游 adoc 副本仍不得入库)
mu-lu.md 卡片图片本地化:52 张卡片图由线上 URL(raspberrypi.com/documentation/images/…)下载至 .gitbook/assets/(新增 47 张,全部 200 且 >500 字节),引用改为本地相对路径,线上 URL 残留 0
图片资产三项审计与整改(2026-10-21):新增 script/audit_images.py(唯一性/悬空/本地化/大小写/前缀六项检查)与 script/audit_duplicates.py(内容哈希查重)。整改结果——删除 28 张悬空图片(2.59 MB:raspi-.png 6 张、os-customisation-.png 4 张、Imager 旧版 UI 9 张、bootloader-*.png 2 张、网络安装 3 张、Updating-Pi-firmware/apache-it-works/misc-utility-images/recommended-software 各 1 张;已核实当前上游 master 全树 0 引用,均为旧版遗留);合并 2 组同图(ai-cam.png→ai.png、sd-cards.png→microSD.png,上游本即同图同哈希);修正 mu-lu.md 1 处大小写不匹配(Display.png→display.png,Windows 通过但 GitBook 构建会失败)。assets 426→396 个,全部被引用、零站外引用、零大小写重名
2026.10.21(图片资产全量替换为上游原图)
背景:用户质疑“引用的图片和上游只是名字一样,实际不是一张图片”。以本地 en/ 上游仓库镜像(main @ bce7571)为基准全量复核 397 张本地图片 + 17 个 SVG/WebM(不抽样)
复核结论:字节一致 307 张;仅编码差异(透明背景 vs 白底、重压缩)345 张,属同图;SVG/WebM 17 个全部字节一致;核心问题为 47 张目录卡片图与 13 张同尺寸不同内容图(其中 12 张为摄像头页 JPEG 重编码噪声 ≤0.17%,1 张 GPIO.png 差 2.29%);实为同名异图
处置(用户决策:全部替换为上游原图、原名覆盖、冲突允许别名):替换 88 张(含目录卡片图 47 张、摄像头页 12 张、远程访问页 7 张、系统配置页 3 张、4 个扩展名不一致项 key.png / wifi2.png / network-hidden.png / thonny-venv.png 由上游 .jpg 无损转码为真 PNG、3 张映射别名项);字节一致 309 张跳过
卡片图与正文图同名冲突(3 组)改用别名拆分:display.png 保留正文源(accessories/display/images/display.png),新增 display-card.png(images/full-sized/Display.png)供 mu-lu.md 卡片;ssd-kit.png / ssd-kit-card.png、RM2.png / radiomodule-card.png 同理;mu-lu.md 三处卡片引用同步更新
覆盖的本地化成果(用户明示弃用):2024.9.14“远程访问”图片本地化的 7 张中文界面截图(network-tooltip.png、vnc-tigervnc-desktop.png、vnc-tigervnc-show-dot.png、vnc-tigervnc-username-password.png、vnc-tigervnc-enter-ip.png、vnc-tigervnc-cert-warning.png、vnc-tigervnc-cert-signer-warning.png)及 raspi-config.png(系统配置页)改为上游英文原图
别名规则例外:本地独有 7 张按别名定位上游源——compute-module-cm3.jpg → compute-module/images/cm3.jpg(字节一致)、imager-are-you-sure.png → getting-started/images/imager/are-you-sure.png(像素一致)、sd-card2.png → images/full-sized/sd-card.png(像素一致)、GPIO.png → raspberry-pi/images/GPIO.png、key.png / wifi2.png / network-hidden.png / thonny-venv.png → 对应页面 .jpg 转码
验证:assets 400 个(原 397 + 3 别名);字节一致 392、像素一致 4(转码项)、无孤立、无悬空、零站外引用、零大小写重名;质量门禁 55 页输出“问题文件 1 个”(qian-yan/guan-yu-wo-men.md 换行混合),经核为仓库既有状态(HEAD 版本即 LF,非本次引入),留待后续处理
脚本留存:script/compare_images_upstream.py(逐张比对)、compare_alpha_aware.py(alpha 感知判定)、build_replace_plan.py、collect_scenes.py、final_replace_map.py(映射生成)、apply_replacement.py(执行,支持 --dry-run);日志 script/replacement_log.txt、script/final_replace_map.csv;备份 /tmp/assets_backup_rpicn(397 个,93 MB)
最后更新于
这有帮助吗?