@wkgeo/cli 1.1.0 → 1.1.2
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 +45 -0
- package/README.md +163 -25
- package/SKILL.md +121 -36
- package/lib/args.mjs +2 -2
- package/lib/asset-role.mjs +68 -0
- package/lib/cms.mjs +2 -2
- package/lib/commands/billing.mjs +56 -10
- package/lib/commands/cms.mjs +49 -13
- package/lib/commands/content.mjs +108 -0
- package/lib/commands/crawl.mjs +219 -0
- package/lib/commands/geo.mjs +1673 -0
- package/lib/commands/index.mjs +640 -541
- package/lib/commands/member.mjs +930 -0
- package/lib/commands/seo.mjs +1386 -0
- package/lib/commands/siteops.mjs +3 -3
- package/lib/commands/sites.mjs +21 -125
- package/lib/commands/template.mjs +1222 -6
- package/lib/config.mjs +16 -13
- package/lib/content-apply.mjs +664 -0
- package/lib/content-check.mjs +887 -0
- package/lib/content-contract.mjs +957 -0
- package/lib/errors.mjs +6 -0
- package/lib/format.mjs +5 -1
- package/lib/login.mjs +15 -3
- package/lib/manifest-apply.mjs +1499 -0
- package/lib/manifest-schema.json +476 -0
- package/lib/manifest.mjs +1082 -0
- package/lib/oauth-urls.mjs +1 -1
- package/lib/runtime.mjs +5 -1
- package/lib/site-create.mjs +536 -0
- package/lib/template-anim.mjs +1338 -0
- package/lib/template-animation.mjs +232 -0
- package/lib/template-capture.mjs +700 -0
- package/lib/template-gen.mjs +1204 -0
- package/lib/template-pack.mjs +206 -0
- package/lib/template-publish.mjs +733 -0
- package/lib/template-score.mjs +865 -0
- package/lib/template-validate.mjs +368 -0
- package/lib/template-verify.mjs +434 -0
- package/lib/templates-sync.mjs +616 -0
- package/package.json +2 -2
package/lib/oauth-urls.mjs
CHANGED
|
@@ -6,7 +6,7 @@
|
|
|
6
6
|
* * 客户后台 `https://wkgeo.com/cms/` (老:`https://cms.wkgeo.com/`)
|
|
7
7
|
* * 会员站 `https://wkgeo.com/user/` (老:`https://user.wkgeo.com/`)
|
|
8
8
|
* * 授权站 `https://wkgeo.com/oauth/` (老:`https://oauth.wkgeo.com/`)
|
|
9
|
-
* * 收银台 `https://pay.wkgeo.
|
|
9
|
+
* * 收银台 `https://pay.wkgeo.cn/` —— **支付独立**(2026-11-05 起 `.cn`,旧域 301 过来)
|
|
10
10
|
* 老地址一律**继续可用**(老板要求并存),但 CLI 的 canonical 地址要切到新路径。
|
|
11
11
|
*
|
|
12
12
|
* ## 问题在哪
|
package/lib/runtime.mjs
CHANGED
|
@@ -59,7 +59,7 @@ export function okEnvelope(command, data, meta) {
|
|
|
59
59
|
|
|
60
60
|
/** 失败信封:**结构化**,带 code / message / hint,让 AI 端能自己决定下一步 */
|
|
61
61
|
export function errorEnvelope(command, err, meta) {
|
|
62
|
-
|
|
62
|
+
const env = {
|
|
63
63
|
ok: false,
|
|
64
64
|
command,
|
|
65
65
|
error: {
|
|
@@ -71,6 +71,10 @@ export function errorEnvelope(command, err, meta) {
|
|
|
71
71
|
},
|
|
72
72
|
meta,
|
|
73
73
|
};
|
|
74
|
+
// `details` = 失败时的结构化明细(如 verify 的动画对账 命中/缺失/多余)。
|
|
75
|
+
// 只在这个字段**确实存在**时加上,老命令的信封形状一个字不变。
|
|
76
|
+
if (err && err.details !== undefined && err.details !== null) env.error.details = err.details;
|
|
77
|
+
return env;
|
|
74
78
|
}
|
|
75
79
|
|
|
76
80
|
/** 输出器:人类可读 + `--json` 两套;"令牌不进终端"这件事只在这里发生一次 */
|
|
@@ -0,0 +1,536 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* **建站原语**(`wkgeo sites create`):建站 → 可选装模板市场的模板 → 可选发布 → 输出短域。
|
|
3
|
+
*
|
|
4
|
+
* 流程(全部走既有平台链路,不改任何云函数):
|
|
5
|
+
* 1. `createSite`(平台通道:分配池位 + 短域 + 写短域 KV);
|
|
6
|
+
* 2. 可选:`--template <key>` → `templateMarketList` → `templateInstall` → `templateActivate`;
|
|
7
|
+
* 3. 可选:`--publish` → `cmsSitePublishStart` + 轮询 `cmsSitePublishStatus`,发布后实测短域首页;
|
|
8
|
+
* 4. 输出 `{ siteId, name, prefixHost, url, published }`。
|
|
9
|
+
*
|
|
10
|
+
* **本文件只做平台原语**:不抓网址、不解析 zip / 目录、不做多来源合成、不做任何"分析"。
|
|
11
|
+
* 三来源规范与生成模板的 skill 不在 CLI,见 `docs/规范-建站三来源-20261031.md`(task-73 产出)。
|
|
12
|
+
*/
|
|
13
|
+
|
|
14
|
+
import { CliError, UsageError } from './errors.mjs';
|
|
15
|
+
import { resolveConfig } from './config.mjs';
|
|
16
|
+
import { createCms } from './cms.mjs';
|
|
17
|
+
|
|
18
|
+
/* ------------------------------------------------------------------ 常量 */
|
|
19
|
+
|
|
20
|
+
/** 支持的语言(不支持的直说,不静默降级) */
|
|
21
|
+
export const LANGS = Object.freeze([
|
|
22
|
+
{ code: 'zh-CN', name: '简体中文', aliases: ['zh', 'zh-cn', 'zh_cn', 'zhcn', 'cn', 'chs', 'chinese', '中文', '简体', '简体中文'] },
|
|
23
|
+
{ code: 'en', name: 'English', aliases: ['en', 'en-us', 'en_us', 'enus', 'english', '英文', '英语'] },
|
|
24
|
+
]);
|
|
25
|
+
|
|
26
|
+
const DEFAULT_LANG = 'zh-CN';
|
|
27
|
+
|
|
28
|
+
/**
|
|
29
|
+
* 区域(决定池位与短域后缀):domestic → `cn1.wkgeo.com.cn`、overseas → `intl.wkgeo.com.cn`、
|
|
30
|
+
* global → `global.wkgeo.com.cn`。**不给就 domestic**(平台默认池)。
|
|
31
|
+
* 池位满了服务端回 409「该区域名额已满」——这时换 `--region overseas` 是有用的逃生门。
|
|
32
|
+
*/
|
|
33
|
+
export const REGIONS = Object.freeze([
|
|
34
|
+
{ code: 'domestic', name: '国内', alias: ['cn', 'cn1', 'domestic', '国内', '大陆'] },
|
|
35
|
+
{ code: 'overseas', name: '海外', alias: ['intl', 'overseas', '海外', '国际'] },
|
|
36
|
+
{ code: 'global', name: '全球', alias: ['global', '全球'] },
|
|
37
|
+
]);
|
|
38
|
+
|
|
39
|
+
const DEFAULT_REGION = 'domestic';
|
|
40
|
+
|
|
41
|
+
/* -------------------------------------------------------------- 参数归一 */
|
|
42
|
+
|
|
43
|
+
/**
|
|
44
|
+
* 语言:认 `zh-CN` / `en` 与常见别名。
|
|
45
|
+
* @param {string|undefined} raw 缺省 `zh-CN`
|
|
46
|
+
* @returns {{code:string, name:string, requested:string}}
|
|
47
|
+
* @throws {UsageError} 不支持的语言(exit 2)
|
|
48
|
+
*/
|
|
49
|
+
export function normalizeLang(raw) {
|
|
50
|
+
const requested = String(raw === undefined || raw === null || raw === '' ? DEFAULT_LANG : raw).trim();
|
|
51
|
+
const key = requested.toLowerCase();
|
|
52
|
+
const hit = LANGS.find((one) => one.code.toLowerCase() === key || one.aliases.includes(key));
|
|
53
|
+
if (!hit) {
|
|
54
|
+
throw new UsageError(`不支持的站点语言:${requested},只支持 ${LANGS.map((one) => one.code).join(' / ')}`, {
|
|
55
|
+
hint: `语言取值:${LANGS.map((one) => `${one.code}(${one.name})`).join(' / ')};不传默认 zh-CN。`,
|
|
56
|
+
});
|
|
57
|
+
}
|
|
58
|
+
return { code: hit.code, name: hit.name, requested };
|
|
59
|
+
}
|
|
60
|
+
|
|
61
|
+
/**
|
|
62
|
+
* 区域:认 `domestic` / `overseas` / `global` 与别名。
|
|
63
|
+
* @param {string|undefined} value 缺省 `domestic`
|
|
64
|
+
* @returns {string}
|
|
65
|
+
* @throws {UsageError} 不认识的区域(exit 2)
|
|
66
|
+
*/
|
|
67
|
+
export function normalizeRegion(value) {
|
|
68
|
+
const raw = String(value == null ? '' : value).trim();
|
|
69
|
+
if (!raw) return DEFAULT_REGION;
|
|
70
|
+
const low = raw.toLowerCase();
|
|
71
|
+
for (const one of REGIONS) {
|
|
72
|
+
if (one.code === low || one.alias.includes(low)) return one.code;
|
|
73
|
+
}
|
|
74
|
+
throw new UsageError(`--region 只支持 ${REGIONS.map((one) => one.code).join(' / ')},收到:${raw}`, {
|
|
75
|
+
hint: 'domestic=国内池(cn1.wkgeo.com.cn)/ overseas=海外池(intl.wkgeo.com.cn)/ global=全球池;不传默认 domestic。',
|
|
76
|
+
});
|
|
77
|
+
}
|
|
78
|
+
|
|
79
|
+
/* ---------------------------------------------------------- 站点侧调用 */
|
|
80
|
+
|
|
81
|
+
/**
|
|
82
|
+
* 给**指定站点**建一个 CMS 调用器。
|
|
83
|
+
*
|
|
84
|
+
* 为什么不用 `ctx.cmsCall`:它只认 `--site` / 本地选中的站,而这里刚建出来的新站 id
|
|
85
|
+
* 还没写进本地状态(也不该写),必须显式带 `x-cms-site`。
|
|
86
|
+
*
|
|
87
|
+
* @param {object} ctx
|
|
88
|
+
* @param {string} siteId
|
|
89
|
+
* @returns {(action:string, payload?:object) => Promise<any>}
|
|
90
|
+
*/
|
|
91
|
+
function siteCms(ctx, siteId) {
|
|
92
|
+
let client = null;
|
|
93
|
+
return async (action, payload = {}) => {
|
|
94
|
+
if (!client) {
|
|
95
|
+
// 复用运行时已解析的 config(含单测注入的 env),不自己再 resolve 一遍
|
|
96
|
+
const config = ctx.config || resolveConfig(ctx.flags, ctx.env || process.env);
|
|
97
|
+
client = createCms({ config, fetchImpl: ctx.fetchImpl });
|
|
98
|
+
}
|
|
99
|
+
const creds = ctx.requireAuth();
|
|
100
|
+
return client.call(action, payload, { token: creds.access_token, siteId });
|
|
101
|
+
};
|
|
102
|
+
}
|
|
103
|
+
|
|
104
|
+
/** 站点行 → 输出用的最小形状 */
|
|
105
|
+
function siteBrief(row) {
|
|
106
|
+
const one = row && row.site ? row.site : row || {};
|
|
107
|
+
const prefixHost = one.prefix_host || one.prefixHost || '';
|
|
108
|
+
return {
|
|
109
|
+
id: String(one.id || ''),
|
|
110
|
+
name: one.name || '',
|
|
111
|
+
status: one.status || null,
|
|
112
|
+
owner_user_id: one.owner_user_id || one.owner_id || null,
|
|
113
|
+
pool_id: one.pool_id || null,
|
|
114
|
+
prefix_host: prefixHost || null,
|
|
115
|
+
prefix_url: one.prefix_url || (prefixHost ? `https://${prefixHost}/` : null),
|
|
116
|
+
};
|
|
117
|
+
}
|
|
118
|
+
|
|
119
|
+
/** 语言:查 → 没有就建(第一个语言服务端会自动设默认) */
|
|
120
|
+
async function ensureLang(call, lang) {
|
|
121
|
+
const pick = (res) => {
|
|
122
|
+
if (Array.isArray(res)) return res;
|
|
123
|
+
if (res && Array.isArray(res.languages)) return res.languages;
|
|
124
|
+
if (res && Array.isArray(res.langs)) return res.langs;
|
|
125
|
+
if (res && Array.isArray(res.items)) return res.items;
|
|
126
|
+
return [];
|
|
127
|
+
};
|
|
128
|
+
const list0 = pick(await call('langList', {}));
|
|
129
|
+
const found = list0.find((one) => String(one && one.code ? one.code : '').toLowerCase() === lang.code.toLowerCase());
|
|
130
|
+
if (found) {
|
|
131
|
+
return { code: lang.code, name: found.name || lang.name, created: false, is_default: Boolean(found.isDefault || found.is_default) };
|
|
132
|
+
}
|
|
133
|
+
await call('langSave', { code: lang.code, name: lang.name });
|
|
134
|
+
const list1 = pick(await call('langList', {}));
|
|
135
|
+
const after = list1.find((one) => String(one && one.code ? one.code : '').toLowerCase() === lang.code.toLowerCase());
|
|
136
|
+
return {
|
|
137
|
+
code: lang.code,
|
|
138
|
+
name: (after && after.name) || lang.name,
|
|
139
|
+
created: true,
|
|
140
|
+
is_default: after ? Boolean(after.isDefault || after.is_default) : true,
|
|
141
|
+
};
|
|
142
|
+
}
|
|
143
|
+
|
|
144
|
+
/** 模板市场:key / 名称 → 市场行(`templateInstall` 只认 uuid) */
|
|
145
|
+
async function resolveMarketTemplate(call, key) {
|
|
146
|
+
const res = await call('templateMarketList', {});
|
|
147
|
+
const list = (res && (Array.isArray(res.templates) ? res.templates : Array.isArray(res.items) ? res.items : null)) || [];
|
|
148
|
+
const wanted = String(key).trim().toLowerCase();
|
|
149
|
+
const hit =
|
|
150
|
+
list.find((one) => String(one && one.key ? one.key : '').toLowerCase() === wanted) ||
|
|
151
|
+
list.find((one) => String(one && one.name ? one.name : '').trim() === String(key).trim());
|
|
152
|
+
if (!hit) {
|
|
153
|
+
throw new CliError(`模板市场里没有 key = ${key} 的模板`, {
|
|
154
|
+
kind: 'usage',
|
|
155
|
+
exitCode: 2,
|
|
156
|
+
hint: `市场现有 key:${list.map((one) => one.key).filter(Boolean).slice(0, 20).join(' / ') || '(空)'}`,
|
|
157
|
+
});
|
|
158
|
+
}
|
|
159
|
+
return hit;
|
|
160
|
+
}
|
|
161
|
+
|
|
162
|
+
/** 装模板市场里的一套(安装 + 启用),返回模板摘要 */
|
|
163
|
+
async function installMarketTemplate(call, key) {
|
|
164
|
+
const market = await resolveMarketTemplate(call, key);
|
|
165
|
+
const installed = await call('templateInstall', { marketId: market.id });
|
|
166
|
+
const templateId = String((installed && (installed.id || installed.templateId)) || '');
|
|
167
|
+
if (!templateId) throw new CliError('模板安装没有返回 templateId', { kind: 'bad_response' });
|
|
168
|
+
await call('templateActivate', { templateId });
|
|
169
|
+
return {
|
|
170
|
+
market_key: market.key || key,
|
|
171
|
+
market_id: market.id,
|
|
172
|
+
market_name: market.name || null,
|
|
173
|
+
template_id: templateId,
|
|
174
|
+
activated: true,
|
|
175
|
+
file_count: Number(installed && installed.fileCount) || null,
|
|
176
|
+
requires_plugins: Array.isArray(installed && installed.requiresPlugins) ? installed.requiresPlugins : [],
|
|
177
|
+
};
|
|
178
|
+
}
|
|
179
|
+
|
|
180
|
+
/** 发布 + 轮询(复用 CMS 发布任务,口径同 `wkgeo publish`) */
|
|
181
|
+
async function publishAndWait(ctx, siteId, { intervalMs = 2000, timeoutMs = 900000, onTick = null } = {}) {
|
|
182
|
+
const started = await ctx.publishCall('cmsSitePublishStart', { siteId }, { siteId });
|
|
183
|
+
const jobId = String((started && (started.jobId || started.job_id || started.id)) || '');
|
|
184
|
+
if (!jobId) {
|
|
185
|
+
throw new CliError('发布接口没有返回 jobId', { kind: 'bad_response', hint: `稍后用 \`wkgeo publish --site ${siteId} --json\` 确认` });
|
|
186
|
+
}
|
|
187
|
+
const deadline = Date.now() + timeoutMs;
|
|
188
|
+
let last = null;
|
|
189
|
+
for (;;) {
|
|
190
|
+
last = await ctx.publishCall('cmsSitePublishStatus', { jobId }, { siteId });
|
|
191
|
+
const status = String((last && (last.status || (last.job && last.job.status))) || '').toLowerCase();
|
|
192
|
+
if (onTick) onTick(status, last);
|
|
193
|
+
if (['success', 'partial', 'failed', 'canceled'].includes(status)) break;
|
|
194
|
+
if (Date.now() > deadline) {
|
|
195
|
+
throw new CliError(`发布任务 ${jobId} 等超时了(${Math.round(timeoutMs / 1000)}s)`, {
|
|
196
|
+
kind: 'timeout',
|
|
197
|
+
hint: `任务可能还在跑:wkgeo publish --site ${siteId} --json 看进度`,
|
|
198
|
+
});
|
|
199
|
+
}
|
|
200
|
+
await new Promise((resolve) => setTimeout(resolve, intervalMs));
|
|
201
|
+
}
|
|
202
|
+
const status = String((last && (last.status || (last.job && last.job.status))) || '').toLowerCase();
|
|
203
|
+
return {
|
|
204
|
+
job_id: jobId,
|
|
205
|
+
status,
|
|
206
|
+
total: Number((last && (last.total || (last.job && last.job.total))) || 0) || null,
|
|
207
|
+
done: Number((last && (last.done || (last.job && last.job.done))) || 0) || null,
|
|
208
|
+
pages_failed: Number((last && (last.pagesFailed || last.pages_failed)) || 0) || 0,
|
|
209
|
+
errors: Array.isArray(last && last.errors) ? last.errors.slice(0, 10) : [],
|
|
210
|
+
warnings: Array.isArray(last && last.warnings) ? last.warnings.slice(0, 10) : [],
|
|
211
|
+
};
|
|
212
|
+
}
|
|
213
|
+
|
|
214
|
+
/** 解析标签上的属性(`rel="stylesheet"` / `src=...`),只为了拿外链地址,不做 HTML 解析器 */
|
|
215
|
+
function parseTagAttrs(raw) {
|
|
216
|
+
const out = {};
|
|
217
|
+
const re = /([a-zA-Z_:][-a-zA-Z0-9_:.]*)\s*(?:=\s*(?:"([^"]*)"|'([^']*)'|([^\s"'>]+)))?/g;
|
|
218
|
+
for (const m of String(raw || '').matchAll(re)) {
|
|
219
|
+
const name = m[1].toLowerCase();
|
|
220
|
+
if (Object.prototype.hasOwnProperty.call(out, name)) continue;
|
|
221
|
+
out[name] = m[2] ?? m[3] ?? m[4] ?? '';
|
|
222
|
+
}
|
|
223
|
+
return out;
|
|
224
|
+
}
|
|
225
|
+
|
|
226
|
+
/** 首页里的外链资源:`<link rel="stylesheet" href>` + `<script src>` */
|
|
227
|
+
export function collectAssetRefs(html) {
|
|
228
|
+
const css = [];
|
|
229
|
+
const js = [];
|
|
230
|
+
for (const m of String(html || '').matchAll(/<(link|script)\b([^>]*)>/gi)) {
|
|
231
|
+
const attrs = parseTagAttrs(m[2]);
|
|
232
|
+
if (m[1].toLowerCase() === 'link') {
|
|
233
|
+
if (/\bstylesheet\b/i.test(attrs.rel || '') && attrs.href) css.push(attrs.href);
|
|
234
|
+
} else if (attrs.src) {
|
|
235
|
+
js.push(attrs.src);
|
|
236
|
+
}
|
|
237
|
+
}
|
|
238
|
+
return { css, js };
|
|
239
|
+
}
|
|
240
|
+
|
|
241
|
+
/** 服务端外链化后的文件名:`/assets/css/site-<hash>.css`、`/assets/js/site-<hash>.js`(见 wkgeo-site-publish) */
|
|
242
|
+
const CSS_BUNDLE_RE = /\/assets\/css\/site-[A-Za-z0-9._-]+\.css/i;
|
|
243
|
+
const JS_BUNDLE_RE = /\/assets\/js\/site-[A-Za-z0-9._-]+\.js/i;
|
|
244
|
+
|
|
245
|
+
/**
|
|
246
|
+
* 发布后自检(task-46 C):首页 HTML 里有没有服务端合并出来的 `site-<hash>.css` 外链。
|
|
247
|
+
*
|
|
248
|
+
* 口径:**只告警、不中断** —— 外链化开关(`PUBLISH_EXTERNAL_ASSETS`,默认开)在服务端,
|
|
249
|
+
* 关掉它或模板本身没有样式时这里不该判失败。四种结果:
|
|
250
|
+
* * 有 `/assets/css/site-…` → `externalized: true`(通过);
|
|
251
|
+
* * 有样式(外链 css 或内联 `<style>`)但没有外链 → `ok: false`(告警,提示开关/发布版本);
|
|
252
|
+
* * 首页没探到 / HTTP ≥400 → `skipped`(探不到不算站的问题,另说);
|
|
253
|
+
* * 首页根本没有样式 → `skipped`(空站 / 纯 HTML 模板)。
|
|
254
|
+
*/
|
|
255
|
+
export function checkAssetBundle(probe) {
|
|
256
|
+
const refs = (probe && probe.assets) || { css: [], js: [] };
|
|
257
|
+
const cssLinks = Array.isArray(refs.css) ? refs.css : [];
|
|
258
|
+
const jsLinks = Array.isArray(refs.js) ? refs.js : [];
|
|
259
|
+
const out = {
|
|
260
|
+
css_bundles: cssLinks.filter((u) => CSS_BUNDLE_RE.test(u)).slice(0, 5),
|
|
261
|
+
js_bundles: jsLinks.filter((u) => JS_BUNDLE_RE.test(u)).slice(0, 5),
|
|
262
|
+
css_links: cssLinks.slice(0, 5),
|
|
263
|
+
js_links: jsLinks.slice(0, 5),
|
|
264
|
+
inline_css: Boolean(probe && probe.inline_css),
|
|
265
|
+
externalized: false,
|
|
266
|
+
skipped: false,
|
|
267
|
+
ok: true,
|
|
268
|
+
reason: '',
|
|
269
|
+
};
|
|
270
|
+
if (!probe || probe.status == null) {
|
|
271
|
+
out.skipped = true;
|
|
272
|
+
out.reason = '首页没探到(短域还没生效 / 网络不通),跳过样式外链自检';
|
|
273
|
+
return out;
|
|
274
|
+
}
|
|
275
|
+
if (probe.status >= 400) {
|
|
276
|
+
out.skipped = true;
|
|
277
|
+
out.reason = `首页 HTTP ${probe.status},跳过样式外链自检`;
|
|
278
|
+
return out;
|
|
279
|
+
}
|
|
280
|
+
if (out.css_bundles.length) {
|
|
281
|
+
out.externalized = true;
|
|
282
|
+
return out;
|
|
283
|
+
}
|
|
284
|
+
if (cssLinks.length || out.inline_css) {
|
|
285
|
+
out.ok = false;
|
|
286
|
+
out.reason =
|
|
287
|
+
'首页有样式,但没有服务端外链化的 /assets/css/site-<hash>.css —— ' +
|
|
288
|
+
'可能是发布侧外链化开关被关(PUBLISH_EXTERNAL_ASSETS=0)或发布产物是旧版本;页面本身不受影响';
|
|
289
|
+
return out;
|
|
290
|
+
}
|
|
291
|
+
out.skipped = true;
|
|
292
|
+
out.reason = '首页没有样式表(空站 / 纯 HTML 模板),跳过样式外链自检';
|
|
293
|
+
return out;
|
|
294
|
+
}
|
|
295
|
+
|
|
296
|
+
/** 抓一次短域首页:状态码 / 字节数 / 标题 / 外链资源(「页面里可见证据」就靠它) */
|
|
297
|
+
async function probeUrl(ctx, url, { timeoutMs = 20000 } = {}) {
|
|
298
|
+
if (!url) return null;
|
|
299
|
+
try {
|
|
300
|
+
const res = await ctx.fetchImpl(url, { method: 'GET', signal: AbortSignal.timeout(timeoutMs) });
|
|
301
|
+
const buf = Buffer.from(await res.arrayBuffer());
|
|
302
|
+
const html = buf.toString('utf8');
|
|
303
|
+
const title = (html.match(/<title[^>]*>([\s\S]*?)<\/title>/i) || [])[1] || '';
|
|
304
|
+
return {
|
|
305
|
+
url,
|
|
306
|
+
status: res.status,
|
|
307
|
+
bytes: buf.length,
|
|
308
|
+
title: title.replace(/\s+/g, ' ').trim().slice(0, 120),
|
|
309
|
+
/** task-46:外链化自检要用的证据(只有链接地址,不含页面正文) */
|
|
310
|
+
assets: collectAssetRefs(html),
|
|
311
|
+
inline_css: /<style\b/i.test(html),
|
|
312
|
+
};
|
|
313
|
+
} catch (e) {
|
|
314
|
+
return { url, status: null, bytes: 0, error: (e && e.message) || String(e) };
|
|
315
|
+
}
|
|
316
|
+
}
|
|
317
|
+
|
|
318
|
+
/* ------------------------------------------------------------- 主流程 */
|
|
319
|
+
|
|
320
|
+
/**
|
|
321
|
+
* 建站原语。由 `sitesCreateCommand` 调用。
|
|
322
|
+
*
|
|
323
|
+
* @param {object} ctx CLI runtime
|
|
324
|
+
* @param {object} flags 已 coerce 的 flags:name / lang / template / region / publish / dry-run / json
|
|
325
|
+
* @returns {Promise<object>} 结构化结果(调用方负责 `ctx.done(data)`)
|
|
326
|
+
*/
|
|
327
|
+
export async function runSiteCreate(ctx, flags) {
|
|
328
|
+
const { out } = ctx;
|
|
329
|
+
const json = out.json;
|
|
330
|
+
const say = (s) => {
|
|
331
|
+
if (!json) out.line(` ${s}`);
|
|
332
|
+
};
|
|
333
|
+
|
|
334
|
+
const name = String(flags.name == null ? '' : flags.name).trim();
|
|
335
|
+
if (!name) {
|
|
336
|
+
throw new UsageError('缺站点名:--name <站点名>', { hint: '例:wkgeo sites create --name 我的站 --lang zh-CN --template qbk-enterprise --publish' });
|
|
337
|
+
}
|
|
338
|
+
const lang = normalizeLang(flags.lang);
|
|
339
|
+
const region = normalizeRegion(flags.region);
|
|
340
|
+
const templateKey = String(flags.template == null ? '' : flags.template).trim() || null;
|
|
341
|
+
const wantPublish = flags.publish === true;
|
|
342
|
+
const dryRun = flags.dryRun === true || flags['dry-run'] === true;
|
|
343
|
+
|
|
344
|
+
const steps = [];
|
|
345
|
+
const warnings = [];
|
|
346
|
+
const record = (step, extra = {}) => {
|
|
347
|
+
steps.push({ step, ok: true, ...extra });
|
|
348
|
+
return steps[steps.length - 1];
|
|
349
|
+
};
|
|
350
|
+
|
|
351
|
+
/* ---------------- dry-run:只打计划,不建站、不写库、不碰 OSS ---------------- */
|
|
352
|
+
if (dryRun) {
|
|
353
|
+
const plan = [
|
|
354
|
+
{ step: 'create_site', via: 'createSite(平台通道)', name, region, lang: lang.code, writes: 'public.site 1 行 + 池位 1 + 短域 KV 1' },
|
|
355
|
+
];
|
|
356
|
+
if (templateKey) {
|
|
357
|
+
plan.push({ step: 'install_template', via: 'templateMarketList → templateInstall → templateActivate', template: templateKey, writes: 'cms_template 1 行 + 模板文件 N 行' });
|
|
358
|
+
}
|
|
359
|
+
plan.push({ step: 'ensure_lang', code: lang.code, via: 'langList → langSave', writes: 'cms_site_language 1 行(已有则 0)' });
|
|
360
|
+
if (wantPublish) {
|
|
361
|
+
plan.push({
|
|
362
|
+
step: 'publish',
|
|
363
|
+
via: 'cmsSitePublishStart + 轮询 cmsSitePublishStatus',
|
|
364
|
+
writes: 'OSS <siteId>/ 下页面对象 + <siteId>/assets/{css,js}/site-<hash>.*(外链化)+ 短域实测',
|
|
365
|
+
after: '探首页断言有 /assets/css/site-<hash>.css,没有只告警',
|
|
366
|
+
});
|
|
367
|
+
}
|
|
368
|
+
|
|
369
|
+
const data = {
|
|
370
|
+
ok: true,
|
|
371
|
+
dry_run: true,
|
|
372
|
+
created: false,
|
|
373
|
+
name,
|
|
374
|
+
lang,
|
|
375
|
+
region,
|
|
376
|
+
template: templateKey,
|
|
377
|
+
publish: wantPublish,
|
|
378
|
+
steps: plan,
|
|
379
|
+
writes: 0,
|
|
380
|
+
note: 'dry-run:没有建站、没有写任何库行、没有写 OSS、没有发布',
|
|
381
|
+
};
|
|
382
|
+
if (!json) {
|
|
383
|
+
out.head('建站计划(--dry-run:只打印,不执行任何写操作)');
|
|
384
|
+
say(`站点名:${name}`);
|
|
385
|
+
say(`语言:${lang.code}(${lang.name})`);
|
|
386
|
+
say(`区域:${region}`);
|
|
387
|
+
say(`模板:${templateKey || '(不装,空站)'}`);
|
|
388
|
+
say(`发布:${wantPublish ? '建完就发' : '不发(加 --publish 才发)'}`);
|
|
389
|
+
for (const one of plan) {
|
|
390
|
+
say(`· ${one.step}:${one.via || one.code || ''}`);
|
|
391
|
+
if (one.after) say(` 发布后自检:${one.after}`);
|
|
392
|
+
}
|
|
393
|
+
out.info('\n → 这一步不产生任何库行 / OSS 对象;真跑去掉 --dry-run。');
|
|
394
|
+
}
|
|
395
|
+
return data;
|
|
396
|
+
}
|
|
397
|
+
|
|
398
|
+
if (!json) out.head(`建站:${name}(语言 ${lang.code},区域 ${region})`);
|
|
399
|
+
|
|
400
|
+
/* ---------------- ① 建站(平台通道:池位 + 短域 + KV) ---------------- */
|
|
401
|
+
let site;
|
|
402
|
+
try {
|
|
403
|
+
const res = await ctx.callData('createSite', { name, region }, { timeoutMs: 60000 });
|
|
404
|
+
site = siteBrief(res);
|
|
405
|
+
} catch (e) {
|
|
406
|
+
const msg = (e && e.message) || String(e);
|
|
407
|
+
if (/POOL_EXHAUSTED|名额已满/.test(msg)) {
|
|
408
|
+
/* 409 在通用分类里会落到 kind:'unknown',这里补成可读的 kind,便于 AI 端按类型分支 */
|
|
409
|
+
if (e && (!e.kind || e.kind === 'unknown')) e.kind = 'pool_exhausted';
|
|
410
|
+
e.hint = [e.hint, `该区域池位满了:加 \`--region overseas\`(intl.wkgeo.com.cn)或 \`--region global\` 再建。`].filter(Boolean).join(' | ');
|
|
411
|
+
}
|
|
412
|
+
throw e;
|
|
413
|
+
}
|
|
414
|
+
if (!site.id) {
|
|
415
|
+
throw new CliError('建站接口没有返回站点 id', {
|
|
416
|
+
kind: 'bad_response',
|
|
417
|
+
hint: '用 `wkgeo sites list` 确认是否已经建出来了;刚建出来但没有 id 属服务端异常。',
|
|
418
|
+
});
|
|
419
|
+
}
|
|
420
|
+
record('create_site', { site_id: site.id, prefix_host: site.prefix_host, pool_id: site.pool_id, region });
|
|
421
|
+
if (!json) {
|
|
422
|
+
out.ok(`站点已创建:${site.name || name}`);
|
|
423
|
+
say(`站点 ID:${site.id}`);
|
|
424
|
+
say(`短域:${site.prefix_url || '(服务端还没分配,稍后看 `wkgeo sites get`)'}`);
|
|
425
|
+
}
|
|
426
|
+
|
|
427
|
+
const call = siteCms(ctx, site.id);
|
|
428
|
+
|
|
429
|
+
/** 站点已建:后面任何一步失败都要把「站还在」说清楚,别让人以为白建了 */
|
|
430
|
+
const guard = async (label, fn) => {
|
|
431
|
+
try {
|
|
432
|
+
return await fn();
|
|
433
|
+
} catch (e) {
|
|
434
|
+
const err = e instanceof CliError ? e : new CliError(`${label} 失败:${(e && e.message) || String(e)}`, { kind: 'error', cause: e });
|
|
435
|
+
err.hint = [err.hint, `站点已创建(${site.id}),可删:wkgeo sites delete ${site.id}`].filter(Boolean).join(' | ');
|
|
436
|
+
err.raw = { ...(err.raw && typeof err.raw === 'object' ? err.raw : {}), site_id: site.id, failed_step: label };
|
|
437
|
+
throw err;
|
|
438
|
+
}
|
|
439
|
+
};
|
|
440
|
+
|
|
441
|
+
/* ---------------- ② 语言(失败只 warn,不整单失败) ---------------- */
|
|
442
|
+
let language = null;
|
|
443
|
+
try {
|
|
444
|
+
language = await ensureLang(call, lang);
|
|
445
|
+
record('ensure_lang', { code: language.code, created: language.created, is_default: language.is_default });
|
|
446
|
+
if (!json) out.ok(`语言:${language.code}(${language.created ? '已新增' : '已存在'}${language.is_default ? ' · 默认' : ''})`);
|
|
447
|
+
} catch (e) {
|
|
448
|
+
language = { code: lang.code, created: false, error: (e && e.message) || String(e) };
|
|
449
|
+
warnings.push(`语言设置失败(站点已建,其余步骤继续):${language.error}`);
|
|
450
|
+
if (!json) out.warn(`语言设置失败(不影响建站):${language.error}`);
|
|
451
|
+
}
|
|
452
|
+
|
|
453
|
+
/* ---------------- ③ 模板(可选:模板市场已有 key) ---------------- */
|
|
454
|
+
let template = null;
|
|
455
|
+
if (templateKey) {
|
|
456
|
+
await guard('安装模板', async () => {
|
|
457
|
+
template = await installMarketTemplate(call, templateKey);
|
|
458
|
+
record('install_template', { market_key: template.market_key, template_id: template.template_id, files: template.file_count });
|
|
459
|
+
if (!json) out.ok(`模板已安装并启用:${template.market_name || template.market_key}(${template.file_count || '?'} 个文件)`);
|
|
460
|
+
if (template.requires_plugins.length) warnings.push(`模板依赖插件已由服务端处理:${template.requires_plugins.join(', ')}`);
|
|
461
|
+
});
|
|
462
|
+
}
|
|
463
|
+
|
|
464
|
+
/* ---------------- ④ 发布(可选) ---------------- */
|
|
465
|
+
let publish = null;
|
|
466
|
+
let probe = null;
|
|
467
|
+
let assetCheck = null;
|
|
468
|
+
if (wantPublish) {
|
|
469
|
+
await guard('发布', async () => {
|
|
470
|
+
publish = await publishAndWait(ctx, site.id);
|
|
471
|
+
record('publish', { job_id: publish.job_id, status: publish.status, total: publish.total, pages_failed: publish.pages_failed });
|
|
472
|
+
if (publish.status !== 'success' && publish.status !== 'partial') {
|
|
473
|
+
throw new CliError(`发布没成功(${publish.status})`, {
|
|
474
|
+
kind: 'error',
|
|
475
|
+
hint: (publish.errors[0] && publish.errors[0].message) || `看 \`wkgeo publish --site ${site.id} --json\``,
|
|
476
|
+
});
|
|
477
|
+
}
|
|
478
|
+
probe = await probeUrl(ctx, site.prefix_url);
|
|
479
|
+
record('probe', { url: site.prefix_url, status: probe && probe.status, bytes: probe && probe.bytes });
|
|
480
|
+
/**
|
|
481
|
+
* 发布后自检(task-46 C):首页有没有 `/assets/css/site-<hash>.css` 外链。
|
|
482
|
+
* **失败只告警不中断** —— 外链化开关在服务端,关掉它页面照样能开。
|
|
483
|
+
*/
|
|
484
|
+
assetCheck = checkAssetBundle(probe);
|
|
485
|
+
record('asset_bundle', {
|
|
486
|
+
ok: assetCheck.ok,
|
|
487
|
+
skipped: assetCheck.skipped,
|
|
488
|
+
externalized: assetCheck.externalized,
|
|
489
|
+
css_bundles: assetCheck.css_bundles,
|
|
490
|
+
js_bundles: assetCheck.js_bundles,
|
|
491
|
+
});
|
|
492
|
+
if (!assetCheck.ok && !assetCheck.skipped) {
|
|
493
|
+
warnings.push(assetCheck.reason);
|
|
494
|
+
}
|
|
495
|
+
if (!json) {
|
|
496
|
+
out.ok(`已发布(job ${publish.job_id},${publish.status})`);
|
|
497
|
+
if (probe) say(`短域首页:HTTP ${probe.status} · ${probe.bytes}B · 标题「${probe.title}」`);
|
|
498
|
+
if (assetCheck.externalized) {
|
|
499
|
+
say(`样式外链:${assetCheck.css_bundles[0]}${assetCheck.js_bundles.length ? ` · 脚本:${assetCheck.js_bundles[0]}` : ''}`);
|
|
500
|
+
} else if (assetCheck.skipped) {
|
|
501
|
+
say(`样式外链自检:${assetCheck.reason}`);
|
|
502
|
+
} else {
|
|
503
|
+
out.warn(`样式外链自检没通过(不影响发布结果):${assetCheck.reason}`);
|
|
504
|
+
}
|
|
505
|
+
}
|
|
506
|
+
});
|
|
507
|
+
} else if (!json) {
|
|
508
|
+
out.info('没有 --publish:站点内容还没发布到短域;加 --publish 或稍后 `wkgeo publish`。');
|
|
509
|
+
}
|
|
510
|
+
|
|
511
|
+
const data = {
|
|
512
|
+
ok: true,
|
|
513
|
+
siteId: site.id,
|
|
514
|
+
name: site.name || name,
|
|
515
|
+
prefixHost: site.prefix_host,
|
|
516
|
+
url: site.prefix_url,
|
|
517
|
+
published: Boolean(publish && (publish.status === 'success' || publish.status === 'partial')),
|
|
518
|
+
lang: language,
|
|
519
|
+
region,
|
|
520
|
+
template,
|
|
521
|
+
publish,
|
|
522
|
+
probe,
|
|
523
|
+
/** task-46:样式外链自检结果(externalized / skipped / ok + 命中的 bundle 地址) */
|
|
524
|
+
asset_bundle: assetCheck,
|
|
525
|
+
steps,
|
|
526
|
+
warnings,
|
|
527
|
+
};
|
|
528
|
+
if (!json) {
|
|
529
|
+
out.head('结果');
|
|
530
|
+
say(`站点 ID:${data.siteId}`);
|
|
531
|
+
say(`短域:${data.url || '(尚未分配)'}`);
|
|
532
|
+
say(`发布:${data.published ? `已发布(${publish.status})` : '未发布'}`);
|
|
533
|
+
for (const warn of warnings) out.info(` ⚠️ ${warn}`);
|
|
534
|
+
}
|
|
535
|
+
return data;
|
|
536
|
+
}
|