ClawHub
Skill flagged — suspicious patterns detected

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

polyv-live-cli

v1.0.5

管理保利威直播服务，包括频道管理、推流操作、商品管理、优惠券、回放、文档和统计数据。当用户需要管理直播频道、配置推流设置、管理商品、处理优惠券、查看直播数据或管理回放录像时使用。

⭐ 0· 168·0 current·0 all-time
byNEE@terryso

Install

OpenClaw Prompt Flow

Install with OpenClaw

Best for remote or guided setup. Copy the exact prompt, then paste it into OpenClaw for terryso/polyv-live-cli.

Previewing Install & Setup.
Prompt PreviewInstall & Setup
Install the skill "polyv-live-cli" (terryso/polyv-live-cli) from ClawHub.
Skill page: https://clawhub.ai/terryso/polyv-live-cli
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

Canonical install target

openclaw skills install terryso/polyv-live-cli

ClawHub CLI

Package manager switcher

npx clawhub@latest install polyv-live-cli
Security Scan
VirusTotalVirusTotal
Benign
View report →
OpenClawOpenClaw
Suspicious
medium confidence
✓
Purpose & Capability
Name, description and the included reference docs consistently describe a CLI for managing Polyv (channels, streams, products, coupons, playback, stats, etc.). The commands shown (npx polyv-live-cli ...) match the stated purpose.
ℹ
Instruction Scope
The SKILL.md explicitly instructs the agent to run npx polyv-live-cli@latest commands and to prompt the user for AppID/AppSecret (or use env vars). All instructions stay within the domain of managing the Polyv service; there are no instructions to read unrelated host files or to exfiltrate data. However the runtime behavior includes obtaining and executing remote code via npx and collecting credentials from the user, which expands the runtime trust surface.
!
Install Mechanism
There is no bundled install spec, but the allowed-tools and all commands use 'npx polyv-live-cli@latest'. That causes npx to fetch and execute code from the npm registry at runtime. The skill metadata lists no homepage/source URL and the package origin is unknown — running @latest without validation is risky. Using npx is common for CLIs, but unpinned @latest execution and lack of a verifiable homepage/source is a notable risk.
ℹ
Credentials
The skill asks for AppID/AppSecret (and references POLYV_APP_ID / POLYV_APP_SECRET) which are appropriate for a live-management CLI. The manifest declares no required env vars, but the docs describe multiple authentication sources (CLI flags, env vars, session account, config directory). This is coherent, but users should be aware they will be asked to supply secrets and that the CLI stores credentials locally (references a ~/.npx polyv-live-cli@latest/ config path).
✓
Persistence & Privilege
The skill is instruction-only, always:false, and does not request persistent platform privileges. It does not attempt to modify other skills or global agent settings. The only persistence implied is the CLI's own credential/config storage on the host (described in docs), which is expected for a CLI tool.
What to consider before installing
This skill is internally consistent: it documents a CLI for Polyv live-management and tells the agent how to use it. Before installing/using it, consider the following: - The runtime instructions run 'npx polyv-live-cli@latest', which will fetch and execute code from npm (@latest) on demand. Fetching and running unreviewed remote packages is a security risk. Prefer to audit the npm package (check publisher, package page, repository, recent versions) before allowing execution. - The skill’s metadata lacks a homepage/source; that increases risk. If you need this functionality, prefer obtaining the official polyv-live-cli package from a verified source, pin a specific version (not @latest), or install it yourself and run locally. - The agent will ask for AppID/AppSecret (or accept env vars). Never paste high-privilege credentials into an agent you don't fully trust. If possible, use a scoped/test account with limited permissions, or supply credentials via secure CI secrets or an audited config file under your control. - If you allow the agent to run these commands, monitor the credential storage location (~/.npx polyv-live-cli@latest/ per docs) and rotate keys if you later suspect misuse. If you want, I can: (1) look up the npm package page and repository (if you provide the package name/URL), (2) produce a checklist of steps to safely run these commands locally instead of letting the agent run them, or (3) suggest safer alternatives (pinning version, manual install, running in isolated environment).

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

latestvk97fdvn2ghyr0va9xvc9ejqk5h83zymp
168downloads
0stars
5versions
Updated 3w ago
v1.0.5
MIT-0
NEE@terryso
latest
Download

保利威直播 CLI

执行前验证

