ClawHub
Skill flagged — suspicious patterns detected

ClawHub Security flagged this skill as suspicious. Review the scan results before using.

jftech-open-pro-ptz-control

v1.0.0

面向开发者杰峰设备 API 工具，可支持设备状态、方向控制、一键遮蔽、变倍和聚焦、预置位及巡航计划管理功能等。触发词：云台控制、设备状态、方向转动、预置位、巡航计划、一键遮蔽。

⭐ 0· 27·0 current·0 all-time
by@jftech

Install

OpenClaw Prompt Flow

Install with OpenClaw

Best for remote or guided setup. Copy the exact prompt, then paste it into OpenClaw for jftech/jftech-open-pro-ptz-control.

Previewing Install & Setup.
Prompt PreviewInstall & Setup
Install the skill "jftech-open-pro-ptz-control" (jftech/jftech-open-pro-ptz-control) from ClawHub.
Skill page: https://clawhub.ai/jftech/jftech-open-pro-ptz-control
Keep the work scoped to this skill only.
After install, inspect the skill metadata and help me finish setup.
Use only the metadata you can verify from ClawHub; do not invent missing requirements.
Ask before making any broader environment changes.

Command Line

CLI Commands

Use the direct CLI path if you want to install manually and keep every step visible.

OpenClaw CLI

Bare skill slug

openclaw skills install jftech-open-pro-ptz-control

ClawHub CLI

Package manager switcher

npx clawhub@latest install jftech-open-pro-ptz-control
Security Scan
VirusTotalVirusTotal
Benign
View report →
OpenClawOpenClaw
Suspicious
medium confidence
ℹ
Purpose & Capability
The name/description (PTZ control for JF devices) aligns with the included Python script: the code implements device token retrieval, login, PTZ, mask, zoom/focus, preset and tour APIs against jftech endpoints. However, the registry metadata at the top of the package lists no required environment variables or primary credential while SKILL.md and the script clearly require sensitive credentials (JF_UUID, JF_APPKEY, JF_APPSECRET, JF_MOVECARD, etc.). That metadata mismatch is an incoherence.
!
Instruction Scope
SKILL.md instructs users to set environment variables and run the included Python script (scripts/jf_open_pro_ptz_control.py). Yet the SKILL.md security section states "不会执行本地代码" (will not execute local code), which is false because the instructions explicitly run local code. There are also contradictions inside SKILL.md about which variables are required (e.g., JF_SN shown as optional in one place and required in another). These mixed/contradictory instructions expand agent discretion and are misleading.
ℹ
Install Mechanism
There is no install spec (instruction-only) which keeps risk lower, but a Python script is included in the package and intended to be executed directly. No third-party downloads, package managers, or remote installers are used — the script runs local HTTPS requests. Presence of runnable code without an install step is acceptable but should be noted.
ℹ
Credentials
The environment variables requested (UUID, APPKEY, APPSECRET, MOVECARD, device SN, username/password, endpoint) are consistent with authenticating to a device cloud API and are proportionate to PTZ control. That said, the package metadata omitted declaring these required env vars; SKILL.md also inconsistently marks some variables as optional vs required. Because these are sensitive secrets (app secret, device password), the user should only provide them to a trusted source after verifying the code.
✓
Persistence & Privilege
The skill does not request permanent/always inclusion and does not modify other skills; model invocation is allowed (default) which is normal. No elevated persistence or system-wide changes are requested by the package.
What to consider before installing
This package appears to implement the claimed PTZ features, but there are clear internal inconsistencies you should resolve before trusting it: (1) the registry metadata does NOT list the environment variables the SKILL.md and script require — verify that the skill really comes from an official JFTech source; (2) SKILL.md wrongly claims "will not execute local code" while it instructs you to run the included Python script — treat this as a red flag and inspect the full script yourself; (3) confirm the API endpoints (api.jftechws.com / api-cn.jftech.com) and examine the rest of the script (the provided file was truncated in the package view) for any unexpected network hosts or obfuscated logic; (4) run in an isolated environment (container/VM) and avoid reusing production credentials — if you already supplied credentials to this skill, rotate them after verification. If you cannot confirm the publisher or inspect the entire script, consider not installing or only using read-only/non-sensitive credentials for testing.

Like a lobster shell, security has layers — review code before you run it.

latestvk97b8pee5x38few04h19f1438185nt6n
27downloads
0stars
1versions
Updated 22h ago
v1.0.0
MIT-0
@jftech
latest
Download

JF Open Pro PTZ Control

面向开发者杰峰设备云台控制工具 (Python)

支持设备状态查询、方向控制、一键遮蔽、变倍和聚焦、预置位及巡航计划管理功能。

🔒 安全说明

仅支持环境变量存储凭据

方式支持说明
环境变量✅ 支持不会在进程列表中暴露，不会执行本地代码
命令行参数❌ 不支持避免凭据泄露风险
配置文件❌ 不支持避免代码执行风险

🚀 快速开始

设置环境变量

