xnx_api_tester API 测试工具

功能

• 6 阶段自动化测试：覆盖 Bug 修复验证（5 项）、权限细分（6 项）、API 覆盖度（10 项）、插件 API（3 项）、安全增强（5 项）、全端点覆盖（16 项），共 45+ 测试用例

• 可视化测试页：分组展示测试目录，支持单测/全量测试/清理临时 token

• 自动创建测试数据：确保 api_app 表结构完整（capabilities/ip_whitelist/permissions 字段），自动创建 full/readonly 两个测试应用

• HTTP 请求辅助：内部 curl 调用 /api/v1/ 端点，自动处理鉴权（Bearer Token + X-App-Id/Secret）

• 凭据安全：密钥明文存 KV，DB 中 password_hash 存储

• 测试辅助方法：getRealId / getTestAppCreds / authedRequest 等

文件结构

plugin/xnx_api_tester/
├── conf.json
├── install.php / uninstall.php
├── admin.php              # 入口路由：GET 加载目录，POST 执行测试
├── icon.png
├── service/
│   └── ApiTesterService.php  # 45+ 测试用例实现
├── view/htm/
│   └── api_tester.htm    # 测试页 UI
├── hook/
│   └── admin_index_route_case_end.php  # 后台菜单注册
└── lang/{zh-cn,zh-tw,en-us}/
    └── bbs_admin.php

配置流程

1. 后台「插件管理」启用 xnx_api_tester

2. 访问后台侧边栏「API 测试工具」，首次使用自动创建测试数据

3. 点击「运行全部测试」或单独运行某阶段测试

4. 测试结果展示每项用例的通过状态、耗时、详细消息

扩展说明

ApiTesterService 为纯静态类，所有方法通过公开的 runTest($id) / runAllTests() 调用。

Service 类方法

ApiTesterService::getTestCatalog(): array           // 获取 6 阶段测试目录
ApiTesterService::runTest(string $testId): array   // 运行单个测试
ApiTesterService::runAllTests(): array              // 运行所有测试
ApiTesterService::cleanupTempTokens(): int         // 清理测试 token
ApiTesterService::ensureTestData(): array          // 幂等创建/修复测试数据
ApiTesterService::isTestDataReady(): bool          // 检查测试数据就绪

测试 ID 规则

• T1.x：Bug 修复验证

• T2.x：权限细分

• T3.x：API 覆盖度

• T4.x：插件 API

• T5.x：安全增强

• T6.x：全端点覆盖（site/rank/auth/forum/thread/post/user/my/notify/credits/mod/attach/openapi/search/admin 16 个路由文件）

版本 1.0.0 | 兼容 Xiuno 1.1+