---
title: "总体架构 — Kition 蓝图"
description: "分层、五条规矩、同一个引擎到处跑、每个 kit 存自己的文件。"
canonical: "https://kition.ai/zh-CN/blueprint/architecture"
---

> Canonical HTML: [https://kition.ai/zh-CN/blueprint/architecture](https://kition.ai/zh-CN/blueprint/architecture)

蓝图

-   [新范式](https://kition.ai/zh-CN/blueprint)
-   [为什么是现在](https://kition.ai/zh-CN/blueprint/why-now)
-   [总体架构](https://kition.ai/zh-CN/blueprint/architecture)
-   [数据模型](https://kition.ai/zh-CN/blueprint/data-model)
-   [协同](https://kition.ai/zh-CN/blueprint/collaboration)
-   [把 Kition 集成进你的产品](https://kition.ai/zh-CN/blueprint/integrate)
-   [开源和价格](https://kition.ai/zh-CN/blueprint/open)

语言

-   [English](https://kition.ai/blueprint/architecture)
-   [简体中文](https://kition.ai/zh-CN/blueprint/architecture)

[Kition](https://kition.ai/)/[蓝图](https://kition.ai/zh-CN/blueprint)/总体架构

蓝图

# 总体架构

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

更新于 2026-11-05

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](https://kitharness.org/)。

[下一篇数据模型：Kit Data Model（KDM） →Kit Data Model（KDM）：kit 共用的、可合并的数据模型，每个修改都有作者、都有历史。](https://kition.ai/zh-CN/blueprint/data-model)

On this page

-   [分层](#section-1)
-   [五条规矩](#section-2)
-   [同一个引擎到处跑](#section-3)
-   [文件怎么存](#section-4)
