@wkgeo/cli 2.0.3 → 2.2.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +19 -2
- package/README.md +7 -7
- package/SKILL.md +1038 -1038
- package/lib/api.mjs +351 -351
- package/lib/args.mjs +235 -235
- package/lib/build.mjs +1047 -0
- package/lib/cms.mjs +328 -328
- package/lib/commands/auth.mjs +1280 -1280
- package/lib/commands/data.mjs +694 -694
- package/lib/commands/index.mjs +17 -1
- package/lib/commands/init.mjs +111 -111
- package/lib/commands/orders.mjs +691 -691
- package/lib/commands/site.mjs +82 -0
- package/lib/commands/siteops.mjs +382 -0
- package/lib/commands/sites.mjs +968 -801
- package/lib/commands/spec.mjs +72 -72
- package/lib/commands/template.mjs +1484 -1484
- package/lib/config.mjs +57 -4
- package/lib/errors.mjs +446 -336
- package/lib/manifest-apply.mjs +1650 -1650
- package/lib/manifest-schema.json +480 -480
- package/lib/manifest.mjs +1106 -1106
- package/lib/runtime.mjs +798 -654
- package/lib/site-create.mjs +537 -537
- package/lib/site-credentials.mjs +157 -0
- package/lib/site-meta.mjs +474 -0
- package/lib/site-publish.mjs +410 -0
- package/lib/site-spec.mjs +302 -302
- package/lib/site-template.mjs +405 -0
- package/lib/template-gen.mjs +1354 -1354
- package/lib/template-publish.mjs +696 -696
- package/lib/templates-sync.mjs +676 -644
- package/lib/workspace-sync.mjs +386 -0
- package/package.json +56 -56
- package/spec/SITE-SPEC.md +198 -198
package/lib/commands/auth.mjs
CHANGED
|
@@ -1,1280 +1,1280 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* 账号类命令:`login` / `logout` / `whoami` / `config`
|
|
3
|
-
*
|
|
4
|
-
* ⚠️ 非交互铁律:这些命令**任何情况下都不提问**(不用 AI 去"按 y")。
|
|
5
|
-
* 需要用户做的事(同意授权)表现为:打印网址 + 阻塞等待 + 超时给明确错误。
|
|
6
|
-
*/
|
|
7
|
-
|
|
8
|
-
import { runLogin } from '../login.mjs';
|
|
9
|
-
import { requestDeviceCode, announceDeviceCode, pollDeviceToken, devicePasteText } from '../device.mjs';
|
|
10
|
-
import {
|
|
11
|
-
pendingDeviceFile,
|
|
12
|
-
savePendingDevice,
|
|
13
|
-
readPendingDevice,
|
|
14
|
-
deletePendingDevice,
|
|
15
|
-
isPendingExpired,
|
|
16
|
-
pendingExpiredError,
|
|
17
|
-
} from '../device-store.mjs';
|
|
18
|
-
import { proxyWarningPayload, proxyDeviceSwitchLines, proxyForcedCallbackLines } from '../proxy.mjs';
|
|
19
|
-
import { deleteCredentials, readCredentials, checkFileMode, isExpired } from '../credentials.mjs';
|
|
20
|
-
import { formatRemaining, maskToken, formatTime } from '../format.mjs';
|
|
21
|
-
import { CliError, EXIT, loginHint, UsageError } from '../errors.mjs';
|
|
22
|
-
import { describeConfigSources, parseDurationMs } from '../config.mjs';
|
|
23
|
-
import { GLOBAL_FLAGS } from '../args.mjs';
|
|
24
|
-
|
|
25
|
-
/**
|
|
26
|
-
* 「检测到系统代理时自动改用设备码」这个开关的解析(默认 **开**)。
|
|
27
|
-
*
|
|
28
|
-
* ## 为什么默认开,而不是 opt-in(老板 2026-10-02 明确要求)
|
|
29
|
-
* 老板原话:「如果能检测到有代理,可不可以**直接返回设备码**,然后用户把它输入到 AI 端的
|
|
30
|
-
* 对话框里……你那个让用户检查代理设置太不方便了,**很多用户也不懂**。」
|
|
31
|
-
* → 主路径必须是"用户什么都不用做就能成功"。三条"改代理设置"的提示保留为**补充说明**,
|
|
32
|
-
* 但绝不能是唯一出路(不懂代理的用户会直接卡死)。
|
|
33
|
-
*
|
|
34
|
-
* ## ⚠️ 2026-10-02 第二版加固:判定依据从 `risk` 改成 `detected`
|
|
35
|
-
* 第一版是"有代理 **且** 绕过列表没写回环(`risk`)才降级"。真机上彻底失效:
|
|
36
|
-
* 老板的机器绕过列表里**写着** `127.*;localhost`,于是判成"不风险"、走了回调,
|
|
37
|
-
* 结果他点了【同意授权】之后 CLI **一直拿不到令牌**
|
|
38
|
-
* (独立证据:`curl -x http://127.0.0.1:7890 http://127.0.0.1:1/x` 返回 502,
|
|
39
|
-
* 说明那台机器上的代理**会尝试接管回环请求**)。
|
|
40
|
-
* ⇒ 现在:**只要 `proxyInfo.detected === true` 就直接走设备码**,
|
|
41
|
-
* 宁可多一步(用户按一次短码),也绝不让用户卡在"点了同意却没反应"。
|
|
42
|
-
* `loopback_bypassed` / `risk` 只进诊断字段。
|
|
43
|
-
*
|
|
44
|
-
* ## 什么情况下关掉它
|
|
45
|
-
* `--no-auto-device` 或 `WKONGAI_AUTO_DEVICE=0`:
|
|
46
|
-
* * 你确认回调一定通(例如内网、代理已正确绕过回环),不想被自动改道;
|
|
47
|
-
* * 探测本身有误报(例如命中 PAC:绕过规则写在脚本里,我们无法零依赖求值)。
|
|
48
|
-
* ⚠️ 关掉时 CLI **必须**警告"代理可能吃掉回调"(见 proxyForcedCallbackLines)——
|
|
49
|
-
* 否则用户就只剩"点了同意干等到超时"这一种结局。
|
|
50
|
-
*
|
|
51
|
-
* ## 优先级(显式 > 环境变量 > 默认)
|
|
52
|
-
* `--auto-device` / `--no-auto-device`(命令行)> `WKONGAI_AUTO_DEVICE`(0/false/no/off = 关)> 默认开
|
|
53
|
-
*/
|
|
54
|
-
export function resolveAutoDevice(flags = {}, env = {}) {
|
|
55
|
-
if (flags.autoDevice === false) return false;
|
|
56
|
-
if (flags.autoDevice === true) return true;
|
|
57
|
-
const v = String((env && env.WKONGAI_AUTO_DEVICE) || '')
|
|
58
|
-
.trim()
|
|
59
|
-
.toLowerCase();
|
|
60
|
-
if (['0', 'false', 'no', 'off'].includes(v)) return false;
|
|
61
|
-
return true;
|
|
62
|
-
}
|
|
63
|
-
|
|
64
|
-
/**
|
|
65
|
-
* 「回调模式首轮等待」窗口(毫秒)的解析 —— **可选自愈,默认关闭**。
|
|
66
|
-
*
|
|
67
|
-
* ## ★★ 0.2.2(老板 2026-10-21 反馈):默认不再自动改设备码
|
|
68
|
-
* 老板原话:「默认的也不应该是设备授权,默认的就是那个传统的授权方式(浏览器打开授权页 +
|
|
69
|
-
* 本地 localhost 回调)。设备码是本地读不了/代理时才用的。」
|
|
70
|
-
* ⇒ 本函数**不再**按"有没有代理"给默认值:用户没显式指定时**一律返回 0**。
|
|
71
|
-
* 也就是说 `wkgeo login` 默认会一路等回调到 `--timeout`,**不会**因为等太久自动改设备码。
|
|
72
|
-
*
|
|
73
|
-
* 设备码只在这两种情况出现(见 loginCommand.run):
|
|
74
|
-
* 1. 用户显式 `--device` / `--no-wait` / `--device-continue`;
|
|
75
|
-
* 2. 检测到系统代理且判定回调不可用(`--no-auto-device` 可关)。
|
|
76
|
-
* ⚠️ 0.2.4 起:**本地回调端口起不来不再自动改设备码**(老板反馈"服务没起来却换了模式"),
|
|
77
|
-
* 而是如实报 `kind:"listen"` 并在 hint 里明确建议用户显式加 `--device`。
|
|
78
|
-
*
|
|
79
|
-
* ## 保留的显式开关(向后兼容,不参与默认判断)
|
|
80
|
-
* `--callback-first-wait <时长>`(默认单位**秒**;`0` / `off` / `none` = 关闭)
|
|
81
|
-
* > `WKONGAI_CALLBACK_FIRST_WAIT_MS`(毫秒)
|
|
82
|
-
* > 默认 **0(关闭)**
|
|
83
|
-
* ⇒ 只有用户**显式**写了它,才会在首轮等待到点后并发启动设备码(两条路先到先得)。
|
|
84
|
-
* 显式指定是用户的明确选择,我们照旧尊重(但他不写就绝不会自动发生)。
|
|
85
|
-
*
|
|
86
|
-
* ⚠️ `--no-auto-device`(autoDevice=false)时**强制返回 0**:用户已经明确要求"只走回调",
|
|
87
|
-
* 我们就连显式开关也不启用(不背着他改道)。此时整段 `--timeout` 依然是兜底。
|
|
88
|
-
*
|
|
89
|
-
* @param {object} flags 已解析的命令行标志(camelCase)
|
|
90
|
-
* @param {object} env 环境变量
|
|
91
|
-
* @param {{autoDevice?: boolean, proxyDetected?: boolean}} [opts]
|
|
92
|
-
* `proxyDetected` 仅为**兼容旧调用方**保留,**已不影响返回值**(0.2.2 起默认永不开启)。
|
|
93
|
-
* @returns {number} 毫秒;0 = 不启用(默认)
|
|
94
|
-
*/
|
|
95
|
-
export function resolveCallbackFirstWaitMs(flags = {}, env = {}, { autoDevice = true } = {}) {
|
|
96
|
-
if (!autoDevice) return 0;
|
|
97
|
-
const off = new Set(['0', 'off', 'none', 'false', 'no']);
|
|
98
|
-
if (flags.callbackFirstWait !== undefined && flags.callbackFirstWait !== '') {
|
|
99
|
-
const raw = String(flags.callbackFirstWait).trim().toLowerCase();
|
|
100
|
-
if (off.has(raw)) return 0;
|
|
101
|
-
return parseDurationMs(flags.callbackFirstWait, { defaultUnit: 's', flag: '--callback-first-wait' });
|
|
102
|
-
}
|
|
103
|
-
const envVal = env && env.WKONGAI_CALLBACK_FIRST_WAIT_MS;
|
|
104
|
-
if (envVal !== undefined && envVal !== '') {
|
|
105
|
-
if (off.has(String(envVal).trim().toLowerCase())) return 0;
|
|
106
|
-
return parseDurationMs(envVal, { defaultUnit: 'ms', flag: 'WKONGAI_CALLBACK_FIRST_WAIT_MS' });
|
|
107
|
-
}
|
|
108
|
-
/**
|
|
109
|
-
* ★ 走到这里 = 用户**没有**显式指定 ⇒ **默认不启用**(0.2.2 起)。
|
|
110
|
-
* 不再看 `proxyDetected`:有代理时命令层已经在第一跳直接走设备码了,
|
|
111
|
-
* 回调模式下的"等待超时"只该如实报错,不该偷偷改道。
|
|
112
|
-
*/
|
|
113
|
-
return 0;
|
|
114
|
-
}
|
|
115
|
-
|
|
116
|
-
/**
|
|
117
|
-
* ★ 「回调 / 设备码两条路并存」时用的**可被立刻叫醒的 sleep**。
|
|
118
|
-
*
|
|
119
|
-
* 为什么需要它:`pollDeviceToken()` 每轮之间会 `await sleep(interval)`(默认 5 秒)。
|
|
120
|
-
* 回调那条路先拿到令牌时,设备码那条路必须**马上**停下来 —— 如果只是置一个"别再轮询"的标志,
|
|
121
|
-
* 那个**已经挂上**的 `setTimeout` 会把 Node 的事件循环继续吊住(用户已经看到"登录成功",
|
|
122
|
-
* 进程却迟迟不退出)。所以这里把 sleep 做成可唤醒的:谁赢了就 `wakeAll()`,
|
|
123
|
-
* 挂着的那一轮立刻醒来,醒来后由 `shouldStop()`(见 device.mjs)抛错退出。
|
|
124
|
-
*
|
|
125
|
-
* ⚠️ 测试注入的 `sleep`(例如 `async () => {}`)**照旧透传**:那种实现立刻返回,
|
|
126
|
-
* 不需要(也无法)被打断 —— 只有生产路径(真 `setTimeout`)才由这里持有并清理。
|
|
127
|
-
*/
|
|
128
|
-
export function createCancelGate(baseSleep) {
|
|
129
|
-
const waiters = new Set();
|
|
130
|
-
let cancelled = false;
|
|
131
|
-
const delegated = typeof baseSleep === 'function';
|
|
132
|
-
return {
|
|
133
|
-
sleep: (ms) => {
|
|
134
|
-
if (cancelled) return Promise.resolve();
|
|
135
|
-
if (delegated) return baseSleep(ms);
|
|
136
|
-
return new Promise((resolve) => {
|
|
137
|
-
const done = () => {
|
|
138
|
-
waiters.delete(done);
|
|
139
|
-
clearTimeout(timer);
|
|
140
|
-
resolve();
|
|
141
|
-
};
|
|
142
|
-
const timer = setTimeout(done, ms);
|
|
143
|
-
waiters.add(done);
|
|
144
|
-
});
|
|
145
|
-
},
|
|
146
|
-
wakeAll() {
|
|
147
|
-
cancelled = true;
|
|
148
|
-
for (const done of [...waiters]) done();
|
|
149
|
-
},
|
|
150
|
-
};
|
|
151
|
-
}
|
|
152
|
-
|
|
153
|
-
/** 回调那条路先成功时用来**安静地**叫停设备码那条路(不是给用户看的错误,命令层会吞掉它) */
|
|
154
|
-
function deviceStoppedError() {
|
|
155
|
-
return new CliError('设备码轮询已停止(本地回调那条路已经拿到令牌)', {
|
|
156
|
-
kind: 'cancelled',
|
|
157
|
-
hint: '不需要做任何事:登录已经完成',
|
|
158
|
-
exitCode: EXIT.AUTH,
|
|
159
|
-
});
|
|
160
|
-
}
|
|
161
|
-
|
|
162
|
-
/**
|
|
163
|
-
* 把"设备码那条路"**等它退出**(失败/被叫停都不许把主流程带下水)。
|
|
164
|
-
*
|
|
165
|
-
* ⚠️ 这里刻意用 `Promise.race` 加一个 1 秒上限:`deviceSide.promise` 的结束速度取决于注入的
|
|
166
|
-
* `sleep` 能不能被打断 —— 生产路径由 `createCancelGate()` 自己持有定时器,`wakeAll()`
|
|
167
|
-
* 一叫就醒(毫秒级);而单测可能注入一个不可打断的假 sleep。
|
|
168
|
-
* 宁可让那次后台轮询在下一轮自己发现 `shouldStop()` 并退出,也不能把用户的登录卡在这里。
|
|
169
|
-
* ⚠️ `deviceSide.promise` 内部两个分支都已 catch(不会 reject),这里 await 它不会抛。
|
|
170
|
-
*/
|
|
171
|
-
async function stopDeviceCodeFlow(deviceSide, cancelGate) {
|
|
172
|
-
if (!deviceSide.promise) return;
|
|
173
|
-
deviceSide.cancelled = true;
|
|
174
|
-
cancelGate.wakeAll();
|
|
175
|
-
await Promise.race([
|
|
176
|
-
deviceSide.promise,
|
|
177
|
-
new Promise((resolve) => {
|
|
178
|
-
const t = setTimeout(resolve, 1000);
|
|
179
|
-
if (t && typeof t.unref === 'function') t.unref();
|
|
180
|
-
}),
|
|
181
|
-
]);
|
|
182
|
-
}
|
|
183
|
-
|
|
184
|
-
/**
|
|
185
|
-
* 两条路都没走通时的报错 —— 回调没等到 + 设备码又失败。
|
|
186
|
-
*
|
|
187
|
-
* ⚠️ 必须把**两件事一起说清楚**:只报设备码那条错,用户会以为"回调其实没问题",
|
|
188
|
-
* 于是又回去重跑 `login`,白等第二个 5 分钟(这是老板真机踩过的那类坑)。
|
|
189
|
-
* ⚠️ 文案里的 `本地回调没成功` / `回调侧的报错` / `设备码侧的报错` 是**契约字样**
|
|
190
|
-
* (`test/proxy-login.test.mjs`「两条路都不通」那条用例按它们断言),不要改写。
|
|
191
|
-
*/
|
|
192
|
-
function bothPathsFailedError(deviceError, reason, { loginTimeoutMs }) {
|
|
193
|
-
const callbackSide =
|
|
194
|
-
reason === 'callback_timeout'
|
|
195
|
-
? `等待授权超时(${loginTimeoutMs}ms,本机回调监听当时仍然开着)`
|
|
196
|
-
: '首轮等待没收到回调(本机回调监听当时仍然开着)';
|
|
197
|
-
return new CliError(`本地回调没成功,改用设备码也失败了:${deviceError.message}`, {
|
|
198
|
-
kind: deviceError.kind || 'device_authorization_failed',
|
|
199
|
-
code: deviceError.code === undefined ? null : deviceError.code,
|
|
200
|
-
hint: `回调侧的报错:${callbackSide};设备码侧的报错:${deviceError.message}。两条路都没走通时,先按提示修掉代理/防火墙,或让服务端确认设备码端点可用`,
|
|
201
|
-
exitCode: deviceError.exitCode === undefined ? EXIT.ERROR : deviceError.exitCode,
|
|
202
|
-
});
|
|
203
|
-
}
|
|
204
|
-
|
|
205
|
-
/**
|
|
206
|
-
* 这些错误意味着"这个设备码已经没救了"(过期/被拒/服务端没有这个能力),
|
|
207
|
-
* 此时磁盘上的待完成状态应该删掉 —— 否则用户下次 `--device-continue` 会拿着一个
|
|
208
|
-
* 注定失败的码去轮询,白等一轮。**网络类错误不在此列**(码还是好的,可以再试)。
|
|
209
|
-
*/
|
|
210
|
-
const TERMINAL_DEVICE_KINDS = new Set(['denied', 'expired', 'not_implemented', 'token_exchange']);
|
|
211
|
-
|
|
212
|
-
/* ------------------------------------------------------------------ */
|
|
213
|
-
/* login */
|
|
214
|
-
/* ------------------------------------------------------------------ */
|
|
215
|
-
|
|
216
|
-
export const loginCommand = {
|
|
217
|
-
name: 'login',
|
|
218
|
-
summary: '浏览器授权一次,把 30 天令牌存到本地(默认本地回调模式;设备码仅在显式 --device / 检测到系统代理时使用)',
|
|
219
|
-
usage:
|
|
220
|
-
'wkgeo login [--scope "site:read site:write billing:self"] [--no-browser] [--open-browser] [--client-id <id>] [--callback-port <n>] [--timeout <秒>]\n' +
|
|
221
|
-
'wkgeo login --device # 设备码模式:不需要回调地址/监听端口,给用户一个短码(兜底路径)\n' +
|
|
222
|
-
'wkgeo login --device --no-wait # ★ 只申请短码就退出(AI 端友好),稍后用下面这条领令牌\n' +
|
|
223
|
-
'wkgeo login --device-continue # 用上次保存的设备码换票、写完凭据就完成登录\n' +
|
|
224
|
-
'wkgeo login --no-auto-device # 检测到系统代理也不自动改设备码(强制回调;CLI 会警告)\n' +
|
|
225
|
-
'wkgeo login --open-browser # 强制尝试打开系统浏览器(⚠️ 现在与默认行为等价,保留只为显式语义与兼容)\n' +
|
|
226
|
-
'wkgeo login --callback-first-wait 60 # ★ 可选:显式启用"首轮等待 60 秒没回调就并行改设备码"(默认关闭;0/off = 关闭)\n' +
|
|
227
|
-
'wkgeo login --timeout 600 # 等待授权 600 秒(默认单位是秒,不是毫秒;也支持 600s / 500ms)',
|
|
228
|
-
flags: {
|
|
229
|
-
browser: { type: 'boolean', desc: '是否自动打开浏览器(★ 默认:人类终端打开;CI/管道/AI 子进程等非交互环境不打开;--no-browser 关闭)' },
|
|
230
|
-
/**
|
|
231
|
-
* ★ 2026-10-21(老板反馈:CI 里弹了浏览器):默认**只在人类终端**自动打开;
|
|
232
|
-
* 非交互/CI 环境(stdout 非 TTY / CI 环境变量 / `WKONGAI_CLI_NO_BROWSER=1`)**一律不打开**。
|
|
233
|
-
* 本开关保留只为两件事:
|
|
234
|
-
* 1. **显式语义**(终端里明确表达"我就是要弹");
|
|
235
|
-
* 2. **兼容**既有脚本(不许删)。
|
|
236
|
-
* ⚠️ 它**压不过**非交互判定(CI 里写它也不弹);与 `--no-browser` 同时出现时 `--no-browser` 优先。
|
|
237
|
-
*/
|
|
238
|
-
'open-browser': { type: 'boolean', desc: '强制尝试打开系统浏览器(⚠️ 仅在人类终端生效;CI/非交互环境仍不打开)' },
|
|
239
|
-
device: { type: 'boolean', desc: '用设备码模式(RFC 8628)代替本地回调:不需要任何回调地址,对代理/防火墙免疫(显式兜底;CLI 不会在端口失败时自动切换过来)' },
|
|
240
|
-
/**
|
|
241
|
-
* ★ 老板 2026-10-02 要的"AI 端友好路径"。
|
|
242
|
-
* 为什么做成"申请完就退出"而不是"申请完继续挂着轮询"(后者靠 JSONL 事件流也能做):
|
|
243
|
-
* AI 端是**一轮一轮**工作的 —— 一次工具调用里挂着等 10 分钟会把用户晾住、也容易撞超时。
|
|
244
|
-
* 拆成"申请"和"领取"两条命令后,中间隔多久都行,且**不需要任何长驻进程**。
|
|
245
|
-
* 两种用法都保留:交互式终端里 `login --device` 一口气跑完更省事;
|
|
246
|
-
* AI/脚本里用 `--device --no-wait` + `--device-continue`(见 README)。
|
|
247
|
-
*/
|
|
248
|
-
'no-wait': { type: 'boolean', desc: '只申请设备码并打印(短码/网址),**立即退出不轮询**;稍后用 --device-continue 领取令牌' },
|
|
249
|
-
'device-continue': { type: 'boolean', desc: '继续上一次 --no-wait/被中断的设备码登录(读取本地保存的设备码并轮询到出结果)' },
|
|
250
|
-
'auto-device': {
|
|
251
|
-
type: 'boolean',
|
|
252
|
-
desc: '检测到系统代理时自动改用设备码(**默认开**;--no-auto-device 或 WKONGAI_AUTO_DEVICE=0 关闭,关闭时会警告"代理可能吃掉回调")',
|
|
253
|
-
},
|
|
254
|
-
/**
|
|
255
|
-
* ★ 可选自愈(默认**关闭**,0.2.2 起)。
|
|
256
|
-
* 默认单位**秒**,与 `--timeout` 一致(人类写等待窗口都按秒想);
|
|
257
|
-
* `0` / `off` / `none` = 关闭(默认值就是关闭)。
|
|
258
|
-
* 环境变量 `WKONGAI_CALLBACK_FIRST_WAIT_MS` 是毫秒(与 `WKONGAI_LOGIN_TIMEOUT_MS` 同口径)。
|
|
259
|
-
*
|
|
260
|
-
* ⚠️ 2026-10-21(老板反馈):**默认不再自动改设备码** —— 不写它时无论等多久都只走回调,
|
|
261
|
-
* 超时只报错。只有显式写它,才会在首轮等待到点后并发启动设备码(显式优先)。
|
|
262
|
-
*/
|
|
263
|
-
'callback-first-wait': {
|
|
264
|
-
type: 'string',
|
|
265
|
-
desc: '★ 可选自愈(默认**关闭**,默认单位秒):显式写它才会在"首轮等待"到点后并行改用设备码继续(本地回调监听同时保留);不写它时**不会**因为等待超时自动改设备码;0/off 关闭',
|
|
266
|
-
},
|
|
267
|
-
/**
|
|
268
|
-
* 显式声明一次(`timeout` 本来就在 GLOBAL_FLAGS 里),只为让 `wkgeo login --help`
|
|
269
|
-
* 把**单位**打在用户眼前 —— 这条命令是最需要等超时的地方。
|
|
270
|
-
* 描述直接引用 `GLOBAL_FLAGS.timeout.desc`,**单一来源**,不会两处口径漂移。
|
|
271
|
-
*/
|
|
272
|
-
timeout: { type: 'string', desc: GLOBAL_FLAGS.timeout.desc },
|
|
273
|
-
},
|
|
274
|
-
/**
|
|
275
|
-
* JSON 模式下的输出形状与其它命令**不同**:它是 JSONL 事件流,因为这条命令会长时间阻塞。
|
|
276
|
-
* {"ok":true,"command":"login","stage":"awaiting_callback","authorization_url":"…"}
|
|
277
|
-
* {"ok":true,"command":"login","stage":"done","data":{…}}
|
|
278
|
-
* {"ok":false,"command":"login","stage":"failed","error":{…}}
|
|
279
|
-
* 设备码模式:
|
|
280
|
-
* {"ok":true,"command":"login","stage":"awaiting_user","user_code":"ABCD-1234","verification_uri":"…",
|
|
281
|
-
* "verification_uri_complete":"…","expires_in":600,"interval":5,"paste_text":"…"}
|
|
282
|
-
* ★ `--no-wait` 时**最后一行就是这个 `stage=awaiting_user`**(进程随即退出,不再有 done);
|
|
283
|
-
* 该行里带 `no_wait:true` / `resume_command` / `pending_file`,AI 端据此转达用户,
|
|
284
|
-
* 稍后再跑 `wkgeo login --device-continue`。
|
|
285
|
-
* 为什么不做成"一条最终 JSON":AI 端需要在**等待期间**就把网址/短码交给用户,
|
|
286
|
-
* 等 5 分钟拿到最终结果时用户早就走了。
|
|
287
|
-
*/
|
|
288
|
-
async run(ctx) {
|
|
289
|
-
const { out, config, flags } = ctx;
|
|
290
|
-
const jsonMode = out.json;
|
|
291
|
-
/** JSON 模式:人类可读文本一律走 stderr,stdout 只放机器可读事件 */
|
|
292
|
-
const log = jsonMode ? (m) => out.raw(m) : (m) => out.line(m);
|
|
293
|
-
const cmdName = config.cmdName || 'wkgeo';
|
|
294
|
-
|
|
295
|
-
/* ---- 0. 三种模式的互斥检查(用法错误 exit 2,脚本里好分辨) ---- */
|
|
296
|
-
const noWait = flags.noWait === true;
|
|
297
|
-
const wantsContinue = flags.deviceContinue === true;
|
|
298
|
-
if (noWait && wantsContinue) {
|
|
299
|
-
throw new UsageError('--no-wait 与 --device-continue 不能同时用:前者是"只申请短码就退出",后者是"去领取上次申请的短码"');
|
|
300
|
-
}
|
|
301
|
-
if (wantsContinue && flags.device === true) {
|
|
302
|
-
throw new UsageError('--device-continue 与 --device 不能同时用:--device-continue 会自动读回上次保存的设备码');
|
|
303
|
-
}
|
|
304
|
-
/**
|
|
305
|
-
* `--no-wait` **隐含**设备码模式:回调模式没有"先返回、稍后再领"这回事
|
|
306
|
-
* (授权码 5 分钟失效,而且必须由浏览器打回本地端口)。
|
|
307
|
-
* 把隐含关系写死在实现里,比要求用户同时记住两个开关更不容易用错。
|
|
308
|
-
*/
|
|
309
|
-
const wantsDevice = flags.device === true || noWait;
|
|
310
|
-
|
|
311
|
-
/** 回调模式的安全底线:只能监听回环(设备码模式不经过回调,跳过这条) */
|
|
312
|
-
if (!wantsDevice && !wantsContinue) {
|
|
313
|
-
if (config.callbackHost !== '127.0.0.1' && config.callbackHost !== 'localhost' && config.callbackHost !== '[::1]') {
|
|
314
|
-
throw new CliError(`回调地址必须监听回环(127.0.0.1 / localhost / [::1]),当前是 ${config.callbackHost}`, {
|
|
315
|
-
kind: 'usage',
|
|
316
|
-
hint: '不要用 --callback-host 绑 0.0.0.0:授权码会暴露给同网段所有人',
|
|
317
|
-
exitCode: EXIT.USAGE,
|
|
318
|
-
});
|
|
319
|
-
}
|
|
320
|
-
}
|
|
321
|
-
|
|
322
|
-
/* ---- 1. 代理检测(只有回调模式才关心:设备码不需要任何入站回调) ---- */
|
|
323
|
-
const proxyInfo = !wantsDevice && !wantsContinue ? ctx.proxyInfo() : null;
|
|
324
|
-
const proxyPayload = proxyInfo ? proxyWarningPayload(proxyInfo, { cmdName }) : null;
|
|
325
|
-
const autoDevice = resolveAutoDevice(flags, ctx.env);
|
|
326
|
-
/**
|
|
327
|
-
* ★ 可选首轮等待(默认 0 = 关闭,0.2.2 起)。
|
|
328
|
-
* 只有用户**显式**写 `--callback-first-wait` / `WKONGAI_CALLBACK_FIRST_WAIT_MS`
|
|
329
|
-
* 才会启用;`--no-auto-device` 强制 0。它**不参与**"默认走什么模式"的判断。
|
|
330
|
-
*/
|
|
331
|
-
const callbackFirstWaitMs = resolveCallbackFirstWaitMs(flags, ctx.env, { autoDevice });
|
|
332
|
-
|
|
333
|
-
/**
|
|
334
|
-
* ★★ 核心规则(2026-10-02 第二版加固):**`detected === true` 就直接走设备码**。
|
|
335
|
-
*
|
|
336
|
-
* ⚠️ 为什么不再看 `loopback_bypassed` / `risk`:真机上老板的绕过列表里**写着**
|
|
337
|
-
* `localhost;127.*`,第一版据此判"没风险"→ 走回调 → 他点了【同意授权】之后
|
|
338
|
-
* 回调请求从没到过本机,CLI 一直拿不到令牌
|
|
339
|
-
* (独立证据:`curl -x http://127.0.0.1:7890 http://127.0.0.1:1/x` → 502,
|
|
340
|
-
* 证明那台机器上的代理**会尝试接管回环请求**,绕过列表并没有真正生效)。
|
|
341
|
-
* ⇒ 结论:**"绕过列表里有 127.*"不等于绕过生效**,不同代理软件/浏览器对 bypass
|
|
342
|
-
* 的解释并不一致。宁可让用户多走一步设备码,也不能让他卡在"点了同意没反应"。
|
|
343
|
-
* 这两个字段仍然照样上报(`proxy_warning`),只是**不再作为放行回调的依据**。
|
|
344
|
-
*/
|
|
345
|
-
const proxyDetected = !!(proxyInfo && proxyInfo.detected);
|
|
346
|
-
let useDevice = wantsDevice;
|
|
347
|
-
/** 为什么会走设备码:proxy_detected / callback_first_wait(仅显式开启时) */
|
|
348
|
-
let downgradeReason = null;
|
|
349
|
-
if (!useDevice && autoDevice && proxyDetected) {
|
|
350
|
-
useDevice = true;
|
|
351
|
-
downgradeReason = 'proxy_detected';
|
|
352
|
-
}
|
|
353
|
-
|
|
354
|
-
if (downgradeReason === 'proxy_detected') {
|
|
355
|
-
// 人类模式:说清楚"为什么改了、怎么改回去"(AI 端看 proxy_warning 结构化字段)
|
|
356
|
-
for (const line of proxyDeviceSwitchLines(proxyInfo, { cmdName })) log(line);
|
|
357
|
-
} else if (!wantsDevice && !wantsContinue && !useDevice && proxyDetected) {
|
|
358
|
-
/**
|
|
359
|
-
* 走到这里只有一种情况:用户**显式**要求坚持回调模式(--no-auto-device / WKONGAI_AUTO_DEVICE=0)。
|
|
360
|
-
* ⚠️ 必须明确警告:否则他唯一的下场就是"点了同意,然后干等到超时",
|
|
361
|
-
* 而他会以为是 CLI 坏了(这正是老板真机上遇到的那个现象)。
|
|
362
|
-
*/
|
|
363
|
-
for (const line of proxyForcedCallbackLines(proxyInfo, { cmdName })) log(line);
|
|
364
|
-
}
|
|
365
|
-
|
|
366
|
-
/** 把运行期注入的依赖透传给两条登录流程(测试要能离线跑,见 runtime.mjs 的说明) */
|
|
367
|
-
const loginDeps = {
|
|
368
|
-
fetchImpl: ctx.fetchImpl,
|
|
369
|
-
now: ctx.now,
|
|
370
|
-
sleep: ctx.sleep,
|
|
371
|
-
// `--no-browser` → false;否则用注入的(测试)或默认的真·打开浏览器
|
|
372
|
-
openBrowser: flags.browser === false ? false : ctx.openBrowser,
|
|
373
|
-
/** 真 spawn 的注入点(单测验证"AI 场景一次都不 spawn 浏览器";生产不传 = 真 spawn) */
|
|
374
|
-
spawnImpl: ctx.spawnImpl,
|
|
375
|
-
/**
|
|
376
|
-
* ★★ 「要不要替用户弹**系统**浏览器」的输入(2026-10-21 起含 CI/非交互检测):
|
|
377
|
-
* * `isTTY` —— stdout 是不是终端(由 runtime 从 stdout.isTTY 读出,命令层原样透传);
|
|
378
|
-
* * `json` —— 是不是 JSON 输出(`--json` 或非 TTY 自动 JSON);
|
|
379
|
-
* * `forceBrowser` —— 用户写了 `--open-browser`(只在终端里保留显式语义);
|
|
380
|
-
* * `noBrowser` —— 用户写了 `--no-browser`(**最高优先级**的"不打开"开关);
|
|
381
|
-
* * `env` —— CI 环境变量判定(`CI` / `GITHUB_ACTIONS`… / `WKONGAI_CLI_NO_BROWSER=1`)。
|
|
382
|
-
* 全部进 `resolveBrowserIntent()`(login.mjs 里的**唯一裁决点**):
|
|
383
|
-
* **人在终端默认打开**;`--no-browser` 与**非交互/CI**都不打开(`attempted:false`);
|
|
384
|
-
* 非交互时还会打印"把链接转给有浏览器的用户 / 改用 `--device`"的提示。
|
|
385
|
-
* ⚠️ 回调模式与设备码模式都吃这一份 deps —— 所以两条授权路径的行为天然一致。
|
|
386
|
-
*/
|
|
387
|
-
isTTY: ctx.isTTY === true,
|
|
388
|
-
json: ctx.out.json === true,
|
|
389
|
-
forceBrowser: flags.openBrowser === true,
|
|
390
|
-
noBrowser: flags.browser === false,
|
|
391
|
-
/** ★ CI / 非交互判定用(纯函数在 login.mjs 的 detectNonInteractive) */
|
|
392
|
-
env: ctx.env || {},
|
|
393
|
-
platform: ctx.platform,
|
|
394
|
-
/**
|
|
395
|
-
* ★ 可选首轮等待(见上面 `callbackFirstWaitMs`)。
|
|
396
|
-
*
|
|
397
|
-
* ⚠️⚠️ 0.2.2 起**默认 0 = 关闭**(老板 2026-10-21 反馈):
|
|
398
|
-
* * 不写 `--callback-first-wait` / 环境变量 → 0,一直等满 `--timeout`,**不会**自动改设备码;
|
|
399
|
-
* * 显式写 `--callback-first-wait <秒>` / `WKONGAI_CALLBACK_FIRST_WAIT_MS` → 照旧启用;
|
|
400
|
-
* * `--no-auto-device` → 强制 0(用户明确要求只走回调,就不能偷偷改道)。
|
|
401
|
-
*/
|
|
402
|
-
callbackFirstWaitMs,
|
|
403
|
-
/**
|
|
404
|
-
* ★★ 设备码先成功后,本地回调监听再多留多久(毫秒;0 = 立刻收尾)。
|
|
405
|
-
* 生产不传 = `login.mjs` 的 `DEFAULT_POST_DEVICE_GRACE_MS`;
|
|
406
|
-
* 单测可注入一个小值,确定性地验证"迟到的回调拿到已完成页"。
|
|
407
|
-
*/
|
|
408
|
-
postDeviceGraceMs: ctx.postDeviceGraceMs,
|
|
409
|
-
};
|
|
410
|
-
|
|
411
|
-
/**
|
|
412
|
-
* ★ 默认模式的正面说明(老板 2026-10-21 反馈的直接回应)。
|
|
413
|
-
*
|
|
414
|
-
* 老板原话:「默认的也不应该是设备授权,默认的就是那个传统的授权方式(浏览器打开授权页 +
|
|
415
|
-
* 本地 localhost 回调)。设备码是本地读不了/代理时才用的。」
|
|
416
|
-
* ⇒ 这里明说"本次就是回调、等多久都不会自动改设备码",同时列出**唯一会走设备码**的两种情况,
|
|
417
|
-
* 并给出"主动提前切换"的显式开关,免得用户以为 CLI 背着他改道。
|
|
418
|
-
* ⚠️ 只在"回调模式 + 没检测到代理 + 没显式开首轮等待"时打:其它情况一律不打(正常环境不要噪音)。
|
|
419
|
-
*/
|
|
420
|
-
if (!useDevice && !wantsContinue && !proxyDetected && callbackFirstWaitMs === 0) {
|
|
421
|
-
log(
|
|
422
|
-
`ℹ️ 未检测到系统代理:本次使用浏览器回调授权(默认),会一直等你完成授权(最多 ${Math.round(config.loginTimeoutMs / 1000)} 秒)。`,
|
|
423
|
-
);
|
|
424
|
-
log(
|
|
425
|
-
' 不会因为"首轮等待/等待超时"到点就自动改用设备码;只有显式 `--device` 或检测到系统代理时才会用设备码' +
|
|
426
|
-
'(`--no-auto-device` 可关掉代理这一种自动切换)。',
|
|
427
|
-
);
|
|
428
|
-
log(
|
|
429
|
-
' (本地回调端口起不来会**如实报错**并建议 `--device`,不会静默换模式;想主动提前切换:`--callback-first-wait <秒>`。)',
|
|
430
|
-
);
|
|
431
|
-
}
|
|
432
|
-
|
|
433
|
-
/**
|
|
434
|
-
* 设备码事件的统一构造(人类提示在 announceDeviceCode 里打;这里只负责机器可读那一份)。
|
|
435
|
-
* ⚠️ `user_action_required` 是**给 AI 端直接用的话术**:AI 不该自己组织语言,
|
|
436
|
-
* 照着念就不会漏掉网址或短码。
|
|
437
|
-
*/
|
|
438
|
-
const deviceEvent = (info, extra = {}) => {
|
|
439
|
-
if (!jsonMode) return;
|
|
440
|
-
out.event({
|
|
441
|
-
ok: true,
|
|
442
|
-
command: 'login',
|
|
443
|
-
mode: 'device',
|
|
444
|
-
stage: 'awaiting_user',
|
|
445
|
-
...info,
|
|
446
|
-
...extra,
|
|
447
|
-
user_action_required: `请让用户访问 ${info.open_url}${info.verification_uri_complete ? '' : ` 并输入短码 ${info.user_code}`}`,
|
|
448
|
-
});
|
|
449
|
-
};
|
|
450
|
-
const deviceDeps = (extraEvent = {}) => ({ ...loginDeps, onDeviceCode: (info) => deviceEvent(info, extraEvent) });
|
|
451
|
-
|
|
452
|
-
const pendingFile = pendingDeviceFile(config.credentialsFile);
|
|
453
|
-
/** 申请到码之后立刻落盘:进程被 Ctrl+C / 终端被关掉,用户还能用 --device-continue 续上 */
|
|
454
|
-
const savePending = (device) => {
|
|
455
|
-
try {
|
|
456
|
-
savePendingDevice(pendingFile, { ...device, base: config.base, client_id: config.clientId });
|
|
457
|
-
return true;
|
|
458
|
-
} catch (e) {
|
|
459
|
-
// 落盘失败**不影响本次授权**(只是失去"稍后续跑"的能力),所以只提示不抛
|
|
460
|
-
log(`⚠️ 无法保存待完成的设备码状态(不影响本次授权,只是不能稍后用 --device-continue 续跑):${e.message}`);
|
|
461
|
-
return false;
|
|
462
|
-
}
|
|
463
|
-
};
|
|
464
|
-
|
|
465
|
-
let result = null;
|
|
466
|
-
|
|
467
|
-
/* ---- 2a. `--device-continue`:续跑上次没等完的设备码 ---- */
|
|
468
|
-
if (wantsContinue) {
|
|
469
|
-
const pending = readPendingDevice(pendingFile);
|
|
470
|
-
if (!pending) {
|
|
471
|
-
throw new CliError('本地没有待完成的设备码登录', {
|
|
472
|
-
kind: 'device_state',
|
|
473
|
-
hint: `先运行 \`${cmdName} login --device --no-wait\`(或直接 \`${cmdName} login --device\`)申请一个短码`,
|
|
474
|
-
exitCode: EXIT.USAGE,
|
|
475
|
-
});
|
|
476
|
-
}
|
|
477
|
-
/**
|
|
478
|
-
* ⚠️ 设备码只对**当初申请它的那个服务端**有效。用户中途换了 `--base`(换了环境)时,
|
|
479
|
-
* 拿旧码去新环境轮询必然失败,不如在这里把话说明白。
|
|
480
|
-
*/
|
|
481
|
-
if (pending.base && pending.base !== config.base) {
|
|
482
|
-
throw new CliError(`这份设备码是为 \`${pending.base}\` 申请的,与当前的 \`${config.base}\` 不一致`, {
|
|
483
|
-
kind: 'device_state',
|
|
484
|
-
hint: `用同一个 --base 重试,或重新运行 \`${cmdName} login --device\``,
|
|
485
|
-
exitCode: EXIT.USAGE,
|
|
486
|
-
});
|
|
487
|
-
}
|
|
488
|
-
if (isPendingExpired(pending, { now: ctx.now() })) {
|
|
489
|
-
deletePendingDevice(pendingFile);
|
|
490
|
-
throw pendingExpiredError(pendingFile);
|
|
491
|
-
}
|
|
492
|
-
log(`继续上一次的设备码登录:短码 ${pending.user_code}`);
|
|
493
|
-
log(` (如果浏览器已经关掉了:${pending.open_url})`);
|
|
494
|
-
try {
|
|
495
|
-
result = await pollDeviceToken({ config, log, deps: loginDeps, device: pending });
|
|
496
|
-
deletePendingDevice(pendingFile);
|
|
497
|
-
useDevice = true;
|
|
498
|
-
} catch (e) {
|
|
499
|
-
if (TERMINAL_DEVICE_KINDS.has(e.kind)) {
|
|
500
|
-
try {
|
|
501
|
-
deletePendingDevice(pendingFile);
|
|
502
|
-
} catch {
|
|
503
|
-
/* 删不掉不影响主流程:报错本身才是用户要看的 */
|
|
504
|
-
}
|
|
505
|
-
}
|
|
506
|
-
throw e;
|
|
507
|
-
}
|
|
508
|
-
}
|
|
509
|
-
|
|
510
|
-
/* ---- 2b. 设备码模式(等待式,或 --no-wait 只申请) ---- */
|
|
511
|
-
if (!result && useDevice) {
|
|
512
|
-
try {
|
|
513
|
-
const device = await requestDeviceCode({ config, deps: loginDeps });
|
|
514
|
-
savePending(device);
|
|
515
|
-
if (noWait) {
|
|
516
|
-
/**
|
|
517
|
-
* ★ AI 端友好路径:打印完就退出(不轮询)。
|
|
518
|
-
* `extra` 同时进"机器可读事件"和"人类可读提示",两处口径同源。
|
|
519
|
-
*/
|
|
520
|
-
const extra = {
|
|
521
|
-
no_wait: true,
|
|
522
|
-
pending_file: pendingFile,
|
|
523
|
-
resume_command: `${cmdName} login --device-continue`,
|
|
524
|
-
expires_at: new Date(device.expires_at).toISOString(),
|
|
525
|
-
proxy_warning: proxyPayload,
|
|
526
|
-
logged_in: false,
|
|
527
|
-
next_step:
|
|
528
|
-
'请让用户在**自己的浏览器**里打开上面的网址并点「同意」(AI 端无法代点:device_confirm 需要用户自己的登录会话);' +
|
|
529
|
-
`然后运行 \`${cmdName} login --device-continue\` 领取令牌`,
|
|
530
|
-
};
|
|
531
|
-
announceDeviceCode({ config, log, deps: deviceDeps(extra), device });
|
|
532
|
-
if (!jsonMode) {
|
|
533
|
-
out.line('');
|
|
534
|
-
out.info(`⏸ 已申请短码并退出(--no-wait)。用户点完「同意」后,运行 \`${cmdName} login --device-continue\` 领取令牌。`);
|
|
535
|
-
out.info(` 短码有效期约 ${Math.round(device.expires_in / 60)} 分钟;过期就重新运行 \`${cmdName} login --device --no-wait\`。`);
|
|
536
|
-
}
|
|
537
|
-
return {
|
|
538
|
-
mode: 'device',
|
|
539
|
-
stage: 'awaiting_user',
|
|
540
|
-
...extra,
|
|
541
|
-
user_code: device.user_code,
|
|
542
|
-
verification_uri: device.verification_uri,
|
|
543
|
-
verification_uri_complete: device.verification_uri_complete,
|
|
544
|
-
open_url: device.open_url,
|
|
545
|
-
paste_text: devicePasteText(device),
|
|
546
|
-
expires_in: device.expires_in,
|
|
547
|
-
interval: device.interval,
|
|
548
|
-
credentials_file: config.credentialsFile,
|
|
549
|
-
client_id: config.clientId,
|
|
550
|
-
};
|
|
551
|
-
}
|
|
552
|
-
announceDeviceCode({ config, log, deps: deviceDeps({ no_wait: false, proxy_warning: proxyPayload }), device });
|
|
553
|
-
try {
|
|
554
|
-
result = await pollDeviceToken({ config, log, deps: loginDeps, device });
|
|
555
|
-
deletePendingDevice(pendingFile);
|
|
556
|
-
} catch (e) {
|
|
557
|
-
if (TERMINAL_DEVICE_KINDS.has(e.kind)) {
|
|
558
|
-
try {
|
|
559
|
-
deletePendingDevice(pendingFile);
|
|
560
|
-
} catch {
|
|
561
|
-
/* 同上:删不掉不影响主流程 */
|
|
562
|
-
}
|
|
563
|
-
}
|
|
564
|
-
throw e;
|
|
565
|
-
}
|
|
566
|
-
} catch (e) {
|
|
567
|
-
/**
|
|
568
|
-
* 自动降级时设备码端点却不可用(服务端缺口/形状不对)→ **老老实实回落回调模式**,
|
|
569
|
-
* 而不是把用户堵死。只有"我们自己主动改道"(autoReason 存在)且用户没显式要设备码时才回落;
|
|
570
|
-
* 显式 `--device` 的失败必须原样报出来(用户要的就是设备码,别替他做别的决定)。
|
|
571
|
-
*/
|
|
572
|
-
const canFallback =
|
|
573
|
-
downgradeReason === 'proxy_detected' && !wantsDevice && (e.kind === 'not_implemented' || e.kind === 'device_authorization_failed');
|
|
574
|
-
if (!canFallback) throw e;
|
|
575
|
-
log(`⚠️ 设备码模式当前不可用(${e.message}),回落到本地回调模式继续…`);
|
|
576
|
-
useDevice = false;
|
|
577
|
-
downgradeReason = null;
|
|
578
|
-
}
|
|
579
|
-
}
|
|
580
|
-
|
|
581
|
-
/* ---- 2c. 本地回调模式(默认路径;显式首轮等待时才与设备码两条路并存) ---- */
|
|
582
|
-
if (!result && !useDevice) {
|
|
583
|
-
/**
|
|
584
|
-
* ★★ 2026-10-03(老板真机反馈 ⚠️):显式开启的"首轮等待"到点改道时**不再关掉本地回调监听**。
|
|
585
|
-
*
|
|
586
|
-
* ## 旧行为(真机证据:ERR_CONNECTION_REFUSED)
|
|
587
|
-
* 首轮等待到点 → `runLogin` 抛错,并在自己的 `finally` 里**关掉本地 server** → 命令层再走设备码。
|
|
588
|
-
* 于是用户**之后**才点【同意授权】时,浏览器跳到
|
|
589
|
-
* `http://127.0.0.1:<port>/callback?code=…` → **ERR_CONNECTION_REFUSED**
|
|
590
|
-
* (老板真机截图见过)→ 用户以为授权失败,再来一遍(而其实他马上就会登录成功)。
|
|
591
|
-
*
|
|
592
|
-
* ## 新行为(仅显式 `--callback-first-wait` 时):两条路**并存**,哪个先拿到令牌就用哪个
|
|
593
|
-
* * 回调那条路:本地 server 一直开着(`runLogin` 收到 `handoff` 时到点**不结束等待**);
|
|
594
|
-
* * 设备码那条路:由下面的 `handoff.onSwitch` 启动,轮询到出结果为止。
|
|
595
|
-
* * 回调先成功 → 把设备码那条路**优雅停掉**(唤醒它挂着的 sleep + 删掉待完成状态文件);
|
|
596
|
-
* * 设备码先成功 → `finishWithDevice()` 让回调那条路收尾(监听再多留几秒,
|
|
597
|
-
* 迟到的回调会拿到"本次登录已经完成"的页面,见 login.mjs / page.mjs)。
|
|
598
|
-
* ★ 0.2.2 起默认**不启用**这套交接(`--callback-first-wait` 未显式给出时
|
|
599
|
-
* `callbackFirstWaitMs === 0`):默认就是一路等回调,超时只报错。
|
|
600
|
-
*/
|
|
601
|
-
/** 允许"等待到点改道"吗:只有用户**显式**开了首轮等待,且没写 --no-auto-device、不是显式设备码模式 */
|
|
602
|
-
const mayAutoSwitch = autoDevice && !wantsDevice && !wantsContinue && callbackFirstWaitMs > 0;
|
|
603
|
-
/** 设备码那条路的可取消状态(回调先赢时要把它收拾干净) */
|
|
604
|
-
const deviceSide = { reason: null, cancelled: false, promise: null, result: null, error: null };
|
|
605
|
-
/** ★ 可被立刻叫醒的 sleep:回调先赢时,不能让设备码那个 5 秒定时器把进程吊住 */
|
|
606
|
-
const cancelGate = createCancelGate(loginDeps.sleep);
|
|
607
|
-
/** 交接面:两边各填一半(`onSwitch` 由这里填,另两个由 runLogin 填;见 login.mjs 的 deps 说明) */
|
|
608
|
-
const handoff = { onSwitch: null, finishWithDevice: null, abort: null };
|
|
609
|
-
|
|
610
|
-
const runDeviceCodeFlow = async () => {
|
|
611
|
-
const device = await requestDeviceCode({ config, deps: loginDeps });
|
|
612
|
-
// 回调那条路已经赢了 → 一个用户可见的动作都不要再做(不打印短码、不弹浏览器、不落盘)
|
|
613
|
-
if (deviceSide.cancelled) throw deviceStoppedError();
|
|
614
|
-
savePending(device);
|
|
615
|
-
if (deviceSide.cancelled) throw deviceStoppedError();
|
|
616
|
-
announceDeviceCode({ config, log, deps: deviceDeps({ no_wait: false, proxy_warning: proxyPayload }), device });
|
|
617
|
-
return pollDeviceToken({
|
|
618
|
-
config,
|
|
619
|
-
log,
|
|
620
|
-
deps: {
|
|
621
|
-
...loginDeps,
|
|
622
|
-
sleep: cancelGate.sleep,
|
|
623
|
-
/** device.mjs 支持它:另一条路赢了就立刻停止轮询(不写凭据、不报错) */
|
|
624
|
-
shouldStop: () => deviceSide.cancelled,
|
|
625
|
-
},
|
|
626
|
-
device,
|
|
627
|
-
});
|
|
628
|
-
};
|
|
629
|
-
|
|
630
|
-
if (mayAutoSwitch) {
|
|
631
|
-
handoff.onSwitch = (reason) => {
|
|
632
|
-
deviceSide.reason = reason;
|
|
633
|
-
/**
|
|
634
|
-
* ⚠️ 这里**不 await**、也**不抛错**:交接只需把设备码那条路点起来。
|
|
635
|
-
* 成功 → `finishWithDevice` 让回调流程带着这份结果收尾(监听留 grace);
|
|
636
|
-
* 失败 → `abort` 让回调流程用"两条路都不通"的错误结束(用户要看的是真原因)。
|
|
637
|
-
*/
|
|
638
|
-
deviceSide.promise = runDeviceCodeFlow().then(
|
|
639
|
-
(res) => {
|
|
640
|
-
deviceSide.result = res;
|
|
641
|
-
if (typeof handoff.finishWithDevice === 'function') handoff.finishWithDevice(res);
|
|
642
|
-
},
|
|
643
|
-
(e2) => {
|
|
644
|
-
deviceSide.error = e2;
|
|
645
|
-
/**
|
|
646
|
-
* ★ 两条路都没成:把**两边的报错**合起来抛(只报设备码那条错,用户会以为
|
|
647
|
-
* "回调其实没问题"、又回去白等一轮 —— 见 bothPathsFailedError 的注释)。
|
|
648
|
-
* ⚠️ 同时存一份到 `deviceSide.combinedError`:万一回调那条路**抢先**抛了自己的错
|
|
649
|
-
* (例如用户在这一刻点了「拒绝」),下面 catch 里也要优先把"两条路都不通"报出来。
|
|
650
|
-
*/
|
|
651
|
-
deviceSide.combinedError = bothPathsFailedError(e2, reason, { loginTimeoutMs: config.loginTimeoutMs });
|
|
652
|
-
if (typeof handoff.abort === 'function') handoff.abort(deviceSide.combinedError);
|
|
653
|
-
},
|
|
654
|
-
);
|
|
655
|
-
};
|
|
656
|
-
}
|
|
657
|
-
|
|
658
|
-
try {
|
|
659
|
-
result = await runLogin({
|
|
660
|
-
config,
|
|
661
|
-
log,
|
|
662
|
-
deps: {
|
|
663
|
-
...loginDeps,
|
|
664
|
-
/** 超时时要把"代理可能是元凶"写进错误 hint(见 login.mjs 的 timeout 分支) */
|
|
665
|
-
proxyRisk: proxyInfo,
|
|
666
|
-
/** ★★ 两条路并存的交接面(未启用自动改道时 `onSwitch` 为 null ⇒ runLogin 走旧契约) */
|
|
667
|
-
handoff,
|
|
668
|
-
onAuthorizationUrl: (url, extra) => {
|
|
669
|
-
if (jsonMode) {
|
|
670
|
-
/**
|
|
671
|
-
* ★ 非交互(CI / 管道 / AI 子进程)时**不会**自动打开浏览器 ⇒ 给 AI/脚本的
|
|
672
|
-
* `user_action_required` 必须换成"把链接转给有浏览器的人 / 改用设备码",
|
|
673
|
-
* 否则调用方会以为"浏览器已经弹出来了",只让用户干等。
|
|
674
|
-
*/
|
|
675
|
-
const nonInteractive = !!(extra && extra.open_browser && extra.open_browser.skipped_reason === 'non_interactive');
|
|
676
|
-
out.event({
|
|
677
|
-
ok: true,
|
|
678
|
-
command: 'login',
|
|
679
|
-
mode: 'callback',
|
|
680
|
-
stage: 'awaiting_callback',
|
|
681
|
-
authorization_url: url,
|
|
682
|
-
user_action_required: nonInteractive
|
|
683
|
-
? '本机是非交互环境(CI/管道/AI 子进程),不会自动打开浏览器:请把 authorization_url 转给有浏览器的用户打开;若本机无法接收回调,改用 `wkgeo login --device`(设备码模式)'
|
|
684
|
-
: '请让用户在浏览器中打开上面的 authorization_url,登录并点「同意」',
|
|
685
|
-
proxy_warning: proxyPayload,
|
|
686
|
-
...extra,
|
|
687
|
-
});
|
|
688
|
-
}
|
|
689
|
-
},
|
|
690
|
-
},
|
|
691
|
-
});
|
|
692
|
-
} catch (e) {
|
|
693
|
-
/** ★ 无论怎么失败,都先把设备码那条路收拾干净(不能留一个还在轮询的后台任务) */
|
|
694
|
-
await stopDeviceCodeFlow(deviceSide, cancelGate);
|
|
695
|
-
/** 设备码那条路也失败了 ⇒ 优先报"两条路都不通"(哪怕回调那边先抛了自己的错) */
|
|
696
|
-
if (deviceSide.combinedError) throw deviceSide.combinedError;
|
|
697
|
-
/**
|
|
698
|
-
* ★★ 0.2.4(2026-10-21 老板真机反馈):**bind 失败不再静默改走设备码**。
|
|
699
|
-
*
|
|
700
|
-
* 旧行为(0.2.2~0.2.3):本地回调端口起不来 → 命令层自动申请设备码继续授权。
|
|
701
|
-
* 现场问题是:用户明明要的是"本地服务 + 浏览器回调",CLI 却在他不知情时换了
|
|
702
|
-
* 另一套授权协议(设备码),127.0.0.1 回调页始终没有出现,看起来就是"本地服务
|
|
703
|
-
* 没启动、浏览器也没东西可打开"。
|
|
704
|
-
*
|
|
705
|
-
* 新口径:**如实失败**,把 `--device` 作为明确的下一步建议交给用户/调用方
|
|
706
|
-
* (`runLogin` 抛的 `kind:"listen"` 错误 hint 里已经写了)。
|
|
707
|
-
* 设备码只在这两种情况下出现:用户显式 `--device` / 检测到系统代理。
|
|
708
|
-
*/
|
|
709
|
-
throw e;
|
|
710
|
-
}
|
|
711
|
-
|
|
712
|
-
if (deviceSide.reason) {
|
|
713
|
-
/**
|
|
714
|
-
* ⚠️ 判定"谁赢了"用**凭据对象的同一性**:`runLogin` 返回时会 `{...result}` 复制一层外壳
|
|
715
|
-
* (见 login.mjs 的返回值),所以比较外层对象会永远不相等;
|
|
716
|
-
* 而 `credentials` 是那一层里原样带出来的同一个对象,用它判定既准确又同步。
|
|
717
|
-
*/
|
|
718
|
-
if (deviceSide.result && result.credentials === deviceSide.result.credentials) {
|
|
719
|
-
/**
|
|
720
|
-
* ★ 设备码那条路**先**成功:`runLogin` 已经把回调那条路收尾(监听再留一小会儿给迟到的回调),
|
|
721
|
-
* 这里只要把"最终模式/原因"如实记下来。
|
|
722
|
-
*/
|
|
723
|
-
useDevice = true;
|
|
724
|
-
// 0.2.2 起整段超时不再交接,`deviceSide.reason` 只可能是显式首轮等待
|
|
725
|
-
downgradeReason = 'callback_first_wait';
|
|
726
|
-
} else {
|
|
727
|
-
/**
|
|
728
|
-
* ★ 回调那条路**先**成功(本次修复的核心价值:用户后来点的那次【同意】真的换到了令牌)
|
|
729
|
-
* ⇒ 把设备码那条路立刻停掉,并给用户一句说明(免得他再去浏览器里确认一个作废的短码)。
|
|
730
|
-
*/
|
|
731
|
-
deviceSide.cancelled = true;
|
|
732
|
-
cancelGate.wakeAll();
|
|
733
|
-
await stopDeviceCodeFlow(deviceSide, cancelGate);
|
|
734
|
-
deletePendingDevice(pendingFile);
|
|
735
|
-
log('ℹ️ 本地回调已经拿到令牌:设备码那条路已停止(刚才那个短码作废,不用再去浏览器里确认)。');
|
|
736
|
-
}
|
|
737
|
-
}
|
|
738
|
-
}
|
|
739
|
-
|
|
740
|
-
const account = result.account || null;
|
|
741
|
-
const creds = result.credentials;
|
|
742
|
-
const data = {
|
|
743
|
-
account,
|
|
744
|
-
mode: useDevice ? 'device' : 'callback',
|
|
745
|
-
client_id: creds.client_id,
|
|
746
|
-
scope: creds.scope,
|
|
747
|
-
expires_at: creds.expires_at,
|
|
748
|
-
token_ttl_seconds: result.tokenTtlSeconds || creds.expires_in || result.metadata?.access_token_ttl_seconds || null,
|
|
749
|
-
on_token_expiry: result.onTokenExpiry || result.metadata?.on_token_expiry || null,
|
|
750
|
-
credentials_file: config.credentialsFile,
|
|
751
|
-
file_mode: result.mode && result.mode.supported ? result.mode.modeText : '无法判断(Windows)',
|
|
752
|
-
redirect_uri: result.redirectUri || null,
|
|
753
|
-
user_code: result.user_code || null,
|
|
754
|
-
verification_uri: result.verification_uri || null,
|
|
755
|
-
paste_text: result.paste_text || null,
|
|
756
|
-
poll_attempts: result.poll_attempts ?? null,
|
|
757
|
-
logged_in: true,
|
|
758
|
-
/** ★ 结构化告知"本机代理情况"与"是否因此改道",AI 端不用去猜 */
|
|
759
|
-
proxy_warning: proxyPayload,
|
|
760
|
-
auto_device: downgradeReason ? { applied: true, reason: downgradeReason } : { applied: false, reason: null },
|
|
761
|
-
};
|
|
762
|
-
|
|
763
|
-
if (jsonMode) {
|
|
764
|
-
// 保持 JSONL:stage=done 是最后一行
|
|
765
|
-
out.event({ ok: true, command: 'login', stage: 'done', data });
|
|
766
|
-
} else {
|
|
767
|
-
out.line('');
|
|
768
|
-
out.ok(`✅ 授权成功,已登录:${account && (account.email || account.name) ? account.email || account.name : '(账号信息未取到)'}`);
|
|
769
|
-
if (account && account.sub) out.line(` 用户 ID:${account.sub}`);
|
|
770
|
-
out.line(` 能力范围:${creds.scope}`);
|
|
771
|
-
out.line(` 令牌有效期:${creds.expires_in ? `${Math.round(creds.expires_in / 86400)} 天` : '未知'}(到期时间 ${formatTime(creds.expires_at)})`);
|
|
772
|
-
out.line(` 凭据文件:${config.credentialsFile}(权限 ${data.file_mode})`);
|
|
773
|
-
out.info(' 令牌本身不会显示在任何输出里(安全约定)。');
|
|
774
|
-
if (useDevice && data.user_code) out.info(` 设备码模式:本次短码 ${data.user_code} 已作废,不能再用于下一次授权。`);
|
|
775
|
-
if (downgradeReason === 'proxy_detected')
|
|
776
|
-
out.info(' (本次因"检测到系统代理"自动改用了设备码模式:不再依赖 127.0.0.1 回调,绕过列表写了什么也不作依据。)');
|
|
777
|
-
if (downgradeReason === 'callback_first_wait')
|
|
778
|
-
out.info(' (已按显式 --callback-first-wait:首轮等待没收到回调,已自动改用设备码模式完成登录。)');
|
|
779
|
-
}
|
|
780
|
-
return data;
|
|
781
|
-
},
|
|
782
|
-
};
|
|
783
|
-
|
|
784
|
-
/* ------------------------------------------------------------------ */
|
|
785
|
-
/* logout */
|
|
786
|
-
/* ------------------------------------------------------------------ */
|
|
787
|
-
|
|
788
|
-
export const logoutCommand = {
|
|
789
|
-
name: 'logout',
|
|
790
|
-
summary: '删除本地凭据(默认还会调用服务端吊销接口作废该令牌)',
|
|
791
|
-
usage: 'wkgeo logout [--local-only]',
|
|
792
|
-
flags: {
|
|
793
|
-
'local-only': { type: 'boolean', desc: '只删本地文件,不调服务端吊销接口' },
|
|
794
|
-
},
|
|
795
|
-
async run(ctx) {
|
|
796
|
-
const { out, config, flags, api } = ctx;
|
|
797
|
-
const creds = readCredentials(config.credentialsFile);
|
|
798
|
-
if (!creds) {
|
|
799
|
-
out.warn('本地本来就没有凭据(未登录)');
|
|
800
|
-
const data = { removed: false, revoked_remote: false, credentials_file: config.credentialsFile };
|
|
801
|
-
ctx.done(data);
|
|
802
|
-
return data;
|
|
803
|
-
}
|
|
804
|
-
|
|
805
|
-
let revoke = { ok: false, reason: '已按要求跳过(--local-only)' };
|
|
806
|
-
if (flags.localOnly !== true) {
|
|
807
|
-
revoke = await api.revoke(creds.access_token);
|
|
808
|
-
}
|
|
809
|
-
const removed = deleteCredentials(config.credentialsFile);
|
|
810
|
-
const data = {
|
|
811
|
-
removed,
|
|
812
|
-
revoked_remote: revoke.ok === true,
|
|
813
|
-
revoke_error: revoke.ok ? null : revoke.reason || null,
|
|
814
|
-
credentials_file: config.credentialsFile,
|
|
815
|
-
client_id: creds.client_id,
|
|
816
|
-
};
|
|
817
|
-
|
|
818
|
-
if (revoke.ok) out.ok('服务端令牌已吊销');
|
|
819
|
-
else out.warn(`未能吊销服务端令牌(${revoke.reason || '未知原因'})—— 本地凭据已删除,登录态在本机已清除`);
|
|
820
|
-
if (removed) out.ok(`本地凭据已删除:${config.credentialsFile}`);
|
|
821
|
-
ctx.done(data);
|
|
822
|
-
return data;
|
|
823
|
-
},
|
|
824
|
-
};
|
|
825
|
-
|
|
826
|
-
/* ------------------------------------------------------------------ */
|
|
827
|
-
/* whoami */
|
|
828
|
-
/* ------------------------------------------------------------------ */
|
|
829
|
-
|
|
830
|
-
export const whoamiCommand = {
|
|
831
|
-
name: 'whoami',
|
|
832
|
-
summary: '显示当前登录的是谁(只显示账号标识,绝不打印令牌)',
|
|
833
|
-
usage: 'wkgeo whoami [--verbose]',
|
|
834
|
-
async run(ctx) {
|
|
835
|
-
const { out, config, flags, api } = ctx;
|
|
836
|
-
const creds = ctx.requireAuth();
|
|
837
|
-
const info = await api.userinfo(creds.access_token);
|
|
838
|
-
|
|
839
|
-
const data = {
|
|
840
|
-
account: {
|
|
841
|
-
user_id: info.sub || null,
|
|
842
|
-
email: info.email || null,
|
|
843
|
-
nickname: info.name || null,
|
|
844
|
-
},
|
|
845
|
-
client_id: creds.client_id,
|
|
846
|
-
scope: creds.scope,
|
|
847
|
-
obtained_at: creds.obtained_at || null,
|
|
848
|
-
expires_at: creds.expires_at || null,
|
|
849
|
-
expires_in_ms: creds.expires_at ? new Date(creds.expires_at).getTime() - ctx.now() : null,
|
|
850
|
-
credentials_file: config.credentialsFile,
|
|
851
|
-
logged_in: true,
|
|
852
|
-
};
|
|
853
|
-
if (flags.verbose) {
|
|
854
|
-
// 掩码是**允许**的(前 6 位 + 长度,抄不走),完整令牌永远不出现
|
|
855
|
-
data.token_masked = maskToken(creds.access_token);
|
|
856
|
-
const mode = checkFileMode(config.credentialsFile);
|
|
857
|
-
data.file_mode = mode.supported ? mode.modeText : '无法判断(Windows)';
|
|
858
|
-
data.file_mode_too_open = mode.supported ? !!mode.tooOpen : null;
|
|
859
|
-
}
|
|
860
|
-
|
|
861
|
-
if (!out.json) {
|
|
862
|
-
out.head('当前登录身份');
|
|
863
|
-
out.line(` 账号:${data.account.email || data.account.nickname || '(服务端未返回账号标识)'}`);
|
|
864
|
-
out.line(` 用户 ID:${data.account.user_id || '-'}`);
|
|
865
|
-
out.line(` 应用(client_id):${data.client_id}`);
|
|
866
|
-
out.line(` 能力范围:${data.scope}`);
|
|
867
|
-
out.line(` 令牌到期:${formatTime(data.expires_at)}(${formatRemaining(data.expires_in_ms)})`);
|
|
868
|
-
out.line(` 凭据文件:${data.credentials_file}`);
|
|
869
|
-
if (flags.verbose) {
|
|
870
|
-
out.line(` 令牌(掩码):${data.token_masked}`);
|
|
871
|
-
out.line(` 文件权限:${data.file_mode}${data.file_mode_too_open ? ' ⚠️ 权限过宽,建议 chmod 600' : ''}`);
|
|
872
|
-
}
|
|
873
|
-
out.info(' (令牌明文不会显示:需要的是账号标识,不是凭据本身)');
|
|
874
|
-
}
|
|
875
|
-
ctx.done(data);
|
|
876
|
-
return data;
|
|
877
|
-
},
|
|
878
|
-
};
|
|
879
|
-
|
|
880
|
-
/* ------------------------------------------------------------------ */
|
|
881
|
-
/* auth status / auth token / auth revoke */
|
|
882
|
-
/* ------------------------------------------------------------------ */
|
|
883
|
-
/*
|
|
884
|
-
* ★ 2026-10-28(task-12「CLI 收口到自己的云函数」):新增 `auth` 命令组。
|
|
885
|
-
*
|
|
886
|
-
* ## 为什么不是一套新令牌
|
|
887
|
-
* 老板拍板的令牌模型就是**现有 OAuth access_token**(`public.oauth_token`,库里只存
|
|
888
|
-
* sha256 + 过期时间,TTL 30 天)。后端**没有** `auth.tokenIssue` / `auth.revoke` 这种
|
|
889
|
-
* "CLI 专用令牌"动作,也没有 `cli-token.json` —— 所以这里既不做令牌换领,也不改
|
|
890
|
-
* `wkgeo login` 的落盘格式;这三条命令只是把**已经有的东西**查清楚 / 展示得更清楚。
|
|
891
|
-
*
|
|
892
|
-
* ## 三条命令各自解决什么
|
|
893
|
-
* * `auth status` —— "我现在是谁、这个令牌在 CLI 自己的函数里到底能干什么"
|
|
894
|
-
* (调 `cliWhoami`:账号 / client_id / scopes / 动作面总数与自持清单)。
|
|
895
|
-
* * `auth token` —— "令牌还剩多久、有多长",**只给前 4 位 + 长度**(永远不给明文)。
|
|
896
|
-
* * `auth revoke` —— 服务端真吊销(RFC 7009 `/api/oauth/revoke`)+ 删本地凭据。
|
|
897
|
-
*/
|
|
898
|
-
|
|
899
|
-
/**
|
|
900
|
-
* 「动作面」汇总:后端字段**原样透出**,另外算一份人能读的合计。
|
|
901
|
-
*
|
|
902
|
-
* 口径(与 `wkgeo-cli-fc` 的 `cliWhoami` / 映射文档一致):
|
|
903
|
-
* * 原生 —— 本函数 switch 里按 scope 过滤后的 `actions`;
|
|
904
|
-
* * 自持 —— 进程内重建(用户面 / 内容 / 素材 / 发布 / 配置 / 站点 / 插件 / 控制台);
|
|
905
|
-
* * 转发 —— 金融面白名单转给 `wkgeo-order`(钱逻辑不复制)。
|
|
906
|
-
*/
|
|
907
|
-
export function summarizeActionSurface(who = {}) {
|
|
908
|
-
const n = (v) => (Array.isArray(v) ? v.length : 0);
|
|
909
|
-
const native = n(who.actions);
|
|
910
|
-
const batches = {
|
|
911
|
-
user: n(who.self_hosted_actions),
|
|
912
|
-
content: n(who.content_actions),
|
|
913
|
-
asset: n(who.asset_actions),
|
|
914
|
-
publish: n(who.publish_actions),
|
|
915
|
-
config_auth: n(who.config_auth_actions),
|
|
916
|
-
site: n(who.site_actions),
|
|
917
|
-
finance_forwarded: n(who.forwarded_actions),
|
|
918
|
-
};
|
|
919
|
-
/* 口径对齐后端 `cliWhoami.action_total`:自持各批次相加即总数。
|
|
920
|
-
★ 2026-11-19 task-1250:域名面(domain / ops / dns_credential)已从后端删除,
|
|
921
|
-
`uncounted_self_hosted` 恒为 0(字段保留,老脚本读它不会 undefined)。 */
|
|
922
|
-
const selfHosted = batches.user + batches.content + batches.asset + batches.publish
|
|
923
|
-
+ batches.config_auth + batches.site;
|
|
924
|
-
const forwarded = batches.finance_forwarded;
|
|
925
|
-
const uncounted = 0;
|
|
926
|
-
const total = Number(who.action_total);
|
|
927
|
-
return {
|
|
928
|
-
action_total: Number.isFinite(total) && total > 0 ? total : native + selfHosted + forwarded,
|
|
929
|
-
native,
|
|
930
|
-
self_hosted: selfHosted,
|
|
931
|
-
forwarded,
|
|
932
|
-
uncounted_self_hosted: uncounted,
|
|
933
|
-
batches,
|
|
934
|
-
consistent: !(Number.isFinite(total) && total > 0) || total === native + selfHosted + forwarded,
|
|
935
|
-
};
|
|
936
|
-
}
|
|
937
|
-
|
|
938
|
-
/** 「自持批次」的人话标签(顺序 = 迁移批次;域名面已随 task-1250 删除) */
|
|
939
|
-
const SURFACE_BATCH_LABEL = [
|
|
940
|
-
['user', '账号/站点面(自持副本)'],
|
|
941
|
-
['content', '内容类(B1)'],
|
|
942
|
-
['asset', '素材类(B2)'],
|
|
943
|
-
['publish', '发布类(B3)'],
|
|
944
|
-
['config_auth', '配置类 auth 面(B7:成员 / 角色 / 语言)'],
|
|
945
|
-
['site', '站点类(B4:公司信息 / 示例内容 / 站级同步)'],
|
|
946
|
-
['finance_forwarded', '金融面(白名单转发 wkgeo-order)'],
|
|
947
|
-
];
|
|
948
|
-
|
|
949
|
-
/** 不计入 `action_total` 的批次:★ task-1250 起为空(域名面已删) */
|
|
950
|
-
const SURFACE_EXTRA_LABEL = [];
|
|
951
|
-
|
|
952
|
-
export const authStatusCommand = {
|
|
953
|
-
name: 'auth status',
|
|
954
|
-
summary: '看当前令牌是谁、在 CLI 自持函数里能干什么(账号 / scopes / 动作面总数与自持清单)',
|
|
955
|
-
usage: 'wkgeo auth status [--verbose]',
|
|
956
|
-
args: [],
|
|
957
|
-
flags: {
|
|
958
|
-
verbose: { type: 'boolean', desc: '额外显示令牌掩码与凭据文件权限(仍然不含令牌明文)' },
|
|
959
|
-
},
|
|
960
|
-
examples: ['wkgeo auth status', 'wkgeo auth status --json'],
|
|
961
|
-
notes: [
|
|
962
|
-
'后端动作 `cliWhoami`(无 scope 要求、只读):返回账号标识 / client_id / scopes / 动作面清单,CLI 原样透出。',
|
|
963
|
-
'后端**没有** `account_id` 字段:账号唯一标识就是 `user_id`(本命令里 `account_id` ≡ `user_id`)。',
|
|
964
|
-
'动作面 = 原生(本函数 switch)+ 自持(进程内重建)+ 转发(金融面白名单给 wkgeo-order);`action_total` 与明细对不上时会标 `action_surface.consistent=false`。',
|
|
965
|
-
'绝不打印令牌:要看"还剩多久、有多长"用 `wkgeo auth token`。',
|
|
966
|
-
],
|
|
967
|
-
async run(ctx) {
|
|
968
|
-
const { out, config, flags } = ctx;
|
|
969
|
-
const creds = ctx.requireAuth();
|
|
970
|
-
const who = (await ctx.callData('cliWhoami', {})) || {};
|
|
971
|
-
const surface = summarizeActionSurface(who);
|
|
972
|
-
const userId = who.user_id || (creds.account && creds.account.sub) || null;
|
|
973
|
-
const expiresInMs = creds.expires_at ? new Date(creds.expires_at).getTime() - ctx.now() : null;
|
|
974
|
-
|
|
975
|
-
const data = {
|
|
976
|
-
logged_in: true,
|
|
977
|
-
/** 后端只有 user_id;`account_id` 是给人/脚本的稳定别名 */
|
|
978
|
-
account_id: userId,
|
|
979
|
-
user_id: userId,
|
|
980
|
-
client_id: who.client_id || creds.client_id || null,
|
|
981
|
-
scopes: Array.isArray(who.scopes) ? who.scopes : String(creds.scope || '').split(/\s+/).filter(Boolean),
|
|
982
|
-
scope: creds.scope || null,
|
|
983
|
-
obtained_at: creds.obtained_at || null,
|
|
984
|
-
expires_at: creds.expires_at || null,
|
|
985
|
-
expires_in_ms: expiresInMs,
|
|
986
|
-
credentials_file: config.credentialsFile,
|
|
987
|
-
/** 后端/函数标识(排查"到底打没打到自持函数"用) */
|
|
988
|
-
fn: who.fn || null,
|
|
989
|
-
via: who.via || null,
|
|
990
|
-
action_total: surface.action_total,
|
|
991
|
-
action_surface: surface,
|
|
992
|
-
/** 原样透出(agent 可直接按清单挑动作;不截断、不重排) */
|
|
993
|
-
action_lists: {
|
|
994
|
-
actions: who.actions || [],
|
|
995
|
-
self_hosted_actions: who.self_hosted_actions || [],
|
|
996
|
-
content_actions: who.content_actions || [],
|
|
997
|
-
asset_actions: who.asset_actions || [],
|
|
998
|
-
publish_actions: who.publish_actions || [],
|
|
999
|
-
forwarded_actions: who.forwarded_actions || [],
|
|
1000
|
-
},
|
|
1001
|
-
token_ttl_hint: who.token_ttl_hint || null,
|
|
1002
|
-
whoami: who,
|
|
1003
|
-
};
|
|
1004
|
-
if (flags.verbose) {
|
|
1005
|
-
data.token_masked = maskToken(creds.access_token);
|
|
1006
|
-
const mode = checkFileMode(config.credentialsFile);
|
|
1007
|
-
data.file_mode = mode.supported ? mode.modeText : '无法判断(Windows)';
|
|
1008
|
-
data.file_mode_too_open = mode.supported ? !!mode.tooOpen : null;
|
|
1009
|
-
}
|
|
1010
|
-
|
|
1011
|
-
if (!out.json) {
|
|
1012
|
-
out.head('当前令牌(CLI 自持云函数 wkgeo-cli-fc)');
|
|
1013
|
-
out.line(` 账号 ID:${userId || '(服务端未返回账号标识)'}`);
|
|
1014
|
-
out.line(` 应用(client_id):${data.client_id || '-'}`);
|
|
1015
|
-
out.line(` 能力范围:${data.scopes.length ? data.scopes.join(' ') : '-'}`);
|
|
1016
|
-
out.line(` 令牌到期:${formatTime(data.expires_at)}(${formatRemaining(expiresInMs)})`);
|
|
1017
|
-
out.line(` 凭据文件:${data.credentials_file}`);
|
|
1018
|
-
out.head(' 动作面');
|
|
1019
|
-
out.line(` 合计:${surface.action_total} 条(原生 ${surface.native} · 自持 ${surface.self_hosted} · 转发 ${surface.forwarded})`);
|
|
1020
|
-
for (const [key, label] of SURFACE_BATCH_LABEL) {
|
|
1021
|
-
const count = surface.batches[key];
|
|
1022
|
-
if (count) out.line(` · ${label}:${count} 条`);
|
|
1023
|
-
}
|
|
1024
|
-
for (const [key, label] of SURFACE_EXTRA_LABEL) {
|
|
1025
|
-
const count = surface.batches[key];
|
|
1026
|
-
if (count) out.line(` · ${label}:${count} 条`);
|
|
1027
|
-
}
|
|
1028
|
-
if (!surface.consistent) {
|
|
1029
|
-
out.warn(' 动作面明细与 action_total 对不上(服务端刚改过动作表?)—— 以 action_lists 明细为准。');
|
|
1030
|
-
}
|
|
1031
|
-
if (data.token_ttl_hint) out.info(` ${data.token_ttl_hint}`);
|
|
1032
|
-
if (flags.verbose) {
|
|
1033
|
-
out.line(` 令牌(掩码):${data.token_masked}`);
|
|
1034
|
-
out.line(` 文件权限:${data.file_mode}${data.file_mode_too_open ? ' ⚠️ 权限过宽,建议 chmod 600' : ''}`);
|
|
1035
|
-
}
|
|
1036
|
-
out.info(' (令牌明文不会显示;只看剩余时长/长度用 `wkgeo auth token`)');
|
|
1037
|
-
}
|
|
1038
|
-
ctx.done(data);
|
|
1039
|
-
return data;
|
|
1040
|
-
},
|
|
1041
|
-
};
|
|
1042
|
-
|
|
1043
|
-
export const authTokenCommand = {
|
|
1044
|
-
name: 'auth token',
|
|
1045
|
-
summary: '看本地令牌的前 4 位、长度与到期时间(绝不打印明文)',
|
|
1046
|
-
usage: 'wkgeo auth token [--json]',
|
|
1047
|
-
args: [],
|
|
1048
|
-
flags: {},
|
|
1049
|
-
examples: ['wkgeo auth token', 'wkgeo auth token --json'],
|
|
1050
|
-
notes: [
|
|
1051
|
-
'只显示**前 4 位 + 总长度 + 到期时间**:足够确认"是不是换过了/有没有被截断",抄不走令牌。',
|
|
1052
|
-
'令牌就是 `wkgeo login` 拿到的 OAuth access_token(30 天);CLI 没有另一套专用令牌。',
|
|
1053
|
-
'要看账号与动作面用 `wkgeo auth status`;要立刻作废用 `wkgeo auth revoke`。',
|
|
1054
|
-
],
|
|
1055
|
-
async run(ctx) {
|
|
1056
|
-
const { out, config } = ctx;
|
|
1057
|
-
const creds = ctx.readCredentials();
|
|
1058
|
-
if (!creds) throw notLoggedInError();
|
|
1059
|
-
const token = String(creds.access_token || '');
|
|
1060
|
-
const expiresInMs = creds.expires_at ? new Date(creds.expires_at).getTime() - ctx.now() : null;
|
|
1061
|
-
const data = {
|
|
1062
|
-
logged_in: true,
|
|
1063
|
-
token_prefix: token.slice(0, 4),
|
|
1064
|
-
token_length: token.length,
|
|
1065
|
-
token_type: creds.token_type || 'Bearer',
|
|
1066
|
-
expires_at: creds.expires_at || null,
|
|
1067
|
-
expires_in_ms: expiresInMs,
|
|
1068
|
-
expired: isExpired(creds, { now: ctx.now() }),
|
|
1069
|
-
scope: creds.scope || null,
|
|
1070
|
-
client_id: creds.client_id || null,
|
|
1071
|
-
obtained_at: creds.obtained_at || null,
|
|
1072
|
-
credentials_file: config.credentialsFile,
|
|
1073
|
-
note: '只显示前 4 位与长度;完整令牌不会出现在任何输出里',
|
|
1074
|
-
};
|
|
1075
|
-
|
|
1076
|
-
if (!out.json) {
|
|
1077
|
-
out.head('本地令牌');
|
|
1078
|
-
out.line(` 前 4 位:${data.token_prefix}…(共 ${data.token_length} 位)`);
|
|
1079
|
-
out.line(` 类型:${data.token_type}`);
|
|
1080
|
-
out.line(` 到期:${formatTime(data.expires_at)}(${formatRemaining(expiresInMs)})${data.expired ? ' ⚠️ 已过期' : ''}`);
|
|
1081
|
-
out.line(` 能力范围:${data.scope || '-'}`);
|
|
1082
|
-
out.line(` 凭据文件:${data.credentials_file}`);
|
|
1083
|
-
out.info(' (完整令牌永远不打印;需要作废就 `wkgeo auth revoke`)');
|
|
1084
|
-
}
|
|
1085
|
-
ctx.done(data);
|
|
1086
|
-
return data;
|
|
1087
|
-
},
|
|
1088
|
-
};
|
|
1089
|
-
|
|
1090
|
-
export const authRevokeCommand = {
|
|
1091
|
-
name: 'auth revoke',
|
|
1092
|
-
summary: '立刻作废本地令牌(服务端 RFC 7009 吊销 + 删本地凭据)',
|
|
1093
|
-
usage: 'wkgeo auth revoke [--local-only]',
|
|
1094
|
-
args: [],
|
|
1095
|
-
flags: {
|
|
1096
|
-
'local-only': { type: 'boolean', desc: '只删本地凭据,不调服务端吊销接口' },
|
|
1097
|
-
},
|
|
1098
|
-
examples: ['wkgeo auth revoke', 'wkgeo auth revoke --local-only'],
|
|
1099
|
-
notes: [
|
|
1100
|
-
'服务端吊销走 OAuth 标准端点 `POST /api/oauth/revoke`(与 `wkgeo logout` 同一个,前端/会员中心也用它);不成功会如实说明,不假装已吊销。',
|
|
1101
|
-
'本地凭据文件(默认 `%USERPROFILE%\\.wkongai\\credentials.json`)会被删除;之后任何业务命令都会要求重新 `wkgeo login`。',
|
|
1102
|
-
'即使服务端吊销失败,令牌也会在到期时间后自动失效;要**立刻**吊销全部设备授权,请到会员中心 →「我的授权」撤销应用(对应动作 `revokeMyOAuthAuthorization`,`wkgeo apps revoke` 也能做)。',
|
|
1103
|
-
],
|
|
1104
|
-
async run(ctx) {
|
|
1105
|
-
const { out, config, flags } = ctx;
|
|
1106
|
-
const creds = ctx.readCredentials();
|
|
1107
|
-
if (!creds) {
|
|
1108
|
-
out.warn('本地本来就没有凭据(未登录),无需吊销');
|
|
1109
|
-
const data = {
|
|
1110
|
-
removed: false,
|
|
1111
|
-
revoked_remote: false,
|
|
1112
|
-
revoke_error: null,
|
|
1113
|
-
revoke_endpoint: '/api/oauth/revoke',
|
|
1114
|
-
credentials_file: config.credentialsFile,
|
|
1115
|
-
};
|
|
1116
|
-
ctx.done(data);
|
|
1117
|
-
return data;
|
|
1118
|
-
}
|
|
1119
|
-
|
|
1120
|
-
let revoke = { ok: false, reason: '已按要求跳过(--local-only)' };
|
|
1121
|
-
if (flags.localOnly !== true) revoke = await ctx.api.revoke(creds.access_token);
|
|
1122
|
-
const removed = deleteCredentials(config.credentialsFile);
|
|
1123
|
-
const data = {
|
|
1124
|
-
removed,
|
|
1125
|
-
revoked_remote: revoke.ok === true,
|
|
1126
|
-
revoke_error: revoke.ok ? null : revoke.reason || null,
|
|
1127
|
-
revoke_endpoint: '/api/oauth/revoke',
|
|
1128
|
-
credentials_file: config.credentialsFile,
|
|
1129
|
-
client_id: creds.client_id || null,
|
|
1130
|
-
expires_at: creds.expires_at || null,
|
|
1131
|
-
server_ttl_note: '未吊销成功时令牌仍会在到期时间自动失效;要立刻撤销全部设备授权请到会员中心',
|
|
1132
|
-
};
|
|
1133
|
-
|
|
1134
|
-
if (revoke.ok) out.ok('服务端令牌已吊销(POST /api/oauth/revoke)');
|
|
1135
|
-
else out.warn(`未能吊销服务端令牌(${revoke.reason || '未知原因'})—— 本地凭据已删除,令牌仍会在到期时间自动失效`);
|
|
1136
|
-
if (removed) out.ok(`本地凭据已删除:${config.credentialsFile}`);
|
|
1137
|
-
out.info(' → 要立刻吊销该应用的全部设备授权:`wkgeo apps revoke --client-id <client_id>` 或会员中心 →「我的授权」。');
|
|
1138
|
-
ctx.done(data);
|
|
1139
|
-
return data;
|
|
1140
|
-
},
|
|
1141
|
-
};
|
|
1142
|
-
|
|
1143
|
-
/* ------------------------------------------------------------------ */
|
|
1144
|
-
/* config */
|
|
1145
|
-
/* ------------------------------------------------------------------ */
|
|
1146
|
-
|
|
1147
|
-
export const configCommand = {
|
|
1148
|
-
name: 'config',
|
|
1149
|
-
summary: '显示当前生效的配置与登录状态(不含任何令牌)',
|
|
1150
|
-
usage: 'wkgeo config',
|
|
1151
|
-
notes: [
|
|
1152
|
-
'这条是**本机诊断**命令(凭据文件 / 代理 / 当前站点),不发任何业务请求。',
|
|
1153
|
-
'★ task-92 起同一个 `config` 前缀下还有**后台参数**命令组(走 `/cli` 自持通道,要 `site:read` / `site:write`):',
|
|
1154
|
-
' `wkgeo config get`(读站点参数与白名单)/ `config save`(存参数,默认 dry-run)/',
|
|
1155
|
-
' `config review`(审核统计代码,双闸 REVIEW_TOKEN)/ `config capabilities`(会员与支付两档能不能选)。',
|
|
1156
|
-
' `wkgeo config --help` 只显示本条(解析器先做精确匹配);看那组的用法:`wkgeo config get --help`。',
|
|
1157
|
-
],
|
|
1158
|
-
async run(ctx) {
|
|
1159
|
-
const { out, config } = ctx;
|
|
1160
|
-
const creds = readCredentials(config.credentialsFile);
|
|
1161
|
-
const sources = describeConfigSources(ctx.flags, ctx.env);
|
|
1162
|
-
const mode = checkFileMode(config.credentialsFile);
|
|
1163
|
-
/**
|
|
1164
|
-
* ★ 顺带报告"本机代理情况"。
|
|
1165
|
-
*
|
|
1166
|
-
* 为什么放在 `config` 里:这条命令就是**排障入口**("把你的 config 输出发我")。
|
|
1167
|
-
* 老板说过"很多用户不懂代理",让支持同学只用一条命令就能看出
|
|
1168
|
-
* "哦,你机器上有代理且没绕过 127.0.0.1,所以回调收不到" —— 比让用户
|
|
1169
|
-
* 自己去翻注册表/系统设置现实得多。
|
|
1170
|
-
* 检测是**只读**的:不改用户任何设置(见 lib/proxy.mjs 开头三条硬约束)。
|
|
1171
|
-
*/
|
|
1172
|
-
const proxy = proxyWarningPayload(ctx.proxyInfo(), { cmdName: config.cmdName || 'wkgeo' });
|
|
1173
|
-
|
|
1174
|
-
/**
|
|
1175
|
-
* 本地"当前站点"(`wkgeo site use` 选的)。
|
|
1176
|
-
* ⚠️ 诊断命令**不能**因为一个坏文件就整体失败:读失败时如实报出来,其它信息照常给。
|
|
1177
|
-
*/
|
|
1178
|
-
let cmsSite = null;
|
|
1179
|
-
let cmsSiteError = null;
|
|
1180
|
-
try {
|
|
1181
|
-
cmsSite = ctx.readSiteState();
|
|
1182
|
-
} catch (e) {
|
|
1183
|
-
cmsSiteError = (e && e.message) || String(e);
|
|
1184
|
-
}
|
|
1185
|
-
|
|
1186
|
-
const data = {
|
|
1187
|
-
base: config.base,
|
|
1188
|
-
/**
|
|
1189
|
-
* CMS 面(栏目/内容/素材/模板)是**另一个云函数、另一个域名**,
|
|
1190
|
-
* 所以单独列一行 —— 排查"CMS 命令为什么 404"时第一眼看的就是它。
|
|
1191
|
-
*/
|
|
1192
|
-
cms_base: config.cmsBase,
|
|
1193
|
-
/**
|
|
1194
|
-
* ⚠️ `web_base` 是**兼容字段**:三站拆分后它指向老站(管理端),
|
|
1195
|
-
* 已经没有任何代码用它打开页面 —— 保留只为不破坏既有自动化脚本。
|
|
1196
|
-
* 真正生效的是下面三个按站的基址(2026-10-02 三站拆分新增)。
|
|
1197
|
-
*/
|
|
1198
|
-
web_base: config.webBase,
|
|
1199
|
-
oauth_web_base: config.oauthWebBase,
|
|
1200
|
-
pay_web_base: config.payWebBase,
|
|
1201
|
-
user_web_base: config.userWebBase,
|
|
1202
|
-
client_id: config.clientId,
|
|
1203
|
-
scope: config.scope,
|
|
1204
|
-
credentials_file: config.credentialsFile,
|
|
1205
|
-
callback: `http://${config.callbackHost}:${config.callbackPort}${config.callbackPath}`,
|
|
1206
|
-
http_timeout_ms: config.httpTimeoutMs,
|
|
1207
|
-
login_timeout_ms: config.loginTimeoutMs,
|
|
1208
|
-
/** 本地"当前站点"(CMS 命令用;`site use` 写的) */
|
|
1209
|
-
cms_site: cmsSite,
|
|
1210
|
-
cms_site_file: config.siteStateFile,
|
|
1211
|
-
cms_site_error: cmsSiteError,
|
|
1212
|
-
sources,
|
|
1213
|
-
logged_in: !!creds,
|
|
1214
|
-
expired: creds ? isExpired(creds, { now: ctx.now() }) : null,
|
|
1215
|
-
account: creds && creds.account ? { user_id: creds.account.sub || null, email: creds.account.email || null } : null,
|
|
1216
|
-
expires_at: creds ? creds.expires_at || null : null,
|
|
1217
|
-
file_mode: mode.supported ? mode.modeText : '无法判断(Windows)',
|
|
1218
|
-
/** 结构化:有代理/有风险/建议怎么做(AI 端与支持同学都直接用这份) */
|
|
1219
|
-
proxy,
|
|
1220
|
-
};
|
|
1221
|
-
|
|
1222
|
-
if (!out.json) {
|
|
1223
|
-
out.head('生效配置');
|
|
1224
|
-
for (const [k, v] of Object.entries({
|
|
1225
|
-
'API 基址': data.base,
|
|
1226
|
-
'CMS 接口基址': data.cms_base,
|
|
1227
|
-
'授权站基址': data.oauth_web_base,
|
|
1228
|
-
'收银台基址': data.pay_web_base,
|
|
1229
|
-
'会员站基址': data.user_web_base,
|
|
1230
|
-
'老站基址(兼容字段,不再用于跳转)': data.web_base,
|
|
1231
|
-
'client_id': data.client_id,
|
|
1232
|
-
'能力范围': data.scope,
|
|
1233
|
-
'回调地址': data.callback,
|
|
1234
|
-
'凭据文件': data.credentials_file,
|
|
1235
|
-
})) {
|
|
1236
|
-
out.line(` ${k}:${v}`);
|
|
1237
|
-
}
|
|
1238
|
-
out.line(
|
|
1239
|
-
` 当前站点:${
|
|
1240
|
-
data.cms_site && data.cms_site.id
|
|
1241
|
-
? `${data.cms_site.label ? `${data.cms_site.label}(` : ''}${data.cms_site.id}${data.cms_site.label ? ')' : ''}`
|
|
1242
|
-
: data.cms_site_error
|
|
1243
|
-
? `⚠️ 读取失败:${data.cms_site_error}`
|
|
1244
|
-
: '未选(CMS 命令前先 `wkgeo site use <站点ID或域名>`)'
|
|
1245
|
-
}`,
|
|
1246
|
-
);
|
|
1247
|
-
out.line(` 登录状态:${data.logged_in ? (data.expired ? '已过期(需重新 login)' : '已登录') : '未登录'}`);
|
|
1248
|
-
if (data.logged_in) {
|
|
1249
|
-
out.line(` 账号:${(data.account && (data.account.email || data.account.user_id)) || '-'}`);
|
|
1250
|
-
out.line(` 令牌到期:${formatTime(data.expires_at)}`);
|
|
1251
|
-
}
|
|
1252
|
-
out.line(` 系统代理:${proxy.detected ? `${proxy.proxy}(来源 ${proxy.source})` : '未检测到'}`);
|
|
1253
|
-
if (proxy.callback_may_fail) {
|
|
1254
|
-
/**
|
|
1255
|
-
* ⚠️ 口径与 login 一致:**检测到代理就一定会走设备码**(不看绕过列表),
|
|
1256
|
-
* 所以这里不能说"已绕过回环就没问题"(真机上正是这么翻车的)。
|
|
1257
|
-
*/
|
|
1258
|
-
out.warn(
|
|
1259
|
-
' 检测到系统代理 → `wkgeo login` 会**直接改用设备码模式**(不再依赖 127.0.0.1 回调;绕过列表写了 127.*/localhost 也不作依据)。',
|
|
1260
|
-
);
|
|
1261
|
-
out.info(' 想坚持浏览器回调模式:`wkgeo login --no-auto-device`,并把 127.0.0.1,localhost 加入代理绕过列表。');
|
|
1262
|
-
}
|
|
1263
|
-
out.info(` (配置来源:${JSON.stringify(sources)})`);
|
|
1264
|
-
/**
|
|
1265
|
-
* ★ task-92:`config` 这个名字现在**同时**是本机诊断命令和"站点参数"命令组的前缀。
|
|
1266
|
-
* 解析器先做精确匹配,所以 `wkgeo config` 永远还是这里(行为一字未改);
|
|
1267
|
-
* 但那也意味着 `wkgeo config --help` **不会**掉到分组帮助里 ——
|
|
1268
|
-
* 想让用户发现后台参数命令,只能在这儿指一条路。
|
|
1269
|
-
*/
|
|
1270
|
-
out.info(' → 站点参数(后台配置):`wkgeo config get` / `config save` / `config review` / `config capabilities`');
|
|
1271
|
-
}
|
|
1272
|
-
ctx.done(data);
|
|
1273
|
-
return data;
|
|
1274
|
-
},
|
|
1275
|
-
};
|
|
1276
|
-
|
|
1277
|
-
/** 未登录时的统一提示(whoami / 业务命令共用) */
|
|
1278
|
-
export function notLoggedInError() {
|
|
1279
|
-
return new CliError('尚未登录', { kind: 'unauthenticated', hint: loginHint(), exitCode: EXIT.AUTH });
|
|
1280
|
-
}
|
|
1
|
+
/**
|
|
2
|
+
* 账号类命令:`login` / `logout` / `whoami` / `config`
|
|
3
|
+
*
|
|
4
|
+
* ⚠️ 非交互铁律:这些命令**任何情况下都不提问**(不用 AI 去"按 y")。
|
|
5
|
+
* 需要用户做的事(同意授权)表现为:打印网址 + 阻塞等待 + 超时给明确错误。
|
|
6
|
+
*/
|
|
7
|
+
|
|
8
|
+
import { runLogin } from '../login.mjs';
|
|
9
|
+
import { requestDeviceCode, announceDeviceCode, pollDeviceToken, devicePasteText } from '../device.mjs';
|
|
10
|
+
import {
|
|
11
|
+
pendingDeviceFile,
|
|
12
|
+
savePendingDevice,
|
|
13
|
+
readPendingDevice,
|
|
14
|
+
deletePendingDevice,
|
|
15
|
+
isPendingExpired,
|
|
16
|
+
pendingExpiredError,
|
|
17
|
+
} from '../device-store.mjs';
|
|
18
|
+
import { proxyWarningPayload, proxyDeviceSwitchLines, proxyForcedCallbackLines } from '../proxy.mjs';
|
|
19
|
+
import { deleteCredentials, readCredentials, checkFileMode, isExpired } from '../credentials.mjs';
|
|
20
|
+
import { formatRemaining, maskToken, formatTime } from '../format.mjs';
|
|
21
|
+
import { CliError, EXIT, loginHint, UsageError } from '../errors.mjs';
|
|
22
|
+
import { describeConfigSources, parseDurationMs } from '../config.mjs';
|
|
23
|
+
import { GLOBAL_FLAGS } from '../args.mjs';
|
|
24
|
+
|
|
25
|
+
/**
|
|
26
|
+
* 「检测到系统代理时自动改用设备码」这个开关的解析(默认 **开**)。
|
|
27
|
+
*
|
|
28
|
+
* ## 为什么默认开,而不是 opt-in(老板 2026-10-02 明确要求)
|
|
29
|
+
* 老板原话:「如果能检测到有代理,可不可以**直接返回设备码**,然后用户把它输入到 AI 端的
|
|
30
|
+
* 对话框里……你那个让用户检查代理设置太不方便了,**很多用户也不懂**。」
|
|
31
|
+
* → 主路径必须是"用户什么都不用做就能成功"。三条"改代理设置"的提示保留为**补充说明**,
|
|
32
|
+
* 但绝不能是唯一出路(不懂代理的用户会直接卡死)。
|
|
33
|
+
*
|
|
34
|
+
* ## ⚠️ 2026-10-02 第二版加固:判定依据从 `risk` 改成 `detected`
|
|
35
|
+
* 第一版是"有代理 **且** 绕过列表没写回环(`risk`)才降级"。真机上彻底失效:
|
|
36
|
+
* 老板的机器绕过列表里**写着** `127.*;localhost`,于是判成"不风险"、走了回调,
|
|
37
|
+
* 结果他点了【同意授权】之后 CLI **一直拿不到令牌**
|
|
38
|
+
* (独立证据:`curl -x http://127.0.0.1:7890 http://127.0.0.1:1/x` 返回 502,
|
|
39
|
+
* 说明那台机器上的代理**会尝试接管回环请求**)。
|
|
40
|
+
* ⇒ 现在:**只要 `proxyInfo.detected === true` 就直接走设备码**,
|
|
41
|
+
* 宁可多一步(用户按一次短码),也绝不让用户卡在"点了同意却没反应"。
|
|
42
|
+
* `loopback_bypassed` / `risk` 只进诊断字段。
|
|
43
|
+
*
|
|
44
|
+
* ## 什么情况下关掉它
|
|
45
|
+
* `--no-auto-device` 或 `WKONGAI_AUTO_DEVICE=0`:
|
|
46
|
+
* * 你确认回调一定通(例如内网、代理已正确绕过回环),不想被自动改道;
|
|
47
|
+
* * 探测本身有误报(例如命中 PAC:绕过规则写在脚本里,我们无法零依赖求值)。
|
|
48
|
+
* ⚠️ 关掉时 CLI **必须**警告"代理可能吃掉回调"(见 proxyForcedCallbackLines)——
|
|
49
|
+
* 否则用户就只剩"点了同意干等到超时"这一种结局。
|
|
50
|
+
*
|
|
51
|
+
* ## 优先级(显式 > 环境变量 > 默认)
|
|
52
|
+
* `--auto-device` / `--no-auto-device`(命令行)> `WKONGAI_AUTO_DEVICE`(0/false/no/off = 关)> 默认开
|
|
53
|
+
*/
|
|
54
|
+
export function resolveAutoDevice(flags = {}, env = {}) {
|
|
55
|
+
if (flags.autoDevice === false) return false;
|
|
56
|
+
if (flags.autoDevice === true) return true;
|
|
57
|
+
const v = String((env && env.WKONGAI_AUTO_DEVICE) || '')
|
|
58
|
+
.trim()
|
|
59
|
+
.toLowerCase();
|
|
60
|
+
if (['0', 'false', 'no', 'off'].includes(v)) return false;
|
|
61
|
+
return true;
|
|
62
|
+
}
|
|
63
|
+
|
|
64
|
+
/**
|
|
65
|
+
* 「回调模式首轮等待」窗口(毫秒)的解析 —— **可选自愈,默认关闭**。
|
|
66
|
+
*
|
|
67
|
+
* ## ★★ 0.2.2(老板 2026-10-21 反馈):默认不再自动改设备码
|
|
68
|
+
* 老板原话:「默认的也不应该是设备授权,默认的就是那个传统的授权方式(浏览器打开授权页 +
|
|
69
|
+
* 本地 localhost 回调)。设备码是本地读不了/代理时才用的。」
|
|
70
|
+
* ⇒ 本函数**不再**按"有没有代理"给默认值:用户没显式指定时**一律返回 0**。
|
|
71
|
+
* 也就是说 `wkgeo login` 默认会一路等回调到 `--timeout`,**不会**因为等太久自动改设备码。
|
|
72
|
+
*
|
|
73
|
+
* 设备码只在这两种情况出现(见 loginCommand.run):
|
|
74
|
+
* 1. 用户显式 `--device` / `--no-wait` / `--device-continue`;
|
|
75
|
+
* 2. 检测到系统代理且判定回调不可用(`--no-auto-device` 可关)。
|
|
76
|
+
* ⚠️ 0.2.4 起:**本地回调端口起不来不再自动改设备码**(老板反馈"服务没起来却换了模式"),
|
|
77
|
+
* 而是如实报 `kind:"listen"` 并在 hint 里明确建议用户显式加 `--device`。
|
|
78
|
+
*
|
|
79
|
+
* ## 保留的显式开关(向后兼容,不参与默认判断)
|
|
80
|
+
* `--callback-first-wait <时长>`(默认单位**秒**;`0` / `off` / `none` = 关闭)
|
|
81
|
+
* > `WKONGAI_CALLBACK_FIRST_WAIT_MS`(毫秒)
|
|
82
|
+
* > 默认 **0(关闭)**
|
|
83
|
+
* ⇒ 只有用户**显式**写了它,才会在首轮等待到点后并发启动设备码(两条路先到先得)。
|
|
84
|
+
* 显式指定是用户的明确选择,我们照旧尊重(但他不写就绝不会自动发生)。
|
|
85
|
+
*
|
|
86
|
+
* ⚠️ `--no-auto-device`(autoDevice=false)时**强制返回 0**:用户已经明确要求"只走回调",
|
|
87
|
+
* 我们就连显式开关也不启用(不背着他改道)。此时整段 `--timeout` 依然是兜底。
|
|
88
|
+
*
|
|
89
|
+
* @param {object} flags 已解析的命令行标志(camelCase)
|
|
90
|
+
* @param {object} env 环境变量
|
|
91
|
+
* @param {{autoDevice?: boolean, proxyDetected?: boolean}} [opts]
|
|
92
|
+
* `proxyDetected` 仅为**兼容旧调用方**保留,**已不影响返回值**(0.2.2 起默认永不开启)。
|
|
93
|
+
* @returns {number} 毫秒;0 = 不启用(默认)
|
|
94
|
+
*/
|
|
95
|
+
export function resolveCallbackFirstWaitMs(flags = {}, env = {}, { autoDevice = true } = {}) {
|
|
96
|
+
if (!autoDevice) return 0;
|
|
97
|
+
const off = new Set(['0', 'off', 'none', 'false', 'no']);
|
|
98
|
+
if (flags.callbackFirstWait !== undefined && flags.callbackFirstWait !== '') {
|
|
99
|
+
const raw = String(flags.callbackFirstWait).trim().toLowerCase();
|
|
100
|
+
if (off.has(raw)) return 0;
|
|
101
|
+
return parseDurationMs(flags.callbackFirstWait, { defaultUnit: 's', flag: '--callback-first-wait' });
|
|
102
|
+
}
|
|
103
|
+
const envVal = env && env.WKONGAI_CALLBACK_FIRST_WAIT_MS;
|
|
104
|
+
if (envVal !== undefined && envVal !== '') {
|
|
105
|
+
if (off.has(String(envVal).trim().toLowerCase())) return 0;
|
|
106
|
+
return parseDurationMs(envVal, { defaultUnit: 'ms', flag: 'WKONGAI_CALLBACK_FIRST_WAIT_MS' });
|
|
107
|
+
}
|
|
108
|
+
/**
|
|
109
|
+
* ★ 走到这里 = 用户**没有**显式指定 ⇒ **默认不启用**(0.2.2 起)。
|
|
110
|
+
* 不再看 `proxyDetected`:有代理时命令层已经在第一跳直接走设备码了,
|
|
111
|
+
* 回调模式下的"等待超时"只该如实报错,不该偷偷改道。
|
|
112
|
+
*/
|
|
113
|
+
return 0;
|
|
114
|
+
}
|
|
115
|
+
|
|
116
|
+
/**
|
|
117
|
+
* ★ 「回调 / 设备码两条路并存」时用的**可被立刻叫醒的 sleep**。
|
|
118
|
+
*
|
|
119
|
+
* 为什么需要它:`pollDeviceToken()` 每轮之间会 `await sleep(interval)`(默认 5 秒)。
|
|
120
|
+
* 回调那条路先拿到令牌时,设备码那条路必须**马上**停下来 —— 如果只是置一个"别再轮询"的标志,
|
|
121
|
+
* 那个**已经挂上**的 `setTimeout` 会把 Node 的事件循环继续吊住(用户已经看到"登录成功",
|
|
122
|
+
* 进程却迟迟不退出)。所以这里把 sleep 做成可唤醒的:谁赢了就 `wakeAll()`,
|
|
123
|
+
* 挂着的那一轮立刻醒来,醒来后由 `shouldStop()`(见 device.mjs)抛错退出。
|
|
124
|
+
*
|
|
125
|
+
* ⚠️ 测试注入的 `sleep`(例如 `async () => {}`)**照旧透传**:那种实现立刻返回,
|
|
126
|
+
* 不需要(也无法)被打断 —— 只有生产路径(真 `setTimeout`)才由这里持有并清理。
|
|
127
|
+
*/
|
|
128
|
+
export function createCancelGate(baseSleep) {
|
|
129
|
+
const waiters = new Set();
|
|
130
|
+
let cancelled = false;
|
|
131
|
+
const delegated = typeof baseSleep === 'function';
|
|
132
|
+
return {
|
|
133
|
+
sleep: (ms) => {
|
|
134
|
+
if (cancelled) return Promise.resolve();
|
|
135
|
+
if (delegated) return baseSleep(ms);
|
|
136
|
+
return new Promise((resolve) => {
|
|
137
|
+
const done = () => {
|
|
138
|
+
waiters.delete(done);
|
|
139
|
+
clearTimeout(timer);
|
|
140
|
+
resolve();
|
|
141
|
+
};
|
|
142
|
+
const timer = setTimeout(done, ms);
|
|
143
|
+
waiters.add(done);
|
|
144
|
+
});
|
|
145
|
+
},
|
|
146
|
+
wakeAll() {
|
|
147
|
+
cancelled = true;
|
|
148
|
+
for (const done of [...waiters]) done();
|
|
149
|
+
},
|
|
150
|
+
};
|
|
151
|
+
}
|
|
152
|
+
|
|
153
|
+
/** 回调那条路先成功时用来**安静地**叫停设备码那条路(不是给用户看的错误,命令层会吞掉它) */
|
|
154
|
+
function deviceStoppedError() {
|
|
155
|
+
return new CliError('设备码轮询已停止(本地回调那条路已经拿到令牌)', {
|
|
156
|
+
kind: 'cancelled',
|
|
157
|
+
hint: '不需要做任何事:登录已经完成',
|
|
158
|
+
exitCode: EXIT.AUTH,
|
|
159
|
+
});
|
|
160
|
+
}
|
|
161
|
+
|
|
162
|
+
/**
|
|
163
|
+
* 把"设备码那条路"**等它退出**(失败/被叫停都不许把主流程带下水)。
|
|
164
|
+
*
|
|
165
|
+
* ⚠️ 这里刻意用 `Promise.race` 加一个 1 秒上限:`deviceSide.promise` 的结束速度取决于注入的
|
|
166
|
+
* `sleep` 能不能被打断 —— 生产路径由 `createCancelGate()` 自己持有定时器,`wakeAll()`
|
|
167
|
+
* 一叫就醒(毫秒级);而单测可能注入一个不可打断的假 sleep。
|
|
168
|
+
* 宁可让那次后台轮询在下一轮自己发现 `shouldStop()` 并退出,也不能把用户的登录卡在这里。
|
|
169
|
+
* ⚠️ `deviceSide.promise` 内部两个分支都已 catch(不会 reject),这里 await 它不会抛。
|
|
170
|
+
*/
|
|
171
|
+
async function stopDeviceCodeFlow(deviceSide, cancelGate) {
|
|
172
|
+
if (!deviceSide.promise) return;
|
|
173
|
+
deviceSide.cancelled = true;
|
|
174
|
+
cancelGate.wakeAll();
|
|
175
|
+
await Promise.race([
|
|
176
|
+
deviceSide.promise,
|
|
177
|
+
new Promise((resolve) => {
|
|
178
|
+
const t = setTimeout(resolve, 1000);
|
|
179
|
+
if (t && typeof t.unref === 'function') t.unref();
|
|
180
|
+
}),
|
|
181
|
+
]);
|
|
182
|
+
}
|
|
183
|
+
|
|
184
|
+
/**
|
|
185
|
+
* 两条路都没走通时的报错 —— 回调没等到 + 设备码又失败。
|
|
186
|
+
*
|
|
187
|
+
* ⚠️ 必须把**两件事一起说清楚**:只报设备码那条错,用户会以为"回调其实没问题",
|
|
188
|
+
* 于是又回去重跑 `login`,白等第二个 5 分钟(这是老板真机踩过的那类坑)。
|
|
189
|
+
* ⚠️ 文案里的 `本地回调没成功` / `回调侧的报错` / `设备码侧的报错` 是**契约字样**
|
|
190
|
+
* (`test/proxy-login.test.mjs`「两条路都不通」那条用例按它们断言),不要改写。
|
|
191
|
+
*/
|
|
192
|
+
function bothPathsFailedError(deviceError, reason, { loginTimeoutMs }) {
|
|
193
|
+
const callbackSide =
|
|
194
|
+
reason === 'callback_timeout'
|
|
195
|
+
? `等待授权超时(${loginTimeoutMs}ms,本机回调监听当时仍然开着)`
|
|
196
|
+
: '首轮等待没收到回调(本机回调监听当时仍然开着)';
|
|
197
|
+
return new CliError(`本地回调没成功,改用设备码也失败了:${deviceError.message}`, {
|
|
198
|
+
kind: deviceError.kind || 'device_authorization_failed',
|
|
199
|
+
code: deviceError.code === undefined ? null : deviceError.code,
|
|
200
|
+
hint: `回调侧的报错:${callbackSide};设备码侧的报错:${deviceError.message}。两条路都没走通时,先按提示修掉代理/防火墙,或让服务端确认设备码端点可用`,
|
|
201
|
+
exitCode: deviceError.exitCode === undefined ? EXIT.ERROR : deviceError.exitCode,
|
|
202
|
+
});
|
|
203
|
+
}
|
|
204
|
+
|
|
205
|
+
/**
|
|
206
|
+
* 这些错误意味着"这个设备码已经没救了"(过期/被拒/服务端没有这个能力),
|
|
207
|
+
* 此时磁盘上的待完成状态应该删掉 —— 否则用户下次 `--device-continue` 会拿着一个
|
|
208
|
+
* 注定失败的码去轮询,白等一轮。**网络类错误不在此列**(码还是好的,可以再试)。
|
|
209
|
+
*/
|
|
210
|
+
const TERMINAL_DEVICE_KINDS = new Set(['denied', 'expired', 'not_implemented', 'token_exchange']);
|
|
211
|
+
|
|
212
|
+
/* ------------------------------------------------------------------ */
|
|
213
|
+
/* login */
|
|
214
|
+
/* ------------------------------------------------------------------ */
|
|
215
|
+
|
|
216
|
+
export const loginCommand = {
|
|
217
|
+
name: 'login',
|
|
218
|
+
summary: '浏览器授权一次,把 30 天令牌存到本地(默认本地回调模式;设备码仅在显式 --device / 检测到系统代理时使用)',
|
|
219
|
+
usage:
|
|
220
|
+
'wkgeo login [--scope "site:read site:write billing:self"] [--no-browser] [--open-browser] [--client-id <id>] [--callback-port <n>] [--timeout <秒>]\n' +
|
|
221
|
+
'wkgeo login --device # 设备码模式:不需要回调地址/监听端口,给用户一个短码(兜底路径)\n' +
|
|
222
|
+
'wkgeo login --device --no-wait # ★ 只申请短码就退出(AI 端友好),稍后用下面这条领令牌\n' +
|
|
223
|
+
'wkgeo login --device-continue # 用上次保存的设备码换票、写完凭据就完成登录\n' +
|
|
224
|
+
'wkgeo login --no-auto-device # 检测到系统代理也不自动改设备码(强制回调;CLI 会警告)\n' +
|
|
225
|
+
'wkgeo login --open-browser # 强制尝试打开系统浏览器(⚠️ 现在与默认行为等价,保留只为显式语义与兼容)\n' +
|
|
226
|
+
'wkgeo login --callback-first-wait 60 # ★ 可选:显式启用"首轮等待 60 秒没回调就并行改设备码"(默认关闭;0/off = 关闭)\n' +
|
|
227
|
+
'wkgeo login --timeout 600 # 等待授权 600 秒(默认单位是秒,不是毫秒;也支持 600s / 500ms)',
|
|
228
|
+
flags: {
|
|
229
|
+
browser: { type: 'boolean', desc: '是否自动打开浏览器(★ 默认:人类终端打开;CI/管道/AI 子进程等非交互环境不打开;--no-browser 关闭)' },
|
|
230
|
+
/**
|
|
231
|
+
* ★ 2026-10-21(老板反馈:CI 里弹了浏览器):默认**只在人类终端**自动打开;
|
|
232
|
+
* 非交互/CI 环境(stdout 非 TTY / CI 环境变量 / `WKONGAI_CLI_NO_BROWSER=1`)**一律不打开**。
|
|
233
|
+
* 本开关保留只为两件事:
|
|
234
|
+
* 1. **显式语义**(终端里明确表达"我就是要弹");
|
|
235
|
+
* 2. **兼容**既有脚本(不许删)。
|
|
236
|
+
* ⚠️ 它**压不过**非交互判定(CI 里写它也不弹);与 `--no-browser` 同时出现时 `--no-browser` 优先。
|
|
237
|
+
*/
|
|
238
|
+
'open-browser': { type: 'boolean', desc: '强制尝试打开系统浏览器(⚠️ 仅在人类终端生效;CI/非交互环境仍不打开)' },
|
|
239
|
+
device: { type: 'boolean', desc: '用设备码模式(RFC 8628)代替本地回调:不需要任何回调地址,对代理/防火墙免疫(显式兜底;CLI 不会在端口失败时自动切换过来)' },
|
|
240
|
+
/**
|
|
241
|
+
* ★ 老板 2026-10-02 要的"AI 端友好路径"。
|
|
242
|
+
* 为什么做成"申请完就退出"而不是"申请完继续挂着轮询"(后者靠 JSONL 事件流也能做):
|
|
243
|
+
* AI 端是**一轮一轮**工作的 —— 一次工具调用里挂着等 10 分钟会把用户晾住、也容易撞超时。
|
|
244
|
+
* 拆成"申请"和"领取"两条命令后,中间隔多久都行,且**不需要任何长驻进程**。
|
|
245
|
+
* 两种用法都保留:交互式终端里 `login --device` 一口气跑完更省事;
|
|
246
|
+
* AI/脚本里用 `--device --no-wait` + `--device-continue`(见 README)。
|
|
247
|
+
*/
|
|
248
|
+
'no-wait': { type: 'boolean', desc: '只申请设备码并打印(短码/网址),**立即退出不轮询**;稍后用 --device-continue 领取令牌' },
|
|
249
|
+
'device-continue': { type: 'boolean', desc: '继续上一次 --no-wait/被中断的设备码登录(读取本地保存的设备码并轮询到出结果)' },
|
|
250
|
+
'auto-device': {
|
|
251
|
+
type: 'boolean',
|
|
252
|
+
desc: '检测到系统代理时自动改用设备码(**默认开**;--no-auto-device 或 WKONGAI_AUTO_DEVICE=0 关闭,关闭时会警告"代理可能吃掉回调")',
|
|
253
|
+
},
|
|
254
|
+
/**
|
|
255
|
+
* ★ 可选自愈(默认**关闭**,0.2.2 起)。
|
|
256
|
+
* 默认单位**秒**,与 `--timeout` 一致(人类写等待窗口都按秒想);
|
|
257
|
+
* `0` / `off` / `none` = 关闭(默认值就是关闭)。
|
|
258
|
+
* 环境变量 `WKONGAI_CALLBACK_FIRST_WAIT_MS` 是毫秒(与 `WKONGAI_LOGIN_TIMEOUT_MS` 同口径)。
|
|
259
|
+
*
|
|
260
|
+
* ⚠️ 2026-10-21(老板反馈):**默认不再自动改设备码** —— 不写它时无论等多久都只走回调,
|
|
261
|
+
* 超时只报错。只有显式写它,才会在首轮等待到点后并发启动设备码(显式优先)。
|
|
262
|
+
*/
|
|
263
|
+
'callback-first-wait': {
|
|
264
|
+
type: 'string',
|
|
265
|
+
desc: '★ 可选自愈(默认**关闭**,默认单位秒):显式写它才会在"首轮等待"到点后并行改用设备码继续(本地回调监听同时保留);不写它时**不会**因为等待超时自动改设备码;0/off 关闭',
|
|
266
|
+
},
|
|
267
|
+
/**
|
|
268
|
+
* 显式声明一次(`timeout` 本来就在 GLOBAL_FLAGS 里),只为让 `wkgeo login --help`
|
|
269
|
+
* 把**单位**打在用户眼前 —— 这条命令是最需要等超时的地方。
|
|
270
|
+
* 描述直接引用 `GLOBAL_FLAGS.timeout.desc`,**单一来源**,不会两处口径漂移。
|
|
271
|
+
*/
|
|
272
|
+
timeout: { type: 'string', desc: GLOBAL_FLAGS.timeout.desc },
|
|
273
|
+
},
|
|
274
|
+
/**
|
|
275
|
+
* JSON 模式下的输出形状与其它命令**不同**:它是 JSONL 事件流,因为这条命令会长时间阻塞。
|
|
276
|
+
* {"ok":true,"command":"login","stage":"awaiting_callback","authorization_url":"…"}
|
|
277
|
+
* {"ok":true,"command":"login","stage":"done","data":{…}}
|
|
278
|
+
* {"ok":false,"command":"login","stage":"failed","error":{…}}
|
|
279
|
+
* 设备码模式:
|
|
280
|
+
* {"ok":true,"command":"login","stage":"awaiting_user","user_code":"ABCD-1234","verification_uri":"…",
|
|
281
|
+
* "verification_uri_complete":"…","expires_in":600,"interval":5,"paste_text":"…"}
|
|
282
|
+
* ★ `--no-wait` 时**最后一行就是这个 `stage=awaiting_user`**(进程随即退出,不再有 done);
|
|
283
|
+
* 该行里带 `no_wait:true` / `resume_command` / `pending_file`,AI 端据此转达用户,
|
|
284
|
+
* 稍后再跑 `wkgeo login --device-continue`。
|
|
285
|
+
* 为什么不做成"一条最终 JSON":AI 端需要在**等待期间**就把网址/短码交给用户,
|
|
286
|
+
* 等 5 分钟拿到最终结果时用户早就走了。
|
|
287
|
+
*/
|
|
288
|
+
async run(ctx) {
|
|
289
|
+
const { out, config, flags } = ctx;
|
|
290
|
+
const jsonMode = out.json;
|
|
291
|
+
/** JSON 模式:人类可读文本一律走 stderr,stdout 只放机器可读事件 */
|
|
292
|
+
const log = jsonMode ? (m) => out.raw(m) : (m) => out.line(m);
|
|
293
|
+
const cmdName = config.cmdName || 'wkgeo';
|
|
294
|
+
|
|
295
|
+
/* ---- 0. 三种模式的互斥检查(用法错误 exit 2,脚本里好分辨) ---- */
|
|
296
|
+
const noWait = flags.noWait === true;
|
|
297
|
+
const wantsContinue = flags.deviceContinue === true;
|
|
298
|
+
if (noWait && wantsContinue) {
|
|
299
|
+
throw new UsageError('--no-wait 与 --device-continue 不能同时用:前者是"只申请短码就退出",后者是"去领取上次申请的短码"');
|
|
300
|
+
}
|
|
301
|
+
if (wantsContinue && flags.device === true) {
|
|
302
|
+
throw new UsageError('--device-continue 与 --device 不能同时用:--device-continue 会自动读回上次保存的设备码');
|
|
303
|
+
}
|
|
304
|
+
/**
|
|
305
|
+
* `--no-wait` **隐含**设备码模式:回调模式没有"先返回、稍后再领"这回事
|
|
306
|
+
* (授权码 5 分钟失效,而且必须由浏览器打回本地端口)。
|
|
307
|
+
* 把隐含关系写死在实现里,比要求用户同时记住两个开关更不容易用错。
|
|
308
|
+
*/
|
|
309
|
+
const wantsDevice = flags.device === true || noWait;
|
|
310
|
+
|
|
311
|
+
/** 回调模式的安全底线:只能监听回环(设备码模式不经过回调,跳过这条) */
|
|
312
|
+
if (!wantsDevice && !wantsContinue) {
|
|
313
|
+
if (config.callbackHost !== '127.0.0.1' && config.callbackHost !== 'localhost' && config.callbackHost !== '[::1]') {
|
|
314
|
+
throw new CliError(`回调地址必须监听回环(127.0.0.1 / localhost / [::1]),当前是 ${config.callbackHost}`, {
|
|
315
|
+
kind: 'usage',
|
|
316
|
+
hint: '不要用 --callback-host 绑 0.0.0.0:授权码会暴露给同网段所有人',
|
|
317
|
+
exitCode: EXIT.USAGE,
|
|
318
|
+
});
|
|
319
|
+
}
|
|
320
|
+
}
|
|
321
|
+
|
|
322
|
+
/* ---- 1. 代理检测(只有回调模式才关心:设备码不需要任何入站回调) ---- */
|
|
323
|
+
const proxyInfo = !wantsDevice && !wantsContinue ? ctx.proxyInfo() : null;
|
|
324
|
+
const proxyPayload = proxyInfo ? proxyWarningPayload(proxyInfo, { cmdName }) : null;
|
|
325
|
+
const autoDevice = resolveAutoDevice(flags, ctx.env);
|
|
326
|
+
/**
|
|
327
|
+
* ★ 可选首轮等待(默认 0 = 关闭,0.2.2 起)。
|
|
328
|
+
* 只有用户**显式**写 `--callback-first-wait` / `WKONGAI_CALLBACK_FIRST_WAIT_MS`
|
|
329
|
+
* 才会启用;`--no-auto-device` 强制 0。它**不参与**"默认走什么模式"的判断。
|
|
330
|
+
*/
|
|
331
|
+
const callbackFirstWaitMs = resolveCallbackFirstWaitMs(flags, ctx.env, { autoDevice });
|
|
332
|
+
|
|
333
|
+
/**
|
|
334
|
+
* ★★ 核心规则(2026-10-02 第二版加固):**`detected === true` 就直接走设备码**。
|
|
335
|
+
*
|
|
336
|
+
* ⚠️ 为什么不再看 `loopback_bypassed` / `risk`:真机上老板的绕过列表里**写着**
|
|
337
|
+
* `localhost;127.*`,第一版据此判"没风险"→ 走回调 → 他点了【同意授权】之后
|
|
338
|
+
* 回调请求从没到过本机,CLI 一直拿不到令牌
|
|
339
|
+
* (独立证据:`curl -x http://127.0.0.1:7890 http://127.0.0.1:1/x` → 502,
|
|
340
|
+
* 证明那台机器上的代理**会尝试接管回环请求**,绕过列表并没有真正生效)。
|
|
341
|
+
* ⇒ 结论:**"绕过列表里有 127.*"不等于绕过生效**,不同代理软件/浏览器对 bypass
|
|
342
|
+
* 的解释并不一致。宁可让用户多走一步设备码,也不能让他卡在"点了同意没反应"。
|
|
343
|
+
* 这两个字段仍然照样上报(`proxy_warning`),只是**不再作为放行回调的依据**。
|
|
344
|
+
*/
|
|
345
|
+
const proxyDetected = !!(proxyInfo && proxyInfo.detected);
|
|
346
|
+
let useDevice = wantsDevice;
|
|
347
|
+
/** 为什么会走设备码:proxy_detected / callback_first_wait(仅显式开启时) */
|
|
348
|
+
let downgradeReason = null;
|
|
349
|
+
if (!useDevice && autoDevice && proxyDetected) {
|
|
350
|
+
useDevice = true;
|
|
351
|
+
downgradeReason = 'proxy_detected';
|
|
352
|
+
}
|
|
353
|
+
|
|
354
|
+
if (downgradeReason === 'proxy_detected') {
|
|
355
|
+
// 人类模式:说清楚"为什么改了、怎么改回去"(AI 端看 proxy_warning 结构化字段)
|
|
356
|
+
for (const line of proxyDeviceSwitchLines(proxyInfo, { cmdName })) log(line);
|
|
357
|
+
} else if (!wantsDevice && !wantsContinue && !useDevice && proxyDetected) {
|
|
358
|
+
/**
|
|
359
|
+
* 走到这里只有一种情况:用户**显式**要求坚持回调模式(--no-auto-device / WKONGAI_AUTO_DEVICE=0)。
|
|
360
|
+
* ⚠️ 必须明确警告:否则他唯一的下场就是"点了同意,然后干等到超时",
|
|
361
|
+
* 而他会以为是 CLI 坏了(这正是老板真机上遇到的那个现象)。
|
|
362
|
+
*/
|
|
363
|
+
for (const line of proxyForcedCallbackLines(proxyInfo, { cmdName })) log(line);
|
|
364
|
+
}
|
|
365
|
+
|
|
366
|
+
/** 把运行期注入的依赖透传给两条登录流程(测试要能离线跑,见 runtime.mjs 的说明) */
|
|
367
|
+
const loginDeps = {
|
|
368
|
+
fetchImpl: ctx.fetchImpl,
|
|
369
|
+
now: ctx.now,
|
|
370
|
+
sleep: ctx.sleep,
|
|
371
|
+
// `--no-browser` → false;否则用注入的(测试)或默认的真·打开浏览器
|
|
372
|
+
openBrowser: flags.browser === false ? false : ctx.openBrowser,
|
|
373
|
+
/** 真 spawn 的注入点(单测验证"AI 场景一次都不 spawn 浏览器";生产不传 = 真 spawn) */
|
|
374
|
+
spawnImpl: ctx.spawnImpl,
|
|
375
|
+
/**
|
|
376
|
+
* ★★ 「要不要替用户弹**系统**浏览器」的输入(2026-10-21 起含 CI/非交互检测):
|
|
377
|
+
* * `isTTY` —— stdout 是不是终端(由 runtime 从 stdout.isTTY 读出,命令层原样透传);
|
|
378
|
+
* * `json` —— 是不是 JSON 输出(`--json` 或非 TTY 自动 JSON);
|
|
379
|
+
* * `forceBrowser` —— 用户写了 `--open-browser`(只在终端里保留显式语义);
|
|
380
|
+
* * `noBrowser` —— 用户写了 `--no-browser`(**最高优先级**的"不打开"开关);
|
|
381
|
+
* * `env` —— CI 环境变量判定(`CI` / `GITHUB_ACTIONS`… / `WKONGAI_CLI_NO_BROWSER=1`)。
|
|
382
|
+
* 全部进 `resolveBrowserIntent()`(login.mjs 里的**唯一裁决点**):
|
|
383
|
+
* **人在终端默认打开**;`--no-browser` 与**非交互/CI**都不打开(`attempted:false`);
|
|
384
|
+
* 非交互时还会打印"把链接转给有浏览器的用户 / 改用 `--device`"的提示。
|
|
385
|
+
* ⚠️ 回调模式与设备码模式都吃这一份 deps —— 所以两条授权路径的行为天然一致。
|
|
386
|
+
*/
|
|
387
|
+
isTTY: ctx.isTTY === true,
|
|
388
|
+
json: ctx.out.json === true,
|
|
389
|
+
forceBrowser: flags.openBrowser === true,
|
|
390
|
+
noBrowser: flags.browser === false,
|
|
391
|
+
/** ★ CI / 非交互判定用(纯函数在 login.mjs 的 detectNonInteractive) */
|
|
392
|
+
env: ctx.env || {},
|
|
393
|
+
platform: ctx.platform,
|
|
394
|
+
/**
|
|
395
|
+
* ★ 可选首轮等待(见上面 `callbackFirstWaitMs`)。
|
|
396
|
+
*
|
|
397
|
+
* ⚠️⚠️ 0.2.2 起**默认 0 = 关闭**(老板 2026-10-21 反馈):
|
|
398
|
+
* * 不写 `--callback-first-wait` / 环境变量 → 0,一直等满 `--timeout`,**不会**自动改设备码;
|
|
399
|
+
* * 显式写 `--callback-first-wait <秒>` / `WKONGAI_CALLBACK_FIRST_WAIT_MS` → 照旧启用;
|
|
400
|
+
* * `--no-auto-device` → 强制 0(用户明确要求只走回调,就不能偷偷改道)。
|
|
401
|
+
*/
|
|
402
|
+
callbackFirstWaitMs,
|
|
403
|
+
/**
|
|
404
|
+
* ★★ 设备码先成功后,本地回调监听再多留多久(毫秒;0 = 立刻收尾)。
|
|
405
|
+
* 生产不传 = `login.mjs` 的 `DEFAULT_POST_DEVICE_GRACE_MS`;
|
|
406
|
+
* 单测可注入一个小值,确定性地验证"迟到的回调拿到已完成页"。
|
|
407
|
+
*/
|
|
408
|
+
postDeviceGraceMs: ctx.postDeviceGraceMs,
|
|
409
|
+
};
|
|
410
|
+
|
|
411
|
+
/**
|
|
412
|
+
* ★ 默认模式的正面说明(老板 2026-10-21 反馈的直接回应)。
|
|
413
|
+
*
|
|
414
|
+
* 老板原话:「默认的也不应该是设备授权,默认的就是那个传统的授权方式(浏览器打开授权页 +
|
|
415
|
+
* 本地 localhost 回调)。设备码是本地读不了/代理时才用的。」
|
|
416
|
+
* ⇒ 这里明说"本次就是回调、等多久都不会自动改设备码",同时列出**唯一会走设备码**的两种情况,
|
|
417
|
+
* 并给出"主动提前切换"的显式开关,免得用户以为 CLI 背着他改道。
|
|
418
|
+
* ⚠️ 只在"回调模式 + 没检测到代理 + 没显式开首轮等待"时打:其它情况一律不打(正常环境不要噪音)。
|
|
419
|
+
*/
|
|
420
|
+
if (!useDevice && !wantsContinue && !proxyDetected && callbackFirstWaitMs === 0) {
|
|
421
|
+
log(
|
|
422
|
+
`ℹ️ 未检测到系统代理:本次使用浏览器回调授权(默认),会一直等你完成授权(最多 ${Math.round(config.loginTimeoutMs / 1000)} 秒)。`,
|
|
423
|
+
);
|
|
424
|
+
log(
|
|
425
|
+
' 不会因为"首轮等待/等待超时"到点就自动改用设备码;只有显式 `--device` 或检测到系统代理时才会用设备码' +
|
|
426
|
+
'(`--no-auto-device` 可关掉代理这一种自动切换)。',
|
|
427
|
+
);
|
|
428
|
+
log(
|
|
429
|
+
' (本地回调端口起不来会**如实报错**并建议 `--device`,不会静默换模式;想主动提前切换:`--callback-first-wait <秒>`。)',
|
|
430
|
+
);
|
|
431
|
+
}
|
|
432
|
+
|
|
433
|
+
/**
|
|
434
|
+
* 设备码事件的统一构造(人类提示在 announceDeviceCode 里打;这里只负责机器可读那一份)。
|
|
435
|
+
* ⚠️ `user_action_required` 是**给 AI 端直接用的话术**:AI 不该自己组织语言,
|
|
436
|
+
* 照着念就不会漏掉网址或短码。
|
|
437
|
+
*/
|
|
438
|
+
const deviceEvent = (info, extra = {}) => {
|
|
439
|
+
if (!jsonMode) return;
|
|
440
|
+
out.event({
|
|
441
|
+
ok: true,
|
|
442
|
+
command: 'login',
|
|
443
|
+
mode: 'device',
|
|
444
|
+
stage: 'awaiting_user',
|
|
445
|
+
...info,
|
|
446
|
+
...extra,
|
|
447
|
+
user_action_required: `请让用户访问 ${info.open_url}${info.verification_uri_complete ? '' : ` 并输入短码 ${info.user_code}`}`,
|
|
448
|
+
});
|
|
449
|
+
};
|
|
450
|
+
const deviceDeps = (extraEvent = {}) => ({ ...loginDeps, onDeviceCode: (info) => deviceEvent(info, extraEvent) });
|
|
451
|
+
|
|
452
|
+
const pendingFile = pendingDeviceFile(config.credentialsFile);
|
|
453
|
+
/** 申请到码之后立刻落盘:进程被 Ctrl+C / 终端被关掉,用户还能用 --device-continue 续上 */
|
|
454
|
+
const savePending = (device) => {
|
|
455
|
+
try {
|
|
456
|
+
savePendingDevice(pendingFile, { ...device, base: config.base, client_id: config.clientId });
|
|
457
|
+
return true;
|
|
458
|
+
} catch (e) {
|
|
459
|
+
// 落盘失败**不影响本次授权**(只是失去"稍后续跑"的能力),所以只提示不抛
|
|
460
|
+
log(`⚠️ 无法保存待完成的设备码状态(不影响本次授权,只是不能稍后用 --device-continue 续跑):${e.message}`);
|
|
461
|
+
return false;
|
|
462
|
+
}
|
|
463
|
+
};
|
|
464
|
+
|
|
465
|
+
let result = null;
|
|
466
|
+
|
|
467
|
+
/* ---- 2a. `--device-continue`:续跑上次没等完的设备码 ---- */
|
|
468
|
+
if (wantsContinue) {
|
|
469
|
+
const pending = readPendingDevice(pendingFile);
|
|
470
|
+
if (!pending) {
|
|
471
|
+
throw new CliError('本地没有待完成的设备码登录', {
|
|
472
|
+
kind: 'device_state',
|
|
473
|
+
hint: `先运行 \`${cmdName} login --device --no-wait\`(或直接 \`${cmdName} login --device\`)申请一个短码`,
|
|
474
|
+
exitCode: EXIT.USAGE,
|
|
475
|
+
});
|
|
476
|
+
}
|
|
477
|
+
/**
|
|
478
|
+
* ⚠️ 设备码只对**当初申请它的那个服务端**有效。用户中途换了 `--base`(换了环境)时,
|
|
479
|
+
* 拿旧码去新环境轮询必然失败,不如在这里把话说明白。
|
|
480
|
+
*/
|
|
481
|
+
if (pending.base && pending.base !== config.base) {
|
|
482
|
+
throw new CliError(`这份设备码是为 \`${pending.base}\` 申请的,与当前的 \`${config.base}\` 不一致`, {
|
|
483
|
+
kind: 'device_state',
|
|
484
|
+
hint: `用同一个 --base 重试,或重新运行 \`${cmdName} login --device\``,
|
|
485
|
+
exitCode: EXIT.USAGE,
|
|
486
|
+
});
|
|
487
|
+
}
|
|
488
|
+
if (isPendingExpired(pending, { now: ctx.now() })) {
|
|
489
|
+
deletePendingDevice(pendingFile);
|
|
490
|
+
throw pendingExpiredError(pendingFile);
|
|
491
|
+
}
|
|
492
|
+
log(`继续上一次的设备码登录:短码 ${pending.user_code}`);
|
|
493
|
+
log(` (如果浏览器已经关掉了:${pending.open_url})`);
|
|
494
|
+
try {
|
|
495
|
+
result = await pollDeviceToken({ config, log, deps: loginDeps, device: pending });
|
|
496
|
+
deletePendingDevice(pendingFile);
|
|
497
|
+
useDevice = true;
|
|
498
|
+
} catch (e) {
|
|
499
|
+
if (TERMINAL_DEVICE_KINDS.has(e.kind)) {
|
|
500
|
+
try {
|
|
501
|
+
deletePendingDevice(pendingFile);
|
|
502
|
+
} catch {
|
|
503
|
+
/* 删不掉不影响主流程:报错本身才是用户要看的 */
|
|
504
|
+
}
|
|
505
|
+
}
|
|
506
|
+
throw e;
|
|
507
|
+
}
|
|
508
|
+
}
|
|
509
|
+
|
|
510
|
+
/* ---- 2b. 设备码模式(等待式,或 --no-wait 只申请) ---- */
|
|
511
|
+
if (!result && useDevice) {
|
|
512
|
+
try {
|
|
513
|
+
const device = await requestDeviceCode({ config, deps: loginDeps });
|
|
514
|
+
savePending(device);
|
|
515
|
+
if (noWait) {
|
|
516
|
+
/**
|
|
517
|
+
* ★ AI 端友好路径:打印完就退出(不轮询)。
|
|
518
|
+
* `extra` 同时进"机器可读事件"和"人类可读提示",两处口径同源。
|
|
519
|
+
*/
|
|
520
|
+
const extra = {
|
|
521
|
+
no_wait: true,
|
|
522
|
+
pending_file: pendingFile,
|
|
523
|
+
resume_command: `${cmdName} login --device-continue`,
|
|
524
|
+
expires_at: new Date(device.expires_at).toISOString(),
|
|
525
|
+
proxy_warning: proxyPayload,
|
|
526
|
+
logged_in: false,
|
|
527
|
+
next_step:
|
|
528
|
+
'请让用户在**自己的浏览器**里打开上面的网址并点「同意」(AI 端无法代点:device_confirm 需要用户自己的登录会话);' +
|
|
529
|
+
`然后运行 \`${cmdName} login --device-continue\` 领取令牌`,
|
|
530
|
+
};
|
|
531
|
+
announceDeviceCode({ config, log, deps: deviceDeps(extra), device });
|
|
532
|
+
if (!jsonMode) {
|
|
533
|
+
out.line('');
|
|
534
|
+
out.info(`⏸ 已申请短码并退出(--no-wait)。用户点完「同意」后,运行 \`${cmdName} login --device-continue\` 领取令牌。`);
|
|
535
|
+
out.info(` 短码有效期约 ${Math.round(device.expires_in / 60)} 分钟;过期就重新运行 \`${cmdName} login --device --no-wait\`。`);
|
|
536
|
+
}
|
|
537
|
+
return {
|
|
538
|
+
mode: 'device',
|
|
539
|
+
stage: 'awaiting_user',
|
|
540
|
+
...extra,
|
|
541
|
+
user_code: device.user_code,
|
|
542
|
+
verification_uri: device.verification_uri,
|
|
543
|
+
verification_uri_complete: device.verification_uri_complete,
|
|
544
|
+
open_url: device.open_url,
|
|
545
|
+
paste_text: devicePasteText(device),
|
|
546
|
+
expires_in: device.expires_in,
|
|
547
|
+
interval: device.interval,
|
|
548
|
+
credentials_file: config.credentialsFile,
|
|
549
|
+
client_id: config.clientId,
|
|
550
|
+
};
|
|
551
|
+
}
|
|
552
|
+
announceDeviceCode({ config, log, deps: deviceDeps({ no_wait: false, proxy_warning: proxyPayload }), device });
|
|
553
|
+
try {
|
|
554
|
+
result = await pollDeviceToken({ config, log, deps: loginDeps, device });
|
|
555
|
+
deletePendingDevice(pendingFile);
|
|
556
|
+
} catch (e) {
|
|
557
|
+
if (TERMINAL_DEVICE_KINDS.has(e.kind)) {
|
|
558
|
+
try {
|
|
559
|
+
deletePendingDevice(pendingFile);
|
|
560
|
+
} catch {
|
|
561
|
+
/* 同上:删不掉不影响主流程 */
|
|
562
|
+
}
|
|
563
|
+
}
|
|
564
|
+
throw e;
|
|
565
|
+
}
|
|
566
|
+
} catch (e) {
|
|
567
|
+
/**
|
|
568
|
+
* 自动降级时设备码端点却不可用(服务端缺口/形状不对)→ **老老实实回落回调模式**,
|
|
569
|
+
* 而不是把用户堵死。只有"我们自己主动改道"(autoReason 存在)且用户没显式要设备码时才回落;
|
|
570
|
+
* 显式 `--device` 的失败必须原样报出来(用户要的就是设备码,别替他做别的决定)。
|
|
571
|
+
*/
|
|
572
|
+
const canFallback =
|
|
573
|
+
downgradeReason === 'proxy_detected' && !wantsDevice && (e.kind === 'not_implemented' || e.kind === 'device_authorization_failed');
|
|
574
|
+
if (!canFallback) throw e;
|
|
575
|
+
log(`⚠️ 设备码模式当前不可用(${e.message}),回落到本地回调模式继续…`);
|
|
576
|
+
useDevice = false;
|
|
577
|
+
downgradeReason = null;
|
|
578
|
+
}
|
|
579
|
+
}
|
|
580
|
+
|
|
581
|
+
/* ---- 2c. 本地回调模式(默认路径;显式首轮等待时才与设备码两条路并存) ---- */
|
|
582
|
+
if (!result && !useDevice) {
|
|
583
|
+
/**
|
|
584
|
+
* ★★ 2026-10-03(老板真机反馈 ⚠️):显式开启的"首轮等待"到点改道时**不再关掉本地回调监听**。
|
|
585
|
+
*
|
|
586
|
+
* ## 旧行为(真机证据:ERR_CONNECTION_REFUSED)
|
|
587
|
+
* 首轮等待到点 → `runLogin` 抛错,并在自己的 `finally` 里**关掉本地 server** → 命令层再走设备码。
|
|
588
|
+
* 于是用户**之后**才点【同意授权】时,浏览器跳到
|
|
589
|
+
* `http://127.0.0.1:<port>/callback?code=…` → **ERR_CONNECTION_REFUSED**
|
|
590
|
+
* (老板真机截图见过)→ 用户以为授权失败,再来一遍(而其实他马上就会登录成功)。
|
|
591
|
+
*
|
|
592
|
+
* ## 新行为(仅显式 `--callback-first-wait` 时):两条路**并存**,哪个先拿到令牌就用哪个
|
|
593
|
+
* * 回调那条路:本地 server 一直开着(`runLogin` 收到 `handoff` 时到点**不结束等待**);
|
|
594
|
+
* * 设备码那条路:由下面的 `handoff.onSwitch` 启动,轮询到出结果为止。
|
|
595
|
+
* * 回调先成功 → 把设备码那条路**优雅停掉**(唤醒它挂着的 sleep + 删掉待完成状态文件);
|
|
596
|
+
* * 设备码先成功 → `finishWithDevice()` 让回调那条路收尾(监听再多留几秒,
|
|
597
|
+
* 迟到的回调会拿到"本次登录已经完成"的页面,见 login.mjs / page.mjs)。
|
|
598
|
+
* ★ 0.2.2 起默认**不启用**这套交接(`--callback-first-wait` 未显式给出时
|
|
599
|
+
* `callbackFirstWaitMs === 0`):默认就是一路等回调,超时只报错。
|
|
600
|
+
*/
|
|
601
|
+
/** 允许"等待到点改道"吗:只有用户**显式**开了首轮等待,且没写 --no-auto-device、不是显式设备码模式 */
|
|
602
|
+
const mayAutoSwitch = autoDevice && !wantsDevice && !wantsContinue && callbackFirstWaitMs > 0;
|
|
603
|
+
/** 设备码那条路的可取消状态(回调先赢时要把它收拾干净) */
|
|
604
|
+
const deviceSide = { reason: null, cancelled: false, promise: null, result: null, error: null };
|
|
605
|
+
/** ★ 可被立刻叫醒的 sleep:回调先赢时,不能让设备码那个 5 秒定时器把进程吊住 */
|
|
606
|
+
const cancelGate = createCancelGate(loginDeps.sleep);
|
|
607
|
+
/** 交接面:两边各填一半(`onSwitch` 由这里填,另两个由 runLogin 填;见 login.mjs 的 deps 说明) */
|
|
608
|
+
const handoff = { onSwitch: null, finishWithDevice: null, abort: null };
|
|
609
|
+
|
|
610
|
+
const runDeviceCodeFlow = async () => {
|
|
611
|
+
const device = await requestDeviceCode({ config, deps: loginDeps });
|
|
612
|
+
// 回调那条路已经赢了 → 一个用户可见的动作都不要再做(不打印短码、不弹浏览器、不落盘)
|
|
613
|
+
if (deviceSide.cancelled) throw deviceStoppedError();
|
|
614
|
+
savePending(device);
|
|
615
|
+
if (deviceSide.cancelled) throw deviceStoppedError();
|
|
616
|
+
announceDeviceCode({ config, log, deps: deviceDeps({ no_wait: false, proxy_warning: proxyPayload }), device });
|
|
617
|
+
return pollDeviceToken({
|
|
618
|
+
config,
|
|
619
|
+
log,
|
|
620
|
+
deps: {
|
|
621
|
+
...loginDeps,
|
|
622
|
+
sleep: cancelGate.sleep,
|
|
623
|
+
/** device.mjs 支持它:另一条路赢了就立刻停止轮询(不写凭据、不报错) */
|
|
624
|
+
shouldStop: () => deviceSide.cancelled,
|
|
625
|
+
},
|
|
626
|
+
device,
|
|
627
|
+
});
|
|
628
|
+
};
|
|
629
|
+
|
|
630
|
+
if (mayAutoSwitch) {
|
|
631
|
+
handoff.onSwitch = (reason) => {
|
|
632
|
+
deviceSide.reason = reason;
|
|
633
|
+
/**
|
|
634
|
+
* ⚠️ 这里**不 await**、也**不抛错**:交接只需把设备码那条路点起来。
|
|
635
|
+
* 成功 → `finishWithDevice` 让回调流程带着这份结果收尾(监听留 grace);
|
|
636
|
+
* 失败 → `abort` 让回调流程用"两条路都不通"的错误结束(用户要看的是真原因)。
|
|
637
|
+
*/
|
|
638
|
+
deviceSide.promise = runDeviceCodeFlow().then(
|
|
639
|
+
(res) => {
|
|
640
|
+
deviceSide.result = res;
|
|
641
|
+
if (typeof handoff.finishWithDevice === 'function') handoff.finishWithDevice(res);
|
|
642
|
+
},
|
|
643
|
+
(e2) => {
|
|
644
|
+
deviceSide.error = e2;
|
|
645
|
+
/**
|
|
646
|
+
* ★ 两条路都没成:把**两边的报错**合起来抛(只报设备码那条错,用户会以为
|
|
647
|
+
* "回调其实没问题"、又回去白等一轮 —— 见 bothPathsFailedError 的注释)。
|
|
648
|
+
* ⚠️ 同时存一份到 `deviceSide.combinedError`:万一回调那条路**抢先**抛了自己的错
|
|
649
|
+
* (例如用户在这一刻点了「拒绝」),下面 catch 里也要优先把"两条路都不通"报出来。
|
|
650
|
+
*/
|
|
651
|
+
deviceSide.combinedError = bothPathsFailedError(e2, reason, { loginTimeoutMs: config.loginTimeoutMs });
|
|
652
|
+
if (typeof handoff.abort === 'function') handoff.abort(deviceSide.combinedError);
|
|
653
|
+
},
|
|
654
|
+
);
|
|
655
|
+
};
|
|
656
|
+
}
|
|
657
|
+
|
|
658
|
+
try {
|
|
659
|
+
result = await runLogin({
|
|
660
|
+
config,
|
|
661
|
+
log,
|
|
662
|
+
deps: {
|
|
663
|
+
...loginDeps,
|
|
664
|
+
/** 超时时要把"代理可能是元凶"写进错误 hint(见 login.mjs 的 timeout 分支) */
|
|
665
|
+
proxyRisk: proxyInfo,
|
|
666
|
+
/** ★★ 两条路并存的交接面(未启用自动改道时 `onSwitch` 为 null ⇒ runLogin 走旧契约) */
|
|
667
|
+
handoff,
|
|
668
|
+
onAuthorizationUrl: (url, extra) => {
|
|
669
|
+
if (jsonMode) {
|
|
670
|
+
/**
|
|
671
|
+
* ★ 非交互(CI / 管道 / AI 子进程)时**不会**自动打开浏览器 ⇒ 给 AI/脚本的
|
|
672
|
+
* `user_action_required` 必须换成"把链接转给有浏览器的人 / 改用设备码",
|
|
673
|
+
* 否则调用方会以为"浏览器已经弹出来了",只让用户干等。
|
|
674
|
+
*/
|
|
675
|
+
const nonInteractive = !!(extra && extra.open_browser && extra.open_browser.skipped_reason === 'non_interactive');
|
|
676
|
+
out.event({
|
|
677
|
+
ok: true,
|
|
678
|
+
command: 'login',
|
|
679
|
+
mode: 'callback',
|
|
680
|
+
stage: 'awaiting_callback',
|
|
681
|
+
authorization_url: url,
|
|
682
|
+
user_action_required: nonInteractive
|
|
683
|
+
? '本机是非交互环境(CI/管道/AI 子进程),不会自动打开浏览器:请把 authorization_url 转给有浏览器的用户打开;若本机无法接收回调,改用 `wkgeo login --device`(设备码模式)'
|
|
684
|
+
: '请让用户在浏览器中打开上面的 authorization_url,登录并点「同意」',
|
|
685
|
+
proxy_warning: proxyPayload,
|
|
686
|
+
...extra,
|
|
687
|
+
});
|
|
688
|
+
}
|
|
689
|
+
},
|
|
690
|
+
},
|
|
691
|
+
});
|
|
692
|
+
} catch (e) {
|
|
693
|
+
/** ★ 无论怎么失败,都先把设备码那条路收拾干净(不能留一个还在轮询的后台任务) */
|
|
694
|
+
await stopDeviceCodeFlow(deviceSide, cancelGate);
|
|
695
|
+
/** 设备码那条路也失败了 ⇒ 优先报"两条路都不通"(哪怕回调那边先抛了自己的错) */
|
|
696
|
+
if (deviceSide.combinedError) throw deviceSide.combinedError;
|
|
697
|
+
/**
|
|
698
|
+
* ★★ 0.2.4(2026-10-21 老板真机反馈):**bind 失败不再静默改走设备码**。
|
|
699
|
+
*
|
|
700
|
+
* 旧行为(0.2.2~0.2.3):本地回调端口起不来 → 命令层自动申请设备码继续授权。
|
|
701
|
+
* 现场问题是:用户明明要的是"本地服务 + 浏览器回调",CLI 却在他不知情时换了
|
|
702
|
+
* 另一套授权协议(设备码),127.0.0.1 回调页始终没有出现,看起来就是"本地服务
|
|
703
|
+
* 没启动、浏览器也没东西可打开"。
|
|
704
|
+
*
|
|
705
|
+
* 新口径:**如实失败**,把 `--device` 作为明确的下一步建议交给用户/调用方
|
|
706
|
+
* (`runLogin` 抛的 `kind:"listen"` 错误 hint 里已经写了)。
|
|
707
|
+
* 设备码只在这两种情况下出现:用户显式 `--device` / 检测到系统代理。
|
|
708
|
+
*/
|
|
709
|
+
throw e;
|
|
710
|
+
}
|
|
711
|
+
|
|
712
|
+
if (deviceSide.reason) {
|
|
713
|
+
/**
|
|
714
|
+
* ⚠️ 判定"谁赢了"用**凭据对象的同一性**:`runLogin` 返回时会 `{...result}` 复制一层外壳
|
|
715
|
+
* (见 login.mjs 的返回值),所以比较外层对象会永远不相等;
|
|
716
|
+
* 而 `credentials` 是那一层里原样带出来的同一个对象,用它判定既准确又同步。
|
|
717
|
+
*/
|
|
718
|
+
if (deviceSide.result && result.credentials === deviceSide.result.credentials) {
|
|
719
|
+
/**
|
|
720
|
+
* ★ 设备码那条路**先**成功:`runLogin` 已经把回调那条路收尾(监听再留一小会儿给迟到的回调),
|
|
721
|
+
* 这里只要把"最终模式/原因"如实记下来。
|
|
722
|
+
*/
|
|
723
|
+
useDevice = true;
|
|
724
|
+
// 0.2.2 起整段超时不再交接,`deviceSide.reason` 只可能是显式首轮等待
|
|
725
|
+
downgradeReason = 'callback_first_wait';
|
|
726
|
+
} else {
|
|
727
|
+
/**
|
|
728
|
+
* ★ 回调那条路**先**成功(本次修复的核心价值:用户后来点的那次【同意】真的换到了令牌)
|
|
729
|
+
* ⇒ 把设备码那条路立刻停掉,并给用户一句说明(免得他再去浏览器里确认一个作废的短码)。
|
|
730
|
+
*/
|
|
731
|
+
deviceSide.cancelled = true;
|
|
732
|
+
cancelGate.wakeAll();
|
|
733
|
+
await stopDeviceCodeFlow(deviceSide, cancelGate);
|
|
734
|
+
deletePendingDevice(pendingFile);
|
|
735
|
+
log('ℹ️ 本地回调已经拿到令牌:设备码那条路已停止(刚才那个短码作废,不用再去浏览器里确认)。');
|
|
736
|
+
}
|
|
737
|
+
}
|
|
738
|
+
}
|
|
739
|
+
|
|
740
|
+
const account = result.account || null;
|
|
741
|
+
const creds = result.credentials;
|
|
742
|
+
const data = {
|
|
743
|
+
account,
|
|
744
|
+
mode: useDevice ? 'device' : 'callback',
|
|
745
|
+
client_id: creds.client_id,
|
|
746
|
+
scope: creds.scope,
|
|
747
|
+
expires_at: creds.expires_at,
|
|
748
|
+
token_ttl_seconds: result.tokenTtlSeconds || creds.expires_in || result.metadata?.access_token_ttl_seconds || null,
|
|
749
|
+
on_token_expiry: result.onTokenExpiry || result.metadata?.on_token_expiry || null,
|
|
750
|
+
credentials_file: config.credentialsFile,
|
|
751
|
+
file_mode: result.mode && result.mode.supported ? result.mode.modeText : '无法判断(Windows)',
|
|
752
|
+
redirect_uri: result.redirectUri || null,
|
|
753
|
+
user_code: result.user_code || null,
|
|
754
|
+
verification_uri: result.verification_uri || null,
|
|
755
|
+
paste_text: result.paste_text || null,
|
|
756
|
+
poll_attempts: result.poll_attempts ?? null,
|
|
757
|
+
logged_in: true,
|
|
758
|
+
/** ★ 结构化告知"本机代理情况"与"是否因此改道",AI 端不用去猜 */
|
|
759
|
+
proxy_warning: proxyPayload,
|
|
760
|
+
auto_device: downgradeReason ? { applied: true, reason: downgradeReason } : { applied: false, reason: null },
|
|
761
|
+
};
|
|
762
|
+
|
|
763
|
+
if (jsonMode) {
|
|
764
|
+
// 保持 JSONL:stage=done 是最后一行
|
|
765
|
+
out.event({ ok: true, command: 'login', stage: 'done', data });
|
|
766
|
+
} else {
|
|
767
|
+
out.line('');
|
|
768
|
+
out.ok(`✅ 授权成功,已登录:${account && (account.email || account.name) ? account.email || account.name : '(账号信息未取到)'}`);
|
|
769
|
+
if (account && account.sub) out.line(` 用户 ID:${account.sub}`);
|
|
770
|
+
out.line(` 能力范围:${creds.scope}`);
|
|
771
|
+
out.line(` 令牌有效期:${creds.expires_in ? `${Math.round(creds.expires_in / 86400)} 天` : '未知'}(到期时间 ${formatTime(creds.expires_at)})`);
|
|
772
|
+
out.line(` 凭据文件:${config.credentialsFile}(权限 ${data.file_mode})`);
|
|
773
|
+
out.info(' 令牌本身不会显示在任何输出里(安全约定)。');
|
|
774
|
+
if (useDevice && data.user_code) out.info(` 设备码模式:本次短码 ${data.user_code} 已作废,不能再用于下一次授权。`);
|
|
775
|
+
if (downgradeReason === 'proxy_detected')
|
|
776
|
+
out.info(' (本次因"检测到系统代理"自动改用了设备码模式:不再依赖 127.0.0.1 回调,绕过列表写了什么也不作依据。)');
|
|
777
|
+
if (downgradeReason === 'callback_first_wait')
|
|
778
|
+
out.info(' (已按显式 --callback-first-wait:首轮等待没收到回调,已自动改用设备码模式完成登录。)');
|
|
779
|
+
}
|
|
780
|
+
return data;
|
|
781
|
+
},
|
|
782
|
+
};
|
|
783
|
+
|
|
784
|
+
/* ------------------------------------------------------------------ */
|
|
785
|
+
/* logout */
|
|
786
|
+
/* ------------------------------------------------------------------ */
|
|
787
|
+
|
|
788
|
+
export const logoutCommand = {
|
|
789
|
+
name: 'logout',
|
|
790
|
+
summary: '删除本地凭据(默认还会调用服务端吊销接口作废该令牌)',
|
|
791
|
+
usage: 'wkgeo logout [--local-only]',
|
|
792
|
+
flags: {
|
|
793
|
+
'local-only': { type: 'boolean', desc: '只删本地文件,不调服务端吊销接口' },
|
|
794
|
+
},
|
|
795
|
+
async run(ctx) {
|
|
796
|
+
const { out, config, flags, api } = ctx;
|
|
797
|
+
const creds = readCredentials(config.credentialsFile);
|
|
798
|
+
if (!creds) {
|
|
799
|
+
out.warn('本地本来就没有凭据(未登录)');
|
|
800
|
+
const data = { removed: false, revoked_remote: false, credentials_file: config.credentialsFile };
|
|
801
|
+
ctx.done(data);
|
|
802
|
+
return data;
|
|
803
|
+
}
|
|
804
|
+
|
|
805
|
+
let revoke = { ok: false, reason: '已按要求跳过(--local-only)' };
|
|
806
|
+
if (flags.localOnly !== true) {
|
|
807
|
+
revoke = await api.revoke(creds.access_token);
|
|
808
|
+
}
|
|
809
|
+
const removed = deleteCredentials(config.credentialsFile);
|
|
810
|
+
const data = {
|
|
811
|
+
removed,
|
|
812
|
+
revoked_remote: revoke.ok === true,
|
|
813
|
+
revoke_error: revoke.ok ? null : revoke.reason || null,
|
|
814
|
+
credentials_file: config.credentialsFile,
|
|
815
|
+
client_id: creds.client_id,
|
|
816
|
+
};
|
|
817
|
+
|
|
818
|
+
if (revoke.ok) out.ok('服务端令牌已吊销');
|
|
819
|
+
else out.warn(`未能吊销服务端令牌(${revoke.reason || '未知原因'})—— 本地凭据已删除,登录态在本机已清除`);
|
|
820
|
+
if (removed) out.ok(`本地凭据已删除:${config.credentialsFile}`);
|
|
821
|
+
ctx.done(data);
|
|
822
|
+
return data;
|
|
823
|
+
},
|
|
824
|
+
};
|
|
825
|
+
|
|
826
|
+
/* ------------------------------------------------------------------ */
|
|
827
|
+
/* whoami */
|
|
828
|
+
/* ------------------------------------------------------------------ */
|
|
829
|
+
|
|
830
|
+
export const whoamiCommand = {
|
|
831
|
+
name: 'whoami',
|
|
832
|
+
summary: '显示当前登录的是谁(只显示账号标识,绝不打印令牌)',
|
|
833
|
+
usage: 'wkgeo whoami [--verbose]',
|
|
834
|
+
async run(ctx) {
|
|
835
|
+
const { out, config, flags, api } = ctx;
|
|
836
|
+
const creds = ctx.requireAuth();
|
|
837
|
+
const info = await api.userinfo(creds.access_token);
|
|
838
|
+
|
|
839
|
+
const data = {
|
|
840
|
+
account: {
|
|
841
|
+
user_id: info.sub || null,
|
|
842
|
+
email: info.email || null,
|
|
843
|
+
nickname: info.name || null,
|
|
844
|
+
},
|
|
845
|
+
client_id: creds.client_id,
|
|
846
|
+
scope: creds.scope,
|
|
847
|
+
obtained_at: creds.obtained_at || null,
|
|
848
|
+
expires_at: creds.expires_at || null,
|
|
849
|
+
expires_in_ms: creds.expires_at ? new Date(creds.expires_at).getTime() - ctx.now() : null,
|
|
850
|
+
credentials_file: config.credentialsFile,
|
|
851
|
+
logged_in: true,
|
|
852
|
+
};
|
|
853
|
+
if (flags.verbose) {
|
|
854
|
+
// 掩码是**允许**的(前 6 位 + 长度,抄不走),完整令牌永远不出现
|
|
855
|
+
data.token_masked = maskToken(creds.access_token);
|
|
856
|
+
const mode = checkFileMode(config.credentialsFile);
|
|
857
|
+
data.file_mode = mode.supported ? mode.modeText : '无法判断(Windows)';
|
|
858
|
+
data.file_mode_too_open = mode.supported ? !!mode.tooOpen : null;
|
|
859
|
+
}
|
|
860
|
+
|
|
861
|
+
if (!out.json) {
|
|
862
|
+
out.head('当前登录身份');
|
|
863
|
+
out.line(` 账号:${data.account.email || data.account.nickname || '(服务端未返回账号标识)'}`);
|
|
864
|
+
out.line(` 用户 ID:${data.account.user_id || '-'}`);
|
|
865
|
+
out.line(` 应用(client_id):${data.client_id}`);
|
|
866
|
+
out.line(` 能力范围:${data.scope}`);
|
|
867
|
+
out.line(` 令牌到期:${formatTime(data.expires_at)}(${formatRemaining(data.expires_in_ms)})`);
|
|
868
|
+
out.line(` 凭据文件:${data.credentials_file}`);
|
|
869
|
+
if (flags.verbose) {
|
|
870
|
+
out.line(` 令牌(掩码):${data.token_masked}`);
|
|
871
|
+
out.line(` 文件权限:${data.file_mode}${data.file_mode_too_open ? ' ⚠️ 权限过宽,建议 chmod 600' : ''}`);
|
|
872
|
+
}
|
|
873
|
+
out.info(' (令牌明文不会显示:需要的是账号标识,不是凭据本身)');
|
|
874
|
+
}
|
|
875
|
+
ctx.done(data);
|
|
876
|
+
return data;
|
|
877
|
+
},
|
|
878
|
+
};
|
|
879
|
+
|
|
880
|
+
/* ------------------------------------------------------------------ */
|
|
881
|
+
/* auth status / auth token / auth revoke */
|
|
882
|
+
/* ------------------------------------------------------------------ */
|
|
883
|
+
/*
|
|
884
|
+
* ★ 2026-10-28(task-12「CLI 收口到自己的云函数」):新增 `auth` 命令组。
|
|
885
|
+
*
|
|
886
|
+
* ## 为什么不是一套新令牌
|
|
887
|
+
* 老板拍板的令牌模型就是**现有 OAuth access_token**(`public.oauth_token`,库里只存
|
|
888
|
+
* sha256 + 过期时间,TTL 30 天)。后端**没有** `auth.tokenIssue` / `auth.revoke` 这种
|
|
889
|
+
* "CLI 专用令牌"动作,也没有 `cli-token.json` —— 所以这里既不做令牌换领,也不改
|
|
890
|
+
* `wkgeo login` 的落盘格式;这三条命令只是把**已经有的东西**查清楚 / 展示得更清楚。
|
|
891
|
+
*
|
|
892
|
+
* ## 三条命令各自解决什么
|
|
893
|
+
* * `auth status` —— "我现在是谁、这个令牌在 CLI 自己的函数里到底能干什么"
|
|
894
|
+
* (调 `cliWhoami`:账号 / client_id / scopes / 动作面总数与自持清单)。
|
|
895
|
+
* * `auth token` —— "令牌还剩多久、有多长",**只给前 4 位 + 长度**(永远不给明文)。
|
|
896
|
+
* * `auth revoke` —— 服务端真吊销(RFC 7009 `/api/oauth/revoke`)+ 删本地凭据。
|
|
897
|
+
*/
|
|
898
|
+
|
|
899
|
+
/**
|
|
900
|
+
* 「动作面」汇总:后端字段**原样透出**,另外算一份人能读的合计。
|
|
901
|
+
*
|
|
902
|
+
* 口径(与 `wkgeo-cli-fc` 的 `cliWhoami` / 映射文档一致):
|
|
903
|
+
* * 原生 —— 本函数 switch 里按 scope 过滤后的 `actions`;
|
|
904
|
+
* * 自持 —— 进程内重建(用户面 / 内容 / 素材 / 发布 / 配置 / 站点 / 插件 / 控制台);
|
|
905
|
+
* * 转发 —— 金融面白名单转给 `wkgeo-order`(钱逻辑不复制)。
|
|
906
|
+
*/
|
|
907
|
+
export function summarizeActionSurface(who = {}) {
|
|
908
|
+
const n = (v) => (Array.isArray(v) ? v.length : 0);
|
|
909
|
+
const native = n(who.actions);
|
|
910
|
+
const batches = {
|
|
911
|
+
user: n(who.self_hosted_actions),
|
|
912
|
+
content: n(who.content_actions),
|
|
913
|
+
asset: n(who.asset_actions),
|
|
914
|
+
publish: n(who.publish_actions),
|
|
915
|
+
config_auth: n(who.config_auth_actions),
|
|
916
|
+
site: n(who.site_actions),
|
|
917
|
+
finance_forwarded: n(who.forwarded_actions),
|
|
918
|
+
};
|
|
919
|
+
/* 口径对齐后端 `cliWhoami.action_total`:自持各批次相加即总数。
|
|
920
|
+
★ 2026-11-19 task-1250:域名面(domain / ops / dns_credential)已从后端删除,
|
|
921
|
+
`uncounted_self_hosted` 恒为 0(字段保留,老脚本读它不会 undefined)。 */
|
|
922
|
+
const selfHosted = batches.user + batches.content + batches.asset + batches.publish
|
|
923
|
+
+ batches.config_auth + batches.site;
|
|
924
|
+
const forwarded = batches.finance_forwarded;
|
|
925
|
+
const uncounted = 0;
|
|
926
|
+
const total = Number(who.action_total);
|
|
927
|
+
return {
|
|
928
|
+
action_total: Number.isFinite(total) && total > 0 ? total : native + selfHosted + forwarded,
|
|
929
|
+
native,
|
|
930
|
+
self_hosted: selfHosted,
|
|
931
|
+
forwarded,
|
|
932
|
+
uncounted_self_hosted: uncounted,
|
|
933
|
+
batches,
|
|
934
|
+
consistent: !(Number.isFinite(total) && total > 0) || total === native + selfHosted + forwarded,
|
|
935
|
+
};
|
|
936
|
+
}
|
|
937
|
+
|
|
938
|
+
/** 「自持批次」的人话标签(顺序 = 迁移批次;域名面已随 task-1250 删除) */
|
|
939
|
+
const SURFACE_BATCH_LABEL = [
|
|
940
|
+
['user', '账号/站点面(自持副本)'],
|
|
941
|
+
['content', '内容类(B1)'],
|
|
942
|
+
['asset', '素材类(B2)'],
|
|
943
|
+
['publish', '发布类(B3)'],
|
|
944
|
+
['config_auth', '配置类 auth 面(B7:成员 / 角色 / 语言)'],
|
|
945
|
+
['site', '站点类(B4:公司信息 / 示例内容 / 站级同步)'],
|
|
946
|
+
['finance_forwarded', '金融面(白名单转发 wkgeo-order)'],
|
|
947
|
+
];
|
|
948
|
+
|
|
949
|
+
/** 不计入 `action_total` 的批次:★ task-1250 起为空(域名面已删) */
|
|
950
|
+
const SURFACE_EXTRA_LABEL = [];
|
|
951
|
+
|
|
952
|
+
export const authStatusCommand = {
|
|
953
|
+
name: 'auth status',
|
|
954
|
+
summary: '看当前令牌是谁、在 CLI 自持函数里能干什么(账号 / scopes / 动作面总数与自持清单)',
|
|
955
|
+
usage: 'wkgeo auth status [--verbose]',
|
|
956
|
+
args: [],
|
|
957
|
+
flags: {
|
|
958
|
+
verbose: { type: 'boolean', desc: '额外显示令牌掩码与凭据文件权限(仍然不含令牌明文)' },
|
|
959
|
+
},
|
|
960
|
+
examples: ['wkgeo auth status', 'wkgeo auth status --json'],
|
|
961
|
+
notes: [
|
|
962
|
+
'后端动作 `cliWhoami`(无 scope 要求、只读):返回账号标识 / client_id / scopes / 动作面清单,CLI 原样透出。',
|
|
963
|
+
'后端**没有** `account_id` 字段:账号唯一标识就是 `user_id`(本命令里 `account_id` ≡ `user_id`)。',
|
|
964
|
+
'动作面 = 原生(本函数 switch)+ 自持(进程内重建)+ 转发(金融面白名单给 wkgeo-order);`action_total` 与明细对不上时会标 `action_surface.consistent=false`。',
|
|
965
|
+
'绝不打印令牌:要看"还剩多久、有多长"用 `wkgeo auth token`。',
|
|
966
|
+
],
|
|
967
|
+
async run(ctx) {
|
|
968
|
+
const { out, config, flags } = ctx;
|
|
969
|
+
const creds = ctx.requireAuth();
|
|
970
|
+
const who = (await ctx.callData('cliWhoami', {})) || {};
|
|
971
|
+
const surface = summarizeActionSurface(who);
|
|
972
|
+
const userId = who.user_id || (creds.account && creds.account.sub) || null;
|
|
973
|
+
const expiresInMs = creds.expires_at ? new Date(creds.expires_at).getTime() - ctx.now() : null;
|
|
974
|
+
|
|
975
|
+
const data = {
|
|
976
|
+
logged_in: true,
|
|
977
|
+
/** 后端只有 user_id;`account_id` 是给人/脚本的稳定别名 */
|
|
978
|
+
account_id: userId,
|
|
979
|
+
user_id: userId,
|
|
980
|
+
client_id: who.client_id || creds.client_id || null,
|
|
981
|
+
scopes: Array.isArray(who.scopes) ? who.scopes : String(creds.scope || '').split(/\s+/).filter(Boolean),
|
|
982
|
+
scope: creds.scope || null,
|
|
983
|
+
obtained_at: creds.obtained_at || null,
|
|
984
|
+
expires_at: creds.expires_at || null,
|
|
985
|
+
expires_in_ms: expiresInMs,
|
|
986
|
+
credentials_file: config.credentialsFile,
|
|
987
|
+
/** 后端/函数标识(排查"到底打没打到自持函数"用) */
|
|
988
|
+
fn: who.fn || null,
|
|
989
|
+
via: who.via || null,
|
|
990
|
+
action_total: surface.action_total,
|
|
991
|
+
action_surface: surface,
|
|
992
|
+
/** 原样透出(agent 可直接按清单挑动作;不截断、不重排) */
|
|
993
|
+
action_lists: {
|
|
994
|
+
actions: who.actions || [],
|
|
995
|
+
self_hosted_actions: who.self_hosted_actions || [],
|
|
996
|
+
content_actions: who.content_actions || [],
|
|
997
|
+
asset_actions: who.asset_actions || [],
|
|
998
|
+
publish_actions: who.publish_actions || [],
|
|
999
|
+
forwarded_actions: who.forwarded_actions || [],
|
|
1000
|
+
},
|
|
1001
|
+
token_ttl_hint: who.token_ttl_hint || null,
|
|
1002
|
+
whoami: who,
|
|
1003
|
+
};
|
|
1004
|
+
if (flags.verbose) {
|
|
1005
|
+
data.token_masked = maskToken(creds.access_token);
|
|
1006
|
+
const mode = checkFileMode(config.credentialsFile);
|
|
1007
|
+
data.file_mode = mode.supported ? mode.modeText : '无法判断(Windows)';
|
|
1008
|
+
data.file_mode_too_open = mode.supported ? !!mode.tooOpen : null;
|
|
1009
|
+
}
|
|
1010
|
+
|
|
1011
|
+
if (!out.json) {
|
|
1012
|
+
out.head('当前令牌(CLI 自持云函数 wkgeo-cli-fc)');
|
|
1013
|
+
out.line(` 账号 ID:${userId || '(服务端未返回账号标识)'}`);
|
|
1014
|
+
out.line(` 应用(client_id):${data.client_id || '-'}`);
|
|
1015
|
+
out.line(` 能力范围:${data.scopes.length ? data.scopes.join(' ') : '-'}`);
|
|
1016
|
+
out.line(` 令牌到期:${formatTime(data.expires_at)}(${formatRemaining(expiresInMs)})`);
|
|
1017
|
+
out.line(` 凭据文件:${data.credentials_file}`);
|
|
1018
|
+
out.head(' 动作面');
|
|
1019
|
+
out.line(` 合计:${surface.action_total} 条(原生 ${surface.native} · 自持 ${surface.self_hosted} · 转发 ${surface.forwarded})`);
|
|
1020
|
+
for (const [key, label] of SURFACE_BATCH_LABEL) {
|
|
1021
|
+
const count = surface.batches[key];
|
|
1022
|
+
if (count) out.line(` · ${label}:${count} 条`);
|
|
1023
|
+
}
|
|
1024
|
+
for (const [key, label] of SURFACE_EXTRA_LABEL) {
|
|
1025
|
+
const count = surface.batches[key];
|
|
1026
|
+
if (count) out.line(` · ${label}:${count} 条`);
|
|
1027
|
+
}
|
|
1028
|
+
if (!surface.consistent) {
|
|
1029
|
+
out.warn(' 动作面明细与 action_total 对不上(服务端刚改过动作表?)—— 以 action_lists 明细为准。');
|
|
1030
|
+
}
|
|
1031
|
+
if (data.token_ttl_hint) out.info(` ${data.token_ttl_hint}`);
|
|
1032
|
+
if (flags.verbose) {
|
|
1033
|
+
out.line(` 令牌(掩码):${data.token_masked}`);
|
|
1034
|
+
out.line(` 文件权限:${data.file_mode}${data.file_mode_too_open ? ' ⚠️ 权限过宽,建议 chmod 600' : ''}`);
|
|
1035
|
+
}
|
|
1036
|
+
out.info(' (令牌明文不会显示;只看剩余时长/长度用 `wkgeo auth token`)');
|
|
1037
|
+
}
|
|
1038
|
+
ctx.done(data);
|
|
1039
|
+
return data;
|
|
1040
|
+
},
|
|
1041
|
+
};
|
|
1042
|
+
|
|
1043
|
+
export const authTokenCommand = {
|
|
1044
|
+
name: 'auth token',
|
|
1045
|
+
summary: '看本地令牌的前 4 位、长度与到期时间(绝不打印明文)',
|
|
1046
|
+
usage: 'wkgeo auth token [--json]',
|
|
1047
|
+
args: [],
|
|
1048
|
+
flags: {},
|
|
1049
|
+
examples: ['wkgeo auth token', 'wkgeo auth token --json'],
|
|
1050
|
+
notes: [
|
|
1051
|
+
'只显示**前 4 位 + 总长度 + 到期时间**:足够确认"是不是换过了/有没有被截断",抄不走令牌。',
|
|
1052
|
+
'令牌就是 `wkgeo login` 拿到的 OAuth access_token(30 天);CLI 没有另一套专用令牌。',
|
|
1053
|
+
'要看账号与动作面用 `wkgeo auth status`;要立刻作废用 `wkgeo auth revoke`。',
|
|
1054
|
+
],
|
|
1055
|
+
async run(ctx) {
|
|
1056
|
+
const { out, config } = ctx;
|
|
1057
|
+
const creds = ctx.readCredentials();
|
|
1058
|
+
if (!creds) throw notLoggedInError();
|
|
1059
|
+
const token = String(creds.access_token || '');
|
|
1060
|
+
const expiresInMs = creds.expires_at ? new Date(creds.expires_at).getTime() - ctx.now() : null;
|
|
1061
|
+
const data = {
|
|
1062
|
+
logged_in: true,
|
|
1063
|
+
token_prefix: token.slice(0, 4),
|
|
1064
|
+
token_length: token.length,
|
|
1065
|
+
token_type: creds.token_type || 'Bearer',
|
|
1066
|
+
expires_at: creds.expires_at || null,
|
|
1067
|
+
expires_in_ms: expiresInMs,
|
|
1068
|
+
expired: isExpired(creds, { now: ctx.now() }),
|
|
1069
|
+
scope: creds.scope || null,
|
|
1070
|
+
client_id: creds.client_id || null,
|
|
1071
|
+
obtained_at: creds.obtained_at || null,
|
|
1072
|
+
credentials_file: config.credentialsFile,
|
|
1073
|
+
note: '只显示前 4 位与长度;完整令牌不会出现在任何输出里',
|
|
1074
|
+
};
|
|
1075
|
+
|
|
1076
|
+
if (!out.json) {
|
|
1077
|
+
out.head('本地令牌');
|
|
1078
|
+
out.line(` 前 4 位:${data.token_prefix}…(共 ${data.token_length} 位)`);
|
|
1079
|
+
out.line(` 类型:${data.token_type}`);
|
|
1080
|
+
out.line(` 到期:${formatTime(data.expires_at)}(${formatRemaining(expiresInMs)})${data.expired ? ' ⚠️ 已过期' : ''}`);
|
|
1081
|
+
out.line(` 能力范围:${data.scope || '-'}`);
|
|
1082
|
+
out.line(` 凭据文件:${data.credentials_file}`);
|
|
1083
|
+
out.info(' (完整令牌永远不打印;需要作废就 `wkgeo auth revoke`)');
|
|
1084
|
+
}
|
|
1085
|
+
ctx.done(data);
|
|
1086
|
+
return data;
|
|
1087
|
+
},
|
|
1088
|
+
};
|
|
1089
|
+
|
|
1090
|
+
export const authRevokeCommand = {
|
|
1091
|
+
name: 'auth revoke',
|
|
1092
|
+
summary: '立刻作废本地令牌(服务端 RFC 7009 吊销 + 删本地凭据)',
|
|
1093
|
+
usage: 'wkgeo auth revoke [--local-only]',
|
|
1094
|
+
args: [],
|
|
1095
|
+
flags: {
|
|
1096
|
+
'local-only': { type: 'boolean', desc: '只删本地凭据,不调服务端吊销接口' },
|
|
1097
|
+
},
|
|
1098
|
+
examples: ['wkgeo auth revoke', 'wkgeo auth revoke --local-only'],
|
|
1099
|
+
notes: [
|
|
1100
|
+
'服务端吊销走 OAuth 标准端点 `POST /api/oauth/revoke`(与 `wkgeo logout` 同一个,前端/会员中心也用它);不成功会如实说明,不假装已吊销。',
|
|
1101
|
+
'本地凭据文件(默认 `%USERPROFILE%\\.wkongai\\credentials.json`)会被删除;之后任何业务命令都会要求重新 `wkgeo login`。',
|
|
1102
|
+
'即使服务端吊销失败,令牌也会在到期时间后自动失效;要**立刻**吊销全部设备授权,请到会员中心 →「我的授权」撤销应用(对应动作 `revokeMyOAuthAuthorization`,`wkgeo apps revoke` 也能做)。',
|
|
1103
|
+
],
|
|
1104
|
+
async run(ctx) {
|
|
1105
|
+
const { out, config, flags } = ctx;
|
|
1106
|
+
const creds = ctx.readCredentials();
|
|
1107
|
+
if (!creds) {
|
|
1108
|
+
out.warn('本地本来就没有凭据(未登录),无需吊销');
|
|
1109
|
+
const data = {
|
|
1110
|
+
removed: false,
|
|
1111
|
+
revoked_remote: false,
|
|
1112
|
+
revoke_error: null,
|
|
1113
|
+
revoke_endpoint: '/api/oauth/revoke',
|
|
1114
|
+
credentials_file: config.credentialsFile,
|
|
1115
|
+
};
|
|
1116
|
+
ctx.done(data);
|
|
1117
|
+
return data;
|
|
1118
|
+
}
|
|
1119
|
+
|
|
1120
|
+
let revoke = { ok: false, reason: '已按要求跳过(--local-only)' };
|
|
1121
|
+
if (flags.localOnly !== true) revoke = await ctx.api.revoke(creds.access_token);
|
|
1122
|
+
const removed = deleteCredentials(config.credentialsFile);
|
|
1123
|
+
const data = {
|
|
1124
|
+
removed,
|
|
1125
|
+
revoked_remote: revoke.ok === true,
|
|
1126
|
+
revoke_error: revoke.ok ? null : revoke.reason || null,
|
|
1127
|
+
revoke_endpoint: '/api/oauth/revoke',
|
|
1128
|
+
credentials_file: config.credentialsFile,
|
|
1129
|
+
client_id: creds.client_id || null,
|
|
1130
|
+
expires_at: creds.expires_at || null,
|
|
1131
|
+
server_ttl_note: '未吊销成功时令牌仍会在到期时间自动失效;要立刻撤销全部设备授权请到会员中心',
|
|
1132
|
+
};
|
|
1133
|
+
|
|
1134
|
+
if (revoke.ok) out.ok('服务端令牌已吊销(POST /api/oauth/revoke)');
|
|
1135
|
+
else out.warn(`未能吊销服务端令牌(${revoke.reason || '未知原因'})—— 本地凭据已删除,令牌仍会在到期时间自动失效`);
|
|
1136
|
+
if (removed) out.ok(`本地凭据已删除:${config.credentialsFile}`);
|
|
1137
|
+
out.info(' → 要立刻吊销该应用的全部设备授权:`wkgeo apps revoke --client-id <client_id>` 或会员中心 →「我的授权」。');
|
|
1138
|
+
ctx.done(data);
|
|
1139
|
+
return data;
|
|
1140
|
+
},
|
|
1141
|
+
};
|
|
1142
|
+
|
|
1143
|
+
/* ------------------------------------------------------------------ */
|
|
1144
|
+
/* config */
|
|
1145
|
+
/* ------------------------------------------------------------------ */
|
|
1146
|
+
|
|
1147
|
+
export const configCommand = {
|
|
1148
|
+
name: 'config',
|
|
1149
|
+
summary: '显示当前生效的配置与登录状态(不含任何令牌)',
|
|
1150
|
+
usage: 'wkgeo config',
|
|
1151
|
+
notes: [
|
|
1152
|
+
'这条是**本机诊断**命令(凭据文件 / 代理 / 当前站点),不发任何业务请求。',
|
|
1153
|
+
'★ task-92 起同一个 `config` 前缀下还有**后台参数**命令组(走 `/cli` 自持通道,要 `site:read` / `site:write`):',
|
|
1154
|
+
' `wkgeo config get`(读站点参数与白名单)/ `config save`(存参数,默认 dry-run)/',
|
|
1155
|
+
' `config review`(审核统计代码,双闸 REVIEW_TOKEN)/ `config capabilities`(会员与支付两档能不能选)。',
|
|
1156
|
+
' `wkgeo config --help` 只显示本条(解析器先做精确匹配);看那组的用法:`wkgeo config get --help`。',
|
|
1157
|
+
],
|
|
1158
|
+
async run(ctx) {
|
|
1159
|
+
const { out, config } = ctx;
|
|
1160
|
+
const creds = readCredentials(config.credentialsFile);
|
|
1161
|
+
const sources = describeConfigSources(ctx.flags, ctx.env);
|
|
1162
|
+
const mode = checkFileMode(config.credentialsFile);
|
|
1163
|
+
/**
|
|
1164
|
+
* ★ 顺带报告"本机代理情况"。
|
|
1165
|
+
*
|
|
1166
|
+
* 为什么放在 `config` 里:这条命令就是**排障入口**("把你的 config 输出发我")。
|
|
1167
|
+
* 老板说过"很多用户不懂代理",让支持同学只用一条命令就能看出
|
|
1168
|
+
* "哦,你机器上有代理且没绕过 127.0.0.1,所以回调收不到" —— 比让用户
|
|
1169
|
+
* 自己去翻注册表/系统设置现实得多。
|
|
1170
|
+
* 检测是**只读**的:不改用户任何设置(见 lib/proxy.mjs 开头三条硬约束)。
|
|
1171
|
+
*/
|
|
1172
|
+
const proxy = proxyWarningPayload(ctx.proxyInfo(), { cmdName: config.cmdName || 'wkgeo' });
|
|
1173
|
+
|
|
1174
|
+
/**
|
|
1175
|
+
* 本地"当前站点"(`wkgeo site use` 选的)。
|
|
1176
|
+
* ⚠️ 诊断命令**不能**因为一个坏文件就整体失败:读失败时如实报出来,其它信息照常给。
|
|
1177
|
+
*/
|
|
1178
|
+
let cmsSite = null;
|
|
1179
|
+
let cmsSiteError = null;
|
|
1180
|
+
try {
|
|
1181
|
+
cmsSite = ctx.readSiteState();
|
|
1182
|
+
} catch (e) {
|
|
1183
|
+
cmsSiteError = (e && e.message) || String(e);
|
|
1184
|
+
}
|
|
1185
|
+
|
|
1186
|
+
const data = {
|
|
1187
|
+
base: config.base,
|
|
1188
|
+
/**
|
|
1189
|
+
* CMS 面(栏目/内容/素材/模板)是**另一个云函数、另一个域名**,
|
|
1190
|
+
* 所以单独列一行 —— 排查"CMS 命令为什么 404"时第一眼看的就是它。
|
|
1191
|
+
*/
|
|
1192
|
+
cms_base: config.cmsBase,
|
|
1193
|
+
/**
|
|
1194
|
+
* ⚠️ `web_base` 是**兼容字段**:三站拆分后它指向老站(管理端),
|
|
1195
|
+
* 已经没有任何代码用它打开页面 —— 保留只为不破坏既有自动化脚本。
|
|
1196
|
+
* 真正生效的是下面三个按站的基址(2026-10-02 三站拆分新增)。
|
|
1197
|
+
*/
|
|
1198
|
+
web_base: config.webBase,
|
|
1199
|
+
oauth_web_base: config.oauthWebBase,
|
|
1200
|
+
pay_web_base: config.payWebBase,
|
|
1201
|
+
user_web_base: config.userWebBase,
|
|
1202
|
+
client_id: config.clientId,
|
|
1203
|
+
scope: config.scope,
|
|
1204
|
+
credentials_file: config.credentialsFile,
|
|
1205
|
+
callback: `http://${config.callbackHost}:${config.callbackPort}${config.callbackPath}`,
|
|
1206
|
+
http_timeout_ms: config.httpTimeoutMs,
|
|
1207
|
+
login_timeout_ms: config.loginTimeoutMs,
|
|
1208
|
+
/** 本地"当前站点"(CMS 命令用;`site use` 写的) */
|
|
1209
|
+
cms_site: cmsSite,
|
|
1210
|
+
cms_site_file: config.siteStateFile,
|
|
1211
|
+
cms_site_error: cmsSiteError,
|
|
1212
|
+
sources,
|
|
1213
|
+
logged_in: !!creds,
|
|
1214
|
+
expired: creds ? isExpired(creds, { now: ctx.now() }) : null,
|
|
1215
|
+
account: creds && creds.account ? { user_id: creds.account.sub || null, email: creds.account.email || null } : null,
|
|
1216
|
+
expires_at: creds ? creds.expires_at || null : null,
|
|
1217
|
+
file_mode: mode.supported ? mode.modeText : '无法判断(Windows)',
|
|
1218
|
+
/** 结构化:有代理/有风险/建议怎么做(AI 端与支持同学都直接用这份) */
|
|
1219
|
+
proxy,
|
|
1220
|
+
};
|
|
1221
|
+
|
|
1222
|
+
if (!out.json) {
|
|
1223
|
+
out.head('生效配置');
|
|
1224
|
+
for (const [k, v] of Object.entries({
|
|
1225
|
+
'API 基址': data.base,
|
|
1226
|
+
'CMS 接口基址': data.cms_base,
|
|
1227
|
+
'授权站基址': data.oauth_web_base,
|
|
1228
|
+
'收银台基址': data.pay_web_base,
|
|
1229
|
+
'会员站基址': data.user_web_base,
|
|
1230
|
+
'老站基址(兼容字段,不再用于跳转)': data.web_base,
|
|
1231
|
+
'client_id': data.client_id,
|
|
1232
|
+
'能力范围': data.scope,
|
|
1233
|
+
'回调地址': data.callback,
|
|
1234
|
+
'凭据文件': data.credentials_file,
|
|
1235
|
+
})) {
|
|
1236
|
+
out.line(` ${k}:${v}`);
|
|
1237
|
+
}
|
|
1238
|
+
out.line(
|
|
1239
|
+
` 当前站点:${
|
|
1240
|
+
data.cms_site && data.cms_site.id
|
|
1241
|
+
? `${data.cms_site.label ? `${data.cms_site.label}(` : ''}${data.cms_site.id}${data.cms_site.label ? ')' : ''}`
|
|
1242
|
+
: data.cms_site_error
|
|
1243
|
+
? `⚠️ 读取失败:${data.cms_site_error}`
|
|
1244
|
+
: '未选(CMS 命令前先 `wkgeo site use <站点ID或域名>`)'
|
|
1245
|
+
}`,
|
|
1246
|
+
);
|
|
1247
|
+
out.line(` 登录状态:${data.logged_in ? (data.expired ? '已过期(需重新 login)' : '已登录') : '未登录'}`);
|
|
1248
|
+
if (data.logged_in) {
|
|
1249
|
+
out.line(` 账号:${(data.account && (data.account.email || data.account.user_id)) || '-'}`);
|
|
1250
|
+
out.line(` 令牌到期:${formatTime(data.expires_at)}`);
|
|
1251
|
+
}
|
|
1252
|
+
out.line(` 系统代理:${proxy.detected ? `${proxy.proxy}(来源 ${proxy.source})` : '未检测到'}`);
|
|
1253
|
+
if (proxy.callback_may_fail) {
|
|
1254
|
+
/**
|
|
1255
|
+
* ⚠️ 口径与 login 一致:**检测到代理就一定会走设备码**(不看绕过列表),
|
|
1256
|
+
* 所以这里不能说"已绕过回环就没问题"(真机上正是这么翻车的)。
|
|
1257
|
+
*/
|
|
1258
|
+
out.warn(
|
|
1259
|
+
' 检测到系统代理 → `wkgeo login` 会**直接改用设备码模式**(不再依赖 127.0.0.1 回调;绕过列表写了 127.*/localhost 也不作依据)。',
|
|
1260
|
+
);
|
|
1261
|
+
out.info(' 想坚持浏览器回调模式:`wkgeo login --no-auto-device`,并把 127.0.0.1,localhost 加入代理绕过列表。');
|
|
1262
|
+
}
|
|
1263
|
+
out.info(` (配置来源:${JSON.stringify(sources)})`);
|
|
1264
|
+
/**
|
|
1265
|
+
* ★ task-92:`config` 这个名字现在**同时**是本机诊断命令和"站点参数"命令组的前缀。
|
|
1266
|
+
* 解析器先做精确匹配,所以 `wkgeo config` 永远还是这里(行为一字未改);
|
|
1267
|
+
* 但那也意味着 `wkgeo config --help` **不会**掉到分组帮助里 ——
|
|
1268
|
+
* 想让用户发现后台参数命令,只能在这儿指一条路。
|
|
1269
|
+
*/
|
|
1270
|
+
out.info(' → 站点参数(后台配置):`wkgeo config get` / `config save` / `config review` / `config capabilities`');
|
|
1271
|
+
}
|
|
1272
|
+
ctx.done(data);
|
|
1273
|
+
return data;
|
|
1274
|
+
},
|
|
1275
|
+
};
|
|
1276
|
+
|
|
1277
|
+
/** 未登录时的统一提示(whoami / 业务命令共用) */
|
|
1278
|
+
export function notLoggedInError() {
|
|
1279
|
+
return new CliError('尚未登录', { kind: 'unauthenticated', hint: loginHint(), exitCode: EXIT.AUTH });
|
|
1280
|
+
}
|