# 🚀 智能 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/` 放构建排障过程中的原始文本记录。
