refactor(代码生成器): 优化模板文件格式和类型检查逻辑

style: 统一代码格式并移除多余空行
fix(前端): 修复富文本编辑器在详情页的显示问题
feat(前端): 为代码编辑器添加主题切换功能
docs: 更新README中的命令说明

backend/app/api/v1/module_generator/gencode/templates/python/model.py.j2

@@ -16,7 +16,6 @@ class {{ class_name }}Model(CreatorMixin):
     """
     {{ function_name }}表
     """
-    
     __tablename__ = '{{ table_name }}'
     __table_args__ = {'comment': '{{ function_name }}'}
     __loader_options__ = ["creator"]

backend/app/api/v1/module_generator/gencode/templates/python/param.py.j2

@@ -15,13 +15,11 @@ class {{ class_name }}QueryParam:
         {{ column.column_name }}: Optional[{{ column.python_type }}] = Query(None, description="{{ column.column_comment }}"),
         {% endif %}
         {% endfor %}
-
         {% for column in columns %}
-        {% if column.column_name == 'EQ' %}
+        {% if column.query_type == 'EQ' %}
         {{ column.column_name }}: Optional[{{ column.python_type }}] = Query(None, description="{{ column.column_comment }}"),
         {% endif %}
         {% endfor %}
-
         creator: Optional[int] = Query(None, description="创建人"),
         start_time: Optional[DateTimeStr] = Query(None, description="开始时间", example="2025-01-01 00:00:00"),
         end_time: Optional[DateTimeStr] = Query(None, description="结束时间", example="2025-12-31 23:59:59"),

backend/app/api/v1/module_generator/gencode/templates/python/schema.py.j2

@@ -13,7 +13,6 @@ class {{ class_name }}CreateSchema(BaseModel):
     """
     {{ function_name }}新增模型
     """
-
     {% for column in columns %}
     {% if column.column_name not in ['id', 'creator_id', 'created_at', 'updated_at'] %}
     {{ column.column_name }}: Optional[{{ column.python_type }}] = Field(default=None, description='{{ column.column_comment }}')

backend/app/api/v1/module_generator/gencode/templates/sql/sql.sql.j2

@@ -4,10 +4,8 @@
 {% set b_true = 1 if db_type == 'mysql' else true %}
 {% set b_false = 0 if db_type == 'mysql' else false %}
 {% set order_col = '`order`' if db_type == 'mysql' else '"order"' %}
