Collections
                                                                                                                                                                                                   
  - POST /collections/search → POST /collections/_search 或 POST /collections?query=...（如果必须复杂 body，保留 POST；建议统一为 /_search 资源）                                                  
  - DELETE /collections/{name}/all → DELETE /collections/{name}/docs（清空集合中的文档）                                                                                                           
  - DELETE /collections/{name}/attributes (body keys) → PATCH /collections/{name} 或 PATCH /collections/{name}/attributes（用 patch 表达字段删除）                                                 
  - PUT /collections/{name}/attributes → PATCH /collections/{name} 或 PUT /collections/{name}/attributes（若整体替换，用 PUT；局部用 PATCH）                                                       
                                                                                                                                                                                                   
  Docs（QaDocsController）                                                                                                                                                                         
                                                                                                                                                                                                   
  - POST /collections/{collId}/docs/batch → POST /collections/{collId}/docs（body 为数组；或 /docs/batch 仅作兼容）                                                                                
  - GET /collections/{collId}/docs/all → GET /collections/{collId}/docs                                                                                                                            
  - DELETE /collections/{collId}/docs/all → DELETE /collections/{collId}/docs                                                                                                                      
  - DELETE /collections/{collId}/docs/by-name?name=... → DELETE /collections/{collId}/docs?name=...                                                                                                
  - GET /collections/{collId}/docs/by-path?path=... → GET /collections/{collId}/docs?path=...                                                                                                      
  - GET /collections/{collId}/docs/by-prefix?prefix=... → GET /collections/{collId}/docs?prefix=...                                                                                                
  - DELETE /collections/{collId}/docs/by-path?path=... → DELETE /collections/{collId}/docs?path=...                                                                                                
  - POST /collections/{collId}/docs/fields → POST /collections/{collId}/docs/_fields（派生集合）                                                                                                   
  - POST /collections/{collId}/docs/{docId}/rename → PATCH /collections/{collId}/docs/{docId}（body: { "name": "..." }）                                                                           
  - POST /collections/{collId}/docs/{docId}/tags/add|set|remove →                                                                                                                                  
      - PATCH /collections/{collId}/docs/{docId}（统一字段更新）                                                                                                                                   
      - 或 POST/PUT/DELETE /collections/{collId}/docs/{docId}/tags                                                                                                                                 
  - POST /collections/{collId}/docs/{docId}/altlabels/add|set|remove →                                                                                                                             
      - 同 tags 处理                                                                                                                                                                               
  - POST /collections/{collId}/docs/fulltextSearch → POST /collections/{collId}/docs/_search（body: { "type": "fulltext", ... }）                                                                  
  - POST /collections/{collId}/docs/similaritySearch → 同上（type: "similarity"）                                                                                                                  
  - POST /collections/{collId}/docs/hybridSearch → 同上（type: "hybrid"）                                                                                                                          
  - DELETE /collections/{collId}/docs/indexes → DELETE /collections/{collId}/indexes（将 indexes 作为子资源）                                                                                      
                                                                                                                                                                                                   
  Tasks（QaTaskController）                                                                                                                                                                        
                                                                                                                                                                                                   
  - POST /collections/{collId}/tasks/submit → POST /collections/{collId}/tasks（创建任务）                                                                                                         
  - POST /collections/{collId}/tasks/{id}/cancel → PATCH /collections/{collId}/tasks/{id}（body: { "status": "canceled" }）                                                                        
  - DELETE /collections/{collId}/tasks/cleanup → DELETE /collections/{collId}/tasks?expired=true（或 ?cleanup=true）                                                                               
  - DELETE /collections/{collId}/tasks/history/cleanup → DELETE /collections/{collId}/tasks/history?expired=true                                                                                   
  - GET /collections/{collId}/tasks/status/{status} → GET /collections/{collId}/tasks?status=...                                                                                                   
                                                                                                                                                                                                   
  Taxonomy（QaTaxonomyController）                                                                                                                                                                 
                                                                                                                                                                                                   
  - POST /collections/{collName}/taxonomy/by-path → POST /collections/{collName}/taxonomy（body 包含 path）
  - GET /collections/{collName}/taxonomy/by-path?path=... → GET /collections/{collName}/taxonomy?path=...
  - PUT /collections/{collName}/taxonomy/by-path → PATCH /collections/{collName}/taxonomy（或 PUT 用于整体替换）
  - DELETE /collections/{collName}/taxonomy/by-path?path=... → DELETE /collections/{collName}/taxonomy?path=...
  - POST /collections/{collName}/docs/by-path → POST /collections/{collName}/docs（body 包含 path）