蓝图

总体架构

分层、五条规矩、同一个引擎到处跑、每个 kit 存自己的文件。

更新于

Kition 是一个桌面应用,自带 AI agent 和 16 个 kit:Tauri 外壳加上 Rust 运行时。同样的 kit 以 Kition Kits 的形式交给别的产品,也用在团队版 Kition One 里。

分层

Kition 从上到下的分层
层做什么
使用方人(kit 自带的编辑器)、你的产品(把编辑器嵌进网页)、脚本(对象模型)、AI agent(遵守 KHP 的 MCP 工具)。四种使用方走同一个入口
会话把命令变成事务;提供对象模型;推送事件和在线状态;按作者撤销
kit每类文件一个引擎:领域规则、校验、排版、渲染;加上读写文件
数据Kit Data Model(KDM):kit 共用的数据模型,所有修改都能合并、都有历史
存储和同步单人时存在你的文件夹里;协同时连到 Kition Server 或 Kition Cloud

五条规矩

  1. 一份文档一个权威。 协同时以 KDM 副本为准,引擎里的模型只是它的视图。绝不用“整份替换”的方式同步。
  2. 所有修改都是事务。 打字、拖拽、菜单、脚本、扩展、导入、AI,全部走同一个入口,没有后门。每个事务记着是谁做的:人、agent、脚本、导入还是系统。
  3. 文件是保存和交换的格式,不是状态。 每个 kit 存自己的文件(Doc 存 .docx,CAD 存 .dxf,Board 存 .kboard),打开时读进模型,保存时从模型写出;你的文件还是你的文件。
  4. 私有状态不复制。 选区、光标、缩放、渲染结果不当作文档数据同步;光标和选区作为“在场”信息单独传。
  5. 到处是同一个合约。 网页里、桌面端、服务器上跑的是同一个引擎,同一套接口。

同一个引擎到处跑

kit 的引擎大多用 Rust 写,编译成 WebAssembly 在网页和桌面端里跑,也编译成原生程序(kition-<kit>,比如 kition-slide)在服务器上无头运行。实验验证过:Rust 和 TypeScript 两个版本的数据副本逐字节一致。

这带来三件事:

  • AI 改的就是人看到的:AI 在服务器上无头改的文件,和人在编辑器里打开看到的完全一样。
  • 嵌入不用重写:把编辑器嵌进别的产品,用的是同一个 kit 包。
  • 服务器不用第二套实现:预览、导出、校验、服务器上的 agent,都用同一个引擎。

文件怎么存

  • 文档就是你文件夹里的一个文件,用 kit 的格式;Kition 的工作数据(历史、素材)放在工作区的 .kition 目录里。
  • 文件在 Kition 外面被改了,新内容作为一次“导入”合进来,不会被覆盖。
  • 认不出的内容(比如某个格式的冷门特性)存成只读的“原样保留”对象,保存时写回去。

协议本身,Kit Harness Protocol(KHP),在 kitharness.org。