wkgeo-cli 0.2.2 → 0.2.4

package/lib/page.mjs

@@ -21,9 +21,10 @@
  *   3. **不依赖 JavaScript**：正文（结论 + 账号 + 兜底文案）全部是静态 HTML + CSS。
  *      这个页面出现的时机很敏感（用户刚在同意页点完"同意"），任何脚本报错
  *      都会让人以为授权失败，所以脚本只能做**锦上添花**的事，绝不能承载信息。
- *      目前唯一的脚本是**成功页**上的"尝试自动关闭标签页"（见 `AUTO_CLOSE_SCRIPT`）：
+ *      目前唯一的脚本是"尝试自动关闭标签页"（见 `autoCloseScript`）：
  *      它失败 / 被浏览器拒绝 / 被用户插件拦掉，页面照旧完整可读。
- *      ⚠️ 它**只**出现在成功页（那是换到令牌、凭据写盘之后的页），错误页一律没有脚本。
+ *      ⚠️ 0.2.4 起成功页与失败页都会带它（老板反馈「页面关不掉」），
+ *      差别只在延迟（成功 1.2s / 失败 6s），正文永远是静态可读的。
  *   4. **所有动态内容必须转义**（`escapeHtml`）。账号标识来自服务端 `userinfo`，
  *      其中昵称是**用户自己可控**的字符串，直接拼进 HTML 就等于在本机页面上
  *      开一个自伤型 XSS（本机页面同样能去访问 `http://127.0.0.1` 上的其它服务）。
@@ -168,43 +169,27 @@ function badgeSvg(tone) {
 }
 
 /**
- * 「尝试自动关闭标签页」的极简内联脚本 —— **只给"确实成功"的成功页用**。
+ * 「尝试自动关闭标签页」的极简内联脚本。
  *
  * ## 为什么加这段（老板 2026-10-01 对比阿里云 MCP 的实测结论）
  *   老板的原话：阿里云那套"点完授权，页面**自动就关了**，这样看着很正常"。
- *   我们的现状是：跳回本机后留一张成功页，**要用户自己动手关**——不够顺。
+ *   我们的现状是：跳回本机后留一张页面，**要用户自己动手关**——不够顺。
  *
- * ## 🔴 但我们**不抄它的时机**（这是它源码里实打实的坑）
- *   阿里云 `mcp-remote` 是在本地回调**刚收到 `code`** 的那一刻就把页面发回去、
- *   页面立刻 `window.close()`，而此刻它还**没有 POST token 端点换令牌**：
- *     `authCompletedResolve(code); res.send('Authorization successful! …<script>window.close();</script>')`
- *   —— 一旦接下来换票失败，用户已经被打发走了（窗口都关了），却只记得"它说我成功了"。
- *   所以本项目的口径是：
- *     * **只有** CLI 真的换到令牌、并且凭据已经写进本机之后的**那张成功页**才尝试关闭
- *       （对应 `login.mjs` 里 `api.token(...)` → `writeCredentials(...)` → `successPage(...)`
- *        这个顺序，**不许调换**）；
- *     * 中间态页面（例如"正在换取令牌…"）即使将来真加了，也**不自动关闭**，统一由成功页收尾；
- *     * 错误页（state 失败 / 缺少授权码 / 授权未完成·拒绝 / 换票失败 / 405）**一律不关**，
- *       详见 `errorPage` 的说明。
+ * ## 0.2.4（2026-10-21 老板反馈「127 那个页面关不掉」）
+ *   **授权成功页和失败页都要能自动关闭**，避免用户卡在一个已经结束的页面上。
+ *   页面仍然保留「本页面可以关闭了 / 直接关闭标签页」的兜底文案（浏览器只允许脚本关闭
+ *   **由脚本打开的**窗口，我们这张页大概率关不掉，文案就是兜底）。
+ *   * 成功页：延迟 1.2 秒关（先让用户看清「授权成功」再关，上来就关会让人以为页面崩了）；
+ *   * 失败页：延迟 6 秒关（失败原因要留够时间看清楚，但绝不能永远留在屏幕上）。
  *
- * ## ⚠️ 另一个关键事实：这一段**大概率关不掉**，所以它是"尽力而为 + 兜底文案"
- *   浏览器有一条硬规则：**只允许脚本关闭"由脚本打开的窗口"**（`window.open` 打开的那类）。
- *   我们这张页面是用户点同意后由**系统命令打开的那个浏览器**里导航过来的
- *   （`openInBrowser` 走 rundll32 / open / xdg-open），对浏览器来说它是
- *   "用户自己打开的标签页"，`window.close()` 通常被**静默忽略**
- *   （Chrome / Edge 控制台里会留一句 "Scripts may close only the windows that
- *   were opened by them"，Firefox 类似）。
- *   所以：
- *     * 这段脚本**不是**"关掉页面"的保证，只是"能关就顺手关掉"；
- *     * 页面上那句「本页面可以关闭了」**必须保留**——它就是给关不掉的情况兜底的；
- *     * 绝不为了"看起来关掉了"去做跳转 / 假按钮 / alert（那才是骗用户）。
+ * ## 🔴 时机约束（阿里云 `mcp-remote` 踩过的坑，别翻回去）
+ *   只有 CLI **真的换到令牌、并且凭据已经写进本机之后**的那张成功页才算"确实成功"；
+ *   收到 code 就宣告成功并关窗是不允许的（换票失败时用户已经被打发走，只剩疑惑）。
+ *   失败页虽然也自动关，但原因文案必须完整可读，且页面里**不出现任何令牌/授权码**。
  *
  * ## 为什么延迟 + 重试两次
- *   * **延迟 1.2 秒**：先让用户看清「授权成功」这四个字再关。上来就关，
- *     用户会以为自己点错了、页面崩了（这正是老板说阿里云"看着正常"的反面：
- *     页面一闪而过同样让人发慌）。
- *   * **再试一次**：部分浏览器（含移动端内核）对第一次 `close()` 会忽略、
- *     第二次才生效；也有的是 DOM 尚未稳定时忽略。重试成本几乎为零，所以试两次。
+ *   * **延迟**：先让用户看清结论；
+ *   * **再试一次**：部分浏览器（含移动端内核）对第一次 `close()` 会忽略、第二次才生效。
  *     两次之后就**不再骚扰**——继续调下去只会刷一屏控制台报错。
  *
  * ## 约束（单测钉住）
@@ -212,8 +197,12 @@ function badgeSvg(tone) {
  *     不用 `eval`；整段脚本不碰 DOM，也不接收任何数据（页面里没有令牌，脚本里更没有）。
  *   * 用 `try/catch` 包住：某些内嵌浏览器（Electron / 企业管控浏览器）里
  *     `window.close` 可能直接被禁用甚至抛异常，不能因此弄脏页面。
+ *
+ * @param {number} delayMs 首次尝试关闭前的延迟（毫秒；必须是有限正数）
  */
