文档目录对话开发
能喵使用文档对话开发
CONVERSATIONAL DEVELOPMENT

把需求说清楚,让产品在对话中成形

对话开发把需求确认、实施计划、页面与受控 App 草稿、预览授权和版本管理放在一个编辑器里。

更新于 2026 年 10 月 23 日核心功能

代码导入与源码下载

工作台的“导入代码”可选择源文件或 ZIP,也可粘贴代码,保存为新的应用草稿。支持常见前后端源码、Vue、Svelte、Astro 和项目配置;接收源文件不等于原技术栈可直接运行。导入后描述下一步修改并开始制作,由平台适配、检查后生成预览,不直接运行原后端或安装脚本。最多 128 个文件,总计 500KB、单文件 250KB,ZIP 不超过 5MB。不要导入密钥或无权使用的代码。

在编辑器源码区域选择“导出项目源码”,下载当前应用已保存的完整源码 ZIP,不受当前选中文件或搜索筛选影响。旧项目若未保存原始可编辑源码,会导出已保存的执行产物并说明限制。压缩包不包含业务记录、密钥、对话和版本历史;外部图片等保留资源引用,不下载依赖或远程资源。平台 SDK、Gateway、服务端函数和权限仍依赖受控运行环境,下载源码不会自动迁移应用或发布。

积分、等待与安全恢复

当前制作使用账号可用通用积分,无需填写每次制作的积分上限。需求理解与制作可能分别计费;积分先预占,最终扣费以结算为准,预占不等于实际扣费。能够开始不保证余额足够完成,任务可能在预览生成前停止;可通过“查看积分”在新标签页核对余额和账本,保留当前工作。

新制作期间保留上一版已采用的预览,进度卡显示当前阶段与用时;等待执行环境、仍在处理、已中断和失败是不同状态。停止本地任务不证明上游调用已立即终止或已退款。优先使用当前页面提供的恢复入口;“从已保存进度开始”会建立单独计费的新制作,重新核验需求、权限和保存点。明确选择只验证原候选时,不改源码或依赖;不能把尚未验证的保存点当成可用版本。

Harness 与 MCP 的当前状态

Harness 已用于 Builder:在任务的积分、时间和工具边界内组织项目上下文、代码与依赖,执行检查并根据反馈修正。新路径使用项目开发循环;历史项目仍可能使用旧的任务编排。检查包括编译、隔离页面观察和适用的合成业务验证,覆盖范围与未验证项应以本次结果为准;检查通过不保证真实数据、外部服务或所有交互可用。

MCP 页面介绍外部 AI 连接平台的规划,目前尚未开放 MCP 连接,也没有可按该页配置的生产连接地址。代码导入、源码下载和已实现的 Builder 能力不代表 MCP 已上线。可查看 Harness 和 MCP 页面了解两者的工作边界。

Harness · MCP

如何描述一个好需求

高质量需求不需要专业术语,但最好包含以下信息:

  • 业务:你提供什么产品或服务。
  • 用户:主要为谁解决问题。
  • 范围:首版需要哪些页面和动作。
  • 风格:希望呈现的气质,以及明确不要的方向。
  • 目标:希望访客注册、咨询、购买还是留下预约。

创建、规划与对话

创建(Build)表达执行意图。没有关键问题或能力阻塞时,无需逐轮确认页面制作;需要准备业务数据时,仍须确认具体数据变更。规划(Plan)先展示方案并在“确认并生成计划”后生成计划;对话(Chat)用于讨论、解释或形成建议。规划和对话可以保存对话、需求版本和计划,但不会修改业务表、字段或记录,也不会批准能力或发布 App。执行计划或建议时需明确选择创建。

需求理解保留“不建表”“不重建”等明确限制,关键问题提供可点击选项,低风险空白使用标明为推断的默认设置。新提交或改写会更新需求版本,旧确认不能授权新内容。

确认并准备业务数据

