飞书妙搭开发经验分享

开题：我们如何用“妙搭”搭建出我们想要的应用和效果。

目标：以最少的成本，搭建出最实用的应用。

一、妙搭常用的三种开发模式

1、灵感探索：主要以先设计页面（首页、报名页面）为主，没有数据库，权限，插件等功能，设计好页面后可以通过升级为应用开发模式。

2、应用开发：具备代码、数据库、插件（多维表格、AI）、权限、文件、自动化、API，报表等功能，可实现一次性搭建好应用。

3、模版搭建：通过官方模版进行搭建，然后在对细节和内容进行修改。

关于数据库

妙搭使用的数据库是PostgreSQL数据库，动态扩缩容，单表支持超过百万行，支持直接在应用中通过AI Agent 对话、数据面板、SQL编辑器来操作数据库。（支持多维表同步数据）

二、常见的三种开发方式及优缺点。

三、提示词（Prompt）经验

1、怎么写好提示词：

• 1、首先我们需要确定好要做什么，给谁用，目标和最终想要达到一个什么样的效果。

• 2、我们的需求。（模块/字段）

• 3、设计风格。（需要什么样的布局，什么样的样式，什么样的页面切换效果，元素）

• 4、任务边界。（哪些功能必须有，哪些先不用做）

例：搭建一个公司AI培训的报名界面。

1、我们第一想到的就是以AI培训为主，用于员工报名，页面该有的元素。

2、把这个项目进行拆解。（主题、课程亮点、讲师介绍，往期学员反馈，培训地点，培训时间，立即报名）

3、页面设计风格。（ai元素，简洁，科技，动态效果）

4、最后是提交表单。（姓名，联系电话、公司/部门）

判断力：

三个判断力维度：

• 拆问题：这件事能不能拆成几步，让每一步都“闭环可验收”？

  • 例：做一个报名页，不要一上来就说“做个页面”，而要先拆成“页面内容”“表单字段”“数据是否留存”“报名后跳转到哪里”。

• 验收输出：这一步 AI 的输出，我用什么标准说“可以过 / 需要重来”？

  • 例：页面不是“好看就行”，而是要看课程亮点是否齐、报名入口是否明显、手机端是否能看。

• 知道边界：什么问题适合交给 AI，什么问题必须自己做？

  • 例：排版、初稿、信息整理可以先交给 AI；但业务规则、权限判断、是否真的能上线，必须由人拍板。

这三件事分别对应到妙搭里：

• 拆问题：先在妙搭里拆清页面模块、表单字段、是否需要数据库、是否需要工作流；

• 验收输出：先看生成出来的首屏结构、移动端效果、字段完整性、提交流程是否通；

• 知道边界：凡是涉及登录权限、审批结果、用户数据留存、多人协作发布，就不要停留在“只看效果”的层面，而要升级到应用模式。

2、AI场景描述

四、销售管理系统（案例）

1、销售管理系统提示词

我需要搭建一个销售管理的应用，主要是给销售人员管理数据，目标是打通客户、线索、商机、合同、发货、回款、售后全销售链路，实现销售流程标准化、数据统一化、业绩可管控，降本增效、提升整体营收与客户留存和合同排版打印功能。

##必须包含功能模块（模块/字段）

1、数据概览：

（1）模块快捷卡片：客户管理，产品管理、合同管理，订单管理，交付管理。

（2）数据视图：指标卡（总客户数，销售线索，商机金额，合同总数，本月订单，成交金额），本月业绩目标，目标完成率、销售漏斗、销售趋势（月、季、年）、客户等级，最近合同，最近订单等。

2、客户管理：

（1）客户档案：以档案的形式来设计用户信息，可以通过档案详情看用户详情，交易记录等。

（2）复购跟进： 指标卡，查看客户复购率情况。

3、交易管理：

（1）合同管理： 合同指标卡，数据字段（字段跟多维表格一致），将每份合同以合同编号或者审批ID为主，将同一个合同编号或者审批ID的产品明细数据合并成一份合同。（因为数据来源多维表和审批表，产品明细是以多条数据存储），实现用户打印前可以选择对应的合同模版进行打印功能。

（2）订单管理 :订单指标卡，数据字段（订单编号、客户、订单金额、状态、下单日期）。

（3）交付管理：交付指标卡，数据字段（交付单号、订单编号、状态、收货人信息、物流公司、运单号、发货日期）。

4、售后服务：

（1）售后工单： 售后指标卡，数据字段（服务单号、客户、问题描述、状态、创建日期、满意度）。

5、基础数据：

（1）产品管理 ：产品指标卡，数据字段（产品编码，产品名称、分类，单位，销售价，成本价，毛利率，状态）。

（2）供应商管理 ：供应商指标卡，数据字段（供应商信息、联系人、信用等级、累计采购、状态、日期）。

6、系统配置：

（1）合同模版配置：通过合同模版配置用户可以自定义上传合同模版（HTML、PDF、Word），实现用户打印前可根据数据选择对应的合同模版。

（2）数据链接配置：支持多维表格数据，API数据来源，数据连接状态（已连接，已断开），实现连接和断开后自动更新和同步数据表。

