---
title: DEMO 元数据参考示例
description: 说明如何在线查看 DEMO 元数据示例，并在 SuccApp CLI 初始化的官方离线文档 skill 中使用这些示例。
navTitle: DEMO 元数据
---
# DEMO 元数据参考示例

DEMO 元数据示例来自 SuccApp 示例项目 `DEMO`。站点只发布已升级到当前元数据类型最新版本的示例文件，可作为 AI 理解 SuccApp 元数据结构、文件组织和同类写法的参考。

DEMO 元数据示例只用于学习结构和参考写法。回答当前业务项目内容、排查服务器路径、查模型字段或判断依赖时，应以当前工作区和 SuccApp 服务器上的真实元数据为准，不得把 `metadata-examples` 当成当前服务器事实。

## 在线查看{#online}

可以从下面的典型文件开始查看：

| 示例文件 | 可参考内容 |
| --- | --- |
| [`metadata-examples/DEMO/app/afl.app/index.tpg`](/metadata-examples/DEMO/app/afl.app/index.tpg) | 应用模板页面结构。 |
| [`metadata-examples/DEMO/app/afl.app/节点/URL路由/URL路由_基本功能.spg`](../../../../metadata-examples/DEMO/app/afl.app/节点/URL路由/URL路由_基本功能.spg) | SuperPage 页面配置。 |
| [`metadata-examples/DEMO/ana/case/film/film1copy.dash`](../../../../metadata-examples/DEMO/ana/case/film/film1copy.dash) | 仪表板页面配置。 |
| [`metadata-examples/DEMO/app/bi.app/报表风格.rpt`](../../../../metadata-examples/DEMO/app/bi.app/报表风格.rpt) | 报表页面配置。 |
| [`metadata-examples/DEMO/app/Course.app/data/DIM_KCXX_KCBQ.tbl`](../../../../metadata-examples/DEMO/app/Course.app/data/DIM_KCXX_KCBQ.tbl) | 数据表模型配置。 |

完整索引见 [`metadata-examples/DEMO/index.json`](../../../../metadata-examples/DEMO/index.json)。索引只列出适合在线查看和 AI 读取的最新版本文本元数据文件。

## 在离线 skill 中使用{#offline-skill}

执行 `succapp workspace init` 后，SuccApp CLI 会同步官方离线文档 skill 到当前工作区。DEMO 元数据示例会作为该 skill 的内部资源保存：

```text
.agents/skills/succapp-docs/
├── indexes/
│   └── metadata-demo-index.json
└── metadata-examples/
    └── DEMO/
```

给 AI 安排任务时，可以让它优先读取 `indexes/metadata-demo-index.json`，再按任务类型选择同类文件。例如：

```text
请参考 .agents/skills/succapp-docs/metadata-examples/DEMO/app/ap.app/ 下的同类页面，
帮我判断当前工作区中这个 .spg 页面应如何调整。先说明候选文件和依据，不要直接修改。
```

## 使用建议{#usage}

1. 查文件类型时，先读[元数据系统](../../meta/README.md)和对应文件类型页，再打开 DEMO 同类文件对照。
2. 让 AI 参考 DEMO 时，明确允许参考的目录和目标文件类型，避免把 DEMO 中的历史测试页面误当成当前项目规范。
3. DEMO 示例用于理解结构和写法，正式项目仍应以当前工作区的同类文件、业务数据、DTS 和产品验证结果为准。