@wkgeo/cli 0.0.0-stage → 1.0.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.
Files changed (51) hide show
  1. package/CHANGELOG.md +208 -0
  2. package/LICENSE +21 -0
  3. package/README.md +1042 -3
  4. package/SKILL.md +927 -0
  5. package/lib/ai/client.mjs +161 -0
  6. package/lib/ai/config.mjs +221 -0
  7. package/lib/ai/context.mjs +468 -0
  8. package/lib/ai/log.mjs +53 -0
  9. package/lib/api.mjs +339 -0
  10. package/lib/args.mjs +235 -0
  11. package/lib/cli.mjs +168 -0
  12. package/lib/cms.mjs +330 -0
  13. package/lib/commands/ai.mjs +392 -0
  14. package/lib/commands/apps.mjs +116 -0
  15. package/lib/commands/auth.mjs +1288 -0
  16. package/lib/commands/billing.mjs +666 -0
  17. package/lib/commands/cms.mjs +2533 -0
  18. package/lib/commands/config-auth.mjs +621 -0
  19. package/lib/commands/config.mjs +434 -0
  20. package/lib/commands/dnscred.mjs +428 -0
  21. package/lib/commands/domainops.mjs +546 -0
  22. package/lib/commands/domainorder.mjs +439 -0
  23. package/lib/commands/import.mjs +164 -0
  24. package/lib/commands/index.mjs +528 -0
  25. package/lib/commands/logs.mjs +141 -0
  26. package/lib/commands/orders.mjs +444 -0
  27. package/lib/commands/overview.mjs +394 -0
  28. package/lib/commands/plugins.mjs +678 -0
  29. package/lib/commands/site.mjs +435 -0
  30. package/lib/commands/siteops.mjs +1012 -0
  31. package/lib/commands/sites.mjs +905 -0
  32. package/lib/commands/skill.mjs +119 -0
  33. package/lib/config.mjs +351 -0
  34. package/lib/credentials.mjs +160 -0
  35. package/lib/device-store.mjs +132 -0
  36. package/lib/device.mjs +464 -0
  37. package/lib/errors.mjs +299 -0
  38. package/lib/format.mjs +339 -0
  39. package/lib/http.mjs +71 -0
  40. package/lib/index.mjs +44 -0
  41. package/lib/local-import.mjs +185 -0
  42. package/lib/login.mjs +1638 -0
  43. package/lib/oauth-urls.mjs +163 -0
  44. package/lib/page.mjs +393 -0
  45. package/lib/pkce.mjs +48 -0
  46. package/lib/proxy.mjs +454 -0
  47. package/lib/qr.mjs +31 -0
  48. package/lib/runtime.mjs +650 -0
  49. package/lib/site-state.mjs +137 -0
  50. package/package.json +53 -4
  51. package/wkgeo.mjs +17 -0