在执行任何 CLI 命令之前，必须先验证账号认证状态。

1. 检测认证状态

npx polyv-live-cli@latest account list

2. 配置认证（如需要）

如果用户未配置认证，引导用户提供 AppID 和 AppSecret：

请提供你的保利威 AppID 和 AppSecret：
- 访问 https://www.polyv.net/ 后台获取
- 路径：云直播 -> 设置 -> 开发者信息

然后用用户提供的凭据配置：

npx polyv-live-cli@latest account add <名称> --app-id <appId> --app-secret <appSecret>
npx polyv-live-cli@latest account set-default <名称>

3. 验证配置成功

npx polyv-live-cli@latest channel list

快速开始

# 添加账号凭证
npx polyv-live-cli@latest account add myaccount --app-id <id> --app-secret <secret>

# 切换账号
npx polyv-live-cli@latest use myaccount

# 创建频道
npx polyv-live-cli@latest channel create -n "我的直播"

# 获取推流密钥（用于OBS）
npx polyv-live-cli@latest stream get-key -c <channelId>

# 开始直播
npx polyv-live-cli@latest stream start -c <channelId>

# 监控直播状态
npx polyv-live-cli@latest stream status -c <channelId> -w

身份认证

# 账号管理
npx polyv-live-cli@latest account add <名称> --app-id <id> --app-secret <secret>
npx polyv-live-cli@latest account list
npx polyv-live-cli@latest account set-default <名称>
npx polyv-live-cli@latest account remove <名称>

# 切换当前会话账号
npx polyv-live-cli@latest use <名称>

# 或使用内联凭证
npx polyv-live-cli@latest channel list --appId <id> --appSecret <secret>
npx polyv-live-cli@latest channel list -a <账号名称>

频道命令

# 增删改查操作
npx polyv-live-cli@latest channel create -n <名称> [-d <描述>] [--scene <场景类型>]
npx polyv-live-cli@latest channel list [-P <页码>] [-l <数量>] [--keyword <关键词>]
npx polyv-live-cli@latest channel get -c <频道ID>
npx polyv-live-cli@latest channel update -c <频道ID> [-n <名称>] [-d <描述>]
npx polyv-live-cli@latest channel delete -c <频道ID> [-f]
npx polyv-live-cli@latest channel batch-delete --channelIds <id1> <id2> ...

# 场景类型: topclass(大班课,默认) | alone(活动营销) | seminar(研讨会) | train(企业培训) | double(双师课,需开通) | guide(导播,需开通)
# 模板: ppt(三分屏-横屏,默认) | portrait_ppt(三分屏-竖屏) | alone(纯视频-横屏) | portrait_alone(纯视频-竖屏) | topclass(纯视频极速-横屏) | portrait_topclass(纯视频极速-竖屏) | seminar(研讨会)

推流命令

# 推流操作
npx polyv-live-cli@latest stream get-key -c <频道ID>        # 获取RTMP地址和推流密钥
npx polyv-live-cli@latest stream start -c <频道ID>          # 开始直播
npx polyv-live-cli@latest stream stop -c <频道ID>           # 结束直播
npx polyv-live-cli@latest stream status -c <频道ID> [-w]    # 查看状态（-w持续监控）
npx polyv-live-cli@latest stream push -c <频道ID> -f <文件> # 推送视频文件
npx polyv-live-cli@latest stream verify -c <频道ID> [-d 60] # 直播质量验证
npx polyv-live-cli@latest stream monitor -c <频道ID> [-r 5] # 实时监控面板

商品命令

# 商品管理
npx polyv-live-cli@latest product list -c <频道ID>
npx polyv-live-cli@latest product add -c <频道ID> --name <名称> --price <价格>
npx polyv-live-cli@latest product get -c <频道ID> -p <商品ID>
npx polyv-live-cli@latest product update -c <频道ID> -p <商品ID> [--name <名称>]
npx polyv-live-cli@latest product delete -c <频道ID> -p <商品ID>

优惠券命令

# 优惠券操作
npx polyv-live-cli@latest coupon add -c <频道ID> --name <名称> --type <类型> --discount <金额>
npx polyv-live-cli@latest coupon list -c <频道ID> [--status enabled|disabled]
npx polyv-live-cli@latest coupon delete -c <频道ID> --coupon-ids <id1> <id2>

# 优惠券类型: discount(折扣券), reduction(满减券)

