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

package/README.md

@@ -28,9 +28,12 @@ siluzan-website plugins install --site <guid> --zip ./plugin.zip
 siluzan-website plugins update --site <guid> --plugin <plugin>
 siluzan-website plugins uninstall --site <guid> --plugin <plugin>
 siluzan-website plugins helper-status --site <guid>
+siluzan-website zasp settings --site <guid>
+siluzan-website zasp set --site <guid> --set related_enabled=1
+siluzan-website zasp sync --site <guid>
 ```
 
-页面写入走站点上已有的 `zionbuilder/v1` visual-edit 接口（HTML → Builder）。插件：目录用 `--slug`，外部用 `--zip`；卸载用 `uninstall --plugin`（helper / oauth2 不允许）；helper 太旧时会先从镜像本地 zip 升级。
+页面写入走站点上已有的 `zionbuilder/v1` visual-edit 接口（HTML → Builder）。插件：目录用 `--slug`，外部用 `--zip`；卸载用 `uninstall --plugin`（helper / oauth2 不允许）；helper 太旧时会先从镜像本地 zip 升级。`zasp-smart-recommender` 装完后用 `zasp settings / set / sync` 配相关推荐和 AI/向量，不要手写 curl。
 
 ## 开发
 

package/dist/index.js

@@ -4225,7 +4225,7 @@ function register6(program2) {
 }
 
 // src/commands/plugins.ts
-import { readFileSync as readFileSync6, existsSync as existsSync3 } from "fs";
+import { readFileSync as readFileSync7, existsSync as existsSync3 } from "fs";
 import { basename as basename2, resolve as resolve2 } from "path";
 
 // src/utils/wp-plugin-catalog.ts
@@ -4385,6 +4385,381 @@ function downloadOfficialZip(url) {
   });
 }
 
+// src/commands/zasp.ts
+import { readFileSync as readFileSync6 } from "fs";
+var SECRET_KEY = /api_key|password|token|secret|private_key/i;
+function zaspUrl(base, path6) {
+  const suffix = path6.startsWith("/") ? path6 : `/${path6}`;
+  return `${base}/wp-json/zasp-b2b/v2${suffix}`;
+}
+function explainZaspError(err) {
+  const msg = err instanceof Error ? err.message : String(err);
+  if (/404|rest_no_route|not found/i.test(msg)) {
+    return `${msg}
+   \u7AD9\u70B9\u53EF\u80FD\u6CA1\u88C5 zasp-smart-recommender\uFF0C\u6216\u7248\u672C\u592A\u65E7\u3001\u6CA1\u6709\u7BA1\u7406 REST\u3002
+   \u5148 \`plugins list\`\uFF0C\u518D \`plugins catalog\` / \`install --slug zasp-smart-recommender\`\uFF0C
+   \u6216 \`update --plugin zasp-smart-recommender/zasp-smart-recommender\``;
+  }
+  return msg;
+}
+function redactSecrets(value) {
+  if (Array.isArray(value)) return value.map(redactSecrets);
+  if (value && typeof value === "object") {
+    const out = {};
+    for (const [key, nested] of Object.entries(value)) {
+      if (SECRET_KEY.test(key) && typeof nested === "string" && nested) {
+        out[key] = "***";
+      } else {
+        out[key] = redactSecrets(nested);
+      }
+    }
+    return out;
+  }
+  return value;
+}
+function printJson(data) {
+  console.log(JSON.stringify(redactSecrets(data), null, 2));
+}
+function collectPair(value, acc) {
+  acc.push(value);
+  return acc;
+}
+function coerceSetValue(raw) {
+  if (raw === "true") return true;
+  if (raw === "false") return false;
+  if (raw === "null") return null;
+  if (/^-?\d+$/.test(raw)) return Number(raw);
+  if (/^-?\d+\.\d+$/.test(raw)) return Number(raw);
+  return raw;
+}
+function parseSetPairs(pairs) {
+  const body = {};
+  for (const raw of pairs ?? []) {
+    const eq = raw.indexOf("=");
+    if (eq <= 0) {
+      throw new Error(`--set \u683C\u5F0F\u5E94\u4E3A key=value\uFF0C\u6536\u5230\uFF1A${raw}`);
+    }
+    const key = raw.slice(0, eq).trim();
+    if (!key) {
+      throw new Error(`--set \u7F3A\u5C11\u5B57\u6BB5\u540D\uFF1A${raw}`);
+    }
+    body[key] = coerceSetValue(raw.slice(eq + 1));
+  }
+  return body;
+}
+function parseBodyJson(inline, filePath) {
+  const raw = filePath ? readFileSync6(filePath, "utf8") : inline;
+  if (!raw?.trim()) return {};
+  const parsed = JSON.parse(raw);
+  if (!parsed || typeof parsed !== "object" || Array.isArray(parsed)) {
+    throw new Error("--body / --body-file \u5FC5\u987B\u662F JSON \u5BF9\u8C61");
+  }
+  return parsed;
+}
+async function zaspFetch(opts, path6, init = {}) {
+  const target = await resolveTarget(opts);
+  try {
+    const data = await apiFetch2(zaspUrl(target.base, path6), target.config, init, opts.verbose);
+    return { data, siteName: target.site.name, base: target.base };
+  } catch (e) {
+    throw new Error(explainZaspError(e));
+  }
+}
+async function runZaspSettings(opts) {
+  let pack;
+  try {
+    pack = await zaspFetch(opts, "/settings");
+  } catch (e) {
+    console.error(`
+\u274C \u8BFB\u53D6\u914D\u7F6E\u5931\u8D25\uFF1A${e.message}
+`);
+    process.exit(1);
+    return;
+  }
+  if (opts.json) {
+    printJson({ site: pack.siteName, url: pack.base, ...pack.data });
+    return;
+  }
+  const settings = pack.data.settings ?? {};
+  const runtime = pack.data.runtime ?? {};
+  console.log(`
+${pack.siteName}  AI \u63A8\u8350\u914D\u7F6E  (${pack.base})
+`);
+  printCliTable(
+    [
+      { k: "ai_provider", v: String(settings.ai_provider ?? "-") },
+      { k: "vector_provider", v: String(settings.vector_provider ?? "-") },
+      { k: "related_enabled", v: String(settings.related_enabled ?? "-") },
+      { k: "related_limit", v: String(settings.related_limit ?? "-") },
+      { k: "auto_sync", v: String(settings.auto_sync ?? "-") },
+      { k: "has_ai_api_key", v: String(settings.has_ai_api_key ?? "-") },
+      { k: "has_vector_api_key", v: String(settings.has_vector_api_key ?? "-") },
+      { k: "has_vector_embed_api_key", v: String(settings.has_vector_embed_api_key ?? "-") },
+      { k: "runtime.ai_configured", v: String(runtime.ai_configured ?? "-") },
+      { k: "runtime.vector_configured", v: String(runtime.vector_configured ?? "-") },
+      { k: "runtime.vector_site_id", v: String(runtime.vector_site_id ?? "-") },
+      { k: "runtime.retrieval_mode", v: String(runtime.retrieval_mode ?? "-") }
+    ],
+    [
+      { key: "k", header: "\u5B57\u6BB5" },
+      { key: "v", header: "\u503C" }
+    ]
+  );
+  const sync = runtime.sync_state;
+  if (sync?.error) {
+    console.log(`
+\u4E0A\u6B21\u540C\u6B65\u5931\u8D25\uFF1A${String(sync.error)}`);
+  }
+  console.log("\n\u5B8C\u6574\u5B57\u6BB5\u7528 --json\uFF1B\u5B57\u6BB5\u5B57\u5178\u7528 `zasp schema`\u3002\n");
+}
+async function runZaspSchema(opts) {
+  let pack;
+  try {
+    pack = await zaspFetch(opts, "/settings/schema");
+  } catch (e) {
+    console.error(`
+\u274C \u8BFB\u53D6\u5B57\u6BB5\u5B57\u5178\u5931\u8D25\uFF1A${e.message}
+`);
+    process.exit(1);
+    return;
+  }
+  if (opts.json) {
+    printJson(pack.data);
+    return;
+  }
+  console.log(`
+${pack.siteName}  \u5B57\u6BB5\u5B57\u5178
+`);
+  printJson(pack.data);
+  console.log();
+}
+async function runZaspSet(opts) {
+  let patch;
+  try {
+    patch = {
+      ...parseBodyJson(opts.body, opts.bodyFile),
+      ...parseSetPairs(opts.set)
+    };
+  } catch (e) {
+    console.error(`
+\u274C ${e.message}
+`);
+    process.exit(1);
+    return;
+  }
+  if (opts.clearAiKey) patch.clear_ai_key = true;
+  if (opts.clearVectorKey) patch.clear_vector_key = true;
+  if (opts.clearVectorEmbedKey) patch.clear_vector_embed_key = true;
+  if (Object.keys(patch).length === 0) {
+    console.error(`
+\u274C \u6CA1\u6709\u8981\u6539\u7684\u5B57\u6BB5\u3002\u7528 --set key=value\uFF0C\u6216 --body '{"related_enabled":1}'
+`);
+    process.exit(1);
+  }
+  let pack;
+  try {
+    pack = await zaspFetch(opts, "/settings", {
+      method: "PATCH",
+      body: JSON.stringify(patch)
+    });
+  } catch (e) {
+    console.error(`
+\u274C \u66F4\u65B0\u914D\u7F6E\u5931\u8D25\uFF1A${e.message}
+`);
+    process.exit(1);
+    return;
+  }
+  const changed = Object.keys(patch).filter((k) => !SECRET_KEY.test(k) && !k.startsWith("clear_"));
+  console.log(`
+\u2705 \u5DF2\u66F4\u65B0 ${pack.siteName} \u7684 AI \u63A8\u8350\u914D\u7F6E`);
+  if (changed.length) console.log(`   \u5B57\u6BB5\uFF1A${changed.join(", ")}`);
+  if (opts.clearAiKey || opts.clearVectorKey || opts.clearVectorEmbedKey) {
+    console.log("   \u5DF2\u6309\u5F00\u5173\u6E05\u7A7A\u5BF9\u5E94\u5BC6\u94A5\uFF08\u660E\u6587\u4E0D\u4F1A\u56DE\u663E\uFF09");
+  }
+  console.log(`   \u7AD9\u70B9\uFF1A${pack.base}
+`);
+  if (opts.json) {
+    printJson(pack.data);
+    return;
+  }
+  const settings = pack.data.settings ?? {};
+  const runtime = pack.data.runtime ?? {};
+  console.log(
+    `   ai_provider=${String(settings.ai_provider ?? "-")}  vector_provider=${String(settings.vector_provider ?? "-")}  ai_configured=${String(runtime.ai_configured ?? "-")}  vector_configured=${String(runtime.vector_configured ?? "-")}`
+  );
+  console.log("   \u6539\u4E86\u5411\u91CF\u540E\u7AEF\u7684\u8BDD\uFF0C\u63A5\u7740\u8DD1 `zasp sync`\uFF1B\u53EA\u6539\u76F8\u5173\u63A8\u8350 / custom AI \u4E00\u822C\u4E0D\u7528\u3002\n");
+}
+async function runZaspSync(opts) {
+  let pack;
+  try {
+    pack = await zaspFetch(opts, "/sync", { method: "POST" });
+  } catch (e) {
+    console.error(`
+\u274C \u540C\u6B65\u5931\u8D25\uFF1A${e.message}
+`);
+    process.exit(1);
+    return;
+  }
+  if (opts.json) {
+    printJson(pack.data);
+    return;
+  }
+  if (pack.data.ok) {
+    console.log(`
+\u2705 ${pack.siteName} \u5168\u91CF\u540C\u6B65\u5B8C\u6210\uFF0C\u5199\u5165 ${pack.data.count ?? 0} \u6761
+`);
+    return;
+  }
+  console.error(`
+\u274C \u540C\u6B65\u672A\u5B8C\u6210\uFF1A${pack.data.error || "\u672A\u77E5\u9519\u8BEF"}`);
+  console.error("   \u5148\u4FEE Collection / key / \u7EF4\u5EA6\uFF0C\u518D `zasp set`\uFF0C\u518D `zasp sync`\n");
+  process.exit(1);
+}
+async function runZaspStatus(opts) {
+  let pack;
+  try {
+    pack = await zaspFetch(opts, "/status");
+  } catch (e) {
+    console.error(`
+\u274C \u8BFB\u53D6\u72B6\u6001\u5931\u8D25\uFF1A${e.message}
+`);
+    process.exit(1);
+    return;
+  }
+  if (opts.json) {
+    printJson({ site: pack.siteName, url: pack.base, ...pack.data });
+    return;
+  }
+  const counts = pack.data.source_counts ?? {};
+  console.log(`
+${pack.siteName}  AI \u63A8\u8350\u72B6\u6001  (${pack.base})
+`);
+  printCliTable(
+    [
+      { k: "ready", v: String(pack.data.ready ?? pack.data.status ?? "-") },
+      { k: "ai_configured", v: String(pack.data.ai_configured ?? "-") },
+      { k: "vector_configured", v: String(pack.data.vector_configured ?? "-") },
+      { k: "vector_site_id", v: String(pack.data.vector_site_id ?? "-") },
+      { k: "mode", v: String(pack.data.mode ?? "-") },
+      { k: "version", v: String(pack.data.version ?? "-") },
+      { k: "documents", v: String(counts.documents ?? "-") },
+      { k: "products", v: String(counts.products ?? "-") }
+    ],
+    [
+      { key: "k", header: "\u5B57\u6BB5" },
+      { key: "v", header: "\u503C" }
+    ]
+  );
+  console.log();
+}
+async function runZaspDiagnostics(opts) {
+  let pack;
+  try {
+    pack = await zaspFetch(opts, "/diagnostics");
+  } catch (e) {
+    console.error(`
+\u274C \u8BCA\u65AD\u5931\u8D25\uFF1A${e.message}
+`);
+    process.exit(1);
+    return;
+  }
+  console.log(`
+${pack.siteName}  \u8BCA\u65AD
+`);
+  printJson(pack.data);
+  console.log();
+}
+async function runZaspRecommend(opts) {
+  const placement = opts.placement?.trim() || "assistant";
+  const limit = Number(opts.limit ?? 5);
+  const pageId = Number(opts.pageId ?? 0);
+  if (!Number.isFinite(limit) || limit < 1) {
+    console.error("\n\u274C --limit \u5FC5\u987B\u662F\u6B63\u6574\u6570\n");
+    process.exit(1);
+  }
+  if (placement === "related_products" && (!Number.isFinite(pageId) || pageId <= 0)) {
+    console.error("\n\u274C \u9875\u9762\u76F8\u5173\u63A8\u8350\u5FC5\u987B\u63D0\u4F9B\u6709\u6548\u5546\u54C1 --page-id\n");
+    process.exit(1);
+  }
+  const body = {
+    query: opts.query?.trim() ?? "",
+    placement,
+    limit,
+    page_id: Number.isFinite(pageId) ? pageId : 0,
+    constraints: {},
+    session: { seen: [], interest: {} }
+  };
+  let pack;
+  try {
+    pack = await zaspFetch(opts, "/recommend", {
+      method: "POST",
+      body: JSON.stringify(body)
+    });
+  } catch (e) {
+    console.error(`
+\u274C \u8BD5\u63A8\u5931\u8D25\uFF1A${e.message}
+`);
+    process.exit(1);
+    return;
+  }
+  if (opts.json) {
+    printJson(pack.data);
+    return;
+  }
+  const items = pack.data.items ?? [];
+  console.log(`
+${pack.siteName}  \u8BD5\u63A8  status=${pack.data.status ?? "-"}  mode=${pack.data.mode ?? "-"}`);
+  if (items.length === 0) {
+    console.log("\u6CA1\u6709\u5339\u914D\u7ED3\u679C\u3002\n");
+    return;
+  }
+  printCliTable(
+    items.map((item) => ({
+      id: item.id != null ? String(item.id) : "-",
+      title: item.title || "-",
+      type: item.type || "-",
+      score: item.score != null ? String(item.score) : "-",
+      url: item.url || "-"
+    })),
+    [
+      { key: "id", header: "id" },
+      { key: "title", header: "\u6807\u9898" },
+      { key: "type", header: "\u7C7B\u578B" },
+      { key: "score", header: "\u5206" },
+      { key: "url", header: "\u94FE\u63A5" }
+    ]
+  );
+  console.log();
+}
+function hintZaspIfNeeded(pluginOrSlug) {
+  if (!pluginOrSlug.toLowerCase().includes("zasp-smart-recommender")) return;
+  console.log("   \u63A5\u4E0B\u6765\u7528 `siluzan-website zasp settings / set / sync` \u914D\u7F6E AI \u63A8\u8350\uFF08\u89C1 references/zasp-recommender.md\uFF09\n");
+}
+function register7(program2) {
+  const zasp = program2.command("zasp").description("zasp-smart-recommender\uFF08AI \u63A8\u8350\uFF09\u914D\u7F6E\u4E0E\u9A8C\u6536\uFF0C\u8D70\u7AD9\u70B9 /wp-json/zasp-b2b/v2");
+  zasp.command("settings").description("\u67E5\u770B\u5F53\u524D AI \u63A8\u8350\u914D\u7F6E\uFF08GET /settings\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\u5B8C\u6574 JSON", false).option("--verbose", "\u8F93\u51FA\u8BF7\u6C42\u8BE6\u60C5", false).action(async (opts) => {
+    await runZaspSettings(opts);
+  });
+  zasp.command("schema").description("\u67E5\u770B\u53EF\u5199\u5B57\u6BB5\u5B57\u5178\uFF08GET /settings/schema\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 runZaspSchema(opts);
+  });
+  zasp.command("set").description("\u53EA\u6539\u8981\u6539\u7684\u5B57\u6BB5\uFF08PATCH /settings\uFF09").option("-s, --site <guidOrName>", "\u7AD9\u70B9 guid \u6216\u540D\u79F0").option("--url <url>", "\u76F4\u63A5\u6307\u5B9A\u7AD9\u70B9\u5730\u5740").option("--body <json>", "PATCH JSON \u5BF9\u8C61\uFF0C\u53EA\u542B\u8981\u6539\u7684\u5B57\u6BB5").option("--body-file <file>", "\u4ECE\u6587\u4EF6\u8BFB PATCH JSON").option("--set <key=value>", "\u5355\u4E2A\u5B57\u6BB5\uFF0C\u53EF\u91CD\u590D", collectPair, []).option("--clear-ai-key", "\u6E05\u7A7A\u5DF2\u4FDD\u5B58\u7684 AI Key", false).option("--clear-vector-key", "\u6E05\u7A7A\u5DF2\u4FDD\u5B58\u7684\u5411\u91CF\u5E93 Key", false).option("--clear-vector-embed-key", "\u6E05\u7A7A\u5DF2\u4FDD\u5B58\u7684 Embedding Key", false).option("--json", "\u8F93\u51FA\u66F4\u65B0\u540E\u7684\u5B8C\u6574 JSON", false).option("--verbose", "\u8F93\u51FA\u8BF7\u6C42\u8BE6\u60C5", false).action(async (opts) => {
+    await runZaspSet(opts);
+  });
+  zasp.command("sync").description("\u5168\u91CF\u540C\u6B65\u5546\u54C1\u5230\u5411\u91CF\u5E93\uFF08POST /sync\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 runZaspSync(opts);
+  });
+  zasp.command("status").description("\u516C\u5F00\u9A8C\u6536\uFF1Aready / \u662F\u5426\u914D\u597D\uFF08GET /status\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 runZaspStatus(opts);
+  });
+  zasp.command("diagnostics").description("\u7BA1\u7406\u5458\u6DF1\u67E5\uFF08GET /diagnostics\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 runZaspDiagnostics(opts);
+  });
+  zasp.command("recommend").description("\u524D\u53F0\u8BD5\u63A8\u4E00\u6761\uFF08POST /recommend\uFF09").option("-s, --site <guidOrName>", "\u7AD9\u70B9 guid \u6216\u540D\u79F0").option("--url <url>", "\u76F4\u63A5\u6307\u5B9A\u7AD9\u70B9\u5730\u5740").option("--query <q>", "\u68C0\u7D22\u8BCD\uFF1B\u76F8\u5173\u63A8\u8350\u53EF\u7559\u7A7A").option("--placement <p>", "assistant \u6216 related_products", "assistant").option("--limit <n>", "\u6761\u6570", "5").option("--page-id <id>", "related_products \u65F6\u7684\u5546\u54C1\u9875 ID", "0").option("--json", "\u8F93\u51FA JSON", false).option("--verbose", "\u8F93\u51FA\u8BF7\u6C42\u8BE6\u60C5", false).action(async (opts) => {
+    await runZaspRecommend(opts);
+  });
+}
+
 // src/commands/plugins.ts
 var MAX_ZIP_BYTES = 40 * 1024 * 1024;
 var PROTECTED_PLUGIN_PREFIXES = ["siluzan-helper-plugin", "wp-oauth2"];
