VideoScript 文字稿
這個技能做什麼
它驅動 videoscript 指令列客戶端。該 CLI 使用使用者自行申請的金鑰與公開的 VideoScript API 通訊；服務端負責提取、轉錄與計費。此技能本身不直接發送 HTTP 請求，也不處理任何金鑰。
在開始之前
videoscript auth status --json
{"authenticated": true, ...}→ 繼續進行。- 結束代碼 3 → 使用者尚未登入。告知他們在 VideoScript 網站上建立 API 金鑰，並自行執行
videoscript auth login --token <key>。絕對不要要求他們將金鑰貼入對話中，也不要回顯金鑰。 - 找不到
videoscript→ 請使用者安裝（npm install -g videoscript）。
一般流程
# 1. 提交（立即回傳任務 ID）
videoscript transcribe create "<url>" --json
# 2. 等待完成（遵循伺服器的 Retry-After）
videoscript transcribe wait <id> --json
# 3. 將文字稿寫入檔案，而非聊天內容
videoscript transcript get <id> --format markdown --output notes/<name>.md
重要規則：
- 一次提交 = 一個冪等金鑰。 CLI 會自動產生並在
--json中顯示；如果需要重試某次呼叫，請重複使用該金鑰（--idempotency-key），以避免使用者被重複收費。 - 長文字稿請寫入檔案。 僅讀取使用者需求所需的篇幅。絕對不要將整份一小時的文字稿貼入對話中。
- 用量是可見的。 每完成一個任務都會消耗使用者的點數，並顯示在他們的資料庫中；在提交長內容前請先告知。
- 內容限制由服務端決定，你無權繞過。 登入牆、付費內容、DRM、地區封鎖與直播串流會被服務端拒絕。請勿建議使用代理、Cookie 或第三方下載工具。
發生問題時
結束代碼：3 未登入，4 無此任務，5 稍後重試，6 點數/預算不足，7 來源被拒絕。
5→ 等待 CLI 回報的Retry-After時間，然後重試。CLI 已內建自動重試兩次。6→ 告知使用者他們的餘額或此金鑰的預算已用盡；絕對不要嘗試進行購買。7→ 清楚說明限制並停止。不要重試。1/2→ 非預期錯誤或錯誤的引數；請閱讀訊息，修正呼叫。
完整表格請參閱：reference/cli.md 和 reference/errors.md。
這個技能不處理的事項
上傳、批次作業、刪除任務、付款、管理操作，或任何需要使用者密碼的事項。金鑰的權限範圍由服務端強制執行。