---
title: 了解基础概念和工具
description: 解释 AI 低代码开发中的元数据即代码、SuccApp 工作区、必备工具、安全边界和浏览器实施差异。
navTitle: 了解基础概念和工具
indexTitle: 概述
---
# 了解基础概念和工具

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

## 什么时候进入

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

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

## 任务入口

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

## 相关阅读

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