metabase-data-apps

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Metabase data apps

Metabase 数据应用

This skill is split into parts, one per task. Each part is a guide in its own folder, together with the files only that task uses. Paths in this skill are relative to

<skill-dir>

, the directory holding this

SKILL.md

本技能按任务拆分为多个部分，每个任务对应一个部分。每个部分都是独立文件夹中的指南，附带仅该任务使用的文件。本技能中的路径均相对于

<skill-dir>

，即存放此

SKILL.md

的目录。

Read only the parts the task needs

仅阅读任务所需的部分

Every guide is long, and its rules apply only to its own task. Pick the parts from the user's request, read those guides, and leave the others unread.

The task	Read
Create, scaffold, or remove an app; the dev preview and its diagnostics feed; syncing an app to Metabase; an app-wide error	`setup/setup.md`
Change an existing app's UI without new data or writes: layout, theme, SDK components, how a chart renders	`setup/setup.md` , from Source conventions on
Show Metabase data: tables, metrics, segments, measures, saved questions, filters, charts, the generated `metabase.data.ts`	`semantic-layer/semantic-layer.md`
More than one page: routes, links between pages, the current path	`routing/routing.md`
A write: a form, a button that creates, updates, or deletes, running an action	`actions/actions.md`
Metabase marks the app Outdated, the user asks to migrate it, or `npm run typecheck` or `npm run build` fails after an SDK upgrade	`migrate/migrate.md`

Don't read
```
routing/routing.md
```
unless the app needs more than one page.
Don't read
```
actions/actions.md
```
unless the app writes data.
Don't read
```
migrate/migrate.md
```
unless the app needs migrating as the table says. An app Metabase doesn't mark Outdated, and that builds, needs no migration.
A task can span parts: a new app that shows a metric needs
```
setup/setup.md
```
, then
```
semantic-layer/semantic-layer.md
```
. Read each part when the work reaches it, not all of them up front.
When a guide points to another part or to a file under its own
```
references/
```
, read it only when you reach that step.

每份指南内容都较长，且其规则仅适用于对应的任务。请根据用户需求选择对应部分的指南阅读，无需阅读其他部分。

任务类型	需阅读的文件
创建、搭建或删除应用；开发预览及其诊断信息流；将应用同步到Metabase；应用全局错误	`setup/setup.md`
修改现有应用的UI（不涉及新增数据或写入操作）：布局、主题、SDK组件、图表渲染方式	`setup/setup.md` ，从_源码约定_章节开始阅读
展示Metabase数据：表、指标、分段、度量、已保存问题、筛选器、图表、生成的 `metabase.data.ts`	`semantic-layer/semantic-layer.md`
多页面场景：路由、页面间链接、当前路径	`routing/routing.md`
数据写入场景：表单、用于创建/更新/删除的按钮、运行action	`actions/actions.md`
Metabase将应用标记为_过时（Outdated）_、用户要求迁移应用，或是SDK升级后 `npm run typecheck` 或 `npm run build` 执行失败	`migrate/migrate.md`

除非应用需要多页面，否则不要阅读
```
routing/routing.md
```
。
除非应用涉及数据写入，否则不要阅读
```
actions/actions.md
```
。
除非表格中说明的需要迁移的场景，否则不要阅读
```
migrate/migrate.md
```
。未被Metabase标记为过时且可正常构建的应用无需迁移。
一个任务可能涉及多个部分：例如一个展示指标的新应用需要先阅读
```
setup/setup.md
```
，再阅读
```
semantic-layer/semantic-layer.md
```
。请在工作推进到对应阶段时再阅读相应部分，无需提前全部阅读。
当某份指南指向另一部分或其自身
```
references/
```
目录下的文件时，仅在执行到对应步骤时再阅读。