一条命令，整库到本地
42md kb export ./42md-kb
跑完得到一个干净的文件夹：
42md-kb/
items/ 你的素材，每条一个 .md
cards/ 你的卡片，每张一个 .md
topics/ 你的专题，每个一个文件夹（含各章节）
每个文件就是一份普通 Markdown，开头带一段 frontmatter（标题、类型、id）。用你趁手的编辑器打开整个文件夹，像翻笔记一样浏览、搜索、修改——完全离线。
改完，一条命令送回
42md kb check ./42md-kb # 先离线自检：格式对不对、有没有重复（零网络、零配额）
42md kb push ./42md-kb # 把改动过的卡片 / 章节回流云端，存成新版本
push 很克制：只回流你确实改过的，没动的一概不碰；每次存成新版本、旧版完整保留；推之前先列清单等你确认；云端被别处改过会当场提醒冲突。
一次完整的来回
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 给了它一个安全的进出通道——拉下来、放手改、自检、送回去，全程版本化、可回溯。
常见问题
身份靠文件名记吗？
不靠。每个文件的身份记在开头 frontmatter 的 id 里，你随意改名、在文件夹之间挪动都不会乱。
会覆盖我在网页端的改动吗？
不会。某条若在云端被别处改过（比如你在网页端也改过同一张），push 会当场提醒冲突，让你先重新 export 同步再推（或加 --force），默认不静默覆盖。
两种用法
| 用法 | 命令 | 说明 |
|---|---|---|
| 按需取用（单条） | search → get → put | 知识库 RAG |
| 整库同步（vault） | export → check → push | 本页 |
立即体验，把知识库当成你和 AI 共同编辑的 Markdown 文件夹。