Neta Character Skill
引导用户从灵感到铸造，完成专属角色 VToken（虚拟Token，TCP/OC）的创建与管理。角色创建后可在 make_image 中通过 @角色名 引用。
本技能需要配合 neta-creative 技能使用
make_image进行视觉预览。
命令使用
创建角色
完整创建流程（推荐）
遵循「视觉预览 → 角色立档 → 确认创建」三段式流程。
📖 创建引导 - 完整创作工作流程与最佳实践
bashnpx -y @talesofai/neta-skills@latest create_character \ --name "Ada Wong" \ --avatar_artifact_uuid "make_image返回的artifacts[0].uuid" \ --prompt "long black hair, red qipao dress, blue eyes, gun holster on thigh, slender figure" \ --trigger "1girl, Ada Wong, black hair, red dress, spy, elegant, resident evil series" \ --gender "女" \ --age "28" \ --occupation "间谍" \ --persona "神秘冷静，目的不明，游走于各方势力之间" \ --interests "情报收集，格斗，精密机械" \ --description "艾达·王，黑发红裙的神秘间谍，真实目的无人知晓。外貌冷峻优雅，实为天才特工，多次与生化危机事件交织，却始终保持独立立场。" \ --accessibility "PUBLIC"
更新角色
有针对性地修改（只传需要改的字段）
📖 更新引导 - 更新场景与流程
bash# 重新生图后更换视觉外观 npx -y @talesofai/neta-skills@latest update_character \ --tcp_uuid "角色的tcp_uuid" \ --avatar_artifact_uuid "新make_image返回的artifacts[0].uuid" \ --prompt "新的视觉特征描述" # 只更新背景故事 npx -y @talesofai/neta-skills@latest update_character \ --tcp_uuid "角色的tcp_uuid" \ --description "更新后的角色背景故事" # 更新多个字段 npx -y @talesofai/neta-skills@latest update_character \ --tcp_uuid "角色的tcp_uuid" \ --persona "新的性格描述" \ --interests "新的兴趣" \ --occupation "新的职业"
查询已有角色
bash# 列出我的角色（当前用户创建的角色） npx -y @talesofai/neta-skills@latest list_my_characters npx -y @talesofai/neta-skills@latest list_my_characters --keyword "艾达" --page_size 10 # 搜索角色（全站关键词匹配） npx -y @talesofai/neta-skills@latest search_character_or_elementum --keywords "角色名" --parent_type "character" # 获取角色完整详情（含 tcp_uuid） npx -y @talesofai/neta-skills@latest request_character_or_elementum --name "角色名"
参考文档
| 场景 | 文档 |
|---|---|
| ✨ 角色创建引导 | character-creation.md |
| 🔧 角色更新引导 | character-update.md |
| 📋 字段说明手册 | character-field-guide.md |
使用建议
- 先预览再创建 - 用
make_image生成角色预览图，确认视觉满意后再调用create_character；avatar_artifact_uuid即为预览图的artifacts[0].uuid - 预览只用纯文本 -
make_image预览阶段使用纯自然语言描述外貌，不加@角色名（因为角色还未创建） - trigger 必须是英文 -
trigger是图像模型和语言模型的识别锚点，中文 trigger 会显著降低识别率；应包含性别词、角色姓名、突出外貌特征、所属 IP 系列 - prompt 只写视觉 -
prompt只描述生理特征、服装、特殊标志；不写性格、故事、背景 - description 给人和 Agent 读 -
description应包含外貌摘要 + 角色背景故事，供 Agent 在后续创作中理解角色语境