export JF_UUID="your-uuid"              # 开放平台用户唯一标识
export JF_APPKEY="your-appkey"          # 开放平台应用 Key
export JF_APPSECRET="your-appsecret"    # 开放平台应用密钥
export JF_MOVECARD=5                    # 签名算法偏移量 (0-9)
export JF_SN="your-device-sn"           # 设备序列号
export JF_USERNAME="admin"              # 设备用户名（可选，默认：admin）
export JF_PASSWORD="your-password"      # 设备密码（可选）

使用技能

# 查询设备状态
python scripts/jf_open_pro_ptz_control.py status

# 云台方向控制（向上转动）
python scripts/jf_open_pro_ptz_control.py ptz --direction up --action start
# 停止转动
python scripts/jf_open_pro_ptz_control.py ptz --direction up --action stop

# 一键遮蔽（开启）
python scripts/jf_open_pro_ptz_control.py mask --enable true

# 一键遮蔽（关闭）
python scripts/jf_open_pro_ptz_control.py mask --enable false

# 变倍控制（放大）
python scripts/jf_open_pro_ptz_control.py zoom --zoom-command ZoomTile --action start
python scripts/jf_open_pro_ptz_control.py zoom --zoom-command ZoomTile --action stop

# 设置预置点
python scripts/jf_open_pro_ptz_control.py preset --preset-command set --id 1 --name "门口"

# 转到预置点
python scripts/jf_open_pro_ptz_control.py preset --preset-command goto --id 1

# 获取预置点列表
python scripts/jf_open_pro_ptz_control.py preset --preset-command list

# 添加巡航点
python scripts/jf_open_pro_ptz_control.py tour --tour-command add --tour-id 0 --preset-id 1

# 启动巡航
python scripts/jf_open_pro_ptz_control.py tour --tour-command start --tour-id 0

# 获取巡航列表
python scripts/jf_open_pro_ptz_control.py tour --tour-command list

📋 环境变量

变量名说明必需默认值
JF_UUID开放平台用户唯一标识是-
JF_APPKEY开放平台应用 Key是-
JF_APPSECRET开放平台应用密钥是-
JF_MOVECARD签名算法偏移量 (0-9)是-
JF_SN设备序列号是-
JF_USERNAME设备用户名否admin
JF_PASSWORD设备密码否-
JF_ENDPOINTAPI 端点否api.jftechws.com

🛠️ 功能

1. 设备状态查询

查询设备在线状态、休眠状态、认证状态、设备 WAN IP 等。

python scripts/jf_open_pro_ptz_control.py status

返回信息：

  • 设备在线状态（online/notfound）
  • 低功耗设备休眠状态
  • 认证状态
  • 设备 WAN IP

2. 方向控制 (PTZ)

云台支持 8 个方向转动：

方向参数值
上up
下down
左left
右right
左上leftup
左下leftdown
右上rightup
右下rightdown

使用示例：

# 开始向上转动（速度 5）
python scripts/jf_open_pro_ptz_control.py ptz --direction up --action start --step 5

# 停止转动
python scripts/jf_open_pro_ptz_control.py ptz --direction up --action stop

参数说明：

  • --direction: 方向（up/down/left/right/leftup/leftdown/rightup/rightdown）
  • --action: 动作（start/stop）
  • --step: 速度（1-8，1 最慢，8 最快，默认：5）

⚠️ 重要: 必须先发送 start 再发送 stop，建议间隔 500ms。如果不发送 stop，设备会一直转动到最大角度。

3. 一键遮蔽 (Mask)

开启后摄像头转至最下方然后转至最右侧，同时关闭视频预览和录像。

# 开启遮蔽
python scripts/jf_open_pro_ptz_control.py mask --enable true

# 关闭遮蔽
python scripts/jf_open_pro_ptz_control.py mask --enable false

4. 变倍和聚焦控制 (Zoom/Focus)

支持变倍（Zoom）和聚焦（Focus）操作：

功能参数值说明
变倍 -ZoomWide缩小（广角）
变倍 +ZoomTile放大（长焦）
聚焦 -FocusFar聚焦远处
聚焦 +FocusNear聚焦近处
光圈 -IrisSmall缩小光圈
光圈 +IrisLarge放大光圈

使用示例：

# 开始变倍 +（放大）
python scripts/jf_open_pro_ptz_control.py zoom --zoom-command ZoomTile --action start --step 8

# 停止
python scripts/jf_open_pro_ptz_control.py zoom --zoom-command ZoomTile --action stop

5. 预置位管理 (Preset)

预置点编号范围：1-255（建议不使用 200 以后的编号）

特殊预置点：

  • 100: 移动追踪守望位（追踪停止后自动回归）
  • 128: 自检回归预置点（设备重启或自检时回归）

操作类型：

操作参数值说明
设置预置点set将当前位置保存为预置点
删除预置点clear删除指定预置点
转到预置点goto云台转动到预置点位置
编辑预置点名name修改预置点名称
获取列表list获取所有预置点

使用示例：

# 设置预置点 1，名称为"门口"
python scripts/jf_open_pro_ptz_control.py preset --preset-command set --id 1 --name "门口"

# 转到预置点 1
python scripts/jf_open_pro_ptz_control.py preset --preset-command goto --id 1

