@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 +18 -0
- package/README.md +3 -2
- package/SKILL.md +2 -2
- package/lib/commands/cms.mjs +119 -3
- package/lib/commands/siteops.mjs +4 -3
- package/lib/commands/sites.mjs +3 -2
- package/lib/commands/template.mjs +2 -2
- package/lib/config.mjs +3 -2
- package/lib/hosts.mjs +37 -0
- package/lib/manifest.mjs +2 -1
- package/lib/site-create.mjs +6 -4
- package/lib/template-anim.mjs +5 -5
- package/lib/template-gen.mjs +56 -13
- package/lib/template-pack.mjs +2 -2
- package/lib/template-publish.mjs +2 -1
- package/lib/template-validate.mjs +15 -9
- package/lib/template-verify.mjs +1 -1
- package/package.json +1 -1
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.
|
|
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
|
|
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
|
|
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` 看现状 |
|
package/lib/commands/cms.mjs
CHANGED
|
@@ -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
|
-
//
|
|
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
|
-
//
|
|
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) {
|
package/lib/commands/siteops.mjs
CHANGED
|
@@ -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 =
|
|
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
|
-
|
|
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 =
|
|
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) {
|
package/lib/commands/sites.mjs
CHANGED
|
@@ -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
|
-
|
|
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:
|
|
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: '
|
|
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/
|
|
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 =
|
|
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 =
|
|
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:
|
|
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 <它>` 负责校验、幂等落库、按需发布。' +
|
package/lib/site-create.mjs
CHANGED
|
@@ -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
|
-
*
|
|
30
|
-
*
|
|
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:
|
|
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,
|
|
412
|
+
e.hint = [e.hint, '该区域池位满了:加 `--region overseas` 或 `--region global` 再建。'].filter(Boolean).join(' | ');
|
|
411
413
|
}
|
|
412
414
|
throw e;
|
|
413
415
|
}
|
package/lib/template-anim.mjs
CHANGED
|
@@ -6,7 +6,7 @@
|
|
|
6
6
|
* `assets/` 下的 `.css` 与 `.js` 里抽四类东西:
|
|
7
7
|
* `@keyframes` 名与帧;`animation` / `transition` 声明与长写;滚动入场
|
|
8
8
|
* (`data-reveal` / IntersectionObserver / class 切换);`transform` 的位移/缩放/旋转与延迟时长。
|
|
9
|
-
* 2. **映射**:每条动画尽量落到 `templates/
|
|
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/
|
|
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/
|
|
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 = '由 `
|
|
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/
|
|
976
|
+
base: { library: 'templates/base', vocabulary: Object.keys(BASE_MAP) },
|
|
977
977
|
signals,
|
|
978
978
|
counts,
|
|
979
979
|
animations,
|
package/lib/template-gen.mjs
CHANGED
|
@@ -12,7 +12,7 @@
|
|
|
12
12
|
* from-dir 是同一套流程换成本地静态目录:读本地 HTML、把被引用的本地资源收进 `assets/`、
|
|
13
13
|
* 反过来从 `<nav>` / `<title>` / 卡片标题推出 v2 `template.json`(栏目 / 菜单 / 字段 / 演示数据)。
|
|
14
14
|
*
|
|
15
|
-
* ## 产出(v2 口径,见 templates/
|
|
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 =
|
|
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
|
-
// ----------------------------------------------------------------
|
|
209
|
+
// ---------------------------------------------------------------- 定位基础库
|
|
209
210
|
|
|
210
211
|
/**
|
|
211
|
-
*
|
|
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
|
|
221
|
-
|
|
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
|
|
229
|
-
|
|
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
|
-
/**
|
|
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)
|
|
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
|
-
|
|
244
|
-
|
|
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 =
|
package/lib/template-pack.mjs
CHANGED
|
@@ -7,7 +7,7 @@
|
|
|
7
7
|
* UTF-8 文件名标志位 0x0800、中央目录齐全),解压工具(PowerShell Expand-Archive / 7-Zip)都认。
|
|
8
8
|
*
|
|
9
9
|
* ## 打包前
|
|
10
|
-
* 1. 把 `templates/
|
|
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(`!
|
|
164
|
+
if (!baseSync.copied) say(`! 没找到基础库(templates/base/assets):${baseSync.reason}`);
|
|
165
165
|
|
|
166
166
|
// 2) 9 关校验(不合格不出包)
|
|
167
167
|
say('跑 9 关校验…');
|
package/lib/template-publish.mjs
CHANGED
|
@@ -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 =
|
|
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/
|
|
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/
|
|
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/
|
|
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
|
-
|
|
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('
|
|
292
|
+
warnings.push('没找到基础库(templates/base/assets),只校验了 assets/base 的存在性');
|
|
287
293
|
}
|
|
288
294
|
add('base', 'assets/base 基础库副本', errors, warnings);
|
|
289
295
|
}
|
package/lib/template-verify.mjs
CHANGED
|
@@ -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('
|
|
232
|
+
if (!baseDir) say('提示:没找到基础库 templates/base/assets(不影响比对)');
|
|
233
233
|
|
|
234
234
|
const out =
|
|
235
235
|
outDir ||
|