快速开始

PaaS AI 提供两种开发方式：直接在后台与 AI 对话，或者继续使用 WorkBuddy 等本地工具。开始前，请先由商家管理员在信多帮后台创建云应用，并给开发人员配置相应权限。

在后台使用云开发

云开发已正式开放，无需安装本地 CLI 或 SDK。

1. 在商家后台依次进入「设置 → 开放平台 → 云应用」，创建或选择要开发的应用。
2. 点击「进入云开发」，告诉 AI 要解决什么业务问题、谁来使用、需要哪些功能。
3. 根据 AI 的提问补充需求；已有开发对话可以继续修改，不必每次新建。
4. 开发完成后发布到测试环境，等待预览就绪，再打开预览验证业务流程。
5. 试用满意后确认正式上线。上线完成后，团队可按应用访问权限打开正式版本。

开发完成、预览就绪、正式上线是不同阶段。 测试版不会自动替换正式应用；可以在对话中明确告诉 AI“发布到预览”或“正式上线”，也可以使用发布面板。

若未看到云开发入口，请让商家管理员检查功能开通情况和员工开发权限。上线后的入口设置见后台管理与使用。

继续开发、保存与恢复、对话发布和工具更新见云开发使用指南。

在本地使用 WorkBuddy 等工具开发

已有本地项目可按以下步骤接入。也可以直接阅读交给 AI 开发，把接入说明发给本地 AI 工具。

商家管理员可以直接授权 CLI；其他员工需先由管理员勾选“开发者”角色（roleId=110）。

平台支持纯静态项目、React / Vue 等前端构建项目、Node.js 22 后端与 Python 3.11 后端。前端项目可以作为静态应用发布，也可以和受支持的后端一起发布。完整范围见支持的项目类型和运行版本。

0. 准备本地项目

在执行安装和绑定前，先确认 AI 工具或终端打开的是实际项目根目录。创建云应用只是准备托管空间，不会自动生成业务页面和功能。

• 已经有项目：打开包含源码、package.json、requirements.txt 或其他项目文件的目录，再让 AI 读取官方说明；
• 还没有项目：先告诉 AI 这个应用要解决什么业务问题、谁来使用、需要哪些核心流程和页面，由 AI 选择受支持的实现并创建项目；
• 当前目录是空的：不要直接执行 xdbapp link，也不需要先选择“静态、Node.js 或 Python”。先决定是打开已有项目目录，还是从需求开始创建新应用。

如果已有项目使用 PHP、Java、Go 等暂不支持的后端，先联系信多帮 CSM，不要为了托管直接改写整个项目。

安装或更新 xdbapp、登录当前商家不依赖项目目录，可以先完成。只有第 3 步 xdbapp link 必须进入已经确认的真实项目根目录。

1. 安装 xdbapp

macOS 或 Linux：

curl -fsS https://paas.xinduobang.cn/i | sh

Windows PowerShell：

irm https://paas.xinduobang.cn/install.ps1 | iex

验证安装：

xdbapp version

xdbapp 是独立程序。Python 项目不需要为它安装 Node.js，Node.js 项目也不需要为它安装 Python。

2. 登录商家后台

把示例域名替换为当前商家实际使用的信多帮后台地址：

xdbapp login --core-url https://abc.co.xinduobang.cn

命令会打开浏览器。确认授权后，回到终端继续操作。登录凭据只允许访问你被授权的云应用；账号被禁用、删除或取消权限后，原有 CLI 登录也会失效。

这是电脑级登录：同一台电脑可以保存多个商家账号。用 xdbapp accounts 查看、xdbapp use <账号ID或商家名称> 切换；登录失效或新增应用尚未进入授权范围时，再重新登录。已经关联的项目会继续使用绑定时的商家账号。

3. 关联本地项目

进入项目根目录：

xdbapp link

这是项目级绑定：每个本地项目目录执行一次。它只记录“这个目录对应哪个云应用”，不会再次登录，也不会把账号凭据或长期密钥写进项目。A、B 两个项目放在不同目录时，绑定互不影响；已有绑定也不会被静默覆盖，如确实要改绑必须显式增加 --force。

如果登录时只授权一个云应用，CLI 会自动选择；授权多个应用时，按显示的名称和序号选择。关联完成后会生成：

文件	作用
xdb-paas-deploy.yaml	描述如何构建、启动和检查应用
.xdbpaasignore	排除密钥、本地依赖和无关文件
.xdbpaas/project.json	记录本地目录关联的 App，不含登录凭据
XDB_PAAS.md	给当前项目和本地 AI 阅读的部署说明

云应用创建时会自动获得一组专属开放平台凭据，不需要手工创建、复制或保存。本地不要把 appid、appsecret 写进 .env，而是通过下面的方式启动原有开发命令：

xdbapp dev -- npm run dev

Python 项目把 npm run dev 替换为自己原有的启动命令。CLI 不会把长期 AppSecret 写入本地，而是在命令运行期间自动协调开放平台短期 Token、Preview 环境变量、Preview 数据库代理、当前用户和文件存储能力。完整说明见本地开发：xdbapp dev。

4. 校验项目

xdbapp validate

想确认哪些文件会上传：

xdbapp validate --list-files

校验只读取本地项目，不会发布内容。

5. 发布 Preview

xdbapp deploy --message "首次发布"

CLI 会上传源码、等待平台构建和启动就绪，并返回 Deployment ID 与 Preview 地址。出现“测试版已生成，尚未正式上线”才可以开始试用；上传成功或取得版本编号不等于应用已经可用。项目声明 MySQL migration 时，这一步会先迁移 Preview 数据库；请打开 Preview 验收页面、接口和数据结构。

6. 发布到 Production

将已经验收的同一个版本发布到正式地址：

xdbapp promote <deployment-id> --yes

promote 不会重新上传或重新构建源码。项目声明 MySQL migration 时，平台会先对 Production 数据库执行同一 migration；成功并通过健康检查后，才让该版本成为 Production。SQL 文件应如何整理、Node.js/Python 如何配置，见数据库与本地代理。

日常推荐流程

先 deploy，验收 Preview，再 promote。deploy --prod 会在构建成功后直接上线，更适合已建立自动化检查的 CI。

7. 查看结果

xdbapp status
xdbapp deployments

• status：查看当前项目、本地关联和 Production 健康状态；
• deployments：查看发布历史及每个版本的状态。

正式上线后，用 xdbapp open 打开正式应用，或从商家后台“设置 → 开放平台 → 云应用 → 对应应用 → 打开应用”进入。希望成员从后台左侧菜单使用时，还需由商家管理员点击“添加到左侧菜单”；CLI 上线不会自动开启菜单。完整说明见后台管理与使用。

出现问题时，先运行 xdbapp doctor 检查安装、登录、项目配置和平台连通性。