@wkgeo/cli 1.1.2 → 1.1.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/CHANGELOG.md CHANGED
@@ -4,6 +4,24 @@
4
4
 
5
5
  ---
6
6
 
7
+ ## 1.1.3 · 2026-11-09
8
+
9
+ **`wkgeo publish` 拦「站点没有自有域名」**(2026-11-09,与 CMS 后台发布按钮同口径):站点唯一地址是平台
10
+ 预览地址(`<slug>.site.wkgeo.cn`,动态实时渲染,内容改完立刻就是最新),静态发布产物只服务客户自有域名 ——
11
+ 所以没绑域名时 `publish` / `publish retry`(**含 dry-run**)**直接拒绝**(exit 1)并提示
12
+ 「当前站点使用平台预览地址,内容实时生效,无需发布;请绑定自有域名后再发布」,**一个发布请求都不发**。
13
+
14
+ - 判据同 CMS `siteCustomDomainState`:`site_domain` 里 `verify_status='verified'`(custom > root > other)
15
+ → 回落 `custom_domain` / `domain`;`--json` 的 `error.details = { reason:'no-custom-domain', hasCustomDomain:false }`;
16
+ - 读不到域名状态时 **fail-open 放行**(与 CMS 同口径,不因一次查询抖动封死发布);
17
+ - `--cancel` / `publish status` / 推送类动作不受影响;服务端 `wkgeo-cli-fc` 也加了同一条 409 闸门。
18
+
19
+ **常量收敛**:新增 `cli/lib/hosts.mjs`(CLI 侧**唯一**的平台域名出处)—— `DEFAULT_OAUTH_WEB_BASE` /
20
+ `DEFAULT_USER_WEB_BASE` / CMS 预览地址 / manifest `$id` / 模板抓取 UA 全部由它派生;
21
+ 再换域(`.com` → `.cn` 这类)只改 `PLATFORM_DOMAIN` 一行。
22
+
23
+ ---
24
+
7
25
  ## 1.1.2 · 2026-11-09
8
26
 
9
27
  **`--open-browser` / `WKONGAI_OPEN_BROWSER=1` 可压过「非交互」判定**:AI 子进程 / 管道 / CI 里只要显式要求,
package/README.md CHANGED
@@ -87,7 +87,7 @@ cd cli && node scripts/build-exe.mjs --sea # 跑 Node SEA 的离线两步(
87
87
 
88
88
  ### 版本与升级策略
89
89
 
90
- * 当前版本 **`1.0.0`**(`cli/package.json`,**2026-10-30 已发布到 npm 组织 `@wkgeo`**):在 0.6.0 之上把后台**整块搬进 CLI** —— 内容 45 / 素材 18 / 发布 16 / 配置类 auth 11 / 站点 7 / 插件 9 / 控制台 8 七批动作全部由自持云函数 `wkgeo-cli-fc` 进程内执行(不再借 `/cms` 会话转发,因而计入 `cli_action_usage`),**`whoami.action_total` 150 → 185**,新增 / 补齐 `assets`、`publish`、`site info`、`plugins`、`config`、`logs`、`overview`、`lang`/`role`/`member` 命令组;上一个版本 **`0.6.0`**(2026-10-28:`/cli` 收口 + `auth` 命令组 + `domain bind` + 域名成交链路);更早的补丁版 **`0.5.1`**(2026-10-26:修 0.5.0 的 `publish --confirm` 轮询崩溃 `ctx.sleep is not a function`)。
90
+ * 当前版本 **`1.1.3`**(`cli/package.json`,**2026-11-09 已发布到 npm 组织 `@wkgeo`**;1.1.0–1.1.3 是增量补丁,逐版明细见 [`CHANGELOG.md`](./CHANGELOG.md));**`1.0.0`**(2026-10-30)在 0.6.0 之上把后台**整块搬进 CLI** —— 内容 45 / 素材 18 / 发布 16 / 配置类 auth 11 / 站点 7 / 插件 9 / 控制台 8 七批动作全部由自持云函数 `wkgeo-cli-fc` 进程内执行(不再借 `/cms` 会话转发,因而计入 `cli_action_usage`),**`whoami.action_total` 150 → 185**,新增 / 补齐 `assets`、`publish`、`site info`、`plugins`、`config`、`logs`、`overview`、`lang`/`role`/`member` 命令组;上一个版本 **`0.6.0`**(2026-10-28:`/cli` 收口 + `auth` 命令组 + `domain bind` + 域名成交链路);更早的补丁版 **`0.5.1`**(2026-10-26:修 0.5.0 的 `publish --confirm` 轮询崩溃 `ctx.sleep is not a function`)。
91
91
  * **本版只加命令、不改契约**:原有命令 / 参数 / `--json` 信封 / 退出码与 0.6.0 完全一致,AI 端继续用 `npx -y @wkgeo/cli@latest` 即可;逐批明细与已知缺口见 [`CHANGELOG.md`](./CHANGELOG.md) 顶部「1.0.0」。
92
92
  * **同一个版本号不能覆盖**:改了代码必须 `npm version patch|minor|major` 再发布。
93
93
  * AI 端统一用 **`npx -y @wkgeo/cli@latest`** → 每次自动拿最新版;
@@ -99,6 +99,7 @@ cd cli && node scripts/build-exe.mjs --sea # 跑 Node SEA 的离线两步(
99
99
 
100
100
  | 版本 | 日期 | 变更 |
101
101
  | --- | --- | --- |
102
+ | **1.1.3** | 2026-11-09 | **`publish` / `publish retry`(含 dry-run)在站点没有客户自有域名时直接拒绝**(exit 1,一个发布请求都不发),提示「当前站点使用平台预览地址,内容实时生效,无需发布;请绑定自有域名后再发布」;判据同 CMS 后台(`site_domain` verified → 回落 `custom_domain`/`domain`),读不到域名状态 fail-open;`--cancel` / `publish status` 不受影响。服务端 `wkgeo-cli-fc` 同批加 `409 no-custom-domain` 兜底。另新增 `lib/hosts.mjs`(CLI 侧唯一平台域名源,12 处域名收口到常量),1.1.1 的 `.com`→`.cn` 默认值也由它派生 |
102
103
  | **1.0.0** | 2026-10-30 | **本版是 scoped 新包**:包名 `@wkgeo/cli`(npm 组织 `@wkgeo`),命令 / 参数 / `--json` 信封 / 退出码与旧包最后一版完全一致;`license` 改 MIT、随包附 `LICENSE`、`engines.node` 为 `>=18`。以下是本版带来的动作面: **七批后台动作全量进自持面(动作面 150 → 185)**。① **插件类 9 条**(task-91 / B5):`plugins` 从 2 条扩到 **9 条**(`list` / `access` / `toggle` / `settings` / `market-list` / `install` / `uninstall` / `upgrade` / `demo`),全部由 `wkgeo-cli-fc/src/plugin-core.js`(逐字复制 CMS handler,生成器拼装)执行,**不再借 `/cms` 转发**,因此进 `cli_action_usage` 计数;权限:4 条读 `site:read`,5 条写 `site:write`(服务端另校验 `site.owner_id`:他人站 403 `not_site_owner`,站名/业主一概不回);写命令一律**默认 dry-run**,`--confirm` 才真发;**9 条全迁、无不迁条目**(`pluginMarketDemo` 只读库里 `demo_url`,不下载外链)。② **站点类 7 条**(task-90 / B4):新增 `site info`、`site info save`、`site domain-recheck`、`site demo-seed`、`site demo-clear`、`site sync`,并把 `domain inspection` 从 `/cms` 切到 `/cli` 的 `cmsSiteDomainInspectionList`;**不迁** `cmsCreateSite`(`site create` 已是原生动作,迁会双写 `site` / `cms_site_member`)与 `cmsSiteDomainCheck`(`domain check` 已走原生 `siteDomainCheck`)。③ **控制台类 8 条**(task-92 / B7):新增 `logs list`、`config get\|save\|review\|capabilities`、`overview summary\|traffic\|dashboard`;平台管理员判定改成真查库(`isPlatformAdminUser`)⇒ `traffic` / `dashboard` 的平台门禁照样成立;6 条只读**不写审计**,只有 `configSave` / `configReview` 落 `admin_audit_log`;`configReview` 另带 `x-review-token` 双闸(未配 `REVIEW_TOKEN` 回 503)。动作面推进:**150(0.6.0)→ 168(B4)→ 177(B5)→ 185(B7)**;域名级 DNS 凭据 4 条按后端口径不计入(`auth status` 单列 `uncounted_self_hosted`),`/cli` 可见动作实际 189 = 185 + 4。 |
