@talesofai/neta-skills 0.6.0

package/skills/zh_cn/neta-creative/references/character-search.md

@@ -0,0 +1,233 @@
+# 角色查询最佳实践
+
+适用于 `search_character_or_elementum` 和 `request_character_or_elementum` 命令。
+
+---
+
+## 工作流程
+
+```
+1. 模糊搜索 → 2. 确认角色 → 3. 获取详情 → 4. 使用标准信息
+```
+
+---
+
+## 搜索策略
+
+### 精确搜索
+
+当知道确切角色名称时：
+
+```bash
+# 使用精确排序
+neta-cli search_character_or_elementum --keywords "角色全名" --sort_scheme "exact" --parent_type "character"
+```
+
+### 模糊搜索
+
+当只记得部分名称或关键词时：
+
+```bash
+# 使用相关性排序
+neta-cli search_character_or_elementum --keywords "关键词" --sort_scheme "best" --parent_type "both"
+```
+
+### 分页浏览
+
+```bash
+# 第一页
+neta-cli search_character_or_elementum --keywords "魔法少女" --page_index 0 --page_size 10
+
+# 第二页
+neta-cli search_character_or_elementum --keywords "魔法少女" --page_index 1 --page_size 10
+```
+
+---
+
+## 参数选择
+
+### parent_type
+
+| 值 | 说明 | 使用场景 |
+|------|------|----------|
+| `character` | 仅角色 | 确定搜索 OC 角色 |
+| `elementum` | 仅风格元素 | 确定搜索风格/元素 |
+| `both` | 两者都搜索 | 不确定类型时（默认） |
+
+### sort_scheme
+
+| 值 | 说明 | 使用场景 |
+|------|------|----------|
+| `exact` | 精确匹配 | 知道确切名称 |
+| `best` | 综合相关 | 模糊搜索（默认） |
+
+---
+
+## 获取角色详情
+
+### 通过名称
+
+```bash
+neta-cli request_character_or_elementum --name "角色名"
+```
+
+### 通过 UUID
+
+```bash
+neta-cli request_character_or_elementum --uuid "角色-uuid"
+```
+
+### 返回数据示例
+
+```json
+{
+  "detail": {
+    "type": "character",
+    "uuid": "xxx-xxx-xxx",
+    "name": "角色名",
+    "age": "18",
+    "interests": "唱歌、跳舞",
+    "persona": "开朗活泼",
+    "description": "详细描述...",
+    "occupation": "学生",
+    "avatar_img": "https://...",
+    "header_img": "https://..."
+  }
+}
+```
+
+---
+
+## 常见用例
+
+### 基于角色生成图片
+
+```bash
+# 1. 获取角色标准信息
+neta-cli request_character_or_elementum --name "初音未来"
+
+# 2. 生成图片
+neta-cli make_image \
+  --prompt "@初音未来，穿着标志性服装，手持大葱，舞台背景" \
+  --aspect "3:4"
+```
+
+### 标签角色调研
+
+```bash
+# 1. 获取标签下的角色列表
+neta-cli get_hashtag_characters --hashtag "热门标签" --sort_by "hot"
+
+# 2. 获取感兴趣角色的详情
+neta-cli request_character_or_elementum --name "角色名"
+
+# 3. 分析角色特征，确定创作方向
+```
+
+### 风格元素查询
+
+```bash
+# 搜索风格元素
+neta-cli search_character_or_elementum --keywords "赛博朋克" --parent_type "elementum"
+
+# 获取元素详情
+neta-cli request_character_or_elementum --name "赛博朋克风格"
+```
+
+---
+
+## 搜索技巧
+
+### 使用别名/简称
+
+有些角色有多个名称：
+```bash
+# 尝试不同名称
+neta-cli search_character_or_elementum --keywords "角色全名" --sort_scheme "exact"
+neta-cli search_character_or_elementum --keywords "角色简称" --sort_scheme "exact"
+```
+
+### 组合关键词
+
+```bash
+# 特征 + 类型
+neta-cli search_character_or_elementum --keywords "粉色头发 魔法少女" --parent_type "character"
+
+# 作品名 + 角色
+neta-cli search_character_or_elementum --keywords "作品名 角色名" --sort_scheme "exact"
+```
+
+### 利用标签筛选
+
+```bash
+# 先查标签
+neta-cli get_hashtag_info --hashtag "标签名"
+
+# 再查标签下角色
+neta-cli get_hashtag_characters --hashtag "标签名"
+```
+
+---
+
+## 数据缓存
+
+### 缓存角色信息
+
+```bash
+# 第一次查询并保存
+neta-cli request_character_or_elementum --name "角色名" > character_cache/角色名.json
+
+# 后续使用缓存数据
+cat character_cache/角色名.json
+```
+
+### 缓存搜索结果
+
+```bash
+# 保存搜索结果
+neta-cli search_character_or_elementum --keywords "关键词" > search_cache/关键词.json
+```
+
+---
+
+## 常见问题
+
+### Q: 搜索不到角色怎么办？
+
+**A:**
+1. 尝试不同的名称变体
+2. 使用模糊搜索（`-s "best"`）
+3. 检查是否拼写错误
+4. 确认角色确实存在于数据库中
+
+### Q: 如何区分同名角色？
+
+**A:**
+1. 查看详细描述
+2. 对比头像图片
+3. 查看所属标签/作品
+4. 使用更精确的搜索词
+
+### Q: 角色信息不完整怎么办？
+
+**A:**
+1. 有些角色可能信息较少
+2. 可以结合多个来源
+3. 使用角色的 avatar_img 作为参考
+4. 基于已有信息创作
+
+---
+
+## 最佳实践总结
+
+1. **先搜索后创作** - 确保使用官方标准设定
+2. **缓存常用角色** - 避免重复 API 调用
+3. **精确优先** - 知道全名时用 `exact` 排序
+4. **保存 UUID** - 方便后续直接查询
+5. **结合标签** - 利用标签系统发现相关角色
+
+---
+
+## 相关文档
+
+- [图片生成](./image-generation.md) - 基于角色信息生成图片

