🐈✨ LingChat - 灵动的人工智能聊天陪伴助手

🖥️ 支持操作系统：

• Windows、Linux/Macos 均可运行。Linux/Macos 用户请查看额外的使用说明。
• 社区安装 QQ 互助群：1055935861【纯安装问题请加入此群，不要去开发者群.jpg，目前好像只能二维码进入了】
• 安装问题解答文档用户帮助文档-代码报错, 用户帮助文档-截图报错

🛠 功能列表

• 选择你喜欢的人物，陪伴你聊天度过寂寞的夜晚
• 内嵌存档+永久记忆功能，每一个存档拥有独立的永久记忆，可以体验不同的对话风格
• 使用自训练的 AI 情绪识别模型，自动判定 AI 的每次对话情绪
• 表情，动作，气泡随着 AI 的情绪改变，提供灵活的 AI 聊天体验
• 搭配 Vits 语音服务或对话音效，用真实的耳语调动你的真心
• 支持自定义角色，可以用自己的 oc 或者游戏人物与自己对话
• 清爽的设置菜单，高度自定义的设置选项，可搭配不同背景和音乐聊天
• 支持视觉感受，主动窥屏功能，自动识别用户的状态是工作还是游戏还是挂机
• 程序内自带番茄钟，日程，待办清单功能，并且支持让 ai 根据你的状态提醒
• 支持切换角色服装，摸摸角色等功能！
• 支持为角色编写羁绊剧情，解锁更多剧情，成就！
• 支持导入剧本，进行多角色对话，自定义剧情，场景！
• 兼容32位Windows系统（Windows 7及以上）！ 也兼容老古董CPU尝鲜！

⭐ 快速上手

Step -1: 选择适合的版本

• 如果是Windows10 64位或者更高请使用最新版本0.4.0 Pre！
• 如果是32位机器请用兼容版喵~

Step 0: 开始之前的准备

• 在 DeepSeek 或者其他大模型网站中，申请自己的 API 密钥，并且保证有余额供使用 -> DeepSeek 的官方 API 获取网站

Step 1: 下载软件

• 在release中，找到最新的版本，下载如 LingChat_setup.exe 的文件，下载完成后运行并安装 LingChat。
• 点击桌面快捷方式或安装目录下的 LingChat.exe或者启动器.bat启动程序
• 您也可以使用如 LingChat.x.x.x.7z 的文件解压后使用
• 补充：老机器在issues里面寻找适合自己的版本，下载如LingChat v0.4.0-pre Python3.8 win32.7z的文件，运行方式如上

温馨提示：

解压完成后可能会发生 LingChat.exe 不见了的情况，这多半是由于 Windows Defender 把它当病毒干掉了。需要手动打开Windows 安全中心，选择病毒和威胁防护一栏，允许该威胁。

Step 2: 首次启动配置

• 启动程序后，直接点击开始游戏，点开右上角的菜单，点击【高级设置】，输入自己选用的大模型类型和 API，模型信息等（这些是必填信息）
• 设置完毕后，滑动到最下方，点击保存配置。关闭黑不溜秋的窗口和 LingChat 程序，重新启动程序，就可以使用啦！

  [!IMPORTANT]

  1. 有些用户的电脑启动LingChat.exe之后会无限卡在加载页，请在现代浏览器如谷歌中输入localhost:8765进入程序
  2. 当你关闭程序准备重启初始化时候，务必保证前端和后端都关闭（exe 或者浏览器的网页，还有 cmd 窗口），否则可能出现进去人物消失的情况
  3. 对于支持 P3 色域显示的电脑，如果你感觉进去画面灰蒙蒙的，可以切换正常显示颜色的浏览器输入地址进入
  4. 对于过于老旧、运行缓慢的CPU们，启动时间可能会大幅延长（如使用Intel Atom Z540启动一次的时间为7~9分钟），只能稍微忍忍了TAT

