PikaStream 視訊會議 是做什麼的?
腳本: SKILL_DIR=skills/pikastream-video-meeting
首次設定
技能首次載入時執行一次:
pip install -r $SKILL_DIR/requirements.txt
1. 頭像
檢查 identity/videomeeting-avatar.png 是否存在且大於 1 KB。如果不存在(或檔案太小):
- 詢問使用者:
我需要一個視訊會議用的頭像圖片(大頭照或肖像)。傳一張圖片給我,或說「generate」讓我幫你產生一個。 - 在收到使用者回應之前,不要繼續。 不要自動產生。
- 使用者傳送圖片: 將其儲存至
identity/videomeeting-avatar.png。 - 使用者說「generate」: 執行:
如果使用者描述了想要的內容(例如「一隻卡通貓」),請加上python $SKILL_DIR/scripts/pikastreaming_videomeeting.py generate-avatar \ --output identity/videomeeting-avatar.png--prompt "<描述>, 適合視訊通話的肖像大頭照"。 顯示產生的圖片。詢問:要保留這個頭像還是重新產生?等待回覆。 - 其他情況: 重複步驟 1 的問題。
機器人在加入會議前必須有一個頭像。
2. 語音
檢查 life/voice_id.txt 是否存在且非空。
如果存在: 讀取 life/voice_config.json。如果可以讀取,檢查 cloned_at — 如果距今已超過 6 天,警告使用者:
您的語音克隆建立於 {date},可能已過期(克隆語音在 7 天未使用後會被刪除)。要使用新的錄音重新克隆,還是嘗試現有的?
- 重新克隆:前往下方的「如果不存在」流程。
- 保留現有:使用既有的語音 ID。
如果 life/voice_config.json 不存在或無法讀取,直接使用 life/voice_id.txt 中的語音 ID。
如果不存在(或使用者選擇重新克隆):
- 詢問使用者:
我還沒有語音克隆。您可以:(a) 傳送一段語音錄音(10 秒到 5 分鐘,咬字清晰),我來克隆;或 (b) 說「skip」使用預設語音。 - 在收到使用者回應之前,不要繼續。
- 使用者說「skip」: 使用
English_radiant_girl。 - 使用者傳送音訊檔案: 執行:
python $SKILL_DIR/scripts/pikastreaming_videomeeting.py clone-voice \ --audio <檔案> --name <機器人名稱> --noise-reduction- 回傳碼 0:讀取
life/voice_id.txt。告知使用者:語音已克隆。本次會議使用 {voice_id}。 - 回傳碼非 0:告知使用者克隆失敗(包含 stderr)。詢問:
要換個檔案重試,還是跳過使用預設語音?
- 回傳碼 0:讀取
- 無效檔案(非音訊): 回應:
這看起來不是支援的音訊檔案。請傳送 mp3、m4a、wav、ogg、flac 或 aac 檔案(10 秒到 5 分鐘的清晰語音)。等待重試或「skip」回應。
加入流程
步驟 1 — 驗證與收集上下文
頭像: 檢查 identity/videomeeting-avatar.png 是否存在且大於 1 KB。如果沒有,執行上方首次設定的頭像部分。
語音: 檢查 life/voice_id.txt 是否存在。如果沒有,執行上方首次設定的語音部分。
上下文: 始終收集最新的上下文 — 不要重複使用先前工作階段的過時檔案。
- 讀取您的工作區檔案(MEMORY.md、日誌、身分檔案等)。
- 如果沒有工作區資料,詢問使用者:
機器人在這次會議中應該使用什麼名稱?將他們的回答填入Name:欄位。根據對話內容填寫您知道的任何其他部分。 - 將簡潔的參考卡片合成至
/tmp/meeting_system_prompt.txt。使用{name}作為機器人的顯示名稱(也用作--bot-name)。如果資料很少(例如只有一個名稱),保持簡短 — 不要用填充內容。
將以下原始資料合成為 {name} 在語音/視訊通話中使用的簡潔參考卡片。全程使用第三人稱(「{name}」)。優先使用具體細節。
優先順序:
1. 具體事實:姓名、地點、日期、數字、事件
2. 近期活動:今天/本週發生了什麼 — 行動,而非氛圍
3. 關係:誰重要,具體互動
4. 個性:最多 1-2 句話
整理規則:
- 保留:任何包含專有名詞、數字、日期或具體行動的內容
- 刪除:模糊描述、例行狀態更新、空白條目
- 合併:如果多個條目表達類似內容,選擇最生動的一個
輸出格式:
**{name}**:[1 句話 — 語氣/氛圍]
**已知事實**(僅具體事實,最多 10 條):
- [包含姓名/日期/數字的具體事實]
**近期活動**:
- [建置了 X,修復了 Y,去了 Z]
**現在**:[1 行 - 目前活動]
**人物**:[姓名 — 每人 1 條具體細節]
規則:
- 具體 > 抽象
- 行動 > 描述
- 不要虛構事實
- 如果資料很少,保持簡短
步驟 2 — 加入
python $SKILL_DIR/scripts/pikastreaming_videomeeting.py join \
--meet-url <網址> --bot-name <名稱> \
--image identity/videomeeting-avatar.png \
--system-prompt-file /tmp/meeting_system_prompt.txt \
--voice-id <id> [--meeting-password <密碼>]
告知使用者您已加入。說 leave 即可離開。不要提及工作階段 ID。
回傳碼: 0 = 已加入。6 = 點數不足(stdout JSON 中包含一個 checkout_url — 顯示給使用者看)。
離開
python $SKILL_DIR/scripts/pikastreaming_videomeeting.py leave \
--session-id <從加入輸出取得的 id>