# 删除预置点 1
python scripts/jf_open_pro_ptz_control.py preset --preset-command clear --id 1

# 编辑预置点名称
python scripts/jf_open_pro_ptz_control.py preset --preset-command name --id 1 --name "新名称"

# 获取预置点列表
python scripts/jf_open_pro_ptz_control.py preset --preset-command list

6. 巡航计划管理 (Tour)

巡航功能让设备在多个预置点之间自动循环巡视。

操作类型：

操作参数值说明
添加巡航点add往巡航线路添加预置点
删除巡航点delete从巡航线路删除预置点
启动巡航start开始自动巡航
停止巡航stop停止巡航
清除巡航线路clear清空整个巡航线路
获取列表list获取巡航配置

使用示例：

# 添加预置点 1 到巡航线路 0
python scripts/jf_open_pro_ptz_control.py tour --tour-command add --tour-id 0 --preset-id 1 --step 5

# 添加预置点 2 到巡航线路 0
python scripts/jf_open_pro_ptz_control.py tour --tour-command add --tour-id 0 --preset-id 2

# 启动巡航线路 0
python scripts/jf_open_pro_ptz_control.py tour --tour-command start --tour-id 0

# 停止巡航
python scripts/jf_open_pro_ptz_control.py tour --tour-command stop --tour-id 0

# 获取巡航配置
python scripts/jf_open_pro_ptz_control.py tour --tour-command list

📖 使用场景示例

场景 1: 基础云台控制

# 1. 检查设备状态
python scripts/jf_open_pro_ptz_control.py status

# 2. 向上转动
python scripts/jf_open_pro_ptz_control.py ptz --direction up --action start
sleep 1
python scripts/jf_open_pro_ptz_control.py ptz --direction up --action stop

# 3. 向右转动
python scripts/jf_open_pro_ptz_control.py ptz --direction right --action start
sleep 1
python scripts/jf_open_pro_ptz_control.py ptz --direction right --action stop

场景 2: 设置并使用预置位

# 1. 转动到目标位置
python scripts/jf_open_pro_ptz_control.py ptz --direction up --action start
sleep 1
python scripts/jf_open_pro_ptz_control.py ptz --direction up --action stop

# 2. 保存为预置点 1
python scripts/jf_open_pro_ptz_control.py preset --preset-command set --id 1 --name "门口"

# 3. 转动到其他位置...

# 4. 回到预置点 1
python scripts/jf_open_pro_ptz_control.py preset --preset-command goto --id 1

场景 3: 设置自动巡航

# 1. 设置多个预置点
python scripts/jf_open_pro_ptz_control.py preset --preset-command set --id 1 --name "位置 1"
python scripts/jf_open_pro_ptz_control.py preset --preset-command set --id 2 --name "位置 2"
python scripts/jf_open_pro_ptz_control.py preset --preset-command set --id 3 --name "位置 3"

# 2. 添加到巡航线路
python scripts/jf_open_pro_ptz_control.py tour --tour-command add --tour-id 0 --preset-id 1
python scripts/jf_open_pro_ptz_control.py tour --tour-command add --tour-id 0 --preset-id 2
python scripts/jf_open_pro_ptz_control.py tour --tour-command add --tour-id 0 --preset-id 3

# 3. 启动巡航
python scripts/jf_open_pro_ptz_control.py tour --tour-command start --tour-id 0

⚠️ 错误处理

错误码说明解决方案
2000成功-
4118连接超时设备离线/休眠，稍后重试
10001Token 无效重新获取 Token
10002设备未登录脚本会自动处理登录
526低电量/不支持设备电量不足或为固定摄像头

错误码 526 说明

含义： 设备支持云台，但电量过低无法执行

解决方案：

  1. 给设备充电
  2. 等待电量恢复至 20% 以上
  3. 使用电源供电模式

⚠️ 注意事项

  1. 设备需在线 - 操作前确保设备在线
  2. 设备需登录 - 脚本会自动处理设备登录
  3. PTZ 控制 - start/stop 指令需串行发送（间隔 500ms）
  4. 预置点范围 - 建议使用 1-199 编号
  5. 电量检查 - 低电量时云台功能可能被禁用

📚 官方参考资料

📁 脚本工具

# 获取帮助
python scripts/jf_open_pro_ptz_control.py --help

# 查询设备状态
python scripts/jf_open_pro_ptz_control.py status

# PTZ 方向控制
python scripts/jf_open_pro_ptz_control.py ptz --direction <方向> --action <start|stop>

# 一键遮蔽
python scripts/jf_open_pro_ptz_control.py mask --enable <true|false>

# 变倍聚焦
python scripts/jf_open_pro_ptz_control.py zoom --zoom-command <命令> --action <start|stop>

# 预置点管理
python scripts/jf_open_pro_ptz_control.py preset --preset-command <set|clear|goto|name|list> [选项]

# 巡航管理
python scripts/jf_open_pro_ptz_control.py tour --tour-command <add|delete|start|stop|clear|list> [选项]

脚本路径：scripts/jf_open_pro_ptz_control.py

技能版本： v1.0.0
语言： Python
最后更新： 2026-04-07

Comments

Loading comments...