@@ -4425,7 +4800,7 @@ function readZipPayload(zipPath) {
 `);
     process.exit(1);
   }
-  const buf = readFileSync6(abs);
+  const buf = readFileSync7(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);
@@ -4672,6 +5047,7 @@ async function runPluginsInstall(opts) {
     return;
   }
   printActionResult(result, site, base, "\u63D2\u4EF6\u5DF2\u5B89\u88C5\u5E76\u542F\u7528");
+  hintZaspIfNeeded(`${result.plugin || ""} ${slug} ${zipPath}`);
   await runPluginsList({
     site: site.guid || opts.site,
     url: site.url,
@@ -4725,6 +5101,7 @@ async function runPluginsUpdate(opts) {
     return;
   }
   printActionResult(result, site, base, "\u63D2\u4EF6\u5DF2\u5347\u7EA7");
+  hintZaspIfNeeded(`${result.plugin || ""} ${plugin}`);
   await runPluginsList({
     site: site.guid || opts.site,
     url: site.url,
@@ -4870,7 +5247,7 @@ async function runPluginsUninstall(opts) {
     exitOnError: false
   });
 }
-function register7(program2) {
+function register8(program2) {
   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);
@@ -5157,7 +5534,7 @@ async function runContentTrash(opts) {
 \u2705 \u5DF2\u79FB\u5165\u56DE\u6536\u7AD9 ${restBase} #${id}\uFF08status=${item.status || "trash"}\uFF09
 `);
 }
