剧本杀项目展示，可以改成电子书系统
本项目以 letter 为工程标识，是一套面向剧本杀场景的数字化内容管理与阅读平台。项目围绕剧本资料整理、人物剧本维护、组织者手册管理、地图线索关联以及分角色授权阅读，建立从内容录入、编辑校对、发布展示到移动端阅读的完整流程。系统由电脑管理后台、移动阅读端和后端服务组成，适合剧本资料整理者、主持人、门店运营人员及玩家使用。
项目主要解决剧本资料分散、纸质内容难检索、扫描图片难编辑、人物资料与线索缺少关联，以及不同身份之间容易提前看到秘密内容等问题。整理者可以把原本分散在 PDF、Word、图片和文字中的资料组织成结构清晰的电子内容，读者则通过统一入口查看故事介绍、阅读人物剧本、查阅地图和线索。
每个剧本都拥有独立的基础档案，可以维护中文名称、英文名称、分类、标签、封面、故事简介、背景正文、建议人数、体验时长、难度和适合读者说明。分类支持上下级结构，标签可以从多个角度描述剧本特点。运营人员能够通过分类、标签、排序和推荐配置组织内容，让读者更方便地找到适合自己的故事。
电脑后台以剧本内容工作台作为主要操作入口。编辑者选中一个剧本后，可以在同一个工作空间中维护基础资料、人物、分幕正文、人物关系、组织者手册、地图、线索、剧情幕、搜证轮次和阅读授权。切换剧本、人物或离开页面时，系统会对尚未保存的修改进行提醒，降低整理长篇资料时误丢内容的可能。
人物资料与人物剧本相互关联。管理员可以设置人物姓名、性别、职业、人物介绍、头像或立绘，以及展示顺序。新增人物时，系统会建立对应的人物剧本，随后可以继续编排该人物的章节、分幕和正文。人物信息既能作为选角与故事介绍的入口，也能连接到相关线索和人物关系，帮助读者逐步理解角色背景。
人物剧本采用书籍与章节的组织方式。每个人物拥有自己的资料本，章节可以设置标题、上级目录、内容类型、所属剧情幕、排序、建议阅读时长和剧透提醒。章节数量与层级可以按照实际剧本安排，适合整理多幕故事、背景回忆、人物任务以及补充资料。
组织者手册与人物剧本分别管理，使用相同的章节与图文内容体系。主持人可以将流程说明、阶段安排、主持提示、复盘解答等资料集中整理到手册中，通过目录快速定位。组织者资料能够设置独立的阅读范围，使玩家内容与主持资料分别维护。
正文采用结构化图文内容块保存，支持段落、标题、列表、表格、图片和引用。系统会根据正文生成阅读展示内容、纯文本、字数和内容摘要，并为内容块保留定位标识。这种组织方式既方便编辑与预览，也为移动端恢复阅读位置、识别正文变化提供基础。
资料导入是项目的重要功能。后台支持导入 PDF、DOC、DOCX，以及按顺序提交多张图片。PDF 可以优先提取已有文字层，对扫描页或文字较少的页面使用本地中文 OCR，也可以选择强制逐页识字。图片导入允许调整顺序、移除图片和检查重复文件，适合处理扫描剧本与连续拍摄的资料页。
OCR 使用随项目依赖提供的本地中文识别引擎，执行识字时不需要另行配置外部大模型接口。识别结果会进入校对环节，编辑者可以放大原图，对照提取文字，查看空白页或失败页提示，补录遗漏内容，并调整候选章节的标题、顺序及归属。
导入结果需要人工确认后才会写入正式正文。编辑者可以选择追加合并、替换整本或更新指定章节。确认保存时，系统会检查原有资料是否已被其他编辑操作修改，避免直接覆盖期间产生的新内容。导入后的资料回到草稿状态，经过检查后再发布，便于将识别、校对和对外展示分开处理。
地图功能把场景图片与可交互资料连接起来。一个剧本可以配置多张地图，每张地图都能维护名称、介绍和展示顺序。管理员可以在地图上标记地点，为地点设置说明、关联线索和可前往的相邻地点，使平面图成为资料导航入口。
移动端地图支持拖动、双指缩放、缩放按钮和位置复位。读者可以点击地图热点查看地点介绍与相关线索，也可以从地点列表进入。在没有配置底图时，地点与线索仍可通过列表查阅。线索还支持按照剧情幕、搜证轮次、地点和关联人物进行筛选，方便主持备本或阅读时交叉查找信息。
线索内容可以包含标题、类型、摘要、图片、图文正文和观察提示，并关联多个地点或人物。系统分别维护线索涉及的人物与允许阅读的人物，避免把内容关联直接当成访问授权。剧情幕和搜证轮次主要用于资料编排、归类与筛选，具体游戏节奏由组织者掌握。
人物关系图提供图形与列表两种查看方式。管理员可以设置关系双方、关系类型、自定义称谓、说明、方向、所属剧情幕和剧透标记。移动端支持拖动、缩放、全屏查看、按幕筛选和点击人物聚焦，读者可以查看关系标签与详细说明。剧透关系默认隐藏，确认后再加载相应内容。
权限设计围绕公开资料、人物资料和组织者资料展开。游客可以浏览已发布的公开信息，并阅读公开文册。受限人物剧本需要为账号授予相应人物身份，组织者资料则要求组织者授权。后台可以设置授权期限、调整授权或撤销授权，服务端在返回内容时检查授权状态。
剧透提醒与阅读权限分别生效。剧透提醒用于让读者确认是否继续查看，访问权限则决定账号能否取得受限内容。对于未授权线索，接口会返回锁定状态，并移除正文、正文图片和观察说明等受限信息。公开阅读接口同时检查内容的发布与启用状态，使草稿资料与已发布资料保持明确边界。
移动端设置发现、剧本库和收藏三个主要入口。发现页用于展示推荐故事、分类和精选内容；剧本库支持关键词、分类、角色人数、体验时长和难度筛选。读者进入剧本详情后，可以先了解公开背景、人物小传和基本信息，再进入人物剧本、组织者手册、地图线索或人物关系图。
阅读器采用连续滚动方式，支持分幕目录、目录抽屉、上一节与下一节切换、字号调整、行距调整，以及浅色、深色和纸色阅读底色。正文能够进行文字与图片混排，文字可以选择，图片可以点击查看原图。目录页会展示章节字数、建议阅读时间、已读状态和整体进度，并提供开始阅读与继续阅读入口。
阅读进度可以记录当前书籍、章节、段落位置、段内偏移和阅读百分比，让读者返回后继续阅读。系统支持自动或手动标记已读，并通过正文摘要识别内容是否发生变化，避免把旧内容的阅读状态直接套用到修改后的正文上。登录用户的收藏、阅读进度和阅读偏好通过服务端保存；游客的公开文册阅读位置与偏好保存在本机，游客记录与账号记录分别管理。
视觉设计支持按剧本题材营造阅读氛围。系统提供默认的秋山书笺风格，以及情感、推理、阵营、欢乐和恐怖等主题。主题可以从应用默认设置继承到分类，也可以为单个剧本指定。个人字号、行距和阅读底色优先满足读者习惯，使题材氛围与长时间阅读的舒适度能够兼顾。
内容运营方面，后台可以维护应用名称、Logo、副标题、首页问候语、主标题、应用介绍和精选区域文案。推荐内容可以设置展示位置、自定义标题、生效时间和显示顺序。发布操作会检查已保存的正文与关联资料，返回发布结果和需要处理的警告；下架操作则用于撤回对外展示的内容。
项目基于 ruoyi-plus-uniapp-single 单租户框架建设。后端使用 Java 21、Spring Boot、MyBatis-Plus、MySQL 和 Redis，按照 Controller、Service、DAO、Mapper 四层组织接口、业务规则、查询和数据访问。电脑管理端使用 Vue 3、TypeScript、Vite、Pinia 和封装后的 Element Plus 组件；移动端使用 Vue 3、TypeScript、UniApp 和项目内维护的 WD UI 组件，具备面向 H5、微信小程序等目标端的工程与构建配置。
底层同时提供用户、角色、菜单、权限、操作日志、文件资源和数据字典等管理能力，用于支撑剧本内容维护和日常运营。当前剧本业务代码已覆盖内容整理、导入校对、发布控制、身份授权、图文阅读和关联查阅等核心环节；文档解析、正文规范化、人物关系和阅读接口等部分也配置了相关自动化测试。