feat(table): 列筛选显隐按页记忆，卡片设置入口移至左侧工具栏

- 列筛选面板勾选状态按页 localStorage 记忆，刷新后表格/卡片两侧一致恢复
- 卡片设置按钮由右侧图标区移至左侧操作按钮区，面板向下展开不再超出视口
- 入口改按钮直绑点击并抽出 toggleCardSettingPanel 复用，不再走 defaultToolbar 注入

.agents/skills/ulthon-card-template/SKILL.md

@@ -279,7 +279,7 @@ layoutDefault: 'goodscard',
 
 - 操作按钮配置对象自 commit 53ee2e3 起有拷贝保护（渲染函数对配置只读）：自定义按钮的 class/method 不会被渲染过程污染，形态反复切换后按钮样式与 URL 拼接保持稳定。这是已修复的历史坑：修复前的版本存在"切换形态后按钮 class 丢失、URL 滚雪球"的缺陷，老版本升级后若仍见此症状先确认包含 53ee2e3。
 - 形态切换零请求，但 switch 开关切换不是：点击开关会触发 modify 提交加一次列表重查（各 1 个 XHR），这是框架标准链路，验收时勿与"切换零请求"混淆。
-- 卡片字段清单实时跟随列显隐：列筛选面板隐藏/恢复列后，卡片形态自动重渲（colToggled 监听 + store 当页数据零请求重渲），隐藏列不产出 `_cells` 对应键，模板侧无需规避。
+- 卡片字段清单实时跟随列显隐：列筛选面板隐藏/恢复列后，卡片形态自动重渲（colToggled 监听 + store 当页数据零请求重渲），隐藏列不产出 `_cells` 对应键，模板侧无需规避。显隐状态按页 localStorage 记忆，刷新保持。
 
 ## 八、验收 checklist
 

public/static/admin/css/public.css

@@ -903,8 +903,28 @@ table样式
   color: rgb(22, 183, 119);
 }
 
+/* 卡片设置面板（admin-table.js toggleCardSettingPanel 产出；面板骨架复用上方
+   .ul-nav-block 基类，此处补面板本体定位与视觉（与 .table-tpl-container 视图
+   切换下拉同语言）、配置行与自绘开关）。入口按钮 .ua-card-setting-btn 由受控
+   接线追加至左侧工具栏容器 .layui-table-tool-temp 末尾，position:relative 供
+   面板相对按钮向下展开锚定；按钮不带 lay-event，点击直调开关函数 */
+.ua-card-setting-btn {
+  position: relative;
+  margin-left: 10px;
+}
+
 .ua-card-setting-panel {
+  position: absolute;
+  left: 0;
+  top: 100%;
+  z-index: 999;
   min-width: 200px;
+  border: 1px solid #d2d2d2;
+  background-color: #fff;
+  box-shadow: 0 2px 4px rgba(0, 0, 0, 0.12);
+  white-space: nowrap;
+  overflow-y: auto;
+  text-align: left;
 }
 
 .ua-card-setting-title {

public/static/admin/css/public.scss

@@ -926,10 +926,28 @@ table样式
     }
 }
 
