---
title: AI 低代码开发
description: >-
  介绍如何使用 AI 编辑 SuccApp 元数据文件系统，并通过 SuccApp CLI 和 SuccApp for VS Code
  完成低代码开发、验证、协作和发布。
navTitle: AI 低代码开发
indexTitle: 概述
---
# AI 低代码开发

AI 低代码开发是让 AI 参与 SuccApp 项目交付的一种方式：人提出业务目标和验收标准，AI 读取项目规则、理解元数据结构、修改本地文件，再由人和工具一起检查差异、验证效果并同步到服务器。

它不是让 AI 在浏览器设计器里模拟点击，而是把 SuccApp 元数据文件系统当作一套以 JSON 为主的低代码编程语言来编辑。页面、仪表板、报表、数据模型、程序流、脚本、主题和配置都以文件形式保存；AI 编辑这些文件时，应参考[元数据系统](../meta/README.md)中的格式规范、DTS、示例和当前项目同类文件，而不是只凭业务描述生成 JSON。

一次完整的 AI 低代码开发闭环通常包括：先在本地工作区修改元数据文件；再检查 diff、DTS、引用关系和同类文件写法；然后使用 SuccApp CLI 的 `workspace file compile` 执行服务器编译校验，检查 JSON 配置、表达式等元数据语义；通过检查后推送到测试服务器，由 AI 辅助整理验证点、人工完成业务测试；测试确认后，再按团队发布流程同步到生产服务器。

处理任何用户问题时，先理解 AI 低代码开发方式，再阅读[任务驱动](./task-driven.md)，按用户目标进入对应任务目录，并补充读取元数据格式、DTS、示例、工具和验证资料。

![SuccApp 工作界面](./images/overview-ui.png)

## 为什么需要 AI + 低代码{#why}

传统低代码实施主要依赖人在设计器里逐项配置。AI 低代码开发把这些配置沉淀为可阅读、可对比、可回退的文件，让 AI 可以帮助完成查找、理解、生成、批量修改和风险检查，让人把精力放在业务判断、效果验证和发布决策上。

它适合帮助团队完成这些工作：

1. 开发完整的低代码应用，例如 CRM、请假流程、报销流程、合同管理等。
2. 开发完整的数据分析项目，从数据建模、数据加工、调度，到报表、仪表板和可视化页面。
3. 制作或调整单个页面，例如大屏、业务表单、详情页、审批页和移动端页面。
4. 完成二次开发任务，例如脚本开发、第三方系统集成、接口对接、扩展开发和模板定制。
5. 配置系统管理和运维相关能力，例如权限、菜单、组织、角色、数据范围和系统设置。
6. 排查项目问题，例如数据不对、页面打不开、图表无数据、脚本报错、权限不符合预期。
7. 做批量调整和持续交付，例如批量改文案、调整过滤条件、整理脚本、检查差异、推送测试和发布生产。

## AI + 低代码比直接 AI 编程更适合企业应用{#ai-low-code-advantages}

1. **AI + 低代码把“写代码”变成“组合业务能力”**

   直接 AI 编程通常要生成前端、后端、接口、权限、数据处理和部署脚本。AI + 低代码则是在 SuccApp 已有的页面、模型、数据集、流程、权限、报表、可视化、调度和发布能力之上完成组合，让 AI 把主要精力放在业务结构和交付目标上。

2. **结构化元数据比自由代码更适合 AI 稳定生成**

   SuccApp 元数据文件系统本质上是一套 JSON 形式的低代码编程语言。它有明确的文件位置、字段结构、引用关系、元数据规范、DTS 和同类示例，比自由代码更容易被 AI 理解、生成和修改。

3. **更快更稳定，也更容易被人类掌控**

   AI + 低代码可以复用平台内置能力，通常比直接 AI 编码更快；产出又是可阅读、可比较、可验证的元数据，不会变成只有研发人员才能接管的黑盒。业务人员、实施人员和团队负责人可以围绕页面、字段、流程、权限、指标和测试效果理解改动，提出调整并接管结果。

4. **对非专业开发者更友好**

   企业应用的很多需求来自业务人员、实施人员、数据分析人员和运维人员。他们关心的是字段怎么定义、页面怎么排、流程怎么走、权限给谁、指标怎么算。AI + 低代码让这些人可以用业务语言参与开发，由 AI 把业务描述转换为 SuccApp 元数据。

