@manturhub/cli 0.3.0 → 0.5.0

package/bin/cli.js

@@ -3,6 +3,7 @@ import { saveConfig, loadConfig } from "../lib/config.js";
 import { apiFetch, pollJob } from "../lib/api.js";
 import { runMcpBridge } from "../lib/mcp.js";
 import { runInit, runMcpInstall } from "../lib/setup.js";
+import { skillLs, skillAdd } from "../lib/skill-install.js";
 import { maybeNotifyUpdate } from "../lib/update-check.js";
 import { readFileSync } from "node:fs";
 import { fileURLToPath } from "node:url";
@@ -43,6 +44,8 @@ const HELP = `manturhub — ManturHub 算子广场 CLI  v${VERSION}
   manturhub status <poll_url>         查异步任务状态（配合 run --no-wait）
   manturhub balance                   查询馒头余额
   manturhub init                      装「ManturHub 使用 skill」+ 写 agent 引导（推荐：让 agent 会用算子）
+  manturhub skill ls                  列出平台 Skill（业务成品流程，如爆款复刻）
+  manturhub skill add <slug>          安装 Skill 到 ~/.claude/skills/<slug>/
   manturhub mcp [--scope <域>]        启动 stdio MCP server（可选，给 MCP 原生客户端）
   manturhub mcp-install [--client x]  把 MCP 接进客户端（可选：claude-code/codex/cursor/claude-desktop/all）
   manturhub help | --version
@@ -258,6 +261,17 @@ async function main() {
       break;
     }
 
+    case "skill": {
+      const sub = args[1];
+      if (sub === "ls" || sub === "list") await skillLs();
+      else if (sub === "add" || sub === "install") await skillAdd(args[2]);
+      else {
+        console.error("用法: manturhub skill ls   |   manturhub skill add <slug>");
+        process.exit(1);
+      }
+      break;
+    }
+
     case "--version":
     case "-v":
       console.log(VERSION);

package/lib/setup.js

@@ -21,7 +21,7 @@ function guideBlock() {
 - 调用算子：\`manturhub run <算子ID> --json '{...入参...}'\`（异步算子会自动轮询到出结果，**别重复调用以免重复扣费**）
 - 上传本地文件：\`manturhub upload <文件>\` → 公网 URL（算子只接受公网 URL，本地路径非法）
 - 查余额：\`manturhub balance\`
-- 每个算子的入参字段见 ${HUB}/marketplace/<算子ID>（字段名必须精确，拼错会被静默忽略）
+- 查某算子的精确入参字段：\`manturhub describe <算子ID>\`（字段名必须精确，拼错会被静默忽略；也可看 ${HUB}/marketplace/<算子ID>）
 
 若运行 \`manturhub\` 时 stderr 出现「有新版」提示，请主动告知用户可运行 \`npm i -g @manturhub/cli@latest\` 更新。
 ${MARK_END}`;

package/lib/skill-install.js