103
104
  | **0.6.0** | 2026-10-28 | **CLI 收口到自己的云函数 `wkgeo-cli-fc`(网关 `/cli`)**。① 业务面从 `/user` `/order` `/domain` 收敛到 `/cli`(`WKONGAI_LEGACY_ENDPOINTS=1` 才走老路径),动作面 **150 条**(原生 + 自持重建 + 金融面白名单转发)。② 新增 **`auth` 命令组**:`auth status`(`cliWhoami`:账号 / `client_id` / `scopes` / 到期 / 动作面体检)、`auth token`(只给前 4 位 + 长度 + 到期)、`auth revoke`(`POST /api/oauth/revoke` + 删本地)。③ 新增 **`domain bind`**(原生 `cliProvisionSiteDomain`;平台通道没开时上游 503 → 明确「本次未写入,可直接重试」+ exit 1)。④ 新增 `sites get`、`domain status\|records\|dns\|check\|remind`(只读)、`sites list --with-prefix`、`sites create --channel auto\|platform\|cms`。⑤ 新增建站端到端脚本 `cli/scripts/e2e-site.mjs`(建站 → 校验短域 → 可选绑域 → 发布 → 盯首页 200 + 指纹;**默认不删站**、真建站需 `--confirm`)。**令牌模型不变**(OAuth access_token,30 天)。 |
104
105
  | **0.5.1** | 2026-10-26 | **修 `publish --confirm` 崩在轮询**。0.5.0 在**发布已经提交成功之后**抛 `{"kind":"internal","message":"ctx.sleep is not a function"}`(exit 1):`lib/cli.mjs` 逐字透传 `sleep: io.sleep`,而生产入口 `wkgeo.mjs` 调 `run(argv)` 不传 `io`,`undefined` 覆盖了默认值;`lib/runtime.mjs` 的 `sleep` 默认值本身也是 `undefined`。修法:**所有可选注入项在 runtime 层落地默认实现**(`sleep`/`now`/`random`/`log`/`clock`/`fetchImpl` 等,非法值一律归一化),`cli.mjs` 只透传真的给了的注入项(`undefined` 不出现,`false`/`0` 保留)。新增 8 条回归(含「不传 io 的 publish --confirm 端到端」)。**命令、参数、`--json` 信封、退出码全部不变**。 |
@@ -444,7 +445,7 @@ wkgeo login --device-continue --json
444
445
  | `templates save` | 新建/覆盖模板文件(html/css/js,≤40 万字符;可用 `assets/site.css` 这种子目录路径) | `<文件名.html\|css\|js>` + `--file <本地文件>` 或 `--content <源码>` |
445
446
  | `templates pull` | **把整套模板拉到本地目录**(按模板内相对路径落盘 + 生成 `template-manifest.json` 记 sha256;二进制按 base64 还原成真文件) | `--dir`(必填)、`--template <key\|id>`、`--force`、`--site` |
446
447
  | `templates push` | **把本地改动推回线上模板**(逐文件比 sha256;**默认只算计划、零写请求**,`--confirm` 才写;默认不删远端) | `--dir`(必填)、`--dry-run`、`--confirm`、`--prune`、`--site` |
447
- | `publish` | **发布站点**(0.5.0 起接真后端):默认 **dry-run**,只读算出会发多少页;`--confirm` 才 `cmsSitePublishStart` 并轮询 `cmsSitePublishStatus` 到终态,打印 `total/done/pagesFailed/finalizeOk` | `--site`、`--confirm`、`--cancel`、`--no-wait`、`--job <任务ID>`、`--interval`、`--wait-timeout` |
448
+ | `publish` | **发布站点**(0.5.0 起接真后端):默认 **dry-run**,只读算出会发多少页;`--confirm` 才 `cmsSitePublishStart` 并轮询 `cmsSitePublishStatus` 到终态,打印 `total/done/pagesFailed/finalizeOk`。**站点没有客户自有域名时直接拒绝**(1.1.3 起,dry-run 也拦,exit 1,一个发布请求都不发):平台预览地址 `<slug>.site.wkgeo.cn` 是动态实时渲染,内容改完即时生效,绑定域名后再发 | `--site`、`--confirm`、`--cancel`、`--no-wait`、`--job <任务ID>`、`--interval`、`--wait-timeout` |
448
449
  | `publish status` | 只看发布任务状态(只读、不触发发布) | `--site`、`--job` |
449
450
  | `publish cancel` | 取消该站正在跑的发布任务(等同 `publish --cancel`) | `--site`、`--job` |
450
451
  | `lang list` | 站点语言列表(代码 / 名称 / 是否默认 / 是否启用;需要 `site:read`) | `--site` |
package/SKILL.md CHANGED
@@ -711,7 +711,7 @@ npx -y @wkgeo/cli@latest sites create --name "我的新站" --lang zh-CN --templ
711
711
  # 读 data.siteId / data.prefixHost / data.url / data.published(steps 里每步的 ok 与耗时)
712
712
  # ℹ️ 客户(customer)层已于 2026-10-27 删除:建站不需要任何归属参数,归属固定为令牌所属用户。
713
713
  # ℹ️ 走平台通道 createSite:服务端分配池位 + 短域 + KV;池位满回 409(POOL_EXHAUSTED),
714
- # 换区再建:--region overseas(intl.wkgeo.com.cn)/ --region global。
714
+ # 换区再建:--region overseas / --region global。
715
715
  # ℹ️ --template 只认**模板市场已有的 key**(填错会列出现有 key,exit 2);不给就是空站;
716
716
  # 装完会自动启用(templateInstall → templateActivate)。
717
717
  # ℹ️ 不给 --publish 只建不发:短域还没内容(404 属正常),要上线加 --publish。
@@ -978,7 +978,7 @@ npx -y @wkgeo/cli@latest context export --format md --out ./site-context.md --si
978
978
  | `login --device-continue` 报 `kind:"expired"` | 短码过期(默认 10 分钟)或已被换过票 | 重新 `login --device --no-wait` 申请新短码;**别**反复续跑 |
979
979
  | 下单直接返回 `paid:true` | 服务端设计:下单时余额足够就直接扣款并履约 | 这是正常的"钱包支付";用 `wallet` 复核余额 |
980
980
  | `sites create` 报 400 参数错误 | 客户层已删,归属无需指定;400 只剩参数问题(名称/区域等) | 按错误提示补参数 |
981
- | `sites create` 报 409「该区域名额已满(系统正在自动扩容)」 | 该区域池位满(`POOL_EXHAUSTED`);服务端可能已先插了一行 draft 再失败 | 换区再建:`--region overseas`(intl.wkgeo.com.cn)或 `--region global`;别原地重试同一区 |
981
+ | `sites create` 报 409「该区域名额已满(系统正在自动扩容)」 | 该区域池位满(`POOL_EXHAUSTED`);服务端可能已先插了一行 draft 再失败 | 换区再建:`--region overseas` 或 `--region global`;别原地重试同一区 |
982
982
  | `sites create --template` 报「模板市场里没有…」exit 2 | `--template` 只认模板市场已有 key(内置如 `classic-blue` 默认模板 / `warm-amber`) | 按报错 hint 里的现有 key 重填;不想装模板就去掉 `--template`(空站) |
