instantclips-mcp 1.7.1 → 1.9.0

package/README.es.md

@@ -212,20 +212,22 @@ El flujo de trabajo, en orden:
 
 1. **Importar** — usa `import_product_from_url` para una página de tienda o
    `create_product_from_images` cuando no haya una página que leer.
-2. **Esperar el borrador** — consulta `get_product` periódicamente hasta que terminen la importación
-   y la preparación del plan.
-3. **Revisarlo y orientarlo** — el plan se devuelve como texto para que el usuario lo revise.
-   `update_video_direction` cambia lo que haga falta y `redraft_video_direction` propone otro
-   enfoque.
+2. **Esperar la importación** — consulta `get_product` periódicamente hasta que `import_status` sea
+   "imported".
+3. **Elegir la idea y revisar el plan** — ofrece las `ideas` del producto, como hace la web. La
+   elección del usuario, o sus propias palabras, va en el `creator_note` de `update_video_direction`,
+   que redacta el plan; `redraft_video_direction` sin idea elige una por él. El plan se devuelve
+   como texto para que el usuario lo revise, y `update_video_direction` cambia lo que haga falta.
 4. **Generar** — usa `generate_video` pasando `expected_credit_cost`: el coste que se le indicó al
    usuario, tal como lo informó `get_product`. Si no coincide, se rechaza sin cobrar.
-5. **Recoger el resultado** — consulta `get_video` periódicamente para obtener el MP4 terminado y
-   un enlace público para compartirlo.
+5. **Recoger el resultado** — consulta `get_video` periódicamente hasta que termine y entrega al
+   usuario el `download_url`, la página propia del vídeo y su enlace público para compartirlo.
 
 Otro vídeo del mismo producto sigue el mismo flujo sobre ese producto: editar o volver a preparar el
 plan abre el borrador del siguiente vídeo, y `generate_video` sin borrador genera otra toma del último
 plan. Un vídeo ya generado no se puede modificar. Cada respuesta de `get_product` incluye `next_step`:
-qué hacer a continuación.
+qué hacer a continuación. Cuando el usuario ha visto un vídeo, `rate_video` registra su valoración;
+`send_feedback` envía al equipo una nota sobre las propias herramientas, con el visto bueno del usuario.
 
 Las marcas funcionan de la misma manera: `list_brands`, `create_brand`, `set_product_brand`. Cada
 vídeo se prepara con la voz de una marca; por eso, si el escaparate de un producto importado no
@@ -294,8 +296,18 @@ de nombres de marca `ai.instantclips`; no lo sustituyas por un nombre `io.github
 firma no se guarda en el repositorio: `.gitignore` cubre `*.pem`, y una clave privada incluida en un
 commit es una clave publicada.
 
-`npm publish` pide una confirmación única en el navegador, así que ejecútalo en una terminal
-interactiva: desde un script se detiene con `EOTP` y no publica nada.
+El paquete npm se publica desde GitHub Actions, no desde un portátil. Haz commit del cambio de
+versión (`package.json`, `server.json` y los valores fijados en `test/shim.test.js`) y sube una
+etiqueta con su nombre (`git tag v1.7.2 && git push origin main v1.7.2`);
+`.github/workflows/publish.yml` ejecuta las pruebas y publica mediante la publicación de confianza
+de npm (trusted publishing), sin token de npm ni confirmación en el navegador. El trabajo se detiene
+si la etiqueta no coincide con el `version` de `package.json`. El publicador de confianza del paquete
+en npmjs.com nombra este repositorio y `publish.yml`, así que renombrar el archivo del flujo de
+trabajo impide publicar.
+
+Una versión nueva puede tardar varios minutos en aparecer en npm, y el registro rechaza una entrada
+cuya versión de npm no encuentra ("version … was not found"; no cambia nada). Ejecuta el paso de
+`mcp-publisher` cuando `https://registry.npmjs.org/instantclips-mcp/<versión>` responda.
 
 Inicia sesión y publica en un mismo comando — el token del registro caduca a los cinco minutos — y el
 dominio se verifica por HTTP, no por DNS: `instantclips.ai/.well-known/mcp-registry-auth`, en el

package/README.md

@@ -200,18 +200,21 @@ The workflow, in order:
 
 1. **Import** — `import_product_from_url` for a store page, or `create_product_from_images` when
    there is no page to read.
-2. **Wait for the draft** — poll `get_product` until the import and the plan have finished.
-3. **Read and steer it** — the plan comes back as text for the user to review.
-   `update_video_direction` changes anything in it, `redraft_video_direction` asks for another
-   angle.
+2. **Wait for the import** — poll `get_product` until `import_status` is "imported".
+3. **Choose the idea, then read the plan** — offer the product's `ideas`, as the website does. The
+   user's pick, or their own words, goes in `update_video_direction`'s `creator_note`, which writes
+   the plan; `redraft_video_direction` with no idea picks one for them. The plan comes back as
+   text for the user to review, and `update_video_direction` changes anything in it.
 4. **Generate** — `generate_video`, passing `expected_credit_cost`: the cost the user was told, as
    `get_product` reported it. A mismatch is refused without charging.
-5. **Collect** — poll `get_video` for the finished MP4 and a public share link.
+5. **Collect** — poll `get_video` until it is done, then give the user `download_url`, the video's
+   own page and its public share link.
 
 Another video for the same product is the same flow on that product: editing or redrafting opens the
 next video's draft, and `generate_video` with no draft renders another take of the last plan. A
 generated video itself cannot be changed. Every `get_product` response carries `next_step`: what to
