@wkgeo/cli 1.1.1 → 1.1.2

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 CHANGED
@@ -4,17 +4,31 @@
4
4
 
5
5
  ---
6
6
 
7
- ## 1.1.1 · 2026-11-09
8
-
9
- **默认域名 `.com` → `.cn`**:`wkgeo.com` 已无 A 记录、全面退役,CLI 默认地址全部改用 `https://wkgeo.cn`。
10
-
11
- - `DEFAULT_OAUTH_WEB_BASE` / `DEFAULT_USER_WEB_BASE` → `https://wkgeo.cn/oauth`、`https://wkgeo.cn/user`;
12
- 修复设备码授权页给出打不开网址的问题(旧默认 `https://wkgeo.com/oauth` 已不可访问)。
13
- - 预览地址 → `https://wkgeo.cn/cms/preview/...`;模板预览、manifest `$id`、UA 域名同步 `.cn`。
14
- - 兼容保留:`WKONGAI_OAUTH_WEB_BASE=https://oauth.wkgeo.com` 等旧站回滚开关仍可用。
15
-
16
- ---
17
-
7
+ ## 1.1.2 · 2026-11-09
8
+
9
+ **`--open-browser` / `WKONGAI_OPEN_BROWSER=1` 可压过「非交互」判定**:AI 子进程 / 管道 / CI 里只要显式要求,
10
+ 就真的用默认浏览器打开授权页(以前一律只打印链接,要用户自己复制)。
11
+
12
+ - `wkgeo login --open-browser` 在非 TTY / AI 子进程里 → 照旧**尝试打开默认浏览器**(`mode:"forced"`);
13
+ - 新增环境变量 `WKONGAI_OPEN_BROWSER=1`(`1`/`true`/`yes`/`on`)→ 同样压过非交互判定(`mode:"agent"`),
14
+ 适合"让本机以后任何 AI 子进程跑 `wkgeo login` 都自动弹浏览器授权";
15
+ - 优先级不变:`--no-browser`(及 `WKONGAI_CLI_NO_BROWSER=1`)仍**最高**,`skipped_reason:"no_browser"`;
16
+ 两个开关都不给时,非交互 / CI 依旧只输出链接(`skipped_reason:"non_interactive"`)。
17
+ - 影响面:`login`(回调 / 设备码)与 `wallet recharge` / `recharge-link` 共用同一道闸门(`resolveBrowserIntent`)。
18
+
19
+ ---
20
+
21
+ ## 1.1.1 · 2026-11-09
22
+
23
+ **默认域名 `.com` → `.cn`**:`wkgeo.com` 已无 A 记录、全面退役,CLI 默认地址全部改用 `https://wkgeo.cn`。
24
+
25
+ - `DEFAULT_OAUTH_WEB_BASE` / `DEFAULT_USER_WEB_BASE` → `https://wkgeo.cn/oauth`、`https://wkgeo.cn/user`;
26
+ 修复设备码授权页给出打不开网址的问题(旧默认 `https://wkgeo.com/oauth` 已不可访问)。
27
+ - 预览地址 → `https://wkgeo.cn/cms/preview/...`;模板预览、manifest `$id`、UA 域名同步 `.cn`。
28
+ - 兼容保留:`WKONGAI_OAUTH_WEB_BASE=https://oauth.wkgeo.com` 等旧站回滚开关仍可用。
29
+
30
+ ---
31
+
18
32
  ## 未发布 · 2026-10-30(`sites create` 原语化,发版时把包版本从 1.1.0 提到 1.2.0)
19
33
 
20
34
  **`sites create` 收口为「平台原语」:建站 → 可选装模板 → 可选发布;三来源(抓网址 / 解析文件)整块移出 CLI**(task-61)。
package/README.md CHANGED
@@ -152,7 +152,8 @@ wkgeo login
152
152
 
153
153
  会发生什么(**用户实际会看到的东西**):
154
154
 
155
- 1. 终端打印一条授权网址(**人在终端时**会尽力自动打开浏览器;**CI/管道/AI 子进程只输出链接**,见下);
155
+ 1. 终端打印一条授权网址(**人在终端时**会尽力自动打开浏览器;**CI/管道/AI 子进程**默认只输出链接,
156
+ 但加 `--open-browser` 或设 `WKONGAI_OPEN_BROWSER=1` 也会真的打开,见下);
156
157
  2. 浏览器里是**我们自己的登录页**:支持「账密登录 / 手机号登录 / 邮箱登录」三个页签