package/skills/zh_cn/neta-creative/references/collection-remix.md

@@ -0,0 +1,40 @@
+# 内容创作最佳实践
+
+利用已有的信息、工具集和参考素材，精确执行指令，帮助用户生成高质量的幻想内容。
+
+# Constraints (关键执行限制)
+
+- 除非任务完成或必须确认关键信息，否则**坚持连续调用指令**直到任务结束，减少对用户的打扰。
+- 指令调用不共享上下文，必须每次传入完整的参数信息。
+- **严禁**使用未提供的指令。
+- **失败重试**：若指令调用失败，最多重试一次，且必须使用**原参数**重试，禁止擅自修改参数逻辑。
+
+# Reference Context (参考素材)
+
+你需要使用 `read_collection` 指令获取参考信息进行 Remix（二创）、复现或改编，以满足用户需求
+
+```bash
+neta-cli read_collection --uuid "作品-uuid"
+```
+
+**返回内容**
+- 玩法信息
+- 玩法内包含的素材
+- 创作者信息
+- Remix
+  - preset_description 参考概要
+  - reference_planning 参考的执行规划
+  - launch_prompt
+    - core_input 详细的改编描述信息
+    - brief_input 简略的改编描述信息
+    - ref_image 参考图
+
+## 开始创作
+
+适用 `make_image` `make_video` `make_song` 命令
+
+📖 - [生成图片](./image-generation.md)
+
+📖 - [生成视频](./video-generation.md)
+
+📖 - [生成歌曲](./song-creation.md)

package/skills/zh_cn/neta-creative/references/image-generation.md

