用途:在 Databricks Apps 平台上构建并部署应用,适用于需要定制交互、写回、嵌入式或鉴权流程、Genie/聊天界面的场景。简单看板应改用 databricks-aibi-dashboards 技能;任何展示数据的应用还须配合 databricks-app-design 技能设计布局与图表。
包管理器:官方仅支持 npm 与 pnpm,按项目说明、package.json 的 packageManager、锁文件顺序判定,冲突或不支持时须询问用户,无信号时默认 pnpm。
开发流程:先运行 databricks apps manifest 获取清单,再用 databricks apps init --name <NAME> --features <插件> --set <资源键值> 脚手架。--name 仅小写字母数字连字符且不超过 26 字符。读取 Unity Catalog 数据前须让用户在 Lakebase 同步表与分析两种方式间选择,再决定 --features lakebase 或 analytics。分析类应用先在 config/queries/ 写 SQL,运行 <pm> run typegen 生成类型后再写 UI。部署前运行 databricks apps validate --profile <PROFILE>。
限制:运行测试前必须更新 tests/smoke.spec.ts 选择器,仅使用 Playwright locator;查询结果需控制在 1 MB 内;不要覆盖 @databricks/appkit 版本;API 签名以 npx @databricks/appkit docs 为准;禁止用双重类型断言;不得用自定义端点跑 SELECT,也不得用 useAnalyticsQuery 查 Lakebase。其余平台细节暂未提供。