@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.
- package/CHANGELOG.md +208 -0
- package/LICENSE +21 -0
- package/README.md +1042 -3
- package/SKILL.md +927 -0
- package/lib/ai/client.mjs +161 -0
- package/lib/ai/config.mjs +221 -0
- package/lib/ai/context.mjs +468 -0
- package/lib/ai/log.mjs +53 -0
- package/lib/api.mjs +339 -0
- package/lib/args.mjs +235 -0
- package/lib/cli.mjs +168 -0
- package/lib/cms.mjs +330 -0
- package/lib/commands/ai.mjs +392 -0
- package/lib/commands/apps.mjs +116 -0
- package/lib/commands/auth.mjs +1288 -0
- package/lib/commands/billing.mjs +666 -0
- package/lib/commands/cms.mjs +2533 -0
- package/lib/commands/config-auth.mjs +621 -0
- package/lib/commands/config.mjs +434 -0
- package/lib/commands/dnscred.mjs +428 -0
- package/lib/commands/domainops.mjs +546 -0
- package/lib/commands/domainorder.mjs +439 -0
- package/lib/commands/import.mjs +164 -0
- package/lib/commands/index.mjs +528 -0
- package/lib/commands/logs.mjs +141 -0
- package/lib/commands/orders.mjs +444 -0
- package/lib/commands/overview.mjs +394 -0
- package/lib/commands/plugins.mjs +678 -0
- package/lib/commands/site.mjs +435 -0
- package/lib/commands/siteops.mjs +1012 -0
- package/lib/commands/sites.mjs +905 -0
- package/lib/commands/skill.mjs +119 -0
- package/lib/config.mjs +351 -0
- package/lib/credentials.mjs +160 -0
- package/lib/device-store.mjs +132 -0
- package/lib/device.mjs +464 -0
- package/lib/errors.mjs +299 -0
- package/lib/format.mjs +339 -0
- package/lib/http.mjs +71 -0
- package/lib/index.mjs +44 -0
- package/lib/local-import.mjs +185 -0
- package/lib/login.mjs +1638 -0
- package/lib/oauth-urls.mjs +163 -0
- package/lib/page.mjs +393 -0
- package/lib/pkce.mjs +48 -0
- package/lib/proxy.mjs +454 -0
- package/lib/qr.mjs +31 -0
- package/lib/runtime.mjs +650 -0
- package/lib/site-state.mjs +137 -0
- package/package.json +53 -4
- package/wkgeo.mjs +17 -0
|
@@ -0,0 +1,905 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* 站点命令:`sites list` / `sites create` / `sites delete`
|
|
3
|
+
*
|
|
4
|
+
* 归属口径(**服务端是权威,CLI 只做复核**):
|
|
5
|
+
* 服务端 `handleCreateSite` 把 `owner_user_id` 和 `created_by` 都写成**令牌所属用户**,
|
|
6
|
+
* 客户端传什么都不作数。CLI 建完会回读一次并核对,避免"以为建在自己名下其实不是"。
|
|
7
|
+
*
|
|
8
|
+
* 2026-10-27 客户层删除后,建站不再需要任何归属参数(服务端直接取登录态用户),
|
|
9
|
+
* 旧的 `--customer` 指引与「无法确定所属客户」文案一并下线。
|
|
10
|
+
*
|
|
11
|
+
* ---------------------------------------------------------------------------
|
|
12
|
+
* 2026-10-22(task-97):`sites list` 从"一张只读表格"改成**站点管理入口**
|
|
13
|
+
* ---------------------------------------------------------------------------
|
|
14
|
+
* 1. **默认只看我名下的站**(`--mine` 默认;`--managed` / `--all` 可选)。
|
|
15
|
+
* 后端的 `listSites` 已支持 `mine` / `includeManaged`(见 `aliyun/fc/wkgeo-user/src`),
|
|
16
|
+
* 但 CLI 不能假设线上一定部署了新版本 —— 于是**再在本地复核一遍**:
|
|
17
|
+
* * `--mine`:服务端没过滤掉别人的站时,按 `owner_user_id` 本地再收窄(只收窄、不放宽);
|
|
18
|
+
* * `--managed`:服务端不认 `includeManaged`(行上没有 `relation`)时,退化成"我拥有的",
|
|
19
|
+
* 协作站由下面的 CMS 侧合并补上。
|
|
20
|
+
* 2. **CMS-only 站点也要能看到**:有的站只存在于 `cms_site`(没有平台 `site` 行),
|
|
21
|
+
* `listSites` 永远查不到。所以列表会**顺带**调 CMS 侧的 `siteImportSites`
|
|
22
|
+
* (该动作本来就支持"还没选站时列我能编辑的站",服务端动作表里现成可用),
|
|
23
|
+
* 按站点 id 合并去重;失败**绝不影响** `sites list` 本身(只在信封里如实标注)。
|
|
24
|
+
* 3. **没有站 → 引导建站**(只在交互终端且非 JSON 时提问):
|
|
25
|
+
* `∅ 你还没有站点,是否现在创建一个?(Y/n)` → 问名称/模板/地区 →
|
|
26
|
+
* 优先走 **CMS 通道** `ctx.cmsCall('cmsCreateSite')`(建站实现在 CMS 云函数里,
|
|
27
|
+
* 平台 `/api/data` 面**没有**这个动作),服务端回"未知动作/400"时回退 `createSite`,
|
|
28
|
+
* 并明确提示 **CMS 站点未创建**(当前线上就是这种状态,别让用户以为 CMS 后台也有了)。
|
|
29
|
+
* 4. **有站 → 选一个来管理**:列序号 → `选择要管理的站点(回车=上次)` →
|
|
30
|
+
* 写本地 config(与 `wkgeo site use` 完全同一条落盘路径)。
|
|
31
|
+
* 5. `--json` / 非 TTY **一律不提问**:没站就输出 `{sites:[], hint:'no_sites'}`,exit 0。
|
|
32
|
+
*/
|
|
33
|
+
|
|
34
|
+
import { CliError, UsageError } from '../errors.mjs';
|
|
35
|
+
import { formatTime } from '../format.mjs';
|
|
36
|
+
import { readSiteState } from '../site-state.mjs';
|
|
37
|
+
import { rememberSite } from './cms.mjs';
|
|
38
|
+
|
|
39
|
+
/**
|
|
40
|
+
* 站点行归一(平台面与 CMS 面字段名不同,先收敛成一个形状再合并)。
|
|
41
|
+
*
|
|
42
|
+
* ⚠️ 归属字段(task-9 / A3):平台 `listSites` 的行字段叫 **`owner_id`**,
|
|
43
|
+
* 0.5.1 只读 `owner_user_id` ⇒ 每一行都是 `null`,`sites create` 建完还会误报
|
|
44
|
+
* 「站点归属(null) ≠ 当前账号」。这里依次兜底 `owner_user_id` → `owner_id` →
|
|
45
|
+
* `created_by`(服务端建站时三者同源),**不再用不存在的字段**。
|
|
46
|
+
*/
|
|
47
|
+
function normalizeSite(res, source = 'platform') {
|
|
48
|
+
const s = res || {};
|
|
49
|
+
/** 短域(平台面 `prefix_host`,CMS 面 `prefixHost`) */
|
|
50
|
+
const prefixHost = s.prefix_host || s.prefixHost || null;
|
|
51
|
+
/** 自有/绑定域名(平台面 `custom_domain` / `cms_domain`,CMS 面 `domain`) */
|
|
52
|
+
const customDomain = s.custom_domain || s.cms_domain || s.domain || null;
|
|
53
|
+
/** 列表「域名」列:优先自有域名;CMS-only 站没有自有域名时退回短域(沿用 0.5.x 展示口径) */
|
|
54
|
+
const domain = customDomain || (source === 'cms' ? prefixHost : null);
|
|
55
|
+
const ownerId = s.owner_user_id || s.owner_id || s.ownerId || null;
|
|
56
|
+
const createdBy = s.created_by || s.createdBy || null;
|
|
57
|
+
/** 旧版接口没有 `prefix_kv_written` ⇒ null(**不能当 false**,否则会误报"短域没写进去") */
|
|
58
|
+
const kvWritten = typeof s.prefix_kv_written === 'boolean' ? s.prefix_kv_written : null;
|
|
59
|
+
return {
|
|
60
|
+
id: s.id ? String(s.id) : null,
|
|
61
|
+
name: s.name || null,
|
|
62
|
+
status: s.status || null,
|
|
63
|
+
domain: domain || null,
|
|
64
|
+
domains: Array.isArray(s.domains) ? s.domains : [],
|
|
65
|
+
/** 短域 + 可访问地址(没分配 = null) */
|
|
66
|
+
prefix_host: prefixHost,
|
|
67
|
+
prefix_url: s.prefix_url || (prefixHost ? `https://${prefixHost}/` : null),
|
|
68
|
+
/** 建站时短域解析有没有写进 KV:true / false / null(未知) */
|
|
69
|
+
prefix_kv_written: kvWritten,
|
|
70
|
+
/** 写后回读确认(只有走发布执行器才可能 true) */
|
|
71
|
+
prefix_kv_verified: typeof s.prefix_kv_verified === 'boolean' ? s.prefix_kv_verified : null,
|
|
72
|
+
/** 站点开通/发布状态:none / provisioning / active / failed */
|
|
73
|
+
provision_state: s.provision_state || null,
|
|
74
|
+
/** 自有域名(`--domain` 登记的那个;未登记 = null) */
|
|
75
|
+
custom_domain: customDomain,
|
|
76
|
+
owner_user_id: ownerId ? String(ownerId) : createdBy ? String(createdBy) : null,
|
|
77
|
+
/** 原始归属字段(排查"到底是哪个字段有值"用) */
|
|
78
|
+
owner_id: ownerId ? String(ownerId) : null,
|
|
79
|
+
created_by: createdBy ? String(createdBy) : null,
|
|
80
|
+
created_at: s.created_at || null,
|
|
81
|
+
expires_at: s.expires_at || null,
|
|
82
|
+
/** `owner` / `managed`(平台面 includeManaged 才有)/ `cms`(CMS 侧补进来的) */
|
|
83
|
+
relation: s.relation || (source === 'cms' ? 'cms' : null),
|
|
84
|
+
role: s.role || null,
|
|
85
|
+
/** 站点来自哪一侧:`platform` / `cms` */
|
|
86
|
+
source,
|
|
87
|
+
/** 只在 CMS 里存在(平台 `listSites` 里没有这一行) */
|
|
88
|
+
cms_only: source === 'cms',
|
|
89
|
+
...(source === 'cms' && s.canWrite !== undefined ? { can_write: Boolean(s.canWrite) } : {}),
|
|
90
|
+
};
|
|
91
|
+
}
|
|
92
|
+
|
|
93
|
+
/** `getSite` 里这几个是**大 JSON 块**,可能存第三方 Key(百度/必应/Google),不往终端打 */
|
|
94
|
+
const SITE_BLOB_FIELDS = ['settings', 'theme', 'layout', 'info', 'template_config'];
|
|
95
|
+
|
|
96
|
+
/** 站点详情:`getSite` 的标量字段全量透出(大 JSON 块除外,见 SITE_BLOB_FIELDS) */
|
|
97
|
+
function pickSiteDetail(res) {
|
|
98
|
+
const detail = {};
|
|
99
|
+
for (const [key, value] of Object.entries(res || {})) {
|
|
100
|
+
if (SITE_BLOB_FIELDS.includes(key) || value === undefined) continue;
|
|
101
|
+
detail[key] = value;
|
|
102
|
+
}
|
|
103
|
+
return detail;
|
|
104
|
+
}
|
|
105
|
+
|
|
106
|
+
/** 短域 → 统一小对象(没分配就是 null;`kv_written` 缺失 = null,别当 false) */
|
|
107
|
+
function shortDomainOf(site) {
|
|
108
|
+
if (!site || !site.prefix_host) return null;
|
|
109
|
+
return {
|
|
110
|
+
host: site.prefix_host,
|
|
111
|
+
url: site.prefix_url || `https://${site.prefix_host}/`,
|
|
112
|
+
kv_written: site.prefix_kv_written,
|
|
113
|
+
kv_verified: site.prefix_kv_verified,
|
|
114
|
+
};
|
|
115
|
+
}
|
|
116
|
+
|
|
117
|
+
/**
|
|
118
|
+
* 归属复核(A3):拿不到 owner 时回 `null`(未知)——
|
|
119
|
+
* 0.5.1 把"字段不存在"当成"不一致"乱告警,比不告警更糟。
|
|
120
|
+
*/
|
|
121
|
+
function checkOwnership(site, meId) {
|
|
122
|
+
if (!meId) return { ok: null, reason: 'no_current_user' };
|
|
123
|
+
if (!site || !site.owner_user_id) return { ok: null, reason: 'owner_unknown' };
|
|
124
|
+
if (site.owner_user_id === meId) return { ok: true, reason: 'owner' };
|
|
125
|
+
return { ok: false, reason: 'owner_mismatch' };
|
|
126
|
+
}
|
|
127
|
+
|
|
128
|
+
/** 短域人话(A2):KV 没写进去 ⇒ 访问会 403/404,必须明确告警 */
|
|
129
|
+
function printShortDomain(out, site, { channel = 'platform' } = {}) {
|
|
130
|
+
if (!site || !site.prefix_host) {
|
|
131
|
+
if (channel === 'cms') {
|
|
132
|
+
/** CMS 走 `cmsCreateSite`,返回体里没有短域 —— 平台侧可能已经分配了,别急着说"未分配" */
|
|
133
|
+
out.info(' 短域:CMS 通道的返回里没有,跑 `wkgeo sites get <站点ID>` 看平台有没有分配');
|
|
134
|
+
return;
|
|
135
|
+
}
|
|
136
|
+
out.info(' 短域:未分配(平台没给短域后缀;不影响站点本身)');
|
|
137
|
+
return;
|
|
138
|
+
}
|
|
139
|
+
out.line(` 短域:${site.prefix_url || `https://${site.prefix_host}/`}`);
|
|
140
|
+
if (site.prefix_kv_written === true) {
|
|
141
|
+
out.info(' → 短域解析已写入(可以直接访问)');
|
|
142
|
+
} else if (site.prefix_kv_written === false) {
|
|
143
|
+
out.warn('短域解析未写入(prefix_kv_written=false):现在访问短域会 403/404。');
|
|
144
|
+
/**
|
|
145
|
+
* TODO(task-9 / 后端 B2):等 `domain repair`(重写短域 KV)动作上线后接上 ——
|
|
146
|
+
* 现在只能在文案里指路,**不要**在 CLI 里假装能修(否则就是"命令回成功、站点还是打不开")。
|
|
147
|
+
*/
|
|
148
|
+
out.info(' → 修复要等后端 `domain repair` 上线后跑 `wkgeo domain repair --site <站点ID>`;在此之前请联系管理员重写该站短域 KV。');
|
|
149
|
+
} else {
|
|
150
|
+
out.info(' → 短域解析写入结果:服务端未返回(旧版接口)—— 直接打开上面的地址试一下就知道');
|
|
151
|
+
}
|
|
152
|
+
}
|
|
153
|
+
|
|
154
|
+
/** 当前登录用户 id(拿不到就 null:只影响本地复核,不影响列表本身) */
|
|
155
|
+
function currentUserId(ctx) {
|
|
156
|
+
try {
|
|
157
|
+
const creds = ctx.requireAuth();
|
|
158
|
+
return creds && creds.account ? String(creds.account.sub || '') || null : null;
|
|
159
|
+
} catch {
|
|
160
|
+
return null;
|
|
161
|
+
}
|
|
162
|
+
}
|
|
163
|
+
|
|
164
|
+
/** 解析 `--mine/--managed/--all` → `'mine' | 'managed' | 'all'`(默认 mine) */
|
|
165
|
+
export function resolveListMode(flags = {}) {
|
|
166
|
+
const picked = ['managed', 'all'].filter((k) => flags[k] === true);
|
|
167
|
+
if (picked.length > 1) {
|
|
168
|
+
throw new UsageError('--managed 与 --all 只能给一个(默认 --mine)');
|
|
169
|
+
}
|
|
170
|
+
if (picked.length === 1 && flags.mine === true) {
|
|
171
|
+
throw new UsageError(`--mine 与 --${picked[0]} 只能给一个(默认就是 --mine)`);
|
|
172
|
+
}
|
|
173
|
+
if (picked.length === 1) return picked[0];
|
|
174
|
+
/** `--no-mine` = 不按 owner 收窄(等同 --all);默认(没写)= mine */
|
|
175
|
+
return flags.mine === false ? 'all' : 'mine';
|
|
176
|
+
}
|
|
177
|
+
|
|
178
|
+
/**
|
|
179
|
+
* 补列 CMS 侧的站(`siteImportSites`:我拥有的 + 我参与的 CMS 站点)。
|
|
180
|
+
*
|
|
181
|
+
* **best-effort**:这个调用失败了不能把 `sites list` 弄挂 —— 平台面列表已经拿到了。
|
|
182
|
+
* 失败原因如实放进信封(`cms_list_ok:false` / `cms_list_error`),排障时能一眼看到
|
|
183
|
+
* "是 CMS 面没通,不是你没站"。
|
|
184
|
+
*/
|
|
185
|
+
async function listCmsSites(ctx) {
|
|
186
|
+
try {
|
|
187
|
+
const res = await ctx.cmsCall('siteImportSites', {});
|
|
188
|
+
const rows = Array.isArray(res) ? res : res && Array.isArray(res.rows) ? res.rows : [];
|
|
189
|
+
return { ok: true, rows: rows.map((r) => normalizeSite(r, 'cms')), error: null };
|
|
190
|
+
} catch (e) {
|
|
191
|
+
return {
|
|
192
|
+
ok: false,
|
|
193
|
+
rows: [],
|
|
194
|
+
error: { kind: (e && e.kind) || 'error', message: (e && e.message) || String(e) },
|
|
195
|
+
};
|
|
196
|
+
}
|
|
197
|
+
}
|
|
198
|
+
|
|
199
|
+
/** 合并去重:平台面的行优先,CMS-only 的行按 id 补在后面 */
|
|
200
|
+
export function mergeSites(platformRows, cmsRows) {
|
|
201
|
+
const out = [];
|
|
202
|
+
const seen = new Set();
|
|
203
|
+
for (const row of platformRows || []) {
|
|
204
|
+
if (!row || !row.id || seen.has(row.id)) continue;
|
|
205
|
+
seen.add(row.id);
|
|
206
|
+
out.push(row);
|
|
207
|
+
}
|
|
208
|
+
let cmsOnly = 0;
|
|
209
|
+
for (const row of cmsRows || []) {
|
|
210
|
+
if (!row || !row.id || seen.has(row.id)) continue;
|
|
211
|
+
seen.add(row.id);
|
|
212
|
+
cmsOnly += 1;
|
|
213
|
+
out.push(row);
|
|
214
|
+
}
|
|
215
|
+
return { sites: out, cmsOnly };
|
|
216
|
+
}
|
|
217
|
+
|
|
218
|
+
/**
|
|
219
|
+
* 服务端还是旧版、`listSites` 没认 `mine` 时,按**全量**拉回来在本地筛。
|
|
220
|
+
*
|
|
221
|
+
* 为什么要多这一步:只筛当前页的话,用户第 51 个站以后永远看不见,
|
|
222
|
+
* 而他看到的结论会是"这不是我的站"——比直接报错更糟。
|
|
223
|
+
* 上限 10 页 × 200 条(2000 个站)足够,且只在"发现别人的站混进来"这个分支才发生,
|
|
224
|
+
* 正常部署(认 `mine`)一次请求都不会多。
|
|
225
|
+
*/
|
|
226
|
+
async function fetchAllPlatformSites(ctx) {
|
|
227
|
+
const limit = 200;
|
|
228
|
+
const all = [];
|
|
229
|
+
for (let page = 0; page < 10; page++) {
|
|
230
|
+
const res = await ctx.callData('listSites', { limit, offset: page * limit });
|
|
231
|
+
const list = (res && Array.isArray(res.rows) ? res.rows : [])
|
|
232
|
+
.map((r) => normalizeSite(r, 'platform'))
|
|
233
|
+
.filter((r) => r.id);
|
|
234
|
+
all.push(...list);
|
|
235
|
+
const total = Number(res && res.total) || 0;
|
|
236
|
+
if (list.length < limit || all.length >= total) break;
|
|
237
|
+
}
|
|
238
|
+
return all;
|
|
239
|
+
}
|
|
240
|
+
|
|
241
|
+
/**
|
|
242
|
+
* `--with-prefix`:平台 `listSites` 的 SQL **不返回 `prefix_host`**(实测字段表见 task-9),
|
|
243
|
+
* 所以列表里的短域列对平台站是空的。这个开关逐站补一次 `getSite` 把短域填上 ——
|
|
244
|
+
* 默认关,因为它是 N+1 次请求;要看单站详情用 `sites get` 更省。
|
|
245
|
+
*/
|
|
246
|
+
async function fillPrefixHosts(ctx, sites) {
|
|
247
|
+
const stat = { requested: 0, filled: 0, failed: 0 };
|
|
248
|
+
for (const row of sites || []) {
|
|
249
|
+
if (!row || !row.id || row.prefix_host) continue;
|
|
250
|
+
stat.requested += 1;
|
|
251
|
+
try {
|
|
252
|
+
const one = normalizeSite(await ctx.callData('getSite', { id: row.id }), 'platform');
|
|
253
|
+
if (one.prefix_host) {
|
|
254
|
+
row.prefix_host = one.prefix_host;
|
|
255
|
+
row.prefix_url = one.prefix_url;
|
|
256
|
+
stat.filled += 1;
|
|
257
|
+
}
|
|
258
|
+
if (!row.provision_state && one.provision_state) row.provision_state = one.provision_state;
|
|
259
|
+
if (!row.domain && one.domain) row.domain = one.domain;
|
|
260
|
+
if (!row.custom_domain && one.custom_domain) row.custom_domain = one.custom_domain;
|
|
261
|
+
} catch {
|
|
262
|
+
stat.failed += 1;
|
|
263
|
+
}
|
|
264
|
+
}
|
|
265
|
+
return stat;
|
|
266
|
+
}
|
|
267
|
+
|
|
268
|
+
/** 交互提问:只在"真人在终端"时发生(`--json` / 非 TTY 一律不问) */
|
|
269
|
+
function isInteractive(ctx) {
|
|
270
|
+
return Boolean(ctx && ctx.isTTY && ctx.stdinIsTTY && !ctx.out.json);
|
|
271
|
+
}
|
|
272
|
+
|
|
273
|
+
/** 是/否提问;默认值按 `defaultYes`(空回车 = 默认) */
|
|
274
|
+
async function askYes(ctx, question, defaultYes = true) {
|
|
275
|
+
const raw = await ctx.ask(question);
|
|
276
|
+
const answer = String(raw == null ? '' : raw).trim().toLowerCase();
|
|
277
|
+
if (!answer) return defaultYes;
|
|
278
|
+
return !['n', 'no', '否', '不', '0'].includes(answer);
|
|
279
|
+
}
|
|
280
|
+
|
|
281
|
+
/** 序号 / 站点 id → 站点行;认不出来返回 null(由调用方决定重问还是报错) */
|
|
282
|
+
function pickSite(rows, answer) {
|
|
283
|
+
const text = String(answer == null ? '' : answer).trim();
|
|
284
|
+
if (!text) return null;
|
|
285
|
+
if (/^\d+$/.test(text)) {
|
|
286
|
+
const idx = Number(text);
|
|
287
|
+
if (idx >= 1 && idx <= rows.length) return rows[idx - 1];
|
|
288
|
+
return null;
|
|
289
|
+
}
|
|
290
|
+
return rows.find((r) => r.id === text) || null;
|
|
291
|
+
}
|
|
292
|
+
|
|
293
|
+
/** 把站点选择写进本地 config(与 `wkgeo site use` 同一条落盘路径) */
|
|
294
|
+
function saveSelectedSite(ctx, site) {
|
|
295
|
+
rememberSite(ctx, { id: site.id, label: site.name || site.domain || '' });
|
|
296
|
+
}
|
|
297
|
+
|
|
298
|
+
/**
|
|
299
|
+
* `cmsCreateSite` 认的地区词(`aliyun/fc/wkgeo-cms/src` 的 `normalizeCmsSiteRegion`)。
|
|
300
|
+
* ⚠️ 与平台 `createSite` 的自由写法(`cn-shanghai`)**不是一套词表**,不能原样转过去。
|
|
301
|
+
*/
|
|
302
|
+
const CMS_CREATE_REGIONS = new Map([
|
|
303
|
+
['domestic', 'domestic'],
|
|
304
|
+
['cn1', 'cn1'],
|
|
305
|
+
['国内', 'domestic'],
|
|
306
|
+
['overseas', 'overseas'],
|
|
307
|
+
['intl', 'intl'],
|
|
308
|
+
['海外', 'overseas'],
|
|
309
|
+
['global', 'global'],
|
|
310
|
+
['全球', 'global'],
|
|
311
|
+
]);
|
|
312
|
+
|
|
313
|
+
/** uuid 形状 = 平台面的"模板 ID";CMS 建站的 `template` 要的是内置模板**名字** */
|
|
314
|
+
function looksLikeUuid(value) {
|
|
315
|
+
return /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i.test(String(value || '').trim());
|
|
316
|
+
}
|
|
317
|
+
|
|
318
|
+
/**
|
|
319
|
+
* 没站时的建站引导(只在交互模式调用)。
|
|
320
|
+
*
|
|
321
|
+
* 建站动作有两套,**在两个不同的服务端 / 两条不同的通道上**(这是 2026-10-22 修的 bug):
|
|
322
|
+
* 1. `cmsCreateSite` —— **CMS 云函数**(`POST {cmsBase}/cmsCreateSite`,走 `ctx.cmsCall`),
|
|
323
|
+
* 一次建出:`cms_site` + owner 成员行 + 复制内置模板 +(缺则补)`public.site`,
|
|
324
|
+
* 所以 CMS 后台立刻能发内容。CLI 用的契约名是 `createCmsSite`
|
|
325
|
+
* (服务端 `resolveActionAlias()` 归一化到规范名 `cmsCreateSite`)。
|
|
326
|
+
* 2. `createSite` —— **平台 `/api/data`**(`ctx.callData`),老动作,只建平台站,
|
|
327
|
+
* **CMS 站不会跟着建**。
|
|
328
|
+
*
|
|
329
|
+
* ⚠️ 历史 bug(task-124 修的就是它):这里原来写的是 `ctx.callData('createCmsSite')`
|
|
330
|
+
* —— 把 CMS 动作发到了平台 `/api/data`,那边永远回"未知动作",于是**永远**走回退、
|
|
331
|
+
* 只建平台站。现在改成 CMS 通道,回退条件与错误口径保持不变:
|
|
332
|
+
* 只有「未知动作 / 400」才回退;网络 / 401 / 429 / 5xx 照常抛(否则故障会被伪装成建站成功)。
|
|
333
|
+
*/
|
|
334
|
+
async function createSiteByGuide(ctx) {
|
|
335
|
+
const { out } = ctx;
|
|
336
|
+
|
|
337
|
+
const name = String((await ctx.ask('站点名称(回车=我的站点):')) || '').trim() || '我的站点';
|
|
338
|
+
const template = String((await ctx.ask('模板名或模板 ID(可选,回车=默认模板):')) || '').trim();
|
|
339
|
+
const region = String(
|
|
340
|
+
(await ctx.ask('地区(可选:domestic / overseas / global,或区域码如 cn-shanghai;回车=默认):')) || '',
|
|
341
|
+
).trim();
|
|
342
|
+
|
|
343
|
+
/** 平台 `createSite` 的入参(老动作) */
|
|
344
|
+
const payload = { name };
|
|
345
|
+
if (template) payload.template_id = template;
|
|
346
|
+
/** `createSite` 没有 region 字段,但接受自由 `settings` */
|
|
347
|
+
if (region) payload.settings = { region };
|
|
348
|
+
|
|
349
|
+
/**
|
|
350
|
+
* CMS 建站入参 —— **不能把平台入参原样转过去**(两个词表不一样,转错就是 400):
|
|
351
|
+
* * `region` 只认 domestic / cn1 / overseas / intl / global / 国内 / 海外 / 全球;
|
|
352
|
+
* 认不出(如 `cn-shanghai`)就**不传**,让服务端用默认 domestic;
|
|
353
|
+
* * `template` 要内置模板**名字**;用户填的是 uuid(平台模板 ID)时不传,用默认模板。
|
|
354
|
+
*/
|
|
355
|
+
const cmsPayload = { name };
|
|
356
|
+
if (template && !looksLikeUuid(template)) cmsPayload.template = template;
|
|
357
|
+
const regionWord = CMS_CREATE_REGIONS.get(region.toLowerCase());
|
|
358
|
+
if (regionWord) cmsPayload.region = regionWord;
|
|
359
|
+
|
|
360
|
+
let site = null;
|
|
361
|
+
let cmsSiteCreated = false;
|
|
362
|
+
let cmsError = null;
|
|
363
|
+
let cmsWarnings = [];
|
|
364
|
+
|
|
365
|
+
try {
|
|
366
|
+
/**
|
|
367
|
+
* ★ 建站走 **CMS 通道**;`noSite: true` = 无站点模式:
|
|
368
|
+
* 此时新站点还不存在,绝不能带本地那个(可能残留的)"当前站点" `x-cms-site`。
|
|
369
|
+
*/
|
|
370
|
+
const res = await ctx.cmsCall('createCmsSite', cmsPayload, { noSite: true });
|
|
371
|
+
/** CMS 回的是 `{ site: {...}, created, templateCopied, publicSite, warnings }`,不是扁平站点行 */
|
|
372
|
+
const row = (res && res.site) || res;
|
|
373
|
+
site = normalizeSite(row, 'cms');
|
|
374
|
+
if (!site || !site.id) {
|
|
375
|
+
throw new CliError('CMS 建站接口没有返回站点 id', {
|
|
376
|
+
kind: 'bad_response',
|
|
377
|
+
hint: '服务端可能刚升级 / 部署不完整;请稍后用 `wkgeo sites list` 确认,或到网页后台查看。',
|
|
378
|
+
});
|
|
379
|
+
}
|
|
380
|
+
cmsSiteCreated = true;
|
|
381
|
+
if (res && Array.isArray(res.warnings)) cmsWarnings = res.warnings.map(String).filter(Boolean);
|
|
382
|
+
} catch (e) {
|
|
383
|
+
/**
|
|
384
|
+
* 只有"服务端还不认识这个动作"(未知动作 / 400)才回退;网络错误 / 401 / 429 / 500 照常抛,
|
|
385
|
+
* 否则会把真正的故障伪装成"建站成功"。
|
|
386
|
+
*/
|
|
387
|
+
if (!isMissingCmsAction(e)) throw e;
|
|
388
|
+
cmsError = (e && e.message) || String(e);
|
|
389
|
+
}
|
|
390
|
+
|
|
391
|
+
if (!cmsSiteCreated) {
|
|
392
|
+
site = normalizeSite(await ctx.callData('createSite', payload), 'platform');
|
|
393
|
+
}
|
|
394
|
+
|
|
395
|
+
if (!site || !site.id) {
|
|
396
|
+
throw new CliError('建站接口没有返回站点 id', {
|
|
397
|
+
kind: 'bad_response',
|
|
398
|
+
hint: '服务端可能刚升级 / 部署不完整;请稍后用 `wkgeo sites list` 确认,或到网页后台查看。',
|
|
399
|
+
});
|
|
400
|
+
}
|
|
401
|
+
|
|
402
|
+
/** 建完就记成"当前站点":下一步的 CMS 命令不用再选一次 */
|
|
403
|
+
saveSelectedSite(ctx, site);
|
|
404
|
+
|
|
405
|
+
if (!out.json) {
|
|
406
|
+
out.ok(`站点已创建并设为当前站点:${site.name || site.id}`);
|
|
407
|
+
out.line(` 站点 ID:${site.id}`);
|
|
408
|
+
if (cmsSiteCreated) {
|
|
409
|
+
out.line(' CMS 站点:已同时创建');
|
|
410
|
+
} else {
|
|
411
|
+
out.line(' 通道:平台(createSite)');
|
|
412
|
+
}
|
|
413
|
+
/** A2:短域 + KV 写入结果一并说明(交互建站同样不能把"短域打不开"藏起来) */
|
|
414
|
+
printShortDomain(out, site, { channel: cmsSiteCreated ? 'cms' : 'platform' });
|
|
415
|
+
if (cmsSiteCreated) {
|
|
416
|
+
/** 服务端能"软着陆"的缺口(模板 / public.site 补建等)如实转述,别让用户以为全好了 */
|
|
417
|
+
for (const warn of cmsWarnings) out.info(` ⚠️ ${warn}`);
|
|
418
|
+
} else {
|
|
419
|
+
out.warn('CMS 站点未创建:CMS 通道没有接受建站动作,本次只建了平台站点。');
|
|
420
|
+
out.info(' → 栏目 / 内容 / 素材等 CMS 命令暂时用不了;等 CMS 站点就绪后再试,或联系管理员在后台补建。');
|
|
421
|
+
}
|
|
422
|
+
} else if (!cmsSiteCreated) {
|
|
423
|
+
out.warn('CMS 站点未创建(CMS 通道回退 createSite)');
|
|
424
|
+
}
|
|
425
|
+
/** JSON 模式同理:短域进返参,KV 未写入走 stderr */
|
|
426
|
+
if (out.json) printShortDomain(out, site, { channel: cmsSiteCreated ? 'cms' : 'platform' });
|
|
427
|
+
|
|
428
|
+
return {
|
|
429
|
+
site,
|
|
430
|
+
sites: [site],
|
|
431
|
+
rows: [site],
|
|
432
|
+
total: 1,
|
|
433
|
+
server_total: 1,
|
|
434
|
+
cms_only_count: site.cms_only ? 1 : 0,
|
|
435
|
+
created: true,
|
|
436
|
+
/** 交互引导固定按 auto 口径:先 CMS,明确不支持才回退平台 */
|
|
437
|
+
channel: cmsSiteCreated ? 'cms' : 'platform',
|
|
438
|
+
channel_requested: 'auto',
|
|
439
|
+
cms_site_created: cmsSiteCreated,
|
|
440
|
+
cms_error: cmsSiteCreated ? null : cmsError,
|
|
441
|
+
cms_warnings: cmsWarnings,
|
|
442
|
+
/** A2:短域 + KV 写入结果(null = 平台没分配 / CMS 返回里没有) */
|
|
443
|
+
short_domain: shortDomainOf(site),
|
|
444
|
+
/** 交互引导不登记域名 ⇒ 这两个字段没有意义,固定 null */
|
|
445
|
+
domain_requested: null,
|
|
446
|
+
domain_registered: null,
|
|
447
|
+
hint: null,
|
|
448
|
+
};
|
|
449
|
+
}
|
|
450
|
+
|
|
451
|
+
/** 是不是"服务端还没有这个动作"(未知动作 / 400)—— 用来决定要不要回退 `createSite` */
|
|
452
|
+
function isMissingCmsAction(e) {
|
|
453
|
+
if (!e) return false;
|
|
454
|
+
const msg = String(e.message || '');
|
|
455
|
+
if (e.kind === 'not_deployed') return true;
|
|
456
|
+
if (/未知动作|不认识的\s*action|unknown action/i.test(msg)) return true;
|
|
457
|
+
return e.code === 400;
|
|
458
|
+
}
|
|
459
|
+
|
|
460
|
+
/**
|
|
461
|
+
* 有站时让用户选一个来管理(只在交互模式调用)。
|
|
462
|
+
*
|
|
463
|
+
* 默认值(空回车)= 上次选过的那个;从没选过就选第 1 个(并在提示里写明)。
|
|
464
|
+
* 输入既可以是序号,也可以直接粘站点 ID —— 两种都常见,没必要逼用户数序号。
|
|
465
|
+
*/
|
|
466
|
+
async function chooseSiteByGuide(ctx, rows) {
|
|
467
|
+
const { out } = ctx;
|
|
468
|
+
const current = readSiteState(ctx.siteStateFile);
|
|
469
|
+
let defaultIndex = current ? rows.findIndex((r) => r.id === current.id) + 1 : 0;
|
|
470
|
+
const currentMissing = Boolean(current && !defaultIndex);
|
|
471
|
+
if (!defaultIndex) defaultIndex = 1;
|
|
472
|
+
|
|
473
|
+
/** 带序号再列一遍:选择这一步要"照着敲",不能让人回头数表格 */
|
|
474
|
+
out.line('');
|
|
475
|
+
for (let i = 0; i < rows.length; i++) {
|
|
476
|
+
const r = rows[i];
|
|
477
|
+
const mark = current && current.id === r.id ? ' ★ 当前' : '';
|
|
478
|
+
const src = r.cms_only ? '(仅 CMS)' : r.relation === 'managed' ? '(协作)' : '';
|
|
479
|
+
out.line(` ${String(i + 1).padStart(2)}. ${r.name || '(未命名)'}${src} ${r.id}${mark}`);
|
|
480
|
+
}
|
|
481
|
+
if (!current) out.info(`(还没有上次选择,回车=第 ${defaultIndex} 个)`);
|
|
482
|
+
else if (currentMissing) {
|
|
483
|
+
out.info(`(上次选的 ${current.label || current.id} 不在本列表里,回车=第 ${defaultIndex} 个)`);
|
|
484
|
+
}
|
|
485
|
+
|
|
486
|
+
for (let attempt = 0; attempt < 3; attempt++) {
|
|
487
|
+
const answer = await ctx.ask('选择要管理的站点(回车=上次):');
|
|
488
|
+
const picked = String(answer == null ? '' : answer).trim() ? pickSite(rows, answer) : rows[defaultIndex - 1];
|
|
489
|
+
if (picked) {
|
|
490
|
+
saveSelectedSite(ctx, picked);
|
|
491
|
+
out.ok(`已选中站点:${picked.name || picked.id}(${picked.id})`);
|
|
492
|
+
out.info(' 之后的 CMS 命令默认都用这个站;临时换站:任意 CMS 命令加 `--site <站点ID>`。');
|
|
493
|
+
return picked;
|
|
494
|
+
}
|
|
495
|
+
out.warn('没认出这个选择:请输入上面的序号,或直接粘贴站点 ID。');
|
|
496
|
+
}
|
|
497
|
+
throw new UsageError('选择站点失败:连续 3 次都没有认出输入\n用法:wkgeo site use <站点ID>');
|
|
498
|
+
}
|
|
499
|
+
|
|
500
|
+
export const sitesListCommand = {
|
|
501
|
+
name: 'sites list',
|
|
502
|
+
summary: '我的站点(默认只看我名下的;没有站会引导建站,有站会让你选一个来管理)',
|
|
503
|
+
usage: 'wkgeo sites list [--mine|--managed|--all] [--limit 50] [--offset 0] [--with-prefix]',
|
|
504
|
+
flags: {
|
|
505
|
+
mine: { type: 'boolean', desc: '只看我名下的站点(**默认**)' },
|
|
506
|
+
managed: { type: 'boolean', desc: '我拥有的 + 我参与的(协作站)' },
|
|
507
|
+
all: { type: 'boolean', desc: '全部可见站点(管理员;普通账号仍受 data_scope 限制)' },
|
|
508
|
+
limit: { type: 'string', desc: '返回条数(1~200,默认 50)' },
|
|
509
|
+
offset: { type: 'string', desc: '偏移(默认 0)' },
|
|
510
|
+
'with-prefix': { type: 'boolean', desc: '逐站补查短域 `prefix_host`(平台列表接口不返回它;每个站多一次 getSite)' },
|
|
511
|
+
},
|
|
512
|
+
examples: [
|
|
513
|
+
'wkgeo sites list # 默认:我名下的站(会引导建站 / 选站)',
|
|
514
|
+
'wkgeo sites list --managed # 加上别人邀请我协作的站',
|
|
515
|
+
'wkgeo sites list --all --json # 管理员看全部(机器可读)',
|
|
516
|
+
'wkgeo sites list --with-prefix # 连短域一起看(每站补一次 getSite)',
|
|
517
|
+
],
|
|
518
|
+
notes: [
|
|
519
|
+
'CMS-only 站点(只存在于 cms_site、平台 listSites 查不到)会补列进来,标记为「仅 CMS」。',
|
|
520
|
+
'平台 `listSites` **不返回短域**(`prefix_host`),列表里那一列默认是 `-`;加 `--with-prefix` 逐站补查,或直接 `wkgeo sites get <站点ID>`。',
|
|
521
|
+
'--json 或非终端下**不提问**:没有站时输出 {"sites":[],"hint":"no_sites"},退出码仍是 0。',
|
|
522
|
+
],
|
|
523
|
+
async run(ctx) {
|
|
524
|
+
const { out } = ctx;
|
|
525
|
+
const mode = resolveListMode(ctx.flags);
|
|
526
|
+
|
|
527
|
+
const payload = {};
|
|
528
|
+
if (ctx.flags.limit !== undefined) payload.limit = Number(ctx.flags.limit);
|
|
529
|
+
if (ctx.flags.offset !== undefined) payload.offset = Number(ctx.flags.offset);
|
|
530
|
+
if (mode === 'mine') payload.mine = true;
|
|
531
|
+
if (mode === 'managed') payload.includeManaged = true;
|
|
532
|
+
|
|
533
|
+
const res = await ctx.callData('listSites', payload);
|
|
534
|
+
let rows = (res && Array.isArray(res.rows) ? res.rows : [])
|
|
535
|
+
.map((r) => normalizeSite(r, 'platform'))
|
|
536
|
+
.filter((r) => r.id);
|
|
537
|
+
|
|
538
|
+
const meId = currentUserId(ctx);
|
|
539
|
+
|
|
540
|
+
/**
|
|
541
|
+
* 本地复核(只收窄,绝不放宽):
|
|
542
|
+
* * `--mine`:线上还是旧版、忽略了 `mine` 时,会把别人的站也带回来 —— 这里按 owner 再筛一遍;
|
|
543
|
+
* * `--managed`:旧版不认 `includeManaged`(行上没有 `relation`)时,退化成"我拥有的",
|
|
544
|
+
* 协作站交给 CMS 侧合并补上(CMS 成员关系比平台 site 行更权威)。
|
|
545
|
+
*/
|
|
546
|
+
let filteredLocally = false;
|
|
547
|
+
/** 用户显式给了 `--limit` / `--offset` 时尊重分页,不偷偷改成"全量" */
|
|
548
|
+
const paged = ctx.flags.limit !== undefined || ctx.flags.offset !== undefined;
|
|
549
|
+
if (mode === 'mine' && meId) {
|
|
550
|
+
const keepOwned = (list) => list.filter((r) => !r.owner_user_id || r.owner_user_id === meId);
|
|
551
|
+
const kept = keepOwned(rows);
|
|
552
|
+
if (kept.length !== rows.length) {
|
|
553
|
+
filteredLocally = true;
|
|
554
|
+
if (paged) {
|
|
555
|
+
rows = kept;
|
|
556
|
+
} else {
|
|
557
|
+
/** 服务端没认 mine:按全量重新拉一遍再筛(别让第 51 个站以后永远看不见) */
|
|
558
|
+
try {
|
|
559
|
+
const all = await fetchAllPlatformSites(ctx);
|
|
560
|
+
const allKept = keepOwned(all);
|
|
561
|
+
rows = allKept.length >= kept.length ? allKept : kept;
|
|
562
|
+
} catch {
|
|
563
|
+
rows = kept;
|
|
564
|
+
}
|
|
565
|
+
}
|
|
566
|
+
}
|
|
567
|
+
} else if (mode === 'managed' && meId) {
|
|
568
|
+
const hasRelation = rows.some((r) => r.relation === 'owner' || r.relation === 'managed');
|
|
569
|
+
if (!hasRelation) {
|
|
570
|
+
const kept = rows.filter((r) => !r.owner_user_id || r.owner_user_id === meId);
|
|
571
|
+
filteredLocally = kept.length !== rows.length;
|
|
572
|
+
rows = kept;
|
|
573
|
+
}
|
|
574
|
+
}
|
|
575
|
+
|
|
576
|
+
/** CMS 侧补列(best-effort;失败不影响平台面结果) */
|
|
577
|
+
const cmsList = await listCmsSites(ctx);
|
|
578
|
+
const merged = mergeSites(rows, cmsList.rows);
|
|
579
|
+
const sites = merged.sites;
|
|
580
|
+
const current = readSiteState(ctx.siteStateFile);
|
|
581
|
+
|
|
582
|
+
/** 短域补查(默认关;平台 listSites 不返回 prefix_host) */
|
|
583
|
+
const prefixFill = ctx.flags.withPrefix === true && sites.length ? await fillPrefixHosts(ctx, sites) : null;
|
|
584
|
+
|
|
585
|
+
const data = {
|
|
586
|
+
sites,
|
|
587
|
+
/** 兼容 0.3.0:老脚本按 `rows` 读列表 */
|
|
588
|
+
rows: sites,
|
|
589
|
+
total: sites.length,
|
|
590
|
+
/** 服务端返回的总数(可能比本页多;CMS-only 不计入) */
|
|
591
|
+
server_total: (res && Number(res.total)) || 0,
|
|
592
|
+
mode,
|
|
593
|
+
mine_fallback: filteredLocally,
|
|
594
|
+
cms_list_ok: cmsList.ok,
|
|
595
|
+
cms_list_error: cmsList.error,
|
|
596
|
+
cms_only_count: merged.cmsOnly,
|
|
597
|
+
current_site_id: current ? current.id : null,
|
|
598
|
+
/** `--with-prefix` 的补查统计;没给这个参数 = null */
|
|
599
|
+
prefix_enriched: prefixFill,
|
|
600
|
+
hint: sites.length ? null : 'no_sites',
|
|
601
|
+
};
|
|
602
|
+
|
|
603
|
+
if (out.json) {
|
|
604
|
+
ctx.done(data);
|
|
605
|
+
return data;
|
|
606
|
+
}
|
|
607
|
+
|
|
608
|
+
/* ------------------------------ 人类可读输出 ------------------------------ */
|
|
609
|
+
|
|
610
|
+
if (!sites.length) {
|
|
611
|
+
out.head('站点列表(0 个)');
|
|
612
|
+
out.info('∅ 你还没有站点。');
|
|
613
|
+
if (!isInteractive(ctx)) {
|
|
614
|
+
out.info(' 建站:`wkgeo sites create --name 我的站`');
|
|
615
|
+
out.info(' (在交互终端里直接运行 `wkgeo sites list` 会一步步引导建站)');
|
|
616
|
+
ctx.done(data);
|
|
617
|
+
return data;
|
|
618
|
+
}
|
|
619
|
+
const yes = await askYes(ctx, '∅ 你还没有站点,是否现在创建一个?(Y/n) ', true);
|
|
620
|
+
if (!yes) {
|
|
621
|
+
out.info('好的,先不建。想建的时候运行 `wkgeo sites list` 或 `wkgeo sites create --name 我的站`。');
|
|
622
|
+
ctx.done(data);
|
|
623
|
+
return data;
|
|
624
|
+
}
|
|
625
|
+
const created = await createSiteByGuide(ctx);
|
|
626
|
+
const createdData = { ...data, ...created, mode, hint: null, current_site_id: created.site.id };
|
|
627
|
+
ctx.done(createdData);
|
|
628
|
+
return createdData;
|
|
629
|
+
}
|
|
630
|
+
|
|
631
|
+
out.head(
|
|
632
|
+
`站点列表(共 ${sites.length} 个${mode === 'mine' ? ' · 我名下的' : mode === 'managed' ? ' · 我拥有的 + 我参与的' : ' · 全部可见'}${
|
|
633
|
+
merged.cmsOnly ? `,其中仅 CMS ${merged.cmsOnly} 个` : ''
|
|
634
|
+
})`,
|
|
635
|
+
);
|
|
636
|
+
out.table(
|
|
637
|
+
[
|
|
638
|
+
{ title: '名称', key: 'name', width: 24, format: (v, row) => `${current && current.id === row.id ? '★ ' : ''}${v || '(未命名)'}` },
|
|
639
|
+
{ title: '站点 ID', key: 'id', width: 38 },
|
|
640
|
+
{ title: '关系', key: 'relation', width: 8, format: (v, row) => (row.cms_only ? '仅CMS' : v === 'managed' ? '协作' : v === 'owner' ? '我的' : v === 'cms' ? 'CMS' : '-') },
|
|
641
|
+
{ title: '状态', key: 'status', width: 8 },
|
|
642
|
+
{ title: '开通', key: 'provision_state', width: 10 },
|
|
643
|
+
{ title: '短域', key: 'prefix_host', width: 30 },
|
|
644
|
+
{ title: '域名', key: 'domain', width: 22 },
|
|
645
|
+
],
|
|
646
|
+
sites,
|
|
647
|
+
);
|
|
648
|
+
if (!cmsList.ok) {
|
|
649
|
+
out.info(`(CMS 侧站点没取到:${(cmsList.error && cmsList.error.message) || '未知原因'};平台面列表不受影响)`);
|
|
650
|
+
}
|
|
651
|
+
if (!prefixFill && sites.some((r) => !r.prefix_host && r.source === 'platform')) {
|
|
652
|
+
out.info('(短域列:平台列表接口不返回,加 `--with-prefix` 逐站补查,或 `wkgeo sites get <站点ID>`)');
|
|
653
|
+
}
|
|
654
|
+
if (prefixFill && prefixFill.failed) {
|
|
655
|
+
out.info(`(短域补查:${prefixFill.filled}/${prefixFill.requested} 个站补到,${prefixFill.failed} 个失败)`);
|
|
656
|
+
}
|
|
657
|
+
|
|
658
|
+
if (!isInteractive(ctx)) {
|
|
659
|
+
if (!current && sites.length) out.info('选一个来管理:`wkgeo site use <站点ID>`(交互终端下直接 `wkgeo sites list` 会问)');
|
|
660
|
+
ctx.done(data);
|
|
661
|
+
return data;
|
|
662
|
+
}
|
|
663
|
+
|
|
664
|
+
const selected = await chooseSiteByGuide(ctx, sites);
|
|
665
|
+
const selectedData = { ...data, current_site_id: selected.id, selected_site_id: selected.id, hint: null };
|
|
666
|
+
ctx.done(selectedData);
|
|
667
|
+
return selectedData;
|
|
668
|
+
},
|
|
669
|
+
};
|
|
670
|
+
|
|
671
|
+
/* ------------------------------------------------------------------ 站点详情 */
|
|
672
|
+
|
|
673
|
+
export const sitesGetCommand = {
|
|
674
|
+
name: 'sites get',
|
|
675
|
+
summary: '站点详情(短域 / 存储位 / 开通状态 / 归属 / 计费池;后端 getSite 全字段)',
|
|
676
|
+
usage: 'wkgeo sites get <站点ID> [--json]',
|
|
677
|
+
args: [{ name: 'id', required: true, desc: '站点 ID(`wkgeo sites list` 第 2 列)' }],
|
|
678
|
+
flags: {},
|
|
679
|
+
examples: [
|
|
680
|
+
'wkgeo sites get a9c743ed-7db7-4156-b7ef-eb6bf6065163',
|
|
681
|
+
'wkgeo sites get <站点ID> --json # 机器可读:site + detail 全量标量字段',
|
|
682
|
+
],
|
|
683
|
+
notes: [
|
|
684
|
+
'`prefix_host` = 平台分配的短域(`<名字>.<地区>.wkgeo.com.cn`),`custom_domain` = 你自己登记的域名;**两套解析**,短域打不开不代表自有域名没配好,反之亦然。',
|
|
685
|
+
'`provision_state`:`none` 没进过开通流程 / `provisioning` 开通中 / `active` 已开通 / `failed` 失败;卡在哪一步看 `provision_step`。',
|
|
686
|
+
'`settings` / `theme` / `layout` / `info` / `template_config` 这几个大 JSON 块**不输出**(可能存第三方 Key),要看去 CMS 后台;其余 `getSite` 字段全部在 `--json` 的 `detail` 里。',
|
|
687
|
+
],
|
|
688
|
+
async run(ctx) {
|
|
689
|
+
const { out } = ctx;
|
|
690
|
+
const id = String(ctx.positional.id || '').trim();
|
|
691
|
+
const res = await ctx.callData('getSite', { id });
|
|
692
|
+
const site = normalizeSite(res, 'platform');
|
|
693
|
+
if (!site.id) {
|
|
694
|
+
throw new CliError('后端没有返回这个站点', {
|
|
695
|
+
kind: 'not_found',
|
|
696
|
+
hint: '确认站点 ID 没打错;`wkgeo sites list` 列的是你有权限的站(软删除的站要先去回收站还原)。',
|
|
697
|
+
});
|
|
698
|
+
}
|
|
699
|
+
const detail = pickSiteDetail(res);
|
|
700
|
+
const meId = currentUserId(ctx);
|
|
701
|
+
const ownership = checkOwnership(site, meId);
|
|
702
|
+
const data = {
|
|
703
|
+
site,
|
|
704
|
+
/** `getSite` 的标量字段全量(大 JSON 块除外,见 notes) */
|
|
705
|
+
detail,
|
|
706
|
+
short_domain: shortDomainOf(site),
|
|
707
|
+
detail_excluded_fields: SITE_BLOB_FIELDS.slice(),
|
|
708
|
+
owner_matches_current_user: meId ? ownership.ok : null,
|
|
709
|
+
current_user_id: meId,
|
|
710
|
+
hint: site.custom_domain ? null : 'no_custom_domain',
|
|
711
|
+
};
|
|
712
|
+
|
|
713
|
+
if (!out.json) {
|
|
714
|
+
out.head(`站点详情:${site.name || '(未命名)'}`);
|
|
715
|
+
out.line(` 站点 ID:${site.id}`);
|
|
716
|
+
out.line(` 状态:${site.status || '-'} · 开通状态:${site.provision_state || '-'}${detail.provision_step ? `(步骤 ${detail.provision_step})` : ''}`);
|
|
717
|
+
out.line(
|
|
718
|
+
` 归属用户:${site.owner_user_id || '(未知)'}${
|
|
719
|
+
meId ? (ownership.ok === true ? '(= 当前账号 ✔)' : ownership.ok === false ? `(⚠️ 与当前账号 ${meId} 不一致)` : '(无法核对)') : ''
|
|
720
|
+
}`,
|
|
721
|
+
);
|
|
722
|
+
printShortDomain(out, site);
|
|
723
|
+
out.line(` 自有域名:${site.custom_domain || '未绑定(域名解析不生效,先登记域名)'}`);
|
|
724
|
+
const region = [detail.region, detail.region_public].filter(Boolean).join(' / ');
|
|
725
|
+
if (region) out.line(` 地区:${region}`);
|
|
726
|
+
if (detail.oss_bucket || detail.oss_prefix) {
|
|
727
|
+
out.line(` 存储:${detail.oss_bucket || '-'}${detail.oss_prefix ? ` · 前缀 ${detail.oss_prefix}` : ''}`);
|
|
728
|
+
}
|
|
729
|
+
if (detail.esa_site_id) out.line(` ESA 站点:${detail.esa_site_id}${detail.esa_status ? `(${detail.esa_status})` : ''}`);
|
|
730
|
+
if (detail.cert_status || detail.cert_not_after) {
|
|
731
|
+
out.line(` 证书:${detail.cert_status || '-'}${detail.cert_not_after ? `(到期 ${formatTime(detail.cert_not_after)})` : ''}`);
|
|
732
|
+
}
|
|
733
|
+
if (detail.pool_id) out.line(` 计费池:${detail.pool_id}`);
|
|
734
|
+
if (detail.provision_attempts) out.line(` 开通尝试:${detail.provision_attempts} 次`);
|
|
735
|
+
out.line(` 创建时间:${formatTime(site.created_at)}${detail.updated_at ? ` · 更新时间:${formatTime(detail.updated_at)}` : ''}`);
|
|
736
|
+
if (detail.last_error) out.warn(`最近一次错误:${detail.last_error}${detail.last_error_at ? `(${formatTime(detail.last_error_at)})` : ''}`);
|
|
737
|
+
if (!site.custom_domain) {
|
|
738
|
+
out.info(' → 还没有自有域名:`wkgeo domain status` 看开通状态,`wkgeo domain dns` 看要加的解析记录。');
|
|
739
|
+
}
|
|
740
|
+
}
|
|
741
|
+
ctx.done(data);
|
|
742
|
+
return data;
|
|
743
|
+
},
|
|
744
|
+
};
|
|
745
|
+
|
|
746
|
+
/* ------------------------------------------------------------------ 建站 */
|
|
747
|
+
|
|
748
|
+
/** `--channel` 取值:`auto` = 先 CMS 通道、明确不支持才回退平台 */
|
|
749
|
+
const CREATE_CHANNELS = ['auto', 'platform', 'cms'];
|
|
750
|
+
|
|
751
|
+
/** CMS 建站入参(与交互引导同一套口径:`template` 只传内置模板名,uuid 不传) */
|
|
752
|
+
function cmsCreatePayload({ name, template }) {
|
|
753
|
+
const payload = { name };
|
|
754
|
+
if (template && !looksLikeUuid(template)) payload.template = template;
|
|
755
|
+
return payload;
|
|
756
|
+
}
|
|
757
|
+
|
|
758
|
+
export const sitesCreateCommand = {
|
|
759
|
+
name: 'sites create',
|
|
760
|
+
summary: '建一个属于当前账号的站点(默认先走 CMS 通道;返回站点 id 与短域)',
|
|
761
|
+
usage: 'wkgeo sites create --name <名称> [--template <模板ID>] [--domain <域名>] [--channel auto|platform|cms]',
|
|
762
|
+
flags: {
|
|
763
|
+
name: { type: 'string', required: true, desc: '站点名称' },
|
|
764
|
+
template: { type: 'string', desc: '模板 ID(uuid)或内置模板名' },
|
|
765
|
+
domain: { type: 'string', desc: '主域名(可选;**只登记到 site.domains,不触发解析 / 证书**;解析要自己去域名商加)' },
|
|
766
|
+
channel: { type: 'string', desc: '建站通道:auto(默认,先 CMS 后回退平台)/ platform(只建平台站)/ cms(只走 CMS,CMS 站点一起建)' },
|
|
767
|
+
},
|
|
768
|
+
examples: [
|
|
769
|
+
'wkgeo sites create --name 我的站',
|
|
770
|
+
'wkgeo sites create --name 我的站 --channel platform',
|
|
771
|
+
'wkgeo sites create --name 我的站 --domain www.example.com --channel platform',
|
|
772
|
+
],
|
|
773
|
+
notes: [
|
|
774
|
+
'`--channel auto`(默认):先打 CMS 通道 `createCmsSite`(CMS 站点会一起建出来);服务端回「未知动作 / 400」才回退平台 `createSite`,网络 / 401 / 429 / 5xx 照常报错,不伪装成成功。',
|
|
775
|
+
'`--domain` **只登记域名**:写的是站点记录里的 `site.domains`,**不写短域 KV、不碰 DNS、不申请证书**。真正对外访问还要在域名商加解析并走域名开通流程(`wkgeo domain status` 看进度)。',
|
|
776
|
+
'`--domain` 与 `--channel cms` 不能一起用(CMS 建站不登记域名);`--channel auto` 遇到 `--domain` 会直接走平台通道,免得域名被静默丢掉。',
|
|
777
|
+
],
|
|
778
|
+
async run(ctx) {
|
|
779
|
+
const { out, flags } = ctx;
|
|
780
|
+
const requested = String(flags.channel || 'auto').toLowerCase();
|
|
781
|
+
if (!CREATE_CHANNELS.includes(requested)) {
|
|
782
|
+
throw new UsageError(`--channel 只能是 ${CREATE_CHANNELS.join(' / ')},收到:${flags.channel}`, {
|
|
783
|
+
hint: 'auto=先 CMS 后回退平台(默认);platform=只走平台 createSite;cms=只走 CMS cmsCreateSite',
|
|
784
|
+
});
|
|
785
|
+
}
|
|
786
|
+
if (requested === 'cms' && flags.domain) {
|
|
787
|
+
throw new UsageError('--channel cms 不能配 --domain(CMS 建站不登记域名)', {
|
|
788
|
+
hint: '去掉 --domain,或改成 `--channel platform` 让域名一起登记(只写库,不触发解析/证书)。',
|
|
789
|
+
});
|
|
790
|
+
}
|
|
791
|
+
/** 带 `--domain` 时 auto 直接走平台:CMS 通道没有域名登记能力,走它会把 --domain 静默丢掉 */
|
|
792
|
+
const wantCms = requested === 'cms' || (requested === 'auto' && !flags.domain);
|
|
793
|
+
|
|
794
|
+
let channel = null;
|
|
795
|
+
let res = null;
|
|
796
|
+
let cmsSiteCreated = false;
|
|
797
|
+
let cmsError = null;
|
|
798
|
+
let cmsWarnings = [];
|
|
799
|
+
if (wantCms) {
|
|
800
|
+
try {
|
|
801
|
+
/** `noSite:true`:新站点还不存在,绝不能带本地残留的 `x-cms-site`(同 createSiteByGuide) */
|
|
802
|
+
const r = await ctx.cmsCall('createCmsSite', cmsCreatePayload({ name: flags.name, template: flags.template }), { noSite: true });
|
|
803
|
+
res = (r && r.site) || r;
|
|
804
|
+
channel = 'cms';
|
|
805
|
+
cmsSiteCreated = true;
|
|
806
|
+
if (r && Array.isArray(r.warnings)) cmsWarnings = r.warnings.map(String).filter(Boolean);
|
|
807
|
+
} catch (e) {
|
|
808
|
+
/** 明确选了 cms 就不回退;auto 只在「服务端还不认识这个动作」时回退 */
|
|
809
|
+
if (requested === 'cms' || !isMissingCmsAction(e)) throw e;
|
|
810
|
+
cmsError = { kind: (e && e.kind) || 'error', message: (e && e.message) || String(e) };
|
|
811
|
+
}
|
|
812
|
+
}
|
|
813
|
+
if (!channel) {
|
|
814
|
+
const payload = { name: flags.name };
|
|
815
|
+
if (flags.template) payload.template_id = flags.template;
|
|
816
|
+
if (flags.domain) payload.domains = [flags.domain];
|
|
817
|
+
res = await ctx.callData('createSite', payload);
|
|
818
|
+
channel = 'platform';
|
|
819
|
+
}
|
|
820
|
+
|
|
821
|
+
const site = normalizeSite(res, channel === 'cms' ? 'cms' : 'platform');
|
|
822
|
+
if (!site.id) {
|
|
823
|
+
throw new CliError('建站接口没有返回站点 id', {
|
|
824
|
+
kind: 'bad_response',
|
|
825
|
+
hint: '服务端可能刚升级 / 部署不完整;请稍后用 `wkgeo sites list` 确认,或到网页后台查看。',
|
|
826
|
+
});
|
|
827
|
+
}
|
|
828
|
+
|
|
829
|
+
/** 复核归属:owner 必须能对上当前登录用户;对不上/拿不到都如实说(A3:拿不到 ≠ 不一致) */
|
|
830
|
+
let creds = null;
|
|
831
|
+
try {
|
|
832
|
+
creds = ctx.requireAuth();
|
|
833
|
+
} catch {
|
|
834
|
+
/* 拿不到也继续,只影响复核 */
|
|
835
|
+
}
|
|
836
|
+
const meId = creds && creds.account ? String(creds.account.sub || '') : '';
|
|
837
|
+
const ownership = checkOwnership(site, meId);
|
|
838
|
+
|
|
839
|
+
const data = {
|
|
840
|
+
site,
|
|
841
|
+
/** 实际走的通道(A9:`--json` 里必须能看出走的是哪条) */
|
|
842
|
+
channel,
|
|
843
|
+
channel_requested: requested,
|
|
844
|
+
cms_site_created: cmsSiteCreated,
|
|
845
|
+
cms_error: cmsError,
|
|
846
|
+
cms_warnings: cmsWarnings,
|
|
847
|
+
short_domain: shortDomainOf(site),
|
|
848
|
+
domain_requested: flags.domain ? String(flags.domain) : null,
|
|
849
|
+
/**
|
|
850
|
+
* `--domain` 只写 `site.domains`(A10),不触发解析/证书。
|
|
851
|
+
* `null` = 服务端没回显 domains,无法确认(不是失败)。
|
|
852
|
+
*/
|
|
853
|
+
domain_registered: flags.domain ? Boolean(Array.isArray(site.domains) && site.domains.length) : null,
|
|
854
|
+
owner_matches_current_user: meId ? ownership.ok : null,
|
|
855
|
+
current_user_id: meId || null,
|
|
856
|
+
};
|
|
857
|
+
|
|
858
|
+
if (!out.json) {
|
|
859
|
+
out.ok(`站点已创建:${site.name || site.id}`);
|
|
860
|
+
out.line(` 站点 ID:${site.id}`);
|
|
861
|
+
out.line(` 通道:${channel === 'cms' ? 'CMS(cmsCreateSite,CMS 站点已同时创建)' : '平台(createSite)'}`);
|
|
862
|
+
if (site.status) out.line(` 状态:${site.status}${site.provision_state ? ` · 开通:${site.provision_state}` : ''}`);
|
|
863
|
+
if (meId) {
|
|
864
|
+
out.line(
|
|
865
|
+
` 归属用户:${site.owner_user_id || '(未知)'}${
|
|
866
|
+
ownership.ok === true ? '(= 当前账号 ✔)' : ownership.ok === false ? ` ⚠️ 与当前账号 ${meId} 不一致,请核查` : '(无法核对)'
|
|
867
|
+
}`,
|
|
868
|
+
);
|
|
869
|
+
}
|
|
870
|
+
printShortDomain(out, site, { channel });
|
|
871
|
+
if (flags.domain) {
|
|
872
|
+
out.line(` 域名:${flags.domain}(已提交登记到站点记录;**不触发解析 / 证书**)`);
|
|
873
|
+
out.info(' → 还要去域名商加解析:`wkgeo domain dns` 看要加哪几条;开通进度:`wkgeo domain status`');
|
|
874
|
+
}
|
|
875
|
+
for (const warn of cmsWarnings) out.info(` ⚠️ ${warn}`);
|
|
876
|
+
} else {
|
|
877
|
+
/** JSON 模式:短域本身在 `short_domain` 里;只有 KV 没写进去才走 stderr 告警(A2) */
|
|
878
|
+
printShortDomain(out, site, { channel });
|
|
879
|
+
}
|
|
880
|
+
if (ownership.ok === false) {
|
|
881
|
+
out.warn(`站点归属(${site.owner_user_id}) ≠ 当前账号(${meId}),请核查`);
|
|
882
|
+
}
|
|
883
|
+
ctx.done(data);
|
|
884
|
+
return data;
|
|
885
|
+
},
|
|
886
|
+
};
|
|
887
|
+
|
|
888
|
+
export const sitesDeleteCommand = {
|
|
889
|
+
name: 'sites delete',
|
|
890
|
+
summary: '删除站点(服务端是**软删除**:进回收站,可还原)',
|
|
891
|
+
usage: 'wkgeo sites delete <站点ID>',
|
|
892
|
+
args: [{ name: 'id', required: true, desc: '站点 ID' }],
|
|
893
|
+
async run(ctx) {
|
|
894
|
+
const { out } = ctx;
|
|
895
|
+
const id = ctx.positional.id;
|
|
896
|
+
const res = await ctx.callData('deleteSite', { id });
|
|
897
|
+
const data = { id, deleted: !!(res && res.deleted), soft: res ? res.soft !== false : true };
|
|
898
|
+
if (!out.json) {
|
|
899
|
+
out.ok(`站点已移入回收站(软删除,可在后台还原):${id}`);
|
|
900
|
+
out.info(' 注意:软删除不会释放域名等外部资源;彻底删除需要管理员在后台操作。');
|
|
901
|
+
}
|
|
902
|
+
ctx.done(data);
|
|
903
|
+
return data;
|
|
904
|
+
},
|
|
905
|
+
};
|