@yandy0725/mediagen-cli 0.3.1 → 0.4.0

package/README.md

@@ -28,6 +28,16 @@ mediagen image generate "a red fox in fresh snow, soft morning light" --provider
 
 Node >= 18, two runtime dependencies, a DashScope and/or Ark API key.
 
+## Using it from an agent
+
+The skill in `skills/mediagen/SKILL.md` tells an agent what this CLI does and which rules
+keep a paid request from being wasted. Install it either way:
+
+```bash
+npx skills add yandy/mediagen-cli
+mediagen skills install --dir ~/.claude/skills
+```
+
 ## Commands
 
 | command | what it does |
@@ -39,7 +49,7 @@ Node >= 18, two runtime dependencies, a DashScope and/or Ark API key.
 | `mediagen login` / `logout` / `auth status` | store, remove, inspect API keys |
 | `mediagen config show` / `config path` | resolved config, and where it lives |
 | `mediagen config add <name>` | create a provider in config.toml; everything else is a manual edit |
-| `mediagen skill install --dir <path>` | copy the packaged agent skill into `<path>/mediagen/`; re-run to replace it |
+| `mediagen skills install --dir <path>` | copy the packaged agent skill into `<path>/mediagen/`; re-run to replace it |
 
 `mediagen image generate --help` and `mediagen video generate --help` are the
 reference: every flag, the model table, the size reference, examples. Everything below
@@ -254,22 +264,6 @@ download and 600 s per video download. For video that budget is the *whole* poll
 window, not one request: each create or poll gets 60 s, so a hung request cannot eat
 the budget, and the download has its own 600 s and is not counted against it.
 
-Working from an agent? Inside pi, install the skill as a pi package:
-
-```bash
-pi install npm:@yandy0725/mediagen-cli
-```
-
-That delivers `skills/mediagen/SKILL.md` only: pi never puts the `mediagen` command on
-`PATH`, so the CLI still comes from `npm install -g @yandy0725/mediagen-cli`. For any other
-agent, `mediagen skill install --dir <skills dir>` puts the same file where that agent
-already looks — e.g. `--dir ~/.claude/skills` — and re-running it after an upgrade replaces
-the old copy. Use one route, not both: pi loads skills by name, so the two copies collide — the
-directory you copied wins and pi only reports a `name "mediagen" collision` warning, which
-means a stale copy silently shadows the upgraded package. The skill describes what this CLI
-does, which tool to prefer when the project already generates media another way, and the
-rules that keep a paid request from being wasted.
-
 ---
 
 ## Development

package/README.zh-CN.md

@@ -27,6 +27,15 @@ mediagen image generate "a red fox in fresh snow, soft morning light" --provider
 
 Node >= 18，两个运行时依赖，需要 DashScope 和/或方舟的 API key。
 
+## 在 Agent 里用
+
+`skills/mediagen/SKILL.md` 这份技能告诉 agent 这个 CLI 能做什么、哪些规则能避免白花钱。两种装法：
+
+```bash
+npx skills add yandy/mediagen-cli
+mediagen skills install --dir ~/.claude/skills
+```
+
 ## 命令
 
 | 命令 | 作用 |
@@ -38,7 +47,7 @@ Node >= 18，两个运行时依赖，需要 DashScope 和/或方舟的 API key
 | `mediagen login` / `logout` / `auth status` | 保存、删除、查看 API key |
 | `mediagen config show` / `config path` | 解析后的配置，以及它存在哪里 |
 | `mediagen config add <name>` | 在 config.toml 里新建一条 provider（其余修改手写文件） |
-| `mediagen skill install --dir <path>` | 把自带的 agent 技能装到 `<path>/mediagen/`；重跑即覆盖 |
+| `mediagen skills install --dir <path>` | 把自带的 agent 技能装到 `<path>/mediagen/`；重跑即覆盖 |
 
 `mediagen image generate --help` 与 `mediagen video generate --help` 才是参考手册：
 全部参数、模型表、尺寸表、示例。下面只是简化版。
@@ -229,19 +238,6 @@ OpenAI 兼容端点（`compatible-mode`）只在业务空间专属域名上提
 `timeout_seconds` 是**整个轮询窗口**，不是单次请求：建任务与每次轮询各自 60 秒，这样一个挂住
 的请求吃不掉预算；下载另有 600 秒，不计入预算。
 
