JeecgBoot UniApp3 移动端 CRUD 代码生成器

将自然语言需求或已有后端接口信息转换为 JeecgBoot UniApp3 移动端全套 CRUD 代码（列表页 + 表单页 + 数据定义），支持单表 CRUD、一对多主子表、树表等场景。

项目路径： <uniapp_project_root>（动态，使用前需向用户确认，见 Step 0） 后端模板参考： <uniapp_project_root> 同级目录下的后端项目（如有）

前置知识

生成代码前必须理解以下项目核心约定，具体细节见 references/ 目录下的参考文件：

交互流程

Step 0: 确认项目路径

在执行任何操作之前，必须先询问用户以下信息（一次性展示，用户说"确认"使用默认值）：

用户回复后，记为：

• <uniapp_project_root> — 前端项目根目录

路径记忆规则： 同一对话中用户提供一次后，后续步骤直接复用，不再重复询问。

Step 1: 判断生成场景

场景 A — 已有后端接口（用户给了表名/实体名/接口路径）：

1. 向用户确认后端 API 路径前缀（如 /test/demo）
2. 从用户信息中提取：实体名（如 Demo）、包路径（如 test）、字段列表
3. 如果用户能提供后端 Entity 类，从中解析全部字段及类型
4. 根据字段类型自动推导前端控件
5. 只生成前端代码

场景 B — 从需求描述生成前端：

1. 从用户描述中提取：模块名、功能描述、字段列表
2. 用"智能控件推导"规则推导每个字段的 classType
3. 只生成前端 3 个文件（List.vue / Form.vue / Data.ts）

Step 2: 确认生成信息

一次性展示所有选项及默认值，用户说"确认"即可全部采用：

Step 3: 生成代码文件

前端文件

每个单表 CRUD 模块生成 3 个文件，路径基于 <uniapp_project_root>：

<uniapp_project_root>/src/pages-home/{模块名}/
  ├── {EntityName}List.vue    # 列表页（分页 + 滑动删除 + 新增入口）
  ├── {EntityName}Form.vue    # 表单页（新增/编辑 + 表单校验 + 提交）
  └── {EntityName}Data.ts     # 列表字段列定义

Step 4: 注册页面路由

在 <uniapp_project_root>/src/pages.json 的 subPackages 中注册新页面（如果目标目录已是 subPackage 则追加 pages，否则新增 subPackage）。

Step 5: 输出生成摘要

展示生成的文件清单、页面路由配置、后续操作说明。

字段控件类型推导规则

根据字段信息推导 classType（决定表单使用哪个组件）：

字段校验规则推导

生成代码的核心规范

1. 列表页（{EntityName}List.vue）规范

关键特征：
- 使用 <route> 标签声明页面路由信息（layout、style、navigationBarTitleText）
- 使用 <PageLayout> 包裹，设置 navTitle 和 backRouteName
- 使用 z-paging 实现分页加载
- 使用 wd-swipe-action 实现左滑删除
- 使用 usePageList hook 管理列表数据加载
- 引入 {EntityName}Data.ts 的 columns 定义
- 列表卡片默认展示前3个字段
- 固定定位的"+"按钮用于新增
- uni.$on('refreshList') 监听表单提交后的列表刷新

详细模板见 references/code-templates.md 的"列表页模板"章节。

2. 表单页（{EntityName}Form.vue）规范

关键特征：
- 使用 <route> 标签声明页面路由信息
- 使用 <PageLayout> 包裹，navTitle 动态切换"新增/编辑"
- 使用 wd-form + wd-cell-group 组织表单
- 通过 onLoad 获取 route params 中的 dataId 判断新增/编辑
- 编辑时调用 queryById 接口加载数据
- 表单数据用 reactive({}) 定义
- 提交时先 form.validate()，再根据 dataId 调用 add 或 edit 接口
- 提交成功后 uni.$emit('refreshList') 通知列表刷新，然后 router.back()
- 根据字段 classType 渲染对应组件（见组件映射表）
- 支持唯一性校验（调用 duplicateCheck API）
- label 超过4个字符时自动截断（get4Label）

详细模板见 references/code-templates.md 的"表单页模板"章节。

3. 数据定义（{EntityName}Data.ts）规范

关键特征：
- 导出 columns 数组，定义列表显示的字段
- 每个字段包含 title（显示名）和 dataIndex（字段名）
- 字典类型字段的 dataIndex 使用 `${fieldName}_dictText` 后缀
- 图片类型字段添加 customRender: render.renderImage
- 开关类型字段添加 customRender 渲染是/否文本
- Blob 类型字段的 dataIndex 使用 `${fieldName}String` 后缀

详细模板见 references/code-templates.md 的"数据定义模板"章节。

4. 页面路由注册

生成的页面需要在 src/pages.json 的 subPackages 中注册。使用 <route> 标签方式（uni-pages 插件自动解析），或手动在 pages.json 中添加。

<route> 标签格式（推荐，写在 .vue 文件顶部）：

<route lang="json5" type="page">
{
  layout: 'default',
  style: {
    navigationBarTitleText: '功能标题',
    navigationStyle: 'custom',
  },
}
</route>

如果目标目录不在已有 subPackages 中，需要手动在 pages.json 添加：

{
  "root": "pages-home",
  "pages": [
    {
      "path": "模块目录/EntityNameList",
      "type": "page",
      "layout": "default",
      "style": {
        "navigationBarTitleText": "功能标题",
        "navigationStyle": "custom"
      }
    },
    {
      "path": "模块目录/EntityNameForm",
      "type": "page",
      "layout": "default",
      "style": {
        "navigationBarTitleText": "功能标题",
        "navigationStyle": "custom"
      }
    }
  ]
}

API 约定

JeecgBoot 后端标准 CRUD 接口路径：

HTTP 工具使用 @/utils/http 的 http 对象，支持 http.get() / http.post() / http.delete() / http.put() 方法。

导入约定

列表页必须导入

import { ref, onMounted, computed } from 'vue'
import { http } from '@/utils/http'
import usePageList from '@/hooks/usePageList'
import { columns } from './{EntityName}Data'

表单页必须导入

import { onLoad } from '@dcloudio/uni-app'
import { http } from '@/utils/http'
import { useToast } from 'wot-design-uni'
import { useRouter } from '@/plugin/uni-mini-router'
import { ref, onMounted, computed, reactive } from 'vue'
import { duplicateCheck } from '@/service/api'

根据字段 classType 按需导入的组件