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, and this page is available as Markdown at /apps-plugin/docs/client-framework/index.md.

应用插件框架

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

建议阅读路径

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

阅读目标

完成本组文档后,开发者应能:

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