-function register8(program2) {
+function register9(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);
@@ -5180,7 +5557,7 @@ function register8(program2) {
 }
 
 // src/commands/media.ts
-import { existsSync as existsSync4, readFileSync as readFileSync8 } from "fs";
+import { existsSync as existsSync4, readFileSync as readFileSync9 } from "fs";
 import { basename as basename3, extname, resolve as resolve3 } from "path";
 var MIME_BY_EXT = {
   ".jpg": "image/jpeg",
@@ -5305,7 +5682,7 @@ async function runMediaUpload(opts) {
 `);
     process.exit(1);
   }
-  const data = readFileSync8(abs);
+  const data = readFileSync9(abs);
   if (data.length > MAX_MEDIA_BYTES) {
     console.error("\n\u274C \u6587\u4EF6\u8D85\u8FC7 20MB\n");
     process.exit(1);
@@ -5347,7 +5724,7 @@ async function runMediaUpload(opts) {
   console.log(`   \u6807\u9898 : ${wpRenderedText(item.title) || filename}`);
   console.log();
 }
-function register9(program2) {
+function register10(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);
@@ -5528,7 +5905,7 @@ async function runTermsDelete(opts) {
 \u2705 \u5DF2\u5220\u9664 ${restBase} #${id}
 `);
 }
-function register10(program2) {
+function register11(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);
@@ -5608,7 +5985,7 @@ ${target.site.name} \u641C\u7D22\u300C${q}\u300D\uFF08${hits.length}\uFF09
   );
   console.log();
 }
