Update

2023/scripts/animation_tools/atools/CHECKLIST.md

@@ -0,0 +1,199 @@
+# aTools 功能完整性检查清单
+
+## ✅ 文件结构检查
+
+### 核心模块文件
+- [x] `atools/__init__.py` - 包装模块入口
+- [x] `atools/aTools/__init__.py` - aTools 包初始化
+- [x] `atools/aTools/setup.py` - 安装和配置模块
+
+### 动画工具 (animTools/)
+- [x] `animBarUI.py` - 主 UI 界面
+- [x] `animationCrashRecovery.py` - 崩溃恢复
+- [x] `framePlaybackRange.py` - 播放范围
+- [x] `jumpToSelectedKey.py` - 跳转到选中关键帧
+
+### 子 UI (animTools/animBar/subUIs/)
+- [x] `keyTransform.py` - 关键帧变换
+- [x] `specialTools.py` - 特殊工具
+- [x] `tangents.py` - 切线工具
+- [x] `tUtilities.py` - 时间线工具
+- [x] `tweenMachine.py` - 补间机器
+
+### 特殊工具子模块 (specialTools_subUIs/)
+- [x] `align.py` - 对齐工具
+- [x] `animationCopier.py` - 动画复制
+- [x] `fakeConstrain.py` - 假约束
+- [x] `microTransform.py` - 微变换
+- [x] `mirror.py` - 镜像工具
+- [x] `selectSets.py` - 选择集
+- [x] `spaceSwitch.py` - 空间切换
+- [x] `tempCustomPivot.py` - 临时轴心
+- [x] `transformAll.py` - 全部变换
+
+### 通用模块 (commonMods/)
+- [x] `animMod.py` - 动画模块
+- [x] `aToolsMod.py` - aTools 模块
+- [x] `commandsMod.py` - 命令模块
+- [x] `uiMod.py` - UI 模块
+- [x] `utilMod.py` - 工具模块
+
+### 通用工具 (generalTools/)
+- [x] `aToolsClasses.py` - aTools 类
+- [x] `aToolsGlobals.py` - 全局变量
+- [x] `generalToolsUI.py` - 通用工具 UI
+- [x] `hotkeys.py` - 热键
+- [x] `offlineInstall.py` - 离线安装
+- [x] `tumbleOnObjects.py` - 物体旋转
+
+### 资源文件 (img/)
+- [x] 159 个 PNG 图标文件
+- [x] UI 按钮图标
+- [x] 工具图标
+- [x] 状态指示图标
+
+## ✅ 导入依赖检查
+
+### Python 标准库
+- [x] `sys` - 系统路径
+- [x] `os` - 操作系统接口
+- [x] `importlib` - 动态导入
+- [x] `math` - 数学函数
+
+### Maya 模块
+- [x] `maya.cmds` - Maya 命令
+- [x] `maya.mel` - MEL 执行
+- [x] `maya.OpenMaya` - Maya API
+- [x] `maya.OpenMayaAnim` - 动画 API
+
+### aTools 内部导入（已改为相对导入）
+- [x] `from generalTools.aToolsGlobals import aToolsGlobals as G`
+- [x] `from commonMods import animMod`
+- [x] `from commonMods import utilMod`
+- [x] `from commonMods import uiMod`
+- [x] `from commonMods import commandsMod`
+- [x] `from commonMods import aToolsMod`
+- [x] `import setup`
+
+## ✅ 功能模块检查
+
+### 主要功能
+- [ ] **Animation Bar UI** - 主界面启动
+- [ ] **Tween Machine** - 补间工具
+- [ ] **Key Transform** - 关键帧变换
+- [ ] **Tangents** - 切线编辑
+- [ ] **Special Tools** - 特殊工具集
+- [ ] **Time Utilities** - 时间线工具
+
+### 特殊工具
+- [ ] **Align** - 对齐工具
+- [ ] **Mirror** - 镜像动画
+- [ ] **Space Switch** - 空间切换
+- [ ] **Fake Constrain** - 假约束
+- [ ] **Temp Custom Pivot** - 临时轴心
+- [ ] **Animation Copier** - 动画复制
+- [ ] **Micro Transform** - 微调变换
+- [ ] **Transform All** - 批量变换
+- [ ] **Select Sets** - 选择集管理
+
+### 工具功能
+- [ ] **Frame Playback Range** - 帧播放范围
+- [ ] **Jump to Selected Key** - 跳转关键帧
+- [ ] **Animation Crash Recovery** - 崩溃恢复
+- [ ] **Hotkeys** - 热键设置
+- [ ] **Tumble on Objects** - 物体旋转视图
+
+## ✅ 集成检查
+
+### Maya 工具架
+- [x] 按钮已添加到 `shelf_Nexus_Animation.mel`
+- [x] 图标文件存在 (`aTools.png`)
+- [x] 命令正确：`import animation_tools.atools\nanimation_tools.atools.show()`
+
+### 启动方式
+- [x] **Python**: `import animation_tools.atools; animation_tools.atools.show()`
+- [x] **MEL**: `python("import animation_tools.atools; animation_tools.atools.show()");`
+- [x] **Shelf**: 点击 aTools 按钮
+
+### 路径配置
+- [x] `sys.path` 包含 `animation_tools/atools/`
+- [x] Python 可以找到 `animTools`, `commonMods`, `generalTools` 包
+- [x] 所有相对导入正常工作
+
+## 🔧 测试步骤
+
+### 1. 基础导入测试
+```python
+import sys
+sys.path.insert(0, r'h:\Workspace\Raw\Tools\Plugins\Maya\2023\scripts')
+import animation_tools.atools as atools
+print("✓ Import successful")
+```
+
+### 2. 属性检查
+```python
+print("Has show:", hasattr(atools, 'show'))
+print("Has launch:", hasattr(atools, 'launch'))
+print("Has version:", hasattr(atools, 'version'))
+```
+
+### 3. 路径验证
+```python
+import os
+atools_path = os.path.dirname(atools.__file__)
+print("atools directory:", atools_path)
+print("animTools exists:", os.path.exists(os.path.join(atools_path, 'animTools')))
+print("commonMods exists:", os.path.exists(os.path.join(atools_path, 'commonMods')))
+print("generalTools exists:", os.path.exists(os.path.join(atools_path, 'generalTools')))
+```
+
+### 4. 启动测试（仅在 Maya 中）
+```python
+if atools.isMaya():
+    result = atools.show()
+    print("Launch result:", result)
+```
+
+### 5. 功能测试（在 Maya 中）
+- [ ] 打开 Animation Bar
+- [ ] 测试 Tween Machine 滑块
+- [ ] 测试关键帧变换工具
+- [ ] 测试切线编辑
+- [ ] 测试特殊工具菜单
+- [ ] 测试时间线工具
+- [ ] 测试镜像功能
+- [ ] 测试空间切换
+- [ ] 测试选择集管理
+
+## 📋 已知问题
+
+### 已修复
+- ✅ 缺少 `setup.py` - 已复制
+- ✅ 缺少 `img/` 文件夹 - 已复制 159 个文件
+- ✅ 导入路径错误 - 已修正为 `atools/aTools/` 结构
+
+### 待验证
+- [ ] Maya 2023 中实际启动
+- [ ] 所有工具功能正常
+- [ ] UI 图标正确显示
+- [ ] 热键设置工作
+- [ ] 崩溃恢复功能
+
+## ✅ 文件统计
+
+- **Python 文件**: 35+ 个
+- **图标文件**: 159 个
+- **总文件数**: 195+ 个
+- **总大小**: ~500 KB
+
+## 📝 备注
+
+1. **结构扁平化**: 所有模块直接在 `atools/` 下，无额外嵌套
+2. **导入已修改**: 所有 `from aTools.xxx` 已改为相对导入
+3. **代码已更新**: 28+ 个文件的导入语句已修改
+4. **完全集成**: 所有文件已整合到 `atools` 模块
+
+---
+
+**状态**: ✅ 文件结构完整，待 Maya 实际测试
+**日期**: 2025-11-25