@wkgeo/cli 1.1.1 → 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 +43 -11
- package/README.md +15 -8
- package/SKILL.md +15 -11
- 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/login.mjs +15 -3
- 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,17 +4,49 @@
|
|
|
4
4
|
|
|
5
5
|
---
|
|
6
6
|
|
|
7
|
-
## 1.1.
|
|
8
|
-
|
|
9
|
-
|
|
10
|
-
|
|
11
|
-
|
|
12
|
-
|
|
13
|
-
|
|
14
|
-
-
|
|
15
|
-
|
|
16
|
-
|
|
17
|
-
|
|
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
|
+
|
|
25
|
+
## 1.1.2 · 2026-11-09
|
|
26
|
+
|
|
27
|
+
**`--open-browser` / `WKONGAI_OPEN_BROWSER=1` 可压过「非交互」判定**:AI 子进程 / 管道 / CI 里只要显式要求,
|
|
28
|
+
就真的用默认浏览器打开授权页(以前一律只打印链接,要用户自己复制)。
|
|
29
|
+
|
|
30
|
+
- `wkgeo login --open-browser` 在非 TTY / AI 子进程里 → 照旧**尝试打开默认浏览器**(`mode:"forced"`);
|
|
31
|
+
- 新增环境变量 `WKONGAI_OPEN_BROWSER=1`(`1`/`true`/`yes`/`on`)→ 同样压过非交互判定(`mode:"agent"`),
|
|
32
|
+
适合"让本机以后任何 AI 子进程跑 `wkgeo login` 都自动弹浏览器授权";
|
|
33
|
+
- 优先级不变:`--no-browser`(及 `WKONGAI_CLI_NO_BROWSER=1`)仍**最高**,`skipped_reason:"no_browser"`;
|
|
34
|
+
两个开关都不给时,非交互 / CI 依旧只输出链接(`skipped_reason:"non_interactive"`)。
|
|
35
|
+
- 影响面:`login`(回调 / 设备码)与 `wallet recharge` / `recharge-link` 共用同一道闸门(`resolveBrowserIntent`)。
|
|
36
|
+
|
|
37
|
+
---
|
|
38
|
+
|
|
39
|
+
## 1.1.1 · 2026-11-09
|
|
40
|
+
|
|
41
|
+
**默认域名 `.com` → `.cn`**:`wkgeo.com` 已无 A 记录、全面退役,CLI 默认地址全部改用 `https://wkgeo.cn`。
|
|
42
|
+
|
|
43
|
+
- `DEFAULT_OAUTH_WEB_BASE` / `DEFAULT_USER_WEB_BASE` → `https://wkgeo.cn/oauth`、`https://wkgeo.cn/user`;
|
|
44
|
+
修复设备码授权页给出打不开网址的问题(旧默认 `https://wkgeo.com/oauth` 已不可访问)。
|
|
45
|
+
- 预览地址 → `https://wkgeo.cn/cms/preview/...`;模板预览、manifest `$id`、UA 域名同步 `.cn`。
|
|
46
|
+
- 兼容保留:`WKONGAI_OAUTH_WEB_BASE=https://oauth.wkgeo.com` 等旧站回滚开关仍可用。
|
|
47
|
+
|
|
48
|
+
---
|
|
49
|
+
|
|
18
50
|
## 未发布 · 2026-10-30(`sites create` 原语化,发版时把包版本从 1.1.0 提到 1.2.0)
|
|
19
51
|
|
|
20
52
|
**`sites create` 收口为「平台原语」:建站 → 可选装模板 → 可选发布;三来源(抓网址 / 解析文件)整块移出 CLI**(task-61)。
|
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` 信封、退出码全部不变**。 |
|
|
@@ -152,7 +153,8 @@ wkgeo login
|
|
|
152
153
|
|
|
153
154
|
会发生什么(**用户实际会看到的东西**):
|
|
154
155
|
|
|
155
|
-
1. 终端打印一条授权网址(**人在终端时**会尽力自动打开浏览器;**CI/管道/AI
|
|
156
|
+
1. 终端打印一条授权网址(**人在终端时**会尽力自动打开浏览器;**CI/管道/AI 子进程**默认只输出链接,
|
|
157
|
+
但加 `--open-browser` 或设 `WKONGAI_OPEN_BROWSER=1` 也会真的打开,见下);
|
|
156
158
|
2. 浏览器里是**我们自己的登录页**:支持「账密登录 / 手机号登录 / 邮箱登录」三个页签
|
|
157
159
|
(手机号/邮箱是**验证码登录**,验证码由平台下发到已绑定的手机/邮箱);
|
|
158
160
|
3. 登录后进入**同意页**,显示应用名「官方 CLI」和将获得的权限,点「同意」;
|
|
@@ -172,8 +174,8 @@ wkgeo login
|
|
|
172
174
|
| 选项 | 说明 |
|
|
173
175
|
| --- | --- |
|
|
174
176
|
| `--device` | 用**设备码模式**(RFC 8628):不需要本地回调地址/端口;本地读不了回调时的兜底(见 §3.2) |
|
|
175
|
-
| `--no-browser` | **不打开浏览器**(优先级最高,压过 `--open-browser
|
|
176
|
-
| `--open-browser` |
|
|
177
|
+
| `--no-browser` | **不打开浏览器**(优先级最高,压过 `--open-browser` 与 `WKONGAI_OPEN_BROWSER=1`) |
|
|
178
|
+
| `--open-browser` | 强制尝试打开系统浏览器(**压过非交互判定**:AI 子进程 / 管道 / CI 里也真的打开;`--no-browser` 仍然更优先)。等价于一次性设 `WKONGAI_OPEN_BROWSER=1` |
|
|
177
179
|
| `--scope "site:read site:write billing:self"` | 申请的能力范围(默认就是这三个,够建站+下单+支付) |
|
|
178
180
|
| `--client-id <id>` | 换一个 OAuth 客户端(默认 `wkgeo-cli`) |
|
|
179
181
|
| `--callback-port <n>` | 本地回调端口(默认 53682;被占用会自动退到随机端口) |
|
|
@@ -198,8 +200,12 @@ wkgeo login
|
|
|
198
200
|
> * `WKONGAI_CLI_NO_BROWSER=1`(`true/yes/on` 也认)。
|
|
199
201
|
> 此时 `open_browser.attempted=false`、`skipped_reason:"non_interactive"`(字段结构不变),
|
|
200
202
|
> 并打印「把授权链接转给有浏览器的用户 / 改用 `wkgeo login --device`」的可照做提示;
|
|
201
|
-
> * `--no-browser` → **不打开**(`skipped_reason:"no_browser"`,**优先级最高**,压过 `--open-browser`);
|
|
202
|
-
> * `--open-browser`
|
|
203
|
+
> * `--no-browser` → **不打开**(`skipped_reason:"no_browser"`,**优先级最高**,压过 `--open-browser` 与 `WKONGAI_OPEN_BROWSER=1`);
|
|
204
|
+
> * ★ **2026-11-09 起 `--open-browser` / `WKONGAI_OPEN_BROWSER=1` 压过非交互判定**:
|
|
205
|
+
> 在上面"非交互 / CI"环境里,只要写了 `--open-browser`(`mode:"forced"`)或设了
|
|
206
|
+
> `WKONGAI_OPEN_BROWSER=1`(`1/true/yes/on`,`mode:"agent"`),CLI 就**真的尝试打开默认浏览器**——
|
|
207
|
+
> 典型场景是 AI 子进程代跑 `wkgeo login`、由人在本机浏览器里点「同意」。
|
|
208
|
+
> 两个开关都不给时,非交互 / CI 仍**只输出链接**(老行为不变);
|
|
203
209
|
> * `--json` 的 `open_browser.skipped_reason` 合法值:`null`(真尝试过)/ `"no_browser"` / `"non_interactive"`
|
|
204
210
|
> (2026-10-01 那版的 `"non_tty_agent_mode"` **已弃用**);
|
|
205
211
|
> * 打开成功 → `✅ 已为你打开浏览器,请在那里完成授权。`;打开失败 → ⚠️ 一段**含完整 URL** 的醒目提示
|
|
@@ -439,7 +445,7 @@ wkgeo login --device-continue --json
|
|
|
439
445
|
| `templates save` | 新建/覆盖模板文件(html/css/js,≤40 万字符;可用 `assets/site.css` 这种子目录路径) | `<文件名.html\|css\|js>` + `--file <本地文件>` 或 `--content <源码>` |
|
|
440
446
|
| `templates pull` | **把整套模板拉到本地目录**(按模板内相对路径落盘 + 生成 `template-manifest.json` 记 sha256;二进制按 base64 还原成真文件) | `--dir`(必填)、`--template <key\|id>`、`--force`、`--site` |
|
|
441
447
|
| `templates push` | **把本地改动推回线上模板**(逐文件比 sha256;**默认只算计划、零写请求**,`--confirm` 才写;默认不删远端) | `--dir`(必填)、`--dry-run`、`--confirm`、`--prune`、`--site` |
|
|
442
|
-
| `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` |
|
|
443
449
|
| `publish status` | 只看发布任务状态(只读、不触发发布) | `--site`、`--job` |
|
|
444
450
|
| `publish cancel` | 取消该站正在跑的发布任务(等同 `publish --cancel`) | `--site`、`--job` |
|
|
445
451
|
| `lang list` | 站点语言列表(代码 / 名称 / 是否默认 / 是否启用;需要 `site:read`) | `--site` |
|
|
@@ -965,7 +971,7 @@ wkgeo context export --format md --out .\site-context.md
|
|
|
965
971
|
> * 打开成功 → `✅ 已为你打开浏览器,请在那里完成支付(微信扫码)。`;
|
|
966
972
|
> * 打开失败 → ⚠️ 一段**含完整收银台地址**的醒目提示(走 stderr,stdout 仍然只有机器可读 JSON);
|
|
967
973
|
> * `--no-browser` → `skipped_reason = "no_browser"`(最高优先级);
|
|
968
|
-
> * `--open-browser`
|
|
974
|
+
> * `--open-browser` / `WKONGAI_OPEN_BROWSER=1` → **压过非交互判定**,非交互 / AI 子进程里也会真的弹浏览器。
|
|
969
975
|
>
|
|
970
976
|
> ★ **`pay_url` 上的 `token=`(2026-10-02 新增)**:服务端在**下单那一刻**把"这一单是谁的"
|
|
971
977
|
> 签成一把**只对这一单有效**的令牌(`createRechargeOrder` 返回的 `pay_token`),
|
|
@@ -1078,6 +1084,7 @@ node aliyun/fc/_tests/oauth-device-live-e2e.js # 结束按 su
|
|
|
1078
1084
|
| `WKONGAI_CALLBACK_FIRST_WAIT_MS` | 未设置 | ★ **可选**的"首轮等待"(毫秒,**默认关闭**):只有显式设了它(或命令行 `--callback-first-wait`),这段时间没等到回调才会自动改用设备码继续(**本地回调监听会同时保留**);`0` 关闭(等价于 `--callback-first-wait 0`)。⚠️ **未设置时一律不启用**(0.2.2 起:等待超时不再自动改设备码;老板 2026-10-21:「默认的就是那个传统的授权方式」) |
|
|
1079
1085
|
| `WKONGAI_AUTO_DEVICE` | `1`(开) | 检测到系统代理时是否自动改用设备码;设 `0`/`false`/`no`/`off` 关闭(等价于 `--no-auto-device`,会打印"代理可能吃掉回调"的警告) |
|
|
1080
1086
|
| `WKONGAI_CLI_NO_BROWSER` | 未设置 | ★ **2026-10-21**:设 `1`/`true`/`yes`/`on` = **不自动打开浏览器**(`open_browser.skipped_reason = "non_interactive"`)。给"没有 CI 环境变量但确实在无浏览器环境"的容器/远程场景用 |
|
|
1087
|
+
| `WKONGAI_OPEN_BROWSER` | 未设置 | ★ **2026-11-09**:设 `1`/`true`/`yes`/`on` = **压过非交互判定**,AI 子进程 / 管道 / CI 里也**真的打开系统默认浏览器**去授权页(`mode:"agent"`,等价于每次都写 `--open-browser`)。`--no-browser` / `WKONGAI_CLI_NO_BROWSER=1` 仍然更优先 |
|
|
1081
1088
|
| `CI` / `GITHUB_ACTIONS` / `GITLAB_CI` / `JENKINS_URL` / `TF_BUILD` / `BUILDKITE` / `TEAMCITY_VERSION` | 未设置 | ★ **2026-10-21**:**存在任一即判定为非交互**(不看值)→ **不自动打开浏览器**,只输出链接/JSON |
|
|
1082
1089
|
| `NO_COLOR` | — | 设了就不上色 |
|
|
1083
1090
|
|
package/SKILL.md
CHANGED
|
@@ -401,17 +401,20 @@ npx -y @wkgeo/cli@latest login --json --timeout 500ms # 也可以显式写毫
|
|
|
401
401
|
> * **人类终端**(stdout 是 TTY、且不在 CI 里)→ **尝试自动打开**系统浏览器;
|
|
402
402
|
> * **非交互 / CI**(stdout 非 TTY / 管道 / AI 子进程;或存在 `CI`、`GITHUB_ACTIONS`、
|
|
403
403
|
> `GITLAB_CI`、`JENKINS_URL`、`TF_BUILD`、`BUILDKITE`、`TEAMCITY_VERSION`;或
|
|
404
|
-
> `WKONGAI_CLI_NO_BROWSER=1`)→
|
|
404
|
+
> `WKONGAI_CLI_NO_BROWSER=1`)→ **默认只输出链接/JSON,一个浏览器进程都不 spawn**,
|
|
405
405
|
> `open_browser.attempted=false`、`skipped_reason="non_interactive"`;
|
|
406
406
|
> * 实现是**多策略依次尝试**(每条都看退出码/错误/超时,失败静默试下一条):
|
|
407
407
|
> * 成功 → `✅ 已为你打开浏览器,请在那里完成授权。`(紧跟着一句"授权成功后页面会自动尝试关闭");
|
|
408
408
|
> * 全部失败 → `⚠️ 浏览器没能自动打开,请手动复制这个地址到浏览器完成授权:` + **紧跟一行完整 URL**
|
|
409
409
|
> (**绝不中断**授权;AI 场景再多一句"客户端支持内置浏览器也可以在那里打开"的**可选**提示);
|
|
410
410
|
> * `--no-browser` → **不打开**(`open_browser.skipped_reason = "no_browser"`,最高优先级,
|
|
411
|
-
> 压过 `--open-browser`);
|
|
412
|
-
> * `--open-browser`
|
|
411
|
+
> 压过 `--open-browser` 与 `WKONGAI_OPEN_BROWSER=1`);
|
|
412
|
+
> * ★ **2026-11-09 起 `--open-browser` / `WKONGAI_OPEN_BROWSER=1` 压过非交互判定**:
|
|
413
|
+
> 上面那些非交互环境里,只要写了 `--open-browser`(`mode:"forced"`)或设了 `WKONGAI_OPEN_BROWSER=1`
|
|
414
|
+
> (`1/true/yes/on`,`mode:"agent"`),CLI 就**真的尝试打开默认浏览器**去授权页 —— 这正是
|
|
415
|
+
> "AI 子进程代跑 `wkgeo login`、由人在本机浏览器点同意"的场景。两个都不给时才只输出链接。
|
|
413
416
|
> 所以 AI **不需要**自己判断"该不该开浏览器",但**永远要**把 `authorization_url` 原文转述给用户
|
|
414
|
-
> (
|
|
417
|
+
> (CLI 确实没弹时,这一步就是**唯一**的交付方式)。
|
|
415
418
|
|
|
416
419
|
**AI 的正确做法**:
|
|
417
420
|
|
|
@@ -638,8 +641,8 @@ Set-Content -LiteralPath "$env:USERPROFILE\.dsh\browser-open.txt" -Value "<完
|
|
|
638
641
|
| --- | --- |
|
|
639
642
|
| **人类终端**(stdout 是 TTY、无 CI 信号) | ✅ **会尝试打开** |
|
|
640
643
|
| **CI / 非交互**(stdout 非 TTY / 管道 / AI 子进程;`CI`、`GITHUB_ACTIONS`、`GITLAB_CI`、`JENKINS_URL`、`TF_BUILD`、`BUILDKITE`、`TEAMCITY_VERSION` 任一存在;`WKONGAI_CLI_NO_BROWSER=1`) | ❌ **绝不弹**(`skipped_reason:"non_interactive"`,只输出链接/JSON) |
|
|
641
|
-
| 加了 `--no-browser` | ❌ **不打开**(**优先级最高**,压过 `--open-browser`;`skipped_reason:"no_browser"`) |
|
|
642
|
-
| 加了 `--open-browser` | ✅
|
|
644
|
+
| 加了 `--no-browser` | ❌ **不打开**(**优先级最高**,压过 `--open-browser` 与 `WKONGAI_OPEN_BROWSER=1`;`skipped_reason:"no_browser"`) |
|
|
645
|
+
| 加了 `--open-browser`(或设了 `WKONGAI_OPEN_BROWSER=1`) | ✅ **会**(★ 2026-11-09:压过非交互判定,AI 子进程 / 管道 / CI 里也真的打开;`--no-browser` 仍然更优先) |
|
|
643
646
|
|
|
644
647
|
* **`--json` 里的结构化字段 `open_browser`**:`{attempted, opened, tried, url, skipped_reason}`
|
|
645
648
|
(结构与取值口径**没有变**)—— `skipped_reason` 有三种取值:
|
|
@@ -708,7 +711,7 @@ npx -y @wkgeo/cli@latest sites create --name "我的新站" --lang zh-CN --templ
|
|
|
708
711
|
# 读 data.siteId / data.prefixHost / data.url / data.published(steps 里每步的 ok 与耗时)
|
|
709
712
|
# ℹ️ 客户(customer)层已于 2026-10-27 删除:建站不需要任何归属参数,归属固定为令牌所属用户。
|
|
710
713
|
# ℹ️ 走平台通道 createSite:服务端分配池位 + 短域 + KV;池位满回 409(POOL_EXHAUSTED),
|
|
711
|
-
# 换区再建:--region overseas
|
|
714
|
+
# 换区再建:--region overseas / --region global。
|
|
712
715
|
# ℹ️ --template 只认**模板市场已有的 key**(填错会列出现有 key,exit 2);不给就是空站;
|
|
713
716
|
# 装完会自动启用(templateInstall → templateActivate)。
|
|
714
717
|
# ℹ️ 不给 --publish 只建不发:短域还没内容(404 属正常),要上线加 --publish。
|
|
@@ -767,8 +770,9 @@ npx -y @wkgeo/cli@latest orders check <order_id> # 用
|
|
|
767
770
|
**原样打开**即可,**不要**把 `token` 单独摘出来展示、更不要放进对话正文里当"验证码"念给用户;
|
|
768
771
|
* 它**只**授权"读这一单的支付参数":读不到钱包、读不到订单列表、不能下单、不能取消,
|
|
769
772
|
而且 30 分钟(= 订单有效期)后自动失效(失效时页面会明确说"支付链接已过期,请重新下单")。
|
|
770
|
-
⚠️ 非交互/CI 环境(容器、管道、AI
|
|
771
|
-
⚠️
|
|
773
|
+
⚠️ 非交互/CI 环境(容器、管道、AI 子进程)**默认不会弹**:`open_browser.skipped_reason = "non_interactive"`,`pay_url` 照常输出;
|
|
774
|
+
⚠️ `--open-browser` / `WKONGAI_OPEN_BROWSER=1` **压过非交互判定**(★ 2026-11-09:非交互环境里也会真的弹);
|
|
775
|
+
要显式不弹用 `--no-browser`(`skipped_reason = "no_browser"`,优先级最高)。
|
|
772
776
|
⚠️ 打开 `pay_url` 的方式见 **§5.5**:人类终端会自动弹系统浏览器;
|
|
773
777
|
只有它**没打开成功**(或非交互环境)时,才考虑可选地在客户端**内置浏览器 / 侧边面板**里打开。
|
|
774
778
|
|
|
@@ -787,7 +791,7 @@ npx -y @wkgeo/cli@latest wallet recharge-link # 默认不弹浏览器
|
|
|
787
791
|
# ★ 有效期只有 10 分钟、且**用掉即失效**(一次性):过期/已用过时页面会明确提示"请重新获取",
|
|
788
792
|
# 这时**重新跑一次本命令**拿一条新链接即可(不要反复让用户刷新旧链接)。
|
|
789
793
|
# ★ 默认**不**打开浏览器(这条命令通常跑在服务器/容器里,且交接物是链接);
|
|
790
|
-
#
|
|
794
|
+
# 写 --open-browser(或设 WKONGAI_OPEN_BROWSER=1)就真的弹(★ 2026-11-09:压过非交互判定);--no-browser 优先级最高。
|
|
791
795
|
# ★ ticket 只是"建一笔充值单"的窄凭证:⛔ 不要把它当登录凭据、不要拿它去调别的 action。
|
|
792
796
|
npx -y @wkgeo/cli@latest orders check <order_id> # 用户说付完了再查(order_id 从他那句"付完了"对应的单拿)
|
|
793
797
|
```
|
|
@@ -974,7 +978,7 @@ npx -y @wkgeo/cli@latest context export --format md --out ./site-context.md --si
|
|
|
974
978
|
| `login --device-continue` 报 `kind:"expired"` | 短码过期(默认 10 分钟)或已被换过票 | 重新 `login --device --no-wait` 申请新短码;**别**反复续跑 |
|
|
975
979
|
| 下单直接返回 `paid:true` | 服务端设计:下单时余额足够就直接扣款并履约 | 这是正常的"钱包支付";用 `wallet` 复核余额 |
|
|
976
980
|
| `sites create` 报 400 参数错误 | 客户层已删,归属无需指定;400 只剩参数问题(名称/区域等) | 按错误提示补参数 |
|
|
977
|
-
| `sites create` 报 409「该区域名额已满(系统正在自动扩容)」 | 该区域池位满(`POOL_EXHAUSTED`);服务端可能已先插了一行 draft 再失败 | 换区再建:`--region overseas
|
|
981
|
+
| `sites create` 报 409「该区域名额已满(系统正在自动扩容)」 | 该区域池位满(`POOL_EXHAUSTED`);服务端可能已先插了一行 draft 再失败 | 换区再建:`--region overseas` 或 `--region global`;别原地重试同一区 |
|
|
978
982
|
| `sites create --template` 报「模板市场里没有…」exit 2 | `--template` 只认模板市场已有 key(内置如 `classic-blue` 默认模板 / `warm-amber`) | 按报错 hint 里的现有 key 重填;不想装模板就去掉 `--template`(空站) |
|
|
979
983
|
| 短域访问 403/404 且 `sites get` 里 `prefix_kv_written:false` | 短域没写进 KV;CLI **没有** `domain repair` 命令(后端也无等价 OAuth 动作) | **别撒谎说"能访问"**:如实告诉用户短域暂不可用,用 `sites get <站点ID>` 复核 `prefix_host` / `prefix_kv_written`;`null` = 旧接口没回这个字段,让用户直接打开短域试 |
|
|
980
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/login.mjs
CHANGED
|
@@ -648,12 +648,24 @@ export function nonInteractiveBrowserHintLines({ kind = 'auth', reason = '', cmd
|
|
|
648
648
|
export function resolveBrowserIntent({ isTTY = false, json = false, forceOpen = false, noBrowser = false, env = {} } = {}) {
|
|
649
649
|
// ① 用户明确关掉:连 `--open-browser` 也不许把它顶回来(--no-browser 优先)
|
|
650
650
|
if (noBrowser === true) return { allow: false, mode: 'off', skipped_reason: 'no_browser' };
|
|
651
|
-
|
|
651
|
+
/**
|
|
652
|
+
* ② **显式要求弹浏览器**:压过"非交互环境"判定(老板 2026-11-09 定)。
|
|
653
|
+
*
|
|
654
|
+
* 背景:AI 子进程 / 管道里 stdout 不是终端,旧逻辑一律只打印链接;
|
|
655
|
+
* 但"AI 代跑 CLI、由人在本机浏览器里点授权"是常见场景(老板就是这样用),
|
|
656
|
+
* 而且用户写了 `--open-browser` 就是明确要开浏览器 —— 这条不能被非交互判定吃掉。
|
|
657
|
+
* 想保持"只打印链接"就写 `--no-browser`(① 优先级最高)。
|
|
658
|
+
*/
|
|
659
|
+
const envForce = ['1', 'true', 'yes', 'on'].includes(
|
|
660
|
+
String((env && env.WKONGAI_OPEN_BROWSER) || '').trim().toLowerCase(),
|
|
661
|
+
);
|
|
662
|
+
if (forceOpen === true || envForce) {
|
|
663
|
+
return { allow: true, mode: forceOpen === true ? 'forced' : 'agent', skipped_reason: null };
|
|
664
|
+
}
|
|
665
|
+
// ③ 非交互 / CI:**只输出链接**,不 spawn 任何浏览器
|
|
652
666
|
if (detectNonInteractive({ isTTY, env }).nonInteractive) {
|
|
653
667
|
return { allow: false, mode: 'off', skipped_reason: 'non_interactive' };
|
|
654
668
|
}
|
|
655
|
-
// ③ 用户明确要求打开(已在终端里):保留显式语义与兼容
|
|
656
|
-
if (forceOpen === true) return { allow: true, mode: 'forced', skipped_reason: null };
|
|
657
669
|
// ④ 人在终端:保持 CLI 一直以来的体验(这条**不能**破坏)
|
|
658
670
|
if (isTTY === true && json !== true) return { allow: true, mode: 'terminal', skipped_reason: null };
|
|
659
671
|
// ⑤ TTY + --json:人还在终端,照旧打开(`json` 只影响 mode 诊断字段)
|
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 ||
|