siluzan-website-cli 1.0.1-beta.1 → 1.0.1-beta.2

package/README.md

@@ -1,6 +1,6 @@
 # siluzan-website-cli
 
-Siluzan **WordPress 站点管理** Skill CLI。安装后由 AI Agent 列出站点、新增/编辑页面、查看已装插件。
+Siluzan **WordPress 站点管理** Skill CLI。安装后由 AI Agent 列出站点、新增/编辑页面、安装 / 升级插件。
 
 ## 安装
 
@@ -21,9 +21,12 @@ siluzan-website pages add --site <guid> --title "关于我们" --content-file ab
 siluzan-website plugins list --site <guid>
 siluzan-website plugins catalog --site <guid>
 siluzan-website plugins install --site <guid> --slug <slug>
+siluzan-website plugins install --site <guid> --zip ./plugin.zip
+siluzan-website plugins update --site <guid> --plugin <plugin>
+siluzan-website plugins helper-status --site <guid>
 ```
 
-页面写入走站点上已有的 `zionbuilder/v1` visual-edit 接口（HTML → Builder）。插件安装 REST 尚未开放，本版只支持列出。
+页面写入走站点上已有的 `zionbuilder/v1` visual-edit 接口（HTML → Builder）。插件：目录用 `--slug`，外部用 `--zip`；helper 太旧时会先从镜像本地 zip 升级。
 
 ## 开发
 

package/dist/index.js

@@ -3995,15 +3995,70 @@ function register6(program2) {
 }
 
 // src/commands/plugins.ts
+import { readFileSync as readFileSync6, existsSync as existsSync3 } from "fs";
+import { basename as basename2, resolve as resolve2 } from "path";
+var MAX_ZIP_BYTES = 20 * 1024 * 1024;
 function pluginName(item) {
   if (typeof item.name === "string") return item.name;
   return item.name?.raw || item.name?.rendered || item.plugin || "";
 }
+function pluginKey(value) {
+  return value.replace(/\\/g, "/").replace(/\.php$/i, "").toLowerCase();
+}
 async function resolveTarget(opts) {
   const config = loadConfig();
   const site = await resolveSite(config, opts);
   return { config, site, base: trimTrailingSlash(site.url) };
 }
+function isRouteMissing(err) {
+  const msg = err.message || "";
+  return /HTTP 404/.test(msg) && /No route was found|rest_no_route/i.test(msg);
+}
+function readZipPayload(zipPath) {
+  const abs = resolve2(zipPath);
+  if (!existsSync3(abs)) {
+    console.error(`
+\u274C zip \u4E0D\u5B58\u5728\uFF1A${abs}
+`);
+    process.exit(1);
+  }
+  const buf = readFileSync6(abs);
+  if (buf.length > MAX_ZIP_BYTES) {
+    console.error("\n\u274C zip \u8D85\u8FC7 20MB\uFF0C\u8BF7\u6362\u66F4\u5C0F\u7684\u5305\n");
+    process.exit(1);
+  }
+  return {
+    filename: basename2(abs),
+    zip_base64: buf.toString("base64")
+  };
+}
+function printActionResult(result, site, base, okTitle) {
+  if (!result.success) {
+    console.error(`
+\u274C ${result.message || "\u7AD9\u70B9\u62D2\u7EDD\u4E86\u8FD9\u6B21\u64CD\u4F5C"}`);
+    if (result.code) console.error(`   code    : ${result.code}`);
+    process.exit(1);
+  }
+  console.log(result.already ? "\n\u2705 \u63D2\u4EF6\u5DF2\u5728\u7AD9\u70B9\u4E0A\uFF08\u5DF2\u542F\u7528\uFF09" : `
+\u2705 ${okTitle}`);
+  if (result.plugin) console.log(`   plugin : ${result.plugin}`);
+  if (result.version) console.log(`   \u7248\u672C   : ${result.version}`);
+  if (result.zip) console.log(`   zip    : ${result.zip}`);
+  if (result.message) console.log(`   \u8BF4\u660E   : ${result.message}`);
+  console.log(`   \u7AD9\u70B9   : ${site.name} (${base})
+`);
+}
+async function withHelperBootstrap(opts, target, run) {
+  try {
+    return await run();
+  } catch (e) {
+    const err = e;
+    if (!isRouteMissing(err)) throw err;
+    console.log("\u7AD9\u70B9 helper REST \u4E0D\u53EF\u7528\uFF0C\u5148\u4ECE\u955C\u50CF\u672C\u5730 zip \u5347\u7EA7 helper\u2026");
+    await runUpdateHelper({ ...opts, site: target.site.guid || opts.site, url: target.site.url }, true);
+    return await run();
+  }
+}
 async function runPluginsList(opts) {
   const { config, site, base } = await resolveTarget(opts);
   const api = `${base}/wp-json/wp/v2/plugins`;
@@ -4011,28 +4066,58 @@ async function runPluginsList(opts) {
   try {
     plugins = await apiFetch2(api, config, {}, opts.verbose);
   } catch (e) {
+    const msg = e.message || "";
     console.error(`
