42md 全面支持 Agents（4）Markdown Vault：把整个知识库导出、编辑、再回流

本文是「42md 全面支持 Agents」系列第 4 篇。前三篇：总述、一行装好、知识库 RAG。

上一篇的「按需取用」是单条级别的：查一条、改一条、存一条。但有时你要做的是整体性的活儿——把整个知识库拉到本地，通览一遍、批量重写，或者一句话交给 AI 助手「把这一批卡片都按新口径改一遍」。

为此，42md 把整个云端知识库做成了能来回同步的本地 Markdown 文件夹。下面这套 export / check / push，你可以在终端自己敲，也可以装上技能包后让助手替你跑——对 AI 助手来说尤其顺手，它本就擅长批量改一堆 Markdown 文件。

一、一条命令，整库到本地

42md kb export ./42md-kb

跑完，你会得到一个干净的文件夹：

42md-kb/
  items/    你的素材，每条一个 .md
  cards/    你的卡片，每张一个 .md
  topics/   你的专题，每个一个文件夹（含各章节）

每个文件就是一份普通 Markdown，开头带一段 frontmatter（标题、类型、id 等）。这一步你可以自己敲，也可以直接跟助手说「把我的知识库导出到本地」，它替你跑这条命令。导出后用你趁手的 Markdown 编辑器打开整个文件夹，就能像翻自己的笔记一样浏览、搜索、修改——完全离线。

二、Markdown 就是真相

这里有个关键设计：在这个文件夹里，Markdown 文件本身就是知识的正本，你可以直接编辑——改完送回，它就成了云端的新版本。所以你可以：

• 用顺手的编辑器自己改正文；
• 一句话让 AI 助手批量改：「把这摞卡片的语气统一成口语」「给这两年的读书笔记做一遍错别字校对」「把『决策』专题整段翻成英文另存」——它打开文件夹逐份改，你只管验收；
• 随意给文件改名、在文件夹之间挪动——身份记在文件开头的标识里，不靠文件名，所以你怎么整理都不会乱。

改，就放心大胆地改。

三、改完，一条命令送回

42md kb check ./42md-kb   # 先离线自检：每个文件格式对不对、有没有重复（零网络、零额度）
42md kb push ./42md-kb    # 把改动过的卡片 / 章节回流云端

push 很克制，也很安全：

• 它只回流你确实改过的卡片和章节，没动的一概不碰；
• 每次回流都是存成新版本，旧版本完整保留——等于自带了「后悔药」；
• 推之前会先列一份清单（改了几张、跳过几张），等你确认再动手；
• 如果某条在云端被别处改过了（比如你在网页端也改过同一张），它会当场提醒你冲突，让你先重新 export 同步一遍再推（或加 --force 强推），默认不会静默覆盖。

四、一次完整的来回

把这条流程连起来，就是知识库的「编辑闭环」：

42md kb export ./42md-kb        # 1. 整库克隆到本地
# 2. 用编辑器或指挥 AI 助手，把卡片改一遍
42md kb check ./42md-kb         # 3. 离线自检，确认没改坏
42md kb push ./42md-kb          # 4. 回流，存成新版本

对 AI 助手来说，这套流程正好对路：它擅长批量改一堆 Markdown 文件，而 export / check / push 给了它一个安全的进出通道——拉下来、放手改、自检、送回去，全程版本化、可回溯。

怎么开始

• 给助手装上技能包：42plugin install zhiping/42ailab/42md
• 让它「把我的知识库导出，把这批卡片按 XX 口径重写一遍，再推回去」
• 它会替你跑完 export → 改 → check → push 这一整条

把知识库当成一个你和 AI 共同编辑的 Markdown 文件夹——能离线、能版本化、能让 AI 直接动手。下一篇换个方向：用一句话让 Agent 定制排版和风格。

42md — 你的知识快刀。更快地获取、更深地编译、更好地策展、更强的工具。

活水 AI 实验室（42ailab） — 源自 2023 年成立的活水智能团队，致力于以认知科学为基石，推动人工智能与人类智能的深度融合与科学创新。

官网：https://42md.cc