> For AI agents: the complete documentation index is available at /apps-plugin/docs/llms.txt, the full documentation bundle is available at /apps-plugin/docs/llms-full.txt.

# 应用插件框架

本组文档不重复项目创建和首次运行流程。阅读前应已完成入门文档，并能够运行一个基础应用插件。

## 建议阅读路径

1. [框架概述与应用配置](/apps-plugin/docs/client-framework/overview.md)：理解框架分层、应用组成、构建与运行机制，以及工程和配置约定；
2. [生命周期与错误处理](/apps-plugin/docs/client-framework/lifecycle.md)：理解应用、视图和组件三层生命周期；
3. [数据流与状态更新](/apps-plugin/docs/client-framework/data-flow.md)：理解 View Data、View Context、本地状态和对外动作；
4. [视图渲染与交互](/apps-plugin/docs/client-framework/rendering.md)：理解渲染模型、渲染元素与组件树，以及事件和线程边界；
5. [CSS 能力清单](/apps-plugin/docs/client-framework/css-capabilities.md)和[框架 API 参考](/apps-plugin/docs/client-framework/api-reference.md)用于按名称查询样式和 API 能力，不要求按顺序阅读；
6. [样式与布局差异](/apps-plugin/docs/client-framework/styling.md)：进阶理解布局、选择器、文本承载和动画等行为差异；
7. [Agent 与端侧交互](/apps-plugin/docs/client-framework/agent-interaction.md)：理解 Agent 调用和事件订阅的运行时边界；

## 阅读目标

完成本组文档后，开发者应能：

- 识别业务入口、Framework、UI 渲染器与豆包宿主的职责；
- 判断代码应放在 App、Page、Widget、Client Tool 还是 React 组件中；
- 理解生命周期、数据更新和渲染之间的关系；
- 理解源码如何被构建为应用运行时与独立视图产物，以及宿主何时加载它们；
- 根据开发任务定位到正确的 Framework API；
- 识别豆包应用插件与 Web 在布局、文本和样式能力上的关键差异；
- 避免把 Page 或 Widget 当作浏览器网页开发；
