@wkgeo/cli 1.1.0 → 1.1.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,541 +1,640 @@
1
- /**
2
- * 命令注册表 + 帮助文本。
3
- *
4
- * 为什么注册表要同时带着 `usage`/`flags`/`args`:
5
- * * 解析器用它做校验(未知参数直接报错,不静默忽略)
6
- * * `--help` 用它生成文本 —— **帮助与实际行为同源**,不会出现"文档写了但命令不支持"
7
- */
8
-
9
- import { GLOBAL_FLAGS } from '../args.mjs';
10
- import {
11
- loginCommand,
12
- logoutCommand,
13
- whoamiCommand,
14
- configCommand,
15
- authStatusCommand,
16
- authTokenCommand,
17
- authRevokeCommand,
18
- } from './auth.mjs';
19
- import { sitesListCommand, sitesGetCommand, sitesCreateCommand, sitesDeleteCommand } from './sites.mjs';
20
- import {
21
- siteUseCommand,
22
- categoriesListCommand,
23
- categoriesGetCommand,
24
- categoriesCreateCommand,
25
- categoriesUpdateCommand,
26
- categoriesSaveCommand,
27
- categoriesDeleteCommand,
28
- categoriesBindTemplateCommand,
29
- contentsListCommand,
30
- contentsGetCommand,
31
- contentsCreateCommand,
32
- contentsUpdateCommand,
33
- contentsSaveCommand,
34
- contentsDeleteCommand,
35
- assetsListCommand,
36
- assetsUploadCommand,
37
- assetsSignCommand,
38
- assetsRegisterCommand,
39
- assetsDeleteCommand,
40
- assetsRestoreCommand,
41
- templatesListCommand,
42
- templatesGetCommand,
43
- templatesSaveCommand,
44
- publishCommand,
45
- publishStatusCommand,
46
- publishCancelCommand,
47
- /**
48
- * ★ task-68 / B3:发布类 16 条动作迁入 `wkgeo-cli-fc` 自持(走 `/cli`,不再借 `/cms`)。
49
- * 命令面:`publish retry` / `publish jobs[ get|cancel]` / `publish targets[ save|delete|test]` /
50
- * `publish push` / `publish storage[ save|verify|delete|publish]`。
51
- */
52
- publishRetryCommand,
53
- publishJobsCommand,
54
- publishJobGetCommand,
55
- publishJobCancelCommand,
56
- publishTargetsCommand,
57
- publishTargetsSaveCommand,
58
- publishTargetsDeleteCommand,
59
- publishTargetsTestCommand,
60
- publishPushCommand,
61
- publishStorageCommand,
62
- publishStorageSaveCommand,
63
- publishStorageVerifyCommand,
64
- publishStorageDeleteCommand,
65
- publishStoragePublishCommand,
66
- } from './cms.mjs';
67
- import {
68
- formsListCommand,
69
- formsEntriesCommand,
70
- domainInspectionCommand,
71
- domainBindCommand,
72
- domainStatusCommand,
73
- domainRecordsCommand,
74
- domainDnsCommand,
75
- domainCheckCommand,
76
- domainRemindCommand,
77
- previewCommand,
78
- importV2StartCommand,
79
- importV2StatusCommand,
80
- } from './siteops.mjs';
81
- import { aiPingCommand, aiAskCommand, aiChatCommand, contextExportCommand } from './ai.mjs';
82
- import { importCommand } from './import.mjs';
83
- import { walletCommand, walletTxnsCommand, walletRechargeCommand, walletRechargeLinkCommand } from './billing.mjs';
84
- import {
85
- productsListCommand,
86
- ordersCreateCommand,
87
- ordersCheckCommand,
88
- ordersPayCommand,
89
- ordersGetCommand,
90
- ordersListCommand,
91
- } from './orders.mjs';
92
- import { appsListCommand, appsRevokeCommand } from './apps.mjs';
93
- import { skillCommand } from './skill.mjs';
94
- /**
95
- * 自持成交链(2026-10-28 老板单):域名查价 / 下单 / 订单状态 / 云解析读写 / ESA 开通 / 建站收口。
96
- * 全部打 `/cli`(自持 `wkgeo-cli-fc`),**不**复用 wkgeo-domain / cms 那套。
97
- */
98
- import {
99
- domainSearchCommand,
100
- domainBuyCommand,
101
- domainOrderCommand,
102
- domainZoneListCommand,
103
- domainZoneAddCommand,
104
- domainZoneUpdateCommand,
105
- domainZoneDeleteCommand,
106
- esaSiteCommand,
107
- esaRecordCommand,
108
- esaHostnameCommand,
109
- esaKvCommand,
110
- siteCreateCommand,
111
- } from './domainops.mjs';
112
- /**
113
- * 成品链路(task-21):在平台模板下注册 → 客户模板 → 收费 → 模板认证 → 快速过户。
114
- * 与上面 12 条同住 `wkgeo-cli-fc`,同样走 `/cli`;命令名带三词(`domain order create`),
115
- * 依赖 `lib/args.mjs#resolveCommand` 的最长前缀匹配。
116
- */
117
- import { DOMAIN_ORDER_COMMANDS } from './domainorder.mjs';
118
- /**
119
- * 域名级 DNS 凭据(2026-10-28 老板单):`domain dns credential detect|set|status|delete`。
120
- * 四词命令(`domain dns` 已被 siteops 的"照抄表"只读命令占用),依赖 `resolveCommand` 的最长前缀匹配。
121
- * 秘密只从 stdin / 无回显交互读,**不进命令行**。
122
- */
123
- import { DNS_CREDENTIAL_COMMANDS } from './dnscred.mjs';
124
- /**
125
- * ★ task-75 / B7:配置类 auth 面 11 条迁入 `wkgeo-cli-fc` 自持(走 `/cli`,不再借 `/cms`)。
126
- * 命令面:`lang list|save|set-default|delete|toggle`、`role list|save|delete`、
127
- * `member list|update|remove`(`memberAdd` / `userProfileUpdate` 复核结论是**不迁**)。
128
- * 读 = `site:read`、改成员/语言 = `site:write`、改角色 = `role:write`(独立 scope)。
129
- */
130
- import { CONFIG_AUTH_COMMANDS } from './config-auth.mjs';
131
-
132
- /**
133
- * ★ task-90(2026-10-29):站点类自持面 —— B4 7 条(公司信息 / 域名巡检重检 /
134
- * 示例内容 / 站级同步)搬进 `wkgeo-cli-fc`(`src/site-core.js`,逐字复制 CMS handler)。
135
- * 命令面:`site info`、`site info save`、`site domain-recheck`、`site demo-seed`、
136
- * `site demo-clear`、`site sync`;`domain inspection` 也从 `/cms` 改走 `/cli`。
137
- * 读 = `site:read`、写 = `site:write`,写动作默认 dry-run。
138
- * **不迁 2 条**:`cmsCreateSite`(已有原生 `site create`)、`cmsSiteDomainCheck`
139
- * (已有原生 `siteDomainCheck`,`wkgeo domain check` 在用)。
140
- */
141
- import { SITE_COMMANDS } from './site.mjs';
142
-
143
- /**
144
- * ★ task-91(2026-10-29):插件类自持面 —— B5 9 条(插件列表 / 访问范围 / 启停 /
145
- * 配置保存 / 市场列表 / 安装 / 卸载 / 升级 / 演示链接)搬进 `wkgeo-cli-fc`
146
- * (`src/plugin-core.js`,逐字复制 CMS handler)。9 条**全部可迁**。
147
- * 命令面:`plugins list|access|toggle|settings|market-list|install|uninstall|upgrade|demo`。
148
- * 读 = `site:read`、写 = `site:write`(写类默认 dry-run,`--confirm` 才发)。
149
- * `plugins list` / `plugins toggle` 两条命令名不变 —— 只是从 `/cms` 转发改走 `/cli` 自持。
150
- */
151
- import { PLUGIN_COMMANDS } from './plugins.mjs';
152
-
153
- /**
154
- * ★ task-92(2026-10-29):控制台类自持面 —— B7 **剩余 8 条**(操作日志 / 参数读取 /
155
- * 参数保存 / 统计代码审核 / 站点概览 / 账号级流量账单 / 控制台首页快照 / 会员支付能力)
156
- * 搬进 `wkgeo-cli-fc`(`src/console-core.js`,逐字复制 CMS handler)。8 条**全部可迁**。
157
- * 命令面:`logs list`、`config get|save|review|capabilities`、
158
- * `overview summary|traffic|dashboard`。
159
- * 读 = `site:read`、写 = `site:write`(写类 `config save` / `config review` 默认 dry-run)。
160
- * ⚠️ B7 的 **AI 7 条(aiLogList / aiLogDetail / aiLogStats / aiTaskCreate / aiTaskMessages /
161
- * aiTaskModels / aiToolConfirm)本批不做** —— 后台 AI 功能还没做完,等做完再单开一单。
162
- * ⚠️ `config` 这个单名命令早就被 `auth.mjs` 的本地诊断占着(`wkgeo config` 读凭据/代理),
163
- * 所以这里只在它后面追加 `config get|save|…` 子命令,`wkgeo config` 本身行为一字未改。
164
- */
165
- import { LOG_COMMANDS } from './logs.mjs';
166
- import { CONFIG_CONSOLE_COMMANDS } from './config.mjs';
167
- import { OVERVIEW_COMMANDS } from './overview.mjs';
168
- /**
169
- * ★ 2026-10-30(task-56):基础库 npm 分发 —— `template init` 一条命令下载整套基础库。
170
- * 老板定调「还是放 npm」:从公开包 `@wkgeo/base-template`(+ npmmirror 镜像)取,
171
- * 校验 integrity、防路径穿越、落本地缓存。**不装进 node_modules**,落地目录就是模板本身。
172
- */
173
- import { templateInitCommand } from './template.mjs';
174
-
175
- export const COMMANDS = [
176
- loginCommand,
177
- whoamiCommand,
178
- logoutCommand,
179
- /**
180
- * ★ 2026-10-28(task-12):`auth` 命令组 —— 把"令牌 / 动作面"讲清楚的只读口。
181
- * 令牌模型不变(就是 `wkgeo login` 拿的 OAuth access_token,30 天),
182
- * 这里**不做**令牌换领:`auth status` 调 `cliWhoami`,`auth token` 只给前 4 位,
183
- * `auth revoke` = 服务端 RFC 7009 吊销 + 删本地凭据。
184
- */
185
- authStatusCommand,
186
- authTokenCommand,
187
- authRevokeCommand,
188
- sitesCreateCommand,
189
- sitesListCommand,
190
- sitesGetCommand,
191
- sitesDeleteCommand,
192
- /**
193
- * ★ 2026-10-18(CMS 面):先选站,再操作内容。
194
- * `site use` 排在最前面 —— 它是后面所有 CMS 命令的前置(后端只认站点成员,
195
- * 而 CLI 没有 Cookie 会话,站点上下文只能来自 `--site` 或本地这条记录)。
196
- */
197
- siteUseCommand,
198
- categoriesListCommand,
199
- categoriesGetCommand,
200
- categoriesCreateCommand,
201
- categoriesUpdateCommand,
202
- categoriesSaveCommand,
203
- categoriesDeleteCommand,
204
- categoriesBindTemplateCommand,
205
- contentsListCommand,
206
- contentsGetCommand,
207
- contentsCreateCommand,
208
- contentsUpdateCommand,
209
- contentsSaveCommand,
210
- contentsDeleteCommand,
211
- assetsListCommand,
212
- assetsUploadCommand,
213
- assetsSignCommand,
214
- assetsRegisterCommand,
215
- assetsDeleteCommand,
216
- assetsRestoreCommand,
217
- templatesListCommand,
218
- templatesGetCommand,
219
- templatesSaveCommand,
220
- publishCommand,
221
- publishStatusCommand,
222
- publishCancelCommand,
223
- /* 发布面其余动作(task-68 / B3):重发 / 推送任务 / 推送目标 / 推送 / 客户桶 */
224
- publishRetryCommand,
225
- publishJobsCommand,
226
- publishJobGetCommand,
227
- publishJobCancelCommand,
228
- publishTargetsCommand,
229
- publishTargetsSaveCommand,
230
- publishTargetsDeleteCommand,
231
- publishTargetsTestCommand,
232
- publishPushCommand,
233
- publishStorageCommand,
234
- publishStorageSaveCommand,
235
- publishStorageVerifyCommand,
236
- publishStorageDeleteCommand,
237
- publishStoragePublishCommand,
238
- /**
239
- * ★ 0.5.0 新增:站点运营面(表单 / 域名巡检 / 预览 / 导入 v2)。
240
- * 共同约定:写操作默认 dry-run(`--confirm` 才真发);人产出的数据默认脱敏。
241
- * ★ task-91 / B5:原来这儿的 `plugins list` / `plugins toggle` 改由 `PLUGIN_COMMANDS`
242
- * 提供(走 `/cli` 自持通道,不再 `/cms` 转发),并补齐插件面另外 7 条命令。
243
- */
244
- formsListCommand,
245
- formsEntriesCommand,
246
- domainInspectionCommand,
247
- /**
248
- * ★ task-9(0.5.2 未发布):域名只读命令 —— 状态 / 解析记录 / 照抄用 DNS 清单 / 可用性 / 到期提醒。
249
- * 全部只读。
250
- * ★ task-12(2026-10-28):补上 `domain bind` —— 走原生动作 `cliProvisionSiteDomain`
251
- * (CLI 自己的函数接、代执行 domain 内部开通编排,免 OAuth 428)。
252
- * `unbind` / `repair` **仍刻意没有**:`/cli` 动作面里没有等价动作
253
- * (解绑只有 `releaseSiteDomain`,OAuth 下 428 短信二次验证),不造命令。
254
- */
255
- domainBindCommand,
256
- domainStatusCommand,
257
- domainRecordsCommand,
258
- domainDnsCommand,
259
- domainCheckCommand,
260
- domainRemindCommand,
261
- previewCommand,
262
- importV2StartCommand,
263
- importV2StatusCommand,
264
- /**
265
- * ★ 2026-10-28 自持成交链:**真的**查价 / 下单 / 改云解析 / 开 ESA / 建站收口。
266
- * 与上面那 5 条只读命令的区别:这些会写账号里的真实资源(所以下单默认 dry-run、
267
- * 删解析强制 --yes),实现全在 `wkgeo-cli-fc` 自己的新模块里。
268
- */
269
- domainSearchCommand,
270
- domainBuyCommand,
271
- domainOrderCommand,
272
- domainZoneListCommand,
273
- domainZoneAddCommand,
274
- domainZoneUpdateCommand,
275
- domainZoneDeleteCommand,
276
- esaSiteCommand,
277
- esaRecordCommand,
278
- esaHostnameCommand,
279
- esaKvCommand,
280
- siteCreateCommand,
281
- /* 成品链路(task-21):域名成交全链路 6 条 */
282
- ...DOMAIN_ORDER_COMMANDS,
283
- /* 域名级 DNS 凭据(2026-10-28):客户自己的 DNS 托管商 AK,四词命令 */
284
- ...DNS_CREDENTIAL_COMMANDS,
285
- /**
286
- * 配置类 auth 面(task-75 / B7):语言 / 角色 / 站点成员 11 条。
287
- * 排在发布面之后 —— 同属"后台配置",但权限面独立(角色写要 `role:write`)。
288
- */
289
- ...CONFIG_AUTH_COMMANDS,
290
- /**
291
- * 站点类自持面(task-90 / B4):公司信息 / 域名巡检重检 / 示例内容 / 站级同步 6 条命令。
292
- * 与上面两块同属"后台运维",但对象是**站点本身**(服务端还要校验 site.owner_id)。
293
- */
294
- ...SITE_COMMANDS,
295
- /**
296
- * 插件类自持面(task-91 / B5):本站插件开关 / 配置 / 市场安装卸载升级 / 演示链接 9 条命令。
297
- * 对象也是**站点内**资源(服务端同样校验 `site.owner_id`),写类同样默认 dry-run。
298
- */
299
- ...PLUGIN_COMMANDS,
300
- /**
301
- * 控制台类自持面(task-92 / B7 剩余 8 条):操作日志 / 参数读取与保存 / 统计代码审核 /
302
- * 站点概览 / 账号级流量 / 控制台首页快照 / 会员支付能力。
303
- * 对象是**站点及其后台配置**(服务端同样校验 `site.owner_id`),
304
- * `overview traffic` 与 `overview dashboard` 的账号级两块另要求平台管理员。
305
- */
306
- ...LOG_COMMANDS,
307
- ...CONFIG_CONSOLE_COMMANDS,
308
- ...OVERVIEW_COMMANDS,
309
- /**
310
- * `import`:老站导入。**当前走本机运维脚本**(需要 service_role 权限),
311
- * 带鉴权的 HTTP 入口还在后端待办 —— 这是唯一一条"不在云函数里"的命令(见命令自己的说明)。
312
- */
313
- importCommand,
314
- walletCommand,
315
- walletTxnsCommand,
316
- walletRechargeCommand,
317
- /**
318
- * ★ 2026-10-02(方案 A):**独立充值页**链接 —— 用户在收银台上自己选金额并支付。
319
- * 与 `wallet recharge` 并列(那条是"金额定死在命令行里"的老路,行为一字未改)。
320
- */
321
- walletRechargeLinkCommand,
322
- productsListCommand,
323
- ordersCreateCommand,
324
- ordersCheckCommand,
325
- ordersPayCommand,
326
- ordersGetCommand,
327
- ordersListCommand,
328
- appsListCommand,
329
- appsRevokeCommand,
330
- /**
331
- * ★ 0.5.0:接本地大模型。
332
- * `ai ping/ask/chat` 走本机 OpenAI 兼容端点(Ollama / LM Studio),
333
- * `context export` 把站点上下文导成文件(任何模型/工具都能吃)。
334
- * 白名单与脱敏在 `lib/ai/context.mjs` + `lib/format.mjs#maskPii`,**不在命令里另写一套**。
335
- */
336
- aiPingCommand,
337
- aiAskCommand,
338
- aiChatCommand,
339
- contextExportCommand,
340
- /**
341
- * `skill`:把随包分发的 `SKILL.md` 原文打印出来(AI 端自取手册)。
342
- * 放在 config 前面 —— 两者同属「(基础)」,都是"不登录也能跑"的本地命令。
343
- */
344
- skillCommand,
345
- configCommand,
346
- /**
347
- * ★ task-56:`template init` —— 本机命令(不需要登录、不碰服务端)。
348
- * 与 CMS 面的 `templates list|get|save` 不是一回事:那几个是"站上的模板",
349
- * 这条是"把基础库从 npm 下到本地"。
350
- */
351
- templateInitCommand,
352
- ];
353
-
354
- export const COMMAND_NAMES = COMMANDS.map((c) => c.name);
355
-
356
- /**
357
- * 分组规则:两词命令(`sites create`)归到第一个词下;
358
- * 单词命令如果**同时是某个分组名**(`wallet` 有 `wallet txns` 子命令)也归到自己名下。
359
- * 否则归「(基础)」。这样帮助里的分组跟人的直觉一致。
360
- */
361
- function groupOf(command) {
362
- if (command.name.includes(' ')) return command.name.split(' ')[0];
363
- if (COMMANDS.some((c) => c.name.startsWith(`${command.name} `))) return command.name;
364
- return '(基础)';
365
- }
366
-
367
- /** 分组帮助的一句话说明(`wkgeo <组名> --help` 的首行) */
368
- const GROUP_SUMMARY = {
369
- auth: '授权与令牌:登录 / 看当前令牌是谁、能干什么 / 立刻作废',
370
- site: '站点:选站 / 建站 / 公司信息 / 域名巡检重检 / 示例内容 / 站级同步(写要 site:write,默认 dry-run)',
371
- domain: '域名:绑自有域名 / 看开通进度 / 取解析清单 / 查可用性(购买与解析读写见 domain search / zone / esa)',
372
- lang: '站点语言:列表 / 新增或修改 / 设默认 / 删除 / 启用停用(写要 site:write,默认 dry-run)',
373
- role: '站点角色:列表 / 新增或修改 / 删除(写要 role:write;不许造带「系统管理」权限的角色)',
374
- member: '站点成员:列表(手机号掩码)/ 改角色 / 移出本站(只能管站点内角色,不建账号)',
375
- plugins: '插件:本站插件开关 / 配置 / 市场安装卸载升级 / 演示链接(写要 site:write,默认 dry-run)',
376
- logs: '操作日志:谁在哪台设备上改了什么(只读,分页;走 `/cli` 自持通道)',
377
- config:
378
- '站点参数:读 / 存 / 审核统计代码 / 会员与支付能力(写要 site:write,默认 dry-run;`wkgeo config` 仍是本地诊断)',
379
- overview: '站点总览:栏目内容素材计数 / 账号级流量账单(仅平台管理员)/ 控制台首页快照(只读)',
380
- template: '模板基础库:`template init` 一条命令从 npm 下载整套基础库(校验 integrity、有本地缓存、可离线)',
381
- };
382
-
383
- /**
384
- * 会"按时间等"的通用参数必须把**单位**写进帮助里。
385
- *
386
- * 踩过的坑:`--timeout` 原来按毫秒解释,`--timeout 600` 变成 600 毫秒(0.8 秒就超时),
387
- * 而帮助里连单位都没写 —— 用户完全没法从 `--help` 看出自己写错了。
388
- * 这里直接引用 `GLOBAL_FLAGS` 的描述(**帮助与解析同源**,不会出现"文档写了但行为不一样")。
389
- */
390
- function renderTimedGlobalFlags() {
391
- return [
392
- ` --timeout <时长> ${GLOBAL_FLAGS.timeout.desc}`,
393
- ` --http-timeout <毫秒> ${GLOBAL_FLAGS['http-timeout'].desc}`,
394
- ];
395
- }
396
-
397
- /** 人类可读帮助。`wkgeo --help` / `wkgeo help` / `wkgeo sites create --help` 都走它 */
398
- export function renderHelp(name = null) {
399
- const line = (s = '') => s;
400
- const spec = name ? COMMANDS.find((c) => c.name === name) : null;
401
-
402
- if (spec) {
403
- const out = [];
404
- out.push(line(`wkgeo ${spec.name} —— ${spec.summary}`));
405
- out.push('');
406
- out.push(line('用法:'));
407
- for (const u of String(spec.usage).split('\n')) out.push(line(` ${u}`));
408
- if (spec.args && spec.args.length) {
409
- out.push('');
410
- out.push(line('位置参数:'));
411
- for (const a of spec.args) {
412
- /** variadic(如 `domain check <域名…>`):一个参数可以接多个值 */
413
- const label = a.variadic ? `<${a.name}…>` : `<${a.name}>`;
414
- out.push(line(` ${label}${a.required ? '(必填)' : ''} ${a.desc || ''}`));
415
- }
416
- }
417
- const own = Object.entries(spec.flags || {});
418
- if (own.length) {
419
- out.push('');
420
- out.push(line('命令参数:'));
421
- for (const [k, v] of own) out.push(line(` --${k}${v.type === 'boolean' ? '' : ' <值>'}${v.required ? '(必填)' : ''} ${v.desc || ''}`));
422
- }
423
- /**
424
- * 示例(2026-10-18 起每条新命令都带上)。
425
- *
426
- * 为什么帮助里必须有示例:AI 端拿到 `--help` 之后要能**直接照抄一条命令**跑起来;
427
- * 只有参数名和一句说明时,它还得自己推参数顺序和取值形态(容易把 `--site` 填成域名)。
428
- */
429
- if (spec.examples && spec.examples.length) {
430
- out.push('');
431
- out.push(line('示例:'));
432
- for (const e of spec.examples) out.push(line(` ${e}`));
433
- }
434
- /**
435
- * 命令自带的"特别说明"(可选)。目前只有 `skill` 用 ——
436
- * 它**不受**"非终端自动 JSON"约定约束,必须在自己的帮助里说清楚,
437
- * 否则用户按通用说明去管道里拿 JSON 会拿到 markdown(反之亦然)。
438
- */
439
- if (spec.notes && spec.notes.length) {
440
- out.push('');
441
- out.push(line('特别说明:'));
442
- for (const n of spec.notes) out.push(line(` ${n}`));
443
- }
444
- out.push('');
445
- out.push(line('通用参数:--json / --text / --base(平台面)/ --cms-base(CMS 面)/ --client-id / --credentials / --verbose / --help'));
446
- out.push(line('(默认:输出到管道/非终端时自动使用 --json)'));
447
- out.push('');
448
- out.push(line('带单位的通用参数(写清单位,避免"600 被当成 600 毫秒"这类误解):'));
449
- for (const l of renderTimedGlobalFlags()) out.push(line(l));
450
- return out.join('\n');
451
- }
452
-
453
- /**
454
- * 分组帮助(2026-10-28 task-12):`wkgeo auth --help` / `wkgeo domain --help` 给
455
- * **这一组的命令清单**,不再掉到全量总帮助里。
456
- *
457
- * 为什么要加:`auth` 是 task-12 新加的命令组(status / token / revoke),`domain` 组也刚多了
458
- * `bind`;用户/AI 打组名求助时,看到 150 多条的全量帮助根本找不到这几条。
459
- */
460
- if (name && !name.includes(' ')) {
461
- const inGroup = COMMANDS.filter((c) => groupOf(c) === name);
462
- if (inGroup.length) {
463
- const g = [`wkgeo ${name} —— ${GROUP_SUMMARY[name] || `${name} 相关命令`}`, ''];
464
- g.push('用法:wkgeo <命令> [参数]');
465
- g.push('');
466
- for (const c of inGroup) g.push(` ${c.name.padEnd(26)} ${c.summary}`);
467
- g.push('');
468
- g.push(`看单条用法:wkgeo <命令> --help(例:wkgeo ${inGroup[0].name} --help)`);
469
- g.push('通用参数:--json / --text / --base / --cms-base / --client-id / --credentials / --verbose / --help');
470
- g.push('(默认:输出到管道/非终端时自动使用 --json)');
471
- g.push('');
472
- g.push('退出码:0 成功 | 1 失败 | 2 用法错误 | 3 需要(重新)授权 | 4 被限流');
473
- return g.join('\n');
474
- }
475
- }
476
-
477
- const groups = new Map();
478
- for (const c of COMMANDS) {
479
- const g = groupOf(c);
480
- if (!groups.has(g)) groups.set(g, []);
481
- groups.get(g).push(c);
482
- }
483
-
484
- const out = [];
485
- out.push('云站平台官方 CLI —— 授权登录一次,之后建站 / 下单 / 钱包支付 / 查余额都不用再登录');
486
- out.push('');
487
- out.push('用法:wkgeo <命令> [参数]');
488
- out.push('');
489
- for (const [g, list] of groups) {
490
- out.push(`${g}:`);
491
- /**
492
- * 列宽给到 26:`categories bind-template`(24 字符)是现在最长的命令名,
493
- * 还按 16 排会让它把说明文字顶到下一列去(2026-10-18 加 CMS 命令时发现)。
494
- */
495
- for (const c of list) out.push(` ${c.name.padEnd(26)} ${c.summary}`);
496
- out.push('');
497
- }
498
- out.push('常用示例:');
499
- out.push(' wkgeo login # 浏览器授权一次,令牌存本地(30 天)');
500
- out.push(' wkgeo whoami # 看当前登录的是谁');
501
- out.push(' wkgeo sites create --name 我的站 # 建站(返回站点 id)');
502
- out.push(' wkgeo products list # 能买什么');
503
- out.push(' wkgeo orders create --product storage_mb --units 1 # 下单(余额够就当场付清)');
504
- out.push(' wkgeo wallet # 查余额 / wallet txns 看流水');
505
- out.push(' wkgeo wallet recharge --amount-cents 1000 # 充值下单(微信扫码,需人工支付)');
506
- out.push(' wkgeo wallet recharge-link # 生成独立充值页链接(用户在网页上自己选金额)');
507
- out.push(' wkgeo orders check <订单ID> # 查支付结果 + 最新余额');
508
- out.push(' wkgeo orders list # 我的订单');
509
- out.push(' wkgeo site use <站点ID或域名> # ★ 选站(栏目/内容/素材/模板命令的前置)');
510
- out.push(' wkgeo categories list # 栏目树(之后 contents / assets / templates 都类似)');
511
- out.push(' wkgeo contents create --category 新闻 --title 标题 --body "<p>…</p>" # 写一篇内容');
512
- out.push(' wkgeo assets upload ./banner.jpg # 传图(直传 OSS,返回素材 id)');
513
- out.push(' wkgeo assets sign logo.png --bytes 20480 # 只取直传票据(agent 自己 POST 文件用)');
514
- out.push(' wkgeo assets delete <素材ID> # 进回收站;--purge --confirm 才是彻底删除');
515
- out.push(' wkgeo templates list # 本站模板 html 清单');
516
- out.push(' wkgeo publish # 发布:默认 dry-run,--confirm 才真发');
517
- out.push(' wkgeo plugins list # 插件开关状态(editor 分类单选互斥)');
518
- out.push(' wkgeo forms entries # 表单提交(默认脱敏)');
519
- out.push(' wkgeo preview /about/ --open # 预览地址(草稿态,不开发布)');
520
- out.push(' wkgeo ai ping # 本地大模型通不通(Ollama / LM Studio)');
521
- out.push(' wkgeo ai ask "这站有哪些栏目?" # 本地模型 + CLI 现取的站点上下文');
522
- out.push(' wkgeo context export --out ctx.md # 把站点上下文导成文件喂任意模型');
523
- out.push(' wkgeo import --url=https://old-site.com # 老站导入(默认 dry-run,需运维权限)');
524
- /**
525
- * ⚠️ 这条示例是为了让 AI 端**能自己发现**手册入口:
526
- * 手册一直随包分发(package.json 的 files 里有 SKILL.md),但在加 `skill` 命令之前
527
- * 没有任何命令能把它取出来 —— AI 只能去 node_modules 里翻,等于"分发了但拿不到"。
528
- */
529
- out.push(' wkgeo skill # 打印给 AI 端的操作手册(随包分发)');
530
- out.push('');
531
- out.push('通用参数:--json(机器可读;非终端下默认开启)/ --text(强制人类可读)');
532
- out.push(' --base <url>(平台面)/ --cms-base <url>(CMS 面)/ --client-id <id> / --credentials <path>');
533
- out.push(' --verbose / --help / --version');
534
- out.push('CMS 命令专用:--site <站点ID>(一次性指定站点,覆盖 `wkgeo site use` 选中的)');
535
- out.push('');
536
- out.push('带单位的通用参数(写清单位,避免"600 被当成 600 毫秒"这类误解):');
537
- for (const l of renderTimedGlobalFlags()) out.push(l);
538
- out.push('');
539
- out.push('退出码:0 成功 | 1 失败 | 2 用法错误 | 3 需要(重新)授权 | 4 被限流');
540
- return out.join('\n');
541
- }
1
+ /**
2
+ * 命令注册表 + 帮助文本。
3
+ *
4
+ * 为什么注册表要同时带着 `usage`/`flags`/`args`:
5
+ * * 解析器用它做校验(未知参数直接报错,不静默忽略)
6
+ * * `--help` 用它生成文本 —— **帮助与实际行为同源**,不会出现"文档写了但命令不支持"
7
+ */
8
+
9
+ import { GLOBAL_FLAGS } from '../args.mjs';
10
+ import {
11
+ loginCommand,
12
+ logoutCommand,
13
+ whoamiCommand,
14
+ configCommand,
15
+ authStatusCommand,
16
+ authTokenCommand,
17
+ authRevokeCommand,
18
+ } from './auth.mjs';
19
+ import { sitesListCommand, sitesGetCommand, sitesCreateCommand, sitesDeleteCommand } from './sites.mjs';
20
+ import {
21
+ siteUseCommand,
22
+ categoriesListCommand,
23
+ categoriesGetCommand,
24
+ categoriesCreateCommand,
25
+ categoriesUpdateCommand,
26
+ categoriesSaveCommand,
27
+ categoriesDeleteCommand,
28
+ categoriesBindTemplateCommand,
29
+ contentsListCommand,
30
+ contentsGetCommand,
31
+ contentsCreateCommand,
32
+ contentsUpdateCommand,
33
+ contentsSaveCommand,
34
+ contentsDeleteCommand,
35
+ assetsListCommand,
36
+ assetsUploadCommand,
37
+ assetsSignCommand,
38
+ assetsRegisterCommand,
39
+ assetsDeleteCommand,
40
+ assetsRestoreCommand,
41
+ templatesListCommand,
42
+ templatesGetCommand,
43
+ templatesSaveCommand,
44
+ publishCommand,
45
+ publishStatusCommand,
46
+ publishCancelCommand,
47
+ /**
48
+ * ★ task-68 / B3:发布类 16 条动作迁入 `wkgeo-cli-fc` 自持(走 `/cli`,不再借 `/cms`)。
49
+ * 命令面:`publish retry` / `publish jobs[ get|cancel]` / `publish targets[ save|delete|test]` /
50
+ * `publish push` / `publish storage[ save|verify|delete|publish]`。
51
+ */
52
+ publishRetryCommand,
53
+ publishJobsCommand,
54
+ publishJobGetCommand,
55
+ publishJobCancelCommand,
56
+ publishTargetsCommand,
57
+ publishTargetsSaveCommand,
58
+ publishTargetsDeleteCommand,
59
+ publishTargetsTestCommand,
60
+ publishPushCommand,
61
+ publishStorageCommand,
62
+ publishStorageSaveCommand,
63
+ publishStorageVerifyCommand,
64
+ publishStorageDeleteCommand,
65
+ publishStoragePublishCommand,
66
+ } from './cms.mjs';
67
+ import {
68
+ formsListCommand,
69
+ formsEntriesCommand,
70
+ domainInspectionCommand,
71
+ domainBindCommand,
72
+ domainStatusCommand,
73
+ domainRecordsCommand,
74
+ domainDnsCommand,
75
+ domainCheckCommand,
76
+ domainRemindCommand,
77
+ previewCommand,
78
+ importV2StartCommand,
79
+ importV2StatusCommand,
80
+ } from './siteops.mjs';
81
+ import { aiPingCommand, aiAskCommand, aiChatCommand, contextExportCommand } from './ai.mjs';
82
+ import { importCommand } from './import.mjs';
83
+ import { crawlCommand } from './crawl.mjs';
84
+ import { walletCommand, walletTxnsCommand, walletRechargeCommand, walletRechargeLinkCommand } from './billing.mjs';
85
+ import { MEMBER_COMMANDS } from './member.mjs';
86
+ import {
87
+ productsListCommand,
88
+ ordersCreateCommand,
89
+ ordersCheckCommand,
90
+ ordersPayCommand,
91
+ ordersGetCommand,
92
+ ordersListCommand,
93
+ } from './orders.mjs';
94
+ import { appsListCommand, appsRevokeCommand } from './apps.mjs';
95
+ import { skillCommand } from './skill.mjs';
96
+ /**
97
+ * 自持成交链(2026-10-28 老板单):域名查价 / 下单 / 订单状态 / 云解析读写 / ESA 开通 / 建站收口。
98
+ * 全部打 `/cli`(自持 `wkgeo-cli-fc`),**不**复用 wkgeo-domain / cms 那套。
99
+ */
100
+ import {
101
+ domainSearchCommand,
102
+ domainBuyCommand,
103
+ domainOrderCommand,
104
+ domainZoneListCommand,
105
+ domainZoneAddCommand,
106
+ domainZoneUpdateCommand,
107
+ domainZoneDeleteCommand,
108
+ esaSiteCommand,
109
+ esaRecordCommand,
110
+ esaHostnameCommand,
111
+ esaKvCommand,
112
+ siteCreateCommand,
113
+ } from './domainops.mjs';
114
+ /**
115
+ * 成品链路(task-21):在平台模板下注册 → 客户模板 → 收费 → 模板认证 → 快速过户。
116
+ * 与上面 12 条同住 `wkgeo-cli-fc`,同样走 `/cli`;命令名带三词(`domain order create`),
117
+ * 依赖 `lib/args.mjs#resolveCommand` 的最长前缀匹配。
118
+ */
119
+ import { DOMAIN_ORDER_COMMANDS } from './domainorder.mjs';
120
+ /**
121
+ * 域名级 DNS 凭据(2026-10-28 老板单):`domain dns credential detect|set|status|delete`。
122
+ * 四词命令(`domain dns` 已被 siteops 的"照抄表"只读命令占用),依赖 `resolveCommand` 的最长前缀匹配。
123
+ * 秘密只从 stdin / 无回显交互读,**不进命令行**。
124
+ */
125
+ import { DNS_CREDENTIAL_COMMANDS } from './dnscred.mjs';
126
+ /**
127
+ * ★ task-75 / B7:配置类 auth 面 11 条迁入 `wkgeo-cli-fc` 自持(走 `/cli`,不再借 `/cms`)。
128
+ * 命令面:`lang list|save|set-default|delete|toggle`、`role list|save|delete`、
129
+ * `member list|update|remove`(`memberAdd` / `userProfileUpdate` 复核结论是**不迁**)。
130
+ * 读 = `site:read`、改成员/语言 = `site:write`、改角色 = `role:write`(独立 scope)。
131
+ */
132
+ import { CONFIG_AUTH_COMMANDS } from './config-auth.mjs';
133
+
134
+ /**
135
+ * ★ task-90(2026-10-29):站点类自持面 —— B4 7 条(公司信息 / 域名巡检重检 /
136
+ * 示例内容 / 站级同步)搬进 `wkgeo-cli-fc`(`src/site-core.js`,逐字复制 CMS handler)。
137
+ * 命令面:`site info`、`site info save`、`site domain-recheck`、`site demo-seed`、
138
+ * `site demo-clear`、`site sync`;`domain inspection` 也从 `/cms` 改走 `/cli`。
139
+ * 读 = `site:read`、写 = `site:write`,写动作默认 dry-run。
140
+ * **不迁 2 条**:`cmsCreateSite`(已有原生 `site create`)、`cmsSiteDomainCheck`
141
+ * (已有原生 `siteDomainCheck`,`wkgeo domain check` 在用)。
142
+ */
143
+ import { SITE_COMMANDS } from './site.mjs';
144
+
145
+ /**
146
+ * ★ task-91(2026-10-29):插件类自持面 —— B5 9 条(插件列表 / 访问范围 / 启停 /
147
+ * 配置保存 / 市场列表 / 安装 / 卸载 / 升级 / 演示链接)搬进 `wkgeo-cli-fc`
148
+ * (`src/plugin-core.js`,逐字复制 CMS handler)。9 条**全部可迁**。
149
+ * 命令面:`plugins list|access|toggle|settings|market-list|install|uninstall|upgrade|demo`。
150
+ * 读 = `site:read`、写 = `site:write`(写类默认 dry-run,`--confirm` 才发)。
151
+ * `plugins list` / `plugins toggle` 两条命令名不变 —— 只是从 `/cms` 转发改走 `/cli` 自持。
152
+ */
153
+ import { PLUGIN_COMMANDS } from './plugins.mjs';
154
+
155
+ /**
156
+ * ★ task-92(2026-10-29):控制台类自持面 —— B7 **剩余 8 条**(操作日志 / 参数读取 /
157
+ * 参数保存 / 统计代码审核 / 站点概览 / 账号级流量账单 / 控制台首页快照 / 会员支付能力)
158
+ * 搬进 `wkgeo-cli-fc`(`src/console-core.js`,逐字复制 CMS handler)。8 条**全部可迁**。
159
+ * 命令面:`logs list`、`config get|save|review|capabilities`、
160
+ * `overview summary|traffic|dashboard`。
161
+ * 读 = `site:read`、写 = `site:write`(写类 `config save` / `config review` 默认 dry-run)。
162
+ * ⚠️ B7 的 **AI 7 条(aiLogList / aiLogDetail / aiLogStats / aiTaskCreate / aiTaskMessages /
163
+ * aiTaskModels / aiToolConfirm)本批不做** —— 后台 AI 功能还没做完,等做完再单开一单。
164
+ * ⚠️ `config` 这个单名命令早就被 `auth.mjs` 的本地诊断占着(`wkgeo config` 读凭据/代理),
165
+ * 所以这里只在它后面追加 `config get|save|…` 子命令,`wkgeo config` 本身行为一字未改。
166
+ */
167
+ import { LOG_COMMANDS } from './logs.mjs';
168
+ import { CONFIG_CONSOLE_COMMANDS } from './config.mjs';
169
+ import { OVERVIEW_COMMANDS } from './overview.mjs';
170
+
171
+ /**
172
+ * ★ 2026-10-30(task-56):模板工具链 —— init 从 npm 取基础库,其余是校验 / 截图 / 评分 / 打包 / 发布。
173
+ */
174
+ import {
175
+ templateAnimCommand,
176
+ templateAnimationCommand,
177
+ templateCaptureCommand,
178
+ templateInitCommand,
179
+ templatePackCommand,
180
+ templatePreviewCommand,
181
+ templatePublishCommand,
182
+ templateScoreCommand,
183
+ templateShootCommand,
184
+ templateValidateCommand,
185
+ templateVerifyCommand,
186
+ /**
187
+ * ★ 2026-11-01(老板单):模板编辑改本地 CLI —— 拉整包到本地改、再推回。
188
+ * CMS 的在线代码编辑器入口下线(服务端 `templateFileSave` 保留,push 用它);
189
+ * 文件逻辑在 `lib/templates-sync.mjs`,命令在 `./template.mjs`。
190
+ */
191
+ templatesPullCommand,
192
+ templatesPushCommand,
193
+ } from './template.mjs';
194
+
195
+ /**
196
+ * ★ 2026-10-30(task-73 / task-178):\`content\` 组 = 写内容 / 查一致性的三个原语。
197
+ * content apply:**建站清单**(site-manifest.json)一次落站(默认 dry-run / 逐栏目 upsert / 幂等 / 未知字段拒绝);
198
+ * content fill :**模板内容契约**(sections[]/pages[])一次填库(同上默认 dry-run);
199
+ * content check:把「模板契约 ↔ 库结构/值 ↔ 前台渲染字段」摆在一起自检 + 9 维评分。
200
+ * 与 contents *(单人单条 CMS CRUD)分工不同,别混。
201
+ */
202
+ import { contentCheckCommand, contentFillCommand } from './content.mjs';
203
+ /* `content apply` 本体在 `cli/lib/manifest-apply.mjs`(只管建站内容契约;模板契约那条已拆成 `content fill`) */
204
+ import { contentApplyCommand } from '../manifest-apply.mjs';
205
+ /**
206
+ * ★ 2026-10-30(task-4):\`seo\` 组 = **本地站点产物**的 SEO 工具,四条纯本地命令(不联网、不写库)。
207
+ * audit 13 项加权评分 + issues[](报告命令,恒 exit 0);
208
+ * llms 生成 llms.txt / llms-full.txt(默认 dry-run);
209
+ * schema 生成 organization / website / article / faq / breadcrumb 的 JSON-LD(默认 dry-run);
210
+ * files 校验 sitemap.xml / robots.txt(门禁命令,有 error 就 exit 1)。
211
+ * 与插件 `seo`(按站点 ID 读库)是两个面:这里吃目录里的静态产物,上线前就能跑。
212
+ */
213
+ import { seoCommands } from './seo.mjs';
214
+ /**
215
+ * ★ 2026-10-30(task-5):`geo` 组 = **本地站点产物**的 GEO(生成式引擎优化)工具,五条命令。
216
+ * audit 20 项加权评分 + issues[](报告命令,恒 exit 0);
217
+ * llms 生成 llms.txt / llms-full.txt(分类小节 + 一句话摘要;`--check` 是门禁,exit 1);
218
+ * robots AI 爬虫策略段(allow-ai / block-ai 幂等 + 保留人工规则,默认 dry-run);
219
+ * brands 品牌跟踪入口(后台未就绪:未配置 `WKGEO_GEO_API` 就返回 not_configured,不发请求);
220
+ * report 汇总 audit + brands 的 markdown / json 报告。
221
+ * 与 `seo` 组分工:那边管搜索引擎收录友好,这边管"生成式引擎能不能读懂 / 摘取 / 引用"。
222
+ */
223
+ import { geoCommands } from './geo.mjs';
224
+
225
+ export const COMMANDS = [
226
+ /* ★ task-56 / task-73:模板工具链 + 写内容原语 + 一致性自检 */
227
+ templateInitCommand,
228
+ templateCaptureCommand,
229
+ templateVerifyCommand,
230
+ templateAnimCommand,
231
+ templateAnimationCommand,
232
+ templateValidateCommand,
233
+ templateScoreCommand,
234
+ templatePackCommand,
235
+ templatePublishCommand,
236
+ templatePreviewCommand,
237
+ templateShootCommand,
238
+ contentApplyCommand,
239
+ contentFillCommand,
240
+ contentCheckCommand,
241
+ /* ★ task-4:本地站点产物的 SEO 工具(audit / llms / schema / files),不联网、不写库 */
242
+ ...seoCommands,
243
+ /* ★ task-5:本地站点产物的 GEO 工具(audit / llms / robots / brands / report),不联网、不写库 */
244
+ ...geoCommands,
245
+ loginCommand,
246
+ whoamiCommand,
247
+ logoutCommand,
248
+ /**
249
+ * ★ 2026-10-28(task-12):`auth` 命令组 —— 把"令牌 / 动作面"讲清楚的只读口。
250
+ * 令牌模型不变(就是 `wkgeo login` 拿的 OAuth access_token,30 天),
251
+ * 这里**不做**令牌换领:`auth status` 调 `cliWhoami`,`auth token` 只给前 4 位,
252
+ * `auth revoke` = 服务端 RFC 7009 吊销 + 删本地凭据。
253
+ */
254
+ authStatusCommand,
255
+ authTokenCommand,
256
+ authRevokeCommand,
257
+ sitesCreateCommand,
258
+ sitesListCommand,
259
+ sitesGetCommand,
260
+ sitesDeleteCommand,
261
+ /**
262
+ * ★ 2026-10-18(CMS 面):先选站,再操作内容。
263
+ * `site use` 排在最前面 —— 它是后面所有 CMS 命令的前置(后端只认站点成员,
264
+ * 而 CLI 没有 Cookie 会话,站点上下文只能来自 `--site` 或本地这条记录)。
265
+ */
266
+ siteUseCommand,
267
+ categoriesListCommand,
268
+ categoriesGetCommand,
269
+ categoriesCreateCommand,
270
+ categoriesUpdateCommand,
271
+ categoriesSaveCommand,
272
+ categoriesDeleteCommand,
273
+ categoriesBindTemplateCommand,
274
+ contentsListCommand,
275
+ contentsGetCommand,
276
+ contentsCreateCommand,
277
+ contentsUpdateCommand,
278
+ contentsSaveCommand,
279
+ contentsDeleteCommand,
280
+ assetsListCommand,
281
+ assetsUploadCommand,
282
+ assetsSignCommand,
283
+ assetsRegisterCommand,
284
+ assetsDeleteCommand,
285
+ assetsRestoreCommand,
286
+ templatesListCommand,
287
+ templatesGetCommand,
288
+ templatesSaveCommand,
289
+ templatesPullCommand,
290
+ templatesPushCommand,
291
+ publishCommand,
292
+ publishStatusCommand,
293
+ publishCancelCommand,
294
+ /* 发布面其余动作(task-68 / B3):重发 / 推送任务 / 推送目标 / 推送 / 客户桶 */
295
+ publishRetryCommand,
296
+ publishJobsCommand,
297
+ publishJobGetCommand,
298
+ publishJobCancelCommand,
299
+ publishTargetsCommand,
300
+ publishTargetsSaveCommand,
301
+ publishTargetsDeleteCommand,
302
+ publishTargetsTestCommand,
303
+ publishPushCommand,
304
+ publishStorageCommand,
305
+ publishStorageSaveCommand,
306
+ publishStorageVerifyCommand,
307
+ publishStorageDeleteCommand,
308
+ publishStoragePublishCommand,
309
+ /**
310
+ * ★ 0.5.0 新增:站点运营面(表单 / 域名巡检 / 预览 / 导入 v2)。
311
+ * 共同约定:写操作默认 dry-run(`--confirm` 才真发);人产出的数据默认脱敏。
312
+ * ★ task-91 / B5:原来这儿的 `plugins list` / `plugins toggle` 改由 `PLUGIN_COMMANDS`
313
+ * 提供(走 `/cli` 自持通道,不再 `/cms` 转发),并补齐插件面另外 7 条命令。
314
+ */
315
+ formsListCommand,
316
+ formsEntriesCommand,
317
+ domainInspectionCommand,
318
+ /**
319
+ * ★ task-9(0.5.2 未发布):域名只读命令 —— 状态 / 解析记录 / 照抄用 DNS 清单 / 可用性 / 到期提醒。
320
+ * 全部只读。
321
+ * ★ task-12(2026-10-28):补上 `domain bind` —— 走原生动作 `cliProvisionSiteDomain`
322
+ * (CLI 自己的函数接、代执行 domain 内部开通编排,免 OAuth 428)。
323
+ * `unbind` / `repair` **仍刻意没有**:`/cli` 动作面里没有等价动作
324
+ * (解绑只有 `releaseSiteDomain`,OAuth 下 428 短信二次验证),不造命令。
325
+ */
326
+ domainBindCommand,
327
+ domainStatusCommand,
328
+ domainRecordsCommand,
329
+ domainDnsCommand,
330
+ domainCheckCommand,
331
+ domainRemindCommand,
332
+ previewCommand,
333
+ importV2StartCommand,
334
+ importV2StatusCommand,
335
+ /**
336
+ * ★ 2026-10-28 自持成交链:**真的**查价 / 下单 / 改云解析 / 开 ESA / 建站收口。
337
+ * 与上面那 5 条只读命令的区别:这些会写账号里的真实资源(所以下单默认 dry-run、
338
+ * 删解析强制 --yes),实现全在 `wkgeo-cli-fc` 自己的新模块里。
339
+ */
340
+ domainSearchCommand,
341
+ domainBuyCommand,
342
+ domainOrderCommand,
343
+ domainZoneListCommand,
344
+ domainZoneAddCommand,
345
+ domainZoneUpdateCommand,
346
+ domainZoneDeleteCommand,
347
+ esaSiteCommand,
348
+ esaRecordCommand,
349
+ esaHostnameCommand,
350
+ esaKvCommand,
351
+ siteCreateCommand,
352
+ /* 成品链路(task-21):域名成交全链路 6 条 */
353
+ ...DOMAIN_ORDER_COMMANDS,
354
+ /* 域名级 DNS 凭据(2026-10-28):客户自己的 DNS 托管商 AK,四词命令 */
355
+ ...DNS_CREDENTIAL_COMMANDS,
356
+ /**
357
+ * 配置类 auth 面(task-75 / B7):语言 / 角色 / 站点成员 11 条。
358
+ * 排在发布面之后 —— 同属"后台配置",但权限面独立(角色写要 `role:write`)。
359
+ */
360
+ ...CONFIG_AUTH_COMMANDS,
361
+ /**
362
+ * 站点类自持面(task-90 / B4):公司信息 / 域名巡检重检 / 示例内容 / 站级同步 6 条命令。
363
+ * 与上面两块同属"后台运维",但对象是**站点本身**(服务端还要校验 site.owner_id)。
364
+ */
365
+ ...SITE_COMMANDS,
366
+ /**
367
+ * 插件类自持面(task-91 / B5):本站插件开关 / 配置 / 市场安装卸载升级 / 演示链接 9 条命令。
368
+ * 对象也是**站点内**资源(服务端同样校验 `site.owner_id`),写类同样默认 dry-run。
369
+ */
370
+ ...PLUGIN_COMMANDS,
371
+ /**
372
+ * 控制台类自持面(task-92 / B7 剩余 8 条):操作日志 / 参数读取与保存 / 统计代码审核 /
373
+ * 站点概览 / 账号级流量 / 控制台首页快照 / 会员支付能力。
374
+ * 对象是**站点及其后台配置**(服务端同样校验 `site.owner_id`),
375
+ * `overview traffic` 与 `overview dashboard` 的账号级两块另要求平台管理员。
376
+ */
377
+ ...LOG_COMMANDS,
378
+ ...CONFIG_CONSOLE_COMMANDS,
379
+ ...OVERVIEW_COMMANDS,
380
+ /**
381
+ * `import`:老站导入。**当前走本机运维脚本**(需要 service_role 权限),
382
+ * 带鉴权的 HTTP 入口还在后端待办 —— 这是唯一一条"不在云函数里"的命令(见命令自己的说明)。
383
+ */
384
+ importCommand,
385
+ /**
386
+ * crawl(task-84):并发抓整站。**不登录、不写库、零模型调用** ——
387
+ * 只把「标题 / 正文 / 图片 / 结构信号」抓回来,整页 HTML 在抓取器里就丢掉。
388
+ * 与 import 的分工:crawl 是抓,import / import-v2 才是写进 CMS(那条链才有三档容错与 AI 托底)。
389
+ */
390
+ crawlCommand,
391
+ walletCommand,
392
+ walletTxnsCommand,
393
+ walletRechargeCommand,
394
+ /**
395
+ * ★ 2026-10-02(方案 A):**独立充值页**链接 —— 用户在收银台上自己选金额并支付。
396
+ * 与 `wallet recharge` 并列(那条是"金额定死在命令行里"的老路,行为一字未改)。
397
+ */
398
+ walletRechargeLinkCommand,
399
+ /**
400
+ * ★ task-197(2026-11-02)会员自助面:把「线上会员中心早有、CLI 还没有」的 8 组动作补上。
401
+ * 后端动作全在 `wkgeo-user`,`wkgeo-cli-fc` 已自持重建并挂在 `/cli`(`SELF_HOSTED_ACTIONS`),
402
+ * 所以这里**只写命令层**:`wallet billing` / `wallet debt` / `coupons` / `notify list|read` /
403
+ * `sites recycle [restore]` / `invoices list` / `plans list` / `sites update`。
404
+ * 三条写命令(notify read / sites recycle restore / sites update)一律**默认 dry-run**、
405
+ * `--confirm` 才真发。`purgeSite`(彻底删站)、开票、券核销**刻意没有**。
406
+ */
407
+ ...MEMBER_COMMANDS,
408
+ productsListCommand,
409
+ ordersCreateCommand,
410
+ ordersCheckCommand,
411
+ ordersPayCommand,
412
+ ordersGetCommand,
413
+ ordersListCommand,
414
+ appsListCommand,
415
+ appsRevokeCommand,
416
+ /**
417
+ * ★ 0.5.0:接本地大模型。
418
+ * `ai ping/ask/chat` 走本机 OpenAI 兼容端点(Ollama / LM Studio),
419
+ * `context export` 把站点上下文导成文件(任何模型/工具都能吃)。
420
+ * 白名单与脱敏在 `lib/ai/context.mjs` + `lib/format.mjs#maskPii`,**不在命令里另写一套**。
421
+ */
422
+ aiPingCommand,
423
+ aiAskCommand,
424
+ aiChatCommand,
425
+ contextExportCommand,
426
+ /**
427
+ * `skill`:把随包分发的 `SKILL.md` 原文打印出来(AI 端自取手册)。
428
+ * 放在 config 前面 —— 两者同属「(基础)」,都是"不登录也能跑"的本地命令。
429
+ */
430
+ skillCommand,
431
+ configCommand,
432
+ ];
433
+
434
+ export const COMMAND_NAMES = COMMANDS.map((c) => c.name);
435
+
436
+ /**
437
+ * 分组规则:两词命令(`sites create`)归到第一个词下;
438
+ * 单词命令如果**同时是某个分组名**(`wallet` 有 `wallet txns` 子命令)也归到自己名下。
439
+ * 否则归「(基础)」。这样帮助里的分组跟人的直觉一致。
440
+ */
441
+ function groupOf(command) {
442
+ if (command.name.includes(' ')) return command.name.split(' ')[0];
443
+ if (COMMANDS.some((c) => c.name.startsWith(`${command.name} `))) return command.name;
444
+ return '(基础)';
445
+ }
446
+
447
+ /** 分组帮助的一句话说明(`wkgeo <组名> --help` 的首行) */
448
+ const GROUP_SUMMARY = {
449
+ auth: '授权与令牌:登录 / 看当前令牌是谁、能干什么 / 立刻作废',
450
+ wallet: '钱包与账单:余额 / 流水 / 账单(订阅+配额+加量包)/ 欠费 / 充值(充值默认 dry-run 语义见子命令)',
451
+ coupons: '优惠券:我的券(可按状态筛)/ `--usable` 看某笔订单能用的券与抵扣预览(只读,不含核销)',
452
+ notify: '我的消息:列表(未读数置顶)/ 标已读(写,默认 dry-run,`--confirm` 才真发)',
453
+ invoices: '我的开票:可开票订单 + 我的开票申请(只读;开票动作留在会员端)',
454
+ plans: '套餐目录:订阅套餐 / 站点续费价 / 加量包套餐 / 我已买的加量包(只读,四块小表)',
455
+ site: '站点:选站 / 建站 / 公司信息 / 域名巡检重检 / 示例内容 / 站级同步(写要 site:write,默认 dry-run)',
456
+ domain: '域名:绑自有域名 / 看开通进度 / 取解析清单 / 查可用性(购买与解析读写见 domain search / zone / esa)',
457
+ lang: '站点语言:列表 / 新增或修改 / 设默认 / 删除 / 启用停用(写要 site:write,默认 dry-run)',
458
+ role: '站点角色:列表 / 新增或修改 / 删除(写要 role:write;不许造带「系统管理」权限的角色)',
459
+ member: '站点成员:列表(手机号掩码)/ 改角色 / 移出本站(只能管站点内角色,不建账号)',
460
+ plugins: '插件:本站插件开关 / 配置 / 市场安装卸载升级 / 演示链接(写要 site:write,默认 dry-run)',
461
+ logs: '操作日志:谁在哪台设备上改了什么(只读,分页;走 `/cli` 自持通道)',
462
+ config:
463
+ '站点参数:读 / 存 / 审核统计代码 / 会员与支付能力(写要 site:write,默认 dry-run;`wkgeo config` 仍是本地诊断)',
464
+ overview: '站点总览:栏目内容素材计数 / 账号级流量账单(仅平台管理员)/ 控制台首页快照(只读)',
465
+ content:
466
+ '内容原语:apply = 建站清单(site-manifest.json)落站 · fill = 模板内容契约(sections[]/pages[])填库 · check 契约↔库↔前台自检 + 9 维评分(两条写命令默认 dry-run、逐栏目 upsert、幂等、未知字段拒绝)',
467
+ template:
468
+ '模板工具链:init 取基础库 / validate 契约九关 / capture 载图 / verify 像素自比 / score 评分 / anim 动画 / pack 打包 / publish 发布 / preview 预览',
469
+ templates:
470
+ '模板文件:list 看文件清单 / get 读一份 / save 写一份 / **pull 拉整包到本地改 · push 推回**(push 默认只算计划,--confirm 才写,推完要 publish 才生效)',
471
+ seo:
472
+ '本地站点产物 SEO:audit 13 项加权评分 + issues[] / llms 生成 llms.txt 与 llms-full.txt / schema 生成 JSON-LD / files 校验 sitemap.xml 与 robots.txt(不联网;写盘默认 dry-run,--confirm 才落盘)',
473
+ geo:
474
+ '本地站点产物 GEO(生成式引擎优化):audit 20 项加权评分 + issues[] / llms 生成并校验 llms.txt 与 llms-full.txt / robots 生成 AI 爬虫策略段(幂等、保留人工规则)/ brands 品牌收录跟踪(未配置基址返回 not_configured,不发请求)/ report 汇总 markdown 报告(写盘默认 dry-run,--confirm 才落盘)',
475
+ };
476
+
477
+ /**
478
+ * 会"按时间等"的通用参数必须把**单位**写进帮助里。
479
+ *
480
+ * 踩过的坑:`--timeout` 原来按毫秒解释,`--timeout 600` 变成 600 毫秒(0.8 秒就超时),
481
+ * 而帮助里连单位都没写 —— 用户完全没法从 `--help` 看出自己写错了。
482
+ * 这里直接引用 `GLOBAL_FLAGS` 的描述(**帮助与解析同源**,不会出现"文档写了但行为不一样")。
483
+ */
484
+ function renderTimedGlobalFlags() {
485
+ return [
486
+ ` --timeout <时长> ${GLOBAL_FLAGS.timeout.desc}`,
487
+ ` --http-timeout <毫秒> ${GLOBAL_FLAGS['http-timeout'].desc}`,
488
+ ];
489
+ }
490
+
491
+ /** 人类可读帮助。`wkgeo --help` / `wkgeo help` / `wkgeo sites create --help` 都走它 */
492
+ export function renderHelp(name = null) {
493
+ const line = (s = '') => s;
494
+ const spec = name ? COMMANDS.find((c) => c.name === name) : null;
495
+
496
+ if (spec) {
497
+ const out = [];
498
+ out.push(line(`wkgeo ${spec.name} —— ${spec.summary}`));
499
+ out.push('');
500
+ out.push(line('用法:'));
501
+ for (const u of String(spec.usage).split('\n')) out.push(line(` ${u}`));
502
+ if (spec.args && spec.args.length) {
503
+ out.push('');
504
+ out.push(line('位置参数:'));
505
+ for (const a of spec.args) {
506
+ /** variadic(如 `domain check <域名…>`):一个参数可以接多个值 */
507
+ const label = a.variadic ? `<${a.name}…>` : `<${a.name}>`;
508
+ out.push(line(` ${label}${a.required ? '(必填)' : ''} ${a.desc || ''}`));
509
+ }
510
+ }
511
+ /**
512
+ * `hidden: true` 的标志(如 `content apply --manifest`)**不进参数表**:
513
+ * 它们只为"旧参数名指到新命令"的拦截存在,列出来会让人以为还能用。
514
+ * 解析层仍认这些 key(`coerceFlags` 读的是 `spec.flags`),只是 `--help` 不显示。
515
+ */
516
+ const own = Object.entries(spec.flags || {}).filter(([, v]) => !v.hidden);
517
+ if (own.length) {
518
+ out.push('');
519
+ out.push(line('命令参数:'));
520
+ for (const [k, v] of own) out.push(line(` --${k}${v.type === 'boolean' ? '' : ' <值>'}${v.required ? '(必填)' : ''} ${v.desc || ''}`));
521
+ }
522
+ /**
523
+ * 示例(2026-10-18 起每条新命令都带上)。
524
+ *
525
+ * 为什么帮助里必须有示例:AI 端拿到 `--help` 之后要能**直接照抄一条命令**跑起来;
526
+ * 只有参数名和一句说明时,它还得自己推参数顺序和取值形态(容易把 `--site` 填成域名)。
527
+ */
528
+ if (spec.examples && spec.examples.length) {
529
+ out.push('');
530
+ out.push(line('示例:'));
531
+ for (const e of spec.examples) out.push(line(` ${e}`));
532
+ }
533
+ /**
534
+ * 命令自带的"特别说明"(可选)。目前只有 `skill` 用 ——
535
+ * 它**不受**"非终端自动 JSON"约定约束,必须在自己的帮助里说清楚,
536
+ * 否则用户按通用说明去管道里拿 JSON 会拿到 markdown(反之亦然)。
537
+ */
538
+ if (spec.notes && spec.notes.length) {
539
+ out.push('');
540
+ out.push(line('特别说明:'));
541
+ for (const n of spec.notes) out.push(line(` ${n}`));
542
+ }
543
+ out.push('');
544
+ out.push(line('通用参数:--json / --text / --base(平台面)/ --cms-base(CMS 面)/ --client-id / --credentials / --verbose / --help'));
545
+ out.push(line('(默认:输出到管道/非终端时自动使用 --json)'));
546
+ out.push('');
547
+ out.push(line('带单位的通用参数(写清单位,避免"600 被当成 600 毫秒"这类误解):'));
548
+ for (const l of renderTimedGlobalFlags()) out.push(line(l));
549
+ return out.join('\n');
550
+ }
551
+
552
+ /**
553
+ * 分组帮助(2026-10-28 task-12):`wkgeo auth --help` / `wkgeo domain --help` 给
554
+ * **这一组的命令清单**,不再掉到全量总帮助里。
555
+ *
556
+ * 为什么要加:`auth` 是 task-12 新加的命令组(status / token / revoke),`domain` 组也刚多了
557
+ * `bind`;用户/AI 打组名求助时,看到 150 多条的全量帮助根本找不到这几条。
558
+ */
559
+ if (name && !name.includes(' ')) {
560
+ const inGroup = COMMANDS.filter((c) => groupOf(c) === name);
561
+ if (inGroup.length) {
562
+ const g = [`wkgeo ${name} —— ${GROUP_SUMMARY[name] || `${name} 相关命令`}`, ''];
563
+ g.push('用法:wkgeo <命令> [参数]');
564
+ g.push('');
565
+ for (const c of inGroup) g.push(` ${c.name.padEnd(26)} ${c.summary}`);
566
+ g.push('');
567
+ g.push(`看单条用法:wkgeo <命令> --help(例:wkgeo ${inGroup[0].name} --help)`);
568
+ g.push('通用参数:--json / --text / --base / --cms-base / --client-id / --credentials / --verbose / --help');
569
+ g.push('(默认:输出到管道/非终端时自动使用 --json)');
570
+ g.push('');
571
+ g.push('退出码:0 成功 | 1 失败 | 2 用法错误 | 3 需要(重新)授权 | 4 被限流');
572
+ return g.join('\n');
573
+ }
574
+ }
575
+
576
+ const groups = new Map();
577
+ for (const c of COMMANDS) {
578
+ const g = groupOf(c);
579
+ if (!groups.has(g)) groups.set(g, []);
580
+ groups.get(g).push(c);
581
+ }
582
+
583
+ const out = [];
584
+ out.push('云站平台官方 CLI —— 授权登录一次,之后建站 / 下单 / 钱包支付 / 查余额都不用再登录');
585
+ out.push('');
586
+ out.push('用法:wkgeo <命令> [参数]');
587
+ out.push('');
588
+ for (const [g, list] of groups) {
589
+ out.push(`${g}:`);
590
+ /**
591
+ * 列宽给到 26:`categories bind-template`(24 字符)是现在最长的命令名,
592
+ * 还按 16 排会让它把说明文字顶到下一列去(2026-10-18 加 CMS 命令时发现)。
593
+ */
594
+ for (const c of list) out.push(` ${c.name.padEnd(26)} ${c.summary}`);
595
+ out.push('');
596
+ }
597
+ out.push('常用示例:');
598
+ out.push(' wkgeo login # 浏览器授权一次,令牌存本地(30 天)');
599
+ out.push(' wkgeo whoami # 看当前登录的是谁');
600
+ out.push(' wkgeo sites create --name 我的站 # 建站(返回站点 id)');
601
+ out.push(' wkgeo products list # 能买什么');
602
+ out.push(' wkgeo orders create --product storage_mb --units 1 # 下单(余额够就当场付清)');
603
+ out.push(' wkgeo wallet # 查余额 / wallet txns 看流水');
604
+ out.push(' wkgeo wallet recharge --amount-cents 1000 # 充值下单(微信扫码,需人工支付)');
605
+ out.push(' wkgeo wallet recharge-link # 生成独立充值页链接(用户在网页上自己选金额)');
606
+ out.push(' wkgeo orders check <订单ID> # 查支付结果 + 最新余额');
607
+ out.push(' wkgeo orders list # 我的订单');
608
+ out.push(' wkgeo site use <站点ID或域名> # ★ 选站(栏目/内容/素材/模板命令的前置)');
609
+ out.push(' wkgeo categories list # 栏目树(之后 contents / assets / templates 都类似)');
610
+ out.push(' wkgeo contents create --category 新闻 --title 标题 --body "<p>…</p>" # 写一篇内容');
611
+ out.push(' wkgeo assets upload ./banner.jpg # 传图(直传 OSS,返回素材 id)');
612
+ out.push(' wkgeo assets sign logo.png --bytes 20480 # 只取直传票据(agent 自己 POST 文件用)');
613
+ out.push(' wkgeo assets delete <素材ID> # 进回收站;--purge --confirm 才是彻底删除');
614
+ out.push(' wkgeo templates list # 本站模板 html 清单');
615
+ out.push(' wkgeo publish # 发布:默认 dry-run,--confirm 才真发');
616
+ out.push(' wkgeo plugins list # 插件开关状态(editor 分类单选互斥)');
617
+ out.push(' wkgeo forms entries # 表单提交(默认脱敏)');
618
+ out.push(' wkgeo preview /about/ --open # 预览地址(草稿态,不开发布)');
619
+ out.push(' wkgeo ai ping # 本地大模型通不通(Ollama / LM Studio)');
620
+ out.push(' wkgeo ai ask "这站有哪些栏目?" # 本地模型 + CLI 现取的站点上下文');
621
+ out.push(' wkgeo context export --out ctx.md # 把站点上下文导成文件喂任意模型');
622
+ out.push(' wkgeo import --url=https://old-site.com # 老站导入(默认 dry-run,需运维权限)');
623
+ /**
624
+ * ⚠️ 这条示例是为了让 AI 端**能自己发现**手册入口:
625
+ * 手册一直随包分发(package.json 的 files 里有 SKILL.md),但在加 `skill` 命令之前
626
+ * 没有任何命令能把它取出来 —— AI 只能去 node_modules 里翻,等于"分发了但拿不到"。
627
+ */
628
+ out.push(' wkgeo skill # 打印给 AI 端的操作手册(随包分发)');
629
+ out.push('');
630
+ out.push('通用参数:--json(机器可读;非终端下默认开启)/ --text(强制人类可读)');
631
+ out.push(' --base <url>(平台面)/ --cms-base <url>(CMS 面)/ --client-id <id> / --credentials <path>');
632
+ out.push(' --verbose / --help / --version');
633
+ out.push('CMS 命令专用:--site <站点ID>(一次性指定站点,覆盖 `wkgeo site use` 选中的)');
634
+ out.push('');
635
+ out.push('带单位的通用参数(写清单位,避免"600 被当成 600 毫秒"这类误解):');
636
+ for (const l of renderTimedGlobalFlags()) out.push(l);
637
+ out.push('');
638
+ out.push('退出码:0 成功 | 1 失败 | 2 用法错误 | 3 需要(重新)授权 | 4 被限流');
639
+ return out.join('\n');
640
+ }