回放命令

# 回放管理
npx polyv-live-cli@latest playback list -c <频道ID>
npx polyv-live-cli@latest playback get -c <频道ID> --video-id <回放ID>
npx polyv-live-cli@latest playback delete -c <频道ID> --video-id <回放ID>
npx polyv-live-cli@latest playback merge -c <频道ID> --file-ids <id1,id2,id3>

录制设置命令

# 回放设置管理
npx polyv-live-cli@latest record setting get -c <频道ID>
npx polyv-live-cli@latest record setting set -c <频道ID> [--playback-enabled Y|N] [--type single|list] [--origin playback|vod|record]

# 录制转存
npx polyv-live-cli@latest record convert -c <频道ID> --file-name <文件名> [--session-id <场次ID>] [--async]
npx polyv-live-cli@latest record set-default -c <频道ID> --video-id <视频ID> [--list-type playback|vod]

# origin 类型: playback(回放列表), vod(点播列表), record(录制文件)
# type 类型: single(单个回放), list(列表回放)

场次命令

# 场次管理
npx polyv-live-cli@latest session list [-c <频道ID>] [--page <页码>] [--page-size <数量>]
npx polyv-live-cli@latest session get -c <频道ID> --session-id <场次ID>

# 状态值: unStart(未开始), live(直播中), end(已结束), playback(回放中), expired(已过期)

文档命令

# 文档管理
npx polyv-live-cli@latest document list -c <频道ID> [--status <状态>] [--page <页码>] [--page-size <数量>]
npx polyv-live-cli@latest document upload -c <频道ID> --url <文件URL> [--type common|animate] [--doc-name <名称>]
npx polyv-live-cli@latest document delete -c <频道ID> --file-id <文档ID> [--type old|new] [--force]
npx polyv-live-cli@latest document status -c <频道ID> --file-id <文档ID>

# 状态值: normal, waitUpload, failUpload, waitConvert, failConvert
# 类型: common(普通转换), animate(动效转换)

统计命令

# 查看每日观看统计
npx polyv-live-cli@latest statistics view -c <频道ID> --start-day 2024-01-01 --end-day 2024-01-31

# 查看历史并发数据
npx polyv-live-cli@latest statistics concurrency -c <频道ID> --start-date 2024-01-01 --end-date 2024-01-31

# 查看历史最高并发人数
npx polyv-live-cli@latest statistics max-concurrent -c <频道ID> --start-time 1704067200000 --end-time 1735689600000

# 查看观众统计
npx polyv-live-cli@latest statistics audience device -c <频道ID>    # 设备分布
npx polyv-live-cli@latest statistics audience region -c <频道ID>    # 地区分布

# 导出统计数据
npx polyv-live-cli@latest statistics export -c <频道ID> -f csv -o report.csv

播放器命令

# 播放器配置
npx polyv-live-cli@latest player config get -c <频道ID>
npx polyv-live-cli@latest player config update -c <频道ID> [--autoplay] [--logo <url>]

场景初始化

# 预设场景
npx polyv-live-cli@latest setup --list                    # 列出可用场景
npx polyv-live-cli@latest setup e-commerce                # 电商直播场景
npx polyv-live-cli@latest setup education                 # 在线教育场景

监控命令

# 直播监控面板
npx polyv-live-cli@latest monitor start -c <频道ID>
npx polyv-live-cli@latest monitor stop

聊天消息命令

# 发送管理员消息
npx polyv-live-cli@latest chat send -c <频道ID> -m <文本消息>
npx polyv-live-cli@latest chat send -c <频道ID> -i <图片URL>
npx polyv-live-cli@latest chat send -c <频道ID> -m <消息> -n <昵称> -a <角色>

# 查看聊天历史
npx polyv-live-cli@latest chat list -c <频道ID>
npx polyv-live-cli@latest chat list -c <频道ID> --page <页码> --size <数量>
npx polyv-live-cli@latest chat list -c <频道ID> --start-day <开始日期> --end-day <结束日期>

# 删除消息
npx polyv-live-cli@latest chat delete -c <频道ID> -m <消息ID>
npx polyv-live-cli@latest chat delete -c <频道ID> --clear  # 清空所有消息

禁言踢人命令 (Story 11-2)

# 禁言用户（频道级别）
npx polyv-live-cli@latest chat ban -c <频道ID> -u <用户ID1,用户ID2>
npx polyv-live-cli@latest chat ban -c <频道ID> -u <用户ID> -o json

