@manturhub/cli 0.1.2 → 0.1.3

package/bin/cli.js

@@ -3,6 +3,7 @@ import { saveConfig, loadConfig } from "../lib/config.js";
 import { apiFetch } from "../lib/api.js";
 import { runMcpBridge } from "../lib/mcp.js";
 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";
@@ -50,6 +51,7 @@ const HELP = `manturhub — ManturHub 算子广场 CLI  v${VERSION}
 `;
 
 async function main() {
+  maybeNotifyUpdate(VERSION);
   switch (cmd) {
     case "login": {
       const key = getFlag("key");

package/lib/setup.js

@@ -22,6 +22,8 @@ function guideBlock() {
 - 每个算子的入参字段见 ${HUB}/marketplace/<算子ID>
 
 注意：视频 / 图像等**异步算子**返回 jobId，需按算子文档轮询取结果；这类场景更建议用 MCP（见 \`manturhub mcp-install\`，工具更完整、含任务状态查询）。
+
+若运行 \`manturhub\` 时 stderr 出现「有新版」提示，请主动告知用户可运行 \`npm i -g @manturhub/cli@latest\` 更新。
 ${MARK_END}`;
 }
 

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.2",
+  "version": "0.1.3",
   "description": "ManturHub 算子广场 CLI：命令行直调 AI 算子 + 给 Claude Code / Codex / Cursor 等当 stdio MCP server",
   "type": "module",
   "bin": {