# Anya

**Repository Path**: yygfml/Anya

## Basic Information

- **Project Name**: Anya
- **Description**: Anya of Kook Bot By Python
- **Primary Language**: Unknown
- **License**: EPL-1.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 1
- **Created**: 2026-03-31
- **Last Updated**: 2026-03-31

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Anya Bot - Kook智能机器人

![Python Version](https://img.shields.io/badge/python-3.12%2B-blue)
![License](https://img.shields.io/badge/license-MIT-green)

## 项目简介
Anya Bot 是基于Kook平台的智能机器人，集成服务器管理、AI对话、定时任务、用户行为分析等功能。支持通过卡片消息进行丰富的交互体验。

## 主要功能
- 🛠 **系统监控**：实时检测数据库/MCSM服务器状态
- 🚀 **应用管理**：启动/关闭/更新MCSM应用实例
- 🤖 **AI聊天**：集成MoonShot AI的智能对话系统
- ⏰ **定时任务**：自动化运维任务管理
- 📊 **用户系统**：登录/注册/行为记录
- 📈 **数据分析**：用户在线时长统计

## 快速开始

### 环境要求
- Python 3.12+
- SQLite3数据库
- MCSM服务器配置

### 安装依赖
```bash
pip install anya-latest.tar.gz
```

### 配置说明
settings.toml
```angular2html
[Database]
DATA_DIR = "./data"

[KOOKBot]
TOKEN = "your kook bot token"
ADMIN_USER = ["user id"]
LOG_CHANNEL = "channel id"

[MCSManager]
MCSM_URL = ""
MCSM_API_KEY = ""

[MoonShotAPI]
MS_API_KEY = [""]
MS_BASE_URL = "https://api.moonshot.cn/v1"
```

### 命令列表
- 基础命令

| 命令 | 别名 | 描述 | 权限 | 示例 |
|-|-|-|-|----|
| ping | 检查 | 检查系统连接状态 | 所有用户  | 检查 |
| login | 登录 | 用户登录/注册 | 所有用户  | 登录 |
| myinfo |个人 | 查看个人信息 | 已登录用户 | 个人 |
|help| 帮助 | 查看帮助信息 | 所有用户  | 帮助 |
|version| 版本 | 查看版本信息 | 所有用户  | 版本 |
|sysinfo| 系统 | 查看系统信息 | 所有用户  | 系统 |

- 应用管理

|命令	| 别名	 |描述	|权限	| 示例    |
|-|----|-|-|-------|
|app_check	| 应用	 |列出所有应用	|已登录用户	| 应用    |
|app_start	| 启动	 |启动指定应用	|已登录用户| 	启动 1 |
|app_stop	| 关闭	  |更新指定应用	|已登录用户	| 关闭 2  |
|app_update| 更新	 |更新指定应用	|管理员	| 更新 3  |

- AI聊天

| 命令	   | 别名	 | 描述	      |权限	| 示例         |
|-------|----|----------|-|------------|
| @机器人	 | @机器人	 | 与AI聊天	   |已登录用户	| @机器人 你好    |
|talk_reset| 对话重置| 重置AI聊天记录	 |已登录用户	| 对话重置       |
|role_now| 当前角色| 查看当前角色信息	 |已登录用户	| 当前角色       |
|default_role| 默认角色| 设置默认角色	  |已登录用户	| 默认角色       |
|role_set| 角色设定| 设置自定义角色	 |已登录用户	| 角色设定 你是一只猫 |

- 定时任务

| 命令	   | 别名	 | 描述	     |权限	| 示例        |
|-------|----|---------|-|-----------|
|task_list| 定时任务| 查看所有任务	 |已登录用户	| 定时任务      |
|task_start| 启动任务| 启动定时任务	 |已登录用户	| 启动任务 task_name     |
|task_stop| 停止任务| 停止定时任务	 |已登录用户	| 停止任务 task_name    |

### 权限体系

👤 普通用户：基础功能+AI聊天

🛡 管理员（admin）：

系统管理命令

应用更新操作

定时任务控制

### 事件处理

📢 用户加入/离开服务器通知

🎙 语音频道进出记录

📛 昵称修改追踪

⏳ 语音时长统计（精确到分钟）

### 定时任务

每天0点重置登录状态

每小时检查机器人版本更新

每5分钟更新运行状态

### 特别鸣谢

Kook.py SDK支持

MoonShot AI提供语言模型

遇到问题？请提交Issue或联系维护者