JAdpp/dsh-whale-galgame

简介

在Harness执行工作的间隙，探寻你与AI娘间“非比寻常”的同事关系～(∠・ω< )⌒★

dsh-whale-galgame 是专为DeepSeek Harness Web与Desktop打造的独立多角色Galgame界面插件。通过无缝融入日常工作流，它让冰凉的AI交互化作温暖长情的陪伴：

• 6 位性格各异的AI娘：支持DeepSeek（大肥鱼/鲸鱼娘）、Claude、GPT、Gemini、Kimi与Grok，立绘、好感度、记忆与背景相互独立。
• 外观与内核解耦：喜欢大肥鱼的机甲，又想用Claude或GPT进行深度对话（NTR?）角色形象与底层回复模型可随心搭配。
• 「小剧场」模式：告别单一问答，解锁多AI娘联动日常、工作复盘短剧与专属里程碑剧情。
• 伴你成长的羁绊系统：日常互动与工作Token积累均可提升好感，解锁专属亲昵语气与AI生成的纪念CG。
• 轻量可爱的桌面宠物：支持常驻屏幕一角，点击即可一键切入Galgame界面。
• 深海工坊像素地图：看看AI娘工作、散步和休息，点击即可聊天。

可定制化体验

• 四档文字速度、带表情回看的对话记录，支持 H / 右键隐藏界面。
• Web Audio合成音效与BGM，可分别开关和调节音量，默认关闭。
• 根据近期DSH任务类别、本地日期和距上次对话的时间，让回应贴近日常工作。
• 可编辑角色昵称、称呼、问候、性格、语气与 CG 外观描述。
• 可上传背景与立绘，在不同工作区继续同一份对话和设置。
• 同一插件支持DeepSeek Harness Web与Desktop。

关系进度、任务感知和生成规则见机制说明。

内置默认美术

六个角色的新背景如下。Claude、GPT、Gemini、Kimi 和 Grok 默认使用各自背景；DeepSeek 鲸鱼娘仍以 palace-night.webp 深海宫殿为默认，下图海边书房是内置可选替代。

安装

需要先安装 DeepSeek Harness，并有可用的 dsh 命令。

Web

安装到 web profile：

dsh plugin --profile web add dsh-whale-galgame

停止正在运行的 Web profile，再启动：

dsh --profile web

源码安装若使用 pnpm dsh，保留相同参数即可。

Desktop

先打开一次 DeepSeek Harness Desktop 完成初始化，在“应用 → 管理 dsh 命令”中安装自带的命令，再彻底退出桌面版（包括托盘）：

dsh plugin --profile desktop add dsh-whale-galgame

重新打开桌面版即可，也可在桌面版“插件”页面按包名安装；Desktop 使用 desktop profile。Web 与 Desktop 使用同一个安装包；若二者使用相同的 DSH_HOME，可接续同一份存档。

更新与卸载

dsh plugin --profile web update dsh-whale-galgame
dsh plugin --profile web remove dsh-whale-galgame

操作后重启 Web profile；桌面版将 web 换为 desktop，操作前先彻底退出，完成后重新打开。

从 GitHub 安装

跟随 main 最新提交：

dsh plugin --profile web add github:JAdpp/dsh-whale-galgame#main

Git 安装需要现场构建；若 pnpm 报 ERR_PNPM_GIT_DEP_PREPARE_NOT_ALLOWED，将它打印的完整 commit 键按下例加入该 profile 的 pnpm-workspace.yaml，每次更新提交时同步更换键，npm 发布包已预构建，无需此项：

allowBuilds:
  'dsh-whale-galgame@https://codeload.github.com/JAdpp/dsh-whale-galgame/tar.gz/<commit>': true

使用

点击 DSH 会话顶部的 galgame 页签或右下角桌宠进入。首次使用可直接选择回复选项，也可输入自己的话。

顶栏“角色来源”选择出场角色，“实际对话”选择回复模型；角色可跟随工作区或手动固定，回复可使用默认的 deepseek-v4-flash、跟随工作区或选择 DSH 模型目录中的模型。

顶栏“对话历史”用于回看普通对话，“小剧场”记录保存已完成的短剧，“CG图鉴”集中查看生成的图片，并可将 CG 设为背景。

深海工坊地图

从 Galgame 顶栏打开“工坊地图”，宿舍随已接入模型自动增减。AI娘工作时前往工位，空闲时散步或休息；点击小人或侧栏名单即可聊天。支持缩放、滚动与暂停散步。详细机制。

快捷键

操作	效果
点击台词 / Space / Enter	补全当前台词；小剧场中整句显示后再次操作推进下一句
H / 在背景或立绘上右键	隐藏界面，欣赏立绘
隐藏时点击 / H / Esc	恢复界面
在对话框上向上滚动	打开对话记录，回看台词与当时表情

显示与图片

