上一篇30-1《文章矩阵三层漏斗与互相引用》 下一篇30-3《结营30 天之外——同态加密内核与论文预告》源码精读篇本文为源码/方法论精读无独立实测文中数字均引述仓库 docs 的板端实测记录一句话导读推理引擎贡献指南一个工程仓库的寿命取决于协作回路——讲 Issue 要带哪些字段作者才能复现、复现数据为何比复现结论更有价值以及报告你发现的坑为什么是贡献而不是冒犯。关键词手搓推理引擎、大模型推理、贡献指南、Issue、复现数据、协作回路一个工程仓库的寿命取决于协作回路作者发布 → 使用者跑 → 使用者反馈 → 作者修。本篇讲反馈端怎么写得专业Issue 要带哪些字段作者才能复现、“复现数据为什么比复现结论更有价值、以及报告你发现的坑”bug/口径不符为什么是贡献而不是冒犯。仓库的入口在 README 联系区220–227 行docs 清单是反馈的背景资料。1. 知识点好 Issue 的可复现三件套作者收到一条 Issue第一反应永远是三个问题你跑的是什么你给了什么参数你看到什么好 Issue 自带答案字段内容为什么作者需要环境板型 / 架构 / 编译方式 / 源码 commit29-2 的教训行为随板画像切换复现步骤完整命令 模型目录 参数缺一步就无法本地复现期望 vs 实际你期望什么、实际得到什么日志贴原文定位是行为偏差还是口径没对齐再加一条最高价值的你对照 docs 做了什么——因为很多bug其实是文档口径没读全28-3 复现差异、25-2 的摘要口径都是这类。Issue 里先写我按 docs/xxx 的第 y 节做了 z结果与文档不符作者一眼就能判断是文档 bug、代码 bug 还是操作偏差。2. 对应代码/文档反馈回路的两端输入端使用者README 联系区220–227 行——商业授权 / 研究合作 / 复现数据398152090qq.com或 Issues。复现数据请求在 README 里与商业授权并列说明复现你的报告是作者认可的正式诉求28-3 的附录也声明可按表结构自建或联系作者。接收端作者侧docs 四件套就是排障手册——技术文档.md架构/模块/调试、RK3588_性能基准报告.md数字口径、优化配置与边界说明.md优化档与边界、权重保护与可验证推理方案.md安全防线。一个规范的 Issue 会在标题写清模块如[vqf]/[attest]/[bench]正文引用对应 docs 章节与源码文件——把 Issue 写成一份微型复现报告而不是一句跑出来不对。3. 改动后果三类反馈的分诊反馈类型例子正确的接法真 bug25-2 的 digest mismatch复现 → 定位 → 修复 → 更新 docs本系列 Day 25 实录口径偏差“复现不出 2.0s”实为默认档 vs 优化档先查配置档与 docs §0 复现环境多数在此解决文档不清header_canonical 定义漏了 flags 位修文档这也是真贡献25-2 的根因就是文档口径不全报告你发现的坑为什么是贡献真 bug 帮作者修代码文档不清帮作者修文档口径偏差帮作者知道读者在哪一步摔跤——三类反馈都让下一个使用者少踩一次坑。对比夸赞Star、转发带来流量但只有Issue能带来修复——30-1 说留存层看 Issue/邮件就是这个原因它们是仓库还活着的运营证据。4. 学员调试任务A 档动手写一条模拟 Issue不必真的提交到 Gitee本地存档即可主题任选① 你在复现 Day 28 报告时与报告数字有出入② 你发现某篇教程/docs 的表述与源码对不上③ 你复现了某个崩溃。按环境 / 复现步骤 / 期望 vs 实际 / 对照的 docs 章节四段写然后自评作者拿到它能否不追问就复现B 档思考回答① 为什么 Issue 要写你对照 docs 做了什么而不是只写报错了② 复现不出 2.0s 冷启动这类 Issue作者最可能先回复什么提示28-3 的配置档/口径差异③ 你发现文档 bug 但代码是对的这条 Issue 值不值得发为什么提示25-2 的 header_canonical 教训预期输出一条四段式模拟 Issue 三题思考答案能讲清反馈回路的质量决定仓库寿命。收尾本篇文档点名README.md联系区 220–227、docs/排障手册清单开源仓库Kestrel-LLM (Gitee)AGPL-3.0-or-later 或商业许可二选一下篇预告最后一篇30 天之外还有什么——一个与明文引擎共享基础设施的同态加密研究内核RNS-CKKS作为论文预告以及结营时必须诚实复述的30 天口径。