# autojsx

**Repository Path**: star_code/autojsx

## Basic Information

- **Project Name**: autojsx
- **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-11-24
- **Last Updated**: 2025-11-27

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 抖音自动化管理系统

多端协同的抖音自动化管理系统，包含 Android 自动私信、Web 数据抓取、统一后台管理三大模块。

> 📌 **快速参考**: 查看 [PROJECT_SUMMARY.md](PROJECT_SUMMARY.md) 了解项目全貌和当前状态

## 项目结构

```
autoxjs/
├── backend/              # Flask 后台服务（核心）
│   ├── app.py           # Flask 应用主文件
│   ├── database.py      # 数据库操作封装
│   ├── database_schema.sql           # 用户授权相关表
│   ├── database_schema_dy_web.sql    # dy_web 数据表
│   ├── init_database.py # 数据库初始化
│   ├── admin.html       # Vue.js 管理后台
│   └── README.md        # 后台说明文档
│
├── autojs/              # AutoX.js 脚本（Android端）
│   ├── login_interface.js        # 主脚本（账号登录+自动私信）
│   ├── login_interface_debug.js  # 调试版本
│   ├── main.js                   # 入口文件
│   ├── assets/message.txt        # 消息配置
│   ├── project_apk.json          # APK打包配置
│   ├── README.md                 # AutoX.js 使用说明
│   └── ...                       # 其他测试脚本
│
├── dy_web/              # PyQt5 桌面端（数据抓取）
│   ├── app/             # 主应用代码
│   │   ├── main_window.py        # 主窗口
│   │   ├── sections/             # 功能模块
│   │   └── utils/                # 工具函数
│   ├── main.py          # 应用入口
│   ├── README.md                 # 桌面端说明
│   ├── README_INTEGRATION.md     # 与 backend 整合说明
│   └── requirements.txt          # Python 依赖
│
├── docs/                # 文档目录
│   ├── 快速开始.md
│   ├── APK打包指南.md
│   ├── 账号授权系统使用说明.md
│   ├── 用户查找修复说明.md
│   ├── 项目重组说明.md
│   └── ...              # 其他技术文档
│
├── .github/             # GitHub配置
│   └── workflows/
│       └── build-apk.yml  # APK自动打包
│
├── PROJECT_SUMMARY.md  # 项目总结（重要！下次开发必读）
└── README.md           # 本文件
```

## 功能特性

### 后台管理系统（Backend）
- 🔐 统一账号授权管理
- 👥 用户账号管理
- 📱 设备授权控制（每用户可设置设备数上限）
- 📊 登录日志统计
- 🎨 Vue.js + Element UI 现代化界面
- 🔑 JWT Token 身份验证
- 📂 管理员与系统用户分离
- 💾 SQLite 数据库（支持多端数据共享）

### AutoX.js 脚本（Android端）
- 📱 账号登录验证
- 💬 批量自动发送私信
- ⏸️ 实时状态监控
- 🛑 一键停止功能
- 📊 用户授权信息显示
- 🎯 智能用户查找（大卡片识别算法）
- 🔍 多层降级策略（成功率95%+）

### dy_web 桌面端（数据抓取）
- 🌐 抖音视频信息抓取
- 💬 视频评论数据采集
- 👥 用户粉丝列表获取
- 🔍 关键字搜索和筛选
- 📤 数据导出（Excel/CSV）
- 📊 历史记录管理
- 🔐 与 backend 统一认证

## 快速开始

### 1. 后台服务部署

```bash
# 进入后台目录
cd backend

# 安装依赖
pip install flask flask-cors pyjwt

# 初始化数据库
python init_database.py

# 启动服务
python app.py
```

后台服务默认运行在 `http://localhost:5000`

**默认管理员账号**：
- 用户名：`admin`
- 密码：`admin123`

访问管理后台：`http://localhost:5000/admin.html`

### 2. AutoX.js 脚本使用（Android端）

1. 修改 `autojs/login_interface.js` 中的 API_BASE_URL：
```javascript
var API_BASE_URL = "http://192.168.0.14:5000/api";  // 改成你的后台IP
```

2. 将 `autojs` 文件夹导入到 AutoX.js 应用

3. 配置消息文件 `autojs/assets/message.txt`：
```
用户ID1||消息内容1&&用户ID2||消息内容2
```

4. 运行 `login_interface.js`

5. 使用后台创建的账号登录

### 3. dy_web 桌面端使用（数据抓取）

```bash
cd dy_web
pip install -r requirements.txt
python main.py
```

详细整合说明请查看 [dy_web/README_INTEGRATION.md](dy_web/README_INTEGRATION.md)

## 多端架构设计

采用多端分离架构，所有端统一使用 backend 提供的 RESTful API：

```
├── backend/        # 后台服务（✅ 已完成）
├── autojs/         # Android 端（✅ 已完成）
├── dy_web/         # 桌面端（✅ 已完成，整合中）
├── ios/           # iOS 端（预留）
└── web/           # Web 端（预留）
```

**数据流向**：
```
dy_web (数据抓取) → backend (统一存储) ← autojs (数据使用)
```

每个端可以独立开发和部署，数据在 backend 实现共享。

## 系统架构

### 后台架构（Backend）
- **框架**：Flask
- **数据库**：SQLite
- **认证**：JWT Token（30天有效期）
- **前端**：Vue.js 2.6 + Element UI 2.15

