feat(db): 添加对达梦数据库的支持

- 在应用程序中新增对达梦数据库（DM）的配置和连接支持 - 实现 SetDmDB 函数以配置达梦数据库连接 - 更新数据库操作逻辑，支持达梦特有的 SQL 语法和功能 - 在相关文件中添加达梦数据库的处理逻辑，包括表创建、数据插入和查询 - 更新 go.mod 和 go.sum 文件以引入达梦数据库驱动 - 增强文档，详细说明达梦数据库的配置和使用方法
2026-03-20 10:46:51 +08:00
parent 1546967918
commit 7f7b585ffb
194 changed files with 211502 additions and 2328 deletions
@@ -0,0 +1,43 @@
+package app
+
+import (
+	"os"
+	"testing"
+
+	. "code.hoteas.com/golang/hotime"
+)
+
+var ProjectTest = ProjTest{
+	"test":  TestTest,
+	"mysql": MysqlTest,
+	"dmdb":  DmdbTest,
+	"cache": CacheTest,
+}
+
+var testApp *TestApp
+
+func TestMain(m *testing.M) {
+	// Go test 的 CWD 是包目录 example/app/，切回 example/ 使相对路径正确
+	_ = os.Chdir("..")
+
+	testApp = NewTestApp("config/config.json",
+		TestProj{
+			"app": {
+				Proj:  Project,
+				Tests: ProjectTest,
+			},
+		},
+	)
+
+	// 在测试前初始化各数据库的测试表和种子数据
+	SetupDatabase(&testApp.Db)
+
+	code := m.Run()
+	testApp.PrintCoverage()
+	testApp.GenerateSwagger("My API", "1.0.0", testApp.Config.GetString("tpt"))
+	os.Exit(code)
+}
+
+func TestApi(t *testing.T) {
+	testApp.RunTests(t)
+}
@@ -0,0 +1,294 @@
+package app
+
+import (
+	"fmt"
+	"time"
+
+	. "code.hoteas.com/golang/hotime"
+	. "code.hoteas.com/golang/hotime/common"
+)
+
+// CacheCtr 缓存测试控制器（数据库无关）
+var CacheCtr = Ctr{
+	"all":    func(that *Context) { that.Display(0, testCacheAll(that)) },
+	"compat": func(that *Context) { that.Display(0, testCacheCompatible(that)) },
+	"batch": func(that *Context) {
+		that.Display(0, Map{"message": "批量缓存测试完成，请查看控制台输出和日志文件"})
+	},
+}
+
+func testCacheAll(that *Context) Map {
+	result := Map{"name": "数据库缓存测试", "tests": Slice{}}
+	tests := Slice{}
+
+	cacheMode := "unknown"
+	if that.Application.HoTimeCache != nil && that.Application.HoTimeCache.Config != nil {
+		dbConfig := that.Application.HoTimeCache.Config.GetMap("db")
+		if dbConfig != nil {
+			cacheMode = dbConfig.GetString("mode")
+			if cacheMode == "" {
+				cacheMode = "new"
+			}
+		}
+	}
+	result["cache_mode"] = cacheMode
+
+	testPrefix := fmt.Sprintf("cache_test_%d_", time.Now().UnixNano())
+
+	// 1. 基础读写测试
+	test1 := Map{"name": "1. 基础 set/get 测试"}
+	testKey1 := testPrefix + "basic"
+	testValue1 := Map{"name": "测试数据", "count": 123, "active": true}
+	that.Application.Cache(testKey1, testValue1)
+	cached1 := that.Application.Cache(testKey1)
+	if cached1.Data != nil {
+		cachedMap := cached1.ToMap()
+		test1["result"] = cachedMap.GetString("name") == "测试数据" && cachedMap.GetInt("count") == 123
+		test1["cached_value"] = cachedMap
+	} else {
+		test1["result"] = false
+		test1["error"] = "缓存读取返回 nil"
+	}
+	tests = append(tests, test1)
+
+	// 2. 删除缓存测试
+	test2 := Map{"name": "2. delete 删除缓存测试"}
+	testKey2 := testPrefix + "delete"
+	that.Application.Cache(testKey2, "删除测试值")
+	before := that.Application.Cache(testKey2)
+	beforeExists := before.Data != nil
+	that.Application.Cache(testKey2, nil)
+	after := that.Application.Cache(testKey2)
+	afterExists := after.Data != nil
+	test2["result"] = beforeExists && !afterExists
+	test2["before_exists"] = beforeExists
+	test2["after_exists"] = afterExists
+	tests = append(tests, test2)
+
+	// 3. 过期时间测试
+	test3 := Map{"name": "3. 过期时间测试（短超时）"}
+	testKey3 := testPrefix + "expire"
+	that.Application.Cache(testKey3, "短期数据", 2)
+	immediate := that.Application.Cache(testKey3)
+	immediateExists := immediate.Data != nil
+	test3["result"] = immediateExists
+	test3["immediate_exists"] = immediateExists
+	test3["note"] = "设置了2秒过期，可等待后再次访问验证过期"
+	tests = append(tests, test3)
+
+	// 4. 不存在的 key 读取测试
+	test4 := Map{"name": "4. 不存在的 key 读取测试"}
+	nonExistKey := testPrefix + "non_exist_key_" + fmt.Sprintf("%d", time.Now().UnixNano())
+	nonExist := that.Application.Cache(nonExistKey)
+	test4["result"] = nonExist.Data == nil
+	test4["value"] = nonExist.Data
+	tests = append(tests, test4)
+
+	// 5. 重复 set 同一个 key 测试
+	test5 := Map{"name": "5. 重复 set 同一个 key 测试"}
+	testKey5 := testPrefix + "repeat"
+	that.Application.Cache(testKey5, "第一次值")
+	first := that.Application.Cache(testKey5).ToStr()
+	that.Application.Cache(testKey5, "第二次值")
+	second := that.Application.Cache(testKey5).ToStr()
+	that.Application.Cache(testKey5, Map{"version": 3})
+	third := that.Application.Cache(testKey5).ToMap()
+	test5["result"] = first == "第一次值" && second == "第二次值" && third.GetInt("version") == 3
+	test5["first"] = first
+	test5["second"] = second
+	test5["third"] = third
+	tests = append(tests, test5)
+
+	// 6. 通配删除测试
+	test6 := Map{"name": "6. 通配删除测试 (key*)"}
+	wildcardPrefix := testPrefix + "wildcard_"
+	that.Application.Cache(wildcardPrefix+"a", "值A")
+	that.Application.Cache(wildcardPrefix+"b", "值B")
+	that.Application.Cache(wildcardPrefix+"c", "值C")
+	aExists := that.Application.Cache(wildcardPrefix+"a").Data != nil
+	bExists := that.Application.Cache(wildcardPrefix+"b").Data != nil
+	cExists := that.Application.Cache(wildcardPrefix+"c").Data != nil
+	allExistBefore := aExists && bExists && cExists
+	that.Application.Cache(wildcardPrefix+"*", nil)
+	aAfter := that.Application.Cache(wildcardPrefix+"a").Data != nil
+	bAfter := that.Application.Cache(wildcardPrefix+"b").Data != nil
+	cAfter := that.Application.Cache(wildcardPrefix+"c").Data != nil
+	allDeletedAfter := !aAfter && !bAfter && !cAfter
+	test6["result"] = allExistBefore && allDeletedAfter
+	test6["before"] = Map{"a": aExists, "b": bExists, "c": cExists}
+	test6["after"] = Map{"a": aAfter, "b": bAfter, "c": cAfter}
+	tests = append(tests, test6)
+
+	// 7. 不同数据类型测试
+	test7 := Map{"name": "7. 不同数据类型存储测试"}
+	that.Application.Cache(testPrefix+"type_string", "字符串值")
+	typeString := that.Application.Cache(testPrefix + "type_string").ToStr()
+	that.Application.Cache(testPrefix+"type_int", 12345)
+	typeInt := that.Application.Cache(testPrefix + "type_int").ToInt()
+	that.Application.Cache(testPrefix+"type_float", 3.14159)
+	typeFloat := that.Application.Cache(testPrefix + "type_float").ToFloat64()
+	that.Application.Cache(testPrefix+"type_bool", true)
+	typeBoolData := that.Application.Cache(testPrefix + "type_bool").Data
+	typeBool := typeBoolData == true || typeBoolData == "true" || typeBoolData == 1.0
+	that.Application.Cache(testPrefix+"type_map", Map{"key": "value", "num": 100})
+	typeMap := that.Application.Cache(testPrefix + "type_map").ToMap()
+	that.Application.Cache(testPrefix+"type_slice", Slice{1, 2, 3, "four", Map{"five": 5}})
+	typeSlice := that.Application.Cache(testPrefix + "type_slice").ToSlice()
+	test7["result"] = typeString == "字符串值" &&
+		typeInt == 12345 &&
+		typeFloat > 3.14 && typeFloat < 3.15 &&
+		typeBool == true &&
+		typeMap.GetString("key") == "value" &&
+		len(typeSlice) == 5
+	test7["string"] = typeString
+	test7["int"] = typeInt
+	test7["float"] = typeFloat
+	test7["bool"] = typeBool
+	test7["map"] = typeMap
+	test7["slice"] = typeSlice
+	tests = append(tests, test7)
+
+	// 8. 自定义超时时间测试
+	test8 := Map{"name": "8. 自定义超时时间参数测试"}
+	testKey8 := testPrefix + "custom_timeout"
+	that.Application.Cache(testKey8, "长期数据", 3600)
+	longTerm := that.Application.Cache(testKey8)
+	test8["result"] = longTerm.Data != nil
+	test8["value"] = longTerm.ToStr()
+	tests = append(tests, test8)
+
+	// 9. 查询缓存表状态
+	test9 := Map{"name": "9. 缓存表状态查询"}
+	prefix := that.Db.GetPrefix()
+	newTableName := prefix + "hotime_cache"
+	newCount := that.Db.Count(newTableName)
+	test9["new_table_count"] = newCount
+	test9["new_table_name"] = newTableName
+	test9["result"] = newCount >= 0
+	tests = append(tests, test9)
+
+	that.Application.Cache(testPrefix+"*", nil)
+
+	result["tests"] = tests
+	result["success"] = true
+	result["cleanup"] = "已清理所有测试缓存数据"
+	return result
+}
+
+func testCacheCompatible(that *Context) Map {
+	result := Map{
+		"test_name": "兼容模式白盒测试",
+		"timestamp": time.Now().Format("2006-01-02 15:04:05"),
+	}
+
+	prefix := that.Db.GetPrefix()
+	newTableName := prefix + "hotime_cache"
+	legacyTableName := prefix + "cached"
+
+	tests := Slice{}
+
+	test1 := Map{"name": "1. 查询当前缓存模式"}
+	cacheConfig := that.Application.Config.GetMap("cache")
+	dbConfig := cacheConfig.GetMap("db")
+	mode := dbConfig.GetString("mode")
+	if mode == "" {
+		mode = "默认(compatible)"
+	}
+	test1["mode"] = mode
+	test1["result"] = true
+	tests = append(tests, test1)
+
+	// 根据数据库类型使用不同的引号
+	q := "`"
+	if that.Db.Dialect != nil {
+		q = that.Db.Dialect.QuoteChar()
+	}
+
+	test2 := Map{"name": "2. 查询老表cached现有数据"}
+	legacyData := that.Db.Query("SELECT * FROM " + q + legacyTableName + q + " LIMIT 5")
+	test2["legacy_table"] = legacyTableName
+	test2["count"] = len(legacyData)
+	test2["data"] = legacyData
+	test2["result"] = true
+	tests = append(tests, test2)
+
+	test3 := Map{"name": "3. 查询新表hotime_cache现有数据"}
+	newData := that.Db.Query("SELECT * FROM " + q + newTableName + q + " LIMIT 5")
+	test3["new_table"] = newTableName
+	test3["count"] = len(newData)
+	test3["data"] = newData
+	test3["result"] = true
+	tests = append(tests, test3)
+
+	test4 := Map{"name": "4. 测试兼容模式老表回退读取"}
+	testKey4 := "test_compat_fallback_" + ObjToStr(time.Now().UnixNano())
+	testValue4 := Map{"admin_id": 999, "admin_name": "测试老数据"}
+	testValueJson4 := ObjToStr(Map{"data": testValue4})
+	that.Db.Insert(legacyTableName, Map{
+		"key":     testKey4,
+		"value":   testValueJson4,
+		"endtime": time.Now().Unix() + 3600,
+		"time":    time.Now().UnixNano(),
+	})
+	test4["test_key"] = testKey4
+	newExists := that.Db.Get(newTableName, "*", Map{"key": testKey4})
+	test4["key_in_new_table"] = newExists != nil
+	cacheValue := that.Application.Cache(testKey4)
+	test4["cache_api_result"] = cacheValue.Data
+	test4["result"] = newExists == nil && cacheValue.Data != nil
+	tests = append(tests, test4)
+
+	test5 := Map{"name": "5. 测试兼容模式写新删老"}
+	testKey5 := "test_compat_write_" + ObjToStr(time.Now().UnixNano())
+	testValue5 := "兼容模式测试数据"
+	that.Db.Insert(legacyTableName, Map{
+		"key":     testKey5,
+		"value":   `{"data":"老表原始数据"}`,
+		"endtime": time.Now().Unix() + 3600,
+		"time":    time.Now().UnixNano(),
+	})
+	legacyBefore := that.Db.Get(legacyTableName, "*", Map{"key": testKey5})
+	test5["step1_legacy_before"] = legacyBefore != nil
+	that.Application.Cache(testKey5, testValue5)
+	newAfter := that.Db.Get(newTableName, "*", Map{"key": testKey5})
+	test5["step2_new_after"] = newAfter != nil
+	if newAfter != nil {
+		test5["new_value"] = newAfter.GetString("value")
+	}
+	legacyAfter := that.Db.Get(legacyTableName, "*", Map{"key": testKey5})
+	test5["step3_legacy_after_deleted"] = legacyAfter == nil
+	test5["result"] = legacyBefore != nil && newAfter != nil && legacyAfter == nil
+	tests = append(tests, test5)
+
+	test6 := Map{"name": "6. 测试兼容模式删除(删除两表)"}
+	testKey6 := "test_compat_delete_" + ObjToStr(time.Now().UnixNano())
+	that.Db.Insert(legacyTableName, Map{
+		"key":     testKey6,
+		"value":   `{"data":"待删除老数据"}`,
+		"endtime": time.Now().Unix() + 3600,
+		"time":    time.Now().UnixNano(),
+	})
+	that.Db.Insert(newTableName, Map{
+		"key":         testKey6,
+		"value":       `"待删除新数据"`,
+		"end_time":    time.Now().Add(time.Hour).Format("2006-01-02 15:04:05"),
+		"state":       0,
+		"create_time": time.Now().Format("2006-01-02 15:04:05"),
+		"modify_time": time.Now().Format("2006-01-02 15:04:05"),
+	})
+	test6["before_legacy"] = that.Db.Get(legacyTableName, "*", Map{"key": testKey6}) != nil
+	test6["before_new"] = that.Db.Get(newTableName, "*", Map{"key": testKey6}) != nil
+	that.Application.Cache(testKey6, nil)
+	test6["after_legacy_deleted"] = that.Db.Get(legacyTableName, "*", Map{"key": testKey6}) == nil
+	test6["after_new_deleted"] = that.Db.Get(newTableName, "*", Map{"key": testKey6}) == nil
+	test6["result"] = test6.GetBool("before_legacy") && test6.GetBool("before_new") &&
+		test6.GetBool("after_legacy_deleted") && test6.GetBool("after_new_deleted")
+	tests = append(tests, test6)
+
+	that.Db.Delete(newTableName, Map{"key[~]": "test_compat_%"})
+	that.Db.Delete(legacyTableName, Map{"key[~]": "test_compat_%"})
+
+	result["tests"] = tests
+	result["success"] = true
+	return result
+}
@@ -0,0 +1,11 @@
+package app
+
+import (
+	. "code.hoteas.com/golang/hotime"
+)
+
+var CacheTest = CtrTest{
+	"all":    {Desc: "缓存全部测试", Func: func(a *Api) { a.Get("缓存全部测试", 0) }},
+	"compat": {Desc: "缓存兼容模式测试", Func: func(a *Api) { a.Get("兼容模式测试", 0) }},
+	"batch":  {Desc: "批量缓存测试", Func: func(a *Api) { a.Get("批量缓存测试", 0) }},
+}
@@ -0,0 +1,88 @@
+package app
+
+import (
+	. "code.hoteas.com/golang/hotime"
+	. "code.hoteas.com/golang/hotime/common"
+)
+
+// DmdbCtr 达梦数据库特有测试控制器
+var DmdbCtr = Ctr{
+	"tables": func(that *Context) {
+		if that.Db.Type != "dm" && that.Db.Type != "dameng" {
+			that.Display(0, Map{"skip": true, "reason": "当前非达梦数据库"})
+			return
+		}
+		tables := that.Db.Query(`SELECT TABLE_NAME AS "name", COMMENTS AS "label" FROM USER_TAB_COMMENTS WHERE TABLE_TYPE='TABLE'`)
+		that.Display(0, Map{"tables": tables})
+	},
+
+	"describe": func(that *Context) {
+		if that.Db.Type != "dm" && that.Db.Type != "dameng" {
+			that.Display(0, Map{"skip": true, "reason": "当前非达梦数据库"})
+			return
+		}
+		tableName := that.Req.FormValue("table")
+		if tableName == "" {
+			that.Display(1, "请提供 table 参数")
+			return
+		}
+		columns := that.Db.Query(`SELECT c.COLUMN_NAME AS "name", c.DATA_TYPE AS "type", m.COMMENTS AS "label", c.NULLABLE AS "must" FROM USER_TAB_COLUMNS c LEFT JOIN USER_COL_COMMENTS m ON c.TABLE_NAME=m.TABLE_NAME AND c.COLUMN_NAME=m.COLUMN_NAME WHERE c.TABLE_NAME='` + tableName + `' ORDER BY c.COLUMN_ID`)
+		data := that.Db.Select(tableName, "*", Map{"LIMIT": 10})
+		that.Display(0, Map{"table": tableName, "columns": columns, "sample_data": data})
+	},
+
+	"rawsql": func(that *Context) {
+		if that.Db.Type != "dm" && that.Db.Type != "dameng" {
+			that.Display(0, Map{"skip": true, "reason": "当前非达梦数据库"})
+			return
+		}
+		result := testDmRawSQL(that)
+		that.Display(0, result)
+	},
+}
+
+func testDmRawSQL(that *Context) Map {
+	result := Map{"name": "达梦原生SQL测试", "tests": Slice{}}
+	tests := Slice{}
+
+	test1 := Map{"name": "Query 原生查询 (双引号)"}
+	articles1 := that.Db.Query(`SELECT "id", "title", "author" FROM "article" WHERE "state" = ? LIMIT ?`, 0, 5)
+	test1["result"] = len(articles1) >= 0
+	test1["count"] = len(articles1)
+	tests = append(tests, test1)
+
+	test2 := Map{"name": "Exec 原生执行 (双引号)"}
+	testArticle := that.Db.Get("article", "id", Map{"state": 0})
+	if testArticle != nil {
+		res, err := that.Db.Exec(`UPDATE "article" SET "modify_time" = NOW() WHERE "id" = ?`, testArticle.GetInt64("id"))
+		if err.GetError() == nil && res != nil {
+			affected, _ := res.RowsAffected()
+			test2["result"] = affected >= 0
+			test2["affected"] = affected
+		} else {
+			test2["result"] = false
+			test2["error"] = err.GetError()
+		}
+	} else {
+		test2["result"] = true
+		test2["note"] = "无可用测试数据"
+	}
+	tests = append(tests, test2)
+
+	test3 := Map{"name": "USER_TABLES 查询"}
+	tables := that.Db.Query(`SELECT TABLE_NAME FROM USER_TABLES`)
+	test3["result"] = len(tables) >= 0
+	test3["count"] = len(tables)
+	tests = append(tests, test3)
+
+	test4 := Map{"name": "USER_TAB_COLUMNS 查询"}
+	cols := that.Db.Query(`SELECT COLUMN_NAME, DATA_TYPE FROM USER_TAB_COLUMNS WHERE TABLE_NAME='admin' ORDER BY COLUMN_ID`)
+	test4["result"] = len(cols) >= 0
+	test4["count"] = len(cols)
+	test4["columns"] = cols
+	tests = append(tests, test4)
+
+	result["tests"] = tests
+	result["success"] = true
+	return result
+}
@@ -0,0 +1,12 @@
+package app
+
+import (
+	. "code.hoteas.com/golang/hotime"
+	. "code.hoteas.com/golang/hotime/common"
+)
+
+var DmdbTest = CtrTest{
+	"tables":   {Desc: "查询达梦所有表", Func: func(a *Api) { a.Get("USER_TABLES 查询", 0) }},
+	"describe": {Desc: "查询达梦表结构", Func: func(a *Api) { a.Query(Map{"table": "admin"}).Get("USER_TAB_COLUMNS 查询", 0) }},
+	"rawsql":   {Desc: "达梦原生 SQL 测试", Func: func(a *Api) { a.Get("达梦原生SQL", 0) }},
+}
@@ -0,0 +1,12 @@
+package app
+
+import (
+	. "code.hoteas.com/golang/hotime"
+)
+
+var Project = Proj{
+	"test":  TestCtr,
+	"mysql": MysqlCtr,
+	"dmdb":  DmdbCtr,
+	"cache": CacheCtr,
+}
@@ -0,0 +1,96 @@
+package app
+
+import (
+	. "code.hoteas.com/golang/hotime"
+	. "code.hoteas.com/golang/hotime/common"
+)
+
+// MysqlCtr MySQL 特有测试控制器
+var MysqlCtr = Ctr{
+	"tables": func(that *Context) {
+		if that.Db.Type != "mysql" {
+			that.Display(0, Map{"skip": true, "reason": "当前非 MySQL 数据库"})
+			return
+		}
+		tables := that.Db.Query("SHOW TABLES")
+		that.Display(0, Map{"tables": tables})
+	},
+
+	"describe": func(that *Context) {
+		if that.Db.Type != "mysql" {
+			that.Display(0, Map{"skip": true, "reason": "当前非 MySQL 数据库"})
+			return
+		}
+		tableName := that.Req.FormValue("table")
+		if tableName == "" {
+			that.Display(1, "请提供 table 参数")
+			return
+		}
+		columns := that.Db.Query("DESCRIBE " + tableName)
+		data := that.Db.Select(tableName, Map{"LIMIT": 10})
+		that.Display(0, Map{"table": tableName, "columns": columns, "sample_data": data})
+	},
+
+	"rawsql": func(that *Context) {
+		if that.Db.Type != "mysql" {
+			that.Display(0, Map{"skip": true, "reason": "当前非 MySQL 数据库"})
+			return
+		}
+		result := testMysqlRawSQL(that)
+		that.Display(0, result)
+	},
+}
+
+func testMysqlRawSQL(that *Context) Map {
+	result := Map{"name": "MySQL原生SQL测试", "tests": Slice{}}
+	tests := Slice{}
+
+	test1 := Map{"name": "Query 原生查询 (反引号)"}
+	articles1 := that.Db.Query("SELECT id, title, author FROM `article` WHERE state = ? LIMIT ?", 0, 5)
+	test1["result"] = len(articles1) >= 0
+	test1["count"] = len(articles1)
+	tests = append(tests, test1)
+
+	test2 := Map{"name": "Exec 原生执行 (反引号)"}
+	testArticle := that.Db.Get("article", "id", Map{"state": 0})
+	if testArticle != nil {
+		res, err := that.Db.Exec("UPDATE `article` SET modify_time = NOW() WHERE id = ?", testArticle.GetInt64("id"))
+		if err.GetError() == nil && res != nil {
+			affected, _ := res.RowsAffected()
+			test2["result"] = affected >= 0
+			test2["affected"] = affected
+		} else {
+			test2["result"] = false
+			test2["error"] = err.GetError()
+		}
+	} else {
+		test2["result"] = true
+		test2["note"] = "无可用测试数据"
+	}
+	tests = append(tests, test2)
+
+	test3 := Map{"name": "IN (?) 非空数组展开"}
+	articles3 := that.Db.Query("SELECT id, title FROM `article` WHERE id IN (?) LIMIT 10", []int{1, 2, 3, 4, 5})
+	test3["result"] = len(articles3) >= 0
+	test3["count"] = len(articles3)
+	test3["lastQuery"] = that.Db.LastQuery
+	tests = append(tests, test3)
+
+	test4 := Map{"name": "IN (?) 空数组替换为1=0"}
+	articles4 := that.Db.Query("SELECT id, title FROM `article` WHERE id IN (?) LIMIT 10", []int{})
+	test4["result"] = len(articles4) == 0
+	test4["count"] = len(articles4)
+	test4["lastQuery"] = that.Db.LastQuery
+	tests = append(tests, test4)
+
+	test5 := Map{"name": "NOT IN (?) 空数组替换为1=1"}
+	articles5 := that.Db.Query("SELECT id, title FROM `article` WHERE id NOT IN (?) LIMIT 10", []int{})
+	test5["result"] = len(articles5) > 0
+	test5["count"] = len(articles5)
+	test5["lastQuery"] = that.Db.LastQuery
+	tests = append(tests, test5)
+
+	result["tests"] = tests
+	result["success"] = true
+	return result
+}
@@ -0,0 +1,12 @@
+package app
+
+import (
+	. "code.hoteas.com/golang/hotime"
+	. "code.hoteas.com/golang/hotime/common"
+)
+
+var MysqlTest = CtrTest{
+	"tables":   {Desc: "查询 MySQL 所有表", Func: func(a *Api) { a.Get("SHOW TABLES", 0) }},
+	"describe": {Desc: "查询 MySQL 表结构", Func: func(a *Api) { a.Query(Map{"table": "admin"}).Get("DESCRIBE admin", 0) }},
+	"rawsql":   {Desc: "MySQL 原生 SQL 测试", Func: func(a *Api) { a.Get("MySQL原生SQL", 0) }},
+}
@@ -0,0 +1,126 @@
+package app
+
+import (
+	"fmt"
+
+	. "code.hoteas.com/golang/hotime/db"
+)
+
+// SetupDMDatabase 为达梦数据库创建测试表并灌入测试数据
+func SetupDMDatabase(db *HoTimeDB) {
+	if db.Type != "dm" && db.Type != "dameng" {
+		return
+	}
+
+	fmt.Println("[DM Setup] 开始初始化达梦数据库测试环境...")
+
+	prefix := db.GetPrefix()
+	createDMTables(db, prefix)
+	seedTestData(db, "DM")
+
+	fmt.Println("[DM Setup] 达梦数据库测试环境初始化完成")
+}
+
+func dmTableExists(db *HoTimeDB, tableName string) bool {
+	// COUNT(*) 即使表为空也会返回一行；若表不存在则报错返回空切片。
+	// 相比 USER_TABLES，这里直接检测当前 schema 下表的可访问性，避免
+	// 连接 schema（?schema=TEST）与 USER_TABLES（SYSDBA 自身 schema）错配。
+	res := db.Query(`SELECT COUNT(*) as cnt FROM "` + tableName + `"`)
+	return len(res) > 0
+}
+
+func createDMTables(db *HoTimeDB, prefix string) {
+	// admin 表
+	tbl := prefix + "admin"
+	if !dmTableExists(db, tbl) {
+		fmt.Println("[DM Setup] 创建表:", tbl)
+		db.Exec(`CREATE TABLE "` + tbl + `" (
+			"id" INT IDENTITY(1,1) PRIMARY KEY,
+			"name" VARCHAR(100),
+			"phone" VARCHAR(20),
+			"state" INT DEFAULT 0,
+			"password" VARCHAR(100),
+			"role_id" INT DEFAULT 0,
+			"title" VARCHAR(100),
+			"create_time" TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
+			"modify_time" TIMESTAMP DEFAULT CURRENT_TIMESTAMP
+		)`)
+		db.Exec(`CREATE UNIQUE INDEX "uk_` + tbl + `_phone" ON "` + tbl + `" ("phone")`)
+	}
+
+	// ctg 分类表
+	tbl = prefix + "ctg"
+	if !dmTableExists(db, tbl) {
+		fmt.Println("[DM Setup] 创建表:", tbl)
+		db.Exec(`CREATE TABLE "` + tbl + `" (
+			"id" INT IDENTITY(1,1) PRIMARY KEY,
+			"name" VARCHAR(100),
+			"state" INT DEFAULT 0,
+			"create_time" TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
+			"modify_time" TIMESTAMP DEFAULT CURRENT_TIMESTAMP
+		)`)
+	}
+
+	// article 文章表
+	tbl = prefix + "article"
+	if !dmTableExists(db, tbl) {
+		fmt.Println("[DM Setup] 创建表:", tbl)
+		db.Exec(`CREATE TABLE "` + tbl + `" (
+			"id" INT IDENTITY(1,1) PRIMARY KEY,
+			"title" VARCHAR(200),
+			"author" VARCHAR(100),
+			"content" CLOB,
+			"state" INT DEFAULT 0,
+			"click_num" INT DEFAULT 0,
+			"sort" INT DEFAULT 0,
+			"img" VARCHAR(500),
+			"ctg_id" INT DEFAULT 0,
+			"admin_id" INT DEFAULT 0,
+			"create_time" TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
+			"modify_time" TIMESTAMP DEFAULT CURRENT_TIMESTAMP
+		)`)
+	}
+
+	// test_batch 测试批量表
+	tbl = prefix + "test_batch"
+	if !dmTableExists(db, tbl) {
+		fmt.Println("[DM Setup] 创建表:", tbl)
+		db.Exec(`CREATE TABLE "` + tbl + `" (
+			"id" INT IDENTITY(1,1) PRIMARY KEY,
+			"name" VARCHAR(100),
+			"title" VARCHAR(200),
+			"state" INT DEFAULT 0,
+			"create_time" TIMESTAMP
+		)`)
+	}
+
+	// cached 老版本缓存表（兼容模式测试需要）
+	tbl = prefix + "cached"
+	if !dmTableExists(db, tbl) {
+		fmt.Println("[DM Setup] 创建表:", tbl)
+		db.Exec(`CREATE TABLE "` + tbl + `" (
+			"id" INT IDENTITY(1,1) PRIMARY KEY,
+			"key" VARCHAR(64),
+			"value" CLOB,
+			"endtime" BIGINT,
+			"time" BIGINT
+		)`)
+	}
+
+	// hotime_cache 新版缓存表
+	tbl = prefix + "hotime_cache"
+	if !dmTableExists(db, tbl) {
+		fmt.Println("[DM Setup] 创建表:", tbl)
+		db.Exec(`CREATE TABLE "` + tbl + `" (
+			"id" INT IDENTITY(1,1) PRIMARY KEY,
+			"key" VARCHAR(64) NOT NULL,
+			"value" TEXT,
+			"end_time" TIMESTAMP,
+			"state" INT DEFAULT 0,
+			"create_time" TIMESTAMP,
+			"modify_time" TIMESTAMP,
+			CONSTRAINT "uk_` + tbl + `_key" UNIQUE ("key")
+		)`)
+		db.Exec(`CREATE INDEX "idx_` + tbl + `_end_time" ON "` + tbl + `" ("end_time")`)
+	}
+}
@@ -0,0 +1,131 @@
+package app
+
+import (
+	"fmt"
+
+	. "code.hoteas.com/golang/hotime/db"
+)
+
+// SetupMySQLDatabase 为 MySQL 数据库创建测试表并灌入测试数据
+func SetupMySQLDatabase(db *HoTimeDB) {
+	if db.Type != "mysql" {
+		return
+	}
+
+	fmt.Println("[MySQL Setup] 开始初始化 MySQL 数据库测试环境...")
+
+	prefix := db.GetPrefix()
+	createMySQLTables(db, prefix)
+	seedTestData(db, "MySQL")
+
+	fmt.Println("[MySQL Setup] MySQL 数据库测试环境初始化完成")
+}
+
+func mysqlTableExists(db *HoTimeDB, tableName string) bool {
+	rows := db.Query("SELECT TABLE_NAME FROM INFORMATION_SCHEMA.TABLES WHERE TABLE_SCHEMA=DATABASE() AND TABLE_NAME=?", tableName)
+	return len(rows) > 0
+}
+
+func createMySQLTables(db *HoTimeDB, prefix string) {
+	// admin 表
+	tbl := prefix + "admin"
+	if !mysqlTableExists(db, tbl) {
+		fmt.Println("[MySQL Setup] 创建表:", tbl)
+		db.Exec("CREATE TABLE `" + tbl + "` (" +
+			"`id` int(11) unsigned NOT NULL AUTO_INCREMENT," +
+			"`name` varchar(100) DEFAULT NULL," +
+			"`phone` varchar(20) DEFAULT NULL," +
+			"`state` int(2) DEFAULT '0'," +
+			"`password` varchar(100) DEFAULT NULL," +
+			"`role_id` int(11) DEFAULT '0'," +
+			"`title` varchar(100) DEFAULT NULL," +
+			"`create_time` datetime DEFAULT NULL," +
+			"`modify_time` datetime DEFAULT NULL," +
+			"PRIMARY KEY (`id`)," +
+			"UNIQUE KEY `uk_phone` (`phone`)" +
+			") ENGINE=InnoDB DEFAULT CHARSET=utf8mb4")
+	}
+
+	// ctg 分类表
+	tbl = prefix + "ctg"
+	if !mysqlTableExists(db, tbl) {
+		fmt.Println("[MySQL Setup] 创建表:", tbl)
+		db.Exec("CREATE TABLE `" + tbl + "` (" +
+			"`id` int(11) unsigned NOT NULL AUTO_INCREMENT," +
+			"`name` varchar(100) DEFAULT NULL," +
+			"`state` int(2) DEFAULT '0'," +
+			"`create_time` datetime DEFAULT NULL," +
+			"`modify_time` datetime DEFAULT NULL," +
+			"PRIMARY KEY (`id`)" +
+			") ENGINE=InnoDB DEFAULT CHARSET=utf8mb4")
+	}
+
+	// article 文章表
+	tbl = prefix + "article"
+	if !mysqlTableExists(db, tbl) {
+		fmt.Println("[MySQL Setup] 创建表:", tbl)
+		db.Exec("CREATE TABLE `" + tbl + "` (" +
+			"`id` int(11) unsigned NOT NULL AUTO_INCREMENT," +
+			"`title` varchar(200) DEFAULT NULL," +
+			"`author` varchar(100) DEFAULT NULL," +
+			"`content` text," +
+			"`state` int(2) DEFAULT '0'," +
+			"`click_num` int(11) DEFAULT '0'," +
+			"`sort` int(11) DEFAULT '0'," +
+			"`img` varchar(500) DEFAULT NULL," +
+			"`ctg_id` int(11) DEFAULT '0'," +
+			"`admin_id` int(11) DEFAULT '0'," +
+			"`create_time` datetime DEFAULT NULL," +
+			"`modify_time` datetime DEFAULT NULL," +
+			"PRIMARY KEY (`id`)," +
+			"KEY `idx_state` (`state`)," +
+			"KEY `idx_ctg_id` (`ctg_id`)" +
+			") ENGINE=InnoDB DEFAULT CHARSET=utf8mb4")
+	}
+
+	// test_batch 测试批量表
+	tbl = prefix + "test_batch"
+	if !mysqlTableExists(db, tbl) {
+		fmt.Println("[MySQL Setup] 创建表:", tbl)
+		db.Exec("CREATE TABLE `" + tbl + "` (" +
+			"`id` int(11) unsigned NOT NULL AUTO_INCREMENT," +
+			"`name` varchar(100) DEFAULT NULL," +
+			"`title` varchar(200) DEFAULT NULL," +
+			"`state` int(2) DEFAULT '0'," +
+			"`create_time` datetime DEFAULT NULL," +
+			"PRIMARY KEY (`id`)" +
+			") ENGINE=InnoDB DEFAULT CHARSET=utf8mb4")
+	}
+
+	// cached 老版本缓存表（兼容模式测试需要）
+	tbl = prefix + "cached"
+	if !mysqlTableExists(db, tbl) {
+		fmt.Println("[MySQL Setup] 创建表:", tbl)
+		db.Exec("CREATE TABLE `" + tbl + "` (" +
+			"`id` int(11) unsigned NOT NULL AUTO_INCREMENT," +
+			"`key` varchar(64) DEFAULT NULL," +
+			"`value` text," +
+			"`endtime` bigint(20) DEFAULT NULL," +
+			"`time` bigint(20) DEFAULT NULL," +
+			"PRIMARY KEY (`id`)" +
+			") ENGINE=InnoDB DEFAULT CHARSET=utf8mb4")
+	}
+
+	// hotime_cache 新版缓存表
+	tbl = prefix + "hotime_cache"
+	if !mysqlTableExists(db, tbl) {
+		fmt.Println("[MySQL Setup] 创建表:", tbl)
+		db.Exec("CREATE TABLE `" + tbl + "` (" +
+			"`id` int(11) unsigned NOT NULL AUTO_INCREMENT," +
+			"`key` varchar(64) NOT NULL," +
+			"`value` text," +
+			"`end_time` datetime DEFAULT NULL," +
+			"`state` int(2) DEFAULT '0'," +
+			"`create_time` datetime DEFAULT NULL," +
+			"`modify_time` datetime DEFAULT NULL," +
+			"PRIMARY KEY (`id`)," +
+			"UNIQUE KEY `uk_key` (`key`)," +
+			"KEY `idx_end_time` (`end_time`)" +
+			") ENGINE=InnoDB DEFAULT CHARSET=utf8mb4")
+	}
+}
@@ -0,0 +1,79 @@
+package app
+
+import (
+	"fmt"
+
+	. "code.hoteas.com/golang/hotime/db"
+)
+
+// SetupDatabase 根据数据库类型自动初始化测试表和种子数据
+// 在 TestMain 中调用一次即可
+func SetupDatabase(db *HoTimeDB) {
+	switch db.Type {
+	case "dm", "dameng":
+		SetupDMDatabase(db)
+	case "mysql":
+		SetupMySQLDatabase(db)
+	}
+}
+
+// seedTestData 通用种子数据灌入（DM 和 MySQL 共用）
+// 使用 ORM 的 Insert 方法，与数据库方言无关
+func seedTestData(db *HoTimeDB, tag string) {
+	// 已有数据则跳过
+	if db.Count("ctg") > 0 {
+		fmt.Printf("[%s Setup] 表中已有数据，跳过数据灌入\n", tag)
+		return
+	}
+
+	fmt.Printf("[%s Setup] 灌入测试数据...\n", tag)
+
+	// 分类数据
+	ctgs := []map[string]interface{}{
+		{"name": "新闻资讯", "state": 0},
+		{"name": "技术文档", "state": 0},
+		{"name": "公告通知", "state": 0},
+		{"name": "产品介绍", "state": 0},
+		{"name": "已归档", "state": 1},
+	}
+	for _, c := range ctgs {
+		c["create_time[#]"] = "NOW()"
+		c["modify_time[#]"] = "NOW()"
+		db.Insert("ctg", c)
+	}
+
+	// 管理员数据
+	admins := []map[string]interface{}{
+		{"name": "超级管理员", "phone": "13800000001", "state": 1, "password": "admin123", "role_id": 1, "title": "系统管理员"},
+		{"name": "编辑员", "phone": "13800000002", "state": 1, "password": "editor123", "role_id": 2, "title": "内容编辑"},
+		{"name": "审核员", "phone": "13800000003", "state": 1, "password": "review123", "role_id": 3, "title": "内容审核"},
+	}
+	for _, a := range admins {
+		a["create_time[#]"] = "NOW()"
+		a["modify_time[#]"] = "NOW()"
+		db.Insert("admin", a)
+	}
+
+	// 文章数据 — 覆盖不同状态、分类、点击数、排序
+	articles := []map[string]interface{}{
+		{"title": "数据库入门指南", "author": "管理员", "content": "国产关系型数据库管理系统入门...", "state": 0, "click_num": 128, "sort": 10, "ctg_id": 1, "admin_id": 1},
+		{"title": "新闻发布系统上线公告", "author": "编辑员", "content": "本系统已正式上线运行...", "state": 0, "click_num": 256, "sort": 5, "ctg_id": 1, "admin_id": 2},
+		{"title": "Go语言最佳实践", "author": "管理员", "content": "Go语言在后端开发中的最佳实践总结...", "state": 0, "click_num": 512, "sort": 8, "ctg_id": 2, "admin_id": 1},
+		{"title": "API接口设计规范", "author": "审核员", "content": "RESTful API设计的基本规范和标准...", "state": 0, "click_num": 64, "sort": 15, "ctg_id": 2, "admin_id": 3},
+		{"title": "系统维护通知", "author": "管理员", "content": "系统将于本周日凌晨进行维护升级...", "state": 0, "click_num": 32, "sort": 1, "ctg_id": 3, "admin_id": 1},
+		{"title": "产品功能更新说明", "author": "编辑员", "content": "新版本增加了以下功能...", "state": 0, "click_num": 96, "sort": 12, "ctg_id": 4, "admin_id": 2},
+		{"title": "数据库性能优化指南", "author": "管理员", "content": "数据库性能优化的常见方法和技巧...", "state": 0, "click_num": 1024, "sort": 3, "ctg_id": 2, "admin_id": 1},
+		{"title": "缓存机制深入分析", "author": "审核员", "content": "缓存在Web应用中的重要作用...", "state": 0, "click_num": 200, "sort": 7, "ctg_id": 2, "admin_id": 3},
+		{"title": "旧版公告（已归档）", "author": "管理员", "content": "此公告已过期归档...", "state": 1, "click_num": 10, "sort": 0, "ctg_id": 5, "admin_id": 1},
+		{"title": "测试文章（隐藏）", "author": "编辑员", "content": "测试用文章不公开显示...", "state": 2, "click_num": 0, "sort": 0, "ctg_id": 1, "admin_id": 2},
+		{"title": "高点击量文章", "author": "编辑员", "content": "这是一篇点击量很高的文章...", "state": 0, "click_num": 9999, "sort": 2, "ctg_id": 1, "admin_id": 2},
+	}
+	for _, a := range articles {
+		a["create_time[#]"] = "NOW()"
+		a["modify_time[#]"] = "NOW()"
+		db.Insert("article", a)
+	}
+
+	fmt.Printf("[%s Setup] 数据灌入完成: ctg=%d, admin=%d, article=%d\n",
+		tag, db.Count("ctg"), db.Count("admin"), db.Count("article"))
+}
@@ -0,0 +1,747 @@
+package app
+
+import (
+	"fmt"
+	"time"
+
+	. "code.hoteas.com/golang/hotime"
+	. "code.hoteas.com/golang/hotime/common"
+	. "code.hoteas.com/golang/hotime/db"
+)
+
+// initTestTables 根据数据库类型初始化测试表
+func initTestTables(that *Context) {
+	switch that.Db.Type {
+	case "dm", "dameng":
+		// 用 COUNT(*) 直接探查表可访问性，而非 USER_TABLES（后者受 schema 错配影响）
+		exists := that.Db.Query(`SELECT COUNT(*) as cnt FROM "test_batch"`)
+		if len(exists) == 0 {
+			that.Db.Exec(`CREATE TABLE "test_batch" (
+				"id" INT IDENTITY(1,1) PRIMARY KEY,
+				"name" VARCHAR(100),
+				"title" VARCHAR(200),
+				"state" INT DEFAULT 0,
+				"create_time" TIMESTAMP
+			)`)
+		}
+	default:
+		that.Db.Exec(`CREATE TABLE IF NOT EXISTS test_batch (
+			id INT AUTO_INCREMENT PRIMARY KEY,
+			name VARCHAR(100),
+			title VARCHAR(200),
+			state INT DEFAULT 0,
+			create_time DATETIME
+		)`)
+	}
+
+	_ = that.Db.Count("admin")
+	_ = that.Db.Count("article")
+}
+
+// nowFunc 返回当前数据库的 NOW() 函数表达式
+func nowFunc(that *Context) string {
+	return "NOW()"
+}
+
+// TestCtr 通用 ORM 测试控制器（数据库无关）
+var TestCtr = Ctr{
+	"test": func(that *Context) {
+		that.Display(2, "dsadasd")
+	},
+
+	"all": func(that *Context) {
+		results := Map{}
+		initTestTables(that)
+
+		results["1_basic_crud"] = testBasicCRUD(that)
+		results["2_condition_syntax"] = testConditionSyntax(that)
+		results["3_chain_query"] = testChainQuery(that)
+		results["4_join_query"] = testJoinQuery(that)
+		results["5_aggregate"] = testAggregate(that)
+		results["6_pagination"] = testPagination(that)
+		results["7_batch_insert"] = testInserts(that)
+		results["8_upsert"] = testUpsert(that)
+		results["9_transaction"] = testTransaction(that)
+
+		that.Display(0, results)
+	},
+
+	"crud":        func(that *Context) { initTestTables(that); that.Display(0, testBasicCRUD(that)) },
+	"condition":   func(that *Context) { that.Display(0, testConditionSyntax(that)) },
+	"chain":       func(that *Context) { that.Display(0, testChainQuery(that)) },
+	"join":        func(that *Context) { that.Display(0, testJoinQuery(that)) },
+	"aggregate":   func(that *Context) { that.Display(0, testAggregate(that)) },
+	"pagination":  func(that *Context) { that.Display(0, testPagination(that)) },
+	"batch":       func(that *Context) { initTestTables(that); that.Display(0, testInserts(that)) },
+	"upsert":      func(that *Context) { that.Display(0, testUpsert(that)) },
+	"transaction": func(that *Context) { initTestTables(that); that.Display(0, testTransaction(that)) },
+}
+
+func testBasicCRUD(that *Context) Map {
+	result := Map{"name": "基础CRUD测试", "tests": Slice{}}
+	tests := Slice{}
+
+	now := nowFunc(that)
+
+	insertTest := Map{"name": "Insert 插入测试 (admin表)"}
+	adminId := that.Db.Insert("admin", Map{
+		"name":           "测试管理员_" + fmt.Sprintf("%d", time.Now().Unix()),
+		"phone":          fmt.Sprintf("138%d", time.Now().Unix()%100000000),
+		"state":          1,
+		"password":       "test123456",
+		"role_id":        1,
+		"title":          "测试职位",
+		"create_time[#]": now,
+		"modify_time[#]": now,
+	})
+	insertTest["result"] = adminId > 0
+	insertTest["adminId"] = adminId
+	insertTest["lastQuery"] = that.Db.LastQuery
+	tests = append(tests, insertTest)
+
+	getTest := Map{"name": "Get 获取单条记录测试"}
+	admin := that.Db.Get("admin", "*", Map{"id": adminId})
+	getTest["result"] = admin != nil && admin.GetInt64("id") == adminId
+	getTest["admin"] = admin
+	tests = append(tests, getTest)
+
+	selectTest1 := Map{"name": "Select 单条件查询测试"}
+	admins1 := that.Db.Select("admin", "*", Map{"state": 1, "LIMIT": 5})
+	selectTest1["result"] = len(admins1) >= 0
+	selectTest1["count"] = len(admins1)
+	tests = append(tests, selectTest1)
+
+	selectTest2 := Map{"name": "Select 多条件自动AND测试"}
+	admins2 := that.Db.Select("admin", "*", Map{
+		"state":      1,
+		"role_id[>]": 0,
+		"ORDER":      "id DESC",
+		"LIMIT":      5,
+	})
+	selectTest2["result"] = true
+	selectTest2["count"] = len(admins2)
+	selectTest2["lastQuery"] = that.Db.LastQuery
+	tests = append(tests, selectTest2)
+
+	updateTest := Map{"name": "Update 更新测试"}
+	affected := that.Db.Update("admin", Map{
+		"title":          "更新后的职位",
+		"modify_time[#]": now,
+	}, Map{"id": adminId})
+	updateTest["result"] = affected > 0
+	updateTest["affected"] = affected
+	tests = append(tests, updateTest)
+
+	deleteTest := Map{"name": "Delete 删除测试"}
+	tempId := that.Db.Insert("test_batch", Map{
+		"name":           "临时删除测试",
+		"title":          "测试标题",
+		"state":          1,
+		"create_time[#]": now,
+	})
+	deleteAffected := that.Db.Delete("test_batch", Map{"id": tempId})
+	deleteTest["result"] = deleteAffected > 0
+	deleteTest["affected"] = deleteAffected
+	tests = append(tests, deleteTest)
+
+	result["tests"] = tests
+	result["success"] = true
+	return result
+}
+
+func testConditionSyntax(that *Context) Map {
+	result := Map{"name": "条件查询语法测试", "tests": Slice{}}
+	tests := Slice{}
+
+	test1 := Map{"name": "等于条件 (=)"}
+	articles1 := that.Db.Select("article", "id,title", Map{"state": 0, "LIMIT": 3})
+	test1["result"] = true
+	test1["count"] = len(articles1)
+	tests = append(tests, test1)
+
+	test2 := Map{"name": "不等于条件 ([!])"}
+	articles2 := that.Db.Select("article", "id,title,state", Map{"state[!]": -1, "LIMIT": 3})
+	test2["result"] = true
+	test2["count"] = len(articles2)
+	test2["lastQuery"] = that.Db.LastQuery
+	tests = append(tests, test2)
+
+	test3 := Map{"name": "大于小于条件 ([>], [<])"}
+	articles3 := that.Db.Select("article", "id,title,click_num", Map{
+		"click_num[>]": 0,
+		"click_num[<]": 100000,
+		"LIMIT":        3,
+	})
+	test3["result"] = true
+	test3["count"] = len(articles3)
+	tests = append(tests, test3)
+
+	test4 := Map{"name": "大于等于小于等于条件 ([>=], [<=])"}
+	articles4 := that.Db.Select("article", "id,title,sort", Map{
+		"sort[>=]": 0,
+		"sort[<=]": 100,
+		"LIMIT":    3,
+	})
+	test4["result"] = true
+	test4["count"] = len(articles4)
+	tests = append(tests, test4)
+
+	test5 := Map{"name": "LIKE 模糊查询 ([~])"}
+	articles5 := that.Db.Select("article", "id,title", Map{"title[~]": "新闻", "LIMIT": 3})
+	test5["result"] = true
+	test5["count"] = len(articles5)
+	test5["lastQuery"] = that.Db.LastQuery
+	tests = append(tests, test5)
+
+	test6 := Map{"name": "右模糊查询 ([~!])"}
+	articles6 := that.Db.Select("admin", "id,name", Map{"name[~!]": "管理", "LIMIT": 3})
+	test6["result"] = true
+	test6["count"] = len(articles6)
+	tests = append(tests, test6)
+
+	test7 := Map{"name": "BETWEEN 区间查询 ([<>])"}
+	articles7 := that.Db.Select("article", "id,title,click_num", Map{"click_num[<>]": Slice{0, 1000}, "LIMIT": 3})
+	test7["result"] = true
+	test7["count"] = len(articles7)
+	test7["lastQuery"] = that.Db.LastQuery
+	tests = append(tests, test7)
+
+	test8 := Map{"name": "NOT BETWEEN 查询 ([><])"}
+	articles8 := that.Db.Select("article", "id,title,sort", Map{"sort[><]": Slice{-10, 0}, "LIMIT": 3})
+	test8["result"] = true
+	test8["count"] = len(articles8)
+	tests = append(tests, test8)
+
+	test9 := Map{"name": "IN 查询"}
+	articles9 := that.Db.Select("article", "id,title", Map{"id": Slice{1, 2, 3, 4, 5}, "LIMIT": 5})
+	test9["result"] = true
+	test9["count"] = len(articles9)
+	test9["lastQuery"] = that.Db.LastQuery
+	tests = append(tests, test9)
+
+	test10 := Map{"name": "NOT IN 查询 ([!])"}
+	articles10 := that.Db.Select("article", "id,title", Map{"id[!]": Slice{1, 2, 3}, "LIMIT": 5})
+	test10["result"] = true
+	test10["count"] = len(articles10)
+	tests = append(tests, test10)
+
+	test11 := Map{"name": "IS NULL 查询"}
+	articles11 := that.Db.Select("article", "id,title,img", Map{"img": nil, "LIMIT": 3})
+	test11["result"] = true
+	test11["count"] = len(articles11)
+	tests = append(tests, test11)
+
+	test12 := Map{"name": "IS NOT NULL 查询 ([!])"}
+	articles12 := that.Db.Select("article", "id,title,create_time", Map{"create_time[!]": nil, "LIMIT": 3})
+	test12["result"] = true
+	test12["count"] = len(articles12)
+	tests = append(tests, test12)
+
+	// SQL 片段查询根据数据库类型适配
+	test13 := Map{"name": "直接 SQL 片段查询 ([##])"}
+	var sqlFragment string
+	switch that.Db.Type {
+	case "dm", "dameng":
+		sqlFragment = "\"create_time\" > DATEADD(DAY, -365, NOW())"
+	default:
+		sqlFragment = "create_time > DATE_SUB(NOW(), INTERVAL 365 DAY)"
+	}
+	articles13 := that.Db.Select("article", "id,title,create_time", Map{
+		"[##]":  sqlFragment,
+		"LIMIT": 3,
+	})
+	test13["result"] = true
+	test13["count"] = len(articles13)
+	test13["lastQuery"] = that.Db.LastQuery
+	tests = append(tests, test13)
+
+	test14 := Map{"name": "显式 AND 条件"}
+	articles14 := that.Db.Select("article", "id,title,state,click_num", Map{
+		"AND": Map{
+			"state":         0,
+			"click_num[>=]": 0,
+		},
+		"LIMIT": 3,
+	})
+	test14["result"] = true
+	test14["count"] = len(articles14)
+	tests = append(tests, test14)
+
+	test15 := Map{"name": "OR 条件"}
+	articles15 := that.Db.Select("article", "id,title,sort,click_num", Map{
+		"OR": Map{
+			"sort":         0,
+			"click_num[>]": 10,
+		},
+		"LIMIT": 5,
+	})
+	test15["result"] = true
+	test15["count"] = len(articles15)
+	tests = append(tests, test15)
+
+	test16 := Map{"name": "嵌套 AND/OR 条件"}
+	articles16 := that.Db.Select("article", "id,title,sort,state", Map{
+		"AND": Map{
+			"state": 0,
+			"OR": Map{
+				"sort[>=]":     0,
+				"click_num[>]": 0,
+			},
+		},
+		"LIMIT": 5,
+	})
+	test16["result"] = true
+	test16["count"] = len(articles16)
+	test16["lastQuery"] = that.Db.LastQuery
+	tests = append(tests, test16)
+
+	result["tests"] = tests
+	result["success"] = true
+	return result
+}
+
+func testChainQuery(that *Context) Map {
+	result := Map{"name": "链式查询测试", "tests": Slice{}}
+	tests := Slice{}
+
+	test1 := Map{"name": "基本链式查询 Table().Where().Select()"}
+	articles1 := that.Db.Table("article").
+		Where("state", 0).
+		Select("id,title,author")
+	test1["result"] = len(articles1) >= 0
+	test1["count"] = len(articles1)
+	tests = append(tests, test1)
+
+	test2 := Map{"name": "链式 And 条件"}
+	articles2 := that.Db.Table("article").
+		Where("state", 0).
+		And("click_num[>=]", 0).
+		And("sort[>=]", 0).
+		Select("id,title,click_num")
+	test2["result"] = len(articles2) >= 0
+	test2["count"] = len(articles2)
+	tests = append(tests, test2)
+
+	test3 := Map{"name": "链式 Or 条件"}
+	articles3 := that.Db.Table("article").
+		Where("state", 0).
+		Or(Map{
+			"sort":         0,
+			"click_num[>]": 10,
+		}).
+		Select("id,title,sort,click_num")
+	test3["result"] = len(articles3) >= 0
+	test3["count"] = len(articles3)
+	tests = append(tests, test3)
+
+	test4 := Map{"name": "链式 Order 排序"}
+	articles4 := that.Db.Table("article").
+		Where("state", 0).
+		Order("create_time DESC", "id ASC").
+		Limit(0, 5).
+		Select("id,title,create_time")
+	test4["result"] = len(articles4) >= 0
+	test4["count"] = len(articles4)
+	tests = append(tests, test4)
+
+	test5 := Map{"name": "链式 Limit 限制"}
+	articles5 := that.Db.Table("article").
+		Where("state", 0).
+		Limit(0, 3).
+		Select("id,title")
+	test5["result"] = len(articles5) <= 3
+	test5["count"] = len(articles5)
+	tests = append(tests, test5)
+
+	test6 := Map{"name": "链式 Get 获取单条"}
+	article6 := that.Db.Table("article").
+		Where("state", 0).
+		Get("id,title,author")
+	test6["result"] = article6 != nil || true
+	test6["article"] = article6
+	tests = append(tests, test6)
+
+	test7 := Map{"name": "链式 Count 统计"}
+	count7 := that.Db.Table("article").
+		Where("state", 0).
+		Count()
+	test7["result"] = count7 >= 0
+	test7["count"] = count7
+	tests = append(tests, test7)
+
+	test8 := Map{"name": "链式 Page 分页"}
+	articles8 := that.Db.Table("article").
+		Where("state", 0).
+		Page(1, 5).
+		Select("id,title")
+	test8["result"] = len(articles8) <= 5
+	test8["count"] = len(articles8)
+	tests = append(tests, test8)
+
+	test9 := Map{"name": "链式 Group 分组"}
+	stats9 := that.Db.Table("article").
+		Where("state", 0).
+		Group("ctg_id").
+		Select("ctg_id, COUNT(*) as cnt")
+	test9["result"] = len(stats9) >= 0
+	test9["stats"] = stats9
+	tests = append(tests, test9)
+
+	test10 := Map{"name": "链式 Update 更新"}
+	testArticle := that.Db.Table("article").Where("state", 0).Get("id")
+	if testArticle != nil {
+		affected := that.Db.Table("article").
+			Where("id", testArticle.GetInt64("id")).
+			Update(Map{"modify_time[#]": nowFunc(that)})
+		test10["result"] = affected >= 0
+		test10["affected"] = affected
+	} else {
+		test10["result"] = true
+		test10["note"] = "无可用测试数据"
+	}
+	tests = append(tests, test10)
+
+	result["tests"] = tests
+	result["success"] = true
+	return result
+}
+
+func testJoinQuery(that *Context) Map {
+	result := Map{"name": "JOIN查询测试", "tests": Slice{}}
+	tests := Slice{}
+
+	test1 := Map{"name": "LEFT JOIN 链式查询"}
+	articles1 := that.Db.Table("article").
+		LeftJoin("ctg", "article.ctg_id = ctg.id").
+		Where("article.state", 0).
+		Limit(0, 5).
+		Select("article.id, article.title, ctg.name as ctg_name")
+	test1["result"] = len(articles1) >= 0
+	test1["count"] = len(articles1)
+	test1["data"] = articles1
+	tests = append(tests, test1)
+
+	test2 := Map{"name": "传统 JOIN 语法"}
+	articles2 := that.Db.Select("article",
+		Slice{
+			Map{"[>]ctg": "article.ctg_id = ctg.id"},
+		},
+		"article.id, article.title, ctg.name as ctg_name",
+		Map{
+			"article.state": 0,
+			"LIMIT":         5,
+		})
+	test2["result"] = len(articles2) >= 0
+	test2["count"] = len(articles2)
+	test2["lastQuery"] = that.Db.LastQuery
+	tests = append(tests, test2)
+
+	test3 := Map{"name": "多表 JOIN"}
+	articles3 := that.Db.Table("article").
+		LeftJoin("ctg", "article.ctg_id = ctg.id").
+		LeftJoin("admin", "article.admin_id = admin.id").
+		Where("article.state", 0).
+		Limit(0, 5).
+		Select("article.id, article.title, ctg.name as ctg_name, admin.name as admin_name")
+	test3["result"] = len(articles3) >= 0
+	test3["count"] = len(articles3)
+	test3["data"] = articles3
+	tests = append(tests, test3)
+
+	test4 := Map{"name": "INNER JOIN"}
+	articles4 := that.Db.Table("article").
+		InnerJoin("ctg", "article.ctg_id = ctg.id").
+		Where("ctg.state", 0).
+		Limit(0, 5).
+		Select("article.id, article.title, ctg.name as ctg_name")
+	test4["result"] = len(articles4) >= 0
+	test4["count"] = len(articles4)
+	tests = append(tests, test4)
+
+	result["tests"] = tests
+	result["success"] = true
+	return result
+}
+
+func testAggregate(that *Context) Map {
+	result := Map{"name": "聚合函数测试", "tests": Slice{}}
+	tests := Slice{}
+
+	test1 := Map{"name": "Count 总数统计"}
+	count1 := that.Db.Count("article")
+	test1["result"] = count1 >= 0
+	test1["count"] = count1
+	tests = append(tests, test1)
+
+	test2 := Map{"name": "Count 条件统计"}
+	count2 := that.Db.Count("article", Map{"state": 0})
+	test2["result"] = count2 >= 0
+	test2["count"] = count2
+	tests = append(tests, test2)
+
+	test3 := Map{"name": "Sum 求和 (单字段名)"}
+	sum3 := that.Db.Sum("article", "click_num", Map{"state": 0})
+	test3["result"] = sum3 >= 0
+	test3["sum"] = sum3
+	test3["lastQuery"] = that.Db.LastQuery
+	tests = append(tests, test3)
+
+	test4 := Map{"name": "Avg 平均值 (单字段名)"}
+	avg4 := that.Db.Avg("article", "click_num", Map{"state": 0})
+	test4["result"] = avg4 >= 0
+	test4["avg"] = avg4
+	test4["lastQuery"] = that.Db.LastQuery
+	tests = append(tests, test4)
+
+	test5 := Map{"name": "Max 最大值 (单字段名)"}
+	max5 := that.Db.Max("article", "click_num", Map{"state": 0})
+	test5["result"] = max5 >= 0
+	test5["max"] = max5
+	test5["lastQuery"] = that.Db.LastQuery
+	tests = append(tests, test5)
+
+	test6 := Map{"name": "Min 最小值 (单字段名)"}
+	min6 := that.Db.Min("article", "sort", Map{"state": 0})
+	test6["result"] = true
+	test6["min"] = min6
+	test6["lastQuery"] = that.Db.LastQuery
+	tests = append(tests, test6)
+
+	test7 := Map{"name": "GROUP BY 分组统计"}
+	stats7 := that.Db.Select("article",
+		"ctg_id, COUNT(*) as article_count, AVG(click_num) as avg_clicks, SUM(click_num) as total_clicks",
+		Map{
+			"state": 0,
+			"GROUP": "ctg_id",
+			"ORDER": "article_count DESC",
+			"LIMIT": 10,
+		})
+	test7["result"] = len(stats7) >= 0
+	test7["stats"] = stats7
+	tests = append(tests, test7)
+
+	test8 := Map{"name": "Sum 求和 (table.column 格式)"}
+	sum8 := that.Db.Sum("article", "article.click_num", Map{"state": 0})
+	test8["result"] = sum8 >= 0
+	test8["sum"] = sum8
+	test8["match_single_field"] = sum8 == sum3
+	test8["lastQuery"] = that.Db.LastQuery
+	tests = append(tests, test8)
+
+	test9 := Map{"name": "聚合函数一致性验证"}
+	avg9 := that.Db.Avg("article", "article.click_num", Map{"state": 0})
+	max10 := that.Db.Max("article", "article.click_num", Map{"state": 0})
+	min11 := that.Db.Min("article", "article.sort", Map{"state": 0})
+	allMatch := (sum8 == sum3) && (avg9 == avg4) && (max10 == max5) && (min11 == min6)
+	test9["result"] = allMatch
+	test9["summary"] = fmt.Sprintf("Sum: %v=%v, Avg: %v=%v, Max: %v=%v, Min: %v=%v",
+		sum3, sum8, avg4, avg9, max5, max10, min6, min11)
+	tests = append(tests, test9)
+
+	joinSlice := Slice{
+		Map{"[>]ctg": "article.ctg_id = ctg.id"},
+	}
+	test10 := Map{"name": "Sum 带 JOIN (table.column 格式)"}
+	sum10 := that.Db.Sum("article", "article.click_num", joinSlice, Map{"article.state": 0})
+	test10["result"] = sum10 >= 0
+	test10["sum"] = sum10
+	test10["lastQuery"] = that.Db.LastQuery
+	tests = append(tests, test10)
+
+	test11 := Map{"name": "Count 带 JOIN"}
+	count11 := that.Db.Count("article", joinSlice, Map{"article.state": 0})
+	test11["result"] = count11 >= 0
+	test11["count"] = count11
+	test11["lastQuery"] = that.Db.LastQuery
+	tests = append(tests, test11)
+
+	result["tests"] = tests
+	result["success"] = true
+	return result
+}
+
+func testPagination(that *Context) Map {
+	result := Map{"name": "分页查询测试", "tests": Slice{}}
+	tests := Slice{}
+
+	test1 := Map{"name": "PageSelect 分页查询"}
+	articles1 := that.Db.Page(1, 5).PageSelect("article", "*", Map{
+		"state": 0,
+		"ORDER": "id DESC",
+	})
+	test1["result"] = len(articles1) <= 5
+	test1["count"] = len(articles1)
+	tests = append(tests, test1)
+
+	test2 := Map{"name": "PageSelect 第二页"}
+	articles2 := that.Db.Page(2, 5).PageSelect("article", "*", Map{
+		"state": 0,
+		"ORDER": "id DESC",
+	})
+	test2["result"] = len(articles2) <= 5
+	test2["count"] = len(articles2)
+	tests = append(tests, test2)
+
+	test3 := Map{"name": "链式 Page 分页"}
+	articles3 := that.Db.Table("article").
+		Where("state", 0).
+		Order("id DESC").
+		Page(1, 3).
+		Select("id,title,author")
+	test3["result"] = len(articles3) <= 3
+	test3["count"] = len(articles3)
+	tests = append(tests, test3)
+
+	test4 := Map{"name": "Offset 偏移查询"}
+	articles4 := that.Db.Table("article").
+		Where("state", 0).
+		Limit(3).
+		Offset(2).
+		Select("id,title")
+	test4["result"] = len(articles4) <= 3
+	test4["count"] = len(articles4)
+	test4["lastQuery"] = that.Db.LastQuery
+	tests = append(tests, test4)
+
+	result["tests"] = tests
+	result["success"] = true
+	return result
+}
+
+func testInserts(that *Context) Map {
+	result := Map{"name": "批量插入测试", "tests": Slice{}}
+	tests := Slice{}
+	now := nowFunc(that)
+
+	test1 := Map{"name": "Inserts 批量插入"}
+	timestamp := time.Now().UnixNano()
+	affected1 := that.Db.Inserts("test_batch", []Map{
+		{"name": fmt.Sprintf("批量测试1_%d", timestamp), "title": "标题1", "state": 1},
+		{"name": fmt.Sprintf("批量测试2_%d", timestamp), "title": "标题2", "state": 1},
+		{"name": fmt.Sprintf("批量测试3_%d", timestamp), "title": "标题3", "state": 1},
+	})
+	test1["result"] = affected1 >= 0
+	test1["affected"] = affected1
+	test1["lastQuery"] = that.Db.LastQuery
+	tests = append(tests, test1)
+
+	test2 := Map{"name": "Inserts 带 [#] 标记"}
+	timestamp2 := time.Now().UnixNano()
+	affected2 := that.Db.Inserts("test_batch", []Map{
+		{"name": fmt.Sprintf("带时间测试1_%d", timestamp2), "title": "标题带时间1", "state": 1, "create_time[#]": now},
+		{"name": fmt.Sprintf("带时间测试2_%d", timestamp2), "title": "标题带时间2", "state": 1, "create_time[#]": now},
+	})
+	test2["result"] = affected2 >= 0
+	test2["affected"] = affected2
+	tests = append(tests, test2)
+
+	that.Db.Delete("test_batch", Map{"name[~]": fmt.Sprintf("_%d", timestamp)})
+	that.Db.Delete("test_batch", Map{"name[~]": fmt.Sprintf("_%d", timestamp2)})
+
+	result["tests"] = tests
+	result["success"] = true
+	return result
+}
+
+func testUpsert(that *Context) Map {
+	result := Map{"name": "Upsert测试", "tests": Slice{}}
+	tests := Slice{}
+	now := nowFunc(that)
+
+	timestamp := time.Now().Unix()
+	testPhone := fmt.Sprintf("199%08d", timestamp%100000000)
+
+	test1 := Map{"name": "Upsert 插入新记录 (admin表)"}
+	affected1 := that.Db.Upsert("admin",
+		Map{
+			"name":           "Upsert测试管理员",
+			"phone":          testPhone,
+			"state":          1,
+			"password":       "test123",
+			"role_id":        1,
+			"title":          "测试职位",
+			"create_time[#]": now,
+			"modify_time[#]": now,
+		},
+		Slice{"phone"},
+		Slice{"name", "state", "title", "modify_time"},
+	)
+	test1["result"] = affected1 >= 0
+	test1["affected"] = affected1
+	test1["lastQuery"] = that.Db.LastQuery
+	tests = append(tests, test1)
+
+	test2 := Map{"name": "Upsert 更新已存在记录"}
+	affected2 := that.Db.Upsert("admin",
+		Map{
+			"name":           "Upsert更新后管理员",
+			"phone":          testPhone,
+			"state":          1,
+			"password":       "updated123",
+			"role_id":        2,
+			"title":          "更新后职位",
+			"create_time[#]": now,
+			"modify_time[#]": now,
+		},
+		Slice{"phone"},
+		Slice{"name", "title", "role_id", "modify_time"},
+	)
+	test2["result"] = affected2 >= 0
+	test2["affected"] = affected2
+	tests = append(tests, test2)
+
+	updatedAdmin := that.Db.Get("admin", "*", Map{"phone": testPhone})
+	test2["updatedAdmin"] = updatedAdmin
+
+	that.Db.Delete("admin", Map{"phone": testPhone})
+
+	result["tests"] = tests
+	result["success"] = true
+	return result
+}
+
+func testTransaction(that *Context) Map {
+	result := Map{"name": "事务测试", "tests": Slice{}}
+	tests := Slice{}
+	now := nowFunc(that)
+
+	timestamp := time.Now().Unix()
+	testName1 := fmt.Sprintf("事务测试_%d", timestamp)
+
+	test1 := Map{"name": "事务成功提交"}
+	success1 := that.Db.Action(func(tx HoTimeDB) bool {
+		recordId := tx.Insert("test_batch", Map{
+			"name":           testName1,
+			"title":          "事务提交测试",
+			"state":          1,
+			"create_time[#]": now,
+		})
+		return recordId != 0
+	})
+	test1["result"] = success1
+	checkRecord := that.Db.Get("test_batch", "*", Map{"name": testName1})
+	test1["recordExists"] = checkRecord != nil
+	tests = append(tests, test1)
+
+	test2 := Map{"name": "事务回滚"}
+	testName2 := fmt.Sprintf("事务回滚测试_%d", timestamp)
+	success2 := that.Db.Action(func(tx HoTimeDB) bool {
+		_ = tx.Insert("test_batch", Map{
+			"name":           testName2,
+			"title":          "事务回滚测试",
+			"state":          1,
+			"create_time[#]": now,
+		})
+		return false
+	})
+	test2["result"] = !success2
+	checkRecord2 := that.Db.Get("test_batch", "*", Map{"name": testName2})
+	test2["recordRolledBack"] = checkRecord2 == nil
+	tests = append(tests, test2)
+
+	that.Db.Delete("test_batch", Map{"name": testName1})
+
+	result["tests"] = tests
+	result["success"] = true
+	return result
+}
@@ -0,0 +1,18 @@
+package app
+
+import (
+	. "code.hoteas.com/golang/hotime"
+)
+
+var TestTest = CtrTest{
+	"all":         {Desc: "运行全部通用测试", Func: func(a *Api) { a.Get("全部测试", 0) }},
+	"crud":        {Desc: "基础 CRUD 测试", Func: func(a *Api) { a.Get("CRUD测试", 0) }},
+	"condition":   {Desc: "条件查询语法测试", Func: func(a *Api) { a.Get("条件查询", 0) }},
+	"chain":       {Desc: "链式查询测试", Func: func(a *Api) { a.Get("链式查询", 0) }},
+	"join":        {Desc: "JOIN 查询测试", Func: func(a *Api) { a.Get("JOIN查询", 0) }},
+	"aggregate":   {Desc: "聚合函数测试", Func: func(a *Api) { a.Get("聚合函数", 0) }},
+	"pagination":  {Desc: "分页查询测试", Func: func(a *Api) { a.Get("分页查询", 0) }},
+	"batch":       {Desc: "批量插入测试", Func: func(a *Api) { a.Get("批量插入", 0) }},
+	"upsert":      {Desc: "Upsert 测试", Func: func(a *Api) { a.Get("Upsert测试", 0) }},
+	"transaction": {Desc: "事务测试", Func: func(a *Api) { a.Get("事务测试", 0) }},
+}
@@ -0,0 +1,94 @@
+-- 达梦数据库测试环境初始化脚本
+-- Schema: TEST（在 config.json 中配置 "dm": {"name": "TEST", ...}）
+-- 执行前确保已切换到 TEST Schema，或以 SYSDBA 身份执行
+-- 连接串示例: dm://SYSDBA:SC_sysdba2026@172.31.18.249:5236?schema=TEST
+
+-- ===================== DDL =====================
+
+CREATE TABLE "admin" (
+    "id" INT IDENTITY(1,1) PRIMARY KEY,
+    "name" VARCHAR(100),
+    "phone" VARCHAR(20),
+    "state" INT DEFAULT 0,
+    "password" VARCHAR(100),
+    "role_id" INT DEFAULT 0,
+    "title" VARCHAR(100),
+    "create_time" TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
+    "modify_time" TIMESTAMP DEFAULT CURRENT_TIMESTAMP
+);
+CREATE UNIQUE INDEX "uk_admin_phone" ON "admin" ("phone");
+
+CREATE TABLE "ctg" (
+    "id" INT IDENTITY(1,1) PRIMARY KEY,
+    "name" VARCHAR(100),
+    "state" INT DEFAULT 0,
+    "create_time" TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
+    "modify_time" TIMESTAMP DEFAULT CURRENT_TIMESTAMP
+);
+
+CREATE TABLE "article" (
+    "id" INT IDENTITY(1,1) PRIMARY KEY,
+    "title" VARCHAR(200),
+    "author" VARCHAR(100),
+    "content" CLOB,
+    "state" INT DEFAULT 0,
+    "click_num" INT DEFAULT 0,
+    "sort" INT DEFAULT 0,
+    "img" VARCHAR(500),
+    "ctg_id" INT DEFAULT 0,
+    "admin_id" INT DEFAULT 0,
+    "create_time" TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
+    "modify_time" TIMESTAMP DEFAULT CURRENT_TIMESTAMP
+);
+
+CREATE TABLE "test_batch" (
+    "id" INT IDENTITY(1,1) PRIMARY KEY,
+    "name" VARCHAR(100),
+    "title" VARCHAR(200),
+    "state" INT DEFAULT 0,
+    "create_time" TIMESTAMP
+);
+
+CREATE TABLE "cached" (
+    "id" INT IDENTITY(1,1) PRIMARY KEY,
+    "key" VARCHAR(64),
+    "value" CLOB,
+    "endtime" BIGINT,
+    "time" BIGINT
+);
+
+CREATE TABLE "hotime_cache" (
+    "id" INT IDENTITY(1,1) PRIMARY KEY,
+    "key" VARCHAR(64) NOT NULL,
+    "value" TEXT,
+    "end_time" TIMESTAMP,
+    "state" INT DEFAULT 0,
+    "create_time" TIMESTAMP,
+    "modify_time" TIMESTAMP,
+    CONSTRAINT "uk_hotime_cache_key" UNIQUE ("key")
+);
+CREATE INDEX "idx_hotime_cache_end_time" ON "hotime_cache" ("end_time");
+
+-- ===================== DML 种子数据 =====================
+
+INSERT INTO "ctg" ("name","state","create_time","modify_time") VALUES ('新闻资讯', 0, NOW(), NOW());
+INSERT INTO "ctg" ("name","state","create_time","modify_time") VALUES ('技术文档', 0, NOW(), NOW());
+INSERT INTO "ctg" ("name","state","create_time","modify_time") VALUES ('公告通知', 0, NOW(), NOW());
+INSERT INTO "ctg" ("name","state","create_time","modify_time") VALUES ('产品介绍', 0, NOW(), NOW());
+INSERT INTO "ctg" ("name","state","create_time","modify_time") VALUES ('已归档',   1, NOW(), NOW());
+
+INSERT INTO "admin" ("name","phone","state","password","role_id","title","create_time","modify_time") VALUES ('超级管理员','13800000001',1,'admin123', 1,'系统管理员',NOW(),NOW());
+INSERT INTO "admin" ("name","phone","state","password","role_id","title","create_time","modify_time") VALUES ('编辑员',    '13800000002',1,'editor123',2,'内容编辑',  NOW(),NOW());
+INSERT INTO "admin" ("name","phone","state","password","role_id","title","create_time","modify_time") VALUES ('审核员',    '13800000003',1,'review123',3,'内容审核',  NOW(),NOW());
+
+INSERT INTO "article" ("title","author","content","state","click_num","sort","ctg_id","admin_id","create_time","modify_time") VALUES ('数据库入门指南',        '管理员','国产关系型数据库管理系统入门...',    0, 128,  10,1,1,NOW(),NOW());
+INSERT INTO "article" ("title","author","content","state","click_num","sort","ctg_id","admin_id","create_time","modify_time") VALUES ('新闻发布系统上线公告',  '编辑员','本系统已正式上线运行...',            0, 256,   5,1,2,NOW(),NOW());
+INSERT INTO "article" ("title","author","content","state","click_num","sort","ctg_id","admin_id","create_time","modify_time") VALUES ('Go语言最佳实践',        '管理员','Go语言在后端开发中的最佳实践总结...',0, 512,   8,2,1,NOW(),NOW());
+INSERT INTO "article" ("title","author","content","state","click_num","sort","ctg_id","admin_id","create_time","modify_time") VALUES ('API接口设计规范',       '审核员','RESTful API设计的基本规范和标准...', 0,  64,  15,2,3,NOW(),NOW());
+INSERT INTO "article" ("title","author","content","state","click_num","sort","ctg_id","admin_id","create_time","modify_time") VALUES ('系统维护通知',          '管理员','系统将于本周日凌晨进行维护升级...',  0,  32,   1,3,1,NOW(),NOW());
+INSERT INTO "article" ("title","author","content","state","click_num","sort","ctg_id","admin_id","create_time","modify_time") VALUES ('产品功能更新说明',      '编辑员','新版本增加了以下功能...',             0,  96,  12,4,2,NOW(),NOW());
+INSERT INTO "article" ("title","author","content","state","click_num","sort","ctg_id","admin_id","create_time","modify_time") VALUES ('数据库性能优化指南',    '管理员','数据库性能优化的常见方法和技巧...',  0,1024,   3,2,1,NOW(),NOW());
+INSERT INTO "article" ("title","author","content","state","click_num","sort","ctg_id","admin_id","create_time","modify_time") VALUES ('缓存机制深入分析',      '审核员','缓存在Web应用中的重要作用...',        0, 200,   7,2,3,NOW(),NOW());
+INSERT INTO "article" ("title","author","content","state","click_num","sort","ctg_id","admin_id","create_time","modify_time") VALUES ('旧版公告（已归档）',    '管理员','此公告已过期归档...',                 1,  10,   0,5,1,NOW(),NOW());
+INSERT INTO "article" ("title","author","content","state","click_num","sort","ctg_id","admin_id","create_time","modify_time") VALUES ('测试文章（隐藏）',      '编辑员','测试用文章不公开显示...',             2,   0,   0,1,2,NOW(),NOW());
+INSERT INTO "article" ("title","author","content","state","click_num","sort","ctg_id","admin_id","create_time","modify_time") VALUES ('高点击量文章',          '编辑员','这是一篇点击量很高的文章...',         0,9999,   2,1,2,NOW(),NOW());
@@ -0,0 +1,104 @@
+-- MySQL 测试数据库初始化脚本
+-- 数据库: test（在 config.json 中配置 "mysql": {"name": "test", ...}）
+-- 执行前确保已连接到 test 数据库：USE test;
+
+-- ===================== DDL =====================
+
+CREATE TABLE IF NOT EXISTS `admin` (
+  `id` int(11) unsigned NOT NULL AUTO_INCREMENT,
+  `name` varchar(100) DEFAULT NULL,
+  `phone` varchar(20) DEFAULT NULL,
+  `state` int(2) DEFAULT '0',
+  `password` varchar(100) DEFAULT NULL,
+  `role_id` int(11) DEFAULT '0',
+  `title` varchar(100) DEFAULT NULL,
+  `create_time` datetime DEFAULT NULL,
+  `modify_time` datetime DEFAULT NULL,
+  PRIMARY KEY (`id`),
+  UNIQUE KEY `uk_phone` (`phone`)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='管理员表';
+
+CREATE TABLE IF NOT EXISTS `ctg` (
+  `id` int(11) unsigned NOT NULL AUTO_INCREMENT,
+  `name` varchar(100) DEFAULT NULL,
+  `state` int(2) DEFAULT '0',
+  `create_time` datetime DEFAULT NULL,
+  `modify_time` datetime DEFAULT NULL,
+  PRIMARY KEY (`id`)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='分类表';
+
+CREATE TABLE IF NOT EXISTS `article` (
+  `id` int(11) unsigned NOT NULL AUTO_INCREMENT,
+  `title` varchar(200) DEFAULT NULL,
+  `author` varchar(100) DEFAULT NULL,
+  `content` text,
+  `state` int(2) DEFAULT '0' COMMENT '0正常 1归档 2隐藏',
+  `click_num` int(11) DEFAULT '0',
+  `sort` int(11) DEFAULT '0',
+  `img` varchar(500) DEFAULT NULL,
+  `ctg_id` int(11) DEFAULT '0',
+  `admin_id` int(11) DEFAULT '0',
+  `create_time` datetime DEFAULT NULL,
+  `modify_time` datetime DEFAULT NULL,
+  PRIMARY KEY (`id`),
+  KEY `idx_state` (`state`),
+  KEY `idx_ctg_id` (`ctg_id`)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='文章表';
+
+CREATE TABLE IF NOT EXISTS `test_batch` (
+  `id` int(11) unsigned NOT NULL AUTO_INCREMENT,
+  `name` varchar(100) DEFAULT NULL,
+  `title` varchar(200) DEFAULT NULL,
+  `state` int(2) DEFAULT '0',
+  `create_time` datetime DEFAULT NULL,
+  PRIMARY KEY (`id`)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='批量测试表';
+
+CREATE TABLE IF NOT EXISTS `cached` (
+  `id` int(11) unsigned NOT NULL AUTO_INCREMENT,
+  `key` varchar(64) DEFAULT NULL,
+  `value` text,
+  `endtime` bigint(20) DEFAULT NULL,
+  `time` bigint(20) DEFAULT NULL,
+  PRIMARY KEY (`id`)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='老版本缓存表';
+
+CREATE TABLE IF NOT EXISTS `hotime_cache` (
+  `id` int(11) unsigned NOT NULL AUTO_INCREMENT,
+  `key` varchar(64) NOT NULL COMMENT '缓存键',
+  `value` text DEFAULT NULL COMMENT '缓存值',
+  `end_time` datetime DEFAULT NULL COMMENT '过期时间',
+  `state` int(2) DEFAULT '0',
+  `create_time` datetime DEFAULT NULL,
+  `modify_time` datetime DEFAULT NULL,
+  PRIMARY KEY (`id`),
+  UNIQUE KEY `uk_key` (`key`),
+  KEY `idx_end_time` (`end_time`)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='缓存管理';
+
+-- ===================== DML 种子数据 =====================
+
+INSERT IGNORE INTO `ctg` (`name`, `state`, `create_time`, `modify_time`) VALUES
+('新闻资讯', 0, NOW(), NOW()),
+('技术文档', 0, NOW(), NOW()),
+('公告通知', 0, NOW(), NOW()),
+('产品介绍', 0, NOW(), NOW()),
+('已归档', 1, NOW(), NOW());
+
+INSERT IGNORE INTO `admin` (`name`, `phone`, `state`, `password`, `role_id`, `title`, `create_time`, `modify_time`) VALUES
+('超级管理员', '13800000001', 1, 'admin123', 1, '系统管理员', NOW(), NOW()),
+('编辑员',     '13800000002', 1, 'editor123', 2, '内容编辑', NOW(), NOW()),
+('审核员',     '13800000003', 1, 'review123', 3, '内容审核', NOW(), NOW());
+
+INSERT INTO `article` (`title`, `author`, `content`, `state`, `click_num`, `sort`, `ctg_id`, `admin_id`, `create_time`, `modify_time`) VALUES
+('数据库入门指南',         '管理员', '国产关系型数据库管理系统入门...',     0, 128,  10, 1, 1, NOW(), NOW()),
+('新闻发布系统上线公告',   '编辑员', '本系统已正式上线运行...',             0, 256,   5, 1, 2, NOW(), NOW()),
+('Go语言最佳实践',         '管理员', 'Go语言在后端开发中的最佳实践总结...', 0, 512,   8, 2, 1, NOW(), NOW()),
+('API接口设计规范',        '审核员', 'RESTful API设计的基本规范和标准...',  0,  64,  15, 2, 3, NOW(), NOW()),
+('系统维护通知',           '管理员', '系统将于本周日凌晨进行维护升级...',   0,  32,   1, 3, 1, NOW(), NOW()),
+('产品功能更新说明',       '编辑员', '新版本增加了以下功能...',             0,  96,  12, 4, 2, NOW(), NOW()),
+('数据库性能优化指南',     '管理员', '数据库性能优化的常见方法和技巧...',   0, 1024,  3, 2, 1, NOW(), NOW()),
+('缓存机制深入分析',       '审核员', '缓存在Web应用中的重要作用...',        0, 200,   7, 2, 3, NOW(), NOW()),
+('旧版公告（已归档）',     '管理员', '此公告已过期归档...',                 1,  10,   0, 5, 1, NOW(), NOW()),
+('测试文章（隐藏）',       '编辑员', '测试用文章不公开显示...',             2,   0,   0, 1, 2, NOW(), NOW()),
+('高点击量文章',           '编辑员', '这是一篇点击量很高的文章...',         0, 9999,  2, 1, 2, NOW(), NOW());
@@ -0,0 +1,481 @@
+<!DOCTYPE html>
+<html lang="zh-CN"><head><meta charset="utf-8"><title>API 调试控制台</title>
+<style>
+:root{--bg:#1a1a2e;--bg2:#16213e;--bg3:#0f3460;--fg:#e0e0e0;--fg2:#888;--accent:#4fc3f7;--green:#66bb6a;--red:#ef5350;--border:#2a2a4a;--r:4px}
+*{box-sizing:border-box;margin:0;padding:0}body{display:flex;height:100vh;background:var(--bg);color:var(--fg);font:13px/1.5 -apple-system,sans-serif}
+input,select,textarea,button{font:inherit}pre{margin:0}
+#side{width:260px;min-width:260px;display:flex;flex-direction:column;border-right:1px solid var(--border);overflow:hidden}
+.shd{padding:10px;border-bottom:1px solid var(--border)}.shd h3{font-size:13px;color:var(--accent);margin-bottom:6px}
+.shd input{width:100%;padding:5px 8px;border:1px solid var(--border);border-radius:var(--r);background:var(--bg2);color:var(--fg);font-size:12px;outline:none}
+.shd input:focus{border-color:var(--accent)}.sft{display:flex;gap:2px;margin-top:5px}
+.sft button{flex:1;padding:3px;border:1px solid var(--border);border-radius:var(--r);background:transparent;color:var(--fg2);font-size:11px;cursor:pointer}
+.sft button.on{background:var(--bg3);color:var(--accent);border-color:var(--accent)}
+#tree{flex:1;overflow-y:auto;min-height:0}#tree::-webkit-scrollbar{width:4px}#tree::-webkit-scrollbar-thumb{background:#444;border-radius:2px}
+.l1{border-bottom:1px solid var(--border)}.l1h,.l2h{display:flex;align-items:center;cursor:pointer}
+.l1h{padding:5px 8px;font-weight:700;color:var(--accent);font-size:13px}.l1h:hover,.l2h:hover{background:var(--bg2)}
+.l2h{padding:3px 8px 3px 20px;color:#81d4fa;font-size:12px}
+.ar{margin-right:4px;font-size:8px;transition:transform .1s;color:#555}.ar.o{transform:rotate(90deg);color:var(--accent)}
+.cn{margin-left:auto;font-size:10px;color:#888;background:rgba(255,255,255,.06);padding:0 5px;border-radius:8px;min-width:18px;text-align:center}.sub{display:none}.sub.o{display:block}
+.ep{display:flex;align-items:center;padding:3px 6px 3px 32px;cursor:pointer;gap:4px;color:var(--fg2)}
+.ep:hover{background:var(--bg2);color:var(--fg)}.ep.act{background:var(--bg3);color:var(--accent)}
+.ep .nm{flex:1;overflow:hidden;text-overflow:ellipsis;white-space:nowrap}
+.mt{font-size:9px;padding:1px 4px;border-radius:2px;font-weight:700;flex-shrink:0}
+.mt-get{background:#1b5e20;color:#a5d6a7}.mt-post{background:#0d47a1;color:#90caf9}.mt-put{background:#e65100;color:#ffcc80}.mt-delete{background:#b71c1c;color:#ef9a9a}
+.tg{font-size:9px;padding:1px 4px;border-radius:2px;flex-shrink:0}
+.tg-ok{background:#1b5e20;color:#a5d6a7}.tg-err{background:#b71c1c;color:#ef9a9a}.tg-no{background:#333;color:#555}
+#main{flex:1;display:flex;flex-direction:column;overflow:hidden}
+#bar{padding:5px 12px;border-bottom:1px solid var(--border);display:flex;align-items:center;gap:6px;flex-shrink:0}
+#bar label{color:var(--fg2);font-size:11px}
+#bar select,#bar input{padding:3px 6px;border:1px solid var(--border);border-radius:var(--r);background:var(--bg2);color:var(--fg);font-size:12px;outline:none}
+#bar input{flex:1;max-width:280px}#bar select{width:auto}
+#ct{flex:1;display:flex;flex-direction:column;overflow:hidden;padding:0}
+.ct-hd{padding:6px 12px;border-bottom:1px solid var(--border);flex-shrink:0}
+.ehd{display:flex;align-items:center;gap:8px;flex-wrap:wrap}
+.ehd .mt{font-size:13px;padding:3px 10px}.ehd .pa{font-size:15px;font-weight:600}.ehd .ds{color:var(--fg2);font-size:13px}
+.ehd .nt{color:var(--red);font-size:11px;padding:2px 6px;border:1px solid var(--red);border-radius:var(--r)}
+.case-cnt{font-size:11px;color:var(--fg2);padding:1px 8px;border:1px solid var(--border);border-radius:10px;white-space:nowrap;flex-shrink:0}
+.pf-wrap{position:relative;flex:1;min-width:0}.pf-btn{width:100%;display:flex;align-items:center;gap:6px;padding:4px 8px;border:1px solid var(--border);border-radius:var(--r);background:var(--bg2);cursor:pointer;font-size:12px;color:var(--fg);outline:none;box-sizing:border-box}.pf-btn:hover{border-color:#555}.pf-dd{position:absolute;top:calc(100% + 2px);left:0;right:0;background:#161625;border:1px solid var(--border);border-radius:var(--r);z-index:200;list-style:none;padding:3px 0;margin:0;max-height:200px;overflow-y:auto;display:none;box-shadow:0 4px 12px rgba(0,0,0,.5)}.pf-dd.on{display:block}.pf-opt{display:flex;align-items:center;gap:6px;padding:5px 10px;cursor:pointer;font-size:12px}.pf-opt:hover{background:var(--bg3)}.pf-opt.sel{color:var(--accent)}
+.split{display:flex;flex:1;min-height:0;overflow:hidden}
+.split-l{width:560px;min-width:220px;overflow-y:auto;padding:10px 12px;border-right:1px solid var(--border);flex-shrink:0}
+.split-l::-webkit-scrollbar{width:4px}.split-l::-webkit-scrollbar-thumb{background:#444;border-radius:2px}
+.split-r{flex:1;display:flex;flex-direction:column;min-width:0;overflow:hidden}
+.rtabs{display:flex;border-bottom:1px solid var(--border);flex-shrink:0;padding:0 4px}
+.rtab{padding:6px 14px;cursor:pointer;color:var(--fg2);border-bottom:2px solid transparent;font-size:12px}
+.rtab:hover{color:var(--fg)}.rtab.on{color:var(--accent);border-color:var(--accent)}
+.rpn{display:none;overflow-y:auto;padding:12px;flex:1}.rpn.on{display:block}
+.rpn::-webkit-scrollbar{width:4px}.rpn::-webkit-scrollbar-thumb{background:#444;border-radius:2px}
+.cs{border:1px solid var(--border);border-radius:var(--r);margin-bottom:6px;overflow:hidden}
+.csh{padding:6px 10px;display:flex;align-items:center;gap:6px;cursor:pointer;font-size:12px;background:var(--bg2)}
+.csh:hover{background:var(--bg3)}.dot{display:inline-block;width:8px;height:8px;border-radius:50%;flex-shrink:0}
+.dot.ok{background:var(--green)}.dot.er{background:var(--red)}.csh .ml{margin-left:auto;color:#555;font-size:11px}
+.csb{display:none;border-top:1px solid var(--border);font-size:12px}.csb.o{display:block}
+.csr{display:flex}.csr>.csc{flex:1;padding:8px 10px;min-width:0}.csr>.csc+.csc{border-left:1px solid var(--border)}
+.csc h5{color:var(--accent);margin:0 0 4px;font-size:11px;letter-spacing:.5px;display:flex;align-items:center}
+.csc h5 .cp-sm{margin-left:auto}.csc h5:not(:first-child){margin-top:8px}
+pre.j{background:#0a0a1a;padding:6px 8px;border-radius:var(--r);font-size:12px;line-height:1.4;color:#aaa;white-space:pre-wrap;word-break:break-all;max-height:260px;overflow:auto;font-family:Consolas,Monaco,monospace}
+.sec{margin-top:10px;padding-top:10px;border-top:1px solid var(--border)}.sec-title{color:var(--fg2);font-size:11px;letter-spacing:.5px;margin-bottom:4px}
+.row-hd{display:flex;align-items:center;margin-bottom:4px;padding:4px 8px;background:var(--bg2);border-radius:var(--r)}.row-hd .sec-title{flex:1;margin:0}
+.kv{display:flex;gap:4px;margin-bottom:3px;align-items:center}.kv input{flex:1;padding:4px 6px;border:1px solid var(--border);border-radius:var(--r);background:var(--bg2);color:var(--fg);font-size:12px;outline:none}
+.kv input[type="file"]{padding:3px 4px}
+.kv input:focus{border-color:var(--accent)}.kv button{padding:2px 8px;background:var(--bg3);border:1px solid var(--border);color:var(--red);border-radius:var(--r);cursor:pointer}
+.addbtn{padding:2px 10px;background:var(--bg2);border:1px solid var(--border);border-radius:var(--r);color:var(--fg);cursor:pointer;font-size:10px;white-space:nowrap}
+.addbtn:hover{border-color:var(--accent);color:var(--accent)}
+.sbtn{padding:6px 18px;background:var(--accent);color:var(--bg);border:none;border-radius:var(--r);cursor:pointer;font-size:12px;font-weight:600;white-space:nowrap}
+.sbtn:hover{opacity:.9}.sbtn:disabled{opacity:.4;cursor:not-allowed}
+.curl{background:#0a0a1a;padding:6px 8px;border-radius:var(--r);font-size:11px;color:#888;white-space:pre-wrap;word-break:break-all;font-family:Consolas,Monaco,monospace}
+.cp-sm{padding:1px 6px;background:var(--bg3);border:1px solid var(--border);border-radius:var(--r);color:var(--fg2);cursor:pointer;font-size:10px}
+.cp-sm:hover{color:var(--accent);border-color:var(--accent)}
+.pc{border:1px solid var(--border);border-radius:var(--r);margin-bottom:6px;overflow:hidden}
+.pc-hd{padding:3px 8px;background:var(--bg2);color:var(--fg2);font-size:10px;letter-spacing:.5px;border-bottom:1px solid var(--border)}.pc-bd{padding:6px 8px}
+.kv-ro{display:flex;gap:4px;margin-bottom:3px;align-items:center}
+.kv-ro .kk{min-width:80px;max-width:140px;padding:4px 6px;border:1px solid var(--border);border-radius:var(--r);background:var(--bg3);color:var(--accent);font-size:12px;word-break:break-all}
+.kv-ro .vv{flex:1;padding:4px 6px;border:1px solid var(--border);border-radius:var(--r);background:var(--bg2);color:var(--fg);font-size:12px;word-break:break-all}
+.bd-acc{border:1px solid var(--border);border-radius:var(--r);overflow:hidden}
+.bd-hd{padding:6px 8px;cursor:pointer;display:flex;align-items:center;gap:5px;color:var(--fg2);font-size:11px;background:var(--bg2);user-select:none}
+.bd-hd+.bd-hd,.bd-bd+.bd-hd{border-top:1px solid var(--border)}
+.bd-hd.on{color:var(--accent)}.bd-hd .ar{font-size:8px;transition:transform .15s;color:#555;margin-right:2px}.bd-hd.on .ar{transform:rotate(90deg);color:var(--accent)}
+.bd-hd .addbtn{margin-left:auto}
+.bd-bd{display:none;padding:8px;border-top:1px solid var(--border)}.bd-bd.on{display:block}
+.bd-bd textarea{width:100%;min-height:36px;max-height:40vh;padding:5px 8px;border:1px solid var(--border);border-radius:var(--r);background:var(--bg2);color:var(--fg);font-size:12px;font-family:Consolas,Monaco,monospace;resize:vertical;outline:none;overflow-y:auto}
+.bd-bd textarea:focus{border-color:var(--accent)}
+.req-star{color:var(--red);font-size:10px;font-weight:700;margin-right:2px;flex-shrink:0;line-height:1.2;align-self:center}
+</style></head><body>
+
+<div id="side">
+  <div class="shd">
+    <h3 id="dt"></h3>
+    <input id="q" placeholder="搜索接口..." oninput="render()">
+    <div class="sft">
+      <button class="on" onclick="sf('all',this)">全部</button>
+      <button onclick="sf('yes',this)">已测试</button>
+      <button onclick="sf('no',this)">未测试</button>
+      <button onclick="sf('pass',this)">通过</button>
+      <button onclick="sf('fail',this)">未通过</button>
+    </div>
+  </div>
+  <div id="tree"></div>
+</div>
+
+<div id="main">
+  <div id="bar">
+    <label>认证</label>
+    <select id="at" onchange="syncAuth()"><option value="none">无认证</option><option value="header">Header (Authorization)</option><option value="query">URL (?token=)</option><option value="cookie">Cookie</option></select>
+    <input id="tk" placeholder="Token（登录后返回的 32 位字符串）" oninput="syncAuth()">
+  </div>
+  <div id="ct"><div style="text-align:center;color:var(--fg2);padding:80px 20px">&#8592; 选择一个接口开始</div></div>
+</div>
+
+<script>
+let D=null,F='all',C=null;
+
+fetch('./api-spec.json').then(r=>r.json()).then(d=>{
+  D=d;document.getElementById('dt').textContent=d.title+' v'+d.version;document.title=d.title;render();
+});
+
+function epPass(e){if(!e.cases?.length)return false;return e.cases.every(x=>x.passed);}
+function epFail(e){if(!e.cases?.length)return e.tested;return e.cases.some(x=>!x.passed);}
+function render(){
+  if(!D)return;const q=document.getElementById('q').value.toLowerCase();const T={};
+  for(const e of D.endpoints){
+    if(F==='yes'&&!e.tested)continue;
+    if(F==='no'&&e.tested)continue;
+    if(F==='pass'&&!epPass(e))continue;
+    if(F==='fail'&&!epFail(e))continue;
+    if(q&&!e.summary.toLowerCase().includes(q)&&!e.path.toLowerCase().includes(q)&&!e.ctr.toLowerCase().includes(q))continue;
+    if(!T[e.project])T[e.project]={};if(!T[e.project][e.ctr])T[e.project][e.ctr]=[];T[e.project][e.ctr].push(e);
+  }
+  let h='';
+  for(const p of Object.keys(T).sort()){let ph='';
+    for(const c of Object.keys(T[p]).sort()){const es=T[p][c];let eh='';
+      for(const e of es){const m=e.method.toLowerCase();
+        let tg='';if(!e.tested)tg='<span class="tg tg-no">未测试</span>';
+        else if(e.cases?.length){const pc=e.cases.filter(x=>x.passed).length;tg=pc===e.cases.length?'<span class="tg tg-ok">'+pc+'/'+e.cases.length+'</span>':'<span class="tg tg-err">'+pc+'/'+e.cases.length+'</span>';}
+        const mn=e.path.split('/').pop();const lbl=e.tested&&e.summary!==mn?mn+' '+e.summary:e.summary;
+        eh+='<div class="ep'+(C?.path===e.path?' act':'')+'" data-p="'+e.path+'" onclick="go(this)"><span class="mt mt-'+m+'">'+e.method+'</span><span class="nm" title="'+e.path+'">'+lbl+'</span>'+tg+'</div>';
+      }
+      ph+='<div class="l2h" onclick="tog(this)"><span class="ar">&#9654;</span>'+c+'<span class="cn">'+es.length+'</span></div><div class="sub">'+eh+'</div>';
+    }
+    const totalEps=Object.values(T[p]).reduce((s,es)=>s+es.length,0);
+    h+='<div class="l1"><div class="l1h" onclick="tog(this)"><span class="ar o">&#9654;</span>'+p+'<span class="cn">'+totalEps+'</span></div><div class="sub o">'+ph+'</div></div>';
+  }
+  document.getElementById('tree').innerHTML=h||'<div style="padding:30px;color:#555;text-align:center">无匹配</div>';
+}
+function sf(f,b){F=f;document.querySelectorAll('.sft button').forEach(x=>x.classList.remove('on'));b.classList.add('on');render();}
+function tog(e){e.querySelector('.ar').classList.toggle('o');e.nextElementSibling.classList.toggle('o');}
+function go(el){C=D.endpoints.find(e=>e.path===el.dataset.p);if(!C)return;document.querySelectorAll('.ep').forEach(e=>e.classList.remove('act'));el.classList.add('act');show();}
+
+function show(){
+  const e=C;if(!e)return;const m=e.method.toLowerCase();const cnt=e.cases?.length||0;
+  let h='<div class="ct-hd"><div class="ehd">';
+  h+='<span class="mt mt-'+m+'" style="font-size:13px;padding:3px 8px">'+e.method+'</span>';
+  h+='<span class="pa">'+esc(e.path)+'</span><span class="ds">'+esc(e.summary)+'</span>';
+  if(cnt)h+='<span class="case-cnt">'+cnt+' 用例</span>';
+  if(!e.tested)h+='<span class="nt">未测试</span>';
+  h+='</div></div>';
+  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)">用例结果</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>';
+  document.getElementById('ct').innerHTML=h;
+  buildPfList(e);
+  let defIdx=-1;
+  if(cnt>0){for(let i=e.cases.length-1;i>=0;i--){if(e.cases[i].passed){defIdx=i;break;}}if(defIdx<0)defIdx=e.cases.length-1;}
+  pfSelect(defIdx>=0?defIdx:'');
+}
+function rswitch(i){
+  document.querySelectorAll('.rtab').forEach((t,j)=>t.classList.toggle('on',j===i));
+  document.querySelectorAll('.rpn').forEach((p,j)=>p.classList.toggle('on',j===i));
+}
+
+function caseCurl(e,c){
+  const base=window.location.origin;
+  let url=base+e.path;
+  const m=c.method||'POST';
+  if(c.query){const qs=Object.keys(c.query).filter(k=>c.query[k]!==undefined&&c.query[k]!=='').map(k=>encodeURIComponent(k)+'='+encodeURIComponent(c.query[k])).join('&');if(qs)url+='?'+qs;}
+  let cmd="curl -X "+m+" '"+url+"'";
+  if(c.json){cmd+="\\\n  -H 'Content-Type: application/json'";cmd+="\\\n  -d '"+JSON.stringify(c.json).replace(/'/g,"'\\''")+"'";}
+  else if(c.form){const fd=Object.keys(c.form).map(k=>"-F '"+k+"="+c.form[k]+"'").join("\\\n  ");if(fd)cmd+="\\\n  "+fd;}
+  return cmd;
+}
+function cases(e){
+  if(!e.cases?.length)return '<div style="color:#555;padding:20px">暂无测试用例</div>';
+  let h='';
+  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>';
+    h+='<div class="row-hd" style="margin:8px 0 4px"><span class="sec-title">响应</span><span class="'+(c.passed?'tg tg-ok':'tg tg-err')+'" style="margin-left:6px">'+(c.passed?'通过':'失败')+'</span><button class="cp-sm" onclick="event.stopPropagation();copyEl(\''+respId+'\')" style="margin-left:auto">复制</button></div>';
+    if(c.response)h+='<pre class="j" id="'+respId+'">'+fj(c.response)+'</pre>';
+    else h+='<span style="color:#555" id="'+respId+'">无响应</span>';
+    h+='</div></div></div>';
+  }
+  return h;
+}
+function accordion(el){
+  const bd=el.nextElementSibling;const wasOpen=bd.classList.contains('o');
+  const panel=el.closest('.rpn');
+  panel.querySelectorAll('.csb').forEach(b=>b.classList.remove('o'));
+  panel.querySelectorAll('.csh .ar').forEach(a=>a.classList.remove('o'));
+  if(!wasOpen){bd.classList.add('o');el.querySelector('.ar').classList.add('o');}
+}
+
+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>';
+  r+='<pre class="j" id="resp-body" style="min-height:60px;max-height:calc(100vh - 200px)">发送请求后显示</pre>';
+  return r;
+}
+
+function buildLeft(e){
+  const hasForm=e.cases?.some(c=>c.form)||e.params?.some(p=>p.in==='form');
+  const defBody=hasForm?'form':'json';
+  const tk=document.getElementById('tk').value||'';
+  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+='<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>';
+  let defH='<div class="kv"><input value="Content-Type"><input id="ct-val" value="'+(defBody==='json'?'application/json':'application/x-www-form-urlencoded')+'"><button onclick="this.parentElement.remove()">&#215;</button></div>';
+  if(tk&&at==='header')defH+='<div class="kv" data-auth="1"><input value="Authorization"><input value="'+esc(tk)+'"><button onclick="this.parentElement.remove()">&#215;</button></div>';
+  if(tk&&at==='cookie')defH+='<div class="kv" data-auth="1"><input value="Cookie"><input value="HOTIME='+esc(tk)+'"><button onclick="this.parentElement.remove()">&#215;</button></div>';
+  l+='<div class="sec" style="margin-top:0"><div class="row-hd"><span class="sec-title">请求头</span><button class="addbtn" onclick="addKV(\'h-rows\')">+ 添加</button></div><div id="h-rows">'+defH+'</div></div>';
+  let qDef='';
+  if(tk&&at==='query')qDef='<div class="kv" data-auth="1"><input value="token"><input value="'+esc(tk)+'"><button onclick="this.parentElement.remove()">&#215;</button></div>';
+  qDef+='<div class="kv"><input placeholder="key"><input placeholder="value"><button onclick="this.parentElement.remove()">&#215;</button></div>';
+  l+='<div class="sec"><div class="row-hd"><span class="sec-title">Query 参数</span><button class="addbtn" onclick="addKV(\'q-rows\')">+ 添加</button></div><div id="q-rows">'+qDef+'</div></div>';
+  l+='<div class="sec"><div class="row-hd"><span class="sec-title">文件上传</span><button class="addbtn" onclick="addFileRow()">+ 添加</button></div><div id="file-rows"><div class="kv"><input placeholder="字段名" value="file" style="max-width:120px"><input type="file"><button onclick="this.parentElement.remove()">&#215;</button></div></div></div>';
+  let jsonPH='';
+  if(e.params){
+    const jp=e.params.filter(p=>p.in==='json');
+    if(jp.length){const obj={};for(const p of jp)obj[(p.required?'*':'')+p.name]=p.example!==undefined?p.example:'';jsonPH=JSON.stringify(obj,null,2);}
+  }
+  l+='<div class="sec"><div class="sec-title" style="margin-bottom:4px">请求体</div><div class="bd-acc">';
+  l+='<div class="bd-hd'+(defBody==='form'?' on':'')+'" data-t="form" onclick="togBody(\'form\')"><span class="ar'+(defBody==='form'?' o':'')+'">&#9654;</span>表单 (Form)<button class="addbtn" onclick="event.stopPropagation();setAcc(\'form\');addKV(\'f-rows\')">+ 添加</button></div>';
+  l+='<div id="bt-form" class="bd-bd'+(defBody==='form'?' on':'')+'"><div id="f-rows"><div class="kv"><input placeholder="key"><input placeholder="value"><button onclick="this.parentElement.remove()">&#215;</button></div></div></div>';
+  l+='<div class="bd-hd'+(defBody==='json'?' on':'')+'" data-t="json" onclick="togBody(\'json\')"><span class="ar'+(defBody==='json'?' o':'')+'">&#9654;</span>JSON</div>';
+  l+='<div id="bt-json" class="bd-bd'+(defBody==='json'?' on':'')+'"><textarea id="xb" oninput="autoH(this)" placeholder="'+(jsonPH?esc(jsonPH):'{"key":"value"}')+'"></textarea></div>';
+  l+='</div></div>';
+  return l;
+}
+
+function addKV(id,k,v){
+  const row=document.createElement('div');row.className='kv';
+  row.innerHTML='<input placeholder="key" value="'+esc(k||'')+'"><input placeholder="value" value="'+esc(v||'')+'"><button onclick="this.parentElement.remove()">&#215;</button>';
+  document.getElementById(id).appendChild(row);
+}
+function addKVReq(id,k,v,req){
+  const row=document.createElement('div');row.className='kv';
+  const star=req?'<span class="req-star">*</span>':'';
+  row.innerHTML=star+'<input placeholder="key" value="'+esc(k||'')+'"><input placeholder="value" value="'+esc(v||'')+'"><button onclick="this.parentElement.remove()">&#215;</button>';
+  document.getElementById(id).appendChild(row);
+}
+function addFileRow(field){
+  const row=document.createElement('div');row.className='kv';
+  row.innerHTML='<input placeholder="字段名" value="'+esc(field||'file')+'" style="max-width:120px"><input type="file"><button onclick="this.parentElement.remove()">&#215;</button>';
+  document.getElementById('file-rows').appendChild(row);
+}
+function setAcc(t){
+  document.querySelectorAll('.bd-hd').forEach(h=>{h.classList.toggle('on',h.dataset.t===t);const a=h.querySelector('.ar');if(a)a.classList.toggle('o',h.dataset.t===t);});
+  document.getElementById('bt-json').classList.toggle('on',t==='json');
+  document.getElementById('bt-form').classList.toggle('on',t==='form');
+  const ctVal=document.getElementById('ct-val');
+  if(ctVal)ctVal.value=t==='json'?'application/json':'application/x-www-form-urlencoded';
+}
+function togBody(t){
+  const cur=document.getElementById(t==='json'?'bt-json':'bt-form').classList.contains('on');
+  setAcc(cur?(t==='json'?'form':'json'):t);
+}
+function autoH(el){el.style.height='36px';el.style.height=Math.min(el.scrollHeight,window.innerHeight*0.4)+'px';}
+function syncAuth(){
+  const tk=document.getElementById('tk').value;const at=document.getElementById('at').value;
+  const hr=document.getElementById('h-rows');const qr=document.getElementById('q-rows');
+  if(!hr||!qr)return;
+  hr.querySelectorAll('[data-auth]').forEach(e=>e.remove());
+  qr.querySelectorAll('[data-auth]').forEach(e=>e.remove());
+  if(!tk)return;
+  function mkAuth(k,v,parent){const d=document.createElement('div');d.className='kv';d.dataset.auth='1';d.innerHTML='<input value="'+esc(k)+'"><input value="'+esc(v)+'"><button onclick="this.parentElement.remove()">&#215;</button>';parent.insertBefore(d,parent.querySelector('.kv:last-child'));}
+  if(at==='header')mkAuth('Authorization',tk,hr);
+  if(at==='cookie')mkAuth('Cookie','HOTIME='+tk,hr);
+  if(at==='query')mkAuth('token',tk,qr);
+}
+
+function buildPfList(e){
+  const dd=document.getElementById('pf-dd');if(!dd)return;
+  dd.innerHTML='';
+  if(e.cases){
+    for(let i=e.cases.length-1;i>=0;i--){
+      const c=e.cases[i];
+      const li=document.createElement('li');li.className='pf-opt';li.dataset.idx=String(i);
+      li.innerHTML='<span class="dot '+(c.passed?'ok':'er')+'"></span><span>'+esc(c.name)+'</span>';
+      li.onclick=ev=>{ev.stopPropagation();pfSelect(i);};
+      dd.appendChild(li);
+    }
+  }
+  const manual=document.createElement('li');manual.className='pf-opt';manual.dataset.idx='';
+  manual.innerHTML='<span style="color:var(--fg2);font-style:italic">-- 手动填写 --</span>';
+  manual.onclick=ev=>{ev.stopPropagation();pfSelect('');};
+  dd.appendChild(manual);
+}
+function togglePfDd(ev){ev.stopPropagation();const dd=document.getElementById('pf-dd');if(dd)dd.classList.toggle('on');}
+document.addEventListener('click',()=>{document.getElementById('pf-dd')?.classList.remove('on');});
+function pfSelect(i){
+  const e=C;if(!e)return;
+  const idxStr=String(i);
+  document.querySelectorAll('.pf-opt').forEach(el=>el.classList.toggle('sel',el.dataset.idx===idxStr));
+  const c=(i!==''&&e.cases?.[i])?e.cases[i]:null;
+  const dot=document.getElementById('pf-dot');
+  const lbl=document.getElementById('pf-label');
+  if(dot&&lbl){
+    if(c){dot.style.display='';dot.className='dot '+(c.passed?'ok':'er');lbl.style.color='var(--fg)';lbl.textContent=c.name;}
+    else{dot.style.display='none';lbl.style.color='var(--fg2)';lbl.textContent='-- 手动填写 --';}
+  }
+  document.getElementById('pf-dd')?.classList.remove('on');
+  updateCasePanel(e,i);
+  pfFill(i);
+}
+function updateCasePanel(e,i){
+  const panel=document.getElementById('case-panel');if(!panel)return;
+  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>';
+  if(c.response)h+='<pre class="j" id="c-resp">'+fj(c.response)+'</pre>';
+  else h+='<span style="color:#555" id="c-resp">无响应</span>';
+  h+='</div>';
+  panel.innerHTML=h;
+}
+function pfFill(v){
+  const qr=document.getElementById('q-rows');
+  const fr=document.getElementById('f-rows');
+  if(qr)qr.innerHTML='';
+  if(v===''){
+    if(C?.params){
+      for(const p of C.params.filter(p=>p.in==='query'))addKVReq('q-rows',p.name,p.example!==undefined?String(p.example):'',p.required);
+    }
+    addKV('q-rows');
+    const el=document.getElementById('xb');if(el)el.value='';
+    if(fr){
+      fr.innerHTML='';
+      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();
+    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;
+      addKVReq('q-rows',k,String(val),req);
+    }
+  }
+  addKV('q-rows');
+  if(c.json){
+    setAcc('json');const el=document.getElementById('xb');
+    if(el){
+      const rq=new Set((C?.params||[]).filter(p=>p.required&&p.in==='json').map(p=>p.name));
+      let obj=c.json;
+      if(rq.size&&typeof obj==='object'&&obj!==null&&!Array.isArray(obj)){
+        const sorted={};
+        for(const k of Object.keys(obj).sort((a,b)=>(rq.has(b)?1:0)-(rq.has(a)?1:0)))sorted[k]=obj[k];
+        obj=sorted;
+      }
+      el.value=JSON.stringify(obj,null,2);autoH(el);
+    }
+  }else if(c.form){
+    setAcc('form');
+    if(fr){
+      fr.innerHTML='';
+      for(const[k,val]of Object.entries(c.form)){
+        const req=C?.params?.find(p=>p.name===k&&p.in==='form')?.required||false;
+        addKVReq('f-rows',k,String(val),req);
+      }
+      addKV('f-rows');
+    }
+  }else{
+    const el=document.getElementById('xb');if(el)el.value='';
+    if(fr){fr.innerHTML='';addKV('f-rows');}
+  }
+  document.getElementById('file-rows').innerHTML='';
+  if(c.hasFile&&c.fileField)addFileRow(c.fileField);
+  addFileRow();syncAuth();
+}
+
+function getKV(id){
+  const obj={};
+  document.querySelectorAll('#'+id+' .kv').forEach(r=>{const ins=r.querySelectorAll('input');const k=ins[0].value.trim(),v=ins[1]?.value;if(k)obj[k]=v||'';});
+  return Object.keys(obj).length?obj:null;
+}
+
+async function send(){
+  if(!C)return;const btn=document.getElementById('sbtn');btn.disabled=true;btn.textContent='请求中...';
+  let url=C.path;
+  const qp=getKV('q-rows');
+  if(qp){const ps=new URLSearchParams();for(const[k,v]of Object.entries(qp))ps.set(k,v);url+='?'+ps.toString();}
+  const token=document.getElementById('tk').value;
+  const authType=document.getElementById('at').value;
+  const opts={method:C.method,headers:{}};
+  if(authType==='cookie'){opts.credentials='same-origin';if(token)document.cookie='HOTIME='+token+';path=/';}
+  else{opts.credentials='omit';}
+  const ch=getKV('h-rows');if(ch)for(const[k,v]of Object.entries(ch)){
+    if(k.toLowerCase()==='authorization'&&token&&authType==='header')continue;
+    if(k.toLowerCase()==='cookie'&&token&&authType==='cookie')continue;
+    opts.headers[k]=v;
+  }
+  if(token&&authType==='header')opts.headers['Authorization']=token;
+  const fileEls=document.querySelectorAll('#file-rows .kv');
+  const files=[];fileEls.forEach(r=>{const fnEl=r.querySelector('input:not([type="file"])');const fi=r.querySelector('input[type="file"]');if(!fnEl||!fi)return;const fn=fnEl.value.trim();if(fn&&fi.files.length)files.push({field:fn,file:fi.files[0]});});
+  const isJson=document.getElementById('bt-json')?.classList.contains('on');
+  const bodyEl=document.getElementById('xb');const formKV=getKV('f-rows');let curlParts='';
+  if(files.length){
+    const fd=new FormData();for(const f of files)fd.append(f.field,f.file);
+    if(!isJson&&formKV)for(const[k,v]of Object.entries(formKV))fd.append(k,v);
+    opts.body=fd;delete opts.headers['Content-Type'];
+    for(const f of files)curlParts+=' -F "'+f.field+'=@'+f.file.name+'"';
+    if(!isJson&&formKV)for(const[k,v]of Object.entries(formKV))curlParts+=' -F "'+k+'='+v+'"';
+  }else if(isJson){
+    const b=bodyEl?.value?.trim();
+    if(b&&C.method!=='GET'){opts.body=b;curlParts=" -d '"+b+"'";}
+  }else if(formKV){
+    const fd=new FormData();for(const[k,v]of Object.entries(formKV))fd.append(k,v);opts.body=fd;delete opts.headers['Content-Type'];
+    for(const[k,v]of Object.entries(formKV))curlParts+=' -F "'+k+'='+v+'"';
+  }
+  let curl='curl -X '+C.method;
+  for(const[k,v]of Object.entries(opts.headers)){if(k&&v)curl+=" -H '"+k+": "+v+"'";}
+  if(token&&authType==='cookie')curl+=" --cookie 'HOTIME="+token+"'";
+  curl+=curlParts+' '+location.origin+url;
+  const curlBox=document.getElementById('curl-box');if(curlBox)curlBox.textContent=curl;
+  rswitch(1);
+  const t0=Date.now();
+  try{
+    const r=await fetch(url,opts);const ms=Date.now()-t0;const txt=await r.text();let pretty=txt;
+    try{pretty=JSON.stringify(JSON.parse(txt),null,2);}catch(e){}
+    const st=document.getElementById('resp-st');if(st)st.innerHTML='<span style="color:'+(r.ok?'var(--green)':'var(--red)')+'">HTTP '+r.status+'</span> <span style="color:#555">'+ms+'ms</span>';
+    const rb=document.getElementById('resp-body');if(rb)rb.textContent=pretty;
+  }catch(e){
+    const st=document.getElementById('resp-st');if(st)st.innerHTML='<span style="color:var(--red)">失败</span>';
+    const rb=document.getElementById('resp-body');if(rb)rb.textContent=e.message;
+  }
+  btn.disabled=false;btn.textContent='发送';
+}
+
+function copyEl(id){navigator.clipboard.writeText(document.getElementById(id).textContent).then(()=>{const b=event.target;b.textContent='已复制';setTimeout(()=>{b.textContent='复制'},1200);});}
+function cpNext(btn){let el=btn.closest('h5').nextElementSibling;let t='';while(el&&el.tagName!=='H5'){if(el.tagName==='PRE')t+=(t?'\n':'')+el.textContent;el=el.nextElementSibling;}navigator.clipboard.writeText(t).then(()=>{btn.textContent='已复制';setTimeout(()=>{btn.textContent='复制'},1200);});}
+function fj(o){return esc(JSON.stringify(o,null,2));}
+function fjp(o,params){
+  if(!params||!params.length||typeof o!=='object'||o===null||Array.isArray(o))return fj(o);
+  const rq=new Set(params.filter(p=>p.required).map(p=>p.name));
+  const keys=Object.keys(o).sort((a,b)=>(rq.has(b)?1:0)-(rq.has(a)?1:0));
+  const lines=keys.map(k=>'  "'+(rq.has(k)?'*':'')+k+'": '+JSON.stringify(o[k]));
+  return esc('{\n'+lines.join(',\n')+'\n}');
+}
+function kvList(o,params){
+  const rq=new Set((params||[]).filter(p=>p.required).map(p=>p.name));
+  let h='';
+  for(const[k,v]of Object.entries(o)){
+    const star=rq.has(k)?'<span class="req-star">*</span>':'';
+    h+='<div class="kv-ro">'+star+'<span class="kk">'+esc(k)+'</span><span class="vv">'+esc(String(v))+'</span></div>';
+  }
+  return h;
+}
+function esc(s){return String(s).replace(/&/g,'&amp;').replace(/</g,'&lt;').replace(/>/g,'&gt;').replace(/"/g,'&quot;');}
+</script></body></html>
@@ -0,0 +1,19 @@
+<!DOCTYPE html>
+<html lang="zh-CN"><head><meta charset="utf-8"><title>API 文档中心</title>
+<style>
+:root{--bg:#1a1a2e;--bg2:#16213e;--bg3:#0f3460;--fg:#e0e0e0;--fg2:#888;--accent:#4fc3f7;--border:#2a2a4a}
+*{box-sizing:border-box;margin:0;padding:0}
+body{min-height:100vh;background:var(--bg);color:var(--fg);font:14px/1.6 -apple-system,sans-serif;display:flex;flex-direction:column;align-items:center;padding:60px 20px}
+h1{font-size:24px;color:var(--accent);margin-bottom:8px}
+.desc{color:var(--fg2);margin-bottom:40px;font-size:13px}
+.grid{display:grid;grid-template-columns:repeat(auto-fill,minmax(240px,1fr));gap:16px;width:100%;max-width:900px}
+.card{display:block;background:var(--bg2);border:1px solid var(--border);border-radius:8px;padding:24px 20px;text-decoration:none;color:var(--fg);transition:all .2s}
+.card:hover{border-color:var(--accent);transform:translateY(-2px);box-shadow:0 4px 20px rgba(79,195,247,.15)}
+.icon{font-size:20px;font-weight:700;color:var(--accent);margin-bottom:8px}
+.title{font-size:15px;font-weight:600;margin-bottom:4px}
+.sub{font-size:12px;color:var(--fg2)}
+</style></head><body>
+<h1>API 文档中心</h1>
+<div class="desc">选择一个模块查看接口文档与调试控制台</div>
+<div class="grid"><a class="card" href="app/index.html"><div class="icon">App</div><div class="title">My API</div><div class="sub">app/</div></a></div>
+</body></html>