@@ -0,0 +1,121 @@
+# 图片生成最佳实践
+
+适用于 `make_image` 和 `remove_background` 命令。
+
+---
+
+## 提示词结构
+
+- 角色: 通过 @character_name 来引用角色,这个引用会包含角色的完整形象信息
+- 画面元素: 通过 /元素名称 格式引用风格元素,如 /漫画风格
+- 参考图: 通过 参考图-artifact_uuid 格式引用已存在的图片作为参考图,如"参考图-1234567890"。最多能有 14 张图片
+- 中文词组: 描述具体画面生成要求,如果没有引用角色,则需要在自然语言词组中描述角色形象
+
+**推荐格式：**
+```
+[角色] + [画面元素] + [参考图] + [主体描述] + [外观细节] + [服装/配饰] + [姿势/动作] + [背景/环境] + [光影/氛围] + [艺术风格]
+```
+
+**示例：**
+```
+@奈塔#996, /漫画风格, 参考图-1234567890, 参考图-1234567891, 词组1, 词组2…
+```
+
+**注意：**
+  - 提示词要多提供上下文和意图。详细描述场景,而不仅仅是列出关键字。与一连串不相关的字词相比,叙述性描述段落几乎总是能生成更好、更连贯的图片；
+  - 角色引用必须以 @角色名称 形式出现,如 @奈塔#996
+  - 元素引用必须以 /元素名称 形式出现,如 /漫画风格
+  - 可以通过 search_character_or_elementum 搜索来获取可以使用的角色或元素，使用前通过 request_character_or_elementum 验证角色或者元素可用
+  - 参考图必须以 参考图-artifact_uuid 形式出现, 只能使用 `read_collection` 获取到的图片 artifact，或者生成过的图片作为参考图
+  - 引用角色或者元素的时候,前后要添加空格或逗号分隔,如："@奈塔#996, /格, 在校园里散步"
+  - 对于修改图片等跟原图参考相关的生成,请一定引用上参考图
+  - 示例(引用角色和元素)：@奈塔#996, /漫画风格, 参考图-artifact_uuid, 参考图-artifact_uuid, 词组1, 词组2…
+  - **存在具体的角色时，通过@角色名来使用角色，而不是重新描述角色的外貌**
+---
+
+## 宽高比选择
+
+| 比例 | 分辨率 | 适用场景 |
+|------|--------|----------|
+| `1:1` | 512×512 | 头像、图标、方形展示图 |
+| `3:4` | 576×768 | **默认推荐**，社交媒体竖图、海报 |
+| `4:3` | 768×576 | 横版插图、演示文稿 |
+| `9:16` | 576×1024 | 手机壁纸、短视频封面、Stories |
+| `16:9` | 1024×576 | 视频封面、横幅、桌面壁纸 |
+
+---
+
+## 常见用例
+
+### 角色立绘
+
+```bash
+neta-cli make_image \
+  --prompt "一个穿着校服的日本女高中生，黑色长发，红色蝴蝶结，站在教室门口，阳光从窗户洒进来，清新自然" \
+  --aspect "3:4"
+```
+
+### 三视图设定
+
+```bash
+# 正面
+neta-cli make_image --prompt "@角色名，正面视图，白色背景，全身像" --aspect "3:4"
+
+# 侧面
+neta-cli make_image --prompt "@角色名，侧面视图，白色背景，全身像" --aspect "3:4"
+
+# 背面
+neta-cli make_image --prompt "@角色名，背面视图，白色背景，全身像" --aspect "3:4"
+```
+
+### 表情集
+
+```bash
+neta-cli make_image --prompt "@角色名，开心表情，特写，白色背景" --aspect "1:1"
+neta-cli make_image --prompt "@角色名，生气表情，特写，白色背景" --aspect "1:1"
+neta-cli make_image --prompt "@角色名，惊讶表情，特写，白色背景" --aspect "1:1"
+neta-cli make_image --prompt "@角色名，害羞表情，特写，白色背景" --aspect "1:1"
+```
+
+### 去背景（抠图）
+
+```bash
+neta-cli remove_background --input_image "image_uuid"
+```
+---
+
+## 常见问题
+
+### Q: 生成结果不符合预期怎么办？
+
+**A:** 逐步调整提示词：
+1. 增加具体细节描述
+2. 明确艺术风格
+3. 简化过于复杂的场景
+4. 尝试不同的宽高比
+
+### Q: 人物脸部崩坏怎么办？
+
+**A:** 
+1. 避免过于复杂的表情描述
+2. 不要同时描述多个动作
+3. 尝试添加"精致的面部特征"等描述
+4. 使用特写构图（在提示词中强调"面部特写"）
+
+### Q: 如何保持角色一致性？
+
+**A:**
+1. 使用固定的角色特征描述
+2. 保存成功的提示词模板
+3. 先查询角色详情获取标准描述
+   ```bash
+   neta-cli request_character_or_elementum --name "角色名"
+   ```
+4. 基于角色描述生成提示词
+
+---
+
+## 相关文档
+
+- [角色查询](./character-search.md) - 获取角色标准信息
+- [视频生成](./video-generation.md) - 将图片转换为动态视频