-
 {# 公共字段列表（按实际库字段） #}
 {# name, type, order, status, permission, icon, route_name, route_path, component_path, redirect, hidden, keep_alive, always_show, title, params, affix, parent_id, description, created_at, updated_at #}
-
 {% if db_type == 'mysql' %}
 -- 父菜单（类型=2：菜单）
 INSERT INTO `system_menu` (name, type, {{ order_col }}, status, permission, icon, route_name, route_path, component_path, redirect, hidden, keep_alive, always_show, title, params, affix, parent_id, description, created_at, updated_at)

backend/app/api/v1/module_generator/gencode/templates/ts/api.ts.j2

@@ -92,9 +92,10 @@ export default {{ class_name }}API;
 // TS 类型声明
 // ------------------------------
 
+// 列表查询参数
 export interface {{ class_name }}PageQuery extends PageQuery {
   {% for column in columns %}
-  {% if column.is_query == "1" and column.query_type != "BETWEEN" %}
+  {% if column.is_query and column.column != "BETWEEN" %}
   {{ column.python_field }}?: {{
     'boolean' if ('status' in (column.python_field|lower)) or (column.html_type == 'radio')
     else 'number' if column.is_pk == '1'
@@ -102,29 +103,30 @@ export interface {{ class_name }}PageQuery extends PageQuery {
   }};
   {% endif %}
   {% endfor %}
-  // 时间范围查询（按示例统一字段名，如需按字段拆分可在页面层处理）
   start_time?: string;
   end_time?: string;
 }
 
+// 列表查询结果
 export interface {{ class_name }}Table {
+  index?: number;
   {% for column in columns %}
   {{ column.python_field }}?: {{
     'boolean' if ('status' in (column.python_field|lower)) or (column.html_type == 'radio')
-    else 'number' if column.is_pk == '1'
+    else 'number' if column.is_pk == 1
     else 'string'
   }};
   {% endfor %}
   creator?: creatorType;
 }
 
+// 新增/修改/详情表单参数
 export interface {{ class_name }}Form {
-  id?: number;
   {% for column in columns %}
-  {% if column.is_insert == "1" or column.is_edit == "1" %}
+  {% if (column.is_insert == 1 or column.is_edit == 1) and column.python_field not in ['creatorId', 'createdAt', 'updatedAt'] %}
   {{ column.python_field }}?: {{
     'boolean' if ('status' in (column.python_field|lower)) or (column.html_type == 'radio')
-    else 'number' if column.is_pk == '1'
+    else 'number' if column.is_pk == 1
     else 'string'
   }};
   {% endif %}

backend/app/api/v1/module_generator/gencode/templates/vue/index.vue.j2

@@ -4,34 +4,33 @@
     <div v-show="visible" class="search-container">
       <el-form ref="queryFormRef" :model="queryFormData" label-suffix=":" :inline="true" @submit.prevent="handleQuery">
         {% for column in columns %}
-          {% if column.is_query == "1" %}
-            {% set dict_type = column.dict_type %}
-            {% set column_comment = column.column_comment if column.column_comment else '' %}
-            {% set parentheseIndex = column_comment.find("（") %}
-            {% set comment = column_comment[:parentheseIndex] if parentheseIndex != -1 else column_comment %}
-
-            {% if column.html_type == "input" %}
-              <el-form-item label="{{ comment }}" prop="{{ column.python_field }}">
-                <el-input v-model="queryFormData.{{ column.python_field }}" placeholder="请输入{{ comment }}" clearable />
-              </el-form-item>
-            {% elif (column.html_type == "select" or column.html_type == "radio") and dict_type != "" %}
-              <el-form-item label="{{ comment }}" prop="{{ column.python_field }}">
-                <el-select v-model="queryFormData.{{ column.python_field }}" placeholder="请选择{{ comment }}" style="width: 180px" clearable>
-                  <el-option v-for="dict in dictStore.getDictArray('{{ dict_type }}')" :key="dict.dict_value" :label="dict.dict_label" :value="dict.dict_value" />
-                </el-select>
-              </el-form-item>
-            {% elif (column.html_type == "select" or column.html_type == "radio") and dict_type %}
-              <el-form-item label="{{ comment }}" prop="{{ column.python_field }}">
-                <el-select v-model="queryFormData.{{ column.python_field }}" placeholder="请选择{{ comment }}" clearable>
-                  <el-option label="请选择字典生成" value="" />
-                </el-select>
-              </el-form-item>
-            {% elif column.html_type == "datetime" and column.query_type != "BETWEEN" %}
-              <el-form-item label="{{ comment }}" prop="{{ column.python_field }}">
-                <el-date-picker v-model="queryFormData.{{ column.python_field }}" type="date" value-format="YYYY-MM-DD" clearable placeholder="请选择{{ comment }}" />
-              </el-form-item>
-            {% endif %}
-          {% endif %}
+        {% if column.is_query == 1 %}
+        {% set dict_type = column.dict_type %}
+        {% set column_comment = column.column_comment if column.column_comment else '' %}
+        {% set parentheseIndex = column_comment.find("（") %}
+        {% set comment = column_comment[:parentheseIndex] if parentheseIndex != -1 else column_comment %}
+        {% if column.html_type == "input" %}
+        <el-form-item label="{{ comment }}" prop="{{ column.python_field }}">
+          <el-input v-model="queryFormData.{{ column.python_field }}" placeholder="请输入{{ comment }}" clearable />
+        </el-form-item>
+        {% elif (column.html_type == "select" or column.html_type == "radio") and dict_type != "" %}
+        <el-form-item label="{{ comment }}" prop="{{ column.python_field }}">
+          <el-select v-model="queryFormData.{{ column.python_field }}" placeholder="请选择{{ comment }}" style="width: 180px" clearable>
+            <el-option v-for="dict in dictStore.getDictArray('{{ dict_type }}')" :key="dict.dict_value" :label="dict.dict_label" :value="dict.dict_value" />
+          </el-select>
+        </el-form-item>
+        {% elif (column.html_type == "select" or column.html_type == "radio") and dict_type %}
+        <el-form-item label="{{ comment }}" prop="{{ column.python_field }}">
+          <el-select v-model="queryFormData.{{ column.python_field }}" placeholder="请选择{{ comment }}" clearable>
+            <el-option label="请选择字典生成" value="" />
+          </el-select>
+        </el-form-item>
+        {% elif column.html_type == "datetime" and column.query_type != "BETWEEN" %}
+        <el-form-item label="{{ comment }}" prop="{{ column.python_field }}">
+          <el-date-picker v-model="queryFormData.{{ column.python_field }}" type="date" value-format="YYYY-MM-DD" clearable placeholder="请选择{{ comment }}" />
+        </el-form-item>
+        {% endif %}
+        {% endif %}
         {% endfor %}
         <!-- 可选：创建人选择与统一日期范围（展开后显示） -->
         <el-form-item v-if="isExpand" prop="creator" label="创建人">
@@ -156,23 +155,23 @@
           </template>
         </el-table-column>
         {% for column in columns %}
-          {% set python_field = column.python_field %}
-          {% set column_comment = column.column_comment if column.column_comment else '' %}
-          {% set parentheseIndex = column_comment.find("（") %}
-          {% set comment = column_comment[:parentheseIndex] if parentheseIndex != -1 else column_comment %}
-          {% if column.is_list == "1" %}
-            <el-table-column v-if="tableColumns.find((col) => col.prop === '{{ python_field }}')?.show" label="{{ comment }}" prop="{{ python_field }}" min-width="140">
-              {% if python_field == "status" %}
-                <template #default="scope">
-                  <el-tag :type="scope.row.status ? 'success' : 'info'">{{ '{{' }} scope.row.status ? '启用' : '停用' {{ '}}' }}</el-tag>
-                </template>
-              {% elif python_field == "creator" %}
-                <template #default="scope">
-                  <el-tag>{{ '{{' }} scope.row.creator?.name {{ '}}' }}</el-tag>
-                </template>
-              {% endif %}
-            </el-table-column>
-          {% endif %}
+        {% set python_field = column.python_field %}
+        {% set column_comment = column.column_comment if column.column_comment else '' %}
+        {% set parentheseIndex = column_comment.find("（") %}
+        {% set comment = column_comment[:parentheseIndex] if parentheseIndex != -1 else column_comment %}
+        {% if column.is_list == 1 %}
+        <el-table-column v-if="tableColumns.find((col) => col.prop === '{{ python_field }}')?.show" label="{{ comment }}" prop="{{ python_field }}" min-width="140">
+        {% if python_field == "status" %}
+          <template #default="scope">
+            <el-tag :type="scope.row.status ? 'success' : 'info'">{{ '{{' }} scope.row.status ? '启用' : '停用' {{ '}}' }}</el-tag>
+          </template>
+        {% elif python_field == "creator" %}
+          <template #default="scope">
+            <el-tag>{{ '{{' }} scope.row.creator?.name {{ '}}' }}</el-tag>
+          </template>
+        {% endif %}
+        </el-table-column>
+        {% endif %}
         {% endfor %}
         <el-table-column v-if="tableColumns.find(col => col.prop === 'operation')?.show" fixed="right" label="操作" align="center" min-width="180">
           <template #default="scope">
@@ -209,58 +208,57 @@
       <template v-else>
         <el-form ref="dataFormRef" :model="formData" :rules="rules" label-suffix=":" label-width="auto" label-position="right">
           {% for column in columns %}
-            {% if column.is_insert == "1" or column.is_edit == "1" %}
-              {% set dict_type = column.dict_type %}
-              {% set column_comment = column.column_comment if column.column_comment else '' %}
-              {% set parentheseIndex = column_comment.find("（") %}
-              {% set comment = column_comment[:parentheseIndex] if parentheseIndex != -1 else column_comment %}
-              {% set required = 'true' if column.is_nullable == '1' else 'false' %}
-
-              {% if column.python_field == "status" %}
-                <el-form-item label="状态" prop="status" :required="true">
-                  <el-radio-group v-model="formData.status">
-                    <el-radio :value="true">启用</el-radio>
-                    <el-radio :value="false">停用</el-radio>
-                  </el-radio-group>
-                </el-form-item>
-              {% elif column.html_type == "input" %}
-                <el-form-item label="{{ comment }}" prop="{{ column.python_field }}" :required="{{ required }}">
-                  <el-input v-model="formData.{{ column.python_field }}" placeholder="请输入{{ comment }}" />
-                </el-form-item>
-              {% elif column.html_type == "textarea" %}
-                <el-form-item label="{{ comment }}" prop="{{ column.python_field }}" :required="{{ required }}">
-                  <el-input v-model="formData.{{ column.python_field }}" type="textarea" placeholder="请输入{{ comment }}" rows="4" />
-                </el-form-item>
-              {% elif (column.html_type == "select" or column.html_type == "radio") and dict_type != "" %}
-                <el-form-item label="{{ comment }}" prop="{{ column.python_field }}" :required="{{ required }}">
-                  <el-select v-model="formData.{{ column.python_field }}" placeholder="请选择{{ comment }}">
-                    <el-option v-for="dict in dictStore.getDictArray('{{ dict_type }}')" :key="dict.dict_value" :label="dict.dict_label" :value="dict.dict_value" />
-                  </el-select>
-                </el-form-item>
-              {% elif (column.html_type == "select" or column.html_type == "radio") and dict_type %}
-                <el-form-item label="{{ comment }}" prop="{{ column.python_field }}" :required="{{ required }}">
-                  <el-select v-model="formData.{{ column.python_field }}" placeholder="请选择{{ comment }}">
-                    <el-option label="请选择字典生成" value="" />
-                  </el-select>
-                </el-form-item>
-              {% elif column.html_type == "date" %}
-                <el-form-item label="{{ comment }}" prop="{{ column.python_field }}" :required="{{ required }}">
-                  <el-date-picker v-model="formData.{{ column.python_field }}" type="date" value-format="YYYY-MM-DD" placeholder="请选择{{ comment }}" />
-                </el-form-item>
-              {% elif column.html_type == "datetime" %}
-                <el-form-item label="{{ comment }}" prop="{{ column.python_field }}" :required="{{ required }}">
-                  <el-date-picker v-model="formData.{{ column.python_field }}" type="datetime" value-format="YYYY-MM-DD HH:mm:ss" placeholder="请选择{{ comment }}" />
-                </el-form-item>
-              {% elif column.html_type == "checkbox" %}
-                <el-form-item label="{{ comment }}" prop="{{ column.python_field }}">
-                  <el-checkbox v-model="formData.{{ column.python_field }}">{{ comment }}</el-checkbox>
-                </el-form-item>
-              {% elif column.html_type == "imageUpload" %}
-                <el-form-item label="{{ comment }}" prop="{{ column.python_field }}">
-                  <SingleImageUpload v-model="formData.{{ column.python_field }}" />
-                </el-form-item>
-              {% endif %}
-            {% endif %}
+          {% if column.is_insert == 1 or column.is_edit == 1 %}
+          {% set dict_type = column.dict_type %}
+          {% set column_comment = column.column_comment if column.column_comment else '' %}
+          {% set parentheseIndex = column_comment.find("（") %}
+          {% set comment = column_comment[:parentheseIndex] if parentheseIndex != -1 else column_comment %}
+          {% set required = 'true' if column.is_nullable == '1' else 'false' %}
+          {% if column.python_field == "status" %}
+          <el-form-item label="状态" prop="status" :required="true">
+            <el-radio-group v-model="formData.status">
+              <el-radio :value="true">启用</el-radio>
+              <el-radio :value="false">停用</el-radio>
+            </el-radio-group>
+          </el-form-item>
+          {% elif column.html_type == "input" %}
+          <el-form-item label="{{ comment }}" prop="{{ column.python_field }}" :required="{{ required }}">
+            <el-input v-model="formData.{{ column.python_field }}" placeholder="请输入{{ comment }}" />
+          </el-form-item>
+          {% elif column.html_type == "textarea" %}
+          <el-form-item label="{{ comment }}" prop="{{ column.python_field }}" :required="{{ required }}">
+            <el-input v-model="formData.{{ column.python_field }}" type="textarea" placeholder="请输入{{ comment }}" rows="4" />
+          </el-form-item>
+          {% elif (column.html_type == "select" or column.html_type == "radio") and dict_type != "" %}
+          <el-form-item label="{{ comment }}" prop="{{ column.python_field }}" :required="{{ required }}">
+            <el-select v-model="formData.{{ column.python_field }}" placeholder="请选择{{ comment }}">
+              <el-option v-for="dict in dictStore.getDictArray('{{ dict_type }}')" :key="dict.dict_value" :label="dict.dict_label" :value="dict.dict_value" />
+            </el-select>
+          </el-form-item>
+          {% elif (column.html_type == "select" or column.html_type == "radio") and dict_type %}
+          <el-form-item label="{{ comment }}" prop="{{ column.python_field }}" :required="{{ required }}">
+            <el-select v-model="formData.{{ column.python_field }}" placeholder="请选择{{ comment }}">
+              <el-option label="请选择字典生成" value="" />
+            </el-select>
+          </el-form-item>
+          {% elif column.html_type == "date" %}
+          <el-form-item label="{{ comment }}" prop="{{ column.python_field }}" :required="{{ required }}">
+            <el-date-picker v-model="formData.{{ column.python_field }}" type="date" value-format="YYYY-MM-DD" placeholder="请选择{{ comment }}" />
+          </el-form-item>
+          {% elif column.html_type == "datetime" %}
+          <el-form-item label="{{ comment }}" prop="{{ column.python_field }}" :required="{{ required }}">
+            <el-date-picker v-model="formData.{{ column.python_field }}" type="datetime" value-format="YYYY-MM-DD HH:mm:ss" placeholder="请选择{{ comment }}" />
+          </el-form-item>
+          {% elif column.html_type == "checkbox" %}
+          <el-form-item label="{{ comment }}" prop="{{ column.python_field }}">
+            <el-checkbox v-model="formData.{{ column.python_field }}">{{ comment }}</el-checkbox>
+          </el-form-item>
+          {% elif column.html_type == "imageUpload" %}
+          <el-form-item label="{{ comment }}" prop="{{ column.python_field }}">
+            <SingleImageUpload v-model="formData.{{ column.python_field }}" />
+          </el-form-item>
+          {% endif %}
+          {% endif %}
           {% endfor %}
         </el-form>
       </template>
@@ -339,7 +337,7 @@ const tableColumns = ref([
   { prop: 'selection', label: '选择框', show: true },
   { prop: 'index', label: '序号', show: true },
   {% for column in columns %}
-  {% if column.is_list == "1" %}
+  {% if column.is_list == 1 %}
   { prop: '{{ column.python_field }}', label: '{{ column.column_comment or column.python_field }}', show: true },
   {% endif %}
   {% endfor %}
@@ -349,7 +347,7 @@ const tableColumns = ref([
 // 导出列（不含选择/序号/操作）
 const exportColumns = [
   {% for column in columns %}
-  {% if column.is_list == "1" %}
+  {% if column.is_list == 1 %}
   { prop: '{{ column.python_field }}', label: '{{ column.column_comment or column.python_field }}' },
   {% endif %}
   {% endfor %}
@@ -391,7 +389,7 @@ const dialogVisible = reactive({
 const formData = reactive<{{ class_name }}Form>({
   id: undefined,
   {% for column in columns %}
-  {% if column.is_insert == "1" or column.is_edit == "1" %}
+  {% if column.is_insert == 1 or column.is_edit == 1 %}
   {{ column.python_field }}: undefined,
   {% endif %}
   {% endfor %}
@@ -401,7 +399,7 @@ const formData = reactive<{{ class_name }}Form>({
 const initialFormData: {{ class_name }}Form = {
   id: undefined,
   {% for column in columns %}
-  {% if column.is_insert == "1" or column.is_edit == "1" %}
+  {% if column.is_insert == 1 or column.is_edit == 1 %}
   {{ column.python_field }}: {{ 'true' if column.python_field == 'status' else ('' if column.html_type == 'textarea' else 'undefined') }},
   {% endif %}
   {% endfor %}
@@ -420,8 +418,8 @@ async function resetForm() {
 // 表单验证规则（必填项按 is_nullable 生成）
 const rules = reactive({
   {% for column in columns %}
-  {% if column.is_insert == "1" or column.is_edit == "1" %}
-  {% set required = 'true' if column.is_nullable == '1' else 'false' %}
+  {% if column.is_insert == 1 or column.is_edit == 1 %}
+  {% set required = 'true' if column.is_nullable == 1 else 'false' %}
   {{ column.python_field }}: [
     { required: {{ required }}, message: '请输入{{ column.column_comment or column.python_field }}', trigger: 'blur' },
   ],
@@ -451,7 +449,7 @@ const queryFormData = reactive<{{ class_name }}PageQuery>({
   page_no: 1,
   page_size: 10,
   {% for column in columns %}
-  {% if column.is_query == "1" and column.query_type != "BETWEEN" %}
+  {% if column.is_query == 1 and column.query_type != "BETWEEN" %}
   {{ column.python_field }}: undefined,
   {% endif %}
   {% endfor %}