# LingChat

**Repository Path**: cysdSSS/LingChat

## Basic Information

- **Project Name**: LingChat
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: develop
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-07-06
- **Last Updated**: 2025-07-06

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 🐈✨ LingChat - 灵动の人工智能聊天陪伴助手
![official](https://github.com/user-attachments/assets/ffccbe79-87ed-4dbc-8e60-f400efbbab26)


## 🖥️ 支持操作系统：
Windows、Linux均可运行。Linux用户请查看额外的使用说明。

## 🛠 功能列表
- [x] 选择你喜欢的人物，陪伴你聊天度过寂寞的夜晚
- [x] 内嵌永久记忆功能，优化和高自定义的RAG系统记录你们的一点一滴
- [x] 使用自训练的AI情绪识别模型，自动判定AI的每次对话情绪
- [x] 表情，动作，气泡随着AI的情绪改变，提供灵活的AI聊天体验
- [x] 非RAG下有存档功能，用不同的方式攻略Galgame人物吧
- [x] 搭配Vits语音服务或对话音效，用真实的耳语调动你的真心
- [x] 支持自定义角色，可以用自己的oc或者游戏人物与自己对话
- [x] 清爽的设置菜单，高度自定义的设置选项，可搭配不同背景和音乐聊天

## ⭐ 快速上手

### Step 0: 开始之前的准备
- 在DeepSeek或者其他大模型网站中，申请自己的API密钥，并且保证有余额拱使用 -> [DeepSeek的官方API获取网站](https://platform.deepseek.com/)

### Step 1: 下载软件
- 在[release](https://github.com/SlimeBoyOwO/LingChat/releases)中，找到最新的版本，下载如 `LingChat.x.x.x.7z` 的文件，下载完成后解压它。
- 点击 `LingChat.exe` 启动程序

### Step 2: 首次启动配置
- 启动程序后，点开右上角的菜单，点击【文字】部分的【进入设置页面】按钮，输入自己选用的大模型类型和API，模型信息等（**这些是必填信息**）
- 设置完毕后，滑动到最下方，点击保存配置。关闭黑不溜秋的窗口和LingChat程序，重新点击 `LingChat.exe` 启动程序，就可以使用啦！
> [!IMPORTANT]
>
> 1. **有些用户的电脑启动`LingChat.exe`之后会无限卡在加载页，请在现代浏览器如谷歌中中输入`localhost:8765`进入程序**
> 2. **当你关闭程序准备重启初始化时候，务必保证前端和后端都关闭（exe或者浏览器的网页，还有cmd窗口），否则可能出现进去人物消失的情况**

### Step 3：基础语音功能使用（从这里开始的以下步骤属于扩展功能，按需进行）
- 若要使用 `Vits` 语音功能，请下载链接程序[simple-vits-api](https://github.com/Artrajz/vits-simple-api)。
- 该项目实现了基于 `Vits` 的简单语音合成 API。如果你是核显只能下载CPU版本。如果有独显建议下载 GPU 版本，速度快。
- 程序默认监听 23456 语音端口，程序默认导入的模型是 zcchat 地址->讨论区->角色示范（丛雨）-> vits
- 模型下载好之后在 simple-vits-api 的目录的/data/models 里面解压，再启动就 ok 了
- 如果需要使用其他角色声线，请在`game_data/characters/角色名/settings.txt`中修改`speaker_id`这个属性（0~6可选）

### Step 4：视觉模型功能使用
- 从通义千问或者其他拥有视觉感知的大模型网站中，获取API -> [阿里云的相关视觉模型API获取网站](https://bailian.console.aliyun.com/?tab=api#/api)
- 在设置中的 `VD_API_KEY` 和 `VD_MODEL_TYPE` 中输入自己的密钥和模型类型，该API默认赠送额度，不需要充值， *而且对于这个项目肯定够用一辈子了* 。
#### 温馨提示：
> 设定完毕后，可以通过在与AI对话的对话中，包含 `“看桌面”` 或者 `“看看我的桌面”` 来触发视觉感知，允许AI观察你的屏幕并做出回应

### Step 5: 扩展语音功能使用（Style-Bert-Vits2模型使用，更好的音色，可自定义训练）
- 从下方相关链接中，下载Style-Bert-Vits2的 [Release](https://github.com/litagin02/Style-Bert-VITS2/releases) 的 **最新版本** ，解压
- 先决定这个软件（安装后12GB）的安装位置，然后启动里面的`Install-Style-Bert-VITS2.bat`文件（如果之后更改这个软件的位置会有Bug）
- 耐心等待很长时间后，这个软件会安装好。由于这个项目庞大，所以等待时间非常长
- 下载完毕后，在 `model_assests` 目录中，把下载好的Bert-Vits模型解压进去
- 打开程序的目录，里面有个 `server.bat` ，启动它即可使用
#### 温馨提示：
> 要是想使用这个功能，需要在 `game_data/characters/<角色名>/settings.txt` 中设定 `model_name` 的参数为导入的模型的名字   
> 模型的名字可以通过启动`app.bat`中的人物列表中查看

### Step 6: 加入最新版的测试
- 我们一直在更新LingChat，所有更新都会随时推送到[develop](https://github.com/SlimeBoyOwO/LingChat/tree/develop)中，我们也会在[issuse](https://github.com/SlimeBoyOwO/LingChat/issues)中发布开发日志。
- 你可以参考[源代码使用教程](https://github.com/SlimeBoyOwO/LingChat/blob/develop/others/document/%E6%BA%90%E4%BB%A3%E7%A0%81%E4%BD%BF%E7%94%A8.md)来使用LingChat的源代码，并随时获取最新的develop开发版更新。
- 开发版是不稳定的版本，如果遇到任何Bug，欢迎向我们反馈！

## 🔗 相关 & 致谢链接

- [Zcchat](https://github.com/Zao-chen/ZcChat): 本项目的灵感来源，可以在这里找到 `Vits` 模型和人物素材。可以的话也帮他们点个stars吧❤
- [Simple-Vits-API](https://github.com/Artrajz/vits-simple-api): 该项目实现了基于 `VITS` 的简单语音合成 API。如果你不是核显建议下载 GPU 版本，速度快。核显就用CPU。
- [Style-Bert-VITS2](https://github.com/litagin02/Style-Bert-VITS2)：该项目实现了 `Bert-VITS` 的语音合成和训练，你可以用这个进行语音训练和推理，少量数据量就可以达到很棒效果！
- [ProgrammingVTuberLogos](https://github.com/Aikoyori/ProgrammingVTuberLogos)：LingChat 的标题风格，可爱滴捏，画风参考这个项目~
- 本项目的实现离不开这些优秀开源作品的先驱者，在这里我们送上由衷的致谢🌼

## 🌸 一些小话

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

## 🔍 其他

> 本项目使用的气泡+音效素材来源于碧蓝档案，其中对话哔哔音效来源于Undertale，请勿商用  
> 默认简单狼狼立绘是自绘，表情差分源于 AI + 人工修改，如果你想自己创作可使用 Novelai 网站或者自己画
> 请对AI生成的东西和使用负责，不要肆意传播不良信息   
> 有其他问题可以 B 站私信捏~


© LingChat 制作团队