@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,621 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* 配置类 auth 面命令:语言(lang)/ 角色(role)/ 站点成员(member)。
|
|
3
|
+
*
|
|
4
|
+
* ## 这一层是什么
|
|
5
|
+
* task-75(2026-10-29)把这 11 条动作从 CMS 的 `actionTable` 搬进 CLI 自己的
|
|
6
|
+
* 云函数 `wkgeo-cli-fc`(`src/config-auth-core.js`,逐字复制 CMS handler)。
|
|
7
|
+
* 因此这里的动作名 = 服务端动作名(`langList` / `roleSave` / `memberUpdate` …),
|
|
8
|
+
* 参数名也照抄 CMS 后端 —— 两边一旦不一致,用户看到的是"参数传了但没生效"。
|
|
9
|
+
*
|
|
10
|
+
* ## 三条口径(与 B1 内容面完全一致)
|
|
11
|
+
* 1. **站点必须先定**:`--site` > `WKONGAI_SITE` > `wkgeo site use` 记住的那个;
|
|
12
|
+
* 一个都没有就当场报用法错误(`configAuthCall` 统一挡)。
|
|
13
|
+
* 2. **写动作默认 dry-run**:不加 `--confirm` 只打印"将要发什么",一个写请求都不发;
|
|
14
|
+
* 加 `--confirm` 才真调。人员 / 角色 / 语言都是**影响线上后台**的东西,不给默认真发。
|
|
15
|
+
* 3. **默认人类可读表格,`--json` 给原始数据**(信封由 `runtime.done()` 统一包)。
|
|
16
|
+
*
|
|
17
|
+
* ## 权限面(为什么有的命令要多一个 scope)
|
|
18
|
+
* * 读(`member list` / `role list` / `lang list`)⇒ `site:read`
|
|
19
|
+
* * 改成员 / 改语言 ⇒ `site:write`
|
|
20
|
+
* * 改角色(`role save` / `role delete`)⇒ **`role:write`**(`site:write` 不继承)
|
|
21
|
+
* 理由:能改角色 = 能给自己发权限,所以单独一道 scope,且服务端还限制了
|
|
22
|
+
* **不许造出带「系统管理」(`system:*`) 权限的角色**(出现即 400)。
|
|
23
|
+
*
|
|
24
|
+
* ## 别在这里做的事
|
|
25
|
+
* * ❌ 不走 `/cms` 转发面(B7 起这几条已经不打 CMS 通道了,统一 `configAuthCall`)
|
|
26
|
+
* * ❌ 不在 CLI 侧拼 `site_id`:`configAuthCall` 会塞 body.siteId,服务端只认自己名下
|
|
27
|
+
* * ❌ 不做「加成员 / 建账号」:`memberAdd`(CMS `userAdd`)**故意没迁** ——
|
|
28
|
+
* 它要调 `wkgeo-auth` 建号,CLI 侧没有这条链路的授权口径(复核批 4 登记为"不迁")
|
|
29
|
+
*/
|
|
30
|
+
|
|
31
|
+
import { UsageError } from '../errors.mjs';
|
|
32
|
+
import { formatTime } from '../format.mjs';
|
|
33
|
+
|
|
34
|
+
/* ------------------------------------------------------------------ 公共小工具 */
|
|
35
|
+
|
|
36
|
+
/** 所有配置类 auth 命令共用的 `--site`(默认取 `wkgeo site use` 选中的站点) */
|
|
37
|
+
const SITE_FLAG = {
|
|
38
|
+
site: {
|
|
39
|
+
type: 'string',
|
|
40
|
+
desc: '站点 ID(uuid;默认用 `wkgeo site use` 选中的站点,可用 WKONGAI_SITE 覆盖)',
|
|
41
|
+
},
|
|
42
|
+
};
|
|
43
|
+
|
|
44
|
+
/** 写动作的确认闸:不加就 dry-run */
|
|
45
|
+
const CONFIRM_FLAG = {
|
|
46
|
+
confirm: {
|
|
47
|
+
type: 'boolean',
|
|
48
|
+
desc: '真发(不加只打印将要发什么,一个写请求都不发)',
|
|
49
|
+
},
|
|
50
|
+
};
|
|
51
|
+
|
|
52
|
+
function siteIdOf(ctx) {
|
|
53
|
+
const site = ctx.cmsSite();
|
|
54
|
+
return (site && site.id) || '';
|
|
55
|
+
}
|
|
56
|
+
|
|
57
|
+
function siteText(ctx) {
|
|
58
|
+
const site = ctx.cmsSite();
|
|
59
|
+
if (!site || !site.id) return '(未选站)';
|
|
60
|
+
return site.label ? `${site.label}(${site.id})` : String(site.id);
|
|
61
|
+
}
|
|
62
|
+
|
|
63
|
+
/** 服务端动作名(同时用于 dry-run 回执里的 `action`) */
|
|
64
|
+
const ACTION = {
|
|
65
|
+
langList: 'langList',
|
|
66
|
+
langSave: 'langSave',
|
|
67
|
+
langSetDefault: 'langSetDefault',
|
|
68
|
+
langDelete: 'langDelete',
|
|
69
|
+
langToggle: 'langToggle',
|
|
70
|
+
roleList: 'roleList',
|
|
71
|
+
roleSave: 'roleSave',
|
|
72
|
+
roleDelete: 'roleDelete',
|
|
73
|
+
memberList: 'memberList',
|
|
74
|
+
memberUpdate: 'memberUpdate',
|
|
75
|
+
memberRemove: 'memberRemove',
|
|
76
|
+
};
|
|
77
|
+
|
|
78
|
+
/**
|
|
79
|
+
* dry-run:把"将要发什么"打印出来就**结束**(不发请求、退出码 0)。
|
|
80
|
+
*
|
|
81
|
+
* 为什么把 request 也放进 `--json`:agent 拿 dry-run 的结果做二次确认时,
|
|
82
|
+
* 需要能核对"我要发的就是这些",光有人类文案不够机器读。
|
|
83
|
+
*/
|
|
84
|
+
function dryRun(ctx, action, request, lines) {
|
|
85
|
+
const data = {
|
|
86
|
+
dry_run: true,
|
|
87
|
+
action,
|
|
88
|
+
site_id: siteIdOf(ctx),
|
|
89
|
+
request,
|
|
90
|
+
confirm_hint: '确认无误后加 --confirm 真发',
|
|
91
|
+
};
|
|
92
|
+
const { out } = ctx;
|
|
93
|
+
if (!out.json) {
|
|
94
|
+
out.head(`dry-run:${action}(没有发送任何写请求)`);
|
|
95
|
+
out.line(` 站点:${siteText(ctx)}`);
|
|
96
|
+
for (const l of lines || []) out.line(` ${l}`);
|
|
97
|
+
out.line('');
|
|
98
|
+
out.line(' 确认无误后加 --confirm 真发。');
|
|
99
|
+
}
|
|
100
|
+
ctx.done(data);
|
|
101
|
+
return data;
|
|
102
|
+
}
|
|
103
|
+
|
|
104
|
+
/** 角色权限:`{"content":["view","edit"]}` 或 `content=view,edit;base=view` 两种写法都收 */
|
|
105
|
+
function parsePermissions(raw) {
|
|
106
|
+
const text = String(raw || '').trim();
|
|
107
|
+
if (!text) throw new UsageError('缺少 --permissions(例:--permissions \'{"content":["view","edit"]}\')');
|
|
108
|
+
|
|
109
|
+
if (text.startsWith('{')) {
|
|
110
|
+
let parsed;
|
|
111
|
+
try {
|
|
112
|
+
parsed = JSON.parse(text);
|
|
113
|
+
} catch (e) {
|
|
114
|
+
throw new UsageError(`--permissions 不是合法 JSON:${e && e.message ? e.message : e}`);
|
|
115
|
+
}
|
|
116
|
+
if (!parsed || typeof parsed !== 'object' || Array.isArray(parsed)) {
|
|
117
|
+
throw new UsageError('--permissions 必须是对象:{"content":["view","edit"]}');
|
|
118
|
+
}
|
|
119
|
+
return parsed;
|
|
120
|
+
}
|
|
121
|
+
|
|
122
|
+
/* 紧凑写法:`content=view,edit;base=view` */
|
|
123
|
+
const out = {};
|
|
124
|
+
for (const part of text.split(';')) {
|
|
125
|
+
const one = part.trim();
|
|
126
|
+
if (!one) continue;
|
|
127
|
+
const eq = one.indexOf('=');
|
|
128
|
+
if (eq < 0) throw new UsageError(`--permissions 片段 "${one}" 少了 "="(写法:content=view,edit)`);
|
|
129
|
+
const group = one.slice(0, eq).trim();
|
|
130
|
+
const acts = one
|
|
131
|
+
.slice(eq + 1)
|
|
132
|
+
.split(',')
|
|
133
|
+
.map((x) => x.trim())
|
|
134
|
+
.filter(Boolean);
|
|
135
|
+
if (!group) throw new UsageError('--permissions 里有空的能力组名');
|
|
136
|
+
out[group] = acts;
|
|
137
|
+
}
|
|
138
|
+
if (!Object.keys(out).length) throw new UsageError('--permissions 是空的');
|
|
139
|
+
return out;
|
|
140
|
+
}
|
|
141
|
+
|
|
142
|
+
/** 权限对象 → 人类可读的一行(`content: 浏览/修改 · base: 浏览`) */
|
|
143
|
+
const ACTION_LABEL = { view: '浏览', create: '新增', edit: '修改', delete: '删除' };
|
|
144
|
+
function permissionsText(permissions) {
|
|
145
|
+
const obj = permissions && typeof permissions === 'object' ? permissions : {};
|
|
146
|
+
const keys = Object.keys(obj);
|
|
147
|
+
if (!keys.length) return '(无权限)';
|
|
148
|
+
return keys
|
|
149
|
+
.map((k) => {
|
|
150
|
+
const acts = Array.isArray(obj[k]) ? obj[k] : [];
|
|
151
|
+
return `${k}: ${acts.map((a) => ACTION_LABEL[a] || a).join('/') || '—'}`;
|
|
152
|
+
})
|
|
153
|
+
.join(' · ');
|
|
154
|
+
}
|
|
155
|
+
|
|
156
|
+
/* ══════════════════════════════ 语言(lang) ══════════════════════════════ */
|
|
157
|
+
|
|
158
|
+
export const langListCommand = {
|
|
159
|
+
name: 'lang list',
|
|
160
|
+
summary: '站点语言列表(代码 / 名称 / 是否默认 / 是否启用)',
|
|
161
|
+
usage: 'wkgeo lang list [--site <站点ID>]',
|
|
162
|
+
args: [],
|
|
163
|
+
flags: { ...SITE_FLAG },
|
|
164
|
+
examples: ['wkgeo lang list', 'wkgeo lang list --json'],
|
|
165
|
+
notes: [
|
|
166
|
+
'需要 `site:read`(只读)。',
|
|
167
|
+
'**默认语言不能禁用、也不能删**(服务端有硬约束:先把别的语言设成默认,再动它)。',
|
|
168
|
+
],
|
|
169
|
+
async run(ctx) {
|
|
170
|
+
const { out } = ctx;
|
|
171
|
+
const res = await ctx.configAuthCall(ACTION.langList);
|
|
172
|
+
const rows = (res && Array.isArray(res.rows) ? res.rows : []).map((r) => r || {});
|
|
173
|
+
const data = { site_id: siteIdOf(ctx), rows, total: rows.length };
|
|
174
|
+
|
|
175
|
+
if (!out.json) {
|
|
176
|
+
out.head(`语言列表(${rows.length} 个 · 站点 ${siteText(ctx)})`);
|
|
177
|
+
out.table(
|
|
178
|
+
[
|
|
179
|
+
{ title: '代码', key: 'code', width: 10 },
|
|
180
|
+
{ title: '名称', key: 'name', width: 16 },
|
|
181
|
+
{ title: '默认', key: 'is_default', width: 6, format: (v) => (v ? '是' : '') },
|
|
182
|
+
{ title: '启用', key: 'enabled', width: 6, format: (v) => (v ? '是' : '停用') },
|
|
183
|
+
{ title: '排序', key: 'sort', width: 6 },
|
|
184
|
+
{ title: '语言 ID', key: 'id', width: 38 },
|
|
185
|
+
],
|
|
186
|
+
rows,
|
|
187
|
+
);
|
|
188
|
+
}
|
|
189
|
+
ctx.done(data);
|
|
190
|
+
return data;
|
|
191
|
+
},
|
|
192
|
+
};
|
|
193
|
+
|
|
194
|
+
export const langSaveCommand = {
|
|
195
|
+
name: 'lang save',
|
|
196
|
+
summary: '保存语言:给了 <语言ID> 就改,没给就新建(新建需要 --code + --name)',
|
|
197
|
+
usage:
|
|
198
|
+
'wkgeo lang save [语言ID] --code <代码> --name <名称> [--default] [--disabled] [--confirm]',
|
|
199
|
+
args: [{ name: 'lang', required: false, desc: '语言 ID(给了就改,不给就新建)' }],
|
|
200
|
+
flags: {
|
|
201
|
+
code: { type: 'string', desc: '语言代码,形如 zh-CN / en / ja(2~3 位主码,可带子标签)' },
|
|
202
|
+
name: { type: 'string', desc: '语言名称,如「简体中文」' },
|
|
203
|
+
default: { type: 'boolean', desc: '设为默认语言(会自动把别的语言取消默认)' },
|
|
204
|
+
disabled: { type: 'boolean', desc: '停用这个语言(默认语言不能停用)' },
|
|
205
|
+
...CONFIRM_FLAG,
|
|
206
|
+
...SITE_FLAG,
|
|
207
|
+
},
|
|
208
|
+
examples: [
|
|
209
|
+
'wkgeo lang save --code ja --name 日本語 # dry-run',
|
|
210
|
+
'wkgeo lang save --code ja --name 日本語 --confirm # 真建',
|
|
211
|
+
'wkgeo lang save 8f3c… --code ja --name 日本語 --confirm',
|
|
212
|
+
'wkgeo lang save 8f3c… --code ja --name 日本語 --default --confirm',
|
|
213
|
+
],
|
|
214
|
+
notes: [
|
|
215
|
+
'需要 `site:write`。**默认 dry-run**,加 `--confirm` 才真发。',
|
|
216
|
+
'语言代码规则:`/^[A-Za-z]{2,3}(-[A-Za-z0-9]{2,8})*$/`(`zh-CN` / `en` / `ja` 这样)。',
|
|
217
|
+
'同一站点里代码**不区分大小写唯一**(重了回 409「这个语言代码已经加过了」)。',
|
|
218
|
+
'默认语言不能停用(先把这个语言设成默认,再停用别的)。',
|
|
219
|
+
],
|
|
220
|
+
async run(ctx) {
|
|
221
|
+
const id = String(ctx.positional.lang || '').trim();
|
|
222
|
+
const body = {};
|
|
223
|
+
if (id) body.id = id;
|
|
224
|
+
if (ctx.flags.code !== undefined) body.code = String(ctx.flags.code);
|
|
225
|
+
if (ctx.flags.name !== undefined) body.name = String(ctx.flags.name);
|
|
226
|
+
if (ctx.flags.default) body.isDefault = true;
|
|
227
|
+
if (ctx.flags.disabled) body.enabled = false;
|
|
228
|
+
|
|
229
|
+
if (!id && !body.code) throw new UsageError('新建语言必须带 --code(如 --code ja)');
|
|
230
|
+
if (!id && !body.name) throw new UsageError('新建语言必须带 --name(如 --name 日本語)');
|
|
231
|
+
|
|
232
|
+
const rows = [
|
|
233
|
+
['语言 ID', id || '(新建)'],
|
|
234
|
+
['代码', body.code === undefined ? '(不改)' : body.code],
|
|
235
|
+
['名称', body.name === undefined ? '(不改)' : body.name],
|
|
236
|
+
['设为默认', ctx.flags.default ? '是' : '否'],
|
|
237
|
+
['启用', ctx.flags.disabled ? '停用' : '是'],
|
|
238
|
+
];
|
|
239
|
+
if (!ctx.flags.confirm) return dryRun(ctx, ACTION.langSave, body, rows.map(([k, v]) => `${k}:${v}`));
|
|
240
|
+
|
|
241
|
+
const { out } = ctx;
|
|
242
|
+
const res = await ctx.configAuthCall(ACTION.langSave, body);
|
|
243
|
+
const data = {
|
|
244
|
+
site_id: siteIdOf(ctx),
|
|
245
|
+
id: (res && res.id) || id || '',
|
|
246
|
+
created: !id,
|
|
247
|
+
code: (res && res.code) || body.code || '',
|
|
248
|
+
name: (res && res.name) || body.name || '',
|
|
249
|
+
saved: true,
|
|
250
|
+
};
|
|
251
|
+
if (!out.json) out.ok(`${id ? '语言已保存' : '语言已新建'}:${data.code || data.id}`);
|
|
252
|
+
ctx.done(data);
|
|
253
|
+
return data;
|
|
254
|
+
},
|
|
255
|
+
};
|
|
256
|
+
|
|
257
|
+
export const langSetDefaultCommand = {
|
|
258
|
+
name: 'lang set-default',
|
|
259
|
+
summary: '把某个语言设为默认(会自动取消原来的默认,并把它置为启用)',
|
|
260
|
+
usage: 'wkgeo lang set-default <语言ID> [--confirm] [--site <站点ID>]',
|
|
261
|
+
args: [{ name: 'lang', required: true, desc: '语言 ID' }],
|
|
262
|
+
flags: { ...CONFIRM_FLAG, ...SITE_FLAG },
|
|
263
|
+
examples: ['wkgeo lang set-default 8f3c…', 'wkgeo lang set-default 8f3c… --confirm'],
|
|
264
|
+
notes: [
|
|
265
|
+
'需要 `site:write`。**默认 dry-run**,加 `--confirm` 才真发。',
|
|
266
|
+
'服务端会在同一个事务语义里先清掉旧的默认,再把这个语言设成默认 + 启用。',
|
|
267
|
+
],
|
|
268
|
+
async run(ctx) {
|
|
269
|
+
const id = String(ctx.positional.lang || '').trim();
|
|
270
|
+
if (!id) throw new UsageError('缺少语言 ID');
|
|
271
|
+
const body = { id };
|
|
272
|
+
if (!ctx.flags.confirm) return dryRun(ctx, ACTION.langSetDefault, body, [`语言 ID:${id}`, '效果:设为默认并启用']);
|
|
273
|
+
|
|
274
|
+
const { out } = ctx;
|
|
275
|
+
await ctx.configAuthCall(ACTION.langSetDefault, body);
|
|
276
|
+
const data = { site_id: siteIdOf(ctx), id, is_default: true };
|
|
277
|
+
if (!out.json) out.ok(`已设为默认语言:${id}`);
|
|
278
|
+
ctx.done(data);
|
|
279
|
+
return data;
|
|
280
|
+
},
|
|
281
|
+
};
|
|
282
|
+
|
|
283
|
+
export const langDeleteCommand = {
|
|
284
|
+
name: 'lang delete',
|
|
285
|
+
summary: '删除语言(默认语言不给删)',
|
|
286
|
+
usage: 'wkgeo lang delete <语言ID> [--confirm] [--site <站点ID>]',
|
|
287
|
+
args: [{ name: 'lang', required: true, desc: '语言 ID' }],
|
|
288
|
+
flags: { ...CONFIRM_FLAG, ...SITE_FLAG },
|
|
289
|
+
examples: ['wkgeo lang delete 8f3c…', 'wkgeo lang delete 8f3c… --confirm'],
|
|
290
|
+
notes: [
|
|
291
|
+
'需要 `site:write`。**默认 dry-run**,加 `--confirm` 才真删。',
|
|
292
|
+
'默认语言不许删:先把别的语言设成默认(`wkgeo lang set-default`),再删它。',
|
|
293
|
+
'删语言会连带删掉该语言下的内容翻译 —— 这是不可恢复的,所以默认不真发。',
|
|
294
|
+
],
|
|
295
|
+
async run(ctx) {
|
|
296
|
+
const id = String(ctx.positional.lang || '').trim();
|
|
297
|
+
if (!id) throw new UsageError('缺少语言 ID');
|
|
298
|
+
const body = { id };
|
|
299
|
+
if (!ctx.flags.confirm) return dryRun(ctx, ACTION.langDelete, body, [`语言 ID:${id}`, '注意:该语言下的翻译内容会一起消失']);
|
|
300
|
+
|
|
301
|
+
const { out } = ctx;
|
|
302
|
+
const res = await ctx.configAuthCall(ACTION.langDelete, body);
|
|
303
|
+
const data = { site_id: siteIdOf(ctx), id, deleted: !!(res && res.deleted) };
|
|
304
|
+
if (!out.json) out.ok(`语言已删除:${id}`);
|
|
305
|
+
ctx.done(data);
|
|
306
|
+
return data;
|
|
307
|
+
},
|
|
308
|
+
};
|
|
309
|
+
|
|
310
|
+
export const langToggleCommand = {
|
|
311
|
+
name: 'lang toggle',
|
|
312
|
+
summary: '启用 / 停用某个语言(默认语言不能停用)',
|
|
313
|
+
usage: 'wkgeo lang toggle <语言ID> [--off] [--confirm] [--site <站点ID>]',
|
|
314
|
+
args: [{ name: 'lang', required: true, desc: '语言 ID' }],
|
|
315
|
+
flags: {
|
|
316
|
+
off: { type: 'boolean', desc: '停用(不加 = 启用)' },
|
|
317
|
+
...CONFIRM_FLAG,
|
|
318
|
+
...SITE_FLAG,
|
|
319
|
+
},
|
|
320
|
+
examples: ['wkgeo lang toggle 8f3c… # dry-run(启用)', 'wkgeo lang toggle 8f3c… --off --confirm'],
|
|
321
|
+
notes: [
|
|
322
|
+
'需要 `site:write`。**默认 dry-run**,加 `--confirm` 才真发。',
|
|
323
|
+
'默认语言不能停用(服务端 400);要停用先 `wkgeo lang set-default` 换一个默认。',
|
|
324
|
+
'审计:这条动作在 CMS 里写 `cms_log`,CLI 侧改落 `public.admin_audit_log`(动作名 `cli.lang.toggle`)。',
|
|
325
|
+
],
|
|
326
|
+
async run(ctx) {
|
|
327
|
+
const id = String(ctx.positional.lang || '').trim();
|
|
328
|
+
if (!id) throw new UsageError('缺少语言 ID');
|
|
329
|
+
const enabled = !ctx.flags.off;
|
|
330
|
+
const body = { id, enabled };
|
|
331
|
+
if (!ctx.flags.confirm) {
|
|
332
|
+
return dryRun(ctx, ACTION.langToggle, body, [`语言 ID:${id}`, `效果:${enabled ? '启用' : '停用'}`]);
|
|
333
|
+
}
|
|
334
|
+
|
|
335
|
+
const { out } = ctx;
|
|
336
|
+
await ctx.configAuthCall(ACTION.langToggle, body);
|
|
337
|
+
const data = { site_id: siteIdOf(ctx), id, enabled };
|
|
338
|
+
if (!out.json) out.ok(`语言已${enabled ? '启用' : '停用'}:${id}`);
|
|
339
|
+
ctx.done(data);
|
|
340
|
+
return data;
|
|
341
|
+
},
|
|
342
|
+
};
|
|
343
|
+
|
|
344
|
+
/* ══════════════════════════════ 角色(role) ══════════════════════════════ */
|
|
345
|
+
|
|
346
|
+
export const roleListCommand = {
|
|
347
|
+
name: 'role list',
|
|
348
|
+
summary: '站点角色列表(含权限明细与成员数)',
|
|
349
|
+
usage: 'wkgeo role list [--site <站点ID>]',
|
|
350
|
+
args: [],
|
|
351
|
+
flags: { ...SITE_FLAG },
|
|
352
|
+
examples: ['wkgeo role list', 'wkgeo role list --json'],
|
|
353
|
+
notes: [
|
|
354
|
+
'需要 `site:read`(只读)。',
|
|
355
|
+
'`permissions` 是 **CLI 内部英文码**(`{"content":["view","edit"]}`);CMS 前端那份是中文键,两边故意不同。',
|
|
356
|
+
'预置角色(sysadmin / webadmin / contentadmin)不可删,sysadmin 的权限也不可改。',
|
|
357
|
+
],
|
|
358
|
+
async run(ctx) {
|
|
359
|
+
const { out } = ctx;
|
|
360
|
+
const res = await ctx.configAuthCall(ACTION.roleList);
|
|
361
|
+
const rows = (res && Array.isArray(res.rows) ? res.rows : []).map((r) => r || {});
|
|
362
|
+
const data = { site_id: siteIdOf(ctx), rows, total: rows.length };
|
|
363
|
+
|
|
364
|
+
if (!out.json) {
|
|
365
|
+
out.head(`角色列表(${rows.length} 个 · 站点 ${siteText(ctx)})`);
|
|
366
|
+
out.table(
|
|
367
|
+
[
|
|
368
|
+
{ title: '代码', key: 'code', width: 14, format: (v, row) => `${v || ''}${row.builtin ? '(预置)' : ''}` },
|
|
369
|
+
{ title: '名称', key: 'name', width: 16 },
|
|
370
|
+
{ title: '权限数', key: 'count', width: 8 },
|
|
371
|
+
{ title: '权限', key: 'permissions', width: 0, format: (v) => permissionsText(v) },
|
|
372
|
+
{ title: '角色 ID', key: 'id', width: 38 },
|
|
373
|
+
],
|
|
374
|
+
rows,
|
|
375
|
+
);
|
|
376
|
+
}
|
|
377
|
+
ctx.done(data);
|
|
378
|
+
return data;
|
|
379
|
+
},
|
|
380
|
+
};
|
|
381
|
+
|
|
382
|
+
export const roleSaveCommand = {
|
|
383
|
+
name: 'role save',
|
|
384
|
+
summary: '保存站点角色:给了 <角色ID> 就改,没给就新建(新建需要 --name)',
|
|
385
|
+
usage:
|
|
386
|
+
'wkgeo role save [角色ID] --name <名称> [--description <说明>] [--permissions <权限>] [--confirm]',
|
|
387
|
+
args: [{ name: 'role', required: false, desc: '角色 ID(给了就改,不给就新建)' }],
|
|
388
|
+
flags: {
|
|
389
|
+
name: { type: 'string', desc: '角色名称(≤30 字)' },
|
|
390
|
+
description: { type: 'string', desc: '角色说明(≤200 字)' },
|
|
391
|
+
permissions: {
|
|
392
|
+
type: 'string',
|
|
393
|
+
desc: '权限:JSON({"content":["view","edit"]})或紧凑写法(content=view,edit;base=view)',
|
|
394
|
+
},
|
|
395
|
+
...CONFIRM_FLAG,
|
|
396
|
+
...SITE_FLAG,
|
|
397
|
+
},
|
|
398
|
+
examples: [
|
|
399
|
+
'wkgeo role save --name 编辑 --permissions content=view,edit # dry-run',
|
|
400
|
+
'wkgeo role save --name 编辑 --permissions \'{"content":["view","edit"]}\' --confirm',
|
|
401
|
+
'wkgeo role list --json # 改已有角色前先取现有 permissions',
|
|
402
|
+
'wkgeo role save 8f3c… --name 编辑 --permissions content=view,edit,delete --confirm',
|
|
403
|
+
],
|
|
404
|
+
notes: [
|
|
405
|
+
'需要 **`role:write`**(`site:write` 不继承它 —— 能改角色 = 能给自己发权限)。',
|
|
406
|
+
'**默认 dry-run**,加 `--confirm` 才真发。',
|
|
407
|
+
'**改角色必须带 `--permissions`**:服务端的更新是整行覆盖,不带会把该角色权限清空。先 `role list --json` 取现值。',
|
|
408
|
+
'**不许造带「系统管理」权限的角色**:`system`(用户管理 / 角色管理)或其中文别名出现即 400(自我提权链的闸)。',
|
|
409
|
+
'合法能力组:config / base / content / framework / template / plugin / asset;动作:view / create / edit / delete。',
|
|
410
|
+
],
|
|
411
|
+
async run(ctx) {
|
|
412
|
+
const id = String(ctx.positional.role || '').trim();
|
|
413
|
+
const body = {};
|
|
414
|
+
if (id) body.id = id;
|
|
415
|
+
if (ctx.flags.name !== undefined) body.name = String(ctx.flags.name);
|
|
416
|
+
if (ctx.flags.description !== undefined) body.description = String(ctx.flags.description);
|
|
417
|
+
const permissions = ctx.flags.permissions === undefined ? undefined : parsePermissions(ctx.flags.permissions);
|
|
418
|
+
|
|
419
|
+
if (!id && !body.name) throw new UsageError('新建角色必须带 --name(如 --name 编辑)');
|
|
420
|
+
if (id && permissions === undefined) {
|
|
421
|
+
throw new UsageError(
|
|
422
|
+
'改角色必须带 --permissions(服务端是整行覆盖,不带会把权限清空):先 `wkgeo role list --json` 取现有 permissions,改完整份提交',
|
|
423
|
+
);
|
|
424
|
+
}
|
|
425
|
+
if (permissions !== undefined) body.permissions = permissions;
|
|
426
|
+
|
|
427
|
+
const lines = [
|
|
428
|
+
['角色 ID', id || '(新建)'],
|
|
429
|
+
['名称', body.name === undefined ? '(不改)' : body.name],
|
|
430
|
+
['说明', body.description === undefined ? '(不改)' : body.description],
|
|
431
|
+
['权限', permissions === undefined ? '(不改)' : permissionsText(permissions)],
|
|
432
|
+
];
|
|
433
|
+
if (!ctx.flags.confirm) return dryRun(ctx, ACTION.roleSave, body, lines.map(([k, v]) => `${k}:${v}`));
|
|
434
|
+
|
|
435
|
+
const { out } = ctx;
|
|
436
|
+
const res = await ctx.configAuthCall(ACTION.roleSave, body);
|
|
437
|
+
const data = {
|
|
438
|
+
site_id: siteIdOf(ctx),
|
|
439
|
+
id: (res && res.id) || id || '',
|
|
440
|
+
created: !id,
|
|
441
|
+
name: body.name || '',
|
|
442
|
+
saved: true,
|
|
443
|
+
};
|
|
444
|
+
if (!out.json) out.ok(`${id ? '角色已保存' : '角色已新建'}:${data.name || data.id}`);
|
|
445
|
+
ctx.done(data);
|
|
446
|
+
return data;
|
|
447
|
+
},
|
|
448
|
+
};
|
|
449
|
+
|
|
450
|
+
export const roleDeleteCommand = {
|
|
451
|
+
name: 'role delete',
|
|
452
|
+
summary: '删除站点角色(预置角色不能删;还有成员在用时服务端会拒绝)',
|
|
453
|
+
usage: 'wkgeo role delete <角色ID> [--confirm] [--site <站点ID>]',
|
|
454
|
+
args: [{ name: 'role', required: true, desc: '角色 ID' }],
|
|
455
|
+
flags: { ...CONFIRM_FLAG, ...SITE_FLAG },
|
|
456
|
+
examples: ['wkgeo role delete 8f3c…', 'wkgeo role delete 8f3c… --confirm'],
|
|
457
|
+
notes: [
|
|
458
|
+
'需要 **`role:write`**。**默认 dry-run**,加 `--confirm` 才真删。',
|
|
459
|
+
'预置角色(sysadmin / webadmin / contentadmin)不给删(403)。',
|
|
460
|
+
'还有成员在用这个角色时回 409 —— 先给他们换角色(`wkgeo member update <用户ID> --role …`)。',
|
|
461
|
+
],
|
|
462
|
+
async run(ctx) {
|
|
463
|
+
const id = String(ctx.positional.role || '').trim();
|
|
464
|
+
if (!id) throw new UsageError('缺少角色 ID');
|
|
465
|
+
const body = { id };
|
|
466
|
+
if (!ctx.flags.confirm) return dryRun(ctx, ACTION.roleDelete, body, [`角色 ID:${id}`]);
|
|
467
|
+
|
|
468
|
+
const { out } = ctx;
|
|
469
|
+
const res = await ctx.configAuthCall(ACTION.roleDelete, body);
|
|
470
|
+
const data = { site_id: siteIdOf(ctx), id, deleted: !!(res && res.deleted) };
|
|
471
|
+
if (!out.json) out.ok(`角色已删除:${id}`);
|
|
472
|
+
ctx.done(data);
|
|
473
|
+
return data;
|
|
474
|
+
},
|
|
475
|
+
};
|
|
476
|
+
|
|
477
|
+
/* ══════════════════════════════ 站点成员(member) ══════════════════════════════ */
|
|
478
|
+
|
|
479
|
+
export const memberListCommand = {
|
|
480
|
+
name: 'member list',
|
|
481
|
+
summary: '站点成员列表(手机号**已掩码**,不返回明文)',
|
|
482
|
+
usage: 'wkgeo member list [--site <站点ID>]',
|
|
483
|
+
args: [],
|
|
484
|
+
flags: { ...SITE_FLAG },
|
|
485
|
+
examples: ['wkgeo member list', 'wkgeo member list --json'],
|
|
486
|
+
notes: [
|
|
487
|
+
'需要 `site:read`(只读)。',
|
|
488
|
+
'**手机号永远是掩码**(`138****8000`):这是 CLI 通道的硬口径,不提供"看明文"的开关。',
|
|
489
|
+
'`roleCode` 是站点内角色代码;业主(owner)那一行的角色恒为 sysadmin 且不能改。',
|
|
490
|
+
],
|
|
491
|
+
async run(ctx) {
|
|
492
|
+
const { out } = ctx;
|
|
493
|
+
const res = await ctx.configAuthCall(ACTION.memberList);
|
|
494
|
+
const rows = (res && Array.isArray(res.rows) ? res.rows : []).map((r) => r || {});
|
|
495
|
+
const assignableRoles = (res && Array.isArray(res.assignableRoles) ? res.assignableRoles : []).map((r) => r || {});
|
|
496
|
+
const data = {
|
|
497
|
+
site_id: siteIdOf(ctx),
|
|
498
|
+
rows,
|
|
499
|
+
total: rows.length,
|
|
500
|
+
assignable_roles: assignableRoles,
|
|
501
|
+
};
|
|
502
|
+
|
|
503
|
+
if (!out.json) {
|
|
504
|
+
out.head(`站点成员(${rows.length} 人 · 站点 ${siteText(ctx)})`);
|
|
505
|
+
out.table(
|
|
506
|
+
[
|
|
507
|
+
{ title: '手机号', key: 'mobile', width: 14 },
|
|
508
|
+
{ title: '昵称', key: 'displayName', width: 18 },
|
|
509
|
+
{ title: '角色', key: 'roleName', width: 14 },
|
|
510
|
+
{ title: '业主', key: 'isOwner', width: 6, format: (v) => (v ? '是' : '') },
|
|
511
|
+
{ title: '加入时间', key: 'joinedAt', width: 20, format: (v) => formatTime(v) },
|
|
512
|
+
{ title: '用户 ID', key: 'userId', width: 38 },
|
|
513
|
+
],
|
|
514
|
+
rows,
|
|
515
|
+
);
|
|
516
|
+
if (assignableRoles.length) {
|
|
517
|
+
out.line('');
|
|
518
|
+
out.line(` 可分配角色:${assignableRoles.map((r) => `${r.name || r.code}(${r.code})`).join('、')}`);
|
|
519
|
+
}
|
|
520
|
+
}
|
|
521
|
+
ctx.done(data);
|
|
522
|
+
return data;
|
|
523
|
+
},
|
|
524
|
+
};
|
|
525
|
+
|
|
526
|
+
export const memberUpdateCommand = {
|
|
527
|
+
name: 'member update',
|
|
528
|
+
summary: '改站点成员的角色(只能是本站角色;不能动业主 / 不能改自己)',
|
|
529
|
+
usage: 'wkgeo member update <用户ID> --role <角色ID|角色代码> [--confirm] [--site <站点ID>]',
|
|
530
|
+
args: [{ name: 'user', required: true, desc: '用户 ID(uuid,见 `wkgeo member list`)' }],
|
|
531
|
+
flags: {
|
|
532
|
+
role: { type: 'string', desc: '目标角色(角色 ID 或角色代码;不给 = 回落 contentadmin)' },
|
|
533
|
+
...CONFIRM_FLAG,
|
|
534
|
+
...SITE_FLAG,
|
|
535
|
+
},
|
|
536
|
+
examples: [
|
|
537
|
+
'wkgeo member update 8f3c… --role contentadmin # dry-run',
|
|
538
|
+
'wkgeo member update 8f3c… --role contentadmin --confirm',
|
|
539
|
+
'wkgeo member list # 先看有哪些人和哪些角色',
|
|
540
|
+
],
|
|
541
|
+
notes: [
|
|
542
|
+
'需要 `site:write`。**默认 dry-run**,加 `--confirm` 才真发。',
|
|
543
|
+
'服务端约束:目标必须已是本站成员(否则 404);角色必须属于本站(否则 400);不能改业主、不能改自己的角色。',
|
|
544
|
+
'这里**只能改站点内角色**:手机号 / 昵称 / 密码等平台级字段一律 400(改资料由本人到「编辑资料」里改)。',
|
|
545
|
+
],
|
|
546
|
+
async run(ctx) {
|
|
547
|
+
const userId = String(ctx.positional.user || '').trim();
|
|
548
|
+
if (!userId) throw new UsageError('缺少用户 ID(见 `wkgeo member list`)');
|
|
549
|
+
const roleRef = String(ctx.flags.role || '').trim();
|
|
550
|
+
const body = { userId };
|
|
551
|
+
if (roleRef) body.roleId = roleRef;
|
|
552
|
+
|
|
553
|
+
const lines = [
|
|
554
|
+
['用户 ID', userId],
|
|
555
|
+
['目标角色', roleRef || '(回落 contentadmin)'],
|
|
556
|
+
];
|
|
557
|
+
if (!ctx.flags.confirm) return dryRun(ctx, ACTION.memberUpdate, body, lines.map(([k, v]) => `${k}:${v}`));
|
|
558
|
+
|
|
559
|
+
const { out } = ctx;
|
|
560
|
+
const res = await ctx.configAuthCall(ACTION.memberUpdate, body);
|
|
561
|
+
const data = {
|
|
562
|
+
site_id: siteIdOf(ctx),
|
|
563
|
+
user_id: userId,
|
|
564
|
+
role_id: (res && res.roleId) || roleRef || '',
|
|
565
|
+
updated: !!(res && res.updated),
|
|
566
|
+
};
|
|
567
|
+
if (!out.json) out.ok(`成员角色已更新:${userId}`);
|
|
568
|
+
ctx.done(data);
|
|
569
|
+
return data;
|
|
570
|
+
},
|
|
571
|
+
};
|
|
572
|
+
|
|
573
|
+
export const memberRemoveCommand = {
|
|
574
|
+
name: 'member remove',
|
|
575
|
+
summary: '把成员移出本站(账号本身还在,别的站不受影响)',
|
|
576
|
+
usage: 'wkgeo member remove <用户ID> [--confirm] [--site <站点ID>]',
|
|
577
|
+
args: [{ name: 'user', required: true, desc: '用户 ID(uuid,见 `wkgeo member list`)' }],
|
|
578
|
+
flags: { ...CONFIRM_FLAG, ...SITE_FLAG },
|
|
579
|
+
examples: ['wkgeo member remove 8f3c…', 'wkgeo member remove 8f3c… --confirm'],
|
|
580
|
+
notes: [
|
|
581
|
+
'需要 `site:write`。**默认 dry-run**,加 `--confirm` 才真移出。',
|
|
582
|
+
'只删 `cms_site_member` 这一行(**不删账号、不动密码**);同一账号在别的站不受影响。',
|
|
583
|
+
'不能移出业主、不能移出自己(403)。',
|
|
584
|
+
],
|
|
585
|
+
async run(ctx) {
|
|
586
|
+
const userId = String(ctx.positional.user || '').trim();
|
|
587
|
+
if (!userId) throw new UsageError('缺少用户 ID(见 `wkgeo member list`)');
|
|
588
|
+
const body = { userId };
|
|
589
|
+
if (!ctx.flags.confirm) return dryRun(ctx, ACTION.memberRemove, body, [`用户 ID:${userId}`, '注意:他从本站的后台权限会立刻消失']);
|
|
590
|
+
|
|
591
|
+
const { out } = ctx;
|
|
592
|
+
const res = await ctx.configAuthCall(ACTION.memberRemove, body);
|
|
593
|
+
const data = {
|
|
594
|
+
site_id: siteIdOf(ctx),
|
|
595
|
+
user_id: userId,
|
|
596
|
+
removed: !!(res && res.removed),
|
|
597
|
+
note: (res && res.note) || '只是从本站移出,账号本身还在(别的站不受影响)',
|
|
598
|
+
};
|
|
599
|
+
if (!out.json) out.ok(`已移出本站:${userId}`);
|
|
600
|
+
ctx.done(data);
|
|
601
|
+
return data;
|
|
602
|
+
},
|
|
603
|
+
};
|
|
604
|
+
|
|
605
|
+
/** 11 条命令(注册表里按 lang → role → member 顺序展开) */
|
|
606
|
+
export const CONFIG_AUTH_COMMANDS = [
|
|
607
|
+
langListCommand,
|
|
608
|
+
langSaveCommand,
|
|
609
|
+
langSetDefaultCommand,
|
|
610
|
+
langDeleteCommand,
|
|
611
|
+
langToggleCommand,
|
|
612
|
+
roleListCommand,
|
|
613
|
+
roleSaveCommand,
|
|
614
|
+
roleDeleteCommand,
|
|
615
|
+
memberListCommand,
|
|
616
|
+
memberUpdateCommand,
|
|
617
|
+
memberRemoveCommand,
|
|
618
|
+
];
|
|
619
|
+
|
|
620
|
+
/* 说明:这一层只用 `UsageError`(命令行参数问题);服务端回执(403/404/409/400)
|
|
621
|
+
* 由 `runtime.callData()` 统一翻成 CliError 并带 hint —— 命令里不重复判一遍。 */
|