ChatWaifu_Mobile

⚠ 该项目 README 未提供完整安装说明，以下步骤为通用流程，请以官方文档为准。

环境要求

• Android 手机（用于安装运行 APK）
• OpenAI API Key（ChatGPT 对话必需）
• 可选：百度翻译 appid 与 key（用于翻译功能）
• 可选：已转换为 ncnn 格式的 VITS 模型与官方标准格式的 Live2D 模型

安装与启动步骤

1. 1获取项目源码

   README 未提供安装命令，此处按项目仓库地址克隆源码，然后用 Android 开发工具打开工程编译出 APK 并安装到手机。

   git clone https://github.com/Voine/ChatWaifu_Mobile.git

   复制

2. 2安装并启动应用

   README 没有给出编译与安装步骤，请按仓库说明自行构建 APK 后安装到 Android 手机并打开应用。

3. 3填写 ChatGPT Key

   在登录页面的 Chat Key 输入框中填入 OpenAI API Key，应用会在本地缓存该 Key，之后即可对话。

4. 4配置百度翻译(可选)

   如需要翻译功能，在设置页面填写百度翻译的 appid 和 key；不需要则直接在设置页面关闭翻译功能。

5. 5替换 VITS 语音模型

   先将模型转成 ncnn 版本（会生成 config.json 和多个 bin 文件），再把整个模型文件夹放进手机 chatwaifu/vits/ 目录下。

6. 6替换 Live2D 模型

   支持官方标准的 Live2D 格式模型，README 中该部分内容被截断，具体放置路径请参考项目仓库后续说明。

关键配置

如何确认成功

在登录页填入 Chat Key 后开始聊天，角色能回复并自动播放本地 VITS 语音即表示运行成功。

常见问题

注意事项

• README 未提供完整的编译与安装命令，构建方式需以项目仓库最新说明为准。
• 项目内置三套角色模型（优香、牧濑红莉栖 Amadeus、亚托莉），可自行替换。
• 嘴形同步目前实际只是播放循环动画，存在时长同步/映射问题。
• 项目处于成长阶段，模型与功能可能随版本变化。