应用开发指南

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

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

从这里开始

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

数据属于用户

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

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

当前支持范围

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

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

阅读与引用

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

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