### 数据库表结构
1. `admins` - 后台管理员
2. `users` - 系统授权用户
3. `device_authorizations` - 设备授权记录
4. `usage_statistics` - 使用统计
5. `login_logs` - 用户登录日志
6. `admin_login_logs` - 管理员登录日志

### AutoX.js 端
- **框架**：AutoX.js 4.1.1+
- **UI**：Material Design
- **网络**：http 模块
- **存储**：LocalStorage

## 配置说明

### 后台配置
修改 `backend/app.py`：
```python
JWT_SECRET_KEY = 'your-secret-key-here'  # JWT密钥
JWT_EXPIRATION_DAYS = 30  # Token有效期
```

### AutoX.js 配置
修改 `autojs/login_interface.js`：
```javascript
var API_BASE_URL = "http://YOUR_IP:5000/api";  # 后台API地址
```

## API 文档

### 用户端 API
- `POST /api/login` - 用户登录
- `GET /api/user/info` - 获取用户信息
- `GET /api/user/devices` - 获取设备授权列表
- `POST /api/device/authorize` - 设备授权
- `POST /api/usage/record` - 记录使用统计

### 管理端 API
- `POST /api/admin/login` - 管理员登录
- `GET /api/admin/users` - 用户列表
- `POST /api/admin/users` - 创建用户
- `PUT /api/admin/users/:id` - 更新用户
- `DELETE /api/admin/users/:id` - 删除用户
- `GET /api/admin/logs` - 登录日志
- `GET /api/admin/statistics` - 统计数据

详细 API 文档请查看 `docs/账号授权系统使用说明.md`

## APK 打包

### 方法1：AutoX.js 应用内打包（推荐）
1. 打开 AutoX.js 应用
2. 导入 `autojs` 文件夹
3. 打开 `login_interface.js`
4. 右上角菜单 → 打包 → 打包为APK
5. 设置应用信息并打包

详细步骤请查看 `docs/APK打包指南.md`

### 方法2：GitHub Actions 自动打包
1. 推送代码到 GitHub
2. 进入 Actions 页面
3. 运行 "Build AutoX.js APK" 工作流
4. 下载生成的 APK

## 权限要求

### Android 端
- 无障碍服务权限（Accessibility Service）
- 悬浮窗权限（Draw Over Apps）
- 存储权限（Storage）
- 网络权限（Internet）

### 系统要求
- Android 6.0+
- AutoX.js 4.1.1+
- 抖音应用已安装

## 技术亮点

### 1. 用户查找多层降级
实现了6层用户查找策略，兼容不同抖音版本：
- LynxFlattenUI 大卡片查找（宽度>800且高度>150）
- 自动过滤小文本标签
- 点击验证机制

### 2. 管理员与用户分离
- 后台管理员独立表存储
- JWT Token 带 `is_admin` 标识
- 分离的登录日志和权限控制

### 3. Vue.js 现代化后台
- 响应式数据绑定
- Element UI 组件库
- LocalStorage Token 持久化

## 开发文档

### 🌟 重要文档（下次开发必读）
- **[PROJECT_SUMMARY.md](PROJECT_SUMMARY.md)** - 项目总结和快速参考（包含当前状态、技术栈、API、下次开发建议）

### 快速上手
- [快速开始](docs/快速开始.md)
- [账号授权系统使用说明](docs/账号授权系统使用说明.md)

### 模块文档
- [backend/README.md](backend/README.md) - 后台服务文档
- [autojs/README.md](autojs/README.md) - AutoX.js 端文档
- [dy_web/README.md](dy_web/README.md) - 桌面端文档
- [dy_web/README_INTEGRATION.md](dy_web/README_INTEGRATION.md) - dy_web 与 backend 整合说明

### 技术文档
- [UI设计说明](docs/UI设计说明.md)
- [用户查找修复说明](docs/用户查找修复说明.md)
- [APK打包指南](docs/APK打包指南.md)
- [项目重组说明](docs/项目重组说明.md)
- [系统开发完成总结](docs/系统开发完成总结.md)

## 更新日志

### v2.2.0 (2025-11-18) - dy_web 整合
- ✨ 新增 dy_web 桌面端模块（PyQt5 数据抓取）
- 📁 项目重组为多端架构（backend/autojs/dy_web）
- 📝 创建 PROJECT_SUMMARY.md 项目总结文档
- 🔗 规划 dy_web 与 backend 的 API 整合方案
- 💾 新增 dy_web 数据表结构（视频/评论/粉丝）
- 📚 完善文档体系（整合说明、项目重组说明）

### v2.1.0 (2025-11-11)
- ✨ 优化用户查找逻辑，只查找大卡片
- 🐛 修复点击小文本无法进入用户主页的问题
- 📝 完善日志输出

### v2.0.0 (2025-11-07)
- ✨ 账号授权系统替代卡密系统
- ✨ Vue.js + Element UI 管理后台
- ✨ 用户设备授权管理
- 🎨 全新 UI 设计
- 📊 使用统计和日志记录

### v1.0.0
- 🎉 初始版本
- 📱 基础自动化功能
- 🔐 卡密验证系统

## 技术支持

- **GitHub Issues**：提交问题和建议
- **AutoX.js 社区**：https://autoxjs.com/
- **开发者文档**：https://doc.autoxjs.com/

## 免责声明

本工具仅供学习和研究使用，请勿用于商业用途或违反平台规则的行为。使用本工具产生的任何后果由用户自行承担。请遵守抖音平台使用规范，避免频繁操作导致账号异常。

---

**开发者**: AutoX.js Community
**版本**: v2.1.0
**最后更新**: 2025-11-11