Chatterbox

LAPLACE Chatterbox 的 AI 陪聊功能位於「同傳」標籤頁內，由內建的輕量引擎驅動：即時讀取同傳辨識出的主播語音文字，並結合最近的觀眾彈幕作為上下文，呼叫 OpenAI 相容的 LLM API 產生貼合直播節奏的候選彈幕

支援「自動傳送」與「候選審核」兩種工作模式，可在「自動陪聊」與「手動挑選」之間隨時切換，所有 LLM 請求均直接發往使用者自行設定的 API，彈幕助手不經手任何提示詞或 API Key

特性

• 雙驅動觸發：由同傳辨識到的主播語音（句末標點 / 端點偵測 / 緩衝區超長）與累計的新觀眾彈幕共同驅動產生
• 兩種工作模式：
  • 自動傳送：LLM 決定 send=true 時直接進入傳送佇列
  • 候選審核：產生的彈幕進入「候選彈幕」清單，由使用者點擊「傳送 / 編輯 / 略過」決定是否發出
• 觀眾彈幕上下文：維護最近 N 則觀眾彈幕（可設定）作為上下文，便於 LLM 理解目前彈幕區的氛圍
• 滾動歷史摘要：將最近的「主播語音 + 已傳送內容」配對作為對話歷史回傳給 LLM，避免重複發言
• 結構化輸出：呼叫時強制使用 json_schema 回應格式，LLM 必須回傳 send / message / reason 三個欄位
• 自我回聲去重：30 秒內發出的彈幕被嗶哩嗶哩回推至彈幕區時會自動忽略，不會污染上下文
• 大表情過濾：觀眾傳送的大表情彈幕（僅有圖片、無文字含義）不會進入上下文
• 多人格預設：內建「槓精 / 吐槽役 / 暖男 / 互動引導」四套提示詞，可隨時切換或自行編輯
• 決策日誌：保留最近 50 筆決策記錄（成功 ✅ / 略過 ⏭ / 失敗 ❌），可一鍵清空
• 共享傳送佇列：與獨輪車、自動融入、同傳共享傳送佇列與嗶哩嗶哩頻率限制，AUTO 優先權，可被手動傳送搶占

使用方法

準備工作

• 在「設定 → LLM 設定」中填入 OpenAI 相容的 API Base、API Key 與模型 ID
• 在「設定 → LLM 提示詞 → AI 陪聊」中確認已啟用一份提示詞（首次啟用時預設會套用「槓精」）
• 在「同傳」標籤頁中啟動同傳，AI 陪聊會基於同傳產生的即時文字運作

啟用與模式切換

• 切換至「同傳」標籤頁，在「AI 陪聊」區域勾選「啟用 AI 陪聊」
• 點擊「自動傳送 / 候選審核」按鈕在兩種模式之間切換：
  • 按鈕高亮（filled）= 目前為「自動傳送」
  • 按鈕外框（outline）= 目前為「候選審核」
• 點擊「立即產生」可跳過緩衝等待，強制觸發一次 LLM 呼叫

候選審核模式

• 產生的候選彈幕顯示在「候選彈幕」清單（最多保留 30 則，超出時捨棄較舊的候選）
• 每則候選可選擇：
  • 傳送：直接將原文加入傳送佇列
  • 編輯：彈出輸入框修改後再傳送（支援 Enter 確認 / Esc 取消）
  • 略過：捨棄該候選，記錄到決策日誌

切換人格

• 在「AI 陪聊」區域底部的「提示詞」下拉選單中切換目前啟用的提示詞
• 完整的提示詞管理（新增、編輯、刪除、調整順序）在「設定 → LLM 提示詞 → AI 陪聊」中進行
• 內建提示詞每則第一行為人格名稱，可作為預覽快速辨識

選項說明

觸發與上下文

模式

觸發時機

引擎內部的排程邏輯：

• 主播語音緩衝區偵測到句末標點（。.！!？?）、Soniox 回報端點（endpoint）或緩衝超過 200 字元時，500 ms 後觸發產生
• 緩衝區有內容但「未就緒」時，最長等待 8 秒後保底觸發
• 觀眾彈幕累計達到設定值時，3 秒後觸發一次「觀眾驅動」產生（僅在沒有其他任務排隊時）

注意事項

• API Base / Key / 模型等所有 LLM 設定僅儲存在瀏覽器的腳本儲存空間，彈幕助手與 LAPLACE 伺服器不會接收任何 LLM 相關資料
• LLM API 費用由使用者與 LLM 服務商按呼叫次數 / Token 用量結算，請合理設定「彈幕最長」與「上下文上限」以控制成本
• 若 LLM 回傳內容無法解析為合法 JSON，引擎會在日誌中回報錯誤並放棄本次結果，不會傳送任何彈幕
• AI 陪聊不接管「同傳」自身的彈幕傳送：同傳的文字仍由「同傳」面板決定是否傳送，AI 陪聊在另一條路徑上獨立產生內容
• 切換房間或重新整理頁面後，候選清單會被清空；決策日誌會保留至本次工作階段結束
• 若希望完全停止引擎，請取消勾選「啟用 AI 陪聊」，否則即使「立即產生」未點擊，觀眾彈幕仍會維持排程狀態