@talesofai/neta-skills 0.6.0

package/skills/zh_cn/neta/references/song-mv.md

@@ -0,0 +1,198 @@
+# 歌曲 MV 制作最佳实践
+
+结合歌曲生成和视频生成，制作完整的音乐视频。
+
+---
+
+## 工作流程
+
+```
+1. 生成歌曲 → 2. 设计 MV 视觉 → 3. 生成封面/关键帧 → 4. 生成视频片段 → 5. 合成
+```
+
+---
+
+## 步骤详解
+
+### 1. 生成歌曲
+
+```bash
+neta-cli make_song \
+  --prompt "欢快的 J-Pop 风格，充满活力的少女感，中快节奏，电子合成器" \
+  --lyrics "[歌词内容...]"
+```
+
+### 2. 设计 MV 视觉概念
+
+根据歌曲风格确定视觉方向：
+
+| 歌曲风格 | 视觉风格 | 色彩 |
+|----------|----------|------|
+| J-Pop | 青春活力 | 明亮、粉色系 |
+| 民谣 | 清新自然 | 温暖、大地色 |
+| 电子 | 未来科技 | 冷色、霓虹 |
+| 抒情 | 浪漫唯美 | 柔和、淡色 |
+| 摇滚 | 激情动感 | 对比强烈 |
+
+### 3. 生成 MV 封面
+
+```bash
+neta-cli make_image \
+  --prompt "根据歌曲主题设计封面，16:9 横版，适合视频封面" \
+  --aspect "16:9"
+```
+
+### 4. 生成视频片段
+
+```bash
+neta-cli make_video \
+  --image_source "<封面图片 URL>" \
+  --prompt "与歌曲情绪匹配的动态效果，如粒子飘动、光影变化" \
+  --model "model_w"
+```
+
+---
+
+## 完整示例
+
+### 青春主题曲 MV
+
+```bash
+# 1. 生成歌曲
+neta-cli make_song \
+  --prompt "青春活力的 J-Pop，明快节奏，电子合成器，关于友情和梦想" \
+  --lyrics "[Verse 1]
+  清晨阳光洒在窗前
+  微风吹过熟悉街道
+  ..."
+
+# 2. 生成 MV 主视觉
+neta-cli make_image \
+  --prompt "青春少女站在天台上，蓝天白云，校服裙摆飞扬，阳光洒下，希望感，动漫风格" \
+  --aspect "16:9"
+
+# 3. 生成动态效果
+neta-cli make_video \
+  --image_source "<上一步图片 URL>" \
+  --prompt "云朵缓缓流动，裙摆轻轻摆动，发丝随风飘动，阳光闪烁" \
+  --model "model_w"
+```
+
+### 抒情歌曲 MV
+
+```bash
+# 1. 生成歌曲
+neta-cli make_song \
+  --prompt "温柔的抒情歌曲，钢琴伴奏，舒缓节奏，淡淡忧伤" \
+  --lyrics "[歌词内容...]"
+
+# 2. 生成氛围图
+neta-cli make_image \
+  --prompt "雨夜的街道，路灯下的雨丝，孤独的身影，深蓝色调，电影感" \
+  --aspect "16:9"
+
+# 3. 生成动态效果
+neta-cli make_video \
+  --image_source "<图片 URL>" \
+  --prompt "雨丝缓缓落下，路灯微微闪烁，水汽朦胧" \
+  --model "model_w"
+```
+
+---
+
+## 多场景 MV
+
+对于完整的 MV，可以生成多个场景：
+
+```bash
+# 场景 1：主歌
+neta-cli make_image --prompt "场景 1 描述" --aspect "16:9"
+neta-cli make_video --image_source "<URL1>" --prompt "场景 1 动态"
+
+# 场景 2：副歌
+neta-cli make_image --prompt "场景 2 描述，更热烈的氛围" --aspect "16:9"
+neta-cli make_video --image_source "<URL2>" --prompt "场景 2 动态，更强烈的效果"
+
+# 场景 3：桥段
+neta-cli make_image --prompt "场景 3 描述，情绪转折" --aspect "16:9"
+neta-cli make_video --image_source "<URL3>" --prompt "场景 3 动态"
+```
+
+---
+
+## 视觉与音乐匹配
+
+| 音乐段落 | 视觉建议 |
+|----------|----------|
+| 主歌 (Verse) | 平静的场景，缓慢的动态 |
+| 预副歌 (Pre-Chorus) | 情绪逐渐提升，动态增强 |
+| 副歌 (Chorus) | 高潮场景，最丰富的动态效果 |
+| 桥段 (Bridge) | 情绪转折，视觉变化 |
+| 结尾 (Outro) | 渐弱，淡出效果 |
+
+---
+
+## 提示词配合
+
+### 欢快歌曲
+- **图片**: "明亮的色彩，阳光，笑容，开放的空间"
+- **视频**: "轻快的飘动，闪烁的光点，活泼的动态"
+
+### 抒情歌曲
+- **图片**: "柔和的色调，安静的场景，内敛的表情"
+- **视频**: "缓慢的运动，微妙的光影变化"
+
+### 激昂歌曲
+- **图片**: "强烈的对比，动感的姿势，戏剧性的光影"
+- **视频**: "强烈的动态，粒子效果，能量感"
+
+---
+
+## 技术建议
+
+### 分辨率
+- 使用 `16:9` 宽高比生成图片
+- 适合主流视频平台
+
+### 模型选择
+- 测试阶段：`model_s`（快速）
+- 最终成品：`model_w`（高质量）
+
+### 时长规划
+- 单个视频片段适合 5-15 秒
+- 完整 MV 需要多个片段组合
+
+---
+
+## 常见问题
+
+### Q: 如何让视频节奏匹配音乐？
+
+**A:**
+1. 根据 BPM 规划场景切换点
+2. 副歌部分使用更丰富的动态
+3. 节奏快的部分动态幅度大
+4. 节奏慢的部分动态舒缓
+
+### Q: 多个场景如何衔接？
+
+**A:**
+1. 保持视觉风格一致
+2. 使用相似的色调
+3. 设计过渡场景
+4. 考虑使用淡入淡出效果
+
+### Q: 如何节省生成时间？
+
+**A:**
+1. 先用 `model_s` 测试效果
+2. 只有关键场景用 `model_w`
+3. 并行生成多个静态图
+4. 串行生成视频（避免队列拥堵）
+
+---
+
+## 相关文档
+
+- [歌曲生成](./song-creation.md) - 生成歌曲和歌词
+- [视频生成](./video-generation.md) - 图片转视频技巧