Step 3：语音功能使用（从这里开始的以下步骤属于扩展功能，按需进行）

• 开始游戏后点击右上角的菜单，在【文字】部分下面有语音引擎的下载链接，根据自己电脑的情况下载对应的版本（后缀为.7z的文件）
• 解压，点开..01 启动API服务.bat就可以直接用了！

  1. 经过反映，如果你的电脑是核显或者太久以前的电脑，单个语音可能要一分钟才能生成，而 GPU 可以 1 秒内生成，而且会有大量报错可能，核显用户大可能只能放弃语音功能了（哭哭）

温馨提示：

要是想自定义角色使用这个功能，需要在 game_data/characters/<角色名>/settings.txt 中设定 model_name 的参数为导入的模型的名字

Step 4：视觉模型功能使用

• 从通义千问或者其他拥有视觉感知的大模型网站中，获取 API -> 阿里云的相关视觉模型 API 获取网站
• 点开主页面的日程，点击主动对话，里面可以填写 VD_API_KEY，填写完毕后划到下面点击保存后重启软件即可使用。
• 如果你有更换其他模型的需求，填写不同的base_url和model_name即可
• 阿里云 API 默认赠送额度，不需要充值（不过阿里云好像百万token有使用时间限制）， 而且对于这个项目肯定够用一辈子了 。

温馨提示：

设定完毕后，可以通过在与 AI 对话的对话中，包含 “看桌面” 或者 “看看我的桌面”来触发视觉感知，允许 AI 观察你的屏幕并做出回应 主动对话中，配置视觉模块后，AI 将拥有主动看你在干什么的能力，小心不要玩黄油？(^▽^)

Step 6: 加入最新版的测试

• 我们一直在更新 LingChat，所有更新都会随时推送到develop中，我们也会在issues中发布开发日志。
• 你可以参考源代码使用教程来使用 LingChat 的源代码，并随时获取最新的 develop 开发版更新。
• 开发版是不稳定的版本，如果遇到任何 Bug，欢迎向我们反馈！

🔗 相关 & 致谢链接

• Zcchat: 本项目的灵感来源，可以在这里找到 Vits 模型和人物素材。可以的话也帮他们点个 stars 吧 ❤
• Simple-Vits-API: 该项目实现了基于 VITS 的简单语音合成 API。如果你不是核显建议下载 GPU 版本，速度快。核显就用 CPU。
• Style-Bert-VITS2：该项目实现了 Bert-VITS 的语音合成和训练，你可以用这个进行语音训练和推理，少量数据量就可以达到很棒效果！
• ProgrammingVTuberLogos：LingChat 的标题风格，可爱滴捏，画风参考这个项目~
• Emotion Training: 人工智能模型训练，用于实现 18 种短句情绪识别
• 本项目的实现离不开这些优秀开源作品的先驱者，在这里我们送上由衷的致谢 🌼

🌸 一些小话

• 本项目为了快速开发用了很多 AI 工具，有做的不好的地方欢迎指出！我们欢迎各位开发者或用户提出 issues！
• 感谢一路结识的开发者，都是 香软可爱 又厉害的大佬们~ 如果你有开发意向可以联系我！开发者群号就藏在 GitHub 中 ❤
• 本项目更多作为一个超小型的学习项目，由于文件结构非常简单， 欢迎有兴趣的人学习 。现在变大了，应用了很多软件工程的架构思想，也欢迎学习啦 qwq

🔍 其他

本项目使用的气泡+音效素材+初始界面来源于碧蓝档案，其中对话哔哔音效来源于 Undertale，请勿商用
默认人物立绘作者为我本人，请勿乱用（商用和奇奇怪怪的东东（bushi）） 请对 AI 生成的东西和使用负责，不要肆意传播不良信息 有其他问题可以提 issues 捏~ 关于硬件调查，我们完全秉持自愿原则，您可以在Ling Chat 硬件调查中查看调查数据