# 全局禁言（账号级别）
npx polyv-live-cli@latest chat ban -u <用户ID1,用户ID2> --global

# 解除禁言
npx polyv-live-cli@latest chat unban -c <频道ID> -u <用户ID1,用户ID2>
npx polyv-live-cli@latest chat unban -u <用户ID1,用户ID2> --global

# 踢人（频道级别）
npx polyv-live-cli@latest chat kick -c <频道ID> -v <观众ID1,观众ID2> -n <昵称1,昵称2>
npx polyv-live-cli@latest chat kick -c <频道ID> -v <观众ID> -o json

# 全局踢人（账号级别）
npx polyv-live-cli@latest chat kick -v <观众ID1> -n <昵称1> --global

# 解除踢人
npx polyv-live-cli@latest chat unkick -c <频道ID> -v <观众ID1> -n <昵称1>
npx polyv-live-cli@latest chat unkick -v <观众ID1> --global

# 查看禁言列表
npx polyv-live-cli@latest chat banned list -c <频道ID> --type userId  # 禁言用户列表
npx polyv-live-cli@latest chat banned list -c <频道ID> --type ip      # 禁言IP列表
npx polyv-live-cli@latest chat banned list -c <频道ID> --type badword # 禁言词列表

# 查看踢人列表
npx polyv-live-cli@latest chat kicked list -c <频道ID>
npx polyv-live-cli@latest chat kicked list -c <频道ID> -o json

签到管理命令 (Story 11-3)

# 发起签到
npx polyv-live-cli@latest checkin start -c <频道ID>
npx polyv-live-cli@latest checkin start -c <频道ID> --limit-time 30          # 设置签到时长30秒
npx polyv-live-cli@latest checkin start -c <频道ID> --delay-time 1700734800000  # 定时签到
npx polyv-live-cli@latest checkin start -c <频道ID> --message "请签到"       # 自定义签到提示语
npx polyv-live-cli@latest checkin start -c <频道ID> --force                  # 强制签到模式

# 查询签到成功记录
npx polyv-live-cli@latest checkin list -c <频道ID>
npx polyv-live-cli@latest checkin list -c <频道ID> --page 1 --size 20        # 分页查询
npx polyv-live-cli@latest checkin list -c <频道ID> --date 2024-01-15         # 按日期筛选
npx polyv-live-cli@latest checkin list -c <频道ID> --session-id <场次ID>     # 按场次筛选

# 查询签到详情（包括已签到和未签到）
npx polyv-live-cli@latest checkin result -c <频道ID> --checkin-id <签到ID>
npx polyv-live-cli@latest checkin result -c <频道ID> --checkin-id <签到ID> -o json

# 查询签到发起记录（按时间范围）
npx polyv-live-cli@latest checkin sessions -c <频道ID>
npx polyv-live-cli@latest checkin sessions -c <频道ID> --start-date 2024-01-01 --end-date 2024-01-31
npx polyv-live-cli@latest checkin sessions -c <频道ID> -o json

问答管理命令 (Story 11-4)

# 发送问答卡（答题卡）
npx polyv-live-cli@latest qa send -c <频道ID> --question-id <问题ID>
npx polyv-live-cli@latest qa send -c <频道ID> --question-id <问题ID> --duration 30      # 设置答题时长30秒
npx polyv-live-cli@latest qa send -c <频道ID> --question-id <问题ID> -o json            # JSON格式输出

# 查询问答卡列表
npx polyv-live-cli@latest qa list -c <频道ID>
npx polyv-live-cli@latest qa list -c <频道ID> -o json                        # JSON格式输出

# 停止问答卡
npx polyv-live-cli@latest qa stop -c <频道ID> --question-id <问题ID>
npx polyv-live-cli@latest qa stop -c <频道ID> --question-id <问题ID> -o json            # JSON格式输出（含统计数据）

问卷管理命令 (Story 11-4)

# 创建问卷
npx polyv-live-cli@latest questionnaire create -c <频道ID> --title <问卷标题> --questions '<JSON数组>'
npx polyv-live-cli@latest questionnaire create -c 3151318 --title "满意度调查" --questions '[{"name":"性别","type":"R","options":["男","女"],"required":"Y"}]'

