@wkgeo/cli 2.0.3 → 2.2.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 +19 -2
- package/README.md +7 -7
- package/SKILL.md +1038 -1038
- 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 +17 -1
- package/lib/commands/init.mjs +111 -111
- package/lib/commands/orders.mjs +691 -691
- package/lib/commands/site.mjs +82 -0
- package/lib/commands/siteops.mjs +382 -0
- package/lib/commands/sites.mjs +968 -801
- package/lib/commands/spec.mjs +72 -72
- 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 -1650
- package/lib/manifest-schema.json +480 -480
- package/lib/manifest.mjs +1106 -1106
- package/lib/runtime.mjs +798 -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-publish.mjs +410 -0
- package/lib/site-spec.mjs +302 -302
- package/lib/site-template.mjs +405 -0
- package/lib/template-gen.mjs +1354 -1354
- 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 -56
- package/spec/SITE-SPEC.md +198 -198
package/lib/runtime.mjs
CHANGED
|
@@ -1,654 +1,798 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* 运行期上下文:把「解析命令行 → 生效配置 → API 客户端 → 输出器 → 登录态」串起来。
|
|
3
|
-
*
|
|
4
|
-
* 为什么要有这一层:
|
|
5
|
-
* 每个命令都需要那几样东西(配置/api/输出/凭据),如果每个命令自己 new 一遍,
|
|
6
|
-
* 测试就没法注入(不能替换 fetch、不能指定临时凭据文件)。
|
|
7
|
-
* 集中在这里之后,单测里 `createRuntime({argv, env, stdout, fetchImpl})` 就能把整条链路变成离线的。
|
|
8
|
-
*
|
|
9
|
-
* 输出契约(**给 AI 端消费用的,必须稳定**):
|
|
10
|
-
* * `--json`:stdout **只有一个 JSON 对象**(成功/失败都是),字段见 okEnvelope/errorEnvelope。
|
|
11
|
-
* * **非 TTY 时自动用 JSON**(AI/管道场景最省事,不用记得加 --json);
|
|
12
|
-
* 想强制人类可读输出用 `--text`。
|
|
13
|
-
* * 人类可读的诊断信息一律走 stderr,绝不混进 stdout 的 JSON 里。
|
|
14
|
-
* * 例外:`login` 天生长跑,JSON 模式下按 **JSONL 事件流**输出(见 commands/auth.mjs 的说明)。
|
|
15
|
-
*/
|
|
16
|
-
|
|
17
|
-
import readline from 'node:readline';
|
|
18
|
-
|
|
19
|
-
import { parseArgv, coerceFlags, checkPositionals, resolveCommand } from './args.mjs';
|
|
20
|
-
import { resolveConfig } from './config.mjs';
|
|
21
|
-
import { createApi } from './api.mjs';
|
|
22
|
-
import { createCms } from './cms.mjs';
|
|
23
|
-
import { readSiteState, writeSiteState } from './site-state.mjs';
|
|
24
|
-
import { requireCredentials, readCredentials } from './credentials.mjs';
|
|
25
|
-
import { createPalette, renderTable, safeJson } from './format.mjs';
|
|
26
|
-
import { UsageError, EXIT } from './errors.mjs';
|
|
27
|
-
import { detectProxy, proxyWarningPayload } from './proxy.mjs';
|
|
28
|
-
|
|
29
|
-
/**
|
|
30
|
-
* 休眠的**默认实现**(毫秒)。
|
|
31
|
-
*
|
|
32
|
-
* ★ 0.5.1 修复(真 bug):以前 `sleep` 的默认值是 `undefined`,`cli/lib/cli.mjs` 又把 `io.sleep`
|
|
33
|
-
* 原样透传;生产入口 `wkgeo.mjs` 调 `run(argv)` 时**不传 io** ⇒ `ctx.sleep === undefined`
|
|
34
|
-
* ⇒ `publish --confirm` 在**发布已经提交成功之后**的轮询里抛 `ctx.sleep is not a function`
|
|
35
|
-
* (exit 1,kind=internal)。默认值现在落在 runtime 层:任何调用方漏传都不会崩。
|
|
36
|
-
*/
|
|
37
|
-
export function defaultSleep(ms = 0) {
|
|
38
|
-
const n = Number(ms);
|
|
39
|
-
return new Promise((resolve) => setTimeout(resolve, Number.isFinite(n) && n > 0 ? n : 0));
|
|
40
|
-
}
|
|
41
|
-
|
|
42
|
-
/** 只接受函数;`undefined` / `null` / `false` / 其它类型一律退回默认实现(漏传 ≠ 崩) */
|
|
43
|
-
function fnOr(value, fallback) {
|
|
44
|
-
return typeof value === 'function' ? value : fallback;
|
|
45
|
-
}
|
|
46
|
-
|
|
47
|
-
/**
|
|
48
|
-
* 给"`undefined` 本身有语义 = 用下游的生产默认实现"的注入点用(如 `openBrowser`):
|
|
49
|
-
* 非函数(含 `null` / `true` 这类误传)收成 `undefined`,但**保留 `false`**(= 用户明确关掉)。
|
|
50
|
-
*/
|
|
51
|
-
function fnOrUndefined(value) {
|
|
52
|
-
return typeof value === 'function' ? value : undefined;
|
|
53
|
-
}
|
|
54
|
-
|
|
55
|
-
/** 成功信封 */
|
|
56
|
-
export function okEnvelope(command, data, meta) {
|
|
57
|
-
return { ok: true, command, data, meta };
|
|
58
|
-
}
|
|
59
|
-
|
|
60
|
-
/**
|
|
61
|
-
|
|
62
|
-
|
|
63
|
-
|
|
64
|
-
|
|
65
|
-
|
|
66
|
-
|
|
67
|
-
|
|
68
|
-
|
|
69
|
-
|
|
70
|
-
|
|
71
|
-
|
|
72
|
-
|
|
73
|
-
|
|
74
|
-
|
|
75
|
-
|
|
76
|
-
|
|
77
|
-
|
|
78
|
-
|
|
79
|
-
|
|
80
|
-
|
|
81
|
-
|
|
82
|
-
|
|
83
|
-
const
|
|
84
|
-
|
|
85
|
-
return {
|
|
86
|
-
|
|
87
|
-
|
|
88
|
-
|
|
89
|
-
|
|
90
|
-
|
|
91
|
-
|
|
92
|
-
|
|
93
|
-
|
|
94
|
-
|
|
95
|
-
|
|
96
|
-
|
|
97
|
-
|
|
98
|
-
|
|
99
|
-
|
|
100
|
-
|
|
101
|
-
|
|
102
|
-
|
|
103
|
-
|
|
104
|
-
|
|
105
|
-
|
|
106
|
-
|
|
107
|
-
|
|
108
|
-
|
|
109
|
-
|
|
110
|
-
|
|
111
|
-
|
|
112
|
-
|
|
113
|
-
|
|
114
|
-
|
|
115
|
-
|
|
116
|
-
|
|
117
|
-
|
|
118
|
-
|
|
119
|
-
|
|
120
|
-
|
|
121
|
-
|
|
122
|
-
|
|
123
|
-
|
|
124
|
-
|
|
125
|
-
|
|
126
|
-
|
|
127
|
-
|
|
128
|
-
|
|
129
|
-
|
|
130
|
-
|
|
131
|
-
|
|
132
|
-
|
|
133
|
-
|
|
134
|
-
|
|
135
|
-
|
|
136
|
-
|
|
137
|
-
|
|
138
|
-
|
|
139
|
-
|
|
140
|
-
|
|
141
|
-
|
|
142
|
-
|
|
143
|
-
|
|
144
|
-
|
|
145
|
-
|
|
146
|
-
|
|
147
|
-
|
|
148
|
-
|
|
149
|
-
|
|
150
|
-
|
|
151
|
-
|
|
152
|
-
|
|
153
|
-
|
|
154
|
-
|
|
155
|
-
|
|
156
|
-
|
|
157
|
-
|
|
158
|
-
*/
|
|
159
|
-
export function
|
|
160
|
-
|
|
161
|
-
|
|
162
|
-
|
|
163
|
-
|
|
164
|
-
|
|
165
|
-
|
|
166
|
-
|
|
167
|
-
|
|
168
|
-
|
|
169
|
-
|
|
170
|
-
|
|
171
|
-
|
|
172
|
-
|
|
173
|
-
|
|
174
|
-
|
|
175
|
-
|
|
176
|
-
|
|
177
|
-
|
|
178
|
-
|
|
179
|
-
|
|
180
|
-
|
|
181
|
-
|
|
182
|
-
|
|
183
|
-
|
|
184
|
-
|
|
185
|
-
|
|
186
|
-
|
|
187
|
-
|
|
188
|
-
|
|
189
|
-
|
|
190
|
-
|
|
191
|
-
|
|
192
|
-
|
|
193
|
-
|
|
194
|
-
|
|
195
|
-
|
|
196
|
-
|
|
197
|
-
|
|
198
|
-
|
|
199
|
-
|
|
200
|
-
|
|
201
|
-
|
|
202
|
-
|
|
203
|
-
|
|
204
|
-
|
|
205
|
-
|
|
206
|
-
|
|
207
|
-
|
|
208
|
-
|
|
209
|
-
|
|
210
|
-
|
|
211
|
-
|
|
212
|
-
|
|
213
|
-
|
|
214
|
-
|
|
215
|
-
|
|
216
|
-
|
|
217
|
-
|
|
218
|
-
|
|
219
|
-
|
|
220
|
-
|
|
221
|
-
|
|
222
|
-
|
|
223
|
-
|
|
224
|
-
|
|
225
|
-
|
|
226
|
-
|
|
227
|
-
|
|
228
|
-
|
|
229
|
-
|
|
230
|
-
|
|
231
|
-
|
|
232
|
-
|
|
233
|
-
|
|
234
|
-
|
|
235
|
-
|
|
236
|
-
|
|
237
|
-
|
|
238
|
-
|
|
239
|
-
|
|
240
|
-
|
|
241
|
-
|
|
242
|
-
|
|
243
|
-
|
|
244
|
-
|
|
245
|
-
|
|
246
|
-
|
|
247
|
-
|
|
248
|
-
|
|
249
|
-
|
|
250
|
-
|
|
251
|
-
|
|
252
|
-
|
|
253
|
-
|
|
254
|
-
|
|
255
|
-
|
|
256
|
-
|
|
257
|
-
|
|
258
|
-
|
|
259
|
-
|
|
260
|
-
|
|
261
|
-
|
|
262
|
-
|
|
263
|
-
|
|
264
|
-
|
|
265
|
-
|
|
266
|
-
|
|
267
|
-
|
|
268
|
-
|
|
269
|
-
|
|
270
|
-
|
|
271
|
-
|
|
272
|
-
|
|
273
|
-
|
|
274
|
-
|
|
275
|
-
|
|
276
|
-
|
|
277
|
-
|
|
278
|
-
*
|
|
279
|
-
*
|
|
280
|
-
*
|
|
281
|
-
*
|
|
282
|
-
|
|
283
|
-
|
|
284
|
-
|
|
285
|
-
/**
|
|
286
|
-
*
|
|
287
|
-
*
|
|
288
|
-
*
|
|
289
|
-
*
|
|
290
|
-
|
|
291
|
-
|
|
292
|
-
|
|
293
|
-
|
|
294
|
-
|
|
295
|
-
|
|
296
|
-
|
|
297
|
-
|
|
298
|
-
|
|
299
|
-
|
|
300
|
-
|
|
301
|
-
|
|
302
|
-
|
|
303
|
-
|
|
304
|
-
|
|
305
|
-
|
|
306
|
-
|
|
307
|
-
|
|
308
|
-
|
|
309
|
-
|
|
310
|
-
|
|
311
|
-
|
|
312
|
-
|
|
313
|
-
|
|
314
|
-
|
|
315
|
-
|
|
316
|
-
|
|
317
|
-
|
|
318
|
-
|
|
319
|
-
|
|
320
|
-
|
|
321
|
-
|
|
322
|
-
|
|
323
|
-
|
|
324
|
-
|
|
325
|
-
const
|
|
326
|
-
|
|
327
|
-
|
|
328
|
-
|
|
329
|
-
|
|
330
|
-
|
|
331
|
-
|
|
332
|
-
|
|
333
|
-
|
|
334
|
-
|
|
335
|
-
|
|
336
|
-
|
|
337
|
-
|
|
338
|
-
|
|
339
|
-
|
|
340
|
-
|
|
341
|
-
|
|
342
|
-
|
|
343
|
-
|
|
344
|
-
|
|
345
|
-
|
|
346
|
-
|
|
347
|
-
|
|
348
|
-
|
|
349
|
-
|
|
350
|
-
|
|
351
|
-
|
|
352
|
-
|
|
353
|
-
|
|
354
|
-
|
|
355
|
-
|
|
356
|
-
|
|
357
|
-
|
|
358
|
-
|
|
359
|
-
|
|
360
|
-
|
|
361
|
-
|
|
362
|
-
|
|
363
|
-
|
|
364
|
-
|
|
365
|
-
|
|
366
|
-
|
|
367
|
-
|
|
368
|
-
|
|
369
|
-
|
|
370
|
-
|
|
371
|
-
|
|
372
|
-
|
|
373
|
-
|
|
374
|
-
|
|
375
|
-
|
|
376
|
-
|
|
377
|
-
|
|
378
|
-
|
|
379
|
-
|
|
380
|
-
|
|
381
|
-
|
|
382
|
-
|
|
383
|
-
|
|
384
|
-
|
|
385
|
-
|
|
386
|
-
|
|
387
|
-
|
|
388
|
-
|
|
389
|
-
|
|
390
|
-
|
|
391
|
-
|
|
392
|
-
|
|
393
|
-
|
|
394
|
-
|
|
395
|
-
|
|
396
|
-
|
|
397
|
-
|
|
398
|
-
|
|
399
|
-
|
|
400
|
-
|
|
401
|
-
|
|
402
|
-
|
|
403
|
-
|
|
404
|
-
|
|
405
|
-
|
|
406
|
-
|
|
407
|
-
|
|
408
|
-
|
|
409
|
-
|
|
410
|
-
|
|
411
|
-
|
|
412
|
-
|
|
413
|
-
|
|
414
|
-
|
|
415
|
-
|
|
416
|
-
|
|
417
|
-
|
|
418
|
-
}
|
|
419
|
-
|
|
420
|
-
|
|
421
|
-
|
|
422
|
-
|
|
423
|
-
|
|
424
|
-
|
|
425
|
-
|
|
426
|
-
|
|
427
|
-
|
|
428
|
-
|
|
429
|
-
|
|
430
|
-
|
|
431
|
-
|
|
432
|
-
|
|
433
|
-
|
|
434
|
-
|
|
435
|
-
|
|
436
|
-
|
|
437
|
-
|
|
438
|
-
/**
|
|
439
|
-
|
|
440
|
-
|
|
441
|
-
|
|
442
|
-
|
|
443
|
-
|
|
444
|
-
|
|
445
|
-
|
|
446
|
-
|
|
447
|
-
|
|
448
|
-
*
|
|
449
|
-
*
|
|
450
|
-
*
|
|
451
|
-
*
|
|
452
|
-
*
|
|
453
|
-
*
|
|
454
|
-
*
|
|
455
|
-
*
|
|
456
|
-
*
|
|
457
|
-
|
|
458
|
-
|
|
459
|
-
|
|
460
|
-
|
|
461
|
-
|
|
462
|
-
|
|
463
|
-
|
|
464
|
-
|
|
465
|
-
|
|
466
|
-
|
|
467
|
-
|
|
468
|
-
|
|
469
|
-
|
|
470
|
-
|
|
471
|
-
|
|
472
|
-
|
|
473
|
-
|
|
474
|
-
|
|
475
|
-
|
|
476
|
-
|
|
477
|
-
|
|
478
|
-
*
|
|
479
|
-
*
|
|
480
|
-
*
|
|
481
|
-
|
|
482
|
-
|
|
483
|
-
|
|
484
|
-
*
|
|
485
|
-
*
|
|
486
|
-
*
|
|
487
|
-
*
|
|
488
|
-
*/
|
|
489
|
-
|
|
490
|
-
|
|
491
|
-
|
|
492
|
-
|
|
493
|
-
|
|
494
|
-
|
|
495
|
-
}
|
|
496
|
-
|
|
497
|
-
|
|
498
|
-
|
|
499
|
-
|
|
500
|
-
|
|
501
|
-
*
|
|
502
|
-
*
|
|
503
|
-
*
|
|
504
|
-
*
|
|
505
|
-
*
|
|
506
|
-
|
|
507
|
-
|
|
508
|
-
|
|
509
|
-
|
|
510
|
-
|
|
511
|
-
|
|
512
|
-
|
|
513
|
-
|
|
514
|
-
|
|
515
|
-
|
|
516
|
-
|
|
517
|
-
|
|
518
|
-
|
|
519
|
-
|
|
520
|
-
|
|
521
|
-
|
|
522
|
-
|
|
523
|
-
|
|
524
|
-
*
|
|
525
|
-
*
|
|
526
|
-
*
|
|
527
|
-
*
|
|
528
|
-
* `
|
|
529
|
-
* `
|
|
530
|
-
*
|
|
531
|
-
* `
|
|
532
|
-
*
|
|
533
|
-
*
|
|
534
|
-
*
|
|
535
|
-
*
|
|
536
|
-
|
|
537
|
-
|
|
538
|
-
|
|
539
|
-
const
|
|
540
|
-
|
|
541
|
-
|
|
542
|
-
|
|
543
|
-
|
|
544
|
-
|
|
545
|
-
|
|
546
|
-
|
|
547
|
-
|
|
548
|
-
|
|
549
|
-
|
|
550
|
-
|
|
551
|
-
|
|
552
|
-
|
|
553
|
-
|
|
554
|
-
|
|
555
|
-
|
|
556
|
-
|
|
557
|
-
|
|
558
|
-
|
|
559
|
-
|
|
560
|
-
|
|
561
|
-
|
|
562
|
-
|
|
563
|
-
|
|
564
|
-
|
|
565
|
-
|
|
566
|
-
|
|
567
|
-
|
|
568
|
-
|
|
569
|
-
|
|
570
|
-
|
|
571
|
-
|
|
572
|
-
|
|
573
|
-
|
|
574
|
-
|
|
575
|
-
*
|
|
576
|
-
*
|
|
577
|
-
*
|
|
578
|
-
*
|
|
579
|
-
*
|
|
580
|
-
*
|
|
581
|
-
*
|
|
582
|
-
*
|
|
583
|
-
*
|
|
584
|
-
|
|
585
|
-
|
|
586
|
-
|
|
587
|
-
|
|
588
|
-
|
|
589
|
-
|
|
590
|
-
|
|
591
|
-
|
|
592
|
-
|
|
593
|
-
|
|
594
|
-
|
|
595
|
-
|
|
596
|
-
|
|
597
|
-
|
|
598
|
-
|
|
599
|
-
|
|
600
|
-
|
|
601
|
-
|
|
602
|
-
|
|
603
|
-
|
|
604
|
-
|
|
605
|
-
|
|
606
|
-
|
|
607
|
-
|
|
608
|
-
|
|
609
|
-
|
|
610
|
-
|
|
611
|
-
|
|
612
|
-
|
|
613
|
-
|
|
614
|
-
|
|
615
|
-
*
|
|
616
|
-
*
|
|
617
|
-
*
|
|
618
|
-
*
|
|
619
|
-
*
|
|
620
|
-
* `
|
|
621
|
-
*
|
|
622
|
-
|
|
623
|
-
|
|
624
|
-
|
|
625
|
-
|
|
626
|
-
|
|
627
|
-
|
|
628
|
-
|
|
629
|
-
|
|
630
|
-
|
|
631
|
-
|
|
632
|
-
|
|
633
|
-
|
|
634
|
-
|
|
635
|
-
|
|
636
|
-
|
|
637
|
-
|
|
638
|
-
|
|
639
|
-
|
|
640
|
-
|
|
641
|
-
|
|
642
|
-
|
|
643
|
-
* `
|
|
644
|
-
|
|
645
|
-
|
|
646
|
-
|
|
647
|
-
|
|
648
|
-
|
|
649
|
-
|
|
650
|
-
|
|
651
|
-
|
|
652
|
-
|
|
653
|
-
|
|
654
|
-
|
|
1
|
+
/**
|
|
2
|
+
* 运行期上下文:把「解析命令行 → 生效配置 → API 客户端 → 输出器 → 登录态」串起来。
|
|
3
|
+
*
|
|
4
|
+
* 为什么要有这一层:
|
|
5
|
+
* 每个命令都需要那几样东西(配置/api/输出/凭据),如果每个命令自己 new 一遍,
|
|
6
|
+
* 测试就没法注入(不能替换 fetch、不能指定临时凭据文件)。
|
|
7
|
+
* 集中在这里之后,单测里 `createRuntime({argv, env, stdout, fetchImpl})` 就能把整条链路变成离线的。
|
|
8
|
+
*
|
|
9
|
+
* 输出契约(**给 AI 端消费用的,必须稳定**):
|
|
10
|
+
* * `--json`:stdout **只有一个 JSON 对象**(成功/失败都是),字段见 okEnvelope/errorEnvelope。
|
|
11
|
+
* * **非 TTY 时自动用 JSON**(AI/管道场景最省事,不用记得加 --json);
|
|
12
|
+
* 想强制人类可读输出用 `--text`。
|
|
13
|
+
* * 人类可读的诊断信息一律走 stderr,绝不混进 stdout 的 JSON 里。
|
|
14
|
+
* * 例外:`login` 天生长跑,JSON 模式下按 **JSONL 事件流**输出(见 commands/auth.mjs 的说明)。
|
|
15
|
+
*/
|
|
16
|
+
|
|
17
|
+
import readline from 'node:readline';
|
|
18
|
+
|
|
19
|
+
import { parseArgv, coerceFlags, checkPositionals, resolveCommand } from './args.mjs';
|
|
20
|
+
import { resolveConfig } from './config.mjs';
|
|
21
|
+
import { createApi } from './api.mjs';
|
|
22
|
+
import { createCms } from './cms.mjs';
|
|
23
|
+
import { readSiteState, writeSiteState } from './site-state.mjs';
|
|
24
|
+
import { requireCredentials, readCredentials, isExpired } from './credentials.mjs';
|
|
25
|
+
import { createPalette, renderTable, safeJson } from './format.mjs';
|
|
26
|
+
import { CliError, UsageError, EXIT } from './errors.mjs';
|
|
27
|
+
import { detectProxy, proxyWarningPayload } from './proxy.mjs';
|
|
28
|
+
|
|
29
|
+
/**
|
|
30
|
+
* 休眠的**默认实现**(毫秒)。
|
|
31
|
+
*
|
|
32
|
+
* ★ 0.5.1 修复(真 bug):以前 `sleep` 的默认值是 `undefined`,`cli/lib/cli.mjs` 又把 `io.sleep`
|
|
33
|
+
* 原样透传;生产入口 `wkgeo.mjs` 调 `run(argv)` 时**不传 io** ⇒ `ctx.sleep === undefined`
|
|
34
|
+
* ⇒ `publish --confirm` 在**发布已经提交成功之后**的轮询里抛 `ctx.sleep is not a function`
|
|
35
|
+
* (exit 1,kind=internal)。默认值现在落在 runtime 层:任何调用方漏传都不会崩。
|
|
36
|
+
*/
|
|
37
|
+
export function defaultSleep(ms = 0) {
|
|
38
|
+
const n = Number(ms);
|
|
39
|
+
return new Promise((resolve) => setTimeout(resolve, Number.isFinite(n) && n > 0 ? n : 0));
|
|
40
|
+
}
|
|
41
|
+
|
|
42
|
+
/** 只接受函数;`undefined` / `null` / `false` / 其它类型一律退回默认实现(漏传 ≠ 崩) */
|
|
43
|
+
function fnOr(value, fallback) {
|
|
44
|
+
return typeof value === 'function' ? value : fallback;
|
|
45
|
+
}
|
|
46
|
+
|
|
47
|
+
/**
|
|
48
|
+
* 给"`undefined` 本身有语义 = 用下游的生产默认实现"的注入点用(如 `openBrowser`):
|
|
49
|
+
* 非函数(含 `null` / `true` 这类误传)收成 `undefined`,但**保留 `false`**(= 用户明确关掉)。
|
|
50
|
+
*/
|
|
51
|
+
function fnOrUndefined(value) {
|
|
52
|
+
return typeof value === 'function' ? value : undefined;
|
|
53
|
+
}
|
|
54
|
+
|
|
55
|
+
/** 成功信封 */
|
|
56
|
+
export function okEnvelope(command, data, meta) {
|
|
57
|
+
return { ok: true, command, data, meta };
|
|
58
|
+
}
|
|
59
|
+
|
|
60
|
+
/**
|
|
61
|
+
* `wkgeo_sk_…` 是 **API Key / 按站短票**的令牌形状(CMS 侧 task-58 起认这类令牌做
|
|
62
|
+
* `templateList / templateGet / templateAssetFiles`)。
|
|
63
|
+
*/
|
|
64
|
+
function isApiKeyToken(token) {
|
|
65
|
+
return /^wkgeo_sk_/i.test(String(token || '').trim());
|
|
66
|
+
}
|
|
67
|
+
|
|
68
|
+
/**
|
|
69
|
+
* 读一个凭据文件,判断它是 **Key** 还是**账号 OAuth**(不发送任何请求)。
|
|
70
|
+
*
|
|
71
|
+
* @returns {{ok:true,creds:object,file:string,kind:'key'|'account'}
|
|
72
|
+
* | {ok:false,kind:'missing'|'invalid'|'expired',file:string,error?:Error}}
|
|
73
|
+
*/
|
|
74
|
+
function readCredentialToken(file, nowFn) {
|
|
75
|
+
if (!file) return { ok: false, kind: 'missing', file: '' };
|
|
76
|
+
let creds = null;
|
|
77
|
+
try {
|
|
78
|
+
creds = readCredentials(file);
|
|
79
|
+
} catch (err) {
|
|
80
|
+
return { ok: false, kind: 'invalid', file, error: err };
|
|
81
|
+
}
|
|
82
|
+
if (!creds) return { ok: false, kind: 'missing', file };
|
|
83
|
+
const token = String(creds.access_token || '').trim();
|
|
84
|
+
if (!token) return { ok: false, kind: 'missing', file };
|
|
85
|
+
if (isApiKeyToken(token)) return { ok: true, creds, file, kind: 'key' };
|
|
86
|
+
if (isExpired(creds, { now: nowFn() })) {
|
|
87
|
+
return {
|
|
88
|
+
ok: false,
|
|
89
|
+
kind: 'expired',
|
|
90
|
+
file,
|
|
91
|
+
error: new CliError(`账号登录令牌已过期:${file}`, {
|
|
92
|
+
kind: 'unauthenticated',
|
|
93
|
+
code: 401,
|
|
94
|
+
exitCode: EXIT.AUTH,
|
|
95
|
+
hint: '重新登录一次即可:`wkgeo login`。',
|
|
96
|
+
}),
|
|
97
|
+
};
|
|
98
|
+
}
|
|
99
|
+
return { ok: true, creds, file, kind: 'account' };
|
|
100
|
+
}
|
|
101
|
+
|
|
102
|
+
/**
|
|
103
|
+
* Key 模式下 CMS 报错的**唯一**正确说法(老板 2026-11-22 硬口径:
|
|
104
|
+
* 「`wkgeo login` 只有 CLI 该有;填了 Key 就不该再要登录,否则就是重复登录」)。
|
|
105
|
+
*
|
|
106
|
+
* 401 ⇒ `AUTH_FAILED`(Key 无效/过期 → 去后台重建 Key);
|
|
107
|
+
* 403 ⇒ `KEY_SCOPE_DENIED`(Key 的权限/站点绑定不够 → 去后台重建 / 换绑站点)。
|
|
108
|
+
* **一律不提示 `wkgeo login`。**
|
|
109
|
+
*/
|
|
110
|
+
function keyCmsCliError(action, err) {
|
|
111
|
+
const raw = String((err && err.message) || err || '未知错误');
|
|
112
|
+
const code = Number(err && err.code);
|
|
113
|
+
const status = Number.isFinite(code) && code >= 400 ? code : err && err.kind === 'cms_auth' ? 401 : 403;
|
|
114
|
+
if (status === 401) {
|
|
115
|
+
return new CliError(
|
|
116
|
+
`CMS 拒绝了这个 Key(HTTP 401):${raw}\n` +
|
|
117
|
+
'Key 模式只认 Key:这个 Key 被 CMS 判为无效或过期 —— 请到后台重新生成 Key(面板「设置 → Key」),把新 Key 填回面板重试。',
|
|
118
|
+
{
|
|
119
|
+
kind: 'key_auth',
|
|
120
|
+
code: 'AUTH_FAILED',
|
|
121
|
+
exitCode: EXIT.AUTH,
|
|
122
|
+
hint: '换 Key / 重建 Key 才是正确的修法(面板「设置 → Key」)。',
|
|
123
|
+
},
|
|
124
|
+
);
|
|
125
|
+
}
|
|
126
|
+
return new CliError(
|
|
127
|
+
`CMS 拒绝了这个 Key(HTTP ${status}):${raw}\n` +
|
|
128
|
+
'这是 Key 的权限 / 站点绑定问题:请确认这个 Key 属于该站点(或账号下已绑定该站),或到后台重新生成 Key 后再试。',
|
|
129
|
+
{
|
|
130
|
+
kind: 'key_scope',
|
|
131
|
+
code: 'KEY_SCOPE_DENIED',
|
|
132
|
+
exitCode: EXIT.AUTH,
|
|
133
|
+
hint: '问题在 Key 本身(权限范围 / 站点绑定):到后台调整或重建 Key 后重试。',
|
|
134
|
+
},
|
|
135
|
+
);
|
|
136
|
+
}
|
|
137
|
+
|
|
138
|
+
/** 失败信封:**结构化**,带 code / message / hint,让 AI 端能自己决定下一步 */
|
|
139
|
+
export function errorEnvelope(command, err, meta) {
|
|
140
|
+
const env = {
|
|
141
|
+
ok: false,
|
|
142
|
+
command,
|
|
143
|
+
error: {
|
|
144
|
+
kind: (err && err.kind) || 'error',
|
|
145
|
+
code: err && err.code !== undefined ? err.code : null,
|
|
146
|
+
message: (err && err.message) || String(err),
|
|
147
|
+
hint: (err && err.hint) || null,
|
|
148
|
+
retry_after: err && err.retryAfter !== undefined ? err.retryAfter : null,
|
|
149
|
+
},
|
|
150
|
+
meta,
|
|
151
|
+
};
|
|
152
|
+
// `details` = 失败时的结构化明细(如 verify 的动画对账 命中/缺失/多余)。
|
|
153
|
+
// 只在这个字段**确实存在**时加上,老命令的信封形状一个字不变。
|
|
154
|
+
if (err && err.details !== undefined && err.details !== null) env.error.details = err.details;
|
|
155
|
+
return env;
|
|
156
|
+
}
|
|
157
|
+
|
|
158
|
+
/** 输出器:人类可读 + `--json` 两套;"令牌不进终端"这件事只在这里发生一次 */
|
|
159
|
+
export function createOutput({ stdout, stderr, json = false, color = true, meta = () => ({}) }) {
|
|
160
|
+
const p = createPalette({ enabled: color && !json });
|
|
161
|
+
const w = (s) => stdout.write(s);
|
|
162
|
+
const we = (s) => stderr.write(s);
|
|
163
|
+
return {
|
|
164
|
+
palette: p,
|
|
165
|
+
json,
|
|
166
|
+
line: (s = '') => {
|
|
167
|
+
if (!json) w(String(s) + '\n');
|
|
168
|
+
},
|
|
169
|
+
/**
|
|
170
|
+
* 原样写 stdout,**无视 json 模式**(注意与 line/info 的区别:那三个在 json 模式下什么都不写)。
|
|
171
|
+
*
|
|
172
|
+
* 为什么需要它:`skill` 的产物**本身就是文档**(markdown 原文)。全 CLI 的通用约定是
|
|
173
|
+
* "非终端自动 JSON",但把 markdown 套进 JSON 信封会毁掉可读性(换行被转义、重定向出来
|
|
174
|
+
* 不能直接读)。所以那条命令要一个"必须写 stdout、且不套信封"的出口 —— 就是这里,
|
|
175
|
+
* 保持"谁写 stdout"只在本文件里出现一次。
|
|
176
|
+
*/
|
|
177
|
+
plain: (s = '') => w(String(s)),
|
|
178
|
+
head: (title) => {
|
|
179
|
+
if (!json) w(`\n${p.bold(title)}\n`);
|
|
180
|
+
},
|
|
181
|
+
ok: (s) => {
|
|
182
|
+
if (!json) w(`${p.green('✔')} ${s}\n`);
|
|
183
|
+
else we(`✔ ${s}\n`);
|
|
184
|
+
},
|
|
185
|
+
warn: (s) => {
|
|
186
|
+
if (!json) w(`${p.yellow('!')} ${s}\n`);
|
|
187
|
+
else we(`! ${s}\n`);
|
|
188
|
+
},
|
|
189
|
+
info: (s) => {
|
|
190
|
+
if (!json) w(`${p.dim(s)}\n`);
|
|
191
|
+
},
|
|
192
|
+
/**
|
|
193
|
+
* ★ 人类提示块:人读模式走 stdout,**JSON 模式走 stderr**。
|
|
194
|
+
*
|
|
195
|
+
* 为什么需要它(与 line/info 的区别):`--json` / 非 TTY 下 stdout 必须只有机器可读 JSON,
|
|
196
|
+
* 而"⚠️ 浏览器没能自动打开,请手动复制这个地址…(含完整 URL)"这类**要给用户看**的提示
|
|
197
|
+
* 又不能因为切了 JSON 就消失(用户得能照着它手动打开授权页/收银台)。
|
|
198
|
+
* 走 stderr 既不污染 stdout,AI 客户端也照样能看到。
|
|
199
|
+
*/
|
|
200
|
+
notice: (s = '') => {
|
|
201
|
+
if (!json) w(String(s) + '\n');
|
|
202
|
+
else we(String(s) + '\n');
|
|
203
|
+
},
|
|
204
|
+
err: (s) => we(`${p.red('✖')} ${s}\n`),
|
|
205
|
+
raw: (s) => we(String(s) + '\n'),
|
|
206
|
+
table: (columns, rows) => {
|
|
207
|
+
if (!json) w(renderTable(columns, rows) + '\n');
|
|
208
|
+
},
|
|
209
|
+
/** 直接打一个对象(JSONL 事件流用),**不做信封包装** */
|
|
210
|
+
event: (obj) => w(safeJson(obj, 0) + '\n'),
|
|
211
|
+
emitOk: (command, data) => {
|
|
212
|
+
if (json) w(safeJson(okEnvelope(command, data, meta()), 2) + '\n');
|
|
213
|
+
},
|
|
214
|
+
emitErr: (command, err) => {
|
|
215
|
+
if (json) w(safeJson(errorEnvelope(command, err, meta()), 2) + '\n');
|
|
216
|
+
else {
|
|
217
|
+
const code = err && err.code !== null && err.code !== undefined ? `[code=${err.code}] ` : '';
|
|
218
|
+
we(`${p.red('✖')} ${code}${(err && err.message) || String(err)}\n`);
|
|
219
|
+
if (err && err.hint) we(` ${p.yellow('↳')} ${err.hint}\n`);
|
|
220
|
+
if (err && err.retryAfter !== undefined && err.retryAfter !== null) {
|
|
221
|
+
we(` ${p.yellow('↳')} 建议 ${err.retryAfter} 秒后重试\n`);
|
|
222
|
+
}
|
|
223
|
+
}
|
|
224
|
+
},
|
|
225
|
+
};
|
|
226
|
+
}
|
|
227
|
+
|
|
228
|
+
/**
|
|
229
|
+
* @param {object} args
|
|
230
|
+
* @param {string[]} args.argv process.argv.slice(2)
|
|
231
|
+
* @param {Array} args.commands 命令注册表
|
|
232
|
+
* @param {object} [args.env]
|
|
233
|
+
* @param {object} [args.stdout] {write, isTTY}
|
|
234
|
+
* @param {object} [args.stderr]
|
|
235
|
+
* @param {Function} [args.fetchImpl]
|
|
236
|
+
*/
|
|
237
|
+
export function createRuntime({
|
|
238
|
+
argv = [],
|
|
239
|
+
commands,
|
|
240
|
+
env = process.env,
|
|
241
|
+
stdout = process.stdout,
|
|
242
|
+
stderr = process.stderr,
|
|
243
|
+
/**
|
|
244
|
+
* 交互提问的输入源(默认 `process.stdin`)与提问函数。
|
|
245
|
+
*
|
|
246
|
+
* `ask` 做成注入点(**只为单测**):`sites list` 的"没站引导建站 / 有站选站"必须在
|
|
247
|
+
* 离线用例里确定性地走完 —— 不注入的话,单测要么真的挂在终端上等人敲键盘,
|
|
248
|
+
* 要么只能不测这条最重要的交互路径。生产不传 = 用下面的 `readline` 默认实现。
|
|
249
|
+
*/
|
|
250
|
+
stdin = process.stdin,
|
|
251
|
+
ask = undefined,
|
|
252
|
+
fetchImpl = globalThis.fetch,
|
|
253
|
+
now = () => Date.now(),
|
|
254
|
+
/** 随机源(默认 `Math.random`;单测可注入确定值。0.5.1 起与 now/sleep 一样有默认实现) */
|
|
255
|
+
random = Math.random,
|
|
256
|
+
/** 诊断日志出口(默认写 stderr —— **绝不进 stdout**,避免污染 JSON 信封) */
|
|
257
|
+
log = undefined,
|
|
258
|
+
/**
|
|
259
|
+
* 这两个是给"需要外部动作"的命令(login)用的注入点:
|
|
260
|
+
* openBrowser —— 测试里替换成空函数,避免真的弹浏览器
|
|
261
|
+
* sleep —— 设备码轮询 / 发布轮询的等待,测试里替换成假时钟
|
|
262
|
+
* ⚠️ 踩过的坑:一开始没把 fetchImpl/openBrowser 从 run() 透传到 runLogin/runDeviceLogin,
|
|
263
|
+
* 结果命令层单测会**真的去打网络/弹浏览器**(静默变成集成测试)。
|
|
264
|
+
* ⚠️ 0.5.1 的另一课:`sleep` 以前默认 `undefined`,生产入口不传 io 就在发布轮询里崩了。
|
|
265
|
+
* ⇒ 所有注入项现在都在这里兜底(见下方 fnOr/fnOrUndefined 与 defaultSleep)。
|
|
266
|
+
*/
|
|
267
|
+
openBrowser = undefined,
|
|
268
|
+
sleep = defaultSleep,
|
|
269
|
+
/**
|
|
270
|
+
* 「设备码先成功后,本地回调监听再多留多久」的注入点(毫秒;见 lib/login.mjs 的
|
|
271
|
+
* `DEFAULT_POST_DEVICE_GRACE_MS`)。**只为单测**:注入一个小值就能确定性地验证
|
|
272
|
+
* "迟到的回调拿到'已完成'页",不必让用例真的等几秒。
|
|
273
|
+
*/
|
|
274
|
+
postDeviceGraceMs = undefined,
|
|
275
|
+
/**
|
|
276
|
+
* `spawnImpl` —— `child_process.spawn` 的注入点(**只为单测**)。
|
|
277
|
+
*
|
|
278
|
+
* ★ 为什么必须透传到命令层才有意义:`--open-browser` / "非 TTY 不弹"这两条行为,
|
|
279
|
+
* 要在**命令层**端到端验证"到底有没有真的去 spawn 浏览器"。
|
|
280
|
+
* 只注入一个假的 `openBrowser` 只能证明"我们没调用注入的实现",
|
|
281
|
+
* 而真正要钉的是**生产接线**(defaultOpenBrowserAsync → child_process.spawn)在 AI 场景下
|
|
282
|
+
* 一次都不发生。生产不传 = 真 spawn。
|
|
283
|
+
*/
|
|
284
|
+
spawnImpl = undefined,
|
|
285
|
+
/**
|
|
286
|
+
* 代理检测的两个注入点(见 lib/proxy.mjs):
|
|
287
|
+
* platform —— 让单测能在任意平台上验证 Windows/macOS 的解析分支;
|
|
288
|
+
* exec —— 跑 `reg query` / `scutil --proxy` 的函数。**单测必须注入**,
|
|
289
|
+
* 否则单测会真的去起子进程、结果还随宿主机代理设置漂移。
|
|
290
|
+
*/
|
|
291
|
+
platform = process.platform,
|
|
292
|
+
exec,
|
|
293
|
+
/**
|
|
294
|
+
* `skill` 命令要读的那份手册的位置(默认 = 包根目录的 `SKILL.md`,见 lib/commands/skill.mjs)。
|
|
295
|
+
* 之所以做成注入点:**"包里没有手册"这个分支没法在真实仓库里造**(总不能把 SKILL.md 删了
|
|
296
|
+
* 或改名 —— 那是并行跑的其它用例依赖的真文件)。单测传入一个不存在的路径即可稳定覆盖该分支。
|
|
297
|
+
*/
|
|
298
|
+
skillUrl = undefined,
|
|
299
|
+
/**
|
|
300
|
+
* `runScript` —— **同步**跑一个外部命令的注入点(目前只有 `wkgeo import` 用)。
|
|
301
|
+
*
|
|
302
|
+
* 为什么和 `spawnImpl` 分开:`spawnImpl` 是 `child_process.spawn`(异步、给浏览器用的),
|
|
303
|
+
* 而导入是一个"人盯着看进度"的阻塞动作,默认实现是 `spawnSync`。
|
|
304
|
+
* 单测注入它就能验证"参数是怎么拼的、退出码怎么转述",**不真的去起子进程抓网站**。
|
|
305
|
+
*/
|
|
306
|
+
runScript = undefined,
|
|
307
|
+
} = {}) {
|
|
308
|
+
/**
|
|
309
|
+
* ★ 0.5.1:**所有注入项在这里一次性归一化**,任何一个漏传 / 传错类型都退回默认实现。
|
|
310
|
+
*
|
|
311
|
+
* 为什么集中做:以前每个注入点各写各的默认(有的写在命令层、有的干脆没有),
|
|
312
|
+
* 于是"生产入口不传 io"这种最普通的调用就会在某个冷门路径上崩(ctx.sleep 就是)。
|
|
313
|
+
*/
|
|
314
|
+
const nowFn = fnOr(now, () => Date.now());
|
|
315
|
+
const sleepFn = fnOr(sleep, defaultSleep);
|
|
316
|
+
const fetchFn = fnOr(fetchImpl, globalThis.fetch);
|
|
317
|
+
const randomFn = fnOr(random, Math.random);
|
|
318
|
+
const logFn = fnOr(log, (line = '') => stderr.write(String(line) + '\n'));
|
|
319
|
+
/** `undefined` = 下游(login/device)的生产默认实现;`false` = 用户明确关掉(`--no-browser`) */
|
|
320
|
+
const openBrowserFn = openBrowser === false ? false : fnOrUndefined(openBrowser);
|
|
321
|
+
const spawnImplFn = fnOrUndefined(spawnImpl);
|
|
322
|
+
const execFn = fnOrUndefined(exec);
|
|
323
|
+
const runScriptFn = fnOrUndefined(runScript);
|
|
324
|
+
/** 只接受有限的毫秒数(`0` 合法 = 立刻收尾;不传 = 用 login.mjs 的默认宽限) */
|
|
325
|
+
const postDeviceGraceMsFn = Number.isFinite(Number(postDeviceGraceMs)) && postDeviceGraceMs !== null
|
|
326
|
+
? Number(postDeviceGraceMs)
|
|
327
|
+
: undefined;
|
|
328
|
+
|
|
329
|
+
const startedAt = nowFn();
|
|
330
|
+
const { positionals, flags: rawFlags } = parseArgv(argv);
|
|
331
|
+
|
|
332
|
+
const resolved = resolveCommand(commands, positionals);
|
|
333
|
+
if (!resolved) {
|
|
334
|
+
const err = new UsageError(`不认识的命令:${positionals.join(' ') || '(空)'}`);
|
|
335
|
+
err.showHelp = true;
|
|
336
|
+
throw err;
|
|
337
|
+
}
|
|
338
|
+
const { spec, rest } = resolved;
|
|
339
|
+
const flags = coerceFlags(spec, rawFlags);
|
|
340
|
+
const positional = checkPositionals(spec, rest);
|
|
341
|
+
const config = resolveConfig(flags, env);
|
|
342
|
+
config.cmdName = 'wkgeo';
|
|
343
|
+
|
|
344
|
+
/**
|
|
345
|
+
* 是否 JSON 输出。
|
|
346
|
+
* ⚠️ 默认值依赖 `isTTY`:**非 TTY(管道 / AI 子进程)自动切 JSON**。
|
|
347
|
+
* 这个默认值是刻意的 —— 父进程多半是脚本或 AI,人类可读的表格对他们没用。
|
|
348
|
+
*/
|
|
349
|
+
const json = flags.json === true ? true : flags.text === true ? false : !stdout.isTTY;
|
|
350
|
+
|
|
351
|
+
const colorEnabled = config.color !== false && !env.NO_COLOR && !!stdout.isTTY && !json;
|
|
352
|
+
|
|
353
|
+
const api = createApi({ config, fetchImpl: fetchFn });
|
|
354
|
+
|
|
355
|
+
/**
|
|
356
|
+
* CMS 客户端(栏目 / 内容 / 素材 / 模板)。
|
|
357
|
+
*
|
|
358
|
+
* 它的地址、鉴权头、错误翻译都在 `lib/cms.mjs` 里;这里只把运行时依赖给它。
|
|
359
|
+
* 懒不懒加载无所谓:`createCms` 只是记住 base 与超时,不发任何请求。
|
|
360
|
+
*/
|
|
361
|
+
const cms = createCms({ config, fetchImpl: fetchFn });
|
|
362
|
+
|
|
363
|
+
/**
|
|
364
|
+
* 代理检测结果:**懒加载 + 记忆化**。
|
|
365
|
+
*
|
|
366
|
+
* ⚠️ 为什么不在这里直接算:Windows 上要起一次 `reg.exe`(约 30-50ms 真机实测)。
|
|
367
|
+
* 如果每个命令、每次输出都探测一遍,等于给所有命令加一笔固定开销;
|
|
368
|
+
* 而"代理会不会挡回调"这件事**只有 login(和诊断用的 config)关心**。
|
|
369
|
+
* 所以:谁需要谁调 `runtime.proxyInfo()`;`meta()` 只在**已经算过**时才把它带出去,
|
|
370
|
+
* 这样 `--json` 的错误信封里也能带上它(AI 端据此判断"是不是代理的锅"),
|
|
371
|
+
* 同时不给其它命令增加任何成本。
|
|
372
|
+
*/
|
|
373
|
+
const proxyState = { computed: false, info: null };
|
|
374
|
+
const proxyInfo = () => {
|
|
375
|
+
if (!proxyState.computed) {
|
|
376
|
+
proxyState.computed = true;
|
|
377
|
+
try {
|
|
378
|
+
proxyState.info = detectProxy({ platform, env, exec: execFn });
|
|
379
|
+
} catch (e) {
|
|
380
|
+
// 检测本身绝不能让命令失败:退化成"没检测到",只留一条诊断
|
|
381
|
+
proxyState.info = { detected: false, risk: false, loopback_bypassed: false, sources: [], platform, probe_error: String((e && e.message) || e) };
|
|
382
|
+
}
|
|
383
|
+
}
|
|
384
|
+
return proxyState.info;
|
|
385
|
+
};
|
|
386
|
+
|
|
387
|
+
const meta = () => {
|
|
388
|
+
const m = {
|
|
389
|
+
base: config.base,
|
|
390
|
+
/** CMS 面是另一个地址:出问题时"打的是哪个 CMS"必须能从信封里看出来 */
|
|
391
|
+
cms_base: config.cmsBase,
|
|
392
|
+
client_id: config.clientId,
|
|
393
|
+
credentials_file: config.credentialsFile,
|
|
394
|
+
/** 本地"当前站点"记录(排障时要能一眼看到它到底读的哪个文件) */
|
|
395
|
+
site_file: config.siteStateFile,
|
|
396
|
+
duration_ms: Math.max(0, nowFn() - startedAt),
|
|
397
|
+
};
|
|
398
|
+
// 只有"真的探测过"才带这个字段:没探测过 = 结论未知,不该编一个 false 出来
|
|
399
|
+
if (proxyState.computed) m.proxy_warning = proxyWarningPayload(proxyState.info, { cmdName: config.cmdName || 'wkgeo' });
|
|
400
|
+
return m;
|
|
401
|
+
};
|
|
402
|
+
|
|
403
|
+
const out = createOutput({ stdout, stderr, json, color: colorEnabled, meta });
|
|
404
|
+
|
|
405
|
+
/**
|
|
406
|
+
* 默认提问实现:一行一问,问完就关掉 readline(不常驻监听 stdin)。
|
|
407
|
+
*
|
|
408
|
+
* 为什么每次新建 interface:`sites list` 最多问 4 个问题,之后命令就结束了;
|
|
409
|
+
* 留一个常驻 interface 会让 Node 进程不退出(尤其 Windows 上 Ctrl+C 之后的表现很怪)。
|
|
410
|
+
* 前缀/提示文案由命令层给(本文件不出现业务措辞)。
|
|
411
|
+
*/
|
|
412
|
+
async function defaultAsk(question) {
|
|
413
|
+
const rl = readline.createInterface({ input: stdin, output: stdout });
|
|
414
|
+
try {
|
|
415
|
+
return await new Promise((resolve) => rl.question(String(question || ''), (answer) => resolve(String(answer || ''))));
|
|
416
|
+
} finally {
|
|
417
|
+
rl.close();
|
|
418
|
+
}
|
|
419
|
+
}
|
|
420
|
+
|
|
421
|
+
const runtime = {
|
|
422
|
+
spec,
|
|
423
|
+
flags,
|
|
424
|
+
positional,
|
|
425
|
+
config,
|
|
426
|
+
api,
|
|
427
|
+
out,
|
|
428
|
+
env,
|
|
429
|
+
/**
|
|
430
|
+
* ★ 2026-10-28:把**注入的 stdin** 也挂到 ctx 上。
|
|
431
|
+
*
|
|
432
|
+
* 为什么需要它:从 stdin(管道)或 TTY 无回显交互读密文(如 `publish targets save`
|
|
433
|
+
* 的密码)时,读取源必须与判定源是同一个对象。命令如果自己用 `process.stdin`,
|
|
434
|
+
* 单测注入的假 stdin 就永远不生效(用例会挂在真 stdin 上),而且 `stdinIsTTY`
|
|
435
|
+
* 与真正的读取源会**对不上**(一个被判成"管道"、另一个却在读终端)。
|
|
436
|
+
*/
|
|
437
|
+
stdin,
|
|
438
|
+
/** 时钟(**恒为函数**;不传 = `Date.now`) */
|
|
439
|
+
now: nowFn,
|
|
440
|
+
meta,
|
|
441
|
+
/** CMS 接口基址(`site use` / 报错提示里要用;**不是**平台面那个 base) */
|
|
442
|
+
cmsBase: config.cmsBase,
|
|
443
|
+
/** 本地"当前站点"记录文件(`wkgeo site use` 写它) */
|
|
444
|
+
siteStateFile: config.siteStateFile,
|
|
445
|
+
/** ★ 代理检测(懒加载 + 记忆化;见上面 proxyState 的说明) */
|
|
446
|
+
proxyInfo,
|
|
447
|
+
/**
|
|
448
|
+
* ★ 透传给 login/device 的依赖(见上面 createRuntime 的说明)。
|
|
449
|
+
*
|
|
450
|
+
* 0.5.1 起的契约:**这几个字段永远不会是"看起来注入了、其实是 undefined"的那一半**——
|
|
451
|
+
* * `fetchImpl` / `sleep` / `now` / `random` / `log`:恒为函数(有默认实现);
|
|
452
|
+
* * `openBrowser`:函数(注入的)|`false`(`--no-browser` = 用户明确关掉)|`undefined`
|
|
453
|
+
* (= 用 login.mjs / device.mjs 的生产默认实现,它们用 `typeof === 'function'` 判断,
|
|
454
|
+
* 所以 `undefined` 是**语义**而不是缺失值);
|
|
455
|
+
* * `spawnImpl` / `exec` / `runScript` / `postDeviceGraceMs` / `skillUrl`:`undefined` = 用
|
|
456
|
+
* 下游默认(`child_process.spawn` / `spawnSync` / 3s / 包内 SKILL.md),全部有兜底。
|
|
457
|
+
*/
|
|
458
|
+
fetchImpl: fetchFn,
|
|
459
|
+
openBrowser: openBrowserFn,
|
|
460
|
+
spawnImpl: spawnImplFn,
|
|
461
|
+
/** ★ 0.5.1:发布轮询(`publish --confirm`)就靠它 —— 以前这里是 `undefined`,必崩 */
|
|
462
|
+
sleep: sleepFn,
|
|
463
|
+
/** 随机源(默认 `Math.random`) */
|
|
464
|
+
random: randomFn,
|
|
465
|
+
/** 诊断日志(默认写 stderr;**不进 stdout**) */
|
|
466
|
+
log: logFn,
|
|
467
|
+
/** 组合时钟(`clock.now()` / `clock.sleep(ms)`,两者都用的上面的默认实现) */
|
|
468
|
+
clock: {
|
|
469
|
+
now: () => nowFn(),
|
|
470
|
+
sleep: (ms) => sleepFn(ms),
|
|
471
|
+
},
|
|
472
|
+
/** ★ 「设备码先成功后的监听宽限期」注入点(只为单测;见 createRuntime 的说明) */
|
|
473
|
+
postDeviceGraceMs: postDeviceGraceMsFn,
|
|
474
|
+
platform,
|
|
475
|
+
/**
|
|
476
|
+
* ★ 「是不是人在终端」—— `resolveBrowserIntent()` 的输入之一。
|
|
477
|
+
*
|
|
478
|
+
* 为什么放在 runtime 里算:只有这里同时知道 **stdout 是不是 TTY** 与 **是不是 JSON 输出**
|
|
479
|
+
* (`json` 的默认值也依赖 `isTTY`,见上面)。命令层原样透传即可,
|
|
480
|
+
* **绝不能**各命令自己判断一遍 —— 那迟早会出现"授权不弹、支付还弹"。
|
|
481
|
+
*/
|
|
482
|
+
isTTY: !!stdout.isTTY,
|
|
483
|
+
/**
|
|
484
|
+
* ★ 交互提问(`sites list` 的建站引导 / 选站)。
|
|
485
|
+
* * `ask` 生产 = readline,单测注入假实现;
|
|
486
|
+
* * `stdinIsTTY` 与 `isTTY`(stdout)**两个都要真**才算"人在终端"——
|
|
487
|
+
* 只有 stdout 是 TTY、stdin 被重定向时不能提问(否则进程会等在一个永远没有输入的 fd 上)。
|
|
488
|
+
*/
|
|
489
|
+
ask: fnOr(ask, defaultAsk),
|
|
490
|
+
stdinIsTTY: !!(stdin && stdin.isTTY),
|
|
491
|
+
/** ★ `skill` 命令读手册的位置(默认包内 SKILL.md;单测可注入不存在的路径) */
|
|
492
|
+
skillUrl,
|
|
493
|
+
/** 读登录态(未登录/过期 → 抛带提示的 CliError,exit 3) */
|
|
494
|
+
requireAuth({ allowExpired = false } = {}) {
|
|
495
|
+
return requireCredentials(config.credentialsFile, { allowExpired, now: nowFn() });
|
|
496
|
+
},
|
|
497
|
+
readCredentials() {
|
|
498
|
+
return readCredentials(config.credentialsFile);
|
|
499
|
+
},
|
|
500
|
+
/**
|
|
501
|
+
* 调业务接口:自动带上凭据里的 token。
|
|
502
|
+
*
|
|
503
|
+
* `opts.prefix` 改网关前缀(`form` / `ai` / `member` / `channel` / `ai-tools`),
|
|
504
|
+
* `opts.headers` 追加请求头(如插件函数要的 `x-cms-site` / `Origin`)——
|
|
505
|
+
* 见 `cli/lib/api.mjs` 的 `GATEWAY_PREFIXES`。
|
|
506
|
+
*/
|
|
507
|
+
callData(action, payload = {}, opts = {}) {
|
|
508
|
+
const creds = opts.credentials || runtime.requireAuth({ allowExpired: opts.allowExpired });
|
|
509
|
+
return api.data(action, payload, {
|
|
510
|
+
token: creds.access_token,
|
|
511
|
+
prefix: opts.prefix,
|
|
512
|
+
headers: opts.headers,
|
|
513
|
+
timeoutMs: opts.timeoutMs,
|
|
514
|
+
});
|
|
515
|
+
},
|
|
516
|
+
/**
|
|
517
|
+
* **本次要操作哪个站**(CMS 命令的站点来源)。
|
|
518
|
+
*
|
|
519
|
+
* 优先级(高 → 低):
|
|
520
|
+
* 1. `--site <站点ID>`(一次性覆盖,不改本地记录);
|
|
521
|
+
* 2. 环境变量 `WKONGAI_SITE`(CI / 脚本里固定下来);
|
|
522
|
+
* 3. 本地 `wkgeo site use` 选中的那个(`~/.wkongai/config.json`);
|
|
523
|
+
* 4. **都没有 ⇒ `id: ''`(不带 `x-cms-site` 头)**,由服务端按令牌的成员关系判定
|
|
524
|
+
* (一个成员站 → 就用它;多个 → 服务端回 400 让我们指定)。
|
|
525
|
+
*
|
|
526
|
+
* ⚠️ 为什么第 4 档不直接报错:Bearer 桥**故意**支持"只有一个成员站就自动用它"
|
|
527
|
+
* (见 docs/功能-CMS认证.md 三·优先级 3),单站用户不该被迫先跑一次 `site use`。
|
|
528
|
+
* 但**多站**时绝不替用户猜:服务端回 400,`lib/cms.mjs` 会把它翻译成
|
|
529
|
+
* "先 `wkgeo site use <站点ID>` 或加 `--site`"(`kind: cms_site_required`)。
|
|
530
|
+
*
|
|
531
|
+
* ⚠️ 为什么 `--site` 必须是**站点 id(uuid)**:CMS 的 `x-cms-site` 先按 `id::text` 查,
|
|
532
|
+
* 再按 Host 兜底 —— CLI 没有 Host,传域名等于没传(会被当成"没指定")。
|
|
533
|
+
* 这种"看起来传了其实没生效"的事最难查,所以在本地就挡住并告诉他改用 `site use <域名>`。
|
|
534
|
+
*
|
|
535
|
+
* @returns {{id:string, label:string|null, source:'flag'|'env'|'local'|'none'}}
|
|
536
|
+
* @throws {UsageError} `--site` / `WKONGAI_SITE` 不是 uuid
|
|
537
|
+
*/
|
|
538
|
+
cmsSite() {
|
|
539
|
+
const flagSite = flags.site !== undefined && flags.site !== '' ? String(flags.site).trim() : '';
|
|
540
|
+
/**
|
|
541
|
+
* ★ 2026-11-21(一个对话只能操作一个站点):DSH 站点卡片会话会注入
|
|
542
|
+
* `DSH_WKGEO_SITE` + `DSH_WKGEO_SITE_LOCK=1`。锁定时**显式指定的站**必须就是它,
|
|
543
|
+
* 否则在本地直接拦(不发请求),哪怕调用方传的是别的站 id。
|
|
544
|
+
* 无 `--site` / `WKONGAI_SITE` 时回落到 `DSH_WKGEO_SITE`(手敲 wkgeo 也不会串站)。
|
|
545
|
+
*/
|
|
546
|
+
const envSite = String((env && env.WKONGAI_SITE) || '').trim() || String((env && env.DSH_WKGEO_SITE) || '').trim();
|
|
547
|
+
const lockSite = String((env && env.DSH_WKGEO_SITE) || '').trim();
|
|
548
|
+
const locked = String((env && env.DSH_WKGEO_SITE_LOCK) || '').trim() === '1';
|
|
549
|
+
const explicit = flagSite || envSite;
|
|
550
|
+
if (locked && lockSite && explicit && explicit.toLowerCase() !== lockSite.toLowerCase()) {
|
|
551
|
+
throw new UsageError('这个会话锁定在站点 ' + lockSite + ',不能操作别的站');
|
|
552
|
+
}
|
|
553
|
+
if (explicit) {
|
|
554
|
+
if (!/^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$/.test(explicit)) {
|
|
555
|
+
throw new UsageError(
|
|
556
|
+
`${flagSite ? '--site' : 'WKONGAI_SITE'} 要填**站点 ID(uuid)**,收到:${explicit}\n` +
|
|
557
|
+
`传域名请先解析成 ID:\`wkgeo site use ${explicit}\`(之后不带 --site 就直接用这个站)`,
|
|
558
|
+
);
|
|
559
|
+
}
|
|
560
|
+
return { id: explicit, label: null, source: flagSite ? 'flag' : 'env' };
|
|
561
|
+
}
|
|
562
|
+
/**
|
|
563
|
+
* ★ v14(按站票据):没有 `--site` / `WKONGAI_SITE` 时,如果 CLI 是**在某个站点目录里**
|
|
564
|
+
* 跑起来的(`config.credentialsFile` 已经换成该站的短票),默认就用票上那个站 ——
|
|
565
|
+
* 比本机 `wkgeo site use` 留下的旧站更可信(旧记录可能是在别的目录选的)。
|
|
566
|
+
* 显式 `--site` / 环境变量仍然优先。
|
|
567
|
+
*/
|
|
568
|
+
const ticketSite = String((config && config.siteCredential && config.siteCredential.siteId) || '').trim();
|
|
569
|
+
if (ticketSite) return { id: ticketSite, label: null, source: 'site-credential' };
|
|
570
|
+
const saved = readSiteState(config.siteStateFile);
|
|
571
|
+
if (saved && saved.id) return { id: saved.id, label: saved.label || null, source: 'local' };
|
|
572
|
+
return { id: '', label: null, source: 'none' };
|
|
573
|
+
},
|
|
574
|
+
/**
|
|
575
|
+
* 取 **CMS 管理面**要用的身份。老板 2026-11-22 硬口径:
|
|
576
|
+
* **「`wkgeo login` 只有 CLI 该有;填了 Key 就不该再要登录,否则就是重复登录」**。
|
|
577
|
+
*
|
|
578
|
+
* 解析顺序(**Key 永远优先,且不回落账号 OAuth**):
|
|
579
|
+
* 1. env `WKGEO_API_KEY`(面板 / 自动化注入的 Key,直接当 Bearer,不落盘)
|
|
580
|
+
* 2. 主凭据 `config.credentialsFile`:是 `wkgeo_sk_…` Key ⇒ **只走 Key**(401/403 由
|
|
581
|
+
* `keyCmsCliError` 翻成 `AUTH_FAILED` / `KEY_SCOPE_DENIED`,不提示登录)
|
|
582
|
+
* 3. 主凭据是**账号 OAuth**(纯 CLI 用户 `wkgeo login` 的场景)⇒ 用它
|
|
583
|
+
* 4. 都没有 ⇒ `cmsCredentialsFile`(纯 CLI 用户的账号登录态)
|
|
584
|
+
*
|
|
585
|
+
* 为什么不再「Key 401 → 回落账号」:那正是重复登录的来源;CMS 侧 task-58 起已认
|
|
586
|
+
* Key 做模板读动作,回落只会掩盖真正的 Key 问题。
|
|
587
|
+
*
|
|
588
|
+
* @returns {{creds:object, file:string, kind:'key'|'account'}}
|
|
589
|
+
*/
|
|
590
|
+
cmsAuth() {
|
|
591
|
+
const envKey = String((env && env.WKGEO_API_KEY) || '').trim();
|
|
592
|
+
if (envKey) {
|
|
593
|
+
return { creds: { access_token: envKey }, file: 'env:WKGEO_API_KEY', kind: 'key' };
|
|
594
|
+
}
|
|
595
|
+
const primaryFile = String((config && config.credentialsFile) || '').trim();
|
|
596
|
+
const accountFile = String((config && config.cmsCredentialsFile) || '').trim();
|
|
597
|
+
const primary = readCredentialToken(primaryFile, nowFn);
|
|
598
|
+
/* ★ Key 优先:主凭据本身就是 Key ⇒ 只走 Key,不看账号文件、不给登录提示 */
|
|
599
|
+
if (primary.ok) return { creds: primary.creds, file: primary.file, kind: primary.kind };
|
|
600
|
+
const account = accountFile && accountFile !== primaryFile
|
|
601
|
+
? readCredentialToken(accountFile, nowFn)
|
|
602
|
+
: { ok: false, kind: 'missing', file: accountFile };
|
|
603
|
+
if (account.ok) return { creds: account.creds, file: account.file, kind: account.kind };
|
|
604
|
+
if (primary.error) throw primary.error;
|
|
605
|
+
if (account.error) throw account.error;
|
|
606
|
+
return {
|
|
607
|
+
creds: requireCredentials(primaryFile || accountFile, { now: nowFn() }),
|
|
608
|
+
file: primaryFile || accountFile,
|
|
609
|
+
kind: 'account',
|
|
610
|
+
};
|
|
611
|
+
},
|
|
612
|
+
/**
|
|
613
|
+
* 调 CMS 动作:自动带 `Authorization: Bearer <token>` +(有站点时)`x-cms-site`。
|
|
614
|
+
*
|
|
615
|
+
* @param {string} action 动作名
|
|
616
|
+
* @param {object} [payload] 业务参数
|
|
617
|
+
* @param {{noSite?:boolean}} [opts]
|
|
618
|
+
* **`noSite: true` = 无站点模式(不带 `x-cms-site`)**。
|
|
619
|
+
* 只有"站点还不存在"的动作才用得上(目前就一个:`cmsCreateSite` 建站)。
|
|
620
|
+
* 为什么必须有这一档:本地 `config.json` 里可能留着**上一个**站点 id,
|
|
621
|
+
* 而服务端的 Bearer 桥在进 handler 之前就按 `x-cms-site` 解析站点(不是成员 ⇒ 403)——
|
|
622
|
+
* 建站会被一个与本次无关的旧 id 挡住。建站时**还没有**新站点,就必须一个都不带。
|
|
623
|
+
*/
|
|
624
|
+
cmsCall(action, payload = {}, opts = {}) {
|
|
625
|
+
/**
|
|
626
|
+
* ★ 2026-11-22:Key 模式只走 Key(CMS task-58 起认 `wkgeo_sk_` 做模板读动作);
|
|
627
|
+
* Key 被拒时由 `keyCmsCliError` 给人话(重建 Key),**不再回落账号 OAuth**。
|
|
628
|
+
*/
|
|
629
|
+
const auth = runtime.cmsAuth();
|
|
630
|
+
let siteId;
|
|
631
|
+
if (!(opts && opts.noSite)) {
|
|
632
|
+
const site = runtime.cmsSite();
|
|
633
|
+
siteId = site.id || undefined;
|
|
634
|
+
}
|
|
635
|
+
try {
|
|
636
|
+
return cms.call(action, payload, { token: auth.creds.access_token, siteId });
|
|
637
|
+
} catch (err) {
|
|
638
|
+
if (auth.kind !== 'key') throw err;
|
|
639
|
+
throw keyCmsCliError(action, err);
|
|
640
|
+
}
|
|
641
|
+
},
|
|
642
|
+
/**
|
|
643
|
+
* 调 **内容类自持动作**(`wkgeo-cli-fc` 的 B1 45 条:栏目 / 文章 / 字段 / 关联 /
|
|
644
|
+
* 标签 / 站内链接 / SEO)—— 走 `/cli`,**不经过 `/cms`**。
|
|
645
|
+
*
|
|
646
|
+
* 老板 2026-10-28:「CLI 的所有动作都必须由 CLI 自己的函数实现,不走 /cms 转发,
|
|
647
|
+
* 目的是统计/限制 agent 动作量。」⇒ 这几个命令以前借 CMS 的 actionTable 处理,
|
|
648
|
+
* 现在由 CLI 函数自己实现(`aliyun/fc/wkgeo-cli-fc/src/content-core.js`),
|
|
649
|
+
* 于是它们**同样进 `cli_action_usage` 计数、同样受 CLI 的额度/限频约束**。
|
|
650
|
+
*
|
|
651
|
+
* ⚠️ 与 `cmsCall` 的差别(别照抄):
|
|
652
|
+
* 1. 站点 id 走 **body.siteId**(不是 `x-cms-site` 头)——content-core 只认调用者名下
|
|
653
|
+
* 的站(`site.owner_id = 当前用户`),成员站请在 CMS 后台操作;
|
|
654
|
+
* 2. 站点没选就**本地直接报错**,不把空站点丢给服务端(服务端也挡,但那样要多一次往返);
|
|
655
|
+
* 3. 响应信封与 `/cms` 一致(`code/message/data`),所以上层格式化代码不用改。
|
|
656
|
+
*/
|
|
657
|
+
contentCall(action, payload = {}, opts = {}) {
|
|
658
|
+
const creds = runtime.requireAuth();
|
|
659
|
+
const site = opts && opts.siteId ? { id: String(opts.siteId), source: 'flag' } : runtime.cmsSite();
|
|
660
|
+
if (!site.id) {
|
|
661
|
+
throw new UsageError(
|
|
662
|
+
`CLI 内容动作要指定站点:先 \`wkgeo site use <站点ID>\`,或加 \`--site <站点ID>\` / 设 WKONGAI_SITE(站点 ID 见 \`wkgeo sites list\`)`,
|
|
663
|
+
);
|
|
664
|
+
}
|
|
665
|
+
return runtime.callData(action, { ...payload, siteId: site.id }, { timeoutMs: opts.timeoutMs });
|
|
666
|
+
},
|
|
667
|
+
/**
|
|
668
|
+
* 调 **发布类自持动作**(`wkgeo-cli-fc` 的 B3 16 条:发布任务 / 推送目标 / 客户桶)——
|
|
669
|
+
* 同样走 `/cli`(`prefix` 不传 ⇒ `api.mjs` 默认打 CLI 自己的函数),**不经过 `/cms`**。
|
|
670
|
+
*
|
|
671
|
+
* 老板 2026-10-28:「CLI 的所有动作都必须由 CLI 自己的函数实现」⇒ 以前
|
|
672
|
+
* `wkgeo publish` 借 CMS 的 actionTable(`ctx.cmsCall`),现在由
|
|
673
|
+
* `aliyun/fc/wkgeo-cli-fc/src/publish-core.js` 自己接:它**只做调度层**
|
|
674
|
+
* (校验站点归属 → 建/查/取消 job 行 → 异步触发 worker),渲染与上传仍由
|
|
675
|
+
* `wkgeo-site-publish` 执行 —— CLI 里没有第二份渲染实现。
|
|
676
|
+
*
|
|
677
|
+
* 与 `contentCall` 一致:站点走 **body.siteId**(不是 `x-cms-site` 头)、没选站本地直接
|
|
678
|
+
* 报错(不多跑一次往返)、信封同样是 `code/message/data`。
|
|
679
|
+
* 发布动作的默认超时比读接口长(起任务要算页面清单),所以 `timeoutMs` 默认 60s。
|
|
680
|
+
*/
|
|
681
|
+
publishCall(action, payload = {}, opts = {}) {
|
|
682
|
+
const creds = runtime.requireAuth();
|
|
683
|
+
const site = opts && opts.siteId ? { id: String(opts.siteId), source: 'flag' } : runtime.cmsSite();
|
|
684
|
+
if (!site.id) {
|
|
685
|
+
throw new UsageError(
|
|
686
|
+
`CLI 发布动作要指定站点:先 \`wkgeo site use <站点ID>\`,或加 \`--site <站点ID>\` / 设 WKONGAI_SITE(站点 ID 见 \`wkgeo sites list\`)`,
|
|
687
|
+
);
|
|
688
|
+
}
|
|
689
|
+
return runtime.callData(
|
|
690
|
+
action,
|
|
691
|
+
{ ...payload, siteId: site.id },
|
|
692
|
+
{ timeoutMs: opts.timeoutMs === undefined ? 60000 : opts.timeoutMs },
|
|
693
|
+
);
|
|
694
|
+
},
|
|
695
|
+
/**
|
|
696
|
+
* 调 **配置类 auth 面自持动作**(`wkgeo-cli-fc` 的 B7 11 条:成员 / 角色 / 语言)——
|
|
697
|
+
* 同样走 `/cli`,**不经过 `/cms`**。
|
|
698
|
+
*
|
|
699
|
+
* 老板 2026-10-28:「CLI 的所有动作都必须由 CLI 自己的函数实现」⇒ 这几条以前
|
|
700
|
+
* `wkgeo member/role/lang` 借 CMS 的 actionTable(`ctx.cmsCall`),现在由
|
|
701
|
+
* `aliyun/fc/wkgeo-cli-fc/src/config-auth-core.js` 自己接。
|
|
702
|
+
*
|
|
703
|
+
* 与 `contentCall` 完全同形(站点走 **body.siteId**、没选站本地直接报错、信封 `code/message/data`),
|
|
704
|
+
* 但**权限面更细**:读要 `site:read`、改成员/语言要 `site:write`、改角色要 **`role:write`**
|
|
705
|
+
* (`site:write` 不继承 `role:write`)—— 因为「能改角色」等于「能给自己发权限」。
|
|
706
|
+
*/
|
|
707
|
+
configAuthCall(action, payload = {}, opts = {}) {
|
|
708
|
+
const creds = runtime.requireAuth();
|
|
709
|
+
const site = opts && opts.siteId ? { id: String(opts.siteId), source: 'flag' } : runtime.cmsSite();
|
|
710
|
+
if (!site.id) {
|
|
711
|
+
throw new UsageError(
|
|
712
|
+
`CLI 人员/角色/语言动作要指定站点:先 \`wkgeo site use <站点ID>\`,或加 \`--site <站点ID>\` / 设 WKONGAI_SITE(站点 ID 见 \`wkgeo sites list\`)`,
|
|
713
|
+
);
|
|
714
|
+
}
|
|
715
|
+
return runtime.callData(action, { ...payload, siteId: site.id }, { timeoutMs: opts.timeoutMs });
|
|
716
|
+
},
|
|
717
|
+
/**
|
|
718
|
+
* 调 **站点类自持动作**(`wkgeo-cli-fc` 的 B4 7 条:公司信息 / 域名巡检重检 /
|
|
719
|
+
* 示例内容 / 站级同步)—— 同样走 `/cli`,**不经过 `/cms`**。
|
|
720
|
+
*
|
|
721
|
+
* 老板 2026-10-28:「CLI 的所有动作都必须由 CLI 自己的函数实现」⇒ 这几条以前
|
|
722
|
+
* 要么借 CMS 的 actionTable(`ctx.cmsCall`),要么 CLI 干脆没有命令;
|
|
723
|
+
* 现在由 `aliyun/fc/wkgeo-cli-fc/src/site-core.js` 自己接(逐字复制 CMS handler)。
|
|
724
|
+
*
|
|
725
|
+
* 与 `contentCall` / `configAuthCall` 完全同形:站点走 **body.siteId**、
|
|
726
|
+
* 没选站本地直接报错(不多跑一次往返)、信封同样是 `code/message/data`。
|
|
727
|
+
* 服务端另外校验 **站点归属**(不是自己名下站 ⇒ 403 `not_site_owner`)。
|
|
728
|
+
*/
|
|
729
|
+
siteCoreCall(action, payload = {}, opts = {}) {
|
|
730
|
+
const creds = runtime.requireAuth();
|
|
731
|
+
const site = opts && opts.siteId ? { id: String(opts.siteId), source: 'flag' } : runtime.cmsSite();
|
|
732
|
+
if (!site.id) {
|
|
733
|
+
throw new UsageError(
|
|
734
|
+
`CLI 站点类动作要指定站点:先 \`wkgeo site use <站点ID>\`,或加 \`--site <站点ID>\` / 设 WKONGAI_SITE(站点 ID 见 \`wkgeo sites list\`)`,
|
|
735
|
+
);
|
|
736
|
+
}
|
|
737
|
+
return runtime.callData(action, { ...payload, siteId: site.id }, { timeoutMs: opts.timeoutMs });
|
|
738
|
+
},
|
|
739
|
+
/**
|
|
740
|
+
* 调 **插件类自持动作**(`wkgeo-cli-fc` 的 B5 9 条:插件列表 / 访问范围 / 启停 /
|
|
741
|
+
* 配置保存 / 插件市场列表 / 安装 / 卸载 / 升级 / 演示链接)—— 走 `/cli`,
|
|
742
|
+
* **不经过 `/cms`**(task-91;服务端实现在 `src/plugin-core.js`,逐字复制 CMS handler)。
|
|
743
|
+
*
|
|
744
|
+
* 与 `siteCoreCall` 完全同形(同一个归属闸、同一个信封):这里单独开一个方法不是为了
|
|
745
|
+
* 换行为,而是让命令层的调用点一眼能看出"这条动作属于插件面",
|
|
746
|
+
* 将来插件面加 scope 或换 base 也只改这一处。
|
|
747
|
+
*/
|
|
748
|
+
pluginCall(action, payload = {}, opts = {}) {
|
|
749
|
+
const creds = runtime.requireAuth();
|
|
750
|
+
const site = opts && opts.siteId ? { id: String(opts.siteId), source: 'flag' } : runtime.cmsSite();
|
|
751
|
+
if (!site.id) {
|
|
752
|
+
throw new UsageError(
|
|
753
|
+
`CLI 插件类动作要指定站点:先 \`wkgeo site use <站点ID>\`,或加 \`--site <站点ID>\` / 设 WKONGAI_SITE(站点 ID 见 \`wkgeo sites list\`)`,
|
|
754
|
+
);
|
|
755
|
+
}
|
|
756
|
+
return runtime.callData(action, { ...payload, siteId: site.id }, { timeoutMs: opts.timeoutMs });
|
|
757
|
+
},
|
|
758
|
+
/**
|
|
759
|
+
* 调 **控制台类自持动作**(`wkgeo-cli-fc` 的 B7 剩余 8 条:操作日志 / 参数读取 /
|
|
760
|
+
* 参数保存 / 统计代码审核 / 站点概览 / 账号流量账单 / 控制台首页快照 / 会员付费能力)——
|
|
761
|
+
* 走 `/cli`,**不经过 `/cms`**(task-92;服务端实现在 `src/console-core.js`,逐字复制 CMS handler)。
|
|
762
|
+
*
|
|
763
|
+
* 与 `pluginCall` 完全同形,唯一差别是 `opts.headers` 会原样透传:`configReview` 的
|
|
764
|
+
* `x-review-token` 必须走请求头(服务端拿 `REVIEW_TOKEN` 环境变量逐字比对),
|
|
765
|
+
* 不进 body —— 否则会被写进日志与审计 detail。
|
|
766
|
+
*/
|
|
767
|
+
consoleCall(action, payload = {}, opts = {}) {
|
|
768
|
+
const creds = runtime.requireAuth();
|
|
769
|
+
const site = opts && opts.siteId ? { id: String(opts.siteId), source: 'flag' } : runtime.cmsSite();
|
|
770
|
+
if (!site.id) {
|
|
771
|
+
throw new UsageError(
|
|
772
|
+
`CLI 控制台类动作要指定站点:先 \`wkgeo site use <站点ID>\`,或加 \`--site <站点ID>\` / 设 WKONGAI_SITE(站点 ID 见 \`wkgeo sites list\`)`,
|
|
773
|
+
);
|
|
774
|
+
}
|
|
775
|
+
return runtime.callData(action, { ...payload, siteId: site.id }, { timeoutMs: opts.timeoutMs, headers: opts.headers });
|
|
776
|
+
},
|
|
777
|
+
/** 读本地"当前站点"记录(没选过 = null) */
|
|
778
|
+
readSiteState() {
|
|
779
|
+
return readSiteState(config.siteStateFile);
|
|
780
|
+
},
|
|
781
|
+
/** 写本地"当前站点"记录(给了就覆盖) */
|
|
782
|
+
writeSiteState(one) {
|
|
783
|
+
return writeSiteState(config.siteStateFile, one, { now: nowFn() });
|
|
784
|
+
},
|
|
785
|
+
/**
|
|
786
|
+
* ★ `wkgeo import` 起子进程的注入点(生产 = `spawnSync`,见 lib/local-import.mjs)。
|
|
787
|
+
* `undefined` 时命令层自己退回 `runNodeCommand`(`cli/lib/commands/import.mjs`),所以不会崩。
|
|
788
|
+
*/
|
|
789
|
+
runScript: runScriptFn,
|
|
790
|
+
/** 成功收尾(JSON 模式输出信封;人类模式什么都不做,由命令自己打印) */
|
|
791
|
+
done(data) {
|
|
792
|
+
out.emitOk(spec.name, data);
|
|
793
|
+
},
|
|
794
|
+
};
|
|
795
|
+
return runtime;
|
|
796
|
+
}
|
|
797
|
+
|
|
798
|
+
export { EXIT };
|