{"_id":"@baomihuatop/popcorn-op-cli","_rev":"4-a86157e108b3edbcf034a7f0d1f5dac1","name":"@baomihuatop/popcorn-op-cli","dist-tags":{"latest":"0.1.4"},"versions":{"0.1.1":{"name":"@baomihuatop/popcorn-op-cli","version":"0.1.1","_id":"@baomihuatop/popcorn-op-cli@0.1.1","maintainers":[{"name":"zongzi1993","email":"zongzizeyi@gmail.com"}],"bin":{"popcorn-op-cli":"bin/popcorn-op-cli.js"},"dist":{"shasum":"fd3426a299e3427cb4cc993e6016d8740d72b05e","tarball":"https://registry.npmjs.org/@baomihuatop/popcorn-op-cli/-/popcorn-op-cli-0.1.1.tgz","fileCount":17,"integrity":"sha512-jT+AvyZp3cXXpq3iOvm+O3xcNNmaZCr9M9ZGKW9lqf7Qchz9SgPQRq3Ckj95EiVFkxKFzT45bQ+lD8a/Orxq+g==","signatures":[{"sig":"MEUCIGXk3CP2Gtaz0XC1SEGf2lxvGz/bPZHLaFYmrO1h8I1eAiEAmvQyajT1G4d5vjBAGF+Jy0kjybiGZUw2eWRkbTlfsKo=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":60654},"type":"module","engines":{"node":">=18"},"gitHead":"2097690ecd2addf7ae4f70ee8b2902940358dc04","scripts":{"test":"node --test","start":"node bin/popcorn-op-cli.js"},"_npmUser":{"name":"zongzi1993","email":"zongzizeyi@gmail.com"},"_npmVersion":"11.6.0","description":"Popcorn operation CLI","directories":{},"_nodeVersion":"24.8.0","dependencies":{"commander":"^12.1.0"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/popcorn-op-cli_0.1.1_1786112522326_0.9759768556634132","host":"s3://npm-registry-packages-npm-production"}},"0.1.2":{"name":"@baomihuatop/popcorn-op-cli","version":"0.1.2","_id":"@baomihuatop/popcorn-op-cli@0.1.2","maintainers":[{"name":"zongzi1993","email":"zongzizeyi@gmail.com"}],"bin":{"popcorn-op-cli":"bin/popcorn-op-cli.js"},"dist":{"shasum":"9754cdf3792e724fd2a5e365906c35e58c5f7991","tarball":"https://registry.npmjs.org/@baomihuatop/popcorn-op-cli/-/popcorn-op-cli-0.1.2.tgz","fileCount":16,"integrity":"sha512-cZZm+sLVyweG1XHSpcrBJy3sRxVJKEHjCW0ZoaZ2CCRxwwrGWtsDbvuYvtFm67kjjXiys4c+R7WslWG6JLIPIQ==","signatures":[{"sig":"MEQCIF527nv+5N8bnPYNfh8k8bbSwy3gDjHxvamq5WEz/nmYAiBVuvIS4wXaXjOeXM3/rJRYNtVQVJ0SVvwaZrS9cD5gQA==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":45858},"type":"module","engines":{"node":">=18"},"gitHead":"2c5a3ba56d7d0d74004a25db107a4938308284df","scripts":{"test":"node --test","start":"node bin/popcorn-op-cli.js"},"_npmUser":{"name":"zongzi1993","email":"zongzizeyi@gmail.com"},"_npmVersion":"11.6.0","description":"Popcorn operation CLI","directories":{},"_nodeVersion":"24.8.0","dependencies":{"commander":"^12.1.0"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/popcorn-op-cli_0.1.2_1786114789072_0.9127373642737782","host":"s3://npm-registry-packages-npm-production"}},"0.1.3":{"name":"@baomihuatop/popcorn-op-cli","version":"0.1.3","_id":"@baomihuatop/popcorn-op-cli@0.1.3","maintainers":[{"name":"zongzi1993","email":"zongzizeyi@gmail.com"}],"bin":{"popcorn-op-cli":"bin/popcorn-op-cli.js"},"dist":{"shasum":"fe322fa94783602f24b4b9c2ba6981ce9e93a1c8","tarball":"https://registry.npmjs.org/@baomihuatop/popcorn-op-cli/-/popcorn-op-cli-0.1.3.tgz","fileCount":16,"integrity":"sha512-uSfJji/8pW/Bbd1iQbnx1IO35/7Px4C0+s5keoSwlHCxN/j/8EC9UQy6FEWZ7P8QEjvuCxZaT4jMlNb2ya3P/g==","signatures":[{"sig":"MEUCIAbQsOATmh7QDbx+oUWCGzFD5NPebaF/62WIjUym2gmtAiEAmfMEBFRQZAMrQC4ou6YV1cjOukpVPXRIKEJHAr/Z9JE=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":45858},"type":"module","engines":{"node":">=18"},"gitHead":"210e4b709795ecca9746d50c4698b364ab52d0a8","scripts":{"test":"node --test","start":"node bin/popcorn-op-cli.js"},"_npmUser":{"name":"zongzi1993","email":"zongzizeyi@gmail.com"},"_npmVersion":"11.6.0","description":"Popcorn operation CLI","directories":{},"_nodeVersion":"24.8.0","dependencies":{"commander":"^12.1.0"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/popcorn-op-cli_0.1.3_1786115448951_0.40244865865889423","host":"s3://npm-registry-packages-npm-production"}},"0.1.4":{"name":"@baomihuatop/popcorn-op-cli","version":"0.1.4","description":"Popcorn operation CLI","type":"module","bin":{"popcorn-op-cli":"bin/popcorn-op-cli.js"},"scripts":{"start":"node bin/popcorn-op-cli.js","test":"node --test"},"engines":{"node":">=18"},"dependencies":{"commander":"^12.1.0"},"_id":"@baomihuatop/popcorn-op-cli@0.1.4","gitHead":"b7c9ef0641f621bdfe73ac80714c37e582361bff","_nodeVersion":"24.8.0","_npmVersion":"11.6.0","dist":{"integrity":"sha512-KZWZRFZxc3ZY84UQh5JAUc1YYdco1vFKqWhSKKnhW7JG5+dCEiBErtJ6r/marpaQ4yTQqkkgmIgZKURLLFW6Kg==","shasum":"e7df059cab83173d6881358d6f2f3bdab3f270eb","tarball":"https://registry.npmjs.org/@baomihuatop/popcorn-op-cli/-/popcorn-op-cli-0.1.4.tgz","fileCount":8,"unpackedSize":21682,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIQCYm5Lo+e6pJhc21h690H7mHfO84pWpY+w0BtKLvdIjfAIgcDCDd4eTL61UnWNrRwxPYnIWKD2MVNbT4EY8lzhkhHE="}]},"_npmUser":{"name":"zongzi1993","email":"zongzizeyi@gmail.com"},"directories":{},"maintainers":[{"name":"zongzi1993","email":"zongzizeyi@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/popcorn-op-cli_0.1.4_1786358730458_0.5764538397342196"},"_hasShrinkwrap":false}},"time":{"created":"2026-08-07T14:22:02.141Z","modified":"2026-08-10T10:45:30.759Z","0.1.1":"2026-08-07T14:22:02.485Z","0.1.2":"2026-08-07T14:59:49.235Z","0.1.3":"2026-08-07T15:10:49.110Z","0.1.4":"2026-08-10T10:45:30.605Z"},"description":"Popcorn operation CLI","maintainers":[{"name":"zongzi1993","email":"zongzizeyi@gmail.com"}],"readme":"# popcorn-op-cli\n\nPopcorn 官方经营命令行客户端。通过本地配置的后管 CLI API Key 调用经营报表接口，用于查询平台总览、组织目录、租户与模型汇总，以及单租户下钻明细。所有报表命令均为只读。\n\n## 安装\n\n需要 Node.js 18 或更高版本。\n\n首次安装请按 [爆米花运营 CLI 安装与使用指南](docs/installation-guide.md) 操作；该指南包含环境准备、API Key 配置、首个报表和故障排查。\n\n```bash\nnpm install -g @baomihuatop/popcorn-op-cli\n```\n\n安装后确认命令可用：\n\n```bash\npopcorn-op-cli --version\npopcorn-op-cli --help\n```\n\n## 配置\n\n安装后需先配置后端地址和 CLI API Key（由运维提供）：\n\n```bash\npopcorn-op-cli config set-url <YOUR_ADMIN_BACKEND_URL>\npopcorn-op-cli config set-api-key <YOUR_CLI_API_KEY>\n```\n\n`baseUrl` 是后端根地址，不要加 `/admin` 或 `/api` 后缀。\n\n```bash\n# 查看当前环境\npopcorn-op-cli config show\n```\n\n配置会保存在本机：`~/.popcorn-op-cli/config.json`。\n\n## 经营报表\n\n报表固定按北京时间（`Asia/Shanghai`）统计，不提供 `--timezone` 参数。日期使用 `YYYY-MM-DD`；传入时 `--start-date` 和 `--end-date` 必须同时提供。不传日期时由后端默认本月 1 日至当前日。\n\n平台总览：\n\n```bash\npopcorn-op-cli report overview \\\n  --start-date 2026-08-01 \\\n  --end-date 2026-08-31\n```\n\n组织目录及配置模型（平台运营权限）：\n\n```bash\npopcorn-op-cli report organizations\n```\n\n租户与模型列表：\n\n```bash\npopcorn-op-cli report tenants\npopcorn-op-cli report models\n```\n\n单租户汇总，以及按账户或模型下钻：\n\n```bash\npopcorn-op-cli report tenant 1001\npopcorn-op-cli report tenant 1001 --breakdown accounts\npopcorn-op-cli report tenant 1001 --breakdown models\n```\n\n当前命令输出后端原始 `{ data, meta }` JSON，便于脚本和二次处理。\n\n## 积分流水明细导出\n\n`detail` 用于导出租户在指定时间范围内的积分流水，会自动请求全部分页并写入文件。日期按北京时间解释。\n\n```bash\n# 仅导出积分分配流水（credit_type=allocate）\npopcorn-op-cli detail allocation \\\n  --tenant-id 123 \\\n  --start-date 2026-08-01 \\\n  --end-date 2026-08-10 \\\n  --output ./tenant-123-allocation.csv\n\n# 导出该租户的全部积分变更明细\npopcorn-op-cli detail changes \\\n  --tenant-id 123 \\\n  --start-date 2026-08-01 \\\n  --end-date 2026-08-10 \\\n  --output ./tenant-123-changes.json\n```\n\n默认按输出文件扩展名选择格式：`.csv` 为 CSV，`.json` 为 JSON；也可以显式传入 `--format csv` 或 `--format json`。\n\n| 指标 | 说明 |\n|------|------|\n| `pool_consumed_credits` | 租户积分池下发/扣减；用于余额经营 |\n| `task_consumed_credits` | 任务净消耗：预扣减去失败和结算返还 |\n| `closing_balance_credits` | 查询截止日的可用积分余额 |\n| `task_count` | 任务主记录数量，不重复计算重试 |\n\n## 常用命令\n\n| 命令 | 说明 |\n|------|------|\n| `popcorn-op-cli config set-url <url>` | 设置后管地址 |\n| `popcorn-op-cli config set-api-key <key>` | 设置 CLI API Key |\n| `popcorn-op-cli config show` | 查看当前配置 |\n| `popcorn-op-cli report overview` | 查看全局经营总览 |\n| `popcorn-op-cli report organizations` | 查看组织目录和配置模型 |\n| `popcorn-op-cli report tenants` | 查看租户汇总列表 |\n| `popcorn-op-cli report models` | 查看模型汇总列表 |\n| `popcorn-op-cli report tenant <id>` | 查看单租户汇总或下钻明细 |\n| `popcorn-op-cli detail allocation ...` | 导出指定租户的积分分配流水 |\n| `popcorn-op-cli detail changes ...` | 导出指定租户的全部积分变更明细 |\n\n所有命令都支持 `--help`：\n\n```bash\npopcorn-op-cli --help\npopcorn-op-cli report --help\npopcorn-op-cli report overview --help\npopcorn-op-cli detail --help\npopcorn-op-cli config --help\n```\n\n## 升级\n\n```bash\nnpm install -g @baomihuatop/popcorn-op-cli@latest\n```\n\n## 卸载\n\n```bash\nnpm uninstall -g @baomihuatop/popcorn-op-cli\n```\n\n## 常见问题\n\n`popcorn-op-cli: command not found`\n\n确认 npm 全局安装目录已加入 `PATH`，或重新打开终端后再试。\n\n`未配置 API Key`\n\n先执行：\n\n```bash\npopcorn-op-cli config set-api-key <YOUR_CLI_API_KEY>\n```\n\n`401 / 403`\n\nAPI Key 缺失、过期、错误，或没有报表权限 / 请求范围越权。请重新配置有效的后管 CLI API Key。\n\n`--start-date 和 --end-date 必须同时提供`\n\n日期参数必须成对传入，例如：\n\n```bash\npopcorn-op-cli report overview --start-date 2026-08-01 --end-date 2026-08-31\n```\n","readmeFilename":"README.md"}