开发指南
从开发基础开始，选择通用 AI Coding 或百积木平台开发路径，完成实现、验证与发布。
开发指南面向创建、修改、测试和发布项目的开发者。第一次开发时，先完成开发基础，再根据目标选择通用 AI Coding 开发或百积木平台开发。
开发者快速开始
- 安装与配置开发环境，完成百积木客户端和 CLI 的安装与验收。
- 选择工作区并获取项目，确认项目归属并检出当前用户的开发分支。
- 使用 Codex 开发，让 Codex 定位、实现、测试并复核变更。
- 根据开发路径执行构建、发布和正式入口验证。
先确认三个不同的目标
工作区决定账号授权和资源归属，项目决定源码与 Git 历史，环境决定最终运行位置。切换 CLI 工作区不会自动切换本地仓库，也不会自动改变开发、测试或生产环境。
公共类型语法、对象开放性和接口引用统一查阅类型系统；响应 envelope 与数据边界查阅 CModel 数据契约。
选择开发路径
开发内容分为两条主路径。通用 AI Coding 面向普通网站和后端服务；百积木平台开发面向需要进入工作区、Runtime、Bundle 或百积木客户端的扩展能力。
| 路径 | 适用对象 | 主要交付物 | 平台边界 |
|---|---|---|---|
| 通用 AI Coding 开发 | 网站、前端应用、后端应用和微服务 | Web 构建产物、Artifact、Hosted Service Deployment | 不要求进入百积木平台；可被平台能力调用 |
| 百积木平台开发 | 平台应用、运行时模块、Bundle、Bundle 管理器和 Connector | 平台应用版本、模块版本、Bundle Version 或 Connector 版本 | 遵循工作区安装、Runtime、Bundle 或客户端生命周期 |
通用 AI Coding 路径从前端网站开发或后端应用开发进入；前端项目可以进一步选择多页面前端开发，后端项目可以进一步选择微服务后端开发。
百积木平台路径中的正式开发对象使用“平台应用”这一术语。平台应用定义和版本通过 Bundle 安装到工作区；安装完成后形成当前工作区可见、可打开的应用实例，产品界面可以称为“工作区应用”。
组合关系
通用前端项目
-> 构建和发布 Web 站点
-> 平台应用版本引用入口 URL
平台模块定义
-> 在所属 Bundle 内创建不可变模块版本
平台应用版本 + 模块版本
-> Bundle Manifest
-> 创建不可变 Bundle Version
-> 工作区安装、升级、卸载
通用后端项目
-> 主线项目版本发布
-> hosted_service_release
-> Hosted Service 按版本独立部署
本地应用项目
-> Connector 清单、服务和本机构建产物
-> 固定版本压缩包与 SHA-256
-> 本地应用市场审核
-> 百积木客户端安装和运行Bundle 管理器属于百积木平台开发的高级能力。推荐的目标架构是 接入 Runtime 与管理器协议 Bundle承担公共平台接入， 独立部署的 Hosted Service 保留业务、事务和 Database Capability 绑定；Bundle 不包含后端二进制。 该架构的正式能力与上线验证条件，以及当前直接实现 Bundle 管理器协议的操作步骤，见 Bundle 管理器开发。准确协议版本与完整请求以该章节的 生命周期与引用合同为准。
不要把不同发布对象混在一起
前端站点发布、后端项目版本部署、平台应用版本创建、Bundle 内模块版本创建、Bundle 版本创建和 Connector 市场发布是独立动作。任一动作成功都不能自动代表完整产品已经升级；模块版本创建也不是独立市场发布或安装。
开发 Bundle 管理器时，先按首次接入流程与验收规划一次性授权、启动握手、凭据恢复和业务验收， 按授权、部署、握手、凭据维护和 Bundle 联调的顺序完成交付。
组织级基础能力
平台应用、模块、智能体和工作流需要查询成员与角色、解析联系方式、发送渠道消息或创建人工事项时，进入 组织级基础能力。该章节位于百积木平台开发下，说明共同业务能力的发现、授权和组合调用； 资源定义与安装仍沿用 Bundle 开发流程。