主题
AI 低代码开发
AI 低代码开发是让 AI 参与 SuccApp 项目交付的一种方式：人提出业务目标和验收标准，AI 读取项目规则、理解元数据结构、修改本地文件，再由人和工具一起检查差异、验证效果并同步到服务器。
它不是让 AI 在浏览器设计器里模拟点击，而是把 SuccApp 元数据文件系统当作一套以 JSON 为主的低代码编程语言来编辑。页面、仪表板、报表、数据模型、程序流、脚本、主题和配置都以文件形式保存；AI 编辑这些文件时，应参考元数据系统中的格式规范、DTS、示例和当前项目同类文件，而不是只凭业务描述生成 JSON。
一次完整的 AI 低代码开发闭环通常包括：先在本地工作区修改元数据文件；再检查 diff、DTS、引用关系和同类文件写法；然后使用 SuccApp CLI 的 workspace file compile 执行服务器编译校验，检查 JSON 配置、表达式等元数据语义；通过检查后推送到测试服务器，由 AI 辅助整理验证点、人工完成业务测试；测试确认后，再按团队发布流程同步到生产服务器。
处理任何用户问题时，先理解 AI 低代码开发方式，再阅读任务驱动，按用户目标进入对应任务目录，并补充读取元数据格式、DTS、示例、工具和验证资料。
为什么需要 AI + 低代码
传统低代码实施主要依赖人在设计器里逐项配置。AI 低代码开发把这些配置沉淀为可阅读、可对比、可回退的文件，让 AI 可以帮助完成查找、理解、生成、批量修改和风险检查，让人把精力放在业务判断、效果验证和发布决策上。
它适合帮助团队完成这些工作：
- 开发完整的低代码应用，例如 CRM、请假流程、报销流程、合同管理等。
- 开发完整的数据分析项目，从数据建模、数据加工、调度，到报表、仪表板和可视化页面。
- 制作或调整单个页面，例如大屏、业务表单、详情页、审批页和移动端页面。
- 完成二次开发任务，例如脚本开发、第三方系统集成、接口对接、扩展开发和模板定制。
- 配置系统管理和运维相关能力，例如权限、菜单、组织、角色、数据范围和系统设置。
- 排查项目问题，例如数据不对、页面打不开、图表无数据、脚本报错、权限不符合预期。
- 做批量调整和持续交付，例如批量改文案、调整过滤条件、整理脚本、检查差异、推送测试和发布生产。
AI + 低代码比直接 AI 编程更适合企业应用
AI + 低代码把“写代码”变成“组合业务能力”
直接 AI 编程通常要生成前端、后端、接口、权限、数据处理和部署脚本。AI + 低代码则是在 SuccApp 已有的页面、模型、数据集、流程、权限、报表、可视化、调度和发布能力之上完成组合，让 AI 把主要精力放在业务结构和交付目标上。
结构化元数据比自由代码更适合 AI 稳定生成
SuccApp 元数据文件系统本质上是一套 JSON 形式的低代码编程语言。它有明确的文件位置、字段结构、引用关系、元数据规范、DTS 和同类示例，比自由代码更容易被 AI 理解、生成和修改。
更快更稳定，也更容易被人类掌控
AI + 低代码可以复用平台内置能力，通常比直接 AI 编码更快；产出又是可阅读、可比较、可验证的元数据，不会变成只有研发人员才能接管的黑盒。业务人员、实施人员和团队负责人可以围绕页面、字段、流程、权限、指标和测试效果理解改动，提出调整并接管结果。
对非专业开发者更友好
企业应用的很多需求来自业务人员、实施人员、数据分析人员和运维人员。他们关心的是字段怎么定义、页面怎么排、流程怎么走、权限给谁、指标怎么算。AI + 低代码让这些人可以用业务语言参与开发，由 AI 把业务描述转换为 SuccApp 元数据。
不是替代所有编程，而是控制代码的使用范围
低代码仍然可以使用代码。脚本开发、复杂表达式、第三方系统集成、扩展开发和特殊业务逻辑都可以通过代码完成。区别在于，通用应用能力由平台承担，业务结构由元数据表达，只有确实需要编程的部分才写代码。
按角色阅读
AI 低代码开发需要项目成员、团队负责人、AI 工具和元数据作者一起协作。你可以按自己的角色选择阅读入口：
| 角色 | 先读什么 | 目标 |
|---|---|---|
| 项目成员 | 快速开始、任务驱动 | 跑通一次 AI 修改、差异检查、测试推送和 Git 提交。 |
| AI Agent | SuccApp 官方文档 Skill、任务驱动 | 按任务读取规则、元数据参考、工具和验证方法。 |
| 团队负责人 | 安全边界、团队协作、发布生产 | 制定 AI 修改、评审、测试到生产和回退规则。 |
| 工具负责人 | 了解基础概念和工具、SuccApp CLI、SuccApp for VS Code、MCP | 了解命令、视图、MCP 能力和安全边界。 |
| 元数据作者 | 元数据即代码、元数据系统 | 理解 JSON 元数据、DTS、同类文件和产品验证的关系。 |
如果只想理解元数据文件格式、后缀、DTS 和 .meta，请阅读元数据系统。本专题重点说明 AI 如何使用这些元数据完成低代码开发任务。
首次使用路径
第一次使用建议按下面顺序阅读：
- 快速开始：安装工具并跑通一次小修改。
- 元数据即代码：理解 AI 实际修改的对象。
- 了解基础概念和工具：了解 SuccApp CLI、SuccApp for VS Code 和 MCP 的分工。
- 任务驱动：根据用户问题进入对应任务页。
安排 AI 任务
给 AI 安排 SuccApp 修改任务时，先说清目标、环境、范围、参考、禁区和验收方式。任务说明建议见工作区中的 AI 协作文件，任务类型入口见任务驱动。
AI 接手后应先定位候选文件和影响范围，再修改元数据；修改完成后输出文件清单、依据、质量检查结果和需要人工确认的风险。
继续阅读
- 快速开始
- 任务驱动
- 了解基础概念和工具：理解元数据即代码、工作区、必备工具、安全边界和实施方式差异。
- 准备工作区：初始化工作区、认证、AI 上下文、连接服务器、Git 和同步变化。
- 管理项目：整理元数据项目、目录、资源和修改边界。
- 处理数据：连接、加工、调度、探查、查询、排查数据质量问题，以及准备测试或演示数据。
- 构建分析可视化：制作仪表板、图表、指标和筛选联动。
- 构建报表：制作报表、参数、打印、导出、模板和主题。
- 构建低代码应用：制作页面、业务应用、门户、程序流、工作流和移动端。
- 管理权限：配置用户、用户组、资源权限和数据范围。
- 脚本开发：判断是否需要写脚本，并选择前端脚本、后端脚本、样式、系统页、钩子或程序流脚本节点。
- 扩展平台能力：开发平台级扩展能力。
- 排查问题：排查同步、登录、数据、页面、权限和调度问题。
- 质量检查：检查 diff、引用、元数据结构、产品运行效果和交付风险。
- 管理发布：协作、提交、发布生产和回退。
- 通过示例学习：查看 DEMO 元数据和典型示例。