# 问卷题型类型: R=单选, C=多选, Q=填空, J=判断, X=评分
# 创建带自定义ID的问卷
npx polyv-live-cli@latest questionnaire create -c <频道ID> --title <标题> --questions '<JSON>' --custom-questionnaire-id <自定义ID>

# 查询问卷列表
npx polyv-live-cli@latest questionnaire list -c <频道ID>
npx polyv-live-cli@latest questionnaire list -c <频道ID> --page 1 --size 20  # 分页查询
npx polyv-live-cli@latest questionnaire list -c <频道ID> --session-id <场次ID>  # 按场次筛选
npx polyv-live-cli@latest questionnaire list -c <频道ID> --start-date 2024-01-01 --end-date 2024-01-31  # 日期范围

# 获取问卷详情
npx polyv-live-cli@latest questionnaire detail -c <频道ID> --questionnaire-id <问卷ID>
npx polyv-live-cli@latest questionnaire detail -c <频道ID> --questionnaire-id <问卷ID> -o json  # JSON格式输出

抽奖管理命令 (Story 11-5)

# 创建抽奖活动
npx polyv-live-cli@latest lottery create -c <频道ID> --name <抽奖名称> --type <类型> --amount <中奖人数> --prize <奖品名称>
npx polyv-live-cli@latest lottery create -c 3151318 --name "幸运抽奖" --type none --amount 3 --prize "神秘礼品"  # 无条件抽奖
npx polyv-live-cli@latest lottery create -c 3151318 --name "邀请抽奖" --type invite --amount 5 --prize "优惠券" --invite-num 3  # 邀请抽奖
npx polyv-live-cli@latest lottery create -c 3151318 --name "时长抽奖" --type duration --amount 2 --prize "红包" --duration 10  # 观看时长抽奖

# 抽奖类型: none=无条件, invite=邀请好友, duration=观看时长, comment=发表评论, question=回答问题

# 查询抽奖活动列表
npx polyv-live-cli@latest lottery list -c <频道ID>
npx polyv-live-cli@latest lottery list -c <频道ID> --page 1 --size 20  # 分页查询
npx polyv-live-cli@latest lottery list -c <频道ID> -o json  # JSON格式输出

# 获取抽奖活动详情
npx polyv-live-cli@latest lottery get -c <频道ID> --id <抽奖活动ID>

# 更新抽奖活动
npx polyv-live-cli@latest lottery update -c <频道ID> --id <抽奖活动ID> --name <新名称> --amount <新人数>

# 删除抽奖活动
npx polyv-live-cli@latest lottery delete -c <频道ID> --id <抽奖活动ID>

# 查询中奖用户
npx polyv-live-cli@latest lottery winners -c <频道ID> --lottery-id <抽奖ID>
npx polyv-live-cli@latest lottery winners -c <频道ID> --lottery-id <抽奖ID> --page 1 --limit 20  # 分页查询

# 查询抽奖记录
npx polyv-live-cli@latest lottery records -c <频道ID>
npx polyv-live-cli@latest lottery records -c <频道ID> --session-id <场次ID>  # 按场次筛选
npx polyv-live-cli@latest lottery records -c <频道ID> --start-time <时间戳> --end-time <时间戳>  # 按时间范围

打赏管理命令 (Story 11-6)

# 获取打赏配置
npx polyv-live-cli@latest donate config get -c <频道ID>
npx polyv-live-cli@latest donate config get -c 3151318 -o json  # JSON格式输出

# 更新打赏配置
npx polyv-live-cli@latest donate config update -c <频道ID> --cash-enabled Y  # 启用现金打赏
npx polyv-live-cli@latest donate config update -c <频道ID> --gift-enabled Y  # 启用礼物打赏
npx polyv-live-cli@latest donate config update -c <频道ID> --tips "感谢支持!"  # 设置打赏提示语
npx polyv-live-cli@latest donate config update -c <频道ID> --amounts "0.88,6.66,8.88,18.88"  # 设置打赏金额

# 查询打赏记录
npx polyv-live-cli@latest donate list -c <频道ID> --start <开始时间戳> --end <结束时间戳>
npx polyv-live-cli@latest donate list -c 3151318 --start 1615772426000 --end 1615858826000
npx polyv-live-cli@latest donate list -c 3151318 --start 1615772426000 --end 1615858826000 --page 2 --size 20  # 分页
npx polyv-live-cli@latest donate list -c 3151318 --start 1615772426000 --end 1615858826000 -o json  # JSON格式

