siluzan-website-cli 1.0.1-beta.3 → 1.0.1-beta.4

package/README.md

@@ -22,7 +22,7 @@ siluzan-website content list --site <guid> --type posts
 siluzan-website media upload --site <guid> --file ./hero.png
 siluzan-website search --site <guid> --q "关于我们"
 siluzan-website plugins list --site <guid>
-siluzan-website plugins catalog --site <guid>
+siluzan-website plugins catalog
 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>

package/dist/index.js

@@ -3317,6 +3317,7 @@ import { spawnSync } from "child_process";
 var BUILD_ENV = "test";
 var DEFAULT_API_BASE = "https://api-ci.siluzan.com";
 var DEFAULT_CSO_BASE = "https://cso-ci.siluzan.com";
+var DEFAULT_CSO_PLUGIN_API = "https://cso-api-ci.siluzan.com";
 var DEFAULT_WEB_BASE = "https://www-ci.siluzan.com";
 var DEFAULT_SITE_STAGE = "ci";
 
@@ -3727,6 +3728,7 @@ function loadConfig() {
   }
   const apiBaseUrl = process.env.SILUZAN_WEBSITE_API_BASE ?? DEFAULT_API_BASE;
   const csoBaseUrl = process.env.SILUZAN_CSO_BASE ?? DEFAULT_CSO_BASE;
+  const csoPluginApiBaseUrl = process.env.SILUZAN_CSO_PLUGIN_API ?? DEFAULT_CSO_PLUGIN_API;
   const apiErr = validateBaseUrl(apiBaseUrl);
   if (apiErr) {
     console.error(`
@@ -3739,9 +3741,16 @@ function loadConfig() {
 \u274C csoBaseUrl \u4E0D\u5408\u6CD5\uFF1A${csoErr}`);
     process.exit(1);
   }