-// 卡片设置面板（admin-table.js listenToolbar case 'TABLE_CARD_SETTING' 产出；
-// 面板骨架复用上方 .ul-nav-block 基类，此处只补面板本体、配置行与自绘开关）
+// 卡片设置面板（admin-table.js toggleCardSettingPanel 产出；面板骨架复用上方
+// .ul-nav-block 基类，此处补面板本体定位与视觉（与 .table-tpl-container 视图
+// 切换下拉同语言）、配置行与自绘开关）。入口按钮 .ua-card-setting-btn 由受控
+// 接线追加至左侧工具栏容器 .layui-table-tool-temp 末尾，position:relative 供
+// 面板相对按钮向下展开锚定；按钮不带 lay-event，点击直调开关函数
+.ua-card-setting-btn {
+    position: relative;
+    margin-left: 10px;
+}
+
 .ua-card-setting-panel {
+    position: absolute;
+    left: 0;
+    top: 100%;
+    z-index: 999;
     min-width: 200px;
+    border: 1px solid #d2d2d2;
+    background-color: #fff;
+    box-shadow: 0 2px 4px rgba(0, 0, 0, .12);
+    white-space: nowrap;
+    overflow-y: auto;
+    text-align: left;
 }
 
 .ua-card-setting-title {

public/static/plugs/ulthon-admin/admin-table.js

@@ -362,7 +362,7 @@
 
     // 形态可见性同步：引擎数据区（表头+表体+合计行）与模板容器互斥显隐，
     // 引擎视图的工具栏（刷新/新增/批量删除等）两形态共用保持可见（print 与
-    // 卡片设置图标除外，随形态互斥显隐），搜索区本就挂在表格元素之前不受影响。
+    // 卡片设置按钮除外，随形态互斥显隐），搜索区本就挂在表格元素之前不受影响。
     // 非 table 形态下引擎根本不渲染行数据
     // （wrapper 非 table 分支不走引擎渲染），并非旧寄生实现"引擎恒渲+CSS 隐藏"。
     var syncLayoutVisibility = function (tableId) {
@@ -386,7 +386,104 @@
         // 工具栏形态联动：print 仅表格形态有意义；卡片设置仅非表格形态有意义。
         // filter（LAYTABLE_COLS）与视图切换（TABLE_LAYOUT）两形态常驻不动
         $view.find('[lay-event="LAYTABLE_PRINT"]').toggleClass('layui-hide', !isTable);
-        $view.find('[lay-event="TABLE_CARD_SETTING"]').toggleClass('layui-hide', isTable);
+        $view.find('.ua-card-setting-btn').toggleClass('layui-hide', isTable);
+    };
+
+    // 卡片设置面板开关（pro#5 迭代：入口由右侧图标区移至左侧工具栏末尾的
+    // .ua-card-setting-btn 按钮，点击直调本函数；不再走 layui toolbar 事件）。
+    // 含面板创建/移除/开关/排序/外点收起全套逻辑，面板 append 在按钮元素内
+    //（按钮 position:relative，面板向右向下展开），面板内交互均阻断冒泡
+    var toggleCardSettingPanel = function (tableId) {
+        var cardSettingId = 'ua-card-setting-' + tableId;
+        var $toolbarSettingElem = $(controlledLayouts[tableId].elem).siblings('.layui-table-view').first().find('.ua-card-setting-btn');
+        var $cardSettingElem = $('#' + cardSettingId);
+        if ($cardSettingElem.length > 0) {
+            $cardSettingElem.remove();
+            return;
+        }
+
+        // 配置段 + 排序段（面板每次点按钮重建，排序段随建随取
+        // store 当前态，表头排序/搜索后重开面板即最新）
+        var cardSettingHtml = '<div id="' + cardSettingId + '" class="ul-nav-block ua-card-setting-panel">';
+        var operatAlwaysOn = ua.getPageSetting('card-operat-always', '') === '1';
+        cardSettingHtml += '<div class="ua-card-setting-title">配置</div>';
+        cardSettingHtml += '<div class="ua-card-setting-item"><span>操作按钮始终显示</span>'
+            + '<span class="ua-card-setting-switch' + (operatAlwaysOn ? ' on' : '') + '"></span></div>';
+        cardSettingHtml += '<div class="ua-card-setting-title">排序</div>';
+        // 当前排序读 store 单一事实源（where.sort 形状为 {字段名: 'asc'|'desc'}
+        // 单键映射，与 store setSort/buildRequestData 同构）
+        var cardSortState = window.UA_TABLE_STORE.dataProvider.getState(tableId);
+        var cardSortCurrent = cardSortState && cardSortState.where ? cardSortState.where.sort : null;
+        $.each(((controlledLayouts[tableId] && controlledLayouts[tableId].cols[0]) || []), function (i, col) {
+            if (!col || !col.field || col.sort === false || col.hide) {
+                return;
+            }
+            var sortClass = '';
+            var sortIconClass = 'layui-icon layui-hide';
+            if (cardSortCurrent && cardSortCurrent[col.field]) {
+                sortClass = ' current';
+                sortIconClass = 'layui-icon layui-icon-' + (cardSortCurrent[col.field] === 'desc' ? 'down' : 'up');
+            }
+            cardSettingHtml += '<div class="ua-card-setting-sort-item item' + sortClass + '" data-field="' + col.field + '">'
+                + (col.title || col.field)
+                + ' <i class="' + sortIconClass + '"></i></div>';
+        });
+        cardSettingHtml += '</div>';
+
+        $cardSettingElem = $(cardSettingHtml).appendTo($toolbarSettingElem);
+
+        // 面板内条目点击不冒泡（排序段等后续 .item 条目沿用）
+        $cardSettingElem.on('click', '.item', function (event) {
+            event.stopPropagation();
+        });
+
+        // 开关：页级记忆 + 模板容器即时生效，不收起面板不重渲
+        $cardSettingElem.on('click', '.ua-card-setting-switch', function (event) {
+            var on = !$(this).hasClass('on');
+            ua.setPageSetting('card-operat-always', on ? '1' : '');
+            $(this).toggleClass('on', on);
+            $('#ua-layout-' + tableId).toggleClass('ua-card-operat-always', on);
+            event.stopPropagation();
+        });
+
+        // 排序：循环 升 → 降 → 取消。与 listenTableSort 同构：
+        // 以 lastTableWhere 为基底就地改 sort，显式传 where
+        // （store.reload 仅在 opts.where 存在时经 setWhere 更新
+        // 请求参数，漏传排序到不了服务端）；initSort 供表头
+        // 箭头（取消时省略）；当前态以 store getState 为准
+        // （搜索路径会整体覆盖 lastTableWhere，admin-table.js
+        // 侧变量不可作判定依据）。点击后收起面板
+        $cardSettingElem.on('click', '.ua-card-setting-sort-item', function (event) {
+            event.stopPropagation();
+            var field = $(this).data('field');
+            var sortState = window.UA_TABLE_STORE.dataProvider.getState(tableId);
+            var currentType = sortState && sortState.where && sortState.where.sort ? (sortState.where.sort[field] || null) : null;
+            var lastWhere = lastTableWhere[tableId] ? lastTableWhere[tableId] : {};
+            var reloadOpts = {where: lastWhere};
+            if (currentType === 'asc') {
+                lastWhere.sort = {};
+                lastWhere.sort[field] = 'desc';
+                reloadOpts.initSort = {field: field, type: 'desc'};
+            } else if (currentType === 'desc') {
+                delete lastWhere.sort;
+            } else {
+                lastWhere.sort = {};
+                lastWhere.sort[field] = 'asc';
+                reloadOpts.initSort = {field: field, type: 'asc'};
+            }
+            lastTableWhere[tableId] = lastWhere;
+            ua.table.reloadData(tableId, reloadOpts);
+            $cardSettingElem.remove();
+            $(document).off('click.ua-card-setting');
+        });
+
+        // 点击面板外区域收起（命名空间事件，收起时解除）；判定以入口按钮为界
+        $(document).off('click.ua-card-setting').on('click.ua-card-setting', function (event) {
+            if (!$(event.target).closest($toolbarSettingElem).length) {
+                $('#' + cardSettingId).remove();
+                $(document).off('click.ua-card-setting');
+            }
+        });
     };
 
     if (window.UA_TABLE_STORE) {
@@ -841,23 +938,6 @@
                         extend: 'data-table-id="' + options.id + '"'
                     });
                 }
