@geoly-ai/skills-hub 0.3.2 → 0.3.3

package/bin/skills-hub.mjs

@@ -2,6 +2,8 @@
 // 🔴 必须在任何 import 之前抑制 node:sqlite 的 ExperimentalWarning。
 // 依据：04-install.md §5.1「代价」第 2 条 —— 警告在模块导入时发出，
 // 放在适配层里抑制来不及。此处是进程内最早的可执行位置。
+import os from 'node:os';
+
 const origEmit = process.emit;
 process.emit = function (name, data, ...rest) {
   if (
@@ -19,22 +21,41 @@ process.emit = function (name, data, ...rest) {
 for (const k of Object.keys(process.env)) {
   if (k.startsWith('GEOLY_FAULT')) delete process.env[k];
 }
-// 🔴 认 HTTP_PROXY / HTTPS_PROXY / NO_PROXY —— **必须在第一次 fetch 之前**。
-//
-// Node 的内建 fetch（undici）**默认不认代理环境变量**，而 curl / npm / git 都认。
-// 后果不是「慢一点」：在企业代理后面，`install` 会以 `UND_ERR_CONNECT_TIMEOUT`
-// 直接失败，而同一台机器上 `curl` 同一个地址是通的 —— 于是看起来像我们的
-// registry 挂了。2026-09-03 在开发机上实测到，绕了两圈才找到。
+// 🔴 认 HTTP_PROXY / HTTPS_PROXY / NO_PROXY —— 只能靠**启动前**就带上变量。
 //
-// ⚠️ `NODE_USE_ENV_PROXY` 是 Node **24** 引入的；22.x 上这一行**无效**，
-//    代理后面的 22.x 用户仍然连不上。这是已知缺口，不要写成已解决。
+// Node 的内建 fetch（undici）默认**不认**代理环境变量，而 npm / git / curl 都认。
+// 后果不是「慢一点」：在企业代理后面 `install` 报 `UND_ERR_CONNECT_TIMEOUT`，
+// 而同一台机器上 `curl` 同一个地址是通的 —— 看起来像我们的 registry 挂了。
 //
-// 📌 代理不削弱安全性：HTTPS 走 CONNECT 隧道，TLS 仍是端到端；
-//    而且我们对取回的字节做的是**签名验证**，一个恶意代理改了字节只会验签失败。
+// ⚠️ **`process.env.NODE_USE_ENV_PROXY = '1'` 在进程内设置是无效的**（实测）。
+//    Node 在**启动时**读它，之后再改不算数。
+//    📌 我第一版正是那么写的，而且「验证」过它有效 —— 那是**假阳性**：
+//    当时网络恰好能直连，设不设都通。三个对照才把它钉死：
+//      ① 什么都不设        → UND_ERR_CONNECT_TIMEOUT
+//      ② 进程内设置        → UND_ERR_CONNECT_TIMEOUT   ← 无效
+//      ③ 启动前外部设置    → 302
+//    **在一个本来就会过的窗口里验证一道闸，等于没验。**
 //
-// 🔴 只在**用户没有显式表态**时设置：已经设过（哪怕设成 '0'）就尊重用户的选择。
-if (process.env.NODE_USE_ENV_PROXY === undefined) {
-  process.env.NODE_USE_ENV_PROXY = '1';
+// 所以：检测到代理配置但变量没带上时，**带着变量把自己重启一次**。
+// 🔴 三个前提缺一不可，否则不重启：
+//    · 用户没有显式表态（`NODE_USE_ENV_PROXY` 未设 —— 设成 '0' 也是表态）
+//    · 环境里确实配了代理（没配就重启纯属白费一个进程）
+//    · 不是已经重启过的那一次（防无限自我重启）
+if (
+  process.env.NODE_USE_ENV_PROXY === undefined &&
+  process.env.GEOLY_PROXY_REEXEC === undefined &&
+  ['HTTPS_PROXY', 'https_proxy', 'HTTP_PROXY', 'http_proxy'].some((k) => process.env[k])
+) {
+  const { spawnSync } = await import('node:child_process');
+  const r = spawnSync(process.execPath, [...process.execArgv, ...process.argv.slice(1)], {
+    // 🔴 `inherit`：stdin 必须原样传下去 —— `install --all` 的数量确认
+    //    要读 TTY，管道化会让它变成非交互而**静默走另一条分支**。
+    stdio: 'inherit',
+    env: { ...process.env, NODE_USE_ENV_PROXY: '1', GEOLY_PROXY_REEXEC: '1' },
+  });
+  // 被信号杀掉时用 128+signo 表示，别把它压成 0
+  if (r.signal) process.exit(128 + (os.constants.signals[r.signal] ?? 0));
+  process.exit(r.status ?? 1);
 }
 
 const { lockdown } = await import('../src/fault-inject.mjs');

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@geoly-ai/skills-hub",
-  "version": "0.3.2",
+  "version": "0.3.3",
   "description": "geoly-ai 的 skill 分发中心 —— 安装、校验、审计",
   "type": "module",
   "bin": {

package/src/download.mjs

@@ -178,10 +178,27 @@ export async function download(url, {
         //    2026-09-03 我自己被这句话挡了两轮，最后是手写探针才挖出
         //    UND_ERR_CONNECT_TIMEOUT，进而发现是代理没被认。
         const why = e.cause?.code ?? e.cause?.message ?? e.code ?? '';
-        const hint = /TIMEOUT|ETIMEDOUT|ECONNREFUSED/.test(String(why))
-          ? '\n  连不上。若你在代理后面：本 CLI 认 HTTPS_PROXY / NO_PROXY，'
-            + '但那需要 Node ≥ 24（当前 ' + process.version + '）。'
-          : '';
+        // 🔴 提示要**按当前环境分情形**，不能一句话套所有人。
+        //    我第一版无论如何都说「需要 Node ≥ 24」，而在 Node 25 上读者会
+        //    合理地认为「我满足了，那问题在别处」—— 一句正确但不适用的话，
+        //    比不说更能把人带偏。
+        let hint = '';
+        if (/TIMEOUT|ETIMEDOUT|ECONNREFUSED|ENOTFOUND|EAI_AGAIN/.test(String(why))) {
+          const major = Number(process.versions.node.split('.')[0]);
+          const hasProxyEnv = ['HTTPS_PROXY', 'https_proxy', 'HTTP_PROXY', 'http_proxy']
+            .some((k) => process.env[k]);
+          if (hasProxyEnv && major < 24) {
+            hint = `\n  你配了代理，但代理支持需要 Node ≥ 24（当前 ${process.version}）。`
+              + '\n  可以先在能直连的网络里跑一次把缓存热起来，之后 --offline 可用。';
+          } else if (hasProxyEnv && process.env.NODE_USE_ENV_PROXY === '0') {
+            hint = '\n  你配了代理，但显式设了 NODE_USE_ENV_PROXY=0 —— CLI 因此没走代理。';
+          } else if (!hasProxyEnv) {
+            hint = '\n  连不上。若你的网络需要代理，设置 HTTPS_PROXY 后重试'
+              + '（NO_PROXY 也会被尊重）。';
+          } else {
+            hint = '\n  代理已配置且已启用，但仍然连不上 —— 请检查代理本身是否可达。';
+          }
+        }
         throw new NetworkError(`${what} 下载失败：${e.message}${why ? `（${why}）` : ''}${hint}`);
       }