@@ -0,0 +1,96 @@
+import { homedir, tmpdir } from "node:os";
+import { join } from "node:path";
+import { mkdirSync, writeFileSync, rmSync } from "node:fs";
+import { execFileSync } from "node:child_process";
+import { getKey, getBaseUrl } from "./config.js";
+
+// `manturhub skill ls` — 列出平台上线 Skill（公开元数据，无需 key）。
+export async function skillLs() {
+  let res;
+  try {
+    res = await fetch(getBaseUrl() + "/api/v1/skills");
+  } catch (e) {
+    console.error(`Skill 列表获取失败: ${e.message}`);
+    process.exit(1);
+  }
+  if (!res.ok) {
+    console.error(`Skill 列表获取失败（HTTP ${res.status}）`);
+    process.exit(1);
+  }
+  const data = await res.json();
+  const skills = data.skills || data || [];
+  console.log(`ManturHub 上线 Skill（${skills.length} 个）:\n`);
+  for (const s of skills) {
+    const slug = String(s.slug || "").padEnd(22);
+    const cat = s.category ? `[${s.category}]` : "";
+    const ver = s.version ? `v${s.version}` : "";
+    console.log(`  ${slug} ${s.name || ""}   ${cat} ${ver}`.trimEnd());
+  }
+  console.log(`\n用 \`manturhub skill add <slug>\` 安装到 ~/.claude/skills/，重启 Claude Code 后 /<slug> 触发。`);
+}
+
+// `manturhub skill add <slug>` — 下载安装包并解压到 ~/.claude/skills/<slug>/。
+export async function skillAdd(slug) {
+  if (!slug) {
+    console.error("用法: manturhub skill add <slug>   （先 `manturhub skill ls` 看可用 Skill）");
+    process.exit(1);
+  }
+  const key = getKey();
+  if (!key) {
+    console.error("下载 Skill 需 API Key。运行 `manturhub login --key sk-xxx`，或设置环境变量 MANTURHUB_KEY。");
+    process.exit(1);
+  }
+
+  const url = `${getBaseUrl()}/api/v1/skills/${encodeURIComponent(slug)}/download`;
+  // 手动处理 302：服务端返回预签名下载地址，跟随时不把 API Key 带去对象存储。
+  let res;
+  try {
+    res = await fetch(url, { headers: { "x-api-key": key }, redirect: "manual" });
+  } catch (e) {
+    console.error(`下载失败: ${e.message}`);
+    process.exit(1);
+  }
+  if (res.status === 401) {
+    console.error("API Key 无效或未授权（401）。");
+    process.exit(1);
+  }
+  if (res.status === 404) {
+    console.error(`Skill 不存在: ${slug}（用 \`manturhub skill ls\` 看可用列表）`);
+    process.exit(1);
+  }
+
+  let zipBuf;
+  if (res.status >= 300 && res.status < 400) {
+    const loc = res.headers.get("location");
+    if (!loc) {
+      console.error("下载重定向缺少 Location 头");
+      process.exit(1);
+    }
+    const zres = await fetch(loc);
+    if (!zres.ok) {
+      console.error(`安装包下载失败（HTTP ${zres.status}）`);
+      process.exit(1);
+    }
+    zipBuf = Buffer.from(await zres.arrayBuffer());
+  } else if (res.ok) {
+    zipBuf = Buffer.from(await res.arrayBuffer());
+  } else {
+    console.error(`下载失败（HTTP ${res.status}）`);
+    process.exit(1);
+  }
+
+  const dest = join(homedir(), ".claude", "skills", slug);
+  mkdirSync(dest, { recursive: true });
+  const tmp = join(tmpdir(), `manturhub-skill-${slug}-${process.pid}.zip`);
+  writeFileSync(tmp, zipBuf);
+  try {
+    execFileSync("unzip", ["-o", "-q", tmp, "-d", dest], { stdio: ["ignore", "ignore", "inherit"] });
+  } catch {
+    console.error(`解压失败（需系统 unzip 命令）。安装包已存到: ${tmp}`);
+    console.error(`可手动解压: unzip -o "${tmp}" -d "${dest}"`);
+    process.exit(1);
+  }
+  rmSync(tmp, { force: true });
+  console.log(`✓ 已安装 Skill「${slug}」→ ${dest}`);
+  console.log(`  重启 Claude Code 后，用 /${slug} <描述> 触发。`);
+}

package/lib/skill.js