+  const pluginApiErr = validateBaseUrl(csoPluginApiBaseUrl);
+  if (pluginApiErr) {
+    console.error(`
+\u274C csoPluginApiBaseUrl \u4E0D\u5408\u6CD5\uFF1A${pluginApiErr}`);
+    process.exit(1);
+  }
   return {
     apiBaseUrl,
     csoBaseUrl,
+    csoPluginApiBaseUrl,
     authToken: "",
     apiKey,
     dataPermission: process.env.SILUZAN_DATA_PERMISSION ?? shared.dataPermission
@@ -4218,7 +4227,166 @@ 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;
+
+// src/utils/wp-plugin-catalog.ts
+import * as http2 from "http";
+import * as https2 from "https";
+function trimSlash(url) {
+  return url.replace(/\/+$/, "");
+}
+function pluginApiBases(config) {
+  const seen = /* @__PURE__ */ new Set();
+  const out = [];
+  for (const raw of [config.csoPluginApiBaseUrl, config.csoBaseUrl]) {
+    const base = trimSlash(raw || "");
+    if (!base || seen.has(base)) continue;
+    seen.add(base);
+    out.push(base);
+  }
+  return out;
+}
+function isNetworkish(err) {
+  const msg = err.message || "";
+  return /fetch failed|ENOTFOUND|ECONNREFUSED|ETIMEDOUT|ECONNRESET|EPROTO|TLS|socket disconnected|certificate|HTTP 5\d\d/i.test(
+    msg
+  );
+}
+function compareVersion(a, b) {
+  const pa = a.split(".").map((p) => Number(p) || 0);
+  const pb = b.split(".").map((p) => Number(p) || 0);
+  const n = Math.max(pa.length, pb.length);
+  for (let i = 0; i < n; i++) {
+    const da = pa[i] ?? 0;
+    const db = pb[i] ?? 0;
+    if (da !== db) return da - db;
+  }
+  return 0;
+}
+function versionFromPath(path6, filename) {
+  const parts = path6.replace(/\\/g, "/").split("/").filter(Boolean);
+  if (parts.length >= 2) return parts[1];
+  const m = filename.match(/\.((?:\d+\.)*\d+)\.zip$/i);
+  return m?.[1] ?? "";
+}
+function collectZips(nodes, out = []) {
+  for (const node of nodes || []) {
+    if (!node.isDirectory && /\.zip$/i.test(node.name || "") && node.url) {
+      out.push(node);
+    }
+    if (node.children?.length) collectZips(node.children, out);
+  }
+  return out;
+}
+function flattenOfficialPlugins(items) {
+  const best = /* @__PURE__ */ new Map();
+  for (const zip of collectZips(items)) {
+    const path6 = (zip.path || "").replace(/\\/g, "/");
+    const filename = zip.name || path6.split("/").pop() || "";
+    const slug = path6.split("/").filter(Boolean)[0] || filename.replace(/\.zip$/i, "");
+    if (!slug) continue;
+    const candidate = {
+      slug,
+      version: versionFromPath(path6, filename),
+      filename,
+      path: path6,
+      size: Number(zip.size) || 0,
+      url: zip.url || "",
+      lastModified: zip.lastModified || ""
+    };
+    const prev = best.get(slug);
+    if (!prev || compareVersion(candidate.version, prev.version) > 0) {
+      best.set(slug, candidate);
+    }
+  }
+  return [...best.values()].sort((a, b) => a.slug.localeCompare(b.slug));
+}
+async function fetchOfficialPluginList(config, opts = {}) {
+  const params = new URLSearchParams();
+  if (opts.prefix?.trim()) params.set("prefix", opts.prefix.trim());
+  const qs = params.toString();
+  const path6 = `/cso/v1/wp-plugin/list${qs ? `?${qs}` : ""}`;
+  const bases = pluginApiBases(config);
+  let lastErr;
+  for (let i = 0; i < bases.length; i++) {
+    const url = `${bases[i]}${path6}`;
+    try {
+      const raw = await apiFetch2(url, config, {}, opts.verbose);
+      const code = raw.code;
+      if (code !== void 0 && code !== 1) {
+        throw new Error(raw.message || `\u76EE\u5F55\u63A5\u53E3\u8FD4\u56DE code=${code}`);
+      }
+      const data = raw.data || {};
+      return {
+        container: data.container || "wp-plugins",
+        items: flattenOfficialPlugins(data.items)
+      };
+    } catch (e) {
+      lastErr = e;
+      if (i < bases.length - 1 && isNetworkish(lastErr)) {
+        console.log(`\u76EE\u5F55\u63A5\u53E3 ${bases[i]} \u4E0D\u53EF\u8FBE\uFF0C\u6539\u8D70 ${bases[i + 1]} \u2026`);
+        continue;
+      }
+      throw lastErr;
+    }
+  }
+  throw lastErr || new Error("\u76EE\u5F55\u63A5\u53E3\u4E0D\u53EF\u7528");
+}
+async function findOfficialPlugin(config, slugOrPlugin, verbose = false) {
+  const needle = slugOrPlugin.replace(/\\/g, "/").replace(/\.php$/i, "").toLowerCase();
+  if (!needle) return null;
+  const { items } = await fetchOfficialPluginList(config, { verbose });
+  return items.find((p) => p.slug.toLowerCase() === needle) || items.find((p) => needle === p.slug.toLowerCase() || needle.startsWith(`${p.slug.toLowerCase()}/`)) || null;
+}
+function downloadOfficialZip(url) {
+  return new Promise((resolve4, reject) => {
+    let parsed;
+    try {
+      parsed = new URL(url);
+    } catch {
+      reject(new Error("\u76EE\u5F55\u5305\u5730\u5740\u4E0D\u5408\u6CD5"));
+      return;
+    }
+    if (parsed.protocol !== "https:" && parsed.protocol !== "http:") {
+      reject(new Error("\u76EE\u5F55\u5305\u5730\u5740\u5FC5\u987B\u662F http(s)"));
+      return;
+    }
+    const transport = parsed.protocol === "https:" ? https2 : http2;
+    const req = transport.get(url, { timeout: 12e4 }, (res) => {
+      const status = res.statusCode ?? 0;
+      if (status >= 300 && status < 400 && res.headers.location) {
+        res.resume();
+        downloadOfficialZip(res.headers.location).then(resolve4, reject);
+        return;
+      }
+      if (status < 200 || status >= 300) {
+        res.resume();
+        reject(new Error(`\u4E0B\u8F7D\u76EE\u5F55\u5305\u5931\u8D25\uFF1AHTTP ${status}`));
+        return;
+      }
+      const chunks = [];
+      let size = 0;
+      res.on("data", (chunk) => {
+        size += chunk.length;
+        if (size > 40 * 1024 * 1024) {
+          res.destroy();
+          reject(new Error("\u76EE\u5F55\u5305\u8D85\u8FC7 40MB"));
+          return;
+        }
+        chunks.push(chunk);
+      });
+      res.on("end", () => resolve4(Buffer.concat(chunks)));
+      res.on("error", reject);
+    });
+    req.on("timeout", () => {
+      req.destroy();
+      reject(new Error("\u4E0B\u8F7D\u76EE\u5F55\u5305\u8D85\u65F6"));
+    });
+    req.on("error", reject);
+  });
+}
+
+// src/commands/plugins.ts
+var MAX_ZIP_BYTES = 40 * 1024 * 1024;
 var PROTECTED_PLUGIN_PREFIXES = ["siluzan-helper-plugin", "wp-oauth2"];
 function isProtectedPlugin(plugin) {
   const key = pluginKey(plugin);
@@ -4234,6 +4402,12 @@ function pluginName(item) {
 function pluginKey(value) {
   return value.replace(/\\/g, "/").replace(/\.php$/i, "").toLowerCase();
 }
+function formatBytes(n) {
+  if (!n) return "-";
+  if (n < 1024) return `${n} B`;
+  if (n < 1024 * 1024) return `${(n / 1024).toFixed(1)} KB`;
+  return `${(n / 1024 / 1024).toFixed(1)} MB`;
+}
 async function resolveTarget2(opts) {
   const config = loadConfig();
   const site = await resolveSite(config, opts);
@@ -4310,34 +4484,23 @@ async function runPluginsList(opts) {
     if (opts.exitOnError === false) return;
     process.exit(1);
   }
-  let catalog = [];
+  let official = [];
   try {
-    const res = await apiFetch2(
-      `${base}/wp-json/siluzan-helper/v1/plugins/catalog`,
-      config,
-      {},
-      opts.verbose
-    );
-    catalog = Array.isArray(res.items) ? res.items : [];
+    official = (await fetchOfficialPluginList(config, { verbose: opts.verbose })).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 officialBySlug = new Map(official.map((item) => [item.slug.toLowerCase(), 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";
+    const slug = pluginKey(plugin).split("/")[0];
+    const hit = officialBySlug.get(slug);
     return {
       plugin,
       name: pluginName(p),
       status: p.status ?? "",
       version: p.version ?? "",
-      updateSource,
-      catalogVersion: hit?.new_version ?? ""
+      updateSource: hit ? "catalog" : "none",
+      catalogVersion: hit?.version ?? ""
     };
   });
   if (opts.json) {
@@ -4385,20 +4548,10 @@ ${site.name} \u5DF2\u88C5\u63D2\u4EF6\uFF08${rows.length}\uFF09
   console.log();
 }
 async function runPluginsCatalog(opts) {
-  const target = await resolveTarget2(opts);
-  const { site, base } = target;
-  let res;
+  const config = loadConfig();
+  let pack;
   try {
-    res = await withHelperBootstrap(
-      opts,
-      target,
-      () => apiFetch2(
-        `${base}/wp-json/siluzan-helper/v1/plugins/catalog`,
-        target.config,
-        {},
-        opts.verbose
-      )
-    );
+    pack = await fetchOfficialPluginList(config, { prefix: opts.prefix, verbose: opts.verbose });
   } catch (e) {
     console.error(`
 \u274C \u83B7\u53D6\u63D2\u4EF6\u76EE\u5F55\u5931\u8D25\uFF1A${e.message}
@@ -4406,46 +4559,78 @@ async function runPluginsCatalog(opts) {
     process.exit(1);
     return;
   }
-  const items = Array.isArray(res.items) ? res.items : [];
+  const installedBySlug = /* @__PURE__ */ new Map();
+  if (opts.site || opts.url) {
+    try {
+      const target = await resolveTarget2(opts);
+      const plugins = await apiFetch2(
+        `${target.base}/wp-json/wp/v2/plugins`,
+        target.config,
+        {},
+        opts.verbose
+      );
+      if (Array.isArray(plugins)) {
+        for (const p of plugins) {
+          const slug = pluginKey(p.plugin || "").split("/")[0];
+          if (slug) installedBySlug.set(slug, { version: p.version || "", status: p.status || "" });
+        }
+      }
+    } catch {
+    }
+  }
+  const rows = pack.items.map((p) => {
+    const onSite = installedBySlug.get(p.slug.toLowerCase());
+    return {
+      slug: p.slug,
+      version: p.version,
+      size: formatBytes(p.size),
+      installed: onSite ? "yes" : opts.site || opts.url ? "no" : "-",
+      filename: p.filename
+    };
+  });
   if (opts.json) {
     console.log(
-      JSON.stringify(
-        { site: { guid: site.guid, name: site.name, url: site.url }, total: items.length, items },
-        null,
-        2
-      )
+      JSON.stringify({ container: pack.container, total: pack.items.length, items: pack.items }, null, 2)
     );
     return;
   }
-  if (items.length === 0) {
-    console.log(`
-\u7AD9\u70B9 ${site.name} \u7684\u4E1D\u8DEF\u8D5E\u63D2\u4EF6\u76EE\u5F55\u4E3A\u7A7A\u3002
-`);
+  if (rows.length === 0) {
+    console.log("\n\u5B98\u65B9\u63D2\u4EF6\u76EE\u5F55\u4E3A\u7A7A\u3002\n");
     return;
   }
-  const columns = [
-    { key: "slug", header: "slug" },
-    { key: "name", header: "\u540D\u79F0" },
-    { key: "new_version", header: "\u76EE\u5F55\u7248\u672C" },
-    { key: "installed", header: "\u5DF2\u88C5" },
-    { 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
+\u5B98\u65B9\u63D2\u4EF6\u76EE\u5F55 ${pack.container}\uFF08${rows.length}\uFF09
 `);
-  printCliTable(
-    items.map((p) => ({
-      slug: p.slug || p.plugin || "-",
-      name: p.name || "-",
-      new_version: p.new_version || "-",
-      installed: p.installed ? "yes" : "no",
-      active: p.active ? "yes" : "no",
-      update_available: p.update_available ? "yes" : "no"
-    })),
-    columns
+  printCliTable(rows, [
+    { key: "slug", header: "slug" },
+    { key: "version", header: "\u76EE\u5F55\u7248\u672C" },
+    { key: "size", header: "\u5927\u5C0F" },
+    { key: "installed", header: "\u672C\u7AD9\u5DF2\u88C5" },
+    { key: "filename", header: "zip" }
+  ]);
+  console.log("\n\u5B89\u88C5\uFF1Asiluzan-website plugins install --site <guid> --slug <slug>\n");
+}
+async function installOfficialZip(target, official, verbose = false) {
+  if (official.size > MAX_ZIP_BYTES) {
+    throw new Error(`\u76EE\u5F55\u5305 ${official.filename} \u8D85\u8FC7 40MB`);
+  }
+  console.log(`\u4ECE\u5B98\u65B9\u76EE\u5F55\u4E0B\u8F7D ${official.slug} ${official.version} \u2026`);
+  const buf = await downloadOfficialZip(official.url);
+  if (buf.length > MAX_ZIP_BYTES) {
+    throw new Error(`\u76EE\u5F55\u5305 ${official.filename} \u8D85\u8FC7 40MB`);
+  }
+  return apiFetch2(
+    `${target.base}/wp-json/siluzan-helper/v1/plugins/install-zip`,
+    target.config,
+    {
+      method: "POST",
+      body: JSON.stringify({
+        filename: official.filename,
+        zip_base64: buf.toString("base64")
+      })
+    },
+    verbose
   );
-  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() ?? "";
@@ -4460,6 +4645,10 @@ async function runPluginsInstall(opts) {
   try {
     result = await withHelperBootstrap(opts, target, async () => {
       if (slug) {
+        const official = await findOfficialPlugin(target.config, slug, opts.verbose);
+        if (official) {
+          return installOfficialZip(target, official, opts.verbose);
+        }
         return apiFetch2(
           `${base}/wp-json/siluzan-helper/v1/plugins/install`,
           target.config,
@@ -4507,16 +4696,20 @@ async function runPluginsUpdate(opts) {
   }
   let result;
   try {
-    result = await withHelperBootstrap(
-      opts,
-      target,
-      () => apiFetch2(
+    result = await withHelperBootstrap(opts, target, async () => {
+      if (!zipPath) {
+        const official = await findOfficialPlugin(target.config, plugin, opts.verbose);
+        if (official) {
+          return installOfficialZip(target, official, opts.verbose);
+        }
+      }
+      return 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)) {
@@ -4682,10 +4875,10 @@ function register7(program2) {
   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 / \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) => {
+  plugins.command("catalog").description("\u5217\u51FA\u5B98\u65B9\u63D2\u4EF6\u76EE\u5F55\uFF08sammk8s / wp-plugins\uFF0C\u4E0D\u4F9D\u8D56\u7AD9\u70B9\uFF09").option("-s, --site <guidOrName>", "\u53EF\u9009\uFF0C\u5BF9\u7167\u8BE5\u7AD9\u662F\u5426\u5DF2\u88C5").option("--url <url>", "\u76F4\u63A5\u6307\u5B9A\u7AD9\u70B9\u5730\u5740").option("--prefix <prefix>", "\u53EA\u5217\u67D0\u4E2A\u76EE\u5F55\uFF0C\u5982 zasp-smart-recommender/").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("\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) => {
+  plugins.command("install").description("\u5B89\u88C5\u5E76\u542F\u7528\u63D2\u4EF6\uFF1A\u5B98\u65B9\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) => {

package/dist/skill/SKILL.md

@@ -62,7 +62,7 @@ Windows 注意：部分 Agent 通过 PowerShell / cmd 代执行时可能失败
 | 分类标签 | `references/terms.md` | `terms list` 再 add/update |
 | 按关键词找内容 | `references/search.md` | `search --q` |
 | 这个站装了哪些插件 | `references/plugins.md` | `plugins list`（全部已装，不只是目录） |
-| 安装 / 启用目录插件 | `references/plugins.md` | `catalog` 找 slug → 确认 → `install --slug` |
+| 安装 / 启用目录插件 | `references/plugins.md` | `plugins catalog`（官方存储目录，含 AI 推荐）→ 确认 → `install --slug` |
 | 安装外部插件 | `references/plugins.md` | 确认 → `install --zip` |
 | 升级已装插件 | `references/plugins.md` | `list` 拿 plugin → 确认 → `update --plugin`；外部再加 `--zip` |
 | 卸载插件 | `references/plugins.md` | `list` 拿 plugin → 确认 → `uninstall --plugin` |

package/dist/skill/_meta.json

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

package/dist/skill/references/plugins.md

@@ -3,9 +3,10 @@
 鉴权一律 **API Key（x-api-key）**。
 
 - **已装列表**走 WordPress 核心 `GET /wp-json/wp/v2/plugins`，能看到站点上的全部插件。
-- **目录安装 / 无 zip 升级**走 `siluzan-helper-plugin` REST。目录包来自丝路赞目录，不接受任意 URL。
+- **可安装目录**走 CSO `GET /cso/v1/wp-plugin/list`（CI：`cso-api-ci.siluzan.com`，连不上回落 `cso-ci.siluzan.com`）。这是 sammk8s 存储账号 `wp-plugins` 容器，每个插件取最高版本 zip。
+- **目录安装 / 无 zip 升级**：CLI 从官方目录下载 zip，再交给站点 helper 的 `install-zip`。不把任意 URL 交给 WordPress。
 - **外部插件**首次安装和升级都带本地 `--zip`。zip 根目录必须是插件目录本身（`插件名/xxx.php`），不能再套一层版本号目录。
-- helper 太旧、没有 REST 时，命令会先打 oauth2 `POST /wp-json/wposso/v1/helper/upgrade`，用镜像里的 `siluzan-helper-plugin.1.0.*.zip` 升 helper，再继续原来的操作。helper **不上架**。
+- helper 太旧、没有 REST 时，命令会先打 oauth2 `POST /wp-json/wposso/v1/helper/upgrade`，用镜像里的 `siluzan-helper-plugin.1.0.*.zip` 升 helper，再继续原来的操作。
 
 ## 已装列表
 
@@ -21,10 +22,12 @@ siluzan-website plugins list --site <guid> --json
 ## 可安装目录
 
 ```bash
+siluzan-website plugins catalog
+siluzan-website plugins catalog --prefix zasp-smart-recommender/
 siluzan-website plugins catalog --site <guid>
 ```
 
-记下 `slug`。目录安装 / 目录升级都用这个值。
+不传 `--site` 也能列。记下 `slug`。目录里有 `zasp-smart-recommender`（AI 推荐）等官方包。
 
 ## 安装
 
@@ -76,7 +79,7 @@ siluzan-website plugins update-helper --site <guid>
 
 1. `sites list` 确定 guid
 2. 用户要「装了哪些插件」→ `plugins list`
-3. 用户要装目录插件 → `catalog` 对上 slug → 确认 → `install --slug`
+3. 用户要装目录插件 → `plugins catalog`（不用站点）对上 slug → 确认 → `install --slug`
 4. 用户要升级已装插件 → `list` 拿到 `plugin` → 确认 → `update --plugin`；外部插件再加 `--zip`
 5. 用户要卸载 → `list` 拿到 `plugin` → 确认不是 helper / oauth2 → `uninstall --plugin`
 6. catalog / install / update 报路由 404 → 命令会自动 `update-helper` 再重试；oauth2 本身 404 / 401 → 告诉用户要先 SiteMan 镜像升级

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.3'
+$PKG_VERSION = '1.0.1-beta.4'
 $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.3"
+readonly PKG_VERSION="1.0.1-beta.4"
 readonly CLI_BIN="siluzan-website"
 readonly SKILL_LABEL="Siluzan Website"
 readonly INSTALL_CMD="npm install -g siluzan-website-cli@beta"

package/package.json

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