# 百积木文档：开发与集成

> 百积木平台开发与集成文档。请用这里的稳定工作流理解平台，再从当前运行时 methodDefinition 获取精确接口参数。

## AI 使用规则

- 本索引面向开发与集成；企业使用、管理和排查见使用与管理索引：<https://docs.baijimu.com/use/llms.txt>。
- 按任务直接读取以下当前文档；历史版本和迁移文档保留独立入口。
- CLI 命令与参数以本机逐级 --help 为准；业务请求的权限与协议由服务端在执行时校验。

- 不要硬编码市场模块版本 ID、内部服务地址或历史接口路径。
- 当前类型规范：<https://docs.baijimu.com/development/type-system/>；所有当前开发文档使用 Type14；Type13 已退役，禁止生成 DataType 数据声明。历史归档不属于当前开发入口。
- 操作项目 Git 前必须读取项目 main 写入策略：DIRECT 允许有写权限的成员快进直推 main；PROTECTED 必须推个人分支再通过平台合并。权威说明：<https://docs.baijimu.com/concepts/projects/>
- 页面 Markdown 是模型读取入口，HTML 是人类阅读和引用入口。
- 开发与集成完整文档：<https://docs.baijimu.com/build/llms-full.txt>
- 结构化清单：<https://docs.baijimu.com/docs-manifest.json>

- human 节点没有合适的事项定义时，创建工作区独立事项包；读取、更新、独立版本发布、API 和输出合同教程：<https://docs.baijimu.com/development/issue-definition-development/>

## 机器可读契约

