القائمة
MallBase ThinkPHP 列表查询构建规则；仅在实现或调整 Service::buildListQuery 与分页查询构建封装时使用。
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
MallBase 扩展槽边界规范；涉及会员、积分、分销、余额、优惠等权益扩展接入订单、商品编辑或 UniApp 展示时使用。
MallBase schema 真相源与幂等升级 SQL 规则；升级 SQL 仅在用户明确要求已有库升级时使用。
MallBase ThinkPHP 后端规则索引；仅在需要浏览或选择后端规则、且无法确定具体 ThinkPHP skill 时使用。
MallBase 已有库升级 SQL 边界规则；只有用户明确要求考虑已有库升级、测试服/线上升级或 upgrade SQL 时使用。
MallBase ThinkPHP 模型字段访问器与素材回显规则；在 Model 字段读写、访问器、修改器、with 关联、素材 ID 回显或 Service 字段组装优化时使用。
MallBase preview 演示站分支边界规则；涉及 preview 分支、演示站专用功能、main 与 preview 合并、反向合并、演示站部署或公开演示能力修改时使用。
| name | build-list-query-only |
| description | MallBase ThinkPHP 列表查询构建规则；仅在实现或调整 Service::buildListQuery 与分页查询构建封装时使用。 |
Service::getList()、getAll()、getPage()、getTotal()、导出前筛选等场景buildListQuery(array $where)。list、total、all、export 等共享同一套筛选条件时，必须复用同一个 buildListQuery()。withSearch()。search*Attr() 作为列表筛选入口。buildListQuery()，不允许在其它地方复制一套查询条件。buildListQuery() 只负责筛选条件构建，不夹杂分页、排序、关联补数。0 的筛选值，必须使用显式判断：->when(($where['status'] ?? null) !== null && $where['status'] !== '', function ($query) use ($where) {
$query->where('status', $where['status']);
})
when()，不要隐藏在模型搜索器中。withwhere、whereLike、order、field alias 或需要返回扁平列表字段时，优先使用 joinjoinwithwithSearch([...], $where)searchKeywordAttr/searchStatusAttr/...list 和 total 各自维护不同筛选条件buildListQuery()。search*Attr()，不保留双轨兼容。with。join。