观众信息查询命令 (Story 12-1)

# 获取单个观众详情
npx polyv-live-cli@latest viewer get -v <观众ID>
npx polyv-live-cli@latest viewer get -v "2_v378gn997yovtl3p8h77db9e224t6hg9" -o json  # JSON格式输出

# 列出观众列表
npx polyv-live-cli@latest viewer list
npx polyv-live-cli@latest viewer list --page 1 --size 20  # 分页查询
npx polyv-live-cli@latest viewer list --source IMPORT      # 按来源过滤（IMPORT/WX/MOBILE）
npx polyv-live-cli@latest viewer list --mobile "13800138000"  # 按手机号过滤
npx polyv-live-cli@latest viewer list --email "user@example.com"  # 按邮箱过滤
npx polyv-live-cli@latest viewer list --area "北京"  # 按地址过滤
npx polyv-live-cli@latest viewer list --source WX -o json  # JSON格式输出

观众标签管理命令 (Story 12-2)

# 列出所有标签
npx polyv-live-cli@latest viewer tag list

# 搜索标签
npx polyv-live-cli@latest viewer tag list --keyword "VIP"

# 分页查询
npx polyv-live-cli@latest viewer tag list --page 1 --size 20

# JSON格式输出
npx polyv-live-cli@latest viewer tag list -o json

# 为观众添加标签（单个观众+单个标签）
npx polyv-live-cli@latest viewer tag add -v "viewer1" -l 1

# 为观众添加多个标签
npx polyv-live-cli@latest viewer tag add -v "viewer1" -l 1,2,3

# 批量为多个观众添加标签
npx polyv-live-cli@latest viewer tag add -v "viewer1,viewer2,viewer3" -l 1,2

# JSON格式输出
npx polyv-live-cli@latest viewer tag add -v "viewer1" -l 1 -o json

# 移除观众的标签（单个观众+单个标签）
npx polyv-live-cli@latest viewer tag remove -v "viewer1" -l 1

# 移除观众的多个标签
npx polyv-live-cli@latest viewer tag remove -v "viewer1" -l 1,2,3

# 批量移除多个观众的标签
npx polyv-live-cli@latest viewer tag remove -v "viewer1,viewer2" -l 1,2

# JSON格式输出
npx polyv-live-cli@latest viewer tag remove -v "viewer1" -l 1 -o json

观看条件配置命令 (Story 12-3)

# 获取观看条件配置
npx polyv-live-cli@latest watch-condition get                  # 获取全局设置
npx polyv-live-cli@latest watch-condition get --channel-id <频道ID>  # 获取频道设置
npx polyv-live-cli@latest watch-condition get --channel-id 3151318 -o json  # JSON格式输出

# 简单设置：关闭观看条件（公开观看）
npx polyv-live-cli@latest watch-condition set --channel-id <频道ID> --rank 1 --auth-type none --enabled Y

# 简单设置：密码观看
npx polyv-live-cli@latest watch-condition set --channel-id <频道ID> --rank 1 --auth-type code --enabled Y --auth-code "abc123"

# 简单设置：付费观看（价格单位：元）
npx polyv-live-cli@latest watch-condition set --channel-id <频道ID> --rank 1 --auth-type pay --enabled Y --price 99.9

# 复杂设置：使用 JSON 配置文件（支持多个条件和完整参数）
npx polyv-live-cli@latest watch-condition set --channel-id <频道ID> --config ./watch-condition.json

# 设置全局观看条件（不传频道ID）
npx polyv-live-cli@latest watch-condition set --rank 1 --auth-type none --enabled N

# 认证类型: none=无限制, code=密码观看, pay=付费观看, phone=白名单观看, info=登记观看, custom=自定义授权, external=外部授权, direct=独立授权
# 条件级别: rank 1=主要条件, rank 2=次要条件
# 启用状态: enabled Y=启用, N=禁用

JSON 配置文件格式示例 (watch-condition.json):

{
  "authSettings": [
    {
      "rank": 1,
      "enabled": "Y",
      "authType": "code",
      "authCode": "abc123"
    },
    {
      "rank": 2,
      "enabled": "N"
    }
  ]
}

白名单管理命令 (Story 12-4)

