蓝图
总体架构
分层、五条规矩、同一个引擎到处跑、每个 kit 存自己的文件。
更新于
Kition 是一个桌面应用,自带 AI agent 和 16 个 kit:Tauri 外壳加上 Rust 运行时。同样的 kit 以 Kition Kits 的形式交给别的产品,也用在团队版 Kition One 里。
分层
| 层 | 做什么 |
|---|---|
| 使用方 | 人(kit 自带的编辑器)、你的产品(把编辑器嵌进网页)、脚本(对象模型)、AI agent(遵守 KHP 的 MCP 工具)。四种使用方走同一个入口 |
| 会话 | 把命令变成事务;提供对象模型;推送事件和在线状态;按作者撤销 |
| kit | 每类文件一个引擎:领域规则、校验、排版、渲染;加上读写文件 |
| 数据 | Kit Data Model(KDM):kit 共用的数据模型,所有修改都能合并、都有历史 |
| 存储和同步 | 单人时存在你的文件夹里;协同时连到 Kition Server 或 Kition Cloud |
五条规矩
- 一份文档一个权威。 协同时以 KDM 副本为准,引擎里的模型只是它的视图。绝不用“整份替换”的方式同步。
- 所有修改都是事务。 打字、拖拽、菜单、脚本、扩展、导入、AI,全部走同一个入口,没有后门。每个事务记着是谁做的:人、agent、脚本、导入还是系统。
- 文件是保存和交换的格式,不是状态。 每个 kit 存自己的文件(Doc 存
.docx,CAD 存.dxf,Board 存.kboard),打开时读进模型,保存时从模型写出;你的文件还是你的文件。 - 私有状态不复制。 选区、光标、缩放、渲染结果不当作文档数据同步;光标和选区作为“在场”信息单独传。
- 到处是同一个合约。 网页里、桌面端、服务器上跑的是同一个引擎,同一套接口。
同一个引擎到处跑
kit 的引擎大多用 Rust 写,编译成 WebAssembly 在网页和桌面端里跑,也编译成原生程序(kition-<kit>,比如 kition-slide)在服务器上无头运行。实验验证过:Rust 和 TypeScript 两个版本的数据副本逐字节一致。
这带来三件事:
- AI 改的就是人看到的:AI 在服务器上无头改的文件,和人在编辑器里打开看到的完全一样。
- 嵌入不用重写:把编辑器嵌进别的产品,用的是同一个 kit 包。
- 服务器不用第二套实现:预览、导出、校验、服务器上的 agent,都用同一个引擎。
文件怎么存
- 文档就是你文件夹里的一个文件,用 kit 的格式;Kition 的工作数据(历史、素材)放在工作区的
.kition目录里。 - 文件在 Kition 外面被改了,新内容作为一次“导入”合进来,不会被覆盖。
- 认不出的内容(比如某个格式的冷门特性)存成只读的“原样保留”对象,保存时写回去。
协议本身,Kit Harness Protocol(KHP),在 kitharness.org。