museav-cli 3.0.2 → 3.1.0

package/.github/workflows/publish.yml

@@ -41,6 +41,20 @@ jobs:
           fi
           echo "版本一致：$PKG"
 
+      # 防空介绍（2026-08-29 教训）：发布卡片的内容取 CHANGELOG.md 顶部一节，
+      # npm version patch 不会写 CHANGELOG——不校验的话，卡片会带着上一个版本的旧介绍
+      # 发给所有租户群（3.0.2 就是这么把 3.0.1 的 reel-kit 内容发出去的）。
+      - name: 校验 CHANGELOG 顶部版本与发版一致
+        if: startsWith(github.ref, 'refs/tags/v')
+        run: |
+          TOP=$(awk '/^## /{print $2; exit}' CHANGELOG.md)
+          PKG=$(node -p "require('./package.json').version")
+          if [ "$TOP" != "$PKG" ]; then
+            echo "::error::CHANGELOG.md 顶部是 $TOP，与要发的 $PKG 不一致。发版前先写好本版本的更新说明（npm version 不会自动写）。"
+            exit 1
+          fi
+          echo "CHANGELOG 顶部版本一致：$TOP"
+
       - name: 冒烟测试（命令能起、版本对得上）
         run: |
           node dist/index.js --version

package/AGENTS.md

@@ -120,6 +120,28 @@ museav jobs --limit 10 --status failed
 museav products
 museav assets
 
+# Publish a local Agent Skill to Xiaohongshu SkillHub. NOT the same as `museav skills`
+# (that lists the platform's image-generation skills) — this ships a local SKILL.md
+# directory to 小红书 SkillHub. Packing, device-code auth, upload and submit are all done
+# by Xiaohongshu's own CLI (`redskillhub-upload`, a dependency of this package); museav is
+# just the entry point plus one guard rail.
+#
+# WITHOUT --yes it is a dry run: local pack + validation only, no login, no upload, no
+# submit. That's the default on purpose — a submit is irreversible (the Skill ID is the
+# platform's primary key and cannot be renamed across versions). Add --yes to really submit;
+# an unauthenticated --yes prints a QR code for the user to scan in the Xiaohongshu app.
+#
+# --tag is REQUIRED (the platform demands at least one content tag and there is no sane
+# default). List the live options first — do not hardcode them.
+museav skillhub tags
+museav skillhub publish ./my-skill --tag 效率工具,编程开发          # dry run, stdout: payload JSON
+museav skillhub publish ./my-skill --tag 效率工具 --yes             # real submit
+museav skillhub publish ./my-skill --tag 内容创作 --source repost --repost-source 知乎 --yes
+
+# Platform limits worth knowing before you package anything: text-ish extensions only
+# (.md/.js/.py/.json/.sh/.html/.css …; .mjs, .ts, .yaml and images are rejected outright),
+# 10MB per file, 30MB per bundle, and a SKILL.md must exist at the root.
+
 # Check who you're logged in as and whether the account is affiliated with a tenant
 # Works for both personal login and apiKey (platform account or tenant). For apiKey:
 #   platform-account → 账户: nickname + 邮箱 + 累计出图 + credits

package/CHANGELOG.md

@@ -1,5 +1,48 @@
 # Changelog
 
+## 3.1.0 (2026-09-08)
+
+### 发布 Skill 到小红书 SkillHub：`museav skillhub`
+
+本地写好的 Agent Skill 现在可以一条命令发到小红书 SkillHub，不用再单独记一套官方 CLI：
+
+```bash
+museav skillhub tags                                          # 查可选内容标签
+museav skillhub publish ./my-skill --tag 效率工具,编程开发       # 预演，不外发
+museav skillhub publish ./my-skill --tag 效率工具 --yes         # 真提交（扫码授权）
+```
+
+- 打包、设备码授权、上传、提交全部委托小红书官方 `redskillhub-upload`（已作为依赖内置），
+  **不重写平台协议**，平台改版跟着升依赖即可
+- **不带 `--yes` 一定不外发**：默认只跑 dry-run，把名称 / Skill ID / 版本 / 简介 / 来源 / 标签
+  摊出来给人核对。提交不可逆——Skill ID 是平台主键，跨版本不可改名
+- `--tag` 强制必填（平台要求且无合理默认），`--source` 默认 `original`；转载必须带
+  `--repost-source`，原创带了会被拒
+- 跟 `museav skills` 是两件事：那个查中台出图技能，这个发 Agent Skill
+
+> 注意平台只收文本类扩展名（`.md` / `.js` / `.py` / `.json` / `.sh` 等），`.mjs`、`.ts`、
+> `.yaml` 一律被拒；单文件 10MB、整包 30MB。
+
+## 3.0.3 (2026-08-29)
+
+### 批量出图：`gen --batch`，一次提交一批，不用再写循环
+
+电商套图、海报批量这种「一口气 N 张」的场景，原来要自己逐张提交、自己处理限流退避。
+现在把每条写进一个文件，一行一条，中台排队消化：
+
+```bash
+museav gen --batch prompts.txt --skill xhs-cover
+```
+
+- 每行一条（配合 `--skill` / `--template` 时是业务描述，否则是完整提示词）；
+  `#` 注释行和空行跳过，`--batch -` 读 stdin
+- `--ratio` / `--ref` / `--transparent` / `--project` 等选项作为公共参数作用于每一行
+- 撞限流自动等冷却后补交剩余项，**已提交的不会重复扣费**
+- 完成后按行序把图片 URL 逐行输出，方便接管道
+
+> 3.0.2 的发布卡片误带了 3.0.1 的旧介绍（发版时 CHANGELOG 未更新），本版一并修正。
+> 功能本体在 3.0.2 已可用，3.0.3 无代码变更。
+
 ## 3.0.1 (2026-08-28)
 
 ### 把 reel-kit 的推荐位做实

