@wkgeo/cli 2.0.2 → 2.1.0
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 +10 -2
- package/README.md +28 -7
- package/SKILL.md +1038 -1015
- package/lib/api.mjs +351 -351
- package/lib/args.mjs +235 -235
- package/lib/build.mjs +1047 -0
- package/lib/cms.mjs +328 -328
- package/lib/commands/auth.mjs +1280 -1280
- package/lib/commands/data.mjs +694 -694
- package/lib/commands/index.mjs +33 -1
- package/lib/commands/init.mjs +111 -0
- package/lib/commands/orders.mjs +691 -691
- package/lib/commands/site.mjs +82 -0
- package/lib/commands/siteops.mjs +248 -0
- package/lib/commands/sites.mjs +968 -801
- package/lib/commands/spec.mjs +72 -0
- package/lib/commands/template.mjs +1484 -1484
- package/lib/config.mjs +57 -4
- package/lib/errors.mjs +446 -336
- package/lib/manifest-apply.mjs +1650 -1600
- package/lib/manifest-schema.json +480 -480
- package/lib/manifest.mjs +1106 -1106
- package/lib/runtime.mjs +767 -654
- package/lib/site-create.mjs +537 -537
- package/lib/site-credentials.mjs +157 -0
- package/lib/site-meta.mjs +474 -0
- package/lib/site-spec.mjs +302 -0
- package/lib/site-template.mjs +405 -0
- package/lib/template-gen.mjs +1354 -1247
- package/lib/template-publish.mjs +696 -696
- package/lib/templates-sync.mjs +676 -644
- package/lib/workspace-sync.mjs +386 -0
- package/package.json +56 -55
- package/spec/SITE-SPEC.md +198 -0
package/lib/commands/site.mjs
CHANGED
|
@@ -34,6 +34,7 @@
|
|
|
34
34
|
|
|
35
35
|
import { UsageError } from '../errors.mjs';
|
|
36
36
|
import { formatTime } from '../format.mjs';
|
|
37
|
+
import { createSiteTemplate } from '../site-template.mjs';
|
|
37
38
|
|
|
38
39
|
/* ------------------------------------------------------------------ 公共小工具 */
|
|
39
40
|
|
|
@@ -378,6 +379,86 @@ export const siteSyncCommand = {
|
|
|
378
379
|
},
|
|
379
380
|
};
|
|
380
381
|
|
|
382
|
+
/* ══════════════════════════════ 新建模板(site template new) ══════════════════════════════ */
|
|
383
|
+
|
|
384
|
+
export const siteTemplateNewCommand = {
|
|
385
|
+
name: 'site template new',
|
|
386
|
+
summary: '新建一套模板:从 base / site / market:<key> / url:<参考站> 复制,拉到本地工程,**建完不启用**',
|
|
387
|
+
usage:
|
|
388
|
+
'wkgeo site template new --dir <目录> --name <名字> [--key <key>] [--from base|site|market:<市场key>|url:<参考站>] [--confirm] [--site <站点ID>] [--json]',
|
|
389
|
+
args: [],
|
|
390
|
+
flags: {
|
|
391
|
+
dir: {
|
|
392
|
+
type: 'string',
|
|
393
|
+
required: true,
|
|
394
|
+
desc: '本地模板工程根目录(模板会落在 <目录>/templates/<key>,带 template-manifest.json)',
|
|
395
|
+
},
|
|
396
|
+
name: { type: 'string', required: true, desc: '模板名字(1~40 个字)' },
|
|
397
|
+
key: { type: 'string', desc: '模板 key(小写字母 / 数字 / 连字符;不传就用名字自动转)' },
|
|
398
|
+
from: { type: 'string', desc: '复制来源:base(默认)/ site(本站当前模板)/ market:<市场key> / url:<参考站>' },
|
|
399
|
+
...CONFIRM_FLAG,
|
|
400
|
+
...SITE_FLAG,
|
|
401
|
+
},
|
|
402
|
+
examples: [
|
|
403
|
+
'wkgeo site template new --dir ./my-site --name 我的新模板',
|
|
404
|
+
'wkgeo site template new --dir ./my-site --name 落地页改版 --key landing-v2 --from market:landing-01 --confirm',
|
|
405
|
+
'wkgeo site template new --dir ./my-site --name 参考站改版 --key ref-v1 --from url:https://example.com --confirm',
|
|
406
|
+
],
|
|
407
|
+
notes: [
|
|
408
|
+
'**默认 dry-run**:只打印将建的 key / 来源 / 预计文件数,零网络、零写盘;加 `--confirm` 才真做。',
|
|
409
|
+
'真做的顺序:线上建站内模板行(`is_active=false`,前台零变化)→ `templates pull` 到本地 →',
|
|
410
|
+
' 改 `template.json`(key / name / version 1.0.0 / summary 追加「基于 <源> 新建」)→ 重写 manifest 对账。',
|
|
411
|
+
'拉取失败会**回滚**(删掉刚建的那行),不会留下空模板。',
|
|
412
|
+
'`--from url:<参考站>` 一期**不镜像整站**:页面仍取 base,参考站只写进 `template.json.origin.reference`;',
|
|
413
|
+
' 采集失败只记 `referenceError`,不影响建模板。',
|
|
414
|
+
'建完后本地改文件 → `wkgeo templates push --dir <目录>/templates/<key>` 推回**这套新模板**(不是原模板)。',
|
|
415
|
+
'需要 `site:write`。目标目录已存在会直接拒绝(不覆盖已有工程)。',
|
|
416
|
+
],
|
|
417
|
+
async run(ctx) {
|
|
418
|
+
const { out } = ctx;
|
|
419
|
+
const flags = ctx.flags || {};
|
|
420
|
+
const site = ctx.cmsSite();
|
|
421
|
+
if (!site || !site.id) {
|
|
422
|
+
throw new UsageError('还没选站:先 `wkgeo site use <站点ID>`,或本次加 --site <站点ID>');
|
|
423
|
+
}
|
|
424
|
+
|
|
425
|
+
const data = await createSiteTemplate({
|
|
426
|
+
dir: flags.dir === undefined ? '' : String(flags.dir),
|
|
427
|
+
name: flags.name === undefined ? '' : String(flags.name),
|
|
428
|
+
key: flags.key === undefined ? '' : String(flags.key),
|
|
429
|
+
from: flags.from === undefined ? 'base' : String(flags.from),
|
|
430
|
+
confirm: flags.confirm === true,
|
|
431
|
+
json: out.json === true,
|
|
432
|
+
runCli: (action, payload) => ctx.cmsCall(action, payload),
|
|
433
|
+
fetch: ctx.fetchImpl,
|
|
434
|
+
siteId: site.id,
|
|
435
|
+
});
|
|
436
|
+
|
|
437
|
+
if (!out.json) {
|
|
438
|
+
if (data.dry_run) {
|
|
439
|
+
out.head('dry-run:新建模板(没有建任何东西、没有写盘)');
|
|
440
|
+
out.line(` 站点:${siteText(ctx)}`);
|
|
441
|
+
out.line(` 模板:${data.name}(key=${data.key})`);
|
|
442
|
+
out.line(` 来源:${data.from_label || data.from}`);
|
|
443
|
+
out.line(` 落地目录:${data.dir}`);
|
|
444
|
+
out.line(` 预计文件数:${data.estimated_files === null ? '建完才知道(市场 / 本站模板)' : data.estimated_files}`);
|
|
445
|
+
out.line('');
|
|
446
|
+
out.line(' 确认无误后加 --confirm 真建。');
|
|
447
|
+
} else {
|
|
448
|
+
out.ok(`模板已新建:${data.name}(key=${data.key},version ${data.version})`);
|
|
449
|
+
out.line(` 来源:${data.from} · 线上模板 id:${data.template_id}`);
|
|
450
|
+
out.line(` 本地工程:${data.dir}(${data.files} 个文件,含 template-manifest.json)`);
|
|
451
|
+
if (data.reference) out.line(` 参考站要点:${data.reference.title || data.reference.url}(导航 ${data.reference.navigation.length} 条 / 配色 ${data.reference.colors.length} 个)`);
|
|
452
|
+
if (data.referenceError) out.warn(`参考站没采到要点(不影响建模板):${data.referenceError}`);
|
|
453
|
+
out.line(' 下一步:本地改文件 → `wkgeo templates push --dir <上面那个目录>` 推回这套模板。');
|
|
454
|
+
out.info('新模板**没有启用**;要上线请到 CMS 模板页点「启用」。');
|
|
455
|
+
}
|
|
456
|
+
}
|
|
457
|
+
ctx.done(data);
|
|
458
|
+
return data;
|
|
459
|
+
},
|
|
460
|
+
};
|
|
461
|
+
|
|
381
462
|
/** 站点类命令(B4 / task-90):注册顺序即 `wkgeo site --help` 的列法 */
|
|
382
463
|
export const SITE_COMMANDS = [
|
|
383
464
|
siteInfoCommand,
|
|
@@ -385,4 +466,5 @@ export const SITE_COMMANDS = [
|
|
|
385
466
|
siteDemoSeedCommand,
|
|
386
467
|
siteDemoClearCommand,
|
|
387
468
|
siteSyncCommand,
|
|
469
|
+
siteTemplateNewCommand,
|
|
388
470
|
];
|
package/lib/commands/siteops.mjs
CHANGED
|
@@ -8,6 +8,7 @@
|
|
|
8
8
|
* * `wkgeo plugins list|toggle` 插件开关(`/cms/pluginList` / `/cms/pluginToggle`)
|
|
9
9
|
* * `wkgeo forms list|entries` 表单与提交记录(`/form/formList` / `/form/formEntryList`)
|
|
10
10
|
* * `wkgeo preview <path>` 拼预览地址(零后端)
|
|
11
|
+
* * `wkgeo site build` 本地生成静态站 html(只读线上渲染;产物全在本地)
|
|
11
12
|
* * `wkgeo import-v2 start|status` 导入老网站 v2(默认 dry-run)
|
|
12
13
|
*
|
|
13
14
|
* 共同约定:
|
|
@@ -17,10 +18,12 @@
|
|
|
17
18
|
*/
|
|
18
19
|
|
|
19
20
|
import { camel } from '../args.mjs';
|
|
21
|
+
import { buildStaticSite } from '../build.mjs';
|
|
20
22
|
import { CliError, EXIT, UsageError } from '../errors.mjs';
|
|
21
23
|
import { maskPii, maskPiiDeep, formatTime } from '../format.mjs';
|
|
22
24
|
import { PLATFORM_WEB_ORIGIN } from '../hosts.mjs';
|
|
23
25
|
import { openUrlForUser } from '../login.mjs';
|
|
26
|
+
import { diffWorkspace } from '../workspace-sync.mjs';
|
|
24
27
|
|
|
25
28
|
/** 表单后台函数(`wkgeo-plugin-contact-form`)认的来源;不给会被 `checkAdminOrigin` 403 */
|
|
26
29
|
const FORM_ORIGIN = PLATFORM_WEB_ORIGIN;
|
|
@@ -293,6 +296,251 @@ export const previewCommand = {
|
|
|
293
296
|
},
|
|
294
297
|
};
|
|
295
298
|
|
|
299
|
+
/* ------------------------------------------------------------------ 站级同步:只读差异 */
|
|
300
|
+
|
|
301
|
+
/** 模块返回的结构化失败 → CliError(用法类走 exit 2,数据坏了走 exit 1;都不打栈) */
|
|
302
|
+
function workspaceDiffError(res) {
|
|
303
|
+
const hint = res && res.hint ? res.hint : undefined;
|
|
304
|
+
const message = (res && res.message) || '差异计算失败';
|
|
305
|
+
if (res && (res.code === 'NO_DIR' || res.code === 'NO_MANIFEST' || res.code === 'UNSAFE_PATH')) {
|
|
306
|
+
return new UsageError(message, { hint });
|
|
307
|
+
}
|
|
308
|
+
return new CliError(message, { kind: 'bad_manifest', hint });
|
|
309
|
+
}
|
|
310
|
+
|
|
311
|
+
/**
|
|
312
|
+
* `site sync diff` —— 「差异检验」第一步:模板通道的**只读**差异。
|
|
313
|
+
*
|
|
314
|
+
* 为什么放在 `site` 组而不是 `templates` 组:对象是「这个站的工作区」(一个目录装模板 +
|
|
315
|
+
* 之后的栏目 / 内容 / 素材通道),不是模板库本身;`templates push` 才是模板库那条链。
|
|
316
|
+
*/
|
|
317
|
+
export const siteSyncDiffCommand = {
|
|
318
|
+
name: 'site sync diff',
|
|
319
|
+
summary: '只读差异:本地 <目录>/template 与上次拉取的线上基线对比(新增/改动/线上多余/未变)',
|
|
320
|
+
usage: 'wkgeo site sync diff [--dir <工作区目录>] [--site <站点ID>] [--json]',
|
|
321
|
+
args: [],
|
|
322
|
+
flags: {
|
|
323
|
+
...SITE_FLAG,
|
|
324
|
+
dir: { type: 'string', desc: '工作区目录(默认当前目录);模板读 <目录>/template/,基线读里面的 template-manifest.json' },
|
|
325
|
+
},
|
|
326
|
+
examples: [
|
|
327
|
+
'wkgeo site sync diff --dir .tmp-build/my-site',
|
|
328
|
+
'wkgeo site sync diff --dir ./my-site --json',
|
|
329
|
+
],
|
|
330
|
+
notes: [
|
|
331
|
+
'**只读**:只读本地文件 + manifest,**不发任何网络请求、不写任何文件**(零写请求)。',
|
|
332
|
+
'基线 = **上次 `templates pull` 时的线上快照**(manifest 里每个文件的 sha256);pull 之后线上又被改过,这里看不出来 —— 实时口径用 `wkgeo templates push --dir <目录>/template --dry-run`(只算计划,writes:0)。',
|
|
333
|
+
'added + changed = **待发布**(push 才会生效);removed = **待下载 / 待确认**(线上快照还有、本地已删;服务端没有删除动作)。',
|
|
334
|
+
],
|
|
335
|
+
async run(ctx) {
|
|
336
|
+
const { out } = ctx;
|
|
337
|
+
const dir = ctx.flags.dir === undefined ? '.' : String(ctx.flags.dir);
|
|
338
|
+
const site = ctx.cmsSite();
|
|
339
|
+
const siteId = site.id || '';
|
|
340
|
+
const res = await diffWorkspace({ dir, siteId, cwd: process.cwd() });
|
|
341
|
+
if (!res.ok) throw workspaceDiffError(res);
|
|
342
|
+
|
|
343
|
+
const t = res.template;
|
|
344
|
+
const payload = {
|
|
345
|
+
ok: true,
|
|
346
|
+
dir: res.dir,
|
|
347
|
+
template_dir: res.template_dir,
|
|
348
|
+
site_id: res.site_id,
|
|
349
|
+
template: t,
|
|
350
|
+
counts: t.counts,
|
|
351
|
+
workspace: res.workspace,
|
|
352
|
+
baseline: res.baseline,
|
|
353
|
+
baseline_note: res.baseline_note,
|
|
354
|
+
read_only: true,
|
|
355
|
+
warnings: res.warnings,
|
|
356
|
+
};
|
|
357
|
+
|
|
358
|
+
if (!out.json) {
|
|
359
|
+
out.head(`工作区差异(模板):${res.template_dir}`);
|
|
360
|
+
out.line(
|
|
361
|
+
` 站点:${res.site_id || '(基线未记站点)'} | 基线:${res.baseline.pulled_at || '未知时间'}` +
|
|
362
|
+
`${res.baseline.template_id ? ` | 模板:${res.baseline.template_id}` : ''}`,
|
|
363
|
+
);
|
|
364
|
+
out.line(
|
|
365
|
+
` 待发布 ${t.counts.pending_publish}(新增 ${t.added.length} / 改动 ${t.changed.length})` +
|
|
366
|
+
` | 线上多余 ${t.counts.pending_download} | 未变 ${t.unchanged.length}`,
|
|
367
|
+
);
|
|
368
|
+
out.line(` 本地文件 ${res.workspace.file_count} 个 | 基线 contentHash ${String(res.workspace.contentHash || '').slice(0, 12) || '(无)'}`);
|
|
369
|
+
const show = (prefix, list, extra) => {
|
|
370
|
+
for (const one of list) out.line(` ${prefix} ${one.path}(${one.bytes} 字节${extra ? extra(one) : ''})`);
|
|
371
|
+
};
|
|
372
|
+
if (t.added.length) {
|
|
373
|
+
out.line('');
|
|
374
|
+
out.line(' 待发布 · 新增:');
|
|
375
|
+
show('+', t.added);
|
|
376
|
+
}
|
|
377
|
+
if (t.changed.length) {
|
|
378
|
+
out.line('');
|
|
379
|
+
out.line(' 待发布 · 改动:');
|
|
380
|
+
show('~', t.changed, (one) => `,基线 ${String(one.baseline_sha256 || '').slice(0, 12)}`);
|
|
381
|
+
}
|
|
382
|
+
if (t.removed.length) {
|
|
383
|
+
out.line('');
|
|
384
|
+
out.line(' 待下载 / 待确认 · 线上多余(本地已删):');
|
|
385
|
+
show('-', t.removed);
|
|
386
|
+
}
|
|
387
|
+
if (!t.added.length && !t.changed.length && !t.removed.length) out.line(' (本地与基线完全一致)');
|
|
388
|
+
if (res.warnings.length) {
|
|
389
|
+
out.line('');
|
|
390
|
+
for (const w of res.warnings) out.warn(w);
|
|
391
|
+
}
|
|
392
|
+
out.line('');
|
|
393
|
+
out.info(res.baseline_note);
|
|
394
|
+
out.info('本命令只读:不登录也能跑,不产生任何写请求;要真推用 `wkgeo templates push --dir <目录>/template --confirm`。');
|
|
395
|
+
}
|
|
396
|
+
ctx.done(payload);
|
|
397
|
+
return payload;
|
|
398
|
+
},
|
|
399
|
+
};
|
|
400
|
+
|
|
401
|
+
/* ------------------------------------------------------------------ 本地生成 */
|
|
402
|
+
|
|
403
|
+
/**
|
|
404
|
+
* `site build` —— **本地生成静态站 html**(老板 2026-11-22:「工作在本地,静态页面也在本地生成,最后再传 OSS」)。
|
|
405
|
+
*
|
|
406
|
+
* 为什么是只读命令:它只调 CMS 的渲染 / 清单类动作(`siteAssetBundle` / `publicSitemap` /
|
|
407
|
+
* `pageRender`),不发布、不上传、不写任何线上数据;产物全落在 `<目录>/html` 与
|
|
408
|
+
* `<目录>/.wkgeo/build-manifest.json`(rev4:模板资产留在 `<目录>/template/`,不复制)。
|
|
409
|
+
*
|
|
410
|
+
* 失败口径:**单页失败不中断**(记 `pages[].reason`),整批跑完后只要有失败就 exit 1
|
|
411
|
+
* (这里抛带 `details` 的 CliError —— 命令 `run` 的返回值不决定退出码,见 `cli.mjs`)。
|
|
412
|
+
*/
|
|
413
|
+
export const siteBuildCommand = {
|
|
414
|
+
name: 'site build',
|
|
415
|
+
summary: '本地生成静态站 html(只读线上渲染;不发布、不上传)',
|
|
416
|
+
usage:
|
|
417
|
+
'wkgeo site build [--dir <工作区目录>] [--site <站点ID|域名>] [--cms-site <CMS站点ID>] ' +
|
|
418
|
+
'[--assets external|inline] [--concurrency 4] [--max-pages N] [--json]',
|
|
419
|
+
args: [],
|
|
420
|
+
flags: {
|
|
421
|
+
dir: {
|
|
422
|
+
type: 'string',
|
|
423
|
+
desc: '工作区目录(默认当前目录);模板在 <目录>/template,产物落 <目录>/html(--out 可改)',
|
|
424
|
+
},
|
|
425
|
+
site: {
|
|
426
|
+
type: 'string',
|
|
427
|
+
desc: '站点(ID / 域名 / 站名;默认用 `wkgeo site use` 选中的站点,可用 WKONGAI_SITE 覆盖)',
|
|
428
|
+
},
|
|
429
|
+
'cms-site': {
|
|
430
|
+
type: 'string',
|
|
431
|
+
desc: 'CMS 站 id(uuid;cmsMe 解析不出来时才用,一般不用填)',
|
|
432
|
+
},
|
|
433
|
+
assets: {
|
|
434
|
+
type: 'string',
|
|
435
|
+
desc: '站点资源模式:external(默认,CSS/JS 落 template/css|js,页面引用 /template/...)/ inline(页面内联)',
|
|
436
|
+
},
|
|
437
|
+
concurrency: { type: 'string', desc: '并发渲染页数(默认 4,上限 16)' },
|
|
438
|
+
'max-pages': { type: 'string', desc: '最多生成多少页(调试 / 试跑用;默认全部)' },
|
|
439
|
+
out: { type: 'string', desc: '产物目录名(默认 html;只接受单层目录名)' },
|
|
440
|
+
},
|
|
441
|
+
examples: [
|
|
442
|
+
'wkgeo site build --dir .tmp-build/my-site # 生成 html',
|
|
443
|
+
'wkgeo site build --dir my-site --site hanyien.com --max-pages 3 # 先试 3 页',
|
|
444
|
+
'wkgeo site build --dir my-site --json # 机器可读结果',
|
|
445
|
+
],
|
|
446
|
+
notes: [
|
|
447
|
+
'**只读**:只调 CMS 的 `siteAssetBundle` / `publicSitemap` / `pageRender`,**不发任何写请求**。',
|
|
448
|
+
'路径映射与发布器同口径:`/` → `html/index.html`,`/about/` → `html/about/index.html`(目录风格)。',
|
|
449
|
+
'幂等:`.wkgeo/build-manifest.json` 里同路径 sha256 未变且文件还在 ⇒ `skipped`,不重复写盘。',
|
|
450
|
+
'状态文件在 `.wkgeo/`(`site.json` 栏目镜像 + `build-manifest.json` 生成清单,首次写入自动建目录);站点根不再写这两个 JSON。',
|
|
451
|
+
'单页失败不中断;跑完 `counts.failed > 0` 时命令 **exit 1**,失败原因在 `pages[].reason`。',
|
|
452
|
+
'页面含表单页 / 插件注入(客服挂件、公告、banner 等)时,本地产物与线上发布产物可能**不完全一致**(发布器另有注入步骤)。',
|
|
453
|
+
'rev4(2026-11-22):模板资产留在 `template/`(不复制进 `html/`),页面引用站内绝对路径 `/template/...`;本地预览把站点根当静态根。',
|
|
454
|
+
],
|
|
455
|
+
async run(ctx) {
|
|
456
|
+
const { out } = ctx;
|
|
457
|
+
const dir = ctx.flags.dir === undefined || ctx.flags.dir === '' ? '.' : String(ctx.flags.dir);
|
|
458
|
+
let site = String(ctx.flags.site || '').trim();
|
|
459
|
+
if (!site) {
|
|
460
|
+
/** 没显式给站就用本地选中的站(`--site` 非 uuid 时不走 cmsSite(),由 build.mjs 按域名解析) */
|
|
461
|
+
const current = ctx.cmsSite();
|
|
462
|
+
site = current.id || '';
|
|
463
|
+
}
|
|
464
|
+
if (!site) {
|
|
465
|
+
throw new UsageError('没选站点:加 `--site <站点ID|域名|站名>`,或先 `wkgeo site use <站点ID>`', {
|
|
466
|
+
hint: 'site build 只生成这一个站的页面,绝不替你猜站。',
|
|
467
|
+
});
|
|
468
|
+
}
|
|
469
|
+
/**
|
|
470
|
+
* ★ 2026-11-22 rev4:build 调的全是 **CMS 动作**(`cmsMe` / `siteAssetBundle` /
|
|
471
|
+
* `publicSitemap` / `pageRender`),必须用账号 OAuth 令牌;Key 模式(`wkgeo_sk_…`)
|
|
472
|
+
* 在 `/cms` 身份桥恒 401。`ctx.cmsAuth()` 会在 Key 模式自动回落本机账号登录态,
|
|
473
|
+
* 都拿不到就抛「需要 `wkgeo login`」的可照做错误。
|
|
474
|
+
*/
|
|
475
|
+
const credentials = ctx.cmsAuth().creds;
|
|
476
|
+
const payload = await buildStaticSite({
|
|
477
|
+
dir,
|
|
478
|
+
site,
|
|
479
|
+
cmsSite: ctx.flags.cmsSite === undefined ? '' : String(ctx.flags.cmsSite),
|
|
480
|
+
assets: ctx.flags.assets === undefined ? 'external' : String(ctx.flags.assets),
|
|
481
|
+
outDir: ctx.flags.out === undefined ? '' : String(ctx.flags.out),
|
|
482
|
+
concurrency: ctx.flags.concurrency === undefined ? undefined : String(ctx.flags.concurrency),
|
|
483
|
+
maxPages: ctx.flags.maxPages === undefined ? undefined : String(ctx.flags.maxPages),
|
|
484
|
+
config: ctx.config,
|
|
485
|
+
credentials,
|
|
486
|
+
fetchImpl: ctx.fetchImpl,
|
|
487
|
+
log: ctx.log,
|
|
488
|
+
});
|
|
489
|
+
|
|
490
|
+
if (!out.json) {
|
|
491
|
+
out.head(`本地静态生成:${payload.site.label || payload.site.id}`);
|
|
492
|
+
out.line(
|
|
493
|
+
` 站点:${payload.site.id}${payload.site.label ? `(${payload.site.label})` : ''}` +
|
|
494
|
+
` | CMS:${payload.site.cms_id}(来源 ${payload.site.cms_source})`,
|
|
495
|
+
);
|
|
496
|
+
out.line(` 输出:${payload.out}`);
|
|
497
|
+
out.line(
|
|
498
|
+
` 页面:写入 ${payload.counts.written} | 跳过 ${payload.counts.skipped} | 失败 ${payload.counts.failed}` +
|
|
499
|
+
`(本次 ${payload.counts.total} / 清单 ${payload.page_limit.total_available} 页` +
|
|
500
|
+
`${payload.page_limit.limited ? `,已按 --max-pages ${payload.page_limit.max_pages} 截断` : ''})`,
|
|
501
|
+
);
|
|
502
|
+
if (payload.assets.mode === 'external') {
|
|
503
|
+
out.line(
|
|
504
|
+
` 资源:external | hash ${payload.assets.hash} | CSS ${payload.assets.css_bytes} B | JS ${payload.assets.js_bytes} B` +
|
|
505
|
+
`(落 template/${payload.assets.css_file ? payload.assets.css_file.replace(/^template\//, '') : 'css|js'},页面引用 ${payload.assets.css_url || '/template/...'})`,
|
|
506
|
+
);
|
|
507
|
+
} else {
|
|
508
|
+
out.line(' 资源:inline(页面自带样式,html 里没有 site-<hash>.css|js)');
|
|
509
|
+
}
|
|
510
|
+
out.line(
|
|
511
|
+
` 模板资产:${payload.template_assets.available ? '就地引用 template/(不复制进 html)' : '缺失(template/assets 不存在,见告警)'}`,
|
|
512
|
+
);
|
|
513
|
+
const failedPages = payload.pages.filter((one) => one.status === 'failed');
|
|
514
|
+
if (failedPages.length) {
|
|
515
|
+
out.line('');
|
|
516
|
+
out.line(' 失败页:');
|
|
517
|
+
for (const one of failedPages) out.warn(` ✗ ${one.path} ${one.reason}`);
|
|
518
|
+
}
|
|
519
|
+
if (payload.warnings.length) {
|
|
520
|
+
out.line('');
|
|
521
|
+
for (const w of payload.warnings) out.warn(w);
|
|
522
|
+
}
|
|
523
|
+
out.line('');
|
|
524
|
+
out.info(
|
|
525
|
+
'本命令只读:不发布、不上传、不写线上数据;产物在 html/(页面 sha256 记在 .wkgeo/build-manifest.json)。',
|
|
526
|
+
);
|
|
527
|
+
}
|
|
528
|
+
|
|
529
|
+
if (!payload.ok) {
|
|
530
|
+
const err = new CliError(`本地生成完成,但有 ${payload.counts.failed} 个页面失败`, {
|
|
531
|
+
kind: 'build_failed',
|
|
532
|
+
exitCode: EXIT.ERROR,
|
|
533
|
+
hint: '看 pages[].reason:改完线上内容重跑即可(幂等,成功页会 skipped)。',
|
|
534
|
+
details: payload,
|
|
535
|
+
raw: payload,
|
|
536
|
+
});
|
|
537
|
+
throw err;
|
|
538
|
+
}
|
|
539
|
+
ctx.done(payload);
|
|
540
|
+
return payload;
|
|
541
|
+
},
|
|
542
|
+
};
|
|
543
|
+
|
|
296
544
|
/* ------------------------------------------------------------------ 导入 v2 */
|
|
297
545
|
|
|
298
546
|
/** `importV2Start` 接受的选项(数值型都是可选的;不传就用后端默认) */
|