@manturhub/cli 0.1.1 → 0.1.3

package/bin/cli.js

@@ -2,8 +2,15 @@
 import { saveConfig, loadConfig } from "../lib/config.js";
 import { apiFetch } from "../lib/api.js";
 import { runMcpBridge } from "../lib/mcp.js";
-
-const VERSION = "0.1.0";
+import { runInit, runMcpInstall } from "../lib/setup.js";
+import { maybeNotifyUpdate } from "../lib/update-check.js";
+import { readFileSync } from "node:fs";
+import { fileURLToPath } from "node:url";
+import { dirname, join } from "node:path";
+
+const VERSION = JSON.parse(
+  readFileSync(join(dirname(fileURLToPath(import.meta.url)), "../package.json"), "utf8")
+).version;
 const args = process.argv.slice(2);
 const cmd = args[0];
 
@@ -21,24 +28,30 @@ const HELP = `manturhub — ManturHub 算子广场 CLI  v${VERSION}
   manturhub ls [--cat <分类>]         列出上线算子（分类: text/image/video/audio/data）
   manturhub run <算子ID> --json '{}'  调用算子（也可用 --字段 值 形式）
   manturhub balance                   查询馒头余额
+  manturhub init                      往项目写 agent 引导（CLAUDE.md/AGENTS.md/.cursorrules）
+  manturhub mcp-install [--client x]  一键把 MCP 接进客户端（claude-code/codex/cursor/claude-desktop/all）
   manturhub help | --version
 
 环境变量:
   MANTURHUB_KEY    API Key（优先于配置文件）
   MANTURHUB_BASE   网关地址（默认 https://hub.mantur.cn）
 
-把算子接进你的 AI（stdio，所有客户端都稳）:
+让 agent 自动用算子（推荐，无需让 agent 学命令）:
+  manturhub mcp-install --client all   一键把 MCP 接进 Claude Code / Codex / Cursor / Claude Desktop
+  manturhub init                       或让 agent 在 shell 里直接用 CLI（写引导到项目）
+
+手动接 MCP（stdio，所有客户端都稳；Key 由 manturhub login 自动读取）:
   Codex  ~/.codex/config.toml:
     [mcp_servers.manturhub]
     command = "manturhub"
     args = ["mcp"]
-    env = { MANTURHUB_KEY = "sk-xxx" }
 
-  Claude Desktop / Cursor:
+  Claude Code .mcp.json / Cursor / Claude Desktop:
     { "mcpServers": { "manturhub": { "command": "manturhub", "args": ["mcp"] } } }
 `;
 
 async function main() {
+  maybeNotifyUpdate(VERSION);
   switch (cmd) {
     case "login": {
       const key = getFlag("key");
@@ -67,6 +80,16 @@ async function main() {
       break;
     }
 
+    case "init": {
+      runInit();
+      break;
+    }
+
+    case "mcp-install": {
+      runMcpInstall(getFlag("client"));
+      break;
+    }
+
     case "ls": {
       const cat = getFlag("cat");
       const r = await apiFetch("/api/v1/operators?status=online");

package/lib/setup.js

@@ -0,0 +1,132 @@
+import { readFileSync, writeFileSync, mkdirSync, existsSync } from "node:fs";
+import { homedir } from "node:os";
+import { join, dirname } from "node:path";
+import { getKey } from "./config.js";
+
+const HUB = "https://hub.mantur.cn";
+
+// ───────────────────────── manturhub init ─────────────────────────
+// 往项目写一段 agent 引导，让 Claude Code / Codex / Cursor 知道用 manturhub CLI。
+const MARK_START = "<!-- manturhub:start -->";
+const MARK_END = "<!-- manturhub:end -->";
+
+function guideBlock() {
+  return `${MARK_START}
+## ManturHub 算子（AI 能力，命令行直调）
+
+本机已安装 \`manturhub\` CLI，可调用 ManturHub 算子广场的 AI 能力（文生图 / 视频生成 / 语音合成 / 视频理解 / 短剧 / 文案等）。**当任务需要这类 AI 能力时，优先用它，不要自己造轮子。**
+
+- 列出可用算子：\`manturhub ls\`（按类：\`manturhub ls --cat image|video|audio|text|data\`）
+- 调用算子：\`manturhub run <算子ID> --json '{...入参...}'\`
+- 查余额：\`manturhub balance\`
+- 每个算子的入参字段见 ${HUB}/marketplace/<算子ID>
+
+注意：视频 / 图像等**异步算子**返回 jobId，需按算子文档轮询取结果；这类场景更建议用 MCP（见 \`manturhub mcp-install\`，工具更完整、含任务状态查询）。
+
+若运行 \`manturhub\` 时 stderr 出现「有新版」提示，请主动告知用户可运行 \`npm i -g @manturhub/cli@latest\` 更新。
+${MARK_END}`;
+}
+
+function escapeRe(s) {
+  return s.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+}
+
+function upsertGuide(file) {
+  const block = guideBlock();
+  let content = existsSync(file) ? readFileSync(file, "utf8") : "";
+  const re = new RegExp(escapeRe(MARK_START) + "[\\s\\S]*?" + escapeRe(MARK_END));
+  if (re.test(content)) {
+    content = content.replace(re, block); // 幂等：替换旧块，不重复追加
+  } else {
+    content = content.trimEnd();
+    content = content ? content + "\n\n" + block + "\n" : block + "\n";
+  }
+  writeFileSync(file, content);
+}
+
+export function runInit() {
+  const targets = ["AGENTS.md", "CLAUDE.md", ".cursorrules"];
+  console.log("写入 agent 引导（幂等，可重复运行）：");
+  for (const t of targets) {
+    upsertGuide(join(process.cwd(), t));
+    console.log(`  ✓ ${t}`);
+  }
+  console.log(
+    `\nClaude Code 读 CLAUDE.md，Codex 读 AGENTS.md，Cursor 读 .cursorrules。` +
+      `\nagent 下次会话即可知道用 manturhub 调算子。`
+  );
+  if (!getKey()) console.log(`\n⚠ 还没配 Key，先跑：manturhub login --key sk-xxx`);
+}
+
+// ──────────────────────── manturhub mcp-install ────────────────────────
+// 把 manturhub MCP server 写进各 AI 客户端配置（自动合并，不覆盖已有其他 server）。
+// Key 由 manturhub login 存的 ~/.manturhub/config.json 自动读取，无需写进各配置。
+const SERVER_DEF = { command: "manturhub", args: ["mcp"] };
+
+function writeJsonMcp(file, label) {
+  mkdirSync(dirname(file), { recursive: true });
+  let cfg = {};
+  if (existsSync(file)) {
+    try {
+      cfg = JSON.parse(readFileSync(file, "utf8"));
+    } catch {
+      console.log(`  ⚠ ${label}: 现有文件不是合法 JSON，跳过 → ${file}`);
+      return;
+    }
+  }
+  cfg.mcpServers = cfg.mcpServers || {};
+  cfg.mcpServers.manturhub = { ...SERVER_DEF };
+  writeFileSync(file, JSON.stringify(cfg, null, 2) + "\n");
+  console.log(`  ✓ ${label}: ${file}`);
+}
+
+function writeTomlCodex(file, label) {
+  mkdirSync(dirname(file), { recursive: true });
+  let content = existsSync(file) ? readFileSync(file, "utf8") : "";
+  if (/\[mcp_servers\.manturhub\]/.test(content)) {
+    console.log(`  ✓ ${label}: 已存在 manturhub，未改动 → ${file}`);
+    return;
+  }
+  const section = `\n[mcp_servers.manturhub]\ncommand = "manturhub"\nargs = ["mcp"]\n`;
+  content = (content.trimEnd() + "\n" + section).replace(/^\n+/, "");
+  writeFileSync(file, content);
+  console.log(`  ✓ ${label}: ${file}`);
+}
+
+const CLIENTS = {
+  "claude-code": () =>
+    writeJsonMcp(join(process.cwd(), ".mcp.json"), "Claude Code (项目 .mcp.json)"),
+  "claude-desktop": () =>
+    writeJsonMcp(
+      join(homedir(), "Library/Application Support/Claude/claude_desktop_config.json"),
+      "Claude Desktop"
+    ),
+  cursor: () => writeJsonMcp(join(homedir(), ".cursor/mcp.json"), "Cursor"),
+  codex: () => writeTomlCodex(join(homedir(), ".codex/config.toml"), "Codex"),
+};
+
+export function runMcpInstall(client) {
+  if (!client) {
+    console.log(`把 ManturHub MCP 接进 AI 客户端（agent 自动发现算子工具，无需学命令）。\n`);
+    console.log(`一键写入（自动合并，不动你已有的其他 MCP server）：`);
+    console.log(`  manturhub mcp-install --client claude-code     # 项目 .mcp.json`);
+    console.log(`  manturhub mcp-install --client codex           # ~/.codex/config.toml`);
+    console.log(`  manturhub mcp-install --client cursor          # ~/.cursor/mcp.json`);
+    console.log(`  manturhub mcp-install --client claude-desktop  # Claude Desktop`);
+    console.log(`  manturhub mcp-install --client all             # 全部`);
+    console.log(`\nKey 由 \`manturhub login\` 的配置自动读取，无需写进各客户端配置。`);
+    return;
+  }
+  const names = client === "all" ? Object.keys(CLIENTS) : [client];
+  console.log("写入 MCP 配置：");
+  for (const n of names) {
+    const fn = CLIENTS[n];
+    if (!fn) {
+      console.log(`  未知客户端: ${n}（可选: ${Object.keys(CLIENTS).join(", ")}, all）`);
+      continue;
+    }
+    fn();
+  }
+  console.log(`\n完成。重启对应客户端即可看到 manturhub 的算子工具。`);
+  if (!getKey()) console.log(`⚠ 还没配 Key，MCP 启动会报错。先跑：manturhub login --key sk-xxx`);
+}

package/lib/update-check.js

@@ -0,0 +1,51 @@
+import { readFileSync, existsSync } from "node:fs";
+import { join, dirname } from "node:path";
+import { homedir } from "node:os";
+import { spawn } from "node:child_process";
+import { fileURLToPath } from "node:url";
+
+const CACHE = join(homedir(), ".manturhub", "update-check.json");
+const ONE_DAY = 24 * 60 * 60 * 1000;
+
+function isNewer(latest, current) {
+  const a = String(latest).split(".").map((n) => parseInt(n, 10) || 0);
+  const b = String(current).split(".").map((n) => parseInt(n, 10) || 0);
+  for (let i = 0; i < 3; i++) {
+    if (a[i] > b[i]) return true;
+    if (a[i] < b[i]) return false;
+  }
+  return false;
+}
+
+// 启动时调用：读本地缓存→落后则 stderr 提示；缓存超过一天→后台异步刷新（不阻塞本次）。
+// 永不抛错、永不写 stdout —— mcp 模式 stdout 是 JSON-RPC 流，绝不能污染。
+export function maybeNotifyUpdate(currentVersion) {
+  try {
+    let cache = {};
+    if (existsSync(CACHE)) {
+      try {
+        cache = JSON.parse(readFileSync(CACHE, "utf8"));
+      } catch {
+        cache = {};
+      }
+    }
+    if (cache.latest && isNewer(cache.latest, currentVersion)) {
+      process.stderr.write(
+        `\n⚠ manturhub 有新版 ${cache.latest}（当前 ${currentVersion}）。` +
+          `\n  更新: npm i -g @manturhub/cli@latest\n\n`
+      );
+    }
+    if (Date.now() - (cache.checkedAt || 0) > ONE_DAY) {
+      // 短命 CLI 进程里直接 fetch 会随进程退出被中断，改 spawn 一个 detached 子进程
+      // 去查 npm 并写缓存；父进程不等它（unref），下次启动读到结果再提示。
+      const script = join(dirname(fileURLToPath(import.meta.url)), "update-fetch.js");
+      const child = spawn(process.execPath, [script], {
+        detached: true,
+        stdio: "ignore",
+      });
+      child.unref();
+    }
+  } catch {
+    /* 检查更新绝不影响主命令 */
+  }
+}

package/lib/update-fetch.js

@@ -0,0 +1,38 @@
+// 后台短命子进程：查 npm latest 写缓存。由 update-check.js detached spawn，
+// 独立于主命令运行，任何失败都静默（更新检查永不打扰用户）。
+import { writeFileSync, readFileSync, mkdirSync } from "node:fs";
+import { join } from "node:path";
+import { homedir } from "node:os";
+
+const DIR = join(homedir(), ".manturhub");
+const CACHE = join(DIR, "update-check.json");
+
+function readPrev() {
+  try {
+    return JSON.parse(readFileSync(CACHE, "utf8"));
+  } catch {
+    return {};
+  }
+}
+
+try {
+  const res = await fetch("https://registry.npmjs.org/@manturhub/cli/latest", {
+    signal: AbortSignal.timeout(8000),
+    headers: { Accept: "application/json" },
+  });
+  mkdirSync(DIR, { recursive: true });
+  if (res.ok) {
+    const j = await res.json();
+    writeFileSync(CACHE, JSON.stringify({ latest: j.version, checkedAt: Date.now() }));
+  } else {
+    writeFileSync(CACHE, JSON.stringify({ ...readPrev(), checkedAt: Date.now() }));
+  }
+} catch {
+  // 失败也记下时间戳（保留已知 latest），避免每次启动都重试，一天后再查。
+  try {
+    mkdirSync(DIR, { recursive: true });
+    writeFileSync(CACHE, JSON.stringify({ ...readPrev(), checkedAt: Date.now() }));
+  } catch {
+    /* ignore */
+  }
+}

package/package.json

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