diff --git "a/\346\226\271\344\275\263\347\272\257/20260608\347\254\224\350\256\260.md" "b/\346\226\271\344\275\263\347\272\257/20260608\347\254\224\350\256\260.md"
new file mode 100644
index 0000000000000000000000000000000000000000..cb25e057a69294b1b9e2c257f139a4362b65e5eb
--- /dev/null
+++ "b/\346\226\271\344\275\263\347\272\257/20260608\347\254\224\350\256\260.md"
@@ -0,0 +1,18 @@
+1.pageIndex 页码：从 1 开始，默认值 1；非法值（≤0）自动修正为 1。
+
+2.pageSize 每页条数：默认 10，最大限制 100（防护数据库大数据量查询压垮服务）；小于 1 重置为 10，大于 100 强制改为 100
+
+3.keyword 搜索关键词：可选参数，用于商品名称模糊查询。
+
+4.categoryId 品类 ID：可选参数，用于品类精准过滤。
+
+5.基于 EF Core IQueryable 构建查询链，此时不会执行 SQL，仅拼接查询条件。
+```
+关联查询：Include 联查品类表。
+关键词非空：追加Contains实现模糊查询；
+品类 ID 有值：追加等值条件实现精准过滤
+```
+# 分页公式
+Skip((pageIndex - 1) * pageSize)
+Take(pageSize)：截取当前页数据
+ToListAsync() 触发 SQL 执行，查询并转为集合。