知识库踩的坑：从向量表结构到重排序，一条 RAG 链路上的 24 个故障点
把 RAG 拆成五个责任位：六个向量库各自在什么场景真好用、pgvector 表结构为什么要三张表、换 embedding 为什么必须重建、RRF 为什么不是重排，以及 ima 千亿级 ES 架构与三家大厂收敛到的同一套取舍。
CATEGORY
踩坑修复
报错、绕坑、最终方案 · 共 8 篇
← 返回栏目从 Vibe Coding 到上线：选型、清算与交付标准
Vibe Coding 只解决了 0→1。以全栈工程师的口径，把「语言/框架/数据库选型」和「上线前按致命程度排序的清算」串成一条可执行路径，附默认套餐与放行清单。
别让 AI 自由发挥：一份管住项目方向的规则清单
AI 不会故意改你的项目方向，它只是在填空。这篇把「项目方案、项目结构、数据库结构、技术栈与依赖、行为边界」五类规则提前写进 Trae / CodeBuddy / Codex / Cursor / Claude Code 的规则文件，附各家机制对照表、可直接抄的模板，以及规则写了却不生效的三个原因。
Nginx 绑定域名：server_name、默认站点与反向代理
从官方文档出发，讲清 Nginx 如何按 Host 选择 server、default_server 优先级、同端口多站点与反代绑域名的常见坑。
LangChain 工具定义踩坑：描述、参数与「什么时候别用」
工具写得越多，Agent 越容易乱调。记录工具命名、docstring、schema 与负面约束的实用写法。
LangChain 记忆与 Checkpointer：thread_id 为什么必须配对
多轮对话失忆，多半不是模型问题。记录 InMemorySaver、thread_id 与长期记忆的分层用法。
shiki 高亮样式在 Astro 里「看起来没生效」
代码块有颜色但和页面不搭，排查后发现是主题与全局背景冲突。记录定位步骤和最终 CSS 处理方式。
Agent 流式输出：别等最终答案，把过程吐出来
invoke 只给最终结果，用户会以为卡死。记录 stream 中间消息、工具调用进度与 UI 展示策略。