package/skills/zh_cn/neta-creative/references/song-creation.md

@@ -0,0 +1,247 @@
+# 歌曲生成最佳实践
+
+适用于 `make_song` 命令。
+
+---
+
+## 提示词结构
+
+**推荐格式：**
+```
+[音乐风格] + [情绪/氛围] + [节奏/速度] + [乐器/元素] + [主题/场景]
+```
+
+**示例：**
+```
+欢快的 J-Pop 风格，充满活力的少女感，中快节奏，电子合成器和鼓点，关于友情和梦想的主题
+```
+
+---
+
+## 音乐风格参考
+
+| 风格 | 描述示例 |
+|------|----------|
+| J-Pop | "欢快的 J-Pop，青春活力，电子合成器" |
+| 民谣 | "温柔的城市民谣，吉他伴奏，清新自然" |
+| 电子 | "动感电子舞曲，强烈节拍，未来感" |
+| 摇滚 | "激情摇滚，电吉他独奏，充满力量" |
+| 古典 | "优雅的钢琴曲，舒缓节奏，浪漫氛围" |
+| R&B | "节奏蓝调，慵懒嗓音，都市夜景" |
+| 古风 | "中国风，古筝笛子，诗意悠扬" |
+
+---
+
+## 情绪/氛围词汇
+
+| 情绪 | 示例描述 |
+|------|----------|
+| 欢快 | "充满活力"、"阳光明媚"、"积极向上" |
+| 忧伤 | "淡淡的忧伤"、"怀念过去"、"雨夜" |
+| 浪漫 | "温柔甜蜜"、"月光下"、"初恋感觉" |
+| 激昂 | "热血沸腾"、"战斗意志"、"永不放弃" |
+| 宁静 | "平和安详"、"清晨森林"、"冥想" |
+| 神秘 | "神秘莫测"、"古老传说"、"魔法氛围" |
+
+---
+
+## 歌词格式模板
+
+```
+[Verse 1]
+主歌第一段，叙述故事背景
+4-8 行，建议押韵
+
+[Pre-Chorus]
+预副歌，情绪铺垫
+2-4 行
+
+[Chorus]
+副歌，高潮部分，记忆点
+4-8 行，重复性强
+
+[Verse 2]
+主歌第二段，故事发展
+4-8 行
+
+[Chorus]
+副歌重复
+
+[Bridge]
+桥段，情绪转折或升华
+2-4 行
+
+[Chorus]
+副歌最后一次（可升调）
+
+[Outro]
+结尾，渐弱
+2-4 行
+```
+
+---
+
+## 歌词示例
+
+```
+[Verse 1]
+清晨的阳光洒在窗前
+微风吹过熟悉的街道
+想起昨天你的笑脸
+心中涌起温暖感觉
+
+[Pre-Chorus]
+时光悄悄流转
+我们的故事继续
+
+[Chorus]
+一起走过春夏秋冬
+手牵手看遍世间风景
+无论未来多么遥远
+这份友情永远不变
+
+[Verse 2]
+放学后的咖啡厅角落
+分享着彼此的梦想
+你说要成为歌手
+我说要环游世界
+
+[Chorus]
+一起走过春夏秋冬
+手牵手看遍世间风景
+无论未来多么遥远
+这份友情永远不变
+
+[Bridge]
+即使有一天各奔东西
+这份回忆永远珍藏
+
+[Chorus]
+一起走过春夏秋冬
+手牵手看遍世间风景
+无论未来多么遥远
+这份友情永远不变
+
+[Outro]
+谢谢你陪伴的每一天
+我们的故事继续书写
+```
+
+---
+
+## 常见用例
+
+### 角色主题曲
+
+```bash
+neta-cli make_song \
+  --prompt "角色专属主题曲，J-Pop 风格，活泼可爱，魔法少女感，电子合成器，明快节奏" \
+  --lyrics "[歌词内容...]"
+```
+
+### 背景音乐
+
+```bash
+neta-cli make_song \
+  --prompt "轻柔的钢琴背景音乐，宁静安详，适合阅读，舒缓节奏" \
+  --lyrics "[纯音乐可省略歌词或使用简单的哼唱]"
+```
+
+### 战斗曲
+
+```bash
+neta-cli make_song \
+  --prompt "激昂的战斗曲，摇滚风格，电吉他，强烈鼓点，热血沸腾" \
+  --lyrics "[Verse 1]
+  燃烧吧斗志
+  冲破黑暗黎明
+  ..."
+```
+
+### 抒情歌曲
+
+```bash
+neta-cli make_song \
+  --prompt "温柔的抒情歌曲，民谣风格，吉他伴奏，清新自然，淡淡忧伤" \
+  --lyrics "[Verse 1]
+  雨后的街道
+  一个人走着
+  ..."
+```
+
+---
+
+## 歌词写作技巧
+
+### 1. 押韵
+
+句尾押韵让歌曲更流畅：
+```
+清晨的阳光洒在窗前 (qián)
+微风吹过熟悉的街道 (dào)
+想起昨天你的笑脸 (liǎn)
+心中涌起温暖感觉 (jué)
+```
+
+### 2. 意象具体
+
+使用具体的意象而非抽象概念：
+- ❌ "我很开心"
+- ✅ "阳光洒在窗前，微风吹过街道"
+
+### 3. 情感递进
+
+从主歌到副歌情感逐渐升华：
+```
+Verse: 叙述故事
+Pre-Chorus: 情绪铺垫
+Chorus: 情感爆发
+```
+
+### 4. 重复记忆点
+
+副歌要有容易记住的核心句：
+```
+一起走过春夏秋冬
+手牵手看遍世间风景
+```
+
+---
+
+## 参数限制
+
+| 参数 | 限制 |
+|------|------|
+| prompt | 10-2000 字符 |
+| lyrics | 10-3500 字符 |
+
+---
+
+## 常见问题
+
+### Q: 歌词太长怎么办？
+
+**A:** 
+- 精简到 3500 字符以内
+- 优先保留主歌和副歌
+- 可以省略部分重复段落
+
+### Q: 纯音乐如何生成？
+
+**A:**
+- 歌词可以填写简单的哼唱词（如"啦~"）
+- 或者填写简短的氛围描述
+- 重点在 prompt 中描述音乐风格
+
+### Q: 如何保持风格一致性？
+
+**A:**
+- 保存成功的 prompt 模板
+- 使用相似的风格描述词汇
+- 参考同类型的成功作品
+
+---
+
+## 相关文档
+
+- [歌曲 MV](./song-mv.md) - 结合歌曲和视频制作完整 MV