package/skills/zh_cn/neta/references/space.md

@@ -0,0 +1,90 @@
+# 空间
+
+> 空间是一系列有主题的玩法的集合，一个进行内容生产与消费的场域
+
+# Terminology (术语表)
+- **Hashtag**：标签/空间。用于构建世界观、组织社团。
+- **Collection**：可供浏览、Remix、改变的内容, 也可以泛指空间内发生的事件、场景，玩法
+- **活动**：官方主导的特殊 Hashtag。
+
+# Workflow
+
+- 列出全部空间 `list_spaces`
+- 获取空间详情 `get_hashtag_info`
+- 获取子空间 `list_space_topics`
+- 获取空间或子空间内的内容 `get_hashtag_collections` `get_hashtag_characters`
+- 扮演空间中的某个角色，或者使用某个角色 `request_character_or_elementum`
+- Remix 空间的内容 📖 [Remix](./collection-remix.md)
+
+# 空间结构
+
+- 空间
+  - 世界观、设定（lore）
+  - 角色
+  - collections
+
+  - 子空间
+    - offical_collections
+    - collections
+
+# 获取可供游览的空间
+
+```bash
+neta-cli list_spaces
+```
+
+**返回内容**
+
+- space_uuid: 空间 UUID
+- name: 空间名称
+- main_hashtag_name: hashtag
+- topic_count: 子空间（topic）数量
+
+# 获取空间详细信息
+
+参考 📖 [标签](./hashtag-research.md)
+
+
+```bash
+neta-cli get_hashtag_info --hashtag "空间标签名"
+```
+
+**返回内容：**
+- 标签 lore（世界观设定）
+- 活动详情
+- 热度数据
+- 订阅数量
+
+# 获取子空间
+
+```bash
+neta-cli list_space_topics --space_uuid "空间 UUID"
+```
+
+**返回内容**
+
+- primary_topic 主空间
+- topics 子空间列表
+  - offical_collections
+
+# 获取空间内角色
+
+```bash
+neta-cli get_hashtag_characters --hashtag "空间标签名" --sort_by "hot"
+```
+
+# 获取空间内的场景、事件、内容（可供游玩的部分）
+
+```bash
+neta-cli get_hashtag_collections --hashtag "标签名"
+```
+
+# 获取空间中的某个玩法信息
+
+```bash
+neta-cli read_collection --uuid "official_collections in topic | collections in hashtag"
+```
+
+## 在空间内游玩
+
+📖 [内容创作](./collection-remix.md)

package/skills/zh_cn/neta/references/video-generation.md

