你每周要花大量时间翻笔记、查文档、找参考资料——花 40 分钟找东西，3 分钟真正用它。我试过市面上几乎所有的 AI 知识库产品，最后还是决定自己搭。现在把整个过程和工具开源出来，你 10 分钟就能上手。这是 7 篇系列文章的最后一篇。前面六篇分别是：第一篇《为什么我退订了所有 AI 知识库订阅，选择自己搭》——从「一个月几十刀订阅费，数据还在别人服务器上」说起，把自建和订阅制的账算清楚。第二篇《

上个月在知识库里搜了三个工作问题，两个返回的都是半年前的过时内容，方案已经彻底废弃了。这个库我花了两个周末认真搭的，才几个月就已经不好用了。这感觉就像买了一堆收纳盒把家里收拾得整整齐齐，三个月后打开柜子发现——东西还是乱的，只是换了个盒子装。搭知识库不难，难的是让它持续好用。市面上 99% 的文章都在教你怎么搭，没人在教你怎么养。今天我把这半年踩过的坑和总结的维护流程拆开来讲，读完你就能照着用。知

你有没有遇到过这种情况——花了一个周末写好 MCP Server，三个工具跑得飞起。丢给 Claude Code 用，结果 AI 全程不调用你的工具。查阅日志，发现它宁可自己编答案，也不碰你精心写好的接口。更崩溃的是反过来：改了几行描述想让 AI 多用用，第二天发现它在跟用户说"早上好"的时候也去搜你的知识库。这不是你不会写代码。是 MCP 工具描述写错了。我在写 kb-builder 的知识库检

我花了三个月搭了一套自建 RAG 知识库，240 篇技术文章灌进去，向量库跑起来一切正常。然后我用"Redis Cluster 怎么扩容"搜了一下。返回的结果前三篇分别是：《Redis 为什么快》、《Go 语言的并发模型》、《我们团队的代码规范》。没一篇回答了我的问题。问题不在 embedding 模型，不在向量数据库。问题出在一个大多数教程一笔带过、很多工程师压根没认真对待的环节——分块策略。同

事情是这样的。上一篇文章聊完三层检索策略之后，我盯着终端里的 出神——里面躺着一个 Qdrant 容器，跑了快一个月，CPU 占用稳如老狗，但我一次查询都没往它那边发。因为我发现我的 Chroma 跑得好好的。240 篇文章，5877 个 chunk，查询延迟没超过 1 秒，内存不到 200MB。我到底为什么要多维护一个独立服务？这个念头一起，我就把 Qdrant 容器停了。然后花了一个下午把两

三个月前的一个晚上，我坐在电脑前，对着刚搭好的 AI 知识库输入了第一个问题：「Redis Cluster 的 gossip 协议在节点故障时怎么处理的？」这个问题的答案我自己写过——一篇 5000 字的专栏文章，就在知识库里。但检索结果让我愣住了：前三名全是 StackOverflow 的社区回答，第四名是一篇 2023 年的公众号转载，我自己的原创文章排在第七位。那篇原创是我花了两个周末写的，

每个月续费的时候我都会犹豫一下。打开账单，那个 AI 知识库会员又扣了三百多块。不多，但每次看到这笔钱，我心里都会冒出一个念头：这个月我打开过它几次？答案是：不超过三次。而且其中两次搜出来的东西，说实话，不太对。这就是我退订所有 AI 知识库的开始。先说清楚，我不是一开始就觉得商业 AI 知识库不好。正相反，第一年用的时候我觉得这东西真方便——把笔记、文档、网页一股脑扔进去，想用的时候搜一下，AI

不知道你有没有遇到过哲宏场景：使用 Cursor 写用户权限模块，vibe coding了3小时，代码跑起来才发现AI把角色继承的逻辑搞反了——我明明说过要RBAC0，它写成了RBAC1的继承方向。改到第5版的时候，AI已经忘了我最开始提的「不支持动态角色」的约束。这种破事我起码遇到过十次。直到上个月试了GitHub官方出的spec-kit，才终于不用在AI的「自由发挥」和我的「反复返工」之间反复

马维斯下载地址：https://marvis.qq.com/上周五下午四点，我的C盘又红了。这已经是本月第三次。打开「此电脑」，红色进度条亮得刺眼——剩8.3G。我盯着那堆「用户」「ProgramData」「Windows」文件夹，不知道哪个能删、哪个删了会出问题。以前遇到这种情况，流程是这样的：右键C盘→属性→磁盘清理→等它扫描三分钟→在一堆「临时文件」「系统还原点」「Windows更新缓存」里

上周我刷 GitHub Trending 的时候，看到一个仓库两天涨了 3000 star，名字叫 。说实话，第一反应是——Google 又来整活了？Gemini CLI 刚刚宣布个人账号停服、过渡到 Antigravity CLI，这会儿又推个新的 CLI？点进去看完 README，我愣了一下：这玩意不是编程助手，它是给编程助手「装技能」的。什么意思？你用 Claude Code 写代码，它帮你

