feat: Enhance HistoryView with Guard List and Stats

- Added guard member model and statistics interface.
- Implemented loading functionality for guard list and statistics.
- Introduced a data table to display current guard members with pagination.
- Enhanced error handling and loading states for guard data.
- Updated UI components to include refresh button and statistics display.

feat: Update PointManage and PointGoodsView for Improved User Experience

- Added management flag to PointGoodsItem for better handling in PointManage.
- Enhanced PointGoodsView with improved tooltip logic for purchase status.
- Implemented detailed purchase history alerts and restrictions based on user actions.
- Improved visual feedback for purchased and non-purchasable items.

docs: Add comprehensive API integration documentation

- Documented API modules, data models, and request types.
- Included details on live platform integration and data storage mechanisms.

docs: Establish development workflow guidelines

- Outlined project configuration, environment setup, and code style practices.
- Provided deployment process using Docker.

docs: Create detailed documentation for the live request system

- Described the functionality and data flow of the song request system.
- Included main files and features related to the song request functionality.

docs: Define project structure and UI components

- Documented the overall project structure and key directories.
- Listed main UI components and their usage within the project.

chore: Analyze and document improvements in AnalyzeView

- Detailed enhancements made to the AnalyzeView for better user experience.
- Included visual comparisons and technical highlights of the optimizations.
This commit is contained in:
Megghy
2025-10-07 14:40:25 +08:00
parent 2966a49fc9
commit 96f6169a6c
16 changed files with 1953 additions and 619 deletions

View File

@@ -0,0 +1,28 @@
---
inclusion: manual
---
# 点歌系统
点歌系统是主要功能之一允许观众在直播过程中通过弹幕、SuperChat或网页界面请求歌曲。
## 主要文件
- [src/views/open_live/LiveRequest.vue](mdc:src/views/open_live/LiveRequest.vue): 点歌系统的主要界面组件
- [src/views/obs/LiveRequestOBS.vue](mdc:src/views/obs/LiveRequestOBS.vue): 用于OBS的点歌系统显示组件
## 主要功能
- 支持多种点歌方式弹幕、SuperChat、网页、手动添加
- 歌曲队列管理:等待、演唱中、已完成、已取消等状态管理
- 权限控制:可配置只允许舰长、提督、总督或粉丝牌用户点歌
- 冷却时间:可设置不同用户类型的点歌冷却时间
- OBS集成提供适用于OBS的显示组件可展示当前点歌队列
- 黑名单:可将特定用户加入黑名单
## 数据流
1. 接收来自直播平台的弹幕或SuperChat
2. 通过前缀识别点歌请求(如"点播"
3. 根据规则验证请求是否有效
4. 将有效请求添加到点歌队列
5. 主播可以管理队列:开始演唱、标记完成、取消请求等