jinye_huang/TravelContentCreator
Template
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
TravelContentCreator/docs/FIELD_REFACTOR_DESIGN.md

589 lines
18 KiB
Markdown
Raw Normal View History

完成了大部分的模块设计，包括新的笔记创作系统
2025-12-09 21:16:44 +08:00
# AIGC 字段重构设计
> 版本: 1.0.0
> 日期: 2024-12-09
> 状态: 设计中
---
## 1. 背景与目标
### 1.1 当前问题
1. **缺少热点追踪**: 无法结合时事热点生成更有传播力的内容
2. **参考内容利用不足**: 仅作为"参考"，未能实现"仿写"模式
3. **字段命名混乱**: `object`/`targetAudience` 等命名不直观
4. **数据结构扁平**: 缺乏层次，不便扩展
### 1.2 设计目标
1. **新增热点字段**: 支持近期热点、趋势追踪、新闻事件
2. **增强参考内容**: 支持"参考"和"仿写"两种模式
3. **统一字段命名**: 采用清晰的下划线命名
4. **结构化设计**: 分层组织，便于扩展
---
## 2. 字段重构方案
### 2.1 输入字段总览
```
┌─────────────────────────────────────────────────────────────┐
│ AIGC 输入参数 │
├─────────────────────────────────────────────────────────────┤
│ 基础信息 │
│ ├── scenic_spot 景区对象 │
│ ├── product 产品对象 │
│ ├── style 风格对象 │
│ └── audience 受众对象 │
├─────────────────────────────────────────────────────────────┤
│ 热点信息 (NEW) │
│ ├── hot_topics 近期热点列表 │
│ ├── trending_events 趋势事件 │
│ └── news_context 新闻背景 │
├─────────────────────────────────────────────────────────────┤
│ 参考内容 (ENHANCED) │
│ ├── reference_mode 参考模式 (reference/rewrite) │
│ ├── reference_content 参考正文 │
│ └── reference_style 参考风格特征 │
├─────────────────────────────────────────────────────────────┤
│ 生成控制 │
│ ├── num_topics 选题数量 │
│ ├── month 目标月份 │
│ ├── enable_judge 是否审核 │
│ └── prompt_version Prompt 版本 │
└─────────────────────────────────────────────────────────────┘
```
### 2.2 热点信息字段 (NEW)
```yaml
# 热点信息结构
hot_topics:
type: object
required: false
description: "近期热点信息"
fields:
# 热点事件列表
events:
type: array
items:
- title: "热点标题"
source: "来源 (微博/抖音/新闻)"
heat_score: 95 # 热度分数 0-100
related_keywords: ["关键词1", "关键词2"]
expire_date: "2025-02-15" # 热点有效期
# 节日/节气
festivals:
type: array
items:
- name: "春节"
date: "2025-01-29"
type: "traditional" # traditional/modern/custom
marketing_angle: "团圆、返乡、年味"
# 趋势话题
trending:
type: array
items:
- topic: "#冬季旅游"
platform: "小红书"
trend_direction: "rising" # rising/stable/falling
related_content_count: 50000
```
**使用场景**:
- 选题生成时，结合热点事件选择发布时机
- 内容生成时，融入热点话题增加传播力
- 标题创作时，借势热点提高点击率
### 2.3 参考内容字段 (ENHANCED)
```yaml
# 参考内容结构
reference:
type: object
required: false
description: "参考内容配置"
fields:
# 参考模式
mode:
type: string
enum: ["none", "reference", "rewrite"]
default: "none"
description: |
- none: 不使用参考内容
- reference: 参考风格和结构，原创内容
- rewrite: 基于参考内容改写，保留核心信息
# 参考正文
content:
type: string
description: "参考的正文内容"
# 参考标题
title:
type: string
description: "参考的标题"
# 风格特征提取
style_features:
type: object
description: "从参考内容提取的风格特征"
fields:
tone: "活泼/专业/温馨" # 语气
structure: "总分总/列表式/故事式" # 结构
emoji_density: "high/medium/low" # emoji 密度
paragraph_style: "短句/长句" # 段落风格
# 保留元素
preserve_elements:
type: array
description: "必须保留的元素"
items:
- "价格信息"
- "核心卖点"
- "行动号召"
# 改写指令
rewrite_instructions:
type: string
description: "额外的改写指令"
example: "保持原文的幽默感，但更换景区信息"
```
**参考模式说明**:
| 模式 | 说明 | 适用场景 |
|-----|------|---------|
| `none` | 完全原创 | 常规内容生成 |
| `reference` | 参考风格，原创内容 | 学习爆款风格 |
| `rewrite` | 基于参考改写 | 快速复制成功内容 |
### 2.4 完整参数 Schema
#### topic_generate (选题生成)
```python
{
# === 基础参数 ===
"month": "2025-02", # 必填，目标月份
"num_topics": 5, # 选填，默认 5
# === 核心对象 (参考 Java ProductPackage 设计) ===
"subject": { # 必填，主体信息
"id": 1, # 对应 ProductPackage.id
"name": "北京环球影城", # 对应 packageName/scenicName
"type": "scenic_spot", # 数据类型 (scenic_spot/hotel/restaurant)
"description": "亚洲最大的环球影城主题公园", # 详细描述
"location": "北京市通州区", # 对应 address
"traffic_info": "地铁1号线环球度假区站", # 交通指南
"highlights": ["哈利波特", "变形金刚"], # 亮点
"advantages": "全球顶级主题乐园", # 优势/特色
"products": [ # 产品列表 (对应 ProductPackage 的价格等字段)
{
"id": 10,
"name": "单日票",
"price": 638, # 对应 realPrice
"original_price": 738, # 对应 originPrice
"sales_period": "2025-01-01 至 2025-03-31", # 售卖期
"package_info": "含一次入园", # 套票详情
"usage_rules": "入园当日有效", # 使用规则
}
]
},
"style": { # 选填，风格
"id": "gonglue",
"name": "攻略风",
},
"audience": { # 选填，受众
"id": "qinzi",
"name": "亲子向",
},
# === 热点信息 ===
"hot_topics": { # 选填，目前留空，后续对接数据源
"events": [],
"festivals": [],
"trending": []
},
# === 控制参数 ===
"prompt_version": "latest"
}
```
#### content_generate (内容生成)
```python
{
# === 选题信息 ===
"topic": { # 必填，选题 (来自选题生成的输出)
"index": 1,
"date": "2025-02-10",
"title": "春节遛娃首选！环球影城全攻略🎢",
"subject_name": "北京环球影城",
"product_name": "单日票",
"style": "攻略风",
"audience": "亲子向",
"logic": "春节假期家庭出游高峰..."
},
# === 核心对象 ===
"subject": { ... }, # 选填，主体信息 (同上)
"style": { ... }, # 选填，风格
"audience": { ... }, # 选填，受众
# === 热点信息 ===
"hot_topics": { ... }, # 选填，热点信息
# === 参考内容 ===
"reference": { # 选填，参考内容
"mode": "rewrite", # none/reference/rewrite
# none: 不使用参考
# reference: 参考风格，本质原创
# rewrite: 保留框架，只换主体
"title": "上海迪士尼遛娃天花板！一日游攻略",
"content": "带娃去迪士尼，这篇攻略你一定要收藏！..."
},
# === 控制参数 ===
"enable_judge": true,
"prompt_version": "latest"
}
```
---
## 3. 输出字段重构
### 3.1 选题输出
```python
{
"topics": [
{
# === 基础信息 ===
"index": 1, # 序号 (整数)
"date": "2025-02-10", # 发布日期
"title": "春节遛娃首选！...", # 选题标题
# === 关联信息 ===
"subject_name": "北京环球影城", # 主体名称
"subject_id": 1, # 主体 ID
"product_name": "单日票", # 产品名称
"product_id": 10, # 产品 ID
"style_name": "攻略风", # 风格名称
"style_id": "gonglue", # 风格 ID
"audience_name": "亲子向", # 受众名称
"audience_id": "qinzi", # 受众 ID
# === 策略逻辑 ===
"logic": "春节假期家庭出游高峰...",
"product_logic": "...",
"style_logic": "...",
"audience_logic": "...",
# === 热点关联 ===
"hot_topic_used": "春节档电影热映", # 使用的热点
"festival_used": "春节", # 关联的节日
}
],
"count": 1
}
```
### 3.2 内容输出
```python
{
"content": {
# === 核心内容 ===
"title": "春节遛娃首选！环球影城全攻略🎢",
"content": "春节带娃去哪玩？...",
"tag": "#北京旅游 #环球影城 #亲子游 ...",
# === 内容分析 (NEW) ===
"analysis": {
"word_count": 450,
"emoji_count": 12,
"paragraph_count": 5,
"estimated_read_time": "2分钟"
},
# === 参考关联 (NEW) ===
"reference_info": {
"mode_used": "rewrite",
"similarity_score": 0.35, # 与参考内容相似度
"preserved_elements": ["价格信息", "核心卖点"]
},
# === 热点融入 (NEW) ===
"hot_topic_integration": {
"topics_used": ["春节"],
"keywords_included": ["团圆", "年味"]
}
},
"judge_result": {
"passed": true,
"score": 85,
"suggestions": []
}
}
```
---
## 4. Prompt 模板更新
### 4.1 选题生成 Prompt 更新
```yaml
# prompts/topic_generate/v2.0.0.yaml
meta:
name: topic_generate
version: "2.0.0"
description: "小红书选题生成 - 支持热点追踪"
variables:
# ... 原有变量 ...
# 新增热点变量
hot_topics:
type: object
required: false
description: "热点信息对象"
system: |
你是景区小红书的每月选题策划投流师...
## 热点追踪规则 (NEW)
1. 优先结合当前热点事件进行选题
2. 节日营销要提前 1-2 周预热
3. 热点有时效性，注意 expire_date
4. 热点与产品要有自然关联，不要强行蹭热点
## 输出字段 (UPDATED)
- `title`: 选题标题 (必填，15-25字，可含emoji)
- `hot_topic_used`: 使用的热点 (选填)
- `festival_used`: 关联的节日 (选填)
...
user: |
...
{% if hot_topics %}
## 近期热点
{% if hot_topics.events %}
### 热点事件
{% for event in hot_topics.events %}
- {{ event.title }} (热度: {{ event.heat_score }}, 有效期至: {{ event.expire_date }})
{% endfor %}
{% endif %}
{% if hot_topics.festivals %}
### 节日节气
{% for festival in hot_topics.festivals %}
- {{ festival.name }} ({{ festival.date }}): {{ festival.marketing_angle }}
{% endfor %}
{% endif %}
{% if hot_topics.trending %}
### 趋势话题
{% for trend in hot_topics.trending %}
- {{ trend.topic }} @ {{ trend.platform }} ({{ trend.trend_direction }})
{% endfor %}
{% endif %}
{% endif %}
```
### 4.2 内容生成 Prompt 更新
```yaml
# prompts/content_generate/v2.0.0.yaml
meta:
name: content_generate
version: "2.0.0"
description: "小红书内容生成 - 支持参考改写"
variables:
# ... 原有变量 ...
# 新增参考变量
reference:
type: object
required: false
description: "参考内容配置"
hot_topics:
type: object
required: false
description: "热点信息"
system: |
你是景区小红书爆款文案策划...
## 参考内容使用规则 (NEW)
### 模式一: reference (参考风格)
- 学习参考内容的语气、结构、emoji 使用
- 内容完全原创，不复制原文
- 保持自己的创意和表达
### 模式二: rewrite (改写模式)
- 基于参考内容进行改写
- 保留核心信息和卖点
- 更换具体细节 (景区、产品、时间)
- 相似度控制在 30%-50%
## 热点融入规则 (NEW)
1. 自然融入热点话题，不要生硬
2. 标题可借势热点提高点击率
3. 正文可结合热点场景
4. TAG 可包含热点关键词
...
user: |
...
{% if reference and reference.mode != 'none' %}
## 参考内容
模式: {{ reference.mode }}
{% if reference.title %}
### 参考标题
{{ reference.title }}
{% endif %}
{% if reference.content %}
### 参考正文
{{ reference.content }}
{% endif %}
{% if reference.style_features %}
### 风格特征
- 语气: {{ reference.style_features.tone }}
- 结构: {{ reference.style_features.structure }}
- Emoji密度: {{ reference.style_features.emoji_density }}
{% endif %}
{% if reference.preserve_elements %}
### 必须保留的元素
{{ reference.preserve_elements | join(', ') }}
{% endif %}
{% if reference.rewrite_instructions %}
### 改写指令
{{ reference.rewrite_instructions }}
{% endif %}
{% endif %}
{% if hot_topics %}
## 可融入的热点
{% for event in hot_topics.events %}
- {{ event.title }}
{% endfor %}
{% endif %}
```
---
## 5. 实现计划
### Phase 1: 字段扩展 (本次) ✅
| 任务 | 优先级 | 状态 |
|-----|-------|------|
| 更新 topic_generate 引擎参数 | P0 | ✅ 完成 |
| 更新 content_generate 引擎参数 | P0 | ✅ 完成 |
| 创建 v2.0.0 Prompt 模板 | P0 | ✅ 完成 |
| 更新字段映射文档 | P1 | ✅ 完成 |
**测试结果**:
- 选题生成: 成功融入热点事件和节日信息，输出包含 `hotTopicUsed` 和 `festivalUsed`
- 内容生成: 成功支持 `reference` 改写模式，保留原文结构并替换具体内容
### Phase 2: 热点数据源 (后续)
| 任务 | 优先级 | 状态 |
|-----|-------|------|
| 设计热点数据采集接口 | P1 | 规划中 |
| 对接微博热搜 API | P2 | 规划中 |
| 对接小红书趋势 API | P2 | 规划中 |
| 节日日历数据库 | P1 | 规划中 |
### Phase 3: 智能分析 (远期)
| 任务 | 优先级 | 状态 |
|-----|-------|------|
| 参考内容风格自动提取 | P2 | 规划中 |
| 热点与产品关联度分析 | P2 | 规划中 |
| 内容相似度检测 | P2 | 规划中 |
---
## 6. 兼容性设计
### 6.1 向后兼容
```python
# 旧字段保留，新字段可选
{
# 旧字段 (保留)
"object": "北京环球影城",
"targetAudience": "亲子向",
# 新字段 (可选)
"scenic_spot_name": "北京环球影城",
"audience_name": "亲子向",
"hot_topic_used": "春节"
}
```
### 6.2 Java 端适配
```java
public class Topic {
// 新字段
private String title;
private String scenicSpotName;
private String hotTopicUsed;
// 兼容方法
public String getScenicSpotName() {
return scenicSpotName != null ? scenicSpotName : object;
}
}
```
---
## 7. 总结
### 新增字段
| 字段 | 位置 | 说明 |
|-----|------|------|
| `hot_topics` | 输入 | 热点信息对象 |
| `hot_topics.events` | 输入 | 热点事件列表 |
| `hot_topics.festivals` | 输入 | 节日节气列表 |
| `hot_topics.trending` | 输入 | 趋势话题列表 |
| `reference` | 输入 | 参考内容配置 |
| `reference.mode` | 输入 | 参考模式 |
| `reference.content` | 输入 | 参考正文 |
| `reference.style_features` | 输入 | 风格特征 |
| `title` | 输出 | 选题标题 |
| `hot_topic_used` | 输出 | 使用的热点 |
| `festival_used` | 输出 | 关联的节日 |
### 改进点
1. **热点追踪**: 支持事件、节日、趋势三类热点
2. **参考模式**: 支持 none/reference/rewrite 三种模式
3. **字段规范**: 统一命名，保持兼容
4. **结构化**: 分层组织，便于扩展
Reference in New Issue Copy Permalink