# matrixTik

**Repository Path**: stonelin/matrix-tik

## Basic Information

- **Project Name**: matrixTik
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-04-18
- **Last Updated**: 2025-06-14

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# MatrixTK - TikTok Automation Bot

基于iMouse API的TikTok自动化机器人，支持养号、用户互动、私信管理和视频发布等功能。

## 项目结构

```
matrixTK/
├── config/                 # 配置文件目录
│   ├── mysql_config.py    # MySQL配置
│   └── redis_config.py    # Redis配置
├── core/                  # 核心功能目录
│   ├── base/             # 基础功能模块
│   │   ├── __init__.py
│   │   ├── device.py     # 设备控制基类
│   │   └── utils.py      # 通用工具
│   ├── account/          # 养号功能模块
│   │   ├── __init__.py
│   │   ├── video_view.py # 刷视频
│   │   ├── like.py       # 点赞
│   │   └── comment.py    # 评论
│   ├── follow/           # 关注功能模块
│   │   ├── __init__.py
│   │   ├── search.py     # 用户搜索
│   │   └── follow.py     # 关注操作
│   ├── message/          # 私信功能模块
│   │   ├── __init__.py
│   │   ├── inbox.py      # 收件箱
│   │   └── reply.py      # 消息回复
│   └── video/            # 视频功能模块
│       ├── __init__.py
│       ├── upload.py     # 视频上传
│       └── edit.py       # 视频编辑
├── data/                  # 数据存储目录
│   ├── users/            # 用户数据
│   ├── videos/           # 视频数据
│   └── messages/         # 消息数据
├── docs/                  # 文档目录
├── imouse/               # iMouse API相关代码
│   ├── api.py            # API接口
│   └── device.py         # 设备控制
├── logs/                 # 日志目录
├── scripts/              # 脚本目录
├── templates/            # 模板目录
├── tests/                # 测试目录
├── utils/                # 工具类目录
│   ├── logger.py         # 日志工具
│   ├── mysql_pool.py     # MySQL连接池
│   ├── redis_pool.py     # Redis连接池
│   └── common/           # 通用工具
├── main.py               # 主程序入口
├── README.md             # 项目说明
└── requirements.txt      # 依赖包列表
```

## 功能特点

### 1. 养号功能
- 自动刷视频
- 视频点赞
- 视频评论
- 评论点赞
- 智能间隔控制
- 行为模式随机化

### 2. 关注功能
- 用户搜索
- 批量关注
- 关注列表管理
- 关注频率控制
- 黑名单过滤

### 3. 私信功能
- 消息接收
- 自动回复
- 消息模板
- 回复策略
- 消息过滤

### 4. 视频功能
- 视频上传
- 视频编辑
- 标题优化
- 标签管理
- 发布时间控制

### 5. 通用功能
- 设备管理
- 账号管理
- 数据统计
- 异常处理
- 日志记录

## 环境要求

- Python 3.8+
- MySQL 5.7+
- Redis 6.0+
- iMouse设备

## 安装步骤

1. 克隆项目
```bash
git clone https://github.com/yourusername/matrixTK.git
cd matrixTK
```

2. 创建虚拟环境
```bash
python -m venv tkvenv
source tkvenv/bin/activate  # Linux/Mac
tkvenv\Scripts\activate     # Windows
```

3. 安装依赖
```bash
pip install -r requirements.txt
```

## 配置说明

项目使用配置文件管理，主要配置文件在 `config` 目录下：

1. MySQL配置 (`config/mysql_config.py`):
```python
MYSQL_CONFIG = {
    'host': '82.29.72.204',
    'port': 3306,
    'user': 'aidex',
    'password': '7rWnPrAwf8LB5t6x',
    'database': 'aidex',
    # ... 其他配置
}
```

2. Redis配置 (`config/redis_config.py`):
```python
REDIS_CONFIG = {
    'host': '82.29.72.204',
    'port': 6379,
    'db': 5,
    'password': 'aidex',
    # ... 其他配置
}
```

## 使用方法

1. 启动服务
```bash
python main.py
```

2. 配置iMouse设备
- 确保iMouse设备已连接
- 在配置文件中设置正确的设备参数

3. 功能使用示例
```python
from core.account.video_view import VideoView
from core.follow.search import UserSearch
from core.message.reply import MessageReply
from core.video.upload import VideoUpload

# 养号功能
video_view = VideoView()
video_view.watch_video()  # 刷视频
video_view.like_video()   # 点赞
video_view.comment()      # 评论

# 关注功能
user_search = UserSearch()
users = user_search.search("keyword")
user_search.follow(users[0])

# 私信功能
message_reply = MessageReply()
messages = message_reply.get_unread()
message_reply.reply(messages[0], "自动回复内容")

# 视频功能
video_upload = VideoUpload()
video_upload.upload("video.mp4", "标题", ["标签1", "标签2"])
```

## 数据库操作

项目使用连接池管理数据库连接：

1. MySQL操作示例：
```python
from utils.mysql_pool import mysql_pool

# 查询数据
result = mysql_pool.fetch_one("SELECT * FROM users WHERE id = %s", (1,))

# 插入数据
data = {'username': 'test', 'password': '123456'}
user_id = mysql_pool.insert('users', data)

# 更新数据
mysql_pool.update('users', {'status': 1}, 'id = %s', (user_id,))
```

2. Redis操作示例：
```python
from utils.redis_pool import redis_pool

# 设置键值
redis_pool.set('user:1:name', 'John', ex=3600)

# 获取值
name = redis_pool.get('user:1:name')

# 哈希表操作
redis_pool.hset('user:1', 'age', '25')
user_data = redis_pool.hgetall('user:1')
```

## 日志系统

项目使用 loguru 进行日志记录，日志文件存储在 `logs/` 目录：
- `app.log`: 应用日志
- `error.log`: 错误日志
- `access.log`: 访问日志

## 测试

运行测试：
```bash
python -m pytest tests/
```

## 贡献指南

1. Fork 项目
2. 创建特性分支
3. 提交更改
4. 推送到分支
5. 创建 Pull Request

## 许可证

MIT License

## 联系方式

- 项目维护者：[Your Name]
- 邮箱：[your.email@example.com]
- 项目地址：[https://github.com/yourusername/matrixTK]