-do now.
+do now. Once the user has watched a video, `rate_video` records their verdict; `send_feedback` sends
+the team a note about the tools themselves, with the user's OK.
 
 Brands work the same way: `list_brands`, `create_brand`, `set_product_brand`. Every video is
 drafted in a brand's voice, so an import whose storefront matches no existing brand stops and asks
@@ -274,8 +277,16 @@ Publish the npm package first, then re-publish this same registry entry with
 `ai.instantclips` namespace; do not replace it with an `io.github.*` name. The signing key stays out
 of the repository — `.gitignore` covers `*.pem`, and a committed private key is a published one.
 
-`npm publish` asks for a one-time confirmation in the browser, so run it in an interactive
-terminal: from a script it stops with `EOTP` and publishes nothing.
+npm is published from GitHub Actions, not from a laptop. Commit the version bump (`package.json`,
+`server.json`, and the pins in `test/shim.test.js`), then push a tag named for it
+(`git tag v1.7.2 && git push origin main v1.7.2`); `.github/workflows/publish.yml` runs the tests
+and publishes through npm's trusted publishing, with no npm token and no browser confirmation. The job stops if the tag does not match `package.json`'s `version`. The package's
+trusted publisher on npmjs.com names this repository and `publish.yml`, so renaming the workflow
+file breaks publishing.
+
+A new version can take several minutes to appear on npm, and the registry refuses an entry whose
+npm version it cannot find ("version … was not found"; nothing changes). Run the `mcp-publisher`
+step once `https://registry.npmjs.org/instantclips-mcp/<version>` answers.
 
 Log in and publish in one command — the registry token expires five minutes after login — and the
 domain is verified over HTTP, not DNS: `instantclips.ai/.well-known/mcp-registry-auth` on the marketing site

package/README.zh-CN.md

@@ -183,16 +183,18 @@ INSTANTCLIPS_TOKEN="your-token" npx -y instantclips-mcp --check --json
 
 1. **导入** — 如果有店铺商品页面，使用 `import_product_from_url`；如果没有可读取的页面，则使用
    `create_product_from_images`。
-2. **等待草稿** — 轮询 `get_product`，直到商品导入和方案起草完成。
-3. **查看并调整** — 方案以文本返回，供用户审阅。
-   使用 `update_video_direction` 修改任何内容，或使用 `redraft_video_direction` 换一个角度。
+2. **等待导入** — 轮询 `get_product`，直到 `import_status` 为 "imported"。
+3. **选择创意，再查看方案** — 像网站一样，提供商品的 `ideas`。用户选中的创意或自己的描述放进
+   `update_video_direction` 的 `creator_note`，由它写出方案；不带创意调用 `redraft_video_direction`
+   则由我们选一个。方案以文本返回，供用户审阅，使用 `update_video_direction` 可修改其中任何内容。
 4. **生成** — 使用 `generate_video`，并传入 `expected_credit_cost`：即 `get_product` 报告并已告知用户的
    算力费用。费用不一致时会拒绝执行，不会扣费。
-5. **获取结果** — 轮询 `get_video`，获取完成的 MP4 文件和公开分享链接。
+5. **获取结果** — 轮询 `get_video` 直到完成，然后把 `download_url`、视频自己的页面和公开分享链接交给用户。
 
 为同一商品制作另一个视频，走的是同一流程：编辑或重新起草会打开下一个视频的草稿；没有草稿时调用
 `generate_video` 会按上一方案再生成一版。已生成的视频本身无法修改。每次 `get_product` 的响应都带有
-`next_step`，说明下一步该做什么。
+`next_step`，说明下一步该做什么。用户看过视频后，`rate_video` 记录用户自己的评价；`send_feedback`
+经用户同意后，把关于这些工具本身的意见发给团队。
 
 品牌的操作方式相同：`list_brands`、`create_brand`、`set_product_brand`。每个视频都会采用对应品牌
 的表达风格进行起草。因此，当导入商品的店铺与任何现有品牌都不匹配时，流程会暂停并询问，而不是
@@ -252,7 +254,14 @@ npm 软件包中的 `mcpName` 必须与该注册表名称完全一致。仓库
 域名身份验证会保留品牌命名空间 `ai.instantclips`；请勿将其替换为 `io.github.*` 名称。签名密钥不
 存放在仓库中：`.gitignore` 已忽略 `*.pem`，因为一旦提交私钥，就等于公开了私钥。
 
-`npm publish` 需要在浏览器里做一次性确认，所以要在交互式终端里运行：在脚本里运行会以 `EOTP` 中止，什么也不发布。
+npm 软件包从 GitHub Actions 发布，而不是从个人电脑发布。先提交版本号的修改（`package.json`、`server.json` 以及 `test/shim.test.js` 中写死的版本号），再推送以该版本命名的标签
+（`git tag v1.7.2 && git push origin main v1.7.2`）；`.github/workflows/publish.yml` 会运行测试，并通过
+npm 的可信发布（trusted publishing）完成发布，不需要 npm 令牌，也不需要在浏览器里确认。标签与
+`package.json` 的 `version` 不一致时，任务会中止。npmjs.com 上该软件包的可信发布者指定了本仓库和
+`publish.yml`，所以重命名这个工作流文件会导致无法发布。
+
+新版本可能要过几分钟才会出现在 npm 上，而注册表会拒绝找不到对应 npm 版本的条目（"version … was not found"，不会有任何改动）。
+等 `https://registry.npmjs.org/instantclips-mcp/<版本>` 能返回结果后，再运行 `mcp-publisher` 这一步。
 
 登录和发布要在同一条命令里完成——注册表令牌登录五分钟后就会过期——域名验证走的是 HTTP 而非 DNS：营销站点上的
 `instantclips.ai/.well-known/mcp-registry-auth` 提供这把密钥的公钥部分（`v=MCPv1; k=ed25519; p=…`），