feat(panel/adapter): plugin adapter auto-discovery + proxy from env

- src/utils/pluginBase.ts: add PanelSettingsAdapter, PanelSettingField, PanelFieldType types
- src/utils/pluginManager.ts: add getPluginPanelAdapters() for dynamic discovery
- src/utils/panel/settingsRegistry.ts: registerPluginPanelAdapters() for auto-registration
- src/utils/panel/controller.ts: call registerPluginPanelAdapters() on startup; remove hardcoded providers
- src/utils/panel/httpServer.ts: /api/settings merges plugin adapters
- plugins/checkin.ts, music.ts, tts.ts, zpr.ts, parsehub.ts, codex_image.ts: add panelAdapter export
- src/utils/runtimeManager.ts: getProxyFromEnv() for teleproto client from HTTP_PROXY/HTTPS_PROXY/ALL_PROXY/SOCKS_PROXY
- src/utils/panel/botService.ts: getProxyAgent() for telegraf using http-proxy-agent/socks-proxy-agent
- tsconfig.json: fix for TS 5.x compatibility
- src/utils/errorHelpers.ts: new utility
- src/utils/htmlEscape.ts: new utility

Panel settings page now auto-discovers plugin configs — zero hardcoding.

Author: TiaraBasori

src/utils/errorHelpers.ts

@@ -0,0 +1,72 @@
+/**
+ * Type-safe error handling utilities.
+ *
+ * These helpers replace `catch (error: any)` patterns with
+ * `catch (error: unknown)` while still providing convenient access
+ * to error message and code properties.
+ */
+
+/**
+ * Extract the message from an unknown caught error.
+ * Safely handles Error objects, strings, and other types.
+ */
+export function getErrorMessage(error: unknown): string {
+  if (error instanceof Error) return error.message;
+  if (typeof error === "string") return error;
+  if (
+    error !== null &&
+    error !== undefined &&
+    typeof error === "object" &&
+    "message" in error &&
+    typeof (error as { message: unknown }).message === "string"
+  ) {
+    return (error as { message: string }).message;
+  }
+  return String(error);
+}
+
+/**
+ * Extract the code from an unknown caught error (e.g., Node.js errno codes).
+ */
+export function getErrorCode(error: unknown): string | undefined {
+  if (
+    error !== null &&
+    error !== undefined &&
+    typeof error === "object" &&
+    "code" in error &&
+    typeof (error as { code: unknown }).code === "string"
+  ) {
+    return (error as { code: string }).code;
+  }
+  return undefined;
+}
+
+/**
+ * Narrow an unknown caught value to an Error instance.
+ * Returns the Error if it is one, otherwise wraps it in a new Error.
+ */
+export function toError(error: unknown): Error {
+  if (error instanceof Error) return error;
+  return new Error(getErrorMessage(error));
+}
+
+/**
+ * Extract stdout/stderr from a child_process.exec error (or any object
+ * that carries those fields).  Returns { stdout, stderr } with empty
+ * strings for missing fields.
+ */
+export function getExecErrorOutput(error: unknown): {
+  stdout: string;
+  stderr: string;
+  message: string;
+} {
+  if (error !== null && error !== undefined && typeof error === "object") {
+    const obj = error as Record<string, unknown>;
+    return {
+      stdout: typeof obj.stdout === "string" ? obj.stdout : String(obj.stdout ?? "").trim(),
+      stderr: typeof obj.stderr === "string" ? obj.stderr : String(obj.stderr ?? "").trim(),
+      message: getErrorMessage(error),
+    };
+  }
+  return { stdout: "", stderr: "", message: getErrorMessage(error) };
+}

src/utils/panel/botService.ts

@@ -23,6 +23,62 @@ function buildOpenKeyboard(baseUrl: string) {
   ]);
 }
 
