docs: update docs

Author: soulteary

docs/NAMING_IMPROVEMENTS.md

@@ -39,9 +39,9 @@ namespace hand {
 | L25/L21 | `LinkerHandL25::LinkerHand` | `linkerhand::hand::L25Hand` | `linkerhand::hand` |
 | Modbus L10 | `ModbusLinkerHandL10::LinkerHand` | `linkerhand::hand::ModbusL10Hand` | `linkerhand::hand` |
 
-### 3. 帧属性枚举重命名
+### 3. 帧属性枚举重命名和改进
 
-各型号的帧属性枚举已重命名，使用更清晰的命名：
+各型号的帧属性枚举已重命名，使用更清晰的命名，并改为使用 `enum class` 以避免命名冲突：
 
 | 型号 | 旧枚举名 | 新枚举名 |
 |------|---------|---------|
@@ -51,6 +51,23 @@ namespace hand {
 | L20 | `LinkerHandL20::FRAME_PROPERTY` | `linkerhand::hand::L20FrameProperty` |
 | L25/L21 | `LinkerHandL25::FRAME_PROPERTY` | `linkerhand::hand::L25FrameProperty` |
 
+**重要改进**：
+- 枚举类型从 `typedef enum` 改为 `enum class`（C++11 强类型枚举）
+- 解决了多个枚举类型之间的命名冲突问题
+- 枚举值现在需要使用作用域限定符访问（如 `L6FrameProperty::JOINT_POSITION`）
+
+**使用示例**：
+```cpp
+// 旧方式（已废弃，但仍可通过向后兼容别名使用）
+LinkerHandL6::FRAME_PROPERTY prop = LinkerHandL6::FRAME_PROPERTY::JOINT_POSITION;
+
+// 新方式（推荐）
+linkerhand::hand::L6FrameProperty prop = linkerhand::hand::L6FrameProperty::JOINT_POSITION;
+
+// 转换为整数（用于 CAN 帧）
+uint8_t frameProperty = static_cast<uint8_t>(linkerhand::hand::L6FrameProperty::JOINT_POSITION);
+```
+
 ### 4. 参数命名修正
 
 修正了错误的参数命名：
@@ -147,7 +164,11 @@ LinkerHandL10::LinkerHand hand(0x27, "can0", 1000000);
 
 1. **工厂类**：`HandFactory` 已更新为使用新类名，但返回类型仍然是 `IHand` 接口
 2. **头文件**：头文件名暂时保持不变，未来可以考虑重命名
-3. **枚举**：帧属性枚举已重命名，但枚举值保持不变
+3. **枚举**：
+   - 帧属性枚举已重命名，枚举值保持不变
+   - 枚举类型已改为 `enum class`，需要使用作用域限定符访问枚举值
+   - 这解决了多个枚举类型之间的命名冲突问题（如 `JOINT_POSITION`、`TORQUE_LIMIT` 等）
+   - 如果需要将枚举值转换为整数，使用 `static_cast<uint8_t>()`
 
 ## 相关文件
 

docs/TROUBLESHOOTING.md

@@ -107,6 +107,39 @@ undefined reference to `LinkerHandApi::...`
 
 ---
 
+### 问题：枚举命名冲突编译错误
+
+**错误信息**:
+```
+error: 'JOINT_POSITION' conflicts with a previous declaration
+error: 'TORQUE_LIMIT' conflicts with a previous declaration
+error: 'TOUCH_SENSOR_TYPE' conflicts with a previous declaration
+```
+
+**可能原因**:
+在旧版本中，多个枚举类型（`L6FrameProperty`、`L7FrameProperty`、`L10FrameProperty` 等）使用 `typedef enum`，导致枚举值泄漏到外层命名空间，当多个头文件同时被包含时会发生命名冲突。
+
+**解决方案**:
+此问题已在最新版本中修复。所有枚举类型已改为使用 `enum class`（C++11 强类型枚举），每个枚举值都在自己的作用域内，不会发生命名冲突。
+
+**如果使用旧版本**:
+1. 升级到最新版本的 SDK
+2. 如果必须使用旧版本，可以：
+   - 避免同时包含多个型号的头文件
+   - 使用前向声明和单独编译单元
+   - 使用命名空间别名隔离不同的枚举类型
+
+**新版本使用方式**:
+```cpp
+// 使用作用域限定符访问枚举值
+linkerhand::hand::L6FrameProperty prop = linkerhand::hand::L6FrameProperty::JOINT_POSITION;
+
+// 转换为整数（用于 CAN 帧）
+uint8_t frameProperty = static_cast<uint8_t>(linkerhand::hand::L6FrameProperty::JOINT_POSITION);
+```
+
+---
+
 ### 问题：CMake 版本过低
 
 **错误信息**: