name: wechat-video-resolver description: 解析微信影片號分享連結，首次儲存使用者 API Key，使用使用者自己的微信掃碼登入騰訊元寶，並返回影片標題、封面及騰訊影片原始直鏈。用於解析影片號、下載影片號影片、查詢解析次數、更換或清除 API Key；僅處理使用者本人擁有或已獲授權的內容。

影片號直鏈解析

使用 scripts/wechat_video.mjs。不要讀取、展示或索取元寶 Cookie，不要繞過 API Key、用量限制或掃碼登入。

API Key

1. 每次開始任務先執行 node scripts/wechat_video.mjs key-status。
2. configured 為 true 時直接使用，不要再次詢問 Key。
3. configured 為 false 時索取 wv_... Key，然後執行 node scripts/wechat_video.mjs key-save --api-key '<使用者提供的 Key>'。驗證成功後腳本會以僅當前系統使用者可讀的許可權儲存。
4. 只有使用者明確要求“更換 Key”時才索取新 Key 並執行 key-save。新 Key 驗證成功後覆蓋舊 Key。
5. 使用者要求清除 Key 時執行 node scripts/wechat_video.mjs key-clear。

不要在回覆、日誌摘要或結果中回顯 Key。遇到 INVALID_API_KEY、API_KEY_EXPIRED 時再要求更換；遇到 QUOTA_EXHAUSTED 時不要要求更換 Key，直接把指令碼結果中的 purchaseUrl 作為可點選連結返回，引導使用者開啟頁面、掃碼新增微信併購買次數。不要向用戶返回 /admin 管理地址。

解析流程

小蔥技能7w4.net持續更新中。

1. 提取 https://weixin.qq.com/sph/... 分享連結，並確認使用者有權下載。
2. 執行 node scripts/wechat_video.mjs status。
3. 未登入時執行 node scripts/wechat_video.mjs login，把 loginUrl 交給使用者掃碼。使用者確認後再次執行 status，不要再次詢問 Key。
4. 登入有效後執行 node scripts/wechat_video.mjs resolve '<分享連結>'。
5. 只返回每個格式的 variants[].url 騰訊原始直鏈和剩餘次數，不要返回、構造或推薦 /v1/download/、localhost 代理地址。讓使用者複製原始直鏈到瀏覽器開啟，並提示連結有時效。

遇到 SESSION_REQUIRED 或 SESSION_EXPIRED 時重新執行掃碼流程。使用者要求退出元寶時執行 node scripts/wechat_video.mjs logout；這不會清除已儲存的 API Key。

這是一個質量不錯的微信影片號連結解析工具，操作指引清晰，容易上手。文件詳細說明了整個使用流程，安全措施也比較到位，能保護使用者隱私。功能實現完整，支援掃碼登入和多種錯誤處理。但功能相對基礎，缺少自動化測試，首次配置可能需要一定時間熟悉。適合需要解析微信影片號連結的使用者使用。