gen-paylink-govilo

Govilo To Go

將任何檔案轉換為付費解鎖連結 — 一個指令即可打包、上傳並收取加密貨幣款項。自動化的最後一哩路：從創作到變現。

執行前

在執行 CLI 前，務必向用戶詢問以下數值，切勿自行猜測或使用佔位符：

1. title — 商品名稱是什麼？
2. price — 要收取多少費用（以 USDC 計價）？
3. description — 商品的簡短描述（非必填，但務必詢問）

CLI 指令

需要 uv。安裝說明請參閱 references/setup-guide.md。

從此技能的基礎目錄執行。使用專用的環境變數檔案，僅包含 GOVILO_API_KEY（以及選擇性的 SELLER_ADDRESS）。切勿將 --env-file 指向包含無關機密的專案 .env 檔案。

cd <skill_base_directory>
uv run --env-file <path_to>/.env.govilo create-link \
  --input <path>         \
  --title "Product Name" \
  --price "5.00"         \
  --address "0x..."      \
  --description "optional"

如果 .env.govilo 不存在，請在執行前先建立：

GOVILO_API_KEY=sk_live_xxx
SELLER_ADDRESS=0x...

--input 接受 ZIP 檔案、資料夾或個別檔案（可重複）。非 ZIP 的輸入會自動打包。

所有輸出皆為 JSON {"ok": true/false, ...}，失敗時退出碼為 1。

參數

參數	必填	來源	說明
--input	是	CLI（可重複）	ZIP、資料夾或檔案路徑
--title	是	CLI	商品標題
--price	是	CLI	價格（USDC）
--address	否	CLI > SELLER_ADDRESS 環境變數	賣家 EVM 錢包位址
--description	否	CLI	商品描述

工作流程

1. 驗證設定（API 金鑰 + 賣家位址）
2. 打包輸入 → ZIP（若非 ZIP 格式）
3. POST /api/v1/bot/uploads/presign → 取得 upload_url 與 session_id
4. PUT upload_url → 上傳 ZIP 至 R2
5. POST /api/v1/bot/items → 取得 unlock_url

檔案限制

• 最大 ZIP 大小：20 MB
• ZIP 內最大檔案數量：20

設定

需要兩個數值：

變數	必填	說明
GOVILO_API_KEY	是	來自 govilo.xyz 的 Bot API 金鑰
SELLER_ADDRESS	是*	Base 鏈上的 EVM 錢包位址

*SELLER_ADDRESS 也可透過 CLI 參數 --address 傳入。

逐步註冊與錢包設定說明請參閱 references/setup-guide.md。

API 參考

Bot API 端點與錯誤碼請參閱 references/bot-api-quick-ref.md。