穗乃小果

基于 Python、pywebview 和 Windows WebView2 的桌面养成宠物。前端继续使用原生 HTML/CSS/JavaScript，游戏逻辑运行在同一 Python 进程中，不再携带 Electron/Node.js/Chromium。

功能

• 透明置顶桌宠和序列帧动画
• 学园养成、行动、商店、背包、疾病、考试、成就、Live 和心情日记
• OpenAI Chat Completions 兼容接口的角色对话（模型名和接口均可配置）
• 本地存档与旧 Electron 版数据迁移
• 状态、商店、对话和主面板按需创建，关闭即释放
• TTS 语音（Beta，规划中）

本地运行

环境要求：Windows 10/11、Python 3.10 或更高版本、系统 WebView2 Runtime。

python -m pip install -r requirements.txt
python honoka_desktop.py

也可以双击 run_honoka_pet.bat。

生成独立 EXE

powershell -ExecutionPolicy Bypass -File .\build_light.ps1

产物为：

dist\HonokaDeskPet.exe

这是单文件、无控制台窗口的便携 EXE。接收方不需要安装 Python 或 Node.js；Windows 10/11 通常已经包含 WebView2 Runtime。

生成 Windows 安装包

先安装 Inno Setup 6，再执行：

powershell -ExecutionPolicy Bypass -File .\build_installer.ps1

产物为 dist\HonokaDeskPet-Setup-0.2.1.exe。安装范围是当前 Windows 用户，不要求管理员权限，并创建开始菜单入口；桌面快捷方式可在安装时选择。

配置与数据

开发模式下数据写到项目的 save/。打包后的 EXE 将数据写到：

%LOCALAPPDATA%\HonokaDeskPet

包括：

• honoka_school.json：养成存档
• chat_history.json：对话历史
• settings.json：AI 接口设置与 API Key
• webview/：WebView2 缓存

首次运行新版程序时，如果 EXE 同目录存在旧版 settings.json 或 save/，程序会自动迁移。

主面板的“语音与数据”区域会显示实际数据目录，并可直接打开。卸载主程序时不会删除这个目录，存档与 API 设置会保留。

也可以通过环境变量覆盖数据和 AI 配置：

HONOKA_DATA_DIR
HONOKA_SAVE_PATH
HONOKA_AI_API_KEY
HONOKA_AI_MODEL
HONOKA_AI_BASE_URL

项目结构

honoka_desktop.py       pywebview 窗口、JS 桥接和生命周期
honoka_api.py           本地 HTTP API 与 AI 对话
school_system/          养成游戏逻辑
web/                    页面、样式和交互
assets/                 桌宠图片与动画
artwork/                应用图标原稿
installer/              Windows 安装脚本与多尺寸图标
build_light.ps1         一键构建独立 EXE
requirements.txt        运行依赖
requirements-build.txt  构建依赖

TTS 语音（Beta）

穗乃果语音目前属于 Beta 规划功能，尚未在当前安装包中开放。该功能将利用上千条语音数据训练，尽可能还原穗乃果的声线，并在未来版本上线。

当前版本的文字对话和全部养成功能均可正常使用，不依赖 TTS。现阶段仓库中出现的语音下载与服务代码仅用于开发验证，不代表已经交付可用的语音功能；当前 Release 也不会附带语音模型。

技术验证与后续接入计划见 TTS_SETUP.md。

验证

开发版 smoke test：

python honoka_desktop.py --smoke-test

测试会验证本地 API、透明桌宠页面、JS 桥接以及状态/商店的懒加载窗口，并在 %TEMP%\honoka-light-smoke.json 写入结果。