feat(api): 添加备注功能以增强用例描述

- 在 Api 和 ApiCase 中新增 Note 方法，允许为用例设置可选备注
- 更新 TestRecord 结构体，包含备注字段以便记录用例信息
- 修改 Swagger 生成逻辑，支持备注字段的输出
- 更新文档，详细说明 Note 方法的使用及其在调试控制台的显示效果

testing_swagger.go

@@ -13,6 +13,7 @@ import (
 
 type swaggerTestCase struct {
 	Name      string                 `json:"name"`
+	Note      string                 `json:"note,omitempty"`
 	Method    string                 `json:"method"`
 	Passed    bool                   `json:"passed"`
 	Query     map[string]interface{} `json:"query,omitempty"`
@@ -227,10 +228,10 @@ func (that *TestApp) GenerateSwagger(title, version, outputDir string) error {
 
 				var cases []swaggerTestCase
 				for _, r := range recs {
-					tc := swaggerTestCase{
-						Name: r.CaseName, Method: r.Method, Passed: r.Passed,
-						Response: r.ResponseBody,
-					}
+				tc := swaggerTestCase{
+					Name: r.CaseName, Note: r.Note, Method: r.Method, Passed: r.Passed,
+					Response: r.ResponseBody,
+				}
 					if r.Query != nil {
 						tc.Query = r.Query
 					}
@@ -502,7 +503,7 @@ function show(){
   h+='<div class="split">';
   h+='<div class="split-l">'+buildLeft(e)+'</div>';
   h+='<div class="split-r">';
-  h+='<div class="rtabs"><div class="rtab on" id="rt0" onclick="rswitch(0)">测试用例'+(cnt?'('+cnt+')':'')+'</div><div class="rtab" id="rt1" onclick="rswitch(1)">发送结果</div></div>';
+  h+='<div class="rtabs"><div class="rtab on" id="rt0" onclick="rswitch(0)">用例结果</div><div class="rtab" id="rt1" onclick="rswitch(1)">发送结果</div></div>';
   h+='<div class="rpn on" id="rp0"><div id="case-panel" style="padding:4px 0"></div></div>';
   h+='<div class="rpn" id="rp1">'+respPanel()+'</div>';
   h+='</div></div>';
@@ -533,6 +534,7 @@ function cases(e){
   for(let i=0;i<e.cases.length;i++){const c=e.cases[i];
     h+='<div class="cs"><div class="csh" onclick="accordion(this)"><span class="ar'+(i===0?' o':'')+'">&#9654;</span><span class="dot '+(c.passed?'ok':'er')+'"></span>'+esc(c.name)+'<span class="ml">'+c.method+'</span></div>';
     h+='<div class="csb'+(i===0?' o':'')+'"><div style="padding:8px 10px">';
+    if(c.note)h+='<div style="color:#aaa;font-size:12px;margin-bottom:8px;line-height:1.5">备注: '+esc(c.note)+'</div>';
     const curlId='cc'+i;const respId='cr'+i;
     h+='<div class="row-hd" style="margin-bottom:4px"><span class="sec-title">cURL</span><button class="cp-sm" onclick="event.stopPropagation();copyEl(\''+curlId+'\')">复制</button></div>';
     h+='<div class="curl" id="'+curlId+'">'+esc(caseCurl(e,c))+'</div>';
@@ -553,6 +555,7 @@ function accordion(el){
 
 function respPanel(){
   let r='';
+  r+='<div id="note-box" style="display:none;color:#aaa;font-size:12px;margin-bottom:8px;line-height:1.5"></div>';
   r+='<div class="row-hd" style="margin-bottom:4px"><span class="sec-title">cURL</span><button class="cp-sm" onclick="copyEl(\'curl-box\')">复制</button></div>';
   r+='<div class="curl" id="curl-box">发送请求后生成</div>';
   r+='<div class="row-hd" style="margin:10px 0 4px"><span class="sec-title">响应 <span id="resp-st"></span></span><button class="cp-sm" onclick="copyEl(\'resp-body\')">复制</button></div>';
@@ -567,7 +570,7 @@ function buildLeft(e){
   const at=document.getElementById('at').value;
   let l='';
   l+='<div style="display:flex;align-items:center;gap:6px;margin-bottom:10px">';
-  l+='<span style="color:var(--fg2);font-size:11px;white-space:nowrap">预填</span>';
+  l+='<span style="color:var(--fg2);font-size:11px;white-space:nowrap">测试用例选择</span>';
   l+='<div class="pf-wrap"><button class="pf-btn" id="pf-btn" onclick="togglePfDd(event)"><span class="dot" id="pf-dot" style="display:none;flex-shrink:0"></span><span id="pf-label" style="flex:1;text-align:left;overflow:hidden;text-overflow:ellipsis;white-space:nowrap;color:var(--fg2)">选择用例...</span><span style="color:var(--fg2);font-size:10px;flex-shrink:0">▾</span></button><ul class="pf-dd" id="pf-dd"></ul></div>';
   l+='<button class="sbtn" onclick="send()" id="sbtn">发送</button>';
   l+='</div>';
@@ -674,6 +677,7 @@ function updateCasePanel(e,i){
   if(i===''||!e?.cases?.[i]){panel.innerHTML='<div style="color:#555;padding:16px 10px">选择一个测试用例查看响应</div>';return;}
   const c=e.cases[i];
   let h='<div style="padding:8px 10px">';
+  if(c.note)h+='<div style="color:#aaa;font-size:12px;margin-bottom:8px;line-height:1.5">备注: '+esc(c.note)+'</div>';
   h+='<div class="row-hd" style="margin-bottom:4px"><span class="sec-title">cURL</span><span class="'+(c.passed?'tg tg-ok':'tg tg-err')+'" style="margin-left:6px">'+(c.passed?'通过':'失败')+'</span><button class="cp-sm" onclick="copyEl(\'c-curl\')" style="margin-left:auto">复制</button></div>';
   h+='<div class="curl" id="c-curl">'+esc(caseCurl(e,c))+'</div>';
   h+='<div class="row-hd" style="margin:8px 0 4px"><span class="sec-title">响应</span><button class="cp-sm" onclick="copyEl(\'c-resp\')" style="margin-left:auto">复制</button></div>';
@@ -697,11 +701,15 @@ function pfFill(v){
       if(C?.params){for(const p of C.params.filter(p=>p.in==='form'))addKVReq('f-rows',p.name,p.example!==undefined?String(p.example):'',p.required);}
       addKV('f-rows');
     }
-    document.getElementById('file-rows').innerHTML='';addFileRow();syncAuth();return;
+    document.getElementById('file-rows').innerHTML='';addFileRow();
+    const nb0=document.getElementById('note-box');if(nb0){nb0.style.display='none';nb0.textContent='';}
+    syncAuth();return;
   }
   const i=parseInt(v);
   if(isNaN(i)||i<0||!C?.cases?.[i])return;
   const c=C.cases[i];
+  const nb=document.getElementById('note-box');
+  if(nb){if(c.note){nb.textContent='备注: '+c.note;nb.style.display='block';}else{nb.textContent='';nb.style.display='none';}}
   if(c.query){
     for(const[k,val]of Object.entries(c.query)){
       const req=C?.params?.find(p=>p.name===k&&p.in==='query')?.required||false;