1111

2026-04-16 15:19:48 +08:00
commit 1c892259a9
127 changed files with 17390 additions and 0 deletions
@@ -0,0 +1,193 @@
+# Live Recorder
+
+Live Recorder is a multi-platform live recording system built with:
+
+- Backend: `.NET 8 Web API + EF Core + SQLite`
+- Frontend: `Vue 3 + TypeScript + Element Plus`
+
+The current production-ready adapter is `DouyinLivePlatformAdapter`. The architecture keeps platform-specific logic isolated so Bilibili, Huya, Douyu, and Kuaishou can be added without changing application services.
+
+## Architecture
+
+```text
+.
+├─ src
+│  ├─ LiveRecorder.Domain
+│  │  ├─ Entities
+│  │  └─ Enums
+│  ├─ LiveRecorder.Application
+│  │  ├─ Abstractions
+│  │  ├─ Common
+│  │  ├─ Models
+│  │  └─ Services
+│  ├─ LiveRecorder.Infrastructure
+│  │  ├─ Persistence
+│  │  ├─ Platforms
+│  │  │  ├─ Douyin
+│  │  │  ├─ Bilibili
+│  │  │  └─ Huya
+│  │  └─ Services
+│  └─ LiveRecorder.WebApi
+│     ├─ Controllers
+│     └─ Middleware
+└─ frontend
+   └─ src
+      ├─ api
+      ├─ components
+      ├─ router
+      ├─ stores
+      └─ views
+```
+
+## Core design
+
+### Domain
+
+- `LiveRoom`: platform, room id, source URL, title, anchor, cover, availability status
+- `RecordTask`: recording state, quality, output format, ffmpeg process id, output path
+- `RecordResult`: final file or segment directory, file size, duration, final status
+- `SystemLogEntry`: persistent system log
+- `AppSetting`: runtime settings store
+- `UserAccount`, `UserSession`: lightweight token-based sign-in
+
+### Application
+
+- `ILivePlatformAdapter`
+  - `ParseRoomAsync`
+  - `GetLiveStatusAsync`
+  - `GetStreamUrlAsync`
+- `ILivePlatformAdapterFactory`
+- `LiveRoomService`
+- `RecordService`
+- `SystemSettingsService`
+- `SystemLogService`
+- `AuthService`
+
+### Infrastructure
+
+- `DouyinHttpClient`
+  - wraps User-Agent, Referer, Cookie, and `ttwid` handling
+- `DouyinLivePlatformAdapter`
+  - share-link resolution, room id extraction, status check, stream selection
+- `FfmpegService`
+  - single file mode, segmented mode, reconnect arguments, recording templates
+- `LiveRoomPollingBackgroundService`
+  - background polling scheduler for live detection and auto-start recording
+- `LiveRecorderDbContext`
+
+### Web API
+
+- `AuthController`
+- `LiveRoomsController`
+- `RecordTasksController`
+- `LogsController`
+- `SettingsController`
+- `ApiTokenAuthenticationMiddleware`
+- `ExceptionHandlingMiddleware`
+
+## Implemented features
+
+### Douyin adapter
+
+- resolve share links and redirects
+- extract real `roomId`
+- call `https://live.douyin.com/webcast/room/web/enter/`
+- preload `ttwid` when needed
+- parse both:
+  - `live_core_sdk_data.pull_data.stream_data`
+  - `flv_pull_url / hls_pull_url_map`
+- select the highest quality by default or respect configured quality
+
+### Background polling scheduler
+
+- configurable polling interval
+- configurable enable/disable switch
+- configurable auto-start switch
+- updates room status in background
+- auto-creates a recording task when a room is live and no task is running
+- also works as a recovery layer when ffmpeg exits unexpectedly while the room is still live
+
+### Recording enhancements
+
+- save format setting: `MP4` or `TS`
+- save mode setting:
+  - `SingleFile`
+  - `Segmented`
+- recording template setting:
+  - `StreamCopy`
+  - `BalancedMp4`
+  - `ArchiveTs`
+- reconnect tuning:
+  - enable/disable reconnect
+  - max reconnect delay
+  - read/write timeout
+
+### Frontend
+
+- login page
+- live room management
+- recording task list
+- recording task detail
+- log viewer
+- system settings
+- route lazy loading
+- vendor chunk splitting in Vite
+
+## Settings exposed in UI
+
+- ffmpeg path
+- output root
+- default quality
+- live save format
+- save mode
+- recording template
+- segment duration
+- reconnect switch and reconnect delay
+- read/write timeout
+- background polling switch
+- auto-start-on-live switch
+- polling interval
+- Douyin User-Agent / Referer / Cookie
+
+## Run
+
+### Backend
+
+```powershell
+dotnet restore LiveRecorder.sln
+dotnet build LiveRecorder.sln --no-restore -m:1
+dotnet run --project src/LiveRecorder.WebApi/LiveRecorder.WebApi.csproj --urls http://localhost:5000
+```
+
+Default account:
+
+- username: `admin`
+- password: `Admin@123`
+
+Swagger:
+
+- [http://localhost:5000/swagger](http://localhost:5000/swagger)
+
+### Frontend
+
+```powershell
+cd frontend
+npm install
+npm run dev
+```
+
+Frontend dev server:
+
+- [http://localhost:5173](http://localhost:5173)
+
+## Verified locally
+
+- `dotnet build LiveRecorder.sln --no-restore -m:1`
+- `npm run build`
+
+## Next steps
+
+1. Implement full adapters for Bilibili, Huya, Douyu, and Kuaishou.
+2. Add per-room recording preferences instead of relying only on global defaults.
+3. Add full-text log search and time-range filters.
+4. Replace lightweight token sessions with JWT or external SSO if needed.