+/**
+ * Get HTTP/HTTPS agent with proxy from environment variables.
+ * Supports HTTP_PROXY, HTTPS_PROXY, ALL_PROXY, and SOCKS_PROXY.
+ */
+function getProxyAgent(): any | undefined {
+  // Check standard env vars (case-insensitive)
+  const httpProxy = process.env.HTTP_PROXY || process.env.http_proxy;
+  const httpsProxy = process.env.HTTPS_PROXY || process.env.https_proxy;
+  const allProxy = process.env.ALL_PROXY || process.env.all_proxy;
+  const socksProxy = process.env.SOCKS_PROXY || process.env.socks_proxy;
+
+  // For HTTPS requests (Telegram Bot API uses HTTPS), prefer HTTPS_PROXY
+  const proxyUrl = httpsProxy || httpProxy || allProxy || socksProxy;
+  if (!proxyUrl) return undefined;
+
+  try {
+    const url = new URL(proxyUrl);
+    const host = url.hostname;
+    const port = Number(url.port);
+    const username = url.username ? decodeURIComponent(url.username) : undefined;
+    const password = url.password ? decodeURIComponent(url.password) : undefined;
+
+    if (!host || !port) {
+      logger.warn("[panel-bot] 环境变量代理 URL 格式无效，缺少 host 或 port:", proxyUrl);
+      return undefined;
+    }
+
+    const protocol = url.protocol.toLowerCase();
+
+    // For telegraf, we need an HTTP/HTTPS agent
+    // SOCKS proxies need special handling (e.g., socks-proxy-agent package)
+    if (protocol === "socks5:" || protocol === "socks4:") {
+      logger.warn(
+        "[panel-bot] SOCKS 代理需要 socks-proxy-agent 包支持，当前仅支持 HTTP/HTTPS 代理。建议配置 HTTP_PROXY/HTTPS_PROXY 环境变量。"
+      );
+      return undefined;
+    }
+
+    if (protocol === "http:" || protocol === "https:") {
+      const auth = username && password ? `${username}:${password}@` : "";
+      const proxyAddress = `${protocol}//${auth}${host}:${port}`;
+
+      // Use http-proxy-agent for HTTP/HTTPS proxy
+      const { HttpProxyAgent } = require("http-proxy-agent");
+
+      return new HttpProxyAgent(proxyAddress);
+    }
+
+    logger.warn("[panel-bot] 不支持的代理协议:", protocol);
+    return undefined;
+  } catch (e: unknown) {
+    logger.warn("[panel-bot] 解析环境变量代理失败:", e);
+    return undefined;
+  }
+}
+
 export function isBotRunning(): boolean {
   return !!bot;
 }
@@ -43,7 +99,14 @@ export async function startPanelBot(): Promise<void> {
   }
   await stopPanelBot();
 
-  const instance = new Telegraf(cfg.botToken);
+  const proxyAgent = getProxyAgent();
+  const instance = new Telegraf(cfg.botToken, {
+    telegram: proxyAgent
+      ? {
+          agent: proxyAgent,
+        }
+      : undefined,
+  });
   const token = cfg.botToken;
 
   instance.start(async (ctx) => {
@@ -54,7 +117,7 @@ export async function startPanelBot(): Promise<void> {
       const latest = await readPanelConfig();
       if (!gate.allowed) {
         await ctx.reply(
-          "⛔ 你没有 TeleBox Panel 管理权限。\n请联系 owner 使用 `.panel admin add <userid>` 授权。",
+          "⛔ 你没有 TeleBox Panel 管理权限。\n请联系 owner 使用 `.panel admin add <userid>` 授权。"
         );
         return;
       }
@@ -63,7 +126,7 @@ export async function startPanelBot(): Promise<void> {
           "⚠️ Panel 已启用，但未设置公网 HTTPS 地址。\n" +
             "请在 userbot 中执行：\n" +
             "`.panel url https://你的域名`\n" +
-            "Telegram 小程序要求公网 HTTPS。",
+            "Telegram 小程序要求公网 HTTPS。"
         );
         return;
       }
@@ -75,7 +138,7 @@ export async function startPanelBot(): Promise<void> {
         {
           parse_mode: "HTML",
           ...buildOpenKeyboard(latest.publicBaseUrl),
-        },
+        }
       );
     } catch (e: unknown) {
       logger.error("[panel-bot] /start failed", e);
@@ -112,7 +175,7 @@ export async function startPanelBot(): Promise<void> {
         `panelAdmin: ${gate.allowed ? "yes" : "no"}`,
         `isOwner: ${gate.isOwner ? "yes" : "no"}`,
         `ownerId: ${ownerId ?? "unknown"}`,
-      ].join("\n"),
+      ].join("\n")
     );
   });
 