⭐️ 星星（觉得好的话务必点一个 Star，这是我们提升影响力和持续做下去的动力！）

© LingChat 制作团队

LingChat 快速上手指南

LingChat 是一款支持多角色互动、永久记忆、情绪识别及视觉感知的 AI 聊天陪伴助手。本指南将帮助你快速在本地部署并运行该工具。

1. 环境准备

系统要求

• 操作系统：
  • Windows 7 及以上（支持 32 位与 64 位）。
  • Linux / macOS（需参考额外说明）。
• 硬件建议：
  • 常规使用：任意现代 CPU 即可。
  • 语音功能（VITS）：推荐配备独立显卡（GPU），核显或老旧 CPU 生成速度极慢且易报错。
  • 视觉功能：无特殊本地硬件要求，依赖云端 API。

前置依赖

• 大模型 API 密钥：
  • 需申请 DeepSeek 或其他兼容大模型的 API Key（确保账户有余额）。
  • 获取地址：DeepSeek 平台
• 视觉模型 API 密钥（可选）：
  • 如需使用“看桌面”等视觉感知功能，需申请阿里云通义千问视觉模型 API。
  • 获取地址：阿里云百炼控制台
• 浏览器：推荐使用 Chrome 或 Edge 等现代浏览器（用于本地访问界面）。

2. 安装步骤

Step 1: 下载软件

访问 Releases 页面 下载适合你系统的版本：

• Windows 10/11 (64 位)：下载 LingChat_setup.exe 或最新版 .exe 安装包。
• 32 位系统或老旧机器：在 Issues #379 中寻找兼容版（如 LingChat v0.4.0-pre Python3.8 win32.7z）。
• 免安装版：下载 .7z 压缩包直接解压使用。

⚠️ 重要提示：解压后若发现 LingChat.exe 消失，可能是被 Windows Defender 误删。请前往 Windows 安全中心 > 病毒和威胁防护，还原文件并添加信任。

Step 2: 启动程序

• 安装版：双击桌面快捷方式或安装目录下的 LingChat.exe。
• 解压版：运行目录下的 启动器.bat 或 LingChat.exe。
• Web 访问模式：若程序启动后卡在加载页，请在浏览器地址栏输入：

  localhost:8765
  

Step 3: 初始化配置

1. 进入程序界面后，点击右上角菜单，选择 【高级设置】。
2. 填写以下必填信息：
   • 大模型类型：选择你使用的模型提供商（如 DeepSeek）。
   • API Key：填入第一步申请的密钥。
   • Model Name：填入具体的模型名称。
3. 滑动至底部点击 保存配置。
4. 完全关闭 程序（包括前端窗口、后端 CMD 窗口），然后重新启动以生效。

3. 基本使用

开始对话

1. 重启程序后，点击 开始游戏。
2. 选择你喜欢的角色卡片，即可开始聊天。
3. 系统会自动加载该角色的独立记忆存档，支持长期上下文关联。

进阶功能启用（可选）

启用语音合成 (TTS)

1. 在程序菜单的 【文字】 板块下方，下载对应的语音引擎包（.7z 文件）。
2. 解压后，双击运行 ..01 启动 API 服务.bat。
3. 返回主程序，语音功能将自动生效。

   注：自定义角色需在 game_data/characters/<角色名>/settings.txt 中设置 model_name 为对应模型名。

启用视觉感知 (Vision)

1. 在主界面点击 日程 -> 主动对话。
2. 填入阿里云视觉模型的 VD_API_KEY。
3. 保存并重启软件。
4. 使用方法：在对话中输入“看桌面”或“看看我的桌面”，AI 将截取屏幕内容进行分析并回应；或配置后让 AI 主动观察你的操作状态。

退出与重启

• 关闭时请务必确认 前端网页/窗口 与 后端 CMD 窗口 均已完全关闭，再次启动时可避免角色数据加载异常。