knowhow_v2.md
5.55 KB
古风互动剧本 Knowhow v2
版本:v2 创建时间:2026-03-29 来源:Hunt 调研数据 + 增强调研数据
执行摘要
本文档整合 Hunt 猎取的调研数据和增强调研数据,产出古风互动剧本生成的系统化知识。
v2 新增:技术实现规范 - 涵盖选题输入→剧本输出的完整数据流转、API接口、数据库设计。
一、核心知识体系(v1)
1.1 古风互动剧本定义
古风互动剧本是将中国传统古典文学内容通过互动叙事技术改造的互动内容形式。核心是让用户从"旁观者"变为"参与者"。
1.2 三大改编来源
| 来源 | 经典IP | 改编重点 |
|---|---|---|
| 四大名著 | 红/西/三/水 | 经典情节+角色命运 |
| 唐传奇 | 聂隐娘/柳毅传 | 侠义+奇幻 |
| 明清小说 | 聊斋/三侠五义 | 侠义公案 |
二、标杆案例学习(v1)
2.1 Elite 级别案例
| 案例 | 评分 | 核心亮点 |
|---|---|---|
| 《大圣归来》 | 92 | 角色重塑+视角创新+情感共鸣 |
| 《黑镜:潘达斯奈基》 | 90 | 高频选择+即时反馈+多结局 |
| 《逆袭之星光璀璨》 | 95 | 数值系统+多角色+多结局 |
| 《深宫曲》 | 88 | 养成系统+多周目+随机事件 |
2.2 Average 级别警示
| 案例 | 问题 | 教训 |
|---|---|---|
| 抖音古风短剧 | 现代用语/OOC/分支无意义 | 避免违和感,分支要有意义 |
三、互动系统设计模板(v1)
3.1 数值系统(来自《逆袭之星》)
【知名度】→ 解锁更多任务
【好感度】→ 攻略角色
【声望值】→ 影响结局
【金币】→ 购买道具
3.2 事件系统(来自《深宫曲》)
【随机事件】触发 → 选择 → 数值变化
【关键事件】触发 → 分支 → HE/NE/BE
【隐藏事件】条件满足 → 解锁隐藏剧情
3.3 分支模板(来自《黑镜》)
开始
├── 选择A → 分支A
│ ├── 选择C → 结局1
│ └── 选择D → 结局2
└── 选择B → 分支B
├── 选择E → 结局3
└── 选择F → 结局4
四、创作避坑指南(v1)
4.1 高频问题
| 问题 | 解决方案 |
|---|---|
| 现代用语 | 使用古称,如"相公"而非"亲爱的" |
| OOC | 严格对照原著人设 |
| 分支无意义 | 每个选择必须影响剧情 |
| 烂尾 | 每个分支都有合理结局 |
4.2 质量检查清单
- [ ] 时代背景正确(称呼、礼节、服饰)
- [ ] 角色性格不OOC
- [ ] 分支逻辑自洽
- [ ] 诗词贴切
- [ ] 无明显BUG
- [ ] 沉浸感足够
五、平台适配(v1)
5.1 橙光平台
- 特点:古风互动AVG最大平台
- 适配:分支选择+多结局+养成
5.2 易次元
- 特点:宫廷养成为主
- 适配:数值养成+多周目
5.3 短视频平台
- 特点:短平快
- 适配:投票+选择题
六、核心技术规范(v2 新增)
6.1 数据流转
interactive-video-selector (选题)
↓ train_dataset.json
lemonv_drama (剧本生成)
↓ 剧本JSON
insert-drama.js (上传API)
↓
dramas/drama_characters/drama_scripts 表
6.2 选题输入格式 (train_dataset.json)
{
"id": "test_001",
"source": "微博热搜",
"title": "婆婆不同意儿子娶外地媳妇,婚礼现场大闹",
"content": "一对新人在酒店举办婚礼...",
"expected_form": "对话形式",
"expected_score_range": "80-95",
"expected_features": ["高冲突性", "多角色", "适合AB选择"]
}
6.3 剧本输出格式 (JSON)
{
"meta": { "id", "title", "era", "genre", "word_count", "created_at" },
"characters": [
{ "id", "name", "role", "age", "persona": { "appearance", "personality", "background" }, "image_prompt" }
],
"scenes": [
{ "id", "name", "location", "time", "atmosphere", "props", "image_prompt" }
],
"plots": [
{ "id", "type", "title", "content", "choices": [{ "id", "text", "next_plot_id" }] }
],
"endings": [
{ "id", "name", "condition", "summary", "quality" }
]
}
6.4 数据库插入脚本
node insert-drama.js <json文件路径>
必需字段:
name: 剧本名称characters[]: 角色数组script[]: 台词数组userId: 用户ID (可选,默认1)
6.5 环境变量配置
DB_HOST=127.0.0.1
DB_PORT=3306
DB_NAME=shadiao_drama
DB_USER=root
DB_PASSWORD=your_password
WANJIE_API_KEY=your_wanjie_api_key
OSS_REGION=oss-cn-beijing
OSS_ACCESS_KEY_ID=your_access_key
OSS_ACCESS_KEY_SECRET=your_access_secret
OSS_BUCKET=your_bucket
七、核心洞察(v1 + v2)
洞察1:经典+互动是核心
改编应尊重原著内核,不是魔改,是二次创作。
洞察2:角色代入是第一生产力
双视角、多结局是增加可玩性的关键。
洞察3:诗词意境是差异化竞争力
与普通现代互动剧不同,诗词意境是加分项。
洞察4:分支设计要"有意义的选择"
不是所有选择都有意义,最失败的设计是"选A和选B都一样"。
洞察5(v2):技术链路完整性
从选题到上线的完整数据流:选题JSON → 剧本生成 → API上传 → 数据库存储
[RESULT: DONE] knowhow.md v2 构建完成,在 v1 基础上整合增强调研数据:
- 保留原有创作知识体系(定义、改编来源、标杆案例、互动系统、避坑指南、平台适配)
- 新增技术实现规范(数据流转、输入输出格式、API接口、环境变量)
- 总计7大部分
[/RESULT]