回声工坊(TRPG-Replay-Generator)使用手册

1. 项目目录结构及介绍

回声工坊的项目结构设计清晰，便于开发者理解和扩展。以下是其基本目录结构及其简要说明：

.
├── assets          # 存放项目相关的静态资源文件，如图标、图片等
├── core            # 核心逻辑和主要功能实现的Python源代码
├── doc             # 文档目录，包括操作手册和开发指南
├── gui             # 图形用户界面(GUI)相关代码
│   ├── d           # GUI的设计文件或特定UI组件
│   ├── f           # 可能是GUI的框架或格式相关文件
│   ├── p           # GUI的主程序文件
│   └── spec        # GUI布局或规格定义文件
├── intel           # 可能涉及项目智能处理或分析的模块
├── tools_scripts   # 工具脚本，用于辅助开发或自动化任务
│   ├── toy         # 示例或玩具性质的脚本文件
├── gitignore       # Git忽略文件，定义哪些文件不应被版本控制
├── LICENSE         # 项目许可协议，采用GPL-3.0
├── README-en.md    # 英文版项目介绍文档
├── README.md       # 中文版项目介绍文档，包含项目概述和基本使用说明
├── build.ps1       # PowerShell脚本，用于构建过程
├── gui.spec        # 用于生成GUI应用的配置文件，可能与PyInstaller等打包工具相关
└── ...             # 其他可能的源码文件和配置文件

每个模块都有明确的职责，核心源码(core)处理业务逻辑，gui目录负责可视化交互，而文档(doc)和配置文件则是用户理解和配置项目的钥匙。

2. 项目的启动文件介绍

主要的启动文件通常位于项目的顶级目录中，虽然具体文件名在描述中没有直接给出，但根据常规，可能是main.py或者直接使用GUI入口文件。对于回声工坊，运行流程可能通过执行main.py或其他指定的脚本来初始化应用，尤其是在源代码环境中。如果您使用的是从GitHub直接下载的源代码版本，则需查找类似的启动入口，并遵循项目文档中指示的命令来执行，如：

python main.py

如果是二进制版本，启动文件通常名为TRPG-Replay-Generator-vX.X.X.exe，其中X.X.X代表版本号，直接双击即可运行。

3. 项目的配置文件介绍

回声工坊的配置可能涉及到多个方面，包括但不限于应用程序的偏好设置(preferences.ini或通过环境变量指定)，媒体定义文件(MediaObject.txt)，角色定义表(CharacterTable.tsv)等。然而，直接的配置文件名在提供的资料中并未明确提及，重点在于如何通过脚本或图形界面进行配置。

• 媒体定义文件：您会在项目中找到一个示例或者建议的媒体定义文件路径，这通常用来指定各种媒体资源的路径和属性。
• 角色定义表：用来定义游戏中各角色的信息，包括语音、立绘等，通常以.tsv格式存储。
• 项目级配置：在源码使用时，配置可能通过代码中的默认参数或外部配置文件加载，比如在config.py（假设存在）中定义或通过命令行参数传递。

为了具体配置，项目可能会引导用户在首次运行时或通过设置界面进行个性化设置。用户可能需要手工编辑这些文件或在图形界面中指定它们的位置以满足个性化需求。项目文档和GUI中的帮助是获取这些配置细节的关键来源。

请注意，实际操作时，请参考项目根目录下最新的README.md文件，因为具体的文件名和配置细节可能会有所变化。