{"id":47619173,"url":"https://github.com/terryso/polyv-live-cli","last_synced_at":"2026-04-01T21:53:43.035Z","repository":{"id":303048633,"uuid":"1014237272","full_name":"terryso/polyv-live-cli","owner":"terryso","description":"Agent-First 设计的保利威直播管理命令行工具","archived":false,"fork":false,"pushed_at":"2026-03-31T06:58:24.000Z","size":5882,"stargazers_count":31,"open_issues_count":0,"forks_count":5,"subscribers_count":0,"default_branch":"develop","last_synced_at":"2026-03-31T08:50:17.004Z","etag":null,"topics":["agent-first","bmad","bmad-method","cli","polyv-live-cli","skill"],"latest_commit_sha":null,"homepage":"https://help.polyv.net/#/live/api/","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/terryso.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-07-05T10:12:14.000Z","updated_at":"2026-03-31T06:58:23.000Z","dependencies_parsed_at":"2026-03-21T12:15:51.544Z","dependency_job_id":null,"html_url":"https://github.com/terryso/polyv-live-cli","commit_stats":null,"previous_names":["terryso/polyv-live-cli"],"tags_count":48,"template":false,"template_full_name":null,"purl":"pkg:github/terryso/polyv-live-cli","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/terryso%2Fpolyv-live-cli","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/terryso%2Fpolyv-live-cli/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/terryso%2Fpolyv-live-cli/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/terryso%2Fpolyv-live-cli/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/terryso","download_url":"https://codeload.github.com/terryso/polyv-live-cli/tar.gz/refs/heads/develop","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/terryso%2Fpolyv-live-cli/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31292611,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-01T21:15:39.731Z","status":"ssl_error","status_checked_at":"2026-04-01T21:15:34.046Z","response_time":53,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["agent-first","bmad","bmad-method","cli","polyv-live-cli","skill"],"created_at":"2026-04-01T21:53:42.023Z","updated_at":"2026-04-01T21:53:43.021Z","avatar_url":"https://github.com/terryso.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# PolyV Live CLI\n\n\u003cdiv\u003e\n\n[![Node Version](https://img.shields.io/node/v/polyv-live-cli?style=flat-square\u0026color=brightgreen)](https://nodejs.org/)\n[![NPM Version](https://badge.fury.io/js/polyv-live-cli.svg)](https://www.npmjs.com/package/polyv-live-cli)\n[![NPM Downloads](https://img.shields.io/npm/dm/polyv-live-cli.svg)](https://www.npmjs.com/package/polyv-live-cli)\n[![codecov](https://codecov.io/gh/terryso/polyv-live-cli/branch/develop/graph/badge.svg?token=066bc852-c6e9-4a49-b283-662c2f2d839f)](https://codecov.io/gh/terryso/polyv-live-cli)\n[![BMAD](https://bmad-badge.vercel.app/terryso/polyv-live-cli.svg)](https://github.com/bmad-code-org/BMAD-METHOD)\n[![zread](https://img.shields.io/badge/Ask_Zread-_.svg?style=flat\u0026color=00b0aa\u0026labelColor=000000\u0026logo=data%3Aimage%2Fsvg%2Bxml%3Bbase64%2CPHN2ZyB3aWR0aD0iMTYiIGhlaWdodD0iMTYiIHZpZXdCb3g9IjAgMCAxNiAxNiIgZmlsbD0ibm9uZSIgeG1sbnM9Imh0dHA6Ly93d3cudzMub3JnLzIwMDAvc3ZnIj4KPHBhdGggZD0iTTQuOTYxNTYgMS42MDAxSDIuMjQxNTZDMS44ODgxIDEuNjAwMSAxLjYwMTU2IDEuODg2NjQgMS42MDE1NiAyLjI0MDFWNC45NjAxQzEuNjAxNTYgNS4zMTM1NiAxLjg4ODEgNS42MDAxIDIuMjQxNTYgNS42MDAxSDQuOTYxNTZDNS4zMTUwMiA1LjYwMDEgNS42MDE1NiA1LjMxMzU2IDUuNjAxNTYgNC45NjAxVjIuMjQwMUM1LjYwMTU2IDEuODg2NjQgNS4zMTUwMiAxLjYwMDEgNC45NjE1NiAxLjYwMDFaIiBmaWxsPSIjZmZmIi8%2BCjxwYXRoIGQ9Ik00Ljk2MTU2IDEwLjM5OTlIMi4yNDE1NkMxLjg4ODEgMTAuMzk5OSAxLjYwMTU2IDEwLjY4NjQgMS42MDE1NiAxMS4wMzk5VjEzLjc1OTlDMS42MDE1NiAxNC4xMTM0IDEuODg4MSAxNC4zOTk5IDIuMjQxNTYgMTQuMzk5OUg0Ljk2MTU2QzUuMzE1MDIgMTQuMzk5OSA1LjYwMTU2IDE0LjExMzQgNS42MDE1NiAxMy43NTk5VjExLjAzOTlDNS42MDE1NiAxMC42ODY0IDUuMzE1MDIgMTAuMzk5OSA0Ljk2MTU2IDEwLjM5OTlaIiBmaWxsPSIjZmZmIi8%2BCjxwYXRoIGQ9Ik0xMy43NTg0IDEuNjAwMUgxMS4wMzg0QzEwLjY4NSAxLjYwMDEgMTAuMzk4NCAxLjg4NjY0IDEwLjM5ODQgMi4yNDAxVjQuOTYwMUMxMC4zOTg0IDUuMzEzNTYgMTAuNjg1IDUuNjAwMSAxMS4wMzg0IDUuNjAwMUgxMy43NTg0QzE0LjExMTkgNS42MDAxIDE0LjM5ODQgNS4zMTM1NiAxNC4zOTg0IDQuOTYwMVYyLjI0MDFDMTQuMzk4NCAxLjg4NjY0IDE0LjExMTkgMS42MDAxIDEzLjc1ODQgMS42MDAxWiIgZmlsbD0iI2ZmZiIvPgo8cGF0aCBkPSJNNCAxMkwxMiA0TDQgMTJaIiBmaWxsPSIjZmZmIi8%2BCjxwYXRoIGQ9Ik00IDEyTDEyIDQiIHN0cm9rZT0iI2ZmZiIgc3Ryb2tlLXdpZHRoPSIxLjUiIHN0cm9rZS1saW5lY2FwPSJyb3VuZCIvPgo8L3N2Zz4K\u0026logoColor=ffffff)](https://zread.ai/terryso/polyv-live-cli)\n[![GitHub License](https://img.shields.io/github/license/terryso/polyv-live-cli?style=flat-square)](https://github.com/terryso/polyv-live-cli/blob/main/LICENSE)\n\u003c/div\u003e\n\n**Agent-First** 设计的保利威直播管理命令行工具。\n\n## Agent-First 设计理念\n\nPolyV Live CLI 专为 AI Agent 和自动化场景设计：\n\n- **详细帮助文档** - 每个命令都有完整的参数说明和示例\n- **结构化输出** - 支持 JSON 格式输出，便于程序化处理\n- **清晰错误信息** - 错误消息包含解决建议\n- **原生 Skill 支持** - 支持 Claude Code、OpenClaw 等 AI Agent\n\n### 在 AI Agent 中使用\n\n只需告诉 AI 你想做什么，它会自动调用 CLI 完成任务：\n\n```\n用户: 帮我创建一个电商直播频道\nAI Agent: [自动执行 npx polyv-live-cli@latest channel create ...]\n\n用户: 查看昨天直播的观看数据\nAI Agent: [自动执行 npx polyv-live-cli@latest statistics viewdata ...]\n\n用户: 给频道添加一个限时优惠券\nAI Agent: [自动执行 npx polyv-live-cli@latest coupon create ...]\n```\n\n## AI Agent Skill\n\n本项目提供官方 Skill，让 AI Agent（如 Claude Code、OpenClaw 等）能够智能管理直播服务。\n\n### 功能特点\n\n- **自动认证验证** - 执行命令前自动检查账号状态\n- **完整命令参考** - 包含所有命令的详细说明和示例\n- **中文文档** - 面向中文用户的完整指南\n- **引用文档** - 详细的使用场景和故障排除\n\n### 安装\n\n```bash\nnpx skills add terryso/polyv-live-cli\n```\n\n\u003e 支持 Claude Code、OpenClaw 等所有兼容 Skill 协议的 AI Agent。\n\n### 使用示例\n\n安装后，直接向 AI Agent 提问即可：\n\n```\n用户: 我想开始一场电商直播\nAI Agent: 我来帮你设置...\n         1. 创建电商频道\n         2. 添加商品\n         3. 创建优惠券\n         4. 获取推流密钥\n\n用户: 帮我监控直播质量\nAI Agent: 正在启动直播监控...\n```\n\n## 快速开始\n\n### 安装\n\n```bash\n# 推荐：使用 npx 直接运行（始终使用最新版）\nnpx polyv-live-cli@latest --help\n\n# 或全局安装\nnpm install -g polyv-live-cli\npolyv-live-cli --help\n```\n\n### 配置认证\n\n```bash\n# 添加账号\nnpx polyv-live-cli@latest account add myaccount --app-id \u003cappId\u003e --app-secret \u003cappSecret\u003e\n\n# 设为默认账号\nnpx polyv-live-cli@latest account set-default myaccount\n```\n\n### 基本使用\n\n```bash\n# 创建频道\nnpx polyv-live-cli@latest channel create -n \"新品发布会\"\n\n# 获取推流密钥（用于 OBS）\nnpx polyv-live-cli@latest stream get-key -c \u003cchannelId\u003e\n\n# 开始直播\nnpx polyv-live-cli@latest stream start -c \u003cchannelId\u003e\n\n# 查看统计数据\nnpx polyv-live-cli@latest statistics overview -c \u003cchannelId\u003e\n```\n\n## 功能模块\n\n| 模块 | 命令 | 说明 |\n|------|------|------|\n| 频道管理 | `channel` | 创建、查看、更新、删除频道 |\n| 推流管理 | `stream` | 获取推流密钥、开始/结束直播、质量监控 |\n| 商品管理 | `product` | 添加、查看、更新、删除商品 |\n| 优惠券 | `coupon` | 创建、查看、删除优惠券 |\n| 回放管理 | `playback` | 查看、删除、合并回放录像 |\n| 文档管理 | `document` | 上传、查看、删除直播文档 |\n| 统计分析 | `statistics` | 查看观看数据、导出报告 |\n| 场景初始化 | `setup` | 一键配置电商、教育等场景 |\n\n## 包结构\n\n```\npackages/\n├── sdk/    # polyv-live-api-sdk - PolyV Live API SDK\n└── cli/    # polyv-live-cli       - PolyV Live CLI 工具\n```\n\n## 开发\n\n```bash\n# 安装依赖\npnpm install\n\n# 构建\npnpm build\n\n# 测试\npnpm test\n\n# 运行 CLI（开发模式）\npnpm --filter polyv-live-cli dev\n```\n\n## 发布流程\n\n使用 Changesets 管理版本：\n\n```bash\npnpm changeset        # 创建 changeset\npnpm changeset version # 版本升级\npnpm changeset publish # 发布\n```\n\n## 相关链接\n\n- [SDK 文档](./packages/sdk/README.md)\n- [CLI 详细文档](./packages/cli/README.md)\n- [保利威直播 API 文档](https://help.polyv.net/#/live/api/)\n- [保利威官网](https://www.polyv.net/)\n\n## 联系方式\n\n- 邮箱: support@polyv.net\n- 官网: https://www.polyv.net/\n- 技术支持: 400-993-9533\n\n## ⭐ Star History\n\n[![Star History Chart](https://api.star-history.com/svg?repos=terryso/polyv-live-cli\u0026type=Date)](https://www.star-history.com/#terryso/polyv-live-cli\u0026Date)\n\n## Made with ❤️ by PolyV Team\n\n\u003e 让直播管理更简单，让开发者更高效！\n\n## License\n\nMIT\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fterryso%2Fpolyv-live-cli","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fterryso%2Fpolyv-live-cli","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fterryso%2Fpolyv-live-cli/lists"}