-在 Agent 里用？在 pi 里，把这份技能当成 pi 包安装：
-
-```bash
-pi install npm:@yandy0725/mediagen-cli
-```
-
-它只送 `skills/mediagen/SKILL.md`：pi 不会把 `mediagen` 命令放进 `PATH`，命令仍来自
-`npm install -g @yandy0725/mediagen-cli`。其他 agent 用 `mediagen skill install --dir <技能目录>`
-把同一个文件装到它已经在读的位置（例如 `--dir ~/.claude/skills`），升级后重跑一次即可覆盖。
-两条路线只选一条：pi 按技能名加载，两份同名技能会冲突——复制出来的那份胜出，pi 只给一条
-name "mediagen" collision 警告，于是旧副本会静默盖住升级后的包。这份技能说明这个 CLI
-能做什么、项目已有别的生成工具时该用哪个，以及哪些规则能避免白花钱。
-
 ---
 
 ## 开发

package/dist/cli.js

@@ -102,12 +102,12 @@ default_provider = "volcengine"
 
 [providers.volcengine]
 base_url    = "https://ark.cn-beijing.volces.com"
-api_key_env = "ARK_API_KEY"   # which environment variable holds this provider's key
+api_key_env = "VOLCENGINE_API_KEY"   # which environment variable holds this provider's key
 
 [providers.volcengine.image]
 api_type = "ark"
 default  = "doubao-seedream-5-0-flash-260915"
-models   = ["doubao-seedream-5-0-flash-260915", "doubao-seedream-5-0-pro"]
+models   = ["doubao-seedream-5-0-flash-260915", "doubao-seedream-5-0-pro-260628"]
 
 [providers.volcengine.video]
 api_type = "ark"
@@ -120,7 +120,7 @@ models   = ["doubao-seedance-1-0-pro-250528"]   # ids are dated snapshots; add m
 # instead \u2014 https://{workspace-id}.cn-beijing.maas.aliyuncs.com \u2014 which is also
 # where Alibaba recommends sending native calls.
 base_url    = "https://dashscope.aliyuncs.com"
-api_key_env = "DASHSCOPE_API_KEY"
+api_key_env = "ALIYUN_API_KEY"
 
 [providers.aliyun.image]
 api_type = "dashscope"          # input.messages + parameters, output.choices[].image
@@ -2500,7 +2500,7 @@ Subcommands:
   config show       the resolved configuration, with a source note for each value
   config path       where config.toml lives
   config add        create a provider in config.toml (edit the file for anything else)
-  skill install     copy the agent skill this package ships into a directory you name
+  skills install    copy the agent skill this package ships into a directory you name
   video generate    create and pay for a video task, then save the result
   video status      look at one task once, and save its video if it finished
 
@@ -2746,8 +2746,8 @@ function createProgram(options = {}) {
   config.command("add <name>").description("Create a [providers.<name>] table in config.toml").option("--api-type <dialect>", "protocol dialect: openai, dashscope, ark or minimax").option("--base-url <url>", "the provider's origin, e.g. https://ark.cn-beijing.volces.com").option("--task <image|video>", "which task table to create (default: image)").option("--model <id>", "the model id this task defaults to").option("--api-key-env <VAR>", "environment variable holding this provider's key").option("--json", "print a JSON result").action(async (name, flags) => {
     runConfigAdd(name, flags);
   });
-  const skill = program.command("skill").description("Install the agent skill this package ships");
-  skill.command("install").description("Copy the skill into a directory an agent reads skills from, replacing an older copy").option("--dir <path>", "the skills directory, e.g. ~/.claude/skills (the skill lands in <path>/mediagen)").option("--json", "print a JSON result").action(async (flags) => {
+  const skills = program.command("skills").description("Install the agent skill this package ships");
+  skills.command("install").description("Copy the skill into a directory an agent reads skills from, replacing an older copy").option("--dir <path>", "the skills directory, e.g. ~/.claude/skills (the skill lands in <path>/mediagen)").option("--json", "print a JSON result").action(async (flags) => {
     runSkillInstall(flags);
   });
   const image = program.command("image").description("Generate and edit images");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@yandy0725/mediagen-cli",
-  "version": "0.3.1",
+  "version": "0.4.0",
   "description": "Non-interactive image generation and editing, plus short video generation, for agents: qwen-image, doubao/seedream, doubao/seedance, MiniMax H3, files on disk, JSON output.",
   "type": "module",
   "license": "MIT",
@@ -11,13 +11,7 @@
     "dist",
     "skills"
   ],
-  "pi": {
-    "skills": [
-      "./skills"
-    ]
-  },
   "keywords": [
-    "pi-package",
     "cli",
     "image",
     "image-generation",

package/skills/mediagen/SKILL.md

@@ -42,8 +42,8 @@ project has, or when the user asks for it by name.
 
 ## Setup, once
 
-This skill carries no binary: `mediagen` must already be on `PATH`, and the pi package that
-delivered this skill does not put it there. If `command -v mediagen` prints nothing:
+This skill carries no binary: `mediagen` must already be on `PATH`, and installing this
+skill never puts it there. If `command -v mediagen` prints nothing:
 
 ```bash
 npm install -g @yandy0725/mediagen-cli