@@ -7,12 +7,12 @@ import { join } from "node:path";
 // run 已自动轮询异步、upload 解决本地文件。内容只讲用法,不含上游供应商/内网地址/成本毛利。
 export const SKILL_MD = `---
 name: manturhub
-description: 调用 ManturHub 算子广场的 AI 能力(文生图/视频生成/视频理解/视频合成/语音合成/音色克隆/语音转写/电商文案/短剧拉片改编等 19 个算子)。当任务需要这类 AI 能力,或用户提到 manturhub / 算子 / 馒头 时使用;在 shell 里跑 \`manturhub\` 命令即可,无需 MCP。
+description: 调用 ManturHub 算子广场的 AI 能力(文生图/视频生成/视频理解/视频合成/语音合成/音色克隆/语音转写/电商文案/短剧拉片改编等,算子持续新增)。当任务需要这类 AI 能力,或用户提到 manturhub / 算子 / 馒头 时使用;在 shell 里跑 \`manturhub\` 命令即可,无需 MCP。
 ---
 
 # ManturHub 算子使用(CLI)
 
-本机已装 \`manturhub\` CLI,命令行直调平台 19 个 AI 算子。**任务需要 AI 能力(生图 / 生视频 / 视频理解 / 配音 / 音色克隆 / 语音转写 / 电商文案 / 短剧)时,优先用它,别自己造轮子。** 在 shell(Bash)里直接跑 \`manturhub\` 命令即可,**无需 MCP**。算子按调用扣「馒头」(平台积分)。
+本机已装 \`manturhub\` CLI,命令行直调平台上的 AI 算子。**任务需要 AI 能力(生图 / 生视频 / 视频理解 / 配音 / 音色克隆 / 语音转写 / 电商文案 / 短剧)时,优先用它,别自己造轮子。** 在 shell(Bash)里直接跑 \`manturhub\` 命令即可,**无需 MCP**。算子按调用扣「馒头」(平台积分)。
 
 ## 命令
 
@@ -39,16 +39,15 @@ description: 调用 ManturHub 算子广场的 AI 能力(文生图/视频生成/
 2. 有本地图片 / 视频 / 音频 → \`manturhub upload 文件\` 拿到公网 URL
 3. \`manturhub run <算子ID> --json '{...}'\` → 异步会自动等到出结果 → 从返回 JSON 取结果 URL
 
-## 19 个算子(按域速查;入参以 \`manturhub describe <算子ID>\` 为准)
+## 算子怎么找(实时查,别背清单)
 
-- **图像**:\`image2\`(文生图 / 图生图)
-- **视频**:\`op.video.generate\`(生成)· \`op.video.compose\`(合成拼接)· \`op.video.understand-v2\`(视频理解)· \`op.video.upscale\`(超分)· \`op.video.subtitle-remover\`(擦字幕)
-- **语音 / 音频**:\`op.voice.synthesize\`(合成)· \`op.voice.clone\`(克隆)· \`op.voice.design\`(音色设计)· \`op.audio.asr\`(语音转文字)
-- **文本**:\`op.text.commerce-copy\`(电商文案)
-- **短剧 / 拉片**:\`op.drama.search / episodes / download / adapt / insight\` · \`op.distill.list / shotscript / get-script\`
+平台算子持续新增,**不要记死有哪些算子**——永远用命令拿实时清单:
 
-> 例:\`manturhub run image2 --json '{"prompt":"a red fox in snow","n":1}'\`(异步,run 自动等到出图)。
-> 字段拼不准就 \`manturhub describe <算子ID>\`,别凭记忆猜。
+- \`manturhub ls\` → 全部上线算子(新上线的立刻出现);\`manturhub ls --cat video\` 按类筛(image / video / audio / text / data)
+- \`manturhub describe <算子ID>\` → 某算子的精确入参字段
+
+> 能力大类参考(具体算子 ID 以 \`ls\` 实时为准):图像生成、视频生成 / 合成 / 理解 / 超分 / 擦字幕、语音合成 / 克隆 / 音色设计 / 语音转写、电商文案、短剧搜索 / 拉片 / 改编。
+> 例:\`manturhub run image2 --json '{"prompt":"a red fox in snow","n":1}'\`(异步,run 自动等到出图)。字段拼不准就 \`manturhub describe <算子ID>\`,别凭记忆猜。
 `;
 
 // 装到用户级 ~/.claude/skills/manturhub/SKILL.md —— 装一次,所有 Claude Code 项目可用。

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@manturhub/cli",
-  "version": "0.3.0",
-  "description": "ManturHub 算子广场 CLI：命令行直调 AI 算子 + 给 Claude Code / Codex / Cursor 等当 stdio MCP server",
+  "version": "0.5.0",
+  "description": "ManturHub 算子广场 CLI：命令行直调 AI 算子 + 安装平台 Skill + 给 Claude Code / Codex / Cursor 等当 stdio MCP server",
   "type": "module",
   "bin": {
     "manturhub": "./bin/cli.js"