WeKnora 实战：从真实 PR 学贡献

调研日期：2026-07-01 · 15 篇精读 · 标杆 case-1828

本包不重复 RAG 原理——那些内容在 47 章系统性导读 和 WeKnora 竞赛贡献指南 中已经覆盖。这里做的事情是：拆解已合入的真实 PR，提炼可复用的贡献模式，并映射到目标 issue #1248。

PR 搜索目录：case-catalog.md（候选队列）· 写作标准：case-writing-standard.md

主路径（推荐）

案例索引 → 1785 → 1633 → patterns → bridge-1248

总计约 100 分钟。

副路径

管线专项（适合关注 RAG 管道的读者）

case-1725（Go docparser HTML→Markdown）→ 模式提炼 §4 管线模式

Go 后端专项

case-1774（repository + service + handler 三层）→ #1248 映射 POST feedback API 子任务

前端状态管理专项

case-1761（Pinia 缓存失效，3 行修复）→ #1248 映射 对话气泡 UI 子任务

与旧材料的关系

每章末尾有思考点

所有案例和枢纽章节末尾都有 3–5 道无标准答案的思考题。如果读不懂某个章节，可以用以下追问模板：

我在读 weknora-practice/case-{CASE}.md 的「{小节名}」。

已读懂的部分：{一句话} 卡住：{具体句/图/代码块}

请：

1. 用 case-{CASE} 里的现象再讲一遍根因（换类比）
2. 指出若我要做 #1248 的「{子任务}」，从本案借哪一步、哪一步不能借
3. 不超过 15 行例子 不要重写整篇 case。

全部文件清单