RachelForster/Shinsekai

Shinsekai – 视觉小说风格角色扮演游戏的人工智能桌面助手

项目简介 – Shinsekai（新世界）是一款本地运行的桌面应用程序，让您可以与galgame、乙女游戏或叙事驱动型角色扮演游戏中的角色聊天。对话由大型语言模型（LLM）生成，系统会自动同步角色的立绘（立绘）和情感表达，并可选添加语音合成（TTS）和语音识别（ASR）。所有组件（LLM、TTS、ASR、图像生成、自定义工具）均可通过基于React的设置界面配置，并可通过插件扩展。

核心功能

模块	功能说明
角色与模板管理	导入/导出角色包（`.char`），借助AI辅助生成角色扮演设置，应用多角色聊天模板，保留对话历史并支持会话的保存/加载。
立绘与演出	为每个角色附加多张立绘图像，为每张图像添加情感标签，界面会根据对话中的情感指令自动切换图像。
语音	通过GPT-SoVITS、Genie TTS、CosyVoice等进行文本转语音；可选播放预录的语音文件。语音识别默认使用Vosk，通过插件可支持Whisper风格的后端。
LLM与工具	通过API设置文件连接任何兼容OpenAI的端点（DeepSeek、OpenAI等）。支持流式响应和工具调用；工具可由内置适配器、插件或外部MCP服务器提供。
文本生成图像（T2I）	连接ComfyUI服务器（或其他适配器）即时生成角色图像；配置位于同一API设置面板中。
React设置中心	一个基于Web的界面（`webui_react.py`），用于管理API密钥、模型ID、立绘资源、主题、插件和MCP连接。
插件系统	SDK允许开发者添加新适配器（LLM、TTS、ASR、T2I）、新工具或UI面板。插件列在`data/config/plugins.yaml`中，可从设置界面安装/启用。
MCP（模型上下文协议）	无需编写插件即可注册远程工具服务（SSE或stdio）；远程工具成为当前LLM工具集的一部分。
主题编辑器	可视化的聊天窗口皮肤编辑器 – 字体、颜色、布局、名牌等。
本地数据优先	所有配置、角色包、历史和生成的资源都存放在`data/`下，便于备份和离线使用。

快速开始（约5分钟）

获取代码 – git clone https://github.com/RachelForster/Shinsekai && cd Shinsekai (或下载发布包)。
安装 – 运行平台特定的install.*脚本，或从environment.yml创建Conda环境并执行pip install -r requirements.txt。
启动设置界面 – 双击start-react.*（Windows/macOS/Linux）。脚本会启动一个本地Python HTTP桥接，并在浏览器中打开React设置页面。
配置LLM – 在API设置中选择提供商，填写模型ID、API密钥和基础URL，然后保存。
添加角色 – 通过角色管理选项卡导入.char包（例如发布版中的nanami.char）。
创建聊天模板 – 选择您想要的角色，生成模板，并打开主聊天窗口。
对话 – 输入或说话；LLM回复，立绘根据情感标签切换，可选的TTS会朗读台词。

扩展Shinsekai

插件 – 将插件文件夹放在plugins/下并在data/config/plugins.yaml中列出，或从内置插件注册表UI安装。使用提供的SDK（python -m sdk.cli create …）搭建新的适配器、工具或UI面板。
MCP服务 – 安装mcpPython包，运行兼容的服务器，并将data/config/mcp.yaml（或设置界面）指向该服务器。远程工具会自动出现在LLM的工具列表中。
自定义T2I流程 – 在API设置中配置ComfyUI端点（或任何其他T2I服务），然后在角色的立绘生成步骤中引用工作流/节点ID。

构建桌面应用（Tauri）

如果您需要原生桌面包装器：

cd frontend
pnpm install
pnpm tauri:dev   # 用于开发
pnpm tauri build  # 用于发布包

构建过程会打包React前端，签署更新程序（设置TAURI_SIGNING_PRIVATE_KEY），并为目标操作系统生成安装程序。

许可证与社区

许可证 – 源代码开放，但重新分发编译后的应用程序、发布版或商业使用需要书面许可（请参阅LICENSE）。
社区 – QQ群928985460、GitHub问题跟踪器以及单独的插件注册表仓库。

总结

Shinsekai是一个非常完整的本地托管平台，结合了LLM驱动的对话、动态角色立绘、语音合成以及可扩展的工具，用于交互式叙事。它面向那些希望在不依赖云服务进行繁重工作的前提下获得自包含的“视觉小说聊天”体验的爱好者和创作者。