用途:把 Make App 记录列表分组作为整体能力处理,涵盖工具栏分组入口、可选 CanvasTable 表头分组入口、Entity Preset 持久化、Service record-groups 请求、records groupFilter 与 CanvasTable 分组渲染。该技能负责消费方契约与分组语义,其他相关技能负责各自实现面。
主要能力:分组字段来自规范化运行时 schema,要求 key 非空且 capabilities.groupable === true,不使用可见列、示例行、本地 DSL 或字段类型白名单作为依据。分组值唯一形式为有序 { fieldKey, order }[],最多三个字段,index 0/1/2 对应根、二级、三级。使用 package RecordGroupPanel、useRecordGroupController、宿主组件适配器与稳定 resetKey。
使用方式:安装 @qfei-design/make-app-group@^0.1.0,先读 package.ai.json,按 readOrder 依次读取声明文件,仅导入公开导出与 styles.css,并移除复制的 UI 模型、面板、样式或拖拽行为;确保安装 @qfei-design/canvas-table,验证 GroupTableComponent、group:load、group:data:load、setGroup、setData、markGroupPageLoadFailed 为公开。先建立权限感知的对象上下文,加载 schema 与 Entity Preset,清洗已保存分组,再选择普通记录或分组记录加载。先保存后应用,Preset 写入稀疏,清除用 Preset { group: [] },filter、sort、group 互不覆盖。
适用场景:桌面/平板分组列表、Entity Preset 分组视图、分组筛选、分组叶分页,以及与 make-app-actions 可写列表的选择协作。
限制:手机标准卡片列表不渲染分组触发器、GroupTableComponent、分组 CanvasTable 或分组叶导航,也不改变已保存的桌面分组 Preset。groupFilter 独立于 filter,后端按 AND 关系处理。CanvasTable 1.3.1 下 GroupTableComponent 不支持 Shift 范围选择。分组 V1 除产品明确定义并测试外,单元格编辑视为禁用。UI 或 Preset 中过期值以 Service 为准。未知字段、别名、重复项和超过三项均拒绝。其余具体 API、版本与限制细节暂未提供。