koishi-plugin-galgame 
让你的机器人变身 Galgame 女主,在群聊中开启一场视觉小说般的邂逅。
简介
这是一个致力于在 Koishi 中还原 Galgame(美少女游戏)体验 的插件。
它不仅仅是一个对话插件,更是一个拥有视觉反馈、好感度系统和多重人格的养成系统。
接入了 DeepSeek 强大的 AI 能力,让角色的回复充满灵魂,不再是冷冰冰的复读机。
核心特性
四重人格切换:
- 内置 奈奈(萝莉)、蕾娜(御姐)、小百合(少妇)、小薰(男娘) 四套预设。
- 每个人格拥有独立的 UI 配色、语气风格和好感度系统。
智能视觉系统:
- 自动扣图:你只需要找白底或透明底的立绘,插件会自动处理背景,让人物完美融入对话框。
- 情绪感知:AI 会自动分析回复的情绪(开心/生气/悲伤/思考),并调用对应的立绘。
- 双向好感条:直观的 UI 反馈,红色代表厌恶,粉色代表喜爱,中间向两边扩散。
共享世界线 (Shared Memory):
- 所有人共享同一个 AI 的记忆。你在群里说的话,AI 会记得,并可能在和别人的对话中提起你!
- 虽然记忆共享,但好感度独立。她可能深爱你,但对另一个群友爱答不理。
深度沉浸:
- 支持 AI 心理活动展示 (
[心理: ...]),让你听到她没说出口的真实想法。
- 支持 AI 心理活动展示 (
如何使用
1. 安装
在 Koishi 插件市场搜索 galgame 并安装,或者使用 npm:
npm install koishi-plugin-galgame
2. 准备素材 (最重要的一步!)
为了让插件显示图片,你需要准备立绘素材。仓库中已包含示例素材,你可以直接使用或替换。
在你的电脑或服务器上创建一个文件夹(例如 C:\galgame-images),结构必须严格如下:
资源根目录/
├── loli/ (对应人格:奈奈)
│ ├── happy.png
│ ├── sad.png
│ ├── angry.png
│ └── think.png
├── gril/ (对应人格:蕾娜)
│ ├── happy.png
│ ├── sad.png
│ ├── angry.png
│ └── think.png
├── woman/ (对应人格:小百合)
│ ├── ...同上
└── mft/ (对应人格:小薰)
└── ...同上
注意:图片建议使用
.png格式,背景可以是透明或纯白(插件会自动处理白底扣图)。
3. 配置
前往 Koishi 控制台 -> 插件配置 -> koishi-plugin-galgame:
- deepseekApiKey: (必填) 你的 DeepSeek API Key。
- characterImageBasePath: (必填) 你的素材根目录路径(例如
C:\galgame-images)。 - admins: (可选) 管理员 QQ 号列表,用于使用管理指令。
指令一览
基础交互
- 直接对话:
- 私聊:直接发送消息。
- 群聊:
@机器人+ 消息。
galgame.switch <角色名>:切换你想攻略的角色。- 示例:
galgame.switch 蕾娜
- 示例:
galgame.fav <开/关>:开启或关闭好感度变化提示。galgame.help:查看使用指南。galgame.mind <开/关>:开启或关闭读心术(显示心理活动)。
管理员指令
galgame.block.user <用户ID>:拉黑指定用户。galgame.unblock.user <用户ID>:解禁指定用户。galgame.block.group <群号>:拉黑指定群组。galgame.unblock.group <群号>:解禁指定群组。galgame.resetworld:重置世界线(清空所有角色的全局记忆)。
常见问题
Q: 为什么图片显示是方框?
A: 请检查你的服务器/电脑是否安装了中文字体(如微软雅黑、黑体)。Linux 系统可能需要安装中文字体包或将字体文件放入项目根目录。
Q: 好感度条为什么变红了?
A: 当好感度为负数(讨厌)时,进度条会显示为红色并向左填充。
如果有 bug 或建议,欢迎在 GitHub 提交 Issue 或在评论区反馈~