需要新建业务表或准备初始数据时,先核对具体的表、字段和初始数据变更,再点击一次“确认并开始制作”。服务端原子应用已确认的数据方案,成功后才制作页面;准备失败时尚未应用数据变更,可保留项目并重试。无需准备业务数据且没有关键问题或能力阻塞时,创建(Build)可直接制作。

确认卡片显示可读的表、字段和初始数据变更,不以技术标识代替说明。Build 可创建或复用 App 并形成草稿;能力批准、App 发布与回滚是独立动作。

真实数据 App 与预览权限

受控 App 通过平台支持的页面和后端操作访问业务数据。已确认的制作完成后,平台只为当前项目、当前页面实际需要的资源准备必要的所有者预览权限,并直接打开预览;不需要再点击“批准并打开预览”。历史页面、需求变化、已撤销权限或缺少外部连接时,可能仍无法打开,应按页面提示处理。

预览中的写操作会修改真实记录,请使用有权操作的测试数据。这项访问只供当前 App 的所有者预览,不会让其他项目或访客取得权限;撤销后后续访问立即被拒绝。普通 HTML 页面预览不具备私有数据访问权,能点击表单不代表已经连接后台。外部集成授权、App 发布与回滚仍是独立操作。

接入与能力边界

自有密钥连接与平台运行时 AI 是不同的接入方式。当前自有密钥集成限于固定 DeepSeek 对话操作,需要所有者另行配置 BYOK(自有密钥)连接,并独立批准当前 App 的操作;制作和预览不会代建连接。不要把密钥粘贴到对话、生成页面或支持工单。

生成页面需要 AI 内容时,可使用平台运行时 AI 表单,无需为这条路径配置 DeepSeek 自有密钥连接。制作前会说明 AI 调用使用项目所有者的通用积分;制作完成后,支持且可用的功能按已确认范围配置测试与正式环境授权,无需再设置项目或账号月限额、开启额外开关。付费测试和访客调用按实际用量扣除所有者的通用积分,用量统一在个人中心查看;已有免费权益继续按其规则使用。已暂停或撤销的授权不会因预览或发布自动恢复,模型、权限和单次调用保护仍生效。

生成页面不能自行增加登录提供商、自定义角色权限、任意外部 API 或任意后端代码。身份认证应使用已有 App 运行配置;未支持的要求会明确停止,能力咨询可以继续留在对话中。

实时预览、检查与制作进度

预览是可交互页面,可切换桌面、平板、手机和子页面,实际检查导航、按钮与表单。预览更新期间会保留正在输入的内容;移动操作和长表单仍需实际测试。

制作进度显示平台正在执行的工作和已用时间,完成后说明结果及可尝试的动作;进度不是后台连接成功的证明。

候选页面会先进行静态质量与隔离布局检查,再尝试应用;自动修正会明确提示。检查使用隔离的合成状态,不能证明真实业务记录或外部服务已经验证。符合条件的局部修改失败会提供“按区块调整重试”入口,保留其他设计;入口是否可用以当前任务为准,不是所有失败都能局部重建。

图片规划或生成未能完成时,页面可能继续制作,并明确提示未配图;不要把完成提示当作已经生成全部图片。

预览出现终止性错误会显示失败状态。保留项目与上一可用版本,按提示恢复或报告问题。

版本与恢复

每次完成生成后,项目会记录新版本。你可以打开版本历史查看旧版本,并将某个旧版本恢复为新的当前版本;原有记录不会被直接覆盖。编辑器版本恢复不等于 App Release 回滚,也不会恢复业务记录备份。

任务中断时先保留当前项目。出现“恢复”入口后点击它即可从安全恢复点继续原任务,不需要重新发送同一条需求。若提示旧任务缺少可核验的需求版本或确认已失效,应先保留现有成果,再按提示重新核对当前需求。

制作失败时可以在项目内提交失败报告。失败卡片不显示技术细节区块,服务端保留生成链路供复核。报告经审核接受后可获 200 通用积分;提交不等于审核通过或积分到账,同一报告不会重复奖励。传输失败会进行一次重试,每日报告额度用尽时会说明原因。