入门指南

界面导览

认识左侧栏、文档区、Agent 面板、命令面板。

主要区域

Kition 的窗口分四块:左侧导航、中间编辑区、右侧 Agent、顶部标签和命令面板入口。左右两侧都可以折叠(Cmd/Ctrl + B / Cmd/Ctrl + J),需要全身心写作时只留中间。

  • 左侧栏:Vault 文件树 + 表 + 收藏 + 最近
  • 中间:编辑器(Markdown / 表 / 浏览器视图)
  • 右侧:Agent 对话面板,可以贴文档作上下文
  • 顶部:标签页 + 命令面板入口 + Vault 切换器
  • 底部状态栏:sidecar 状态、字数、Git 分支、provider 名

编辑器特点

编辑器是 WYSIWYG Markdown — 输入 # Title 会立刻渲染成标题但底下还是纯文本,跟 Typora 类似的体验。所有快捷键都遵循平台习惯(macOS 是 Cmd,Windows / Linux 是 Ctrl)。

双链 [[Doc Name]] 自动补全,反向链接在右侧 Inspector 实时显示。/ 触发 slash 菜单 — 表、引用、Mermaid 图、AI 块都从这里来。

  • Markdown 源码模式:Cmd/Ctrl + /
  • 内嵌图片:直接拖入或粘贴,自动存到 Resources/
  • Mermaid / KaTeX 实时预览
  • 代码块自动语言检测 + 行号 + 复制按钮

Agent 面板

右侧 Agent 面板不是简单的 chatbot — 它有 plan / goal / chat 三种模式,可以读写 Vault 文件、运行 sidecar 提供的工具(搜索、表查询、Web fetch 等等)。当前打开的文档会自动作为上下文之一。

面板顶部能切模型、切 provider、切 system prompt。这些都按 Vault 单独保存,不会污染其他 Vault。

  • @doc 引用一个文档作为上下文
  • @table 引用一个数据表(结构 + 样本)
  • Plan 模式:Agent 先列计划,你确认再执行
  • Goal 模式:连续多步任务,自动调度子 Agent
  • 历史会话保存在 .kition/history/,可重放

命令面板

Cmd/Ctrl + K 打开命令面板 — 这里是所有操作的入口。模糊搜索文档、跳标题、切 Vault、跑 Agent 任务、运行 Hooks、切换主题 — 都在这一个地方。

一旦你习惯了命令面板,鼠标可以丢一半。绝大多数高频操作都有它的别名,比如 >new table 会建表,?query 会全文搜索。

  • 直接输文字 = 搜文档名
  • > 前缀 = 运行命令(如 >Toggle theme
  • ? 前缀 = 全文搜索
  • # 前缀 = 跳标题
  • @ 前缀 = 跳标签 / 双链

关键快捷键

下面是高频快捷键。在 Settings → Keybindings 可以自定义,导入 VS Code / Sublime 键位也可以。

  • Cmd/Ctrl + K — 命令面板
  • Cmd/Ctrl + O — 快速跳转文档
  • Cmd/Ctrl + P — 最近文档
  • Cmd/Ctrl + J — 切换 Agent 面板
  • Cmd/Ctrl + B — 切换左侧栏
  • Cmd/Ctrl + Shift + N — 新建 Vault
  • Cmd/Ctrl + Shift + V — 切换 Vault
  • Cmd/Ctrl + Shift + F — 全 Vault 搜索

相关文档

下载 Kition

本地优先的 AI 工作空间。Markdown 文档、结构化数据表、AI Agent,全部跑在你自己的电脑上。