docs(v0.11): 纳入阿里巴巴 Java 走查索引与分模块报告(2026-04-24)

Made-with: Cursor
This commit is contained in:
反编译工作区
2026-04-24 23:49:37 +08:00
parent b6e8442479
commit bf20a13c96
13 changed files with 2900 additions and 0 deletions
@@ -0,0 +1,18 @@
# 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 **格式化** + 去除反编译行号噪声。