##页面设计风格

（1）布局：参考金蝶云布局样式（数据管理系统）进行布局，将筛选条件统一放在数据区左侧。

（2）样式：简洁、专业、科技和页面动态效果 。

（3）色彩搭配：不要太花，按照标准的管理系统颜色搭配，导航栏以白色为主。

##任务边界

（1）具备权限、数据库、视图、自动化数据分析能力，自动化（多维表数据同步），API数据链接，可自适应PC端和移动端。

需注意的是参考其他系统布局和样式是可以实现的，但不能做成一摸一样。例如：我要做一个飞书或者说我要做一个金蝶软件，一是浪费额度，二是达不到那个能力。

2、最终的效果

五、搭建过程中遇到的问题与解决方案

1、AI理解了需求但输出结果与预期不符。

问题描述：提示词描述看似清晰，但AI生成的结果偏离预期，或者反复调整后效果仍不理想。例如：有两张表格需要上下合并成一张表，AI理解了但始终无法实现正确的合并效果。（问题定位：页面布局、合同模版明细表）

解决方案：

• 拆解需求：将复杂需求拆成"最小可验证单元"，逐个调试。先让AI完成第一步，确认效果后再进行第二步。

• 举例说明：对难以描述的需求，直接给AI一个"正确示例"和一个"错误示例"，对比说明差异。

• 增加约束条件：明确告诉AI"必须包含"和"绝对不能出现"的内容，缩小AI的发挥空间。

• 分轮对话：不要试图在一轮提示词中解决所有问题，先让AI搭框架，再逐层细化。

2、页面样式与预期差距大。

问题描述：AI生成的页面布局、颜色搭配或交互效果不符合预期，反复调整仍不满意。（问题定位：页面布局、合同模版布局、细节调整）

解决方案：

• 提供参考图/截图：上传目标页面的截图或UI设计稿，让AI"照着做"。

• 明确设计规范：指定具体的颜色值（如"主色用#1890FF"）、字体大小（如"标题18px，正文14px"）、间距（如"卡片间距16px"）等。

• 引用成熟系统样式：如"参考金蝶云/钉钉管理后台的布局风格"，AI对知名系统的样式理解更准确。

• 分步确认：先生成静态页面布局，确认后再添加动态效果和交互逻辑。

3、数据库字段或关联关系混乱。

问题描述：应用涉及多张数据表关联时，AI生成的表结构不合理，或字段类型、关联关系有误，导致数据无法正常存取。（问题定位：创建数据库表时）

解决方案：

• 提前画ER图：在提需求前先梳理清楚表与表之间的关系（一对一、一对多、多对多），明确主键和外键。

• 字段清单化：将每个表的字段名、字段类型、是否必填、默认值等以清单形式列出，避免AI"自由发挥"。

• 分表构建：先让AI建好基础数据表（如产品表、客户表），确认无误后再建关联的业务表（如订单表、合同表）。

• 测试数据验证：表结构建好后，先录入几条测试数据验证关联关系是否正确，再正式使用。

4、权限配置导致数据泄露或无法访问。

问题描述：应用搭建完成后，发现普通用户能看到不该看的数据，或者管理员反而无法操作某些功能。（问题定位：应用分享时）

解决方案：

• 角色先行：在搭建应用前先明确系统有哪些角色（如普通员工、部门主管、管理员），以及每个角色能看什么、能做什么。

• 最小权限原则：默认给最小权限，需要时再逐步放开，避免一开始就全部放开导致数据风险。

• 按模块划分权限：数据权限和功能权限分开配置，数据权限控制"能看到哪些数据"，功能权限控制"能进行哪些操作"。

• 测试不同角色：搭建完成后用不同角色的账号分别登录测试，确保每个角色的权限边界正确。

5、额度消耗过快。

问题描述：开发过程中发现AI调用额度消耗很快，尤其是反复调整提示词时。（问题定位：页面布局，样式整改，细节调整）

解决方案：

• 一次性说清楚：在第一次提需求时就尽可能详尽，减少后续反复修改的次数。

• 善用"灵感探索"预览：在正式升级到"应用开发"模式前，先用"灵感探索"快速验证页面效果，确认方向正确后再投入额度进行完整开发。

• 复用已有模块：相似功能不要从零开始，基于已有的提示词或模块进行修改，减少AI的重新理解成本。

• 记录有效提示词：将验证通过的提示词保存下来，形成团队内部的"提示词库"，后续同类需求直接复用。

6、嵌入 iframe 或外部链接失效。

问题描述：页面中嵌入的其他应用链接（iframe）在其他设备或浏览器中无法正常显示。

解决方案：

• 检查链接权限：确保嵌入的链接在当前环境下有访问权限，部分链接仅在特定网络或登录状态下可用。

• 使用公开链接：嵌入的链接尽量使用公开可访问的地址，避免使用需要登录或内网才能访问的链接。

• 预留备用方案：在页面中添加文字说明或跳转按钮作为iframe加载失败的备选方案。

• 多端测试：在PC端和移动端分别测试嵌入内容的显示效果，确保自适应正常。