必须明确定义状态枚举值、筛选控件类型及默认行为，并绑定筛选结果至统计卡片、导出功能等模块，否则将生成无实际过滤能力的假筛选。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
在码上飞AI平台中，想让生成的应用支持按“状态”字段筛选搜索结果，不能只写“能按状态筛选”，必须明确状态有哪些取值、筛选控件类型、是否默认显示全部、筛选后如何联动其他区域——否则AI会生成无实际过滤能力的静态下拉框或缺失后端逻辑的假筛选。
第一步：在需求描述中明确定义状态枚举值
直接在聊天框输入需求时，把状态选项用中文顿号或括号列全，例如：“订单状态包括【待支付、已支付、发货中、已签收、已取消】”；不要写“多种状态”“常见状态”这类模糊词。码上飞的Agent会将这些字符串自动识别为枚举类型并生成数据库约束和前端选项。
如果漏掉某个关键状态（比如忘记写“退款中”），后续修改需重走数据模型重建流程，【原有测试数据中的该状态记录将丢失】。
第二步：指定筛选交互形式与默认行为
在状态定义后紧跟一句说明筛选方式，例如：“在列表页顶部加下拉筛选栏，默认显示‘全部状态’，选中后实时刷新表格”。
这一步决定AI是否生成带API请求的动态筛选。若只写“支持筛选”，平台可能仅生成前端JavaScript过滤——此时翻页或新增数据后筛选失效，用户会发现筛选结果不一致。
方法一：下拉单选（最常用）→ 适合状态数≤8个，响应快，UI简洁；
方法二：标签式多选 → 适合需要组合查看“待支付+发货中”的运营场景，但需额外说明“可多选，筛选后保留原排序”；
方法三：开关式状态分组 → 如“进行中（含待支付、发货中）、已完成（含已签收、已取消）”，需写明分组逻辑，否则AI无法自动归类。
第三步：绑定筛选结果到具体功能模块
必须点名筛选生效范围，例如：“筛选结果同步影响右侧统计卡片中的数量、导出Excel按钮的数据范围、以及底部‘导出当前筛选结果’提示文字”。
不写这句话，AI默认只改表格数据，统计数字仍显示全量，导出文件仍是全部数据——用户第一次点击导出时会立刻发现功能断裂。
① 打开预览界面，找到筛选后的表格；
② 点击右上角“导出Excel”按钮；
③ 检查导出文件行数是否等于当前页面显示行数；
④ 若不等，返回对话框追加指令：“导出功能必须严格遵循当前状态筛选条件，不可导出全量数据”。