6 月 16 日，Superpowers 发布 v6.0.0。两天后追了 v6.0.3 修复版。如果你读过码哥之前那篇「185,000 星的 Superpowers 插件，90% 的人只用了它 10% 的功能」，14 个 Skill 的基本面你已经知道了。那篇写的是 v5.1，拆的是「是什么」和「怎么用」。这篇是续集。只讲一件事：SDD（subagent-driven-development）从底

上周五凌晨两点，我盯着终端里 Claude Code 输出的一堆「建议」，突然意识到一件事——我用了三个月的 Claude Code，本质上还是在用聊天框。那天晚上我赶着重构一个用户权限模块，思路是把原来散落在十几个文件里的权限校验逻辑收拢成一个 middleware。我打开 Claude Code，敲了一句：「帮我重构一下用户权限校验的代码」。它给了我一堆建议，列了五个文件要改哪些函数。我说「好

上个月我在文章里留了个留言区，说「你们在 Claude Code 上遇到的问题，尽管丢过来」。结果后台收到了将近 200 条消息，很多问题反复出现——CLAUDE.md 到底怎么写、Token 消耗太快怎么办、MCP 是个什么东西。与其在留言区逐条回复，不如把高频问题集中回答一次。这 10 个问题覆盖了从入门到进阶的核心困惑，每个回答都附带我自己用了半年的真实经验。这个问题被问的频率排第一。几乎所

上周在刷 Twitter 的时候，看到有人发了张截图：一个浏览器插件界面，模型列表里整整齐齐排着 GPT-5.5、Claude Opus 4.8、Gemini 3.1 Pro、Grok 4.3，底下赫然写着「免费」。第一反应是钓鱼网站。点进去一看，居然是美团做的。一个叫 Tabbit 的 AI 浏览器，6 月 9 号刚发布 1.0 版本。我拿主力浏览器装了试了三天，说实话，模型免费不是最让我意外的

上周五晚上7点，我们组的产品经理小林发了条消息：「明天要给客户汇报，PPT 还有 30 页没做，救命。」我当时心想，都 2026 年了，这活儿不该 10 分钟搞定吗？结果我一问，她用的是某款很火的 AI 做 PPT 工具，生成出来的内容：配色花哨但不统一，文字像 AI 通稿一样空洞，最关键的数据页——图表数据全是假的。这不是个例。过去两个月，我帮身边做产品、运营、HR 的朋友实测了市面上 8 款主

你有没有遇到过这种情况——数据量才几万条，ECharts 图表渲染就要 3 秒以上，用户拖拽 dataZoom 的时候卡得像幻灯片。你反复检查代码，配置项翻来覆去看，觉得"官方文档不就是这么写的吗"。问题不在 ECharts 本身——66.6k GitHub stars、Apache 基金会顶级项目、最新版 6.1.0 在 2025 年 5 月刚发布——它扛得住。问题出在你对它的理解还停留在"能画

上周一早上，领导说要周三前交一个新功能的产品方案。你打开文档，准备写 PRD——需求背景、用户故事、功能清单、流程图、原型线框图……光是想清楚怎么组织这些内容，半天就过去了。不是你效率低，是这类工作本来就会吃时间。你旁边那个同事，10 分钟后拿着一个能点、能跳转、能在手机上滑的可交互原型去跟开发对需求了。开发看完直接说「明白了」，连会都没开。差距不在能力，在工具。baoyu-design 是宝玉（

你有没有遇到过这种情况——CLAUDE.md 写了 300 多行，把团队的编码规范、命名规则、部署流程全塞进去了，结果 Claude Code 执行的时候该忘还是忘。换个复杂点的任务，它甚至开始自相矛盾。我之前也是这么干的。直到某天在 Anthropic 官方文档里看到一句话，大意是：「CLAUDE.md 只是 7 种自定义方式之一，不是唯一的。」7 种？我数了数自己用过的，只有 CLAUDE.m

6 月 16 号早上，我打开 Cursor 正准备改一个 Bug，屏幕上弹出一条推送：「SpaceX 宣布以 600 亿美元全股票收购 Anysphere（Cursor 母公司）」。手里的咖啡放下来，第一个念头不是「哇，马斯克真有钱」。而是——我的所有项目、所有 API Key、所有 Composer 会话历史，现在全归马斯克了。如果你也用 Cursor，这一刻你可能也在想同一件事。这笔收购被包装

老板说："用 AI 把这坨屎山重构掉，现在工具这么好，应该很快。"我当时点了头。这是我接手的一个运行了 6 年的 Spring Boot 单体服务，核心模块 5000 行，最臃肿的那个类 1800 行，47 个方法堆在一起，没有注释，单测覆盖率 8%。前任的前任离职的时候留了一句话："这块别乱动，动了必翻车。"我用 Claude Code 开干了。第一周，重构进展顺利，AI 拆类、提方法、补测试，