# 微博工具

**Repository Path**: ttzhanshen/weibo-tools

## Basic Information

- **Project Name**: 微博工具
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-07-31
- **Last Updated**: 2026-08-21

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Weibo Tools 

Weibo Tools 是一款专为新浪微博平台设计的全自动化多账号辅助管理工具。系统拥有现代化的前端交互界面与强健的异步任务后台，可满足个人及专业团队在微博超话管理、日常互动、粉丝增长以及好友维系方面的全流程自动化需求。

## ✨ 核心特性 (Features)

* **🔐 官方扫码登录 & 🔄 SSO 无感自动续期**：
  * 支持绑定多个微博账号，官方二维码安全授权，无需输入密码。
  * **长效登录保持**：内置新浪 SSO 跨域换票与会话保活守护引擎，每 12 小时自动静默刷新令牌，彻底告别 7 天频繁掉线，实现一次扫码维持数月登录态。
  * **任务即时自愈**：任务执行前智能测活，临界失效自动毫秒级换票，保障任务不中断。
* **🛡️ 智能防风控与商业代理无缝对接**：
  * 支持动态 IP 代理池与商业级 API（如快代理、青果网络等）自动提取注入。
  * 全局透明请求拦截、实时代理存活探测、遭遇 403/418/429 风控毫秒级无感自愈切换新 IP。
  * 自带账号级 Redis 互斥锁、操作随机冷却（3~8s）与散列时间抖动，极力模拟真实用户行为。
* **📅 批量与全天自动签到 (Auto Checkin)**：
  * 支持一键完成选中账号在所有关注超话的签到。
  * 开启全天自动守护模式后，后台调度器在每天凌晨 0:00 - 6:00 窗口期内均匀随机分散执行，完美规避平台高峰风控。
* **💬 二转四评与自动互动 (Auto Interact)**：
  * 自动在选定超话下抓取最新帖子执行“转发 + 评论”。
  * 内置自定义评论库，执行时随机抽取真实文案，有效积累超话积分与经验值。
* **📈 全天自动增粉 (Auto Grow)**：
  * 支持指定最多 3 个互粉类超话，后台定时循环抓取最新帖子发表互粉文案。
  * 内置 **7 天 Redis 防重缓冲锁**，同一个账号对同一个帖子 7 天内绝不重复评论，防止刷屏。
* **🔥 一键全天自动续火 (Auto Streak)**：
  * 支持手动或开启每日定时任务（凌晨 1:00），向重要好友（最多 10 个）自动发送专属私信，确保“火花”永不断档。
* **💻 实时可视终端**：
  * 前端集成高度仿真的运行日志终端，任务进度、代理状态、成功与异常细节一目了然。
* **🖼️ 服务端头像防盗链代理**：
  * 内置图片代理接口，彻底解决微博官方头像防盗链导致的图片破损问题。

## 🛠️ 技术栈 (Tech Stack)

* **前端 (Frontend)**: Vue 3 (Composition API), Vite, TypeScript, Lucide-Vue-Next
* **后端 (Backend)**: Python 3.10+, FastAPI, Uvicorn, Pydantic
* **任务调度与队列 (Task Queue)**: Celery (基于 Gevent 协程并发), 自研 SchedulerEngine（支持 Celery / ThreadPool 双引擎自动降级）
* **缓存与消息代理 (Broker)**: Redis
* **数据持久化**: SQLite (WAL 高并发模式，存储系统用户与鉴权)

## 📖 相关文档 (Documentation)

针对具体功能的说明以及服务器生产环境的部署，请参考以下专用文档：

* 📘 [功能与服务详细介绍 (SERVICES.md)](./SERVICES.md)
* 🚀 [Ubuntu 22.04 服务器生产环境部署指南 (DEPLOY_UBUNTU.md)](./DEPLOY_UBUNTU.md)
* 💻 [后端架构与开发说明 (backend/README.md)](./backend/README.md)

## 💻 本地开发指南 (Local Development)

如果你想在本地机器上运行与二次开发本项目：

### 1. 前置条件
确保你已经安装了 **Python 3.10+**, **Node.js 18+**, 并且本地有正在运行的 **Redis** 实例 (`localhost:6379`)。

### 2. 启动后端 (Backend)
```bash
cd backend
python -m venv venv
# 激活虚拟环境 (Windows)
venv\Scripts\activate 
# 安装依赖
pip install -r requirements.txt
# 启动 FastAPI
uvicorn app.main:app --reload --port 8000
```

### 3. 启动 Celery Worker (处理异步任务)
另开一个终端窗口（请保持虚拟环境处于激活状态）：
```bash
cd backend
# 启动 Celery Worker
celery -A app.worker.tasks worker -l info -P gevent -c 100 -Q celery,checkin,interact
```
*(Windows 用户可以直接运行 `.\start_worker.ps1` 脚本)*

### 4. 启动前端 (Frontend)
```bash
cd frontend
npm install
npm run dev
```

打开浏览器访问 `http://localhost:5173` 即可进入系统主界面。

---
*声明：本项目仅供技术交流与学习参考使用，请合理安排任务调用频率。*