@@ -0,0 +1,221 @@
+# 视频生成最佳实践
+
+适用于 `make_video` 命令。
+
+---
+
+## 提示词原则
+
+### 1. 动作具体
+
+描述明确的动作，而非抽象概念。
+
+❌ **过于抽象：**
+```
+让她动起来
+```
+
+✅ **具体动作：**
+```
+角色轻轻挥手，头发随风飘动
+```
+
+### 2. 幅度适中
+
+避免过于复杂的多重动作。
+
+❌ **过于复杂：**
+```
+她先挥手，然后转身，跳起来，最后微笑
+```
+
+✅ **单一动作：**
+```
+角色温柔地挥手，脸上带着微笑
+```
+
+### 3. 时间暗示
+
+可以暗示动作的速度。
+
+✅ **带速度的描述：**
+```
+头发缓缓飘动
+眼神慢慢转向一侧
+轻轻眨眼
+```
+
+---
+
+## 模型选择
+
+| 模型 | 处理时间 | 适用场景 |
+|------|----------|----------|
+| `model_s` | 5-10 分钟 | 快速迭代测试、简单动作 |
+| `model_w` | 10-20 分钟 | 最终成品、复杂动作/表情 |
+
+**建议：** 先用 `model_s` 测试效果，满意后再用 `model_w` 生成高质量版本。
+
+---
+
+## 常见动作提示词
+
+### 头部动作
+- "轻轻点头"
+- "转头看向一侧"
+- "微微歪头"
+- "抬头仰望"
+- "低头沉思"
+
+### 面部表情
+- "温暖的微笑"
+- "眨眼睛"
+- "惊讶的表情"
+- "害羞地脸红"
+- "坚定的眼神"
+
+### 手部动作
+- "挥手告别"
+- "双手合十"
+- "指向远方"
+- "抚摸头发"
+- "握紧拳头"
+
+### 身体动作
+- "转身"
+- "向前迈步"
+- "轻轻跳跃"
+- "伸展双臂"
+
+### 头发/衣物
+- "头发随风飘动"
+- "裙摆飞扬"
+- "披风摆动"
+- "发丝轻柔摆动"
+
+### 魔法/特效
+- "手中发出光芒"
+- "周围环绕魔法粒子"
+- "星光闪烁"
+- "能量波动"
+
+---
+
+## 常见用例
+
+### 角色动态立绘
+
+```bash
+neta-cli make_video \
+  --image_source "https://example.com/character.jpg" \
+  --prompt "角色轻轻呼吸，头发随风飘动，温暖的微笑，眼睛微微眨动" \
+  --model "model_s"
+```
+
+### 动态壁纸
+
+```bash
+neta-cli make_video \
+  --image_source "https://example.com/scenery.jpg" \
+  --prompt "星空缓缓旋转，流星缓慢划过，梦幻的光点闪烁，宁静祥和" \
+  --model "model_w"
+```
+
+### 视频封面动效
+
+```bash
+neta-cli make_video \
+  --image_source "https://example.com/cover.jpg" \
+  --prompt "标题文字微微发光，背景有粒子飘动，电影感" \
+  --model "model_s"
+```
+
+### 从图片生成完整流程
+
+```bash
+# 1. 生成图片（16:9 适合视频）
+neta-cli make_image \
+  --prompt "梦幻的星空背景，流星划过，深蓝色调" \
+  --aspect "16:9"
+
+# 2. 从输出中获取图片 URL
+
+# 3. 生成视频
+neta-cli make_video \
+  --image_source "<图片 URL>" \
+  --prompt "星空缓缓旋转，流星缓慢划过" \
+  --model "model_w"
+```
+
+---
+
+## 提示词对比
+
+### ❌ 动作过多
+```
+她挥手，转身，跳跃，然后微笑，头发飘动，衣服摆动
+```
+
+### ✅ 聚焦单一动作
+```
+她温柔地挥手，头发轻轻飘动，脸上带着微笑
+```
+
+### ❌ 抽象描述
+```
+让她变得生动
+```
+
+### ✅ 具体描述
+```
+她轻轻眨眼，嘴角微微上扬，发丝随风摆动
+```
+
+---
+
+## 图片准备建议
+
+### 适合的图片
+- 清晰的主体轮廓
+- 人物/物体占据主要画面
+- 背景相对简洁
+- 高分辨率（至少 512px 边长）
+
+### 不适合的图片
+- 多人物复杂场景
+- 主体过小
+- 过于复杂的背景
+- 低分辨率模糊图片
+
+---
+
+## 常见问题
+
+### Q: 视频动作不自然怎么办？
+
+**A:**
+1. 简化动作描述，一次只描述 1-2 个动作
+2. 使用"轻轻"、"缓缓"、"慢慢"等词汇
+3. 避免快速、剧烈的动作描述
+4. 尝试使用 `model_w` 获得更好效果
+
+### Q: 视频和原图差异太大？
+
+**A:**
+1. 提示词不要描述与原图冲突的内容
+2. 避免描述大幅度的位置变化
+3. 聚焦于细微的动态效果（呼吸、眨眼、飘动）
+
+### Q: 生成时间太长？
+
+**A:**
+1. 测试阶段使用 `model_s`
+2. 避免在高峰期批量提交
+3. 单个任务完成后再提交下一个
+
+---
+
+## 相关文档
+
+- [图片生成](./image-generation.md) - 生成用于视频转换的图片
+- [歌曲 MV](./song-mv.md) - 结合歌曲和视频制作 MV