@@ -0,0 +1,2533 @@
1
+ /**
2
+ * CMS 命令(客户站后台的内容管理面):栏目 / 内容 / 素材 / 模板 / 发布 / 选站。
3
+ *
4
+ * ## 这一层的三条口径
5
+ * 1. **站点必须先定**:所有 CMS 动作都落在"一个站"上。来源优先级
6
+ * `--site <站点ID>` > `WKONGAI_SITE` > 本地 `wkgeo site use` 记住的那个。
7
+ * 一个都没有就**当场报用法错误**,并且只说一句能照做的话 —— 不猜、不默认。
8
+ * 2. **动作名照抄云函数动作表**(`aliyun/fc/wkgeo-cms/src/index.js` 的 `actionTable`),
9
+ * 参数名也照抄后台前端(`CMS/src/service/api/cms.ts`)——
10
+ * 两边一旦不一致,用户看到的是"参数传了但没生效"这种最难查的错。
11
+ * 3. **默认人类可读表格,`--json` 给原始数据**(信封由 `runtime.done()` 统一包)。
12
+ *
13
+ * ## 与后台网页的关系
14
+ * 命令**不是**另一套业务逻辑:它就是后台那几个按钮的同一批接口。
15
+ * 所以后台的约束在 CLI 上**一条都不会松**(系统栏目不能删、单页内容只能改不能建、
16
+ * 绑定模板必须是本站已有的 html …)—— 这些都由服务端拦,CLI 只是把原因如实转给用户。
17
+ *
18
+ * ## 别在这里做的事
19
+ * * ❌ 不往请求 body 里塞 `site_id`:后端**故意忽略**它,站点边界只认 `x-cms-site` 和会话;
20
+ * * ❌ 不自己拼 CMS 地址:走 `runtime.cmsCall()`(它管 Bearer 令牌、站点头、错误翻译);
21
+ * * ❌ 不在 CLI 里"补一条内容"绕过单页限制:那是故意绕过后端校验。
22
+ */
23
+
24
+ import fs from 'node:fs';
25
+ import path from 'node:path';
26
+
27
+ import { camel } from '../args.mjs';
28
+ import { uploadToOss } from '../cms.mjs';
29
+ import { CliError, UsageError } from '../errors.mjs';
30
+ import { formatTime } from '../format.mjs';
31
+ import { clearSiteState, readSiteState, writeSiteState } from '../site-state.mjs';
32
+
33
+ /* ------------------------------------------------------------------ 公共小工具 */
34
+
35
+ /** 站点/资源 id 的形状(后端到处用 uuid 做参数类型,先本地挡一道比让 PG 报 22P02 友好) */
36
+ const UUID_RE = /^[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}$/;
37
+
38
+ export function looksLikeUuid(v) {
39
+ return UUID_RE.test(String(v || '').trim());
40
+ }
41
+
42
+ /** 所有 CMS 命令共用的 `--site`(默认取 `wkgeo site use` 选中的站点) */
43
+ const SITE_FLAG = {
44
+ site: {
45
+ type: 'string',
46
+ desc: '站点 ID(uuid;默认用 `wkgeo site use` 选中的站点,可用 WKONGAI_SITE 覆盖)',
47
+ },
48
+ };
49
+
50
+ const CATEGORY_KIND_LABEL = { channel: '频道页', list: '列表页', page: '单页' };
51
+ /** `publish storage save --pool` 认的平台共享桶池键(= `public.platform_storage.key`) */
52
+ const PLATFORM_POOL_KEYS = ['aliyun', 'tencent', 'baidu'];
53
+ const CONTENT_STATUS_LABEL = { draft: '草稿', published: '已发布', hidden: '隐藏' };
54
+
55
+ /** 站点那一行的提示文本(人类输出用) */
56
+ function siteText(site) {
57
+ if (!site) return '';
58
+ /** 没显式选站:服务端按令牌的成员关系判定(见 runtime.cmsSite 的第 4 档) */
59
+ if (!site.id) return '由服务端按你的成员关系自动判定';
60
+ return site.label ? `${site.label}(${site.id})` : site.id;
61
+ }
62
+
63
+ /** 信封里的 `site_id`:没显式选站时是 `null`(真实站点由服务端定,返回行里自带 site_id) */
64
+ function siteIdOf(site) {
65
+ return site && site.id ? site.id : null;
66
+ }
67
+
68
+ /**
69
+ * 把"以后操作哪个站"写进本地 config —— **`site use` 与 `sites list` 的选站共用这一处**。
70
+ *
71
+ * 为什么抽出来:选站落盘必须只有一条路径(`<凭据目录>/config.json`)。
72
+ * 两处各写一遍的话,将来改文件格式 / 加字段时一定会漏掉一处,
73
+ * 表现成"`site use` 选了 A、`sites list` 选了 B 却读不到"。
74
+ *
75
+ * @param {object} ctx 运行期上下文(只要 `siteStateFile`)
76
+ * @param {{id:string,label?:string}} site
77
+ */
78
+ export function rememberSite(ctx, site) {
79
+ return writeSiteState(ctx.siteStateFile, site);
80
+ }
81
+
82
+ /** 按 1024 进制给人看的容量 */
83
+ export function formatBytes(n) {
84
+ const num = Number(n);
85
+ if (!Number.isFinite(num) || num < 0) return '-';
86
+ if (num < 1024) return `${num} B`;
87
+ if (num < 1024 * 1024) return `${(num / 1024).toFixed(1)} KB`;
88
+ return `${(num / 1024 / 1024).toFixed(2)} MB`;
89
+ }
90
+
91
+ /** 读一个文本文件(`--body-file` / `--file` 用);失败给能照做的中文错误 */
92
+ function readTextFile(flagName, filePath) {
93
+ const abs = path.resolve(String(filePath));
94
+ try {
95
+ return fs.readFileSync(abs, 'utf8');
96
+ } catch (e) {
97
+ throw new CliError(`读不到文件:${abs}`, {
98
+ kind: 'io',
99
+ hint: `${flagName} 需要一个可读的文件路径(${(e && e.code) || (e && e.message) || '未知原因'})`,
100
+ });
101
+ }
102
+ }
103
+
104
+ /** `--ext` 这类"整段 JSON"参数 */
105
+ function parseJsonObjectFlag(name, raw) {
106
+ let parsed;
107
+ try {
108
+ parsed = JSON.parse(String(raw));
109
+ } catch (e) {
110
+ throw new UsageError(`参数 ${name} 需要一段 JSON 对象,收到:${String(raw).slice(0, 80)}(${e.message})`);
111
+ }
112
+ if (!parsed || typeof parsed !== 'object' || Array.isArray(parsed)) {
113
+ throw new UsageError(`参数 ${name} 需要一个 JSON **对象**(形如 {"型号":"X1"}),不是数组或标量`);
114
+ }
115
+ return parsed;
116
+ }
117
+
118
+ /** 逗号分隔 → 字符串数组(`--usage home,featured`) */
119
+ function splitList(raw) {
120
+ return String(raw == null ? '' : raw)
121
+ .split(',')
122
+ .map((s) => s.trim())
123
+ .filter(Boolean);
124
+ }
125
+
126
+ /** `--body` / `--body-file` 二选一 → 正文;没给就 undefined(= 不传,后端保持原样) */
127
+ function resolveBodyFlag(ctx) {
128
+ const hasInline = ctx.flags.body !== undefined;
129
+ const hasFile = ctx.flags.bodyFile !== undefined;
130
+ if (hasInline && hasFile) throw new UsageError('--body 与 --body-file 只能给一个');
131
+ if (hasFile) return readTextFile('--body-file', ctx.flags.bodyFile);
132
+ return hasInline ? String(ctx.flags.body) : undefined;
133
+ }
134
+
135
+ /**
136
+ * 把「字段表 + flags」变成请求体:**只放用户真的给了的键**。
137
+ *
138
+ * 为什么不能一律塞 `undefined`:`categorySave` / `contentSave` 的语义是
139
+ * "没传的保持原样",塞一个 `null` 进去等于**清空**(`pickValue` 认的是 `undefined`)。
140
+ *
141
+ * ⚠️ 字段表的键是**命令行写法**(`in-menu` / `seo-description`),而解析后的 flags 是 camelCase
142
+ * (`inMenu` / `seoDescription`)—— 必须过 `camel()`,否则读到的永远是 undefined,
143
+ * 表现成"参数传了但没生效"(这条踩过一次,专门写在这)。
144
+ */
145
+ function pickFields(flags, table, payload) {
146
+ for (const [flagKey, bodyKey, kind] of table) {
147
+ const v = flags[camel(flagKey)];
148
+ if (v === undefined) continue;
149
+ if (kind === 'num') {
150
+ const n = Number(v);
151
+ if (!Number.isFinite(n)) throw new UsageError(`参数 --${flagKey} 需要数字,收到:${v}`);
152
+ payload[bodyKey] = n;
153
+ } else if (kind === 'bool') {
154
+ payload[bodyKey] = v === true;
155
+ } else if (kind === 'list') {
156
+ payload[bodyKey] = splitList(v);
157
+ } else {
158
+ payload[bodyKey] = String(v);
159
+ }
160
+ }
161
+ return payload;
162
+ }
163
+
164
+ /* ------------------------------------------------------------------ 站点 */
165
+
166
+ /**
167
+ * `wkgeo site use`:把"以后操作哪个站"记在本地。
168
+ *
169
+ * 为什么要这一步(而不是每条命令都问):CMS 的动作**必须**有站点上下文,
170
+ * 而 CLI 没有登录 Cookie;把选择显式化之后,多站用户不会出现"改了 A 站以为改的是 B 站"。
171
+ *
172
+ * 域名 → id 的解析走平台面的 `listSites`(**自己名下**的站)。
173
+ * ⚠️ 如果这个站是"别人邀请你协作的",`listSites` 里没有 ⇒ 只能用站点 ID 选(文案里已写明)。
174
+ */
175
+ export const siteUseCommand = {
176
+ name: 'site use',
177
+ summary: '选中要操作的站点(本地记住,之后的 CMS 命令都带它)',
178
+ usage: 'wkgeo site use <站点ID或域名>\nwkgeo site use # 看当前选中的是哪个站\nwkgeo site use --clear # 取消选中',
179
+ args: [{ name: 'site', required: false, desc: '站点 ID(uuid)、自有域名、临时域名或站点名' }],
180
+ flags: {
181
+ clear: { type: 'boolean', desc: '取消当前选中的站点' },
182
+ },
183
+ examples: [
184
+ 'wkgeo site use 8f3c1a2e-4b5d-4f6a-8b7c-9d0e1f2a3b4c',
185
+ 'wkgeo site use www.example.com',
186
+ 'wkgeo site use # 只查询,不改',
187
+ 'wkgeo categories list --site 8f3c… # 不改本地选择,临时指定',
188
+ ],
189
+ notes: [
190
+ '选择存在 `<凭据目录>/config.json`(默认 `~/.wkongai/config.json`),与令牌文件分开:logout 不会清掉它。',
191
+ '域名解析只查**你自己名下**的站;协作站的域名查不到时,请改用站点 ID。',
192
+ ],
193
+ async run(ctx) {
194
+ const { out } = ctx;
195
+
196
+ if (ctx.flags.clear) {
197
+ const had = clearSiteState(ctx.siteStateFile);
198
+ const data = { cleared: had, site: null, state_file: ctx.siteStateFile };
199
+ if (out.json) ctx.done(data);
200
+ else if (had) out.ok('已取消选中的站点(后续 CMS 命令需要重新 `wkgeo site use` 或加 `--site`)');
201
+ else out.info('本来就没有选中任何站点,无需取消。');
202
+ return data;
203
+ }
204
+
205
+ const wanted = String(ctx.positional.site || '').trim();
206
+ if (!wanted) {
207
+ const current = readSiteState(ctx.siteStateFile);
208
+ const data = { site: current, state_file: ctx.siteStateFile, selected: Boolean(current) };
209
+ if (out.json) ctx.done(data);
210
+ else if (current) {
211
+ out.head('当前选中的站点');
212
+ out.line(` 站点:${siteText(current)}`);
213
+ out.line(` 选择时间:${formatTime(current.saved_at)}`);
214
+ out.line(` 记录文件:${ctx.siteStateFile}`);
215
+ } else {
216
+ out.info('还没有选中站点:运行 `wkgeo site use <站点ID或域名>`,或在命令里加 `--site <站点ID>`。');
217
+ }
218
+ return data;
219
+ }
220
+
221
+ /** ① ID 直接认(**不查库**:协作站也可能不在 listSites 里,那是正常情况) */
222
+ let site = null;
223
+ let matchedBy = '';
224
+ if (looksLikeUuid(wanted)) {
225
+ site = { id: wanted, label: '' };
226
+ matchedBy = 'id';
227
+ } else {
228
+ /** ② 域名 / 站点名 → 查平台面的站点列表再匹配 */
229
+ const res = await ctx.callData('listSites', { limit: 200 });
230
+ const rows = (res && Array.isArray(res.rows) ? res.rows : []).map((r) => r || {});
231
+ site = matchSiteRow(rows, wanted);
232
+ matchedBy = site ? site.matched_by : '';
233
+ if (!site) {
234
+ throw new CliError(`没有找到站点「${wanted}」(按 id / 域名 / 站点名都没匹配上)`, {
235
+ kind: 'not_found',
236
+ code: 404,
237
+ hint:
238
+ rows.length
239
+ ? `你名下的站:${rows
240
+ .slice(0, 10)
241
+ .map((r) => `${r.name || '(未命名)'}=${r.id}`)
242
+ .join(';')}${rows.length > 10 ? ` …共 ${rows.length} 个` : ''};也可以直接给站点 ID。`
243
+ : '当前账号名下没有站点(协作站不在列表里)—— 请直接用站点 ID。',
244
+ });
245
+ }
246
+ }
247
+
248
+ rememberSite(ctx, site);
249
+ const data = {
250
+ site: { id: site.id, label: site.label || '' },
251
+ matched_by: matchedBy,
252
+ state_file: ctx.siteStateFile,
253
+ };
254
+ if (out.json) ctx.done(data);
255
+ else {
256
+ out.ok(`已选中站点:${siteText(site)}`);
257
+ out.info(` 记录文件:${ctx.siteStateFile}(之后的 CMS 命令默认都用这个站)`);
258
+ out.info(' 临时换站:任意 CMS 命令加 `--site <站点ID>`。');
259
+ }
260
+ return data;
261
+ },
262
+ };
263
+
264
+ /**
265
+ * 在一堆站点行里按「域名 / 临时域名 / 站点名」找唯一一个。
266
+ *
267
+ * @returns {{id:string, label:string, matched_by:string}|null}
268
+ */
269
+ export function matchSiteRow(rows, wanted) {
270
+ const needle = normalizeSiteRef(wanted);
271
+ if (!needle) return null;
272
+ for (const row of rows || []) {
273
+ const id = String(row.id || '');
274
+ if (!id) continue;
275
+ const label = String(row.name || '') || String(row.domain || '');
276
+ const domains = [];
277
+ if (row.domain) domains.push(String(row.domain));
278
+ if (Array.isArray(row.domains)) for (const d of row.domains) if (d) domains.push(String(d));
279
+ if (row.prefix_host) domains.push(String(row.prefix_host));
280
+ for (const d of domains) {
281
+ if (normalizeSiteRef(d) === needle) return { id, label, matched_by: 'domain' };
282
+ }
283
+ if (String(row.name || '').trim() === String(wanted).trim()) return { id, label, matched_by: 'name' };
284
+ }
285
+ return null;
286
+ }
287
+
288
+ /** 域名归一:去掉协议、`/` 尾巴、大小写 —— 用户粘一条网址进来也能匹配 */
289
+ function normalizeSiteRef(v) {
290
+ return String(v || '')
291
+ .trim()
292
+ .replace(/^https?:\/\//i, '')
293
+ .replace(/\/+$/, '')
294
+ .toLowerCase();
295
+ }
296
+
297
+ /* ------------------------------------------------------------------ 栏目 */
298
+
299
+ /** 取本站栏目全表(`categoryList` 返回的是**数组**,不是 `{rows}`) */
300
+ async function fetchCategories(ctx) {
301
+ const res = await ctx.contentCall('categoryList');
302
+ const rows = Array.isArray(res) ? res : res && Array.isArray(res.rows) ? res.rows : [];
303
+ return rows.map((r) => r || {});
304
+ }
305
+
306
+ /**
307
+ * 栏目引用 → 栏目行(支持 栏目 ID / slug / path / 栏目名)。
308
+ *
309
+ * 为什么要这么宽:AI 端手里常常只有「新闻」这个栏目名或 `/news/` 这个路径,
310
+ * 逼它先去记一个 uuid 没有意义 —— 而全表本来就在一次调用里拿回来了。
311
+ */
312
+ export async function resolveCategory(ctx, ref) {
313
+ const wanted = String(ref || '').trim();
314
+ if (!wanted) throw new UsageError('缺少栏目(可以给栏目 ID、slug、path 或栏目名)');
315
+ const rows = await fetchCategories(ctx);
316
+ const low = wanted.toLowerCase();
317
+ const trimPath = (s) => String(s || '').replace(/^\/+|\/+$/g, '').toLowerCase();
318
+ const hit =
319
+ rows.find((r) => String(r.id) === wanted) ||
320
+ rows.find((r) => String(r.slug || '').toLowerCase() === low) ||
321
+ rows.find((r) => trimPath(r.path) === trimPath(wanted)) ||
322
+ rows.find((r) => String(r.name || '') === wanted);
323
+ if (hit) return hit;
324
+ throw new CliError(`没有找到栏目「${wanted}」`, {
325
+ kind: 'not_found',
326
+ code: 404,
327
+ hint: rows.length
328
+ ? `当前栏目:${rows
329
+ .slice(0, 20)
330
+ .map((r) => `${r.name || '(未命名)'}(${r.path || r.slug || r.id})`)
331
+ .join('、')}${rows.length > 20 ? ' …' : ''}`
332
+ : '这个站还没有栏目:先 `wkgeo categories create --name 首页 --kind channel`,或在后台启用默认栏目。',
333
+ });
334
+ }
335
+
336
+ export const categoriesListCommand = {
337
+ name: 'categories list',
338
+ summary: '栏目列表(树序:按 level / sort 排)',
339
+ usage: 'wkgeo categories list [--site <站点ID>]',
340
+ flags: { ...SITE_FLAG },
341
+ examples: ['wkgeo categories list', 'wkgeo categories list --json', 'wkgeo categories list --site 8f3c…'],
342
+ async run(ctx) {
343
+ const { out } = ctx;
344
+ const site = ctx.cmsSite();
345
+ const rows = await fetchCategories(ctx);
346
+ const data = { site_id: siteIdOf(site), rows, total: rows.length };
347
+
348
+ if (!out.json) {
349
+ out.head(`栏目列表(${rows.length} 个 · 站点 ${siteText(site)})`);
350
+ out.table(
351
+ [
352
+ { title: '名称', key: 'name', width: 26, format: (v, row) => `${' '.repeat(Math.max(0, (Number(row.level) || 1) - 1))}${v || ''}` },
353
+ { title: '路径', key: 'path', width: 20 },
354
+ { title: '类型', key: 'kind', width: 8, format: (v) => CATEGORY_KIND_LABEL[v] || v || '-' },
355
+ { title: '状态', key: 'status', width: 6, format: (v) => (v === 'hide' ? '隐藏' : '显示') },
356
+ { title: '绑定模板', key: 'template_path', width: 14 },
357
+ { title: '栏目 ID', key: 'id', width: 38 },
358
+ ],
359
+ rows,
360
+ );
361
+ }
362
+ ctx.done(data);
363
+ return data;
364
+ },
365
+ };
366
+
367
+ export const categoriesGetCommand = {
368
+ name: 'categories get',
369
+ summary: '单个栏目详情(含栏目正文与父栏目启用的字段)',
370
+ usage: 'wkgeo categories get <栏目ID|slug|path|栏目名> [--site <站点ID>]',
371
+ args: [{ name: 'category', required: true, desc: '栏目 ID / slug / path(如 /news/)/ 栏目名' }],
372
+ flags: { ...SITE_FLAG },
373
+ examples: ['wkgeo categories get /news/', 'wkgeo categories get 8f3c1a2e-… --json'],
374
+ async run(ctx) {
375
+ const { out } = ctx;
376
+ const site = ctx.cmsSite();
377
+ const row = await resolveCategory(ctx, ctx.positional.category);
378
+ /** 详情要单独调一次:正文在 cms_richtext 里,`categoryList` 故意不带(列表会被拖慢) */
379
+ const one = await ctx.contentCall('categoryGet', { id: String(row.id) });
380
+ const data = { site_id: siteIdOf(site), category: one };
381
+
382
+ if (!out.json) {
383
+ out.head(`栏目:${one.name || row.name || ''}`);
384
+ const lines = [
385
+ ['栏目 ID', one.id],
386
+ ['路径', one.path],
387
+ ['slug', one.slug],
388
+ ['类型', CATEGORY_KIND_LABEL[one.kind] || one.kind || '-'],
389
+ ['状态', one.status === 'hide' ? '隐藏' : '显示'],
390
+ ['在菜单里', one.in_menu ? '是' : '否'],
391
+ ['绑定模板', one.template_path || '(按类型自动选)'],
392
+ ['副标题', one.sub_title || '-'],
393
+ ['SEO 描述', one.seo_description || '-'],
394
+ ['SEO 关键词', one.seo_keywords || '-'],
395
+ ['更新时间', formatTime(one.updated_at)],
396
+ ];
397
+ for (const [k, v] of lines) out.line(` ${k}:${v === undefined || v === null || v === '' ? '-' : v}`);
398
+ if (one.body) {
399
+ out.line(' 栏目正文:');
400
+ out.line(String(one.body));
401
+ }
402
+ }
403
+ ctx.done(data);
404
+ return data;
405
+ },
406
+ };
407
+
408
+ /** `categorySave` 支持的字段(flag → body 键) */
409
+ const CATEGORY_FIELDS = [
410
+ ['name', 'name', 'str'],
411
+ ['slug', 'slug', 'str'],
412
+ ['parent', 'parent_id', 'str'],
413
+ ['kind', 'kind', 'str'],
414
+ ['status', 'status', 'str'],
415
+ ['sort', 'sort', 'num'],
416
+ ['icon', 'icon', 'str'],
417
+ ['link-url', 'link_url', 'str'],
418
+ ['link-category', 'link_category_id', 'str'],
419
+ ['link-plugin', 'link_plugin_key', 'str'],
420
+ ['link-plugin-sub', 'link_plugin_sub', 'str'],
421
+ ['description', 'description', 'str'],
422
+ ['sub-title', 'sub_title', 'str'],
423
+ ['seo-description', 'seo_description', 'str'],
424
+ ['seo-keywords', 'seo_keywords', 'str'],
425
+ ['seo-jsonld', 'seo_jsonld', 'str'],
426
+ ['in-menu', 'in_menu', 'bool'],
427
+ ['featured', 'featured', 'bool'],
428
+ ['cover', 'cover_asset_id', 'str'],
429
+ ['attachments', 'attachments', 'list'],
430
+ ['fields-enabled', 'fields_enabled', 'bool'],
431
+ ['max-depth', 'max_depth', 'num'],
432
+ ['template-path', 'template_path', 'str'],
433
+ ];
434
+
435
+ /** 栏目命令共用的字段参数(新建/修改同源,避免两处写歪) */
436
+ const CATEGORY_FIELD_FLAGS = {
437
+ slug: { type: 'string', desc: 'URL 片段(不传由服务端按名字生成)' },
438
+ parent: { type: 'string', desc: '上级栏目 ID(不传 = 一级栏目)' },
439
+ kind: { type: 'string', desc: '页面类型:channel 频道页 / list 列表页 / page 单页(只有一级栏目能定)' },
440
+ status: { type: 'string', desc: '显示状态:show 显示 / hide 隐藏' },
441
+ sort: { type: 'string', desc: '排序(小的在前)' },
442
+ icon: { type: 'string', desc: '菜单图标(iconify 名,如 mdi:home-outline)' },
443
+ 'link-url': { type: 'string', desc: '外链地址(http/https;给了就是"点它直接跳走"的栏目)' },
444
+ 'link-category': { type: 'string', desc: '内部跳转目标:另一个栏目的 ID(优先级高于插件页与外链)' },
445
+ 'link-plugin': {
446
+ type: 'string',
447
+ desc: '插件页跳转:插件 key(如 contact-form;须本站已安装且已启用,否则后端 400)',
448
+ },
449
+ 'link-plugin-sub': { type: 'string', desc: '插件页跳转的子页面(如 list/detail;可选)' },
450
+ description: { type: 'string', desc: '栏目描述(也当前台 SEO 的 description 备选)' },
451
+ 'sub-title': { type: 'string', desc: '副标题(下拉菜单第二行小字)' },
452
+ 'seo-description': { type: 'string', desc: 'SEO 描述(≤500 字)' },
453
+ 'seo-keywords': { type: 'string', desc: 'SEO 关键词(逗号分隔,≤300 字)' },
454
+ 'seo-jsonld': { type: 'string', desc: '结构化数据 JSON-LD(直接塞进 page <script type="application/ld+json">)' },
455
+ 'in-menu': { type: 'boolean', desc: '是否显示在前台导航菜单里(默认是;关掉用 --no-in-menu)' },
456
+ featured: { type: 'boolean', desc: '是否推荐(频道页取数用;默认是)' },
457
+ cover: { type: 'string', desc: '封面素材 ID(先 `wkgeo assets upload` 拿到 ID)' },
458
+ attachments: { type: 'string', desc: '附件素材 ID,逗号分隔(如 id1,id2)' },
459
+ 'fields-enabled': { type: 'boolean', desc: '是否启用自定义字段(默认是)' },
460
+ 'max-depth': { type: 'string', desc: '该栏目下最多几级子栏目(默认服务端给)' },
461
+ 'template-path': { type: 'string', desc: '绑定模板文件名(xxx.html;等价于 `categories bind-template`)' },
462
+ body: { type: 'string', desc: '栏目正文(富文本 HTML)' },
463
+ 'body-file': { type: 'string', desc: '从本地文件读栏目正文(与 --body 二选一)' },
464
+ };
465
+
466
+ export const categoriesCreateCommand = {
467
+ name: 'categories create',
468
+ summary: '新建栏目',
469
+ usage: 'wkgeo categories create --name <栏目名> [--parent <上级栏目ID>] [--kind channel|list|page] [其他字段…]',
470
+ flags: {
471
+ name: { type: 'string', required: true, desc: '栏目名(≤100 字)' },
472
+ ...CATEGORY_FIELD_FLAGS,
473
+ ...SITE_FLAG,
474
+ },
475
+ examples: [
476
+ 'wkgeo categories create --name 新闻 --kind list --seo-description "公司新闻动态"',
477
+ 'wkgeo categories create --name 公司简介 --kind page --parent <关于我们的ID>',
478
+ 'wkgeo categories create --name 产品 --slug product --body-file ./product.html',
479
+ ],
480
+ notes: [
481
+ '单页(page)栏目会自动带一条"只能编辑、不能新建也不能删除"的内容;要加一页 = 给它加子栏目。',
482
+ '首页(slug=home)的页面类型会被服务端锁定为 channel。',
483
+ ],
484
+ async run(ctx) {
485
+ const { out, flags } = ctx;
486
+ const site = ctx.cmsSite();
487
+ const payload = pickFields(flags, CATEGORY_FIELDS, { name: String(flags.name) });
488
+ const body = resolveBodyFlag(ctx);
489
+ if (body !== undefined) payload.body = body;
490
+
491
+ const one = await ctx.contentCall('categorySave', payload);
492
+ const data = { site_id: siteIdOf(site), category: one };
493
+ if (!out.json) {
494
+ out.ok(`栏目已创建:${(one && one.name) || payload.name}`);
495
+ out.line(` 栏目 ID:${(one && one.id) || '-'}`);
496
+ out.line(` 路径:${(one && one.path) || '-'}(类型 ${CATEGORY_KIND_LABEL[(one && one.kind) || ''] || (one && one.kind) || '-'})`);
497
+ out.info(' 下一步:`wkgeo contents create --category <栏目ID> --title …`,或 `wkgeo categories bind-template <栏目> index.html`。');
498
+ }
499
+ ctx.done(data);
500
+ return data;
501
+ },
502
+ };
503
+
504
+ export const categoriesUpdateCommand = {
505
+ name: 'categories update',
506
+ summary: '修改栏目(只改给了的字段,其余保持原样)',
507
+ usage: 'wkgeo categories update <栏目ID|slug|path> [--name …] [--status show|hide] [其他字段…]',
508
+ args: [{ name: 'category', required: true, desc: '栏目 ID / slug / path / 栏目名' }],
509
+ flags: {
510
+ /** `name` 单独声明:新建时是**必填**,修改时不能必填("没传的保持原样") */
511
+ name: { type: 'string', desc: '新栏目名(≤100 字)' },
512
+ ...CATEGORY_FIELD_FLAGS,
513
+ ...SITE_FLAG,
514
+ },
515
+ examples: [
516
+ 'wkgeo categories update /news/ --name 新闻中心',
517
+ 'wkgeo categories update 8f3c1a2e-… --no-in-menu # 不显示在前台菜单',
518
+ ],
519
+ notes: ['"没传的字段保持原样"是服务端口径,所以改名不会顺手把描述清空;要清空请显式传空串(如 --description "")。'],
520
+ async run(ctx) {
521
+ const { out, flags } = ctx;
522
+ const site = ctx.cmsSite();
523
+ const row = await resolveCategory(ctx, ctx.positional.category);
524
+ const payload = pickFields(flags, CATEGORY_FIELDS, { id: String(row.id) });
525
+ const body = resolveBodyFlag(ctx);
526
+ if (body !== undefined) payload.body = body;
527
+
528
+ if (Object.keys(payload).length <= 1) {
529
+ throw new UsageError(
530
+ '没有要改的字段:至少给一个(--name / --slug / --status / --sort / --seo-description / --body …)',
531
+ );
532
+ }
533
+
534
+ const one = await ctx.contentCall('categorySave', payload);
535
+ const data = { site_id: siteIdOf(site), category_id: String(row.id), changed: Object.keys(payload).filter((k) => k !== 'id'), category: one };
536
+ if (!out.json) {
537
+ out.ok(`栏目已更新:${(one && one.name) || row.name}(${data.changed.join(', ')})`);
538
+ out.line(` 栏目 ID:${row.id}`);
539
+ }
540
+ ctx.done(data);
541
+ return data;
542
+ },
543
+ };
544
+
545
+ /**
546
+ * `categories save` —— create / update 的二合一(task-73 起的对外推荐写法)。
547
+ *
548
+ * 为什么不直接让 AI 记「新建用 create、改名用 update」:agent 拿到的是「保存一下」
549
+ * 这个意图,让它先判断该用哪条命令纯属给自己加错因。给了栏目 ID/slug/path 就是改,
550
+ * 没给就是新建 —— 判断只在一处(这里),两条老命令仍然保留(脚本里有存量调用)。
551
+ */
552
+ export const categoriesSaveCommand = {
553
+ name: 'categories save',
554
+ summary: '保存栏目:给了 <栏目ID|slug|path> 就改,没给就新建(create / update 二合一)',
555
+ usage: 'wkgeo categories save [栏目ID|slug|path] [--name …] [--parent …] [--kind …] [其他字段…]',
556
+ args: [{ name: 'category', required: false, desc: '栏目 ID / slug / path / 栏目名(给了就改,不给就新建)' }],
557
+ flags: {
558
+ name: { type: 'string', desc: '栏目名(新建时必填,≤100 字)' },
559
+ ...CATEGORY_FIELD_FLAGS,
560
+ ...SITE_FLAG,
561
+ },
562
+ examples: [
563
+ 'wkgeo categories save --name 新闻 --kind list # 新建',
564
+ 'wkgeo categories save /news/ --name 新闻中心 # 改名',
565
+ 'wkgeo categories save 8f3c1a2e-… --status hide --json # 隐藏',
566
+ ],
567
+ notes: [
568
+ '判断口径:**有没有给栏目**。给了 = 修改(找不到那个栏目会报错),没给 = 新建(必须给 --name)。',
569
+ '等价命令仍在:`categories create` / `categories update`。',
570
+ ],
571
+ async run(ctx) {
572
+ const target = String(ctx.positional.category || '').trim();
573
+ if (!target) {
574
+ if (!ctx.flags.name) {
575
+ throw new UsageError(
576
+ '没给栏目:新建必须带 --name(如 `wkgeo categories save --name 新闻 --kind list`);要改已有栏目请把栏目 ID/slug/path 放在命令后面。',
577
+ );
578
+ }
579
+ return categoriesCreateCommand.run(ctx);
580
+ }
581
+ const prev = ctx.positional;
582
+ ctx.positional = { ...(prev || {}), category: target };
583
+ try {
584
+ return await categoriesUpdateCommand.run(ctx);
585
+ } finally {
586
+ ctx.positional = prev;
587
+ }
588
+ },
589
+ };
590
+
591
+ export const categoriesDeleteCommand = {
592
+ name: 'categories delete',
593
+ summary: '删除栏目(系统栏目 / 还有子栏目或内容时服务端会拒绝)',
594
+ usage: 'wkgeo categories delete <栏目ID|slug|path> [--site <站点ID>]',
595
+ args: [{ name: 'category', required: true, desc: '栏目 ID / slug / path / 栏目名' }],
596
+ flags: { ...SITE_FLAG },
597
+ examples: ['wkgeo categories delete /old/', 'wkgeo categories delete 8f3c1a2e-… --json'],
598
+ notes: [
599
+ '系统预置栏目**只能隐藏不能删**;下面还有子栏目 / 普通内容时也会被拒(先把它们挪走或删掉)。',
600
+ '单页栏目自己的那一页内容会跟着栏目一起删(那是唯一正规的做法)。',
601
+ ],
602
+ async run(ctx) {
603
+ const { out } = ctx;
604
+ const site = ctx.cmsSite();
605
+ const row = await resolveCategory(ctx, ctx.positional.category);
606
+ const res = await ctx.contentCall('categoryDelete', { id: String(row.id) });
607
+ const data = { site_id: siteIdOf(site), id: String(row.id), name: row.name || '', deleted: !!(res && res.deleted) };
608
+ if (!out.json) {
609
+ out.ok(`栏目已删除:${data.name || data.id}`);
610
+ }
611
+ ctx.done(data);
612
+ return data;
613
+ },
614
+ };
615
+
616
+ /**
617
+ * 栏目绑定模板文件(`categorySave.template_path`)。
618
+ *
619
+ * 为什么单独一条命令:后台最常做的一件事是"把这一栏换成另一套版式",
620
+ * 而 `template_path` 藏在保存接口里 —— 让 AI 为改一个字段去拼整个栏目表单没必要,
621
+ * 也容易把别的字段(描述 / SEO)顺手清掉。
622
+ */
623
+ export const categoriesBindTemplateCommand = {
624
+ name: 'categories bind-template',
625
+ summary: '给栏目绑定模板文件(不给 <模板文件> + --clear = 解绑,回到"按栏目类型自动选")',
626
+ usage: 'wkgeo categories bind-template <栏目ID|slug|path> <模板文件名>\nwkgeo categories bind-template <栏目> --clear',
627
+ args: [
628
+ { name: 'category', required: true, desc: '栏目 ID / slug / path / 栏目名' },
629
+ { name: 'template', required: false, desc: '模板文件名,如 about.html(必须是本站模板里已有的文件)' },
630
+ ],
631
+ flags: {
632
+ clear: { type: 'boolean', desc: '解绑(清空 template_path,回到按栏目类型自动选模板)' },
633
+ ...SITE_FLAG,
634
+ },
635
+ examples: [
636
+ 'wkgeo categories bind-template /about/ about.html',
637
+ 'wkgeo categories bind-template 新闻 news-list.html',
638
+ 'wkgeo categories bind-template /about/ --clear',
639
+ 'wkgeo templates list # 先看本站有哪些 html',
640
+ ],
641
+ notes: [
642
+ '模板文件白名单:`字母/数字/中划线/下划线 + .html`;文件不存在时服务端会拒绝 —— 这里先查一次并列出可选文件。',
643
+ '不绑定时按栏目类型自动选:频道页 index.html、单页 about.html、列表页/内容页 content.html。',
644
+ ],
645
+ async run(ctx) {
646
+ const { out, flags } = ctx;
647
+ const site = ctx.cmsSite();
648
+ const row = await resolveCategory(ctx, ctx.positional.category);
649
+ const clear = flags.clear === true;
650
+ const wanted = String(ctx.positional.template || '').trim();
651
+
652
+ if (!clear && !wanted) {
653
+ throw new UsageError('缺少参数 <模板文件>(要解绑请加 --clear)\n用法:wkgeo categories bind-template <栏目> <模板文件名>');
654
+ }
655
+ if (clear && wanted) {
656
+ throw new UsageError('--clear 与 <模板文件> 只能给一个(要绑定就写文件名,要解绑就只给 --clear)');
657
+ }
658
+
659
+ let templatePath = '';
660
+ if (!clear) {
661
+ if (!/^[A-Za-z0-9_-]+\.html$/.test(wanted)) {
662
+ throw new UsageError(`模板文件名不合法:${wanted}\n只允许 字母/数字/中划线/下划线 + .html,例如 about.html`);
663
+ }
664
+ /** 先查一次本站模板,把"没有这个文件"变成一句带候选的错误(服务端也会查,但它的报错没有候选列表) */
665
+ const tpl = await ctx.cmsCall('templateGet', {});
666
+ const files = (tpl && Array.isArray(tpl.files) ? tpl.files : []).map((f) => String((f && f.path) || ''));
667
+ if (!files.includes(wanted)) {
668
+ throw new CliError(`本站模板里没有「${wanted}」`, {
669
+ kind: 'not_found',
670
+ code: 404,
671
+ hint: files.length
672
+ ? `现有模板文件:${files.join(' / ')};要新建它用 \`wkgeo templates save ${wanted} --file <本地文件>\``
673
+ : '本站还没有模板文件:先 `wkgeo templates save index.html --file <本地文件>`(或先跑 `wkgeo templates list` 让服务端 seed 默认模板)',
674
+ });
675
+ }
676
+ templatePath = wanted;
677
+ }
678
+
679
+ const one = await ctx.contentCall('categorySave', { id: String(row.id), template_path: templatePath });
680
+ const data = {
681
+ site_id: siteIdOf(site),
682
+ category_id: String(row.id),
683
+ category_name: row.name || '',
684
+ template_path: templatePath || null,
685
+ cleared: clear,
686
+ category: one,
687
+ };
688
+ if (!out.json) {
689
+ if (clear) out.ok(`已解绑模板:${row.name || data.category_id}(回到按栏目类型自动选)`);
690
+ else out.ok(`已绑定模板:${row.name || data.category_id} → ${templatePath}`);
691
+ }
692
+ ctx.done(data);
693
+ return data;
694
+ },
695
+ };
696
+
697
+ /* ------------------------------------------------------------------ 内容 */
698
+
699
+ export const contentsListCommand = {
700
+ name: 'contents list',
701
+ summary: '内容列表(可按栏目 / 状态 / 关键词筛;不含正文)',
702
+ usage: 'wkgeo contents list [--category <栏目>] [--status draft|published|hidden] [--keyword 词] [--page 1] [--page-size 20]',
703
+ flags: {
704
+ category: { type: 'string', desc: '只看这个栏目(ID / slug / path / 栏目名)' },
705
+ status: { type: 'string', desc: '状态:draft 草稿 / published 已发布 / hidden 隐藏' },
706
+ keyword: { type: 'string', desc: '标题关键词' },
707
+ page: { type: 'string', desc: '页码(默认 1)' },
708
+ 'page-size': { type: 'string', desc: '每页条数(默认 20,最多 100)' },
709
+ sort: { type: 'string', desc: '排序:views_desc 访问量降序 / views_asc 升序(默认置顶→排序→ID)' },
710
+ 'include-children': { type: 'boolean', desc: '连下级栏目的内容一起列' },
711
+ 'owner-page': { type: 'boolean', desc: '只看"单页栏目那一页"(单页栏目专用)' },
712
+ ...SITE_FLAG,
713
+ },
714
+ examples: [
715
+ 'wkgeo contents list --status draft',
716
+ 'wkgeo contents list --category 新闻 --page-size 50',
717
+ 'wkgeo contents list --keyword 展会 --include-children --json',
718
+ ],
719
+ async run(ctx) {
720
+ const { out, flags } = ctx;
721
+ const site = ctx.cmsSite();
722
+ const payload = {};
723
+ if (flags.category !== undefined) payload.categoryId = String((await resolveCategory(ctx, flags.category)).id);
724
+ if (flags.status !== undefined) payload.status = String(flags.status);
725
+ if (flags.keyword !== undefined) payload.keyword = String(flags.keyword);
726
+ if (flags.page !== undefined) payload.page = Number(flags.page);
727
+ if (flags.pageSize !== undefined) payload.pageSize = Number(flags.pageSize);
728
+ if (flags.sort !== undefined) payload.sort = String(flags.sort);
729
+ if (flags.includeChildren !== undefined) payload.includeChildren = flags.includeChildren === true;
730
+ if (flags.ownerPage !== undefined) payload.ownerPage = flags.ownerPage === true;
731
+
732
+ const res = await ctx.contentCall('contentList', payload);
733
+ const rows = (res && Array.isArray(res.rows) ? res.rows : []).map((r) => r || {});
734
+ const data = {
735
+ site_id: siteIdOf(site),
736
+ rows,
737
+ total: (res && res.total) || rows.length,
738
+ page: (res && res.page) || payload.page || 1,
739
+ page_size: (res && res.pageSize) || payload.pageSize || 20,
740
+ };
741
+
742
+ if (!out.json) {
743
+ out.head(`内容列表(共 ${data.total} 条 · 第 ${data.page} 页 ${rows.length} 条 · 站点 ${siteText(site)})`);
744
+ out.table(
745
+ [
746
+ { title: '标题', key: 'title', width: 34 },
747
+ { title: '栏目', key: 'category_name', width: 14 },
748
+ { title: '状态', key: 'status', width: 8, format: (v) => CONTENT_STATUS_LABEL[v] || v || '-' },
749
+ { title: '更新时间', key: 'updated_at', format: (v) => formatTime(v), width: 20 },
750
+ { title: '内容 ID', key: 'id', width: 38 },
751
+ ],
752
+ rows,
753
+ );
754
+ if (data.total > data.page * data.page_size) {
755
+ out.info(` 下一页:--page ${data.page + 1}`);
756
+ }
757
+ }
758
+ ctx.done(data);
759
+ return data;
760
+ },
761
+ };
762
+
763
+ export const contentsGetCommand = {
764
+ name: 'contents get',
765
+ summary: '单条内容详情(含正文、附件、SEO、自定义字段)',
766
+ usage: 'wkgeo contents get <内容ID> [--site <站点ID>]',
767
+ args: [{ name: 'id', required: true, desc: '内容 ID(uuid)' }],
768
+ flags: { ...SITE_FLAG },
769
+ examples: ['wkgeo contents get 8f3c1a2e-…', 'wkgeo contents get 8f3c1a2e-… --json'],
770
+ async run(ctx) {
771
+ const { out } = ctx;
772
+ const site = ctx.cmsSite();
773
+ const id = String(ctx.positional.id || '').trim();
774
+ if (!looksLikeUuid(id)) {
775
+ throw new UsageError(`内容 ID 应该是 uuid,收到:${id}\n先 'wkgeo contents list' 找到它`);
776
+ }
777
+ const one = await ctx.contentCall('contentGet', { id });
778
+ const data = { site_id: siteIdOf(site), content: one };
779
+ if (!out.json) {
780
+ out.head(`内容:${one.title || ''}`);
781
+ const ext = (one && one.ext) || {};
782
+ const lines = [
783
+ ['内容 ID', one.id],
784
+ ['栏目', one.category_name || one.category_id],
785
+ ['slug', one.slug],
786
+ ['状态', CONTENT_STATUS_LABEL[one.status] || one.status],
787
+ ['置顶', one.pinned ? '是' : '否'],
788
+ ['访问量', one.views],
789
+ ['关键词', one.keywords || ext.keywords || '-'],
790
+ ['封面', one.cover_url || ext.cover_asset_id || '-'],
791
+ ['更新时间', formatTime(one.updated_at)],
792
+ ];
793
+ for (const [k, v] of lines) out.line(` ${k}:${v === undefined || v === null || v === '' ? '-' : v}`);
794
+ if (one.body) {
795
+ out.line(' 正文:');
796
+ out.line(String(one.body));
797
+ }
798
+ }
799
+ ctx.done(data);
800
+ return data;
801
+ },
802
+ };
803
+
804
+ /** `contentSave` 支持的字段(flag → body 键) */
805
+ const CONTENT_FIELDS = [
806
+ ['slug', 'slug', 'str'],
807
+ ['status', 'status', 'str'],
808
+ ['description', 'description', 'str'],
809
+ ['keywords', 'keywords', 'str'],
810
+ ['sub-title', 'sub_title', 'str'],
811
+ ['cover', 'cover_asset_id', 'str'],
812
+ ['video', 'video_asset_id', 'str'],
813
+ ['usage', 'usage', 'list'],
814
+ ['sort', 'sort', 'num'],
815
+ ['pinned', 'pinned', 'bool'],
816
+ ['attachments', 'attachments', 'list'],
817
+ ];
818
+
819
+ /** 内容命令共用的字段参数 */
820
+ const CONTENT_FIELD_FLAGS = {
821
+ slug: { type: 'string', desc: 'URL 片段(不传由服务端生成)' },
822
+ status: { type: 'string', desc: '状态:draft 草稿(默认)/ published 已发布 / hidden 隐藏' },
823
+ description: { type: 'string', desc: '描述(列表页简介 + SEO description,≤500 字)' },
824
+ keywords: { type: 'string', desc: '关键词(≤300 字)' },
825
+ 'sub-title': { type: 'string', desc: '副标题' },
826
+ cover: { type: 'string', desc: '封面素材 ID(先用 `wkgeo assets upload` 传图拿 id)' },
827
+ video: { type: 'string', desc: '视频素材 ID' },
828
+ usage: { type: 'string', desc: '用途/位置,逗号分隔:home 首页、list 列表、featured 推荐' },
829
+ sort: { type: 'string', desc: '排序(小的在前)' },
830
+ pinned: { type: 'boolean', desc: '置顶' },
831
+ attachments: { type: 'string', desc: '多图:素材 ID 逗号分隔(整体替换)' },
832
+ ext: { type: 'string', desc: '自定义字段(JSON 对象,如 {"型号":"X1"};与内置字段同名时以 --ext 为准)' },
833
+ body: { type: 'string', desc: '正文(富文本 HTML)' },
834
+ 'body-file': { type: 'string', desc: '从本地文件读正文(与 --body 二选一)' },
835
+ };
836
+
837
+ /** 把内容相关的 flags 收成 `contentSave` 的请求体 */
838
+ function buildContentPayload(ctx, base) {
839
+ const payload = pickFields(ctx.flags, CONTENT_FIELDS, { ...base });
840
+ const body = resolveBodyFlag(ctx);
841
+ if (body !== undefined) payload.body = body;
842
+ if (ctx.flags.ext !== undefined) payload.ext = parseJsonObjectFlag('--ext', ctx.flags.ext);
843
+ return payload;
844
+ }
845
+
846
+ export const contentsCreateCommand = {
847
+ name: 'contents create',
848
+ summary: '新建内容(默认草稿;状态给 published 就立刻在前台可见)',
849
+ usage: 'wkgeo contents create --category <栏目> --title <标题> [--body …|--body-file 文件] [--status draft|published]',
850
+ flags: {
851
+ title: { type: 'string', required: true, desc: '标题(≤200 字)' },
852
+ category: { type: 'string', required: true, desc: '所属栏目(ID / slug / path / 栏目名)' },
853
+ ...CONTENT_FIELD_FLAGS,
854
+ ...SITE_FLAG,
855
+ },
856
+ examples: [
857
+ 'wkgeo contents create --category 新闻 --title "公司参展 2026" --status published --body "<p>正文…</p>"',
858
+ 'wkgeo contents create --category /news/ --title 新品发布 --body-file ./article.html --cover <素材ID>',
859
+ 'wkgeo contents create --category 产品 --title X1 --ext \'{"型号":"X1","价格":"999"}\' --json',
860
+ ],
861
+ notes: [
862
+ '「单页」栏目(含它下面的子栏目)**不能新建内容** —— 那是栏目自带的一页,只能 `contents update` 改。',
863
+ '前台是服务端按需渲染:`--status published` 保存即上线,不需要额外的发布步骤(见 `wkgeo publish`)。',
864
+ ],
865
+ async run(ctx) {
866
+ const { out, flags } = ctx;
867
+ const site = ctx.cmsSite();
868
+ const category = await resolveCategory(ctx, flags.category);
869
+ const payload = buildContentPayload(ctx, {
870
+ title: String(flags.title),
871
+ category_id: String(category.id),
872
+ });
873
+ const one = await ctx.contentCall('contentSave', payload);
874
+ const data = { site_id: siteIdOf(site), content: one };
875
+ if (!out.json) {
876
+ out.ok(`内容已保存:${(one && one.title) || payload.title}`);
877
+ out.line(` 内容 ID:${(one && one.id) || '-'}`);
878
+ out.line(` 栏目:${category.name || category.path || category.id}`);
879
+ out.line(` 状态:${CONTENT_STATUS_LABEL[(one && one.status) || payload.status] || (one && one.status) || payload.status || 'draft'}`);
880
+ if ((one && one.status) === 'published') out.info(' 已发布:前台(服务端按需渲染)已经能打开这一页。');
881
+ }
882
+ ctx.done(data);
883
+ return data;
884
+ },
885
+ };
886
+
887
+ export const contentsUpdateCommand = {
888
+ name: 'contents update',
889
+ summary: '修改内容(只改给了的字段,其余保持原样)',
890
+ usage: 'wkgeo contents update <内容ID> [--title …] [--status …] [--body …] [其他字段…]',
891
+ args: [{ name: 'id', required: true, desc: '内容 ID(uuid)' }],
892
+ flags: {
893
+ title: { type: 'string', desc: '新标题(≤200 字)' },
894
+ category: { type: 'string', desc: '换栏目(单页那一页不能搬家,服务端会按归属栏目写)' },
895
+ ...CONTENT_FIELD_FLAGS,
896
+ ...SITE_FLAG,
897
+ },
898
+ examples: [
899
+ 'wkgeo contents update 8f3c1a2e-… --status published',
900
+ 'wkgeo contents update 8f3c1a2e-… --title "新标题" --body-file ./v2.html',
901
+ ],
902
+ notes: ['服务端口径是"没传的字段保持原样";要清空某字段请显式传空串(如 --description "")。'],
903
+ async run(ctx) {
904
+ const { out, flags } = ctx;
905
+ const site = ctx.cmsSite();
906
+ const id = String(ctx.positional.id || '').trim();
907
+ if (!looksLikeUuid(id)) {
908
+ throw new UsageError(`内容 ID 应该是 uuid,收到:${id}\n先 'wkgeo contents list' 找到它`);
909
+ }
910
+ const base = { id };
911
+ if (flags.title !== undefined) base.title = String(flags.title);
912
+ if (flags.category !== undefined) base.category_id = String((await resolveCategory(ctx, flags.category)).id);
913
+ const payload = buildContentPayload(ctx, base);
914
+
915
+ if (Object.keys(payload).length <= 1) {
916
+ throw new UsageError('没有要改的字段:至少给一个(--title / --status / --body / --description / --ext …)');
917
+ }
918
+
919
+ const one = await ctx.contentCall('contentSave', payload);
920
+ const data = {
921
+ site_id: siteIdOf(site),
922
+ content_id: id,
923
+ changed: Object.keys(payload).filter((k) => k !== 'id'),
924
+ content: one,
925
+ };
926
+ if (!out.json) {
927
+ out.ok(`内容已更新:${(one && one.title) || id}(${data.changed.join(', ')})`);
928
+ out.line(` 状态:${CONTENT_STATUS_LABEL[(one && one.status) || ''] || (one && one.status) || '-'}`);
929
+ }
930
+ ctx.done(data);
931
+ return data;
932
+ },
933
+ };
934
+
935
+ /**
936
+ * `contents save` —— create / update 的二合一(task-73 起的对外推荐写法)。
937
+ *
938
+ * 与 `categories save` 同一口径:**给了内容 ID 就是改,没给就是新建**。
939
+ * 新建时 `--title` 与 `--category` 都是硬要求(服务端 contentSave 缺它们必 400),
940
+ * 所以「必填」不能写在 flag 声明上(那样修改时也被迫带),只能在这里判。
941
+ */
942
+ export const contentsSaveCommand = {
943
+ name: 'contents save',
944
+ summary: '保存内容:给了 <内容ID> 就改,没给就新建(create / update 二合一)',
945
+ usage: 'wkgeo contents save [内容ID] [--category <栏目>] [--title <标题>] [--body …] [--status …]',
946
+ args: [{ name: 'id', required: false, desc: '内容 ID(给了就改,不给就新建)' }],
947
+ flags: {
948
+ title: { type: 'string', desc: '标题(新建必填,≤200 字)' },
949
+ category: { type: 'string', desc: '所属栏目(新建必填;ID / slug / path / 栏目名)' },
950
+ ...CONTENT_FIELD_FLAGS,
951
+ ...SITE_FLAG,
952
+ },
953
+ examples: [
954
+ 'wkgeo contents save --category 新闻 --title "公司参展 2026" --status published',
955
+ 'wkgeo contents save 8f3c1a2e-… --status published # 改已有内容',
956
+ 'wkgeo contents save --category /news/ --title 新品 --body-file ./a.html',
957
+ ],
958
+ notes: [
959
+ '判断口径:**有没有给内容 ID**。给了 = 修改(只改给了的字段),没给 = 新建(--title 与 --category 必填)。',
960
+ '「单页」栏目不能新建内容(只能 `contents save <那页的ID> …` 改);等价命令仍在:`contents create` / `contents update`。',
961
+ ],
962
+ async run(ctx) {
963
+ const id = String(ctx.positional.id || '').trim();
964
+ if (!id) {
965
+ const missing = [];
966
+ if (!ctx.flags.title) missing.push('--title');
967
+ if (!ctx.flags.category) missing.push('--category');
968
+ if (missing.length) {
969
+ throw new UsageError(
970
+ `没给内容 ID 就是新建,新建必须带 ${missing.join(' 和 ')}(如 \`wkgeo contents save --category 新闻 --title 标题\`);要改已有内容请把内容 ID 放在命令后面。`,
971
+ );
972
+ }
973
+ return contentsCreateCommand.run(ctx);
974
+ }
975
+ if (!looksLikeUuid(id)) {
976
+ throw new UsageError(`内容 ID 应该是 uuid,收到:${id}\n先 'wkgeo contents list' 找到它`);
977
+ }
978
+ const prev = ctx.positional;
979
+ ctx.positional = { ...(prev || {}), id };
980
+ try {
981
+ return await contentsUpdateCommand.run(ctx);
982
+ } finally {
983
+ ctx.positional = prev;
984
+ }
985
+ },
986
+ };
987
+
988
+ export const contentsDeleteCommand = {
989
+ name: 'contents delete',
990
+ summary: '删除内容(「单页」那一页删不掉 —— 要去栏目管理删栏目)',
991
+ usage: 'wkgeo contents delete <内容ID> [--site <站点ID>]',
992
+ args: [{ name: 'id', required: true, desc: '内容 ID(uuid)' }],
993
+ flags: { ...SITE_FLAG },
994
+ examples: ['wkgeo contents delete 8f3c1a2e-…', 'wkgeo contents delete 8f3c1a2e-… --json'],
995
+ async run(ctx) {
996
+ const { out } = ctx;
997
+ const site = ctx.cmsSite();
998
+ const id = String(ctx.positional.id || '').trim();
999
+ if (!looksLikeUuid(id)) throw new UsageError(`内容 ID 应该是 uuid,收到:${id}`);
1000
+ const res = await ctx.contentCall('contentDelete', { id });
1001
+ const data = { site_id: siteIdOf(site), id, deleted: !!(res && res.deleted) };
1002
+ if (!out.json) out.ok(`内容已删除:${id}`);
1003
+ ctx.done(data);
1004
+ return data;
1005
+ },
1006
+ };
1007
+
1008
+ /* ------------------------------------------------------------------ 素材 */
1009
+
1010
+ export const assetsListCommand = {
1011
+ name: 'assets list',
1012
+ summary: '素材列表(默认只列图片;可看回收站)',
1013
+ usage: 'wkgeo assets list [--kind 图片|视频|文档|PDF|压缩包|""] [--keyword 词] [--status normal|deleted] [--page 1] [--page-size 60]',
1014
+ flags: {
1015
+ kind: { type: 'string', desc: '类型:图片(默认)/ 视频 / 文档 / PDF / 压缩包;给空串 "" = 全部类型' },
1016
+ keyword: { type: 'string', desc: '按名称 / 文件路径搜' },
1017
+ status: { type: 'string', desc: 'normal 在用(默认)/ deleted 回收站' },
1018
+ sort: { type: 'string', desc: '排序:date_desc(默认)/ date_asc / size_desc / size_asc / name_asc / name_desc' },
1019
+ page: { type: 'string', desc: '页码(默认 1)' },
1020
+ 'page-size': { type: 'string', desc: '每页条数(默认 60,最多 200)' },
1021
+ ...SITE_FLAG,
1022
+ },
1023
+ examples: [
1024
+ 'wkgeo assets list',
1025
+ 'wkgeo assets list --kind 视频 --keyword 宣传',
1026
+ 'wkgeo assets list --status deleted',
1027
+ 'wkgeo assets list --kind "" --page-size 200 --json',
1028
+ ],
1029
+ async run(ctx) {
1030
+ const { out, flags } = ctx;
1031
+ const site = ctx.cmsSite();
1032
+ const payload = {};
1033
+ if (flags.kind !== undefined) payload.kind = String(flags.kind);
1034
+ if (flags.keyword !== undefined) payload.keyword = String(flags.keyword);
1035
+ if (flags.status !== undefined) payload.status = String(flags.status);
1036
+ if (flags.sort !== undefined) payload.sort = String(flags.sort);
1037
+ if (flags.page !== undefined) payload.page = Number(flags.page);
1038
+ if (flags.pageSize !== undefined) payload.pageSize = Number(flags.pageSize);
1039
+
1040
+ const res = await ctx.contentCall('assetList', payload);
1041
+ const rows = (res && Array.isArray(res.rows) ? res.rows : []).map((r) => r || {});
1042
+ const data = {
1043
+ site_id: siteIdOf(site),
1044
+ rows,
1045
+ total: (res && res.total) || rows.length,
1046
+ page: (res && res.page) || payload.page || 1,
1047
+ page_size: (res && res.pageSize) || payload.pageSize || 60,
1048
+ asset_host: (res && res.assetHost) || '',
1049
+ kind_counts: (res && res.kindCounts) || [],
1050
+ trash_count: res && res.trashCount !== undefined ? res.trashCount : null,
1051
+ };
1052
+
1053
+ if (!out.json) {
1054
+ out.head(`素材列表(共 ${data.total} 条 · 第 ${data.page} 页 ${rows.length} 条 · 站点 ${siteText(site)})`);
1055
+ out.table(
1056
+ [
1057
+ { title: '名称', key: 'name', width: 28 },
1058
+ { title: '类型', key: 'kind', width: 8 },
1059
+ { title: '大小', key: 'size', width: 10, format: (v) => formatBytes(v) },
1060
+ { title: '尺寸', key: 'width', width: 12, format: (v, row) => (row.width && row.height ? `${row.width}×${row.height}` : '-') },
1061
+ { title: '身份ID', key: 'slug', width: 12 },
1062
+ { title: '上传时间', key: 'created_at', format: (v) => formatTime(v), width: 20 },
1063
+ { title: '素材 ID', key: 'id', width: 38 },
1064
+ ],
1065
+ rows,
1066
+ );
1067
+ if (data.trash_count) out.info(` 回收站里还有 ${data.trash_count} 个(--status deleted 查看)。`);
1068
+ if (data.total > data.page * data.page_size) out.info(` 下一页:--page ${data.page + 1}`);
1069
+ }
1070
+ ctx.done(data);
1071
+ return data;
1072
+ },
1073
+ };
1074
+
1075
+ /** 服务端单文件上限(见 `aliyun/fc/wkgeo-cms/src` 的 allowedExtensions 表:最大 200MB 的视频/压缩包) */
1076
+ const MAX_UPLOAD_BYTES = 200 * 1024 * 1024;
1077
+
1078
+ export const assetsUploadCommand = {
1079
+ name: 'assets upload',
1080
+ summary: '上传素材(签名 → 直传 OSS → 登记;CLI 不碰 AK,二进制不进云函数)',
1081
+ usage: 'wkgeo assets upload <本地文件> [--name 显示名] [--site <站点ID>]',
1082
+ args: [{ name: 'file', required: true, desc: '本地文件路径(图片 / 视频 / 文档 / PDF / 压缩包)' }],
1083
+ flags: {
1084
+ name: { type: 'string', desc: '素材显示名(默认取文件名)' },
1085
+ ...SITE_FLAG,
1086
+ },
1087
+ examples: [
1088
+ 'wkgeo assets upload ./logo.png',
1089
+ 'wkgeo assets upload "D:\\图\\展会.jpg" --name 展会现场',
1090
+ 'wkgeo assets upload ./brochure.pdf --json # 拿 id 去挂内容:contents update <id> --attachments <素材ID>',
1091
+ ],
1092
+ notes: [
1093
+ '三步走:`assetSign` 取票据(锁 key/大小,10 分钟)→ 用票据把文件 POST 到 OSS → `assetRegister` 落库并回读校验。',
1094
+ 'CLI 只做搬运:既不保存也不打印 OSS 的 AccessKey(AK 只在云函数里)。',
1095
+ '支持的扩展名与上限由服务端决定(图片 10MB / PDF 50MB / 视频 200MB …)。',
1096
+ ],
1097
+ async run(ctx) {
1098
+ const { out, flags } = ctx;
1099
+ const site = ctx.cmsSite();
1100
+ const filePath = path.resolve(String(ctx.positional.file || ''));
1101
+ let stat;
1102
+ try {
1103
+ stat = fs.statSync(filePath);
1104
+ } catch (e) {
1105
+ throw new CliError(`读不到文件:${filePath}`, {
1106
+ kind: 'io',
1107
+ hint: `检查路径是否正确(${(e && e.code) || (e && e.message) || '未知原因'})`,
1108
+ });
1109
+ }
1110
+ if (!stat.isFile()) throw new UsageError(`不是普通文件:${filePath}`);
1111
+ if (stat.size <= 0) throw new UsageError(`文件是空的:${filePath}`);
1112
+ if (stat.size > MAX_UPLOAD_BYTES) {
1113
+ throw new UsageError(`文件 ${formatBytes(stat.size)} 超过服务端单文件上限 ${formatBytes(MAX_UPLOAD_BYTES)}`);
1114
+ }
1115
+
1116
+ const fileName = path.basename(filePath);
1117
+ const displayName = String(flags.name || fileName).trim() || fileName;
1118
+
1119
+ /** ① 取直传票据(fileName 决定 kind / mime,bytes 让服务端提前挡掉超限) */
1120
+ const ticket = await ctx.contentCall('assetSign', { fileName, bytes: stat.size });
1121
+ if (!ticket || !ticket.key || !ticket.uploadUrl) {
1122
+ throw new CliError('服务端没有返回直传票据(assetSign)', {
1123
+ kind: 'bad_response',
1124
+ hint: '检查 CLI 函数的素材库配置(OSS_ACCESS_KEY_ID / OSS_ACCESS_KEY_SECRET / 平台桶与地域)',
1125
+ });
1126
+ }
1127
+
1128
+ /** ② 直传 OSS(CLI 只拿票据,不持 AK) */
1129
+ const buffer = fs.readFileSync(filePath);
1130
+ await uploadToOss({ ticket, buffer, fileName, fetchImpl: ctx.fetchImpl });
1131
+
1132
+ /** ③ 登记落库(服务端会回读一次 OSS,确认文件真的在) */
1133
+ const asset = await ctx.contentCall('assetRegister', { key: ticket.key, name: displayName });
1134
+ const data = {
1135
+ site_id: siteIdOf(site),
1136
+ asset,
1137
+ key: ticket.key,
1138
+ url: (asset && asset.url) || ticket.url || '',
1139
+ };
1140
+
1141
+ if (!out.json) {
1142
+ out.ok(`素材已上传:${(asset && asset.name) || displayName}`);
1143
+ out.line(` 素材 ID:${(asset && asset.id) || '-'}`);
1144
+ out.line(` 类型:${(asset && asset.kind) || ticket.kind || '-'}(${formatBytes(stat.size)})`);
1145
+ out.line(` 地址:${data.url || '-'}`);
1146
+ out.info(` 引用它:\`wkgeo contents update <内容ID> --cover ${(asset && asset.id) || '<素材ID>'}\``);
1147
+ }
1148
+ ctx.done(data);
1149
+ return data;
1150
+ },
1151
+ };
1152
+
1153
+ /* -------------------------------------------------------------- 素材(task-66) */
1154
+
1155
+ /**
1156
+ * 素材 ID 一律 uuid(服务端也挡,本地先挡省一次往返,且报错更像人话)。
1157
+ * @param {unknown} raw
1158
+ * @returns {string}
1159
+ */
1160
+ function requireAssetId(raw) {
1161
+ const id = String(raw === undefined || raw === null ? '' : raw).trim();
1162
+ if (!id) throw new UsageError('缺少素材 ID:`wkgeo assets list` 最后一列 / `--json` 里的 id');
1163
+ if (!looksLikeUuid(id)) throw new UsageError(`素材 ID 应该是 uuid,收到:${id}`);
1164
+ return id;
1165
+ }
1166
+
1167
+ /** 通用的「票据 -> 数据」形状校验(assetSign 三条命令共用一个报错口径) */
1168
+ function requireTicket(ticket) {
1169
+ if (!ticket || !ticket.key || !ticket.uploadUrl) {
1170
+ throw new CliError('服务端没有返回直传票据(assetSign)', {
1171
+ kind: 'bad_response',
1172
+ hint: '检查 CLI 函数的素材库配置(OSS_ACCESS_KEY_ID / OSS_ACCESS_KEY_SECRET / 平台桶与地域)',
1173
+ });
1174
+ }
1175
+ return ticket;
1176
+ }
1177
+
1178
+ /**
1179
+ * 单文件上限的显示口径:票据里的 `maxBytes` 只在新版服务端才有,
1180
+ * 老回包没有这个字段 —— 别打成「上限 0 B」,退回按扩展名说明。
1181
+ */
1182
+ function uploadLimitText(ticket) {
1183
+ const max = Number(ticket && ticket.maxBytes);
1184
+ if (Number.isFinite(max) && max > 0) return `单文件上限 ${formatBytes(max)}`;
1185
+ return '上限按扩展名(图片 10MB / PDF 50MB / 视频 200MB)';
1186
+ }
1187
+
1188
+ export const assetsSignCommand = {
1189
+ name: 'assets sign',
1190
+ summary: '只取直传票据(不上传、不登记)—— 给 agent / 脚本自己 POST 文件用',
1191
+ usage: 'wkgeo assets sign <文件名> [--bytes 字节数] [--overwrite <已有 key>] [--site <站点ID>]',
1192
+ args: [{ name: 'file', required: true, desc: '文件名(只用来定类型/扩展名,不必是本地真实文件)' }],
1193
+ flags: {
1194
+ bytes: { type: 'string', desc: '文件字节数(服务端据此卡单文件上限;默认 1)' },
1195
+ overwrite: { type: 'string', desc: '覆盖已有文件:传它的 key(服务端要求该 key 属于本站,否则 403)' },
1196
+ ...SITE_FLAG,
1197
+ },
1198
+ examples: [
1199
+ 'wkgeo assets sign logo.png --bytes 20480 --json',
1200
+ 'wkgeo assets sign "展会.jpg" --bytes 3000000',
1201
+ ],
1202
+ notes: [
1203
+ '票据锁三件事:key(`<站点ID>/upload/…`)、大小上界、10 分钟过期。',
1204
+ 'CLI 不持 AK:`OSSAccessKeyId` / `signature` / `policy` 都是服务端用函数账号签的,10 分钟后作废。',
1205
+ '传完用 `wkgeo assets register --key <key> --name 显示名` 登记;懒得两步就用 `wkgeo assets upload <文件>`。',
1206
+ ],
1207
+ async run(ctx) {
1208
+ const { out, flags } = ctx;
1209
+ const site = ctx.cmsSite();
1210
+ const fileName = path.basename(String(ctx.positional.file || '').trim());
1211
+ if (!fileName) throw new UsageError('缺少文件名:`wkgeo assets sign logo.png --bytes 20480`');
1212
+ const bytes = flags.bytes === undefined ? 1 : Number(flags.bytes);
1213
+ if (!Number.isFinite(bytes) || bytes <= 0) throw new UsageError(`--bytes 要是正整数(字节),收到:${flags.bytes}`);
1214
+ const payload = { fileName, bytes };
1215
+ if (flags.overwrite !== undefined) payload.overwriteKey = String(flags.overwrite);
1216
+
1217
+ const ticket = requireTicket(await ctx.contentCall('assetSign', payload));
1218
+ const data = { site_id: siteIdOf(site), ...ticket };
1219
+
1220
+ if (!out.json) {
1221
+ out.head(`直传票据(站点 ${siteText(site)})`);
1222
+ out.line(` key:${ticket.key}`);
1223
+ out.line(` 上传地址:${ticket.uploadUrl}`);
1224
+ out.line(` 类型:${ticket.kind || '-'} / ${ticket.mime || '-'}(${uploadLimitText(ticket)})`);
1225
+ out.line(` 过期:${formatTime(ticket.expireAt)}`);
1226
+ out.line(' 表单字段(multipart/form-data;file 必须放最后一项):');
1227
+ for (const [k, v] of Object.entries(ticket.fields || {})) out.line(` ${k} = ${v}`);
1228
+ out.info(' 传完就登记:`wkgeo assets register --key <key> --name 显示名`');
1229
+ }
1230
+ ctx.done(data);
1231
+ return data;
1232
+ },
1233
+ };
1234
+
1235
+ export const assetsRegisterCommand = {
1236
+ name: 'assets register',
1237
+ summary: '把已直传的 key 登记成素材(服务端会回读一次,确认文件真的在)',
1238
+ usage: 'wkgeo assets register --key <key> [--name 显示名] [--source-id <来源素材ID>] [--site <站点ID>]',
1239
+ flags: {
1240
+ key: { type: 'string', desc: '直传后的对象 key(`wkgeo assets sign` 回的 key)' },
1241
+ name: { type: 'string', desc: '素材显示名(默认取 key 的文件名)' },
1242
+ 'source-id': { type: 'string', desc: '裁切/水印产物的来源素材 ID(必须是本站素材)' },
1243
+ ...SITE_FLAG,
1244
+ },
1245
+ examples: [
1246
+ 'wkgeo assets register --key 3f2a…/upload/logo-9a1b2c3d.png --name Logo',
1247
+ 'wkgeo assets register --key <key> --name 水印图 --source-id <素材ID> --json',
1248
+ ],
1249
+ notes: [
1250
+ '服务端先按 key 形态校验(必须 `<站点ID>/upload/…`),再 HEAD 回读;读不回来回 502 —— 说明文件没真上去。',
1251
+ '同一 key 重复登记不会插两条:先查后写(有就更新 size/mime/updated_at)。',
1252
+ ],
1253
+ async run(ctx) {
1254
+ const { out, flags } = ctx;
1255
+ const site = ctx.cmsSite();
1256
+ const key = String(flags.key || '').trim();
1257
+ if (!key) throw new UsageError('缺少 --key:`wkgeo assets register --key <key> --name 显示名`');
1258
+ const payload = { key };
1259
+ if (flags.name !== undefined) payload.name = String(flags.name);
1260
+ if (flags.sourceId !== undefined) payload.sourceId = String(flags.sourceId);
1261
+
1262
+ const asset = await ctx.contentCall('assetRegister', payload);
1263
+ const data = { site_id: siteIdOf(site), asset };
1264
+ if (!out.json) {
1265
+ out.ok(`素材已登记:${(asset && asset.name) || payload.name || key}`);
1266
+ out.line(` 素材 ID:${(asset && asset.id) || '-'}`);
1267
+ out.line(` 地址:${(asset && asset.url) || '-'}`);
1268
+ }
1269
+ ctx.done(data);
1270
+ return data;
1271
+ },
1272
+ };
1273
+
1274
+ export const assetsDeleteCommand = {
1275
+ name: 'assets delete',
1276
+ summary: '删除素材(默认进回收站;`--purge --confirm` 才是彻底删除)',
1277
+ usage: 'wkgeo assets delete <素材ID> [--purge --confirm] [--site <站点ID>]',
1278
+ args: [{ name: 'id', required: true, desc: '素材 ID(uuid)' }],
1279
+ flags: {
1280
+ purge: { type: 'boolean', desc: '彻底删除(只能删回收站里的;会连对象一起删)' },
1281
+ confirm: { type: 'boolean', desc: '配合 --purge:确认真的彻底删除(不加就只打印计划)' },
1282
+ ...SITE_FLAG,
1283
+ },
1284
+ examples: [
1285
+ 'wkgeo assets delete 8f14e45f-ceea-467f-a1b0-1d2c3b4a5e6f',
1286
+ 'wkgeo assets delete <素材ID> --purge # 只打印计划,不发请求',
1287
+ 'wkgeo assets delete <素材ID> --purge --confirm # 真删(含 OSS 对象)',
1288
+ ],
1289
+ notes: [
1290
+ '普通删除只把状态改成「已删除」,文件留在桶里 ⇒ 随时能 `wkgeo assets restore` 回来。',
1291
+ '被内容/公司信息引用的素材**服务端硬禁止删除**(连强删口子都没有):先去引用处换图。',
1292
+ '彻底删除只清「回收站里」的行;key 在共享目录(`public/` 等)时只清数据库行、不动公共原图。',
1293
+ ],
1294
+ async run(ctx) {
1295
+ const { out, flags } = ctx;
1296
+ const site = ctx.cmsSite();
1297
+ const id = requireAssetId(ctx.positional.id);
1298
+
1299
+ if (!flags.purge) {
1300
+ const res = await ctx.contentCall('assetDelete', { id });
1301
+ const data = { site_id: siteIdOf(site), id, deleted: true, purge: false, name: (res && res.name) || '' };
1302
+ if (!out.json) {
1303
+ out.ok(`素材已删除(进回收站):${data.name || id}`);
1304
+ out.info(` 恢复:\`wkgeo assets restore ${id}\`;彻底删除:\`wkgeo assets delete ${id} --purge --confirm\``);
1305
+ }
1306
+ ctx.done(data);
1307
+ return data;
1308
+ }
1309
+
1310
+ if (!flags.confirm) {
1311
+ const data = { site_id: siteIdOf(site), id, purge: true, confirmed: false };
1312
+ if (!out.json) {
1313
+ out.head('彻底删除计划(未发请求)');
1314
+ out.line(` 素材:${id}`);
1315
+ out.line(' 会做:删 OSS 对象(本站 `upload/` 前缀)+ 删数据库行');
1316
+ out.info(' 确认无误就加 `--confirm` 真删。');
1317
+ }
1318
+ ctx.done(data);
1319
+ return data;
1320
+ }
1321
+
1322
+ const res = await ctx.contentCall('assetPurge', { id });
1323
+ const data = {
1324
+ site_id: siteIdOf(site),
1325
+ id,
1326
+ purge: true,
1327
+ confirmed: true,
1328
+ name: (res && res.name) || '',
1329
+ storage: (res && res.storage) || '',
1330
+ objects_deleted: (res && res.objectsDeleted) || 0,
1331
+ objects_skipped: (res && res.objectsSkipped) || [],
1332
+ };
1333
+ if (!out.json) {
1334
+ out.ok(`素材已彻底删除:${data.name || id}`);
1335
+ out.line(` 对象:删了 ${data.objects_deleted} 个(storage=${data.storage || '-'})`);
1336
+ if (data.objects_skipped.length) out.info(` 跳过 ${data.objects_skipped.length} 个对象(共享目录/非本站前缀,只清了数据库行)`);
1337
+ }
1338
+ ctx.done(data);
1339
+ return data;
1340
+ },
1341
+ };
1342
+
1343
+ export const assetsRestoreCommand = {
1344
+ name: 'assets restore',
1345
+ summary: '从回收站恢复素材(文件已被彻底删掉的会明确拒绝)',
1346
+ usage: 'wkgeo assets restore <素材ID> [--site <站点ID>]',
1347
+ args: [{ name: 'id', required: true, desc: '回收站里的素材 ID(uuid)' }],
1348
+ flags: { ...SITE_FLAG },
1349
+ examples: ['wkgeo assets restore 8f14e45f-ceea-467f-a1b0-1d2c3b4a5e6f'],
1350
+ notes: [
1351
+ '服务端恢复前会 HEAD 一次对象:文件不在就回 400「实体已经删掉了,恢复不回来」。',
1352
+ '恢复时若这条素材没有身份ID,服务端会自动补一个(`a` + 序号)。',
1353
+ ],
1354
+ async run(ctx) {
1355
+ const { out } = ctx;
1356
+ const site = ctx.cmsSite();
1357
+ const id = requireAssetId(ctx.positional.id);
1358
+ const res = await ctx.contentCall('assetRestore', { id });
1359
+ const data = { site_id: siteIdOf(site), id, restored: true, asset: res || null };
1360
+ if (!out.json) {
1361
+ out.ok(`素材已恢复:${(res && res.name) || id}`);
1362
+ if (res && res.slug) out.line(` 身份ID:${res.slug}`);
1363
+ }
1364
+ ctx.done(data);
1365
+ return data;
1366
+ },
1367
+ };
1368
+
1369
+ /* ------------------------------------------------------------------ 模板 */
1370
+ /** 取默认模板(含全部文件源码)—— `templateGet` 不传 templateId 就是默认模板 */
1371
+ async function fetchDefaultTemplate(ctx) {
1372
+ return ctx.cmsCall('templateGet', {});
1373
+ }
1374
+
1375
+ export const templatesListCommand = {
1376
+ name: 'templates list',
1377
+ summary: '模板列表(默认模板 + 每个 html 的字符数)',
1378
+ usage: 'wkgeo templates list [--site <站点ID>]',
1379
+ flags: { ...SITE_FLAG },
1380
+ examples: ['wkgeo templates list', 'wkgeo templates list --json'],
1381
+ notes: [
1382
+ '一个站的模板就是一套 html(index.html / about.html / content.html…),第一次调用时服务端会自动 seed 一套,所以不会"没有模板"。',
1383
+ '要看源码用 `wkgeo templates get <文件名>`;要改/新建用 `wkgeo templates save <文件名> --file <本地文件>`。',
1384
+ ],
1385
+ async run(ctx) {
1386
+ const { out } = ctx;
1387
+ const site = ctx.cmsSite();
1388
+ const res = (await ctx.cmsCall('templateList')) || {};
1389
+ const templates = Array.isArray(res.templates) ? res.templates : [];
1390
+ const files = Array.isArray(res.files) ? res.files : [];
1391
+ const data = {
1392
+ site_id: siteIdOf(site),
1393
+ template_id: res.templateId || null,
1394
+ templates,
1395
+ files: files.map((f) => ({ id: f.id, path: f.path, chars: String(f.content || '').length, updated_at: f.updatedAt || null })),
1396
+ auto_files: res.autoFiles || {},
1397
+ };
1398
+
1399
+ if (!out.json) {
1400
+ out.head(`模板(站点 ${siteText(site)})`);
1401
+ out.line(` 默认模板:${(templates.find((t) => t.isDefault) || templates[0] || {}).name || '-'}(id ${data.template_id || '-'})`);
1402
+ out.table(
1403
+ [
1404
+ { title: '模板文件', key: 'path', width: 24 },
1405
+ { title: '字符数', key: 'chars', width: 10 },
1406
+ { title: '更新时间', key: 'updated_at', format: (v) => formatTime(v), width: 20 },
1407
+ { title: '文件 ID', key: 'id', width: 38 },
1408
+ ],
1409
+ data.files,
1410
+ );
1411
+ const auto = Object.entries(data.auto_files || {});
1412
+ if (auto.length) {
1413
+ out.info(` 自动档(栏目没绑模板时按类型选):${auto.map(([k, v]) => `${CATEGORY_KIND_LABEL[k] || k}→${v}`).join('、')}`);
1414
+ }
1415
+ }
1416
+ ctx.done(data);
1417
+ return data;
1418
+ },
1419
+ };
1420
+
1421
+ export const templatesGetCommand = {
1422
+ name: 'templates get',
1423
+ summary: '看模板文件源码(不给文件名 = 只列文件清单)',
1424
+ usage: 'wkgeo templates get [模板文件名] [--site <站点ID>]',
1425
+ args: [{ name: 'path', required: false, desc: '模板文件名,如 index.html;不给就只列清单' }],
1426
+ flags: { ...SITE_FLAG },
1427
+ examples: [
1428
+ 'wkgeo templates get',
1429
+ 'wkgeo templates get index.html',
1430
+ 'wkgeo templates get about.html > about.html',
1431
+ ],
1432
+ notes: [
1433
+ '给了文件名时,**人类可读模式输出的是源码原文**(可以直接 `> 文件` 存下来),不受"非终端自动 JSON"影响;',
1434
+ '`--json` 下仍然是一个标准信封(`data.content` 里是源码)。模板语法见 docs/功能-模板.md。',
1435
+ ],
1436
+ async run(ctx) {
1437
+ const { out } = ctx;
1438
+ const site = ctx.cmsSite();
1439
+ const wanted = String(ctx.positional.path || '').trim();
1440
+ const tpl = (await fetchDefaultTemplate(ctx)) || {};
1441
+ const files = Array.isArray(tpl.files) ? tpl.files : [];
1442
+
1443
+ if (!wanted) {
1444
+ const data = {
1445
+ site_id: siteIdOf(site),
1446
+ template: { id: tpl.id || null, name: tpl.name || '', is_default: !!tpl.isDefault },
1447
+ files: files.map((f) => ({ id: f.id, path: f.path, chars: String(f.content || '').length, updated_at: f.updatedAt || null })),
1448
+ };
1449
+ if (!out.json) {
1450
+ out.head(`模板文件(${data.template.name || '默认模板'} · 站点 ${siteText(site)})`);
1451
+ out.table(
1452
+ [
1453
+ { title: '模板文件', key: 'path', width: 24 },
1454
+ { title: '字符数', key: 'chars', width: 10 },
1455
+ { title: '更新时间', key: 'updated_at', format: (v) => formatTime(v), width: 20 },
1456
+ ],
1457
+ data.files,
1458
+ );
1459
+ out.info(' 看源码:`wkgeo templates get <文件名>`');
1460
+ }
1461
+ ctx.done(data);
1462
+ return data;
1463
+ }
1464
+
1465
+ const hit = files.find((f) => String(f.path || '') === wanted);
1466
+ if (!hit) {
1467
+ throw new CliError(`模板里没有「${wanted}」`, {
1468
+ kind: 'not_found',
1469
+ code: 404,
1470
+ hint: files.length
1471
+ ? `现有模板文件:${files.map((f) => f.path).join(' / ')}(新建用 \`wkgeo templates save ${wanted} --file <本地文件>\`)`
1472
+ : '这个站还没有任何模板文件(先跑 `wkgeo templates list` 触发服务端 seed 默认模板)',
1473
+ });
1474
+ }
1475
+
1476
+ const data = {
1477
+ site_id: siteIdOf(site),
1478
+ template: { id: tpl.id || null, name: tpl.name || '', is_default: !!tpl.isDefault },
1479
+ path: hit.path,
1480
+ chars: String(hit.content || '').length,
1481
+ updated_at: hit.updatedAt || null,
1482
+ content: String(hit.content || ''),
1483
+ };
1484
+ if (!out.json) {
1485
+ /** 原文直出(可重定向);不加任何表头,避免污染模板源码 */
1486
+ out.plain(data.content.endsWith('\n') ? data.content : data.content + '\n');
1487
+ } else {
1488
+ ctx.done(data);
1489
+ }
1490
+ return data;
1491
+ },
1492
+ };
1493
+
1494
+ /** 服务端上限:`templateMaxBytes = 400 * 1024`(按**字符**算) */
1495
+ const TEMPLATE_MAX_CHARS = 400 * 1024;
1496
+
1497
+ export const templatesSaveCommand = {
1498
+ name: 'templates save',
1499
+ summary: '新建 / 覆盖一个模板 html(≤40 万字符,写操作会记系统日志)',
1500
+ usage: 'wkgeo templates save <模板文件名.html> (--file <本地文件> | --content <源码>) [--site <站点ID>]',
1501
+ args: [{ name: 'path', required: true, desc: '模板文件名,如 index.html(字母/数字/中划线/下划线 + .html)' }],
1502
+ flags: {
1503
+ file: { type: 'string', desc: '从本地文件读源码' },
1504
+ content: { type: 'string', desc: '直接给源码(与 --file 二选一;适合短模板)' },
1505
+ ...SITE_FLAG,
1506
+ },
1507
+ examples: [
1508
+ 'wkgeo templates save index.html --file ./index.html',
1509
+ 'wkgeo templates save about.html --content "<!doctype html><h1>{{ category.name }}</h1>"',
1510
+ ],
1511
+ notes: [
1512
+ '同名文件直接覆盖(服务端 `on conflict do update`);改坏了用 `wkgeo templates get <文件名>` 先取回旧源码备份。',
1513
+ '模板语法与可用变量见 docs/功能-模板.md(`{{ category.name }}` / `{{#each contents}}` 等)。',
1514
+ ],
1515
+ async run(ctx) {
1516
+ const { out, flags } = ctx;
1517
+ const site = ctx.cmsSite();
1518
+ const filePath = String(ctx.positional.path || '').trim();
1519
+ if (!/^[A-Za-z0-9_-]+\.html$/.test(filePath)) {
1520
+ throw new UsageError(
1521
+ `模板文件名不合法:${filePath || '(空)'}\n只允许 字母/数字/中划线/下划线 + .html,例如 index.html / news-list.html`,
1522
+ );
1523
+ }
1524
+ const hasFile = flags.file !== undefined;
1525
+ const hasContent = flags.content !== undefined;
1526
+ if (hasFile === hasContent) {
1527
+ throw new UsageError('--file 与 --content 必须且只能给一个\n用法:wkgeo templates save index.html --file ./index.html');
1528
+ }
1529
+ const content = hasFile ? readTextFile('--file', flags.file) : String(flags.content);
1530
+ if (content.length > TEMPLATE_MAX_CHARS) {
1531
+ throw new UsageError(`模板太长了:${content.length} 字符,服务端上限 ${TEMPLATE_MAX_CHARS} 字符`);
1532
+ }
1533
+
1534
+ const saved = await ctx.cmsCall('templateFileSave', { path: filePath, content });
1535
+ const data = {
1536
+ site_id: siteIdOf(site),
1537
+ path: (saved && saved.path) || filePath,
1538
+ file_id: (saved && saved.id) || null,
1539
+ chars: content.length,
1540
+ updated_at: (saved && saved.updatedAt) || null,
1541
+ };
1542
+ if (!out.json) {
1543
+ out.ok(`模板已保存:${data.path}(${data.chars} 字符)`);
1544
+ out.line(` 文件 ID:${data.file_id || '-'}`);
1545
+ if (data.updated_at) out.line(` 更新时间:${formatTime(data.updated_at)}`);
1546
+ out.info(` 让栏目用它:\`wkgeo categories bind-template <栏目> ${data.path}\``);
1547
+ }
1548
+ ctx.done(data);
1549
+ return data;
1550
+ },
1551
+ };
1552
+
1553
+ /* ------------------------------------------------------------------ 发布 */
1554
+
1555
+ /**
1556
+ * `publish` —— 真发布(0.5.0 起接后端,不再只"看状态")。
1557
+ *
1558
+ * 后端动作(`wkgeo-cms`):
1559
+ * * `cmsSitePublishStart` `{siteId}` → `{jobId,total,status,alreadyRunning,dispatched}`
1560
+ * * `cmsSitePublishStatus` `{jobId?}` → `{jobId,status,total,done,percent,error,errors[],summary}`
1561
+ * * `cmsSitePublishCancel` `{jobId}` → `{jobId,status,canceled}`
1562
+ *
1563
+ * 三条产品决策:
1564
+ * 1. **默认 dry-run**:不加 `--confirm` 只把"会发多少页面"算给你看,一个写请求都不发;
1565
+ * 2. **站点必须显式**:没有 `--site` 也没有 `site use` 就报 UsageError —— 发布打错站是灾难;
1566
+ * 3. 真发前把**站点名 / 域名 / 将发布页面数**打出来,让用户看得见自己按的是什么。
1567
+ */
1568
+
1569
+ const PUBLISH_TERMINAL = new Set(['success', 'partial', 'failed', 'canceled']);
1570
+
1571
+ const PUBLISH_FLAGS = {
1572
+ confirm: { type: 'boolean', desc: '真发(不加就是 dry-run:只算将发布多少页面,不发写请求)' },
1573
+ cancel: { type: 'boolean', desc: '取消该站正在跑的发布任务' },
1574
+ wait: { type: 'boolean', desc: '提交后等它跑完(默认等;`--no-wait` 只提交就返回)' },
1575
+ job: { type: 'string', desc: '指定任务 ID(默认用该站最新任务)' },
1576
+ interval: { type: 'string', desc: '轮询间隔毫秒(默认 2000)' },
1577
+ 'wait-timeout': { type: 'string', desc: '最多等多少秒(默认 900)' },
1578
+ };
1579
+
1580
+ /** 站点行(只为拿域名;平台接口只读,取不到不影响发布) */
1581
+ async function publishSiteRow(ctx, siteId) {
1582
+ try {
1583
+ const data = await ctx.callData('listSites', { limit: 200 });
1584
+ const rows = Array.isArray(data) ? data : (data && (data.rows || data.list || data.sites)) || [];
1585
+ return rows.find((r) => r && r.id === siteId) || null;
1586
+ } catch {
1587
+ return null;
1588
+ }
1589
+ }
1590
+
1591
+ function publishDomainsOf(row) {
1592
+ if (!row) return [];
1593
+ const list = [];
1594
+ const push = (v) => {
1595
+ const s = String(v || '').trim();
1596
+ if (s && !list.includes(s)) list.push(s);
1597
+ };
1598
+ push(row.domain);
1599
+ push(row.prefix_host);
1600
+ for (const d of row.domains || []) push(typeof d === 'string' ? d : d && (d.domain || d.host || d.name));
1601
+ return list;
1602
+ }
1603
+
1604
+ /** 发布必须知道打哪个站:没选站就报错,**不猜**(猜错站会覆盖线上)。 */
1605
+ function publishSiteOrThrow(ctx) {
1606
+ const site = ctx.cmsSite();
1607
+ if (!site.id) {
1608
+ throw new UsageError('发布必须显式指定站点,CLI 不会替你猜', {
1609
+ hint: '先 `wkgeo site use <站点ID>` 选站,或加 `--site <站点ID>`;确认无误后再加 `--confirm`。',
1610
+ });
1611
+ }
1612
+ return site;
1613
+ }
1614
+
1615
+ async function publishJobOf(ctx, jobId) {
1616
+ const payload = jobId ? { jobId } : {};
1617
+ return (await ctx.publishCall('cmsSitePublishStatus', payload)) || {};
1618
+ }
1619
+
1620
+ function publishJobLines(job) {
1621
+ const s = job.summary || {};
1622
+ const lines = [];
1623
+ lines.push(` 状态:${job.status || 'unknown'}${job.status === 'idle' ? '(这个站还没发过)' : ''}`);
1624
+ if (job.jobId) lines.push(` 任务:${job.jobId}`);
1625
+ if (typeof job.total === 'number') lines.push(` 页面:${job.done || 0}/${job.total}(${job.percent || 0}%)`);
1626
+ if (s && s.pagesFailed !== undefined) {
1627
+ lines.push(` 失败:${s.pagesFailed} 页 | 收尾:${s.finalizeOk ? '成功' : '未完成'}`);
1628
+ }
1629
+ if (job.startedAt) {
1630
+ lines.push(` 开始:${formatTime(job.startedAt)}${job.finishedAt ? ` | 结束:${formatTime(job.finishedAt)}` : ''}`);
1631
+ }
1632
+ if (job.error) lines.push(` 错误:${job.error}`);
1633
+ for (const e of job.errors || []) lines.push(` · ${e.path || '-'}:${e.message || ''}`);
1634
+ return lines;
1635
+ }
1636
+
1637
+ function publishNum(flagValue, fallback) {
1638
+ const n = Number(flagValue);
1639
+ if (!Number.isFinite(n) || n <= 0) return fallback;
1640
+ return n;
1641
+ }
1642
+
1643
+ async function pollPublishJob(ctx, jobId, intervalMs, timeoutSec) {
1644
+ const deadline = ctx.now() + timeoutSec * 1000;
1645
+ for (;;) {
1646
+ const job = await publishJobOf(ctx, jobId);
1647
+ if (PUBLISH_TERMINAL.has(job.status)) return job;
1648
+ if (ctx.now() > deadline) {
1649
+ throw new CliError(`发布任务 ${jobId} 在 ${timeoutSec}s 内没跑完`, {
1650
+ kind: 'publish_timeout',
1651
+ hint: '任务还在后台跑:`wkgeo publish status` 再看,或 `wkgeo publish cancel` 取消。',
1652
+ });
1653
+ }
1654
+ ctx.out.info(` …${job.status || 'running'} ${job.done || 0}/${job.total || '?'}(${job.percent || 0}%)`);
1655
+ await ctx.sleep(intervalMs);
1656
+ }
1657
+ }
1658
+
1659
+ function publishResultData(site, row, job, extra = {}) {
1660
+ const s = (job && job.summary) || {};
1661
+ return {
1662
+ site_id: site.id,
1663
+ site_name: (row && row.name) || site.label || '',
1664
+ domains: publishDomainsOf(row),
1665
+ job_id: (job && job.jobId) || '',
1666
+ status: (job && job.status) || '',
1667
+ total: (job && job.total) || 0,
1668
+ done: (job && job.done) || 0,
1669
+ percent: (job && job.percent) || 0,
1670
+ pages_failed: s.pagesFailed !== undefined ? s.pagesFailed : null,
1671
+ finalize_ok: s.finalizeOk !== undefined ? s.finalizeOk : null,
1672
+ errors: (job && job.errors) || [],
1673
+ ...extra,
1674
+ };
1675
+ }
1676
+
1677
+ /** 发布失败**如实**报,并用非 0 退出码让脚本能感知。 */
1678
+ function throwIfPublishFailed(job) {
1679
+ if (job.status !== 'failed') return;
1680
+ const s = job.summary || {};
1681
+ const parts = [`${job.done || 0}/${job.total || 0} 页已处理`];
1682
+ if (s.pagesFailed !== undefined) parts.push(`失败 ${s.pagesFailed} 页`);
1683
+ throw new CliError(`发布失败:${job.error || '后端未给出原因'}(${parts.join(',')})`, {
1684
+ kind: 'publish_failed',
1685
+ hint: '看详情:`wkgeo publish status`;修好后重新 `wkgeo publish --confirm`。',
1686
+ });
1687
+ }
1688
+
1689
+ export const publishCommand = {
1690
+ name: 'publish',
1691
+ summary: '发布站点(默认 dry-run;`--confirm` 才真发并等它跑完)',
1692
+ usage: 'wkgeo publish [--site <站点ID>] [--confirm] [--cancel] [--no-wait] [--job <任务ID>]',
1693
+ args: [],
1694
+ flags: { ...SITE_FLAG, ...PUBLISH_FLAGS },
1695
+ examples: [
1696
+ 'wkgeo publish # dry-run:看会发多少页,不发请求',
1697
+ 'wkgeo publish --confirm # 真发,并轮询到结束',
1698
+ 'wkgeo publish --confirm --no-wait # 只提交,稍后 `wkgeo publish status`',
1699
+ 'wkgeo publish --cancel # 取消该站正在跑的任务',
1700
+ 'wkgeo publish status --json # 只看状态',
1701
+ ],
1702
+ notes: [
1703
+ '**站点必须显式**:`--site` 或先 `wkgeo site use <id>`;都没配就报用法错误(不猜站点)。',
1704
+ '不加 `--confirm` 一律 dry-run:只读 `overview` / `publishStatus` 算计划,**不发发布请求**。',
1705
+ '真发前会打印站点名、域名、将发布页面数;需要「系统管理 / 全局配置」写权限,没有会回 403 并给权限提示。',
1706
+ '后端没配 `INNER_PUBLISH_SECRET` 时会 fail-closed 回 503 —— 那是服务端部署问题,不是 CLI 的错。',
1707
+ ],
1708
+ async run(ctx) {
1709
+ const { out } = ctx;
1710
+ const site = publishSiteOrThrow(ctx);
1711
+ const row = await publishSiteRow(ctx, site.id);
1712
+ const domains = publishDomainsOf(row);
1713
+
1714
+ // 1) 取消分支:`--cancel` 与 `publish cancel` 同一个实现
1715
+ if (ctx.flags.cancel) return runPublishCancel(ctx, site, row);
1716
+
1717
+ // 2) 先看清现状(只读):最新任务 + 内容计数
1718
+ let latest = {};
1719
+ try {
1720
+ latest = await publishJobOf(ctx, ctx.flags.job);
1721
+ } catch (err) {
1722
+ if (ctx.flags.job) throw err; // 显式给了 jobId 却查不到 → 真的错
1723
+ }
1724
+ let overview = null;
1725
+ try {
1726
+ overview = await ctx.cmsCall('overview');
1727
+ } catch {
1728
+ overview = null;
1729
+ }
1730
+ const counts = overview
1731
+ ? {
1732
+ categories: overview.categories || 0,
1733
+ contents: overview.contents || 0,
1734
+ published: overview.published || 0,
1735
+ drafts: overview.drafts || 0,
1736
+ }
1737
+ : null;
1738
+ const estimate = counts ? counts.categories + counts.contents + 1 : null;
1739
+
1740
+ // 3) dry-run:把"要打哪个站、发多少页"摊开说
1741
+ if (!ctx.flags.confirm) {
1742
+ const data = {
1743
+ ...publishResultData(site, row, latest, { action: 'dry_run', confirmed: false }),
1744
+ site_source: site.source,
1745
+ counts,
1746
+ estimated_pages: estimate,
1747
+ };
1748
+ if (!out.json) {
1749
+ out.head('发布计划(dry-run,未发送任何发布请求)');
1750
+ out.line(` 站点:${data.site_name || '(未取到站名)'}(${site.id})`);
1751
+ out.line(` 域名:${domains.length ? domains.join('、') : '(平台没登记域名)'}`);
1752
+ if (counts) {
1753
+ out.line(
1754
+ ` 内容:栏目 ${counts.categories} 个 | 内容 ${counts.contents} 条(已发布 ${counts.published} / 草稿 ${counts.drafts})`,
1755
+ );
1756
+ out.line(` 预计页面:约 ${estimate} 页(首页 + 栏目 + 内容详情;准确清单以任务 total 为准)`);
1757
+ } else {
1758
+ out.line(' 内容:overview 没取到(权限或网络),页面数以后端任务 total 为准。');
1759
+ }
1760
+ for (const line of publishJobLines(latest)) out.line(line);
1761
+ out.line('');
1762
+ out.line(` 站点来源:${site.source === 'flag' ? '--site' : site.source === 'env' ? 'WKONGAI_SITE' : 'site use'}`);
1763
+ out.line(' 确认无误就加 `--confirm` 真发。');
1764
+ }
1765
+ ctx.done(data);
1766
+ return data;
1767
+ }
1768
+
1769
+ // 4) 真发
1770
+ if (!out.json) {
1771
+ out.head(`开始发布:${(row && row.name) || site.label || site.id}`);
1772
+ out.line(` 站点:${site.id}`);
1773
+ out.line(` 域名:${domains.length ? domains.join('、') : '(平台没登记域名)'}`);
1774
+ if (estimate) out.line(` 预计页面:约 ${estimate} 页`);
1775
+ }
1776
+ const started = (await ctx.publishCall('cmsSitePublishStart', { siteId: site.id })) || {};
1777
+ const jobId = started.jobId || (latest && latest.jobId) || '';
1778
+ if (!out.json) {
1779
+ if (started.alreadyRunning) out.warn('该站已有发布任务在跑,直接接上它的进度:');
1780
+ out.ok(`发布任务已提交:${jobId || '(后端没回 jobId)'}(${started.status || 'queued'},共 ${started.total || '?'} 页)`);
1781
+ }
1782
+
1783
+ if (ctx.flags.wait === false) {
1784
+ const data = publishResultData(site, row, { ...started, jobId }, { action: 'publish', confirmed: true, waited: false });
1785
+ ctx.done(data);
1786
+ return data;
1787
+ }
1788
+
1789
+ const intervalMs = publishNum(ctx.flags.interval, 2000);
1790
+ const timeoutSec = publishNum(ctx.flags.waitTimeout, 900);
1791
+ if (!out.json) out.info('等后端跑完(Ctrl+C 不影响后台任务;`wkgeo publish status` 随时可查)…');
1792
+ const job = await pollPublishJob(ctx, jobId, intervalMs, timeoutSec);
1793
+
1794
+ const data = publishResultData(site, row, job, { action: 'publish', confirmed: true, waited: true });
1795
+ if (!out.json) {
1796
+ out.line('');
1797
+ for (const line of publishJobLines(job)) out.line(line);
1798
+ out.line('');
1799
+ out.info('前台按需渲染:发布任务把页面写进静态层,完成后域名侧即可访问。');
1800
+ }
1801
+ throwIfPublishFailed(job);
1802
+ if (!out.json && job.status === 'partial') out.warn('部分页面失败:看上面的 errors,修好后重新发布。');
1803
+ ctx.done(data);
1804
+ return data;
1805
+ },
1806
+ };
1807
+
1808
+ async function runPublishCancel(ctx, site, row) {
1809
+ const { out } = ctx;
1810
+ let job = null;
1811
+ try {
1812
+ job = await publishJobOf(ctx, ctx.flags.job);
1813
+ } catch (err) {
1814
+ if (ctx.flags.job) throw err;
1815
+ }
1816
+ const jobId = (job && job.jobId) || '';
1817
+ if (!jobId) {
1818
+ throw new UsageError('这个站没有发布任务可取消', {
1819
+ hint: '先 `wkgeo publish status` 看看有没有在跑的任务。',
1820
+ });
1821
+ }
1822
+ const res = (await ctx.publishCall('cmsSitePublishCancel', { jobId })) || {};
1823
+ const canceled = res.canceled === true;
1824
+ const data = publishResultData(site, row, { ...job, jobId, status: res.status || job.status }, {
1825
+ action: 'cancel',
1826
+ canceled,
1827
+ });
1828
+ if (!out.json) {
1829
+ if (canceled) out.ok(`已取消发布任务 ${jobId}`);
1830
+ else out.warn(`任务 ${jobId} 已经结束(状态 ${res.status || job.status}),没有可取消的东西`);
1831
+ }
1832
+ ctx.done(data);
1833
+ return data;
1834
+ }
1835
+
1836
+ export const publishStatusCommand = {
1837
+ name: 'publish status',
1838
+ summary: '只看发布任务状态(只读,不会触发发布)',
1839
+ usage: 'wkgeo publish status [--site <站点ID>] [--job <任务ID>] [--json]',
1840
+ args: [],
1841
+ flags: { ...SITE_FLAG, job: PUBLISH_FLAGS.job },
1842
+ examples: ['wkgeo publish status', 'wkgeo publish status --job <任务ID> --json'],
1843
+ notes: [
1844
+ '不传 `--job` 时看该站**最新**任务;从没发过时状态是 `idle`。',
1845
+ '这个命令只读:只要有站点成员权限就能看。',
1846
+ ],
1847
+ async run(ctx) {
1848
+ const { out } = ctx;
1849
+ const site = publishSiteOrThrow(ctx);
1850
+ const row = await publishSiteRow(ctx, site.id);
1851
+ const job = await publishJobOf(ctx, ctx.flags.job);
1852
+ const data = publishResultData(site, row, job, { action: 'status' });
1853
+ if (!out.json) {
1854
+ out.head(`发布状态(${(row && row.name) || site.label || site.id})`);
1855
+ for (const line of publishJobLines(job)) out.line(line);
1856
+ if (!job.jobId) out.info(' 这个站还没发布过:`wkgeo publish --confirm` 发第一次。');
1857
+ }
1858
+ ctx.done(data);
1859
+ return data;
1860
+ },
1861
+ };
1862
+
1863
+ export const publishCancelCommand = {
1864
+ name: 'publish cancel',
1865
+ summary: '取消该站正在跑的发布任务',
1866
+ usage: 'wkgeo publish cancel [--site <站点ID>] [--job <任务ID>] [--json]',
1867
+ args: [],
1868
+ flags: { ...SITE_FLAG, job: PUBLISH_FLAGS.job },
1869
+ examples: ['wkgeo publish cancel', 'wkgeo publish --cancel --site <站点ID>'],
1870
+ notes: ['等价于 `wkgeo publish --cancel`;任务已经结束时会如实告诉你"没可取消的"。'],
1871
+ async run(ctx) {
1872
+ const site = publishSiteOrThrow(ctx);
1873
+ const row = await publishSiteRow(ctx, site.id);
1874
+ return runPublishCancel(ctx, site, row);
1875
+ },
1876
+ };
1877
+
1878
+ /* --------------------------------------------- 发布面其余动作(B3 16 条) */
1879
+
1880
+ /**
1881
+ * ## 这一段的来历(task-68 / B3)
1882
+ * 老板 2026-10-28:「CLI 的动作要覆盖 CMS 里面的所有动作」,且 CLI 走自己的函数
1883
+ * `wkgeo-cli-fc`(网关 `/cli`)。B1 内容 45 条、B2 素材 18 条已迁完,这里补**发布类 16 条**:
1884
+ * 发布任务(Start / Status / Cancel)、推送目标(TargetGet / Save / Delete / Test)、
1885
+ * 推送(Push)、推送任务(JobList / JobGet / JobCancel)、客户桶(StorageTargetGet / Save /
1886
+ * Verify / Delete / Publish)。
1887
+ *
1888
+ * ## 两条口径(别写歪)
1889
+ * 1. **动作名照抄服务端动作表**:`cmsSitePublish*` / `cmsSiteStorageTarget*` —— 与后台点的是
1890
+ * 同一批 handler(`aliyun/fc/wkgeo-cli-fc/src/publish-core.js` 里逐字复制自 CMS 的那份),
1891
+ * 只是鉴权换成了 CLI 令牌 + 站点归属校验(别人的站回 403 `not_site_owner`)。
1892
+ * 2. **秘密只从 stdin 读**:推送密码 / 客户桶 SK 一律 `--secret-stdin` / `--ak-secret-stdin`
1893
+ * 从管道读,**不接受命令行明文**(会进 shell history / 进程列表 / CI 日志)。
1894
+ */
1895
+
1896
+ /** 把 stdin 读完(管道 / 重定向);秘密只走这条路 */
1897
+ function publishReadStdin(ctx) {
1898
+ const stdin = ctx.stdin || process.stdin;
1899
+ /**
1900
+ * 兜底(2026-10-28):`stdin` 可能是个**只有 `isTTY` 的假对象**(单测的 ctx),
1901
+ * 也可能是个永远不会 EOF 的管道 —— 两种情况都**不许**让命令挂在那里等输入。
1902
+ * ① 没有 `on` ⇒ 直接当"没读到"(命令会报用法错误,而不是抛 TypeError / 卡死);
1903
+ * ② 2 秒内既没 data 也没 end ⇒ 收尾成空串(真人交互请用 `--xxx-stdin` 走管道)。
1904
+ */
1905
+ if (!stdin || typeof stdin.on !== 'function') return Promise.resolve('');
1906
+ return new Promise((resolve) => {
1907
+ let buf = '';
1908
+ let done = false;
1909
+ const finish = () => {
1910
+ if (done) return;
1911
+ done = true;
1912
+ clearTimeout(timer);
1913
+ resolve(buf.replace(/\r/g, '').split('\n')[0].trim());
1914
+ };
1915
+ const timer = setTimeout(finish, 2000);
1916
+ try {
1917
+ stdin.setEncoding('utf8');
1918
+ } catch {
1919
+ /* 注入的假 stdin 可能没有 setEncoding */
1920
+ }
1921
+ stdin.on('data', (chunk) => {
1922
+ buf += chunk;
1923
+ });
1924
+ stdin.once('end', finish);
1925
+ stdin.once('error', finish);
1926
+ if (typeof stdin.resume === 'function') stdin.resume();
1927
+ });
1928
+ }
1929
+
1930
+ /** 读一条秘密:`--xxx-stdin` 或(非 TTY 时)自动;读不到就报用法错误,不猜 */
1931
+ async function publishSecret(ctx, flagName, sample) {
1932
+ const piped = ctx.flags[flagName] === true || !ctx.stdinIsTTY;
1933
+ if (!piped) {
1934
+ throw new UsageError('秘密不要写进命令行(会进 shell history / 进程列表 / CI 日志),请用管道', {
1935
+ hint: sample,
1936
+ });
1937
+ }
1938
+ const text = await publishReadStdin(ctx);
1939
+ if (!text) {
1940
+ throw new UsageError('没从 stdin 读到秘密。管道用法:\n ' + sample);
1941
+ }
1942
+ return text;
1943
+ }
1944
+
1945
+ /** 统一的「调一下、把 data 交出去」小工具(发布面每个命令都长这样) */
1946
+ async function publishCallData(ctx, action, payload, render) {
1947
+ const data = (await ctx.publishCall(action, payload)) || {};
1948
+ if (!ctx.out.json && typeof render === 'function') render(data);
1949
+ ctx.done(data);
1950
+ return data;
1951
+ }
1952
+
1953
+ /** `--target-id` 必填校验:缺了本地就挡(服务端也会挡,但那样要多跑一次往返) */
1954
+ function publishTargetIdOf(ctx) {
1955
+ const id = String(ctx.flags.targetId || '').trim();
1956
+ if (!id) throw new UsageError('需要 --target-id(先用 `wkgeo publish targets` 看有哪些目标)');
1957
+ if (!looksLikeUuid(id)) throw new UsageError(`--target-id 要填 uuid,收到:${id}`);
1958
+ return id;
1959
+ }
1960
+
1961
+ function publishJobIdArg(ctx, { required = true } = {}) {
1962
+ const id = String(ctx.flags.job || '').trim();
1963
+ if (!id) {
1964
+ if (!required) return '';
1965
+ throw new UsageError('需要 --job <任务ID>(先用 `wkgeo publish jobs` 看有哪些任务)');
1966
+ }
1967
+ if (!looksLikeUuid(id)) throw new UsageError(`--job 要填 uuid,收到:${id}`);
1968
+ return id;
1969
+ }
1970
+
1971
+ /**
1972
+ * `publish retry` —— **重发一次**。
1973
+ *
1974
+ * 后端(CMS 与 CLI 自持版)**都没有单独的 retry 动作**:重试的语义就是「再建一个新任务」,
1975
+ * 旧任务(failed / canceled)原样留着当历史。所以这里不假造 `cmsSitePublishRetry`,
1976
+ * 而是:先看清最新任务 → 还在跑就拦住(要它先 cancel)→ 真发一个新的(同 `publish --confirm`)。
1977
+ */
1978
+ export const publishRetryCommand = {
1979
+ name: 'publish retry',
1980
+ summary: '重发一次(旧任务不动,新建一个发布任务)',
1981
+ usage:
1982
+ 'wkgeo publish retry [--site <站点ID>] [--confirm] [--wait-timeout <秒>] [--no-wait] [--json]',
1983
+ args: [],
1984
+ flags: { ...SITE_FLAG, ...PUBLISH_FLAGS },
1985
+ examples: [
1986
+ 'wkgeo publish retry # dry-run:只说清楚"会重发哪个站、上一个任务什么状态"',
1987
+ 'wkgeo publish retry --confirm # 真重发,并轮询到结束',
1988
+ 'wkgeo publish retry --confirm --no-wait',
1989
+ ],
1990
+ notes: [
1991
+ '**后端没有 retry 动作**:重试 = 新建一个发布任务,旧的 failed/canceled 任务原样保留可查。',
1992
+ '上一个任务还在跑(queued/running)时不重发:先 `wkgeo publish cancel`,否则两个任务会抢同一批页面。',
1993
+ '不加 `--confirm` 一律 dry-run,不发写请求。',
1994
+ ],
1995
+ async run(ctx) {
1996
+ const { out } = ctx;
1997
+ const site = publishSiteOrThrow(ctx);
1998
+ const row = await publishSiteRow(ctx, site.id);
1999
+ const previous = await publishJobOf(ctx, ctx.flags.job).catch(() => ({}));
2000
+ const active = previous.status === 'queued' || previous.status === 'running';
2001
+ if (active) {
2002
+ throw new CliError(`这个站还有一个任务在跑(${previous.jobId || '-'},${previous.status}),不能重发`, {
2003
+ kind: 'publish_busy',
2004
+ hint: '先 `wkgeo publish cancel` 取消它,或 `wkgeo publish status` 等它跑完。',
2005
+ });
2006
+ }
2007
+ if (!ctx.flags.confirm) {
2008
+ const data = publishResultData(site, row, previous, {
2009
+ action: 'retry_dry_run',
2010
+ confirmed: false,
2011
+ retriedFrom: (previous && previous.jobId) || '',
2012
+ });
2013
+ if (!out.json) {
2014
+ out.head('重发计划(dry-run,未发送任何发布请求)');
2015
+ out.line(` 站点:${data.site_name || '(未取到站名)'}(${site.id})`);
2016
+ out.line(` 上一个任务:${(previous && previous.jobId) || '(没有)'}(${(previous && previous.status) || 'idle'})`);
2017
+ out.line(' 确认无误就加 `--confirm` 新建一个发布任务。');
2018
+ }
2019
+ ctx.done(data);
2020
+ return data;
2021
+ }
2022
+ const started = (await ctx.publishCall('cmsSitePublishStart', { siteId: site.id })) || {};
2023
+ const jobId = started.jobId || '';
2024
+ if (!out.json) {
2025
+ if (started.alreadyRunning) out.warn('该站已有发布任务在跑,直接接上它的进度:');
2026
+ out.ok(`重发任务已提交:${jobId || '(后端没回 jobId)'}(${started.status || 'queued'},共 ${started.total || '?'} 页)`);
2027
+ }
2028
+ if (ctx.flags.wait === false) {
2029
+ const data = publishResultData(site, row, { ...started, jobId }, {
2030
+ action: 'retry',
2031
+ confirmed: true,
2032
+ waited: false,
2033
+ retriedFrom: (previous && previous.jobId) || '',
2034
+ });
2035
+ ctx.done(data);
2036
+ return data;
2037
+ }
2038
+ const intervalMs = publishNum(ctx.flags.interval, 2000);
2039
+ const timeoutSec = publishNum(ctx.flags.waitTimeout, 900);
2040
+ const job = await pollPublishJob(ctx, jobId, intervalMs, timeoutSec);
2041
+ const data = publishResultData(site, row, job, {
2042
+ action: 'retry',
2043
+ confirmed: true,
2044
+ waited: true,
2045
+ retriedFrom: (previous && previous.jobId) || '',
2046
+ });
2047
+ if (!out.json) {
2048
+ out.line('');
2049
+ for (const line of publishJobLines(job)) out.line(line);
2050
+ }
2051
+ throwIfPublishFailed(job);
2052
+ ctx.done(data);
2053
+ return data;
2054
+ },
2055
+ };
2056
+
2057
+ /** `publish jobs` —— 推送任务列表(只读) */
2058
+ export const publishJobsCommand = {
2059
+ name: 'publish jobs',
2060
+ summary: '推送任务列表(只读)',
2061
+ usage: 'wkgeo publish jobs [--site <站点ID>] [--limit <1-50>] [--json]',
2062
+ args: [],
2063
+ flags: {
2064
+ ...SITE_FLAG,
2065
+ limit: { type: 'number', desc: '最多几条(默认 20,上限 50)' },
2066
+ },
2067
+ examples: ['wkgeo publish jobs', 'wkgeo publish jobs --limit 5 --json'],
2068
+ notes: [
2069
+ '这是**推送**任务(`site_publish_job`,把成品推到客户自己的 FTP/SFTP/S3/WebDAV);',
2070
+ '站内渲染发布的任务用 `wkgeo publish status` 看(`cms_site_publish_job`),两者是不同表。',
2071
+ ],
2072
+ async run(ctx) {
2073
+ const site = publishSiteOrThrow(ctx);
2074
+ const limit = publishNum(ctx.flags.limit, 20);
2075
+ return publishCallData(ctx, 'cmsSitePublishJobList', { limit }, (data) => {
2076
+ const jobs = data.jobs || [];
2077
+ ctx.out.head(`推送任务(${site.id},最近 ${jobs.length} 条)`);
2078
+ if (!jobs.length) {
2079
+ ctx.out.line(' 还没有推送任务:先 `wkgeo publish targets save` 配目标,再 `wkgeo publish push`。');
2080
+ return;
2081
+ }
2082
+ for (const job of jobs) {
2083
+ ctx.out.line(
2084
+ ` ${job.jobId || '-'} ${String(job.status || '-').padEnd(9)} ${job.done || 0}/${job.total || 0} ${job.createdAt || ''}`,
2085
+ );
2086
+ }
2087
+ });
2088
+ },
2089
+ };
2090
+
2091
+ /** `publish jobs get` —— 单个推送任务(默认会「推进」一次,见 notes) */
2092
+ export const publishJobGetCommand = {
2093
+ name: 'publish jobs get',
2094
+ summary: '看一个推送任务的详情(默认会推进它一次)',
2095
+ usage: 'wkgeo publish jobs get [--site <站点ID>] [--job <任务ID>] [--advance|--no-advance] [--json]',
2096
+ args: [],
2097
+ flags: {
2098
+ ...SITE_FLAG,
2099
+ job: PUBLISH_FLAGS.job,
2100
+ advance: { type: 'boolean', desc: '顺便推进这个任务(默认推进;`--no-advance` 只读)' },
2101
+ },
2102
+ examples: ['wkgeo publish jobs get', 'wkgeo publish jobs get --job <任务ID> --no-advance --json'],
2103
+ notes: [
2104
+ '⚠️ 服务端这个动作**默认会推进任务**(调推送服务跑下一批,并写回 job 行)——',
2105
+ '所以它不是纯只读;想「只看不动」必须加 `--no-advance`。',
2106
+ '不传 `--job` 时看该站最新一条推送任务。',
2107
+ ],
2108
+ async run(ctx) {
2109
+ const site = publishSiteOrThrow(ctx);
2110
+ const payload = { advance: ctx.flags.advance !== false };
2111
+ const jobId = publishJobIdArg(ctx, { required: false });
2112
+ if (jobId) payload.jobId = jobId;
2113
+ return publishCallData(ctx, 'cmsSitePublishJobGet', payload, (data) => {
2114
+ const job = data.job || {};
2115
+ ctx.out.head(`推送任务 ${job.jobId || jobId || '(最新)'}`);
2116
+ ctx.out.line(` 状态:${job.status || '-'}${job.active ? '(进行中)' : ''}`);
2117
+ ctx.out.line(` 文件:${job.done || 0}/${job.total || 0}`);
2118
+ if (job.error) ctx.out.line(` 错误:${job.error}`);
2119
+ });
2120
+ },
2121
+ };
2122
+
2123
+ /** `publish jobs cancel` —— 取消推送任务 */
2124
+ export const publishJobCancelCommand = {
2125
+ name: 'publish jobs cancel',
2126
+ summary: '取消一个推送任务',
2127
+ usage: 'wkgeo publish jobs cancel [--site <站点ID>] [--job <任务ID>] [--json]',
2128
+ args: [],
2129
+ flags: { ...SITE_FLAG, job: { ...PUBLISH_FLAGS.job, required: true } },
2130
+ examples: ['wkgeo publish jobs cancel --job <任务ID>'],
2131
+ notes: ['任务已经结束时会如实回"已经结束,不用取消",不假装成功。'],
2132
+ async run(ctx) {
2133
+ const site = publishSiteOrThrow(ctx);
2134
+ const jobId = publishJobIdArg(ctx);
2135
+ return publishCallData(ctx, 'cmsSitePublishJobCancel', { jobId }, (data) => {
2136
+ if (data.canceled) ctx.out.ok(`已取消推送任务 ${jobId}`);
2137
+ else ctx.out.warn(`任务 ${jobId} 已经结束(${data.status || '-'}),没有可取消的`);
2138
+ if (data.message) ctx.out.line(` ${data.message}`);
2139
+ void site;
2140
+ });
2141
+ },
2142
+ };
2143
+
2144
+ /** `publish targets` —— 推送目标列表(只读,秘密只回「已配置」) */
2145
+ export const publishTargetsCommand = {
2146
+ name: 'publish targets',
2147
+ summary: '推送目标列表(FTP/SFTP/S3/WebDAV,只读)',
2148
+ usage: 'wkgeo publish targets [--site <站点ID>] [--json]',
2149
+ args: [],
2150
+ flags: { ...SITE_FLAG },
2151
+ examples: ['wkgeo publish targets', 'wkgeo publish targets --json'],
2152
+ notes: [
2153
+ '只回「已配置 / 没配」和主机、路径这些非秘密字段;密码/密钥**永远不会**出现在输出里。',
2154
+ '增改删测:`publish targets save|delete|test`。',
2155
+ ],
2156
+ async run(ctx) {
2157
+ const site = publishSiteOrThrow(ctx);
2158
+ return publishCallData(ctx, 'cmsSitePublishTargetGet', {}, (data) => {
2159
+ const targets = data.targets || [];
2160
+ ctx.out.head(`推送目标(${site.id})`);
2161
+ if (!targets.length) {
2162
+ ctx.out.line(' 还没配:`wkgeo publish targets save --protocol sftp --host <主机> --username <用户> --remote-root /www/site --secret-stdin`');
2163
+ }
2164
+ for (const one of targets) {
2165
+ ctx.out.line(
2166
+ ` ${one.setCode || '-'} ${one.protocol || '-'} ${one.host || '-'}:${one.port || '-'} ` +
2167
+ `路径 ${one.remoteRoot || '-'} 校验 ${one.verifyStatus || '-'} 密钥 ${one.hasSecret ? '已配置' : '没配'}`,
2168
+ );
2169
+ }
2170
+ ctx.out.line(` 服务端推送通道:base ${data.baseConfigured ? '已配' : '没配'} | secret ${data.secretConfigured ? '已配' : '没配'}`);
2171
+ });
2172
+ },
2173
+ };
2174
+
2175
+ /** `publish targets save` —— 存推送目标(凭据加密落库) */
2176
+ export const publishTargetsSaveCommand = {
2177
+ name: 'publish targets save',
2178
+ summary: '存推送目标(凭据加密落库;密码只从 stdin 读)',
2179
+ usage:
2180
+ 'wkgeo publish targets save --protocol <sftp|ftp|ftps_explicit|ftps_implicit|s3|webdav> --host <主机> [--port <端口>] ' +
2181
+ '[--username <用户>] [--remote-root </路径>] [--target-id <ID>] [--set-code <代号>] [--secret-stdin] [--plain-ack] [--json]',
2182
+ args: [],
2183
+ flags: {
2184
+ ...SITE_FLAG,
2185
+ 'target-id': { type: 'string', desc: '已有目标 ID(改它;不填就是新建)' },
2186
+ 'set-code': { type: 'string', desc: '目标代号(默认 default;小写字母/数字/-/_,≤32)' },
2187
+ protocol: { type: 'string', required: true, desc: 'sftp / ftp / ftps_explicit / ftps_implicit / s3 / webdav' },
2188
+ host: { type: 'string', required: true, desc: '主机名或 IP(不带协议、端口)' },
2189
+ port: { type: 'number', desc: '端口(sftp 22 / ftp 21 / ftps_implicit 990 / webdav 80 / s3 443)' },
2190
+ username: { type: 'string', desc: '登录用户(对象存储填 AccessKeyId)' },
2191
+ 'remote-root': { type: 'string', desc: '远端根目录(必须以 / 开头)' },
2192
+ bucket: { type: 'string', desc: '对象存储桶名(s3/webdav 用)' },
2193
+ region: { type: 'string', desc: '对象存储区域(s3 用)' },
2194
+ note: { type: 'string', desc: '备注(≤500 字)' },
2195
+ 'secret-stdin': { type: 'boolean', desc: '从 stdin 读密码/密钥(管道;非 TTY 下默认就是它)' },
2196
+ 'plain-ack': { type: 'boolean', desc: '明文 ftp 的风险确认(不加密传输,必须显式加)' },
2197
+ },
2198
+ examples: [
2199
+ 'printf %s "$SFTP_PASSWORD" | wkgeo publish targets save --protocol sftp --host 1.2.3.4 --username deploy --remote-root /www/site --secret-stdin',
2200
+ 'wkgeo publish targets save --target-id <ID> --protocol sftp --host 1.2.3.4 --remote-root /www/site',
2201
+ ],
2202
+ notes: [
2203
+ '**密码/密钥不要写进命令行**:只走 stdin(`--secret-stdin`)或交互输入。',
2204
+ '同一个站可以存多条目标,但只有一个 `setCode=default` 是默认推送目标。',
2205
+ '改已有目标时密码留空 = 沿用原密钥;要换就重新 pipe 一次。',
2206
+ ],
2207
+ async run(ctx) {
2208
+ const site = publishSiteOrThrow(ctx);
2209
+ const payload = { siteId: site.id };
2210
+ const map = {
2211
+ setCode: 'setCode',
2212
+ protocol: 'protocol',
2213
+ host: 'host',
2214
+ username: 'username',
2215
+ remoteRoot: 'remoteRoot',
2216
+ bucket: 'bucket',
2217
+ region: 'region',
2218
+ note: 'note',
2219
+ };
2220
+ for (const [flag, key] of Object.entries(map)) {
2221
+ const v = ctx.flags[flag];
2222
+ if (v !== undefined && v !== '') payload[key] = String(v);
2223
+ }
2224
+ if (ctx.flags.port !== undefined) payload.port = ctx.flags.port;
2225
+ if (ctx.flags.plainAck === true) payload.plainAck = true;
2226
+ const targetId = String(ctx.flags.targetId || '').trim();
2227
+ if (targetId) {
2228
+ if (!looksLikeUuid(targetId)) throw new UsageError(`--target-id 要填 uuid,收到:${targetId}`);
2229
+ payload.targetId = targetId;
2230
+ }
2231
+ if (ctx.flags.secretStdin === true || !ctx.stdinIsTTY) {
2232
+ payload.secret = await publishSecret(
2233
+ ctx,
2234
+ 'secretStdin',
2235
+ 'printf %s "$PASSWORD" | wkgeo publish targets save --protocol sftp --host <主机> --secret-stdin',
2236
+ );
2237
+ }
2238
+ return publishCallData(ctx, 'cmsSitePublishTargetSave', payload, (data) => {
2239
+ const one = data.target || {};
2240
+ ctx.out.ok(`推送目标已保存:${one.setCode || payload.setCode || 'default'}(${one.protocol || payload.protocol} ${one.host || ''})`);
2241
+ ctx.out.info(' 未验证前不会推送:先 `wkgeo publish targets test --target-id <ID>`(或推送时会自动验)。');
2242
+ });
2243
+ },
2244
+ };
2245
+
2246
+ /** `publish targets delete` —— 删推送目标(危险操作,必须 --yes) */
2247
+ export const publishTargetsDeleteCommand = {
2248
+ name: 'publish targets delete',
2249
+ summary: '删推送目标(危险:必须 --yes)',
2250
+ usage: 'wkgeo publish targets delete --target-id <ID> --yes [--site <站点ID>] [--json]',
2251
+ args: [],
2252
+ flags: {
2253
+ ...SITE_FLAG,
2254
+ 'target-id': { type: 'string', required: true, desc: '目标 ID' },
2255
+ yes: { type: 'boolean', desc: '确认删除(不加就只报错,什么都不做)' },
2256
+ },
2257
+ examples: ['wkgeo publish targets delete --target-id <ID> --yes'],
2258
+ notes: ['有正在跑的推送任务时服务端会回 409(先 `wkgeo publish jobs cancel`),不会硬删。'],
2259
+ async run(ctx) {
2260
+ const site = publishSiteOrThrow(ctx);
2261
+ const targetId = publishTargetIdOf(ctx);
2262
+ if (ctx.flags.yes !== true) {
2263
+ throw new UsageError('删目标不可恢复:确认后加 `--yes` 再执行', {
2264
+ hint: `wkgeo publish targets delete --target-id ${targetId} --yes`,
2265
+ });
2266
+ }
2267
+ return publishCallData(ctx, 'cmsSitePublishTargetDelete', { targetId }, () => {
2268
+ ctx.out.ok(`已删除推送目标 ${targetId}`);
2269
+ });
2270
+ },
2271
+ };
2272
+
2273
+ /** `publish targets test` —— 真连一次(FTP/SFTP 登录、S3 列桶) */
2274
+ export const publishTargetsTestCommand = {
2275
+ name: 'publish targets test',
2276
+ summary: '测试推送目标能不能连上(真连,不推文件)',
2277
+ usage: 'wkgeo publish targets test --target-id <ID> [--site <站点ID>] [--json]',
2278
+ args: [],
2279
+ flags: { ...SITE_FLAG, 'target-id': { type: 'string', required: true, desc: '目标 ID' } },
2280
+ examples: ['wkgeo publish targets test --target-id <ID>'],
2281
+ notes: [
2282
+ '服务端对同一站点有节流(1 分钟内最多 3 次),太频繁会回 429。',
2283
+ '连不上时如实回错误原因(认证失败 / 目录不存在 / DNS 不通),不会假装成功。',
2284
+ ],
2285
+ async run(ctx) {
2286
+ const site = publishSiteOrThrow(ctx);
2287
+ const targetId = publishTargetIdOf(ctx);
2288
+ return publishCallData(ctx, 'cmsSitePublishTargetTest', { targetId }, (data) => {
2289
+ const one = data.target || {};
2290
+ if (data.ok) ctx.out.ok(`连接成功:${one.protocol || ''} ${one.host || ''}(${data.ms || 0}ms)`);
2291
+ else ctx.out.warn(`连不上:${data.message || '服务端没给原因'}`);
2292
+ });
2293
+ },
2294
+ };
2295
+
2296
+ /** `publish push` —— 把成品推到客户自己的目标(异步任务) */
2297
+ export const publishPushCommand = {
2298
+ name: 'publish push',
2299
+ summary: '把站点成品推送到客户自有目标(FTP/SFTP/S3/WebDAV;异步任务)',
2300
+ usage:
2301
+ 'wkgeo publish push [--site <站点ID>] [--target-id <ID>] [--switch-mode dir_rename|file_rename|overwrite] [--confirm] [--json]',
2302
+ args: [],
2303
+ flags: {
2304
+ ...SITE_FLAG,
2305
+ 'target-id': { type: 'string', desc: '用哪个目标(默认 setCode=default)' },
2306
+ 'switch-mode': { type: 'string', desc: '切换方式:dir_rename(默认)/ file_rename / overwrite' },
2307
+ confirm: { type: 'boolean', desc: '真推(不加只报错:推送会改远端站点)' },
2308
+ },
2309
+ examples: [
2310
+ 'wkgeo publish push # 不加 --confirm 会告诉你还缺什么',
2311
+ 'wkgeo publish push --confirm # 真推(服务端跑异步任务)',
2312
+ 'wkgeo publish jobs # 看进度',
2313
+ ],
2314
+ notes: [
2315
+ '推送 = 把「已发布」的静态页面整批传到客户那台机器 / 那个桶;默认走目录切换(`dir_rename`),失败能回滚。',
2316
+ '服务端没配 `PUBLISH_PUSH_BASE` / `INTERNAL_TASK_SECRET` 时 fail-closed 回 503(部署问题,不是 CLI 的错)。',
2317
+ '同一个站同一时间只有一个活跃推送任务;已经在跑时回 `alreadyRunning`,不会重复推。',
2318
+ ],
2319
+ async run(ctx) {
2320
+ const site = publishSiteOrThrow(ctx);
2321
+ if (ctx.flags.confirm !== true) {
2322
+ throw new UsageError('推送会改远端站点:确认后加 `--confirm` 再执行', {
2323
+ hint: `wkgeo publish push --confirm --site ${site.id}`,
2324
+ });
2325
+ }
2326
+ const payload = {};
2327
+ const targetId = String(ctx.flags.targetId || '').trim();
2328
+ if (targetId) {
2329
+ if (!looksLikeUuid(targetId)) throw new UsageError(`--target-id 要填 uuid,收到:${targetId}`);
2330
+ payload.targetId = targetId;
2331
+ }
2332
+ if (ctx.flags.switchMode) payload.switchMode = String(ctx.flags.switchMode);
2333
+ return publishCallData(ctx, 'cmsSitePublishPush', payload, (data) => {
2334
+ const job = data.job || {};
2335
+ if (data.alreadyRunning) ctx.out.warn(`该站已有推送任务在跑(${job.jobId || '-'}),接上它的进度:`);
2336
+ else ctx.out.ok(`推送任务已提交:${job.jobId || (data.jobId || '-')}(${job.status || 'queued'},共 ${job.total || 0} 个文件)`);
2337
+ ctx.out.info(' 看进度:`wkgeo publish jobs get`;取消:`wkgeo publish jobs cancel --job <ID>`。');
2338
+ });
2339
+ },
2340
+ };
2341
+
2342
+ /** `publish storage` —— 客户自有对象存储(站点存储位置) */
2343
+ export const publishStorageCommand = {
2344
+ name: 'publish storage',
2345
+ summary: '客户自有对象存储(OSS/COS/BOS/S3)当前的配置(只读,密钥打码)',
2346
+ usage: 'wkgeo publish storage [--site <站点ID>] [--json]',
2347
+ args: [],
2348
+ flags: { ...SITE_FLAG },
2349
+ examples: ['wkgeo publish storage', 'wkgeo publish storage --json'],
2350
+ notes: [
2351
+ '配好之后:站点静态页发布时**直写这个桶**(平台桶不再落一份),短域由这个桶对外提供。',
2352
+ '增改删验:`publish storage save|verify|delete|publish`。',
2353
+ ],
2354
+ async run(ctx) {
2355
+ const site = publishSiteOrThrow(ctx);
2356
+ return publishCallData(ctx, 'cmsSiteStorageTargetGet', {}, (data) => {
2357
+ const one = data.target || {};
2358
+ ctx.out.head(`站点存储(${site.id})`);
2359
+ if (!one.kind) {
2360
+ ctx.out.line(' 还是平台默认桶:`wkgeo publish storage save --kind oss --bucket <桶> --region <区域> --endpoint <域名> --ak-id <ID> --ak-secret-stdin`');
2361
+ ctx.out.line(' 想挂平台自己的共享桶池(腾讯 COS / 百度 BOS / 阿里云 OSS):`wkgeo publish storage save --pool tencent`');
2362
+ } else {
2363
+ ctx.out.line(` 类型:${one.kind}(${one.provider || '-'})| 桶:${one.bucket || '-'} | 区域:${one.region || '-'}`);
2364
+ ctx.out.line(` 端点:${one.endpoint || '-'} | 前缀:${one.pathPrefix || '(根)'} | 密钥:${one.hasSecret ? '已配置' : '没配'}`);
2365
+ if (one.storageSource === 'platform') {
2366
+ ctx.out.line(` 来源:平台共享桶池(platform_storage_id=${one.platformStorageId || '-'},AK 由平台托管)`);
2367
+ }
2368
+ ctx.out.line(` 校验:${one.verifyStatus || '未验证'} | 启用:${one.enabled === false ? '否' : '是'}`);
2369
+ }
2370
+ });
2371
+ },
2372
+ };
2373
+
2374
+ /** `publish storage save` —— 存客户桶(SK 只从 stdin 读) */
2375
+ export const publishStorageSaveCommand = {
2376
+ name: 'publish storage save',
2377
+ summary: '存客户自有对象存储(SK 只从 stdin 读,加密落库)',
2378
+ usage:
2379
+ 'wkgeo publish storage save --kind <oss|cos|bos|s3> --bucket <桶> --region <区域> ' +
2380
+ '[--provider <厂商>] [--endpoint <域名>] [--path-prefix <前缀>] --ak-id <ID> --ak-secret-stdin [--site <站点ID>] [--json]\n' +
2381
+ ' wkgeo publish storage save --pool <aliyun|tencent|baidu> [--path-prefix <前缀>] [--site <站点ID>] [--json]',
2382
+ args: [],
2383
+ flags: {
2384
+ ...SITE_FLAG,
2385
+ pool: {
2386
+ type: 'string',
2387
+ desc: '挂**平台共享桶池**(aliyun / tencent / baidu;AK 由平台托管,不用填 --ak-id / --ak-secret-stdin)',
2388
+ },
2389
+ 'platform-storage-id': { type: 'string', desc: '平台存储行 id(uuid;等价于 --pool,但要精确到某一行时用)' },
2390
+ kind: { type: 'string', desc: 'oss / cos / bos / s3(用 --pool 时可省略,按池的厂商自动定)' },
2391
+ provider: { type: 'string', desc: '厂商(oss⇒aliyun、cos⇒tencent、bos⇒baidu;s3 默认 other)' },
2392
+ bucket: { type: 'string', desc: '桶名(小写字母/数字/点/连字符;用 --pool 时可省略)' },
2393
+ region: { type: 'string', desc: '区域,如 oss-cn-shanghai / ap-guangzhou(用 --pool 时可省略)' },
2394
+ endpoint: { type: 'string', desc: '访问域名(oss/cos/bos 必填,如 oss-cn-shanghai.aliyuncs.com)' },
2395
+ 'path-prefix': { type: 'string', desc: '对象前缀(默认空 = 桶根)' },
2396
+ 'ak-id': { type: 'string', desc: 'AccessKeyId(不是密钥,可以写在命令行)' },
2397
+ 'ak-secret-stdin': { type: 'boolean', desc: '从 stdin 读 AccessKeySecret(管道;非 TTY 下默认就是它)' },
2398
+ 'force-path-style': { type: 'boolean', desc: '强制 path-style 访问(MinIO 等需要)' },
2399
+ note: { type: 'string', desc: '备注(≤500 字)' },
2400
+ },
2401
+ examples: [
2402
+ 'printf %s "$OSS_SK" | wkgeo publish storage save --kind oss --bucket my-site --region oss-cn-shanghai --endpoint oss-cn-shanghai.aliyuncs.com --ak-id LTAI... --ak-secret-stdin',
2403
+ 'wkgeo publish storage save --pool tencent # 挂平台腾讯云 COS 共享桶(AK 平台托管)',
2404
+ 'wkgeo publish storage verify',
2405
+ ],
2406
+ notes: [
2407
+ '**AccessKeySecret 不要写进命令行**:只走 stdin(`--ak-secret-stdin`)或交互输入。',
2408
+ '一个站点只能有一个存储位置:如果超管后台把它设成了服务器(FTP/SFTP),这里会回 409 让你先改回默认。',
2409
+ '改已有配置时 SK 留空 = 沿用原密钥。',
2410
+ '`--pool` / `--platform-storage-id` 挂的是**平台自己维护的共享桶池**(库里 `platform_storage` 那几行):站点侧不落 AK,发布时直写那个桶 + 站点前缀。',
2411
+ ],
2412
+ async run(ctx) {
2413
+ const site = publishSiteOrThrow(ctx);
2414
+ const pool = String(ctx.flags.pool || '').trim().toLowerCase();
2415
+ const platformStorageId = String(ctx.flags.platformStorageId || '').trim();
2416
+ if (pool && !PLATFORM_POOL_KEYS.includes(pool)) {
2417
+ throw new UsageError(`--pool 只认 ${PLATFORM_POOL_KEYS.join(' / ')},收到:${pool}`, {
2418
+ hint: 'wkgeo publish storage save --pool tencent',
2419
+ });
2420
+ }
2421
+ if (platformStorageId && !looksLikeUuid(platformStorageId)) {
2422
+ throw new UsageError(`--platform-storage-id 要填 uuid,收到:${platformStorageId}`);
2423
+ }
2424
+ const payload = { siteId: site.id };
2425
+ if (pool) payload.platformKey = pool;
2426
+ if (platformStorageId) payload.platformStorageId = platformStorageId;
2427
+ const platformMode = Boolean(pool || platformStorageId);
2428
+ if (!platformMode) {
2429
+ if (!ctx.flags.kind) throw new UsageError('缺 --kind(oss / cos / bos / s3)', { hint: '或用 --pool <aliyun|tencent|baidu> 挂平台共享桶池' });
2430
+ if (!ctx.flags.bucket) throw new UsageError('缺 --bucket(客户桶名)', { hint: '或用 --pool <aliyun|tencent|baidu> 挂平台共享桶池' });
2431
+ if (!ctx.flags.region) throw new UsageError('缺 --region(如 oss-cn-shanghai)');
2432
+ if (!ctx.flags.akId) throw new UsageError('缺 --ak-id(客户桶的 AccessKeyId)');
2433
+ }
2434
+ if (ctx.flags.kind) payload.kind = String(ctx.flags.kind || '');
2435
+ for (const [flag, key] of Object.entries({
2436
+ provider: 'provider',
2437
+ bucket: 'bucket',
2438
+ region: 'region',
2439
+ endpoint: 'endpoint',
2440
+ pathPrefix: 'pathPrefix',
2441
+ note: 'note',
2442
+ })) {
2443
+ const v = ctx.flags[flag];
2444
+ if (v !== undefined && v !== '') payload[key] = String(v);
2445
+ }
2446
+ if (ctx.flags.akId) payload.akId = String(ctx.flags.akId || '');
2447
+ if (ctx.flags.forcePathStyle === true) payload.forcePathStyle = true;
2448
+ if (!platformMode && (ctx.flags.akSecretStdin === true || !ctx.stdinIsTTY)) {
2449
+ payload.akSecret = await publishSecret(
2450
+ ctx,
2451
+ 'akSecretStdin',
2452
+ 'printf %s "$SK" | wkgeo publish storage save --kind oss --bucket <桶> --region <区域> --endpoint <域名> --ak-id <ID> --ak-secret-stdin',
2453
+ );
2454
+ }
2455
+ return publishCallData(ctx, 'cmsSiteStorageTargetSave', payload, (data) => {
2456
+ const one = data.target || {};
2457
+ ctx.out.ok(
2458
+ `存储配置已保存:${one.kind || payload.kind || 'platform'} ${one.bucket || payload.bucket || ''}` +
2459
+ (one.storageSource === 'platform' ? `(平台池 ${one.provider || ''}${one.platformStorageId ? ` / ${one.platformStorageId}` : ''})` : ''),
2460
+ );
2461
+ ctx.out.info(' 下一步:`wkgeo publish storage verify`(真连一次),通过后再发布。');
2462
+ });
2463
+ },
2464
+ };
2465
+
2466
+ /** `publish storage verify` —— 真连一次(写探测对象再删) */
2467
+ export const publishStorageVerifyCommand = {
2468
+ name: 'publish storage verify',
2469
+ summary: '验证客户桶能不能写(真连、真写一个探测对象)',
2470
+ usage: 'wkgeo publish storage verify [--site <站点ID>] [--json]',
2471
+ args: [],
2472
+ flags: { ...SITE_FLAG },
2473
+ examples: ['wkgeo publish storage verify'],
2474
+ notes: ['会往桶里写一个校验对象(`_site-verify/…`),随后删掉;连不上会如实回原因。'],
2475
+ async run(ctx) {
2476
+ const site = publishSiteOrThrow(ctx);
2477
+ return publishCallData(ctx, 'cmsSiteStorageTargetVerify', {}, (data) => {
2478
+ if (data.ok) ctx.out.ok(`桶可写:${data.bucket || ''}(${data.ms || 0}ms)`);
2479
+ else ctx.out.warn(`验证没通过:${data.message || '服务端没给原因'}`);
2480
+ });
2481
+ },
2482
+ };
2483
+
2484
+ /** `publish storage delete` —— 解绑客户桶(危险,必须 --yes) */
2485
+ export const publishStorageDeleteCommand = {
2486
+ name: 'publish storage delete',
2487
+ summary: '解绑客户自有存储(危险:必须 --yes;站点回到平台默认桶)',
2488
+ usage: 'wkgeo publish storage delete --yes [--site <站点ID>] [--json]',
2489
+ args: [],
2490
+ flags: { ...SITE_FLAG, yes: { type: 'boolean', desc: '确认解绑(不加就只报错,什么都不做)' } },
2491
+ examples: ['wkgeo publish storage delete --yes'],
2492
+ notes: [
2493
+ '解绑只删平台里的配置与密文,**不动客户桶里的任何对象**。',
2494
+ '解绑后站点回到平台默认桶;下次发布才会重新写平台桶。',
2495
+ ],
2496
+ async run(ctx) {
2497
+ const site = publishSiteOrThrow(ctx);
2498
+ if (ctx.flags.yes !== true) {
2499
+ throw new UsageError('解绑存储不可自动恢复:确认后加 `--yes` 再执行', {
2500
+ hint: `wkgeo publish storage delete --site ${site.id} --yes`,
2501
+ });
2502
+ }
2503
+ return publishCallData(ctx, 'cmsSiteStorageTargetDelete', {}, () => {
2504
+ ctx.out.ok('已解绑客户存储,站点回到平台默认桶');
2505
+ });
2506
+ },
2507
+ };
2508
+
2509
+ /** `publish storage publish` —— 把现有成品整批镜像到客户桶 */
2510
+ export const publishStoragePublishCommand = {
2511
+ name: 'publish storage publish',
2512
+ summary: '把现有成品整批镜像到客户桶(同步一次)',
2513
+ usage: 'wkgeo publish storage publish [--site <站点ID>] [--confirm] [--json]',
2514
+ args: [],
2515
+ flags: { ...SITE_FLAG, confirm: { type: 'boolean', desc: '真同步(不加只报错)' } },
2516
+ examples: ['wkgeo publish storage publish --confirm'],
2517
+ notes: [
2518
+ '平时不用它:发布任务成功后会自己镜像(除非线上把 `CMS_EXTERNAL_MIRROR` 关了)。',
2519
+ '配好桶之后想立刻把存量页面同步过去,就跑这一条。',
2520
+ ],
2521
+ async run(ctx) {
2522
+ const site = publishSiteOrThrow(ctx);
2523
+ if (ctx.flags.confirm !== true) {
2524
+ throw new UsageError('这会往客户桶写对象:确认后加 `--confirm` 再执行', {
2525
+ hint: `wkgeo publish storage publish --site ${site.id} --confirm`,
2526
+ });
2527
+ }
2528
+ return publishCallData(ctx, 'cmsSiteStorageTargetPublish', {}, (data) => {
2529
+ const r = data.result || data;
2530
+ ctx.out.ok(`镜像完成:上传 ${r.uploaded ?? r.files ?? 0} 个对象(跳过 ${r.skipped ?? 0})`);
2531
+ });
2532
+ },
2533
+ };