AI Agent 的 Wiki 外脑：为什么你的记忆总在「重启就忘」

问题：你的 Agent 是不是也这样？

给 Agent 交代了一个复杂项目，第一轮对话聊得挺好。第二天打开新会话——它完全不记得昨天聊了什么。

你只能重新说一遍：项目背景、服务器 IP、设计规范、数据库结构……

这不是 Agent 笨，是你没给它装「外脑」。

什么是 Wiki 外脑？

Wiki 是 Agent 的外部知识库——一组 Markdown 文件，存在磁盘上，不会随会话重置而丢失。

核心原理：文件是唯一真相源。Agent 每次新会话第一件事不是问用户，是读 Wiki。

三个核心问题 + 解决

问题1：会话断裂

现象：新会话开了，Agent 不知道项目进展到哪了。

根因：只在会话上下文里记住信息，上下文一丢就失忆。

解决：在系统提示中加入强制启动协议

关键：不是"建议读"，是"强制读"。Agent 和人类一样会偷懒，不强制它就跳过。

问题2：知识丢失

现象：踩过的坑反复踩。上次改配置文件忘了备份导致宕机，这次又忘了。

根因：经验留在会话里，没写入持久存储。

解决：建立写入铁律

场景	写入哪里
做了项目决策	wiki/entities/<项目>.md
发现系统行为/规则	对应 entity/concept 页
修改了服务器配置	对应 server entity
踩了坑	wiki/concepts/ 新建

关键：不等 session 结束再汇总——做完立刻写。人的记性靠不住，Agent 的也一样。

问题3：Wiki 腐化

现象：Wiki 写了一堆，但从来不用。查东西还是靠问用户或者瞎猜。

根因：有 Wiki 但没建立"先查再答"的习惯。

解决：在系统提示中加入硬性规则

关键："凭记忆补充"放在最后。Wiki 优先级高于会话记忆，高于模型内置知识。

实战：我们怎么用 Wiki 的

以美程会展的酒店预订系统为例，Wiki 里存了：

服务器配置：IP 地址、Nginx 配置、PM2 进程名、SSL 证书路径
退款逻辑：微信支付退款、支付宝退款、对公转账退款的完整流程
设计规范：主色 #ea6928、日期格式永远是"05月05日"、移动端优先
用户偏好：老板说"上传"才部署、不要批量改文件、做完要验证
踩坑记录：SCP 传文件别用 base64、.next 坏了先删再重建

每个条目都有来源和日期。不是"我猜的"，是"某月某日改配置文件时确认的"。

三个常见错误

错误1：Wiki 写成流水账

坏例子：

今天改了配置文件。又改了。再改了一次。

好例子：

nginx 配置：反向代理端口 3001，SSL 证书路径 /etc/letsencrypt/live/ai.cnlsjz.cn/，最后更新 2026-07-12。改动原因：从端口 3000 迁移到 3001 避免冲突。

原则：存"真相"，不存"过程"。Wiki 是字典，不是日记。

错误2：把 Wiki 当聊天记录

Wiki 不承载对话。用 session_search 查"上次聊到哪了"，Wiki 只存不变的知识。

错误3：只写不读

写完后必须更新 index.md 和 log.md。不更新索引等于没写——下次 Agent 找不到这个页面。

给你的 Agent 搭一个 Wiki

最小可行方案（10分钟搞定）：

然后把上面"会话启动协议"和"查询铁律"写入你的 Agent 系统提示。

总结

Agent 不笨，是没给它记忆。Wiki 是性价比最高的 Agent 升级——不花钱、不改模型、立竿见影。

三个数字记住：

1个结构：SCHEMA → index → log → 具体页面

2条铁律：启动时必读、操作后必写

3不原则：不写流水账、不当聊天记录、不只写不读

搭好 Wiki 后，你的 Agent 从「每次都要自我介绍的新人」变成「记住所有上下文的靠谱搭档」。

AI Agent 的 Wiki 外脑：为什么你的记忆总在「重启就忘」