功能指南
项目开发台
使用项目开发台管理文件、服务、流程、数据、类型、函数、Git、环境、依赖、日志和事项。
项目开发台是开发者处理单个业务项目的工作区。一个项目可以包含页面文件、后端服务、流程、数据、类型、函数、模块依赖、Git 配置、环境变量、管理后台和运行日志。
进入项目
从工作区「项目」页选择项目进入。项目地址形如:
/project/{projectId}不同项目类型会有不同默认页面。进入后如果看不到预期菜单,先确认项目类型、项目归属工作区和当前账号权限。
常用页面
| 页面 | 用途 | 常见动作 |
|---|---|---|
| 文件 | 管理前端或项目文件。 | 上传、编辑、预览、整理目录。 |
| 服务 | 管理项目后端服务。 | 创建接口、配置属性、查看方法。 |
| 流程 | 管理项目内业务流程。 | 新建流程、维护步骤。 |
| 数据 | 查看项目数据列表。 | 查看数据表、添加数据表、检查状态。 |
| 设置 | 管理项目基础设置。 | 修改名称、描述、项目配置。 |
| 定价 | 配置项目商业化或套餐信息。 | 查看价格配置、调整展示。 |
| 类型 | 管理项目类型定义。 | 新建类型、查看字段、复用类型。 |
| 模块详情 | 查看项目关联模块。 | 管理属性、方法、事件和依赖。 |
| 函数 | 管理项目函数。 | 创建函数、编辑参数、测试函数。 |
| Git | 管理代码仓库配置。 | 配置凭据、查看同步状态。 |
| 管理后台 | 打开项目后台能力。 | 管理业务数据或运营功能。 |
| 日志 | 查看运行日志和链路详情。 | 按 trace 排查接口、模块和智能体调用。 |
| 依赖 | 查看项目依赖。 | 检查模块、类型、函数依赖关系。 |
| 环境 | 管理环境配置。 | 检查变量、密钥和运行差异。 |
| 事项 | 查看项目问题和待办。 | 处理失败项、跟踪异常。 |
开发顺序
推荐按下面顺序开发:
- 在设置中确认项目名称、类型和工作区。
- 在文件中完成页面或前端入口。
- 在服务中定义后端接口和业务方法。
- 在类型中定义稳定的数据结构。
- 在函数中封装可复用逻辑。
- 在模块详情中接入外部能力。
- 在环境中保存密钥、token 和运行变量。
- 在日志中验证真实调用链路。
- 发布后在工作区应用或网站入口验证。
排查顺序
| 现象 | 优先检查 |
|---|---|
| 页面打不开 | 文件、发布状态、运行时入口。 |
| 接口 404 或无响应 | 服务、运行时路由、后端日志。 |
| 数据结构不一致 | 类型定义、函数入参、模块方法返回。 |
| 调用外部系统失败 | 模块属性、服务属性、环境变量。 |
| AI 回复异常 | 智能体配置、技能挂载、工具调用日志。 |
| 发布后行为和预览不同 | 环境配置、运行时、模块属性和渠道回调。 |
项目与工作区边界
项目只管理当前业务应用的开发资产。成员、余额、应用安装、服务实例、工作区级渠道和审计要回到工作区或管理台处理。
如果问题涉及多个项目、多个成员或多个外部实例,不要只在单个项目里修改配置,应先回到 工作区管理台 确认责任边界。