名称： visla
描述： 使用 Visla 从文本脚本、URL 或 PPT/PDF 文档生成 AI 视频。当用户请求生成视频、将网页转为视频或将 PPT/PDF 转换为视频，或查询 Visla 账户积分/余额时使用。
argument-hint: [脚本|URL|文件]
元数据：
clawdbot:
emoji: ""
requires:
env: ["VISLA_API_KEY", "VISLA_API_SECRET"]
primaryEnv: "VISLA_API_KEY"
files: ["scripts/*"]

Visla 视频生成

版本: 260218-1410

使用 Visla OpenAPI，从文本脚本、网页 URL 或文档（PPT/PDF）创建 AI 生成的视频。

开始之前

凭证（切勿在响应中输出 API 密钥/密钥）：

重要提示：仅在获得用户明确同意后读取本地凭证文件。

1. 在读取 ~/.config/visla/.credentials 前，先询问用户许可。
2. 如果获得许可且文件存在并包含有效凭证，则在使用 Python CLI 时使用 --credentials-file ~/.config/visla/.credentials 参数。Bash CLI 不支持 --credentials-file，因此请改用环境变量。
3. 如果用户拒绝、文件缺失或凭证无效，则向用户索取凭证。

仅处理用户明确提供的本地文件（脚本/文档），并提醒用户避免上传敏感数据。
* 告知用户：这是一次性设置（配置完成后无需重复操作）。
* 告知用户：从 https://www.visla.us/visla-api 获取 API 密钥和密钥。
* 明确索取 API 密钥/密钥（或请用户更新文件并确认）。不要在响应中重复密钥。

凭证有效性检查（实践）：

• 如果凭证存在但运行 account 命令失败，并返回 VISLA_CLI_ERROR_CODE=missing_credentials 或 VISLA_CLI_ERROR_CODE=auth_failed，则将凭证视为无效并要求用户提供真实的凭证。

文件格式（bash/zsh）：

export VISLA_API_KEY="你的密钥"
export VISLA_API_SECRET="你的密钥"

对于 PowerShell（临时会话）：

$env:VISLA_API_KEY = "你的密钥"
$env:VISLA_API_SECRET = "你的密钥"

脚本：scripts/visla_cli.py (Python), scripts/visla_cli.sh (Bash)

平台执行策略

默认策略：

• 在 macOS 上，如果依赖项可用，首选 Bash（Bash CLI 可避免某些 macOS 设置上的 Python SSL 堆栈问题）。
• 如果已在使用配置良好的 Python 环境（或 Bash 依赖项缺失），则首选 Python。

Bash（在 macOS 上推荐；也适用于类 Linux 环境）：

# 获得用户同意后，可以 source ~/.config/visla/.credentials
export VISLA_API_KEY="你的密钥"
export VISLA_API_SECRET="你的密钥"
./scripts/visla_cli.sh <命令>

Python（跨平台）：

python3 scripts/visla_cli.py --key "你的密钥" --secret "你的密钥" <命令>
# 或者，获得用户同意后：
python3 scripts/visla_cli.py --credentials-file ~/.config/visla/.credentials <命令>

Windows 原生环境（PowerShell/CMD，无 Bash；使用 Python）：

# PowerShell
$env:VISLA_API_KEY = "你的密钥"
$env:VISLA_API_SECRET = "你的密钥"
python scripts/visla_cli.py <命令>

Windows 注意事项：

• 除非已验证 Bash 环境（WSL/Git Bash）可用，否则代理应首选在 Windows 上运行 Python CLI。
• 对于简单脚本，直接传递：python scripts/visla_cli.py script "场景 1: ..."
• 对于多行或复杂脚本，使用标准输入 -（推荐，无需临时文件）：
  powershell @" 场景 1: ... 场景 2: ... "@ | python scripts/visla_cli.py script -
• 如果安装了 Python Launcher，py -3 scripts/visla_cli.py <命令> 可能比 python 效果更好。
• 凭证：
• Python CLI 仅在明确提供 --credentials-file 参数时才读取凭证文件。
• 在 Windows 上，默认路径通常是：%USERPROFILE%\\.config\\visla\\.credentials。

注意：不要打印凭证。优先使用环境变量或在获得用户明确同意后使用 --credentials-file。

命令

确切的 CLI 接口信息，请运行 scripts/visla_cli.sh --help 或 python3 scripts/visla_cli.py --help 查看。

脚本格式

**场景 1** (0-10 秒):
**视觉:** 一个未来主义的日历翻到 2025 年，带有数字图案。
**旁白:** "AI 正在飞速发展！以下是 3 个颠覆性的 AI 趋势。"

**场景 2** (10-25 秒):
**视觉:** 文字："趋势 #1：生成式 AI 无处不在。" 展示像 ChatGPT 这样的工具。
**旁白:** "生成式 AI 正在主导各行各业——创造内容和图像。"

工作流程

script、url 和 doc 命令会自动执行完整流程：
1. 创建项目
2. 轮询直到生成完成（可能需要几分钟）
3. 自动导出并返回下载链接

执行说明：
* 告知用户视频生成需要一些时间
* 在轮询期间定期报告进度状态

超时指引

• 此工作流程通常需要 3-10 分钟，但在最坏情况下可能需要 长达约 30 分钟。请将任务/命令的 timeout 设置为 >= 30 分钟（Windows 默认值通常约为 10 分钟，需要增加）。如果无法更改超时设置，请提前警告用户，并在超时发生时询问是继续还是切换到分步运行。
• 如果发生超时，CLI 会在输出中返回 project_uuid。告知用户他们可以稍后通过 Visla 网页界面或 API 手动检查项目状态并继续。

示例

/visla script @myscript.txt
/visla script "场景 1: ..."
/visla url https://blog.example.com/article
/visla doc presentation.pptx
/visla account

支持的文档格式

• PowerPoint: .pptx, .ppt
• PDF: .pdf

输出格式

• 开始：技能开始时显示 "Visla Skill v260218-1410"
• 结束：技能完成时显示 "Visla Skill v260218-1410 completed"