跳到主要内容

交给 AI 开发

本页适用于 WorkBuddy 等本地 AI 工具。在后台直接与 AI 对话，请阅读云开发使用指南。

你不需要先懂技术栈。把官方说明交给本地 AI，它会先确认当前目录中是否真的有项目：已有项目就自动识别并接入；空目录则先确认你要关联已有代码，还是从业务需求开始创建新应用。

推荐提示词​

复制下面这一句话，粘贴给正在使用的 AI 开发工具：

请阅读 https://paas.xinduobang.cn/XDB_PAAS.md ，帮我把应用接入信多帮。

完整的项目识别、安装登录、SDK、业务接口调用和发布约定统一维护在这份 Markdown 中，AI 先阅读再执行。若无法读取，请先下载该文件交给 AI，不要让它猜测接入步骤。

从「商家后台 → 设置 → 开放平台 → 云应用」复制「接入说明给 AI」时，还会带上当前商家地址和应用 ID，帮助 AI 关联正确的应用；不包含密钥。

这套方式可以用于 Cursor、Codex、Qoder、Claude Code、WorkBuddy、Trae、Windsurf、Cline、Roo Code 等能够读取网页或项目文件的 AI 开发工具。

开发完成后，怎么让 AI 发布​

已登录并关联当前项目后，可以直接说：

推送到信多帮测试环境。

按照最新官方约定，“推送吧”“上传吧”“部署一下”“上线到信多帮”没有明确正式上线目标时，都应先发布测试版；明确说“推送 Git”则只按 Git 目标处理。AI 应简短说明发布目标，完成后提供测试链接和“尚未正式上线”的提示。

每轮完成可试用修改后，AI 应主动询问是否发布测试版。已要求本轮完成后发布，就不必再重复确认。只有在回答明确的测试发布询问时，“好”“可以”“发吧”才表示同意发布；确认需求方案不会自动授权发布。

试用后再明确说：

将刚才试用的这个版本正式上线。

AI 应使用同一个已试用版本执行 Promote，并返回正式地址。试用后又改了代码、版本不明确或用户没有明确正式上线时，先确认目标，不能把新代码当成刚才验收的版本上线。

这些约定需要第三方 AI 工具读取并遵守，不保证它一定提供可点击的确认按钮。完整操作见校验与发布。

AI 应当遵守的边界​

  • 先阅读项目根目录中的 XDB_PAAS.md 和 xdb-paas-deploy.yaml；
  • 先检查实际文件和脚本，能判断技术栈时不把问题原样抛回给使用者；
  • 空目录先确认是关联已有项目还是创建新应用；创建新应用时先问业务需求，不让使用者先选编程语言；
  • 发现不受支持的存量后端时停止接入并建议联系信多帮 CSM，不擅自重写项目；
  • React / Vue 是前端选择，Node.js / Python 是后端运行环境，不把它们当成同一道二选一问题；
  • 无后端的项目保持静态；已有 Node.js 或 Python 后端时保留原有语言和框架；
  • 使用 xdbapp dev -- <原启动命令> 进行本地联调，不让使用者手工复制长期 AppSecret 或数据库密码；
  • SDK 按官方固定版本地址安装，不向使用者索要私有源或安装令牌，不覆盖项目现有自定义 .npmrc；
  • 不生成 Dockerfile；
  • 不把 .env、数据库密码、开放平台 Secret、CLI 登录凭据提交到 Git；
  • 先发布 Preview，得到明确确认后再发布 Production；
  • 数据库变更整理成有顺序、可重复执行、向前兼容的 migration 文件并随源码提交，配置 database.migrate_command；先由 deploy 验证 Preview，再由 promote --yes 在切流前迁移 Production，不能依赖手工修改生产表结构；
  • 上传文件使用 SDK Storage，不能把文件永久保存在容器目录。
  • 按业务接口稳定性设计并测试调用层；SDK 缓存 Token 不代表已控制业务频率，本地调试和托管运行都受开放平台限制。

初始化后为什么还有一份 XDB_PAAS.md​

xdbapp link 会把当时的官方说明写入项目根目录。这样 AI 在后续迭代时可以直接读取项目内说明，也能在网络不可用时理解部署规则。

项目内文件是当前项目的工作说明；需要确认最新能力时，以在线文档和 https://paas.xinduobang.cn/XDB_PAAS.md 为准。

已有项目的说明和旧对话不会自动更新。可以在商家后台重新复制“接入说明给 AI”，或让 AI 阅读最新官方说明和 xdbapp help deploy，只同步过时的约定并保留项目自定义内容；无需重新绑定应用，也不要为了更新说明执行 init --force 覆盖项目配置。

需要业务变化自动同步时，读取 云应用订阅事件，由后端验签、持久化和去重后返回接收回执；不放开整个应用、不要求客户手填密钥。应用创建后即可在商家后台选择事件和云应用保存订阅，无需先上线；正式上线后开始接收新事件。

订阅环境与联调（AI 必须主动说明）​

  • 在方案说明、开始联调和交付预览时，凡涉及订阅事件，主动用一句话告诉客户：“订阅可以先配置；真实通知只发给正式版，测试版和本地用模拟事件验证，上线后自动接收新通知。”不要等客户问为什么没有数据。
  • 客户在本地、测试版或预览环境等不到推送时，先说明环境规则并运行模拟事件测试，不把没有真实推送误判为代码故障，不让客户反复修改订阅、重试或重新登录。
  • 应用已有正式版、同时在开发新版时，事件仍发给当前正式版；未上线的改动不会收到真实通知。不得为联调擅自正式上线或把真实事件转到测试环境。
  • 模拟测试使用隔离的测试数据和测试签名凭据，不复制生产密钥，不把模拟结果说成真实投递成功。完整联调在用户授权上线后，用约定的测试业务触发，并检查订阅日志和应用实际处理结果。
  • 上线前的事件不自动补发；需要历史数据时，由应用做初始化查询。没有实际配置、上线或投递结果，不声称这些步骤已完成。