接入 DeepSeek,在群聊中体验视觉小说般的galgame恋爱养成!(多重人格/共享记忆/自动扣图)

koishi-plugin-galgame :video_game:

让你的机器人变身 Galgame 女主,在群聊中开启一场视觉小说般的邂逅。

GitHub

:tada: 简介

这是一个致力于在 Koishi 中还原 Galgame(美少女游戏)体验 的插件。
它不仅仅是一个对话插件,更是一个拥有视觉反馈好感度系统多重人格的养成系统。

接入了 DeepSeek 强大的 AI 能力,让角色的回复充满灵魂,不再是冷冰冰的复读机。

:star2: 核心特性

  • :performing_arts: 四重人格切换
    • 内置 奈奈(萝莉)、蕾娜(御姐)、小百合(少妇)、小薰(男娘) 四套预设。
    • 每个人格拥有独立的 UI 配色、语气风格和好感度系统。
  • :framed_picture: 智能视觉系统
    • 自动扣图:你只需要找白底或透明底的立绘,插件会自动处理背景,让人物完美融入对话框。
    • 情绪感知:AI 会自动分析回复的情绪(开心/生气/悲伤/思考),并调用对应的立绘。
    • 双向好感条:直观的 UI 反馈,红色代表厌恶,粉色代表喜爱,中间向两边扩散。
  • :earth_asia: 共享世界线 (Shared Memory)
    • 所有人共享同一个 AI 的记忆。你在群里说的话,AI 会记得,并可能在和别人的对话中提起你!
    • 虽然记忆共享,但好感度独立。她可能深爱你,但对另一个群友爱答不理。
  • :brain: 深度沉浸
    • 支持 AI 心理活动展示 ([心理: ...]),让你听到她没说出口的真实想法。

:package: 如何使用

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 号列表,用于使用管理指令。

:video_game: 指令一览

基础交互

  • 直接对话
    • 私聊:直接发送消息。
    • 群聊:@机器人 + 消息。
  • 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:重置世界线(清空所有角色的全局记忆)。

:bulb: 常见问题

Q: 为什么图片显示是方框?
A: 请检查你的服务器/电脑是否安装了中文字体(如微软雅黑、黑体)。Linux 系统可能需要安装中文字体包或将字体文件放入项目根目录。

Q: 好感度条为什么变红了?
A: 当好感度为负数(讨厌)时,进度条会显示为红色并向左填充。


如果有 bug 或建议,欢迎在 GitHub 提交 Issue 或在评论区反馈~

2 个赞

建议用koishi的已有的服务API吧~~~

1 个赞

更新了

2 个赞

仓库commit还是没更新,八嘎

1 个赞

考四级,所以没推送

2 个赞