- [BundleDefinition JSON Schema 23.0.0](https://docs.baijimu.com/contracts/bundle-definition/23.0.0/schema.json)：数据库可编辑定义与不可变发布内容的统一结构；按准确修订更新与发布，不创建 Bundle Git 仓库。
- [已退役 Git Bundle Project Manifest JSON Schema 12.0.0](https://docs.baijimu.com/contracts/bundle-project-manifest/12.0.0/schema.json)：仅供历史归档识别；当前编辑和发布统一使用 BundleDefinition 23.0.0。
- [Workflow Definition JSON Schema 7.0.0](https://docs.baijimu.com/contracts/workflow-definition/7.0.0/schema.json)：Engine 62 的唯一 Start 入口、Agent 重试与 Workflow finally 作者合同。
- [Workflow 完整示例](https://docs.baijimu.com/contracts/workflow-definition/7.0.0/examples/complete-workflow.json)
- [Agent Definition JSON Schema 3.0.0](https://docs.baijimu.com/contracts/agent-definition/3.0.0/schema.json)：Bundle AGENT 资源 create/update definition 文件的版本化结构合同。
- [Agent Definition JSON 示例](https://docs.baijimu.com/contracts/agent-definition/3.0.0/examples/operations-analyst.json)：可由统一 Bundle 资源命令创建定义并生成不可变版本的 Agent 草稿。
- [Timer Definition JSON Schema 3.0.0](https://docs.baijimu.com/contracts/timer-definition/3.0.0/schema.json)：Bundle Timer 草稿定义的版本化结构合同。
- [Timer module-method 示例](https://docs.baijimu.com/contracts/timer-definition/3.0.0/examples/module-method.json)：Timer 作者配置示例。
- [Timer workflow 示例](https://docs.baijimu.com/contracts/timer-definition/3.0.0/examples/workflow.json)：Timer 作者配置示例。
- [Timer CRON JSON 示例](https://docs.baijimu.com/contracts/timer-definition/3.0.0/examples/cron.json)：带 IANA 时区的周期调度。
- [Timer EVERY JSON 示例](https://docs.baijimu.com/contracts/timer-definition/3.0.0/examples/every.json)：固定毫秒间隔调度。
- [Timer AT JSON 示例](https://docs.baijimu.com/contracts/timer-definition/3.0.0/examples/at.json)：RFC 3339 单次调度。
- 模块服务、方法和参数不是静态目录；提交前必须读取目标工作区当前 Runtime 的 methodDefinition。
- [模块方法调用入口](https://docs.baijimu.com/development/bundle-development/module-development/method-calls/)：区分 CLI、App Gateway 与 Runtime 服务网关。
- [当前调用 JSON 示例](https://docs.baijimu.com/examples/runtime-invocation/index.json)：作者配置 7.0.0、SDK 10 名称调用、Runtime 请求与来源属性访问。

## 开发指南

- [架构与资源边界](https://docs.baijimu.com/development/backend-development/architecture.md)：区分后端项目、Release Operation、Artifact、环境、部署、运行治理和数据库迁移。
- [完整构建与部署链路](https://docs.baijimu.com/development/backend-development/build-and-deploy.md)：从项目主线发布不可变语义版本，完成 Environment 绑定、版本部署与验证。
- [环境配置与服务鉴权](https://docs.baijimu.com/development/backend-development/configuration-and-auth.md)：使用环境配置、Provider 绑定和 consumer token 隔离后端部署环境。
- [数据库设计规范](https://docs.baijimu.com/development/backend-development/database-design.md)：Hosted Service 后端按第三范式设计关系模型，通过 ID 引用权威数据，并对专门设计的冗余存储逐项确认和记录原因。
- [数据库迁移](https://docs.baijimu.com/development/backend-development/database-migrations.md)：在同一个 Hosted Service 项目版本中声明 Schema 与 Data Migration，并在目标环境部署前执行。
- [Browser Session Capability](https://docs.baijimu.com/development/backend-development/hosted-service-capabilities/browser-session.md)：Browser Session Capability 方法列表与请求响应合同。
- [Database Capability](https://docs.baijimu.com/development/backend-development/hosted-service-capabilities/database.md)：Database Capability 方法列表与请求响应合同。
- [Hosted Service Capability 列表](https://docs.baijimu.com/development/backend-development/hosted-service-capabilities.md)：先发现当前环境的可用能力，再选择提供方查询方法及请求响应合同。
- [Workflow Worker Capability](https://docs.baijimu.com/development/backend-development/hosted-service-capabilities/workflow.md)：Workflow Worker Capability 方法列表与请求响应合同。
- [Project、Environment、Slot、Endpoint 与数据库](https://docs.baijimu.com/development/backend-development/hosted-services-and-databases.md)：面向后端开发者解释 Project 托管运行资源与托管 PostgreSQL 产品之间的关系、归属和计费边界。
- [后端应用开发](https://docs.baijimu.com/development/backend-development.md)：把工作区后端项目主线发布为不可变版本，并通过 Hosted Service 部署为稳定 API。
- [Kubernetes 资源操作边界](https://docs.baijimu.com/development/backend-development/kubernetes-resource-boundary.md)：业务模块持有期望状态，BuildManager 分阶段收敛为 Kubernetes 执行层。
- [环境日志查询与错误排查](https://docs.baijimu.com/development/backend-development/logs-and-errors.md)：使用 Hosted Service CLI 按环境和时间查询运行、迁移日志，通过请求标识追踪错误，并区分业务失败与日志查询失败。
- [微服务后端开发](https://docs.baijimu.com/development/backend-development/microservices.md)：按业务边界拆分独立后端服务，设计契约、部署、鉴权、观测和发布验证。
- [Hosted Service 对象存储与签名上传](https://docs.baijimu.com/development/backend-development/object-storage-upload.md)：绑定工作区 Object Storage Profile，通过短期签名 URL 上传文件，并用 HEAD 和 GET 验证结果。
- [资源用量与容量分析](https://docs.baijimu.com/development/backend-development/resource-metrics.md)：按环境或 Slot 查询实际 CPU、内存、CPU 限流和请求表现，用历史时序分析压测容量。
- [Rust 服务设计约束](https://docs.baijimu.com/development/backend-development/rust-service-design.md)：用类型化 Rust 模型承载业务语义，并把 JSON、Serde、数据库和外部协议限制在适配器边界。
- [发布验证与故障排查](https://docs.baijimu.com/development/backend-development/verification-and-troubleshooting.md)：验证后端项目版本、Deployment、Endpoint、鉴权和业务请求的完整链路。
- [浏览器录制生成个性化 Bundle](https://docs.baijimu.com/development/bundle-development/advanced/browser-recording-to-bundle.md)：用 Baijimu CLI 创建 Agent 会话，让用户在托管浏览器中完成操作，再把捕获的请求固化为工作区专属 Bundle 并验证自动调用。
- [高级 Bundle 开发](https://docs.baijimu.com/development/bundle-development/advanced.md)：在普通 Bundle 之上扩展外部资源生命周期、跨资源初始化和故障补偿。
- [Bundle 管理器](https://docs.baijimu.com/development/bundle-development/advanced/lifecycle-plugins.md)：登记管理器，并设置来源 Bundle 跨版本共用的固定关系。
- [Bundle Agent 定义、版本创建与 Workflow 引用](https://docs.baijimu.com/development/bundle-development/agent-development.md)：使用统一 Bundle 资源命令创建 Agent 定义和不可变版本，并以领域身份供 Workflow agent 节点引用。 数据声明统一采用 Type14 JSON Schema。
- [Bundle 修改与发布工作流（旧入口）](https://docs.baijimu.com/development/bundle-development/agent-workflow.md)：已发布客户端使用的兼容入口，指向统一的 Bundle 修改与发布规范。
- [Bundle 定义与资源声明](https://docs.baijimu.com/development/bundle-development/bundle-definition.md)：Bundle Service 在数据库中维护产品定义，使用同一内容结构保存不可变版本。
- [Bundle 修改与发布工作流](https://docs.baijimu.com/development/bundle-development/change-and-release.md)：维护数据库 Bundle 定义与资源源码，按准确修订发布并验证。
- [交付完整性与验收证据](https://docs.baijimu.com/development/bundle-development/delivery-verification.md)：在发布验收中关联精确 Bundle、后端制品、部署、管理器协议与真实业务证据，保留独立安装边界。
- [Event Trigger 绑定工作流与输入映射](https://docs.baijimu.com/development/bundle-development/event-trigger-development.md)：使用 source/action 与完整 Resource Locator 创建事件触发器，映射工作流输入与元数据，由 Owner 生成幂等请求标识，并验证运行态。
- [Hosted Service Capability 列表](https://docs.baijimu.com/development/bundle-development/hosted-service-capability-methods.md)：先发现当前环境的可用能力，再选择提供方查询方法及请求响应合同。
- [百积木平台开发](https://docs.baijimu.com/development/bundle-development.md)：从普通资源组合开始开发 Bundle，只在需要管理外部资源时使用高级 Bundle 管理器。
- [Bundle 安装与资源绑定](https://docs.baijimu.com/development/bundle-development/installation-and-binding.md)：区分资源定义安装、运行时绑定生效和业务调用，独立管理资源引用。
- [事项包开发入口已迁移](https://docs.baijimu.com/development/bundle-development/issue-definition-development.md)：事项包是工作区独立发布对象，不属于 Bundle。
- [Bundle 定义与资源选择](https://docs.baijimu.com/development/bundle-development/manifest.md)：在数据库中维护统一 BundleDefinition，按准确修订创建不可变版本。
- [Runtime 用户委托](https://docs.baijimu.com/development/bundle-development/module-development/actor-delegation.md)：在外部模块后端通过 ServiceReference 调用下游服务时，安全传递当前已验证用户，并由 Runtime 按服务跳点轮换短期委托。
- [模块事件与发布机制](https://docs.baijimu.com/development/bundle-development/module-development/event-development.md)：区分事件声明、发布和订阅，并通过当前 Runtime 安全发布模块事件。
- [模块开发与 Bundle 自动安装](https://docs.baijimu.com/development/bundle-development/module-development/from-private-to-market.md)：开发不可变模块版本，由 Bundle 组合并自动安装到 Runtime。
- [HTTP methodBody 源契约](https://docs.baijimu.com/development/bundle-development/module-development/http-method-body.md)：使用 snake_case 编写、生成和保存 HTTP 模块方法，并正确处理历史驼峰输入。
- [模块开发](https://docs.baijimu.com/development/bundle-development/module-development.md)：在 Bundle 内创建模块定义，创建不可变模块版本并由 Bundle 统一发布。
- [InterfaceMap 与 ServiceReferenceMap](https://docs.baijimu.com/development/bundle-development/module-development/interface-map.md)：声明一组具名 Interface 服务槽位，通过 ServiceReferenceMap 绑定同一 Runtime 中的多个目标服务。
- [方法行为与重试契约](https://docs.baijimu.com/development/bundle-development/module-development/method-behavior.md)：在现有方法描述中声明副作用、幂等和未知结果处理，避免把签名兼容误当作安全重试。
- [模块方法调用入口](https://docs.baijimu.com/development/bundle-development/module-development/method-calls.md)：区分 CLI、平台应用和 Runtime 服务网关的真实路径、参数包装与身份来源。
- [模块定义开发](https://docs.baijimu.com/development/bundle-development/module-development/module-definition.md)：定义模块属性、方法、事件、用户域和权限。
- [模块版本创建与 Bundle 交付](https://docs.baijimu.com/development/bundle-development/module-development/publish-and-install.md)：从项目 Git 快照创建模块版本，再由 Bundle 统一发布和安装。
- [服务引用完整操作示例](https://docs.baijimu.com/development/bundle-development/module-development/reference-binding-walkthrough.md)：使用正式 CLI 验证空引用安装、绑定、换绑、清空和再绑定，分别确认配置与真实业务结果。
- [模块调用上下文](https://docs.baijimu.com/development/bundle-development/module-development/runtime-context.md)：了解模块方法当前可以读取的 Runtime、调用方、用户和请求上下文字段。
- [ServiceReference 声明、绑定与运行时交付](https://docs.baijimu.com/development/bundle-development/module-development/service-reference.md)：声明 Interface 属性，通过模块属性配置绑定目标服务，并由 Runtime 管理访问关系，Bundle 管理器在生命周期中接收当前引用和资源访问凭据。
- [模块服务间调用协议](https://docs.baijimu.com/development/bundle-development/module-development/service-to-service-calls.md)：通过模块属性绑定 ServiceReference，管理器接收首次签发的资源凭据并调用同一 Runtime 中的目标模块方法。
- [权限开发](https://docs.baijimu.com/development/bundle-development/permission-definition-development.md)：将每个业务权限定义为独立 PERMISSION 资源，用完整 Locator 连接角色授权与 Module 方法。
- [App Gateway 接入与配置](https://docs.baijimu.com/development/bundle-development/platform-application-development/app-gateway-configuration.md)：以作者配置 7.3.0 和 SDK 10 接入环境托管应用、同包 Module 直接调用 与公开调用入口。
- [平台应用授权与 PKCE](https://docs.baijimu.com/development/bundle-development/platform-application-development/authorization.md)：Bundle 安装的环境托管平台应用通过同源配置、统一网页授权和 PKCE 获取 appClientToken。
- [调用应用所属 Bundle 的模块](https://docs.baijimu.com/development/bundle-development/platform-application-development/capabilities.md)：无需 targets 和方法名单，按 moduleKey 与可选 propertyKey 直接调用同包 Module。
- [创建版本并纳入 Bundle](https://docs.baijimu.com/development/bundle-development/platform-application-development/create-and-install.md)：创建平台应用不可变版本，并由 Bundle 组合安装到工作区。
- [入口类型与应用清单](https://docs.baijimu.com/development/bundle-development/platform-application-development/entry-and-manifest.md)：配置环境托管前端、平台内路由与普通外链，并迁移不再支持平台授权的历史外部入口。
- [平台应用开发](https://docs.baijimu.com/development/bundle-development/platform-application-development.md)：开发由 Bundle 组合交付、受平台身份和能力范围约束的工作区应用入口。
- [调用模块方法](https://docs.baijimu.com/development/bundle-development/platform-application-development/module-method-calls.md)：SDK 10 通过同包模块键和 App Gateway 调用同包 Module，区分参数信封与业务错误。
- [页面声明与链接发现](https://docs.baijimu.com/development/bundle-development/platform-application-development/pages.md)：在平台应用版本中声明可分享的页面，让 Agent 读取真实路径和参数并在本地构造普通 href。
- [平台应用版本文档已迁移](https://docs.baijimu.com/development/bundle-development/platform-application-development/publish-and-install.md)：旧地址迁移入口。
- [Web 接入与运行态调用](https://docs.baijimu.com/development/bundle-development/platform-application-development/sdk-and-runtime.md)：使用百积木标准浏览器 SDK 完成平台应用启动、PKCE、会话和 Runtime 方法调用。
- [安全与故障排查](https://docs.baijimu.com/development/bundle-development/platform-application-development/security-and-troubleshooting.md)：保护 Bundle 平台应用 token，并按授权链路定位入口、回跳和权限问题。
- [示例：查询工作区成员与旧应用迁移](https://docs.baijimu.com/development/bundle-development/platform-application-development/workspace-member-list-example.md)：通过当前 Runtime 目录核对成员查询合同，并把旧跨包浏览器引用迁移到本包 Module 属性。
- [Bundle 与 Module 属性](https://docs.baijimu.com/development/bundle-development/properties.md)：使用一致的属性声明、类型化属性值和可选的自动绑定。
- [Bundle 失败重试](https://docs.baijimu.com/development/bundle-development/recovery.md)：检查失败原因，通过普通安装或升级按当前资源重新执行，并验证最终状态。
- [角色开发](https://docs.baijimu.com/development/bundle-development/role-template-development.md)：将每个业务角色定义为独立 ROLE 资源，通过完整 ResourceLocator 引用权限和分配主体。
- [Bundle Skill 文本与版本](https://docs.baijimu.com/development/bundle-development/skill-development.md)：在真实 Bundle 下以明确的 key 创建 Skill 纯文本不可变版本，再选择精确版本纳入清单。
- [Timer 定义、版本创建与运行态](https://docs.baijimu.com/development/bundle-development/timer-development.md)：Bundle Timer 的机器定义、Manifest 引用、安装收敛和执行记录合同。
- [Type Definition](https://docs.baijimu.com/development/bundle-development/type-definition-development.md)：独立发布共享类型，在 Module 中导入精确版本，并验证接口兼容性。
- [版本创建、市场与交付](https://docs.baijimu.com/development/bundle-development/version-and-delivery.md)：创建不可变 Bundle 版本内容，完成审核、市场发布、安装、升级，以及安装清单和运行态资源验证。
- [使用 Codex 开发](https://docs.baijimu.com/development/codex-development.md)：在正确的工作区、项目和分支中，让 Codex 完成定位、实现、测试、审查、发布与结果确认。
- [CModel 数据契约](https://docs.baijimu.com/development/data-contracts.md)：统一平台接口、模块、事件、任务和持久化层的数据类型与响应结构。
- [时间与日期规范](https://docs.baijimu.com/development/data-contracts/time.md)：业务时间统一使用 Unix epoch 毫秒，格式化字符串只用于显示和外部协议适配。
- [安装与配置开发环境](https://docs.baijimu.com/development/environment-setup.md)：安装百积木客户端和 CLI，登录账号、切换工作区并完成开发前验收。
- [完整构建与发布链路](https://docs.baijimu.com/development/frontend-development/build-and-publish.md)：按严格语义版本固定 Git 标签并构建不可变制品，部署静态站点并验证。
- [前端网站开发](https://docs.baijimu.com/development/frontend-development.md)：按普通静态网站或环境托管平台应用选择前端开发和发布流程。
- [多页面前端开发](https://docs.baijimu.com/development/frontend-development/multi-page-applications.md)：为内容型网站、管理后台和多个独立入口设计可独立构建、发布和验证的多页面前端。
- [项目结构与平台接入](https://docs.baijimu.com/development/frontend-development/project-and-integration.md)：设计前端环境配置、API 边界，并选择普通网站或平台应用入口。
- [开发指南](https://docs.baijimu.com/development.md)：从开发基础开始，选择通用 AI Coding 或百积木平台开发路径，完成实现、验证与发布。
- [独立事项包开发](https://docs.baijimu.com/development/issue-definition-development.md)：读取、创建、完整更新和发布工作区独立事项包，以精确成员版本供 Workflow human 节点引用。
- [首次握手与凭据轮换](https://docs.baijimu.com/development/lifecycle-plugin-development/credential-enrollment.md)：一次性引导、双向数据库凭据、可恢复交付与在线轮换的协议。
- [直接实现 Bundle 管理器协议](https://docs.baijimu.com/development/lifecycle-plugin-development/develop-plugin-service.md)：直接接入方式与底层实现参考：用公开 SDK 承担生命周期协议、认证、引用解析和恢复。
- [失败与重试](https://docs.baijimu.com/development/lifecycle-plugin-development/failure-and-retry.md)：以同一操作恢复未知结果，按资源所有权执行 DETACH 清理。
- [首次接入流程与验收](https://docs.baijimu.com/development/lifecycle-plugin-development/first-enrollment.md)：从判断是否需要管理器，到一次性授权、启动握手、清理引导配置和 Bundle 联调的完整交付流程。
- [Bundle 管理器开发](https://docs.baijimu.com/development/lifecycle-plugin-development.md)：以独立 Adapter Hosted Service 分担公共协议，Bundle 和 Module 提供调用方法，业务后端保留业务与数据库。
- [安装环境与 Bundle 管理器请求](https://docs.baijimu.com/development/lifecycle-plugin-development/installation-environment.md)：使用完整 Bundle 安装身份区分来源与目标环境，并按授权路由引用访问解析。
- [推荐架构：独立 Hosted Service 上的 Bundle 管理器 Adapter](https://docs.baijimu.com/development/lifecycle-plugin-development/integration-runtime.md)：Bundle 管理器 Adapter 以独立 Hosted Service 实现公共管理器协议，Bundle 提供 Runtime 网关与标准 Module 方法，业务后端保留业务与数据库。
- [最小示例：通过 Adapter 校验业务配置](https://docs.baijimu.com/development/lifecycle-plugin-development/minimal-business-example.md)：使用一个受保护的业务回调理解 Adapter 接入，不在业务代码中拼装平台生命周期或引用协议。
- [Bundle 生命周期与资源交付协议](https://docs.baijimu.com/development/lifecycle-plugin-development/reference-protocol.md)：使用来源 Bundle 管理器关系和完整安装身份，在生命周期中接收、保存并更新调用凭据，供业务运行使用。
- [Bundle 管理器登记与接入](https://docs.baijimu.com/development/lifecycle-plugin-development/registration-management.md)：登记管理器执行协议与受管凭据，再独立设置来源 Bundle 的固定关系。
- [资源凭据交付与补签](https://docs.baijimu.com/development/lifecycle-plugin-development/resource-delivery.md)：首次签发下发、只存哈希，按资源和管理器安装隔离的显式补签与轮换
- [验证与发布 Bundle 管理器](https://docs.baijimu.com/development/lifecycle-plugin-development/verification-and-release.md)：验证协议、操作恢复、资源归属、引用撤销和实际安装效果。
- [Connector 应用开发](https://docs.baijimu.com/development/local-app-development.md)：开发 Connector 本地应用，定义清单、服务、内嵌界面、权限、调试、打包和市场发布流程。
- [渠道与会话消息](https://docs.baijimu.com/development/organization-capabilities/channel-messages.md)：从真实成员和渠道目录取得外部会话，通过 channel gateway 给同事发送企业微信私聊，并在工作流中调用。
- [通讯录与联系方式](https://docs.baijimu.com/development/organization-capabilities/contacts.md)：从成员目录查询可用联系方式，区分个人联系人、渠道实例和群聊通讯录，并交给对应消息能力发送。
- [身份映射与权限](https://docs.baijimu.com/development/organization-capabilities/identity.md)：区分调用者、接收人、平台用户与外部渠道账号，正确使用 Runtime 授权和渠道用户绑定。
- [概览与调用约定](https://docs.baijimu.com/development/organization-capabilities.md)：在百积木平台应用、模块、智能体与工作流中使用组织、身份、通讯录、渠道消息和人工事项等共同能力。
- [事项与人工协作](https://docs.baijimu.com/development/organization-capabilities/issues.md)：使用 IssueDefinition、事项和工作流 human 节点安排责任人、接收人工结果，并与渠道消息组合。
- [通知与投递](https://docs.baijimu.com/development/organization-capabilities/notifications.md)：明确组织通知、渠道消息、已读和业务处理之间的边界，选择公开能力并验证投递结果。
- [组织、成员与角色](https://docs.baijimu.com/development/organization-capabilities/organization.md)：从当前工作区组织目录定位成员、部门和用户组，按 Runtime 查询有效角色及角色成员。
- [选择工作区并获取项目](https://docs.baijimu.com/development/project-setup.md)：确认工作区、项目、Git main 写入策略和环境边界，通过百积木 CLI 检出平台项目。
- [兼容性与迁移](https://docs.baijimu.com/development/type-system/compatibility.md)：Type14 兼容方向、Type13 退役、历史归档和后继版本迁移。
- [数据类型](https://docs.baijimu.com/development/type-system/data-types.md)：JSON Schema 2020-12 的任意值、对象开放性、数组、字典、组合、引用、约束和缺省语义。
- [类型系统](https://docs.baijimu.com/development/type-system.md)：Type14 数据声明统一采用 JSON Schema 2020-12，接口、精确引用与版本治理使用平台契约。
- [接口与方法](https://docs.baijimu.com/development/type-system/interfaces.md)：Interface、MethodDefinition、事件和接口容器的公共类型结构。
- [命名类型与精确引用](https://docs.baijimu.com/development/type-system/references.md)：Type Definition 5.0.0 的 dataSchema、interfaces、标准数据引用与平台接口引用。

## 开发功能

- [后端服务](https://docs.baijimu.com/features/backend-services.md)：开发后端服务，为网站、智能体、模块和定时任务提供稳定 API。
- [创建模块](https://docs.baijimu.com/features/create-modules.md)：创建 Bundle 内部的模块能力，说明属性、方法以及随 Bundle 交付的发布验证要求。
- [数据、类型与函数](https://docs.baijimu.com/features/data-types-functions.md)：在项目中管理数据表、类型定义和函数，让页面、服务、模块方法和智能体共享稳定结构。
- [构建并部署 Hosted Service](https://docs.baijimu.com/features/hosted-services.md)：面向开发者和 AI 的 Hosted Service 标准流程：发布主线项目版本，再部署到目标环境。
- [项目开发台](https://docs.baijimu.com/features/project-development.md)：使用项目开发台管理文件、服务、流程、数据、类型、函数、Git、环境、依赖、日志和事项。
- [基础能力与 Resource Binding](https://docs.baijimu.com/features/resource-bindings.md)：了解当前工作区可申请或绑定的数据库、对象存储、浏览器与 Workflow 能力，以及申请、绑定、鉴权和生命周期边界。
- [网站](https://docs.baijimu.com/features/websites.md)：开发第一个网站，并把页面、接口和发布配置接入工作区运行时。

## 开发概念

- [项目](https://docs.baijimu.com/concepts/projects.md)：项目用于管理一个应用相关的网站、服务、智能体和发布配置。
- [服务](https://docs.baijimu.com/concepts/services.md)：服务用于提供接口、处理业务逻辑并连接外部系统。

## 开发集成

- [外部 Agent Runtime 接入](https://docs.baijimu.com/integration/agent-execution.md)：使用独立执行 Token 发现并调用当前授权的 Runtime 方法。
- [API 调用](https://docs.baijimu.com/integration/api.md)：通过平台 API 调用项目、模块、智能体和运行时能力。
- [渠道资源管理 API](https://docs.baijimu.com/integration/channel-resource-management.md)：用工作区、Runtime 与完整 Module Locator 管理机器人连接、策略、身份和会话。
- [渠道接入](https://docs.baijimu.com/integration/channel.md)：飞书、企业微信、钉钉、微信等渠道通过模块服务与工作区绑定。
- [CModel 错误模型](https://docs.baijimu.com/integration/cmodel-error-model.md)：CModel Error Contract 1.0.0 的三字段响应结构、HTTP 语义和调用规则。
- [统一内容协议（Content Parts）](https://docs.baijimu.com/integration/content-parts.md)：使用有序 content 数组描述文字、图片、音频、视频和文件，区分内容、通知属性与渠道投递能力。
- [保持登录状态](https://docs.baijimu.com/integration/login-state.md)：接入需要登录的现有系统时，选择重新登录、复用浏览器登录状态或复用设备登录状态。
- [MCP 与外部工具](https://docs.baijimu.com/integration/mcp.md)：通过 MCP 或工具连接外部能力，让智能体在授权范围内执行任务。
- [OpenRouter 接入](https://docs.baijimu.com/integration/openrouter.md)：通过统一入口访问模型能力，复用平台权限、跨域和转发配置。
- [Webhook](https://docs.baijimu.com/integration/webhook.md)：接收外部系统事件，并把事件转换为工作区内的业务动作。

## CLI

- [命令层级与能力发现](https://docs.baijimu.com/cli/command-hierarchy.md)：区分工作区管理、Bundle 作者资源和 Runtime 当前可调用能力。
- [百积木 CLI 文档](https://docs.baijimu.com/cli.md)：通过本机分级帮助按需查询命令和参数。
- [安装百积木 CLI](https://docs.baijimu.com/cli/installation.md)：通过百积木客户端安装 baijimu CLI，完成首次登录、版本检查和工作区验证。