# EmulatorJS

此扩展允许您直接从 SillyTavern 聊天中玩复古主机游戏。

# 安装

先决条件：

• 最新版本的 SillyTavern。
• 从网络下载的 ROM 文件。您可以在任何地方找到它们。

如何安装：

1. 使用 SillyTavern 的扩展下载器安装。
2. 或使用此链接：https://github.com/SillyTavern/SillyTavern-EmulatorJS

# 使用方法

• 打开"EmulatorJS"扩展菜单。
• 点击"添加 ROM 文件"。ROM 保存到您的浏览器存储中，不存储在服务器上。
• 选择要添加的游戏文件。输入名称和核心（如果未自动检测到）。如果核心需要 BIOS 文件，也要添加它。
• 点击列表中的"播放"按钮或通过魔杖菜单启动。
• 启动游戏后，您可以在模拟器框架中自定义控件和其他设置。
• 如果需要休息，请使用保存/加载状态功能。

查看 EmulatorJS 文档以查看可用核心及其要求列表：核心。

# 评论模式

借助多模态模型的力量，您的 AI 机器人可以看到您的游戏过程并提供机智的角色内评论。

# 要求

1. 支持 ImageCapture 的浏览器。在桌面 Chrome 上测试过。Firefox 需要通过配置启用。Safari 不工作。
2. 建议使用具有图像内联模式的聊天完成 API。检查 API 文档以查看所选模型是否支持多模态提示。
3. 如果禁用了图像内联，请确保启用了图像描述生成扩展，然后选择"多模态"描述来源。

# 如何启用评论

1. 确保您在 EmulatorJS 扩展设置中设置了提供评论的间隔。此设置定义角色使用您当前游戏画面的图像被查询评论的频率。值为 0 表示不提供评论。
2. 选择角色聊天并启动游戏。为获得最佳性能，请确保 ROM 文件正确命名，以便 AI 可以有更多背景上下文。
3. 像平常一样开始游戏。视觉模型将被定期查询，根据它"看到"的最新截图编写评论。

# 设置

1. 描述模板 - 用于描述游戏内截图的提示。支持 {{game}} 和 {{core}} 附加宏。
2. 评论模板 - 用于根据生成的描述编写评论的提示。支持 {{game}}、{{core}}、{{caption}} 附加宏。对于图像内联模式，{{caption}} 替换为 see included image。
3. 强制描述 - 将强制使用多模态描述，即使支持并启用了图像内联。

# 为什么我没有看到任何评论？

评论被临时暂停（跳过间隔步骤）如果：

1. 模拟器暂停（使用暂停按钮，不是游戏内）。
2. 浏览器窗口失去焦点。
3. 用户输入区域不为空。这是为了让您安静地输入回复。
4. 另一个回复生成正在进行中。
5. TTS 语音正在大声朗读。评论被延迟（最多 30 秒）直到完成，但不会跳过。
6. 角色卡或组当前打开。从欢迎屏幕启动游戏时禁用评论模式。

其他常见问题：

1. 确保您在启动游戏之前设置了评论间隔。
2. 确保您设置了多模态 API 密钥，并且 ST 服务器控制台中没有错误。

仍然不工作？向我们发送您的浏览器调试控制台日志（按 F12）。

# 致谢

• EmulatorJS 引擎 (GPLv3): https://github.com/EmulatorJS/EmulatorJS