package/README.md

@@ -105,6 +105,7 @@
 | **语音**（直连小米 MiMo，需 `MIMO_API_KEY`） | 文字转语音 / 音色设计 / 音色克隆 | `speak` |
 | | 语音转文字 | `transcribe` |
 | **素材与统计** | 上传素材 / 查任务 / 查余额 / 查模型 / 查身份 | `upload` / `jobs` / `balance` / `models` / `whoami` |
+| **发布**（小红书 SkillHub） | 把本地 Agent Skill 发到小红书 SkillHub | `skillhub publish` |
 
 > 本地工具（`compress` / `remove-bg` / `upscale` / `remove-watermark`）**不用登录、不花一分钱**，装了就能用；其余命令需要一个凭证（个人 `login` 或租户 apiKey）。
 >
@@ -553,6 +554,56 @@ IMG=$(museav products | node -e "process.stdin.once('data',d=>console.log(JSON.p
 museav gen --template <模板id> --ref "$IMG"
 ```
 
+### 发布 Skill 到小红书 SkillHub `skillhub`
+
+> 2026-09-08 新增。跟 `museav skills` **不是一回事**：`skills` 查的是中台的出图技能，
+> `skillhub` 是把本地写好的 Agent Skill（`SKILL.md` 那种）发到小红书 SkillHub。
+
+打包、扫码授权、上传、提交全部由小红书官方 CLI [`redskillhub-upload`](https://www.npmjs.com/package/redskillhub-upload)
+完成（它是本包的依赖，装 museav 就带上了，不用另外全局装）。这里只做入口和护栏，
+**不重写平台协议**——平台改版跟着升依赖就行。
+
+```bash
+# 1. 先看可选内容标签（发布必须带，没有默认值）
+museav skillhub tags
+
+# 2. 预演：只本地打包 + 校验，不登录、不上传、不提交
+museav skillhub publish ./my-skill --tag 效率工具,编程开发
+
+# 3. 核对无误再真提交（未登录会出二维码，用小红书 App 扫）
+museav skillhub publish ./my-skill --tag 效率工具,编程开发 --yes
+```
+
+**不带 `--yes` 一定不会外发**——它只跑 dry-run 把待提交内容摊给你看：
+
+```
+待提交内容：
+  名称       museav-gen
+  Skill ID   museav-gen   ← 平台主键，提交后跨版本不可改
+  版本       0.1.0
+  简介       用 museav CLI 在命令行出图、出视频、读图逆向提示词。
+  来源       原创
+  标签       效率工具,编程开发
+```
+
+转载稿要多带一个来源，原创稿不许带：
+
+```bash
+museav skillhub publish ./my-skill --tag 内容创作 --source repost --repost-source 知乎 --yes
+```
+
+其他：`--identifier <kebab-case>` 显式指定 Skill ID（不传由官方 CLI 从名称/目录名派生，
+派生不出来会报错）；`museav skillhub whoami` 查登录态，`skillhub logout` 清凭证，
+`skillhub login --cancel` 取消等待中的扫码。
+
+几个平台限制，踩之前先知道：
+
+- **只收文本类文件**：`.md` / `.js` / `.py` / `.json` / `.sh` / `.html` / `.css` 等；
+  `.mjs`、`.ts`、`.yaml`、图片都会被拒（报「目录中包含不支持上传的文件」）
+- 单文件 10MB、整包 30MB 上限
+- 目录里必须有 `SKILL.md`
+- **Skill ID 是平台主键，提交后跨版本不可改名**，第一次提交前想清楚
+
 ## 编程调用
 
 CLI 背后是一个干净的 `StudioClient` class，也可以当库用：
@@ -593,6 +644,8 @@ console.log(r.sculpt.light)  // 光影分析
 | `whoami` | 查当前账户 + 租户归属（仅个人 login） | JSON |
 | `gen` | 出图 / 出视频（`--prompt` / `--skill` / `--template` 三选一；`--video` 切视频，`--image` 图生视频） | 图片/视频 URL |
 | `skills` | 查可用技能：私有 + 租户专属 + 公共库（配合 `gen --skill`） | slug 列表（每行一个） |
+| `skillhub tags` | 查小红书 SkillHub 的内容标签（发布必须带 `--tag`） | 中文标签名（每行一个） |
+| `skillhub publish <path>` | 发布本地 Skill 到小红书 SkillHub；默认只预演，`--yes` 才真提交 | 待提交载荷 JSON |
 | `templates` | 查可用图片模板（配合 `gen --template`） | JSON |
 | `templates create` | 新建图片模板，归属按账号身份自动关联租户 | 新模板 id |
 | `products` | 查所属租户自己的产品目录（数据在租户自己后台，非中台；仅租户 apiKey） | JSON |

package/dist/commands/skillhub.d.ts

@@ -0,0 +1,26 @@
+export interface SkillhubPublishOptions {
+    source?: string;
+    tag?: string;
+    repostSource?: string;
+    identifier?: string;
+    yes?: boolean;
+}
+/**
+ * 拼官方 publish 参数。抽成纯函数是为了能断言——参数拼错的代价是把错的
+ * source/tag 提交到平台，而 Skill ID 提交后跨版本不可改。
+ */
+export declare function buildPublishArgs(skillPath: string, opts: SkillhubPublishOptions): string[];
+/** museav skillhub tags —— 列平台实时内容标签。stdout 出中文名，一行一个，好接管道 */
+export declare function skillhubTags(): Promise<void>;
+/** museav skillhub whoami / logout / login [--cancel] —— 原样透传给官方 CLI */
+export declare function skillhubPassthrough(command: 'whoami' | 'logout' | 'login', opts?: {
+    cancel?: boolean;
+}): Promise<void>;
+/**
+ * museav skillhub publish —— 默认只做 dry-run（不登录、不上传、不提交），
+ * 把待提交载荷摊给人看；确认无误再加 --yes 真提交。
+ *
+ * 提交是外发且不可逆（Skill ID 是平台主键，跨版本不可改名），所以护栏不省：
+ * 没有 --yes 一律不出网提交。
+ */
+export declare function skillhubPublish(skillPath: string, opts: SkillhubPublishOptions): Promise<void>;

package/dist/commands/skillhub.js

@@ -0,0 +1,195 @@
+/**
+ * museav skillhub —— 把本地 Skill 发布到小红书 SkillHub。
+ *
+ * 这里只做**薄封装**：打包、设备码授权、上传、提交全部由官方 CLI
+ * `redskillhub-upload`（本包的 dependency）完成，我们不复制它的任何协议。
+ * 平台改版时升这条 dependency 就行，不用动这个文件。
+ *
+ * 官方 CLI 的输出契约（cli/output.mjs）：stdout 逐行 `RESULT_JSON:{...}` /
+ * `PROMPT:{...}` / `UPLOAD_PROGRESS:<n>`。我们只挑最后一行 RESULT_JSON 出摘要。
+ *
+ * 两个不能省的坑：
+ * 1. 官方 `--yes` 是**死 flag**——只在 parseArgs 里被赋值，全流程没有消费点。
+ *    要免交互提交，只能往 stdin 推 `submit\n`（官方 SKILL.md 也是这个口径）。
+ * 2. 缺 `--source` / `--tag` 时官方会转成交互提问读 stdin，和我们推的 `submit`
+ *    抢同一条管道。所以这两个参数在本层就补齐/校验，绝不让它进交互分支。
+ */
+import { createRequire } from 'node:module';
+import { spawn } from 'node:child_process';
+/** dry-run 只是本地打包 + 校验，两分钟够；真提交要等扫码授权，给 15 分钟 */
+const DRY_RUN_TIMEOUT_MS = 120_000;
+const PUBLISH_TIMEOUT_MS = 900_000;
+/**
+ * 定位官方 CLI 入口。走 createRequire 解析包内文件，而不是指望 PATH 上有
+ * `redskillhub-upload` 命令——它是我们的 dependency，不要求用户全局装过。
+ * 后面用 process.execPath 直接跑这个 .mjs，也就绕开了 .bin shim 与 Windows
+ * 的 .cmd 差异（AGENTS.md 的跨平台约定）。
+ */
+function cliEntry() {
+    const require = createRequire(import.meta.url);
+    try {
+        return require.resolve('redskillhub-upload/cli/index.mjs');
+    }
+    catch {
+        throw new Error('找不到官方上传 CLI（redskillhub-upload）。重装一次 museav 即可带上：npm i -g museav-cli');
+    }
+}
+/**
+ * 拼官方 publish 参数。抽成纯函数是为了能断言——参数拼错的代价是把错的
+ * source/tag 提交到平台，而 Skill ID 提交后跨版本不可改。
+ */
+export function buildPublishArgs(skillPath, opts) {
+    const tag = (opts.tag || '').trim();
+    if (!tag) {
+        throw new Error('缺 --tag：平台要求至少一个内容标签，且没有合理默认值。\n' +
+            '先看可选标签： museav skillhub tags\n' +
+            '再带上，多个用逗号分隔： museav skillhub publish <目录> --tag 效率工具,内容创作');
+    }
+    // 默认原创；转载必须说清来源，否则平台侧校验会拒
+    const source = (opts.source || 'original').trim();
+    if (source !== 'original' && source !== 'repost') {
+        throw new Error(`--source 只能是 original（原创）或 repost（转载），收到「${source}」`);
+    }
+    const repostSource = (opts.repostSource || '').trim();
+    if (source === 'repost' && !repostSource) {
+        throw new Error('--source repost 必须同时给 --repost-source <来源平台名>（15 字以内）');
+    }
+    if (source === 'original' && repostSource) {
+        throw new Error('--repost-source 只在 --source repost 时有意义，原创稿不要带');
+    }
+    // --agent 是官方验证过的调用形态（SKILL.md Step 2/3），让它走结构化输出而不是彩色 TUI
+    const args = [cliEntry(), 'publish', skillPath, '--agent', '--source', source, '--tag', tag];
+    if (repostSource)
+        args.push('--repost-source', repostSource);
+    if (opts.identifier)
+        args.push('--identifier', String(opts.identifier).trim());
+    if (!opts.yes)
+        args.push('--dry-run');
+    return args;
+}
+/** 取最后一行 RESULT_JSON 的载荷；官方在 dry-run/提交/取消/报错时都会写这一行 */
+function lastResultJson(stdout) {
+    const line = stdout.split('\n').filter((l) => l.startsWith('RESULT_JSON:')).at(-1);
+    if (!line)
+        return null;
+    try {
+        return JSON.parse(line.slice('RESULT_JSON:'.length));
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * 跑官方 CLI。capture=true 时收走两条流供解析（成功的 RESULT_JSON 在 stdout，
+ * 失败的在 stderr——见官方 index.mjs 顶层 catch），否则原样透传给终端（二维码/进度要人看见）。
+ * stderr 即使被 capture 也照样转发出去，不然人看不到失败原文。
+ */
+function runCli(args, { capture, feedStdin, timeoutMs }) {
+    return new Promise((resolve, reject) => {
+        const child = spawn(process.execPath, args, {
+            stdio: [feedStdin ? 'pipe' : 'ignore', capture ? 'pipe' : 'inherit', capture ? 'pipe' : 'inherit'],
+            timeout: timeoutMs,
+            killSignal: 'SIGTERM',
+        });
+        let stdout = '';
+        let stderr = '';
+        child.stdout?.on('data', (b) => {
+            stdout += b.toString();
+        });
+        child.stderr?.on('data', (b) => {
+            stderr += b.toString();
+            process.stderr.write(b);
+        });
+        if (feedStdin) {
+            // confirm 阶段之前官方不读 stdin，先写进管道等它来取即可
+            child.stdin.on('error', () => { });
+            child.stdin.end(feedStdin);
+        }
+        child.on('error', reject);
+        child.on('close', (code, signal) => {
+            if (signal) {
+                reject(new Error(`官方 CLI 超时被终止（${Math.round(timeoutMs / 1000)}s，signal=${signal}）`));
+                return;
+            }
+            resolve({ code: code ?? 1, stdout, stderr });
+        });
+    });
+}
+/** museav skillhub tags —— 列平台实时内容标签。stdout 出中文名，一行一个，好接管道 */
+export async function skillhubTags() {
+    const { code, stdout, stderr } = await runCli([cliEntry(), 'tags'], { capture: true, timeoutMs: 30_000 });
+    const result = lastResultJson(stdout + stderr);
+    if (code !== 0 || !result || result.status !== 'ok') {
+        throw new Error(`拉标签失败：${result?.message || `官方 CLI 退出码 ${code}`}`);
+    }
+    const tags = result.tags || [];
+    if (!tags.length) {
+        process.stderr.write('平台没有返回可选标签\n');
+        return;
+    }
+    process.stderr.write(`SkillHub 内容标签（${tags.length} 个）:\n`);
+    for (const t of tags)
+        process.stderr.write(`  ${String(t.name || '').padEnd(16)} ${t.tagId ?? ''}\n`);
+    process.stderr.write('\n发布： museav skillhub publish <目录> --tag <中文名[,中文名...]>\n');
+    console.log(tags.map((t) => t.name).filter(Boolean).join('\n'));
+}
+/** museav skillhub whoami / logout / login [--cancel] —— 原样透传给官方 CLI */
+export async function skillhubPassthrough(command, opts = {}) {
+    const args = [cliEntry(), command];
+    if (command === 'login' && opts.cancel)
+        args.push('--cancel');
+    // login 要出二维码给人扫，不能 capture
+    const capture = command !== 'login';
+    const { code, stdout } = await runCli(args, {
+        capture,
+        timeoutMs: command === 'login' ? PUBLISH_TIMEOUT_MS : 30_000,
+    });
+    if (capture && stdout)
+        process.stdout.write(stdout);
+    if (code !== 0)
+        throw new Error(`官方 CLI ${command} 退出码 ${code}`);
+}
+/**
+ * museav skillhub publish —— 默认只做 dry-run（不登录、不上传、不提交），
+ * 把待提交载荷摊给人看；确认无误再加 --yes 真提交。
+ *
+ * 提交是外发且不可逆（Skill ID 是平台主键，跨版本不可改名），所以护栏不省：
+ * 没有 --yes 一律不出网提交。
+ */
+export async function skillhubPublish(skillPath, opts) {
+    const args = buildPublishArgs(skillPath, opts);
+    if (!opts.yes) {
+        process.stderr.write(`预演发布 ${skillPath}（dry-run，不上传不提交）...\n`);
+        const { code, stdout, stderr } = await runCli(args, { capture: true, timeoutMs: DRY_RUN_TIMEOUT_MS });
+        const result = lastResultJson(stdout + stderr);
+        if (code !== 0 || !result || result.status === 'error') {
+            const why = result?.message || `官方 CLI 退出码 ${code}`;
+            // 官方只说「移除后重试」，不说什么能留。白名单是它的规则（pack.mjs），不在这里复制一份，
+            // 只点一句最常踩的：.mjs / .ts / .yaml 这些都不在名单里。
+            const hint = why.includes('不支持上传的文件')
+                ? '\n提示：平台只收文本类扩展名（.md / .js / .py / .json / .sh 等），.mjs、.ts、.yaml 都不在名单里——改扩展名或把该文件移出 skill 目录'
+                : '';
+            throw new Error(`预演失败：${why}${hint}`);
+        }
+        const p = result.payload || {};
+        process.stderr.write('待提交内容：\n');
+        process.stderr.write(`  名称       ${p.name ?? ''}\n`);
+        process.stderr.write(`  Skill ID   ${p.skill_identifier ?? ''}   ← 平台主键，提交后跨版本不可改\n`);
+        process.stderr.write(`  版本       ${p.version ?? ''}\n`);
+        process.stderr.write(`  简介       ${p.description ?? ''}\n`);
+        process.stderr.write(`  来源       ${p.original ? '原创' : `转载 · ${p.repost_source || ''}`}\n`);
+        process.stderr.write(`  标签       ${opts.tag}\n`);
+        process.stderr.write(`\n核对无误后真提交（会要求小红书 App 扫码授权）：\n`);
+        process.stderr.write(`  museav skillhub publish ${skillPath} --tag ${opts.tag} --yes\n`);
+        console.log(JSON.stringify(p));
+        return;
+    }
+    process.stderr.write(`发布 ${skillPath} 到 SkillHub...\n`);
+    process.stderr.write('未登录会先出二维码，用小红书 App 扫一下；授权后同一进程继续上传\n');
+    // 官方 --yes 是死 flag，免交互提交只能推 stdin；参数已在 buildPublishArgs 里补齐，
+    // 不会有别的提问来抢这个 submit
+    const { code } = await runCli(args, { capture: false, feedStdin: 'submit\n', timeoutMs: PUBLISH_TIMEOUT_MS });
+    if (code !== 0)
+        throw new Error(`发布失败（官方 CLI 退出码 ${code}），上面的 RESULT_JSON 有具体原因`);
+    process.stderr.write('✅ 已提交，等平台审核\n');
+}

package/dist/index.js

@@ -21,6 +21,7 @@ import { imageToTemplate } from './commands/image-to-template.js';
 import { upload } from './commands/upload.js';
 import { models } from './commands/models.js';
 import { skills } from './commands/skills.js';
+import { skillhubTags, skillhubPublish, skillhubPassthrough } from './commands/skillhub.js';
 import { templates, createTemplate } from './commands/templates.js';
 import { videoTemplates, createVideoTemplate } from './commands/video-templates.js';
 import { balance } from './commands/balance.js';
@@ -313,6 +314,39 @@ program
     .description('查可用技能：自己的私有技能 + 所属租户专属模板 + 公共技能库')
     .option('--genre <name>', '按分类过滤，如 电商 / 人像写真')
     .action(withClient((client, opts) => skills(client, opts)));
+// skillhub 跟上面的 skills 是两回事：skills 查的是中台出图技能，skillhub 是把
+// 本地 Agent Skill 发到小红书 SkillHub。打包/授权/上传/提交全由官方
+// redskillhub-upload 完成，这里只是入口 + 提交护栏，见 commands/skillhub.ts 顶部注释。
+const skillhubCmd = program
+    .command('skillhub')
+    .description('把本地 Skill 发布到小红书 SkillHub（不带子命令时列可选内容标签）')
+    .action(asyncRun(() => skillhubTags()));
+skillhubCmd
+    .command('tags')
+    .description('列平台实时内容标签（发布必须带 --tag，没有默认值）')
+    .action(asyncRun(() => skillhubTags()));
+skillhubCmd
+    .command('publish <path>')
+    .description('发布本地 Skill 目录或 .zip 源包。默认只预演（dry-run，不登录不上传），加 --yes 才真提交')
+    .requiredOption('--tag <中文名>', '内容标签，多个用逗号分隔；清单见 museav skillhub tags')
+    .option('--source <type>', '内容来源：original（原创，默认） / repost（转载）', 'original')
+    .option('--repost-source <来源>', '转载来源平台名（15 字以内），--source repost 时必填')
+    .option('--identifier <id>', 'Skill ID（kebab-case，平台主键，跨版本不可改）；不传由官方 CLI 从名称/目录名派生')
+    .option('--yes', '真提交（会要求用小红书 App 扫码授权）；不带则只预演')
+    .action(asyncRun((path, opts) => skillhubPublish(path, opts)));
+skillhubCmd
+    .command('whoami')
+    .description('查 SkillHub 登录态（脱敏）')
+    .action(asyncRun(() => skillhubPassthrough('whoami')));
+skillhubCmd
+    .command('login')
+    .description('显式预登录（正常发布会自动登录，这条只用于诊断）')
+    .option('--cancel', '取消等待中的授权，并清理待授权状态与二维码')
+    .action(asyncRun((opts) => skillhubPassthrough('login', opts)));
+skillhubCmd
+    .command('logout')
+    .description('退出 SkillHub 登录（清除本地凭证）')
+    .action(asyncRun(() => skillhubPassthrough('logout')));
 const templatesCmd = program
     .command('templates')
     .description('查可用图片/文字模板：自己租户建的 + 平台共享的（跟技能是两套不同的机制，见 gen --template）')

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "museav-cli",
-  "version": "3.0.2",
+  "version": "3.1.0",
   "description": "MUSE AV 出图中台官方 CLI —— 命令行调中台 API 出图、出视频、读图逆向、图生模板",
   "type": "module",
   "bin": {
@@ -18,7 +18,8 @@
   "scripts": {
     "build": "tsc",
     "dev": "tsx src/index.ts",
-    "prepublishOnly": "npm run build"
+    "prepublishOnly": "npm run build",
+    "test": "node --test test/*.test.mjs"
   },
   "engines": {
     "node": ">=20.19"
@@ -39,6 +40,7 @@
   "license": "MIT",
   "dependencies": {
     "commander": "^14.0.3",
+    "redskillhub-upload": "^1.0.2",
     "update-notifier": "^7.3.1"
   },
   "devDependencies": {
@@ -53,7 +55,7 @@
     "access": "public"
   },
   "optionalDependencies": {
-    "sharp": "^0.35.3",
-    "onnxruntime-node": "^1.27.0"
+    "onnxruntime-node": "^1.27.0",
+    "sharp": "^0.35.3"
   }
 }

package/src/commands/skillhub.ts

@@ -0,0 +1,214 @@
+/**
+ * museav skillhub —— 把本地 Skill 发布到小红书 SkillHub。
+ *
+ * 这里只做**薄封装**：打包、设备码授权、上传、提交全部由官方 CLI
+ * `redskillhub-upload`（本包的 dependency）完成，我们不复制它的任何协议。
+ * 平台改版时升这条 dependency 就行，不用动这个文件。
+ *
+ * 官方 CLI 的输出契约（cli/output.mjs）：stdout 逐行 `RESULT_JSON:{...}` /
+ * `PROMPT:{...}` / `UPLOAD_PROGRESS:<n>`。我们只挑最后一行 RESULT_JSON 出摘要。
+ *
+ * 两个不能省的坑：
+ * 1. 官方 `--yes` 是**死 flag**——只在 parseArgs 里被赋值，全流程没有消费点。
+ *    要免交互提交，只能往 stdin 推 `submit\n`（官方 SKILL.md 也是这个口径）。
+ * 2. 缺 `--source` / `--tag` 时官方会转成交互提问读 stdin，和我们推的 `submit`
+ *    抢同一条管道。所以这两个参数在本层就补齐/校验，绝不让它进交互分支。
+ */
+import { createRequire } from 'node:module'
+import { spawn } from 'node:child_process'
+
+/** dry-run 只是本地打包 + 校验，两分钟够；真提交要等扫码授权，给 15 分钟 */
+const DRY_RUN_TIMEOUT_MS = 120_000
+const PUBLISH_TIMEOUT_MS = 900_000
+
+export interface SkillhubPublishOptions {
+  source?: string
+  tag?: string
+  repostSource?: string
+  identifier?: string
+  yes?: boolean
+}
+
+/**
+ * 定位官方 CLI 入口。走 createRequire 解析包内文件，而不是指望 PATH 上有
+ * `redskillhub-upload` 命令——它是我们的 dependency，不要求用户全局装过。
+ * 后面用 process.execPath 直接跑这个 .mjs，也就绕开了 .bin shim 与 Windows
+ * 的 .cmd 差异（AGENTS.md 的跨平台约定）。
+ */
+function cliEntry(): string {
+  const require = createRequire(import.meta.url)
+  try {
+    return require.resolve('redskillhub-upload/cli/index.mjs')
+  } catch {
+    throw new Error(
+      '找不到官方上传 CLI（redskillhub-upload）。重装一次 museav 即可带上：npm i -g museav-cli',
+    )
+  }
+}
+
+/**
+ * 拼官方 publish 参数。抽成纯函数是为了能断言——参数拼错的代价是把错的
+ * source/tag 提交到平台，而 Skill ID 提交后跨版本不可改。
+ */
+export function buildPublishArgs(skillPath: string, opts: SkillhubPublishOptions): string[] {
+  const tag = (opts.tag || '').trim()
+  if (!tag) {
+    throw new Error(
+      '缺 --tag：平台要求至少一个内容标签，且没有合理默认值。\n' +
+      '先看可选标签： museav skillhub tags\n' +
+      '再带上，多个用逗号分隔： museav skillhub publish <目录> --tag 效率工具,内容创作',
+    )
+  }
+
+  // 默认原创；转载必须说清来源，否则平台侧校验会拒
+  const source = (opts.source || 'original').trim()
+  if (source !== 'original' && source !== 'repost') {
+    throw new Error(`--source 只能是 original（原创）或 repost（转载），收到「${source}」`)
+  }
+  const repostSource = (opts.repostSource || '').trim()
+  if (source === 'repost' && !repostSource) {
+    throw new Error('--source repost 必须同时给 --repost-source <来源平台名>（15 字以内）')
+  }
+  if (source === 'original' && repostSource) {
+    throw new Error('--repost-source 只在 --source repost 时有意义，原创稿不要带')
+  }
+
+  // --agent 是官方验证过的调用形态（SKILL.md Step 2/3），让它走结构化输出而不是彩色 TUI
+  const args = [cliEntry(), 'publish', skillPath, '--agent', '--source', source, '--tag', tag]
+  if (repostSource) args.push('--repost-source', repostSource)
+  if (opts.identifier) args.push('--identifier', String(opts.identifier).trim())
+  if (!opts.yes) args.push('--dry-run')
+  return args
+}
+
+/** 取最后一行 RESULT_JSON 的载荷；官方在 dry-run/提交/取消/报错时都会写这一行 */
+function lastResultJson(stdout: string): any {
+  const line = stdout.split('\n').filter((l) => l.startsWith('RESULT_JSON:')).at(-1)
+  if (!line) return null
+  try {
+    return JSON.parse(line.slice('RESULT_JSON:'.length))
+  } catch {
+    return null
+  }
+}
+
+/**
+ * 跑官方 CLI。capture=true 时收走两条流供解析（成功的 RESULT_JSON 在 stdout，
+ * 失败的在 stderr——见官方 index.mjs 顶层 catch），否则原样透传给终端（二维码/进度要人看见）。
+ * stderr 即使被 capture 也照样转发出去，不然人看不到失败原文。
+ */
+function runCli(
+  args: string[],
+  { capture, feedStdin, timeoutMs }: { capture: boolean; feedStdin?: string; timeoutMs: number },
+): Promise<{ code: number; stdout: string; stderr: string }> {
+  return new Promise((resolve, reject) => {
+    const child = spawn(process.execPath, args, {
+      stdio: [feedStdin ? 'pipe' : 'ignore', capture ? 'pipe' : 'inherit', capture ? 'pipe' : 'inherit'],
+      timeout: timeoutMs,
+      killSignal: 'SIGTERM',
+    })
+    let stdout = ''
+    let stderr = ''
+    child.stdout?.on('data', (b: Buffer) => {
+      stdout += b.toString()
+    })
+    child.stderr?.on('data', (b: Buffer) => {
+      stderr += b.toString()
+      process.stderr.write(b)
+    })
+    if (feedStdin) {
+      // confirm 阶段之前官方不读 stdin，先写进管道等它来取即可
+      child.stdin!.on('error', () => { /* 进程先退了，忽略断管 */ })
+      child.stdin!.end(feedStdin)
+    }
+    child.on('error', reject)
+    child.on('close', (code, signal) => {
+      if (signal) {
+        reject(new Error(`官方 CLI 超时被终止（${Math.round(timeoutMs / 1000)}s，signal=${signal}）`))
+        return
+      }
+      resolve({ code: code ?? 1, stdout, stderr })
+    })
+  })
+}
+
+/** museav skillhub tags —— 列平台实时内容标签。stdout 出中文名，一行一个，好接管道 */
+export async function skillhubTags(): Promise<void> {
+  const { code, stdout, stderr } = await runCli([cliEntry(), 'tags'], { capture: true, timeoutMs: 30_000 })
+  const result = lastResultJson(stdout + stderr)
+  if (code !== 0 || !result || result.status !== 'ok') {
+    throw new Error(`拉标签失败：${result?.message || `官方 CLI 退出码 ${code}`}`)
+  }
+  const tags: Array<{ name?: string; tagId?: string | number }> = result.tags || []
+  if (!tags.length) {
+    process.stderr.write('平台没有返回可选标签\n')
+    return
+  }
+  process.stderr.write(`SkillHub 内容标签（${tags.length} 个）:\n`)
+  for (const t of tags) process.stderr.write(`  ${String(t.name || '').padEnd(16)} ${t.tagId ?? ''}\n`)
+  process.stderr.write('\n发布： museav skillhub publish <目录> --tag <中文名[,中文名...]>\n')
+  console.log(tags.map((t) => t.name).filter(Boolean).join('\n'))
+}
+
+/** museav skillhub whoami / logout / login [--cancel] —— 原样透传给官方 CLI */
+export async function skillhubPassthrough(
+  command: 'whoami' | 'logout' | 'login',
+  opts: { cancel?: boolean } = {},
+): Promise<void> {
+  const args = [cliEntry(), command]
+  if (command === 'login' && opts.cancel) args.push('--cancel')
+  // login 要出二维码给人扫，不能 capture
+  const capture = command !== 'login'
+  const { code, stdout } = await runCli(args, {
+    capture,
+    timeoutMs: command === 'login' ? PUBLISH_TIMEOUT_MS : 30_000,
+  })
+  if (capture && stdout) process.stdout.write(stdout)
+  if (code !== 0) throw new Error(`官方 CLI ${command} 退出码 ${code}`)
+}
+
+/**
+ * museav skillhub publish —— 默认只做 dry-run（不登录、不上传、不提交），
+ * 把待提交载荷摊给人看；确认无误再加 --yes 真提交。
+ *
+ * 提交是外发且不可逆（Skill ID 是平台主键，跨版本不可改名），所以护栏不省：
+ * 没有 --yes 一律不出网提交。
+ */
+export async function skillhubPublish(skillPath: string, opts: SkillhubPublishOptions): Promise<void> {
+  const args = buildPublishArgs(skillPath, opts)
+
+  if (!opts.yes) {
+    process.stderr.write(`预演发布 ${skillPath}（dry-run，不上传不提交）...\n`)
+    const { code, stdout, stderr } = await runCli(args, { capture: true, timeoutMs: DRY_RUN_TIMEOUT_MS })
+    const result = lastResultJson(stdout + stderr)
+    if (code !== 0 || !result || result.status === 'error') {
+      const why = result?.message || `官方 CLI 退出码 ${code}`
+      // 官方只说「移除后重试」，不说什么能留。白名单是它的规则（pack.mjs），不在这里复制一份，
+      // 只点一句最常踩的：.mjs / .ts / .yaml 这些都不在名单里。
+      const hint = why.includes('不支持上传的文件')
+        ? '\n提示：平台只收文本类扩展名（.md / .js / .py / .json / .sh 等），.mjs、.ts、.yaml 都不在名单里——改扩展名或把该文件移出 skill 目录'
+        : ''
+      throw new Error(`预演失败：${why}${hint}`)
+    }
+    const p = result.payload || {}
+    process.stderr.write('待提交内容：\n')
+    process.stderr.write(`  名称       ${p.name ?? ''}\n`)
+    process.stderr.write(`  Skill ID   ${p.skill_identifier ?? ''}   ← 平台主键，提交后跨版本不可改\n`)
+    process.stderr.write(`  版本       ${p.version ?? ''}\n`)
+    process.stderr.write(`  简介       ${p.description ?? ''}\n`)
+    process.stderr.write(`  来源       ${p.original ? '原创' : `转载 · ${p.repost_source || ''}`}\n`)
+    process.stderr.write(`  标签       ${opts.tag}\n`)
+    process.stderr.write(`\n核对无误后真提交（会要求小红书 App 扫码授权）：\n`)
+    process.stderr.write(`  museav skillhub publish ${skillPath} --tag ${opts.tag} --yes\n`)
+    console.log(JSON.stringify(p))
+    return
+  }
+
+  process.stderr.write(`发布 ${skillPath} 到 SkillHub...\n`)
+  process.stderr.write('未登录会先出二维码，用小红书 App 扫一下；授权后同一进程继续上传\n')
+  // 官方 --yes 是死 flag，免交互提交只能推 stdin；参数已在 buildPublishArgs 里补齐，
+  // 不会有别的提问来抢这个 submit
+  const { code } = await runCli(args, { capture: false, feedStdin: 'submit\n', timeoutMs: PUBLISH_TIMEOUT_MS })
+  if (code !== 0) throw new Error(`发布失败（官方 CLI 退出码 ${code}），上面的 RESULT_JSON 有具体原因`)
+  process.stderr.write('✅ 已提交，等平台审核\n')
+}

package/src/index.ts

@@ -21,6 +21,7 @@ import { imageToTemplate } from './commands/image-to-template.js'
 import { upload } from './commands/upload.js'
 import { models } from './commands/models.js'
 import { skills } from './commands/skills.js'
+import { skillhubTags, skillhubPublish, skillhubPassthrough } from './commands/skillhub.js'
 import { templates, createTemplate } from './commands/templates.js'
 import { videoTemplates, createVideoTemplate } from './commands/video-templates.js'
 import { balance } from './commands/balance.js'
@@ -339,6 +340,45 @@ program
   .option('--genre <name>', '按分类过滤，如 电商 / 人像写真')
   .action(withClient((client: StudioClient, opts: any) => skills(client, opts)))
 
+// skillhub 跟上面的 skills 是两回事：skills 查的是中台出图技能，skillhub 是把
+// 本地 Agent Skill 发到小红书 SkillHub。打包/授权/上传/提交全由官方
+// redskillhub-upload 完成，这里只是入口 + 提交护栏，见 commands/skillhub.ts 顶部注释。
+const skillhubCmd = program
+  .command('skillhub')
+  .description('把本地 Skill 发布到小红书 SkillHub（不带子命令时列可选内容标签）')
+  .action(asyncRun(() => skillhubTags()))
+
+skillhubCmd
+  .command('tags')
+  .description('列平台实时内容标签（发布必须带 --tag，没有默认值）')
+  .action(asyncRun(() => skillhubTags()))
+
+skillhubCmd
+  .command('publish <path>')
+  .description('发布本地 Skill 目录或 .zip 源包。默认只预演（dry-run，不登录不上传），加 --yes 才真提交')
+  .requiredOption('--tag <中文名>', '内容标签，多个用逗号分隔；清单见 museav skillhub tags')
+  .option('--source <type>', '内容来源：original（原创，默认） / repost（转载）', 'original')
+  .option('--repost-source <来源>', '转载来源平台名（15 字以内），--source repost 时必填')
+  .option('--identifier <id>', 'Skill ID（kebab-case，平台主键，跨版本不可改）；不传由官方 CLI 从名称/目录名派生')
+  .option('--yes', '真提交（会要求用小红书 App 扫码授权）；不带则只预演')
+  .action(asyncRun((path: string, opts: any) => skillhubPublish(path, opts)))
+
+skillhubCmd
+  .command('whoami')
+  .description('查 SkillHub 登录态（脱敏）')
+  .action(asyncRun(() => skillhubPassthrough('whoami')))
+
+skillhubCmd
+  .command('login')
+  .description('显式预登录（正常发布会自动登录，这条只用于诊断）')
+  .option('--cancel', '取消等待中的授权，并清理待授权状态与二维码')
+  .action(asyncRun((opts: any) => skillhubPassthrough('login', opts)))
+
+skillhubCmd
+  .command('logout')
+  .description('退出 SkillHub 登录（清除本地凭证）')
+  .action(asyncRun(() => skillhubPassthrough('logout')))
+
 const templatesCmd = program
   .command('templates')
   .description('查可用图片/文字模板：自己租户建的 + 平台共享的（跟技能是两套不同的机制，见 gen --template）')

package/test/skillhub.test.mjs

@@ -0,0 +1,42 @@
+/**
+ * skillhub 参数拼装自检：这里错的代价是把错的 source/tag 提交到平台，
+ * 而 Skill ID 提交后跨版本不可改，所以校验分支必须有断言兜着。
+ * 跑： npm test（需要先 npm run build）
+ */
+import { test } from 'node:test'
+import assert from 'node:assert/strict'
+import { buildPublishArgs } from '../dist/commands/skillhub.js'
+
+test('缺 tag 直接拒，并指向 tags 命令', () => {
+  assert.throws(() => buildPublishArgs('/tmp/s', {}), /缺 --tag[\s\S]*skillhub tags/)
+})
+
+test('source 只收 original / repost', () => {
+  assert.throws(() => buildPublishArgs('/tmp/s', { tag: '效率工具', source: '原创' }), /只能是 original/)
+})
+
+test('转载必须带来源，原创不许带', () => {
+  assert.throws(() => buildPublishArgs('/tmp/s', { tag: '效率工具', source: 'repost' }), /repost-source/)
+  assert.throws(
+    () => buildPublishArgs('/tmp/s', { tag: '效率工具', repostSource: '知乎' }),
+    /只在 --source repost 时有意义/,
+  )
+})
+
+test('默认原创，且不带 --yes 时强制 dry-run（不外发）', () => {
+  const args = buildPublishArgs('/tmp/s', { tag: '效率工具,编程开发' })
+  assert.deepEqual(args.slice(1), [
+    'publish', '/tmp/s', '--agent', '--source', 'original', '--tag', '效率工具,编程开发', '--dry-run',
+  ])
+})
+
+test('--yes 才去掉 dry-run，转载参数与 identifier 一并透传', () => {
+  const args = buildPublishArgs('/tmp/s', {
+    tag: '内容创作', source: 'repost', repostSource: '知乎', identifier: 'my-skill', yes: true,
+  })
+  assert.ok(!args.includes('--dry-run'))
+  assert.deepEqual(args.slice(1), [
+    'publish', '/tmp/s', '--agent', '--source', 'repost', '--tag', '内容创作',
+    '--repost-source', '知乎', '--identifier', 'my-skill',
+  ])
+})