157
158
  (手机号/邮箱是**验证码登录**,验证码由平台下发到已绑定的手机/邮箱);
158
159
  3. 登录后进入**同意页**,显示应用名「官方 CLI」和将获得的权限,点「同意」;
@@ -172,8 +173,8 @@ wkgeo login
172
173
  | 选项 | 说明 |
173
174
  | --- | --- |
174
175
  | `--device` | 用**设备码模式**(RFC 8628):不需要本地回调地址/端口;本地读不了回调时的兜底(见 §3.2) |
175
- | `--no-browser` | **不打开浏览器**(优先级最高,压过 `--open-browser`)。⚠️ 非交互/CI 环境本来就不会打开,这个开关主要用于终端/脚本显式表态 |
176
- | `--open-browser` | 强制尝试打开系统浏览器(⚠️ **只在人类终端生效**;CI/非交互环境仍不打开;保留显式语义与兼容) |
176
+ | `--no-browser` | **不打开浏览器**(优先级最高,压过 `--open-browser` 与 `WKONGAI_OPEN_BROWSER=1`) |
177
+ | `--open-browser` | 强制尝试打开系统浏览器(**压过非交互判定**:AI 子进程 / 管道 / CI 里也真的打开;`--no-browser` 仍然更优先)。等价于一次性设 `WKONGAI_OPEN_BROWSER=1` |
177
178
  | `--scope "site:read site:write billing:self"` | 申请的能力范围(默认就是这三个,够建站+下单+支付) |
178
179
  | `--client-id <id>` | 换一个 OAuth 客户端(默认 `wkgeo-cli`) |
179
180
  | `--callback-port <n>` | 本地回调端口(默认 53682;被占用会自动退到随机端口) |
@@ -198,8 +199,12 @@ wkgeo login
198
199
  > * `WKONGAI_CLI_NO_BROWSER=1`(`true/yes/on` 也认)。
199
200
  > 此时 `open_browser.attempted=false`、`skipped_reason:"non_interactive"`(字段结构不变),
200
201
  > 并打印「把授权链接转给有浏览器的用户 / 改用 `wkgeo login --device`」的可照做提示;
201
- > * `--no-browser` → **不打开**(`skipped_reason:"no_browser"`,**优先级最高**,压过 `--open-browser`);
202
- > * `--open-browser` **保留**,但只在终端里保留显式语义(**压不过**非交互判定:CI 里写它也不弹);
202
+ > * `--no-browser` → **不打开**(`skipped_reason:"no_browser"`,**优先级最高**,压过 `--open-browser` 与 `WKONGAI_OPEN_BROWSER=1`);
203
+ > * ★ **2026-11-09 起 `--open-browser` / `WKONGAI_OPEN_BROWSER=1` 压过非交互判定**:
204
+ > 在上面"非交互 / CI"环境里,只要写了 `--open-browser`(`mode:"forced"`)或设了
205
+ > `WKONGAI_OPEN_BROWSER=1`(`1/true/yes/on`,`mode:"agent"`),CLI 就**真的尝试打开默认浏览器**——
206
+ > 典型场景是 AI 子进程代跑 `wkgeo login`、由人在本机浏览器里点「同意」。
207
+ > 两个开关都不给时,非交互 / CI 仍**只输出链接**(老行为不变);
203
208
  > * `--json` 的 `open_browser.skipped_reason` 合法值:`null`(真尝试过)/ `"no_browser"` / `"non_interactive"`
204
209
  > (2026-10-01 那版的 `"non_tty_agent_mode"` **已弃用**);
205
210
  > * 打开成功 → `✅ 已为你打开浏览器,请在那里完成授权。`;打开失败 → ⚠️ 一段**含完整 URL** 的醒目提示
@@ -965,7 +970,7 @@ wkgeo context export --format md --out .\site-context.md
965
970
  > * 打开成功 → `✅ 已为你打开浏览器,请在那里完成支付(微信扫码)。`;
966
971
  > * 打开失败 → ⚠️ 一段**含完整收银台地址**的醒目提示(走 stderr,stdout 仍然只有机器可读 JSON);
967
972
  > * `--no-browser` → `skipped_reason = "no_browser"`(最高优先级);