# 列出白名单
npx polyv-live-cli@latest whitelist list --rank 1                          # 获取全局白名单
npx polyv-live-cli@latest whitelist list --channel-id <频道ID> --rank 1    # 获取频道白名单
npx polyv-live-cli@latest whitelist list --channel-id 3151318 --rank 1 --page 1 --page-size 20  # 分页
npx polyv-live-cli@latest whitelist list --channel-id 3151318 --rank 1 --keyword "张三"  # 搜索
npx polyv-live-cli@latest whitelist list --channel-id 3151318 --rank 1 -o json  # JSON格式输出

# 添加白名单
npx polyv-live-cli@latest whitelist add --rank 1 --code "13800138000" --name "张三"  # 全局白名单
npx polyv-live-cli@latest whitelist add --channel-id <频道ID> --rank 1 --code "13800138000" --name "张三"  # 频道白名单
npx polyv-live-cli@latest whitelist add --rank 1 --code "13800138000" -o json  # JSON格式输出

# 更新白名单
npx polyv-live-cli@latest whitelist update --rank 1 --old-code "13800138000" --code "13900139000" --name "李四"  # 全局
npx polyv-live-cli@latest whitelist update --channel-id <频道ID> --rank 1 --old-code "13800138000" --code "13900139000" --name "李四"  # 频道
npx polyv-live-cli@latest whitelist update --rank 1 --old-code "13800138000" --code "13900139000" -o json  # JSON格式输出

# 删除白名单
npx polyv-live-cli@latest whitelist remove --rank 1 --codes "13800138000"  # 删除单个（全局）
npx polyv-live-cli@latest whitelist remove --channel-id <频道ID> --rank 1 --codes "13800138000,13900139000"  # 批量删除
npx polyv-live-cli@latest whitelist remove --channel-id <频道ID> --rank 1 --clear  # 清空所有白名单
npx polyv-live-cli@latest whitelist remove --rank 1 --codes "13800138000" -o json  # JSON格式输出

# 条件级别: rank 1=主要条件, rank 2=次要条件
# 不传 --channel-id 为全局设置，传 --channel-id 为频道级别设置

平台账号信息管理命令 (Story 13-1)

# 获取账号基本信息（用户ID、邮箱、频道数等）
npx polyv-live-cli@latest platform get
npx polyv-live-cli@latest platform get -o json  # JSON格式输出

# 获取账号开关配置（全局设置、认证、录制等开关状态）
npx polyv-live-cli@latest platform switch get
npx polyv-live-cli@latest platform switch get -o json  # JSON格式输出

# 更新账号开关配置
npx polyv-live-cli@latest platform switch update --param authEnabled --enabled Y      # 启用认证
npx polyv-live-cli@latest platform switch update --param recordEnabled --enabled N    # 禁用录制
npx polyv-live-cli@latest platform switch update --param authEnabled --enabled Y -o json  # JSON格式输出

# 可用开关参数:
# - globalSettingEnabled: 全局设置开关
# - authEnabled: 认证开关
# - recordEnabled: 录制开关
# - playbackEnabled: 回放开关
# - danmuEnabled: 弹幕开关

回调设置管理命令 (Story 13-2)

# 获取回调设置（回调URL和启用状态）
npx polyv-live-cli@latest platform callback get
npx polyv-live-cli@latest platform callback get -o json  # JSON格式输出

# 更新回调设置
npx polyv-live-cli@latest platform callback update --url https://example.com/callback  # 更新回调URL
npx polyv-live-cli@latest platform callback update --enabled Y                          # 启用回调
npx polyv-live-cli@latest platform callback update --url https://example.com/callback --enabled Y  # 同时更新
npx polyv-live-cli@latest platform callback update --url https://example.com/callback -o json  # JSON格式输出

全局频道设置管理

管理账号级别的全局频道设置，包括并发人数、转码、打赏等功能开关。

# 获取全局频道设置
npx polyv-live-cli@latest platform setting get
npx polyv-live-cli@latest platform setting get -o json  # JSON格式输出

# 更新全局频道设置
npx polyv-live-cli@latest platform setting update --channel-concurrences-enabled Y  # 启用最大并发人数
npx polyv-live-cli@latest platform setting update --timely-convert-enabled N         # 禁用自动转码
npx polyv-live-cli@latest platform setting update --donate-enabled Y                 # 启用打赏功能
npx polyv-live-cli@latest platform setting update --cover-img-type contain           # 设置封面类型

