@wkgeo/cli 1.1.5 → 2.0.1

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.
@@ -1,435 +1,388 @@
1
- /**
2
- * 站点类命令(B4 / task-90):公司信息 / 域名巡检重检 / 示例内容 / 站级同步。
3
- *
4
- * ## 这一层是什么
5
- * task-90(2026-10-29)把 CMS `actionTable` 里的站点类动作搬进 CLI 自己的云函数
6
- * `wkgeo-cli-fc`(`src/site-core.js`,逐字复制 CMS handler)。因此这里的
7
- * **动作名 = 服务端动作名**(`siteInfoGet` / `siteInfoSave` / `cmsSiteDomainRecheck` …),
8
- * 参数名也照抄 CMS 后端 —— 两边一旦不一致,用户看到的就是"参数传了但没生效"。
9
- *
10
- * ## 三条口径(与 B1 内容面 / B3 发布面 / B7 配置面完全一致)
11
- * 1. **站点必须先定**:`--site` > `WKONGAI_SITE` > `wkgeo site use` 记住的那个;
12
- * 一个都没有就当场报用法错误(`siteCoreCall` 统一挡)。
13
- * 2. **写动作默认 dry-run**:不加 `--confirm` 只打印"将要发什么",一个写请求都不发。
14
- * 3. **默认人类可读,`--json` 给原始数据**(信封由 `runtime.done()` 统一包)。
15
- *
16
- * ## 权限面
17
- * * 读(`site info` / `domain inspection`)⇒ `site:read`
18
- * * 写(`site info save` / `site domain-recheck` / `site demo-seed` /
19
- * `site demo-clear` / `site sync`)⇒ `site:write`
20
- * * **服务端还会校验站点归属**:不是自己名下站一律 403 `not_site_owner`
21
- * (站不存在 / 已删除回 404,且不区分"从未创建"与"已删除",不泄露额外信息)
22
- *
23
- * ## 别在这里做的事
24
- * * ❌ 不走 `/cms` 转发面(B4 起这几条都改走 `/cli` 自持通道)
25
- * * ❌ 不在 CLI 侧拼 `site_id`:`siteCoreCall` 会塞 body.siteId,服务端只认自己名下
26
- * * ❌ 不做「建站」:`cmsCreateSite` **故意没迁** —— 建站早已是 `wkgeo site create`
27
- * (原生 `createSite` 动作),再迁一份就是双写同一批表
28
- * * ❌ 不做「域名占用量检查」:**故意的** —— `siteDomainCheck` 早就是 `/cli` 原生动作,
29
- * `wkgeo domain check` 已经在用它;CMS 的 `cmsSiteDomainCheck` 只是往
30
- * `wkgeo-domain` 转发一次的代理,迁过来等于同一能力两套实现 + 多一跳
31
- */
32
-
33
- import { UsageError } from '../errors.mjs';
34
- import { formatTime } from '../format.mjs';
35
-
36
- /* ------------------------------------------------------------------ 公共小工具 */
37
-
38
- /** 所有站点类命令共用的 `--site`(默认取 `wkgeo site use` 选中的站点) */
39
- const SITE_FLAG = {
40
- site: {
41
- type: 'string',
42
- desc: '站点 ID(uuid;默认用 `wkgeo site use` 选中的站点,可用 WKONGAI_SITE 覆盖)',
43
- },
44
- };
45
-
46
- /** 写动作的确认闸:不加就 dry-run */
47
- const CONFIRM_FLAG = {
48
- confirm: {
49
- type: 'boolean',
50
- desc: '真发(不加只打印将要发什么,一个写请求都不发)',
51
- },
52
- };
53
-
54
- function siteIdOf(ctx) {
55
- const site = ctx.cmsSite();
56
- return (site && site.id) || '';
57
- }
58
-
59
- function siteText(ctx) {
60
- const site = ctx.cmsSite();
61
- if (!site || !site.id) return '(未选站)';
62
- return site.label ? `${site.label}(${site.id})` : String(site.id);
63
- }
64
-
65
- /**
66
- * dry-run:把"将要发什么"打印出来就**结束**(不发请求、退出码 0)。
67
- *
68
- * `request` 也进 `--json`:agent 拿 dry-run 结果做二次确认时,需要能核对
69
- * "我要发的就是这些",光有人类文案不够机器读。
70
- */
71
- function dryRun(ctx, action, request, lines) {
72
- const data = {
73
- dry_run: true,
74
- action,
75
- site_id: siteIdOf(ctx),
76
- request,
77
- confirm_hint: '确认无误后加 --confirm 真发',
78
- };
79
- const { out } = ctx;
80
- if (!out.json) {
81
- out.head(`dry-run:${action}(没有发送任何写请求)`);
82
- out.line(` 站点:${siteText(ctx)}`);
83
- for (const l of lines || []) out.line(` ${l}`);
84
- out.line('');
85
- out.line(' 确认无误后加 --confirm 真发。');
86
- }
87
- ctx.done(data);
88
- return data;
89
- }
90
-
91
- /** 服务端动作名(同时用于 dry-run 回执里的 `action`) */
92
- const ACTION = {
93
- siteInfoGet: 'siteInfoGet',
94
- siteInfoSave: 'siteInfoSave',
95
- cmsSiteDomainRecheck: 'cmsSiteDomainRecheck',
96
- siteSeedDemo: 'siteSeedDemo',
97
- siteClearDemo: 'siteClearDemo',
98
- siteSync: 'siteSync',
99
- };
100
-
101
- /* ══════════════════════════════ 公司信息(site info) ══════════════════════════════ */
102
-
103
- export const siteInfoCommand = {
104
- name: 'site info',
105
- summary: '看站点公司信息(公司名称 / 网站标题 / SEO / 联系方式 / 素材;只读)',
106
- usage: 'wkgeo site info [--site <站点ID>] [--json]',
107
- args: [],
108
- flags: { ...SITE_FLAG },
109
- examples: ['wkgeo site info', 'wkgeo site info --json', 'wkgeo site info --site 3fb25881-…'],
110
- notes: [
111
- '需要 `site:read`(只读)。',
112
- '字段是**模板字段 ∪ 本站覆盖**(同 key 时本站行优先),只列启用的字段。',
113
- '★ 注意:站点第一次打开公司信息时,服务端会**幂等补建**预设字段行(`cms_field`,on conflict do nothing)——',
114
- ' 这是 CMS 的既有行为,本命令原样继承,不是"读接口偷偷写库"的新 bug。',
115
- ],
116
- async run(ctx) {
117
- const { out } = ctx;
118
- const res = (await ctx.siteCoreCall(ACTION.siteInfoGet)) || {};
119
- const fields = Array.isArray(res.fields) ? res.fields : [];
120
- const values = res.values && typeof res.values === 'object' ? res.values : {};
121
- const rows = fields.map((f) => {
122
- const one = f || {};
123
- const raw = values[one.key];
124
- return {
125
- key: String(one.key || ''),
126
- label: String(one.label || one.key || ''),
127
- type: String(one.type || ''),
128
- value: Array.isArray(raw) ? raw.join(', ') : raw === undefined || raw === null ? '' : String(raw),
129
- };
130
- });
131
- const data = {
132
- site_id: siteIdOf(ctx),
133
- version: Number(res.version || 0),
134
- updated_at: res.updated_at || null,
135
- fields: rows,
136
- values,
137
- };
138
-
139
- if (!out.json) {
140
- out.head(`公司信息(站点 ${siteText(ctx)} · v${data.version})`);
141
- if (!rows.length) {
142
- out.line(' (还没有字段定义:CMS 后台「公司信息」页打开一次就会补建预设字段)');
143
- } else {
144
- out.table(
145
- [
146
- { title: '字段', key: 'key', width: 18 },
147
- { title: '名称', key: 'label', width: 14 },
148
- { title: '值', key: 'value', width: 60 },
149
- ],
150
- rows.map((one) => ({ ...one, value: one.value.length > 58 ? `${one.value.slice(0, 57)}…` : one.value })),
151
- );
152
- }
153
- if (data.updated_at) out.line(` 最近保存:${formatTime(data.updated_at)}`);
154
- }
155
- ctx.done(data);
156
- return data;
157
- },
158
- };
159
-
160
- export const siteInfoSaveCommand = {
161
- name: 'site info save',
162
- summary: '保存公司信息(常用字段有专参,其余用 --values 传 JSON;默认 dry-run)',
163
- usage:
164
- 'wkgeo site info save [--company-name <名称>] [--site-title <标题>] [--keywords <词>] [--description <描述>] [--values <JSON>] [--confirm] [--site <站点ID>]',
165
- args: [],
166
- flags: {
167
- 'company-name': { type: 'string', desc: '公司名称(必填字段,服务端会校验)' },
168
- 'site-title': { type: 'string', desc: '网站标题(浏览器标签 / 搜索结果标题)' },
169
- keywords: { type: 'string', desc: '关键词,逗号分隔' },
170
- description: { type: 'string', desc: '网站描述(搜索结果里的一两句话)' },
171
- values: { type: 'string', desc: '其余字段的 JSON:{"icpNumber":"…","contactMobile":"…"}(键 = 字段 key)' },
172
- ...CONFIRM_FLAG,
173
- ...SITE_FLAG,
174
- },
175
- examples: [
176
- 'wkgeo site info save --company-name 示例科技有限公司 # dry-run',
177
- 'wkgeo site info save --company-name 示例科技有限公司 --confirm # 真存',
178
- 'wkgeo site info save --keywords "官网, 产品" --values \'{"icpNumber":"浙ICP备00000000号"}\' --confirm',
179
- ],
180
- notes: [
181
- '需要 `site:write`。**默认 dry-run**,加 `--confirm` 才真发。',
182
- '只发**这次给了的键**:没给的字段保持原值(服务端按旧值当基线合并)。',
183
- '只发**该站字段定义里有的键**:库里没定义的键会被忽略(删掉字段后前端还传也不会写进去)。',
184
- '服务端会校验:必填字段不能空 + 字段级规则(长度 / 数字范围 / 图片大小格式)。',
185
- '**版本号会 +1**(`cms_site_company.version`),可以用 `wkgeo site info` 复核。',
186
- ],
187
- async run(ctx) {
188
- const values = {};
189
- const put = (key, raw) => {
190
- if (raw === undefined) return;
191
- const text = String(raw);
192
- if (text === '') return;
193
- values[key] = text;
194
- };
195
- put('companyName', ctx.flags.companyName);
196
- put('siteTitle', ctx.flags.siteTitle);
197
- put('keywords', ctx.flags.keywords);
198
- put('siteDescription', ctx.flags.description);
199
-
200
- const rawValues = ctx.flags.values;
201
- if (rawValues !== undefined) {
202
- let parsed;
203
- try {
204
- parsed = JSON.parse(String(rawValues));
205
- } catch (e) {
206
- throw new UsageError(`--values 不是合法 JSON:${e && e.message ? e.message : e}`);
207
- }
208
- if (!parsed || typeof parsed !== 'object' || Array.isArray(parsed)) {
209
- throw new UsageError('--values 必须是对象:{"icpNumber":"浙ICP备00000000号"}');
210
- }
211
- for (const [k, v] of Object.entries(parsed)) values[k] = v;
212
- }
213
-
214
- if (!Object.keys(values).length) {
215
- throw new UsageError(
216
- '至少给一个字段:--company-name / --site-title / --keywords / --description / --values \'{"字段":值}\'',
217
- );
218
- }
219
-
220
- const body = { values };
221
- const lines = Object.entries(values).map(([k, v]) => `${k}:${Array.isArray(v) ? v.join(', ') : String(v)}`);
222
- if (!ctx.flags.confirm) return dryRun(ctx, ACTION.siteInfoSave, body, lines);
223
-
224
- const { out } = ctx;
225
- const res = (await ctx.siteCoreCall(ACTION.siteInfoSave, body)) || {};
226
- const data = {
227
- site_id: siteIdOf(ctx),
228
- saved: true,
229
- version: Number(res.version || 0),
230
- updated_at: res.updated_at || null,
231
- values: res.values && typeof res.values === 'object' ? res.values : values,
232
- };
233
- if (!out.json) {
234
- out.ok(`公司信息已保存(v${data.version}${data.updated_at ? ` · ${formatTime(data.updated_at)}` : ''})`);
235
- out.line(` 改了 ${Object.keys(values).length} 个字段:${Object.keys(values).join(', ')}`);
236
- }
237
- ctx.done(data);
238
- return data;
239
- },
240
- };
241
-
242
- /* ══════════════════════════════ 域名重新检测 ══════════════════════════════ */
243
-
244
- export const siteDomainRecheckCommand = {
245
- name: 'site domain-recheck',
246
- summary: '提交域名重新检测(只把巡检游标提前,10 分钟内后台重查 TXT / CNAME;默认 dry-run)',
247
- usage: 'wkgeo site domain-recheck [域名] [--confirm] [--site <站点ID>]',
248
- args: [{ name: 'hostname', required: false, desc: '只重检这一个域名(不写 = 该站全部域名)' }],
249
- flags: { ...CONFIRM_FLAG, ...SITE_FLAG },
250
- examples: [
251
- 'wkgeo site domain-recheck # dry-run:本站在巡检里的域名全排一遍',
252
- 'wkgeo site domain-recheck www.example.com # dry-run:只排这一个域名',
253
- 'wkgeo site domain-recheck www.example.com --confirm',
254
- ],
255
- notes: [
256
- '需要 `site:write`。**默认 dry-run**,加 `--confirm` 才真发。',
257
- '它**不做**解析检测本身:只把 `site_domain.next_check_at` / `site.next_check_at` 置为 now(),',
258
- ' 后台巡检(10 分钟一轮)pick 到之后才真查 —— 所以 `queued` 是"排上了几个域名行"。',
259
- '查完的状态用 `wkgeo domain inspection` 看(`poll_after_ms` = 建议轮询间隔)。',
260
- '`degraded:true` = 域名表结构没就绪(迁移没跑),命令不报错但要提示。',
261
- ],
262
- async run(ctx) {
263
- const hostname = String(ctx.positional.hostname || '').trim();
264
- const body = hostname ? { hostname } : {};
265
- const lines = [hostname ? `域名:${hostname}` : '范围:本站全部域名', '效果:巡检游标置为 now(),10 分钟内重查'];
266
- if (!ctx.flags.confirm) return dryRun(ctx, ACTION.cmsSiteDomainRecheck, body, lines);
267
-
268
- const { out } = ctx;
269
- const res = (await ctx.siteCoreCall(ACTION.cmsSiteDomainRecheck, body)) || {};
270
- const data = {
271
- site_id: siteIdOf(ctx),
272
- hostname: res.hostname || hostname || null,
273
- queued: Number(res.queued || 0),
274
- poll_after_ms: Number(res.poll_after_ms || 600000),
275
- queued_at: res.queued_at || null,
276
- degraded: Boolean(res.degraded),
277
- message: String(res.message || ''),
278
- };
279
- if (!out.json) {
280
- out.ok(`已提交重新检测:排上 ${data.queued} 个域名行${data.hostname ? `(${data.hostname})` : ''}`);
281
- if (data.message) out.line(` ${data.message}`);
282
- if (data.degraded) out.line(' ⚠️ degraded:域名表结构未就绪,巡检可能拿不到这一站');
283
- }
284
- ctx.done(data);
285
- return data;
286
- },
287
- };
288
-
289
- /* ══════════════════════════════ 示例内容(demo) ══════════════════════════════ */
290
-
291
- export const siteDemoSeedCommand = {
292
- name: 'site demo-seed',
293
- summary: '导入行业示例内容(栏目 / 内容 / 素材 / 标签,全部打 is_demo 标记,可被 demo-clear 回收)',
294
- usage: 'wkgeo site demo-seed [--demo <行业包>] [--template <模板ID>] [--confirm] [--site <站点ID>]',
295
- args: [],
296
- flags: {
297
- demo: { type: 'string', desc: '行业包 key(enterprise / restaurant / …;不写就用模板自带的那套)' },
298
- template: { type: 'string', desc: '模板 ID(不写用本站启用中的模板)' },
299
- ...CONFIRM_FLAG,
300
- ...SITE_FLAG,
301
- },
302
- examples: [
303
- 'wkgeo site demo-seed # dry-run:看会用哪个行业包',
304
- 'wkgeo site demo-seed --confirm # 真导',
305
- 'wkgeo site demo-seed --demo enterprise --confirm',
306
- ],
307
- notes: [
308
- '需要 `site:write`。**默认 dry-run**,加 `--confirm` 才真发。',
309
- '**幂等**:栏目按 `path` 复用、内容按(栏目 + slug)跳过 ⇒ 连导两次不会重复建。',
310
- '只导**代码内置**那份行业包(`template-demos.js`):CLI 侧不读模板桶,不为预览数据等一次 OSS 超时。',
311
- '导入的东西都带标记(`is_demo=true` / `ext.demo=true` / `asset.key like demo/%`)⇒ 可用 `site demo-clear` 一次性回收,',
312
- ' **不会碰你自己建的内容与素材**。',
313
- ],
314
- async run(ctx) {
315
- const body = {};
316
- if (ctx.flags.demo !== undefined) body.demo = String(ctx.flags.demo);
317
- if (ctx.flags.template !== undefined) body.templateId = String(ctx.flags.template);
318
- const lines = [
319
- `行业包:${body.demo || '(模板自带)'}`,
320
- `模板:${body.templateId || '(本站启用中的模板)'}`,
321
- '效果:建栏目 / 内容 / 素材 / 标签(都打 is_demo 标记,可被 site demo-clear 回收)',
322
- ];
323
- if (!ctx.flags.confirm) return dryRun(ctx, ACTION.siteSeedDemo, body, lines);
324
-
325
- const { out } = ctx;
326
- const res = (await ctx.siteCoreCall(ACTION.siteSeedDemo, body)) || {};
327
- const data = {
328
- site_id: siteIdOf(ctx),
329
- template_id: res.templateId || '',
330
- template_name: res.templateName || '',
331
- demo_key: res.demoKey || '',
332
- demo_industry: res.demoIndustry || '',
333
- categories: Number(res.categories || 0),
334
- reused_categories: Number(res.reusedCategories || 0),
335
- contents: Number(res.contents || 0),
336
- skipped_contents: Number(res.skippedContents || 0),
337
- assets: Number(res.assets || 0),
338
- tags: Number(res.tags || 0),
339
- };
340
- if (!out.json) {
341
- out.ok(`示例内容已导入(${data.demo_industry || data.demo_key || '未知行业包'})`);
342
- out.line(
343
- ` 栏目 ${data.categories} 个(复用 ${data.reused_categories})· 内容 ${data.contents} 条(跳过 ${data.skipped_contents})· 素材 ${data.assets} 张 · 标签 ${data.tags} 个`,
344
- );
345
- out.line(' 回收:wkgeo site demo-clear --confirm');
346
- }
347
- ctx.done(data);
348
- return data;
349
- },
350
- };
351
-
352
- export const siteDemoClearCommand = {
353
- name: 'site demo-clear',
354
- summary: '清空示例内容(只删 is_demo / ext.demo / demo% 素材,不碰客户自建内容)',
355
- usage: 'wkgeo site demo-clear [--confirm] [--site <站点ID>]',
356
- args: [],
357
- flags: { ...CONFIRM_FLAG, ...SITE_FLAG },
358
- examples: ['wkgeo site demo-clear', 'wkgeo site demo-clear --confirm'],
359
- notes: [
360
- '需要 `site:write`。**默认 dry-run**,加 `--confirm` 才真删。',
361
- '只删三类带标记的行:`cms_content.ext.demo=true`、`cms_category.is_demo=true`(从最深一层往上)、',
362
- ' `asset.key like \'demo/%\'` 且已经没人引用的素材。',
363
- '**你自己建的内容 / 你上传的素材一条都不会动**(这是这条命令与"清空全站"的区别)。',
364
- '删除不可恢复:要先留档就先 `wkgeo content list` 导一份。',
365
- ],
366
- async run(ctx) {
367
- if (!ctx.flags.confirm) {
368
- return dryRun(ctx, ACTION.siteClearDemo, {}, [
369
- '效果:删掉示例内容 / 示例栏目 / 示例素材(都带 is_demo 标记的那批)',
370
- '不动:客户自建内容与自传素材',
371
- ]);
372
- }
373
-
374
- const { out } = ctx;
375
- const res = (await ctx.siteCoreCall(ACTION.siteClearDemo, {})) || {};
376
- const data = {
377
- site_id: siteIdOf(ctx),
378
- contents: Number(res.contents || 0),
379
- categories: Number(res.categories || 0),
380
- assets: Number(res.assets || 0),
381
- };
382
- if (!out.json) {
383
- out.ok(`示例内容已清空:内容 ${data.contents} 条 · 栏目 ${data.categories} 个 · 素材 ${data.assets} 张`);
384
- }
385
- ctx.done(data);
386
- return data;
387
- },
388
- };
389
-
390
- /* ══════════════════════════════ 站级同步 ══════════════════════════════ */
391
-
392
- export const siteSyncCommand = {
393
- name: 'site sync',
394
- summary: '把站点同步到会员中心(站点表合并后是 no-op,回 skipped=merged-into-site)',
395
- usage: 'wkgeo site sync [--confirm] [--site <站点ID>]',
396
- args: [],
397
- flags: { ...CONFIRM_FLAG, ...SITE_FLAG },
398
- examples: ['wkgeo site sync', 'wkgeo site sync --confirm'],
399
- notes: [
400
- '需要 `site:write`。**默认 dry-run**,加 `--confirm` 才真发。',
401
- '★ 2026-10-22 站点表合并成 `public.site` 之后,CMS 侧「同步到会员中心」**本身就是空操作**',
402
- ' (实现只剩一句 `skipped: merged-into-site` 的日志)—— 这条命令保留是为了让老脚本能跑通、',
403
- ' 并给出"现在不需要同步了"的明确回执,不是真在搬数据。',
404
- ],
405
- async run(ctx) {
406
- if (!ctx.flags.confirm) {
407
- return dryRun(ctx, ACTION.siteSync, {}, ['效果:站级同步(当前实现是 no-op,会回 skipped=merged-into-site)']);
408
- }
409
-
410
- const { out } = ctx;
411
- const res = (await ctx.siteCoreCall(ACTION.siteSync, {})) || {};
412
- const data = {
413
- site_id: siteIdOf(ctx),
414
- ok: res.ok !== false,
415
- skipped: res.skipped || '',
416
- result_site_id: res.siteId || '',
417
- };
418
- if (!out.json) {
419
- if (data.skipped === 'merged-into-site') out.ok('站点表已合并:同步是空操作(skipped=merged-into-site),无需再同步');
420
- else out.ok(`同步已完成${data.skipped ? `(skipped=${data.skipped})` : ''}`);
421
- }
422
- ctx.done(data);
423
- return data;
424
- },
425
- };
426
-
427
- /** 站点类命令(B4 / task-90):注册顺序即 `wkgeo site --help` 的列法 */
428
- export const SITE_COMMANDS = [
429
- siteInfoCommand,
430
- siteInfoSaveCommand,
431
- siteDomainRecheckCommand,
432
- siteDemoSeedCommand,
433
- siteDemoClearCommand,
434
- siteSyncCommand,
435
- ];
1
+ /**
2
+ * 站点类命令(B4 / task-90):公司信息 / 示例内容 / 站级同步。
3
+ *
4
+ * ★ 2026-11-19 task-1250(老板:CLI 只做 CMS 内容管理,跟域名没关系):
5
+ * `site domain-recheck`(域名重检)已从命令面删除;后端 `cmsSiteDomainRecheck` /
6
+ * `cmsSiteDomainInspectionList` 两条**仍在 site-core.js**(属站点设置,本单未动,待老板拍板)。
7
+ *
8
+ * ## 这一层是什么
9
+ * task-90(2026-10-29)把 CMS `actionTable` 里的站点类动作搬进 CLI 自己的云函数
10
+ * `wkgeo-cli-fc`(`src/site-core.js`,逐字复制 CMS handler)。因此这里的
11
+ * **动作名 = 服务端动作名**(`siteInfoGet` / `siteInfoSave` / `siteSeedDemo` …),
12
+ * 参数名也照抄 CMS 后端 —— 两边一旦不一致,用户看到的就是"参数传了但没生效"。
13
+ *
14
+ * ## 三条口径(与 B1 内容面 / B3 发布面 / B7 配置面完全一致)
15
+ * 1. **站点必须先定**:`--site` > `WKONGAI_SITE` > `wkgeo site use` 记住的那个;
16
+ * 一个都没有就当场报用法错误(`siteCoreCall` 统一挡)。
17
+ * 2. **写动作默认 dry-run**:不加 `--confirm` 只打印"将要发什么",一个写请求都不发。
18
+ * 3. **默认人类可读,`--json` 给原始数据**(信封由 `runtime.done()` 统一包)。
19
+ *
20
+ * ## 权限面
21
+ * * 读(`site info`)⇒ `site:read`
22
+ * * 写(`site info save` / `site demo-seed` / `site demo-clear` / `site sync`)⇒ `site:write`
23
+ * * **服务端还会校验站点归属**:不是自己名下站一律 403 `not_site_owner`
24
+ * (站不存在 / 已删除回 404,且不区分"从未创建"与"已删除",不泄露额外信息)
25
+ *
26
+ * ## 别在这里做的事
27
+ * * ❌ 不走 `/cms` 转发面(B4 起这几条都改走 `/cli` 自持通道)
28
+ * * ❌ 不在 CLI 侧拼 `site_id`:`siteCoreCall` 会塞 body.siteId,服务端只认自己名下
29
+ * * ❌ 不做「建站」:`cmsCreateSite` **故意没迁** —— 建站早已是 `wkgeo site create`
30
+ * (原生 `createSite` 动作),再迁一份就是双写同一批表
31
+ * * ❌ 不做任何域名操作(解析 / 巡检 / 绑定 / 重检):2026-11-19 task-1250 起 CLI 不碰域名,
32
+ * 这类能力只在 wkgeo-domain / 超管后台 / 会员中心
33
+ */
34
+
35
+ import { UsageError } from '../errors.mjs';
36
+ import { formatTime } from '../format.mjs';
37
+
38
+ /* ------------------------------------------------------------------ 公共小工具 */
39
+
40
+ /** 所有站点类命令共用的 `--site`(默认取 `wkgeo site use` 选中的站点) */
41
+ const SITE_FLAG = {
42
+ site: {
43
+ type: 'string',
44
+ desc: '站点 ID(uuid;默认用 `wkgeo site use` 选中的站点,可用 WKONGAI_SITE 覆盖)',
45
+ },
46
+ };
47
+
48
+ /** 写动作的确认闸:不加就 dry-run */
49
+ const CONFIRM_FLAG = {
50
+ confirm: {
51
+ type: 'boolean',
52
+ desc: '真发(不加只打印将要发什么,一个写请求都不发)',
53
+ },
54
+ };
55
+
56
+ function siteIdOf(ctx) {
57
+ const site = ctx.cmsSite();
58
+ return (site && site.id) || '';
59
+ }
60
+
61
+ function siteText(ctx) {
62
+ const site = ctx.cmsSite();
63
+ if (!site || !site.id) return '(未选站)';
64
+ return site.label ? `${site.label}(${site.id})` : String(site.id);
65
+ }
66
+
67
+ /**
68
+ * dry-run:把"将要发什么"打印出来就**结束**(不发请求、退出码 0)。
69
+ *
70
+ * `request` 也进 `--json`:agent 拿 dry-run 结果做二次确认时,需要能核对
71
+ * "我要发的就是这些",光有人类文案不够机器读。
72
+ */
73
+ function dryRun(ctx, action, request, lines) {
74
+ const data = {
75
+ dry_run: true,
76
+ action,
77
+ site_id: siteIdOf(ctx),
78
+ request,
79
+ confirm_hint: '确认无误后加 --confirm 真发',
80
+ };
81
+ const { out } = ctx;
82
+ if (!out.json) {
83
+ out.head(`dry-run:${action}(没有发送任何写请求)`);
84
+ out.line(` 站点:${siteText(ctx)}`);
85
+ for (const l of lines || []) out.line(` ${l}`);
86
+ out.line('');
87
+ out.line(' 确认无误后加 --confirm 真发。');
88
+ }
89
+ ctx.done(data);
90
+ return data;
91
+ }
92
+
93
+ /** 服务端动作名(同时用于 dry-run 回执里的 `action`) */
94
+ const ACTION = {
95
+ siteInfoGet: 'siteInfoGet',
96
+ siteInfoSave: 'siteInfoSave',
97
+ siteSeedDemo: 'siteSeedDemo',
98
+ siteClearDemo: 'siteClearDemo',
99
+ siteSync: 'siteSync',
100
+ };
101
+
102
+ /* ══════════════════════════════ 公司信息(site info) ══════════════════════════════ */
103
+
104
+ export const siteInfoCommand = {
105
+ name: 'site info',
106
+ summary: '看站点公司信息(公司名称 / 网站标题 / SEO / 联系方式 / 素材;只读)',
107
+ usage: 'wkgeo site info [--site <站点ID>] [--json]',
108
+ args: [],
109
+ flags: { ...SITE_FLAG },
110
+ examples: ['wkgeo site info', 'wkgeo site info --json', 'wkgeo site info --site 3fb25881-…'],
111
+ notes: [
112
+ '需要 `site:read`(只读)。',
113
+ '字段是**模板字段 ∪ 本站覆盖**(同 key 时本站行优先),只列启用的字段。',
114
+ '★ 注意:站点第一次打开公司信息时,服务端会**幂等补建**预设字段行(`cms_field`,on conflict do nothing)——',
115
+ ' 这是 CMS 的既有行为,本命令原样继承,不是"读接口偷偷写库"的新 bug。',
116
+ ],
117
+ async run(ctx) {
118
+ const { out } = ctx;
119
+ const res = (await ctx.siteCoreCall(ACTION.siteInfoGet)) || {};
120
+ const fields = Array.isArray(res.fields) ? res.fields : [];
121
+ const values = res.values && typeof res.values === 'object' ? res.values : {};
122
+ const rows = fields.map((f) => {
123
+ const one = f || {};
124
+ const raw = values[one.key];
125
+ return {
126
+ key: String(one.key || ''),
127
+ label: String(one.label || one.key || ''),
128
+ type: String(one.type || ''),
129
+ value: Array.isArray(raw) ? raw.join(', ') : raw === undefined || raw === null ? '' : String(raw),
130
+ };
131
+ });
132
+ const data = {
133
+ site_id: siteIdOf(ctx),
134
+ version: Number(res.version || 0),
135
+ updated_at: res.updated_at || null,
136
+ fields: rows,
137
+ values,
138
+ };
139
+
140
+ if (!out.json) {
141
+ out.head(`公司信息(站点 ${siteText(ctx)} · v${data.version})`);
142
+ if (!rows.length) {
143
+ out.line(' (还没有字段定义:CMS 后台「公司信息」页打开一次就会补建预设字段)');
144
+ } else {
145
+ out.table(
146
+ [
147
+ { title: '字段', key: 'key', width: 18 },
148
+ { title: '名称', key: 'label', width: 14 },
149
+ { title: '值', key: 'value', width: 60 },
150
+ ],
151
+ rows.map((one) => ({ ...one, value: one.value.length > 58 ? `${one.value.slice(0, 57)}…` : one.value })),
152
+ );
153
+ }
154
+ if (data.updated_at) out.line(` 最近保存:${formatTime(data.updated_at)}`);
155
+ }
156
+ ctx.done(data);
157
+ return data;
158
+ },
159
+ };
160
+
161
+ export const siteInfoSaveCommand = {
162
+ name: 'site info save',
163
+ summary: '保存公司信息(常用字段有专参,其余用 --values 传 JSON;默认 dry-run)',
164
+ usage:
165
+ 'wkgeo site info save [--company-name <名称>] [--site-title <标题>] [--keywords <词>] [--description <描述>] [--values <JSON>] [--confirm] [--site <站点ID>]',
166
+ args: [],
167
+ flags: {
168
+ 'company-name': { type: 'string', desc: '公司名称(必填字段,服务端会校验)' },
169
+ 'site-title': { type: 'string', desc: '网站标题(浏览器标签 / 搜索结果标题)' },
170
+ keywords: { type: 'string', desc: '关键词,逗号分隔' },
171
+ description: { type: 'string', desc: '网站描述(搜索结果里的一两句话)' },
172
+ values: { type: 'string', desc: '其余字段的 JSON:{"icpNumber":"…","contactMobile":"…"}(键 = 字段 key)' },
173
+ ...CONFIRM_FLAG,
174
+ ...SITE_FLAG,
175
+ },
176
+ examples: [
177
+ 'wkgeo site info save --company-name 示例科技有限公司 # dry-run',
178
+ 'wkgeo site info save --company-name 示例科技有限公司 --confirm # 真存',
179
+ 'wkgeo site info save --keywords "官网, 产品" --values \'{"icpNumber":"浙ICP备00000000号"}\' --confirm',
180
+ ],
181
+ notes: [
182
+ '需要 `site:write`。**默认 dry-run**,加 `--confirm` 才真发。',
183
+ '只发**这次给了的键**:没给的字段保持原值(服务端按旧值当基线合并)。',
184
+ '只发**该站字段定义里有的键**:库里没定义的键会被忽略(删掉字段后前端还传也不会写进去)。',
185
+ '服务端会校验:必填字段不能空 + 字段级规则(长度 / 数字范围 / 图片大小格式)。',
186
+ '**版本号会 +1**(`cms_site_company.version`),可以用 `wkgeo site info` 复核。',
187
+ ],
188
+ async run(ctx) {
189
+ const values = {};
190
+ const put = (key, raw) => {
191
+ if (raw === undefined) return;
192
+ const text = String(raw);
193
+ if (text === '') return;
194
+ values[key] = text;
195
+ };
196
+ put('companyName', ctx.flags.companyName);
197
+ put('siteTitle', ctx.flags.siteTitle);
198
+ put('keywords', ctx.flags.keywords);
199
+ put('siteDescription', ctx.flags.description);
200
+
201
+ const rawValues = ctx.flags.values;
202
+ if (rawValues !== undefined) {
203
+ let parsed;
204
+ try {
205
+ parsed = JSON.parse(String(rawValues));
206
+ } catch (e) {
207
+ throw new UsageError(`--values 不是合法 JSON:${e && e.message ? e.message : e}`);
208
+ }
209
+ if (!parsed || typeof parsed !== 'object' || Array.isArray(parsed)) {
210
+ throw new UsageError('--values 必须是对象:{"icpNumber":"浙ICP备00000000号"}');
211
+ }
212
+ for (const [k, v] of Object.entries(parsed)) values[k] = v;
213
+ }
214
+
215
+ if (!Object.keys(values).length) {
216
+ throw new UsageError(
217
+ '至少给一个字段:--company-name / --site-title / --keywords / --description / --values \'{"字段":值}\'',
218
+ );
219
+ }
220
+
221
+ const body = { values };
222
+ const lines = Object.entries(values).map(([k, v]) => `${k}:${Array.isArray(v) ? v.join(', ') : String(v)}`);
223
+ if (!ctx.flags.confirm) return dryRun(ctx, ACTION.siteInfoSave, body, lines);
224
+
225
+ const { out } = ctx;
226
+ const res = (await ctx.siteCoreCall(ACTION.siteInfoSave, body)) || {};
227
+ const data = {
228
+ site_id: siteIdOf(ctx),
229
+ saved: true,
230
+ version: Number(res.version || 0),
231
+ updated_at: res.updated_at || null,
232
+ values: res.values && typeof res.values === 'object' ? res.values : values,
233
+ };
234
+ if (!out.json) {
235
+ out.ok(`公司信息已保存(v${data.version}${data.updated_at ? ` · ${formatTime(data.updated_at)}` : ''})`);
236
+ out.line(` 改了 ${Object.keys(values).length} 个字段:${Object.keys(values).join(', ')}`);
237
+ }
238
+ ctx.done(data);
239
+ return data;
240
+ },
241
+ };
242
+
243
+ /* ══════════════════════════════ 示例内容(demo) ══════════════════════════════ */
244
+
245
+ export const siteDemoSeedCommand = {
246
+ name: 'site demo-seed',
247
+ summary: '导入行业示例内容(栏目 / 内容 / 素材 / 标签,全部打 is_demo 标记,可被 demo-clear 回收)',
248
+ usage: 'wkgeo site demo-seed [--demo <行业包>] [--template <模板ID>] [--confirm] [--site <站点ID>]',
249
+ args: [],
250
+ flags: {
251
+ demo: { type: 'string', desc: '行业包 key(enterprise / restaurant / …;不写就用模板自带的那套)' },
252
+ template: { type: 'string', desc: '模板 ID(不写用本站启用中的模板)' },
253
+ ...CONFIRM_FLAG,
254
+ ...SITE_FLAG,
255
+ },
256
+ examples: [
257
+ 'wkgeo site demo-seed # dry-run:看会用哪个行业包',
258
+ 'wkgeo site demo-seed --confirm # 真导',
259
+ 'wkgeo site demo-seed --demo enterprise --confirm',
260
+ ],
261
+ notes: [
262
+ '需要 `site:write`。**默认 dry-run**,加 `--confirm` 才真发。',
263
+ '**幂等**:栏目按 `path` 复用、内容按(栏目 + slug)跳过 ⇒ 连导两次不会重复建。',
264
+ '只导**代码内置**那份行业包(`template-demos.js`):CLI 侧不读模板桶,不为预览数据等一次 OSS 超时。',
265
+ '导入的东西都带标记(`is_demo=true` / `ext.demo=true` / `asset.key like demo/%`)⇒ 可用 `site demo-clear` 一次性回收,',
266
+ ' **不会碰你自己建的内容与素材**。',
267
+ ],
268
+ async run(ctx) {
269
+ const body = {};
270
+ if (ctx.flags.demo !== undefined) body.demo = String(ctx.flags.demo);
271
+ if (ctx.flags.template !== undefined) body.templateId = String(ctx.flags.template);
272
+ const lines = [
273
+ `行业包:${body.demo || '(模板自带)'}`,
274
+ `模板:${body.templateId || '(本站启用中的模板)'}`,
275
+ '效果:建栏目 / 内容 / 素材 / 标签(都打 is_demo 标记,可被 site demo-clear 回收)',
276
+ ];
277
+ if (!ctx.flags.confirm) return dryRun(ctx, ACTION.siteSeedDemo, body, lines);
278
+
279
+ const { out } = ctx;
280
+ const res = (await ctx.siteCoreCall(ACTION.siteSeedDemo, body)) || {};
281
+ const data = {
282
+ site_id: siteIdOf(ctx),
283
+ template_id: res.templateId || '',
284
+ template_name: res.templateName || '',
285
+ demo_key: res.demoKey || '',
286
+ demo_industry: res.demoIndustry || '',
287
+ categories: Number(res.categories || 0),
288
+ reused_categories: Number(res.reusedCategories || 0),
289
+ contents: Number(res.contents || 0),
290
+ skipped_contents: Number(res.skippedContents || 0),
291
+ assets: Number(res.assets || 0),
292
+ tags: Number(res.tags || 0),
293
+ };
294
+ if (!out.json) {
295
+ out.ok(`示例内容已导入(${data.demo_industry || data.demo_key || '未知行业包'})`);
296
+ out.line(
297
+ ` 栏目 ${data.categories} 个(复用 ${data.reused_categories})· 内容 ${data.contents} 条(跳过 ${data.skipped_contents})· 素材 ${data.assets} 张 · 标签 ${data.tags} 个`,
298
+ );
299
+ out.line(' 回收:wkgeo site demo-clear --confirm');
300
+ }
301
+ ctx.done(data);
302
+ return data;
303
+ },
304
+ };
305
+
306
+ export const siteDemoClearCommand = {
307
+ name: 'site demo-clear',
308
+ summary: '清空示例内容(只删 is_demo / ext.demo / demo% 素材,不碰客户自建内容)',
309
+ usage: 'wkgeo site demo-clear [--confirm] [--site <站点ID>]',
310
+ args: [],
311
+ flags: { ...CONFIRM_FLAG, ...SITE_FLAG },
312
+ examples: ['wkgeo site demo-clear', 'wkgeo site demo-clear --confirm'],
313
+ notes: [
314
+ '需要 `site:write`。**默认 dry-run**,加 `--confirm` 才真删。',
315
+ '只删三类带标记的行:`cms_content.ext.demo=true`、`cms_category.is_demo=true`(从最深一层往上)、',
316
+ ' `asset.key like \'demo/%\'` 且已经没人引用的素材。',
317
+ '**你自己建的内容 / 你上传的素材一条都不会动**(这是这条命令与"清空全站"的区别)。',
318
+ '删除不可恢复:要先留档就先 `wkgeo content list` 导一份。',
319
+ ],
320
+ async run(ctx) {
321
+ if (!ctx.flags.confirm) {
322
+ return dryRun(ctx, ACTION.siteClearDemo, {}, [
323
+ '效果:删掉示例内容 / 示例栏目 / 示例素材(都带 is_demo 标记的那批)',
324
+ '不动:客户自建内容与自传素材',
325
+ ]);
326
+ }
327
+
328
+ const { out } = ctx;
329
+ const res = (await ctx.siteCoreCall(ACTION.siteClearDemo, {})) || {};
330
+ const data = {
331
+ site_id: siteIdOf(ctx),
332
+ contents: Number(res.contents || 0),
333
+ categories: Number(res.categories || 0),
334
+ assets: Number(res.assets || 0),
335
+ };
336
+ if (!out.json) {
337
+ out.ok(`示例内容已清空:内容 ${data.contents} 条 · 栏目 ${data.categories} 个 · 素材 ${data.assets} 张`);
338
+ }
339
+ ctx.done(data);
340
+ return data;
341
+ },
342
+ };
343
+
344
+ /* ══════════════════════════════ 站级同步 ══════════════════════════════ */
345
+
346
+ export const siteSyncCommand = {
347
+ name: 'site sync',
348
+ summary: '把站点同步到会员中心(站点表合并后是 no-op,回 skipped=merged-into-site)',
349
+ usage: 'wkgeo site sync [--confirm] [--site <站点ID>]',
350
+ args: [],
351
+ flags: { ...CONFIRM_FLAG, ...SITE_FLAG },
352
+ examples: ['wkgeo site sync', 'wkgeo site sync --confirm'],
353
+ notes: [
354
+ '需要 `site:write`。**默认 dry-run**,加 `--confirm` 才真发。',
355
+ '★ 2026-10-22 站点表合并成 `public.site` 之后,CMS 侧「同步到会员中心」**本身就是空操作**',
356
+ ' (实现只剩一句 `skipped: merged-into-site` 的日志)—— 这条命令保留是为了让老脚本能跑通、',
357
+ ' 并给出"现在不需要同步了"的明确回执,不是真在搬数据。',
358
+ ],
359
+ async run(ctx) {
360
+ if (!ctx.flags.confirm) {
361
+ return dryRun(ctx, ACTION.siteSync, {}, ['效果:站级同步(当前实现是 no-op,会回 skipped=merged-into-site)']);
362
+ }
363
+
364
+ const { out } = ctx;
365
+ const res = (await ctx.siteCoreCall(ACTION.siteSync, {})) || {};
366
+ const data = {
367
+ site_id: siteIdOf(ctx),
368
+ ok: res.ok !== false,
369
+ skipped: res.skipped || '',
370
+ result_site_id: res.siteId || '',
371
+ };
372
+ if (!out.json) {
373
+ if (data.skipped === 'merged-into-site') out.ok('站点表已合并:同步是空操作(skipped=merged-into-site),无需再同步');
374
+ else out.ok(`同步已完成${data.skipped ? `(skipped=${data.skipped})` : ''}`);
375
+ }
376
+ ctx.done(data);
377
+ return data;
378
+ },
379
+ };
380
+
381
+ /** 站点类命令(B4 / task-90):注册顺序即 `wkgeo site --help` 的列法 */
382
+ export const SITE_COMMANDS = [
383
+ siteInfoCommand,
384
+ siteInfoSaveCommand,
385
+ siteDemoSeedCommand,
386
+ siteDemoClearCommand,
387
+ siteSyncCommand,
388
+ ];