VSingerBoard

# VSingerBoard - 您的专属虚拟主播点歌台     

---

在弹幕的海洋中，手动记录点歌请求不仅繁琐，还容易错失粉丝的热情。VSingerBoard 专为解决这一痛点而生，它是一座连接主播与粉丝的桥梁，一个为虚拟主播、歌手和音乐爱好者打造的跨平台智能点歌管理面板。

VSingerBoard 将混乱的弹幕点歌请求，转化为一个优雅、有序、可交互的列表，让您能专注于直播，而非手忙脚乱的管理。

✨ 核心功能

• 🎤 多平台支持: 已无缝支持 Bilibili 和 抖音 两大主流直播平台，并具备良好的扩展性。
• 🚀 实时弹幕抓取: 基于高性能异步框架，实时捕获并智能过滤点歌弹幕，确保不会错失粉丝的热情互动。
• 🛡️ 高稳定连接: 针对抖音平台，通过模拟浏览器签名算法和原生 WebSocket 通信，结合后台异步任务处理，实现长期、稳定的弹幕连接。
• 🎨 现代化UI界面: 采用 Vue 3 和 Element Plus 构建，界面简洁美观，支持亮色/暗色模式一键切换，提供卓越的操作体验。
• 🛠️ 自动化构建与部署: 借助 GitHub Actions 实现全自动的跨平台（Windows, macOS, Linux）打包与发布，确保您随时能获取最新的稳定版本。
• 🔒 本地化数据存储: 使用 Tortoise-ORM 配合 SQLite，将所有配置和凭据安全存储在本地，杜绝隐私泄露风险。

📸 应用截图

🚀 如何使用

对于普通用户，我们强烈建议您直接下载已打包好的应用程序。

1. 前往 GitHub Releases 页面。
2. 根据您的操作系统（Windows, macOS, 或 Linux），下载最新版本的压缩包。
3. 解压后，直接运行主程序即可！
4. 有不明白的地方可参考 文档

🛠️ 技术栈

• 后端: Python 3.12, FastAPI, Uvicorn, Tortoise-ORM
• 前端: Vue 3, Vite, Element Plus, TypeScript
• 桌面端框架: Pywebview
• 直播平台接口: bilibili-api-python, aiohttp, pyexecjs, Protobuf
• 构建与打包: PyInstaller, GitHub Actions

📂 项目结构

.
├── .github/                  # GitHub Actions CI/CD 工作流
│   └── workflows/            # 自动化工作流定义
├── doc/                      # 项目文档和图片
├── frontend/                 # 前端Vue应用源码
│   ├── public/               # 前端静态资源
│   └── src/                  # 前端核心代码
│       ├── api/              # API 服务定义
│       ├── assets/           # 静态资源(如CSS,图片)
│       ├── components/       # Vue 公共组件
│       ├── layouts/          # 布局组件
│       ├── pages/            # 页面组件
│       ├── router/           # Vue Router 配置
│       ├── stores/           # Pinia 状态管理
│       ├── types/            # TypeScript 类型定义
│       └── utils/            # 前端工具函数
├── hooks/                    # PyInstaller打包钩子
├── resources/                # 应用打包所需资源
│   ├── douyinjs/             # 抖音签名相关JS文件
│   ├── icons/                # 应用图标
│   └── Notificator.app/      # macOS通知程序
├── src/                      # Python后端应用源码
│   ├── database/             # 数据库模型和操作
│   ├── douyin/               # 抖音直播相关逻辑
│   │   └── lib/              # Protobuf编译库
│   ├── jsBridge/             # Python与JavaScript桥接
│   ├── live/                 # 各直播平台实现
│   ├── manager/              # 核心管理器模块
│   ├── notifypy/             # 跨平台桌面通知库
│   │   └── os_notifiers/     # 特定操作系统的通知实现
│   ├── server/               # FastAPI后端服务
│   └── utils/                # 后端通用工具函数
└── tests/                    # 测试代码

🤝 如何贡献

我们欢迎任何形式的贡献！无论是提交 Bug、建议新功能，还是直接贡献代码，都将是对本项目的巨大支持。

推荐使用 VS Code 作为开发IDE。环境要求：Python 3.12+ 和 Node.js 20.19+。

1. Fork 本仓库。
2. 创建您的新分支 (git checkout -b feature/AmazingFeature)。
3. 安装依赖:
   • 后端:

     pip install uv && uv sync
     

     ⚠️ Linux 用户请注意: 如果您使用 Linux 系统，请额外安装 GTK 和 WebKit 的开发库： sudo apt-get install -y python3-gi python3-gi-cairo gir1.2-gtk-3.0 gir1.2-webkit2-4.1

   • 前端:

     cd frontend
     pnpm install
     

4. 运行与开发: 启动开发环境：

   uv run main.py
   

   该命令将同时启动后端的 FastAPI 服务与前端的 Vite 开发服务器。代码修改后，应用会自动热重载。

5. 本地Build:
   运行build脚本:

   bash build.sh
   

6. 提交您的更改 (git commit -m 'feat: Add some AmazingFeature')。
7. 推送您的分支 (git push origin feature/AmazingFeature)。
8. 创建 Pull Request。

❤️ 致谢

本项目的实现离不开以下优秀开源项目的支持：

• bilibili-api
• DouyinLiveWebFetcher
• PyWebview

📄 许可证

本项目基于 GPL-3.0 许可证发布。详情请见 LICENSE 文件。

This site is open source. Improve this page.