Skip to content

Repository files navigation

托利亚QQ聊天机器人

一个以游戏角色亚托莉为原型的QQ聊天机器人,使用NapCatQQ作为QQ机器人框架,阿里千练(通义千问)作为AI模型服务。

项目简介

托利亚是一个温柔、自然、有感情的QQ聊天机器人,能够理解用户的情感需求,并以亚托莉的性格特点进行回应,为用户提供真实的陪伴体验。

功能特性

  • 🤖 自然对话:基于大语言模型,生成自然流畅的对话
  • 💝 情感陪伴:理解用户情感,提供温柔贴心的回应
  • 🎭 角色一致性:保持亚托莉的角色人设和说话风格
  • 💬 多场景支持:支持私聊和群聊
  • 📝 对话记忆:保存对话历史,支持多轮对话

技术栈

  • QQ机器人框架:NapCatQQ
  • AI模型服务:阿里云通义千问(千练)
  • 开发语言:Node.js
  • 数据库:SQLite
  • 日志系统:Winston

项目结构

托利亚项目/
├── config/              # 配置文件
├── src/
│   ├── bot/            # 机器人核心
│   ├── ai/             # AI模型集成
│   ├── character/      # 角色人设
│   ├── database/       # 数据库
│   └── utils/          # 工具函数
├── data/               # 数据目录
├── logs/               # 日志目录
└── package.json

安装步骤

1. 克隆项目

git clone <项目地址>
cd 亚托利

2. 安装依赖

npm install

3. 配置环境变量

复制 .env.example.env 并填写配置:

cp .env.example .env

编辑 .env 文件:

# NapCatQQ配置
NAPCAT_WS_URL=ws://localhost:3000

# 阿里千练配置(DashScope)
# 获取API Key:访问 https://dashscope.console.aliyun.com/api-key_management
QWEN_API_KEY=你的API_KEY
QWEN_MODEL=qwen-turbo

# 数据库配置
DB_TYPE=sqlite
DB_PATH=./data/database.db

# 其他配置
LOG_LEVEL=info
MAX_CONVERSATION_HISTORY=20

4. 配置NapCatQQ

  1. 下载并启动NapCatQQ服务
  2. 配置NapCatQQ的WebSocket地址
  3. 确保NapCatQQ正常运行

5. 获取阿里云API密钥

  1. 注册阿里云账号
  2. 开通通义千问服务
  3. 获取API Key和Secret
  4. 将密钥填入 .env 文件

使用方法

启动机器人

npm start

开发模式(自动重启)

npm run dev

配置说明

机器人配置

config/config.js 中可以配置:

  • 机器人名称和触发关键词
  • 是否启用群聊/私聊
  • AI模型参数(temperature、maxTokens等)
  • 对话历史长度限制

角色人设

src/character/character.js 中可以调整:

  • 角色性格特点
  • 说话风格
  • 系统提示词
  • 降级回复模板

开发说明

添加新功能

  1. 在对应的模块中添加功能代码
  2. 更新配置文件(如需要)
  3. 添加日志记录
  4. 测试功能

调试

日志文件保存在 logs/ 目录:

  • combined.log - 所有日志
  • error.log - 错误日志

注意事项

  1. NapCatQQ配置:确保NapCatQQ服务正常运行,WebSocket地址正确
  2. API密钥:妥善保管API密钥,不要泄露
  3. 成本控制:注意API调用量,避免产生过多费用
  4. 合规使用:遵守QQ平台使用规范

常见问题

Q: 机器人无法连接NapCatQQ?

A: 检查NapCatQQ服务是否启动,WebSocket地址是否正确。

Q: AI回复失败?

A: 检查API密钥是否正确,网络是否正常,查看日志文件获取详细错误信息。

Q: 如何修改角色人设?

A: 编辑 src/character/character.js 中的角色设定和系统提示词。

许可证

MIT License

贡献

欢迎提交Issue和Pull Request!


托利亚 - 温柔陪伴你的AI助手 💝

About

一个以游戏角色亚托莉为原型的QQ聊天机器人,使用NapCatQQ作为QQ机器人框架,阿里千练(通义千问)作为AI模型服务。

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages