@cicctencent/agent-core 0.1.70 → 0.1.72

package/dist/esm/utils/system-proxy.js

@@ -0,0 +1,128 @@
+// ============================================================
+// System Proxy — 通用系统代理检测工具（跨平台，与业务模块无关的基础方法）
+// ============================================================
+import { execSync } from 'child_process';
+// ---- 缓存策略 ----
+// macOS scutil / Windows 注册表探测都比较重（spawn 进程 / 读注册表），不能每次调用都执行；
+// 但「永久缓存」又会导致系统级代理被直接修改后无法生效。
+// 因此采用「TTL 缓存 + 显式失效」：
+//   - 性能：TTL 内复用结果，不重复探测；
+//   - 时效：超过 TTL 自动重新探测，确保系统设置变更（非经本应用）后最终生效；
+//   - 即时：应用内修改代理设置会调用 clearSystemProxyCache() 立即失效。
+// 环境变量始终实时读取（零成本、即时生效），不参与缓存。
+const OS_PROXY_TTL_MS = 30_000;
+// ---- macOS 系统代理检测 ----
+let _macProxy = null;
+let _macProbed = false;
+let _macTs = 0;
+/**
+ * 从 macOS 系统偏好设置读取代理配置
+ * 通过 scutil --proxy 查询，仅 macOS 平台生效。
+ * 结果带 TTL 缓存，兼顾性能与「系统设置变更后生效」。
+ */
+function getMacOSSystemProxy() {
+    if (_macProbed && Date.now() - _macTs < OS_PROXY_TTL_MS)
+        return _macProxy ?? undefined;
+    let url;
+    if (process.platform === 'darwin') {
+        try {
+            const output = execSync('scutil --proxy', { encoding: 'utf-8', timeout: 3000 });
+            const parsed = {};
+            // scutil 输出格式: "  Key : Value"
+            for (const line of output.split('\n')) {
+                const m = line.trim().match(/^(\w+)\s*:\s*(.+)$/);
+                if (m)
+                    parsed[m[1]] = m[2].trim();
+            }
+            // 优先 HTTPS 代理，其次 HTTP 代理，最后 SOCKS 代理
+            if (parsed['HTTPSEnable'] === '1' && parsed['HTTPSProxy']) {
+                const port = parsed['HTTPSPort'] || '443';
+                url = `http://${parsed['HTTPSProxy']}:${port}`;
+                console.debug(`[Proxy] macOS system HTTPS proxy detected: ${url}`);
+            }
+            else if (parsed['HTTPEnable'] === '1' && parsed['HTTPProxy']) {
+                const port = parsed['HTTPPort'] || '80';
+                url = `http://${parsed['HTTPProxy']}:${port}`;
+                console.debug(`[Proxy] macOS system HTTP proxy detected: ${url}`);
+            }
+            else if (parsed['SOCKSEnable'] === '1' && parsed['SOCKSProxy']) {
+                const port = parsed['SOCKSPort'] || '1080';
+                url = `socks5://${parsed['SOCKSProxy']}:${port}`;
+                console.debug(`[Proxy] macOS system SOCKS proxy detected: ${url}`);
+            }
+        }
+        catch {
+            url = undefined;
+        }
+    }
+    _macProxy = url ?? null;
+    _macProbed = true;
+    _macTs = Date.now();
+    return _macProxy ?? undefined;
+}
+// ---- Windows 系统代理检测 ----
+let _winProxy = null;
+let _winProbed = false;
+let _winTs = 0;
+/**
+ * 从 Windows 注册表读取系统代理配置
+ * 仅 Windows 平台生效，其他平台返回 undefined。
+ * 结果带 TTL 缓存，避免重复查询注册表，同时保证系统设置变更后生效。
+ */
+export function getWindowsSystemProxy() {
+    if (_winProbed && Date.now() - _winTs < OS_PROXY_TTL_MS)
+        return _winProxy ?? undefined;
+    let url;
+    if (process.platform === 'win32') {
+        try {
+            const regPath = 'HKCU\\Software\\Microsoft\\Windows\\CurrentVersion\\Internet Settings';
+            const output = execSync(`reg query "${regPath}" /v ProxyEnable`, { encoding: 'utf-8', timeout: 3000, windowsHide: true });
+            const enabledMatch = output.match(/ProxyEnable\s+REG_DWORD\s+0x(\d+)/i);
+            if (!enabledMatch || enabledMatch[1] === '0') {
+                url = undefined;
+            }
+            else {
+                const serverOutput = execSync(`reg query "${regPath}" /v ProxyServer`, { encoding: 'utf-8', timeout: 3000, windowsHide: true });
+                const serverMatch = serverOutput.match(/ProxyServer\s+REG_SZ\s+(.+)/i);
+                if (serverMatch) {
+                    const proxyServer = serverMatch[1].trim();
+                    // Windows 代理可能是 ip:port 格式，需要补全协议
+                    url = proxyServer.includes('://') ? proxyServer : `http://${proxyServer}`;
+                    console.debug(`[Proxy] Windows system proxy detected: ${url}`);
+                }
+            }
+        }
+        catch {
+            url = undefined;
+        }
+    }
+    _winProxy = url ?? null;
+    _winProbed = true;
+    _winTs = Date.now();
+    return _winProxy ?? undefined;
+}
+/** 清除系统代理缓存（应用内修改代理设置、或希望强制重新探测时调用） */
+export function clearSystemProxyCache() {
+    _macProxy = null;
+    _macProbed = false;
+    _macTs = 0;
+    _winProxy = null;
+    _winProbed = false;
+    _winTs = 0;
+}
+/**
+ * 获取系统代理 URL
+ * 优先级：环境变量 HTTPS_PROXY / HTTP_PROXY / ALL_PROXY > macOS scutil > Windows 注册表
+ * 环境变量每次实时读取（即时生效、零成本）；OS 探测结果带 TTL 缓存 + 显式失效。
+ */
+export function getSystemProxyUrl() {
+    return process.env.HTTPS_PROXY
+        || process.env.https_proxy
+        || process.env.HTTP_PROXY
+        || process.env.http_proxy
+        || process.env.ALL_PROXY
+        || process.env.all_proxy
+        || getMacOSSystemProxy()
+        || getWindowsSystemProxy();
+}
+//# sourceMappingURL=system-proxy.js.map

package/dist/esm/utils/system-proxy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"system-proxy.js","sourceRoot":"","sources":["../../../src/utils/system-proxy.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cicctencent/agent-core",
-  "version": "0.1.70",
+  "version": "0.1.72",
   "description": "Core engine for AI agent — LLM orchestration, tool execution, MCP, skill routing, security, and memory pipeline.",
   "type": "module",
   "main": "./dist/cjs/index.js",