完善气站资源列表搜索契约

docs/06-气站管理系统需求.md

@@ -85,6 +85,8 @@
 
 工作人员支持新增、编辑、启停和归档；资质支持新增、编辑、启停和归档。工作人员只能归属当前气站，可选归属当前气站的一个配送点。存在未完成订单时不得归档。删除工作人员和资质均更新为已归档。
 
+安装人员、配送人员和运维人员列表统一支持按“用户名、角色”模糊搜索，输入框必须明确提示“可搜索：用户名、角色”。
+
 ### 4.4 用户管理
 
 - 用户账户是平台全局账户；当前气站可管理由总后台分配到本站的用户，也可自行创建用户并在同一事务内建立本站服务关系。
@@ -163,6 +165,8 @@
 
 标准列表资源使用独立记录页，不在列表抽屉中承载新建、详情或编辑：
 
+- 列表搜索能力由后端资源契约声明；支持搜索时输入框必须逐项显示“可搜索：字段名”，不得使用“关键字段”等含义不明确的兜底文案。
+- 后端资源契约未声明可搜索字段时，前端必须隐藏“模糊搜索”、输入框、“查询”和“重置”组成的完整搜索区域，刷新和新建操作不受影响。
 - 新建页：`列表路径/new`，仅为支持新建的资源生成。
 - 详情页：`列表路径/:identity`，20 类标准资源全部提供，并支持刷新和直达。
 - 编辑页：`列表路径/:identity/edit`，仅为支持通用编辑的资源生成。