gen-paylink-govilo
Compare original and translation side by side
🇺🇸
Original
English🇨🇳
Translation
ChineseGovilo To Go
Govilo To Go
Turn any file into a paid unlock link — one command to package, upload, and collect crypto payments. The last mile of automation: from creation to monetization.
将任意文件转换为付费解锁链接——只需一条命令即可完成打包、上传并收取加密货币付款。实现从内容创建到变现的最后一英里自动化。
Before Running
运行前准备
Always ask the user for these values before executing the CLI — never guess or use placeholders:
- title — What is the product name?
- price — How much to charge (in USDC)?
- description — Short description of the product (optional, but always ask)
在执行CLI命令前,务必向用户确认以下参数——切勿猜测或使用占位符:
- title — 产品名称是什么?
- price — 收费金额(以USDC计价)?
- description — 产品简短描述(可选,但务必询问)
CLI Command
CLI命令
Requires uv. See references/setup-guide.md for install instructions.
Run from this skill's base directory. Use a dedicated env file containing only (and optionally ). Never point at a project that contains unrelated secrets.
GOVILO_API_KEYSELLER_ADDRESS--env-file.envbash
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"If no exists, create one before running:
.env.govilodotenv
GOVILO_API_KEY=sk_live_xxx
SELLER_ADDRESS=0x...--inputAll output is JSON with exit code 1 on failure.
{"ok": true/false, ...}需要依赖uv。安装说明请查看references/setup-guide.md。
请在本技能的根目录下运行命令。使用专用的环境变量文件,该文件仅包含(可选包含)。切勿将指向包含无关密钥的项目文件。
GOVILO_API_KEYSELLER_ADDRESS--env-file.envbash
cd <skill_base_directory>
uv run --env-file <path_to>/.env.govilo create-link \
--input <path> \
--title "产品名称" \
--price "5.00" \
--address "0x..." \
--description "可选描述"若不存在文件,请在运行前创建:
.env.govilodotenv
GOVILO_API_KEY=sk_live_xxx
SELLER_ADDRESS=0x...--input所有输出均为JSON格式,执行失败时退出码为1。
{"ok": true/false, ...}Parameters
参数说明
| Param | Required | Source | Description |
|---|---|---|---|
| Yes | CLI (repeatable) | ZIP, folder, or file paths |
| Yes | CLI | Product title |
| Yes | CLI | Price in USDC |
| No | CLI > | Seller EVM wallet |
| No | CLI | Product description |
| 参数名称 | 是否必填 | 参数来源 | 描述 |
|---|---|---|---|
| 是 | CLI(可重复使用) | ZIP文件、文件夹或文件路径 |
| 是 | CLI | 产品标题 |
| 是 | CLI | 以USDC计价的价格 |
| 否 | CLI > | 卖家EVM钱包地址 |
| 否 | CLI | 产品描述 |
Workflow
工作流程
- Validate config (API Key + seller address)
- Package inputs → ZIP (if not already ZIP)
- → get upload_url + session_id
POST /api/v1/bot/uploads/presign - → upload ZIP to R2
PUT upload_url - → get unlock_url
POST /api/v1/bot/items
- 验证配置信息(API密钥 + 卖家地址)
- 将输入内容打包为ZIP(若输入不是ZIP格式)
- 调用接口 → 获取upload_url和session_id
POST /api/v1/bot/uploads/presign - 调用接口 → 将ZIP文件上传至R2存储
PUT upload_url - 调用接口 → 获取unlock_url
POST /api/v1/bot/items
File Limits
文件限制
- Max ZIP size: 20 MB
- Max files in ZIP: 20
- ZIP文件最大大小:20 MB
- ZIP文件内最多包含20个文件
Setup
配置步骤
Two values are required:
| Variable | Required | Description |
|---|---|---|
| Yes | Bot API key from govilo.xyz |
| Yes* | EVM wallet address on Base chain |
* can also be passed via CLI parameter.
SELLER_ADDRESS--addressSee references/setup-guide.md for step-by-step registration and wallet setup instructions.
需要配置以下两个参数:
| 变量名称 | 是否必填 | 描述 |
|---|---|---|
| 是 | 从govilo.xyz获取的Bot API密钥 |
| 是* | Base链上的EVM钱包地址 |
*也可通过CLI参数传入。
SELLER_ADDRESS--address分步注册和钱包配置说明请查看references/setup-guide.md。
API Reference
API参考
See references/bot-api-quick-ref.md for Bot API endpoints and error codes.
Bot API的接口端点和错误码请查看references/bot-api-quick-ref.md。