用途：训练一个面部保真的身份模型（Soul Character），供 Higgsfield 的 Soul 系列生成能力反复调用，在图生图或视频生成中保持人物身份一致。
主要能力：支持两种变体，--soul-2 用于图像生成（默认），--soul-cinematic 用于电影感/视频工作；可列出与查询已训练的 Soul 引用。
使用方式：先确认 higgsfield 在 PATH 中，若不在则安装：curl -fsSL https://raw.githubusercontent.com/higgsfield-ai/cli/main/install.sh | sh。若账号状态提示 Session expired / Not authenticated，需用户运行 higgsfield auth login（交互式）并等待确认。训练需要付费方案（Basic+），若为免费方案需先告知用户。提供名称（一个词，便于后续引用）与 5–20 张不同角度和光照的人脸照片，本地路径或已上传 ID 均可，--image 两者都接受。提交示例：higgsfield soul-id create --name "<name>" --soul-2 --image ./photo1.png --image ./photo2.png。随后运行 higgsfield soul-id wait <id> 静默等待（默认超时 30 分钟）。完成后在生成时传入 --soul-id <id>，如 higgsfield generate create text2image_soul_v2 --prompt "..." --soul-id <ref_id> --quality 2k --wait。列出：higgsfield soul-id list；查询：higgsfield soul-id get <id>。
适用场景：需要保持同一人物面貌的图像或视频生成。
限制：训练需付费方案；训练失败通常与照片质量有关（建议 5 张以上清晰、光照良好的人脸照片）；会话过期需重新登录。更详细的照片建议与排错见 references/photo-guide.md 与 references/troubleshooting.md。UX 规则要求回复简洁、按用户语言响应、CLI 参数保持英文、轮询期间保持静默不重复状态。