Update nexus wiki content

wiki/sources/roblox-avatar-creator.md

@@ -2,57 +2,66 @@
 title: "Roblox Avatar Creator Agent Personality"
 type: source
 tags: []
-date: 2026-04-26
+date: 2026-04-30
 ---
 
 ## Source File
-- [[raw/Agent/agency-agents/game-development/roblox-studio/roblox-avatar-creator.md]]
+- [[Agent/agency-agents/game-development/roblox-studio/roblox-avatar-creator.md]]
 
 ## Summary（用中文描述）
-- 核心主题：Roblox UGC（用户生成内容）化身系统专家 AI Agent 人格规范——从建模绑定到 Creator Marketplace 提交的完整 avatar pipeline
-- 问题域：Roblox avatar 配件系统、Layered Clothing 分层服装、Creator Marketplace 合规审核、化身自定义 API
-- 方法/机制：R15 骨骼权重系统；附件点（Attachment）定位；纹理规范（256-1024px PNG）；三角面数硬限制（配件≤4000、Bundle部件≤10000）；InnerCage/OuterCage 双笼系统
-- 结论/价值：提供可直接使用的 Luau 代码模块（HumanoidDescription、Layered Clothing cage setup、UGC Shop UI flow）和 Creator Marketplace 提交检查清单
+- 核心主题：Roblox UGC（用户生成内容）虚拟形象物品设计与发布全流程规范，包括配饰制作、分层服装、贴图标准、Avatar 系统集成和 Creator Marketplace 合规要求。
+- 问题域：如何在 Roblox 平台内创建技术上正确、视觉上精致、平台合规的 Avatar 物品，并成功上架 Creator Marketplace。
+- 方法/机制：通过严格的技术规范（三角面数限制、UV 规范、附件点命名）、Blender 骨骼绑定与 Cage 网格制作、HumanoidDescription API 驱动的游戏内换装系统，以及完整的提交审查流程。
+- 结论/价值：提供了一套从建模 → 绑定 → 测试 → 发布的端到端 UGC Avatar 物品制作方法论，帮助创建者规避 moderation 拒绝，实现 Creator Marketplace 上架目标。
 
 ## Key Claims（用中文描述）
-- UGC 配件网格必须低于 4,000 三角面——超过此限制将导致自动拒绝（Roblox 强制规则）
-- 所有 UGC 配件必须使用单个 UV 通道，UV 范围严格限制在 [0,1] 空间内——超出该范围将导致贴图采样错误
-- Layered Clothing 配件必须同时包含外层网格和 InnerCage 网格——缺失 InnerCage 将导致服装穿透过角色身体
-- 化身附件必须使用标准命名：HatAttachment、FaceFrontAttachment、LeftShoulderAttachment 等——命名错误导致跨 body type 附件失效
-- Creator Marketplace 商品名称必须准确描述商品——误导性名称将触发审核暂停
+- UGC 配饰网格必须低于 4,000 三角面，超过则自动被平台拒绝。
+- 所有网格必须是单一物体、单一 UV 通道，UV 范围限制在 [0,1] 空间内，禁止超出范围的重叠 UV。
+- 分层服装（Layered Clothing）必须同时包含外层网格和内层变形 Cage 网格（_InnerCage），缺少内层 Cage 会导致服装穿透 Avatar 身体。
+- 配饰通过 `Attachment` 对象附件至 Avatar，附件点名称必须与 Roblox 标准一致（如 HatAttachment、FaceFrontAttachment）。
+- 贴图分辨率为 256×256 至 1024×1024，格式为 PNG（带透明通道的配饰需 RGBA），UV island 边缘至少 2px 内边距。
+- 所有变换必须先应用（scale=1, rotation=0）再导出，导出格式：带绑定的配饰用 .fbx，不变形的简单配饰用 .obj。
+- 物品提交后需通过 Roblox 自动 moderation 和人工审核（精选物品），审核周期通常 24-72 小时。
+- 体验内 Avatar 自定义通过 `HumanoidDescription` API 实现，支持在不刷新角色的情况下动态应用换装。
+- R15/Rthro 兼容性要求在 Classic、R15 Normal、R15 Rthro 等多种体型上测试配饰，防止穿插。
+- UGC Limited 物品需要建立创作者账户记录，并设计符合二级市场价值的内容以吸引买家。
 
 ## Key Quotes
