@wkgeo/cli 0.0.0-stage → 1.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (54) hide show
  1. package/CHANGELOG.md +223 -0
  2. package/LICENSE +21 -0
  3. package/README.md +1042 -3
  4. package/SKILL.md +927 -0
  5. package/lib/ai/client.mjs +161 -0
  6. package/lib/ai/config.mjs +221 -0
  7. package/lib/ai/context.mjs +468 -0
  8. package/lib/ai/log.mjs +53 -0
  9. package/lib/api.mjs +339 -0
  10. package/lib/args.mjs +235 -0
  11. package/lib/cli.mjs +168 -0
  12. package/lib/cms.mjs +330 -0
  13. package/lib/commands/ai.mjs +392 -0
  14. package/lib/commands/apps.mjs +116 -0
  15. package/lib/commands/auth.mjs +1288 -0
  16. package/lib/commands/billing.mjs +666 -0
  17. package/lib/commands/cms.mjs +2533 -0
  18. package/lib/commands/config-auth.mjs +621 -0
  19. package/lib/commands/config.mjs +434 -0
  20. package/lib/commands/dnscred.mjs +428 -0
  21. package/lib/commands/domainops.mjs +546 -0
  22. package/lib/commands/domainorder.mjs +439 -0
  23. package/lib/commands/import.mjs +164 -0
  24. package/lib/commands/index.mjs +541 -0
  25. package/lib/commands/logs.mjs +141 -0
  26. package/lib/commands/orders.mjs +444 -0
  27. package/lib/commands/overview.mjs +394 -0
  28. package/lib/commands/plugins.mjs +678 -0
  29. package/lib/commands/site.mjs +435 -0
  30. package/lib/commands/siteops.mjs +1012 -0
  31. package/lib/commands/sites.mjs +905 -0
  32. package/lib/commands/skill.mjs +119 -0
  33. package/lib/commands/template.mjs +258 -0
  34. package/lib/config.mjs +351 -0
  35. package/lib/credentials.mjs +160 -0
  36. package/lib/device-store.mjs +132 -0
  37. package/lib/device.mjs +464 -0
  38. package/lib/errors.mjs +299 -0
  39. package/lib/format.mjs +339 -0
  40. package/lib/http.mjs +71 -0
  41. package/lib/index.mjs +44 -0
  42. package/lib/local-import.mjs +185 -0
  43. package/lib/login.mjs +1638 -0
  44. package/lib/oauth-urls.mjs +163 -0
  45. package/lib/page.mjs +393 -0
  46. package/lib/pkce.mjs +48 -0
  47. package/lib/proxy.mjs +454 -0
  48. package/lib/qr.mjs +31 -0
  49. package/lib/runtime.mjs +650 -0
  50. package/lib/site-state.mjs +137 -0
  51. package/lib/tar.mjs +207 -0
  52. package/lib/template-package.mjs +522 -0
  53. package/package.json +53 -4
  54. package/wkgeo.mjs +17 -0
