@manturhub/cli 0.1.0 → 0.1.2

package/README.md

@@ -17,7 +17,7 @@ npm install -g @manturhub/cli
 ## 上手三步
 
 ```bash
-# 1. 配 Key（去 https://manturhub.leisurecat.cloud/dashboard 拿）
+# 1. 配 Key（去 https://hub.mantur.cn/dashboard 拿）
 manturhub login --key sk-你的key
 
 # 2. 验证（列出全部上线算子）
@@ -65,4 +65,4 @@ args = ["mcp", "--scope", "drama"]   # 只暴露剧本域算子
 `manturhub mcp` 不重新实现 MCP server,而是把客户端的 stdio JSON-RPC 消息转发到 ManturHub 已标准化的 Streamable HTTP MCP 端点(`/api/v1/mcp/<域>/mcp`),再把响应写回 stdout。工具发现、调用、计费全部在服务端完成,CLI 只做可靠的 stdio↔HTTP 桥接 —— 等于一个官方、可控的 mcp-remote。
 
 ---
-ManturHub 算子广场 · https://manturhub.leisurecat.cloud
+ManturHub 算子广场 · https://hub.mantur.cn

package/bin/cli.js

@@ -2,8 +2,14 @@
 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 { 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,20 +27,25 @@ 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://manturhub.leisurecat.cloud）
+  MANTURHUB_BASE   网关地址（默认 https://hub.mantur.cn）
+
+让 agent 自动用算子（推荐，无需让 agent 学命令）:
+  manturhub mcp-install --client all   一键把 MCP 接进 Claude Code / Codex / Cursor / Claude Desktop
+  manturhub init                       或让 agent 在 shell 里直接用 CLI（写引导到项目）
 
-把算子接进你的 AI（stdio，所有客户端都稳）:
+手动接 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"] } } }
 `;
 
@@ -67,6 +78,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");
@@ -80,7 +101,7 @@ async function main() {
       for (const o of ops) {
         console.log(`  ${o.id.padEnd(26)} ${o.name}   [${o.cat}]`);
       }
-      console.log(`\n用 \`manturhub run <算子ID> --json '{...}'\` 调用，参数见 ${"https://manturhub.leisurecat.cloud"}/marketplace/<算子ID>`);
+      console.log(`\n用 \`manturhub run <算子ID> --json '{...}'\` 调用，参数见 ${"https://hub.mantur.cn"}/marketplace/<算子ID>`);
       break;
     }
 

package/lib/config.js

@@ -11,7 +11,7 @@ import {
 // Local config lives at ~/.manturhub/config.json (chmod 600). Env vars win over it.
 const DIR = join(homedir(), ".manturhub");
 const FILE = join(DIR, "config.json");
-const DEFAULT_BASE = "https://manturhub.leisurecat.cloud";
+const DEFAULT_BASE = "https://hub.mantur.cn";
 
 export function loadConfig() {
   try {

package/lib/setup.js

@@ -0,0 +1,130 @@
+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\`，工具更完整、含任务状态查询）。
+${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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@manturhub/cli",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "ManturHub 算子广场 CLI：命令行直调 AI 算子 + 给 Claude Code / Codex / Cursor 等当 stdio MCP server",
   "type": "module",
   "bin": {
@@ -24,5 +24,5 @@
     "stdio"
   ],
   "license": "MIT",
-  "homepage": "https://manturhub.leisurecat.cloud"
+  "homepage": "https://hub.mantur.cn"
 }