-> "4,000 triangles is the hard limit — model to 3,800 to leave room for exporter overhead" — Roblox 网格三角面数规范：留 200 面余量防止导出器开销
-> "Looks great in Blender — now test it on Rthro Broad in a run cycle before submitting" — 测试原则：必须覆盖所有 5 种 body type 动画循环
-> "That logo will get flagged — use an original design instead" — 纹理内容规范：禁止任何商标或真实世界品牌
-> "Similar hats sell for 75 Robux — pricing at 150 without a strong brand will slow sales" — Creator Marketplace 定价策略：参考同类商品定价
+> "MANDATORY: All UGC accessory meshes must be under 4,000 triangles for hats/accessories — exceeding this causes auto-rejection" — Roblox UGC 技术红线
+
+> "Layered Clothing requires both the outer mesh AND an inner cage mesh (_InnerCage) for deformation — missing inner cage causes clipping through body" — 分层服装变形核心要求
+
+> "Looks great in Blender — now test it on Rthro Broad in a run cycle before submitting" — 沟通风格：强调跨体型实测
+
+> "That logo will get flagged — use an original design instead" — 沟通风格： moderation 风险预判
 
 ## Key Concepts
-- [[UGC]]: User Generated Content，Roblox 平台允许创作者发布和销售虚拟物品的经济系统
-- [[LayeredClothing]]: Roblox 分层服装系统，需要 Outer Mesh + InnerCage + OuterCage 三层 cage 网格实现变形
-- [[HumanoidDescription]]: Roblox 化身 API，通过 description.Apply() 方法应用全身装扮，支持 Shirt/Pants/Accessory 等属性
-- [[R15Rig]]: Roblox R15 avatar 骨骼系统，Layered Clothing 权重绑定到标准 R15 骨骼
-- [[CreatorMarketplace]]: Roblox 官方 UGC 交易平台，所有 UGC 商品需通过 Creator Dashboard 提交并通过自动化+人工审核
-- [[AttachmentPoint]]: Roblox 化身附件定位点，名称必须匹配 Roblox 标准（HatAttachment/FaceFrontAttachment 等）
-- [[RthroBodyType]]: Roblox 瘦长型化身比例，与 Classic/R15 Normal 不同——需单独测试附件兼容性
+- [[UGC (User-Generated Content)]]：Roblox 平台允许创作者自行设计虚拟形象物品并通过 Creator Marketplace 销售的内容生态。
+- [[Layered Clothing]]：Roblox 分层服装系统，通过外层可见网格 + 内层变形 Cage 网格 + 外层堆叠 Cage 实现与其他分层物品的叠穿。
+- [[R15 Avatar Rig]]：Roblox 第 15 代 Avatar 骨架系统，提供标准骨骼命名和体型预设，是所有配饰绑定的参考基准。
+- [[HumanoidDescription]]：Roblox API，通过修改 Description 对象中的配件字段（如 HatAccessory、Shirt）并调用 ApplyDescription 实现换装。
+- [[Creator Marketplace]]：Roblox UGC 物品的官方销售渠道，所有物品必须通过自动 moderation 和人工审核才能上架。
+- [[Cage Mesh]]：分层服装中的变形网格，_InnerCage 定义服装包裹 Avatar 的形状，_OuterCage 允许其他分层物品堆叠在其上方。
+- [[Rthro Avatar Scale]]：Roblox Rthro 体型系统，包含 Rthro Narrow 和 Rthro Broad 两种体型变体，需在配饰测试中覆盖。
+- [[Blender R15 Rig]]：Roblox 官方提供的 Blender 参考骨架文件，用于正确命名骨骼和进行权重绘制。
 
 ## Key Entities
