了解基础概念和工具

在让 AI 修改 SuccApp 项目前，先理解 AI 实际修改的对象、工作区同步模型、必备工具、安全边界，以及 SuccApp 和浏览器实施方式的差异。

什么时候进入

遇到以下问题时，先阅读本目录：

• 第一次了解 AI 低代码开发，不清楚 AI 实际修改什么。
• 需要区分 SuccApp 工作区、SuccApp CLI、SuccApp for VS Code 和 MCP 的分工。
• 需要确定 AI 能做什么、哪些操作必须人工确认。
• 需要向团队解释为什么不直接让 AI 在浏览器设计器中模拟点击。

任务入口

主题	先读	适用情况
元数据即代码	元数据即代码	理解 AI 修改的是本地工作区中的 SuccApp 元数据文件。
工作区	工作区	理解本地工作区、服务器同步基线、AI 协作文件和 Git 的关系。
SuccApp CLI	SuccApp CLI	需要在终端中初始化工作区、登录服务器、查询数据、检查差异或同步变化。
SuccApp for VS Code	SuccApp for VS Code	需要人工浏览服务器项目、查看 Changes、打开 diff、编辑脚本或推送测试环境。
MCP	MCP	需要让支持 MCP 的 AI 客户端读取服务器信息、查元数据或查询数据库结构。
安全边界	安全边界	需要约束 AI 写服务器、改生产、删除资源、执行 SQL 或影响权限流程。
实施方式差异	SuccApp 和浏览器实施的区别	需要判断什么时候适合用 SuccApp 工作区，什么时候适合直接在浏览器里配置。

相关阅读

• 准备工作区：理解基础概念后，继续初始化工作区、配置认证和克隆项目。
• 质量检查：AI 修改完成后，检查变化范围、元数据结构和产品效果。