# 项目开发台

使用项目开发台管理文件、服务、流程、数据、类型、函数、Git、环境、依赖、日志和事项。

项目开发台是开发者处理单个业务项目的工作区。一个项目可以包含页面文件、后端服务、流程、数据、类型、函数、模块依赖、Git 配置、环境变量、管理后台和运行日志。

## 进入项目

从工作区「项目」页选择项目进入。项目地址形如：

```text
/project/{projectId}
```

不同项目类型会有不同默认页面。进入后如果看不到预期菜单，先确认项目类型、项目归属工作区和当前账号权限。

## 常用页面

| 页面   | 用途                     | 常见动作                                                            |
| ---- | ---------------------- | --------------------------------------------------------------- |
| 文件   | 管理前端或项目文件。             | 上传、编辑、预览、整理目录。                                                  |
| 服务   | 管理项目后端服务。              | 创建接口、配置属性、查看方法。                                                 |
| 流程   | 管理项目内业务流程。             | 新建流程、维护步骤。                                                      |
| 数据   | 查看项目数据列表。              | 查看数据表、添加数据表、检查状态。                                               |
| 设置   | 管理项目基础设置。              | 修改名称、描述、项目配置。                                                   |
| 定价   | 配置项目商业化或套餐信息。          | 查看价格配置、调整展示。                                                    |
| 类型   | 管理项目类型定义。              | 新建类型、查看字段、复用类型。                                                 |
| 模块详情 | 查看项目关联模块。              | 管理属性、方法、事件和依赖。                                                  |
| 函数   | 管理项目函数。                | 创建函数、编辑参数、测试函数。                                                 |
| Git  | 管理代码仓库配置和 `main` 写入策略。 | 查看同步状态；按[项目分支策略](/concepts/projects/#git-main-写入策略)选择直推或个人分支合并。 |
| 管理后台 | 打开项目后台能力。              | 管理业务数据或运营功能。                                                    |
| 日志   | 查看运行日志和链路详情。           | 按 trace 排查接口、模块和智能体调用。                                          |
| 依赖   | 查看项目依赖。                | 检查模块、类型、函数依赖关系。                                                 |
| 环境   | 管理环境配置。                | 检查变量、密钥和运行差异。                                                   |
| 事项   | 查看项目问题和待办。             | 处理失败项、跟踪异常。                                                     |

## 开发顺序

推荐按下面顺序开发：

1. 在设置中确认项目名称、类型和工作区。
2. 在文件中完成页面或前端入口。
3. 在服务中定义后端接口和业务方法。
4. 在类型中定义稳定的数据结构。
5. 在函数中封装可复用逻辑。
6. 在模块详情中接入外部能力。
7. 在环境中保存密钥、token 和运行变量。
8. 在日志中验证真实调用链路。
9. 发布后在工作区应用或网站入口验证。

## 排查顺序

| 现象          | 优先检查                |
| ----------- | ------------------- |
| 页面打不开       | 文件、发布状态、运行时入口。      |
| 接口 404 或无响应 | 服务、运行时路由、后端日志。      |
| 数据结构不一致     | 类型定义、函数入参、模块方法返回。   |
| 调用外部系统失败    | 模块属性、服务属性、环境变量。     |
| AI 回复异常     | 智能体配置、技能挂载、工具调用日志。  |
| 发布后行为和预览不同  | 环境配置、运行时、模块属性和渠道回调。 |

## 项目与工作区边界

项目只管理当前业务应用的开发资产。成员、余额、应用安装、服务实例、工作区级渠道和审计要回到工作区或管理台处理。

如果问题涉及多个项目、多个成员或多个外部实例，不要只在单个项目里修改配置，应先回到 [工作区管理台](/features/workspace-management/) 确认责任边界。