看直播位置、任務進度、點數商店、排行榜、通知與互動結果。
TuTou IRL Live OS
TuTou Live OS 戶外直播控制中心
TuTou Live OS IRL streaming control center
這套網站不是單一介紹頁，而是把觀眾互動、主播後台、OBS 圖層、聊天室 Bot、斗內、任務、點數商店、即時地圖與直播後整理放在一起的工作台。
This site is not a single profile page. It is the workspace that connects viewer interaction, creator controls, OBS overlays, Twitch chat bot, donations, missions, point shop, live map, and post-stream organization.
先用四個面向理解
Understand it in four areas
如果你剛進來，先不要從技術名詞看。這套系統分成觀眾端、主播控制、系統主幹與直播後整理四個面向。
If you are new here, do not start from the technical names. The system is easiest to understand as viewer surfaces, creator controls, the event core, and post-stream workflow.
Live location, mission progress, reward shop, rankings, notifications, and interaction results.
管理 OBS 圖層、聊天室 Bot、自動通知、金流、直播狀態與系統健康。
Manage OBS overlays, chat bot, automated notices, payments, live state, and system health.
把 GPS、聊天室、斗內、Twitch EventSub、RIST 網路狀態轉成 LiveEvent。
Normalize GPS, chat, donations, Twitch EventSub, and RIST network status into LiveEvent.
用路線、聊天爆點、斗內點、任務與網路異常整理可回放的直播素材。
Use routes, chat spikes, donations, missions, and network issues to organize replay material.
43API router modules
57service modules
21model files
60Jinja / OBS templates
8Twitch bot command modules
目前能做什麼
Current feature map
🎥
OBS / IRL HUD
透明、低遮擋的戶外直播 HUD。
- IRL Game Hub
- 左上聊天室 / 左下網路 HUD / 右上導航 HUD
- 事件 toast、任務卡、目標進度條
- 斷線 / 待機全螢幕大面板
- OBS 圖層管理面板
🎥
OBS / IRL HUD
Transparent, low-obstruction livestream overlays.
- IRL Game Hub
- Chat, network HUD, navigation HUD
- Event toasts, mission cards, goal progress
- Full-screen disconnect dashboard
- Overlay management panel
📡
RIST / Belabox 網路監控
以 RIST Stats WebSocket 讀取即時串流狀態。
- Kbps / bitrate
- RTT、loss、quality
- missing、recovered、buffer
- NACK / retries / peer 狀態
- receiver-stats null、cleanup、timeout 偵測
📡
RIST / Belabox network monitoring
Reads real-time stream stats from RIST Stats WebSocket.
- Kbps / bitrate
- RTT, loss, quality
- missing, recovered, buffer
- NACK / retries / peer status
- receiver-stats null, cleanup, timeout detection
🗺️
GPS / RTIRL / Live Map
把戶外移動變成可互動資料。
- 即時 GPS、速度、方向、海拔、步數
- 線上即時地圖
- 歷史路線與回放
- 斗內點、任務點、網路差點、聊天爆點
- 停留點與熱點分析
🗺️
GPS / RTIRL / Live Map
Turns outdoor movement into interactive data.
- GPS, speed, heading, altitude, steps
- Live map
- Historical routes and playback
- Donation, mission, network, and chat event points
- Hotspot analysis
🤖
Twitch Bot / 聊天室
聊天室不只是文字，而是事件入口。
- 聊天室指令
- 自訂回覆、排程訊息、關鍵字
- Moderation、防洗版、禁字
- 任務、投票、兌換與查詢
- EventSub / Channel Points 串接
🤖
Twitch Bot / Chat automation
Chat becomes an event input layer.
- Chat commands
- Custom replies, scheduled messages, keywords
- Moderation, anti-spam, stopwords
- Missions, polls, redemptions, queries
- EventSub / Channel Points integrations
💸
斗內 / 金流
把支持轉成直播事件與會員經濟。
- Payment Order
- ECPay、OPay、PayPal、Streamlabs
- Webhook 驗證與付款追蹤
- 斗內通知、排行榜、訊息
- 避免新舊通道重複通知
💸
Donations / Payments
Turns support into live events and viewer economy.
- Payment orders
- ECPay, OPay, PayPal, Streamlabs
- Webhook verification and payment tracking
- Donation alerts, rankings, messages
- Duplicate-alert protection
🏆
點數 / 任務 / 遊戲化
讓觀眾參與直播，而不是只觀看。
- Point Ledger 與會員點數
- 觀看時間、簽到、斗內、任務獎勵
- 商店兌換、排行榜
- 任務、成就、寶箱、Boss Chest
- 預測、位置事件、streak
🏆
Points / Missions / Gamification
Turns viewers into participants.
- Point ledger and viewer balances
- Watch time, check-ins, donations, mission rewards
- Shop redemptions and rankings
- Missions, achievements, chests, Boss Chest
- Predictions, location events, streaks
系統架構：全部進 LiveEvent 主幹
Architecture: everything flows into LiveEvent
核心不是更多功能，而是把所有功能統一成事件。斗內、聊天室、GPS、網路、任務、成就、Follow、Raid、金流 Webhook、後台操作都會先正規化成 LiveEvent，再分發給 OBS、Bot、Live Map、Admin Dashboard、System Notice Queue 與直播後摘要。
The core idea is not adding more features, but normalizing every feature into events. Donations, chat, GPS, network stats, missions, achievements, follows, raids, payment webhooks, and admin actions are normalized into LiveEvents, then dispatched to OBS, Bot, Live Map, Admin Dashboard, System Notice Queue, and post-stream summaries.
Input SourcesTwitch Chat, EventSub, payments, RIST WebSocket, GPS / RTIRL, admin actions, viewer interactions.
NormalizeConvert raw inputs into typed LiveEvents with source, title, body, level, payload and targets.
State / DB / QueueStore events, update live state, queue notices, preserve replay and audit history.
Output SurfacesOBS overlays, Twitch Bot, Live Map, Admin Dashboard, notifications and summary pages.
Post-streamRoutes, chat spikes, donations, network problems, mission triggers and clip candidates.
RIST WebSocket 場景切換
RIST WebSocket scene switching
我使用 RIST Stats WebSocket 讀取即時網路狀態，而不是一直 HTTP polling。這讓 OBS 可以根據更接近真實狀態的 bitrate、receiver-stats null、cleanup、timeout、RTT、loss、missing、recovered、buffer 等資料做場景切換。
I use RIST Stats WebSocket instead of constant HTTP polling. This allows OBS scene switching to react to real-time bitrate, receiver-stats null, cleanup, timeout, RTT, loss, missing, recovered, and buffer signals.
NormalMain live scene. Bitrate is active, stats are fresh, and quality is stable.
Bitrate 0 / nullSwitch to disconnect scene when bitrate drops to zero or receiver-stats becomes null.
Quality warningShow warning overlays when RTT, loss, missing packets or buffer time become risky.
Stable recoveryOnly switch back after stats remain good for a confirmation window, avoiding rapid scene flapping.
後台與維運能力
Admin and operations
後台不是單純設定頁，而是整套直播系統的控制中心。它包含 OBS 圖層管理、聊天室 Bot 管理、金流與訂單、EventSub、系統整合測試、Runtime Diagnostics、Worker Health、Migration Guard、Startup Checklist、直播遙控台與地圖管理。
The admin panel is the control center of the livestream system. It includes OBS overlay management, chat bot controls, payment tracking, EventSub, integration tests, runtime diagnostics, worker health, migration guard, startup checklist, creator remote controls, and map management.
未來方向
Roadmap
1. 穩定核心先讓 LiveEvent、GPS、OBS、Bot、金流、地圖與後台穩定運作，不再互相卡死。
1. Stabilize the coreMake LiveEvent, GPS, OBS, Bot, payments, map and admin stable without blocking each other.
2. 產品化 UI把前台做成觀眾看得懂的作品頁，把後台做成直播主能快速操作的控制台。
2. Productize the UIMake public pages understandable for viewers and the admin panel practical for creators.
3. 直播後內容化用事件、路線、斗內點、聊天爆點和網路問題自動整理剪片素材。
3. Post-stream content workflowUse events, routes, donations, chat spikes and network issues to generate clip candidates.
4. 對外展示讓這套系統可以展示給觀眾、Discord、合作方、投資人或其他 IRL streamer。
4. Public showcaseMake the system easy to present to viewers, Discord communities, partners, investors and other IRL streamers.