@manturhub/cli 0.5.5 → 0.6.0

package/bin/cli.js

@@ -4,6 +4,7 @@ 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 { suiteLs, suiteInstall } from "../lib/suite-install.js";
 import { maybeNotifyUpdate } from "../lib/update-check.js";
 import { readFileSync } from "node:fs";
 import { fileURLToPath } from "node:url";
@@ -46,6 +47,8 @@ const HELP = `manturhub — ManturHub 算子广场 CLI  v${VERSION}
   manturhub init                      装「ManturHub 使用 skill」+ 写 agent 引导（推荐：让 agent 会用算子）
   manturhub skill ls                  列出平台 Skill（业务成品流程，如爆款复刻）
   manturhub skill add <slug>          安装 Skill 到 ~/.claude/skills/<slug>/
+  manturhub suite ls                  列出 Agent 套件（多角色团队工作区，给 Agent 配一整个团队）
+  manturhub suite install <slug>      安装套件为工作目录 ./<slug>/（自动写入 API Key，任意 Agent 打开即用）
   manturhub recipe [关键词] [--cat x] 搜配方（已验证创作的效果+可复现参数；分类 video/image/script）
   manturhub recipe get <配方ID>       看配方提示词模板与调用参数（换掉 {占位符} 即可复刻）
   manturhub mcp [--scope <域>]        启动 stdio MCP server（可选，给 MCP 原生客户端）
@@ -274,6 +277,18 @@ async function main() {
       break;
     }
 
+    case "suite":
+    case "suites": {
+      const sub = args[1];
+      if (sub === "ls" || sub === "list" || sub === undefined) await suiteLs();
+      else if (sub === "install" || sub === "add") await suiteInstall(args[2], args[3]);
+      else {
+        console.error("用法: manturhub suite ls   |   manturhub suite install <slug> [目录]");
+        process.exit(1);
+      }
+      break;
+    }
+
     case "recipe":
     case "recipes": {
       const sub = args[1];

package/lib/setup.js

@@ -22,6 +22,7 @@ function guideBlock() {
 - 上传本地文件：\`manturhub upload <文件>\` → 公网 URL（算子只接受公网 URL，本地路径非法）
 - 查余额：\`manturhub balance\`
 - 查某算子的精确入参字段：\`manturhub describe <算子ID>\`（字段名必须精确，拼错会被静默忽略；也可看 ${HUB}/marketplace/<算子ID>）
+- Agent 套件（多角色团队工作区，如小说→短剧制作团队）：\`manturhub suite ls\` 看清单，\`manturhub suite install <slug>\` 装为工作目录——用户想「组个团队干一类完整业务」时先看有没有现成套件
 
 若运行 \`manturhub\` 时 stderr 出现「有新版」提示，请主动告知用户可运行 \`npm i -g @manturhub/cli@latest\` 更新。
 ${MARK_END}`;

package/lib/skill-install.js

@@ -22,7 +22,8 @@ export async function skillLs() {
     process.exit(1);
   }
   const data = await res.json();