@@ -0,0 +1,163 @@
1
+ /**
2
+ * 授权站页面地址的「归一化」——**唯一入口**。
3
+ *
4
+ * ## 为什么需要它(2026-10-18 域名统一到路径)
5
+ * 平台把三个业务前端统一到了路径:
6
+ * * 客户后台 `https://wkgeo.com/cms/` (老:`https://cms.wkgeo.com/`)
7
+ * * 会员站 `https://wkgeo.com/user/` (老:`https://user.wkgeo.com/`)
8
+ * * 授权站 `https://wkgeo.com/oauth/` (老:`https://oauth.wkgeo.com/`)
9
+ * * 收银台 `https://pay.wkgeo.com/` —— **支付独立,没动**
10
+ * 老地址一律**继续可用**(老板要求并存),但 CLI 的 canonical 地址要切到新路径。
11
+ *
12
+ * ## 问题在哪
13
+ * CLI 的授权地址有两个来源:
14
+ * 1. 线上 metadata 的 `authorization_endpoint` / `device_verification_uri`
15
+ * —— 由云函数 `aliyun/fc/wkgeo-oauth/src/index.js` 的 `ADMIN_WEB_BASE` 决定,
16
+ * 它的**线上环境变量里还写着老地址**,所以在服务端切完并重新部署之前,
17
+ * 这两个字段一直返回 `https://oauth.wkgeo.com/...`;
18
+ * 2. CLI 自己的兜底 `${config.oauthWebBase}/authorize`。
19
+ * 只改 (2) 没用 —— (1) 永远优先,用户看到的还是老子域。
20
+ *
21
+ * ## 采取的口径
22
+ * **配置基址(`WKONGAI_OAUTH_WEB_BASE` / `--web-base`)是 canonical,服务端只提供"路径"。**
23
+ * 拿到任何平台内的地址后,把它的 pathname 挪到当前配置的基址下:
24
+ * 老站 `/authorize/` + 新基址 `https://wkgeo.com/oauth` → `https://wkgeo.com/oauth/authorize/`
25
+ * 新站 `/oauth/authorize/` + 老基址 `https://oauth.wkgeo.com` → `https://oauth.wkgeo.com/authorize/`
26
+ * 这样:
27
+ * * **默认走新路径**(`DEFAULT_OAUTH_WEB_BASE` 已改成 `https://wkgeo.com/oauth`);
28
+ * * **回滚只要一条环境变量**:`WKONGAI_OAUTH_WEB_BASE=https://oauth.wkgeo.com`
29
+ * (不用改代码、不用发版);
30
+ * * 服务端将来把 `ADMIN_WEB_BASE` 切过来之后,这里**不动**也仍然正确(幂等)。
31
+ *
32
+ * ## 边界(不许放宽)
33
+ * * 只处理 http/https;
34
+ * * 只认**本平台域名**:`wkgeo.com` / `*.wkgeo.com` / `wkgeo.cn` / `*.wkgeo.cn`
35
+ * —— 历史上真的被 `authorization_endpoint=http://localhost:8000` 坑过一次,
36
+ * 打开用户本机端口是**最坏**的一种失败;
37
+ * * 平台之外的地址一律不跟随,直接回落到基址 + `fallbackPath`,并如实返回 `reason`
38
+ * 让调用方打日志(不要静默纠正)。
39
+ */
40
+
41
+ /** 平台根域(裸域也认:路径化之后授权站的 host 就是 `wkgeo.com`) */
42
+ const PLATFORM_ROOTS = ['wkgeo.com', 'wkgeo.cn'];
43
+
44
+ /**
45
+ * 已知的「站前缀」——路径化之后各站挂在同一个域的不同前缀下。
46
+ *
47
+ * 只列 `/oauth`:它是**授权站自己**的前缀。归一化时如果目标基址不带 `/oauth`(回滚到
48
+ * 老站 `oauth.wkgeo.com`,它的 `/authorize` 在站根),就必须把它剥掉,
49
+ * 否则会拼出 `https://oauth.wkgeo.com/oauth/authorize/`(老站没有这个路由 → 404)。
50
+ * 其它站前缀(`/user`、`/cms`)不该出现在授权地址里,不做猜测。
51
+ */
52
+ const OAUTH_PATH_PREFIX = '/oauth';
53
+
54
+ /**
55
+ * hostname 是否属于本平台。
56
+ * @param {string} hostname
57
+ * @returns {boolean}
58
+ */
59
+ export function isPlatformHost(hostname) {
60
+ const h = String(hostname || '').toLowerCase().replace(/\.$/, '');
61
+ if (!h) return false;
62
+ return PLATFORM_ROOTS.some((root) => h === root || h.endsWith(`.${root}`));
63
+ }
64
+
65
+ /** `https://a/b/` 的路径部分,去掉结尾斜杠;空路径返回 `''` */
66
+ function trimBasePath(pathname) {
67
+ return String(pathname || '').replace(/\/+$/, '');
68
+ }
69
+
70
+ /**
71
+ * 把 pathname 里与基址重复的段、以及已知站前缀剥掉,只留下"站内路由"。
72
+ * 例:基址 `/oauth`,输入 `/oauth/authorize/` → `/authorize/`
73
+ * 基址 ``(老站根),输入 `/oauth/authorize/` → `/authorize/`
74
+ */
75
+ function siteRelativePath(pathname, basePath) {
76
+ let p = String(pathname || '/');
77
+ if (basePath && (p === basePath || p.startsWith(`${basePath}/`))) {
78
+ p = p.slice(basePath.length) || '/';
79
+ }
80
+ if (basePath !== OAUTH_PATH_PREFIX && (p === OAUTH_PATH_PREFIX || p.startsWith(`${OAUTH_PATH_PREFIX}/`))) {
81
+ p = p.slice(OAUTH_PATH_PREFIX.length) || '/';
82
+ }
83
+ if (!p.startsWith('/')) p = `/${p}`;
84
+ return p;
85
+ }
86
+
87
+ /**
88
+ * 归一化一个「用户浏览器要打开的授权站页面地址」。
89
+ *
90
+ * @param {string} rawUrl 服务端给的地址(可能是老站 / 新路径 / 本机地址 / 垃圾)
91
+ * @param {string} oauthWebBase canonical 授权站基址(`config.oauthWebBase`)
92
+ * @param {object} [opts]
93
+ * @param {string} [opts.fallbackPath] 拿不到可用地址时用的站内路径(`/authorize` / `/device`)
94
+ * @returns {{url: string, changed: boolean, reason: 'ok'|'other_site'|'not_platform'|'unparsable'}}
95
+ * * `changed` —— 地址被改写过(调用方应打一条提示,别静默)
96
+ * * `reason` —— 为什么改:
97
+ * `other_site` 平台内另一个站(典型:老 `oauth.wkgeo.com`)
98
+ * `not_platform` 平台之外的域名(含 `localhost` / 局域网 IP)
99
+ * `unparsable` 根本不是 URL
100
+ */
101
+ export function canonicalOauthUrl(rawUrl, oauthWebBase, { fallbackPath = '/' } = {}) {
102
+ const baseText = String(oauthWebBase || '').trim();
103
+ if (!baseText) {
104
+ // 没有基址就什么都不做 —— 调用方自己的默认值已经兜住了
105
+ return { url: String(rawUrl || ''), changed: false, reason: 'ok' };
106
+ }
107
+
108
+ let base;
109
+ try {
110
+ base = new URL(baseText);
111
+ } catch {
112
+ return { url: String(rawUrl || ''), changed: false, reason: 'ok' };
113
+ }
114
+ const basePath = trimBasePath(base.pathname);
115
+
116
+ /** 用基址 + 站内路径拼出最终地址(保留基址自身可能带的端口) */
117
+ const buildFromBase = (relPath, search = '', hash = '') =>
118
+ `${base.origin}${basePath}${relPath === '/' ? '/' : relPath}${search}${hash}`;
119
+
120
+ let u;
121
+ try {
122
+ u = new URL(String(rawUrl || ''));
123
+ } catch {
124
+ return { url: buildFromBase(fallbackPath), changed: true, reason: 'unparsable' };
125
+ }
126
+
127
+ if (u.protocol !== 'http:' && u.protocol !== 'https:') {
128
+ return { url: buildFromBase(fallbackPath), changed: true, reason: 'not_platform' };
129
+ }
130
+
131
+ /*
132
+ * 本机/局域网地址:历史上 `authorization_endpoint` 真被配成 `http://localhost:8000`
133
+ * (云函数默认值没配环境变量),打开的是**用户自己机器**的端口 —— 必须纠偏。
134
+ */
135
+ const host = u.hostname.toLowerCase();
136
+ const isLoopback =
137
+ host === 'localhost' ||
138
+ host === '127.0.0.1' ||
139
+ host === '::1' ||
140
+ host === '[::1]' ||
141
+ /^127\./.test(host) ||
142
+ /^10\./.test(host) ||
143
+ /^192\.168\./.test(host) ||
144
+ /^172\.(1[6-9]|2\d|3[01])\./.test(host);
145
+
146
+ if (!isLoopback && !isPlatformHost(host)) {
147
+ return { url: buildFromBase(fallbackPath), changed: true, reason: 'not_platform' };
148
+ }
149
+ if (isLoopback) {
150
+ return { url: buildFromBase(fallbackPath), changed: true, reason: 'not_platform' };
151
+ }
152
+
153
+ const relPath = siteRelativePath(u.pathname, basePath);
154
+ const normalized = buildFromBase(relPath, u.search, u.hash);
155
+
156
+ /**
157
+ * `changed` 的判定:**host 或前缀变了**才算改写。
158
+ * 同一个地址原样返回(服务端已经配对了、或者已经是新路径)时不能让调用方误报"纠正过"。
159
+ */
160
+ const sameHost = u.origin === base.origin;
161
+ const changed = !sameHost || u.pathname !== `${basePath}${relPath}`;
162
+ return { url: normalized, changed, reason: changed ? 'other_site' : 'ok' };
163
+ }
package/lib/page.mjs ADDED
@@ -0,0 +1,393 @@
1
+ /**
2
+ * 本机授权回调页面的 HTML 模板(成功页 + 各类错误页)。
3
+ *
4
+ * ## 为什么单独一个模块(而不是继续塞在 `login.mjs` 里)
5
+ * 1. 页面模板是**纯字符串**逻辑,与 OAuth 时序无关。抽出来之后单测可以
6
+ * **直接断言 HTML**(文案 / 品牌 / 不含令牌 / 不带外链 / 体积),
7
+ * 不必为了测一句文案就起一个本地 HTTP server 再发请求。
8
+ * 2. 老板 2026-10-01 截图吐槽的正是这一页(原来一共 764 字节:一个裸 `<h1>`
9
+ * 加两段 `<p>`,手机上顶格贴边)。页面一定会被反复改,
10
+ * 放在独立文件里改样式就**碰不到**授权时序那段危险代码。
11
+ *
12
+ * ## 🔴 这个页面的安全底线(改样式时不要破坏,有单测钉住)
13
+ * 1. **不出现任何令牌 / 授权码**。这里只有"成功 / 失败"这个事实和账号标识;
14
+ * 模板里**没有**任何位置接收 `access_token` / `code`,调用方也不该往里传。
15
+ * (`login.test.mjs` 里那条"成功页里没有任何令牌"的断言必须继续通过。)
16
+ * 2. **不引任何外链资源**:没有 CDN、没有 web font、没有 `<img src=http…>`、
17
+ * 没有统计脚本。这是跑在 `http://127.0.0.1:<随机端口>` 上的一次性页面,
18
+ * 一旦依赖网络,在离线 / 内网代理 / 被墙的机器上就会变成"半张白页"——
19
+ * 而它唯一要表达的只是"授权成功了,回终端去"。
20
+ * 图标一律**内联 SVG**,样式一律**内联 `<style>`**。
21
+ * 3. **不依赖 JavaScript**:正文(结论 + 账号 + 兜底文案)全部是静态 HTML + CSS。
22
+ * 这个页面出现的时机很敏感(用户刚在同意页点完"同意"),任何脚本报错
23
+ * 都会让人以为授权失败,所以脚本只能做**锦上添花**的事,绝不能承载信息。
24
+ * 目前唯一的脚本是"尝试自动关闭标签页"(见 `autoCloseScript`):
25
+ * 它失败 / 被浏览器拒绝 / 被用户插件拦掉,页面照旧完整可读。
26
+ * ⚠️ 0.2.4 起成功页与失败页都会带它(老板反馈「页面关不掉」),
27
+ * 差别只在延迟(成功 1.2s / 失败 6s),正文永远是静态可读的。
28
+ * 4. **所有动态内容必须转义**(`escapeHtml`)。账号标识来自服务端 `userinfo`,
29
+ * 其中昵称是**用户自己可控**的字符串,直接拼进 HTML 就等于在本机页面上
30
+ * 开一个自伤型 XSS(本机页面同样能去访问 `http://127.0.0.1` 上的其它服务)。
31
+ * ⚠️ 原来那版是裸模板字符串,**没有**转义,这是顺手补上的安全债。
32
+ * 5. **手机号只脱敏显示**:邮箱可以全量显示(它本来就是账号标识),
33
+ * 手机号按 `189****3607` 脱敏。理由:这个页面可能被截图、
34
+ * 也可能被同事瞄一眼屏幕,而"授权成功"根本不需要看到完整手机号。
35
+ *
36
+ * ## 手机端
37
+ * `<meta name="viewport">` + `max-width` 卡片 + `@media (max-width:420px)`
38
+ * 收窄内边距;再补一份 `prefers-color-scheme: dark`,
39
+ * 免得夜间模式下白底刺眼(纯静态,不掉一行 JS)。
40
+ */
41
+
42
+ /**
43
+ * HTML 实体转义。
44
+ *
45
+ * ⚠️ 五个字符一个都不能少:`&` 必须**第一个**替换,否则后面替换出来的
46
+ * `&lt;` 会被再转一次,变成用户看到的 `&amp;lt;`(经典的顺序 bug)。
47
+ */
48
+ export function escapeHtml(value) {
49
+ return String(value === undefined || value === null ? '' : value)
50
+ .replace(/&/g, '&amp;')
51
+ .replace(/</g, '&lt;')
52
+ .replace(/>/g, '&gt;')
53
+ .replace(/"/g, '&quot;')
54
+ .replace(/'/g, '&#39;');
55
+ }
56
+
57
+ /**
58
+ * 账号标识脱敏:**只处理手机号**,邮箱 / 昵称原样返回。
59
+ *
60
+ * 为什么不一并脱敏邮箱:邮箱是用户在这个平台上认自己账号的主要标识
61
+ * (终端里 `login` 打印的也是它),把它打码成 `w***@qq.com` 反而让用户
62
+ * 认不出"登的是哪个号",那是把安全做成了不好用。
63
+ * 手机号则相反:它对"这是不是我的账号"没有额外信息量,但有实打实的
64
+ * 隐私价值(截图 / 旁边有人看屏幕),所以按 `+86 189****3607` 显示。
65
+ *
66
+ * @param {string} raw 邮箱 / 昵称 / 手机号
67
+ * @returns {string} 可直接放进页面的账号标识
68
+ */
69
+ export function maskAccount(raw) {
70
+ const text = String(raw === undefined || raw === null ? '' : raw).trim();
71
+ if (!text) return '';
72
+ // 邮箱(含 @ 且两侧都有内容):原样返回
73
+ const at = text.indexOf('@');
74
+ if (at > 0 && at < text.length - 1) return text;
75
+ /**
76
+ * 手机号:容忍 `+86 189 1234 3607` / `+8618912343607` / `189-1234-3607`
77
+ * 这些写法(用户资料里的 phone_number 可能是带区号的 E.164),
78
+ * 先去掉所有非数字再判,避免"格式稍变就漏脱敏"。
79
+ */
80
+ const digits = text.replace(/\D/g, '');
81
+ const m = /^(?:(86))?(1\d{2})(\d{4})(\d{4})$/.exec(digits);
82
+ if (m) return `${m[1] ? `+86 ` : ''}${m[2]}****${m[4]}`;
83
+ // 其它(区号带 +、座机、昵称):不认识就原样显示,绝不猜着截断
84
+ return text;
85
+ }
86
+
87
+ /**
88
+ * 从 `userinfo` 的返回里挑一个给用户看的账号标识。
89
+ *
90
+ * 优先级:邮箱 > 昵称 > 脱敏手机号 > 空串(页面会省略这一行)。
91
+ * ⚠️ 顺序是有意的:邮箱/昵称能唯一对应"哪个号",手机号只是兜底
92
+ * (有些账号是手机号注册、没填邮箱也没昵称)。
93
+ */
94
+ export function accountLabel(account) {
95
+ if (!account || typeof account !== 'object') return '';
96
+ const email = typeof account.email === 'string' ? account.email.trim() : '';
97
+ if (email) return email;
98
+ const name = [account.name, account.nickname]
99
+ .map((v) => (typeof v === 'string' ? v.trim() : ''))
100
+ .find(Boolean);
101
+ if (name) return name;
102
+ const phone = typeof account.phone_number === 'string' ? account.phone_number.trim() : '';
103
+ if (phone) return maskAccount(phone);
104
+ return '';
105
+ }
106
+
107
+ /**
108
+ * 样式表。**别引任何外部资源**(见文件头的安全底线)。
109
+ * 尺寸刻意压得很小:整个页面(含 CSS)目标 < 8KB。
110
+ */
111
+ const PAGE_CSS = [
112
+ ':root{color-scheme:light dark}',
113
+ '*{box-sizing:border-box}',
114
+ 'html,body{margin:0;padding:0}',
115
+ 'body{min-height:100vh;display:flex;flex-direction:column;align-items:center;justify-content:center;',
116
+ 'gap:18px;padding:32px 16px;background:#f5f6f8;color:#1f2329;line-height:1.7;',
117
+ '-webkit-text-size-adjust:100%;',
118
+ 'font-family:-apple-system,BlinkMacSystemFont,"Segoe UI",Roboto,"PingFang SC","Hiragino Sans GB","Microsoft YaHei",sans-serif}',
119
+ '.card{width:100%;max-width:520px;background:#fff;border-radius:16px;padding:40px 32px 32px;',
120
+ 'box-shadow:0 8px 32px rgba(15,23,42,.08);text-align:center}',
121
+ '.badge{display:block;width:64px;height:64px;margin:0 auto 18px}',
122
+ 'h1{font-size:24px;font-weight:600;line-height:1.35;margin:0 0 12px}',
123
+ '.lead{font-size:16px;margin:0 0 18px;color:#3d4451}',
124
+ '.who{font-size:14px;margin:0 0 16px;padding:10px 14px;border-radius:10px;background:#f7f8fa;',
125
+ // ⚠️ 用 `overflow-wrap:anywhere` 而**不是** `word-break:break-all`:
126
+ // 后者会**无条件**把 `wkgeo@agent.qq.com` 从中间劈开成两行(320px 屏上实测很丑),
127
+ // 前者只在"这一整串真的放不下"时才断行 —— 既保证长邮箱/长昵称不会撑破卡片,
128
+ // 又不会把本来放得下的标识拆开。
129
+ 'color:#3d4451;overflow-wrap:anywhere}',
130
+ '.who strong{font-weight:600;color:#1f2329}',
131
+ '.note{font-size:12.5px;color:#8f959e;margin:0}',
132
+ '.hint{font-size:12.5px;color:#8f959e;margin:10px 0 0}',
133
+ 'footer{font-size:12px;color:#9aa2ad}',
134
+ '@media (max-width:420px){body{padding:20px 12px;gap:14px}',
135
+ '.card{padding:28px 20px 24px;border-radius:14px}h1{font-size:21px}.lead{font-size:15px}}',
136
+ '@media (prefers-color-scheme:dark){body{background:#14171c;color:#e6e8eb}',
137
+ '.card{background:#1d2128;box-shadow:0 8px 32px rgba(0,0,0,.4)}',
138
+ '.lead,.who{color:#c2c7cf}.who{background:#23272f}.who strong{color:#e6e8eb}',
139
+ '.note,.hint,footer{color:#8b929c}}',
140
+ ].join('');
141
+
142
+ /** 成功 = 绿色对勾;warn = 琥珀色感叹号;error = 红色叉。颜色同时用于描边和字形 */
143
+ const TONE = {
144
+ ok: { fg: '#16a34a', bg: '#e9f8ef' },
145
+ warn: { fg: '#d97706', bg: '#fdf3e3' },
146
+ error: { fg: '#dc2626', bg: '#fdecec' },
147
+ };
148
+
149
+ /**
150
+ * 状态图标:**内联 SVG**(不引外链、不用 emoji)。
151
+ *
152
+ * 为什么不用 emoji `✅`:emoji 的渲染完全交给系统字体 ——
153
+ * Windows 是彩色方框、某些 Linux 容器里根本没有字体,会渲染成豆腐块 `□`,
154
+ * 那正好是"授权成功页"最不该出现的东西。SVG 到哪里都是同一个样子。
155
+ */
156
+ function badgeSvg(tone) {
157
+ const c = TONE[tone] || TONE.ok;
158
+ const glyph =
159
+ tone === 'warn'
160
+ ? `<path d="M26 15.5v14.5" stroke="${c.fg}" stroke-width="3.2" stroke-linecap="round"/>` +
161
+ `<circle cx="26" cy="36.2" r="1.9" fill="${c.fg}"/>`
162
+ : tone === 'error'
163
+ ? `<path d="M19.2 19.2l13.6 13.6M32.8 19.2L19.2 32.8" stroke="${c.fg}" stroke-width="3.2" stroke-linecap="round"/>`
164
+ : `<path d="M16.6 27.2l6.6 6.6 12.2-14.2" stroke="${c.fg}" stroke-width="3.4" stroke-linecap="round" stroke-linejoin="round"/>`;
165
+ return (
166
+ `<svg class="badge" viewBox="0 0 52 52" fill="none" aria-hidden="true" focusable="false">` +
167
+ `<circle cx="26" cy="26" r="24" fill="${c.bg}" stroke="${c.fg}" stroke-width="2"/>${glyph}</svg>`
168
+ );
169
+ }
170
+
171
+ /**
172
+ * 「尝试自动关闭标签页」的极简内联脚本。
173
+ *
174
+ * ## 为什么加这段(老板 2026-10-01 对比阿里云 MCP 的实测结论)
175
+ * 老板的原话:阿里云那套"点完授权,页面**自动就关了**,这样看着很正常"。
176
+ * 我们的现状是:跳回本机后留一张页面,**要用户自己动手关**——不够顺。
177
+ *
178
+ * ## 0.2.4(2026-10-21 老板反馈「127 那个页面关不掉」)
179
+ * **授权成功页和失败页都要能自动关闭**,避免用户卡在一个已经结束的页面上。
180
+ * 页面仍然保留「本页面可以关闭了 / 直接关闭标签页」的兜底文案(浏览器只允许脚本关闭
181
+ * **由脚本打开的**窗口,我们这张页大概率关不掉,文案就是兜底)。
182
+ * * 成功页:延迟 1.2 秒关(先让用户看清「授权成功」再关,上来就关会让人以为页面崩了);
183
+ * * 失败页:延迟 6 秒关(失败原因要留够时间看清楚,但绝不能永远留在屏幕上)。
184
+ *
185
+ * ## 🔴 时机约束(阿里云 `mcp-remote` 踩过的坑,别翻回去)
186
+ * 只有 CLI **真的换到令牌、并且凭据已经写进本机之后**的那张成功页才算"确实成功";
187
+ * 收到 code 就宣告成功并关窗是不允许的(换票失败时用户已经被打发走,只剩疑惑)。
188
+ * 失败页虽然也自动关,但原因文案必须完整可读,且页面里**不出现任何令牌/授权码**。
189
+ *
190
+ * ## 为什么延迟 + 重试两次
191
+ * * **延迟**:先让用户看清结论;
192
+ * * **再试一次**:部分浏览器(含移动端内核)对第一次 `close()` 会忽略、第二次才生效。
193
+ * 两次之后就**不再骚扰**——继续调下去只会刷一屏控制台报错。
194
+ *
195
+ * ## 约束(单测钉住)
196
+ * * 不使用 `alert` / `confirm`,不跳转(不碰 `location`),不发任何请求(无 fetch/XHR),
197
+ * 不用 `eval`;整段脚本不碰 DOM,也不接收任何数据(页面里没有令牌,脚本里更没有)。
198
+ * * 用 `try/catch` 包住:某些内嵌浏览器(Electron / 企业管控浏览器)里
199
+ * `window.close` 可能直接被禁用甚至抛异常,不能因此弄脏页面。
200
+ *
201
+ * @param {number} delayMs 首次尝试关闭前的延迟(毫秒;必须是有限正数)
202
+ */
203
+ function autoCloseScript(delayMs) {
204
+ const delay = Number.isFinite(delayMs) && delayMs >= 0 ? Math.round(delayMs) : 1200;
205
+ return `<script>
206
+ (function(){
207
+ var n = 0;
208
+ function tryClose(){
209
+ n++;
210
+ try { window.close(); } catch (e) { /* 内嵌浏览器可能直接禁用,忽略 */ }
211
+ if (n < 2) setTimeout(tryClose, 700);
212
+ }
213
+ setTimeout(tryClose, ${delay});
214
+ })();
215
+ </script>`;
216
+ }
217
+
218
+ /**
219
+ * 拼出整份文档。
220
+ *
221
+ * @param {object} spec
222
+ * @param {string} spec.title 浏览器标签页标题(会带上品牌)
223
+ * @param {'ok'|'warn'|'error'} [spec.tone]
224
+ * @param {string} spec.heading 页面大标题(h1)
225
+ * @param {string} [spec.lead] 主文案(成功=下一步;失败=明确的中文原因)
226
+ * @param {string} [spec.account] 账号标识(仅成功页;已脱敏,这里再转义一次)
227
+ * @param {string} [spec.note] 小字说明
228
+ * @param {string} [spec.hint] 更小的补充提示
229
+ * @param {boolean} [spec.autoClose] 是否附上"尝试自动关闭标签页"的脚本。
230
+ * 0.2.4 起**成功页与失败页都打开它**(老板反馈「页面关不掉」),差别只在延迟:
231
+ * 成功页 1.2 秒(先看清"授权成功"),失败页 6 秒(先看清原因)。
232
+ * 打开它的页面**必须同时**有「本页面可以关闭了 / 直接关闭标签页」这类兜底文案
233
+ * (浏览器大概率不允许脚本关闭"用户自己打开的"标签页)。
234
+ * @param {number} [spec.autoCloseDelayMs] 首次尝试关闭前的延迟(默认 1200ms)
235
+ */
236
+ export function renderPage({
237
+ title,
238
+ tone = 'ok',
239
+ heading,
240
+ lead,
241
+ account,
242
+ note,
243
+ hint,
244
+ autoClose = false,
245
+ autoCloseDelayMs = 1200,
246
+ } = {}) {
247
+ const parts = [badgeSvg(tone), `<h1>${escapeHtml(heading)}</h1>`];
248
+ if (lead) parts.push(`<p class="lead">${escapeHtml(lead)}</p>`);
249
+ if (account) {
250
+ parts.push(`<p class="who">已登录账号:<strong>${escapeHtml(account)}</strong></p>`);
251
+ }
252
+ if (note) parts.push(`<p class="note">${escapeHtml(note)}</p>`);
253
+ if (hint) parts.push(`<p class="hint">${escapeHtml(hint)}</p>`);
254
+
255
+ const html = `<!doctype html>
256
+ <html lang="zh-CN">
257
+ <head>
258
+ <meta charset="utf-8">
259
+ <meta name="viewport" content="width=device-width,initial-scale=1,viewport-fit=cover">
260
+ <meta name="color-scheme" content="light dark">
261
+ <meta name="robots" content="noindex,nofollow">
262
+ <title>${escapeHtml(title)}</title>
263
+ <style>${PAGE_CSS}</style>
264
+ </head>
265
+ <body>
266
+ <main class="card" role="main">
267
+ ${parts.join('\n')}
268
+ </main>
269
+ <footer>悟空AI · 云站平台</footer>${autoClose ? `\n${autoCloseScript(autoCloseDelayMs)}` : ''}
270
+ </body>
271
+ </html>`;
272
+ return { title, html };
273
+ }
274
+
275
+ /**
276
+ * 授权成功页 —— 用户在本机回调里**唯一**该看到的结论。
277
+ *
278
+ * 为什么必须存在(老板 2026-10-01 亲眼看过的现场):
279
+ * 点完「同意」后浏览器会跳到 `http://127.0.0.1:53682/callback?code=…`。
280
+ * 如果那一刻本机没有 CLI 在监听,浏览器甩出的是 `ERR_CONNECTION_REFUSED`
281
+ * 「无法访问此网站」——用户会以为**授权失败**,然后反复重来。
282
+ * 所以只要回调真的到达了 CLI,就必须给出一个明确的、中文的、体面的成功页。
283
+ *
284
+ * 文案分区(老板指定):大标题 / 副文案(回终端)/ 已登录账号 / 小字说明。
285
+ *
286
+ * ## 会尝试自动关闭标签页的页面之一(`autoClose: true`)
287
+ * 这张页只在 `login.mjs` 里 **`api.token(...)` 换到令牌 → `writeCredentials(...)` 写盘之后**
288
+ * 才被返回,所以"授权成功"是**已经落地的事实**,不是"收到了 code"这种半成品状态
289
+ * —— 这是与阿里云 `mcp-remote` 最关键的区别(它收到 code 就宣告成功并关窗,换票失败时
290
+ * 用户已经被打发走了)。详见 `autoCloseScript` 的注释。
291
+ * ⚠️ 副文案里的「本页面可以关闭了」和 hint 里的"直接关闭标签页"是**兜底**,
292
+ * 关不掉时用户照着做就行,两条都不许删(单测钉住)。
293
+ *
294
+ * @param {object|null} account `userinfo` 的返回(可能为 null:拿不到账号信息)
295
+ */
296
+ export function successPage(account) {
297
+ return renderPage({
298
+ tone: 'ok',
299
+ title: '授权成功 · 悟空AI',
300
+ heading: '授权成功',
301
+ lead: '请回到终端(客户端)继续操作,本页面可以关闭了。',
302
+ account: accountLabel(account),
303
+ note: '凭据已保存在本机,仅本次授权使用;不会显示在本页面。',
304
+ // ⚠️ 刻意**不做**假的"返回终端"按钮:网页关不掉终端窗口,点了没反应只会更困惑
305
+ hint: '本页没有需要点击的按钮:页面会尝试自动关闭;如果没有关掉,直接关闭标签页或切回终端窗口即可。',
306
+ autoClose: true,
307
+ });
308
+ }
309
+
310
+ /** 错误页统一的收尾提示(每一步失败后用户唯一该做的事) */
311
+ const RETRY_HINT = '请回到终端(客户端)重试:关掉本页,回到命令行重新运行 wkgeo login。';
312
+
313
+ /**
314
+ * 「本次登录已经完成」页 —— 设备码那条路**先**拿到令牌之后,用户后来又点的那次回调该看到的页面。
315
+ *
316
+ * ## 为什么必须有这一页(老板 2026-10-03 真机反馈的连带缺陷)
317
+ * 旧行为:首轮等待到点 → CLI 先**关掉本地回调监听**、再改走设备码。于是用户随后在浏览器里点
318
+ * 【同意授权】时,浏览器跳到 `http://127.0.0.1:<port>/callback?code=…` 直接得到
319
+ * **ERR_CONNECTION_REFUSED**(真机截图见过)—— 他会以为"授权失败了",然后再登录一次,
320
+ * 而其实他**早就登录成功了**。
321
+ * 修复后本地监听会保留到本次登录收尾(见 login.mjs),所以那种"连接被拒绝"不会再出现;
322
+ * 而在"设备码先成功"的时序里,迟到的回调就由这一页收尾。
323
+ *
324
+ * ## ⚠️ 与「授权成功页」(successPage)的关键区别
325
+ * 这一页出现的时刻,**令牌不是这次回调换来的**(凭据早就由设备码那条路写好了)。所以文案必须
326
+ * 说清"登录已经完成、不用再点",而不是"授权成功" —— 否则用户会以为自己刚才那一下才是关键,
327
+ * 下一回还会去重复点、甚至怀疑第一次没成功。
328
+ *
329
+ * ## 安全底线(与其它页完全一致)
330
+ * * **不回显**回调 URL 里的 `code`(模板里根本没有接收它的位置),页面里不出现任何令牌;
331
+ * * 账号标识走 `accountLabel()` 脱敏 + `renderPage` 里的转义;
332
+ * * 这是**终态**(令牌已在手、凭据已写盘)⇒ 与成功页一样带上"尝试自动关闭标签页"
333
+ * (真机上用户点完就想走,留着这张页只是让他确认"没出错")。
334
+ *
335
+ * @param {object|null} account `userinfo` 的返回(可能为 null:拿不到账号信息)
336
+ */
337
+ export function alreadyDonePage(account) {
338
+ return renderPage({
339
+ tone: 'ok',
340
+ title: '本次登录已经完成 · 悟空AI',
341
+ heading: '本次登录已经完成',
342
+ lead: '你刚才已经在另一个页面完成过授权了,这一次不需要再点;本页面可以关闭了。',
343
+ account: accountLabel(account),
344
+ note: '凭据已保存在本机,仅本次授权使用;不会显示在本页面。',
345
+ hint: '本页没有需要点击的按钮:页面会尝试自动关闭;如果没有关掉,直接关闭标签页或切回终端窗口即可。',
346
+ autoClose: true,
347
+ });
348
+ }
349
+
350
+ /**
351
+ * 错误页 —— 失败分支**也要有像样的页面**,不能回一段纯文本。
352
+ *
353
+ * 为什么(真实体验问题):用户是"点完同意"被跳回本机的,此刻他
354
+ * 并不知道发生了什么。回纯文本 `not found` / 白屏,等于让他去猜;
355
+ * 而这几种失败(state 对不上、缺 code、换票失败)**原因完全不同**,
356
+ * 有的只要重试、有的要重新发起授权。所以:
357
+ * * 颜色区分等级(`warn` 琥珀 = 这次没成但不一定是错;`error` 红 = 确实失败了);
358
+ * * `reason` 必须是**明确的中文原因**(不出现英文栈、不出现令牌);
359
+ * * 永远带一句"请回到终端重试"。
360
+ *
361
+ * @param {object} spec
362
+ * @param {'warn'|'error'} [spec.tone]
363
+ * @param {string} spec.heading 大标题(短,一眼能懂)
364
+ * @param {string} spec.reason 明确的中文原因
365
+ * @param {string} [spec.hint] 补充说明(例如"没有写入任何凭据")
366
+ * @param {boolean} [spec.autoClose] 是否尝试自动关闭(默认 **true**,0.2.4 老板反馈"关不掉")
367
+ * @param {number} [spec.autoCloseDelayMs] 首次关闭延迟(默认 6000ms:先让用户看清原因)
368
+ *
369
+ * ## 0.2.4(2026-10-21 老板反馈「127 那个页面关不掉」)
370
+ * 失败页**也**尝试自动关闭,但延迟 6 秒 —— 既不让用户卡死在一个已经结束的页面上,
371
+ * 也留够时间看清"为什么没成"。正文(原因 + 回终端重试)全部是静态 HTML,
372
+ * 脚本关不掉时页面照旧可读,且带「直接关闭标签页」的兜底文案。
373
+ * ⚠️ 仍然**不允许**把失败页做成"一出来就关":失败原因是排障的唯一线索,
374
+ * 而且其中"state 校验失败 / 缺少授权码 / 405"出现时 CLI 还在等真正的回调,
375
+ * 用户可能正照着页面说明重试。延迟关闭是这两者之间的折中。
376
+ * ⚠️ 任何页面都绝不回显 code / 令牌(模板里没有接收它们的位置)。
377
+ */
378
+ export function errorPage({ tone = 'error', heading, reason, hint, autoClose = true, autoCloseDelayMs = 6000 } = {}) {
379
+ const seconds = Math.max(1, Math.round(autoCloseDelayMs / 1000));
380
+ const closeHint = autoClose
381
+ ? `本页面会在约 ${seconds} 秒后自动关闭;如果没有关掉,直接关闭标签页即可。`
382
+ : '看完后直接关闭标签页即可。';
383
+ return renderPage({
384
+ tone,
385
+ title: `${heading} · 悟空AI`,
386
+ heading,
387
+ lead: reason,
388
+ note: hint,
389
+ hint: `${RETRY_HINT} ${closeHint}`,
390
+ autoClose,
391
+ autoCloseDelayMs,
392
+ });
393
+ }
package/lib/pkce.mjs ADDED
@@ -0,0 +1,48 @@
1
+ /**
2
+ * PKCE(RFC 7636)与随机数工具 —— 全部用 node:crypto,零依赖。
3
+ *
4
+ * 为什么必须有 PKCE:
5
+ * 我们是**公共客户端**(CLI 没有能力保管 client_secret),授权码又是通过
6
+ * 回环地址回调交给本地进程的 —— 同机器上的其它程序理论上能抢到那个 code。
7
+ * PKCE 让"抢到 code 也换不了票"(换票必须出示 code_verifier,而它从头到尾只在内存里)。
8
+ * 服务端对公共客户端是**强制**校验 PKCE 的,缺了直接 400。
9
+ *
10
+ * 踩过的坑:
11
+ * * code_verifier 只允许 `[A-Za-z0-9-._~]`,长度 43~128。base64url 出来的字符集是它的子集,
12
+ * 32 字节随机数 → 43 个字符,刚好卡在下限(少一个字节就非法了)。
13
+ * * challenge 必须是 `base64url(sha256(ascii(verifier)))`,**不是** hex,也不能带 padding。
14
+ */
15
+
16
+ import crypto from 'node:crypto';
17
+
18
+ /** base64url(去 padding、`+`→`-`、`/`→`_`)—— Buffer 自带这个编码 */
19
+ export function base64url(buf) {
20
+ return Buffer.from(buf).toString('base64url');
21
+ }
22
+
23
+ /** 生成 code_verifier:32 字节 → 43 字符(RFC 7636 允许 43~128) */
24
+ export function createVerifier(bytes = 32) {
25
+ return base64url(crypto.randomBytes(bytes));
26
+ }
27
+
28
+ /** S256 challenge = base64url(sha256(verifier)) */
29
+ export function challengeOf(verifier, method = 'S256') {
30
+ if (method !== 'S256') throw new Error(`不支持的 code_challenge_method: ${method}(服务端只认 S256)`);
31
+ return base64url(crypto.createHash('sha256').update(String(verifier), 'ascii').digest());
32
+ }
33
+
34
+ /**
35
+ * state:防 CSRF。
36
+ * 服务端只负责**原样回传**,校验是客户端自己的责任 —— 不校验就等于没有防重放/防串号。
37
+ */
38
+ export function createState(bytes = 16) {
39
+ return base64url(crypto.randomBytes(bytes));
40
+ }
41
+
42
+ /** 恒定时间比较:state 比对不要用 `===`(虽然 state 不是密钥,但习惯要好) */
43
+ export function safeEqual(a, b) {
44
+ const ba = Buffer.from(String(a));
45
+ const bb = Buffer.from(String(b));
46
+ if (ba.length !== bb.length) return false;
47
+ return crypto.timingSafeEqual(ba, bb);
48
+ }