入门指南
创建第一个 Vault
Vault 是一个本地文件夹，包含你所有文档、表与配置。
Vault 是什么
一个 Vault = 一个普通文件夹。打开它你会看到原始的 .md 文件、.kitable 数据表文件、一个 .kition/ 元数据目录。没有专有格式，没有锁文件，没有云依赖。
这意味着：你可以用 VS Code 直接编辑里面的 Markdown，可以把整个目录 zip 寄给同事，可以用 grep 在 1ms 内全文搜索。Kition 在上面加了一层结构化能力（双链、表、Agent），但底层永远是平面文件。
创建步骤
在引导流程里点 Create New Vault，或者已经进了主界面就用 Cmd/Ctrl + Shift + N。选一个空目录（或让 Kition 创建一个新的），起一个有意义的名字，比如 personal 或 work-2026。
一个用户可以同时挂多个 Vault — 顶部下拉可以快速切换。常见做法是工作和生活分开两个，敏感内容再单独一个。
- 路径建议：用绝对路径，避免软链接和 OneDrive
On-Demand目录 - 避免：iCloud Drive 里默认开启的 "Optimize Storage" — 会异步驱逐文件
- 避免：网络盘 / WebDAV — Vault 索引在远程文件系统上锁定行为不可控
- 建议：本地 SSD，必要时叠 Git 做版本
Vault 内部结构
一个新建的 Vault 大致长这样。.kition/ 是 Kition 的元数据目录 — 不要手动改里面的东西，但它是纯文本/JSON，所以 Git diff 起来也很清楚。
my-vault/
Notes/ # your freeform markdown
Projects/
Tables/ # one .kitable file per table
.kition/
config.json # per-vault settings
index/ # search index (regenerable)
secrets/ # never commit this dir
history/ # local undo history建议的初始结构
你完全可以一个文件都不分类直接写。但如果在等灵感的时候想要一个起点，下面这套结构对独立写作、项目管理、研究笔记都适用：
Notes/— 自由笔记、日记、临时想法Projects/— 每个项目一个子文件夹Tables/— 数据表（自动创建）Templates/— 文档模板，命令面板可以快速插入Resources/— 附件、PDF、截图Archive/— 归档目录，不参与默认搜索
多 Vault 实践
Vault 之间是完全隔离的：独立的 Agent provider 配置、独立的 Hooks、独立的索引。这是有意为之 — 工作 Vault 配公司发的 API Key，个人 Vault 配自己的，互不污染。
不要在两个 Vault 之间用符号链接共享子目录 — 会导致索引互相覆盖。如果需要共享内容，导出 / 导入 Markdown 是更安全的方式。
- 顶部 Vault 切换器：
Cmd/Ctrl + Shift + V - 常用 Vault 可以在 Settings → Vaults 钉住
- 每个 Vault 都可以独立设置默认模型 / 默认主题
- 一个 Vault 删除不会影响其它 Vault