968
- > * `--open-browser` 保留,但只在终端里生效(非交互仍不弹)。
973
+ > * `--open-browser` / `WKONGAI_OPEN_BROWSER=1` → **压过非交互判定**,非交互 / AI 子进程里也会真的弹浏览器。
969
974
  >
970
975
  > ★ **`pay_url` 上的 `token=`(2026-10-02 新增)**:服务端在**下单那一刻**把"这一单是谁的"
971
976
  > 签成一把**只对这一单有效**的令牌(`createRechargeOrder` 返回的 `pay_token`),
@@ -1078,6 +1083,7 @@ node aliyun/fc/_tests/oauth-device-live-e2e.js # 结束按 su
1078
1083
  | `WKONGAI_CALLBACK_FIRST_WAIT_MS` | 未设置 | ★ **可选**的"首轮等待"(毫秒,**默认关闭**):只有显式设了它(或命令行 `--callback-first-wait`),这段时间没等到回调才会自动改用设备码继续(**本地回调监听会同时保留**);`0` 关闭(等价于 `--callback-first-wait 0`)。⚠️ **未设置时一律不启用**(0.2.2 起:等待超时不再自动改设备码;老板 2026-10-21:「默认的就是那个传统的授权方式」) |
1079
1084
  | `WKONGAI_AUTO_DEVICE` | `1`(开) | 检测到系统代理时是否自动改用设备码;设 `0`/`false`/`no`/`off` 关闭(等价于 `--no-auto-device`,会打印"代理可能吃掉回调"的警告) |
1080
1085
  | `WKONGAI_CLI_NO_BROWSER` | 未设置 | ★ **2026-10-21**:设 `1`/`true`/`yes`/`on` = **不自动打开浏览器**(`open_browser.skipped_reason = "non_interactive"`)。给"没有 CI 环境变量但确实在无浏览器环境"的容器/远程场景用 |
1086
+ | `WKONGAI_OPEN_BROWSER` | 未设置 | ★ **2026-11-09**:设 `1`/`true`/`yes`/`on` = **压过非交互判定**,AI 子进程 / 管道 / CI 里也**真的打开系统默认浏览器**去授权页(`mode:"agent"`,等价于每次都写 `--open-browser`)。`--no-browser` / `WKONGAI_CLI_NO_BROWSER=1` 仍然更优先 |
1081
1087
  | `CI` / `GITHUB_ACTIONS` / `GITLAB_CI` / `JENKINS_URL` / `TF_BUILD` / `BUILDKITE` / `TEAMCITY_VERSION` | 未设置 | ★ **2026-10-21**:**存在任一即判定为非交互**(不看值)→ **不自动打开浏览器**,只输出链接/JSON |
1082
1088
  | `NO_COLOR` | — | 设了就不上色 |
1083
1089
 
package/SKILL.md CHANGED
@@ -401,17 +401,20 @@ npx -y @wkgeo/cli@latest login --json --timeout 500ms # 也可以显式写毫
401
401
  > * **人类终端**(stdout 是 TTY、且不在 CI 里)→ **尝试自动打开**系统浏览器;
402
402
  > * **非交互 / CI**(stdout 非 TTY / 管道 / AI 子进程;或存在 `CI`、`GITHUB_ACTIONS`、
403
403
  > `GITLAB_CI`、`JENKINS_URL`、`TF_BUILD`、`BUILDKITE`、`TEAMCITY_VERSION`;或
404
- > `WKONGAI_CLI_NO_BROWSER=1`)→ **只输出链接/JSON,一个浏览器进程都不 spawn**,
404
+ > `WKONGAI_CLI_NO_BROWSER=1`)→ **默认只输出链接/JSON,一个浏览器进程都不 spawn**,
405
405
  > `open_browser.attempted=false`、`skipped_reason="non_interactive"`;
406
406
  > * 实现是**多策略依次尝试**(每条都看退出码/错误/超时,失败静默试下一条):
407
407
  > * 成功 → `✅ 已为你打开浏览器,请在那里完成授权。`(紧跟着一句"授权成功后页面会自动尝试关闭");
408
408
  > * 全部失败 → `⚠️ 浏览器没能自动打开,请手动复制这个地址到浏览器完成授权:` + **紧跟一行完整 URL**
409
409
  > (**绝不中断**授权;AI 场景再多一句"客户端支持内置浏览器也可以在那里打开"的**可选**提示);
