# weibo-tools-app

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

## Basic Information

- **Project Name**: weibo-tools-app
- **Description**: ....
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

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

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 🚀 微博多功能全自动运维助手 (Weibo Tools Mobile & Web)

[![Vue](https://img.shields.io/badge/Vue-3.4+-42b883.svg?style=flat-square&logo=vue.js)](https://vuejs.org/)
[![Vite](https://img.shields.io/badge/Vite-5.4+-646cff.svg?style=flat-square&logo=vite)](https://vitejs.dev/)
[![TypeScript](https://img.shields.io/badge/TypeScript-5.5+-3178c6.svg?style=flat-square&logo=typescript)](https://www.typescriptlang.org/)
[![Capacitor](https://img.shields.io/badge/Capacitor-6.0+-119EFF.svg?style=flat-square&logo=capacitor)](https://capacitorjs.com/)
[![License](https://img.shields.io/badge/License-MIT-blue.svg?style=flat-square)](LICENSE)

基于 **Vue 3 + Vite 5 + TypeScript + Capacitor 6** 构建的现代化极简白蓝风格（White & Tech Blue）微博全自动化多账号运营与管理工具。支持 **Web 网页端** 与 **Android 原生移动端 (APK)** 双端无缝运行。

---

## 🌟 核心特性与架构亮点

### 1. 📱 手机原生网络直连引擎（直接使用手机自身移动网络/Wi-Fi IP）
- **告别云服务器风控**：内置跨端网络适配层（`CapacitorHttp`），在手机 Android APK 运行时**直接通过手机自身的蜂窝 4G/5G 或家用 Wi-Fi 发起网络请求**。
- **全流程原生直连**：从官方二维码获取、扫码轮询、SSO 凭证置换，到超话签到、二转四评、增粉巡检、好友私信，全部独立在手机本地完成，无需依赖任何电脑端代理转发。

### 2. 🎨 现代极简白蓝高定设计（White & Tech Blue）
- **清爽纯白与科技蔚蓝**：纯白底色（`#FFFFFF`）搭配冷灰基底（`#F8FAFC`）与蔚蓝科技主色（`#2563EB`）。
- **沉浸式全屏与固定导航**：深度适配 Android 系统状态栏（`windowLightStatusBar` 纯白底色深色图标），顶部导航栏全程固定置顶（吸顶），滚动时呈现优雅的毛玻璃透光拟态（`backdrop-filter: blur(16px)`）。
- **移动端流式自适应**：所有账号矩阵卡片、功能操作面板、底部控制台与弹出模态框（Modal）均针对手机端视口（`100dvh`）进行了像素级触控与排版优化。

### 3. 🤖 微博全套自动化核心能力
- 🔑 **官方二维码扫码安全登录**：全自动获取官方高清二维码，附带 90 秒动态倒计时与实时轮询感知。
- 🔄 **新浪 SSO 静默跨域换票**：自动检测 Cookie 有效性并在临界时完成多域自动续期，告别频繁掉线。
- 📋 **多账号槽位矩阵管理**：支持多账号自由切换、独立存储与一键批量多选。
- ✍️ **超话批量打卡与签到**：一键并行拉取关注的超话列表，毫秒级执行批量打卡。
- 💬 **超话互动二转四评**：自动抓取超话最新精华博文，执行高拟真互动转发与优质评论。
- 📈 **互粉超话 24/7 自动增粉**：内置 7 天防重哈希过滤库与智能随机延时，规避微博频率风控。
- 🔥 **好友一键维持火花（续火）**：单行自适应私信文案编辑器，批量向互关好友发送私信维持聊天火花。
- 📚 **互动评论文案库管理**：支持预设常用话术、批量导入多行文本、单行紧凑控制栏、一键随机模拟测试与文本导出。
- 💻 **IDE 极客风格实时终端**：暗黑玻璃拟态控制台（`#090D16`），提供多等级日志过滤（`ALL/INFO/SUCCESS/WARN/ERROR`）、关键词搜索、一键自动滚屏与日志导出。

### 4. 📴 100% 离线优先与数据安全
- **零云端上传**：所有账号凭证（Cookie / SSO Ticket）、自定义评论库、历史增粉记录均保存于设备本地存储（`LocalStorage`），无任何第三方中转，安全可信赖。

---

## 🛠️ 技术栈与依赖

| 技术 / 工具 | 说明 |
| :--- | :--- |
| **Vue 3** | 前端核心框架（Composition API + `<script setup>`） |
| **Vite 5** | 极速前端构建与开发工具 |
| **TypeScript 5** | 严谨的前端类型定义与类型检查系统 |
| **Capacitor 6** | 跨平台原生运行时（原生网络、剪贴板、安全存储） |
| **CapacitorHttp** | 突破浏览器跨域限制的原生 HTTP 直连层 |
| **Lucide Vue Next** | 现代矢量图标库 |
| **CSS Variables** | 模块化设计系统 Token 与流式响应式排版 |

---

## 📂 项目工程目录结构

```text
weibo-tools-app/
├── android/                         # Capacitor Android 原生工程
│   ├── app/                         # Android 应用模块 (Gradle / AndroidManifest)
│   │   ├── src/main/res/values/     # 原生主题 styles.xml / strings.xml / 图标
│   │   └── src/main/assets/public/  # 离线打包的前端静态资产
│   └── gradlew.bat                  # Gradle 原生编译脚本
├── public/                          # Web 公共静态资源与高清 Logo
├── src/
│   ├── components/                  # UI 交互组件与模态弹窗
│   │   ├── AccountCard.vue          # 微博账号卡片 (头像、状态、批量勾选)
│   │   ├── ChaohuaPickerModal.vue   # 超话选择与打卡弹窗
│   │   ├── CommentsModal.vue        # 评论文案库管理 (单行紧凑栏、批量导入)
│   │   ├── GrowthModal.vue          # 自动增粉与互助回关弹窗
│   │   ├── StreakModal.vue          # 好友一键续火弹窗 (单行私信编辑器)
│   │   ├── QrModal.vue              # 微博官方扫码登录弹窗
│   │   ├── TerminalLogs.vue         # 极客风格实时日志终端控制台
│   │   ├── ConfirmModal.vue         # 通用操作确认模态框
│   │   └── Toast.vue                # 顶部轻量浮动通知
│   ├── composables/                 # 响应式状态管理
│   │   └── useToast.ts              # 全局 Toast 提示服务
│   ├── services/                    # 纯客户端核心业务引擎 (TypeScript)
│   │   ├── http.ts                  # 跨端网络适配器 (CapacitorHttp 原生直连 / Web 代理)
│   │   ├── qr.ts                    # 手机端独立二维码生成与状态轮询
│   │   ├── api.ts                   # 统一业务数据门面 (Facade)
│   │   ├── storage.ts               # 本地存储与 7 天防重缓存
│   │   ├── logger.ts                # 实时日志广播发射器
│   │   ├── renew.ts                 # 新浪 SSO 跨域换票续期算法
│   │   ├── checkin.ts               # 超话分页拉取与批量打卡
│   │   ├── interact.ts              # 二转四评互动引擎
│   │   ├── growth.ts                # 互粉增粉与防重复逻辑
│   │   └── streak.ts                # 好友私信续火执行器
│   ├── styles/
│   │   └── main.css                 # 白蓝设计系统全局样式与 Modal 规范
│   ├── types/
│   │   └── index.ts                 # 完整 TypeScript 接口与类型定义
│   ├── App.vue                      # 仪表盘主控制台与 Bento 视图
│   └── main.ts                      # 应用程序入口
├── capacitor.config.ts              # Capacitor 跨平台配置文件
├── package.json                     # 项目依赖与运行脚本
├── tsconfig.json                    # TypeScript 编译配置
└── vite.config.ts                   # Vite 5 构建与安全过滤配置
```

---

## 🚀 本地开发与调试运行

### 1. 克隆项目并安装依赖
```bash
git clone https://gitee.com/ttzhanshen/weibo-tools-app.git
cd weibo-tools-app
npm install
```

### 2. 启动本地开发热更新服务器
```bash
npm run dev -- --host
```
启动后在控制台查看访问地址：
- **本机浏览器访问**：`http://localhost:5173/`
- **局域网/手机浏览器访问**：`http://[你的局域网IP]:5173/`

### 3. 类型检查与前端编译
```bash
npm run build
```
编译产物将安全输出至 `dist/` 目录。

---

## 📱 Android APK 原生编译与打包

本工程已完整配置 Android 原生支持，可随时编译生成独立 APK：

### 1. 同步前端构建资产至 Android 工程
```bash
npm run build
npx cap sync android
```

### 2. 使用 Gradle 编译 Debug APK
```bash
# Windows 环境设置 Java 21 / Android SDK 环境变量后编译
cd android
./gradlew assembleDebug
```
编译完成后，APK 文件位于：
`android/app/build/outputs/apk/debug/app-debug.apk`

---

## 🔒 隐私与免责声明

1. 本项目为开源学习与个人自动化辅助工具，所有网络通信均发生在用户设备本地与微博官方服务器之间。
2. 本项目不收集、不存储、不上报任何用户的个人隐私数据、账号密码或 Cookie 凭证。
3. 请合理合规使用自动化辅助功能，遵守平台社区规范，避免高频过度调用。

---

## 📄 开源许可证

本项目基于 [MIT License](LICENSE) 开源协议分发与使用。