{"_id":"@baomihuatop/popcorn-cli","_rev":"4-12db48889086bed6ab186f9b0dc48a81","name":"@baomihuatop/popcorn-cli","dist-tags":{"latest":"0.1.3"},"versions":{"0.1.0":{"name":"@baomihuatop/popcorn-cli","version":"0.1.0","_id":"@baomihuatop/popcorn-cli@0.1.0","maintainers":[{"name":"zongzi1993","email":"zongzizeyi@gmail.com"}],"bin":{"popcorn-cli":"bin/popcorn-cli.js"},"dist":{"shasum":"2509e8bf3a4876a9335ec39fdbcba1a64fa14426","tarball":"https://registry.npmjs.org/@baomihuatop/popcorn-cli/-/popcorn-cli-0.1.0.tgz","fileCount":13,"integrity":"sha512-YHvN4Bi2Z722XEpMNAwsukWLWrlksfWfWBubiXkwd4wRqj6ImQ7465/v9nFYcEuvfNwrWhW0Z3bhItLyoNIMxQ==","signatures":[{"sig":"MEUCIC7ztpRM9AXn8yvpvHuOIw24Fhr85ftuzPAYEtszc1RlAiEA4mqCMhA488nmk08DqL4+IzGOShfwqfDOBc6lw0cVNY4=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":20366},"type":"module","gitHead":"ea064523ce64d4ae07411ea90b0c877a1e511d2e","scripts":{"start":"node bin/popcorn-cli.js"},"_npmUser":{"name":"zongzi1993","email":"zongzizeyi@gmail.com"},"_npmVersion":"11.5.1","description":"Popcorn CLI - 通过 API Key 提交生图任务","directories":{},"_nodeVersion":"24.7.0","dependencies":{"commander":"^12.1.0","node-fetch":"^3.3.2"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/popcorn-cli_0.1.0_1785292156414_0.056203829641000125","host":"s3://npm-registry-packages-npm-production"}},"0.1.1":{"name":"@baomihuatop/popcorn-cli","version":"0.1.1","_id":"@baomihuatop/popcorn-cli@0.1.1","maintainers":[{"name":"zongzi1993","email":"zongzizeyi@gmail.com"}],"bin":{"popcorn-cli":"bin/popcorn-cli.js"},"dist":{"shasum":"002021a924e5e1d847ba9b9adaf259edfbb92547","tarball":"https://registry.npmjs.org/@baomihuatop/popcorn-cli/-/popcorn-cli-0.1.1.tgz","fileCount":13,"integrity":"sha512-nB5si+G4WAOp/Y2/uLk7d+9jQFXYVtSJQhKlOeEk0BMEmaEu7okwIs/xC2N4lWvT/UVk8HoDXYXnG10/gAIUZA==","signatures":[{"sig":"MEYCIQDKpo0UC8xTFXaPLwv83vicahjNdjHRlGYkm7zB9jbBNwIhAI+pyKhh9bM/RKWnRbAgEUUlBX6OLhJDiQ+mtYbuvxFL","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":20366},"type":"module","gitHead":"ea064523ce64d4ae07411ea90b0c877a1e511d2e","scripts":{"start":"node bin/popcorn-cli.js"},"_npmUser":{"name":"zongzi1993","email":"zongzizeyi@gmail.com"},"_npmVersion":"11.5.1","description":"Popcorn CLI - 通过 API Key 提交生图任务","directories":{},"_nodeVersion":"24.7.0","dependencies":{"commander":"^12.1.0","node-fetch":"^3.3.2"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/popcorn-cli_0.1.1_1785292447686_0.6577009677423662","host":"s3://npm-registry-packages-npm-production"}},"0.1.2":{"name":"@baomihuatop/popcorn-cli","version":"0.1.2","_id":"@baomihuatop/popcorn-cli@0.1.2","maintainers":[{"name":"zongzi1993","email":"zongzizeyi@gmail.com"}],"bin":{"popcorn-cli":"bin/popcorn-cli.js"},"dist":{"shasum":"00b8f24873e895503458b27af8dc85106c83ad74","tarball":"https://registry.npmjs.org/@baomihuatop/popcorn-cli/-/popcorn-cli-0.1.2.tgz","fileCount":13,"integrity":"sha512-qR/605xbuvCA7pUVKrvq4SQsdiKkym5uU9/NagqNCKTLt1Kupune0t8I5uBW4P73emWVm15E44BOQ3gezz+/tw==","signatures":[{"sig":"MEUCIHNZPFwRkwb4tYHmiKUhRIzGuDp/O1WhY0ArwHJETXKqAiEAwtsfqwvmjS3XuuTIc3x6NyAUksYOHUWv8w7Emazripo=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":22189},"type":"module","gitHead":"300ae8900ecbd86d63c220328e50f2d76fd0cea3","scripts":{"start":"node bin/popcorn-cli.js"},"_npmUser":{"name":"zongzi1993","email":"zongzizeyi@gmail.com"},"_npmVersion":"11.5.1","description":"Popcorn CLI - 通过 API Key 提交生图任务","directories":{},"_nodeVersion":"24.7.0","dependencies":{"commander":"^12.1.0","node-fetch":"^3.3.2"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/popcorn-cli_0.1.2_1785309207832_0.5502543210481274","host":"s3://npm-registry-packages-npm-production"}},"0.1.3":{"name":"@baomihuatop/popcorn-cli","version":"0.1.3","description":"Popcorn CLI - 通过 API Key 提交生图任务","type":"module","bin":{"popcorn-cli":"bin/popcorn-cli.js"},"scripts":{"start":"node bin/popcorn-cli.js"},"dependencies":{"commander":"^12.1.0","node-fetch":"^3.3.2"},"_id":"@baomihuatop/popcorn-cli@0.1.3","_integrity":"sha512-pOmoBqiNl+Qa59Nv8R7tpG3IftB3/Rb1FHFGQ/Y+hf3xJ6IZQnwgCe/u33UKiPCCwLBzmgkLFcCHwXD1AVKKjw==","_resolved":"/Users/yangsen/Work/llm/MangaForge/popcorn-cli/baomihuatop-popcorn-cli-0.1.3.tgz","_from":"file:baomihuatop-popcorn-cli-0.1.3.tgz","_nodeVersion":"24.8.0","_npmVersion":"11.6.0","dist":{"integrity":"sha512-pOmoBqiNl+Qa59Nv8R7tpG3IftB3/Rb1FHFGQ/Y+hf3xJ6IZQnwgCe/u33UKiPCCwLBzmgkLFcCHwXD1AVKKjw==","shasum":"554b7fe4fd99c3fde821fcc2df470cc6b8f046e7","tarball":"https://registry.npmjs.org/@baomihuatop/popcorn-cli/-/popcorn-cli-0.1.3.tgz","fileCount":15,"unpackedSize":45016,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIQCCB8vAZ1gdpOujKnnWMQCWaR8g3InyvQho6nMiMRKSiwIgeV8suWjYxQHSIMJIg1gH5PHntfnqgKQn6FNrIsvOdcs="}]},"_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-cli_0.1.3_1786104360094_0.1959602965291789"},"_hasShrinkwrap":false}},"time":{"created":"2026-07-29T02:29:16.281Z","modified":"2026-08-07T12:06:00.418Z","0.1.0":"2026-07-29T02:29:16.571Z","0.1.1":"2026-07-29T02:34:07.829Z","0.1.2":"2026-07-29T07:13:27.999Z","0.1.3":"2026-08-07T12:06:00.249Z"},"description":"Popcorn CLI - 通过 API Key 提交生图任务","maintainers":[{"name":"zongzi1993","email":"zongzizeyi@gmail.com"}],"readme":"# popcorn-cli\n\nPopcorn 官方命令行客户端。通过本地配置的 API Key 调用 Popcorn 服务，用于查询可用模型、提交生图 / 生视频任务、查询任务状态，以及按类型查询 / 创建文件夹。\n\n## 安装\n\n需要 Node.js 18 或更高版本。\n\n```bash\nnpm install -g @baomihuatop/popcorn-cli\n```\n\n安装后确认命令可用：\n\n```bash\npopcorn-cli --version\npopcorn-cli --help\n```\n\n## 配置 API Key\n\n```bash\npopcorn-cli config set-key <YOUR_API_KEY>\n```\n\n查看当前配置：\n\n```bash\npopcorn-cli config show\n```\n\nAPI Key 会保存在本机配置文件中：`~/.popcorn-cli/config.json`。\n\n## 查询可用模型\n\n提交任务前，先查询当前 API Key 可用的模型和参数 schema。\n\n```bash\npopcorn-cli image models\npopcorn-cli video models\npopcorn-cli video models --detail <MODEL_ID>\n```\n\n`models` 默认返回模型清单、`model_limit`、计费配置、公共调用建议和提交任务所需的参数结构。使用 `--detail <MODEL_ID>` 查看单个模型完整信息。\n\n## 提交任务\n\n生图任务：\n\n```bash\npopcorn-cli image submit -n \"demo image\" -d \"cat test\" -p '{\"model\":\"sd-xl-v1\",\"prompt\":\"a cat\"}'\n```\n\n生视频任务：\n\n```bash\npopcorn-cli video submit -n \"demo video\" -d \"cinematic cat test\" -p '{\"model\":\"video-model-id\",\"prompt\":\"a cinematic cat\"}'\n```\n\n关联会话 ID：\n\n```bash\npopcorn-cli image submit -s <SESSION_ID> -n \"demo image\" -d \"cat test\" -p '{\"model\":\"sd-xl-v1\",\"prompt\":\"a cat\"}'\n```\n\n指定 AI 产物文件夹（仅支持 `cli_generate`）：\n\n```bash\npopcorn-cli folder list -t cli_generate\npopcorn-cli image submit -f <FOLDER_ID> -n \"demo image\" -d \"cat test\" -p '{\"model\":\"sd-xl-v1\",\"prompt\":\"a cat\"}'\n```\n\n`-n, --name` 和 `-d, --description` 必填；`-p, --params` 必须是 JSON 对象字符串。具体字段以 `image models` / `video models` 返回的 `params_schema` 为准。\n\n## 上传资源\n\n上传本地图片、视频或音频资源：\n\n```bash\npopcorn-cli resource upload ./demo.png --name \"demo image\" --description \"reference image\"\n```\n\n指定上传资源文件夹：\n\n```bash\npopcorn-cli resource upload ./demo.mp4 --folder-id 123 --name \"demo video\" --description \"reference video\"\n```\n\n`--name` 和 `--description` 必填。资源类型由后端按文件扩展名 / Content-Type 推断，CLI 不再提供 `--type`。`--folder-id` 不传则不归属目录；传入时必须是当前用户的 `cli_upload` 目录 ID，并由后端校验权限。\n\n查询上传资源：\n\n```bash\npopcorn-cli resource list --name demo --created-from 2026-08-01 --created-to 2026-08-06 --page 1 --page-size 20\n```\n\n返回内容包含 `name`、`description`、`file_url`、`created_at`，并附带 `total/page/page_size` 分页信息。\n\n## 查询任务\n\n按任务 ID 查询单个任务：\n\n```bash\npopcorn-cli task list -t <TASK_ID>\n```\n\n按会话 ID 查询该会话下的任务：\n\n```bash\npopcorn-cli task list -s <SESSION_ID>\n```\n\n## 文件夹\n\n按类型查询文件夹：\n\n```bash\npopcorn-cli folder list -t cli_generate\npopcorn-cli folder list -t cli_upload\n```\n\n创建文件夹：\n\n```bash\npopcorn-cli folder create -n \"角色参考\" -t cli_upload\npopcorn-cli folder create -n \"主角\" -t cli_upload -p <PARENT_ID>\n```\n\n`type` 支持 `cli_generate`（CLI 生成产物）与 `cli_upload`（CLI 上传资源）。\n\n## 常用命令\n\n| 命令 | 说明 |\n|------|------|\n| `popcorn-cli config set-key <apiKey>` | 设置 API Key |\n| `popcorn-cli config show` | 查看当前配置 |\n| `popcorn-cli image models` | 查询可用生图模型 |\n| `popcorn-cli image models --detail <MODEL_ID>` | 查看单个生图模型完整信息 |\n| `popcorn-cli image submit -n <NAME> -d <DESCRIPTION> -p <JSON>` | 提交生图任务 |\n| `popcorn-cli video models` | 查询可用生视频模型 |\n| `popcorn-cli video models --detail <MODEL_ID>` | 查看单个生视频模型完整信息 |\n| `popcorn-cli video submit -n <NAME> -d <DESCRIPTION> -p <JSON>` | 提交生视频任务 |\n| `popcorn-cli resource upload <file> -n <NAME> -d <DESCRIPTION>` | 上传图片、视频或音频资源 |\n| `popcorn-cli resource list --name <KEYWORD> --page <PAGE>` | 查询上传资源 |\n| `popcorn-cli task list -t <TASK_ID>` | 按任务 ID 查询任务 |\n| `popcorn-cli task list -s <SESSION_ID>` | 按会话 ID 查询任务 |\n| `popcorn-cli folder list -t <TYPE>` | 按类型查询文件夹 |\n| `popcorn-cli folder create -n <NAME> -t <TYPE>` | 创建文件夹 |\n\n所有命令都支持 `--help`：\n\n```bash\npopcorn-cli --help\npopcorn-cli image --help\npopcorn-cli folder --help\npopcorn-cli folder create --help\npopcorn-cli resource upload --help\n```\n\n## 升级\n\n```bash\nnpm install -g @baomihuatop/popcorn-cli@latest\n```\n\n## 卸载\n\n```bash\nnpm uninstall -g @baomihuatop/popcorn-cli\n```\n\n## 常见问题\n\n`popcorn-cli: command not found`\n\n确认 npm 全局安装目录已加入 `PATH`，或重新打开终端后再试。\n\n`未设置 API Key`\n\n先执行：\n\n```bash\npopcorn-cli config set-key <YOUR_API_KEY>\n```\n\n`params 不是合法的 JSON`\n\n`-p` 参数必须传入合法 JSON 对象字符串，建议用单引号包裹完整 JSON。\n","readmeFilename":"README.md"}