410
410
  > * `--no-browser` → **不打开**(`open_browser.skipped_reason = "no_browser"`,最高优先级,
411
- > 压过 `--open-browser`);
412
- > * `--open-browser` → 只在终端里保留显式语义(**压不过**非交互判定,CI 里写它也不弹)。
411
+ > 压过 `--open-browser` 与 `WKONGAI_OPEN_BROWSER=1`);
412
+ > * ★ **2026-11-09 起 `--open-browser` / `WKONGAI_OPEN_BROWSER=1` 压过非交互判定**:
413
+ > 上面那些非交互环境里,只要写了 `--open-browser`(`mode:"forced"`)或设了 `WKONGAI_OPEN_BROWSER=1`
414
+ > (`1/true/yes/on`,`mode:"agent"`),CLI 就**真的尝试打开默认浏览器**去授权页 —— 这正是
415
+ > "AI 子进程代跑 `wkgeo login`、由人在本机浏览器点同意"的场景。两个都不给时才只输出链接。
413
416
  > 所以 AI **不需要**自己判断"该不该开浏览器",但**永远要**把 `authorization_url` 原文转述给用户
414
- > (CI/非交互环境里,这一步就是**唯一**的交付方式)。
417
+ > (CLI 确实没弹时,这一步就是**唯一**的交付方式)。
415
418
 
416
419
  **AI 的正确做法**:
417
420
 
@@ -638,8 +641,8 @@ Set-Content -LiteralPath "$env:USERPROFILE\.dsh\browser-open.txt" -Value "<完
638
641
  | --- | --- |
639
642
  | **人类终端**(stdout 是 TTY、无 CI 信号) | ✅ **会尝试打开** |
640
643
  | **CI / 非交互**(stdout 非 TTY / 管道 / AI 子进程;`CI`、`GITHUB_ACTIONS`、`GITLAB_CI`、`JENKINS_URL`、`TF_BUILD`、`BUILDKITE`、`TEAMCITY_VERSION` 任一存在;`WKONGAI_CLI_NO_BROWSER=1`) | ❌ **绝不弹**(`skipped_reason:"non_interactive"`,只输出链接/JSON) |
641
- | 加了 `--no-browser` | ❌ **不打开**(**优先级最高**,压过 `--open-browser`;`skipped_reason:"no_browser"`) |
642
- | 加了 `--open-browser` | ✅ 只在**终端**里会(⚠️ 压不过非交互判定;别依赖它去"开启") |
644
+ | 加了 `--no-browser` | ❌ **不打开**(**优先级最高**,压过 `--open-browser` 与 `WKONGAI_OPEN_BROWSER=1`;`skipped_reason:"no_browser"`) |
645
+ | 加了 `--open-browser`(或设了 `WKONGAI_OPEN_BROWSER=1`) | ✅ **会**(★ 2026-11-09:压过非交互判定,AI 子进程 / 管道 / CI 里也真的打开;`--no-browser` 仍然更优先) |
643
646
 
644
647
  * **`--json` 里的结构化字段 `open_browser`**:`{attempted, opened, tried, url, skipped_reason}`
645
648
  (结构与取值口径**没有变**)—— `skipped_reason` 有三种取值:
@@ -767,8 +770,9 @@ npx -y @wkgeo/cli@latest orders check <order_id> # 用
767
770
  **原样打开**即可,**不要**把 `token` 单独摘出来展示、更不要放进对话正文里当"验证码"念给用户;
768
771
  * 它**只**授权"读这一单的支付参数":读不到钱包、读不到订单列表、不能下单、不能取消,
769
772
  而且 30 分钟(= 订单有效期)后自动失效(失效时页面会明确说"支付链接已过期,请重新下单")。
770
- ⚠️ 非交互/CI 环境(容器、管道、AI 子进程)**本来就不会弹**:`open_browser.skipped_reason = "non_interactive"`,`pay_url` 照常输出;
771
- ⚠️ 终端里 `--open-browser` 保留显式语义(**非交互/CI 仍不弹**);要显式不弹用 `--no-browser`(`skipped_reason = "no_browser"`,优先级最高)。
773
+ ⚠️ 非交互/CI 环境(容器、管道、AI 子进程)**默认不会弹**:`open_browser.skipped_reason = "non_interactive"`,`pay_url` 照常输出;
774
+ ⚠️ `--open-browser` / `WKONGAI_OPEN_BROWSER=1` **压过非交互判定**(★ 2026-11-09:非交互环境里也会真的弹);
775
+ 要显式不弹用 `--no-browser`(`skipped_reason = "no_browser"`,优先级最高)。
772
776
  ⚠️ 打开 `pay_url` 的方式见 **§5.5**:人类终端会自动弹系统浏览器;
