# Life OS 应用开发文档索引

Life OS 是一台云上的个人电脑。应用通过 platform.data 访问当前用户的数据，通过 platform.ui 构建界面，通过 platform.* 使用宿主能力。

从快速上手开始，再按需阅读应用包、组件和 API。当前只有 Web 宿主；能力状态与限制以各篇文档为准。不要引入 KV，也不要直接请求外部服务器或平台接口。

阅读版：[开发文档](/doc)。以下链接返回 text/markdown，无需登录。每篇阅读页面右上角也可以复制 Markdown 内容或完整 URL。此文件仅提供导航，不重复 API 正文。

## 指南

- [应用开发指南](/doc/markdown/index.md)：了解应用、用户数据与宿主之间的关系。
- [快速上手](/doc/markdown/start.md)：编写入口函数、预览界面并打开桌面应用。
- [安装与更新](/doc/markdown/install.md)：通过构建会话或开发接口创建、读取和更新应用包。
- [管理数据表](/doc/markdown/database.md)：在数据库应用中管理字段，分页查看和编辑当前用户的数据。
- [应用名称与图标](/doc/markdown/app-icons.md)：配置图片模型，生成、上传图标并编辑应用资料。

## 框架

- [运行环境](/doc/markdown/framework.md)：了解沙箱、跨端边界和应用开发约束。
- [应用入口与页面](/doc/markdown/entry.md)：掌握 render 的参数、异步启动与页面组织。
- [多文件应用包](/doc/markdown/packages.md)：了解 app.json、相对 import、CSS 与文件限制。

## 组件

- [组件总览](/doc/markdown/components.md)：查阅全部 platform.ui 组件与返回值约定。
- [布局与文字](/doc/markdown/components/layout.md)：页面、卡片、分组、标题和空状态。
- [表单控件](/doc/markdown/components/forms.md)：输入框、文本域、选择、复选框与开关。
- [交互与导航](/doc/markdown/components/navigation.md)：按钮、列表、分段选择和标签。
- [状态反馈](/doc/markdown/components/feedback.md)：轻提示、确认弹层与加载状态。
- [图片与数据展示](/doc/markdown/components/display.md)：图片、头像、统计数值与贴纸标记。

## API

- [能力一览](/doc/markdown/api.md)：区分已经开放的宿主能力与尚未开放的功能。
- [数据](/doc/markdown/api/data.md)：发现数据集、读取单条记录与理解返回结构。
- [筛选、排序与分页](/doc/markdown/api/query.md)：使用 where、search、orderBy、limit、offset 和 count。
- [写入与删除](/doc/markdown/api/mutations.md)：新增、批量新增、更新、删除及返回值。
- [宿主与用户](/doc/markdown/api/host.md)：读取当前平台、检查能力并获取当前用户信息。
- [剪贴板](/doc/markdown/api/clipboard.md)：通过宿主复制文本并处理浏览器限制。
- [应用控制](/doc/markdown/api/app.md)：关闭当前应用与理解标签生命周期。

## 样式

- [设计规范](/doc/markdown/style.md)：使用宿主颜色、布局类和响应式规范。

## 示例

- [待办示例](/doc/markdown/examples/todo.md)：体验新增、服务端筛选、计数与完成状态更新。
- [多文件待办](/doc/markdown/examples/multi-file.md)：用数据模块、列表页和详情页构建完整应用。