从查文档查到崩溃，到给自己做一个 RAG 问

前几天搞 ESP32，本来只想安安静静写点代码。结果大半时间全耗在翻文档上。

手上那几套资料各说各话。同一个接口，在不同文档里的写法还不一样。写着写着卡住，就在几个文档站之间来回跳。跳到最后，自己都忘了刚才想查啥。

麻烦真不是没资料，而是资料太多太散。明明知道要找个答案，却不知道去哪找。找到了还得核对版本、看适不适合手上的板子。这种消耗特别隐蔽。每次好像只花几分钟，一天下来整块时间就被切得稀碎。

于是干脆做个问答机器人。把问题丢给它，让它去文档里找答案，直接给结论和出处。

大模型本身可不知道我这些文档写了啥。直接问它，要么答得笼统，要么干脆瞎编。所以关键不在模型多强，而在怎么把文档喂给它。

这就是 RAG 干的活儿：不让模型凭空回忆，而是先翻出最相关的资料，再让它照着组织答案。

具体落地分两步。先把文档清洗干净、切成小块，转成向量存进库里。之后提问时，系统按语义去找内容。最后把找到的资料和问题一起交给模型，让它作答并带上出处。

链路跑通后，直接接进飞书机器人。写代码卡住时，不用切窗口，在聊天框里问一句就行。

其实真正费时间的，是那些没展开的细节。文档怎么清洗、切块多大、检索不准怎么办。这些问题每一个都够单独写一篇。下期开始，我打算一个环节一个环节拆开讲。