gen-paylink-govilo

Govilo To Go

将任意文件转换为付费解锁链接——一条命令即可打包、上传并收取加密货币付款。自动化的最后一公里：从创作到变现。

运行前

在执行 CLI 前，务必向用户询问以下值——切勿猜测或使用占位符：

1. title — 产品名称是什么？
2. price — 收费多少（以 USDC 计）？
3. description — 产品的简短描述（可选，但务必询问）

CLI 命令

需要 uv。安装说明请参见 references/setup-guide.md。

从本技能的基目录运行。使用一个专用的 env 文件，仅包含 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 也可以通过 --address CLI 参数传递。

分步注册和钱包设置说明请参见 references/setup-guide.md。

API 参考

Bot API 端点和错误码请参见 references/bot-api-quick-ref.md。