package/skills/zh_cn/neta-community/SKILL.md

@@ -0,0 +1,109 @@
+---
+name: neta-community
+description: Neta API 社区技能——浏览互动推荐流、查看作品详情、进行点赞等社区互动，并在社区语境下基于标签和角色浏览内容。当用户想“随便看看大家在玩什么”“刷推荐流”“对作品进行互动”时使用本技能；不负责分类/关键词层面的调研与复杂推荐筛选（这些由 neta-suggest 负责），也不直接生成图片/视频/歌曲（由 neta-creative 负责）。
+---
+
+# Neta Community Skill
+
+用于与 Neta API 交互，进行社区内容浏览、互动及标签查询。
+
+## Instructions
+
+1. 对于「**看社区里有什么内容**」「刷时间线/推荐流」「对作品点赞或互动」这类任务，可按以下方式使用本 skill：
+2. 推荐使用流程：
+   - 使用推荐流命令获取内容列表；
+   - 通过作品详情命令查看单个作品；
+   - 根据需要对作品进行点赞等互动。
+3. 若用户需要「按分类/关键词做系统性调研或复杂筛选」，应切换到 `neta-suggest`。
+4. 若用户希望直接**创作新内容**（图片/视频/歌曲/MV），应切换到 `neta-creative`。
+
+## 前置条件
+
+确保已设置环境变量 `NETA_TOKEN`。
+
+确保已安装最新版本的 Neta Cli
+```
+neta-cli --version
+0.6.0
+```
+
+```
+npm i @talesofai/neta-cli@latest -g
+```
+
+```
+pnpm add -g @talesofai/neta-cli@latest
+```
+
+## 命令使用
+
+### 内容推荐流
+
+**推荐流获取**
+```bash
+neta-cli request_interactive_feed --page_index 0 --page_size 3
+```
+
+**获取内容详细信息**
+```bash
+neta-cli read_collection --uuid "作品-uuid"
+```
+
+📖 [详细指南](./references/interactive-feed.md)
+
+### 社区互动
+```bash
+neta-cli like_collection --uuid "目标作品 UUID"
+```
+📖 [详细指南](./references/social-interactive.md)
+
+### 标签查询
+
+**获取标签信息**
+```bash
+neta-cli get_hashtag_info --hashtag "标签名"
+```
+📖 [详细指南](./references/hashtag-research.md) - 调研流程、分析方法
+
+**获取标签角色**
+```bash
+neta-cli get_hashtag_characters --hashtag "标签名" --sort_by "hot"
+```
+
+**获取标签合集**
+```bash
+neta-cli get_hashtag_collections --hashtag "标签名"
+```
+
+### 角色查询
+
+**搜索角色**
+```bash
+neta-cli search_character_or_elementum --keywords "关键词" --parent_type "character" --sort_scheme "exact"
+```
+📖 [详细指南](./references/character-search.md) - 搜索策略、参数选择
+
+**获取角色详情**
+```bash
+neta-cli request_character_or_elementum --name "角色名"
+```
+
+**通过 UUID 查询**
+```bash
+neta-cli request_character_or_elementum --uuid "uuid"
+```
+
+## 参考文档
+
+| 场景 | 文档 |
+|------|------|
+| 🎮 互动玩法推荐  | [interactive-feed.md](./references/interactive-feed.md) |
+| 💬 社区互动    | [social-interactive.md](./references/social-interactive.md) |
+| 🏷️ 标签调研 | [hashtag-research.md](./references/hashtag-research.md) |
+| 👤 角色查询 | [character-search.md](./references/character-search.md) |
+
+## 使用建议
+
+1. **先浏览后互动**：先通过推荐流了解整体内容分布，再对感兴趣的作品进行点赞等互动。
+2. **结合标签使用**：在社区语境下使用标签与角色查询，可以快速聚焦到相关作品集合。
+3. **与调研/创作 skill 联动**：当需要更深入的标签/分类调研时配合 `neta-suggest`，当需要从社区作品出发进行二创时配合 `neta-creative`。