@talesofai/neta-skills 0.6.0

package/skills/zh_cn/neta-community/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-community/references/hashtag-research.md

@@ -0,0 +1,295 @@
+# 标签调研最佳实践
+
+适用于 `get_hashtag_info`、`get_hashtag_characters` 和 `get_hashtag_collections` 命令。
+
+---
+
+## 工作流程
+
+```
+1. 获取标签信息 → 2. 查看热门角色 → 3. 分析精选合集 → 4. 确定创作方向
+```
+
+---
+
+## 标签信息
+
+### 基本信息查询
+
+```bash
+neta-cli get_hashtag_info --hashtag "标签名"
+```
+
+**返回内容：**
+- 标签 lore（世界观设定）
+- 活动详情
+- 热度数据
+- 订阅数量
+
+### 标签 lore 使用
+
+lore 包含标签的世界观和设定，是创作的重要参考：
+
+```json
+{
+  "lore": [
+    {
+      "name": "设定名称",
+      "category": "设定类别",
+      "description": "详细描述..."
+    }
+  ]
+}
+```
+
+**应用：**
+- 基于 lore 创作符合世界观的内容
+- 使用 lore 中的关键词作为提示词
+- 保持创作与官方设定一致
+
+---
+
+## 角色调研
+
+### 获取热门角色
+
+```bash
+neta-cli get_hashtag_characters \
+  --hashtag "标签名" \
+  --sort_by "hot" \
+  --page_size 20
+```
+
+### 获取最新角色
+
+```bash
+neta-cli get_hashtag_characters \
+  --hashtag "标签名" \
+  --sort_by "newest" \
+  --page_size 20
+```
+
+### 筛选角色类型
+
+```bash
+# 只看 OC 角色
+neta-cli get_hashtag_characters --hashtag "标签名" --parent_type "oc"
+
+# 只看风格元素
+neta-cli get_hashtag_characters --hashtag "标签名" --parent_type "elementum"
+```
+
+### 分析角色特征
+
+```bash
+# 1. 获取角色列表
+neta-cli get_hashtag_characters --hashtag "标签名" > characters.json
+
+# 2. 分析热门角色的共同特征
+# - 发型/发色分布
+# - 服装风格
+# - 常见元素
+
+# 3. 获取详情
+neta-cli request_character --name "热门角色名"
+```
+
+---
+
+## 精选合集分析
+
+### 获取精选作品
+
+```bash
+neta-cli get_hashtag_collections --hashtag "标签名"
+```
+
+**返回内容：**
+- 精选作品列表
+- 封面图
+- 创作者信息
+- 点赞数
+
+### 分析热门作品
+
+```bash
+# 1. 获取合集
+neta-cli get_hashtag_collections --hashtag "标签名" > collections.json
+
+# 2. 分析高赞作品
+# - 使用的角色
+# - 视觉风格
+# - 构图特点
+# - 色彩搭配
+
+# 3. 总结成功要素
+```
+
+### 学习创作技巧
+
+通过精选合集学习：
+- 流行的构图方式
+- 常用的色彩搭配
+- 受欢迎的角色组合
+- 热门的场景设定
+
+---
+
+## 完整调研流程
+
+### 示例：新标签创作调研
+
+```bash
+# 1. 了解标签整体信息
+neta-cli get_hashtag_info --hashtag "魔法少女"
+
+# 2. 查看热门角色（前 20 个）
+neta-cli get_hashtag_characters --hashtag "魔法少女" --sort_by "hot" --page_size 20
+
+# 3. 查看精选作品
+neta-cli get_hashtag_collections --hashtag "魔法少女"
+
+# 4. 获取感兴趣角色的详情
+neta-cli request_character --name "角色名"
+
+# 5. 基于调研结果创作
+neta-cli make_image --prompt "符合标签风格的提示词..."
+```
+
+---
+
+## 数据记录
+
+### 调研笔记模板
+
+```markdown
+# 标签调研：标签名
+
+## 基本信息
+- 订阅数：xxx
+- 热度：xxx
+- 核心设定：...
+
+## 热门角色 Top 5
+1. 角色名 - 特征...
+2. 角色名 - 特征...
+3. ...
+
+## 流行元素
+- 发色：...
+- 服装：...
+- 道具：...
+- 背景：...
+
+## 创作方向
+基于调研，计划创作...
+```
+
+### 保存调研结果
+
+```bash
+# 保存完整调研数据
+mkdir research/标签名
+neta-cli get_hashtag_info --hashtag "标签名" > research/标签名/info.json
+neta-cli get_hashtag_characters --hashtag "标签名" > research/标签名/characters.json
+neta-cli get_hashtag_collections --hashtag "标签名" > research/标签名/collections.json
+```
+
+---
+
+## 常见用例
+
+### 新角色创作调研
+
+```bash
+# 1. 调研现有角色，避免重复
+neta-cli search_character_or_elementum --keywords "角色特征" --parent_type "character"
+
+# 2. 调研相关标签的热门元素
+neta-cli get_hashtag_characters --hashtag "相关标签"
+
+# 3. 基于调研设计独特角色
+```
+
+### 系列活动策划
+
+```bash
+# 1. 调研标签 lore 和设定
+neta-cli get_hashtag_info --hashtag "标签名"
+
+# 2. 分析精选作品的主题
+neta-cli get_hashtag_collections --hashtag "标签名"
+
+# 3. 策划符合标签调性的系列内容
+```
+
+### 竞品分析
+
+```bash
+# 1. 收集热门标签
+neta-cli get_hashtag_info --hashtag "标签 1"
+neta-cli get_hashtag_info --hashtag "标签 2"
+
+# 2. 对比各标签的热门角色
+neta-cli get_hashtag_characters --hashtag "标签 1" --sort_by "hot"
+neta-cli get_hashtag_characters --hashtag "标签 2" --sort_by "hot"
+
+# 3. 分析差异和机会点
+```
+
+---
+
+## 调研技巧
+
+### 发现新兴标签
+
+- 关注 `newest` 排序的新角色
+- 查看活跃度上升的标签
+- 注意跨界合作的标签
+
+### 识别趋势
+
+- 定期调研同一标签
+- 记录热门角色的变化
+- 观察精选作品风格演变
+
+### 高效调研
+
+- 先广度后深度（先了解整体，再深入细节）
+- 善用分页获取完整数据
+- 保存常用标签的调研结果
+
+---
+
+## 常见问题
+
+### Q: 如何找到适合创作的标签？
+
+**A:**
+1. 浏览热门标签列表
+2. 查看各标签的订阅数
+3. 选择与创作风格匹配的标签
+4. 考虑竞争程度（热门标签竞争大）
+
+### Q: 标签 lore 太长如何快速提取要点？
+
+**A:**
+1. 关注核心设定（世界观、背景）
+2. 提取关键词和术语
+3. 记录角色关系
+4. 注意禁忌/限制
+
+### Q: 如何判断标签的热度趋势？
+
+**A:**
+1. 对比不同时间的调研数据
+2. 观察新角色发布频率
+3. 查看精选合集更新时间
+4. 关注订阅数变化
+
+---
+
+## 相关文档
+
+- [角色查询](./character-search.md) - 获取角色详细信息
+- [图片生成](./image-generation.md) - 基于调研结果创作