talesofai/neta-elementum

Neta Elementum Skill

通过「元素(Elementum)炼金」工作流，将任意可视化概念铸造为可复用的 VToken（虚拟Token，TCP/Elementum）。创建后可在 make_image 中通过 /元素名 引用。

本技能需要配合 neta-creative 技能使用 make_image 进行视觉预览。

命令使用

创建元素

完整炼金流程（推荐）

遵循「概念确认 → 视觉预览 → 提炼封装 → 确认铸造」四段式流程。

📖 炼金引导 - 完整炼金工作流程与最佳实践

npx -y @talesofai/neta-skills@latest create_elementum \
  --name "RE4村庄" \
  --artifact_uuid "make_image返回的artifacts[0].uuid" \
  --prompt "生化危机4风格欧洲中世纪村庄，破旧石屋，燃烧篝火，浓雾弥漫，枯木，恐怖压抑氛围，写实风格" \
  --description "此元素表示生化危机4标志性的废弃欧洲村庄场景。使用时搭配夜晚、角色人物、恐怖氛围等描述词，可与角色引用同用。参考图为原版游戏村庄截图风格的复现。" \
  --accessibility "PUBLIC"

更新元素

有针对性地修改（只传需要改的字段）

📖 更新引导 - 更新场景与流程

# 重新生图后更换代表图
npx -y @talesofai/neta-skills@latest update_elementum \
  --tcp_uuid "元素的tcp_uuid" \
  --artifact_uuid "新make_image返回的artifacts[0].uuid" \
  --prompt "更新后的生图指令"

# 只更新 Agent 使用说明
npx -y @talesofai/neta-skills@latest update_elementum \
  --tcp_uuid "元素的tcp_uuid" \
  --description "更新后的使用说明"

查询已有元素

# 列出我的元素（当前用户创建的元素）
npx -y @talesofai/neta-skills@latest list_my_elementum
npx -y @talesofai/neta-skills@latest list_my_elementum --keyword "村庄" --page_size 10

# 搜索元素（全站关键词匹配）
npx -y @talesofai/neta-skills@latest search_character_or_elementum --keywords "元素名" --parent_type "elementum"

# 获取元素完整详情（含 tcp_uuid）
npx -y @talesofai/neta-skills@latest request_character_or_elementum --name "元素名"

参考文档

| 场景 | 文档 | |------|------| | ⚗️ 元素炼金引导 | elementum-alchemy.md | | 🔧 元素更新引导 | elementum-update.md | | 📋 字段说明手册 | elementum-field-guide.md |

Elementum 能表示什么

Elementum 是对一个可视化概念的封装，适用范围很广：

| 类别 | 示例 | |------|------| | 场景/环境 | 废弃村庄、赛博朋克街道、星空沙漠 | | 道具/物品 | 古老魔法书、未来武器、神圣圣杯 | | 服装/风格 | 汉服、赛博朋克战甲、洛丽塔裙 | | 姿势/动作 | 战斗站姿、回眸、飞跃动作 | | 氛围/光影 | 午后阳光、赛博霓虹、神秘暗影 | | 艺术风格 | 水墨风、像素风、漫画线稿 | | 梗图/表情包 | "这就是命运" 梗、星战女孩 |

使用建议

1. 先预览再铸造 - 用 make_image 生成元素代表图，确认视觉满意后再调用 create_elementum；artifact_uuid 即为代表图的 artifacts[0].uuid
2. prompt 给图像模型读 - prompt 是直接传给 make_image 的生图指令，语言要清晰、可组合、简洁精准；写完后应该能直接粘贴到 make_image --prompt 中使用
3. description 给 Agent 读 - description 告诉 Agent 这个元素是什么、适合怎么用、有什么注意事项；格式建议："此元素表示[概念]，使用时[方法]，参考图展示[说明]"
4. ref_image 用于风格锚定 - 如果有特定参考图（如游戏截图、参考画面），传入 ref_image_uuid 让图像模型锚定视觉风格