AI Agent 总是丢失项目知识？Plasma Wiki 用 CLI 给你的 Agent 装上持久记忆

用过 Claude Code、Codex 或 Cursor 的朋友都知道一个痛：每次开始新会话，Agent 就像失忆了一样，完全不记得你项目的架构约定、代码规范、技术选型。你不得不一遍又一遍地告诉它同样的事情。

Andrej Karpathy 提出了一个优雅的解决方案——LLM Wiki 模式：把项目知识写成 Markdown 文件，通过索引文件（_index.md）串联起来，让 Agent 按需翻阅。但这个模式有个尴尬的地方：维护索引、交叉引用、处理冲突全靠手工，比写代码还累。

Plasma Wiki 就是来解决这个问题的——一个开源的 CLI 工具，自动生成索引和交叉链接，处理并行编辑冲突，让你的 AI Agent 有一个可维护的持久知识库。

安装：一行命令搞定

pip install plasma-wiki

或者用 pipx 隔离安装：

pipx install plasma-wiki

也可以用 uv 工具链的用户：

uv tool install plasma-wiki

安装后你会得到一个 wiki 命令行工具，所有操作都通过它完成。

初始化：给你的项目装上知识库

在你项目的根目录下运行：

wiki init

这条命令会干三件事：

1. 在 wiki/ 目录下搭建 Markdown 文件树结构
2. 创建根目录的 _index.md 索引文件
3. 配置 Obsidian 插件和 Git 合并驱动（如果检测到你在用 Git）

初始化完成后，你的项目结构大概是这样的：

project/
├── wiki/
│   ├── _index.md              # 根索引
│   ├── architecture/
│   │   ├── _index.md          # 架构章节索引
│   │   └── decision-log.md    # 架构决策记录
│   ├── conventions/
│   │   ├── _index.md          # 规范章节索引
│   │   ├── coding-style.md    # 编码风格
│   │   └── naming.md          # 命名规范
│   └── tech-stack/
│       └── _index.md          # 技术栈索引
└── _config/
    └── settings.json          # 全局配置

写入知识：像写文档一样写笔记

Plasma Wiki 对 Markdown 文件的内容格式非常宽容。每个文件夹下的 _index.md 就是该章节的目录，你可以在里面写章节介绍、链接到具体文章。

具体的知识条目就是普通 Markdown 文件。比如 wiki/architecture/decision-log.md：

---
name: 架构决策日志
created: 2026-07-04
---

## 2026-07-04：选择 PostgreSQL 作为主数据库

**原因**：团队对 SQL 更熟悉，PostgreSQL 的 JSONB 支持可以满足
部分灵活 Schema 需求，避免引入 MongoDB。

**影响**：需要配置连接池，ORM 选用 Prisma。

文件名和文件夹名支持中文、空格、短横线、Unicode——只要不会破坏 Wiki 结构（比如以 . 开头或使用 _index/_config 等保留名）都没问题。

如果项目有严格的命名规范，可以通过 _config/settings.json 配置：

{
  "naming": "ascii-only",
  "timestamp": {
    "timezone": "Asia/Shanghai",
    "format": "%Y-%m-%d %H:%M"
  }
}

CLI 命令：让 Agent 自己查阅知识库

这是 Plasma Wiki 的核心价值——所有操作都通过 CLI 完成，AI Agent 可以直接调用。

维护索引

wiki lint

wiki update

wiki lint 会检查文件名冲突、无效链接、配置合规性——相当于给 Wiki 做了一次健康检查。

wiki update 是最常用的命令：你新增或删除了 Markdown 文件后，运行它就能自动更新所有 _index.md，保持索引与文件系统一致。

查询知识

wiki map

wiki search "数据库"

wiki read architecture/decision-log

这三个命令是 Agent 获取知识的入口。wiki map 让 Agent 快速了解整个知识库的结构；wiki search 允许全文检索；wiki read 精确读取某个条目。

集成到 AI Agent

对于 Claude Code 和 Codex，可以通过插件安装 /wiki 技能：

/plugin marketplace add plasma-ai/plugins
/plugin install wiki@plasma

codex plugin marketplace add plasma-ai/plugins
codex plugin add wiki@plasma

或者通过 CLI 直接安装（把技能复制到 ~/.claude/skills 和 ~/.agents/skills）：

wiki install

安装完成后，你的 AI Agent 就可以在需要时自动调用 wiki search 和 wiki read 来查询项目知识，不再需要你反复解释。

实战场景

场景一：新成员快速上手

新成员加入项目，Claude Code 第一次启动时自动运行 wiki map 了解项目结构，然后 wiki read 读取关键架构文档。几分钟内就能掌握项目全貌。

场景二：编码时自动查阅规范

Agent 在写代码时遇到命名问题，自动运行 wiki search naming 找到命名规范，直接在生成的代码中遵循项目约定。

场景三：并行编辑不冲突

多人团队中，两个 Agent 同时修改了不同的 _index.md。Plasma Wiki 的 wiki update 会自动合并冲突（类似 Git 的合并策略），确保索引一致性。

为什么用 Plasma Wiki 而不是自己维护？

合适的命名策略

你可以通过 naming 配置选择严格的命名策略：

• loose（默认）：中文、空格、Unicode 都允许
• identifier：只允许字母、数字、短横线
• ascii-only：严格 ASCII

用 wiki lint 检查命名合规性，违规项一目了然。

结语

Plasma Wiki 不是什么革命性的新技术——它只是把 Karpathy 的 LLM Wiki 理念自动化了。但正因为这种自动化，让你的 AI Agent 拥有了一个无需人工维护的持久知识库。

下次 Claude Code 再问你”这个项目用什么数据库”，你只需要让它 wiki search "数据库" 就好。

相关链接

• Plasma Wiki GitHub
• PyPI 包
• Karpathy 的 LLM Wiki 理念
• Google Open Knowledge Format
• 文档站