烟花上手实操：从搭好环境到产出第一个系统

烟花是一个会操作灵象低代码平台的 AI 智能体：你用一句话说需求，它替你在灵象里把系统建出来。这篇手册带你从零跑通一遍——搭好环境 → 说一句需求 → 看着它产出第一个能用的功能。照着做即可，每一步都告诉你「该看到什么」和「该你做什么」。

一张路线图，先看全程

整条路线就 6 步。前 2 步是环境搭建（配一次，以后不用再配），后 4 步是产内容（每次搭系统都这么走）。

记住这条「健康心跳」：先出计划 → 一步步报进度 → 卡住就交还。烟花会把每步打印出来，你只要看节奏对不对，不用懂技术。

开始前：备齐 4 样东西

1. 一个支持 MCP 的 AI 客户端——接 DeepSeek 或其他支持 MCP 的 AI 模型都行。
2. JECloud MCP 服务——跑在端口 1078，由工程师给你部署好、给你地址。
3. 一个灵象平台账号——用来登录、让烟花在里面干活。
4. 一份「开机启动清单」——一段给烟花看的启动指令（逼它先分类、先出计划再动手），同样由工程师给你，第 ② 步会用到。

① 把 MCP 接成「常驻连接」（最容易翻车的一步）

烟花靠 JECloud MCP 干活。这一步接法配错，连登录都过不去，所以单独拎出来讲。

✅ 正路：用 AI 客户端内置的 MCP 通道挂 jecloud-mcp，走 http 常驻长连接，指向 1078。以常见的 MCP 客户端配置（.mcp.json 这类）为例：

{
  "mcpServers": {
    "jecloud-mcp": {
      "type": "http",
      "url": "http://127.0.0.1:1078/mcp"
    }
  }
}

把 url 里的 http://127.0.0.1:1078 换成工程师给你的那个地址（备料清单第 2 条里的那个）——本机部署才是 127.0.0.1，装在别的机器/内网就用他给的 IP 或域名，末尾 /mcp 不动。

上面是一份常见的 MCP 客户端配置写法。本质只有三点：走 http 类型、url 指向 …:1078/mcp、保持常驻长连接——其余字段名以你所用 AI 客户端的 MCP 配置文档为准（不同客户端配置项名称可能不同，工具名也可能带 mcp__jecloud-mcp__ 前缀）。

❌ 死路：用 mcporter call 这类无状态逐调用的桥接（每次调用都新建一条连接）。JECloud MCP 是连接级有状态会话，无状态调用会让你登录成功后下一次就掉线（报 AUTH_REQUIRED）——换再聪明的 AI 也过不了登录，这不是烟花的问题，是接法的问题。

一眼自检：浏览器或命令行访问 http://<你的地址>:1078/health/ops（<你的地址> 同上，本机就是 127.0.0.1），看到 session_model = connection-stateful 就说明「必须常驻连接」。卡在登录时别去 curl 戳端点、别改桥接参数——都没用，换成常驻连接即可。

② 开新会话，让烟花握手登录

环境通了，开一个新会话，把工程师给你的「开机启动清单」贴在最前面（一段给烟花看的启动指令，逼它先分类、先出计划、再动手）。贴完它会自己做两件事：

1. 握手自检——whoami 确认登录态、查能访问哪些服务。
2. 登录灵象——账号口令不在对话框里输：工程师交付环境时已把它预置在客户端安全配置里（具体照「开机启动清单」操作，清单里有这一条）。烟花握手时自动取用，你只需在它询问时点头确认「就用这个账号」。

一条红线：别在对话里贴明文密码。烟花也绝不会帮你存密码、查密码——你让它碰，它也会拒。这是写死的（详见《信号灯与保险丝》）。

到这里环境就绪。下面进入「产内容」，每次搭系统都走 ③→⑥。

③ 说一句需求，等它给你《行动计划》

直接用大白话说你要什么。把字段列清楚最关键：

帮我做一个设备报修单，字段有：设备名称、报修人、报修时间、故障描述、状态。

烟花收到后，第一个动作一定是打印一份编号的《行动计划》（第 1 步做什么、第 2 步做什么……，写库/删除的步骤会标红）。

• ✅ 看到编号计划，再往下走——这是健康的节奏。
• ⛔ 没打印计划就开始建表 = 头号跑偏，回它一句：「先出《行动计划》再动手，没打印计划不许写。」

拿不准的字段（长度、必填、值从哪来）烟花会反过来问你，照它问的给值就行，别让它自己猜。想让需求一次说准，看《字段从哪来的 6 分法》。

④ 审「毛坯设计」并签字

按计划走到建表前，烟花会停下来，把这套设计摆给你看：字段清单、字典选项、编码方案、挂在哪个菜单下。

这是整条流程里唯一的硬关口——你不点头，它不动手。

• 看着对 → 回一句「可以，建吧」，它才开始写库。
• 哪里不对 → 直接说改哪里，它改完再给你审。

为什么这一步要你拍板：毛坯（表结构）一旦错了，后面再怎么装修也是错的。所以这一关必须等你签字，烟花不许自走。

⑤ 看它建表 → 注数据 → 装修

你签字后，剩下的烟花自己一口气跑完，你不用每步批准，盯着进度即可：

1. 建表 + 建功能 + 挂菜单 + 授权——把功能在灵象里立起来。
2. 注几行模拟数据——让功能看得见、点得动。
3. 对着真实数据做全面装修——调列的显隐、排序、列宽、对齐，表单的必填、控件、分组……让它好看好用。

⛔ 建完就停在「毛坯」（没注数据、没装修）也是跑偏。回它一句：「别停在毛坯，继续注数据 + 全面装修。」想知道它到底能装到多细，看《烟花能搭什么：四大能力全景》。

⑥ 去灵象里验收

打开灵象，找到刚建的菜单。你应该看到：

• 菜单能打开，列表整整齐齐；
• 点「新增」能录入一条，保存得上；
• 列表里有刚才注的几行模拟数据。

三条都对，第一个系统就搭出来了。它是标准的灵象应用，往后既能继续让烟花改，也能由人在平台上手动维护扩展。

一边干一边盯：看这 6 盏「信号灯」

烟花照章办事，但偶尔会「扑向最快那一下」而跳步。它被设计成把每步打印给你看，你只要看「该亮的灯亮没亮」：

灯没亮、或它跑偏了，怎么一句话拉回、怎么回它的「交还」，全在《怎么盯着烟花干活：信号灯与保险丝》。

下一步

• 不知道怎么开口？→ 《怎么对烟花开口：6 类任务 + 模板》
• 想把需求说得更准 → 《把需求说准：字段从哪来的 6 分法》
• 想给系统加交互、按钮、看板 → 《给系统加交互：JEAPI 事件配方》
• 先理解烟花脚下的底座 → 《灵象快速上手》
• 实战视频会发布在 B 站官方频道。