siluzan-website-cli 1.0.1-beta.6 → 1.0.1-beta.7

package/README.md

@@ -14,9 +14,11 @@ siluzan-website login
 
 ## 开通建站
 
+对话顺序：**先图文选模板，再一次性填站信息**（对齐 TSO）。
+
 ```bash
-siluzan-website packages list
-siluzan-website templates list --package <packageId>
+siluzan-website templates catalog          # 套餐+封面+预览，开站第一步
+siluzan-website templates get --id <siteTemplateId>
 siluzan-website trial status
 siluzan-website bills create --package <packageId> --channel Monthly
 siluzan-website bills get --id <billId>

package/dist/index.js

@@ -3319,6 +3319,7 @@ var DEFAULT_API_BASE = "https://api-ci.siluzan.com";
 var DEFAULT_CSO_BASE = "https://cso-ci.siluzan.com";
 var DEFAULT_CSO_PLUGIN_API = "https://cso-api-ci.siluzan.com";
 var DEFAULT_WEB_BASE = "https://www-ci.siluzan.com";
+var DEFAULT_SITEMAN_BASE = "https://api-ussiteman-ci.mysiluzan.com";
 var DEFAULT_SITE_STAGE = "ci";
 
 // src/utils/version.ts
@@ -4189,8 +4190,115 @@ function unwrapList2(raw) {
   if (Array.isArray(obj.data)) {
     return obj.data.map(asRecord3).filter((x) => Boolean(x));
   }
+  if (Array.isArray(obj.items)) {
+    return obj.items.map(asRecord3).filter((x) => Boolean(x));
+  }
   return [];
 }
+function siteManBase() {
+  return (process.env.SILUZAN_SITEMAN_BASE ?? DEFAULT_SITEMAN_BASE).replace(/\/+$/, "");
+}
+function enrichTemplatePreview(t) {
+  const out = { ...t };
+  const base = siteManBase();
+  const coverId = readString3(t, "cover") || readString3(t, "Cover");
+  const imageId = readString3(t, "image") || readString3(t, "Image");
+  if (!readString3(t, "coverUrl") && coverId) out.coverUrl = `${base}/api/Attachments/${coverId}`;
+  if (!readString3(t, "imageUrl") && imageId) out.imageUrl = `${base}/api/Attachments/${imageId}`;
+  const colors = Array.isArray(t.colors) ? t.colors : Array.isArray(t.Colors) ? t.Colors : [];
+  const first = asRecord3(colors[0]);
+  const preview = readString3(first, "colorSchemePreview") || readString3(first, "ColorSchemePreview");
+  if (!readString3(t, "previewUrl") && preview) out.previewUrl = preview;
+  const colorPreviewId = readString3(first, "colorPreview") || readString3(first, "ColorPreview");
+  if (!readString3(t, "colorPreviewUrl") && colorPreviewId) {
+    out.colorPreviewUrl = `${base}/api/Attachments/${colorPreviewId}`;
+  }
+  return out;
+}
+function templateBelongsToPackage(t, packageId) {
+  const packages = readString3(t, "packages") || readString3(t, "Packages");
+  if (!packages) return false;
+  if (packages.toLowerCase().includes(`|${packageId.toLowerCase()}|`)) return true;
+  return packages.split(/[|,;]/).map((s) => s.trim()).some((p) => p.toLowerCase() === packageId.toLowerCase());
+}
+function pickPreviewFields(t) {
+  const e = enrichTemplatePreview(t);
+  return {
+    id: readString3(e, "siteTemplateId") || readString3(e, "SiteTemplateId"),
+    name: readString3(e, "name") || readString3(e, "Name"),
+    industry: readString3(e, "industrys") || readString3(e, "Industrys") || "-",
+    coverUrl: readString3(e, "coverUrl") || readString3(e, "CoverUrl") || "",
+    previewUrl: readString3(e, "previewUrl") || readString3(e, "PreviewUrl") || "",
+    hot: String(e.hotTag ?? e.HotTag ?? "-"),
+    neu: String(e.newTag ?? e.NewTag ?? "-"),
+    version: readString3(e, "version") || readString3(e, "Version") || "-"
+  };
+}
+function printCatalogMarkdown(groups) {
+  console.log("\n# \u5EFA\u7AD9\u6A21\u677F\u76EE\u5F55\uFF08\u8BF7\u5148\u9009\u6A21\u677F\uFF09\n");
+  console.log("\u5C55\u793A\u89C4\u5219\uFF1A\u6309\u5957\u9910\u5206\u7EC4\uFF1B\u6BCF\u6761\u542B\u5C01\u9762\u56FE\u4E0E\u5728\u7EBF\u9884\u89C8\u94FE\u63A5\uFF08\u4E0E TSO \u5EFA\u7AD9\u4E00\u81F4\uFF09\u3002");
+  console.log("\u8BF7\u7528\u6237\u9009\u5B9A **siteTemplateId**\uFF08\u53CA\u6240\u5C5E\u5957\u9910\uFF09\u540E\uFF0C\u518D\u4E00\u6B21\u6027\u6536\u96C6\u5EFA\u7AD9\u8868\u5355\u5B57\u6BB5\u3002\n");
+  for (const g of groups) {
+    const pkgId = readString3(g, "packageId");
+    const pkgName = readString3(g, "packageName") || pkgId;
+    const month = g.monthPriceUSD ?? g.MonthPriceUSD ?? "-";
+    const year = g.yearlyPriceUSD ?? g.YearlyPriceUSD ?? "-";
+    const templates = Array.isArray(g.templates) ? g.templates : [];
+    console.log(`## ${pkgName}\uFF08\`${pkgId}\`\uFF09`);
+    console.log(`\u6708\u4ED8 USD ${month} / \u5E74\u4ED8\u6708\u4EF7 USD ${year} \xB7 \u6A21\u677F ${templates.length} \u4E2A
+`);
+    if (templates.length === 0) {
+      console.log("_\u672C\u5957\u9910\u6682\u65E0\u542F\u7528\u6A21\u677F_\n");
+      continue;
+    }
+    for (const raw of templates) {
+      const t = asRecord3(raw);
+      if (!t) continue;
+      const p = pickPreviewFields(t);
+      const tags = [p.hot === "true" ? "\u70ED\u95E8" : "", p.neu === "true" ? "\u65B0\u54C1" : ""].filter(Boolean).join(" \xB7 ");
+      console.log(`### ${p.name || p.id} \uFF08\`${p.id}\`\uFF09`);
+      if (tags) console.log(`\u6807\u7B7E\uFF1A${tags}`);
+      console.log(`\u884C\u4E1A\uFF1A${p.industry}`);
+      if (p.coverUrl) console.log(`![${p.name || p.id}](${p.coverUrl})`);
+      if (p.previewUrl) console.log(`\u5728\u7EBF\u9884\u89C8\uFF1A${p.previewUrl}`);
+      console.log("");
+    }
+  }
+  console.log("---");
+  console.log("\u4E0B\u4E00\u6B65\uFF1A\u7528\u6237\u786E\u8BA4\u6A21\u677F\u540E\uFF0C\u7528\u4E00\u6B21\u6027\u8868\u5355\u6536\u96C6\uFF1A\u7AD9\u540D\u3001\u533A\u57DF(US|CN)\u3001\u524D\u53F0\u8BED\u8A00\u3001\u540E\u53F0\u8BED\u8A00\u3001\u8BD5\u7528\u6216\u4ED8\u8D39\u3002");
+  console.log("\u786E\u8BA4\u8868\u5355\u540E\u6267\u884C\uFF1A`siluzan-website sites create ...`\n");
+}
+async function composeCatalogLocally(config, verbose) {
+  const [pkgRaw, tplRaw] = await Promise.all([
+    apiFetch2(`${config.apiBaseUrl}/website-provision/packages`, config, {}, verbose),
+    apiFetch2(
+      `${config.apiBaseUrl}/website-provision/templates?pageSize=500&pageIndex=1`,
+      config,
+      {},
+      verbose
+    )
+  ]);
+  const packages = unwrapList2(pkgRaw).filter((p) => !(p.sunset === true || p.Sunset === true));
+  const templates = unwrapList2(tplRaw).map(enrichTemplatePreview);
+  const groups = packages.map((p) => {
+    const packageId = readString3(p, "packageId") || readString3(p, "PackageId");
+    const matched = templates.filter((t) => templateBelongsToPackage(t, packageId));
+    return {
+      packageId,
+      packageName: readString3(p, "packageName") || readString3(p, "PackageName"),
+      monthPriceUSD: p.monthPriceUSD ?? p.MonthPriceUSD,
+      yearlyPriceUSD: p.yearlyPriceUSD ?? p.YearlyPriceUSD,
+      templates: matched,
+      templateCount: matched.length
+    };
+  });
+  return {
+    packages,
+    groups,
+    totalTemplates: templates.length,
+    source: "cli-fallback"
+  };
+}
 async function runTemplatesList(opts) {
   const config = loadConfig();
   const params = new URLSearchParams({ pageSize: "100", pageIndex: "1" });
@@ -4208,7 +4316,7 @@ async function runTemplatesList(opts) {
     process.exit(1);
     return;
   }
-  const list = unwrapList2(raw);
+  const list = unwrapList2(raw).map(enrichTemplatePreview);
   if (opts.json) {
     console.log(JSON.stringify({ total: list.length, templates: list }, null, 2));
     return;
@@ -4221,23 +4329,106 @@ async function runTemplatesList(opts) {
     { key: "id", header: "siteTemplateId" },
     { key: "name", header: "\u540D\u79F0" },
     { key: "industry", header: "\u884C\u4E1A" },
-    { key: "version", header: "\u7248\u672C" },
+    { key: "preview", header: "\u9884\u89C8" },
     { key: "hot", header: "\u70ED\u95E8" },
     { key: "neu", header: "\u65B0\u54C1" }
   ];
-  const rows = list.map((t) => ({
-    id: readString3(t, "siteTemplateId") || readString3(t, "SiteTemplateId"),
-    name: readString3(t, "name") || readString3(t, "Name"),
-    industry: readString3(t, "industrys") || readString3(t, "Industrys") || "-",
-    version: readString3(t, "version") || readString3(t, "Version") || "-",
-    hot: String(t.hotTag ?? t.HotTag ?? "-"),
-    neu: String(t.newTag ?? t.NewTag ?? "-")
-  }));
+  const rows = list.map((t) => {
+    const p = pickPreviewFields(t);
+    return {
+      id: p.id,
+      name: p.name,
+      industry: p.industry,
+      preview: p.previewUrl || (p.coverUrl ? "(\u6709\u5C01\u9762)" : "-"),
+      hot: p.hot,
+      neu: p.neu
+    };
+  });
   console.log(`
 \u6A21\u677F\u5217\u8868\uFF08\u5171 ${list.length} \u4E2A\uFF09
 `);
   printCliTable(rows, columns);
-  console.log("\n\u8BE6\u60C5\uFF1Asiluzan-website templates get --id <siteTemplateId>\n");
+  console.log("\n\u56FE\u6587\u76EE\u5F55\uFF1Asiluzan-website templates catalog");
+  console.log("\u8BE6\u60C5\uFF1Asiluzan-website templates get --id <siteTemplateId>\n");
+}
+async function runTemplatesCatalog(opts) {
+  const config = loadConfig();
+  const url = `${config.apiBaseUrl}/website-provision/template-catalog`;
+  let raw;
+  let usedFallback = false;
+  try {
+    raw = await apiFetch2(url, config, {}, opts.verbose);
+  } catch (e) {
+    const msg = e.message || "";
+    if (/HTTP 404/.test(msg)) {
+      console.error("\u2139\uFE0F  \u4E3B\u7AD9\u5C1A\u672A\u90E8\u7F72 template-catalog\uFF0C\u6539\u7528 packages+templates \u672C\u5730\u62FC\u88C5\u76EE\u5F55\u2026");
+      try {
+        raw = await composeCatalogLocally(config, opts.verbose);
+        usedFallback = true;
+      } catch (e2) {
+        console.error(`
+\u274C \u62FC\u88C5\u6A21\u677F\u76EE\u5F55\u5931\u8D25\uFF1A${e2.message}`);
+        process.exit(1);
+        return;
+      }
+    } else {
+      console.error(`
+\u274C \u83B7\u53D6\u6A21\u677F\u76EE\u5F55\u5931\u8D25\uFF1A${msg}`);
+      if (!opts.verbose) console.error("   \u52A0 --verbose \u53EF\u67E5\u770B\u8BE6\u7EC6\u9519\u8BEF");
+      process.exit(1);
+      return;
+    }
+  }
+  const root = asRecord3(raw);
+  let groups = (Array.isArray(root?.groups) ? root.groups : []).map(asRecord3).filter((x) => Boolean(x)).map((g) => ({
+    ...g,
+    templates: Array.isArray(g.templates) ? g.templates.map((t) => enrichTemplatePreview(asRecord3(t) ?? {})) : []
+  }));
+  if (opts.package?.trim()) {
+    const pkg = opts.package.trim();
+    groups = groups.filter((g) => readString3(g, "packageId") === pkg);
+  }
+  if (opts.json) {
+    console.log(
+      JSON.stringify(
+        {
+          totalGroups: groups.length,
+          totalTemplates: root?.totalTemplates ?? groups.reduce((n, g) => n + (Array.isArray(g.templates) ? g.templates.length : 0), 0),
+          source: usedFallback ? "cli-fallback" : root?.source ?? "api",
+          groups
+        },
+        null,
+        2
+      )
+    );
+    return;
+  }
+  if (opts.markdown !== false) {
+    if (usedFallback) console.log("\uFF08\u6570\u636E\u6E90\uFF1ACLI \u56DE\u9000\u62FC\u88C5\uFF09");
+    printCatalogMarkdown(groups);
+    return;
+  }
+  for (const g of groups) {
+    const pkgId = readString3(g, "packageId");
+    const pkgName = readString3(g, "packageName") || pkgId;
+    const templates = Array.isArray(g.templates) ? g.templates : [];
+    console.log(`
+## ${pkgName} (${pkgId}) \u2014 ${templates.length} \u4E2A\u6A21\u677F
+`);
+    const columns = [
+      { key: "id", header: "siteTemplateId" },
+      { key: "name", header: "\u540D\u79F0" },
+      { key: "industry", header: "\u884C\u4E1A" },
+      { key: "preview", header: "\u9884\u89C8URL" }
+    ];
+    const rows = templates.map((item) => {
+      const t = asRecord3(item) ?? {};
+      const p = pickPreviewFields(t);
+      return { id: p.id, name: p.name, industry: p.industry, preview: p.previewUrl || "-" };
+    });
+    printCliTable(rows, columns);
+  }
+  console.log();
 }
 async function runTemplatesGet(opts) {
   const id = opts.id?.trim();
@@ -4256,22 +4447,35 @@ async function runTemplatesGet(opts) {
     process.exit(1);
     return;
   }
+  const enriched = enrichTemplatePreview(asRecord3(raw) ?? {});
   if (opts.json) {
-    console.log(JSON.stringify(raw, null, 2));
+    console.log(JSON.stringify(enriched, null, 2));
     return;
   }
-  const t = asRecord3(raw);
+  const p = pickPreviewFields(enriched);
   console.log("\n\u6A21\u677F\u8BE6\u60C5\n");
-  console.log(`  siteTemplateId : ${readString3(t, "siteTemplateId") || readString3(t, "SiteTemplateId") || id}`);
-  console.log(`  name           : ${readString3(t, "name") || readString3(t, "Name")}`);
-  console.log(`  description    : ${readString3(t, "description") || readString3(t, "Description") || "-"}`);
-  console.log(`  industrys      : ${readString3(t, "industrys") || readString3(t, "Industrys") || "-"}`);
-  console.log(`  version        : ${readString3(t, "version") || readString3(t, "Version") || "-"}`);
-  console.log(`  hasTheme       : ${String(t?.hasTheme ?? "-")}`);
+  console.log(`  siteTemplateId : ${p.id || id}`);
+  console.log(`  name           : ${p.name}`);
+  console.log(`  description    : ${readString3(enriched, "description") || readString3(enriched, "Description") || "-"}`);
+  console.log(`  industrys      : ${p.industry}`);
+  console.log(`  version        : ${p.version}`);
+  console.log(`  hasTheme       : ${String(enriched.hasTheme ?? "-")}`);
+  console.log(`  coverUrl       : ${p.coverUrl || "-"}`);
+  console.log(`  previewUrl     : ${p.previewUrl || "-"}`);
+  if (p.coverUrl) console.log(`
+![${p.name || p.id}](${p.coverUrl})`);
   console.log("\n\uFF08\u5B89\u88C5\u5305\u5730\u5740\u5DF2\u8131\u654F\uFF0C\u4E0D\u4F1A\u8F93\u51FA\uFF09\n");
 }
 function register7(program2) {
   const templates = program2.command("templates").description("\u5EFA\u7AD9\u6A21\u677F\uFF08website-provision\uFF09");
+  templates.command("catalog").description("\u5957\u9910+\u6A21\u677F\u56FE\u6587\u76EE\u5F55\uFF08\u5BF9\u9F50 TSO\uFF1B\u5BF9\u8BDD\u5F00\u7AD9\u7B2C\u4E00\u6B65\uFF09").option("--package <packageId>", "\u53EA\u663E\u793A\u67D0\u4E00\u5957\u9910").option("--json", "\u8F93\u51FA JSON", false).option("--table", "\u8868\u683C\u8F93\u51FA\uFF08\u9ED8\u8BA4 Markdown \u56FE\u6587\u753B\u5ECA\uFF09", false).option("--verbose", "\u8F93\u51FA\u8BF7\u6C42\u8BE6\u60C5", false).action(async (opts) => {
+    await runTemplatesCatalog({
+      package: opts.package,
+      json: opts.json,
+      markdown: !opts.table && !opts.json,
+      verbose: opts.verbose
+    });
+  });
   templates.command("list").description("\u6309\u5957\u9910\u7B49\u6761\u4EF6\u5217\u51FA\u6A21\u677F").option("--package <packageId>", "\u5957\u9910 ID \u8FC7\u6EE4").option("--industry <industry>", "\u884C\u4E1A\u8FC7\u6EE4").option("--keyword <keyword>", "\u5173\u952E\u8BCD").option("--json", "\u8F93\u51FA JSON", false).option("--verbose", "\u8F93\u51FA\u8BF7\u6C42\u8BE6\u60C5", false).action(async (opts) => {
     await runTemplatesList(opts);
   });

package/dist/skill/SKILL.md

@@ -40,7 +40,8 @@ Windows 注意：部分 Agent 通过 PowerShell / cmd 代执行时可能失败
 | `siluzan-website config show/set/clear` | 查看 / 写入凭据 | [references/setup.md](references/setup.md) |
 | `siluzan-website init` / `update` | 写入 / 刷新 Skill 文件 | [references/setup.md](references/setup.md) |
 | `siluzan-website packages list` | 可售套餐 | [references/provision.md](references/provision.md) |
-| `siluzan-website templates list/get` | 建站模板 | [references/provision.md](references/provision.md) |
+| `siluzan-website templates catalog` | **图文选模目录**（套餐+封面+预览，开站第一步） | [references/provision.md](references/provision.md) |
+| `siluzan-website templates list/get` | 建站模板列表 / 详情 | [references/provision.md](references/provision.md) |
 | `siluzan-website trial status` | 试用额度 | [references/provision.md](references/provision.md) |
 | `siluzan-website bills create/get` | 套餐账单与支付状态 | [references/provision.md](references/provision.md) |
 | `siluzan-website sites list` | 列出我的 WordPress 站点 | [references/sites.md](references/sites.md) |
@@ -61,7 +62,7 @@ Windows 注意：部分 Agent 通过 PowerShell / cmd 代执行时可能失败
 | 用户在做什么 | 先读 | 再执行 |
 |--------------|------|--------|
 | 首次安装 / 登录 | `references/setup.md` | `login` 或复用已有 CSO/TSO 凭据 |
-| **选套餐 / 选模板 / 试用或付费开站** | `references/provision.md` | packages → templates → trial/bills → 确认 → sites create |
+| **开通新站 / 选模板建站** | `references/provision.md` | **先** `templates catalog` 图文选模 → **再**一次性表单（站名/区域/语言/试用或付费）→ trial/bills → 确认 → `sites create` |
 | 我有哪些网站 | `references/sites.md` | `sites list`，不要猜 guid |
 | 加一页 / 改一页正文 | `references/pages.md` | 先 `sites list` 再 `pages add/update` |
 | 改页面 slug / 状态 / 回收站 | `references/pages.md` | `pages meta` / `pages trash` |
@@ -84,7 +85,8 @@ Windows 注意：部分 Agent 通过 PowerShell / cmd 代执行时可能失败
    - 写操作（`bills create`、`sites create/bind`、`pages add/update/meta/trash`、`content add/update/trash`、`media upload`、`terms add/update/delete`、`plugins install/update/uninstall/update-helper`、`zasp set/sync`）会立刻生效，执行前必须复述目标与内容，获得用户确认。
    - 只读（`packages/templates/trial`、`bills get`、`sites list/status`、`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`；套餐/模板用 list 返回的 id。
-3. **先查再写**：改页面前先 `pages list`；开站前先 `trial status` 或 `bills get`。
+3. **先查再写**：改页面前先 `pages list`；**开站必须先 `templates catalog` 选定模板**，再一次性收集站信息表单；创建前再查 `trial status` 或 `bills get`。  
+   禁止未选模板就追问站名/区域/语言。
 4. **只认 API Key**：所有命令走 `x-api-key`。Agent 沙箱只注入 Key，不要向用户要 JWT，也不要设 `SILUZAN_AUTH_TOKEN`，不要直连 ussiteman。
 5. **命令透明**：用一句话说明意图；用户要细节时再给完整命令。
 6. **失败先自救**：401 → 重新 `login`；开站失败勿盲目重试 POST；`site_created_unbound` → `sites bind`；helper 404 → 自动升 helper。不要编造成功。

package/dist/skill/_meta.json

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

package/dist/skill/references/provision.md

@@ -1,18 +1,78 @@
 # 对话开通站点（provision）
 
-通过主站 `website-provision` API 完成选套餐 → 支付/试用 → 选模板 → 创建站。  
-**禁止**直连 ussiteman，**禁止**向用户要 JWT。只使用 API Key + 本 Skill CLI。
+通过主站 `website-provision` API 完成：**先选模板（图文）→ 一次性填站信息 → 试用/付费 → 创建**。  
+对齐 TSO 建站选模体验。**禁止**直连 ussiteman，**禁止**向用户要 JWT。只使用 API Key + 本 Skill CLI。
 
-## 对话 SOP
+## 对话 SOP（必须按此顺序）
 
-1. `packages list` — 列套餐并与用户选定（或确认走试用）
-2. 付费：`bills create --package <id>` → 把 `checkoutUrl` 给用户 → 用户付完后 `bills get --id <billId>` 确认 Paid
-3. `templates list --package <id>` — 选定模板；需要时 `templates get --id`
-4. `trial status` — 试用路径先看剩余次数（上限 3）
-5. **复述计划并获用户确认**（站名、区域 US/CN、语种、套餐、模板、试用或账单号）
-6. `sites create --name … --region … --package … --template … --site-lang … --admin-lang … [--bill …] [--wait]`
-7. 若返回 `site_created_unbound`：`sites bind --site <guid> --name <同名> --region …`
-8. `sites status` / `sites list` 核对 Online 后，再交给 pages / plugins 等运维命令
+### 1. 图文选模板（先于任何站信息）
+
+```bash
+siluzan-website templates catalog
+# 或：siluzan-website templates catalog --json
+# 或只看某套餐：siluzan-website templates catalog --package BasicEdition
+```
+
+Agent **必须**把目录以图文形式展示给用户（CLI 默认已输出 Markdown 画廊）：
+
+- 按**套餐**分组（套餐名、价格、模板数）
+- 每个模板：`![封面](coverUrl)` + 名称 + `siteTemplateId` + 行业 + `previewUrl`（在线预览，与 TSO 一致）
+- **不要**先问站名/区域/语言；先让用户选定模板
+
+用户确认后记下：
+
+| 字段 | 来源 |
+|------|------|
+| `siteTemplateId` | 用户点选的模板 |
+| `packageId` | 该模板所属套餐分组 |
+
+可用 `templates get --id <id>` 再确认封面/预览（可选）。
+
+### 2. 一次性建站表单（确认模板之后）
+
+选定模板后，**一次性**向用户展示表单（可复制为 Markdown 表格让用户填），字段如下：
+
+| 字段 | 必填 | 说明 | 示例 |
+|------|------|------|------|
+| 站点名称 `name` | 是 | 广告主/站点显示名 | Acme Trading |
+| 区域 `region` | 是 | `US` 或 `CN` | US |
+| 前台语言 `siteLang` | 是 | 如 `en_US` / `zh_CN` | en_US |
+| 后台语言 `adminLang` | 是 | 通常与前台相同 | en_US |
+| 开通方式 | 是 | `试用` 或 `付费` | 试用 |
+
+规则：
+
+- 套餐与模板**已由第 1 步锁定**，表单里不要再改（可只读展示）
+- 区域默认：未填时 `US` → 语言默认 `en_US`；`CN` → 默认 `zh_CN`
+- **禁止**拆成多轮零散追问（不要先问站名、再问区域、再问语言）；一张表单收齐
+
+付费路径额外字段：
+
+| 字段 | 说明 |
+|------|------|
+| 付费周期 | `Monthly` / `Yearly`（对应 `bills create --channel`） |
+
+### 3. 额度 / 支付
+
+- 试用：`trial status`；若 `remaining=0` 引导付费，勿强行 create  
+- 付费：`bills create --package <已锁定的 packageId>` → 把 `checkoutUrl` 给用户 → `bills get` 确认 Paid
+
+### 4. 复述计划并确认后创建
+
+复述：站名、区域、语种、套餐、模板、试用或账单号 → 用户明确同意后：
+
+```bash
+siluzan-website sites create \
+  --name "…" --region US|CN \
+  --package <packageId> --template <siteTemplateId> \
+  --site-lang … --admin-lang … \
+  [--bill <billId>] [--wait]
+```
+
+### 5. 收尾
+
+- `site_created_unbound` → `sites bind --site <guid> --name <同名> --region …`
+- `sites status` / `sites list` 核对 Online 后，再交给 pages / plugins
 
 ## 写操作确认
 
@@ -22,8 +82,8 @@
 ## 命令速查
 
 ```bash
-siluzan-website packages list
-siluzan-website templates list --package <packageId>
+siluzan-website templates catalog
+siluzan-website templates catalog --package BasicEdition
 siluzan-website templates get --id <siteTemplateId>
 siluzan-website trial status
 siluzan-website bills create --package <packageId> --channel Monthly
@@ -42,9 +102,11 @@ siluzan-website sites bind --site <guid> --region US --name "Acme"
 | bill_unpaid / bill_owner_mismatch | 查 `bills get`；勿用他人账单号 |
 | site_created_unbound | 跑 `sites bind`，再 `sites list` |
 | 503 disabled | 主站 WebsiteProvision 功能开关关闭 |
+| template-catalog 404 | 主站未部署 catalog 接口；可暂用 `packages list` + `templates list --package` 拼目录 |
 
 ## 明确不做
 
 - CLI 直连 SiteMan / 注入 `SILUZAN_AUTH_TOKEN` 开通
+- 未选模板就收集站名等建站字段
 - 删除站、重启、绑域名、CDN、SSL
 - AI Sites / LPS 静态建站

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