983
983
  | 短域访问 403/404 且 `sites get` 里 `prefix_kv_written:false` | 短域没写进 KV;CLI **没有** `domain repair` 命令(后端也无等价 OAuth 动作) | **别撒谎说"能访问"**:如实告诉用户短域暂不可用,用 `sites get <站点ID>` 复核 `prefix_host` / `prefix_kv_written`;`null` = 旧接口没回这个字段,让用户直接打开短域试 |
984
984
  | `domain bind` 回 exit 1 +「域名开通通道暂不可用(平台侧未开),本次未写入,可直接重试」 | 上游 `wkgeo-domain` 的内部通道没开(部署侧 `DOMAIN_INTERNAL_CHANNEL_ENABLED=false`)⇒ 服务端 503 | **如实说"没绑上、没写入"**,别当成成功;平台开通后**直接重跑同一条命令**(`domain bind` 幂等),也可以先用 `domain status` 看现状 |
@@ -1648,6 +1648,112 @@ function publishSiteOrThrow(ctx) {
1648
1648
  return site;
1649
1649
  }
1650
1650
 
1651
+ /* ---- 发布前置:自有域名闸门(口径同 CMS 的 `siteCustomDomainState`) ---- */
1652
+
1653
+ /**
1654
+ * 无自有域名时的提示 —— **一句中文说完「为什么不用发 + 下一步做什么」**。
1655
+ * 与 CMS 后台同一口径(那边 `PUBLISH_NO_CUSTOM_DOMAIN_MESSAGE` 是「请绑定自有域名后再发布」,
1656
+ * CLI 多解释一句「平台预览地址实时生效」,因为命令行用户看不到后台那张提示卡)。
1657
+ */
1658
+ const PUBLISH_NO_CUSTOM_DOMAIN_MESSAGE =
1659
+ '当前站点使用平台预览地址,内容实时生效,无需发布;请绑定自有域名后再发布';
1660
+
1661
+ /** 认「有自有域名」的 hostname_kind(与 CMS 的 SITE_PRIMARY_DOMAIN_SQL 一致,custom > root > other) */
1662
+ const PUBLISH_CUSTOM_DOMAIN_KINDS = ['custom', 'root', 'other'];
1663
+
1664
+ /** 站点行 / 域名接口上「客户自有域名」的候选列(平台面 custom_domain / CMS 面 cms_domain / 老列 domain) */
1665
+ function publishSiteDomainOf(row) {
1666
+ if (!row) return '';
1667
+ for (const key of ['custom_domain', 'cms_domain', 'domain']) {
1668
+ const text = String(row[key] || '').trim().toLowerCase();
1669
+ if (text) {
1670
+ return text.replace(/^https?:\/\//, '').replace(/\/.*$/, '');
1671
+ }
1672
+ }
1673
+ return '';
1674
+ }
1675
+
1676
+ /** `siteDomainRecords` 回包里**已验证**的客户域名(custom > root > other;同级按接口顺序 = id 升序) */
1677
+ function publishVerifiedDomainOf(payload) {
1678
+ const rows = Array.isArray(payload && payload.domains) ? payload.domains : [];
1679
+ for (const kind of PUBLISH_CUSTOM_DOMAIN_KINDS) {
1680
+ const hit = rows.find(
1681
+ (one) =>
1682
+ one &&
1683
+ String(one.verify_status || '').toLowerCase() === 'verified' &&
1684
+ String(one.hostname_kind || '').toLowerCase() === kind,
1685
+ );
1686
+ if (hit && String(hit.hostname || '').trim()) return String(hit.hostname).trim().toLowerCase();
1687
+ }
1688
+ return '';
1689
+ }
1690
+
1691
+ /**
1692
+ * 站点「有没有绑定客户自有域名」—— 判据**逐条对齐** CMS 的 `siteCustomDomainState`:
1693
+ * ① `site_domain` 里 `verify_status='verified'` 的客户域名(custom > root > other);
1694
+ * ② 回落站点行上的 `custom_domain` / `domain`(以及域名接口回的 `custom_domain`)。
1695
+ * 任一有值 ⇒ 有。
1696
+ *
1697
+ * CLI 为什么要自己判一次:`cmsSitePublishStart` 走的是 CLI 自己的调度副本
1698
+ * (`wkgeo-cli-fc`),CMS 后台那道 409 闸门管不到这条路径;不判就会白跑几百页,
1699
+ * 而客户在自有域名上一点变化也看不到。
1700
+ *
1701
+ * **fail-open**(与 CMS 同口径):两级里只要有一级**读失败**、拿不到结论,就不下"没有域名"的判断,
1702
+ * 照旧放行 —— 宁可多跑一次发布,也不能因为一次查询抖动把客户的手动发布永久封死。
1703
+ *
1704
+ * @returns {Promise<{known:boolean, hasCustomDomain:boolean, customDomain:string}>}
1705
+ */
1706
+ async function publishCustomDomainState(ctx, siteId) {
1707
+ let siteRow = null;
1708
+ let records = null;
1709
+ let readFailed = false;
1710
+ try {
1711
+ siteRow = await ctx.callData('getSite', { id: siteId });
1712
+ } catch {
1713
+ readFailed = true;
1714
+ }
1715
+ try {
1716
+ records = await ctx.callData('siteDomainRecords', { id: siteId });
1717
+ } catch {
1718
+ readFailed = true;
1719
+ }
1720
+
1721
+ const verified = publishVerifiedDomainOf(records);
1722
+ if (verified) return { known: true, hasCustomDomain: true, customDomain: verified };
1723
+
1724
+ const fallback = publishSiteDomainOf(siteRow) || publishSiteDomainOf(records);
1725
+ if (fallback) return { known: true, hasCustomDomain: true, customDomain: fallback };
1726
+
1727
+ if (readFailed) return { known: false, hasCustomDomain: true, customDomain: '' };
1728
+ return { known: true, hasCustomDomain: false, customDomain: '' };
1729
+ }
1730
+
1731
+ /**
1732
+ * 发布前拦一道:**没有客户自有域名 ⇒ 拒绝并给一句中文提示**(exit code 非 0)。
1733
+ *
1734
+ * 2026-11-09 口径:站点唯一地址 `<slug>.site.wkgeo.cn` 是动态实时渲染,
1735
+ * 内容改完立刻生效;静态发布产物只服务客户自有域名 —— 没绑域名时发布对客户没有任何可见效果。
1736
+ * `--cancel` / `publish status` 不受影响(取消永远要能用)。
1737
+ */
1738
+ async function assertPublishHasCustomDomain(ctx, site) {
1739
+ const state = await publishCustomDomainState(ctx, site.id);
1740
+ if (!state.known) {
1741
+ if (!ctx.out.json) {
1742
+ ctx.out.warn('读不到该站的自有域名状态,本次不拦发布(发完可用 `wkgeo domain records` 核对)。');
1743
+ }
1744
+ return state;
1745
+ }
1746
+ if (state.hasCustomDomain) return state;
1747
+ throw new CliError(PUBLISH_NO_CUSTOM_DOMAIN_MESSAGE, {
1748
+ kind: 'no_custom_domain',
1749
+ code: 409,
1750
+ hint:
1751
+ '平台预览地址本身实时渲染:内容改完刷新就是最新,不需要发布。' +
1752
+ '绑定自有域名后再发:CMS 后台站点设置里登记域名 → 按提示加解析 → `wkgeo domain records` 看验证状态。',
1753
+ details: { reason: 'no-custom-domain', hasCustomDomain: false },
1754
+ });
1755
+ }
1756
+
1651
1757
  async function publishJobOf(ctx, jobId) {
1652
1758
  const payload = jobId ? { jobId } : {};
1653
1759
  return (await ctx.publishCall('cmsSitePublishStatus', payload)) || {};
@@ -1738,6 +1844,7 @@ export const publishCommand = {
1738
1844
  notes: [
1739
1845
  '**站点必须显式**:`--site` 或先 `wkgeo site use <id>`;都没配就报用法错误(不猜站点)。',
1740
1846
  '不加 `--confirm` 一律 dry-run:只读 `overview` / `publishStatus` 算计划,**不发发布请求**。',
1847
+ '**没有客户自有域名会被拒**(exit 1,一个发布请求都不发):站点唯一地址是平台预览地址(动态实时渲染,内容改完立刻生效),静态发布只服务客户自有域名 —— 与 CMS 后台发布按钮同一口径;绑定域名后再发。',
1741
1848
  '真发前会打印站点名、域名、将发布页面数;需要「系统管理 / 全局配置」写权限,没有会回 403 并给权限提示。',
1742
1849
  '后端没配 `INNER_PUBLISH_SECRET` 时会 fail-closed 回 503 —— 那是服务端部署问题,不是 CLI 的错。',
1743
1850
  ],
@@ -1750,7 +1857,11 @@ export const publishCommand = {
1750
1857
  // 1) 取消分支:`--cancel` 与 `publish cancel` 同一个实现
1751
1858
  if (ctx.flags.cancel) return runPublishCancel(ctx, site, row);
1752
1859
 
1753
- // 2) 先看清现状(只读):最新任务 + 内容计数
1860
+ // 2) 前置闸门:站点没有绑定客户自有域名 ⇒ 拒绝(exit code 非 0、一个发布请求都不发)。
1861
+ // 口径同 CMS 后台的发布按钮:平台预览地址是实时渲染,发布对客户没有可见效果。
1862
+ const domainState = await assertPublishHasCustomDomain(ctx, site);
1863
+
1864
+ // 3) 先看清现状(只读):最新任务 + 内容计数
1754
1865
  let latest = {};
1755
1866
  try {
1756
1867
  latest = await publishJobOf(ctx, ctx.flags.job);
@@ -1773,11 +1884,13 @@ export const publishCommand = {
1773
1884
  : null;
1774
1885
  const estimate = counts ? counts.categories + counts.contents + 1 : null;
1775
1886
 
1776
- // 3) dry-run:把"要打哪个站、发多少页"摊开说
1887
+ // 4) dry-run:把"要打哪个站、发多少页"摊开说
1777
1888
  if (!ctx.flags.confirm) {
1778
1889
  const data = {
1779
1890
  ...publishResultData(site, row, latest, { action: 'dry_run', confirmed: false }),
1780
1891
  site_source: site.source,
1892
+ has_custom_domain: true,
1893
+ custom_domain: domainState.customDomain || '',
1781
1894
  counts,
1782
1895
  estimated_pages: estimate,
1783
1896
  };
@@ -1785,6 +1898,7 @@ export const publishCommand = {
1785
1898
  out.head('发布计划(dry-run,未发送任何发布请求)');
1786
1899
  out.line(` 站点:${data.site_name || '(未取到站名)'}(${site.id})`);
1787
1900
  out.line(` 域名:${domains.length ? domains.join('、') : '(平台没登记域名)'}`);
1901
+ out.line(` 自有域名:${domainState.customDomain || '(已绑定,平台没回具体域名)'}`);
1788
1902
  if (counts) {
1789
1903
  out.line(
1790
1904
  ` 内容:栏目 ${counts.categories} 个 | 内容 ${counts.contents} 条(已发布 ${counts.published} / 草稿 ${counts.drafts})`,
@@ -1802,7 +1916,7 @@ export const publishCommand = {
1802
1916
  return data;
1803
1917
  }
1804
1918
 
1805
- // 4) 真发
1919
+ // 5) 真发
1806
1920
  if (!out.json) {
1807
1921
  out.head(`开始发布:${(row && row.name) || site.label || site.id}`);
1808
1922
  out.line(` 站点:${site.id}`);
@@ -2032,6 +2146,8 @@ export const publishRetryCommand = {
2032
2146
  const { out } = ctx;
2033
2147
  const site = publishSiteOrThrow(ctx);
2034
2148
  const row = await publishSiteRow(ctx, site.id);
2149
+ // 重发同样是"真发",先过同一道前置闸门(没有自有域名 ⇒ 拒绝,见 publishCommand)
2150
+ await assertPublishHasCustomDomain(ctx, site);
2035
2151
  const previous = await publishJobOf(ctx, ctx.flags.job).catch(() => ({}));
2036
2152
  const active = previous.status === 'queued' || previous.status === 'running';
2037
2153
  if (active) {
@@ -16,10 +16,11 @@
16
16
  import { camel } from '../args.mjs';
17
17
  import { CliError, EXIT, UsageError } from '../errors.mjs';
18
18
  import { maskPii, maskPiiDeep, formatTime } from '../format.mjs';
19
+ import { PLATFORM_WEB_ORIGIN } from '../hosts.mjs';
19
20
  import { openUrlForUser } from '../login.mjs';
20
21
 
21
22
  /** 表单后台函数(`wkgeo-plugin-contact-form`)认的来源;不给会被 `checkAdminOrigin` 403 */
22
- const FORM_ORIGIN = 'https://wkgeo.cn';
23
+ const FORM_ORIGIN = PLATFORM_WEB_ORIGIN;
23
24
 
24
25
  const SITE_FLAG = {
25
26
  site: { type: 'string', desc: '站点 ID(默认用 `wkgeo site use` 选中的站点,可用 WKONGAI_SITE 覆盖)' },
@@ -824,7 +825,7 @@ export const previewCommand = {
824
825
  },
825
826
  examples: ['wkgeo preview /about/', 'wkgeo preview news/2026/ --site <站点ID> --open'],
826
827
  notes: [
827
- '地址形如 `https://wkgeo.cn/cms/preview/<站点ID>/<路径>`,走预览通道:**看的是草稿态**,不影响线上。',
828
+ `地址形如 \`${PLATFORM_WEB_ORIGIN}/cms/preview/<站点ID>/<路径>\`,走预览通道:**看的是草稿态**,不影响线上。`,
828
829
  '零后端调用:只拼字符串,不产生任何写操作。',
829
830
  '`--open` 用的是系统默认浏览器;CI / 非交互环境会自动跳过(不会卡住)。',
830
831
  ],
@@ -836,7 +837,7 @@ export const previewCommand = {
836
837
  rel = rel.replace(/^https?:\/\/[^/]+/i, '');
837
838
  rel = rel.replace(/^\/+/, '');
838
839
 
839
- const url = `https://wkgeo.cn/cms/preview/${site.id}/${rel}`;
840
+ const url = `${PLATFORM_WEB_ORIGIN}/cms/preview/${site.id}/${rel}`;
840
841
  const payload = { site_id: site.id, path: `/${rel}`, url };
841
842
 
842
843
  if (!out.json) {
@@ -33,6 +33,7 @@
33
33
 
34
34
  import { CliError, UsageError } from '../errors.mjs';
35
35
  import { formatTime } from '../format.mjs';
36
+ import { SITE_PREVIEW_SUFFIX } from '../hosts.mjs';
36
37
  import { readSiteState } from '../site-state.mjs';
37
38
  import { runSiteCreate } from '../site-create.mjs';
38
39
  import { rememberSite } from './cms.mjs';
@@ -682,7 +683,7 @@ export const sitesGetCommand = {
682
683
  'wkgeo sites get <站点ID> --json # 机器可读:site + detail 全量标量字段',
683
684
  ],
684
685
  notes: [
685
- '`prefix_host` = 平台分配的短域(`<名字>.<地区>.wkgeo.com.cn`),`custom_domain` = 你自己登记的域名;**两套解析**,短域打不开不代表自有域名没配好,反之亦然。',
686
+ `\`prefix_host\` = 平台分配的站点短域(2026-11-09 起**唯一地址** = \`<slug>.${SITE_PREVIEW_SUFFIX}\`),\`custom_domain\` = 你自己登记的域名;**两套解析**,短域打不开不代表自有域名没配好,反之亦然。`,
686
687
  '`provision_state`:`none` 没进过开通流程 / `provisioning` 开通中 / `active` 已开通 / `failed` 失败;卡在哪一步看 `provision_step`。',
687
688
  '`settings` / `theme` / `layout` / `info` / `template_config` 这几个大 JSON 块**不输出**(可能存第三方 Key),要看去 CMS 后台;其余 `getSite` 字段全部在 `--json` 的 `detail` 里。',
688
689
  ],
@@ -757,7 +758,7 @@ export const sitesCreateCommand = {
757
758
  template: { type: 'string', desc: '模板市场里的模板 key(可选;不传就是空站)' },
758
759
  publish: { type: 'boolean', desc: '建完立即发布,并实测短域首页(HTTP 码 / 字节 / 标题)' },
759
760
  'dry-run': { type: 'boolean', desc: '只打印计划:不建站、不写库、不写 OSS' },
760
- region: { type: 'string', desc: '区域/池位:domestic(默认,cn1)/ overseas(intl)/ global;国内池满了换 overseas' },
761
+ region: { type: 'string', desc: `区域/池位:domestic(默认)/ overseas / global(只决定池位,站点地址恒为 <slug>.${SITE_PREVIEW_SUFFIX});国内池满了换 overseas` },
761
762
  },
762
763
  examples: [
763
764
  'wkgeo sites create --name 我的站 --lang zh-CN',
@@ -728,7 +728,7 @@ export const templateValidateCommand = {
728
728
  args: [],
729
729
  flags: {
730
730
  dir: { type: 'string', desc: '模板目录' },
731
- base: { type: 'string', desc: '_base 目录(默认自动找 templates/_base;用于 assets/base 逐字节比对)' },
731
+ base: { type: 'string', desc: '基础库目录(默认自动找 templates/base;用于 assets/base 逐字节比对)' },
732
732
  'no-design': { type: 'boolean', desc: '不要求 design/ 截图(只适合自查,pack 仍会要求)' },
733
733
  },
734
734
  examples: ['wkgeo template validate --dir ./tpl/qbk-mirror', 'wkgeo template validate --dir ./tpl/demo --json'],
@@ -783,7 +783,7 @@ export const templatePackCommand = {
783
783
  },
784
784
  examples: ['wkgeo template pack --dir ./tpl/qbk-mirror', 'wkgeo template pack --dir ./tpl/qbk-mirror --out .tmp-build/t142/qbk.zip'],
785
785
  notes: [
786
- '打包前把 `templates/_base/assets/**` 逐字节同步到 `<模板>/assets/base/`(§3 约定,validate/pack 都查)。',
786
+ '打包前把 `templates/base/assets/**` 逐字节同步到 `<模板>/assets/base/`(§3 约定,validate/pack 都查)。',
787
787
  'zip 内必有:template.json、pages/、partials/、assets/(含 assets/base/base.css)、design/*.png。',
788
788
  'zip 自己写(zlib deflateRaw + 自算 CRC32):不 npm install、不依赖外部 archiver。',
789
789
  ],
package/lib/config.mjs CHANGED
@@ -16,6 +16,7 @@ import path from 'node:path';
16
16
  import { readFileSync } from 'node:fs';
17
17
 
18
18
  import { UsageError } from './errors.mjs';
19
+ import { PLATFORM_WEB_ORIGIN } from './hosts.mjs';
19
20
 
20
21
  /**
21
22
  * 线上 API 基址(业务接口 `/api/data`、OAuth 服务端 `/api/oauth/*` 都在这个域下)。
@@ -77,9 +78,9 @@ export const DEFAULT_CMS_BASE = 'https://api.wkgeo.cn/cms';
77
78
  * ⇒ 所以统一走 `oauth-urls.mjs` 的 `canonicalOauthUrl()`:
78
79
  * **这里(配置基址)是 canonical,服务端只提供路径**。
79
80
  */
80
- export const DEFAULT_OAUTH_WEB_BASE = 'https://wkgeo.cn/oauth';
81
+ export const DEFAULT_OAUTH_WEB_BASE = `${PLATFORM_WEB_ORIGIN}/oauth`;
81
82
  export const DEFAULT_PAY_WEB_BASE = 'https://pay.wkgeo.cn';
82
- export const DEFAULT_USER_WEB_BASE = 'https://wkgeo.cn/user';
83
+ export const DEFAULT_USER_WEB_BASE = `${PLATFORM_WEB_ORIGIN}/user`;
83
84
 
84
85
  /**
85
86
  * ⚠️ 兼容保留:老站(管理端)基址。
package/lib/hosts.mjs ADDED
@@ -0,0 +1,37 @@
1
+ /**
2
+ * 平台地址常量 —— **CLI 侧唯一源**(`cli/**` 里再出现 `https://<平台域>` 字面量就是错的)。
3
+ *
4
+ * ## 为什么 CLI 自己留一份,而不是 `import` 仓库级常量
5
+ * CLI 是**独立发包**的 npm 包(`@wkgeo/cli`,`files` 只含 `lib/`,`dependencies` 为空):
6
+ * 装到别人机器上之后没有仓库上下文,
7
+ * * `share/platform-hosts`(前端侧唯一源)是仓库内的相对路径,跨包引用在 npm 包里直接 404;
8
+ * * `aliyun/fc/_shared/platform-hosts.js`(云函数侧唯一源)同样进不了包。
9
+ * ⇒ CLI 侧自己保留**一份**:**只在本文件写域名**,`config.mjs` 的三个 Web 基址、
10
+ * 预览地址、manifest 的 schema `$id`、模板抓取 UA 全部由它派生。
11
+ * 换域(`.com` → `.cn` 这类)只改下面的 `PLATFORM_DOMAIN` 一行,其余自动跟随。
12
+ *
13
+ * ⚠️ 与检查器的关系(`tools/check-hardcoded-domains.mjs` 的 `url` 规则):
14
+ * 那条规则要求「`https://` + 域名**连写**」才算硬编码。这里先给根域、再拼 scheme,
15
+ * 不是为了绕过检查,而是**把域名收敛成一行**:本文件是 CLI 侧的唯一出处,
16
+ * 业务代码一律 `import { PLATFORM_WEB_ORIGIN }`,不许各自拼字符串。
17
+ */
18
+
19
+ /**
20
+ * 平台根域(**裸域**,不带 scheme,不含任何子域)。
21
+ * 2026-11-09 老板定:`wkgeo.com` 已无 A 记录、全面退役,默认一律 `.cn`。
22
+ */
23
+ export const PLATFORM_DOMAIN = 'wkgeo.cn';
24
+
25
+ /** 平台 Web 源(主站 `https://wkgeo.cn`;`/cms`、`/user`、`/oauth` 都挂在它下面) */
26
+ export const PLATFORM_WEB_ORIGIN = `https://${PLATFORM_DOMAIN}`;
27
+
28
+ /** CMS 后台源(客户站工作台,`<web>/cms/`;CMS 接口基址另有 `config.DEFAULT_CMS_BASE`) */
29
+ export const PLATFORM_CMS_ORIGIN = `${PLATFORM_WEB_ORIGIN}/cms`;
30
+
31
+ /**
32
+ * 客户站预览短域后缀:站点对外**唯一地址** = `<slug>.` + 它(即 `<slug>.site.wkgeo.cn`)。
33
+ *
34
+ * 2026-11-09 起池短域(`*.cn1 / *.intl / *.global.wkgeo.com.cn`)整体退役,
35
+ * 只剩这一套;说明文案 / 帮助文本要举例站点地址时一律引用它,别再手写。
36
+ */
37
+ export const SITE_PREVIEW_SUFFIX = `site.${PLATFORM_DOMAIN}`;
package/lib/manifest.mjs CHANGED
@@ -28,6 +28,7 @@ import fs from 'node:fs';
28
28
  import path from 'node:path';
29
29
 
30
30
  import { ASSET_ROLES, inferAssetRole, normalizeAssetRole } from './asset-role.mjs';
31
+ import { PLATFORM_WEB_ORIGIN } from './hosts.mjs';
31
32
 
32
33
  /* `ASSET_ROLES` / `inferAssetRole` 从本文件对外也是契约的一部分(文档与测试照着这里写) */
33
34
  export { ASSET_ROLES, inferAssetRole, normalizeAssetRole };
@@ -1034,7 +1035,7 @@ export function manifestJsonSchema() {
1034
1035
 
1035
1036
  return {
1036
1037
  $schema: 'http://json-schema.org/draft-07/schema#',
1037
- $id: 'https://wkgeo.cn/schema/wkgeo-site-manifest@1.json',
1038
+ $id: `${PLATFORM_WEB_ORIGIN}/schema/wkgeo-site-manifest@1.json`,
1038
1039
  title: 'wkgeo-site-manifest@1',
1039
1040
  description:
1040
1041
  'A(agent)→ 平台的建站内容契约:A 交这份 manifest,`wkgeo content apply --file <它>` 负责校验、幂等落库、按需发布。' +
@@ -13,6 +13,7 @@
13
13
 
14
14
  import { CliError, UsageError } from './errors.mjs';
15
15
  import { resolveConfig } from './config.mjs';
16
+ import { SITE_PREVIEW_SUFFIX } from './hosts.mjs';
16
17
  import { createCms } from './cms.mjs';
17
18
 
18
19
  /* ------------------------------------------------------------------ 常量 */
@@ -26,8 +27,9 @@ export const LANGS = Object.freeze([
26
27
  const DEFAULT_LANG = 'zh-CN';
27
28
 
28
29
  /**
29
- * 区域(决定池位与短域后缀):domestic → `cn1.wkgeo.com.cn`、overseas → `intl.wkgeo.com.cn`、
30
- * global → `global.wkgeo.com.cn`。**不给就 domestic**(平台默认池)。
30
+ * 区域(只决定**池位**):domestic / overseas / global。**不给就 domestic**(平台默认池)。
31
+ * 2026-11-09 起池短域整体退役:站点对外**唯一地址** = `<站点名 slug>.site.wkgeo.cn`,
32
+ * 与区域无关(不再有 `.cn1 / .intl / .global` 后缀)。
31
33
  * 池位满了服务端回 409「该区域名额已满」——这时换 `--region overseas` 是有用的逃生门。
32
34
  */
33
35
  export const REGIONS = Object.freeze([
@@ -72,7 +74,7 @@ export function normalizeRegion(value) {
72
74
  if (one.code === low || one.alias.includes(low)) return one.code;
73
75
  }
74
76
  throw new UsageError(`--region 只支持 ${REGIONS.map((one) => one.code).join(' / ')},收到:${raw}`, {
75
- hint: 'domestic=国内池(cn1.wkgeo.com.cn)/ overseas=海外池(intl.wkgeo.com.cn)/ global=全球池;不传默认 domestic。',
77
+ hint: `domestic=国内池 / overseas=海外池 / global=全球池;站点地址恒为 <slug>.${SITE_PREVIEW_SUFFIX},跟区域无关;不传默认 domestic。`,
76
78
  });
77
79
  }
78
80
 
@@ -407,7 +409,7 @@ export async function runSiteCreate(ctx, flags) {
407
409
  if (/POOL_EXHAUSTED|名额已满/.test(msg)) {
408
410
  /* 409 在通用分类里会落到 kind:'unknown',这里补成可读的 kind,便于 AI 端按类型分支 */
409
411
  if (e && (!e.kind || e.kind === 'unknown')) e.kind = 'pool_exhausted';
410
- e.hint = [e.hint, `该区域池位满了:加 \`--region overseas\`(intl.wkgeo.com.cn)或 \`--region global\` 再建。`].filter(Boolean).join(' | ');
412
+ e.hint = [e.hint, '该区域池位满了:加 `--region overseas` 或 `--region global` 再建。'].filter(Boolean).join(' | ');
411
413
  }
412
414
  throw e;
413
415
  }
@@ -6,7 +6,7 @@
6
6
  * `assets/` 下的 `.css` 与 `.js` 里抽四类东西:
7
7
  * `@keyframes` 名与帧;`animation` / `transition` 声明与长写;滚动入场
8
8
  * (`data-reveal` / IntersectionObserver / class 切换);`transform` 的位移/缩放/旋转与延迟时长。
9
- * 2. **映射**:每条动画尽量落到 `templates/_base` **已有**的类名/属性/变量上
9
+ * 2. **映射**:每条动画尽量落到 `templates/base` **已有**的类名/属性/变量上
10
10
  * (`[data-reveal]` + `data-delay` / `.anim-float` / `.anim-pulse` / `.anim-gradient` /
11
11
  * `.anim-shine` / `[data-kenburns]` / `.marquee` / `[data-parallax]`),**不新造体系**;
12
12
  * 落不下去的标 `unmapped` 并写清原因。
@@ -14,7 +14,7 @@
14
14
  * 给出命中 / 缺失 / 多余;缺失与多余都影响退出码。
15
15
  *
16
16
  * ## 为什么清单要单独一个文件
17
- * `templates/_base` 本轮**只读**,`template.json` 的 v2 字段表也不能随便加键,
17
+ * `templates/base` 本轮**只读**,`template.json` 的 v2 字段表也不能随便加键,
18
18
  * 所以清单落在 `design/animations.json`(随模板包一起分发),几何证据落在
19
19
  * `design/animations.geom.json`(Chrome 实测的元素矩形,用来把像素区域归因到具体动画)。
20
20
  *
@@ -341,7 +341,7 @@ export function motionOfFrames(frames = []) {
341
341
  // ---------------------------------------------------------------- 映射到 _base
342
342
 
343
343
  /**
344
- * `templates/_base` 已有的动效(只读,不新造):
344
+ * `templates/base` 已有的动效(只读,不新造):
345
345
  * `.anim-float` / `.anim-pulse` / `.anim-gradient` / `.anim-shine` / `[data-kenburns]` /
346
346
  * `.marquee` + `.marquee__track` / `[data-reveal]` + `data-delay` / `[data-parallax]`。
347
347
  */
@@ -416,7 +416,7 @@ export function mapToBase(entry) {
416
416
  };
417
417
  const bucket = delayBucket(entry.timing.delayMs);
418
418
  if (bucket) base.attrs['data-delay'] = String(bucket);
419
- if (entry.entryFrom === 'js') base.js = '由 `_base/assets/base.js` 的 IntersectionObserver 加 `.is-visible`,不需要模板自带 JS';
419
+ if (entry.entryFrom === 'js') base.js = '由 `templates/base/assets/base.js` 的 IntersectionObserver 加 `.is-visible`,不需要模板自带 JS';
420
420
  return { status: deltas.length ? 'alias' : 'exact', base, deltas };
421
421
  }
422
422
  if (kind === 'parallax') {
@@ -973,7 +973,7 @@ export function extractAnimations({ key = null, page = '/pages/index.html', css
973
973
  page,
974
974
  generatedAt: new Date().toISOString(),
975
975
  source: { css: css.map((c) => c.file), js: js.map((j) => j.file), html: html.map((h) => h.file) },
976
- base: { library: 'templates/_base', vocabulary: Object.keys(BASE_MAP) },
976
+ base: { library: 'templates/base', vocabulary: Object.keys(BASE_MAP) },
977
977
  signals,
978
978
  counts,
979
979
  animations,
@@ -12,7 +12,7 @@
12
12
  * from-dir 是同一套流程换成本地静态目录:读本地 HTML、把被引用的本地资源收进 `assets/`、
13
13
  * 反过来从 `<nav>` / `<title>` / 卡片标题推出 v2 `template.json`(栏目 / 菜单 / 字段 / 演示数据)。
14
14
  *
15
- * ## 产出(v2 口径,见 templates/_base/README.md §3 §4)
15
+ * ## 产出(v2 口径,见 templates/base/README.md §3 §4)
16
16
  * ```
17
17
  * <out>/
18
18
  * template.json _format=wkgeo-template@2 / key / site / menus / columns / requires / data
@@ -31,6 +31,7 @@ import crypto from 'node:crypto';
31
31
  import { fileURLToPath } from 'node:url';
32
32
 
33
33
  import { CliError, UsageError } from './errors.mjs';
34
+ import { PLATFORM_WEB_ORIGIN } from './hosts.mjs';
34
35
  import { VIEWPORTS, captureDesign, inspectDesign, resolveChrome } from './template-capture.mjs';
35
36
 
36
37
  export const TEMPLATE_FORMAT = 'wkgeo-template@2';
@@ -158,7 +159,7 @@ export function normalizeSiteUrl(input) {
158
159
  return u;
159
160
  }
160
161
 
161
- const UA = 'wkgeo-cli-template/1.0 (+https://wkgeo.cn)';
162
+ const UA = `wkgeo-cli-template/1.0 (+${PLATFORM_WEB_ORIGIN})`;
162
163
 
163
164
  async function fetchBuffer(url, { fetchImpl, timeoutMs = 30000, referer = null } = {}) {
164
165
  const f = fetchImpl || globalThis.fetch;
@@ -205,28 +206,37 @@ function wrapFetchError(url, err, timeoutMs) {
205
206
  return new CliError(`抓取失败:${url}\n 原因:${msg}\n ${hint}`, { kind: 'fetch', code: 'EFETCH', cause: err });
206
207
  }
207
208
 
208
- // ---------------------------------------------------------------- 定位 _base
209
+ // ---------------------------------------------------------------- 定位基础库
209
210
 
210
211
  /**
211
- * 找 `templates/_base`(只读引用):显式参数 > 环境变量 > 从 cwd 往上找 > 从本文件往上找。
212
+ * 找基础库宿主目录(只读引用):显式参数 > 环境变量 > 从 cwd 往上找 > 从本文件往上找。
213
+ *
214
+ * 2026-11-09 起基础库并入**模板 `templates/base/assets/`**(老板:"`_base` 不应该有,
215
+ * 他就是 base 的 assets 里的 js css")。老结构 `templates/_base/` 已删除,但这里仍保留
216
+ * 一档回落,避免有人从旧分支/旧分发目录里跑命令时直接崩。
212
217
  * 找不到就返回 null(validate 会降级为"只查 assets/base 存在")。
213
218
  */
214
219
  export function resolveBaseDir(explicit, { cwd = process.cwd(), env = process.env } = {}) {
215
- const ok = (dir) => dir && fs.existsSync(path.join(dir, 'assets', 'base.css'));
220
+ const ok = (dir) => dir && fs.existsSync(path.join(dir, 'assets', 'base.css')) && fs.existsSync(path.join(dir, 'components.json'));
221
+ const candidates = ['templates/base', path.join('templates', '_base')];
216
222
  if (ok(explicit)) return path.resolve(explicit);
217
223
  if (ok(env.WKGEO_BASE_TEMPLATE)) return path.resolve(env.WKGEO_BASE_TEMPLATE);
218
224
  let dir = path.resolve(cwd);
219
225
  for (let i = 0; i < 8; i++) {
220
- const cand = path.join(dir, 'templates', '_base');
221
- if (ok(cand)) return cand;
226
+ for (const rel of candidates) {
227
+ const cand = path.join(dir, rel);
228
+ if (ok(cand)) return cand;
229
+ }
222
230
  const parent = path.dirname(dir);
223
231
  if (parent === dir) break;
224
232
  dir = parent;
225
233
  }
226
234
  dir = HERE;
227
235
  for (let i = 0; i < 8; i++) {
228
- const cand = path.join(dir, 'templates', '_base');
229
- if (ok(cand)) return cand;
236
+ for (const rel of candidates) {
237
+ const cand = path.join(dir, rel);
238
+ if (ok(cand)) return cand;
239
+ }
230
240
  const parent = path.dirname(dir);
231
241
  if (parent === dir) break;
232
242
  dir = parent;
@@ -234,14 +244,47 @@ export function resolveBaseDir(explicit, { cwd = process.cwd(), env = process.en
234
244
  return null;
235
245
  }
236
246
 
237
- /** `assets/base/` = `_base/assets/` 的逐字节副本 */
247
+ /**
248
+ * 基础库里**属于库**的文件(相对 `<基础库目录>/assets/` 的路径)。
249
+ * `style.css` / `page.css` 是 `templates/base/` **自己的皮肤**,与库文件同住在 assets/ 下,
250
+ * 同步到别的模板时必须排除(它们不是"所有模板都该有"的东西)。
251
+ */
252
+ const BASE_LIB_SKIN_FILES = new Set(['style.css', 'page.css']);
253
+
254
+ /** 递归列出基础库 assets 下要同步的文件(相对路径,posix 风格) */
255
+ export function listBaseAssetFiles(baseDir) {
256
+ const root = path.join(baseDir, 'assets');
257
+ const out = [];
258
+ const walk = (rel) => {
259
+ for (const ent of fs.readdirSync(path.join(root, rel), { withFileTypes: true })) {
260
+ const childRel = rel ? `${rel}/${ent.name}` : ent.name;
261
+ if (ent.isDirectory()) {
262
+ walk(childRel);
263
+ continue;
264
+ }
265
+ if (!rel && BASE_LIB_SKIN_FILES.has(ent.name)) continue;
266
+ out.push(childRel);
267
+ }
268
+ };
269
+ walk('');
270
+ return out.sort();
271
+ }
272
+
273
+ /** `assets/base/` = 基础库 `templates/base/assets/` 的逐字节副本(不含宿主模板的皮肤文件) */
238
274
  export async function syncBaseAssets(outDir, baseDir) {
239
275
  const dest = path.join(outDir, 'assets', 'base');
240
- if (!baseDir) return { copied: false, reason: '没找到 templates/_base(跳过 assets/base 同步)' };
276
+ if (!baseDir) {
277
+ return { copied: false, reason: '没找到基础库(templates/base/assets 或老的 templates/_base)——跳过 assets/base 同步' };
278
+ }
241
279
  await fsp.mkdir(path.dirname(dest), { recursive: true });
242
280
  await fsp.rm(dest, { recursive: true, force: true });
243
- await fsp.cp(path.join(baseDir, 'assets'), dest, { recursive: true });
244
- return { copied: true, from: path.join(baseDir, 'assets'), to: dest };
281
+ const list = listBaseAssetFiles(baseDir);
282
+ for (const rel of list) {
283
+ const to = path.join(dest, ...rel.split('/'));
284
+ await fsp.mkdir(path.dirname(to), { recursive: true });
285
+ await fsp.copyFile(path.join(baseDir, 'assets', ...rel.split('/')), to);
286
+ }
287
+ return { copied: true, from: path.join(baseDir, 'assets'), to: dest, files: list.length };
245
288
  }
246
289
 
247
290
  const PLACEHOLDER_SVG =
@@ -7,7 +7,7 @@
7
7
  * UTF-8 文件名标志位 0x0800、中央目录齐全),解压工具(PowerShell Expand-Archive / 7-Zip)都认。
8
8
  *
9
9
  * ## 打包前
10
- * 1. 把 `templates/_base/assets/**` **逐字节**同步进 `<模板>/assets/base/`(§3 基础库同步规则);
10
+ * 1. 把 `templates/base/assets/**` **逐字节**同步进 `<模板>/assets/base/`(§3 基础库同步规则);
11
11
  * 2. 跑 9 关校验(`template-validate.mjs`),**不合格不出包**(exit 1)。
12
12
  *
13
13
  * 包内结构:`template.json`、`pages/`、`partials/`、`assets/`(含 `assets/base/`)、`design/`。
@@ -161,7 +161,7 @@ export async function packTemplate({ dir, out = null, base = null, cwd = process
161
161
  // 1) 基础库逐字节同步
162
162
  const baseDir = resolveBaseDir(base, { cwd });
163
163
  const baseSync = await syncBaseAssets(root, baseDir);
164
- if (!baseSync.copied) say(`! 没找到 templates/_base:${baseSync.reason}`);
164
+ if (!baseSync.copied) say(`! 没找到基础库(templates/base/assets):${baseSync.reason}`);
165
165
 
166
166
  // 2) 9 关校验(不合格不出包)
167
167
  say('跑 9 关校验…');
@@ -26,6 +26,7 @@ import path from 'node:path';
26
26
  import crypto from 'node:crypto';
27
27
 
28
28
  import { CliError } from './errors.mjs';
29
+ import { PLATFORM_WEB_ORIGIN } from './hosts.mjs';
29
30
 
30
31
  /** 市场表(发布上游:模板市场) */
31
32
  export const MARKET_TABLE = 'public.cms_template_market';
@@ -637,7 +638,7 @@ export async function publishTemplate({
637
638
  }
638
639
  let previewCheck = null;
639
640
  if (preview) {
640
- const url = `https://wkgeo.cn/cms/template/preview?key=${encodeURIComponent(collected.key)}&device=desktop`;
641
+ const url = `${PLATFORM_WEB_ORIGIN}/cms/template/preview?key=${encodeURIComponent(collected.key)}&device=desktop`;
641
642
  try {
642
643
  const res = await fetchImpl(url, { method: 'GET', redirect: 'follow' });
643
644
  const body = Buffer.from(await res.arrayBuffer());
@@ -1,7 +1,7 @@
1
1
  /**
2
2
  * 模板校验(9 关)——`wkgeo template validate` 与 `pack` 共用同一套门禁。
3
3
  *
4
- * 口径来源:`templates/_base/README.md` §1(12 种字段类型 / 8 个字段键)、§3(目录约定)、
4
+ * 口径来源:`templates/base/README.md` §1(12 种字段类型 / 8 个字段键)、§3(目录约定)、
5
5
  * §4(v2 字段表)、§5(禁止事项)。**这里不另创规则**,每条门禁都能指回 README 的哪一节。
6
6
  *
7
7
  * 9 关:
@@ -11,7 +11,7 @@
11
11
  * 4. menus menus.top 非空,项字段与 menu_type/link_type 枚举合法(§1)
12
12
  * 5. columns ≥1 个栏目;12 个栏键齐全;fields 8 键齐全且 type ∈ 12 种;items 与 fields 对齐(§1 §4)
13
13
  * 6. pages pages/index.html 存在;columns[].page 都有对应文件;每页有 <title>(§3)
14
- * 7. base assets/base/ 存在,且能找到 `templates/_base` 时逐字节一致(§3)
14
+ * 7. base assets/base/ 存在,且能找到基础库(`templates/base/assets/`)时逐字节一致(§3)
15
15
  * 8. links 页面引用的本地 CSS/JS/图片都在;资源类标签不得走外网(§5.2)
16
16
  * 9. design design/desktop-1440.png 与 mobile-375.png 尺寸正确(t0/t1500 帧可选但建议有)
17
17
  */
@@ -23,7 +23,7 @@ import path from 'node:path';
23
23
  import { CliError, EXIT } from './errors.mjs';
24
24
  import { readPngSize } from './template-capture.mjs';
25
25
  import { VIEWPORTS } from './template-capture.mjs';
26
- import { TEMPLATE_FORMAT, resolveBaseDir } from './template-gen.mjs';
26
+ import { TEMPLATE_FORMAT, resolveBaseDir, listBaseAssetFiles } from './template-gen.mjs';
27
27
 
28
28
  export const FIELD_TYPES = ['text', 'textarea', 'richtext', 'image', 'gallery', 'date', 'number', 'select', 'link', 'phone', 'email', 'boolean'];
29
29
  export const FIELD_KEYS = ['key', 'label', 'type', 'required', 'options', 'group', 'sort', 'hint'];
@@ -47,12 +47,13 @@ async function walkFiles(root, out = [], skip = new Set(['node_modules', '.git']
47
47
  }
48
48
 
49
49
  /** 逐字节比较两个目录(相对路径集合 + 每个文件内容) */
50
- export async function compareTrees(a, b) {
50
+ export async function compareTrees(a, b, opts = {}) {
51
+ const only = opts.only instanceof Set ? opts.only : Array.isArray(opts.only) ? new Set(opts.only) : null;
51
52
  const fa = await walkFiles(a);
52
53
  const fb = await walkFiles(b);
53
54
  const rel = (root, list) => new Map(list.map((f) => [path.relative(root, f).replace(/\\/g, '/'), f]));
54
- const ma = rel(a, fa);
55
- const mb = rel(b, fb);
55
+ const ma = new Map([...rel(a, fa)].filter(([k]) => !only || only.has(k)));
56
+ const mb = new Map([...rel(b, fb)].filter(([k]) => !only || only.has(k)));
56
57
  const missing = [...ma.keys()].filter((k) => !mb.has(k));
57
58
  const extra = [...mb.keys()].filter((k) => !ma.has(k));
58
59
  const different = [];
@@ -270,11 +271,16 @@ export async function validateTemplate({ dir, base = null, cwd = process.cwd(),
270
271
  const dest = path.join(root, 'assets', 'base');
271
272
  const baseDir = resolveBaseDir(base, { cwd });
272
273
  if (!fs.existsSync(dest)) {
273
- errors.push('缺少 assets/base/(应从 templates/_base/assets 逐字节复制)');
274
+ errors.push('缺少 assets/base/(应从 templates/base/assets 逐字节复制)');
274
275
  } else if (!fs.existsSync(path.join(dest, 'base.css'))) {
275
276
  errors.push('assets/base/ 里没有 base.css');
276
277
  } else if (baseDir) {
277
- const cmp = await compareTrees(path.join(baseDir, 'assets'), dest);
278
+ /**
279
+ * 只比**库文件**:2026-11-09 起基础库住在 `templates/base/assets/`,同目录里还躺着
280
+ * base 模板自己的皮肤 `style.css`(不是库文件、别的模板不该有),所以按
281
+ * `listBaseAssetFiles()` 给的清单逐字节比,不整目录比。
282
+ */
283
+ const cmp = await compareTrees(path.join(baseDir, 'assets'), dest, { only: listBaseAssetFiles(baseDir) });
278
284
  if (!cmp.ok) {
279
285
  const bits = [];
280
286
  if (cmp.missing.length) bits.push(`缺 ${cmp.missing.length} 个(${cmp.missing.slice(0, 3).join(', ')})`);
@@ -283,7 +289,7 @@ export async function validateTemplate({ dir, base = null, cwd = process.cwd(),
283
289
  errors.push(`assets/base/ 与 ${baseDir}/assets 不是逐字节副本:${bits.join(';')}`);
284
290
  }
285
291
  } else {
286
- warnings.push('没找到 templates/_base,只校验了 assets/base 的存在性');
292
+ warnings.push('没找到基础库(templates/base/assets),只校验了 assets/base 的存在性');
287
293
  }
288
294
  add('base', 'assets/base 基础库副本', errors, warnings);
289
295
  }
@@ -229,7 +229,7 @@ export async function verifyTemplate({
229
229
 
230
230
  const chrome = resolveChrome(chromeExe);
231
231
  const baseDir = resolveBaseDir(null, {});
232
- if (!baseDir) say('提示:没找到 templates/_base(不影响比对)');
232
+ if (!baseDir) say('提示:没找到基础库 templates/base/assets(不影响比对)');
233
233
 
234
234
  const out =
235
235
  outDir ||
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@wkgeo/cli",
3
- "version": "1.1.2",
3
+ "version": "1.1.3",
4
4
  "description": "云站平台官方命令行客户端(@wkgeo/cli):授权登录一次,之后建站 / 下单 / 钱包支付 / 查余额都不用再登录(OAuth 授权码 + PKCE,公共客户端,零第三方依赖)",
5
5
  "keywords": [
6
6
  "wkgeo",