---
title: 做页面
navTitle: 做页面
---
# 做页面

“做页面”通常指创建或修改 SuperPage、模板页面、报表填报应用、入口页或业务操作页面。AI 可以辅助查找文件、生成组件结构、调整文案和事件，但必须用产品页面或设计器验证效果。

## 阅读顺序{#reading-order}

1. 先读 [SuccApp 官方文档 Skill](../../../../SKILL.md) 中的 AI 低代码开发说明和[工作区中的 AI 协作文件](../basics/workspace.md#ai-files)，确认目标、环境、范围、禁区和验收方式。
2. 再读[元数据系统](../../meta/README.md)、[文件类型](../../meta/file-types/README.md)、[SuccApp Super JSON](../../meta/rules/super-json.md)。
3. 根据目标文件类型继续读 [SuperPage 页面](../../meta/file-types/views/spg.md)、[超级模板页面](../../meta/file-types/views/tpg.md) 或[报表填报应用](../../meta/file-types/views/fapp.md)。
4. 修改前参考当前项目同类页面、组件、数据集和相关 DTS；修改后按[引用检查](../quality/reference-check.md)、[产品验证](../quality/product-verification.md)和[Diff 审查](../quality/diff-review.md)验证。

## 先判断文件类型{#file-types}

常见文件包括：

| 文件 | 用途 |
| --- | --- |
| `.spg` | SuperPage 页面。 |
| `.tpg` | 超级模板页面。 |
| `.fapp` | 报表填报应用。 |
| `.afl`、`.wfl` | 页面动作、流程或工作流相关逻辑。 |
| `.ts`、`.js`、`.action.ts`、`.ftl` | 前端脚本、后端脚本和模板逻辑。 |

## AI 修改前{#before}

给 AI 的任务应说明：

1. 目标页面或业务入口。
2. 是否新建页面，还是修改已有页面。
3. 数据来源、字段、按钮、跳转和权限限制。
4. 不允许修改的范围，例如数据模型、流程、权限或生产配置。
5. 验证方式，例如打开哪个页面、执行哪个按钮或检查哪个字段。

## 推荐流程{#workflow}

1. 让 AI 先查找候选页面和同类文件，不要立即修改。
2. 确认目标文件、数据集、组件和动作范围。
3. 小步修改页面 JSON、脚本或 `.meta`。
4. 使用 DTS、同类文件和元数据静态检查确认结构。
5. 查看 SuccApp diff，确认没有无关格式化。
6. 推送测试服务器并打开页面预览。
7. 测试通过后提交 Git。

## 验证重点{#validation}

1. 页面能打开，没有 JSON 或脚本报错。
2. 参数、数据集和组件绑定正确。
3. 按钮、跳转、弹窗和动作流符合需求。
4. 引用的模型、图片、脚本和页面路径有效。
5. 权限和数据范围没有被误改。

相关验证方法见[引用检查](../quality/reference-check.md)、[产品验证](../quality/product-verification.md)和[Diff 审查](../quality/diff-review.md)。