5. **不是替代所有编程，而是控制代码的使用范围**

   低代码仍然可以使用代码。脚本开发、复杂表达式、第三方系统集成、扩展开发和特殊业务逻辑都可以通过代码完成。区别在于，通用应用能力由平台承担，业务结构由元数据表达，只有确实需要编程的部分才写代码。

## 按角色阅读{#audience}

AI 低代码开发需要项目成员、团队负责人、AI 工具和元数据作者一起协作。你可以按自己的角色选择阅读入口：

| 角色 | 先读什么 | 目标 |
| --- | --- | --- |
| 项目成员 | [快速开始](./quick-start.md)、[任务驱动](./task-driven.md) | 跑通一次 AI 修改、差异检查、测试推送和 Git 提交。 |
| AI Agent | [SuccApp 官方文档 Skill](../../../SKILL.md)、[任务驱动](./task-driven.md) | 按任务读取规则、元数据参考、工具和验证方法。 |
| 团队负责人 | [安全边界](./basics/safety.md)、[团队协作](./release/team-collaboration.md)、[发布生产](./release/release-to-prod.md) | 制定 AI 修改、评审、测试到生产和回退规则。 |
| 工具负责人 | [了解基础概念和工具](./basics/README.md)、[SuccApp CLI](./basics/cli.md)、[SuccApp for VS Code](./basics/vscode.md)、[MCP](./basics/mcp.md) | 了解命令、视图、MCP 能力和安全边界。 |
| 元数据作者 | [元数据即代码](./basics/metadata-as-code.md)、[元数据系统](../meta/README.md) | 理解 JSON 元数据、DTS、同类文件和产品验证的关系。 |

如果只想理解元数据文件格式、后缀、DTS 和 `.meta`，请阅读[元数据系统](../meta/README.md)。本专题重点说明 AI 如何使用这些元数据完成低代码开发任务。

## 首次使用路径{#start}

第一次使用建议按下面顺序阅读：

1. [快速开始](./quick-start.md)：安装工具并跑通一次小修改。
2. [元数据即代码](./basics/metadata-as-code.md)：理解 AI 实际修改的对象。
3. [了解基础概念和工具](./basics/README.md)：了解 SuccApp CLI、SuccApp for VS Code 和 MCP 的分工。
4. [任务驱动](./task-driven.md)：根据用户问题进入对应任务页。

## 安排 AI 任务{#assign-ai-task}

给 AI 安排 SuccApp 修改任务时，先说清目标、环境、范围、参考、禁区和验收方式。任务说明建议见[工作区中的 AI 协作文件](./basics/workspace.md#ai-files)，任务类型入口见[任务驱动](./task-driven.md)。

AI 接手后应先定位候选文件和影响范围，再修改元数据；修改完成后输出文件清单、依据、质量检查结果和需要人工确认的风险。

## 继续阅读{#catalog}

1. [快速开始](./quick-start.md)
2. [任务驱动](./task-driven.md)
3. [了解基础概念和工具](./basics/README.md)：理解元数据即代码、工作区、必备工具、安全边界和实施方式差异。
4. [准备工作区](./workspace/README.md)：初始化工作区、认证、AI 上下文、连接服务器、Git 和同步变化。
5. [管理项目](./project/README.md)：整理元数据项目、目录、资源和修改边界。
6. [处理数据](./data/README.md)：连接、加工、调度、探查、查询、排查数据质量问题，以及准备测试或演示数据。
7. [构建分析可视化](./analytics/README.md)：制作仪表板、图表、指标和筛选联动。
8. [构建报表](./report/README.md)：制作报表、参数、打印、导出、模板和主题。
9. [构建低代码应用](./app/README.md)：制作页面、业务应用、门户、程序流、工作流和移动端。
10. [管理权限](./permission/README.md)：配置用户、用户组、资源权限和数据范围。
11. [脚本开发](../script/choose-script.md)：判断是否需要写脚本，并选择前端脚本、后端脚本、样式、系统页、钩子或程序流脚本节点。
12. [扩展平台能力](./extension/README.md)：开发平台级扩展能力。
13. [排查问题](./troubleshoot/README.md)：排查同步、登录、数据、页面、权限和调度问题。
14. [质量检查](./quality/README.md)：检查 diff、引用、元数据结构、产品运行效果和交付风险。
15. [管理发布](./release/README.md)：协作、提交、发布生产和回退。
16. [通过示例学习](./examples/README.md)：查看 DEMO 元数据和典型示例。
