@yorha2b-lab/autodev 3.3.0 → 3.4.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@yorha2b-lab/autodev",
-  "version": "3.3.0",
+  "version": "3.4.0",
   "description": "基于视觉大模型的前端(react+Antd)全自动 CRUD 代码生成器",
   "bin": {
     "autodev": "bin/autodev.js"

package/src/prompts/react/watch-part.js

@@ -40,8 +40,9 @@ module.exports = `
 - 命名规范:
     - daterange: name 必须设为 '字段英文名start,字段英文名end'。
 - 增强属性:
-    - 必填校验: 若图片中 label 前有红色星号，必须加入 rules:[{required:true,message:'xxx不能为空'}]。
     - 文字单位: 若项末尾有单位（如 元/kg），必须存入 unit 属性。
+    - 尾操作: 若项末尾有操作按钮（如 选择、编辑 等操作），必须存入 {renderAction:true,addonAfter:'尾操作名'} 属性。
+    - 必填校验: 若图片中 label 前有红色星号，必须加入 rules:[{required:true,message:'xxx不能为空'}]。
 
 ## 3. 下拉选项字典 (OptionDict)
 - 结构: optionDict: { 字段英文名Options: [] }

package/templates/react/components/EditableCell.js

@@ -45,17 +45,17 @@ export const EditableRow = ({ index, record, ...props }) => {
  * 支持多种装配模式（text/number/select/checkbox），并具备“自动对焦”与“失焦自愈（自动保存）”功能。
  *
  * @param {Object} props - 构筑参数
- * @param {string} props.title - 零部件视觉标题，兼作占位符使用
+ * @param {Array} [props.rules=[]] - 逻辑校验准则
  * @param {Object} props.record - 当前行原始物资数据
- * @param {boolean} props.editable - 权限协议：是否允许开启编辑模式
  * @param {boolean} props.disabled - 物理锁定：是否禁止修改
+ * @param {string} props.title - 零部件视觉标题，兼作占位符使用
+ * @param {React.ReactNode} props.children - 默认展示的视觉节点
+ * @param {boolean} props.editable - 权限协议：是否允许开启编辑模式
  * @param {string} props.dataIndex - 逻辑寻址地址：对应后端数据的字段名
+ * @param {Array} [props.options=[]] - 数据字典（仅用于 select/checkbox）
  * @param {Function} props.handleSave - 物理封存协议：数据校验通过后的保存回调
  * @param {boolean} [props.defaultEdit] - 持久化模式：是否默认始终开启编辑状态
- * @param {Array} [props.rules=[]] - 逻辑校验准则
- * @param {Array} [props.options=[]] - 数据字典（仅用于 select/checkbox）
  * @param {string} [props.editType='text'] - 零部件型号（text/number/select/checkbox）
- * @param {React.ReactNode} props.children - 默认展示的视觉节点
  */
 export const EditableCell = ({ title, record, editable, disabled, children, dataIndex, placeholder, handleSave, defaultEdit, rules = [], options = [], editType = 'text', ...restProps }) => {
 

package/templates/react/components/MyBaseForm.js

@@ -63,9 +63,9 @@ const renderFormContent = ({ item, prefixName = [] }) => {
  *
  * @param {Object} props - 组件属性
  * @param {Object} props.item - 构筑协议对象
+ * @param {Object} props.form - Antd Form 实例，用于实现复杂的跨组件联动
  * @param {boolean} [props.item.isList] - 模式切换：是否开启动态增减列表模式
  * @param {Function} [props.item.render] - 逻辑劫持：支持自定义渲染函数，可完全改写渲染行为
- * @param {Object} props.form - Antd Form 实例，用于实现复杂的跨组件联动
  *
  * @example
  * // 模式 A：标准表单项
@@ -99,7 +99,7 @@ export const MyBaseForm = ({ item, form }) => {
                 tooltip={item.tooltip}
                 labelCol={item.labelCol}
                 wrapperCol={item.wrapperCol}
-                required={item.required ?? !!item.rules}
+                required={item.required ?? item.rules?.some(v => v.required)}
                 style={{ marginBottom: !item.name ? 0 : undefined, ...item.style }}
             >
                 {/*

package/templates/react/components/MyModalForm.js

@@ -1,7 +1,99 @@
 import dayjs from 'dayjs'
 import { MyBaseForm } from './MyBaseForm'
-import { useState, useEffect } from 'react'
-import { Row, Col, Form, Modal, } from 'antd'
+import { MyModalTable } from './MyModalTable'
+import { useMemo, useState, useEffect } from 'react'
+import { Row, Col, Form, Modal, Button, Collapse } from 'antd'
+
+const LAYOUT_PROCESSORS = {
+    // 分节布局
+    section: ({ item, children }) => (
+        <Col span={item.span ?? 24}>
+            <div className={item.className}>{item.title}</div>
+            <Row gutter={[24, 0]}>{children}</Row>
+        </Col>
+    ),
+    // 手风琴布局
+    collapse: ({ item, renderCore }) => (
+        <Col span={item.span ?? 24}>
+            <Collapse ghost accordion defaultActiveKey={[0]}>
+                {item.childItems?.map((child, ind) => (
+                    <Collapse.Panel key={child.name || ind} header={<span style={{ fontWeight: 'bold' }}>{child.title}</span>}>
+                        <Row gutter={[24, 0]}>
+                            {renderCore(child.childItems || [child])}
+                        </Row>
+                    </Collapse.Panel>
+                ))}
+            </Collapse>
+        </Col>
+    ),
+    default: ({ children }) => <>{children}</>
+}
+
+// 定义“零部件增强协议”处理器,以后加任何新功能，只需要在这个对象里加一个 Key，不需要动主逻辑！
+const ACTION_PROCESSORS = {
+    // 处理尾操作按钮
+    addonAfter: (item, { tableConfig, setModalTable, setSelectedTableRows }) => ({
+        props: {
+            addonAfter: (
+                <Button onClick={() => {
+                    setSelectedTableRows([])
+                    setModalTable({ visible: true, title: `选择${item.label}`, ...tableConfig[item.name] })
+                }}>
+                    {item.addonAfter}
+                </Button>
+            )
+        }
+    }),
+    // 以后想加个“前缀图标”？直接加在这里：
+    // prefix: (item) => ({ props: { prefix: <Icon type={item.prefix} /> } }),
+}
+
+const FormRenderer = ({ form, formItems, tableConfig, setModalTable, setSelectedTableRows }) => {
+
+    // 定义核心渲染逻辑，供递归使用
+    const renderCore = items => (
+        <FormRenderer
+            form={form}
+            formItems={items}
+            tableConfig={tableConfig}
+            setModalTable={setModalTable}
+            setSelectedTableRows={setSelectedTableRows}
+        />
+    )
+
+    // 定义单项动作注入逻辑
+    const getRenderItemProps = item => {
+        if (!item.renderAction) return {}
+        const props = {}
+        Object.keys(ACTION_PROCESSORS).forEach(key => {
+            if (item[key]) {
+                Object.assign(props, ACTION_PROCESSORS[key](item, { tableConfig, setModalTable, setSelectedTableRows }))
+            }
+        })
+        return props
+    }
+
+    return formItems.map((item, index) => {
+        // 情况 A：发现容器型零件 (含有 layoutType)
+        if (item.layoutType && LAYOUT_PROCESSORS[item.layoutType]) {
+            const Layout = LAYOUT_PROCESSORS[item.layoutType] ?? LAYOUT_PROCESSORS.default
+            return (
+                <Layout
+                    item={item}
+                    key={item.name || index}
+                    renderCore={renderCore} // 注入渲染能力，让 Layout 自己去 Map
+                />
+            )
+        }
+
+        // 情况 B：标准作战零件
+        return (
+            <Col span={item.span ?? 24} key={item.name || index}>
+                <MyBaseForm item={{ ...item, ...getRenderItemProps(item) }} form={form} />
+            </Col>
+        )
+    })
+}
 
 /**
  * @component MyModalForm
@@ -9,29 +101,42 @@ import { Row, Col, Form, Modal, } from 'antd'
  * 集成了“语义回显自愈”、“自动时间戳转换”及“原子级提交锁定”三大核心协议。
  *
  * @param {Object} props - 构筑参数
- * @param {string|number} [props.width] - 舱体物理宽度
  * @param {string} [props.title] - 舱体视觉标题
- * @param {Function} props.submit - 数据发射协议：提交表单后的核心回调函数
- * @param {Object} [props.record] - 初始物资包：用于编辑模式的数据回显
- * @param {boolean} props.visible - 激活信号：控制弹窗的物理显示状态
- * @param {Function} props.setModal - 指令中心：用于更新弹窗状态（开启/关闭）
- * @param {Array} props.formItems - 零部件清单：定义表单内部的输入单元
  * @param {Object} [props.labelCol] - 标签布局校准
  * @param {Object} [props.wrapperCol] - 控件布局校准
+ * @param {string|number} [props.width] - 舱体物理宽度
+ * @param {boolean} props.visible - 激活信号：控制弹窗的物理显示状态
+ * @param {Array} props.formItems - 零部件清单：定义表单内部的输入单元
+ * @param {Object} [props.record] - 初始物资包：用于编辑模式的数据回显
+ * @param {Function} props.submit - 数据发射协议：提交表单后的核心回调函数
+ * @param {Function} props.setModal - 指令中心：用于更新弹窗状态（开启/关闭）
  * @param {Function} [props.onValuesChange] - 联动传感：捕获表单内部的信号波动
  *
  * @example
  * <MyModalForm
  *   title="构筑新模块"
  *   visible={visible}
- *   formItems={[{ label: '截止日期', name: 'deadline', type: 'date' }]}
  *   submit={async (vals) => await save(vals)}
+ *   formItems={[{ label: '截止日期', name: 'deadline', type: 'date' }]}
  * />
  */
-export const MyModalForm = ({ width, title, submit, record, visible, setModal, labelCol, formItems, wrapperCol, onValuesChange }) => {
+export const MyModalForm = ({ width, title, submit, record, visible, setModal, labelCol, formItems, wrapperCol, tableConfig, onValuesChange, handleModalTableOk }) => {
+
+    const rowKey = tableConfig?.rowKey || 'id'
 
     const [form] = Form.useForm()
     const [pending, setPending] = useState(false)
+    const [modalTable, setModalTable] = useState({})
+    const [selectedTableRows, setSelectedTableRows] = useState([])
+
+    const flattenFormItems = items => {
+        return items.flatMap(item => {
+            if (item.layoutType && item.childItems) {
+                return flattenFormItems(item.childItems)
+            }
+            return item
+        })
+    }
 
     /**
      * @description [数据回显协议] 当构筑舱开启时，自动对初始物资进行“语义格式化”。
@@ -41,11 +146,11 @@ export const MyModalForm = ({ width, title, submit, record, visible, setModal, l
         if (visible) {
             form.resetFields()
             if (record && Object.keys(record).length > 0) {
-                const itemMap = new Map(formItems.map(i => [i.name, i]))
+                const itemMap = new Map(flattenFormItems(formItems).map(i => [i.name, i]))
                 const initialData = {}
                 Object.entries(record).forEach(([key, value]) => {
                     const config = itemMap.get(key)
-                    // 💡 语义识别：若零部件类型为日期且数值存在，执行物理转化
+                    // 语义识别：若零部件类型为日期且数值存在，执行物理转化
                     if (config?.type?.includes('date') && value) {
                         if (Array.isArray(value)) {
                             // 处理范围日期
@@ -91,13 +196,16 @@ export const MyModalForm = ({ width, title, submit, record, visible, setModal, l
             if (submit) {
                 setPending(true)
                 await submit({ ...record, ...formattedValues })
-                setPending(false)
             }
         } catch (error) {
             console.log('表单校验失败:', error)
+        } finally {
+            setPending(false)
         }
     }
 
+    const modalTableOk = () => handleModalTableOk({ form, selectedTableRows, setModalTable })
+
     /**
      * @function handleCancel
      * @description 执行“撤退协议”：关闭构筑舱并清除当前逻辑残留。
@@ -107,15 +215,17 @@ export const MyModalForm = ({ width, title, submit, record, visible, setModal, l
         form.resetFields()
     }
 
+    const tableRowSelection = useMemo(() => ({
+        selectedRowKeys: selectedTableRows.map(row => row[rowKey]),
+        onChange: (selectedRowKeys, selectedRows) => setSelectedTableRows(selectedRows),
+    }), [rowKey, modalTable, selectedTableRows])
+
     return (
         <Modal centered title={title} width={width} open={visible} onOk={handleOk} destroyOnClose onCancel={handleCancel} confirmLoading={pending}>
+            {modalTable.visible && <MyModalTable rowKey={rowKey} {...modalTable} rowSelection={tableRowSelection} onOk={modalTableOk} setModal={setModalTable} />}
             <Form form={form} preserve={false} labelCol={labelCol} wrapperCol={wrapperCol} onValuesChange={(changed, all) => onValuesChange?.({ changed, all, form, record })}>
                 <Row gutter={[24, 0]}>
-                    {formItems.map((item, index) =>
-                        <Col span={item.span ?? 24} key={item.name || index}>
-                            <MyBaseForm item={item} form={form} />
-                        </Col>
-                    )}
+                    <FormRenderer form={form} formItems={formItems} tableConfig={tableConfig} setModalTable={setModalTable} setSelectedTableRows={setSelectedTableRows} />
                 </Row>
             </Form>
         </Modal>

package/templates/react/components/MyModalTable.js

@@ -11,22 +11,22 @@ import { useTableQuery } from '../hooks/useTableQuery'
  * 具备独立的数据获取链路、可选的搜索过滤系统以及与主构筑舱（setModalForm）的跨维协同能力。
  *
  * @param {Object} props - 支援参数
- * @param {Function} props.api - 弹窗内独立的数据源指令
- * @param {Function} [props.onOk] - 战果物理确认：按下确认按钮后的异步回调协议
  * @param {string} [props.title] - 舱体视觉标题
+ * @param {Function} props.api - 弹窗内独立的数据源指令
  * @param {string|number} [props.width] - 舱体物理宽度
- * @param {React.ReactNode} [props.footer] - 底座指令区：支持完全自定义操作按钮
+ * @param {Object} [props.rowSelection] - 战术勾选：用于多选物资
  * @param {boolean} props.visible - 激活信号：控制支援单元的显示状态
- * @param {Function} props.operate - 动态火力配置：生成操作列的函数，接收 { refresh, setModalForm } 句柄
  * @param {Function} props.setModal - 单元注销中心：用于关闭当前弹窗
- * @param {Array} [props.formItems] - 局部搜索零部件：用于在弹窗内执行精准情报过滤
- * @param {Function} [props.setModalForm] - [重要] 跨维调用：由主页面注入的表单控制句柄，实现“弹窗开弹窗”的非耦合交互
- * @param {Object} [props.rowSelection] - 战术勾选：用于多选物资
- * @param {Function} props.formatResponse - 数据清洗协议：对 API 吐出的原始物资进行格式化
- * @param {Array} [props.functionButtons] - 功能挂件组：位于表格上方的操作按钮，可直接操控表格状态
  * @param {Array} props.columns - 零部件初始清单 (别名: modalColumns)
+ * @param {Function} [props.onOk] - 战果物理确认：按下确认按钮后的异步回调协议
  * @param {Object} [props.initialParams={}] - 初始战备物资：定义的初始搜索参数
+ * @param {React.ReactNode} [props.footer] - 底座指令区：支持完全自定义操作按钮
+ * @param {Array} [props.formItems] - 局部搜索零部件：用于在弹窗内执行精准情报过滤
+ * @param {Function} props.formatResponse - 数据清洗协议：对 API 吐出的原始物资进行格式化
  * @param {boolean|Object} [props.modalPagination=true] - 局部后勤协议：弹窗内是否开启分页
+ * @param {Array} [props.functionButtons] - 功能挂件组：位于表格上方的操作按钮，可直接操控表格状态
+ * @param {Function} props.operate - 动态火力配置：生成操作列的函数，接收 { refresh, setModalForm } 句柄
+ * @param {Function} [props.setModalForm] - [重要] 跨维调用：由主页面注入的表单控制句柄，实现“弹窗开弹窗”的非耦合交互
  *
  * @example
  * <MyModalTable
@@ -36,7 +36,7 @@ import { useTableQuery } from '../hooks/useTableQuery'
  *   operate={({ refresh, setModalForm }) => ({ label: '详情', onClick: (rec) => setModalForm(...) })}
  * />
  */
-export const MyModalTable = ({ api, onOk, title, width, footer, visible, operate, setModal, formItems, setModalForm, rowSelection, formatResponse, functionButtons, columns: modalColumns, initialParams = {}, modalPagination = true }) => {
+export const MyModalTable = ({ api, onOk, title, width, footer, visible, operate, setModal, formItems, setModalForm, rowSelection, formatResponse, functionButtons, columns: modalColumns, rowKey = 'id', initialParams = {}, modalPagination = true }) => {
 
     const [pending, setPending] = useState(false)
 
@@ -90,6 +90,7 @@ export const MyModalTable = ({ api, onOk, title, width, footer, visible, operate
             {functionButtons?.length > 0 && <Space>{functionButtons.map(item => <Button key={item.name} type={item.type} onClick={() => item.onClick({ refresh, setLoading, setSearch, setDataSource })}>{item.name}</Button>)}</Space>}
             <MyTable
                 total={total}
+                rowKey={rowKey}
                 search={search}
                 loading={loading}
                 scroll={{ y: 400 }}

package/templates/react/components/MySearchForm.js

@@ -10,25 +10,25 @@ import { Row, Col, Form, Button, Space } from 'antd'
  *
  * @param {Object} props - 指挥官指令包
  * @param {Object} props.form - Antd Form 实例，表单的主控舵盘
- * @param {Object} props.search - 当前的全局搜索状态（包含 pageNo, pageSize 及各过滤项）
- * @param {boolean} props.loading - 战场负载状态：请求中时锁定按钮，防止由于重复指令导致的逻辑冲突
- * @param {Function} props.setSearch - 状态分发器：用于更新全局搜索参数并触发重新构筑
+ * @param {Function} [props.customReset] - 逻辑劫持：自定义重置协议
+ * @param {Function} [props.customFinish] - 逻辑劫持：自定义提交协议
  * @param {Array} props.formItems - 零部件清单：定义所有的搜索输入单元
  * @param {number} [props.showLimit=7] - 初始可见能级：默认展示的零部件数量
+ * @param {number} [props.defaultPageSize=10] - 默认吞吐量：重置时的初始每页条数
+ * @param {Function} [props.onValuesChange] - 联动传感：当表单值变动时的即时反馈
  * @param {Object} props.initialValues - 初始信号：从 URL 或缓存中解析出的初始参数
- * @param {Function} [props.customReset] - 逻辑劫持：自定义重置协议
- * @param {Function} [props.customFinish] - 逻辑劫持：自定义提交协议
+ * @param {Function} props.setSearch - 状态分发器：用于更新全局搜索参数并触发重新构筑
+ * @param {Object} props.search - 当前的全局搜索状态（包含 pageNo, pageSize 及各过滤项）
  * @param {React.ReactNode} [props.extraOperate] - 额外挂件：在按钮区域注入自定义战术单元
- * @param {Function} [props.onValuesChange] - 联动传感：当表单值变动时的即时反馈
+ * @param {boolean} props.loading - 战场负载状态：请求中时锁定按钮，防止由于重复指令导致的逻辑冲突
  * @param {boolean} [props.syncUrlParams=true] - 物理同步开关：是否将搜索状态实时镜像至 URL 链接中
- * @param {number} [props.defaultPageSize=10] - 默认吞吐量：重置时的初始每页条数
  *
  * @example
  * <MySearchForm
  *   form={form}
  *   search={search}
- *   formItems={[{ label: '状态', name: 'status', type: 'select', options: [...] }]}
  *   setSearch={setSearch}
+ *   formItems={[{ label: '状态', name: 'status', type: 'select', options: [...] }]}
  * />
  */
 export const MySearchForm = ({ form, search, loading, labelCol, setSearch, formItems, showLimit = 7, initialValues, customReset, extraOperate, customFinish, onValuesChange, syncUrlParams = true, defaultPageSize = 10 }) => {
@@ -102,7 +102,7 @@ export const MySearchForm = ({ form, search, loading, labelCol, setSearch, formI
                     newValues[item.name] = item.type?.includes('date') ? dayjs(Number(value)) : value
                 }
                 // 处理双字段（日期范围）回显：执行物理重组
-                if (item.name.includes(',') && item.type?.includes('date')) {
+                if (item.name?.includes(',') && item.type?.includes('date')) {
                     const [startKey, endKey] = item.name.split(',')
                     if (initialValues[startKey] && initialValues[endKey]) {
                         newValues[item.name] = [dayjs(Number(initialValues[startKey])), dayjs(Number(initialValues[endKey]))]

package/templates/react/components/MyTable.js

@@ -8,31 +8,50 @@ import { useRef, useMemo, useEffect, useCallback } from 'react'
  * 它是地堡系统的“火力中心”，集成了行内编辑、自动滚动定位、动态分页协议及 Optimistic UI (乐观更新) 等工业级特性。
  *
  * @param {Object} props - 平台配置参数
- * @param {string} [props.size='middle'] - 视觉能级：表格的物理尺寸 (small/middle/large)
- * @param {Object} [props.query] - 侦察参数：包含 rowIndex 用于执行物理追踪定位
  * @param {number} props.total - 物资总量：用于构筑分页器的刻度
+ * @param {Object} [props.rowSelection] - 战术勾选：配置行选择逻辑
+ * @param {string} [props.rowKey='id'] - 唯一标识：每一行物资的数字指纹
+ * @param {boolean} [props.loading=false] - 战场负载状态：显示加载动画
+ * @param {Array} [props.dataSource=[]] - 物理物资包：表格展示的原始数据
  * @param {Object} props.search - 当前物流状态：包含 pageNo 和 pageSize
+ * @param {Object} [props.query] - 侦察参数：包含 rowIndex 用于执行物理追踪定位
  * @param {boolean} [props.autoScroll] - 视觉引导开关：是否开启自动滚动至目标行逻辑
+ * @param {Function} [props.lineFormChange] - 行级信号监听：捕获行内表单的实时变动
  * @param {Function} props.onChange - 战位协同回调：分页、排序、筛选变动时的通信协议
  * @param {boolean|Object} [props.pagination] - 分页配置：支持布尔开关或物理对象覆盖
- * @param {string|Function} [props.rowClassName] - 行视觉涂装：支持静态字符串或基于逻辑的动态类名
  * @param {Function} [props.customSave] - 物理封存协议：行内编辑保存后的外部持久化回调
- * @param {Function} props.setDataSource - 状态设置器：直接操作地堡的原始数据流（支持函数式更新）
- * @param {Function} [props.lineFormChange] - 行级信号监听：捕获行内表单的实时变动
  * @param {Array} props.columns - 零部件清单：定义列的构筑协议，支持 editType 等扩展属性
- * @param {Object} [props.rowSelection] - 战术勾选：配置行选择逻辑
- * @param {string} [props.rowKey='id'] - 唯一标识：每一行物资的数字指纹
- * @param {boolean} [props.loading=false] - 战场负载状态：显示加载动画
- * @param {Array} [props.dataSource=[]] - 物理物资包：表格展示的原始数据
  * @param {Object} [props.scroll={x:'max-content'}] - 滚动配置：默认开启横向物理溢出防护
+ * @param {string} [props.size='middle'] - 视觉能级：表格的物理尺寸 (small/middle/large)
+ * @param {Function} props.setDataSource - 状态设置器：直接操作地堡的原始数据流（支持函数式更新）
+ * @param {string|Function} [props.rowClassName] - 行视觉涂装：支持静态字符串或基于逻辑的动态类名
+ *
+ * @param {Object} [props.renderAction] - [后期物理绑定协议] 运行时逻辑注入仓库。
+ * @description
+ * 这是地堡系统的“黑客骇入”接口。
+ * 由于 resource.js 必须保持纯净的静态 JSON 格式以确保主权安全性，
+ * 凡是涉及“查看图片”、“跳转链接”等需要运行时函数支持的列，
+ * 统一通过该协议在渲染阶段执行“逻辑对冲”。
+ *
+ * @logic
+ * 1. 物理寻址：通过 col.dataIndex 锁定目标零部件位点。
+ * 2. 逻辑脱壳：删除临时标记字段 [renderAction: true]。
+ * 3. 语义注入：将 index.js 中定义的真实 Action 物理焊接到 columns.render 属性上。
  *
  * @example
+ * // 1. 在 resource.js 中标记：
+ * { title: '图片', dataIndex: 'imgUrl', renderAction: true }
+ *
+ * // 2. 在 index.js 中提供弹药：
  * <MyTable
+ *   total={100}
  *   columns={columns}
  *   dataSource={data}
- *   total={100}
  *   setDataSource={setData}
  *   customSave={(row) => saveApi(row)}
+ *   renderAction={{
+ *     imgUrl: (text, record) => <a onClick={() => showImg(record)}>查看物资</a>
+ *   }}
  * />
  */
 export const MyTable = ({ size, query, total, search, autoScroll, onChange, pagination, renderAction, rowClassName, customSave, setDataSource, lineFormChange, columns = [], rowSelection, rowKey = 'id', loading = false, dataSource = [], scroll = { x: 'max-content' }, ...restProps }) => {
@@ -82,7 +101,7 @@ export const MyTable = ({ size, query, total, search, autoScroll, onChange, pagi
     const mergedColumns = useMemo(() => {
         return columns.map(col => {
             if (!col.editType) {
-                if (col.renderAction && renderAction[col.dataIndex]) {
+                if (col.renderAction && renderAction?.[col.dataIndex]) {
                     return { ...col, render: renderAction[col.dataIndex] }
                 }
                 return col

package/templates/react/components/index.js

@@ -9,11 +9,11 @@ import { Button, Tree, Radio, Input, Upload, Select, Cascader, Checkbox, DatePic
  * 集成了“物理路径自动重组”、“STS 令牌自动续期”以及“ Antd 属性无损透传”三大核心协议。
  *
  * @param {Object} props - 构筑参数
+ * @param {string} [props.path] - 默认存储扇区：定义文件在云端的物理根路径
+ * @param {string} [props.url] - 司令部通信地址：用于申请最新的物理传输令牌 (STS)
  * @param {Array} props.value - 传感器当前封存的文件列表 (符合 Antd fileList 规范)
  * @param {Function} props.onChange - 状态反馈协议：当物理文件状态变更时同步至地堡中枢
  * @param {Object} [props.oss] - 外部空投的初始凭证包。若缺失，组件将启动自主初始化流程。
- * @param {string} [props.url] - 司令部通信地址：用于申请最新的物理传输令牌 (STS)
- * @param {string} [props.path] - 默认存储扇区：定义文件在云端的物理根路径
  * @param {Object} [props.options] - 通信加密/配置参数：在申请令牌时透传给 request 的额外负载
  * @param {Object} [props.originUploadProps] - [重要] 无损透传：支持 Antd Upload 的所有原生属性（如 multiple, accept 等）
  *
@@ -81,7 +81,7 @@ const AliyunOSSUpload = ({ value, onChange, ...restProps }) => {
      */
     const beforeUpload = async file => {
         let currentOSS = OSSData
-        const expire = Number(OSSData.expire) * 1000
+        const expire = Number(OSSData?.expire ?? 0) * 1000
         if (expire < Date.now()) {
             currentOSS = await init()
         }
@@ -119,12 +119,12 @@ const AliyunOSSUpload = ({ value, onChange, ...restProps }) => {
  *
  * @param {Object} params - 装配参数
  * @param {Object} params.item - 零部件配置对象
- * @param {string} params.item.type - 构筑类型（date/number/ossUpload/select/daterange 等）
- * @param {boolean} [params.item.readOnly] - 物理锁定开关
  * @param {string|number} [params.item.width] - 宽度校准
+ * @param {boolean} [params.item.readOnly] - 物理锁定开关
  * @param {string} [params.item.placeholder] - 视觉占位提示
- * @param {Array} [params.item.options] - 数据字典（用于 select/radio/tree 等）
  * @param {Object} [params.item.props] - 透传给底层组件的原始控制参数
+ * @param {Array} [params.item.options] - 数据字典（用于 select/radio/tree 等）
+ * @param {string} params.item.type - 构筑类型（date/number/ossUpload/select/daterange 等）
  *
  * @returns {React.ReactNode} 物理装配完成的 UI 单元
  */

package/templates/react/hooks/useTableQuery.js

@@ -6,21 +6,21 @@ import { useRef, useState, useEffect, useCallback } from 'react'
  * 负责全自动管理表格的生命周期，包括数据抓取、状态同步、动态列指纹识别及“竞态病毒”物理免疫。
  *
  * @param {Object} params - 引擎配置包
- * @param {Function} params.api - 任务指令：必须返回 Promise 的数据抓取函数
  * @param {Array} [params.cols] - 初始战备物资：前端预设的静态列配置
+ * @param {Function} params.api - 任务指令：必须返回 Promise 的数据抓取函数
  * @param {Object} [params.initialParams={}] - 初始导航坐标：包含 pageNo, pageSize 及默认过滤参数
  * @param {Function} params.formatResponse - 数据解码协议：将 API 原始信号转化为 { data, total, columns } 结构
  *
  * @returns {Object} 物理操作句柄包
  * @returns {number} .total - 仓库物资总量
- * @returns {Array} .columns - 当前生效的动态列配置（已通过指纹协议校验）
  * @returns {boolean} .loading - 引擎负载状态
- * @returns {Array} .dataSource - 已解压的物理物资列表
- * @returns {Object} .search - 当前导航参数（pageNo, pageSize 等）
  * @returns {Function} .setSearch - 坐标修改器
+ * @returns {Array} .dataSource - 已解压的物理物资列表
  * @returns {Function} .setLoading - 负载状态手动干预句柄
- * @returns {Function} .setDataSource - 物资流手动修改句柄（用于行内编辑等乐观更新）
+ * @returns {Object} .search - 当前导航参数（pageNo, pageSize 等）
  * @returns {Function} .refresh - 强制重启协议：立即执行一次数据抓取
+ * @returns {Array} .columns - 当前生效的动态列配置（已通过指纹协议校验）
+ * @returns {Function} .setDataSource - 物资流手动修改句柄（用于行内编辑等乐观更新）
  *
  * @example
  * const { dataSource, loading, refresh } = useTableQuery({

package/templates/react/utils/utils.js

@@ -51,8 +51,8 @@ export const initOSS = async (url, options) => {
 /**
  * @function formatQuery
  * @description [数据脱水] 搜索参数校准协议：根据零部件类型（如日期）自动执行类型转换（String -> Number）。
- * @param {Object} params - 原始表单/URL 传感器数据
  * @param {Array} formItems - 对应的零部件配置清单
+ * @param {Object} params - 原始表单/URL 传感器数据
  * @returns {Object} 经过物理清洗、可直接用于 API 请求的参数包
  */
 export const formatQuery = (params, formItems) => {
@@ -96,9 +96,9 @@ export const timeRender = ({ time, date, minute }) => {
  * @description [物资外运] 数据表格导出协议：支持复杂的渲染逻辑回溯，将页面数据封存为 .xlsx 格式。
  * @param {string} url - 数据源地址
  * @param {Object} options - 请求参数
- * @param {Array} columns - 表格列配置，支持 exportRender 优先级
  * @param {string} fileName - 导出的文件名
  * @param {Function} [formatter] - 数据预处理回调
+ * @param {Array} columns - 表格列配置，支持 exportRender 优先级
  */
 export const exportDataToExcel = async (url, options, columns, fileName, formatter) => {
     /* const response = await request(url, options)
@@ -216,8 +216,8 @@ export const moneyRender = (value, { decimals = 2, currency = 'CNY', language =
  * @description [视觉渲染] 单位自动进阶协议：实现 B/KB/MB... 等数据的物理量级自动折算。
  * @param {number} value - 原始字节数值
  * @param {Object} [options] - 配置参数
- * @param {number} [options.k=1024] - 进位系数
  * @param {Array} [options.units] - 单位阶梯
+ * @param {number} [options.k=1024] - 进位系数
  * @param {number} [options.decimals=2] - 保留小数位
  * @returns {string} 带单位的物理量级文本
  */