今日重点:📖 阅读——今天 linux-media 上来了一份稀有材料:因斯布鲁克大学学生 Christian Koever-Draxl 把 Amlogic S4 的整条 BSP 栈推上游,cover letter 里写了一段 AI 协作披露——坦白说自己大量用了 Claude Code,同时把「AI 干的活」和 「人担的责」切得清清楚楚。这种披露 2026 年起内核社区开始要求 (Documentation/process/generated-content.rst),他这段写法几乎是模板。 精读一遍,你以后写任何 AI 辅助的贡献说明都能用。
📖 阅读:四句话的披露段
/ sectionThis work was done with the help of an AI coding assistant, Claude (Anthropic), used through Claude Code over many sessions. It did a large part of the hands-on work: it read the vendor kernel and the firmware interfaces, probed registers on the board, drafted the code and the changelogs, and ran the builds, checkpatch, dt_binding_check and the tests on the hardware. I directed the work, reviewed every change and the final patches, and take responsibility for them. There is no single prompt to quote; the sessions were of the form "find out why X fails on this board, fix it, test it on the box".
这段四句话的披露,结构就是「承认 → 分工 → 担责 → 答疑」。 第一句承认事实:用被动式 This work was done with the help of ... 把 AI 直接摆上台面,括号注明公司(Anthropic)与工具(Claude Code),「over many sessions」 交代这不是一次性问答,而是长期协作。 第二句切分工:主语换成 It(指 AI),冒号引出四个并列动词—— read / probed / drafted / ran——全是「动手类」动作;关键定语是 hands-on work(动手活、操作层的工作),这是整段最关键的措辞, 把 AI 的贡献精确限定在「操作」层,不是「决策」层。
第三句换人出场:主语从 It 切到 I—— I directed the work, reviewed every change and the final patches, and take responsibility for them。三个动词 directed / reviewed / take responsibility 一个比一个重,刚好对应「指导 → 审查 → 担责」三层。 整段的法律/伦理重量全压在这句上——告诉维护者:补丁是我签的,问题找我。 第四句预防性答疑:预料到读者会问「那 prompt 是什么」,直接堵回去—— There is no single prompt to quote(没有一条单一 prompt 可以引用), 分号后给出原因:session 的形态是「找出为什么 X 在这块板子上失败、修掉、在机器上测试」。 这一刀把「会不会是 AI 一键生成」的怀疑拆干净了。
★ 句式与语汇拆解
with the help of an AI coding assistant —— 正式场合致谢/披露的标准开头。help 暗示「辅助不是替代」,比 using AI 的语气更稳妥。套用到自己的工作:This series was prepared with the help of <工具名>。 There is no single commit to revert; the regression came from a combination of ... 🔗 原文
✨ 辅助彩蛋(术语卡)
/ column★ bit-exact / bit-exactness(位精确)
Bit-exactness was checked against ffmpeg/libavcodec frame by frame for H.264, VP9, AV1 and HEVC conformance and real-world streams; MPEG-2 differs by the hardware's IDCT rounding. frame by frame(逐帧)强调比对的粒度。 MPEG-2 differs by the hardware's IDCT rounding——MPEG-2 不 bit-exact,原因是硬件的 IDCT 舍入差。codec 评审里这种「主动报告不一致项」比宣称全过更赢得信任。 🔗 原文
✍️ 今日练习
/ column💡 显示答案
Admit it, split the labor, own the result, preempt the follow-up — four sentences is all a disclosure needs.
素材:lore.kernel.org linux-media · Amlogic S4 vdec cover letter(Christian Koever-Draxl,〔10-25 19:25 UTC〕)· 内核英语 · 每日一篇