# 应用开发指南

Life OS 是一台云上的个人电脑。用户在桌面上打开应用，也可以通过对话让 Agent 读取、记录和更新同一份数据。你开发的应用就运行在这台电脑里。

应用由 JavaScript 文件组成，通过 `platform.data` 读写当前用户的数据，通过 `platform.ui` 构建界面，通过 `platform.*` 使用宿主能力。无需为每个应用单独搭建业务服务器或实现登录。

## 从这里开始

- [快速上手](/doc/start)：编写并预览第一个应用。
- [安装与更新](/doc/install)：将应用添加到桌面，更新源码和数据绑定。
- [多文件应用包](/doc/packages)：拆分页面、逻辑和样式。
- [界面组件](/doc/components)：使用与主站一致的组件。
- [数据](/doc/api/data)：发现数据集、查询和写入记录。
- [多文件待办](/doc/examples/multi-file)：运行一个包含列表和详情页面的完整应用。

## 数据属于用户

应用读写的是这台云上电脑的数据。对应用开发者而言，它像设备提供的数据库；物理数据仍然保存在云端，并不是浏览器本地存储。换一部设备，登录后仍然使用同一份数据。

数据独立于应用，多个应用和 Agent 可以协作使用同一份数据。页面筛选和临时状态放在内存，需要持久保存的信息通过数据 API 写入数据库，不另外引入 KV。

## 当前支持范围

当前已经实现 Web 宿主、数据查询和写入、界面组件、多文件包、用户信息、剪贴板写入与关闭应用。iOS、macOS、Android、Windows 是跨端目标，目前没有这些端的宿主实现。

文件、相机、相册、系统通知、后台任务和外部网络请求尚未开放。使用前请查看[能力一览](/doc/api)，不要根据规划文档推断 API 已经可用。

## 阅读与引用

左侧目录按主题组织，每篇文档右上角可以复制 Markdown 正文或纯 Markdown URL。代码可以单独复制，标有预览的示例可以直接操作。

[AGENTS.md 文档索引](/AGENTS.md) 提供所有文章的 Markdown 链接。预览使用独立的模拟数据，不会访问当前账号的数据库；刷新页面会重置预览数据。