VibeSKU CLI
Command-line interface for VibeSKU — AI-powered creative automation that turns product SKU photos into agency-grade e-commerce visuals and marketplace-ready copy in seconds.
What VibeSKU Does
VibeSKU replaces manual creative production for e-commerce teams. Upload a product photo, define brand guidelines, and receive complete multi-format visual sets. Core capabilities: VisionKV™ visual system (complete visual collections from a single product), high-fidelity product restoration (1:1 precision on textures/logos/packaging), multilingual text overlays, and omni-channel format output.
Credit costs: 1K/2K image = 1 credit, 4K image = 2 credits, short video = 5 credits, copy = 1 credit.
Setup
The CLI is bundled at bin/vibesku.js — self-contained Node.js script, zero dependencies (requires Node >= 18).
CODEBLOCK0
Skill Version
For version checks and auto-update workflow, see versioning.md.
Authentication
Two methods, resolved in priority order:
- 1. CLI token (
vibesku auth login) — browser-based device flow, tokens at INLINECODE4 - API key —
VIBESKU_API_KEY env var > config file key (from vibesku init or vibesku config set-key)
CODEBLOCK1
Template Selection Guide
VibeSKU provides 4 templates. Read the corresponding reference file before building the generate command.
| Need | Template | Output | Cost | Reference |
|---|
| Single product image (main photo, banner, poster) | INLINECODE8 | IMAGE | 1-2 cr/img | ecom-hero.md |
| Coordinated detail-page poster set |
kv-image-set | IMAGE | 1-2 cr/img × scenes |
kv-image-set.md |
| Single technical exploded infographic |
exploded-view | IMAGE | 1-2 cr/img |
exploded-view.md |
| Product listing copy (title, bullets, description) |
listing | TEXT | 1 cr |
listing.md |
Decision Tree
CODEBLOCK2
Quick Style Matching (image templates)
| Product Type | ecom-hero INLINECODE12 | kv-image-set INLINECODE13 | exploded-view INLINECODE14 |
|---|
| Electronics, gadgets | INLINECODE15 | INLINECODE16 | INLINECODE17 |
| Luxury, high-end |
premium |
magazine |
morandi-editorial |
| Food, home goods |
lifestyle |
retro-film |
lifestyle-soft |
| Organic, eco-friendly |
organic |
organic-nature |
material-focus |
| Fashion, beauty |
minimal |
nordic-minimal |
studio-minimal |
| Kids, sports, bold |
vibrant |
cyberpunk |
auto (recommended) |
| Artisan, handmade |
studio |
watercolor |
material-focus |
| Unsure / let AI decide |
auto (default) |
auto (default) |
auto (default) |
Typical Workflow
CODEBLOCK3
Commands Quick Reference
| Command | Purpose |
|---|
| INLINECODE39 | Authentication management |
| INLINECODE40 |
Initialize with API key |
|
vibesku config set-key\|set-url\|show\|reset | CLI configuration |
|
vibesku templates [info <id>] | List / inspect templates |
|
vibesku generate -t <id> [options] | Generate visuals or copy |
|
vibesku refine <output-id> -p <prompt> | Refine output with edit instructions |
|
vibesku status <job-id> [--watch] | Check job progress |
|
vibesku jobs [-p <page>] [-t <template>] | List jobs |
|
vibesku export <job-id> [-o <dir>] | Download outputs |
|
vibesku batch <file> [--dry-run] | Bulk generation from JSON |
|
vibesku credits [show\|buy\|redeem <code>] | Credit management |
All commands support --json for machine-readable output. Full details: commands.md
Key Behaviors
- - Asset upload:
-i auto-uploads product images; -l uploads logo - Modify vs Regenerate: Use
vibesku refine <output-id> -p "<instruction>" to edit existing output. Use vibesku generate only for new creations. - Full UUID required for refine: Use
vibesku status <job-id> --json to get complete output UUIDs (table view truncates them). - Agent-friendly output: Prefer
--json flag for all commands when used by AI agents. - Version drift check (recommended triggers): Compare local
VERSION with upstream when any of these happen: unknown template/option error, template mismatch with vibesku templates --json, user asks for newly added capability, or local check is older than 7 days (recommended cadence). If issues occur during execution, prioritize this check before retrying generation/refine commands. Follow versioning.md. - Auto-update when outdated (recommended): If upstream version is newer, update skill first, then continue the user task with the updated skill.
- Watch mode:
--watch polls every 5s until all runs complete. - Credit tracking: Generation and refine show remaining balance on success.
Environment Variables
| Variable | Description |
|---|
| INLINECODE60 | API key (overrides config file) |
| INLINECODE61 |
Custom API URL (overrides config file) |
|
NO_COLOR | Disable colored output |
VibeSKU CLI
VibeSKU 的命令行界面——AI驱动的创意自动化工具，可在数秒内将产品SKU照片转化为机构级电商视觉素材和可直接上架的文案。
VibeSKU 功能概述
VibeSKU 取代了电商团队的手动创意制作流程。上传产品照片，定义品牌指南，即可获得完整的多格式视觉素材集。核心能力包括：VisionKV™ 视觉系统（从单个产品生成完整视觉集合）、高保真产品还原（纹理/标志/包装的1:1精准还原）、多语言文字叠加以及全渠道格式输出。
积分消耗：1K/2K图像 = 1积分，4K图像 = 2积分，短视频 = 5积分，文案 = 1积分。
环境设置
CLI 位于 bin/vibesku.js —— 独立的 Node.js 脚本，零依赖（需要 Node >= 18）。
bash
node /bin/vibesku.js --help
alias vibesku=node /bin/vibesku.js # 可选
技能版本
版本检查和自动更新工作流程，请参见 versioning.md。
身份认证
两种方式，按优先级顺序解析：
- 1. CLI 令牌（vibesku auth login）—— 基于浏览器的设备流程，令牌存储在 ~/.vibesku/config.json
- API 密钥—— VIBESKUAPIKEY 环境变量 > 配置文件密钥（来自 vibesku init 或 vibesku config set-key）
bash
vibesku auth login # 浏览器登录（推荐）
vibesku init vsk_ # 用于 CI/CD 的 API 密钥
模板选择指南
VibeSKU 提供4个模板。在构建生成命令前，请先阅读对应的参考文件。
| 需求 | 模板 | 输出 | 成本 | 参考文件 |
|---|
| 单张产品图片（主图、横幅、海报） | ecom-hero | 图像 | 1-2 积分/张 | ecom-hero.md |
| 协调的详情页海报集 |
kv-image-set | 图像 | 1-2 积分/张 × 场景数 |
kv-image-set.md |
| 单张技术分解信息图 | exploded-view | 图像 | 1-2 积分/张 |
exploded-view.md |
| 产品列表文案（标题、要点、描述） | listing | 文本 | 1 积分 |
listing.md |
决策树
用户需要视觉素材？
├── 技术分解信息图 → exploded-view
│ ├── 平衡标注（默认）→ labelPlacement: balanced-callout
│ ├── 无标签的清晰视觉效果 → labelPlacement: none
│ └── 品类感知环境 → backgroundMode: product-matched-scene
├── 单张图像（主图/横幅/海报）→ ecom-hero
│ ├── 产品主图 → scenario: MAIN_IMAGE, aspectRatio: 1:1
│ ├── 营销横幅 → scenario: BANNER, aspectRatio: 16:9
│ └── 竖版海报 → scenario: POSTER, aspectRatio: 3:4
└── 多张协调图像 → kv-image-set
├── 完整详情页 → scenes: [kv-hero, lifestyle, detail-01, specs-table, ...]
├── 快速主图+生活方式 → scenes: [kv-hero, lifestyle]
└── 品牌故事叙述 → scenes: [kv-hero, brand-story, user-review]
用户需要文本？
└── 产品列表文案 → listing
├── Amazon → templateName: AMAZON_LISTING
├── 淘宝 → templateName: TAOBAO_DETAIL
├── Shopify → templateName: SHOPIFY_DESC
└── 通用 → templateName: GENERIC
快速风格匹配（图像模板）
| 产品类型 | ecom-hero style | kv-image-set style | exploded-view style |
|---|
| 电子产品、小工具 | tech | tech-future | premium-technical |
| 奢侈品、高端产品 |
premium | magazine | morandi-editorial |
| 食品、家居用品 | lifestyle | retro-film | lifestyle-soft |
| 有机、环保产品 | organic | organic-nature | material-focus |
| 时尚、美妆 | minimal | nordic-minimal | studio-minimal |
| 儿童、运动、大胆风格 | vibrant | cyberpunk | auto（推荐） |
| 手工艺、手工制作 | studio | watercolor | material-focus |
| 不确定/让AI决定 | auto（默认） | auto（默认） | auto（默认） |
典型工作流程
bash
vibesku auth login # 1. 身份认证
vibesku templates # 2. 浏览模板
vibesku templates info exploded-view # 3. 查看模板详情（可选）
vibesku credits # 4. 检查余额
vibesku generate -t ecom-hero \
-n 无线耳机 \
-i product.jpg -l logo.png \
-b AudioTech # 5. 生成视觉素材
vibesku status --watch # 6. 监控直至完成
vibesku refine -p 更亮的背景 # 7. 优化（可选）
vibesku export -o ./output # 8. 下载结果
命令快速参考
| 命令 | 用途 |
|---|
| vibesku auth login\ | logout\ | status\ | refresh | 认证管理 |
| vibesku init <api-key> |
使用API密钥初始化 |
| vibesku config set-key\|set-url\|show\|reset | CLI配置 |
| vibesku templates [info
] | 列出/查看模板 |
| vibesku generate -t [options] | 生成视觉素材或文案 |
| vibesku refine -p | 通过编辑指令优化输出 |
| vibesku status [--watch] | 检查任务进度 |
| vibesku jobs [-p ] [-t ] | 列出任务 |
| vibesku export [-o ] | 下载输出结果 |
| vibesku batch [--dry-run] | 从JSON批量生成 |
| vibesku credits [show\|buy\|redeem ] | 积分管理 |
所有命令支持 --json 参数以输出机器可读格式。完整详情：commands.md
关键行为
- - 资产上传：-i 自动上传产品图片；-l 上传标志
- 修改 vs 重新生成：使用 vibesku refine -p <指令> 编辑现有输出。仅在新创建时使用 vibesku generate。
- 优化需要完整UUID：使用 vibesku status --json 获取完整输出UUID（表格视图会截断）。
- 代理友好输出：AI代理使用时，建议在所有命令中添加 --json 标志。
- 版本漂移检查（推荐触发条件）：当出现以下情况时，将本地 VERSION 与上游版本进行比较：未知模板/选项错误、模板与 vibesku templates --json 不匹配、用户询问新增功能、或本地检查超过7天（建议周期）。如果在执行过程中出现问题，在重试生成/优化命令前，优先进行此检查。请遵循 versioning.md。
- 过时时自动更新（推荐）：如果上游版本更新，先更新技能，然后使用更新后的
