BlenderRetopology技能
Claude Code技能，为Blender MCP提供手动重新布局工作流程指导。使用经过验证的拓扑技术将高多边形雕刻转换为干净、可用于动画的四边形网格。
概述
这项技能将手动工作流程中的专家重组知识编码为结构化的指导，克劳德在使用Blender MCP时可以利用这些指导。该技能不是依赖于自动重网格（很少产生最佳结果），而是教授以下基本原理： 所有重新布局都简化为三种形状：圆形、矩形和圆柱体.
它的作用
- 指导拓扑岛创建：将复杂模型分解为可管理的基于特征的区域
- 提供边缘流动模式：连接岛的4比2、3比1和2比1缩减模式
- 确保网格动画就绪：正确放置环以防止接头变形
- 保持仅四元拓扑：干净的循环切割，没有三角形阻挡细分
- 优化多计数：从最低限度开始，只在需要的地方添加细节
何时使用
触发短语包括：
- “使用BlenderRetopology技能”
- “道歉”、“道歉”
- “减少多晶硅数量”、“低多晶硅版本”
- “干净拓扑”、“边环”
- “四边形网格”、“拓扑岛”
- “动画就绪网格”、“游戏就绪网格”
安装
克劳德代码
- 下载
.skill文件来自 发布 - 放在您的Claude Code技能目录中：
~/.claude/skills/blender-retopology.skill- 触发后，技能将自动加载
手动安装
克隆存储库并复制技能文件夹：
git clone https://github.com/MushroomFleet/BlenderRetopology-Skill.git
cp -r BlenderRetopology-Skill/blender-retopology ~/.claude/skills/用法
基本用法
在向Blender MCP发送指令之前，在提示中添加触发短语：
Using BlenderRetopology skill, retopologize this sculpted head mesh for animation.示例提示
完整的角色重组：
Using BlenderRetopology skill, create a game-ready version of my character sculpt.
Target 10k polys with proper edge loops at joints.具体功能工作：
Using BlenderRetopology skill, retopologize just the hand. I need clean topology
for finger deformation with 8 edges per finger.拓扑修复：
Using BlenderRetopology skill, fix the edge flow around the mouth area.
The current loops don't support proper lip deformation.技能内容
blender-retopology/
├── SKILL.md # Main skill instructions
└── references/
└── patterns.md # Detailed edge reduction patterns技能.md
核心工作流程指南包括：
- 设置顺序（备份、抽取、收缩、快照设置）
- 三形学说（圆、矩形、圆柱体）
- 拓扑岛策略
- 用基于极点的模式连接岛屿
- 循环切割验证
- 平滑工作流程
- MCP操作映射
- 常见问题排查
参考文献/模式.md
详细参考资料：
- 缩减模式的ASCII图（4到2、3到1、2到1）
- 用于各种边数的圆形填充图案
- 带解剖位置的电极放置指南
- 头部和手部拓扑结构故障
- 动画关键循环要求
- 边数匹配公式
核心概念
三种形状
| 形状 | 用例 | 关键规则 |
|---|---|---|
| 圆形 | 盖子、手指、圆柱形特征 | 边缘计数始终均匀 |
| 矩形 | 扁平填充物、连接器 | 双向环形切割 |
| 圆柱体 | 身体部位、四肢、躯干 | 圆形帽子+矩形身体 |
拓扑岛
每个模型都分解为孤岛——主要特征的自包含拓扑区域：
- 脸、身体、手、脚、耳朵（主要岛屿）
- 眼睛、嘴巴、鼻子（面部亚岛）
- 单个手指（手中的子岛屿）
当边缘计数不匹配时，岛屿使用缩减模式连接。
4比2模式
最常见的连接模式。示例：将4个手指（共32条边）连接到手掌（18条边）：
- 水平连接手指岛
- 在接缝处涂上4到2的图案
- 验证回路切割流量是否正确
需求
- 搅拌机MCP已配置且可访问
- 启用技能支持的Claude Code
贡献
欢迎投稿！需要改进的地方：
- 其他解剖拓扑结构分解
- 更多边缘流型图
- Blender版本特定指南
- 具有特定MCP功能的集成示例
许可证
MIT许可证-有关详细信息，请参阅许可证文件。
______________________________________________________________________
📚 引用
学术引文
如果您在研究或项目中使用此代码库，请引用：
@software{blender_retopology_skill,
title = {BlenderRetopology-Skill: Manual Retopology Workflow Guidance for Blender MCP},
author = {Drift Johnson},
year = {2025},
url = {https://github.com/MushroomFleet/BlenderRetopology-Skill},
version = {1.0.0}
}捐赠
______________________________________________________________________
支持这个项目
如果你觉得这有用，请 明星回购 --它帮助别人发现它！
](https://github.com/MushroomFleet/BlenderRetopology-Skill)