Back to search
cxp-character-forge
SkillWorks with Claude CodeGitHub
从参考立绘通过 Tripo 兼容代理生成带贴图的 3D 人物,接续 Blender 外形检查、组件修整、按需绑骨动作与资产交付。用于人物建模和已有生成任务续作。
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Checked yesterday
Badge for your README
Markdown
[](/listings/cxp-2024--cxp-character-forge)HTML
<a href="/listings/cxp-2024--cxp-character-forge"><img src="/api/listings/cxp-2024--cxp-character-forge/badge.svg" alt="findsafeskills safety rating" /></a>Install
i
What was scanned
The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.
SKILL.md · Manifest · 40 lines
- ---
- name: cxp-character-forge
- description: 从参考立绘通过 Tripo 兼容代理生成带贴图的 3D 人物,接续 Blender 外形检查、组件修整、按需绑骨动作与资产交付。用于人物建模和已有生成任务续作。
- ---
- # CXP Character Forge
- 使用本 skill 目录下的 `scripts/tripo_proxy.py`。首次安装执行 `python scripts/bootstrap.py` 获取固定版本依赖;读取 README 的配置方式。只向用户配置的代理地址发送密钥,不调用上游官方 CLI 的 configure。
- ## 任务与参考
- 尊重用户确认的设计、比例、定稿版本与静态/动画用途。先查已有资产和任务记录,避免重复生成。造新人物先确认本机装有 [Charakuru](https://github.com/nanocle/Charakuru) 源码(Releases 下载解压;Node 22+、Blender 5.2、VRM Add-on),作为三视图、重贴图分组、UV 恢复、权重迁移、表情与摇摆物理的方法库,见 [Charakuru 方法](references/charakuru-methods.md)。推荐路线:T 型正背设定图 → **整体一次生成**(每次只调用 1 个任务,不并行、不抽卡,非常耗积分)→ 灰模与网格检查,当场试拆头、头发/刘海、饰品、裙子(拆不开就改图重生成)→ 快速绑定并套一段简单 MMD 动作校验骨架,让 AI 修骨骼节点和权重 → Tripo 重贴图并转回 UV(最耗时)→ 表情 → 最后做物理;制作期间二次元角色默认用原神式快速三渲二材质加灰模检查(渲染快、方便迭代),最后一步才用 [genshin-blender-render](https://github.com/CXP-2024/genshin-blender-render) 做精细渲染;眼睛、嘴部和表情三样缺一不做:Charakuru 方法论、目标原脸型不变、参考角色的完整表情网络与贴图(含口腔结构),见 [表情前提](references/facial-expressions.md)、[眼眉流程](references/eye-brow-expression-workflow.md);**不要把头和身体分开生成**(颈部接缝、比例、肤色难以接上,这点与 Charakuru 原版不同)。步骤、经验与 MMD 细节见 [人物流程](references/character-workflow.md);组件拆分清单和每个组件该用 Tripo / Codex 投影 / 几何生成 / 平涂见 [分组件贴图](references/component-texturing.md),脚本在 `scripts/component_tex/`。与 MMD / 原神 PMX 角色同框时的眼睛精细化(眼白上睑阴影、分层瞳孔、发光闪点)见 [眼睛精细化](references/eye-refinement.md),脚本在 `scripts/eye_refine/`。Houdini 无界面裙发解算见 [houdini-cloth-hair](references/houdini-cloth-hair.md);整首分段解算、已认可段只解后段拼接、真实多层裙解算(层间缝合、裙撑、灰模验收)、远端 Linux 安装、授权按机器占用的规则与分块整理见 [houdini-fullsong-remote](references/houdini-fullsong-remote.md),脚本在 `scripts/houdini_song/`。
- 先核对 A/T 姿态、头身比例、手指、前后轮廓与遮挡。多视图必须同角色同姿态;不可靠侧背图不应强行参与生成。隐藏面属于补全假设。
- ## 生成与恢复
- - `doctor` 离线检查配置;`doctor --online` 只读验证;`models`、`balance` 查询模型与余额。配置服务兼容约定见 [代理 API](references/proxy-api.md)。
- - 获取当前模型 value、支持参数和价格,不把历史型号或代理参数当作官方通用规格。已有制作授权内可执行生成;仅连接测试不要提交付费任务。
- - 优先带原生纹理生成,尽早查看真正的贴图模型。灰模用于辅助诊断,不能代替带纹理检查。
- - `upload --file reference.png --record uploads/front.json` 上传参考;将返回 token 与当前 model value 填入 examples/image-to-model.json 的副本。
- - `submit --request request.json --job jobs/v1 --dry-run` 离线校验后,使用同命令 `--execute` 提交。
- - `wait --job jobs/v1 --timeout 45`,退出码 3 表示继续等待;成功后 `download --job jobs/v1 --extract`。
- - 同请求复用 job;改参数用新目录。POST 结果未知时先对账再 recover,不盲目重提。原生下载与收费格式转换要区分。
- ## Blender 验收
- 保留原始生成文件,在副本中修整。渲染真实模型正面、侧面、背面与旋转检查,不能把二维生成图当模型效果。检查手指、面部、贴图接缝、发根、头饰、尾巴体积与连接、翼根和手臂穿插。
- 保持用户认可的原生贴图与五官比例;三渲二无法修复错误几何或烘焙在贴图中的污染。局部替换需三维贴合与侧面验收,不能只看正面投影。尾巴/头发等组件需有连续根部和适当厚度。
- 静态交付无需强行绑骨。需要动画时执行 prereigcheck → rig → flags/animations → retarget,检查真实变形。MMD 表情、骨骼映射及衣发物理单独制作与验证;两个独立生成头不能直接视为连续眨眼形态键。
- ## 交付
- 按人物与版本组织定稿目录,Blender 贴图内嵌或完整相对路径,按需提供 GLB、真实渲染和旋转视频。报告完成阶段、已检查角度和剩余问题。用户只要模型包时,不夹带视频/过程文件;只报告实际验证过的动画能力。
- 离线回归:`python scripts/test_proxy.py`。脚本检查接口行为,不证明生成质量、蒙皮或物理通过。
- 原生嘴型迁移、VMD 表情轨道接入及嘴周碎片/肤色问题,见 [嘴型迁移与修复](references/mouth-transfer-vmd-repair.md)。
README.md · README · 108 lines
- # CXP Character Forge
- **从一张角色立绘开始,由 AI agent 一步步做出能跳 MMD 舞的 3D 角色。**
- ### ▶ [看成片:用这个 skill 做出来的 DeepSeek 鲸娘双人《愛包ダンスホール》(B 站)](https://www.bilibili.com/video/BV1ALxY6aEH9)
- [](https://www.bilibili.com/video/BV1ALxY6aEH9)
- *点击图片观看。角色模型、贴图、表情、裙子物理和渲染都由 AI agent 按本 skill 的流程完成。*
- 这是一个给 AI 编程 agent(Claude Code、Codex)用的 skill,覆盖从零开始做 MMD 角色的整条流程:设定图 → Tripo 生成模型 → 拆件 → 绑定与骨架校验 → 分组件重贴图 → 眼睛、嘴部和表情 → 衣服和头发物理 → 套 MMD 动作 → 渲染。每一步都写了做法、验收标准,以及实际项目里踩过的坑和解决办法。
- 它不是一键生成器。流程来自一个真实项目的整套制作:DeepSeek 鲸娘,从立绘做到双人跳完整首《愛包ダンスホール》。skill 里写明了哪些步骤做到了什么程度、哪些还需要人来把关。
- ## 交流群
- QQ 群:**1130507071**,欢迎来做技术交流。群里聊 AI 视频、AI 建模、AI 绘画等内容,主打 agent base(dsh、Codex、Claude Code)+ 本地模型。
- ## 流程总览
- | 阶段 | 做什么 | 文档 |
- | --- | --- | --- |
- | 0. 准备 | 安装 [Charakuru](https://github.com/nanocle/Charakuru) 源码,作为方法库(三视图、重贴图分组、权重迁移、表情、摇摆物理) | [character-workflow](references/character-workflow.md) 第 0 步、[charakuru-methods](references/charakuru-methods.md) |
- | 1. 设定图 | 整理出 T 型正背设定图,两张图的基线、头顶、臂展像素对齐 | [character-workflow](references/character-workflow.md) |
- | 2. 生成 | 用 Tripo 一次生成整个人物。**每次只提交一个任务,不抽卡;头和身体不要分开生成** | 同上,以及 [proxy-api](references/proxy-api.md) |
- | 3. 拆件 | 先看灰模,当场试拆头、头发和刘海、饰品、裙子;拆不开就重新生成 | [component-texturing](references/component-texturing.md) |
- | 4. 绑定 | 快速绑定,套一段简单 MMD 舞蹈校验骨架,让 AI 修骨骼节点和权重 | [rigging-physics](references/rigging-physics.md) |
- | 5. 重贴图 | 按组件选方法:Tripo 重贴图、Codex 多视角重画后投影、从几何生成、平涂 | [component-texturing](references/component-texturing.md)、[texture-transfer](references/texture-transfer.md)、[texture-refinement-qa](references/texture-refinement-qa.md) |
- | 6. 表情 | 三样缺一不做:Charakuru 方法、原脸型不变、参考角色的表情网络和贴图 | [facial-expressions](references/facial-expressions.md)、[eye-brow-expression-workflow](references/eye-brow-expression-workflow.md)、[mouth-transfer-vmd-repair](references/mouth-transfer-vmd-repair.md)、[eye-refinement](references/eye-refinement.md) |
- | 7. 物理 | 真实多层裙的 Houdini Vellum 解算(层间缝合、裙撑),整首分段并行解算,远端 Linux 机器的安装与授权 | [houdini-cloth-hair](references/houdini-cloth-hair.md)、[houdini-fullsong-remote](references/houdini-fullsong-remote.md) |
- | 8. 渲染 | 原神风格的三渲二:面部 UV、眼睛分层、服装 ramp、原生 MMD 描边 | 姊妹 skill [genshin-blender-render](https://github.com/CXP-2024/genshin-blender-render) |
- 制作期间二次元角色默认用原神式快速三渲二材质(EEVEE 下几秒一帧,方便反复迭代),最后一步才用渲染 skill 做精细渲染。每个阶段都要求用灰模加这套材质验收,在同一相机下与参考对比,原始资产只读、修改另存新版本。
- ## 推荐安装
- 把本仓库放进 agent 的 skills 目录,agent 就会在做角色时自动加载它。
- **Claude Code**
- ```sh
- git clone https://github.com/CXP-2024/cxp-character-forge.git ~/.claude/skills/cxp-character-forge
- cd ~/.claude/skills/cxp-character-forge
- python scripts/bootstrap.py
- ```
- **Codex**
- ```sh
- git clone https://github.com/CXP-2024/cxp-character-forge.git ~/.codex/skills/cxp-character-forge
- cd ~/.codex/skills/cxp-character-forge
- python scripts/bootstrap.py
- ```
- 装好后直接对 agent 说要做什么角色即可,例如“按这张立绘做一个能跳 MMD 的模型”。Codex 也可以用 `$cxp-character-forge` 显式调用。
- ### 建议一起安装
- | 名称 | 用途 |
- | --- | --- |
- | [Charakuru](https://github.com/nanocle/Charakuru) | 从 Releases 下载解压。本 skill 用它的方法和脚本做三视图、权重迁移、表情和摇摆物理 |
- | [genshin-blender-render](https://github.com/CXP-2024/genshin-blender-render) | 原神风格渲染 |
- | [codex-image-gen-skill](https://github.com/CXP-2024/codex-image-gen-skill) | 本地动漫生图:设定图、参考图和局部重画 |
- | [gcp-blender-render](https://github.com/CXP-2024/gcp-blender-render) / [paratera-blender-render](https://github.com/CXP-2024/paratera-blender-render) | 在云 GPU 上渲染长片 |
- ## 运行环境
- | 需要 | 用在哪里 |
- | --- | --- |
- | Python 3.10+、Git | 全部 |
- | Tripo 兼容代理和自己的密钥 | 生成模型、重贴图 |
- | Blender 5.2 + [mmd_tools](https://github.com/MMD-Blender/blender_mmd_tools) | 拆件、绑定、表情、套 MMD 动作、渲染 |
- | Node.js 22+、VRM Add-on | 运行 Charakuru |
- | Houdini(Indie 即可) | 衣服和头发的 Vellum 解算。授权按机器计算:一份授权同一时间只能在一台机器上用,但这台机器上可以开多个进程 |
- ## 配置 Tripo 代理
- 复制 `proxy-config.example.json` 为 `proxy-config.json`,填写兼容代理地址和本地密钥文件路径。密钥存放在仓库外,文件内容只是服务提供的 token。也可以用 `TRIPO_PROXY_BASE_URL` 和 `TRIPO_PROXY_KEY_FILE` 环境变量。
- 该适配器面向 `/v1`、返回 `{code: "ok", data: ...}` 的兼容代理,密钥格式为 `tp_live_...` / `tp_test_...`。它不能直接接入官方 `/v3`,也不保证兼容任意代理。
- ```sh
- python scripts/tripo_proxy.py doctor # 离线检查配置
- python scripts/tripo_proxy.py doctor --online # 只读联网检查,不提交任务
- python scripts/tripo_proxy.py models
- python scripts/test_proxy.py
- ```
- 只读检查不会提交生成任务。实际生成会消耗服务额度,费用由服务决定。
- ## 仓库结构
- ```
- SKILL.md agent 入口:路线、按任务查资料的索引
- references/ 各阶段的方法、验收标准和踩坑记录
- scripts/tripo_proxy.py Tripo 代理客户端:提交、等待、恢复、下载
- scripts/component_tex/ 分组件重贴图:Tripo 前后 UV 写回、多视角投影烘焙、局部重画、金边纽扣几何、手部平涂、无光照材质
- scripts/eye_refine/ 眼睛精细化:眼白上睑阴影、分层虹膜、发光闪点
- scripts/houdini_song/ Houdini 裙子解算:真实多层裙、整首分段排队、拼接、饰品重挂、灰模检查
- ```
- 脚本里的项目路径都改成了参数或环境变量;各脚本的用法写在文件开头的注释里。
- ## 来源与边界
- 在 Tripo 公开人物工作流和 Charakuru 方法的基础上,我们加了代理客户端、离线回归、分阶段验收流程和一整套制作经验。依赖与来源见 [THIRD_PARTY_NOTICES.md](THIRD_PARTY_NOTICES.md);固定版本下载有 SHA-256 校验。
- 本项目不是 Tripo 或 Charakuru 的官方产品,不包含模型资产、密钥、商业服务额度,也不附带 Charakuru 的人体和表情素材,使用这些素材请遵守它们各自的许可。skill 不承诺全自动产出合格的表情或物理:每一步都需要按文档验收,结果因角色而异。
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.