-function register11(program2) {
+function register12(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);
   });
@@ -5617,7 +5994,7 @@ function register11(program2) {
 // src/index.ts
 installProcessHandlers();
 var program = new Command();
-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());
+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\u3001AI \u63A8\u8350").version(getCurrentVersion2());
 var REGISTRARS = [
   register,
   register2,
@@ -5625,10 +6002,11 @@ var REGISTRARS = [
   register4,
   register5,
   register6,
-  register8,
   register9,
   register10,
   register11,
+  register12,
+  register8,
   register7
 ];
 for (const reg of REGISTRARS) reg(program);

package/dist/skill/SKILL.md

@@ -3,6 +3,7 @@ name: siluzan-website
 description: >-
   管理丝路赞 WordPress 站点（wp-k8s 托管）：列出站点、页面/文章/产品、媒体、分类、插件。
   当用户提到 WordPress、建站后台、新增页面、发文章、上传图片、改官网、装插件、
+  AI 推荐、相关推荐、zasp、zasp-smart-recommender、B2B Site AI、
   站点 guid、siluzan-website、zionbuilder、visual-edit 时使用。不是 LPS / AI Sites，也不是 SEO JSON 生成。
 ---
 
@@ -10,7 +11,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 生成。用户要的是「我的官网加一页 / 发一篇资讯 / 上传图片 / 装插件 / 配 AI 推荐」才用本 Skill。
 
 ## 一键安装
 
@@ -46,6 +47,7 @@ Windows 注意：部分 Agent 通过 PowerShell / cmd 代执行时可能失败
 | `siluzan-website search` | 全站搜索 | [references/search.md](references/search.md) |
 | `siluzan-website plugins list/catalog/install/update/uninstall` | 已装列表 / 目录 / 安装 / 升级 / 卸载 | [references/plugins.md](references/plugins.md) |
 | `siluzan-website plugins helper-status/update-helper` | 查看 / 用镜像 zip 升级 helper | [references/plugins.md](references/plugins.md) |
+| `siluzan-website zasp settings/set/sync/status/recommend` | AI 推荐插件配置与验收 | [references/zasp-recommender.md](references/zasp-recommender.md) |
 
 ---
 
@@ -66,14 +68,15 @@ Windows 注意：部分 Agent 通过 PowerShell / cmd 代执行时可能失败
 | 安装外部插件 | `references/plugins.md` | 确认 → `install --zip` |
 | 升级已装插件 | `references/plugins.md` | `list` 拿 plugin → 确认 → `update --plugin`；外部再加 `--zip` |
 | 卸载插件 | `references/plugins.md` | `list` 拿 plugin → 确认 → `uninstall --plugin` |
+| 配置 / 验收 AI 推荐（zasp） | `references/zasp-recommender.md` | 先确认已装 `zasp-smart-recommender` → `zasp settings` → 确认后 `set`；改向量再 `sync` |
 
 ---
 
 ## AI 行为规范
 
 1. **计划 → 确认 → 执行 → 验证**
-   - 写操作（`pages add/update/meta/trash`、`content add/update/trash`、`media upload`、`terms add/update/delete`、`plugins install/update/uninstall/update-helper`）会立刻生效，执行前必须复述目标站点与内容，获得用户确认。
-   - 只读（`sites list`、`pages list/get`、`content types/list/get`、`media list/get`、`terms taxonomies/list`、`search`、`plugins list/catalog/helper-status`、`config show`）可直接跑。
+   - 写操作（`pages add/update/meta/trash`、`content add/update/trash`、`media upload`、`terms add/update/delete`、`plugins install/update/uninstall/update-helper`、`zasp set/sync`）会立刻生效，执行前必须复述目标站点与内容，获得用户确认。
+   - 只读（`sites list`、`pages list/get`、`content types/list/get`、`media list/get`、`terms taxonomies/list`、`search`、`plugins list/catalog/helper-status`、`zasp settings/schema/status/diagnostics`、`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`。
@@ -86,5 +89,5 @@ Windows 注意：部分 Agent 通过 PowerShell / cmd 代执行时可能失败
 - 创建 / 删除 / 重启站点（SiteMan）
 - 绑定域名 / CDN / SSL
 - 单独停用插件但留在磁盘（停用只作为卸载的一步）
-- 推荐插件的业务配置（选择器、Cron、模型）
+- 用 API 写入 `ZASP_PROXY_KEY`（K8s 环境变量）
 - LPS / AI Sites / SEO JSON 灌入

package/dist/skill/_meta.json

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

package/dist/skill/references/plugins.md

@@ -66,6 +66,8 @@ siluzan-website plugins uninstall --site <guid> --plugin dummy-plugin/dummy-plug
 
 `--plugin` 与 `plugins list` 的 plugin 列一致；只写目录名且能唯一对上也可以。
 
+装完或升完 `zasp-smart-recommender` 之后，用 [zasp-recommender.md](zasp-recommender.md) 配相关推荐、内置/自定义 AI、向量库和同步。不要手写 curl，不要向用户要 Application Password。
+
 ## helper
 
 ```bash
@@ -84,6 +86,7 @@ siluzan-website plugins update-helper --site <guid>
 5. 用户要卸载 → `list` 拿到 `plugin` → 确认不是 helper / oauth2 → `uninstall --plugin`
 6. catalog / install / update 报路由 404 → 命令会自动 `update-helper` 再重试；oauth2 本身 404 / 401 → 告诉用户要先 SiteMan 镜像升级
 7. 装完看复核列表是否 `active`；卸完确认列表里已经没有该项
+8. 装的是 `zasp-smart-recommender` → 转 [zasp-recommender.md](zasp-recommender.md) 用 `zasp settings / set / sync` 配业务，不要停在「已安装」
 
 匹配到多个目录项时让用户选，不要猜。
 

package/dist/skill/references/zasp-recommender.md

@@ -0,0 +1,256 @@
+# zasp-smart-recommender（AI 推荐）
+
+装完官方目录里的 `zasp-smart-recommender` 之后，用本组命令改插件设置。不要打开后台表单，不要改 `options.php`，不要手写 curl。
+
+鉴权与其它 website 命令一样：**API Key（x-api-key）**。不要向用户要 WordPress Application Password。
+
+底层是站点 `GET/PATCH /wp-json/zasp-b2b/v2/settings`、`POST /sync`、`GET /status`。`ZASP_PROXY_KEY` 是 K8s 环境变量，**本命令写不了**（仅 `ai_provider` / `vector_provider` 为 builtin 时需要）。
+
+**两个开关互相独立**：
+
+| 开关 | 取值 | 含义 |
+|------|------|------|
+| `ai_provider` | `builtin` | 对话走丝路赞平台代理 |
+| | `custom` | 对话走自己的 OpenAI 兼容接口（场景 3） |
+| `vector_provider` | `builtin` | 向量走平台代理 |
+| | `dashvector` | 自建阿里云 DashVector（场景 4） |
+| | `generic` | 自建 HTTP 向量网关（场景 5） |
+| | `none` | 不用向量库 |
+
+改设置只传要改的字段，其它保持原值。密钥字段 `ai_api_key` / `vector_api_key` / `vector_embed_api_key`：GET 只回 `has_*` 布尔；`--set` 传新字符串=覆盖；不传=保留；`--clear-*-key`=清空。不要把密钥打印进聊天记录。
+
+路由 404：插件没装或版本太旧。先 `plugins list`，再 `plugins catalog` / `install --slug zasp-smart-recommender` 或 `update --plugin zasp-smart-recommender/zasp-smart-recommender`。
+
+关系审核 `POST /relations/{id}/review` 目前可能不可用，用户未明确要求时跳过。不要编造不存在的字段。
+
+---
+
+## 命令
+
+```bash
+siluzan-website zasp settings --site <guid>
+siluzan-website zasp settings --site <guid> --json
+siluzan-website zasp schema --site <guid>
+siluzan-website zasp set --site <guid> --set related_enabled=1 --set related_limit=6
+siluzan-website zasp set --site <guid> --body "{\"ai_provider\":\"builtin\",\"vector_provider\":\"builtin\"}"
+siluzan-website zasp set --site <guid> --body-file ./patch.json
+siluzan-website zasp set --site <guid> --clear-ai-key
+siluzan-website zasp sync --site <guid>
+siluzan-website zasp status --site <guid>
+siluzan-website zasp diagnostics --site <guid>
+siluzan-website zasp recommend --site <guid> --query "stainless steel valve"
+```
+
+`set` 是写操作，执行前必须复述站点与将要改的字段，获得用户确认。`settings` / `schema` / `status` 只读，可直接跑。
+
+---
+
+## 场景 0：先看当前配置（每次改之前建议先做）
+
+```bash
+siluzan-website zasp settings --site <guid> --json
+siluzan-website zasp schema --site <guid>
+```
+
+看 `settings.*`（已保存）和 `runtime.*`（是否真能连上、上次同步）。`runtime.sync_state.error` 非空 = 上次同步失败，先修配置再 sync。
+
+---
+
+## 场景 1：打开页面「相关推荐」，显示 6 条
+
+商品详情页 Smart Related Products，最多 6 个（上限 10）。对话框推荐上限仍是 50，不受 `related_limit` 影响。
+
+```bash
+siluzan-website zasp set --site <guid> --set related_enabled=1 --set related_limit=6 --set related_selector=section.related.products
+```
+
+| 字段 | 含义 |
+|------|------|
+| `related_enabled` | `1` 开 / `0` 关 |
+| `related_limit` | 页面条数，1–10 |
+| `related_selector` | 前端注入节点；Woo 默认 `section.related.products` |
+
+关掉：`--set related_enabled=0`。只改相关推荐一般**不用** sync。
+
+---
+
+## 场景 2：用丝路赞内置代理（最常见上线配置）
+
+AI + 向量都走平台代理，站点侧不存 DashVector/百炼密钥。前提：站点环境已注入 `ZASP_PROXY_KEY`。
+
+```bash
+siluzan-website zasp set --site <guid> --body "{\"ai_provider\":\"builtin\",\"vector_provider\":\"builtin\",\"platform_proxy_base\":\"\",\"auto_sync\":1}"
+```
+
+| 字段 | 含义 |
+|------|------|
+| `ai_provider: builtin` | 对话走平台代理 |
+| `vector_provider: builtin` | 向量 upsert/search 走平台代理 |
+| `platform_proxy_base: ""` | 空=按站点域名自动选 CI/Prod 代理；只有要强制指定时才填 URL |
+| `auto_sync: 1` | 商品发布/更新/下架时自动推向量 |
+
+强制 CI 代理：`--set platform_proxy_base=https://chatgpt-ci.mysiluzan.com`。然后全量同步（场景 8）。
+
+---
+
+## 场景 3：自定义 AI（用自己的大模型，不走平台代理）
+
+对应后台「AI → 自定义」。`ai_provider` 必须 `"custom"`，否则填了 endpoint 也不会走。接口需兼容 `POST …/v1/chat/completions`。只影响对话 / 查询规划 / AI 抽取；向量仍由 `vector_provider` 单独决定。
+
+```bash
+siluzan-website zasp set --site <guid> --body "{\"ai_provider\":\"custom\",\"ai_endpoint\":\"https://dashscope.aliyuncs.com/compatible-mode/v1/chat/completions\",\"ai_model\":\"qwen-plus\",\"ai_api_key\":\"sk-你的模型Key\",\"ai_timeout\":30}"
+```
+
+| 字段 | 必填 | 含义 |
+|------|------|------|
+| `ai_provider` | 是 | 固定 `custom` |
+| `ai_endpoint` | 是 | 完整 Chat Completions URL |
+| `ai_model` | 是 | 如 `qwen-plus`、`deepseek-chat` |
+| `ai_api_key` | 视网关 | Bearer；不传则保留旧值 |
+| `ai_timeout` | 否 | 10–90 秒，默认 30 |
+
+DeepSeek：`ai_endpoint=https://api.deepseek.com/chat/completions`，`ai_model=deepseek-chat`。切回内置：`--set ai_provider=builtin`。只改 AI **不必** sync。验收：`settings --json` 里 `runtime.ai_configured` 为 true。
+
+---
+
+## 场景 4：自定义向量库 — DashVector（阿里云）
+
+`vector_provider` 必须 `dashvector`。Collection 维度必须 = `vector_embed_dimension`（常用 1024）。可与 AI 的 builtin/custom 任意组合。
+
+```bash
+siluzan-website zasp set --site <guid> --body-file dashvector.json
+```
+
+`dashvector.json` 示例：
+
+```json
+{
+  "vector_provider": "dashvector",
+  "vector_endpoint": "vrs-cn-xxx.dashvector.cn-hangzhou.aliyuncs.com",
+  "vector_collection": "zasp_wp_products",
+  "vector_api_key": "你的DashVector-API-KEY",
+  "vector_site_id": "",
+  "vector_embed_endpoint": "https://dashscope.aliyuncs.com/compatible-mode/v1/embeddings",
+  "vector_embed_model": "text-embedding-v4",
+  "vector_embed_dimension": 1024,
+  "vector_embed_api_key": "sk-你的百炼EmbeddingKey",
+  "auto_sync": 1
+}
+```
+
+| 字段 | 必填 | 含义 |
+|------|------|------|
+| `vector_endpoint` | 是 | Cluster，可只填主机名 |
+| `vector_collection` | 是 | 不存在时可按维度自动创建 |
+| `vector_api_key` | 是 | DashVector 控制台 API-KEY |
+| `vector_site_id` | 否 | 空=自动探测；改了必须重新全量 sync |
+| `vector_embed_*` | 是 | 商品文本 → 向量；新加坡用 `dashscope-intl.aliyuncs.com` |
+
+改完必须 `zasp sync`。验收：`runtime.vector_configured === true` 且 sync `ok: true`。
+
+---
+
+## 场景 5：自定义向量库 — Generic HTTP 网关
+
+`vector_provider` 必须 `generic`。Search / Upsert / Delete 都 POST JSON，带 `action`、`collection`、`site_id`；Search 响应需含 `post_ids`。Embedding 仍由插件侧 `vector_embed_*` 完成。
+
+```json
+{
+  "vector_provider": "generic",
+  "vector_endpoint": "https://vector-gateway.example.com/v1/search",
+  "vector_upsert_endpoint": "https://vector-gateway.example.com/v1/write",
+  "vector_collection": "zasp_wp_products",
+  "vector_api_key": "你的网关Token",
+  "vector_site_id": "",
+  "vector_embed_endpoint": "https://dashscope.aliyuncs.com/compatible-mode/v1/embeddings",
+  "vector_embed_model": "text-embedding-v4",
+  "vector_embed_dimension": 1024,
+  "vector_embed_api_key": "sk-你的EmbeddingKey",
+  "auto_sync": 1
+}
+```
+
+网关协议：Search body `{"action":"search","collection":"...","site_id":"...","query":"...","top_k":50,"filter_post_ids":[1]}`；响应 `{"post_ids":[1,2,3]}`。改完必须 `zasp sync`。
+
+关闭向量库：`--set vector_provider=none`。
+
+---
+
+## 场景 6：只改咨询链接 / 筛选项 / 索引范围
+
+```bash
+siluzan-website zasp set --site <guid> --set contact_url=mailto:sales@example.com?subject=Product%20consultation
+siluzan-website zasp set --site <guid> --set max_facets=8
+siluzan-website zasp set --site <guid> --set product_post_types=product --set content_post_types=post,product
+siluzan-website zasp set --site <guid> --set meta_exclude=password,passwd,secret,token,api_key,session,cookie,nonce,private_key,internal_cost
+```
+
+`product_post_types` / `content_post_types`：`auto` = 自动发现；逗号分隔 = 固定类型名。
+
+---
+
+## 场景 7：清空 / 轮换密钥
+
+```bash
+siluzan-website zasp set --site <guid> --clear-vector-key
+siluzan-website zasp set --site <guid> --set vector_api_key=新的DashVector-API-KEY
+siluzan-website zasp set --site <guid> --clear-ai-key
+siluzan-website zasp set --site <guid> --clear-vector-embed-key
+```
+
+换成新 key 直接传新值即可，不必先 clear。
+
+---
+
+## 场景 8：全量同步商品到向量库
+
+改了 `vector_*` / `product_post_types` 之后，或怀疑向量库缺货。只改 custom AI 一般不必 sync。
+
+```bash
+siluzan-website zasp sync --site <guid>
+```
+
+成功看写入条数。失败（常见 502 / `Collection Not Exist`）：先修 Collection / key / 维度，再 `set`，再 `sync`。
+
+---
+
+## 场景 9：验收是否可用
+
+```bash
+siluzan-website zasp status --site <guid>
+siluzan-website zasp diagnostics --site <guid>
+```
+
+`status` 关注：`ready`、`ai_configured`、`vector_configured`、`vector_site_id`、`source_counts`。`diagnostics` 含 profile、关系统计，需管理员权限。
+
+---
+
+## 场景 10：前台试推一条（可选验收）
+
+```bash
+siluzan-website zasp recommend --site <guid> --query "stainless steel valve" --placement assistant --limit 5
+siluzan-website zasp recommend --site <guid> --placement related_products --limit 4 --page-id 31
+```
+
+`related_products` 必须带有效商品 `page-id`，同分类优先；`assistant` 走对话检索。
+
+---
+
+## Agent 标准流程
+
+1. `plugins list` 确认已装并启用 `zasp-smart-recommender`
+2. `zasp settings --json` 看现状
+3. 按用户意图选上面某一场景 → `zasp set`（只带必要字段，先确认）
+4. 若动过向量后端 → `zasp sync`
+5. `zasp status` 确认
+6. 用中文简短回复：改了什么、同步条数、失败原因（如有）。密钥只用 `has_*` 描述
+
+## 组合速查
+
+| 需求 | AI | 向量 |
+|------|----|------|
+| 全托管（最常见） | `builtin` | `builtin` |
+| 自有大模型 + 平台向量 | `custom` + endpoint/model/key | `builtin` |
+| 平台对话 + 自建 DashVector | `builtin` | `dashvector` + endpoint/collection/keys + embed |
+| 全自建 | `custom` | `dashvector` 或 `generic` |
+| 不用向量 | 任意 | `none` |

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.4'
+$PKG_VERSION = '1.0.1-beta.5'
 $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.4"
+readonly PKG_VERSION="1.0.1-beta.5"
 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.4",
+  "version": "1.0.1-beta.5",
   "description": "Siluzan WordPress 站点管理 Skill CLI — 列出站点、新增/编辑页面、安装/升级插件。",
   "keywords": [
     "ai-skill",