像素剧本圣殿步骤详解：如何导出带角色关系图谱的交互式剧本HTML文档
像素剧本圣殿步骤详解：如何导出带角色关系图谱的交互式剧本HTML文档
1. 工具介绍与环境准备
像素剧本圣殿（Pixel Script Temple）是基于Qwen2.5-14B-Instruct深度微调的专业剧本创作工具。它不仅具备强大的剧本生成能力，还能将创作结果以8-Bit复古美学风格呈现，特别适合游戏剧本、影视剧本等创意写作场景。
1.1 系统要求
- 操作系统：Windows 10/11或Linux（推荐Ubuntu 20.04+）
- 显卡：NVIDIA GPU（至少8GB显存）
- Python版本：3.8或更高
- 磁盘空间：至少20GB可用空间
1.2 快速安装
打开终端或命令提示符，执行以下命令完成环境准备：
# 克隆项目仓库 git clone https://github.com/scriptgen/pixel-script-temple.git cd pixel-script-temple # 安装依赖 pip install -r requirements.txt # 下载模型权重（约28GB） python download_weights.py安装过程大约需要30-60分钟，具体时间取决于网络速度。
2. 创建并完善剧本内容
2.1 启动创作界面
运行以下命令启动像素剧本圣殿的交互式界面：
python launch_script_temple.py --theme retro --gpu 0启动后，您将看到一个充满复古风格的创作界面，包含以下主要区域：
- 左侧：角色关系面板
- 中部：剧本编辑区
- 右侧：场景可视化预览
2.2 基础剧本创作
在剧本编辑区，您可以：
- 输入"/scene"开始一个新场景
- 输入"/char"添加或编辑角色
- 输入"/dialogue"编写对话
示例剧本片段：
/scene 夜晚 - 赛博城市 - 屋顶 /char 主角:维克多(男,35岁,黑客) /char 配角:霓(女,28岁,仿生人) [动作] 雨滴在霓虹招牌上折射出迷离的光，维克多蹲在屋顶边缘，手指在虚拟键盘上飞舞。 [对白-维克多] "这防火墙比我们想的要复杂...霓，你能接入他们的主系统吗？" [对白-霓] (眼睛闪烁蓝光) "正在尝试...但检测到量子加密层。"3. 构建角色关系图谱
3.1 添加角色关系
在角色关系面板中，您可以：
- 点击"+"按钮添加新角色
- 拖动角色之间的连线建立关系
- 右键点击关系线编辑关系类型
支持的关系类型包括：
- 亲情
- 友情
- 爱情
- 敌对
- 师徒
- 同事
3.2 自动关系推断
工具还提供AI辅助的关系推断功能。在命令窗口输入：
# 自动分析现有剧本内容并推断角色关系 /infer_relations --depth 3 --style cinematic这将分析剧本中对白和场景描述，自动生成可能的人物关系建议。
4. 导出交互式HTML文档
4.1 基本导出命令
完成剧本创作后，使用以下命令导出HTML：
python export_script.py --input my_script.pst --output script_with_graph.html --format interactive4.2 高级导出选项
您可以通过额外参数定制导出效果：
python export_script.py \ --input my_script.pst \ --output script_with_graph.html \ --format interactive \ --theme cyberpunk \ --animation true \ --relation_depth 2 \ --include_notes true参数说明：
--theme: 可选择retro/cyberpunk/fantasy等主题--animation: 是否启用场景过渡动画--relation_depth: 关系图谱显示层级--include_notes: 是否包含作者注释
4.3 导出结果解析
导出的HTML文档将包含以下交互功能：
- 可折叠场景树：点击场景标题展开/收起详细内容
- 动态关系图谱：鼠标悬停可查看关系详情，点击角色聚焦相关场景
- 风格切换：右上角可实时切换显示主题
- 搜索功能：可按角色名、场景关键词快速定位
5. 常见问题解决
5.1 导出文件过大
如果导出的HTML文件体积过大（超过10MB），可以尝试以下优化：
python export_script.py --input large_script.pst --optimize true --image_quality medium5.2 关系图谱显示异常
若角色关系显示不正确，请检查：
- 角色名称是否在剧本中保持一致
- 是否正确定义了关系类型
- 尝试重新运行关系推断：
/clear_relations /infer_relations --refresh true5.3 复古样式丢失
如果导出的HTML缺少像素风格，请确保：
- 导出时指定了正确的主题：
python export_script.py --theme retro - 所有样式文件已正确包含：
python check_assets.py --verify all
6. 总结与下一步建议
通过本教程，您已经掌握了使用像素剧本圣殿创建并导出交互式剧本文档的完整流程。这种包含角色关系图谱的HTML输出特别适合：
- 向制作团队展示剧本整体架构
- 用于剧本研讨会和创作讨论
- 作为游戏设计文档的组成部分
- 教学演示和案例分析
为了进一步提升使用体验，建议尝试：
- 探索不同的视觉主题（cyberpunk/fantasy/noir等）
- 使用
/auto_relation命令自动生成复杂人物关系网 - 尝试团队协作模式，多人同时编辑同一剧本
- 结合时间线视图(
/timeline)规划剧情发展节奏
获取更多AI镜像
想探索更多AI镜像和应用场景？访问 CSDN星图镜像广场，提供丰富的预置镜像，覆盖大模型推理、图像生成、视频生成、模型微调等多个领域，支持一键部署。