-  const skills = data.skills || data || [];
+  // #456：套件（kind=suite）走 `manturhub suite ls`，这里只列常规 Skill
+  const skills = (data.skills || data || []).filter((s) => s.kind !== "suite");
   console.log(`ManturHub 上线 Skill（${skills.length} 个）:\n`);
   for (const s of skills) {
     const slug = String(s.slug || "").padEnd(22);

package/lib/skill.js

@@ -7,7 +7,7 @@ import { join } from "node:path";
 // run 已自动轮询异步、upload 解决本地文件。内容只讲用法,不含上游供应商/内网地址/成本毛利。
 export const SKILL_MD = `---
 name: manturhub
-description: 调用 ManturHub 算子广场的 AI 能力与行业数据(文生图/视频生成/视频理解/视频合成/花字/配字幕/配音/音色克隆/语音转写/电商文案/短剧拉片改编/剧本评估/Seedance提示词润色,以及漫剧·短剧热榜、爆量趋势、出海投放数据等市场洞察,算子持续新增),还有配方广场(已验证创作的效果+可复现参数,一键复刻同款)。这些场景优先在 shell 跑 \`manturhub\` 命令解决——查热榜/行业数据也用算子,别先上网页搜索;用户要生成视频/图片/剧本、或问「有什么风格推荐/怎么做出这种效果/有没有同款」时,先想到配方库;用户提到 manturhub / 算子 / 馒头 / 配方 时同样使用。无需 MCP。
+description: 调用 ManturHub 算子广场的 AI 能力与行业数据(文生图/视频生成/视频理解/视频合成/花字/配字幕/配音/音色克隆/语音转写/电商文案/短剧拉片改编/剧本评估/Seedance提示词润色,以及漫剧·短剧热榜、爆量趋势、出海投放数据等市场洞察,算子持续新增),还有配方广场(已验证创作的效果+可复现参数,一键复刻同款)与 Agent 套件(多角色团队工作区,如小说改短剧制作团队,manturhub suite 安装)。这些场景优先在 shell 跑 \`manturhub\` 命令解决——查热榜/行业数据也用算子,别先上网页搜索;用户要生成视频/图片/剧本、或问「有什么风格推荐/怎么做出这种效果/有没有同款」时,先想到配方库;用户要「组个团队干一类活」(如把小说改成短剧)时,先想到套件;用户提到 manturhub / 算子 / 馒头 / 配方 / 套件 时同样使用。无需 MCP。
 ---
 
 # ManturHub 算子使用(CLI)
@@ -26,6 +26,8 @@ description: 调用 ManturHub 算子广场的 AI 能力与行业数据(文生图
 | \`manturhub balance\` | 查馒头余额 |
 | \`manturhub recipe [关键词] [--cat video\\|image\\|script]\` | 搜配方(已验证创作:效果样片+可复现参数) |
 | \`manturhub recipe get <配方ID>\` | 拿配方的提示词模板与调用参数,换掉 {占位符} 即可复刻 |
+| \`manturhub suite ls\` | 列出 Agent 套件(多角色团队工作区,如小说→短剧制作团队) |
+| \`manturhub suite install <slug> [目录]\` | 安装套件为工作目录(自动写入 API Key),打开该目录即开工 |
 
 ## 五条铁律(不照做就会踩坑)
 
@@ -51,6 +53,10 @@ description: 调用 ManturHub 算子广场的 AI 能力与行业数据(文生图
 
 配方本身免费,复刻按算子正常计费(配方里标了成本)。用户粘来一段「请用 ManturHub 复刻这个配方…」的指令块时,照块内步骤执行即可。
 
+## Agent 套件(给 Agent 配一整个团队)
+
+套件 = 多角色团队工作区(角色分工 + 流程 + 知识库打包成一个工作目录),如「小说 → 短剧制作团队」。**用户想「组个团队干一类完整业务」(把小说改成短剧、批量出片这类多角色长流程)时,先 \`manturhub suite ls\` 看有没有现成套件**;有就 \`manturhub suite install <slug>\` 装到当前位置(自动写入 API Key),然后 cd 进该目录按其 AGENTS.md 开工。套件免费,干活按算子计费。网页版: https://hub.mantur.cn/skill?tab=suites
+
 ## 算子怎么找(实时查,别背清单)
 
 平台算子持续新增,**不要记死有哪些算子**——永远用命令拿实时清单:

package/lib/suite-install.js

@@ -0,0 +1,136 @@
+import { join, resolve } from "node:path";
+import { tmpdir } from "node:os";
+import { mkdirSync, writeFileSync, rmSync, existsSync, readFileSync } from "node:fs";
+import { execFileSync } from "node:child_process";
+import { getKey, getBaseUrl } from "./config.js";
+
+// #456 Agent 套件（团队版 Skill）：与 skill 共用 /api/v1/skills 元数据与下载端点，
+// 区别在安装形态——解压为当前目录下的工作目录（非 ~/.claude/skills），并把 API Key
+// 写进套件 .env，任意 Agent 打开该目录即可开工。
+
+// `manturhub suite ls` — 列出平台上线套件（kind=suite）。
+export async function suiteLs() {
+  let res;
+  try {
+    const key = getKey();
+    res = await fetch(getBaseUrl() + "/api/v1/skills", {
+      headers: key ? { "x-api-key": key } : {},
+    });
+  } catch (e) {
+    console.error(`套件列表获取失败: ${e.message}`);
+    process.exit(1);
+  }
+  if (!res.ok) {
+    console.error(`套件列表获取失败（HTTP ${res.status}）`);
+    process.exit(1);
+  }
+  const data = await res.json();
+  const suites = (data.skills || []).filter((s) => s.kind === "suite");
+  if (!suites.length) {
+    console.log("暂无上线套件。网页版: https://hub.mantur.cn/skill?tab=suites");
+    return;
+  }
+  console.log(`ManturHub Agent 套件（${suites.length} 个）:\n`);
+  for (const s of suites) {
+    const meta = s.suite_meta || {};
+    const roles = (meta.roles || []).map((r) => r.title).join("/");
+    console.log(`  ${String(s.slug || "").padEnd(22)} ${s.name || ""}${roles ? `   [${roles}]` : ""}`);
+    if (meta.cost_note) console.log(`  ${"".padEnd(22)} ${meta.cost_note}`);
+  }
+  console.log(`\n用 \`manturhub suite install <slug>\` 安装为工作目录，任意 Agent 打开即可开工。`);
+}
+
+// `manturhub suite install <slug> [目录]` — 下载套件包并解压为工作目录 + 注入 API Key。
+export async function suiteInstall(slug, dirArg) {
+  if (!slug) {
+    console.error("用法: manturhub suite install <slug> [目录]   （先 `manturhub suite ls` 看可用套件）");
+    process.exit(1);
+  }
+  const key = getKey();
+  if (!key) {
+    console.error("下载套件需 API Key。运行 `manturhub login --key sk-xxx`，或设置环境变量 MANTURHUB_KEY。");
+    process.exit(1);
+  }
+
+  const url = `${getBaseUrl()}/api/v1/skills/${encodeURIComponent(slug)}/download`;
+  // 手动处理 302：跟随预签名地址时不把 API Key 带去对象存储（同 skill add）。
+  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(`套件不存在: ${slug}（用 \`manturhub suite 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 = resolve(dirArg || `./${slug}`);
+  mkdirSync(dest, { recursive: true });
+  const tmp = join(tmpdir(), `manturhub-suite-${slug}-${process.pid}.zip`);
+  writeFileSync(tmp, zipBuf);
+  // bsdtar 正确处理 zip 内 UTF-8 文件名；unzip 兜底（同 skill add 的踩坑结论）。
+  const extractors = [
+    ["tar", ["-xf", tmp, "-C", dest]],
+    ["unzip", ["-o", "-q", tmp, "-d", dest]],
+  ];
+  let extracted = false;
+  for (const [cmd, cargs] of extractors) {
+    try {
+      execFileSync(cmd, cargs, { stdio: ["ignore", "ignore", "ignore"] });
+      extracted = true;
+      break;
+    } catch {
+      // 尝试下一个解压器
+    }
+  }
+  if (!extracted) {
+    console.error(`解压失败（需系统 tar 或 unzip 命令）。安装包已存到: ${tmp}`);
+    console.error(`可手动解压: tar -xf "${tmp}" -C "${dest}"`);
+    process.exit(1);
+  }
+  rmSync(tmp, { force: true });
+
+  // 注入 API Key：有 .env.example 按模板替换占位，否则直接写最小 .env；已有 .env 不覆盖。
+  const envPath = join(dest, ".env");
+  if (!existsSync(envPath)) {
+    let envBody = `MANTURHUB_KEY=${key}\n`;
+    const examplePath = join(dest, ".env.example");
+    if (existsSync(examplePath)) {
+      envBody = readFileSync(examplePath, "utf8")
+        .replace(/^(MANTURHUB_KEY\s*=).*$/m, `$1${key}`);
+      if (!/MANTURHUB_KEY/.test(envBody)) envBody += `\nMANTURHUB_KEY=${key}\n`;
+    }
+    writeFileSync(envPath, envBody, { mode: 0o600 });
+  }
+
+  console.log(`✓ 已安装套件「${slug}」→ ${dest}`);
+  console.log(`  API Key 已写入 ${join(dest, ".env")}`);
+  console.log(`\n下一步：用你的 Agent（Claude Code / Codex / Cursor…）打开该目录，直接说需求即可开工：`);
+  console.log(`  cd ${dest}`);
+}

package/package.json

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