# 03 `maven-cloudwalk-device-sdk` — 阿里巴巴规范走查（整理版）

**范围**：`maven-cloudwalk-device-sdk/**/*.java`（排除 `target/`），约 **162** 个文件。

## 主要发现

| 类别 | 说明 |
|------|------|
| **序列化** | 大量 `implements Serializable` 的 DTO/Param **未声明 `serialVersionUID`**（约数十个文件）；内部静态类序列化缺独立 UID。 |
| **命名** | `NotifyUploadPanoramamResult`（Panorama）、`FaceRegistionParam`（Registration）等拼写疑点；内部类名 `deviceData`、`helmetsData` 等小写开头不符合类型 UpperCamelCase。 |
| **格式** | 部分文件 `package` 与类型声明间**大段空行**；若仍残留 `/* N */` 行号注释，应继续跑 `scripts/strip_jdcore_java_noise.py`。 |
| **启发式** | 与 `00-heuristic-scan.md` 一致：`DeviceV2CommonBaseDTO` 等存在**行尾空白**；未见 `System.out`、空 catch。 |

## 建议优先级

1. 为对外 DTO 统一 **`serialVersionUID`** 策略（或评估 Protobuf/JSON 单一序列化路径）。  
2. 修正对外可见的**拼写错误**类名时评估协议兼容（`@JSONField` 别名等）。  
3. IDE **格式化** + 去除反编译行号噪声。