-const AUTO_CLOSE_SCRIPT = `<script>
+function autoCloseScript(delayMs) {
+  const delay = Number.isFinite(delayMs) && delayMs >= 0 ? Math.round(delayMs) : 1200;
+  return `<script>
 (function(){
   var n = 0;
   function tryClose(){
@@ -221,9 +210,10 @@ const AUTO_CLOSE_SCRIPT = `<script>
     try { window.close(); } catch (e) { /* 内嵌浏览器可能直接禁用，忽略 */ }
     if (n < 2) setTimeout(tryClose, 700);
   }
-  setTimeout(tryClose, 1200);
+  setTimeout(tryClose, ${delay});
 })();
 </script>`;
+}
 
 /**
  * 拼出整份文档。
@@ -237,11 +227,11 @@ const AUTO_CLOSE_SCRIPT = `<script>
  * @param {string} [spec.note]   小字说明
  * @param {string} [spec.hint]   更小的补充提示
  * @param {boolean} [spec.autoClose] 是否附上"尝试自动关闭标签页"的脚本。
- *   ⚠️ 默认 `false`，而且目前**只允许成功页**用它（`successPage`）——那个页面代表
- *      "令牌已换到、凭据已写盘"，是唯一"确实成功"的终态。
- *      错误页 / 任何中间态页**不要**打开它（理由见 `AUTO_CLOSE_SCRIPT` 与 `errorPage` 的注释；
- *      顺手关掉用户正在看的失败原因，正是阿里云那套踩过的坑）。
- *      打开它的页面**必须同时**有「本页面可以关闭了」这类兜底文案（它大概率关不掉）。
+ *   0.2.4 起**成功页与失败页都打开它**（老板反馈「页面关不掉」），差别只在延迟：
+ *   成功页 1.2 秒（先看清"授权成功"），失败页 6 秒（先看清原因）。
+ *   打开它的页面**必须同时**有「本页面可以关闭了 / 直接关闭标签页」这类兜底文案
+ *   （浏览器大概率不允许脚本关闭"用户自己打开的"标签页）。
+ * @param {number} [spec.autoCloseDelayMs] 首次尝试关闭前的延迟（默认 1200ms）
  */
 export function renderPage({
   title,
@@ -252,6 +242,7 @@ export function renderPage({
   note,
   hint,
   autoClose = false,
+  autoCloseDelayMs = 1200,
 } = {}) {
   const parts = [badgeSvg(tone), `<h1>${escapeHtml(heading)}</h1>`];
   if (lead) parts.push(`<p class="lead">${escapeHtml(lead)}</p>`);
@@ -275,7 +266,7 @@ export function renderPage({
 <main class="card" role="main">
 ${parts.join('\n')}
 </main>
-<footer>悟空AI · 云站平台</footer>${autoClose ? `\n${AUTO_CLOSE_SCRIPT}` : ''}
+<footer>悟空AI · 云站平台</footer>${autoClose ? `\n${autoCloseScript(autoCloseDelayMs)}` : ''}
 </body>
 </html>`;
   return { title, html };
@@ -292,11 +283,11 @@ ${parts.join('\n')}
  *
  * 文案分区（老板指定）：大标题 / 副文案（回终端）/ 已登录账号 / 小字说明。
  *
- * ## 唯一会尝试自动关闭标签页的页面（`autoClose: true`）
+ * ## 会尝试自动关闭标签页的页面之一（`autoClose: true`）
  *   这张页只在 `login.mjs` 里 **`api.token(...)` 换到令牌 → `writeCredentials(...)` 写盘之后**
  *   才被返回，所以"授权成功"是**已经落地的事实**，不是"收到了 code"这种半成品状态
  *   —— 这是与阿里云 `mcp-remote` 最关键的区别（它收到 code 就宣告成功并关窗，换票失败时
- *   用户已经被打发走了）。详见 `AUTO_CLOSE_SCRIPT` 的注释。
+ *   用户已经被打发走了）。详见 `autoCloseScript` 的注释。
  *   ⚠️ 副文案里的「本页面可以关闭了」和 hint 里的"直接关闭标签页"是**兜底**，
  *      关不掉时用户照着做就行，两条都不许删（单测钉住）。
  *
@@ -372,25 +363,31 @@ export function alreadyDonePage(account) {
  * @param {string} spec.heading   大标题（短，一眼能懂）
  * @param {string} spec.reason    明确的中文原因
  * @param {string} [spec.hint]    补充说明（例如"没有写入任何凭据"）
+ * @param {boolean} [spec.autoClose] 是否尝试自动关闭（默认 **true**，0.2.4 老板反馈"关不掉"）
+ * @param {number} [spec.autoCloseDelayMs] 首次关闭延迟（默认 6000ms：先让用户看清原因）
  *
- * ## 🔴 错误页**永远不**尝试自动关闭（这里刻意连开关都不留）
- *   失败分支一共五处：`state 校验失败` / `缺少授权码` / `授权未完成`（拒绝或服务端 error）/
- *   `换取令牌失败` / `405 方法不允许`。它们全都不带自动关闭脚本，理由分两层：
- *     1. 其中三处**流程还没结束**（state 校验失败、缺 code、405 时 CLI 仍在等真正的回调），
- *        用户可能正照着这一页的说明回同意页重来 —— 自动关掉等于把线索删了；
- *     2. 另外两处虽然已经终态，但**用户必须看清原因**（"为什么没成"是排障的唯一线索，
- *        而且失败提示里那句"请回到终端重试"要留在屏幕上让人照做）。
- *   ⚠️ 这里**不提供** `autoClose` 参数：不给调用方"图省事打开"的机会。
- *      真要改这条口径，请先读完 `AUTO_CLOSE_SCRIPT` 上面那段（阿里云 `mcp-remote` 的教训）。
+ * ## 0.2.4（2026-10-21 老板反馈「127 那个页面关不掉」）
+ *   失败页**也**尝试自动关闭，但延迟 6 秒 —— 既不让用户卡死在一个已经结束的页面上，
+ *   也留够时间看清"为什么没成"。正文（原因 + 回终端重试）全部是静态 HTML，
+ *   脚本关不掉时页面照旧可读，且带「直接关闭标签页」的兜底文案。
+ *   ⚠️ 仍然**不允许**把失败页做成"一出来就关"：失败原因是排障的唯一线索，
+ *      而且其中"state 校验失败 / 缺少授权码 / 405"出现时 CLI 还在等真正的回调，
+ *      用户可能正照着页面说明重试。延迟关闭是这两者之间的折中。
+ *   ⚠️ 任何页面都绝不回显 code / 令牌（模板里没有接收它们的位置）。
  */
-export function errorPage({ tone = 'error', heading, reason, hint } = {}) {
+export function errorPage({ tone = 'error', heading, reason, hint, autoClose = true, autoCloseDelayMs = 6000 } = {}) {
+  const seconds = Math.max(1, Math.round(autoCloseDelayMs / 1000));
+  const closeHint = autoClose
+    ? `本页面会在约 ${seconds} 秒后自动关闭；如果没有关掉，直接关闭标签页即可。`
+    : '看完后直接关闭标签页即可。';
   return renderPage({
     tone,
     title: `${heading} · 悟空AI`,
     heading,
     lead: reason,
     note: hint,
-    hint: RETRY_HINT,
-    // autoClose 保持默认 false：错误页一律留在屏幕上
+    hint: `${RETRY_HINT} ${closeHint}`,
+    autoClose,
+    autoCloseDelayMs,
   });
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "wkgeo-cli",
-  "version": "0.2.2",
+  "version": "0.2.4",
   "description": "云站平台官方命令行客户端：授权登录一次，之后建站 / 下单 / 钱包支付 / 查余额都不用再登录（OAuth 授权码 + PKCE，公共客户端，零第三方依赖）",
   "keywords": [
     "wkgeo",