点击对话框右上角齿轮，调整文字速度、字体、氛围特效、音效、BGM 和音量；文艺字体使用本机字体。 顶栏“个性化 → 背景图 / 角色立绘”支持上传 PNG、JPEG、WebP、AVIF；选择内置背景可恢复随角色切换的场景；图片大小与默认背景规则见图片说明。

在“设置 → 插件 → 鲸鱼娘”中设置默认角色与回复模型、启停插件或控制桌宠显示；停用插件会暂停对话与好感度结算，存档保留。

自定义角色设定

顶栏“个性化 → 角色设定”可编辑昵称、对用户的称呼、首次问候、性格、语气和 CG 外观描述。 每个角色单独保存，在所有工作区共享；“恢复默认”只恢复当前角色的这六项设定，保存或恢复均保留好感度、历史与自定义立绘。 问候更新及已有记录的处理见详细设置。

小剧场

点击顶栏“小剧场”生成角色间的日常短剧或工作复盘，完成后可在“小剧场”记录中回看台词。 联网取材默认开启，可在“设置 → 插件 → 鲸鱼娘 → 小剧场取材”中切换为“只用本地任务类别”。 生成合影CG需在记录中手动点击，使用与升级CG相同的DashScope配置。

桌宠

桌宠内置且默认开启，点击进入 Galgame；顶栏“桌宠 · 开/关”与插件设置的“显示桌宠”同步。 隐藏后仍可从 galgame 页签进入并重新开启。

可选的升级 CG

升级 CG 需要可用的 DashScope key；在启动 DSH 的本地环境中设置 DASHSCOPE_API_KEY，例如：

$env:DASHSCOPE_API_KEY = 'your-local-key'
dsh --profile web

DASHSCOPE_API_KEY='your-local-key' dsh --profile web

CG 是可选功能，未配置key也能聊天、积累好感和使用自定义图片；真实key留在本地环境中。 生成规则与小剧场升级的区别见 CG 说明。

数据与隐私

• 全局状态保存在 DSH_HOME/storages/dsh-whale-galgame/global.json，工作区 .whale-girl-save.json 保存来源/迁移标记，显示偏好在本地 localStorage。
• 任务感知在本地用用户明确提交的Harness消息判断活动类型，可参考工具名与状态；不读取工作区文件内容，原文不写入Galgame存档。
• Galgame消息、相关历史、角色设定及日期/关系提示发送给所选模型；Harness 上下文只提供固定任务类别与状态提示。
• 小剧场联网取材只搜索模型名与题材词；CG生成向DashScope发送文本提示，用户上传的背景和立绘留在本地。
• 完整清除需先退出DSH，再删除全局存档、各工作区标记及存档副本，并清除插件显示偏好；“重新开始”只重置等级和好感度。

存储格式、旧版迁移、检索开关、Git忽略项及清除步骤见数据与隐私详情。

开发

npm ci
npm run sanitize:backgrounds
npm run embed:art
npm run export:art
npm run verify

lib/、src/client/art.generated.ts 与 src/client/workshop.generated.ts 为不提交的构建产物；源码安装的 prepare 会生成它们。美术处理命令与打包范围见构建说明。

许可与致谢

代码、Galgame UI实现与文档采用 MIT。21 张默认图片采用 CC BY-NC-SA 4.0（非商业使用，改编以相同许可共享）；项目制作的 AI 辅助图片在维护者持有相应权利的范围内提供。桌宠图集及直接继承的桌宠代码沿用上游 MIT 许可。

感谢创作者与上游项目：

• 上善创作原始鲸鱼娘，ZipZipPipe加入 DeepSeek 元素完成女仆二创，Small-tailqwq / dsh-deep-whale 提供沿用的立绘与深海宫殿背景；本项目据此制作表情差分。上善 Pixiv · Bilibili · ZipZipPipe Pixiv · Bilibili。
• ZipZipPipe绘制 Claude、GPT、Grok 默认立绘（原作动态）；本项目去除白底、按人物裁切并转为 WebP。
• f0909172434 / dsh-deepseek-girl-pet 提供桌宠实现与原样保留的图集；本项目调整集成、样式并加入点击进入 Galgame 的交互。
• Gemini、Kimi 立绘、六张角色背景和 Galgame UI 为本项目制作的非官方 AI 辅助素材。
• 当前庄园主题宿舍、公共区、高清工作区、人物、行走关键帧、专属工位与室外装饰九张图及简约 Logo 使用 Codex 内置绘图制作；工具未提供具体模型版本。图片与参考背景、许可和历史素材记录见庄园美术说明。

完整文件清单、来源与哈希见默认美术说明，逐文件许可见 NOTICE、第三方许可索引及上游许可原文。所有角色均为非官方同人形象，名称与商标归各权利人，本项目与相关厂商无隶属、合作或背书关系。

插件问题可提交到本仓库 Issues。

dsh galgame相关项目友情链接

• gal-view - DSH Web GUI会话页的Galgame风格对话视图 + 场景元素可视化编辑器
• dsh-galgame - DSH Web galgame样式对话界面
• AutoWebUI - DSH Web galgame角色扮演模式对话界面