-                // 卡片设置入口（pro#5）：存在任何非 table 形态即注入（不依赖
-                // 条目数>1，单形态 card 页也需要打开设置面板）。不写 extend 属性
-                // （layui 不渲染该属性，面板定位走 lay-table-id 模式）
-                var hasNonTableLayout = false;
-                $.each(layoutEntries, function (i, entry) {
-                    if (entry && entry.name !== 'table') {
-                        hasNonTableLayout = true;
-                        return false;
-                    }
-                });
-                if (hasNonTableLayout) {
-                    defaultToolbar.push({
-                        title: '卡片设置',
-                        layEvent: 'TABLE_CARD_SETTING',
-                        icon: 'layui-icon-set'
-                    });
-                }
             }
 
             if (options.defaultToolbar === undefined) {
@@ -882,22 +962,6 @@
                         extend: 'data-table-id="' + options.id + '"'
                     });
                 }
-                // 卡片设置入口与 TABLE_LAYOUT 同规则去重追加：autoInjected
-                // 即默认注入 card，条件恒成立；已有同名 layEvent 不重复加
-                var hasCardSettingBtn = false;
-                $.each(options.defaultToolbar, function (i, btn) {
-                    if (btn && typeof btn === 'object' && btn.layEvent === 'TABLE_CARD_SETTING') {
-                        hasCardSettingBtn = true;
-                        return false;
-                    }
-                });
-                if (!hasCardSettingBtn) {
-                    options.defaultToolbar.push({
-                        title: '卡片设置',
-                        layEvent: 'TABLE_CARD_SETTING',
-                        icon: 'layui-icon-set'
-                    });
-                }
             }
 
 
