数据表

从 CSV 导入

在表标题栏点 "Import CSV",映射列、确认类型推断、点击导入。

为什么从 CSV 开始

大多数人迁移到 Kition 时手上已经有数据 — Notion 导出、Airtable export、Excel 表、Linear 周报。CSV 是这些工具的最大公约数:行 = 记录,列 = 字段,UTF-8,逗号分隔。

Kition 的 CSV 导入做了两件别人没做好的事:类型推断比 Notion 准(数字、日期、布尔自动识别),以及导入后 schema 仍然可改 — 不会"导完只能改值不能改类型"。

导入步骤

  • 1. 准备 CSV — UTF-8 编码,首行字段名,避免合并单元格
  • 2. 表头右上 → "Import CSV" — 选文件,预览前 20 行
  • 3. 检查列映射 — Kition 自动匹配同名字段;没匹配的列可以新建
  • 4. 确认类型推断 — 数字 / 日期 / select 会被自动推;不准的手动改
  • 5. 处理冲突 — 选 "Append"(追加)/ "Update by key"(按某列 upsert)/ "Replace"(清空再导)
  • 6. 等导入完成 — 状态栏显示进度;> 10K 行预计几秒到几十秒

一个真实例子

假设要把一份 Linear 任务列表导进来。Linear 导出的 CSV 长这样:

id,title,status,priority,assignee,due_date,estimate
ENG-101,"Fix login bug",In Progress,Urgent,[email protected],2026-06-15,3
ENG-102,"Refactor payment flow",Todo,High,[email protected],2026-06-22,8
ENG-103,"Add OAuth provider",Done,Medium,[email protected],2026-06-01,5

推断会怎么走

  • idtext(主键候选,Kition 会建议设为 unique)
  • titletext
  • status / priorityselect(值少于 20 个,自动推为 select)
  • assigneeemail(识别 email 格式)
  • due_datedate(识别 ISO 8601)
  • estimatenumber(纯数字列)

常见坑

  • Excel 默认 GBK / Windows-1252 — 导出时手动选 UTF-8,否则中文 / é / ñ 乱码
  • 日期格式混杂2026/6/7Jun 7, 2026 混在一起会被识别成 text;先在 Excel 里统一成 ISO
  • 带逗号的字段 — 用双引号包起来:"hello, world"
  • > 50K 行 — 分批导(每批 10K),避免长事务卡 UI
  • 带换行的字段 — RFC 4180 允许;CSV 写出时确保字段也被引号包
  • 布尔列yes/notrue/false1/0 都能被推断为 checkbox

相关文档

下载 Kition

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