面向 Galgame / 乙女 / 剧情向 RPG 的桌面助手：用大语言模型驱动角色对白，立绘与情绪联动，并可接入 语音合成、语音识别 与 视觉、工具 等扩展——一切在本地 Settings 里配置，聊天窗口专注演出。
- 角色演出一条龙：聊天模板、会话历史、立绘切图与情绪、TTS/ASR 与输入管线在同一套工作流里衔接，减少到处换工具。
- 双窗分工：设置中心（
webui.py/ 整合包）集中管 API、角色、插件；聊天主窗专责对白与演出，思路清晰。 - 多模型、可换引擎：在 API 设定 对接常见 LLM 与 OpenAI 兼容端点；TTS 含 GPT-SoVITS、Genie TTS 等，无独显也可选轻量方案；文生图可接 ComfyUI 等工作流（同页配置）。
- 听懂与说出口：麦克风 ASR（如 Vosk；更多后端可装插件）与台词 TTS 可选开关，适配「只打字」「只朗读立绘音频」等多种玩法。
- 模型不仅会聊天：内置/插件 LLM 工具（如角色与世界书相关能力）+ MCP 接入外部服务，把检索、自动化等能力收进同一次对话。
- 可扩展、可换肤：插件 SDK 扩展适配器与设置页、聊天栏控件；主题与聊天窗样式可通过配置与插件微调（如
chat_ui_theme）。 - 数据在本地、可备份：配置与资源默认落在项目
data/下（api.yaml、system_config.yaml、角色与历史等），便于打包备份与二次开发。 - 开源可玩：源码与 发行版整合包 任选；社区插件索引见 Shinsekai-Plugin-Registry。
教程： 配置 API 与导入角色包
| 模块 | 说明 |
|---|---|
| 角色与模板 | 创建 / 导入导出角色包（.char）；AI 辅助生成设定与背景；聊天模板一键套用多角色与世界书；会话 历史 读写、回溯与存档。 |
| 立绘与演出 | 多张三宣图 / 立绘管理；0–3 倍缩放；为每张图打 情绪标签，对白中的情绪指令与立绘切换联动；可选 CG / 特效字段（视模板与管线）。 |
| 语音 | TTS：GPT-SoVITS、Genie TTS、CosyVoice 等（API 设定中选引擎并填服务路径/URL）；选「不使用」时可仅播放 立绘绑定的台词音频。ASR：麦克风识别默认可走 Vosk；Whisper 类等可通过 插件 注册。 |
| LLM 与工具 | API 设定中配置供应商、模型 ID、Key、Base URL；支持 流式输出与 工具调用；工具来源包括内置/插件 @tool 与 MCP（data/config/mcp.yaml）。 |
| 文生图（T2I） | 在 API 设定中配置 ComfyUI 等服务端地址、工作流与节点 ID；可按需接入其他 T2I 适配器（插件注册）。 |
| 设置与系统集成 | PySide 设置界面集中管理 API（data/config/api.yaml）与 系统（data/config/system_config.yaml）：界面语言、语音识别后端、主题色、字体等。 |
| 插件 | data/config/plugins.yaml 清单加载；插件页发现/安装、启用禁用；扩展 LLM/TTS/ASR/T2I、工具与 Settings / 工具箱 / 聊天窗 入口。 |
| MCP | 插件 → MCP 子页或 YAML 连接远端/本机 MCP Server（SSE / stdio），工具并入当前进程的 LLM 工具列表。 |
| 视觉与其它扩展 | 视觉理解、主题编辑等能力可通过 官方或社区插件 启用（如仓库内 plugins/ 示例）；具体能力以各插件说明为准。 |
源码：
git clone https://github.com/RachelForster/Shinsekai
cd Shinsekai整合包： 从 Releases 下载解压。
| 平台 | 安装 | 启动 |
|---|---|---|
| Windows | 双击 install.bat |
双击 start.bat |
| macOS | 双击 install.command |
双击 start.command |
| Linux | ./scripts/install-linux.sh |
./scripts/start-linux.sh |
macOS 首次运行：如果双击提示「无法验证开发者」，请右键（或 Ctrl+点击）文件 → 打开，在弹出的对话框中再次点 打开 即可。或者前往 系统设置 → 隐私与安全性 中允许。
整合包用户：双击对应平台的安装脚本即可。
开发者 建议 Python 3.10 虚拟环境：
conda create -n shinsekai python=3.10
conda activate shinsekai
pip install -r requirements.txtLinux 源码用户也可以运行 ./scripts/install-linux.sh。如果已激活 Python 3.10 的非 base conda 环境，脚本会直接在当前环境安装依赖；否则会优先用 uv 创建 .venv，没有 uv 时需要系统提供 python3.10。
| 平台 | 操作 |
|---|---|
| Windows | 双击 start.bat |
| macOS | 双击 start.command |
| Linux | ./scripts/start-linux.sh |
源码用户：
python webui_qt.py- 在 API 设定 中填写 LLM（例如 DeepSeek / OpenAI 兼容端点），保存。
- 在 角色管理 导入角色包（示例：nanami.char；更多角色包见 社区资源）。
- 打开 聊天模板，勾选角色并生成模板。
- 启动聊天，即可在主窗口发消息、看立绘与回复。
需要台词语音合成时，可部署 GPT-SoVITS；机器较弱或无独显时，可在 API 设定中改用 Genie TTS 等方案。
- 顶部进入 API 设定。
- 选择供应商，填写 模型 ID、API Key、Base URL（部分供应商会自动填默认地址）。
- 保存后回到聊天流程即可使用。
用 data/config/plugins.yaml 登记插件；源码放在 plugins/<包名>/。宿主会合并 LLM / TTS / ASR / T2I 适配器、工具、Settings / 工具箱 / 聊天窗 等贡献。
- 图形界面：Settings → 插件：启用/禁用、从索引发现与下载、
pip install依赖（与当前解释器一致）。 - 索引仓库：Shinsekai-Plugin-Registry
- 脚手架：
python -m sdk.cli create --package your_plugin_name - 设计说明（英文）：docs/PLUGIN_DEVELOPER_GUIDE.md
修改清单后请 重启应用 以加载插件。
将 MCP 服务接入 本进程 LLM 工具列表：支持 SSE 与 stdio 等传输方式。
- 安装：
pip install mcp - 配置：
data/config/mcp.yaml，或在 Settings → 插件 → MCP 子页可视化编辑。 - 保存并应用 会重连服务并把远端工具注册到当前会话（可用前缀避免工具名冲突）。
与插件系统独立：不写插件也能通过 YAML 接外部能力。
我们非常欢迎社区贡献，也希望能让协作过程对彼此都轻松。CONTRIBUTING.md 有详细说明，这里简单列几条约定：
- 先开 Issue 聊聊想法 — 避免你花时间写完了才发现方向对不上。Issue 里说清楚想做什么、为什么，等 maintainer 确认后再动手，效率更高。
- 一个 PR 只做一件事 — 小步快跑比一个巨大的 PR 容易 review 太多。如果改动超过几百行，大概率可以拆成几个递进的 PR。
- 文件放对位置 — 新功能相关的脚本请放在对应的模块目录下，尽量不要往
scripts/这类顶层目录堆大量不相关文件。
如果你不确定怎么组织，开个 Issue 问问就好，我们会尽快回复。
| 内容 | 链接 |
|---|---|
| 项目主页（GitHub Pages） | rachelforster.github.io/Shinsekai |
| 图形界面使用指南（新手） | docs/GUI_USER_GUIDE_zh-CN.md |
| 英文说明 | docs/README_EN.md |
| 插件开发者指南 | docs/PLUGIN_DEVELOPER_GUIDE.md |
| 本仓库 | github.com/RachelForster/Shinsekai |
欢迎参与，请先阅读 CONTRIBUTING.md。若二次分发角色与语音资源，请遵守对应作者许可。