百积木文档
功能指南

项目开发台

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

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

进入项目

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

/project/{projectId}

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

常用页面

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

开发顺序

推荐按下面顺序开发:

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

排查顺序

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

项目与工作区边界

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

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

本页内容