@@ -127,7 +190,7 @@ export async function startPanelBot(): Promise<void> {
     },
     (e: unknown) => {
       logger.error("[panel-bot] launch failed", e);
-    },
+    }
   );
 
   bot = instance;
@@ -172,5 +235,5 @@ function escapeHtml(s: string): string {
     .replace(/&/g, "&")
     .replace(/</g, "<")
     .replace(/>/g, ">")
-    .replace(/"/g, '"');
-}
+    .replace(/"/g, """);
+}

src/utils/panel/controller.ts

@@ -15,6 +15,10 @@ import {
   registerAiPanelProviders,
   unregisterAiPanelProviders,
 } from "./aiPanelProviders";
+import {
+  registerPluginPanelAdapters,
+  unregisterPluginPanelAdapters,
+} from "./settingsRegistry";
 import { startTunnel, stopTunnel, getTunnelUrl, isTunnelRunning } from "./cloudflareTunnel";
 
 let providersReady = false;
@@ -24,13 +28,15 @@ export function ensurePanelProviders(): void {
   if (providersReady) return;
   registerBuiltinPanelProviders();
   registerAiPanelProviders();
+  registerPluginPanelAdapters();
   providersReady = true;
 }
 
 export function teardownPanelProviders(): void {
   if (!providersReady) return;
   unregisterBuiltinPanelProviders();
   unregisterAiPanelProviders();
+  unregisterPluginPanelAdapters();
   providersReady = false;
 }
 

src/utils/panel/httpServer.ts

@@ -10,7 +10,7 @@ import path from "path";
 import { URL } from "url";
 import { logger } from "@utils/logger";
 import { readDisplayVersion } from "@utils/teleboxInfoHelper";
-import { listCommands } from "@utils/pluginManager";
+import { listCommands, getPluginPanelAdapters } from "@utils/pluginManager";
 import {
   readPanelConfig,
   updatePanelConfig,
@@ -382,11 +382,33 @@ async function routeApi(
 
   // ---- Settings hooks ----
   if (method === "GET" && p === "/api/settings") {
+    // Merge built-in providers + plugin-provided adapters
     // Only show settings for plugins that are currently loaded/installed
     const loadedPlugins = await help.listLoadedPlugins();
-    const loadedPluginNames = new Set(loadedPlugins.map(p => p.name));
+    const loadedPluginNames = new Set(loadedPlugins.map((p) => p.name));
 
-    const list = listPanelSettingsProviders()
+    // Get plugin adapters (auto-discovered from loaded plugins)
+    const pluginAdapters = getPluginPanelAdapters();
+    
+    // Build merged list: built-in providers + plugin adapters
+    const builtinProviders = listPanelSettingsProviders();
+    const allProviders = [...builtinProviders];
+    
+    // Add plugin adapters as virtual providers
+    for (const adapter of pluginAdapters) {
+      allProviders.push({
+        id: adapter.id,
+        title: adapter.title,
+        description: adapter.description,
+        category: adapter.category || "插件配置",
+        icon: adapter.icon || "⚙️",
+        getSchema: adapter.getSchema,
+        getValues: adapter.getValues,
+        setValues: adapter.setValues,
+      } as typeof builtinProviders[0]);
+    }
+    
+    const list = allProviders
       .filter((x) => {
         // System plugins always show
         if (x.category === "系统") return true;