feat(api): 增强 API 测试框架功能与文档

- 在 Api 结构中新增 lastResp 字段以存储最近请求的响应
- 添加 Verify 方法，支持自定义校验函数并返回 ApiCase 构建器
- 新增 Resp 方法，获取最近一次请求的响应以便于断言
- 在 TestCollector 中添加 Visited 字段，记录已调用的路径
- 更新 GenerateSwagger 方法，支持部分运行时保留未运行端点的已有数据
- 完善文档，增加用例编写范式和示例，提升测试框架的可用性与易用性

testing_helper.go

@@ -67,6 +67,7 @@ type TestRecord struct {
 type TestCollector struct {
 	mu      sync.Mutex
 	Records []TestRecord
+	Visited map[string]bool // 被 RunTests 实际调用过的路径（不论是否产生记录）
 }
 
 func (c *TestCollector) Add(r TestRecord) {
@@ -75,6 +76,16 @@ func (c *TestCollector) Add(r TestRecord) {
 	c.Records = append(c.Records, r)
 }
 
+// MarkVisited 标记路径已被测试框架调用（由 RunTests 在进入方法级 t.Run 时调用）
+func (c *TestCollector) MarkVisited(path string) {
+	c.mu.Lock()
+	defer c.mu.Unlock()
+	if c.Visited == nil {
+		c.Visited = map[string]bool{}
+	}
+	c.Visited[path] = true
+}
+
 // NewTestApp 创建测试应用实例
 // configPath: 配置文件路径（如 "../config/config.json"）
 // projects: 项目定义（路由 + 测试）
@@ -172,15 +183,17 @@ func (that *TestApp) RunTests(t *testing.T) {
 					for methodName, apiTest := range ctrTest {
 						methodName := methodName
 						apiTest := apiTest
-						t.Run(methodName, func(t *testing.T) {
-							err := that.Db.BeginTestTx()
-							if err != nil {
-								t.Fatal("开启测试事务失败:", err)
-							}
-							defer that.Db.RollbackTestTx()
+					t.Run(methodName, func(t *testing.T) {
+						path := "/" + projName + "/" + ctrName + "/" + methodName
+						that.collector.MarkVisited(path)
 
-							path := "/" + projName + "/" + ctrName + "/" + methodName
-							api := &Api{
+						err := that.Db.BeginTestTx()
+						if err != nil {
+							t.Fatal("开启测试事务失败:", err)
+						}
+						defer that.Db.RollbackTestTx()
+
+						api := &Api{
 								app:  that,
 								path: path,
 								t:    t,