← 返回 Skills 市场

gnview-script-extraction

Name: gnview-script-extraction
Author: gnview

作者 gnview · GitHub ↗ · v1.0.0 · MIT-0

cross-platform ⚠ suspicious

总下载

当前安装

版本数

在 OpenClaw 中安装

/install gnview-script-extraction

功能描述

本工具实现本地视频文件的上传与脚本分析，使用大模型支持对视频进行分析，同时支持自定义分析提示词，适配多种抖音/视频数据分析场景。

使用说明 (SKILL.md)

\r \r

触发词\r

当用户需要以下场景时，可调用此工具：\r

视频内容结构化分析\r \r

依赖要求\r

Python 3.7+\r
安装requests库：pip install requests\r
已获取API密钥（ARK_API_KEY）\r \r

使用方法\r

1. 上传本地视频\r

python3 scripts/script-extraction.py upload \x3C本地视频路径> \x3CARK_API_KEY>\r
```\r
**参数说明**：\r
- `本地视频路径`：待分析的本地MP4视频文件路径\r
- `ARK_API_KEY`：VolcEngine ARK平台的API访问密钥\r
\r
**返回结果**：成功上传后会输出视频文件ID（file_id），用于后续分析。\r
\r
### 2. 分析视频脚本\r
```bash\r
python3 scripts/script-extraction.py analyze \x3Cfile_id> \x3CARK_API_KEY> [--model \x3C模型名称>] [--prompt \x3C自定义提示词>]\r
```\r
**参数说明**：\r
- `file_id`：上传视频后获取的文件ID\r
- `ARK_API_KEY`：同上\r
- `--model`：可选，指定分析使用的大模型，默认值为`doubao-seed-2-0-lite-260215`\r
- `--prompt`：可选，自定义分析提示词，默认提示词为：\r
  ```\r
  请你描述下视频中的人物的一系列动作，以JSON格式输出开始时间（start_time）、结束时间（end_time）、事件（event）、是否危险（danger），请使用HH:mm:ss表示时间戳。\r
  ```\r
\r
**示例**：\r
```bash\r
# 使用默认模型和提示词分析\r
python3 scripts/script-extraction.py analyze v1-abc123 your-ark-key\r
\r
# 自定义提示词，提取视频台词和场景\r
python3 scripts/script-extraction.py analyze v1-abc123 your-ark-key --prompt "请提取视频中的所有台词和对应的场景描述"\r
\r
# 指定自定义模型\r
python3 scripts/script-extraction.py analyze v1-abc123 your-ark-key --model doubao-seed-2-0-pro-260215\r
```\r
\r
## 输出说明\r
- 上传成功：返回视频文件ID，可直接用于分析命令\r
- 分析成功：返回格式化的JSON结果，包含视频分析的结构化数据，如动作时间、事件描述、危险等级等。\r
\r
## 注意事项\r
1.  仅支持MP4格式的视频文件\r
2.  上传的视频文件大小需符合VolcEngine ARK的限制\r
3.  API密钥需妥善保管，避免泄露\r
4.  自定义提示词需符合大模型的输入格式要求

安全使用建议

What to consider before installing: - The script uploads your local MP4s to VolcEngine ARK (ark.cn-beijing.volces.com). Only install if you are comfortable sending those videos to that third-party service and its privacy policy. - The SKILL.md and script require an ARK API key, but the registry metadata does not declare this — the metadata should be updated. Treat this as a warning sign and prefer skills that declare required credentials explicitly. - The examples pass the API key as a CLI argument. That can expose the key via process listings (ps) or shell history. Prefer using a secure method (environment variable or a protected config file) and avoid pasting secrets on the command line. - Verify the endpoint and owner independently (homepage/source are missing). If you cannot confirm the skill author or the endpoint's legitimacy, avoid uploading sensitive videos. - The code appears straightforward (no obfuscated code) and performs only the described upload/analysis calls, but because the source and registry metadata are incomplete, proceed cautiously. If you need this functionality, ask the author to: (1) declare ARK_API_KEY in the skill metadata, (2) provide a homepage/source link, and (3) update instructions to accept credentials securely (env var or config) rather than as CLI args.

功能分析

Type: OpenClaw Skill Name: gnview-script-extraction Version: 1.0.0 The skill bundle provides a legitimate tool for uploading and analyzing video files using the VolcEngine ARK API. The Python script (scripts/script-extraction.py) implements standard API interactions with the official endpoint (ark.cn-beijing.volces.com) using the requests library, and the instructions in SKILL.md are consistent with the tool's stated functionality without any signs of malicious intent or prompt injection.

能力标签

requires-oauth-token

能力评估

ℹ Purpose & Capability

The name/description, SKILL.md, and the included Python script all describe uploading an MP4 and calling VolcEngine ARK endpoints to analyze video; the network endpoints used (ark.cn-beijing.volces.com) match that purpose. However, the registry metadata lists no required environment variables or primary credential while SKILL.md and the script require an ARK API key; this metadata omission is an inconsistency.

✓ Instruction Scope

Runtime instructions are narrowly scoped to: (a) open a local MP4 file, (b) POST it as form data to the ARK file upload endpoint, and (c) call the ARK responses endpoint with a JSON body including file_id and prompt. The script does not attempt to read other system files or unrelated environment variables.

✓ Install Mechanism

This is an instruction-only skill with one small Python script and a single dependency (requests). No installer, downloads, or archive extraction are used; risk from install mechanism is low.

⚠ Credentials

The SKILL.md and script clearly require a VolcEngine ARK API key (ARK_API_KEY). The registry metadata, however, declares no required environment variables or primary credential. Additionally, the documentation instructs passing the API key as a command-line argument, which can leak to process listings or shell history — this is a privacy/credential-handling concern. The number and scope of credentials (single ARK API key) is otherwise proportional to the stated purpose.

✓ Persistence & Privilege

The skill does not request always:true, does not install background components, and does not modify other skills or global agent configuration. It runs only when invoked.

如何使用

确保已安装 OpenClaw（本地或 Docker 部署）
在对话框中输入安装命令：/install gnview-script-extraction
安装完成后，直接呼叫该 Skill 的名称或使用 /gnview-script-extraction 触发
根据 Skill 的参数说明提供必要输入，即可获得结构化输出

版本历史

v1.0.0

- Major update: the skill now provides local video upload and script analysis using a large model, supporting custom prompts for various Douyin/video data analysis scenarios. - Added script scripts/script-extraction.py for uploading and analyzing local MP4 video files with API key authentication. - Removed legacy files: config.json and return-data/api/douyin/web/fetch_user_post_videos.json. - Updated documentation to describe new CLI usage for uploading and analyzing videos, prompt customization, and output formats. - Dependency requirements updated: Python 3.7+ and requests library.

元数据

Slug gnview-script-extraction

版本 1.0.0

许可证 MIT-0

累计安装 0

当前安装数 0

历史版本数 1

常见问题