云服务为 QMuse 应用提供持久化数据、文件存储、数据访问权限、密钥和云函数能力。当需求中出现“保存表单”“记录订单”“上传图片或附件”“用户只能查看自己的数据”“调用需要密钥的第三方接口”等场景时，QMuse 可以在生成应用的同时自动创建所需的云服务资源。 本篇介绍如何开启云服务，以及如何在创作工作区中查看和维护这些资源。 云服务能做什么 能力 用来做什么 常见场景 应用数据表 持久化保存和查询结构化数据 报名、预约、订单、文章、评论、操作记录 文件存储 保存应用中上传的图片、附件等文件 旅行相册、作品集、报名附件、资料收集 数据表权限 控制谁可以新增、查看、更新和删除数据 个人数据隔离、管理员审核、多人协作 密钥管理 安全保存第三方服务所需的密钥或环境变量 支付、地图、短信、AI 模型等接口 云函数 在云端执行不适合放在浏览器中的后端逻辑 签名、支付回调、数据校验、定时或服务端处理 多环境 为测试和正式环境提供独立的云服务资源与数据隔离 测试验证、正式上线、环境数据互不干扰 这些能力都属于当前应用。切换到其他应用后，需要查看或配置该应用自己的云服务。 开始前 已创建一个 QMuse 网页应用并进入创作工作区 对要保存的数据、使用者和操作流程有基本设想 涉及第三方接口时，已准备好对方平台提供的密钥 准备修改或删除线上数据前，先确认该数据是否仍被已发布应用使用 云服务中显示的是应用实际使用的数据和资源，不是独立的演示副本。新增、修改、删除数据，调整权限，停用密钥或重新部署函数，都可能立即影响应用功能；操作前请确认影响范围。 1. 通过对话开启云服务 不需要先设计数据库表。直接在对话中说明业务流程、数据归属和权限要求，QMuse 会判断是否需要云服务，并创建所需的数据表、文件存储或云函数等资源。 当 QMuse 判断当前需求需要云服务时，会先显示「云服务初始化」确认卡片。卡片会说明将占用的云服务应用额度、可用能力和当前额度；确认后才会正式启用。 确认需要云数据库、文件存储、密钥管理或云函数时，点击「确认启用」继续；暂时不需要或希望调整方案时，点击「暂不启用」。 推荐按“谁做什么、保存什么、谁能查看或修改”的方式描述： 做一个活动报名应用。访客填写姓名、手机号和报名场次后提交；访客只能查看和修改自己的报名记录，应用管理员可以查看全部记录。 其他示例： “创建一个旅行相册，支持上传和浏览照片，刷新或重新打开后仍能看到已上传的照片。” “给报名表增加附件上传，提交后保存附件，方便后续查看。” “把当前待办清单改为云端保存，用户登录后只能看到自己的待办事项。” “为商品下单增加订单表，保存商品、金额、订单状态和创建时间。” “调用第三方图片生成接口，API Key 通过密钥管理保存，接口请求放在云函数中执行。” “为当前应用增加数据库存储能力，把浏览器里的临时数据迁移到云端。” 如果当前账号的云服务应用数量已达到权益上限，页面会显示额度提示。按提示处理额度后，再继续开启。 推荐描述业务行为，不要只说“建一张包含 title、content 字段的表”。业务描述能帮助 QMuse 同时处理页面交互、数据关系和访问权限。 2. 进入云服务管理页 打开需要管理的应用，进入创作工作区。 在工作区顶部工具栏点击「云服务」。 如果应用尚未开启云服务，面板会显示云服务能力说明和「一键开启」按钮；确认需要后，点击按钮开启。 云服务开启后，在左侧选择「应用数据表」「数据表权限设置」「文件管理」「密钥管理」或「云函数」。多环境应用还可在顶部切换「测试环境」和「正式环境」。 未开启云服务的应用：点击顶部「云服务」图标后，可以查看能力说明并通过「一键开启」继续。 云服务开启后，应用卡片上会显示“云服务”标识。刚开启但还没有业务数据表时，云服务页会显示“暂无数据表”；继续在对话中说明要保存的数据即可由 AI 创建。 3. 管理应用数据表 左侧「应用数据表」下会列出当前应用的所有数据表。选择一张表后，右侧显示表名、英文名、字段和数据记录。 应用数据表：选择数据表后，可以查看和维护记录，并使用搜索、添加记录、字段配置、导入和导出等操作。 操作 使用方法 注意事项 查找记录 在搜索框输入关键词，或使用表格提供的筛选、排序和分页能力 搜索和筛选只作用于当前数据表 添加记录 点击「添加记录」，按字段填写后确认 系统 ID、创建时间等字段通常由系统生成 查看或编辑 在记录操作区点击「查看详情」，按页面提示修改并保存 修改后可能立即影响已发布应用 删除记录 删除单条记录，或勾选多条后使用「批量操作」 删除通常不可撤销，先确认没有业务引用 字段配置 点击「字段配置」调整当前表格中显示的字段 该入口主要调整管理页展示；业务结构变化优先通过对话完成 导入 点击「导入」，按模板准备文件并确认字段映射 导入前先用少量数据验证格式，避免批量脏数据 导出 点击「导出」下载当前表数据 可在批量修改或清理前用作备份 数据表标题旁会显示英文名。需要在代码或排查中定位数据表时，可以点击复制图标复制英文名。 不要把密钥、密码、身份证号等敏感信息直接存进普通业务数据表。第三方服务密钥应放在「密钥管理」中，并通过云函数使用。 调整数据结构 需要增加字段、修改业务关系或新增数据表时，优先回到对话中说明变化。例如： 给报名记录增加“审核状态”和“审核备注”，默认状态为待审核；只有应用管理员可以修改这两个字段。 修改后检查数据表、页面表单和权限是否一起更新，再用一条测试数据走通完整流程。 4. 配置数据表权限 进入「数据表权限设置」，先选择要配置的数据表。每张表可以分别控制四类操作： 数据表权限设置：分别配置新增、查看、更新和删除权限；选择「自定义」后可进一步限定成员范围。 权限 决定什么 新增数据权限 谁可以向表中创建记录 查看数据权限 谁可以读取记录 更新数据权限 谁可以修改记录 删除数据权限 谁可以删除记录 每类权限可选择「所有人」或「自定义」。选择「自定义」后，点击「设置成员」，按页面提供的角色、部门或成员范围配置。常见范围包括应用管理员和数据创建者。 推荐原则： 公开内容可以允许所有人查看，但新增、更新和删除应限制范围。 个人记录优先限定为数据创建者本人可查看和修改。 审核、运营或后台管理操作只授予应用管理员。 配置完成后，分别用普通访问者和管理员身份验证，不要只测试创建者账号。 权限配置错误可能导致数据泄露或数据被误删。包含用户私有数据时，不要把「查看数据权限」设为所有人；保存权限后务必使用非管理员账号验证。 5. 管理密钥 「密钥管理」用于保存云函数需要的环境变量和第三方服务凭证。页面支持搜索、新建、编辑、启用或停用、删除和同步失败重试。 密钥管理：列表只展示密钥名称、用途、引用关系和状态，不会直接展示密钥值。 新建密钥 进入「云服务」>「密钥管理」。 点击「新建密钥」。 填写名称、值和可选描述。 点击「确认」，等待同步完成。 密钥名称只支持英文字母、数字和下划线，必须以英文字母开头，最长 64 个字符。建议使用能表达用途的大写名称，例如 MAPAPIKEY 、 PAYMENTPRIVATEKEY 。 密钥列表会显示用途描述、引用该密钥的云函数、启用状态和更新时间。点击引用的云函数，可以直接跳转到对应函数。 修改、停用和删除 编辑已有密钥时，名称不可修改；值留空表示保留原值，填写新值才会更新。 暂时不希望云函数读取某个密钥时，可以先停用，再观察应用是否受影响。 启用状态的密钥不能直接删除；先停用并确认没有函数依赖，再执行删除。 出现同步失败时，点击「重试」；仍失败时检查密钥名称和值的格式，并重新发布验证。 不要在聊天消息、前端代码、截图或问题反馈中粘贴完整密钥。密钥值应只在密钥表单或 QMuse 提供的密钥填写卡片中输入。 6. 查看和排查云函数 云函数通常由 QMuse 根据业务需求自动生成和部署，管理页不提供手动新建入口。需要新增后端逻辑时，在对话中描述业务动作和安全要求即可。 云函数：通过列表查看运行状态、执行次数、平均耗时和更新时间，也可以进入源码或函数详情继续排查。 云函数列表显示： 云函数名称与当前状态 执行次数和平均耗时 最近更新时间 查看源码或重新部署等可用操作 执行次数和平均耗时存在统计与展示延迟，不会随每次调用实时更新。排查刚发生的请求时，应优先结合实际业务结果和函数执行日志判断，并稍后刷新列表查看统计变化。 常见状态： 状态 含义 建议操作 运行中 已部署并可接收请求 结合执行次数和日志验证业务调用 构建中 正在构建部署，通常需要几十秒 稍等后点击刷新 已创建 已创建资源，正在等待构建 稍等后刷新；长时间不变再排查 已停用 函数不可用，请求可能返回 503 确认影响后重新部署或重启 部署失败 构建或部署过程出错 打开错误详情，修复后重新部署 点击函数所在行可以查看基本信息、最近执行日志和部署记录。异常状态还会展示错误信息与调用堆栈。 点击「查看源码」会切换到代码视图并打开该函数的入口文件。修改源码前建议先保留可恢复版本；保存后重新发布，并再次检查函数状态和日志。 云函数排查顺序 确认状态是否为「运行中」。 查看执行次数是否随实际操作增加，判断请求是否到达函数。 打开详情查看最近执行日志、HTTP 状态和错误信息。 到「密钥管理」检查依赖的密钥是否存在且已启用。 如为部署失败，查看源码修复或通过对话说明错误，再执行重新部署。 重新走一遍页面上的完整业务流程，不只检查函数列表状态。 查看执行日志 每个云函数都支持查看执行日志，用于排查请求异常和监控运行情况。在云函数列表中点击「执行日志」即可进入。 日志列表 执行日志列表展示该函数最近的执行记录，每页 10 条，支持分页浏览和手动刷新。 字段 说明 执行 ID 本次执行的唯一标识 状态码 HTTP 响应状态码 状态 执行状态：已完成、失败、执行中、等待中、已排期 持续时间 本次执行耗时 创建时间 执行发起时间 操作 点击「详情」查看执行详情 执行详情 点击某条执行记录的「详情」可查看本次执行的完整信息： 基本信息： 执行 ID、请求方法、状态码、执行状态、触发方式（HTTP 请求 / 定时触发 / 事件触发）、持续时间、创建时间和请求路径。 请求信息： 参数 ：请求 URL 中的查询参数 请求头 ：请求头键值对 响应信息： 日志 ：云函数运行时 log 输出的日志 错误 ：云函数运行时抛出的错误信息 响应头 ：响应头键值对 正文 ：响应体内容（JSON 自动格式化） 日志和错误内容支持一键复制，便于排查或反馈问题。 执行错误与自动修复 当云函数部署失败或最近一次执行出错时，系统会展示错误详情并提供以下操作： 自动修复 ：将错误信息发送给 AI 助手，自动分析并修复代码问题 重新同步 ：重新发起云服务同步 复制 ：将错误信息复制到剪贴板，方便反馈问题 7. 管理文件 文件存储用于保存应用中上传的图片、附件等文件。例如旅行相册中的照片、报名表中的附件、作品集中的图片，都可以随应用一起保存在云端。 为应用添加上传能力 在对话中描述要上传什么，以及上传后如何使用。例如： 给这个应用增加照片上传功能。上传成功后在相册中展示，刷新页面或下次打开时仍能查看。 如果应用尚未开启云服务，按对话中的提示确认启用。已经开启云服务的应用，直接说明新增的上传需求即可；等待新版本生成、云服务同步完成后，再进入预览测试上传。无需自行创建存储空间或填写存储配置。 上传入口由 QMuse 根据需求生成在应用页面中。创作工作区的「文件管理」用于查看和维护已存储的文件，当前不提供上传、创建文件夹、编辑或重命名入口。 查看与查找文件 在创作工作区顶部点击「云服务」。 在左侧选择「文件管理」。 查看文件名、类型、大小和更新时间；在「搜索文件名」中输入关键词查找文件。 应用刚上传文件后，点击右上角刷新图标更新列表。文件较多时，可使用列表底部分页查看。 「文件管理」展示当前应用存储的实际文件。截图中的文件名仅为示例，你的列表以应用实际上传内容为准。 操作 使用方法 说明 搜索文件 在右上角「搜索文件名」中输入关键词 清空关键词可返回完整列表 刷新列表 点击搜索框右侧的刷新图标 上传或删除后可刷新确认最新结果 复制链接 点击文件所在行的「复制链接」 复制的是文件访问地址，不是复制出一份文件 删除文件 点击所在行的「删除」，核对提示后确认 删除不可恢复，原链接可能失效 批量删除 勾选文件，再点击出现的「批量删除」按钮 表头复选框选择当前页文件；翻页或刷新后需重新选择 批量清理文件 勾选要清理的文件后，右上角会显示「批量删除」及选中数量。核对所选文件，再点击按钮。 确认弹窗会再次提示文件数量和不可恢复的影响。点击「取消」可保留文件；确认不再需要后再点击「删除」。如果部分文件删除失败，按页面提示刷新并检查剩余文件。 删除文件可能导致已发布应用中的图片、附件或下载链接无法使用。删除前请确认文件不再被业务使用，并自行保留需要的原始文件。删除业务记录和删除文件是两个操作，不要默认它们会自动同步。 8. 多环境管理 什么是多环境 云服务支持将资源划分为 测试环境 和 正式环境 两套独立实例，实现开发调试与线上运行的数据隔离。 特性 测试环境 正式环境 数据 调试期间产生的业务数据 线上真实业务数据 云函数 调试用云函数 线上运行云函数 密钥 测试用密钥 线上生产密钥 文件存储 调试用文件 线上文件资源 测试环境与正式环境的项目资源完全独立：数据库、云函数、密钥和文件存储互不影响。默认情况下应用为单环境（测试和正式共用一个环境），开启多环境后会分别管理两套资源。 开启多环境 在云服务面板顶部，点击「开启多环境云服务」按钮。开启过程需要确认以下事项： 开启后不可取消 ，也不能恢复为单环境模式 开启后系统将异步初始化正式环境，整个过程大约需要 2 分钟 初始化完成后，需要 发布一次 才会对新加载的线上页面生效 测试环境已有的业务数据 不会自动迁移 到正式环境 开启流程： 点击「升级多环境」 确认弹窗 异步初始化正式环境 初始化完成 首次发布生效 环境状态说明 状态 说明 未开启 尚未开启多环境，默认单环境运行 初始化中 正式环境正在初始化，此期间不可发布 初始化失败 正式环境初始化异常，可点击「重试」重新发起 待首次发布 正式环境已就绪，发布一次后即可生效 已激活 多环境已完全激活，正常使用 环境切换 多环境激活后，云服务面板顶部会出现环境选择器，可在「测试环境」和「正式环境」之间切换。切换后，数据表、云函数、密钥和文件存储的内容将对应到所选环境的资源。 跨环境数据同步 多环境激活后，数据表支持跨环境数据同步，可在数据表的批量操作中使用： 测试 → 正式 ：将测试环境的数据同步到正式环境 正式 → 测试 ：将正式环境的数据同步到测试环境 操作方式：选中数据记录后，在批量操作菜单中选择对应同步方向即可。 跨环境同步会以所选记录覆盖目标环境的同名记录，请确认目标环境数据可以覆盖后再操作。 社区访问环境设置 多环境应用同步公开到社区后，在发布面板可以设置社区是使用 测试环境 或 正式环境 云服务访问。 9. 生成和发布包含云服务的应用 应用使用云服务后，每次生成新版本时，QMuse 会同步该版本依赖的数据表、密钥引用和云函数等资源。版本生成完成后，再检查版本内容和页面功能。 生成或发布前建议检查： 数据表字段和测试数据符合预期 新增、查看、更新、删除权限已分别验证 文件上传成功，刷新或重新打开页面后仍能查看，文件管理页可查到对应文件 必需密钥已创建、启用并同步成功 云函数状态正常，最近一次测试没有错误日志 页面在登录和未登录两种状态下表现符合预期 如果版本生成失败或长时间未完成，先查看对话和版本面板中的提示；涉及云函数时，再到云函数详情查看错误信息。修复后重新生成版本，并在验证通过后发布。 发布成功不等于每条业务链路都已验证。发布后请使用正式访问链接完成一次新增、查询、修改或第三方接口调用。 10. 解绑云服务 「解绑云服务」位于云服务左侧导航底部。解绑后，当前项目将无法继续使用应用数据表、文件存储、权限设置、密钥和云函数，依赖这些能力的页面可能无法正常展示或操作。 解绑后的云服务数据保留 15 天： 保留期内可以重新启用云服务。 超过保留期，云服务数据会被永久删除。 解绑前至少完成以下检查： 导出需要保留的数据，并另行保存需要保留的文件。 确认已发布应用是否仍有访问量。 记录仍在使用的密钥名称和云函数用途，不要导出或传播密钥值。 确认应用可以接受相关功能暂时不可用。 不要把解绑当作普通的“关闭面板”。只有明确不再需要该应用的全部云服务能力时，才点击「确认解绑并关闭」。 使用建议 先描述业务，再描述表结构。 让 QMuse 同时处理页面、数据与权限。 先用少量数据验证。 新表或导入流程先测试 1-3 条记录，再批量操作。 权限默认从严。 先限制访问，再按实际需要逐步放开。 密钥只放密钥管理。 前端代码和普通数据表都不应保存密钥值。 修改后走完整流程。 数据写入成功、函数运行中、页面没有报错三者都要检查。 大改前先导出。 批量删除、导入覆盖、解绑前都保留必要的数据备份。 常见问题 为什么工作区里没有“云服务”入口？ 当前应用可能还没有开启云服务。在对话中明确提出持久化数据、用户权限或云函数需求，等待 QMuse 完成创建后再查看；如果出现额度提示，先按提示处理。 云服务已开通，为什么没有数据表？ 开通云服务不等于一定已经创建业务表。在对话中说明需要保存的业务数据和使用流程，数据表会随代码变更自动创建。 数据在管理页里存在，页面却看不到？ 先检查当前页面的查询条件和登录身份，再检查查看权限是否允许该用户读取记录。仍有问题时查看云函数执行次数和日志。 只需要上传图片，也要说“开启数据库”吗？ 不需要。直接说明“上传图片”“云端保存附件”或“创建相册”等业务需求，QMuse 会判断并接入所需的云服务。 老应用可以增加文件上传吗？ 可以。在原应用对话中说明新增上传需求，等待新版本生成和云服务同步完成，再测试上传、刷新和重新打开。如果仍提示文件存储未就绪，把完整提示反馈给 QMuse 继续处理。 文件管理页为什么没有上传按钮？ 当前该页面提供查看、搜索、复制链接和删除。需要上传时，请在应用的预览或已发布页面中使用生成的上传入口；如果尚无入口，可通过对话添加。 上传后列表没有看到文件怎么办？ 先确认应用页面提示上传成功，再回到同一个应用的「文件管理」刷新列表，清空搜索条件并检查分页。仍未出现时，记录操作步骤和错误提示后反馈。 复制文件链接会改变访问权限吗？ 不会。复制链接只取得访问地址；能否打开仍取决于文件当前的访问权限和状态。删除文件后，原链接可能失效。 密钥更新后功能仍然报错？ 确认密钥已启用且同步成功，名称与代码引用完全一致；然后重新发布并再次触发业务操作。反馈问题时不要附上完整密钥值。 函数一直构建中怎么办？ 先等待约一分钟并刷新列表。长时间没有变化时，打开详情查看部署记录；若已转为部署失败，按错误信息修复后重新部署。 可以直接在云服务页新建云函数吗？ 当前不支持。请在对话中描述要新增的后端业务逻辑，由 QMuse 生成并部署函数。 多环境开启后可以关闭吗？ 不可以。多环境开启后不可取消，也不能恢复为单环境模式。 多环境初始化失败了怎么办？ 云服务面板会显示「正式环境初始化异常」提示，点击「重试」即可重新发起初始化。重试不会创建重复环境，会复用已创建的项目资源。 正式环境初始化完成后为什么还不生效？ 初始化完成后需要发布一次应用，社区和正式页面才会使用正式环境数据。面板顶部会显示「正式环境已就绪」提示，点击「立即发布」即可。 测试环境的数据会自动同步到正式环境吗？ 不会。测试环境已有数据不会自动迁移到正式环境。如需同步，可在数据表中选中记录，使用批量操作中的跨环境同步功能手动操作。 云函数的执行日志保留多长时间？ 执行日志展示函数最近的执行记录，可手动刷新获取最新数据。如需保留特定日志，请在详情中复制日志内容。 相关文档 通过对话继续修改 工作区工具：代码、数据源与应用设置 发布与分享作品 发布失败 问题排查指南 提交反馈 准备发生时间、应用链接、操作步骤、完整报错文字，以及不包含密钥和用户隐私的截图，再通过 问题排查指南 中的渠道反馈。