vb-weibo-plus

Project Overview

vb-weibo-plus is a single-user Weibo client that runs on your own machine. After scanning a QR code to sign in with one Weibo account, the service keeps group chats and the latest posts from followed creators incrementally synced to a local SQLite database. It offers two web interfaces: local Weibo for browsing and searching, and Weibo group chat for reading and sending messages, with all images and videos previewed directly in the browser through a local proxy.

Browse Weibo and group chats in your browser with data kept on your machine, plus optional AI-assisted analysis of messages.

Key Features

• Local Weibo browsing: add creators, browse posts by day on a calendar and sync history within a chosen time range
• Weibo group chat: read group messages and send text, images and videos
• AI analysis: optionally connect an OpenAI-compatible model to analyze group chat messages
• Media proxy preview: Weibo images and videos are previewed in the browser through a local proxy, with no Weibo login in the browser
• Incremental sync: syncs group chats and creator posts to local SQLite on a schedule

Target Audience

• Users who want to view posts from multiple creators in one place on their own machine
• Users who need to archive and search Weibo group chat messages
• Users who want to analyze group chat content with AI
• Users with some experience running a Java environment

Quick Start

1. Install JDK 21 and Maven 3.9 or later, and optionally ffmpeg for HEIC image preview
2. Start the service with mvn spring-boot:run, which listens on http://localhost:18080 by default
3. Open the web interface and sign in to Weibo by scanning the QR code
4. Add creators in the local Weibo view, or read and send messages in the group chat view

Core Advantages

• Data stays local: Weibo and group chat content is synced to local SQLite, keeping private data on your machine
• No browser login: media is previewed through a local proxy, so you never log in to Weibo in the browser
• Clear dual interfaces: post browsing and group chat are kept separate for easy use
• Optional AI boost: connect an OpenAI-compatible model on demand; base features work without it

System Requirements

Item	Requirement
OS	Windows, macOS, Linux
Architecture	64-bit environment with JDK 21 installed

Notes

• Running from source requires JDK 21 and Maven 3.9 or later
• ffmpeg is optional; without it, HEIC images cannot be displayed in the browser
• AI analysis requires your own OpenAI-compatible API endpoint and key
• The app listens on port 18080 by default; edit the config file to change it
• The project is designed for single-user use, so use one Weibo account at a time