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

package/dist/index.js

@@ -1960,6 +1960,7 @@ import * as fs from "fs";
 import * as path from "path";
 import * as os from "os";
 import lockfile from "proper-lockfile";
+import { randomBytes } from "crypto";
 import * as https from "https";
 import * as http from "http";
 import * as zlib from "zlib";
@@ -2460,7 +2461,13 @@ function rawRequest(url, options) {
       }
       reject(err);
     });
-    if (options.body) req.write(options.body);
+    if (options.body !== void 0) {
+      const payload = typeof options.body === "string" ? Buffer.from(options.body) : options.body;
+      if (!headers["Content-Length"] && !headers["content-length"]) {
+        req.setHeader("Content-Length", payload.length);
+      }
+      req.write(payload);
+    }
     req.end();
   });
 }
@@ -2557,6 +2564,54 @@ function formatHttpError(status, rawBody, opts) {
 function buildAuthHeaders(config) {
   return buildSiluzanAuthHeaders(config);
 }
+function buildMultipartBody(fields, files) {
+  const boundary = `----SiluzanForm${randomBytes(16).toString("hex")}`;
+  const chunks = [];
+  for (const [name, value] of Object.entries(fields)) {
+    chunks.push(
+      Buffer.from(
+        `--${boundary}\r
+Content-Disposition: form-data; name="${name}"\r
+\r
+${value}\r
+`
+      )
+    );
+  }
+  for (const file of files) {
+    chunks.push(
+      Buffer.from(
+        `--${boundary}\r
+Content-Disposition: form-data; name="${file.field}"; filename="${file.filename}"\r
+Content-Type: ${file.contentType}\r
+\r
+`
+      )
+    );
+    chunks.push(file.data);
+    chunks.push(Buffer.from("\r\n"));
+  }
+  chunks.push(Buffer.from(`--${boundary}--\r
+`));
+  return {
+    body: Buffer.concat(chunks),
+    contentType: `multipart/form-data; boundary=${boundary}`
+  };
+}
+async function parseApiResponse(status, text, verbose) {
+  if (status < 200 || status >= 300) {
+    throw new Error(formatHttpError(status, text, { verbose }));
+  }
+  if (!text.trim()) return null;
+  try {
+    return parseJsonWithStringIds(text);
+  } catch {
+    if (verbose) {
+      console.error(`  \u26A0\uFE0F  \u54CD\u5E94\u975E JSON\uFF0C\u539F\u59CB\u5185\u5BB9\uFF1A${redactSensitive(text).slice(0, 200)}`);
+    }
+    return text;
+  }
+}
 async function apiFetch(url, config, options = {}, verbose = false) {
   const method = options.method ?? "GET";
   const reqHeaders = {
@@ -2575,19 +2630,23 @@ async function apiFetch(url, config, options = {}, verbose = false) {
     headers: reqHeaders,
     body
   });
-  const text = res.text;
-  if (res.status < 200 || res.status >= 300) {
-    throw new Error(formatHttpError(res.status, text, { verbose }));
-  }
-  if (!text.trim()) return null;
-  try {
-    return parseJsonWithStringIds(text);
-  } catch {
-    if (verbose) {
-      console.error(`  \u26A0\uFE0F  \u54CD\u5E94\u975E JSON\uFF0C\u539F\u59CB\u5185\u5BB9\uFF1A${redactSensitive(text).slice(0, 200)}`);
-    }
-    return text;
-  }
+  return parseApiResponse(res.status, res.text, verbose);
+}
+async function apiFetchMultipart(url, config, payload, verbose = false) {
+  const packed = buildMultipartBody(payload.fields ?? {}, payload.files);
+  const reqHeaders = {
+    "Content-Type": packed.contentType,
+    "Accept-Language": "zh-CN",
+    "Accept-Encoding": "gzip, deflate, br",
+    ...buildAuthHeaders(config),
+    Datapermission: config.dataPermission ?? ""
+  };
+  const res = await rawRequest(url, {
+    method: "POST",
+    headers: reqHeaders,
+    body: packed.body
+  });
+  return parseApiResponse(res.status, res.text, verbose);
 }
 function getCurrentVersion(importMetaUrl) {
   try {
@@ -3691,6 +3750,9 @@ function loadConfig() {
 function apiFetch2(url, config, options = {}, verbose = false) {
   return apiFetch(url, config, options, verbose);
 }
+function apiFetchMultipart2(url, config, payload, verbose = false) {
+  return apiFetchMultipart(url, config, payload, verbose);
+}
 
 // src/utils/site-url.ts
 function normalizeRegion(raw) {
@@ -3842,6 +3904,57 @@ function register5(program2) {
 
 // src/commands/pages.ts
 import * as fs6 from "fs";
+
+// src/utils/wp-site.ts
+async function resolveTarget(opts) {
+  const config = loadConfig();
+  const site = await resolveSite(config, opts);
+  return { config, site, base: trimTrailingSlash(site.url) };
+}
+function wpV2(base, path6) {
+  const suffix = path6.startsWith("/") ? path6 : `/${path6}`;
+  return `${base}/wp-json/wp/v2${suffix}`;
+}
+async function resolveTypeRestBase(target, typeArg, verbose = false) {
+  const needle = typeArg.trim().toLowerCase();
+  if (!needle) {
+    throw new Error("\u8BF7\u63D0\u4F9B --type\uFF08\u5148 content types \u770B rest_base\uFF09");
+  }
+  const types = await apiFetch2(
+    wpV2(target.base, "/types?context=edit"),
+    target.config,
+    {},
+    verbose
+  );
+  for (const [slug, info] of Object.entries(types || {})) {
+    const restBase = (info.rest_base || slug).toLowerCase();
+    if (slug.toLowerCase() === needle || restBase === needle) {
+      return info.rest_base || slug;
+    }
+  }
+  return typeArg.trim();
+}
+async function resolveTaxonomyRestBase(target, taxonomyArg, verbose = false) {
+  const needle = taxonomyArg.trim().toLowerCase();
+  if (!needle) {
+    throw new Error("\u8BF7\u63D0\u4F9B --taxonomy\uFF08\u5982 category\u3001post_tag\uFF09");
+  }
+  const taxes = await apiFetch2(
+    wpV2(target.base, "/taxonomies?context=edit"),
+    target.config,
+    {},
+    verbose
+  );
+  for (const [slug, info] of Object.entries(taxes || {})) {
+    const restBase = (info.rest_base || slug).toLowerCase();
+    if (slug.toLowerCase() === needle || restBase === needle) {
+      return info.rest_base || slug;
+    }
+  }
+  return taxonomyArg.trim();
+}
+
+// src/commands/pages.ts
 function pageTitle(page) {
   if (typeof page.title === "string") return page.title;
   return page.title?.rendered ?? "";
@@ -3909,6 +4022,7 @@ async function runPagesList(opts) {
     { key: "id", header: "id" },
     { key: "title", header: "\u6807\u9898" },
     { key: "status", header: "\u72B6\u6001" },
+    { key: "slug", header: "slug" },
     { key: "link", header: "\u94FE\u63A5" }
   ];
   console.log(`
@@ -3919,6 +4033,7 @@ ${site.name} \u9875\u9762\uFF08${pages.length}\uFF09
       id: String(p.id),
       title: pageTitle(p) || "(\u65E0\u6807\u9898)",
       status: p.status ?? "-",
+      slug: p.slug ?? "-",
       link: p.link ?? "-"
     })),
     columns
@@ -3981,6 +4096,103 @@ async function runPagesWrite(mode, opts) {
   console.log(`   \u7AD9\u70B9    : ${base}
 `);
 }
+async function runPagesGet(opts) {
+  const id = Number(opts.id);
+  if (!Number.isFinite(id) || id <= 0) {
+    console.error("\n\u274C \u8BF7\u63D0\u4F9B --id\n");
+    process.exit(1);
+  }
+  const target = await resolveTarget(opts);
+  const page = await apiFetch2(
+    wpV2(target.base, `/pages/${id}?context=edit`),
+    target.config,
+    {},
+    opts.verbose
+  ).catch((e) => {
+    console.error(`
+\u274C \u83B7\u53D6\u9875\u9762\u5931\u8D25\uFF1A${e.message}
+`);
+    process.exit(1);
+  });
+  if (opts.json) {
+    console.log(JSON.stringify(page, null, 2));
+    return;
+  }
+  console.log(`
+\u9875\u9762 #${page.id}`);
+  console.log(`   \u6807\u9898 : ${pageTitle(page) || "-"}`);
+  console.log(`   \u72B6\u6001 : ${page.status || "-"}`);
+  console.log(`   slug : ${page.slug || "-"}`);
+  console.log(`   \u94FE\u63A5 : ${page.link || "-"}`);
+  if (page.parent) console.log(`   \u7236\u9875 : ${page.parent}`);
+  if (page.featured_media) console.log(`   \u7279\u8272\u56FE : ${page.featured_media}`);
+  console.log();
+}
+async function runPagesMeta(opts) {
+  const id = Number(opts.id);
+  if (!Number.isFinite(id) || id <= 0) {
+    console.error("\n\u274C \u8BF7\u63D0\u4F9B --id\n");
+    process.exit(1);
+  }
+  const body = {};
+  if (opts.title?.trim()) body.title = opts.title.trim();
+  if (opts.slug?.trim()) body.slug = opts.slug.trim();
+  if (opts.status?.trim()) body.status = opts.status.trim();
+  const parent = Number(opts.parent);
+  if (opts.parent !== void 0 && Number.isFinite(parent)) body.parent = parent;
+  const featured = Number(opts.featuredMedia);
+  if (Number.isFinite(featured) && featured > 0) body.featured_media = featured;
+  if (Object.keys(body).length === 0) {
+    console.error("\n\u274C \u6CA1\u6709\u8981\u6539\u7684\u5B57\u6BB5\u3002\u6B63\u6587\u8BF7\u7528 pages update\u3002\n");
+    process.exit(1);
+  }
+  const target = await resolveTarget(opts);
+  const page = await apiFetch2(
+    wpV2(target.base, `/pages/${id}`),
+    target.config,
+    { method: "POST", body: JSON.stringify(body) },
+    opts.verbose
+  ).catch((e) => {
+    console.error(`
+\u274C \u66F4\u65B0\u9875\u9762\u5143\u6570\u636E\u5931\u8D25\uFF1A${e.message}
+`);
+    process.exit(1);
+  });
+  console.log(`
+\u2705 \u9875\u9762 #${page.id} \u5143\u6570\u636E\u5DF2\u66F4\u65B0`);
+  console.log(`   \u6807\u9898 : ${pageTitle(page) || "-"}`);
+  console.log(`   \u72B6\u6001 : ${page.status || "-"}`);
+  console.log(`   slug : ${page.slug || "-"}`);
+  if (page.link) console.log(`   \u94FE\u63A5 : ${page.link}`);
+  console.log();
+}
+async function runPagesTrash(opts) {
+  const id = Number(opts.id);
+  if (!Number.isFinite(id) || id <= 0) {
+    console.error("\n\u274C \u8BF7\u63D0\u4F9B --id\n");
+    process.exit(1);
+  }
+  const target = await resolveTarget(opts);
+  const qs = opts.force ? "?force=true" : "";
+  const page = await apiFetch2(
+    wpV2(target.base, `/pages/${id}${qs}`),
+    target.config,
+    { method: "DELETE" },
+    opts.verbose
+  ).catch((e) => {
+    console.error(`
+\u274C \u5220\u9664\u9875\u9762\u5931\u8D25\uFF1A${e.message}
+`);
+    process.exit(1);
+  });
+  console.log(
+    opts.force ? `
+\u2705 \u5DF2\u6C38\u4E45\u5220\u9664\u9875\u9762 #${id}
+` : `
+\u2705 \u9875\u9762 #${id} \u5DF2\u8FDB\u56DE\u6536\u7AD9\uFF08status=${page.status || "trash"}\uFF09
+`
+  );
+}
 function register6(program2) {
   const pages = program2.command("pages").description("WordPress \u9875\u9762\uFF08zionbuilder visual-edit\uFF09");
   pages.command("list").description("\u5217\u51FA\u7AD9\u70B9\u9875\u9762").option("-s, --site <guidOrName>", "\u7AD9\u70B9 guid \u6216\u540D\u79F0").option("--url <url>", "\u76F4\u63A5\u6307\u5B9A\u7AD9\u70B9\u5730\u5740\uFF08\u8DF3\u8FC7 all-sites\uFF09").option("--json", "\u8F93\u51FA JSON", false).option("--verbose", "\u8F93\u51FA\u8BF7\u6C42\u8BE6\u60C5", false).action(async (opts) => {
@@ -3992,47 +4204,149 @@ function register6(program2) {
   pages.command("update").description("\u7528 HTML \u8986\u76D6\u5DF2\u6709\u9875\u9762\uFF08\u8D70 save-visual-edit\uFF0C\u4F1A\u76F4\u63A5\u53D1\u5E03\uFF09").option("-s, --site <guidOrName>", "\u7AD9\u70B9 guid \u6216\u540D\u79F0").option("--url <url>", "\u76F4\u63A5\u6307\u5B9A\u7AD9\u70B9\u5730\u5740").requiredOption("--id <id>", "\u9875\u9762 ID").option("-t, --title <title>", "\u65B0\u6807\u9898\uFF08\u53EF\u7701\u7565\uFF09").option("-c, --content <html>", "HTML \u6B63\u6587").option("--content-file <path>", "\u4ECE\u6587\u4EF6\u8BFB\u53D6 HTML \u6B63\u6587").option("--css <css>", "\u9644\u52A0 CSS").option("--css-file <path>", "\u4ECE\u6587\u4EF6\u8BFB\u53D6 CSS").option("--js <js>", "\u9644\u52A0 JS").option("--js-file <path>", "\u4ECE\u6587\u4EF6\u8BFB\u53D6 JS").option("--verbose", "\u8F93\u51FA\u8BF7\u6C42\u8BE6\u60C5", false).action(async (opts) => {
     await runPagesWrite("update", opts);
   });
+  pages.command("get").description("\u67E5\u770B\u5355\u4E2A\u9875\u9762\u7684\u5143\u6570\u636E").option("-s, --site <guidOrName>", "\u7AD9\u70B9 guid \u6216\u540D\u79F0").option("--url <url>", "\u76F4\u63A5\u6307\u5B9A\u7AD9\u70B9\u5730\u5740").requiredOption("--id <id>", "\u9875\u9762 ID").option("--json", "\u8F93\u51FA JSON", false).option("--verbose", "\u8F93\u51FA\u8BF7\u6C42\u8BE6\u60C5", false).action(async (opts) => {
+    await runPagesGet(opts);
+  });
+  pages.command("meta").description("\u6539\u9875\u9762 slug / \u72B6\u6001 / \u7236\u9875 / \u7279\u8272\u56FE\uFF08\u4E0D\u6539 Zion \u6B63\u6587\uFF09").option("-s, --site <guidOrName>", "\u7AD9\u70B9 guid \u6216\u540D\u79F0").option("--url <url>", "\u76F4\u63A5\u6307\u5B9A\u7AD9\u70B9\u5730\u5740").requiredOption("--id <id>", "\u9875\u9762 ID").option("-t, --title <title>", "\u6807\u9898").option("--slug <slug>", "\u522B\u540D").option("--status <status>", "publish / draft / private / pending").option("--parent <id>", "\u7236\u9875\u9762 ID\uFF0C0 \u8868\u793A\u53D6\u6D88").option("--featured-media <id>", "\u7279\u8272\u56FE\u5A92\u4F53 ID").option("--verbose", "\u8F93\u51FA\u8BF7\u6C42\u8BE6\u60C5", false).action(async (opts) => {
+    await runPagesMeta(opts);
+  });
+  pages.command("trash").description("\u9875\u9762\u8FDB\u56DE\u6536\u7AD9\uFF1B\u52A0 --force \u6C38\u4E45\u5220\u9664").option("-s, --site <guidOrName>", "\u7AD9\u70B9 guid \u6216\u540D\u79F0").option("--url <url>", "\u76F4\u63A5\u6307\u5B9A\u7AD9\u70B9\u5730\u5740").requiredOption("--id <id>", "\u9875\u9762 ID").option("--force", "\u6C38\u4E45\u5220\u9664", false).option("--verbose", "\u8F93\u51FA\u8BF7\u6C42\u8BE6\u60C5", false).action(async (opts) => {
+    await runPagesTrash(opts);
+  });
 }
 
 // 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;
+var PROTECTED_PLUGIN_PREFIXES = ["siluzan-helper-plugin", "wp-oauth2"];
+function isProtectedPlugin(plugin) {
+  const key = pluginKey(plugin);
+  return PROTECTED_PLUGIN_PREFIXES.some((prefix) => key === prefix || key.startsWith(`${prefix}/`));
+}
+function wpPluginRestPath(plugin) {
+  return plugin.replace(/\\/g, "/").split("/").filter(Boolean).map((part) => encodeURIComponent(part)).join("/");
+}
 function pluginName(item) {
   if (typeof item.name === "string") return item.name;
   return item.name?.raw || item.name?.rendered || item.plugin || "";
 }
-async function resolveTarget(opts) {
+function pluginKey(value) {
+  return value.replace(/\\/g, "/").replace(/\.php$/i, "").toLowerCase();
+}
+async function resolveTarget2(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 { config, site, base } = await resolveTarget2(opts);
   const api = `${base}/wp-json/wp/v2/plugins`;
   let plugins;
   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 +4354,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 +4364,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 resolveTarget2(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 +4428,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,68 +4440,991 @@ ${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 target = await resolveTarget2(opts);
+  const { site, base } = target;
+  let result;
+  try {
+    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}
+`);
+    process.exit(1);
+    return;
+  }
+  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 resolveTarget2(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 \u5347\u7EA7\u5931\u8D25\uFF1A${msg}
+`);
+    process.exit(1);
+    return;
+  }
+  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 resolveTarget2(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;
   }
-  const { config, site, base } = await resolveTarget(opts);
-  const api = `${base}/wp-json/siluzan-helper/v1/plugins/install`;
+  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 resolveTarget2(opts);
   let result;
   try {
     result = await apiFetch2(
-      api,
+      `${base}/wp-json/wposso/v1/helper/upgrade`,
       config,
-      { method: "POST", body: JSON.stringify({ slug }) },
+      { method: "POST", body: JSON.stringify({}) },
       opts.verbose
     );
   } catch (e) {
+    const msg = e.message || "";
     console.error(`
-\u274C \u5B89\u88C5\u5931\u8D25\uFF1A${e.message}
+\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 });
+  }
+}
+async function findInstalledPlugin(base, config, pluginArg, verbose = false) {
+  const plugins = await apiFetch2(`${base}/wp-json/wp/v2/plugins`, config, {}, verbose);
+  if (!Array.isArray(plugins)) {
+    throw new Error("\u7AD9\u70B9\u8FD4\u56DE\u7684\u63D2\u4EF6\u5217\u8868\u683C\u5F0F\u5F02\u5E38");
+  }
+  const needle = pluginKey(pluginArg);
+  const exact = plugins.find((p) => pluginKey(p.plugin || "") === needle);
+  if (exact?.plugin) return exact;
+  const hits = plugins.filter((p) => {
+    const key = pluginKey(p.plugin || "");
+    return key === needle || key.startsWith(`${needle}/`) || key.endsWith(`/${needle}`);
+  });
+  if (hits.length === 1 && hits[0].plugin) return hits[0];
+  if (hits.length > 1) {
+    const names = hits.map((p) => p.plugin).join("\u3001");
+    throw new Error(`\u300C${pluginArg}\u300D\u5339\u914D\u5230\u591A\u4E2A\u63D2\u4EF6\uFF0C\u8BF7\u6539\u7528\u5B8C\u6574 --plugin\uFF1A${names}`);
+  }
+  throw new Error(`\u7AD9\u70B9\u4E0A\u6CA1\u6709\u63D2\u4EF6\u300C${pluginArg}\u300D\uFF0C\u5148 plugins list \u770B plugin \u5217`);
+}
+async function runPluginsUninstall(opts) {
+  const pluginArg = opts.plugin?.trim() ?? "";
+  if (!pluginArg) {
+    console.error("\n\u274C \u8BF7\u63D0\u4F9B --plugin\uFF08\u5148 plugins list \u770B plugin \u5217\uFF09\n");
+    process.exit(1);
+  }
+  if (isProtectedPlugin(pluginArg)) {
+    console.error("\n\u274C \u4E0D\u80FD\u5378\u8F7D siluzan-helper-plugin \u6216 wp-oauth2\uFF0C\u5378\u6389\u540E\u7AD9\u70B9\u65E0\u6CD5\u518D\u7528 Skill \u7BA1\u7406\u3002\n");
+    process.exit(1);
+  }
+  const target = await resolveTarget2(opts);
+  const { site, base } = target;
+  let current;
+  try {
+    current = await findInstalledPlugin(base, target.config, pluginArg, opts.verbose);
+  } catch (e) {
+    console.error(`
+\u274C ${e.message}
 `);
     process.exit(1);
     return;
   }
-  if (!result.success) {
+  const plugin = current.plugin || pluginArg;
+  if (isProtectedPlugin(plugin)) {
+    console.error("\n\u274C \u4E0D\u80FD\u5378\u8F7D siluzan-helper-plugin \u6216 wp-oauth2\uFF0C\u5378\u6389\u540E\u7AD9\u70B9\u65E0\u6CD5\u518D\u7528 Skill \u7BA1\u7406\u3002\n");
+    process.exit(1);
+  }
+  const restPath = `${base}/wp-json/wp/v2/plugins/${wpPluginRestPath(plugin)}`;
+  try {
+    if (current.status === "active") {
+      console.log(`\u5148\u505C\u7528 ${plugin} \u2026`);
+      await apiFetch2(
+        restPath,
+        target.config,
+        { method: "POST", body: JSON.stringify({ status: "inactive" }) },
+        opts.verbose
+      );
+    }
+    await apiFetch2(restPath, target.config, { method: "DELETE" }, opts.verbose);
+  } catch (e) {
     console.error(`
-\u274C ${result.message || "\u5B89\u88C5\u88AB\u7AD9\u70B9\u62D2\u7EDD"}
+\u274C \u5378\u8F7D\u5931\u8D25\uFF1A${e.message}
 `);
     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(`
+\u2705 \u5DF2\u5378\u8F7D ${plugin}`);
   console.log(`   \u7AD9\u70B9   : ${site.name} (${base})
 `);
-  try {
-    await runPluginsList({ site: site.guid || opts.site, url: site.url, verbose: opts.verbose });
-  } catch {
-  }
+  await runPluginsList({
+    site: site.guid || opts.site,
+    url: site.url,
+    verbose: opts.verbose,
+    exitOnError: false
+  });
 }
 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\u3001\u5378\u8F7D");
+  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("uninstall").description("\u5378\u8F7D\u5DF2\u88C5\u63D2\u4EF6\uFF08\u5148\u505C\u7528\u518D\u5220\u9664\uFF1Bhelper / oauth2 \u4E0D\u5141\u8BB8\uFF09").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 dummy-e2e-plugin/dummy-e2e-plugin").option("--verbose", "\u8F93\u51FA\u8BF7\u6C42\u8BE6\u60C5", false).action(async (opts) => {
+    await runPluginsUninstall(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/commands/content.ts
+import * as fs7 from "fs";
+
+// src/types/wp-rest.ts
+function wpRenderedText(value) {
+  if (!value) return "";
+  if (typeof value === "string") return value;
+  return value.raw || value.rendered || "";
+}
+
+// src/commands/content.ts
+function parseIdList(raw) {
+  if (!raw?.trim()) return void 0;
+  return raw.split(",").map((s) => Number(s.trim())).filter((n) => Number.isFinite(n) && n > 0);
+}
+function printPost(item, restBase) {
+  console.log(`
+\u2705 ${restBase} #${item.id}`);
+  console.log(`   \u6807\u9898   : ${wpRenderedText(item.title) || "-"}`);
+  console.log(`   \u72B6\u6001   : ${item.status || "-"}`);
+  console.log(`   slug   : ${item.slug || "-"}`);
+  if (item.link) console.log(`   \u94FE\u63A5   : ${item.link}`);
+  console.log();
+}
+async function runContentTypes(opts) {
+  const target = await resolveTarget(opts);
+  let types;
+  try {
+    types = await apiFetch2(
+      wpV2(target.base, "/types?context=edit"),
+      target.config,
+      {},
+      opts.verbose
+    );
+  } catch (e) {
+    console.error(`
+\u274C \u83B7\u53D6\u5185\u5BB9\u7C7B\u578B\u5931\u8D25\uFF1A${e.message}
+`);
+    process.exit(1);
+    return;
+  }
+  const rows = Object.entries(types || {}).map(([slug, info]) => ({
+    slug,
+    rest_base: info.rest_base || slug,
+    name: info.name || slug
+  }));
+  if (opts.json) {
+    console.log(JSON.stringify({ site: target.site, types: rows }, null, 2));
+    return;
+  }
+  console.log(`
+${target.site.name} \u53EF REST \u7BA1\u7406\u7684\u5185\u5BB9\u7C7B\u578B\uFF08${rows.length}\uFF09
+`);
+  printCliTable(rows, [
+    { key: "slug", header: "slug" },
+    { key: "rest_base", header: "rest_base\uFF08--type\uFF09" },
+    { key: "name", header: "\u540D\u79F0" }
+  ]);
+  console.log("\n\u9875\u9762\u6B63\u6587\u8BF7\u7528 pages add/update\uFF1B\u5176\u5B83\u7C7B\u578B\u7528 content add --type <rest_base>\n");
+}
+async function runContentList(opts) {
+  const typeArg = opts.type?.trim() || "posts";
+  const target = await resolveTarget(opts);
+  let restBase;
+  try {
+    restBase = await resolveTypeRestBase(target, typeArg, opts.verbose);
+  } catch (e) {
+    console.error(`
+\u274C ${e.message}
+`);
+    process.exit(1);
+    return;
+  }
+  const status = opts.status?.trim() || "publish,draft,private,pending";
+  const api = wpV2(target.base, `/${restBase}?per_page=100&status=${encodeURIComponent(status)}`);
+  let items;
+  try {
+    items = await apiFetch2(api, target.config, {}, opts.verbose);
+  } catch (e) {
+    console.error(`
+\u274C \u83B7\u53D6 ${restBase} \u5931\u8D25\uFF1A${e.message}
+`);
+    process.exit(1);
+    return;
+  }
+  if (!Array.isArray(items)) {
+    console.error("\n\u274C \u7AD9\u70B9\u8FD4\u56DE\u7684\u5217\u8868\u683C\u5F0F\u5F02\u5E38\n");
+    process.exit(1);
+  }
+  if (opts.json) {
+    console.log(
+      JSON.stringify(
+        {
+          site: { guid: target.site.guid, name: target.site.name, url: target.site.url },
+          type: restBase,
+          total: items.length,
+          items: items.map((p) => ({
+            id: p.id,
+            title: wpRenderedText(p.title),
+            status: p.status ?? "",
+            slug: p.slug ?? "",
+            link: p.link ?? "",
+            modified: p.modified ?? ""
+          }))
+        },
+        null,
+        2
+      )
+    );
+    return;
+  }
+  if (items.length === 0) {
+    console.log(`
+${target.site.name} \u6CA1\u6709 ${restBase}\u3002
+`);
+    return;
+  }
+  const columns = [
+    { key: "id", header: "id" },
+    { key: "title", header: "\u6807\u9898" },
+    { key: "status", header: "\u72B6\u6001" },
+    { key: "slug", header: "slug" },
+    { key: "link", header: "\u94FE\u63A5" }
+  ];
+  console.log(`
+${target.site.name} ${restBase}\uFF08${items.length}\uFF09
+`);
+  printCliTable(
+    items.map((p) => ({
+      id: String(p.id),
+      title: wpRenderedText(p.title) || "(\u65E0\u6807\u9898)",
+      status: p.status ?? "-",
+      slug: p.slug ?? "-",
+      link: p.link ?? "-"
+    })),
+    columns
+  );
+  console.log();
+}
+async function runContentGet(opts) {
+  const id = Number(opts.id);
+  if (!Number.isFinite(id) || id <= 0) {
+    console.error("\n\u274C \u8BF7\u63D0\u4F9B\u6709\u6548 --id\n");
+    process.exit(1);
+  }
+  const target = await resolveTarget(opts);
+  const restBase = await resolveTypeRestBase(target, opts.type?.trim() || "posts", opts.verbose);
+  const item = await apiFetch2(
+    wpV2(target.base, `/${restBase}/${id}?context=edit`),
+    target.config,
+    {},
+    opts.verbose
+  ).catch((e) => {
+    console.error(`
+\u274C \u83B7\u53D6\u5931\u8D25\uFF1A${e.message}
+`);
+    process.exit(1);
+  });
+  if (opts.json) {
+    console.log(JSON.stringify(item, null, 2));
+    return;
+  }
+  console.log(`
+${restBase} #${item.id}`);
+  console.log(`   \u6807\u9898     : ${wpRenderedText(item.title) || "-"}`);
+  console.log(`   \u72B6\u6001     : ${item.status || "-"}`);
+  console.log(`   slug     : ${item.slug || "-"}`);
+  console.log(`   \u94FE\u63A5     : ${item.link || "-"}`);
+  if (item.featured_media) console.log(`   \u7279\u8272\u56FE   : ${item.featured_media}`);
+  const excerpt = wpRenderedText(item.excerpt);
+  if (excerpt) console.log(`   \u6458\u8981     : ${excerpt.slice(0, 120)}`);
+  console.log();
+}
+async function runContentWrite(mode, opts) {
+  const typeArg = opts.type?.trim() || "posts";
+  if (typeArg === "page" || typeArg === "pages") {
+    console.error("\n\u274C \u9875\u9762\u6B63\u6587\u8BF7\u7528 pages add / pages update\uFF08Zion visual-edit\uFF09\u3002");
+    console.error("   \u53EA\u6539 slug/\u72B6\u6001/\u56DE\u6536\u7AD9\u7528 pages meta / pages trash\u3002\n");
+    process.exit(1);
+  }
+  const target = await resolveTarget(opts);
+  const restBase = await resolveTypeRestBase(target, typeArg, opts.verbose);
+  const content = opts.contentFile ? fs7.readFileSync(opts.contentFile, "utf8") : opts.content ?? "";
+  if (mode === "add" && !opts.title?.trim() && !content.trim()) {
+    console.error("\n\u274C \u65B0\u589E\u81F3\u5C11\u8981 --title \u6216 --content / --content-file\n");
+    process.exit(1);
+  }
+  const body = {};
+  if (opts.title?.trim()) body.title = opts.title.trim();
+  if (content.trim()) body.content = content;
+  if (opts.status?.trim()) body.status = opts.status.trim();
+  if (opts.slug?.trim()) body.slug = opts.slug.trim();
+  if (opts.excerpt?.trim()) body.excerpt = opts.excerpt.trim();
+  const featured = Number(opts.featuredMedia);
+  if (Number.isFinite(featured) && featured > 0) body.featured_media = featured;
+  const cats = parseIdList(opts.categories);
+  if (cats) body.categories = cats;
+  const tags = parseIdList(opts.tags);
+  if (tags) body.tags = tags;
+  if (mode === "update") {
+    const id = Number(opts.id);
+    if (!Number.isFinite(id) || id <= 0) {
+      console.error("\n\u274C \u66F4\u65B0\u5FC5\u987B\u63D0\u4F9B --id\uFF08\u5148 content list\uFF09\n");
+      process.exit(1);
+    }
+    if (Object.keys(body).length === 0) {
+      console.error("\n\u274C \u6CA1\u6709\u8981\u6539\u7684\u5B57\u6BB5\n");
+      process.exit(1);
+    }
+    const item2 = await apiFetch2(
+      wpV2(target.base, `/${restBase}/${id}`),
+      target.config,
+      { method: "POST", body: JSON.stringify(body) },
+      opts.verbose
+    ).catch((e) => {
+      console.error(`
+\u274C \u66F4\u65B0\u5931\u8D25\uFF1A${e.message}
+`);
+      process.exit(1);
+    });
+    printPost(item2, restBase);
+    return;
+  }
+  const item = await apiFetch2(
+    wpV2(target.base, `/${restBase}`),
+    target.config,
+    { method: "POST", body: JSON.stringify(body) },
+    opts.verbose
+  ).catch((e) => {
+    console.error(`
+\u274C \u65B0\u589E\u5931\u8D25\uFF1A${e.message}
+`);
+    process.exit(1);
+  });
+  printPost(item, restBase);
+}
+async function runContentTrash(opts) {
+  const id = Number(opts.id);
+  if (!Number.isFinite(id) || id <= 0) {
+    console.error("\n\u274C \u8BF7\u63D0\u4F9B --id\n");
+    process.exit(1);
+  }
+  const target = await resolveTarget(opts);
+  const restBase = await resolveTypeRestBase(target, opts.type?.trim() || "posts", opts.verbose);
+  const qs = opts.force ? "?force=true" : "";
+  const item = await apiFetch2(
+    wpV2(target.base, `/${restBase}/${id}${qs}`),
+    target.config,
+    { method: "DELETE" },
+    opts.verbose
+  ).catch((e) => {
+    console.error(`
+\u274C \u5220\u9664\u5931\u8D25\uFF1A${e.message}
+`);
+    process.exit(1);
+  });
+  console.log(opts.force ? `
+\u2705 \u5DF2\u6C38\u4E45\u5220\u9664 ${restBase} #${id}
+` : `
+\u2705 \u5DF2\u79FB\u5165\u56DE\u6536\u7AD9 ${restBase} #${id}\uFF08status=${item.status || "trash"}\uFF09
+`);
+}
+function register8(program2) {
+  const content = program2.command("content").description("\u901A\u7528\u5185\u5BB9\uFF1A\u6587\u7AE0/\u4EA7\u54C1\u7B49 REST \u7C7B\u578B\uFF08\u9875\u9762\u6B63\u6587\u8BF7\u7528 pages\uFF09");
+  content.command("types").description("\u5217\u51FA\u7AD9\u70B9\u53EF REST \u7BA1\u7406\u7684\u5185\u5BB9\u7C7B\u578B").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 runContentTypes(opts);
+  });
+  content.command("list").description("\u5217\u51FA\u67D0\u4E00\u7C7B\u578B\u7684\u5185\u5BB9").option("-s, --site <guidOrName>", "\u7AD9\u70B9 guid \u6216\u540D\u79F0").option("--url <url>", "\u76F4\u63A5\u6307\u5B9A\u7AD9\u70B9\u5730\u5740").option("--type <restBase>", "\u7C7B\u578B rest_base\uFF0C\u9ED8\u8BA4 posts", "posts").option("--status <status>", "\u72B6\u6001\uFF0C\u9017\u53F7\u5206\u9694", "publish,draft,private,pending").option("--json", "\u8F93\u51FA JSON", false).option("--verbose", "\u8F93\u51FA\u8BF7\u6C42\u8BE6\u60C5", false).action(async (opts) => {
+    await runContentList(opts);
+  });
+  content.command("get").description("\u67E5\u770B\u5355\u6761\u5185\u5BB9").option("-s, --site <guidOrName>", "\u7AD9\u70B9 guid \u6216\u540D\u79F0").option("--url <url>", "\u76F4\u63A5\u6307\u5B9A\u7AD9\u70B9\u5730\u5740").option("--type <restBase>", "\u7C7B\u578B rest_base\uFF0C\u9ED8\u8BA4 posts", "posts").requiredOption("--id <id>", "\u5185\u5BB9 ID").option("--json", "\u8F93\u51FA JSON", false).option("--verbose", "\u8F93\u51FA\u8BF7\u6C42\u8BE6\u60C5", false).action(async (opts) => {
+    await runContentGet(opts);
+  });
+  content.command("add").description("\u65B0\u589E\u6587\u7AE0\u6216\u5176\u5B83 CPT\uFF08\u4E0D\u8981\u7528\u6765\u52A0 Zion \u9875\u9762\uFF09").option("-s, --site <guidOrName>", "\u7AD9\u70B9 guid \u6216\u540D\u79F0").option("--url <url>", "\u76F4\u63A5\u6307\u5B9A\u7AD9\u70B9\u5730\u5740").option("--type <restBase>", "\u7C7B\u578B rest_base\uFF0C\u9ED8\u8BA4 posts", "posts").option("-t, --title <title>", "\u6807\u9898").option("-c, --content <html>", "\u6B63\u6587 HTML").option("--content-file <path>", "\u4ECE\u6587\u4EF6\u8BFB\u6B63\u6587").option("--status <status>", "publish / draft / private", "draft").option("--slug <slug>", "\u522B\u540D").option("--excerpt <text>", "\u6458\u8981").option("--featured-media <id>", "\u7279\u8272\u56FE\u5A92\u4F53 ID").option("--categories <ids>", "\u5206\u7C7B ID\uFF0C\u9017\u53F7\u5206\u9694").option("--tags <ids>", "\u6807\u7B7E ID\uFF0C\u9017\u53F7\u5206\u9694").option("--verbose", "\u8F93\u51FA\u8BF7\u6C42\u8BE6\u60C5", false).action(async (opts) => {
+    await runContentWrite("add", opts);
+  });
+  content.command("update").description("\u66F4\u65B0\u5DF2\u6709\u5185\u5BB9\u5B57\u6BB5").option("-s, --site <guidOrName>", "\u7AD9\u70B9 guid \u6216\u540D\u79F0").option("--url <url>", "\u76F4\u63A5\u6307\u5B9A\u7AD9\u70B9\u5730\u5740").option("--type <restBase>", "\u7C7B\u578B rest_base\uFF0C\u9ED8\u8BA4 posts", "posts").requiredOption("--id <id>", "\u5185\u5BB9 ID").option("-t, --title <title>", "\u6807\u9898").option("-c, --content <html>", "\u6B63\u6587 HTML").option("--content-file <path>", "\u4ECE\u6587\u4EF6\u8BFB\u6B63\u6587").option("--status <status>", "publish / draft / private / pending").option("--slug <slug>", "\u522B\u540D").option("--excerpt <text>", "\u6458\u8981").option("--featured-media <id>", "\u7279\u8272\u56FE\u5A92\u4F53 ID").option("--categories <ids>", "\u5206\u7C7B ID\uFF0C\u9017\u53F7\u5206\u9694").option("--tags <ids>", "\u6807\u7B7E ID\uFF0C\u9017\u53F7\u5206\u9694").option("--verbose", "\u8F93\u51FA\u8BF7\u6C42\u8BE6\u60C5", false).action(async (opts) => {
+    await runContentWrite("update", opts);
+  });
+  content.command("trash").description("\u79FB\u5165\u56DE\u6536\u7AD9\uFF1B\u52A0 --force \u6C38\u4E45\u5220\u9664").option("-s, --site <guidOrName>", "\u7AD9\u70B9 guid \u6216\u540D\u79F0").option("--url <url>", "\u76F4\u63A5\u6307\u5B9A\u7AD9\u70B9\u5730\u5740").option("--type <restBase>", "\u7C7B\u578B rest_base\uFF0C\u9ED8\u8BA4 posts", "posts").requiredOption("--id <id>", "\u5185\u5BB9 ID").option("--force", "\u6C38\u4E45\u5220\u9664", false).option("--verbose", "\u8F93\u51FA\u8BF7\u6C42\u8BE6\u60C5", false).action(async (opts) => {
+    await runContentTrash(opts);
+  });
+}
+
+// src/commands/media.ts
+import { existsSync as existsSync4, readFileSync as readFileSync8 } from "fs";
+import { basename as basename3, extname, resolve as resolve3 } from "path";
+var MIME_BY_EXT = {
+  ".jpg": "image/jpeg",
+  ".jpeg": "image/jpeg",
+  ".png": "image/png",
+  ".gif": "image/gif",
+  ".webp": "image/webp",
+  ".svg": "image/svg+xml",
+  ".pdf": "application/pdf",
+  ".mp4": "video/mp4",
+  ".zip": "application/zip"
+};
+var MAX_MEDIA_BYTES = 20 * 1024 * 1024;
+function guessMime(filename) {
+  return MIME_BY_EXT[extname(filename).toLowerCase()] || "application/octet-stream";
+}
+async function runMediaList(opts) {
+  const target = await resolveTarget(opts);
+  let items;
+  try {
+    items = await apiFetch2(
+      wpV2(target.base, "/media?per_page=50"),
+      target.config,
+      {},
+      opts.verbose
+    );
+  } catch (e) {
+    console.error(`
+\u274C \u83B7\u53D6\u5A92\u4F53\u5E93\u5931\u8D25\uFF1A${e.message}
+`);
+    process.exit(1);
+    return;
+  }
+  if (!Array.isArray(items)) {
+    console.error("\n\u274C \u7AD9\u70B9\u8FD4\u56DE\u7684\u5A92\u4F53\u5217\u8868\u683C\u5F0F\u5F02\u5E38\n");
+    process.exit(1);
+  }
+  if (opts.json) {
+    console.log(
+      JSON.stringify(
+        {
+          site: { guid: target.site.guid, name: target.site.name, url: target.site.url },
+          total: items.length,
+          items: items.map((m) => ({
+            id: m.id,
+            title: wpRenderedText(m.title),
+            mime: m.mime_type ?? "",
+            url: m.source_url ?? ""
+          }))
+        },
+        null,
+        2
+      )
+    );
+    return;
+  }
+  if (items.length === 0) {
+    console.log(`
+${target.site.name} \u5A92\u4F53\u5E93\u4E3A\u7A7A\u3002
+`);
+    return;
+  }
+  console.log(`
+${target.site.name} \u5A92\u4F53\uFF08\u6700\u8FD1 ${items.length}\uFF09
+`);
+  printCliTable(
+    items.map((m) => ({
+      id: String(m.id),
+      title: wpRenderedText(m.title) || "-",
+      mime: m.mime_type || "-",
+      url: m.source_url || "-"
+    })),
+    [
+      { key: "id", header: "id" },
+      { key: "title", header: "\u6807\u9898" },
+      { key: "mime", header: "\u7C7B\u578B" },
+      { key: "url", header: "\u5730\u5740" }
+    ]
+  );
+  console.log();
+}
+async function runMediaGet(opts) {
+  const id = Number(opts.id);
+  if (!Number.isFinite(id) || id <= 0) {
+    console.error("\n\u274C \u8BF7\u63D0\u4F9B --id\n");
+    process.exit(1);
+  }
+  const target = await resolveTarget(opts);
+  const item = await apiFetch2(
+    wpV2(target.base, `/media/${id}`),
+    target.config,
+    {},
+    opts.verbose
+  ).catch((e) => {
+    console.error(`
+\u274C \u83B7\u53D6\u5A92\u4F53\u5931\u8D25\uFF1A${e.message}
+`);
+    process.exit(1);
+  });
+  if (opts.json) {
+    console.log(JSON.stringify(item, null, 2));
+    return;
+  }
+  console.log(`
+\u5A92\u4F53 #${item.id}`);
+  console.log(`   \u6807\u9898 : ${wpRenderedText(item.title) || "-"}`);
+  console.log(`   \u7C7B\u578B : ${item.mime_type || "-"}`);
+  console.log(`   \u5730\u5740 : ${item.source_url || "-"}`);
+  if (item.alt_text) console.log(`   alt  : ${item.alt_text}`);
+  console.log();
+}
+async function runMediaUpload(opts) {
+  const filePath = opts.file?.trim() ?? "";
+  if (!filePath) {
+    console.error("\n\u274C \u8BF7\u63D0\u4F9B --file\n");
+    process.exit(1);
+  }
+  const abs = resolve3(filePath);
+  if (!existsSync4(abs)) {
+    console.error(`
+\u274C \u6587\u4EF6\u4E0D\u5B58\u5728\uFF1A${abs}
+`);
+    process.exit(1);
+  }
+  const data = readFileSync8(abs);
+  if (data.length > MAX_MEDIA_BYTES) {
+    console.error("\n\u274C \u6587\u4EF6\u8D85\u8FC7 20MB\n");
+    process.exit(1);
+  }
+  const filename = basename3(abs);
+  const target = await resolveTarget(opts);
+  const fields = {};
+  if (opts.title?.trim()) fields.title = opts.title.trim();
+  if (opts.alt?.trim()) fields.alt_text = opts.alt.trim();
+  if (opts.caption?.trim()) fields.caption = opts.caption.trim();
+  let item;
+  try {
+    item = await apiFetchMultipart2(
+      wpV2(target.base, "/media"),
+      target.config,
+      {
+        fields,
+        files: [
+          {
+            field: "file",
+            filename,
+            contentType: guessMime(filename),
+            data
+          }
+        ]
+      },
+      opts.verbose
+    );
+  } catch (e) {
+    console.error(`
+\u274C \u4E0A\u4F20\u5931\u8D25\uFF1A${e.message}
+`);
+    process.exit(1);
+    return;
+  }
+  console.log(`
+\u2705 \u5DF2\u4E0A\u4F20\u5A92\u4F53 #${item.id}`);
+  console.log(`   \u5730\u5740 : ${item.source_url || "-"}`);
+  console.log(`   \u6807\u9898 : ${wpRenderedText(item.title) || filename}`);
+  console.log();
+}
+function register9(program2) {
+  const media = program2.command("media").description("\u5A92\u4F53\u5E93\uFF1A\u5217\u51FA\u3001\u67E5\u770B\u3001\u4E0A\u4F20");
+  media.command("list").description("\u5217\u51FA\u5A92\u4F53\u5E93\uFF08\u6700\u8FD1 50 \u6761\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 runMediaList(opts);
+  });
+  media.command("get").description("\u67E5\u770B\u5355\u4E2A\u5A92\u4F53").option("-s, --site <guidOrName>", "\u7AD9\u70B9 guid \u6216\u540D\u79F0").option("--url <url>", "\u76F4\u63A5\u6307\u5B9A\u7AD9\u70B9\u5730\u5740").requiredOption("--id <id>", "\u5A92\u4F53 ID").option("--json", "\u8F93\u51FA JSON", false).option("--verbose", "\u8F93\u51FA\u8BF7\u6C42\u8BE6\u60C5", false).action(async (opts) => {
+    await runMediaGet(opts);
+  });
+  media.command("upload").description("\u4E0A\u4F20\u672C\u5730\u6587\u4EF6\u5230\u5A92\u4F53\u5E93\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").requiredOption("--file <path>", "\u672C\u5730\u6587\u4EF6\u8DEF\u5F84").option("-t, --title <title>", "\u5A92\u4F53\u6807\u9898").option("--alt <text>", "\u56FE\u7247 alt").option("--caption <text>", "\u8BF4\u660E").option("--verbose", "\u8F93\u51FA\u8BF7\u6C42\u8BE6\u60C5", false).action(async (opts) => {
+    await runMediaUpload(opts);
+  });
+}
+
+// src/commands/terms.ts
+async function runTermsTaxonomies(opts) {
+  const target = await resolveTarget(opts);
+  let taxes;
+  try {
+    taxes = await apiFetch2(
+      wpV2(target.base, "/taxonomies?context=edit"),
+      target.config,
+      {},
+      opts.verbose
+    );
+  } catch (e) {
+    console.error(`
+\u274C \u83B7\u53D6\u5206\u7C7B\u6CD5\u5931\u8D25\uFF1A${e.message}
+`);
+    process.exit(1);
+    return;
+  }
+  const rows = Object.entries(taxes || {}).map(([slug, info]) => ({
+    slug,
+    rest_base: info.rest_base || slug,
+    name: info.name || slug
+  }));
+  if (opts.json) {
+    console.log(JSON.stringify({ site: target.site, taxonomies: rows }, null, 2));
+    return;
+  }
+  console.log(`
+${target.site.name} \u5206\u7C7B\u6CD5\uFF08${rows.length}\uFF09
+`);
+  printCliTable(rows, [
+    { key: "slug", header: "slug" },
+    { key: "rest_base", header: "--taxonomy" },
+    { key: "name", header: "\u540D\u79F0" }
+  ]);
+  console.log();
+}
+async function runTermsList(opts) {
+  const target = await resolveTarget(opts);
+  const restBase = await resolveTaxonomyRestBase(target, opts.taxonomy || "category", opts.verbose);
+  let items;
+  try {
+    items = await apiFetch2(
+      wpV2(target.base, `/${restBase}?per_page=100`),
+      target.config,
+      {},
+      opts.verbose
+    );
+  } catch (e) {
+    console.error(`
+\u274C \u83B7\u53D6 ${restBase} \u5931\u8D25\uFF1A${e.message}
+`);
+    process.exit(1);
+    return;
+  }
+  if (!Array.isArray(items)) {
+    console.error("\n\u274C \u7AD9\u70B9\u8FD4\u56DE\u7684\u672F\u8BED\u5217\u8868\u683C\u5F0F\u5F02\u5E38\n");
+    process.exit(1);
+  }
+  if (opts.json) {
+    console.log(JSON.stringify({ taxonomy: restBase, total: items.length, items }, null, 2));
+    return;
+  }
+  if (items.length === 0) {
+    console.log(`
+\u6CA1\u6709 ${restBase}\u3002
+`);
+    return;
+  }
+  console.log(`
+${target.site.name} ${restBase}\uFF08${items.length}\uFF09
+`);
+  printCliTable(
+    items.map((t) => ({
+      id: String(t.id),
+      name: t.name || "-",
+      slug: t.slug || "-",
+      count: String(t.count ?? 0)
+    })),
+    [
+      { key: "id", header: "id" },
+      { key: "name", header: "\u540D\u79F0" },
+      { key: "slug", header: "slug" },
+      { key: "count", header: "\u6570\u91CF" }
+    ]
+  );
+  console.log();
+}
+async function runTermsAdd(opts) {
+  const name = opts.name?.trim() ?? "";
+  if (!name) {
+    console.error("\n\u274C \u8BF7\u63D0\u4F9B --name\n");
+    process.exit(1);
+  }
+  const target = await resolveTarget(opts);
+  const restBase = await resolveTaxonomyRestBase(target, opts.taxonomy || "category", opts.verbose);
+  const body = { name };
+  if (opts.slug?.trim()) body.slug = opts.slug.trim();
+  const parent = Number(opts.parent);
+  if (Number.isFinite(parent) && parent > 0) body.parent = parent;
+  const item = await apiFetch2(
+    wpV2(target.base, `/${restBase}`),
+    target.config,
+    { method: "POST", body: JSON.stringify(body) },
+    opts.verbose
+  ).catch((e) => {
+    console.error(`
+\u274C \u65B0\u589E\u5931\u8D25\uFF1A${e.message}
+`);
+    process.exit(1);
+  });
+  console.log(`
+\u2705 \u5DF2\u65B0\u589E ${restBase} #${item.id} ${item.name || name}
+`);
+}
+async function runTermsUpdate(opts) {
+  const id = Number(opts.id);
+  if (!Number.isFinite(id) || id <= 0) {
+    console.error("\n\u274C \u8BF7\u63D0\u4F9B --id\n");
+    process.exit(1);
+  }
+  const body = {};
+  if (opts.name?.trim()) body.name = opts.name.trim();
+  if (opts.slug?.trim()) body.slug = opts.slug.trim();
+  if (Object.keys(body).length === 0) {
+    console.error("\n\u274C \u6CA1\u6709\u8981\u6539\u7684\u5B57\u6BB5\n");
+    process.exit(1);
+  }
+  const target = await resolveTarget(opts);
+  const restBase = await resolveTaxonomyRestBase(target, opts.taxonomy || "category", opts.verbose);
+  const item = await apiFetch2(
+    wpV2(target.base, `/${restBase}/${id}`),
+    target.config,
+    { method: "POST", body: JSON.stringify(body) },
+    opts.verbose
+  ).catch((e) => {
+    console.error(`
+\u274C \u66F4\u65B0\u5931\u8D25\uFF1A${e.message}
+`);
+    process.exit(1);
+  });
+  console.log(`
+\u2705 \u5DF2\u66F4\u65B0 ${restBase} #${item.id} ${item.name || ""}
+`);
+}
+async function runTermsDelete(opts) {
+  const id = Number(opts.id);
+  if (!Number.isFinite(id) || id <= 0) {
+    console.error("\n\u274C \u8BF7\u63D0\u4F9B --id\n");
+    process.exit(1);
+  }
+  const target = await resolveTarget(opts);
+  const restBase = await resolveTaxonomyRestBase(target, opts.taxonomy || "category", opts.verbose);
+  await apiFetch2(
+    wpV2(target.base, `/${restBase}/${id}?force=true`),
+    target.config,
+    { method: "DELETE" },
+    opts.verbose
+  ).catch((e) => {
+    console.error(`
+\u274C \u5220\u9664\u5931\u8D25\uFF1A${e.message}
+`);
+    process.exit(1);
+  });
+  console.log(`
+\u2705 \u5DF2\u5220\u9664 ${restBase} #${id}
+`);
+}
+function register10(program2) {
+  const terms = program2.command("terms").description("\u5206\u7C7B / \u6807\u7B7E / \u81EA\u5B9A\u4E49\u5206\u7C7B\u6CD5");
+  terms.command("taxonomies").description("\u5217\u51FA\u5206\u7C7B\u6CD5").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 runTermsTaxonomies(opts);
+  });
+  terms.command("list").description("\u5217\u51FA\u67D0\u5206\u7C7B\u6CD5\u4E0B\u7684\u672F\u8BED").option("-s, --site <guidOrName>", "\u7AD9\u70B9 guid \u6216\u540D\u79F0").option("--url <url>", "\u76F4\u63A5\u6307\u5B9A\u7AD9\u70B9\u5730\u5740").option("--taxonomy <slug>", "category / post_tag / \u5176\u5B83 rest_base", "category").option("--json", "\u8F93\u51FA JSON", false).option("--verbose", "\u8F93\u51FA\u8BF7\u6C42\u8BE6\u60C5", false).action(async (opts) => {
+    await runTermsList(opts);
+  });
+  terms.command("add").description("\u65B0\u589E\u672F\u8BED\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("--taxonomy <slug>", "\u9ED8\u8BA4 category", "category").requiredOption("-n, --name <name>", "\u540D\u79F0").option("--slug <slug>", "\u522B\u540D").option("--parent <id>", "\u7236\u7EA7 ID").option("--verbose", "\u8F93\u51FA\u8BF7\u6C42\u8BE6\u60C5", false).action(async (opts) => {
+    await runTermsAdd(opts);
+  });
+  terms.command("update").description("\u66F4\u65B0\u672F\u8BED\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("--taxonomy <slug>", "\u9ED8\u8BA4 category", "category").requiredOption("--id <id>", "\u672F\u8BED ID").option("-n, --name <name>", "\u540D\u79F0").option("--slug <slug>", "\u522B\u540D").option("--verbose", "\u8F93\u51FA\u8BF7\u6C42\u8BE6\u60C5", false).action(async (opts) => {
+    await runTermsUpdate(opts);
+  });
+  terms.command("delete").description("\u5220\u9664\u672F\u8BED\uFF08\u5199\u64CD\u4F5C\uFF0C\u4E0D\u53EF\u8FDB\u56DE\u6536\u7AD9\uFF09").option("-s, --site <guidOrName>", "\u7AD9\u70B9 guid \u6216\u540D\u79F0").option("--url <url>", "\u76F4\u63A5\u6307\u5B9A\u7AD9\u70B9\u5730\u5740").option("--taxonomy <slug>", "\u9ED8\u8BA4 category", "category").requiredOption("--id <id>", "\u672F\u8BED ID").option("--verbose", "\u8F93\u51FA\u8BF7\u6C42\u8BE6\u60C5", false).action(async (opts) => {
+    await runTermsDelete(opts);
+  });
+}
+
+// src/commands/search.ts
+async function runSearch(opts) {
+  const q = opts.q?.trim() ?? "";
+  if (!q) {
+    console.error("\n\u274C \u8BF7\u63D0\u4F9B --q\n");
+    process.exit(1);
+  }
+  const target = await resolveTarget(opts);
+  const params = new URLSearchParams({
+    search: q,
+    per_page: "20"
+  });
+  if (opts.type?.trim()) params.set("subtype", opts.type.trim());
+  let hits;
+  try {
+    hits = await apiFetch2(
+      wpV2(target.base, `/search?${params.toString()}`),
+      target.config,
+      {},
+      opts.verbose
+    );
+  } catch (e) {
+    console.error(`
+\u274C \u641C\u7D22\u5931\u8D25\uFF1A${e.message}
+`);
+    process.exit(1);
+    return;
+  }
+  if (!Array.isArray(hits)) {
+    console.error("\n\u274C \u7AD9\u70B9\u8FD4\u56DE\u7684\u641C\u7D22\u7ED3\u679C\u683C\u5F0F\u5F02\u5E38\n");
+    process.exit(1);
+  }
+  if (opts.json) {
+    console.log(JSON.stringify({ q, total: hits.length, hits }, null, 2));
+    return;
+  }
+  if (hits.length === 0) {
+    console.log(`
+\u6CA1\u6709\u5339\u914D\u300C${q}\u300D\u7684\u7ED3\u679C\u3002
+`);
+    return;
+  }
+  console.log(`
+${target.site.name} \u641C\u7D22\u300C${q}\u300D\uFF08${hits.length}\uFF09
+`);
+  printCliTable(
+    hits.map((h) => ({
+      id: h.id != null ? String(h.id) : "-",
+      title: h.title || "-",
+      type: [h.type, h.subtype].filter(Boolean).join("/") || "-",
+      url: h.url || "-"
+    })),
+    [
+      { key: "id", header: "id" },
+      { key: "title", header: "\u6807\u9898" },
+      { key: "type", header: "\u7C7B\u578B" },
+      { key: "url", header: "\u94FE\u63A5" }
+    ]
+  );
+  console.log();
+}
+function register11(program2) {
+  program2.command("search").description("\u5168\u7AD9\u641C\u7D22\uFF08\u9875\u9762/\u6587\u7AE0/\u5A92\u4F53\u7B49\uFF09").option("-s, --site <guidOrName>", "\u7AD9\u70B9 guid \u6216\u540D\u79F0").option("--url <url>", "\u76F4\u63A5\u6307\u5B9A\u7AD9\u70B9\u5730\u5740").requiredOption("-q, --q <keyword>", "\u5173\u952E\u8BCD").option("--type <subtype>", "\u9650\u5B9A rest \u5B50\u7C7B\u578B\uFF0C\u5982 page / post").option("--json", "\u8F93\u51FA JSON", false).option("--verbose", "\u8F93\u51FA\u8BF7\u6C42\u8BE6\u60C5", false).action(async (opts) => {
+    await runSearch(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\u7AD9\u70B9\u3001\u9875\u9762\u3001\u6587\u7AE0\u3001\u5A92\u4F53\u3001\u5206\u7C7B\u3001\u63D2\u4EF6").version(getCurrentVersion2());
 var REGISTRARS = [
   register,
   register2,
@@ -4181,6 +5432,10 @@ var REGISTRARS = [
   register4,
   register5,
   register6,
+  register8,
+  register9,
+  register10,
+  register11,
   register7
 ];
 for (const reg of REGISTRARS) reg(program);