> ## Documentation Index
> Fetch the complete documentation index at: https://docs.kazzle.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 应用模式

> 为常见任务选择合适的 Kazzle 应用形态。

# 应用模式

选择最小的应用形态来匹配任务需求。仅在应用需要时才添加流程、数据库、同步或 AI API。

| 用户需求             | 使用                 | 说明                                                                       |
| ---------------- | ------------------ | ------------------------------------------------------------------------ |
| 落地页、报告、静态页面      | UI 应用              | 一个 UI 组件就足够了。                                                            |
| 仪表板或内部工具（含服务器数据） | UI + 流程            | 将 API 路由和凭证保存在流程组件中。                                                     |
| 应用数据持久化          | UI + 流程 + 数据库      | 重用合适的活跃数据库，而不是新建。                                                        |
| 离线或即时多设备数据       | 实时应用               | 启用同步并验证 `sync: ready`，然后连接应用。                                            |
| 定时任务或 webhook    | 流程应用               | 在流程组件上使用触发器。                                                             |
| 应用内的 AI 驱动功能     | 流程 + Kazzle AI API | 使用 `/ai/*` 和 `kzl_` API 密钥。                                              |
| 助手稍后应调用的工具       | 技能 + 流程            | 添加技能文件夹（`SKILL.md` + `tools.ts`），并用流程组件上的路由支持每个 `target.type: 'app'` 工具。 |

## 默认做法

* 有合适的模板时从模板开始。
* 保持前端代码不含密钥和数据库 URL。
* 将仅服务器端的工作放在流程组件中。
* 使用同级组件 URL，而不是硬编码的 localhost 地址。
* 在应用开发标签页中验证预览，然后再说应用正在运行。