整库导出成 Markdown 仓
的 get 和 put 一次处理一条。要通读整个库、批量改一批卡片，就把整个库导出成一个本地 Markdown 文件夹（下面叫它「仓」）：用你顺手的编辑器打开，或者交给 AI 助手去改，改完再推回云端。
导出、校验、推回都免费。只有让 AI 加工内容才花点数。
导出：kb export
不写路径就导出到当前目录下的 42md-kb。目标文件夹必须不存在或是空的。导出后的结构：
每个文件都是普通 Markdown，开头一段 frontmatter 记着标题、类型和 id。文件的身份认的是 frontmatter 里的 id，不是文件名，所以你可以随意改名、在文件夹里挪动位置。
编辑
在仓里，Markdown 文件就是正本，直接改就行：
- 用任何 Markdown 编辑器打开整个文件夹，离线浏览、搜索、修改。
- 交给 AI 助手批量改，比如「把这批卡片的语气统一成口语」「给读书笔记做一遍错别字校对」。
frontmatter 里的 id 和 type 别改，其余随意。
校验：kb check
推回之前先离线检查一遍：frontmatter 写得对不对、有没有重复的 id、目录结构完不完整。不联网，不花点数。
在仓里面运行时可以不写路径，它会从当前目录往上找。
推回：kb push
- 只推你改过的卡片和专题章节，没动的不碰。
- 每次推回都存成新版本，旧版本保留。卡片的历次版本可以在网页版卡片页的「版本历史」里对照。
- 推之前会列出这次要推几项，等你确认。脚本里想跳过确认，加
-y。 - 素材的改动不会推回。改过的素材想入库，用
42md kb put存成一篇新素材。
如果某张卡在你导出之后又在别处改过（比如在网页版上），push 会把它标成冲突、先不推，其余照常推。处理办法二选一：
- 想以云端为准：重新导出一份新仓，在新仓里改。
- 想以本地为准：加
--force强制推。推上去仍是新版本，云端那一版也保留。
一次完整的来回
中间那一步就是你自己或 AI 助手编辑文件。装好 Skill 后，可以直接对助手说「把我的知识库导出来，把这批卡片按新口径改一遍，再推回去」，它会照这个顺序跑完，见 。
下一步
- 卡片和综述是怎么来的：
- 专题和章节是怎么来的：