@@ -1043,6 +1107,30 @@
             }
 
 
+            // 列显隐记忆恢复：必须在引擎 table.render 首次渲染之前改写
+            // col.hide——cols 为同一引用（layui 浅拷贝 config.cols ===
+            // options.cols），引擎表格、列筛选面板勾选态、卡片收集三处自动
+            // 一致；controlledLayouts 注册晚于本行，同样消费改写后的引用。
+            // 记忆损坏时静默忽略，不中断渲染
+            var savedHiddenFields = ua.getPageSetting('table-cols-hide-' + options.id, '');
+            if (savedHiddenFields) {
+                try {
+                    var hiddenFieldMap = {};
+                    $.each(JSON.parse(savedHiddenFields), function (i, fieldName) {
+                        hiddenFieldMap[fieldName] = true;
+                    });
+                    $.each(options.cols, function (i, row) {
+                        $.each(row || [], function (j, col) {
+                            if (col.field && hiddenFieldMap[col.field]) {
+                                col.hide = true;
+                            }
+                        });
+                    });
+                } catch (e) {
+                    // 视为无记忆
+                }
+            }
+
             // 初始化表格
             var newTable = table.render(options);
 
@@ -1098,6 +1186,33 @@
                     e.stopPropagation();
                 });
 
+                // 卡片设置入口按钮（pro#5 迭代：由右侧图标区 defaultToolbar 移至
+                // 左侧工具栏末尾）。layui 2.10.1 左容器为 .layui-table-tool-temp
+                //（layui.js 工具栏模板 '<div class="layui-table-tool"><div
+                // class="layui-table-tool-temp"></div><div
+                // class="layui-table-tool-self"></div>'，左容器经
+                // o.layTool.find(".layui-table-tool-temp").html(t) 渲染现有操作
+                // 按钮）。不带 lay-event（避免 layui toolbar 委托与直绑双触发），
+                // 点击直调 toggleCardSettingPanel。初始 layui-hide，追加在本分支
+                // 内、首次 syncLayoutVisibility 调用之前，由其按当前形态定初始
+                // 显隐（表格形态直开页按钮不会闪现）
+                var $cardSettingView = $(options.elem).siblings('.layui-table-view').first();
+                var hasNonTableLayout = false;
+                $.each(layoutEntries, function (i, entry) {
+                    if (entry && entry.name !== 'table') {
+                        hasNonTableLayout = true;
+                        return false;
+                    }
+                });
+                if (hasNonTableLayout && $cardSettingView.find('.ua-card-setting-btn').length === 0) {
+                    var $cardSettingBtn = $('<a class="layui-btn layui-btn-sm ua-card-setting-btn layui-hide" title="卡片设置"><i class="layui-icon layui-icon-set"></i>卡片设置</a>')
+                        .appendTo($cardSettingView.find('.layui-table-tool-temp'));
+                    $cardSettingBtn.on('click', function (event) {
+                        toggleCardSettingPanel(options.id);
+                        event.stopPropagation();
+                    });
+                }
+
                 // 形态注册：layoutList 已在 defaultToolbar 段规范化（视图按钮
                 // 注入共用）。运行期切形态经 ua.table.setLayoutForm。
                 // options.cols 此时已过 formatCols/renderOperat/renderTrueHide，
