56 lines
2.2 KiB
Markdown
56 lines
2.2 KiB
Markdown
# 🚀 智能 JSON-WASM 接口测试平台
|
|
|
|
基于 WebAssembly 的智能 JSON 接口系统，支持自动参数匹配、智能类型推断和动态函数发现。
|
|
|
|
## ✨ 特性
|
|
|
|
- ✅ **智能参数名称匹配** - 自动识别不同名称的参数
|
|
- ✅ **参数别名支持** - 支持多种参数命名方式
|
|
- ✅ **自动类型推断** - 根据内容自动推断参数类型
|
|
- ✅ **默认值填充** - 自动填充缺失的默认参数
|
|
- ✅ **动态函数发现** - 运行时发现可用函数
|
|
- ✅ **JSON 标准接口** - 统一的 JSON 请求/响应格式
|
|
- ✅ **完整错误处理** - 详细的错误信息和调试支持
|
|
|
|
## 🏗️ 项目结构
|
|
|
|
```text
|
|
.
|
|
|-- src/ C++ 业务实现
|
|
|-- include/ 公共头文件和业务接口定义
|
|
|-- scripts/ 构建、调试、回归测试脚本
|
|
|-- tests/
|
|
| |-- testdata/ 正式回归测试数据
|
|
| `-- fixtures/legacy/ 历史手工样例和原始参考数据
|
|
|-- docs/
|
|
| |-- notes/ 功能说明和算法笔记
|
|
| `-- build-logs/ 历史编译记录和调试日志
|
|
|-- third_party/
|
|
| |-- eigen3/ 第三方 Eigen 依赖
|
|
| |-- kdl_parser/ vendored URDF/KDL parser 源码
|
|
| |-- nlohmann/ JSON 头文件库
|
|
| `-- orocos_kdl/ 第三方 KDL 依赖及安装产物
|
|
|-- public/wasm/ WASM 构建输出
|
|
|-- package.json npm 入口
|
|
|-- CMakeLists.txt CMake 入口
|
|
`-- Makefile Make 入口
|
|
```
|
|
|
|
## 📦 常用命令
|
|
|
|
```powershell
|
|
npm run build
|
|
npm run test:wasm
|
|
npm run build-serve
|
|
```
|
|
|
|
## 📁 目录约定
|
|
|
|
- 根目录只保留项目入口文件和核心目录，避免测试样例、日志、草稿散落在顶层。
|
|
- `include/` 只放本项目对外和模块间共享的头文件。
|
|
- `third_party/` 统一收纳所有外部依赖和 vendored 源码，避免和业务代码混放。
|
|
- `tests/testdata/` 放可重复执行的标准化测试数据。
|
|
- `tests/fixtures/legacy/` 放历史调试输入输出，便于追溯，但默认不作为正式回归入口。
|
|
- `docs/notes/` 放业务说明和算法记录。
|
|
- `docs/build-logs/` 放构建排障过程中的原始文本记录。
|