773
777
  只有它**没打开成功**(或非交互环境)时,才考虑可选地在客户端**内置浏览器 / 侧边面板**里打开。
774
778
 
@@ -787,7 +791,7 @@ npx -y @wkgeo/cli@latest wallet recharge-link # 默认不弹浏览器
787
791
  # ★ 有效期只有 10 分钟、且**用掉即失效**(一次性):过期/已用过时页面会明确提示"请重新获取",
788
792
  # 这时**重新跑一次本命令**拿一条新链接即可(不要反复让用户刷新旧链接)。
789
793
  # ★ 默认**不**打开浏览器(这条命令通常跑在服务器/容器里,且交接物是链接);
790
- # 确实要在**人类终端**里弹出时加 --open-browser(CI/非交互仍不弹);--no-browser 优先级最高。
794
+ # 写 --open-browser(或设 WKONGAI_OPEN_BROWSER=1)就真的弹(★ 2026-11-09:压过非交互判定);--no-browser 优先级最高。
791
795
  # ★ ticket 只是"建一笔充值单"的窄凭证:⛔ 不要把它当登录凭据、不要拿它去调别的 action。
792
796
  npx -y @wkgeo/cli@latest orders check <order_id> # 用户说付完了再查(order_id 从他那句"付完了"对应的单拿)
793
797
  ```
package/lib/login.mjs CHANGED
@@ -648,12 +648,24 @@ export function nonInteractiveBrowserHintLines({ kind = 'auth', reason = '', cmd
648
648
  export function resolveBrowserIntent({ isTTY = false, json = false, forceOpen = false, noBrowser = false, env = {} } = {}) {
649
649
  // ① 用户明确关掉:连 `--open-browser` 也不许把它顶回来(--no-browser 优先)
650
650
  if (noBrowser === true) return { allow: false, mode: 'off', skipped_reason: 'no_browser' };
651
- // ② 非交互 / CI:**只输出链接**,不 spawn 任何浏览器(压过 --open-browser)
651
+ /**
652
+ * ② **显式要求弹浏览器**:压过"非交互环境"判定(老板 2026-11-09 定)。
653
+ *
654
+ * 背景:AI 子进程 / 管道里 stdout 不是终端,旧逻辑一律只打印链接;
655
+ * 但"AI 代跑 CLI、由人在本机浏览器里点授权"是常见场景(老板就是这样用),
656
+ * 而且用户写了 `--open-browser` 就是明确要开浏览器 —— 这条不能被非交互判定吃掉。
657
+ * 想保持"只打印链接"就写 `--no-browser`(① 优先级最高)。
658
+ */
659
+ const envForce = ['1', 'true', 'yes', 'on'].includes(
660
+ String((env && env.WKONGAI_OPEN_BROWSER) || '').trim().toLowerCase(),
661
+ );
662
+ if (forceOpen === true || envForce) {
663
+ return { allow: true, mode: forceOpen === true ? 'forced' : 'agent', skipped_reason: null };
664
+ }
665
+ // ③ 非交互 / CI:**只输出链接**,不 spawn 任何浏览器
652
666
  if (detectNonInteractive({ isTTY, env }).nonInteractive) {
653
667
  return { allow: false, mode: 'off', skipped_reason: 'non_interactive' };
654
668
  }
655
- // ③ 用户明确要求打开(已在终端里):保留显式语义与兼容
656
- if (forceOpen === true) return { allow: true, mode: 'forced', skipped_reason: null };
657
669
  // ④ 人在终端:保持 CLI 一直以来的体验(这条**不能**破坏)
658
670
  if (isTTY === true && json !== true) return { allow: true, mode: 'terminal', skipped_reason: null };
659
671
  // ⑤ TTY + --json:人还在终端,照旧打开(`json` 只影响 mode 诊断字段)
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@wkgeo/cli",
3
- "version": "1.1.1",
3
+ "version": "1.1.2",
4
4
  "description": "云站平台官方命令行客户端(@wkgeo/cli):授权登录一次,之后建站 / 下单 / 钱包支付 / 查余额都不用再登录(OAuth 授权码 + PKCE,公共客户端,零第三方依赖)",
5
5
  "keywords": [
6
6
  "wkgeo",