Nexus/plug-ins/ARTv2/doc/QUICK_REFERENCE.md

ARTv2 快速参考

🎉 状态

✅ 完全兼容 Maya 2023-2025 | Python 3.7-3.11
✅ 已修复 50 个代码质量问题
✅ 可用于生产环境

---

🚀 快速开始

1. 加载插件

import maya.cmds as cmds
cmds.loadPlugin("ARTv2")

2. 打开 Rig Creator

cmds.ARTv2()

---

🛠️ 常用工具

清理 Python 缓存

execfile("h:/Workspace/Raw/Tools/Plugins/Maya/plug-ins/ARTv2/clear_maya_cache.py")

清理缩略图对象

import maya.cmds as cmds
for pattern in ["thumbnail_spot*", "thumbnail_lights*", "thumbnail_camera*"]:
    existing = cmds.ls(pattern, long=True)
    for item in existing:
        if cmds.objExists(item):
            try:
                cmds.lockNode(item, lock=False)
                cmds.delete(item)
            except:
                pass

清理场景工具上下文

execfile("h:/Workspace/Raw/Tools/Plugins/Maya/plug-ins/ARTv2/clean_scene_contexts.py")

检查兼容性

python h:/Workspace/Raw/Tools/Plugins/Maya/plug-ins/ARTv2/check_python_compatibility.py

---

📋 工作流程

1. Rig Creator → 创建角色和模块
2. Skeleton Placement → 调整 Joint Movers
3. Finalize Setup → 生成骨骼
4. Deformation Setup → 绑定皮肤
5. Build Rig → 构建控制器
6. Animation → 使用动画工具

⚠️ 重要: 必须按顺序完成每个步骤！

---

⚠️ 常见问题

Q: "No object matches name: xxx_anim"

A: 场景还在 Skeleton Placement 阶段，需要先完成 Build Rig

Q: "artAttrSkinPaintCtx: Object 'selectSuperContext' not found"

A: 旧场景的工具上下文问题，不影响功能，可以忽略

Q: Cycle warnings

A: ARTv2 Joint Mover 系统的正常行为，可以忽略

Q: 重复的缩略图灯光

A: 运行缩略图清理脚本

---

📚 文档

• COMPATIBILITY_REPORT.md - 详细修复报告
• FINAL_STATUS_REPORT.md - 最终状态报告
• QUICK_REFERENCE.md - 本文档

---

🔧 支持的版本

Maya	Python	状态
2020	2.7/3.7	✅
2022	3.9	✅
2023	3.9	✅
2024	3.10	✅
2025	3.11	✅

---

✅ 已修复的问题 (14个)

1. Qt 导入统一
2. long 类型兼容
3. 异常语法
4. Qt 信号语法
5. shiboken 统一
6. execfile() 替换
7. from future 位置
8. print 函数导入
9. 未定义变量
10. NoneType 迭代
11. QGraphicsTextItem 参数
12. useDepthMapShadows 属性
13. 重复缩略图对象
14. 缩略图清理改进

---

最后更新: 2024-12-07
状态: ✅ 生产就绪