数据表

字段类型一览

12+ 字段类型:文本、数字、日期、选择、附件、AI、Doc-link 等。

基础类型

基础类型对应 Notion / Airtable 用户熟悉的那一套。你不需要为它们写公式或 prompt — 它们就是带 UI 的存储槽。

  • text — 单行文本(适合标题、ID)
  • rich_text — 多行 Markdown,支持粗体、链接、代码
  • number — 数字,可选单位(USD、kg、%)和精度
  • select / multi_select — 标签型枚举,颜色可配
  • date — 日期 + 可选时间,可选时区
  • checkbox — 布尔,用方框渲染
  • url / email / phone — 文本但带语义校验和点击行为
  • attachment — 文件附件,存在 <vault>/.kition/attachments/

关联类型

这三种类型让表之间能拼成真正的数据库。relation 是基础 — 它存的是指向另一张表行的引用;rollup 顺着 relation 把对端的某个字段汇总过来;doc_link 把表行钉到 .md 文档上,实现双向跳转。

  • relation — 链到另一张表的一行或多行;编辑器里出现行卡片
  • rollup — 沿 relation 跨表聚合(sumcountavgminmaxconcat
  • doc_link — 链到 vault 里的某个 .md;文档侧 backlinks 自动反向显示

计算类型

计算字段不存数据 — 它们每次被读到的时候按当行算。formula 是确定性的,ai_field 是不确定的。这两个的关键差别在调试和成本:公式错了一目了然,AI 字段错了你得读 prompt 才知道为什么。

  • formula — Excel 风格表达式,参考下方语法
  • ai_field — Agent 按 prompt 算(见 "Setting up an AI field")
  • created_at / updated_at — 系统自动维护,只读
  • created_by / updated_by — 团队 vault 下记录操作者
// Days since a date column was set
days_since({last_contact})

// Conditional priority based on number + checkbox
if({score} > 8 && {is_blocker}, "P0", if({score} > 5, "P1", "P2"))

// Concat across rollup
concat(rollup({Tasks}, "title", "list"), ", ")

怎么选类型

  • 能用 select 就别用 text — 类型受限的字段过滤更准、报表更稳
  • rich_text 用克制 — 表更像数据库不是文档;长内容用 doc_link 链出去
  • 量级 > 1000 行的表,别在热路径用 ai_field — 用 manual 模式只算最近一批
  • relation 比把外表 ID 塞进 text 强 — 你能拿到行的引用,不是字符串

相关文档

下载 Kition

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