@@ -1188,6 +1303,19 @@
                 // 不变），卡片形态 debounce 100ms 后从 store 当页数据重渲
                 //（renderLayoutForm 零网络请求，连点不抖动）
                 table.on('colToggled(' + options.layFilter + ')', function (obj) {
+                    // 列显隐按页记忆：表格/卡片两种形态都能从列筛选面板触发
+                    // 本事件，保存必须放在形态短路之前。收集当前隐藏列的字段
+                    // 名，全显时存空串即清除记忆
+                    var hiddenFields = [];
+                    $.each(controlledLayouts[options.id].cols, function (i, row) {
+                        $.each(row || [], function (j, col) {
+                            if (col.field && col.hide === true && hiddenFields.indexOf(col.field) === -1) {
+                                hiddenFields.push(col.field);
+                            }
+                        });
+                    });
+                    ua.setPageSetting('table-cols-hide-' + options.id, hiddenFields.length ? JSON.stringify(hiddenFields) : '');
+
                     if (resolveCurrentLayout(options.id).kind === 'table') {
                         return;
                     }
@@ -2244,103 +2372,6 @@
                             }
                         });
                         break;
-                    case 'TABLE_CARD_SETTING':
-                        // 卡片设置面板（pro#5，交互结构参照 TABLE_LAYOUT 实现
-                        // 重建）：入口图标仅卡片形态可见（syncLayoutVisibility
-                        // 联动），面板 append 在工具栏图标元素内，面板内点击
-                        // 均阻断冒泡（不触发 layui toolbar 重开、不触发
-                        // document 收起），开关可反复切换；再点图标收起
-                        var cardSettingId = 'ua-card-setting-' + tableId;
-                        var $toolbarSettingElem = $('[lay-table-id="' + tableId + '"]').find('[lay-event="TABLE_CARD_SETTING"]');
-                        var $cardSettingElem = $('#' + cardSettingId);
-                        if ($cardSettingElem.length > 0) {
-                            $cardSettingElem.remove();
-                            break;
-                        }
-
-                        // 配置段 + 排序段（面板每次点图标重建，排序段随建随取
-                        // store 当前态，表头排序/搜索后重开面板即最新）
-                        var cardSettingHtml = '<div id="' + cardSettingId + '" class="ul-nav-block ua-card-setting-panel">';
-                        var operatAlwaysOn = ua.getPageSetting('card-operat-always', '') === '1';
-                        cardSettingHtml += '<div class="ua-card-setting-title">配置</div>';
-                        cardSettingHtml += '<div class="ua-card-setting-item"><span>操作按钮始终显示</span>'
-                            + '<span class="ua-card-setting-switch' + (operatAlwaysOn ? ' on' : '') + '"></span></div>';
-                        cardSettingHtml += '<div class="ua-card-setting-title">排序</div>';
-                        // 当前排序读 store 单一事实源（where.sort 形状为 {字段名: 'asc'|'desc'}
-                        // 单键映射，与 store setSort/buildRequestData 同构）
-                        var cardSortState = window.UA_TABLE_STORE.dataProvider.getState(tableId);
-                        var cardSortCurrent = cardSortState && cardSortState.where ? cardSortState.where.sort : null;
-                        $.each(((controlledLayouts[tableId] && controlledLayouts[tableId].cols[0]) || []), function (i, col) {
-                            if (!col || !col.field || col.sort === false || col.hide) {
-                                return;
-                            }
-                            var sortClass = '';
-                            var sortIconClass = 'layui-icon layui-hide';
-                            if (cardSortCurrent && cardSortCurrent[col.field]) {
-                                sortClass = ' current';
-                                sortIconClass = 'layui-icon layui-icon-' + (cardSortCurrent[col.field] === 'desc' ? 'down' : 'up');
-                            }
-                            cardSettingHtml += '<div class="ua-card-setting-sort-item item' + sortClass + '" data-field="' + col.field + '">'
-                                + (col.title || col.field)
-                                + ' <i class="' + sortIconClass + '"></i></div>';
-                        });
-                        cardSettingHtml += '</div>';
-
-                        $cardSettingElem = $(cardSettingHtml).appendTo($toolbarSettingElem);
-
-                        // 面板内条目点击不冒泡（排序段等后续 .item 条目沿用）
-                        $cardSettingElem.on('click', '.item', function (event) {
-                            event.stopPropagation();
-                        });
-
-                        // 开关：页级记忆 + 模板容器即时生效，不收起面板不重渲
-                        $cardSettingElem.on('click', '.ua-card-setting-switch', function (event) {
-                            var on = !$(this).hasClass('on');
-                            ua.setPageSetting('card-operat-always', on ? '1' : '');
-                            $(this).toggleClass('on', on);
-                            $('#ua-layout-' + tableId).toggleClass('ua-card-operat-always', on);
-                            event.stopPropagation();
-                        });
-
-                        // 排序：循环 升 → 降 → 取消。与 listenTableSort 同构：
-                        // 以 lastTableWhere 为基底就地改 sort，显式传 where
-                        // （store.reload 仅在 opts.where 存在时经 setWhere 更新
-                        // 请求参数，漏传排序到不了服务端）；initSort 供表头
-                        // 箭头（取消时省略）；当前态以 store getState 为准
-                        // （搜索路径会整体覆盖 lastTableWhere，admin-table.js
-                        // 侧变量不可作判定依据）。点击后收起面板
-                        $cardSettingElem.on('click', '.ua-card-setting-sort-item', function (event) {
-                            event.stopPropagation();
-                            var field = $(this).data('field');
-                            var sortState = window.UA_TABLE_STORE.dataProvider.getState(tableId);
-                            var currentType = sortState && sortState.where && sortState.where.sort ? (sortState.where.sort[field] || null) : null;
-                            var lastWhere = lastTableWhere[tableId] ? lastTableWhere[tableId] : {};
-                            var reloadOpts = {where: lastWhere};
-                            if (currentType === 'asc') {
-                                lastWhere.sort = {};
-                                lastWhere.sort[field] = 'desc';
-                                reloadOpts.initSort = {field: field, type: 'desc'};
-                            } else if (currentType === 'desc') {
-                                delete lastWhere.sort;
-                            } else {
-                                lastWhere.sort = {};
-                                lastWhere.sort[field] = 'asc';
-                                reloadOpts.initSort = {field: field, type: 'asc'};
-                            }
-                            lastTableWhere[tableId] = lastWhere;
-                            ua.table.reloadData(tableId, reloadOpts);
-                            $cardSettingElem.remove();
-                            $(document).off('click.ua-card-setting');
-                        });
-
-                        // 点击面板外区域收起（命名空间事件，收起时解除）
-                        $(document).off('click.ua-card-setting').on('click.ua-card-setting', function (event) {
-                            if (!$(event.target).closest($toolbarSettingElem).length) {
-                                $('#' + cardSettingId).remove();
-                                $(document).off('click.ua-card-setting');
-                            }
-                        });
-                        break;
                 }
             });
         },