← 返回 Skills 市场
🔌

jftech-open-pro-ptz-control

作者 jftech · GitHub ↗ · v1.0.0 · MIT-0
cross-platform ⚠ suspicious
47
总下载
0
收藏
0
当前安装
1
版本数
在 OpenClaw 中安装
/install jftech-open-pro-ptz-control
功能描述
面向开发者杰峰设备 API 工具，可支持设备状态、方向控制、一键遮蔽、变倍和聚焦、预置位及巡航计划管理功能等。触发词：云台控制、设备状态、方向转动、预置位、巡航计划、一键遮蔽。
使用说明 (SKILL.md)

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_ENDPOINT API 端点 否 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 连接超时 设备离线/休眠，稍后重试
10001 Token 无效 重新获取 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 \x3C方向> --action \x3Cstart|stop>

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

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

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

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

脚本路径：scripts/jf_open_pro_ptz_control.py

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

安全使用建议
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.
功能分析
Type: OpenClaw Skill Name: jftech-open-pro-ptz-control Version: 1.0.0 The skill bundle provides a Python tool for controlling JFTech PTZ cameras via their official API (api.jftechws.com and api-cn.jftech.com). The script jf_open_pro_ptz_control.py implements standard API interactions, including signature calculation, token acquisition, and device control commands. It follows security best practices by using environment variables for credentials and lacks any indicators of data exfiltration, persistence, or malicious intent.
能力评估
ℹ 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.
如何使用
  1. 确保已安装 OpenClaw（本地或 Docker 部署）
  2. 在对话框中输入安装命令：/install jftech-open-pro-ptz-control
  3. 安装完成后，直接呼叫该 Skill 的名称或使用 /jftech-open-pro-ptz-control 触发
  4. 根据 Skill 的参数说明提供必要输入，即可获得结构化输出
版本历史
v1.0.0
Initial release of jf-open-pro-ptz-control. - Provides command-line Python tools for PTZ control on JieFeng devices: device status, direction control, masking, zoom/focus, preset, and tour management. - All credentials are set via environment variables for security; config files and CLI params are not supported. - Supports both international and mainland China API endpoints. - Detailed usage instructions and parameter lists are provided for all supported features. - Sample usage scenarios included for fast start and common PTZ workflow reference.
元数据
Slug jftech-open-pro-ptz-control
版本 1.0.0
许可证 MIT-0
累计安装 0
当前安装数 0
历史版本数 1
常见问题

jftech-open-pro-ptz-control 是什么？

面向开发者杰峰设备 API 工具，可支持设备状态、方向控制、一键遮蔽、变倍和聚焦、预置位及巡航计划管理功能等。触发词：云台控制、设备状态、方向转动、预置位、巡航计划、一键遮蔽。 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件，目前累计下载 47 次。

如何安装 jftech-open-pro-ptz-control？

在 OpenClaw 或 Claude Code 对话框中运行命令「/install jftech-open-pro-ptz-control」即可一键安装，无需额外配置。

jftech-open-pro-ptz-control 是免费的吗？

是的，jftech-open-pro-ptz-control 完全免费，采用 MIT-0 许可证，可自由下载、安装和使用。

jftech-open-pro-ptz-control 支持哪些平台？

jftech-open-pro-ptz-control 跨平台运行，可在任意部署了 OpenClaw / Claude Code 的环境中使用（cross-platform）。

谁开发了 jftech-open-pro-ptz-control？

由 jftech（@jftech）开发并维护，当前版本 v1.0.0。

推荐 Skills
self-improving agent
Captures learnings, errors, and corrections to enable continuous improvement. Use when: (1) A command or operation fails unexpectedly, (2) User corrects Clau...
⬇ 463283 · by pskoett
Skill Vetter
Security-first skill vetting for AI agents. Use before installing any skill from ClawdHub, GitHub, or other sources. Checks for red flags, permission scope, and suspicious patterns.
⬇ 259410 · by spclaudehome
Polymarket
Query Polymarket prediction markets. Check odds, find trending markets, search events, track price movements.
⬇ 232503 · by joelchance
Self-Improving + Proactive Agent
Self-reflection + Self-criticism + Self-learning + Self-organizing memory. Agent evaluates its own work, catches mistakes, and improves permanently. Use when...
⬇ 200423 · by ivangdavila
Github
Interact with GitHub using the `gh` CLI. Use `gh issue`, `gh pr`, `gh run`, and `gh api` for issues, PRs, CI runs, and advanced queries.
⬇ 191115 · by steipete
ontology
Typed knowledge graph for structured agent memory and composable skills. Use when creating/querying entities (Person, Project, Task, Event, Document), linkin...
⬇ 190156 · by oswalpalash

💬 留言讨论