文档
文档
从安装到进阶配置，按产品模块系统学习 Kition。左侧目录分组浏览，或从下面的快速上手开始。
开始
什么是 Kition待补
本地优先的 AI 工作台 — Markdown 文档、结构化表、AI Agent，全在你自己的机器上。
安装 Kition
在 macOS / Windows 上下载安装包并完成首次启动。
创建第一个 Vault
Vault 是一个本地文件夹，包含你所有文档、表与配置。
界面导览
认识左侧栏、文档区、Agent 面板、命令面板。
配置 AI Provider
让 Agent 工作起来 — 添加 OpenAI / Anthropic / 兼容服务的 API Key。
安全保管你的 API Key
Key 存在操作系统 Keychain；不要写进 Vault 文件或 Git 仓库。
备份与同步
本地优先并不代表"没备份"。Git、iCloud、Dropbox 三种推荐方式。
核心模型
文档编辑器
Markdown 基础
标题、列表、粗体、链接、代码 — 三分钟掌握 Markdown 核心。
双链与反向链接
`[[文档名]]` 创建双链，反向链接面板显示谁引用了当前页。
Callout 语法
`> [!note]` 形式，支持 note / tip / warning / danger / success。
命令面板
`Cmd/Ctrl + K` 调出命令面板 — 跳文档、运行命令、切换设置。
文档模板
在 `Templates/` 放 `.md` 模板，新建文档时一键应用。
在文档里嵌入数据表
`![[Tables/projects]]` 把整张表或一个视图嵌入文档。
公式与 Mermaid 流程图
`$$...$$` 写公式，```mermaid 块画流程图。
导出 PDF / DOCX
内置 Pandoc 链路 — 文档可一键导出 PDF / DOCX / HTML。
数据表
创建数据表
从命令面板新建表，或在文档里 `/table` 触发。
字段类型一览
12+ 字段类型：文本、数字、日期、选择、附件、AI、Doc-link 等。
创建与切换视图
Grid / Kanban / Calendar / Gallery — 同一张表多个视图。
过滤、排序、分组
组合任意条件过滤行，多字段排序，按字段分组。
配置 AI Field
让一列由 Agent 根据其他列自动计算 — 抽 theme、做翻译、打分。
从 CSV 导入
在表标题栏点 "Import CSV"，映射列、确认类型推断、点击导入。
导出表为 CSV / JSON
随时把表导出成明文格式 — 数据从来不锁。
关联文档与数据表
用 `doc_link` 字段把表行链到文档；在文档里 backlinks 自动显示反向。
AI Agent
Agent 基础对话
右侧面板 → 输入问题 → Agent 自动调用工具回答。
Agent 的工具调用
Agent 自动选工具、传参、看结果、决定下一步 — 你可在对话流里看见每一步。
Plan 模式
复杂任务：先让 Agent 写计划 → 你确认 → 再执行。
Hooks 入门
Hooks 在工具调用前后插入代码 — 拦截、审计、注入上下文。
MCP Server 配置
`<vault>/.kition/mcp.json` 配 stdio / SSE / HTTP server，重启 Agent 生效。
子 Agent 协作
让主 Agent 起子 Agent 处理子任务 — 避免上下文爆炸。
Agent 长期记忆
把"你是谁、习惯、约束"写进 `.kition/agent.md` — 每次对话自动加载。
浏览器工具
`browser_open` 启一个真浏览器（Chromium），Agent 可以点、填、滚、截图。
控制 Agent 成本
按任务挑模型、限制上下文、设月度预算 — 三招避免账单暴雷。
Agent 权限模型
工具调用按白名单 / 询问 / 拒绝三档；可按 vault 单独配置。
Provider 配置
桌面与数据
实操指南
参考
设置参考待补
按面板列出所有设置项。
键位待补
默认快捷键与自定义方式。
隐私与遥测待补
Kition 收集什么、如何关闭。
Agent 没回应
检查 Provider 配置、API Key、网络、Hooks 阻断，并按层级隔离问题。
Vault 没同步
Git / iCloud / Dropbox 每种同步路径的排查、修复与冲突处理。
编辑器卡顿
通常是单文档过大、附件目录爆炸、扩展冲突，或文件索引落后。
双链失效 / 反链不显示
重命名 / 移动后索引偶尔落后；理解索引模型才能彻底解决。
CSV 导入失败 / 乱码
UTF-8 + 一致日期格式 + 合理行数 + 干净分隔符 — 四件事保证导入成功。
PDF 导出失败
99% 是 Pandoc / LaTeX 缺失或 PATH 没找到；剩 1% 是文档里有特殊字符。