# 同时更新多个设置
npx polyv-live-cli@latest platform setting update \
  --channel-concurrences-enabled Y \
  --timely-convert-enabled Y \
  --donate-enabled N \
  -o json  # JSON格式输出

可用参数

参数说明值
--channel-concurrences-enabled最大并发观看人数开关Y/N
--timely-convert-enabled自动转码开关Y/N
--donate-enabled打赏功能开关Y/N
--rebirth-auto-upload-enabled转存自动上传PPTY/N
--rebirth-auto-convert-enabled转存自动转码Y/N
--ppt-covered-enabledPPT全屏开关Y/N
--cover-img-type封面图片类型contain/cover
--test-mode-button-enabled测试模式按钮Y/N

转播管理命令 (Story 14-3)

# 批量创建转播频道
npx polyv-live-cli@latest transmit create -c <频道ID> --names "频道1,频道2,频道3"
npx polyv-live-cli@latest transmit create -c 3151318 --names "转播1,转播2,转播3" -o json

# 获取转播关联列表
npx polyv-live-cli@latest transmit list -c <频道ID>
npx polyv-live-cli@latest transmit list -c 3151318 -o json

# 最多支持一次创建100个转播频道
# -o table 为默认表格格式, -o json 为JSON格式输出

卡片推送命令 (Story 14-2)

# 列出卡片配置
npx polyv-live-cli@latest card-push list -c <频道ID>
npx polyv-live-cli@latest card-push list -c 3151318 -o json

# 创建卡片配置
npx polyv-live-cli@latest card-push create -c <频道ID> --image-type <类型> --title <标题> --link <链接> --duration <秒数> --show-condition PUSH|WATCH
npx polyv-live-cli@latest card-push create -c 3151318 --image-type giftbox --title "限时优惠" --link "https://example.com" --duration 10 --show-condition PUSH

# 定时弹出卡片（观看时长触发）
npx polyv-live-cli@latest card-push create -c 3151318 --image-type redpack --title "新手红包" --link "https://example.com" --duration 15 --show-condition WATCH --condition-value 30 --condition-unit SECONDS

# 更新卡片配置
npx polyv-live-cli@latest card-push update -c <频道ID> --card-push-id <卡片ID> --title <新标题>
npx polyv-live-cli@latest card-push update -c 3151318 --card-push-id 123 --duration 20

# 推送卡片
npx polyv-live-cli@latest card-push push -c <频道ID> --card-push-id <卡片ID>

# 取消推送
npx polyv-live-cli@latest card-push cancel -c <频道ID> --card-push-id <卡片ID>

# 删除卡片配置
npx polyv-live-cli@latest card-push delete -c <频道ID> --card-push-id <卡片ID>

# image-type: giftbox(礼盒), redpack(红包), custom(自定义)
# show-condition: PUSH(手动推送), WATCH(观看时长触发)
# card-type: common(普通), qrCode(二维码)

输出格式

大多数命令支持 -o table（默认表格格式）或 -o json（JSON格式，便于程序化处理）。

npx polyv-live-cli@latest channel list -o json
npx polyv-live-cli@latest stream status -c <频道ID> -o json

全局选项

--appId <id>           # 保利威应用ID
--appSecret <secret>   # 保利威应用密钥
--userId <id>          # 保利威用户ID（可选）
-a, --account <名称>   # 使用指定账号
--verbose              # 显示详细信息
--debug                # 启用调试模式
--timeout <毫秒>       # API超时时间（默认30000毫秒）

常用工作流程

创建并开始直播

npx polyv-live-cli@latest use myaccount
npx polyv-live-cli@latest channel create -n "新品发布会" -d "新品展示直播"
# 记住输出的频道ID
npx polyv-live-cli@latest stream get-key -c 3151318
# 在OBS中使用RTMP地址和推流密钥
npx polyv-live-cli@latest stream start -c 3151318
npx polyv-live-cli@latest stream status -c 3151318 -w

初始化电商直播场景

npx polyv-live-cli@latest setup e-commerce
# 自动创建带商品预配置的频道

监控直播质量

npx polyv-live-cli@latest stream verify -c 3151318 -d 120 -i 5
npx polyv-live-cli@latest stream monitor -c 3151318 -r 3 --alerts

详细文档

联系方式

Comments

Loading comments...