-\u274C \u83B7\u53D6\u5DF2\u88C5\u63D2\u4EF6\u5931\u8D25\uFF1A${e.message}
-`);
+\u274C \u83B7\u53D6\u5DF2\u88C5\u63D2\u4EF6\u5931\u8D25\uFF1A${msg}`);
+    if (/HTTP 401/.test(msg)) {
+      console.error("   \u7AD9\u70B9 oauth2 \u8FC7\u65E7\u6216\u4E0D\u8BA4 API Key\uFF0C\u9700\u8981\u5148\u505A SiteMan \u955C\u50CF\u5347\u7EA7\u3002\n");
+    }
+    if (opts.exitOnError === false) return;
     process.exit(1);
     return;
   }
   if (!Array.isArray(plugins)) {
     console.error("\n\u274C \u7AD9\u70B9\u8FD4\u56DE\u7684\u63D2\u4EF6\u5217\u8868\u683C\u5F0F\u5F02\u5E38\n");
+    if (opts.exitOnError === false) return;
     process.exit(1);
   }
+  let catalog = [];
+  try {
+    const res = await apiFetch2(
+      `${base}/wp-json/siluzan-helper/v1/plugins/catalog`,
+      config,
+      {},
+      opts.verbose
+    );
+    catalog = Array.isArray(res.items) ? res.items : [];
+  } catch {
+  }
+  const catalogByKey = /* @__PURE__ */ new Map();
+  for (const item of catalog) {
+    if (item.plugin) catalogByKey.set(pluginKey(item.plugin), item);
+    if (item.slug) catalogByKey.set(pluginKey(item.slug), item);
+  }
+  const rows = plugins.map((p) => {
+    const plugin = p.plugin ?? "";
+    const hit = catalogByKey.get(pluginKey(plugin));
+    let updateSource = "none";
+    if (hit?.update_available) updateSource = "catalog";
+    return {
+      plugin,
+      name: pluginName(p),
+      status: p.status ?? "",
+      version: p.version ?? "",
+      updateSource,
+      catalogVersion: hit?.new_version ?? ""
+    };
+  });
   if (opts.json) {
     console.log(
       JSON.stringify(
         {
           site: { guid: site.guid, name: site.name, url: site.url },
-          total: plugins.length,
-          plugins: plugins.map((p) => ({
-            plugin: p.plugin ?? "",
-            name: pluginName(p),
-            status: p.status ?? "",
-            version: p.version ?? ""
-          }))
+          total: rows.length,
+          plugins: rows
         },
         null,
         2
@@ -4040,7 +4125,7 @@ async function runPluginsList(opts) {
     );
     return;
   }
-  if (plugins.length === 0) {
+  if (rows.length === 0) {
     console.log(`
 \u7AD9\u70B9 ${site.name} \u672A\u8FD4\u56DE\u63D2\u4EF6\u3002
 `);
@@ -4050,32 +4135,45 @@ async function runPluginsList(opts) {
     { key: "plugin", header: "plugin" },
     { key: "name", header: "\u540D\u79F0" },
     { key: "status", header: "\u72B6\u6001" },
-    { key: "version", header: "\u7248\u672C" }
+    { key: "version", header: "\u7248\u672C" },
+    { key: "updateSource", header: "\u66F4\u65B0\u6E90" },
+    { key: "catalogVersion", header: "\u76EE\u5F55\u7248\u672C" }
   ];
   console.log(`
-${site.name} \u5DF2\u88C5\u63D2\u4EF6\uFF08${plugins.length}\uFF09
+${site.name} \u5DF2\u88C5\u63D2\u4EF6\uFF08${rows.length}\uFF09
 `);
   printCliTable(
-    plugins.map((p) => ({
-      plugin: p.plugin ?? "-",
-      name: pluginName(p) || "-",
-      status: p.status ?? "-",
-      version: p.version ?? "-"
+    rows.map((r) => ({
+      plugin: r.plugin || "-",
+      name: r.name || "-",
+      status: r.status || "-",
+      version: r.version || "-",
+      updateSource: r.updateSource,
+      catalogVersion: r.catalogVersion || "-"
     })),
     columns
   );
   console.log();
 }
 async function runPluginsCatalog(opts) {
-  const { config, site, base } = await resolveTarget(opts);
-  const api = `${base}/wp-json/siluzan-helper/v1/plugins/catalog`;
+  const target = await resolveTarget(opts);
+  const { site, base } = target;
   let res;
   try {
-    res = await apiFetch2(api, config, {}, opts.verbose);
+    res = await withHelperBootstrap(
+      opts,
+      target,
+      () => apiFetch2(
+        `${base}/wp-json/siluzan-helper/v1/plugins/catalog`,
+        target.config,
+        {},
+        opts.verbose
+      )
+    );
   } catch (e) {
     console.error(`
-\u274C \u83B7\u53D6\u63D2\u4EF6\u76EE\u5F55\u5931\u8D25\uFF1A${e.message}`);
-    console.error("   \u9700\u8981\u7AD9\u70B9\u5DF2\u90E8\u7F72\u5E26 REST \u7684 siluzan-helper-plugin\u3002\n");
+\u274C \u83B7\u53D6\u63D2\u4EF6\u76EE\u5F55\u5931\u8D25\uFF1A${e.message}
+`);
     process.exit(1);
     return;
   }
@@ -4101,7 +4199,8 @@ async function runPluginsCatalog(opts) {
     { key: "name", header: "\u540D\u79F0" },
     { key: "new_version", header: "\u76EE\u5F55\u7248\u672C" },
     { key: "installed", header: "\u5DF2\u88C5" },
-    { key: "active", header: "\u542F\u7528" }
+    { key: "active", header: "\u542F\u7528" },
+    { key: "update_available", header: "\u53EF\u66F4\u65B0" }
   ];
   console.log(`
 ${site.name} \u53EF\u5B89\u88C5\u76EE\u5F55\uFF08${items.length}\uFF09
@@ -4112,28 +4211,41 @@ ${site.name} \u53EF\u5B89\u88C5\u76EE\u5F55\uFF08${items.length}\uFF09
       name: p.name || "-",
       new_version: p.new_version || "-",
       installed: p.installed ? "yes" : "no",
-      active: p.active ? "yes" : "no"
+      active: p.active ? "yes" : "no",
+      update_available: p.update_available ? "yes" : "no"
     })),
     columns
   );
-  console.log("\n\u5B89\u88C5\uFF1Asiluzan-website plugins install --site <guid> --slug <slug>\n");
+  console.log("\n\u5B89\u88C5 / \u5347\u7EA7\uFF1Asiluzan-website plugins install --site <guid> --slug <slug>\n");
 }
 async function runPluginsInstall(opts) {
   const slug = opts.slug?.trim() ?? "";
-  if (!slug) {
-    console.error("\n\u274C \u8BF7\u63D0\u4F9B --slug\uFF08\u5148 plugins catalog \u67E5\u770B\u53EF\u88C5\u5217\u8868\uFF09\n");
+  const zipPath = opts.zip?.trim() ?? "";
+  if (slug && zipPath || !slug && !zipPath) {
+    console.error("\n\u274C \u76EE\u5F55\u63D2\u4EF6\u7528 --slug\uFF0C\u5916\u90E8\u63D2\u4EF6\u7528 --zip\uFF0C\u4E24\u8005\u53EA\u4F20\u4E00\u4E2A\n");
     process.exit(1);
   }
-  const { config, site, base } = await resolveTarget(opts);
-  const api = `${base}/wp-json/siluzan-helper/v1/plugins/install`;
+  const target = await resolveTarget(opts);
+  const { site, base } = target;
   let result;
   try {
-    result = await apiFetch2(
-      api,
-      config,
-      { method: "POST", body: JSON.stringify({ slug }) },
-      opts.verbose
-    );
+    result = await withHelperBootstrap(opts, target, async () => {
+      if (slug) {
+        return apiFetch2(
+          `${base}/wp-json/siluzan-helper/v1/plugins/install`,
+          target.config,
+          { method: "POST", body: JSON.stringify({ slug }) },
+          opts.verbose
+        );
+      }
+      const zip = readZipPayload(zipPath);
+      return apiFetch2(
+        `${base}/wp-json/siluzan-helper/v1/plugins/install-zip`,
+        target.config,
+        { method: "POST", body: JSON.stringify(zip) },
+        opts.verbose
+      );
+    });
   } catch (e) {
     console.error(`
 \u274C \u5B89\u88C5\u5931\u8D25\uFF1A${e.message}
@@ -4141,39 +4253,151 @@ async function runPluginsInstall(opts) {
     process.exit(1);
     return;
   }
-  if (!result.success) {
+  printActionResult(result, site, base, "\u63D2\u4EF6\u5DF2\u5B89\u88C5\u5E76\u542F\u7528");
+  await runPluginsList({
+    site: site.guid || opts.site,
+    url: site.url,
+    verbose: opts.verbose,
+    exitOnError: false
+  });
+}
+async function runPluginsUpdate(opts) {
+  const plugin = opts.plugin?.trim() ?? "";
+  if (!plugin) {
+    console.error("\n\u274C \u8BF7\u63D0\u4F9B --plugin\uFF08\u5148 plugins list \u770B plugin \u5217\uFF09\n");
+    process.exit(1);
+  }
+  const target = await resolveTarget(opts);
+  const { site, base } = target;
+  const zipPath = opts.zip?.trim() ?? "";
+  const body = { plugin };
+  if (zipPath) {
+    const zip = readZipPayload(zipPath);
+    body.zip_base64 = zip.zip_base64;
+    body.filename = zip.filename;
+  }
+  let result;
+  try {
+    result = await withHelperBootstrap(
+      opts,
+      target,
+      () => apiFetch2(
+        `${base}/wp-json/siluzan-helper/v1/plugins/update`,
+        target.config,
+        { method: "POST", body: JSON.stringify(body) },
+        opts.verbose
+      )
+    );
+  } catch (e) {
+    const msg = e.message || "";
+    if (/HTTP 409/.test(msg) && /no_package/i.test(msg)) {
+      console.error(`
+\u274C ${msg}`);
+      console.error("   \u76EE\u5F55\u548C WordPress.org \u90FD\u6CA1\u6709\u5B89\u88C5\u5305\u3002\u5916\u90E8\u63D2\u4EF6\u8BF7\u5E26 --zip \u518D\u5347\u7EA7\u3002\n");
+      process.exit(1);
+    }
     console.error(`
-\u274C ${result.message || "\u5B89\u88C5\u88AB\u7AD9\u70B9\u62D2\u7EDD"}
+\u274C \u5347\u7EA7\u5931\u8D25\uFF1A${msg}
 `);
     process.exit(1);
+    return;
   }
-  console.log(result.already ? "\n\u2705 \u63D2\u4EF6\u5DF2\u5728\u7AD9\u70B9\u4E0A\uFF08\u5DF2\u542F\u7528\uFF09" : "\n\u2705 \u63D2\u4EF6\u5DF2\u5B89\u88C5\u5E76\u542F\u7528");
-  if (result.plugin) console.log(`   plugin : ${result.plugin}`);
-  if (result.message) console.log(`   \u8BF4\u660E   : ${result.message}`);
-  console.log(`   \u7AD9\u70B9   : ${site.name} (${base})
+  printActionResult(result, site, base, "\u63D2\u4EF6\u5DF2\u5347\u7EA7");
+  await runPluginsList({
+    site: site.guid || opts.site,
+    url: site.url,
+    verbose: opts.verbose,
+    exitOnError: false
+  });
+}
+async function runHelperStatus(opts) {
+  const { config, site, base } = await resolveTarget(opts);
+  let status;
+  try {
+    status = await apiFetch2(
+      `${base}/wp-json/wposso/v1/helper/status`,
+      config,
+      {},
+      opts.verbose
+    );
+  } catch (e) {
+    const msg = e.message || "";
+    console.error(`
+\u274C \u65E0\u6CD5\u8BFB\u53D6 helper \u72B6\u6001\uFF1A${msg}`);
+    if (isRouteMissing(e) || /HTTP 404/.test(msg)) {
+      console.error("   \u7AD9\u70B9 oauth2 \u8FD8\u6CA1\u6709\u5F15\u5BFC\u5347\u7EA7\u63A5\u53E3\uFF0C\u9700\u8981\u5148\u505A SiteMan \u955C\u50CF\u5347\u7EA7\u3002\n");
+    }
+    process.exit(1);
+    return;
+  }
+  if (opts.json) {
+    console.log(JSON.stringify({ site: { guid: site.guid, name: site.name, url: site.url }, ...status }, null, 2));
+    return;
+  }
+  console.log(`
+${site.name} helper \u72B6\u6001`);
+  console.log(`   \u5DF2\u5B89\u88C5     : ${status.helper_installed ? "yes" : "no"}`);
+  console.log(`   \u5DF2\u542F\u7528     : ${status.helper_active ? "yes" : "no"}`);
+  console.log(`   \u7248\u672C       : ${status.helper_version || "-"}`);
+  console.log(`   helper REST: ${status.helper_rest_available ? "yes" : "no"}`);
+  console.log(`   \u955C\u50CF zip   : ${status.bootstrap_zip || "-"}`);
+  console.log(`   \u53EF\u5F15\u5BFC\u5347\u7EA7 : ${status.can_upgrade ? "yes" : "no"}
 `);
+}
+async function runUpdateHelper(opts, fromBootstrap = false) {
+  const { config, site, base } = await resolveTarget(opts);
+  let result;
   try {
-    await runPluginsList({ site: site.guid || opts.site, url: site.url, verbose: opts.verbose });
-  } catch {
+    result = await apiFetch2(
+      `${base}/wp-json/wposso/v1/helper/upgrade`,
+      config,
+      { method: "POST", body: JSON.stringify({}) },
+      opts.verbose
+    );
+  } catch (e) {
+    const msg = e.message || "";
+    console.error(`
+\u274C helper \u5347\u7EA7\u5931\u8D25\uFF1A${msg}`);
+    if (isRouteMissing(e)) {
+      console.error("   \u7AD9\u70B9 oauth2 \u8FD8\u6CA1\u6709\u5F15\u5BFC\u5347\u7EA7\u63A5\u53E3\uFF0C\u9700\u8981\u5148\u505A SiteMan \u955C\u50CF\u5347\u7EA7\u3002");
+    } else if (/HTTP 409/.test(msg)) {
+      console.error("   \u5F53\u524D\u955C\u50CF\u91CC\u6CA1\u6709 siluzan-helper-plugin.1.0.*.zip\u3002");
+    }
+    console.error();
+    process.exit(1);
+    return;
+  }
+  printActionResult(result, site, base, "helper \u5DF2\u4ECE\u955C\u50CF\u672C\u5730 zip \u5347\u7EA7");
+  if (!fromBootstrap) {
+    await runHelperStatus({ site: site.guid || opts.site, url: site.url, verbose: opts.verbose });
   }
 }
 function register7(program2) {
-  const plugins = program2.command("plugins").description("WordPress \u63D2\u4EF6\uFF1A\u5217\u51FA\u3001\u76EE\u5F55\u3001\u5B89\u88C5");
-  plugins.command("list").description("\u5217\u51FA\u7AD9\u70B9\u5DF2\u5B89\u88C5\u63D2\u4EF6").option("-s, --site <guidOrName>", "\u7AD9\u70B9 guid \u6216\u540D\u79F0").option("--url <url>", "\u76F4\u63A5\u6307\u5B9A\u7AD9\u70B9\u5730\u5740").option("--json", "\u8F93\u51FA JSON", false).option("--verbose", "\u8F93\u51FA\u8BF7\u6C42\u8BE6\u60C5", false).action(async (opts) => {
+  const plugins = program2.command("plugins").description("WordPress \u63D2\u4EF6\uFF1A\u5217\u51FA\u3001\u76EE\u5F55\u3001\u5B89\u88C5\u3001\u5347\u7EA7");
+  plugins.command("list").description("\u5217\u51FA\u7AD9\u70B9\u5DF2\u5B89\u88C5\u7684\u5168\u90E8\u63D2\u4EF6").option("-s, --site <guidOrName>", "\u7AD9\u70B9 guid \u6216\u540D\u79F0").option("--url <url>", "\u76F4\u63A5\u6307\u5B9A\u7AD9\u70B9\u5730\u5740").option("--json", "\u8F93\u51FA JSON", false).option("--verbose", "\u8F93\u51FA\u8BF7\u6C42\u8BE6\u60C5", false).action(async (opts) => {
     await runPluginsList(opts);
   });
-  plugins.command("catalog").description("\u5217\u51FA\u4E1D\u8DEF\u8D5E\u63D2\u4EF6\u76EE\u5F55\uFF08\u53EF\u5B89\u88C5\u5217\u8868\uFF09").option("-s, --site <guidOrName>", "\u7AD9\u70B9 guid \u6216\u540D\u79F0").option("--url <url>", "\u76F4\u63A5\u6307\u5B9A\u7AD9\u70B9\u5730\u5740").option("--json", "\u8F93\u51FA JSON", false).option("--verbose", "\u8F93\u51FA\u8BF7\u6C42\u8BE6\u60C5", false).action(async (opts) => {
+  plugins.command("catalog").description("\u5217\u51FA\u4E1D\u8DEF\u8D5E\u63D2\u4EF6\u76EE\u5F55\uFF08\u53EF\u5B89\u88C5 / \u53EF\u5347\u7EA7\uFF09").option("-s, --site <guidOrName>", "\u7AD9\u70B9 guid \u6216\u540D\u79F0").option("--url <url>", "\u76F4\u63A5\u6307\u5B9A\u7AD9\u70B9\u5730\u5740").option("--json", "\u8F93\u51FA JSON", false).option("--verbose", "\u8F93\u51FA\u8BF7\u6C42\u8BE6\u60C5", false).action(async (opts) => {
     await runPluginsCatalog(opts);
   });
-  plugins.command("install").description("\u4ECE\u4E1D\u8DEF\u8D5E\u76EE\u5F55\u5B89\u88C5\u5E76\u542F\u7528\u63D2\u4EF6\uFF08\u5199\u64CD\u4F5C\uFF0C\u4F1A\u7ACB\u523B\u751F\u6548\uFF09").option("-s, --site <guidOrName>", "\u7AD9\u70B9 guid \u6216\u540D\u79F0").option("--url <url>", "\u76F4\u63A5\u6307\u5B9A\u7AD9\u70B9\u5730\u5740").requiredOption("--slug <slug>", "\u76EE\u5F55\u4E2D\u7684 slug \u6216 plugin \u8DEF\u5F84").option("--verbose", "\u8F93\u51FA\u8BF7\u6C42\u8BE6\u60C5", false).action(async (opts) => {
+  plugins.command("install").description("\u5B89\u88C5\u5E76\u542F\u7528\u63D2\u4EF6\uFF1A\u76EE\u5F55\u7528 --slug\uFF0C\u5916\u90E8\u7528 --zip").option("-s, --site <guidOrName>", "\u7AD9\u70B9 guid \u6216\u540D\u79F0").option("--url <url>", "\u76F4\u63A5\u6307\u5B9A\u7AD9\u70B9\u5730\u5740").option("--slug <slug>", "\u4E1D\u8DEF\u8D5E\u76EE\u5F55\u4E2D\u7684 slug \u6216 plugin \u8DEF\u5F84").option("--zip <file>", "\u5916\u90E8\u63D2\u4EF6 zip\uFF08\u6839\u76EE\u5F55\u5FC5\u987B\u662F\u63D2\u4EF6\u76EE\u5F55\uFF09").option("--verbose", "\u8F93\u51FA\u8BF7\u6C42\u8BE6\u60C5", false).action(async (opts) => {
     await runPluginsInstall(opts);
   });
+  plugins.command("update").description("\u5347\u7EA7\u5DF2\u88C5\u63D2\u4EF6\uFF1A\u6709\u76EE\u5F55/\u5B98\u65B9\u5305\u5219\u4E0D\u7528 zip\uFF0C\u5916\u90E8\u63D2\u4EF6\u5E26 --zip").option("-s, --site <guidOrName>", "\u7AD9\u70B9 guid \u6216\u540D\u79F0").option("--url <url>", "\u76F4\u63A5\u6307\u5B9A\u7AD9\u70B9\u5730\u5740").requiredOption("--plugin <plugin>", "\u5DF2\u88C5\u63D2\u4EF6\u8DEF\u5F84\uFF0C\u5982 theme-manage/theme-manage").option("--zip <file>", "\u5916\u90E8\u63D2\u4EF6\u5347\u7EA7\u5305").option("--verbose", "\u8F93\u51FA\u8BF7\u6C42\u8BE6\u60C5", false).action(async (opts) => {
+    await runPluginsUpdate(opts);
+  });
+  plugins.command("helper-status").description("\u67E5\u770B\u7AD9\u70B9 helper \u4E0E\u955C\u50CF\u672C\u5730 zip").option("-s, --site <guidOrName>", "\u7AD9\u70B9 guid \u6216\u540D\u79F0").option("--url <url>", "\u76F4\u63A5\u6307\u5B9A\u7AD9\u70B9\u5730\u5740").option("--json", "\u8F93\u51FA JSON", false).option("--verbose", "\u8F93\u51FA\u8BF7\u6C42\u8BE6\u60C5", false).action(async (opts) => {
+    await runHelperStatus(opts);
+  });
+  plugins.command("update-helper").description("\u7528\u955C\u50CF\u91CC\u7684 siluzan-helper-plugin.1.0.*.zip \u5347\u7EA7 helper\uFF08\u5199\u64CD\u4F5C\uFF09").option("-s, --site <guidOrName>", "\u7AD9\u70B9 guid \u6216\u540D\u79F0").option("--url <url>", "\u76F4\u63A5\u6307\u5B9A\u7AD9\u70B9\u5730\u5740").option("--verbose", "\u8F93\u51FA\u8BF7\u6C42\u8BE6\u60C5", false).action(async (opts) => {
+    await runUpdateHelper(opts);
+  });
 }
 
 // src/index.ts
 installProcessHandlers();
 var program = new Command();
-program.name("siluzan-website").description("Siluzan WordPress \u7AD9\u70B9\u7BA1\u7406\uFF1A\u5217\u51FA\u7AD9\u70B9\u3001\u65B0\u589E/\u7F16\u8F91\u9875\u9762\u3001\u67E5\u770B\u63D2\u4EF6").version(getCurrentVersion2());
+program.name("siluzan-website").description("Siluzan WordPress \u7AD9\u70B9\u7BA1\u7406\uFF1A\u5217\u51FA\u7AD9\u70B9\u3001\u65B0\u589E/\u7F16\u8F91\u9875\u9762\u3001\u5B89\u88C5/\u5347\u7EA7\u63D2\u4EF6").version(getCurrentVersion2());
 var REGISTRARS = [
   register,
   register2,

package/dist/skill/SKILL.md

@@ -1,8 +1,8 @@
 ---
 name: siluzan-website
 description: >-
-  管理丝路赞 WordPress 站点（wp-k8s 托管）：列出我的站点、新增/编辑页面、从丝路赞目录安装插件。
-  当用户提到 WordPress、建站后台、新增页面、改官网、装插件、站点 guid、
+  管理丝路赞 WordPress 站点（wp-k8s 托管）：列出我的站点、新增/编辑页面、安装/升级插件。
+  当用户提到 WordPress、建站后台、新增页面、改官网、装插件、升级插件、站点 guid、
   siluzan-website、zionbuilder、visual-edit 时使用。不是 LPS / AI Sites，也不是 SEO JSON 生成。
 ---
 
@@ -10,7 +10,7 @@ description: >-
 
 管理用户账号下的 **WordPress 站点**（TSO 建站 / wp-k8s）。通过 CLI 调平台 all-sites 与站点 WP REST，不要手写 curl，不要猜 guid / 页面 ID。
 
-**不是** `landing-page-system` 的 LPS Agent，也不是 `siluzan-seo` 的 schema 生成。用户要的是「我的官网加一页 / 看插件」才用本 Skill。
+**不是** `landing-page-system` 的 LPS Agent，也不是 `siluzan-seo` 的 schema 生成。用户要的是「我的官网加一页 / 看插件 / 装插件 / 升级插件」才用本 Skill。
 
 ## 一键安装
 
@@ -40,7 +40,8 @@ Windows 注意：部分 Agent 通过 PowerShell / cmd 代执行时可能失败
 | `siluzan-website init` / `update` | 写入 / 刷新 Skill 文件 | [references/setup.md](references/setup.md) |
 | `siluzan-website sites list` | 列出我的 WordPress 站点 | [references/sites.md](references/sites.md) |
 | `siluzan-website pages list/add/update` | 列出 / 新增 / 覆盖页面 | [references/pages.md](references/pages.md) |
-| `siluzan-website plugins list/catalog/install` | 已装列表 / 目录 / 安装并启用 | [references/plugins.md](references/plugins.md) |
+| `siluzan-website plugins list/catalog/install/update` | 已装列表 / 目录 / 安装 / 升级 | [references/plugins.md](references/plugins.md) |
+| `siluzan-website plugins helper-status/update-helper` | 查看 / 用镜像 zip 升级 helper | [references/plugins.md](references/plugins.md) |
 
 ---
 
@@ -51,25 +52,29 @@ Windows 注意：部分 Agent 通过 PowerShell / cmd 代执行时可能失败
 | 首次安装 / 登录 | `references/setup.md` | `login` 或复用已有 CSO/TSO 凭据 |
 | 我有哪些网站 | `references/sites.md` | `sites list`，不要猜 guid |
 | 加一页 / 改一页 | `references/pages.md` | 先 `sites list` 再 `pages add/update` |
-| 这个站装了哪些插件 | `references/plugins.md` | `plugins list` |
-| 安装 / 启用插件 | `references/plugins.md` | `catalog` 找 slug → 确认 → `install` |
+| 这个站装了哪些插件 | `references/plugins.md` | `plugins list`（全部已装，不只是目录） |
+| 安装 / 启用目录插件 | `references/plugins.md` | `catalog` 找 slug → 确认 → `install --slug` |
+| 安装外部插件 | `references/plugins.md` | 确认 → `install --zip` |
+| 升级已装插件 | `references/plugins.md` | `list` 拿 plugin → 确认 → `update --plugin`；外部再加 `--zip` |
 
 ---
 
 ## AI 行为规范
 
 1. **计划 → 确认 → 执行 → 验证**
-   - 写操作（`pages add` / `pages update` / `plugins install`）会立刻生效，执行前必须复述目标站点与内容，获得用户确认。
-   - 只读（`sites list` / `pages list` / `plugins list` / `plugins catalog` / `config show`）可直接跑。
+   - 写操作（`pages add` / `pages update` / `plugins install` / `plugins update` / `plugins update-helper`）会立刻生效，执行前必须复述目标站点与内容，获得用户确认。
+   - 只读（`sites list` / `pages list` / `plugins list` / `plugins catalog` / `plugins helper-status` / `config show`）可直接跑。
 2. **不猜 ID**：站点用 `sites list` 的 `guid`；页面用 `pages list` 的 `id`。
 3. **先查再写**：改页面前先 `pages list` 确认目标页存在。
 4. **只认 API Key**：所有命令走 `x-api-key`（`SILUZAN_API_KEY` 或 `login` 写入的 config）。Agent 沙箱只注入 Key，不要向用户要 JWT，也不要设 `SILUZAN_AUTH_TOKEN`。
 5. **命令透明**：用一句话说明意图（「正在列出您的站点」），不要把整段命令当主回复；用户要细节时再给完整命令。
-6. **失败先自救**：401 → 引导重新 `login`；站点找不到 → 再跑 `sites list`；不要编造成功。
+6. **失败先自救**：401 → 引导重新 `login`；站点找不到 → 再跑 `sites list`；helper REST 404 时命令会先升 helper；oauth2 401/404 → 说明要 SiteMan 镜像升级。不要编造成功。
+7. **不传任意下载 URL**：外部插件只接受本地 `--zip`。helper 只从镜像 `1.0.*` zip 引导升级，不要上架 helper。
 
 ### 本版明确不做
 
 - 创建 / 删除 / 重启站点（SiteMan）
 - 绑定域名 / CDN / SSL
-- 停用 / 删除插件；安装目录里没有的第三方插件
+- 停用 / 删除插件
+- 推荐插件的业务配置（选择器、Cron、模型）
 - LPS / AI Sites / SEO JSON 灌入

package/dist/skill/_meta.json

@@ -1,7 +1,7 @@
 {
   "slug": "siluzan-website",
-  "version": "1.0.1-beta.1",
-  "publishedAt": 1789609097006,
+  "version": "1.0.1-beta.2",
+  "publishedAt": 1789633076915,
   "homepage": "https://www.siluzan.com",
   "source": "https://dev.azure.com/jack4it/Sammamish/_git/siluzan-skill",
   "requiredBinaries": [

package/dist/skill/references/plugins.md

@@ -1,6 +1,11 @@
 # 插件
 
-鉴权一律 **API Key（x-api-key）**。安装走站点 `siluzan-helper-plugin` 的 REST，只允许丝路赞目录里的 zip，不接受任意 URL。
+鉴权一律 **API Key（x-api-key）**。
+
+- **已装列表**走 WordPress 核心 `GET /wp-json/wp/v2/plugins`，能看到站点上的全部插件。
+- **目录安装 / 无 zip 升级**走 `siluzan-helper-plugin` REST。目录包来自丝路赞目录，不接受任意 URL。
+- **外部插件**首次安装和升级都带本地 `--zip`。zip 根目录必须是插件目录本身（`插件名/xxx.php`），不能再套一层版本号目录。
+- helper 太旧、没有 REST 时，命令会先打 oauth2 `POST /wp-json/wposso/v1/helper/upgrade`，用镜像里的 `siluzan-helper-plugin.1.0.*.zip` 升 helper，再继续原来的操作。helper **不上架**。
 
 ## 已装列表
 
@@ -9,36 +14,62 @@ siluzan-website plugins list --site <guid>
 siluzan-website plugins list --site <guid> --json
 ```
 
-`GET /wp-json/wp/v2/plugins`。字段：`plugin`、名称、`status`、版本。
+字段：`plugin`、名称、`status`、版本、`updateSource`（有目录命中则为 `catalog`）、目录版本。
+
+`plugin` 列是后续 `update --plugin` 要用的值，不要猜。
 
 ## 可安装目录
 
 ```bash
 siluzan-website plugins catalog --site <guid>
-siluzan-website plugins catalog --site <guid> --json
 ```
 
-`GET /wp-json/siluzan-helper/v1/plugins/catalog`。记下 `slug`，安装必须用这个值（或 `plugin` 路径）。不要猜。
+记下 `slug`。目录安装 / 目录升级都用这个值。
 
-## 安装并启用
+## 安装
 
 写操作，执行前必须和用户确认目标站点与插件名。
 
+目录插件：
+
 ```bash
 siluzan-website plugins install --site <guid> --slug <slug>
 ```
 
-`POST /wp-json/siluzan-helper/v1/plugins/install`，body：`{ "slug": "..." }`。
+外部插件：
+
+```bash
+siluzan-website plugins install --site <guid> --zip ./my-plugin.zip
+```
+
+`--slug` 和 `--zip` 只传一个。`install --slug` 已装时会按目录包覆盖升级。
+
+## 升级已装插件
+
+不传 zip 时：先查目录包，再查 WordPress `update_plugins`（含 wordpress.org）。都没有包则失败，提示带 `--zip`。
+
+```bash
+siluzan-website plugins update --site <guid> --plugin theme-manage/theme-manage
+siluzan-website plugins update --site <guid> --plugin zasp-smart-recommender/zasp-smart-recommender --zip ./zasp.zip
+```
+
+## helper
+
+```bash
+siluzan-website plugins helper-status --site <guid>
+siluzan-website plugins update-helper --site <guid>
+```
 
-成功后命令会再跑一次 `plugins list` 复核。已装且已启用会返回 `already: true`，视为成功，不要再装一遍。
+`update-helper` 只装镜像本地 `1.0.*` 包，不会去目录拉 helper。
 
 ## Agent 流程
 
 1. `sites list` 确定 guid
-2. `plugins catalog` 找到 slug（用户说中文名时按 `name` 匹配）
-3. 复述「将在 {站点} 安装并启用 {名称}（slug）」并等确认
-4. `plugins install --site <guid> --slug <slug>`
-5. 看复核列表里是否 `active`
+2. 用户要「装了哪些插件」→ `plugins list`
+3. 用户要装目录插件 → `catalog` 对上 slug → 确认 → `install --slug`
+4. 用户要升级已装插件 → `list` 拿到 `plugin` → 确认 → `update --plugin`；外部插件再加 `--zip`
+5. catalog / install / update 报路由 404 → 命令会自动 `update-helper` 再重试；oauth2 本身 404 / 401 → 告诉用户要先 SiteMan 镜像升级
+6. 看复核列表里是否 `active`
 
 匹配到多个目录项时让用户选，不要猜。
 
@@ -46,9 +77,12 @@ siluzan-website plugins install --site <guid> --slug <slug>
 
 | 现象 | 处理 |
 |------|------|
-| catalog / install 404 或路由不存在 | 站点 helper 还没带 REST，需要更新 `siluzan-helper-plugin` |
-| 401 | API Key 无效或无权操作该站 |
-| Plugin not found | slug 不对，重新 `catalog` |
+| list 401 | 站点 oauth2 不认 API Key，需要 SiteMan 镜像升级 |
+| helper REST 404 | 先自动升 helper；oauth2 也没有引导接口则要镜像升级 |
+| update-helper 409 | 当前镜像没有 `siluzan-helper-plugin.1.0.*.zip` |
+| Plugin not found / not_in_catalog | slug 不对，重新 `catalog` |
+| 409 no_package | 目录和官方都没包，外部插件带 `--zip` |
+| zip 结构不对 | 重新打包，根目录必须是插件目录 |
 | 安装成功但激活失败 | 把站点返回的 message 原文告诉用户 |
 
-本 Skill **不能**停用、删除插件，也不能装 wordpress.org 上目录里没有的插件。
+本 Skill **不能**停用、删除插件，也不能传任意下载 URL。

package/dist/skill/scripts/install.ps1

@@ -9,7 +9,7 @@ $ErrorActionPreference = 'Stop'
 # -- Package info (injected at build time) ------------------------------------
 $PKG_NAME    = 'siluzan-website-cli'
 # PKG_VERSION 锁定到与本脚本同批构建产物一致的版本，避免与 dist/skill 错位
-$PKG_VERSION = '1.0.1-beta.1'
+$PKG_VERSION = '1.0.1-beta.2'
 $CLI_BIN     = 'siluzan-website'
 $SKILL_LABEL = 'Siluzan Website'
 $INSTALL_CMD = 'npm install -g siluzan-website-cli@beta'

package/dist/skill/scripts/install.sh

@@ -9,7 +9,7 @@ set -euo pipefail
 # -- Package info (injected at build time) ------------------------------------
 readonly PKG_NAME="siluzan-website-cli"
 # PKG_VERSION 锁定到与本脚本同批构建产物一致的版本，避免与 dist/skill 错位
-readonly PKG_VERSION="1.0.1-beta.1"
+readonly PKG_VERSION="1.0.1-beta.2"
 readonly CLI_BIN="siluzan-website"
 readonly SKILL_LABEL="Siluzan Website"
 readonly INSTALL_CMD="npm install -g siluzan-website-cli@beta"

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "siluzan-website-cli",
-  "version": "1.0.1-beta.1",
-  "description": "Siluzan WordPress 站点管理 Skill CLI — 列出站点、新增/编辑页面、查看插件。",
+  "version": "1.0.1-beta.2",
+  "description": "Siluzan WordPress 站点管理 Skill CLI — 列出站点、新增/编辑页面、安装/升级插件。",
   "keywords": [
     "ai-skill",
     "cli",