-- [[Blender]]: 3D 建模软件，用于制作 UGC 配件网格和 cage 网格
-- [[RobloxStudio]]: Roblox 官方开发工具，通过 Avatar → Import Accessory 导入 UGC 物品
-- [[R15TestBodies]]: Roblox Studio 提供的 5 种测试化身预设：Young / Classic / Normal / Rthro Narrow / Rthro Broad
-- [[DataStore]]: Roblox 服务器端持久化系统，用于存储玩家装扮数据
+- [[RobloxAvatarCreator]]：本 agent 角色——Roblox UGC 虚拟形象流水线专家，精通从建模到 Creator Marketplace 提交的完整流程。
+- [[Roblox Studio]]：Roblox 官方开发引擎，用于导入配饰、测试体型、预览动画穿插和管理 Creator Dashboard。
+- [[Blender]]：第三方 DCC 工具，用于网格建模、UV 展开、骨骼绑定和 Cage 网格制作。
+- [[Creator Dashboard]]：Roblox 创作者后台，用于提交 UGC 物品、管理 moderation 状态和发布内容。
+- [[MarketplaceService]]：Roblox 服务端 API，通过 PromptPurchase 驱动游戏内购买 UGC 物品的流程。
 
 ## Connections
-- [[RobloxSystemsScripter]] ← game-dev-scope ← [[RobloxAvatarCreator]]
-- [[RobloxExperienceDesigner]] ← player-economy ← [[RobloxAvatarCreator]]
-- [[Blender]] ← mesh-pipeline ← [[RobloxAvatarCreator]]
-- [[RobloxStudio]] ← asset-pipeline ← [[RobloxAvatarCreator]]
-- [[CreatorMarketplace]] ← submission ← [[RobloxAvatarCreator]]
-- [[R15Rig]] ← bone-weights ← [[RobloxAvatarCreator]]
+- [[Roblox Systems Scripter Agent Personality]] ← related_to ← [[Roblox Avatar Creator Agent Personality]]
+- [[Roblox Experience Designer]] ← related_to ← [[Roblox Avatar Creator Agent Personality]]
+- [[HumanoidDescription]] ← drives ← [[AvatarManager.lua]]（游戏内换装模块）
+- [[Layered Clothing]] ← requires ← [[R15 Avatar Rig]]（骨骼绑定参考）
+- [[Creator Marketplace]] ← requires ← [[UGC (User-Generated Content)]]（物品来源）
 
 ## Contradictions
-- 与 [[UnityArchitect]] / [[UnityMultiplayerEngineer]] 冲突：
-  - 冲突点：角色自定义系统的实现路径差异
-  - 当前观点（Roblox）：使用 HumanoidDescription API 实现服务端权威的化身自定义，数据通过 DataStore 持久化
-  - 对方观点（Unity）：推荐客户端预测式角色定制，使用 LocalPlayer 状态缓存提升响应体验
-  - 说明：此差异由平台架构约束决定——Roblox 的 LocalScript 不可写 DataStore，Unity 无此限制，均为各自平台最优解
+- 与 [[Roblox Systems Scripter Agent Personality]] 的潜在重叠：
+  - 冲突点：Avatar 自定义系统同时涉及脚本编写和物品设计，职责边界可能模糊。
+  - 当前观点：Avatar Creator 专注物品层面的建模/绑定/提交，Systems Scripter 专注游戏内 Avatar 逻辑和 API 调用。
+  - 对方观点：Systems Scripter 可能认为游戏内换装逻辑属于自己的职责范围。
+  - 协调方案：物品层面的 HumanoidDescription 填充属于 Avatar Creator，DataStore 保存/加载和换装触发逻辑属于 Systems Scripter。