mioku-service-webui 4.8.0 → 4.9.0

package/index.ts

@@ -247,8 +247,6 @@ const runtime = new WebUIRuntime();
 
 const webUIService: MiokuService = {
   name: "webui",
-  version: "4.2.0",
-  description: "Mioku WebUI 管理服务",
   api: {
     getSettings: () => getWebUISettings(),
   } as WebUIServiceAPI,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mioku-service-webui",
-  "version": "4.8.0",
+  "version": "4.9.0",
   "description": "Mioku WebUI 服务",
   "main": "index.ts",
   "type": "module",

package/routes/access-control.ts

@@ -1,8 +1,8 @@
 import { Hono } from "hono";
 import * as fs from "node:fs";
 import * as path from "node:path";
-import { logger } from "mioku";
-import { readJsonFile, writeJsonFile, NODE_MODULES_DIR } from "../utils";
+import { getActiveCommandManager, logger } from "mioku";
+import { isPackageDir, readJsonFile, writeJsonFile, NODE_MODULES_DIR } from "../utils";
 
 const ACCESS_CONFIG_PATH = path.resolve(
   process.cwd(),
@@ -38,24 +38,37 @@ interface AccessItem {
   desc?: string;
   match?: string;
   event?: string;
+  permission?: string;
+  priority?: number;
   fromHook: boolean;
 }
 
 function readAccessCatalog(): AccessItem[] {
+  const manager = getActiveCommandManager();
+  if (manager) {
+    return manager.catalog().map((item) => ({
+      kind: item.kind,
+      plugin: item.plugin,
+      id: item.id,
+      label: item.label,
+      desc: item.desc,
+      match: item.match,
+      event: item.event,
+      permission: item.permission,
+      priority: item.priority,
+      fromHook:
+        item.source === "manifest" && Boolean(item.match || item.event),
+    }));
+  }
   if (!fs.existsSync(NODE_MODULES_DIR)) return [];
   const entries = fs.readdirSync(NODE_MODULES_DIR, { withFileTypes: true });
   const items: AccessItem[] = [];
 
   for (const entry of entries) {
-    if (!entry.name.startsWith("mioku-plugin-")) continue;
+    if (!entry.name.toLowerCase().startsWith("mioku-plugin-")) continue;
     const fullPath = path.join(NODE_MODULES_DIR, entry.name);
-    let stat: fs.Stats;
-    try {
-      stat = fs.lstatSync(fullPath);
-    } catch {
-      continue;
-    }
-    if (!stat.isDirectory() && !stat.isSymbolicLink()) continue;
+    // Windows 上 pnpm/bun workspace 会用 NTFS junction，旧 lstat 检查会误判
+    if (!isPackageDir(fullPath)) continue;
 
     const pkgPath = path.join(fullPath, "package.json");
     if (!fs.existsSync(pkgPath)) continue;
@@ -66,7 +79,7 @@ function readAccessCatalog(): AccessItem[] {
       continue;
     }
 
-    const name = entry.name.replace(/^mioku-plugin-/, "");
+    const name = entry.name.replace(/^mioku-plugin-/i, "");
     const mioku = pkg.mioku || {};
     const help = mioku.help || { title: name, description: "", commands: [] };
     const hooks: Array<{ id: string; match?: string; event?: string; description?: string }> =

package/routes/adapter-config.ts

@@ -3,23 +3,25 @@ import * as fs from "node:fs";
 import * as path from "node:path";
 import { loadAdapterConfigPage } from "../config-page-loader";
 import { getAdapterConfigs, updateAdapterConfig } from "../system";
+import { isPackageDir } from "../utils";
 
 function listAdaptersFromNodeModules(): string[] {
   const modulesPath = path.join(process.cwd(), "node_modules");
-  if (!fs.existsSync(modulesPath)) return [];
   const adapters: string[] = [];
-  const entries = fs.readdirSync(modulesPath, { withFileTypes: true });
+  if (!fs.existsSync(modulesPath)) return adapters;
+
+  let entries: import("fs").Dirent[];
+  try {
+    entries = fs.readdirSync(modulesPath, { withFileTypes: true });
+  } catch {
+    return adapters;
+  }
+
   for (const entry of entries) {
-    if (!entry.name.startsWith("mioku-adapter-")) continue;
+    if (!entry.name.toLowerCase().startsWith("mioku-adapter-")) continue;
     const fullPath = path.join(modulesPath, entry.name);
-    let stat: fs.Stats;
-    try {
-      stat = fs.lstatSync(fullPath);
-    } catch {
-      continue;
-    }
-    if (!stat.isDirectory() && !stat.isSymbolicLink()) continue;
-    adapters.push(entry.name.replace(/^mioku-adapter-/, ""));
+    if (!isPackageDir(fullPath)) continue;
+    adapters.push(entry.name.replace(/^mioku-adapter-/i, ""));
   }
   return adapters.sort((a, b) => a.localeCompare(b));
 }

package/system.ts

@@ -4,8 +4,8 @@ import * as path from "node:path";
 import process from "node:process";
 import AdmZip from "adm-zip";
 import systemInfo from "systeminformation";
-import {connectedBots,
-  logger} from "mioku";
+import { buildAdapterReport, connectedBots, logger } from "mioku";
+import type { AdapterInstanceStatus, Bot } from "mioku";
 import type {
   InstallRequest,
   ManagedTarget,
@@ -17,10 +17,12 @@ import type {
 import {
   AUTH_PATH,
   CHAT_CONFIG_DIR,
+  CONFIG_DIR,
   defaultWebUISettings,
   ensureDir,
   getInstallCommand,
   isNpmPackageName,
+  isPackageDir,
   isValidRepoUrl,
   LOCAL_CONFIG_PATH,
   NODE_MODULES_DIR,
@@ -640,6 +642,11 @@ interface ManagedPackageUpdateInfo {
   error?: string;
 }
 
+interface NpmPackageUpdateInfo extends ManagedPackageUpdateInfo {
+  currentVersion: string;
+  latestVersion: string;
+}
+
 interface ManagedPackageUpdateCacheEntry {
   checkedAt: number;
   info: ManagedPackageUpdateInfo;
@@ -727,6 +734,65 @@ function isManagedUpdateCacheFresh(
   return Date.now() - entry.checkedAt < MANAGED_UPDATE_CACHE_TTL_MS;
 }
 
+/** 本地已安装版本：node_modules/<fullName>/package.json */
+function readLocalPackageVersion(fullName: string): string {
+  const pkg = readPackageJson(path.join(NODE_MODULES_DIR, fullName));
+  return pkg?.version || "";
+}
+
+async function getNpmLatestVersion(fullName: string): Promise<string> {
+  try {
+    const data = await fetchJson(
+      `https://registry.npmjs.org/${encodeURIComponent(fullName)}`,
+    );
+    return String(data?.["dist-tags"]?.latest || "").trim();
+  } catch {
+    return "";
+  }
+}
+
+function npmManagedUpdateError(
+  fullName: string,
+  error: string,
+): NpmPackageUpdateInfo {
+  return {
+    state: "unknown",
+    hasUpdates: false,
+    behind: 0,
+    changelog: [],
+    error,
+    currentVersion: readLocalPackageVersion(fullName),
+    latestVersion: "",
+  };
+}
+
+async function checkNpmManagedUpdate(
+  fullName: string,
+): Promise<NpmPackageUpdateInfo> {
+  const current = readLocalPackageVersion(fullName);
+  let latest = "";
+  try {
+    latest = await getNpmLatestVersion(fullName);
+  } catch (error: any) {
+    return npmManagedUpdateError(
+      fullName,
+      error?.message || "UPDATE_CHECK_FAILED",
+    );
+  }
+  if (!latest) {
+    return npmManagedUpdateError(fullName, "无法获取 npm 最新版本");
+  }
+  const hasUpdates = Boolean(current) && current !== latest;
+  return {
+    state: hasUpdates ? "has-updates" : "up-to-date",
+    hasUpdates,
+    behind: hasUpdates ? 1 : 0,
+    changelog: [],
+    currentVersion: current || "0.0.0",
+    latestVersion: latest,
+  };
+}
+
 async function refreshManagedUpdatesInBackground(
   target: ManagedTarget,
   packages: Array<Record<string, any>>,
@@ -735,21 +801,9 @@ async function refreshManagedUpdatesInBackground(
     const name = String(item.name || "");
     if (!name) continue;
 
-    if (!item.hasGit) {
-      setCachedManagedUpdateInfo(target, name, {
-        state: "no-git",
-        hasUpdates: false,
-        behind: 0,
-        changelog: [],
-        error: "NOT_GIT_REPO",
-      });
-      continue;
-    }
-
+    const fullName = fullPackageName(target, name);
     try {
-      const updateInfo = await getManagedPackageUpdateInfo(
-        String(item.path || ""),
-      );
+      const updateInfo = await checkNpmManagedUpdate(fullName);
       setCachedManagedUpdateInfo(target, name, updateInfo);
     } catch (error: any) {
       setCachedManagedUpdateInfo(target, name, {
@@ -769,8 +823,8 @@ function scheduleManagedUpdatesRefresh(
 ): void {
   if (managedOverviewRefreshInFlight.has(target)) return;
 
+  // npm 包与 git 包统一走 registry 更新检查（已不再使用 git 仓库形式）
   const shouldRefresh = packages.some((item) => {
-    if (!item.hasGit) return false;
     const cached = getCachedManagedUpdateInfo(target, String(item.name || ""));
     return !isManagedUpdateCacheFresh(cached);
   });
@@ -887,11 +941,11 @@ function listPluginsFromNodeModules(): Array<Record<string, any>> {
 
   const entries = fs.readdirSync(modulesPath, { withFileTypes: true });
   for (const entry of entries) {
-    if (!entry.name.startsWith("mioku-plugin-")) continue;
+    if (!entry.name.toLowerCase().startsWith("mioku-plugin-")) continue;
     const fullPath = path.join(modulesPath, entry.name);
-    const stat = fs.lstatSync(fullPath);
-    if (!stat.isDirectory() && !stat.isSymbolicLink()) continue;
-    const name = entry.name.replace(/^mioku-plugin-/, "");
+    // Windows 上 pnpm/bun workspace 会用 NTFS junction，旧 lstat 检查会误判
+    if (!isPackageDir(fullPath)) continue;
+    const name = entry.name.replace(/^mioku-plugin-/i, "");
     const pkg = readPackageJson(fullPath);
     plugins.push({
       name,
@@ -915,11 +969,11 @@ function listServicesFromNodeModules(): Array<Record<string, any>> {
 
   const entries = fs.readdirSync(modulesPath, { withFileTypes: true });
   for (const entry of entries) {
-    if (!entry.name.startsWith("mioku-service-")) continue;
+    if (!entry.name.toLowerCase().startsWith("mioku-service-")) continue;
     const fullPath = path.join(modulesPath, entry.name);
-    const stat = fs.lstatSync(fullPath);
-    if (!stat.isDirectory() && !stat.isSymbolicLink()) continue;
-    const name = entry.name.replace(/^mioku-service-/, "");
+    // Windows 上 pnpm/bun workspace 会用 NTFS junction，旧 lstat 检查会误判
+    if (!isPackageDir(fullPath)) continue;
+    const name = entry.name.replace(/^mioku-service-/i, "");
     const pkg = readPackageJson(fullPath);
     services.push({
       name,
@@ -943,11 +997,11 @@ function listAdaptersFromNodeModules(): Array<Record<string, any>> {
 
   const entries = fs.readdirSync(modulesPath, { withFileTypes: true });
   for (const entry of entries) {
-    if (!entry.name.startsWith("mioku-adapter-")) continue;
+    if (!entry.name.toLowerCase().startsWith("mioku-adapter-")) continue;
     const fullPath = path.join(modulesPath, entry.name);
-    const stat = fs.lstatSync(fullPath);
-    if (!stat.isDirectory() && !stat.isSymbolicLink()) continue;
-    const name = entry.name.replace(/^mioku-adapter-/, "");
+    // Windows 上 pnpm/bun workspace 会用 NTFS junction，旧 lstat 检查会误判
+    if (!isPackageDir(fullPath)) continue;
+    const name = entry.name.replace(/^mioku-adapter-/i, "");
     const pkg = readPackageJson(fullPath);
     adapters.push({
       name,
@@ -1001,10 +1055,8 @@ export async function installManagedPackage(
     ...Object.keys(afterPkg?.devDependencies || {}),
   ];
   const installedName =
-    afterDeps.find(
-      (name) =>
-        !beforeDeps.has(name) && isNpmManagedName(name),
-    ) || pkgName;
+    afterDeps.find((name) => !beforeDeps.has(name) && isNpmManagedName(name)) ||
+    pkgName;
 
   const packageJsonPath = path.join(
     NODE_MODULES_DIR,
@@ -1038,34 +1090,25 @@ export async function checkUpdate(
   name: string,
   target: ManagedTarget,
 ): Promise<Record<string, any>> {
-  const isNpmPackage = isNpmManagedName(name);
+  // 现在插件/服务/适配器全部以 npm 包形式安装，统一走 npm 更新检查
+  const fullName = isNpmManagedName(name)
+    ? name
+    : fullPackageName(target, name);
+  const localPath = path.join(NODE_MODULES_DIR, fullName);
+  const isNpmPackage = fs.existsSync(localPath) || isNpmManagedName(name);
 
   if (isNpmPackage) {
-    // 使用 npm view 检查 npm 包更新
-    const currentVersion = await runCommand(
-      "bun",
-      ["npm", "info", name, "version"],
-      process.cwd(),
-    );
-    const latestVersion = await runCommand(
-      "bun",
-      ["npm", "info", name, "dist-tags.latest"],
-      process.cwd(),
-    );
-    const current = currentVersion.stdout?.trim() || "";
-    const latest = latestVersion.stdout?.trim() || "";
-    const hasUpdates = current !== latest && latest !== "";
-
+    const info = await checkNpmManagedUpdate(fullName);
     return {
       ok: true,
-      state: "npm",
-      hasUpdates,
-      behind: hasUpdates ? 1 : 0,
-      changelog: [],
+      state: info.state,
+      hasUpdates: info.hasUpdates,
+      behind: info.behind,
+      changelog: info.changelog,
       hasGit: false,
-      error: null,
-      currentVersion: current,
-      latestVersion: latest,
+      error: info.error || null,
+      currentVersion: info.currentVersion,
+      latestVersion: info.latestVersion,
     };
   }
 
@@ -1092,28 +1135,30 @@ export async function updateManagedPackage(
 ): Promise<Record<string, any>> {
   const installCmd = getInstallCommand();
 
-  // 检查是 npm 包还是 git 包
-  const isNpmPackage = isNpmManagedName(input.name);
+  // 前端传短名（如 chat），统一还原为完整 npm 包名
+  const fullName = isNpmManagedName(input.name)
+    ? input.name
+    : fullPackageName(input.target, input.name);
   const npmPackagePath = path.join(
     process.cwd(),
     "node_modules",
-    input.name,
+    fullName,
     "package.json",
   );
 
-  if (isNpmPackage && fs.existsSync(npmPackagePath)) {
-    // Bun 包更新
-    const updateArgs = installCmd.args.map((arg) =>
-      arg === "install" ? "update" : arg,
-    );
+  if (fs.existsSync(npmPackagePath)) {
+    // Bun 包更新：bun add 会拉取 npm 最新版本
     const update = await runCommand(
       installCmd.cmd,
-      [...updateArgs, input.name],
+      [...installCmd.args, fullName],
       process.cwd(),
     );
     if (update.code !== 0) {
-      throw new Error(`bun update 失败: ${update.stderr || update.stdout}`);
+      throw new Error(`bun add 更新失败: ${update.stderr || update.stdout}`);
     }
+    managedPackageUpdateCache.delete(
+      makeManagedUpdateCacheKey(input.target, fullName),
+    );
     return {
       ok: true,
       restartRequired: true,
@@ -1172,9 +1217,7 @@ export async function removeManagedPackage(
     : fullPackageName(input.target, input.name);
 
   const installCmd = getInstallCommand();
-  const removeArgs = installCmd.args.map((a) =>
-    a === "add" ? "remove" : a,
-  );
+  const removeArgs = installCmd.args.map((a) => (a === "add" ? "remove" : a));
 
   const result = await runCommand(
     installCmd.cmd,
@@ -1193,10 +1236,15 @@ export async function removeManagedPackage(
       try {
         const pkg = JSON.parse(fs.readFileSync(pkgPath, "utf-8"));
         const mioki = pkg.mioki ?? {};
-        const plugins: string[] = Array.isArray(mioki.plugins) ? mioki.plugins : [];
+        const plugins: string[] = Array.isArray(mioki.plugins)
+          ? mioki.plugins
+          : [];
         const shortName = fullName.replace(/^mioku-plugin-/, "");
         if (plugins.includes(shortName)) {
-          pkg.mioki = { ...mioki, plugins: plugins.filter((p: string) => p !== shortName) };
+          pkg.mioki = {
+            ...mioki,
+            plugins: plugins.filter((p: string) => p !== shortName),
+          };
           fs.writeFileSync(pkgPath, `${JSON.stringify(pkg, null, 2)}\n`);
         }
       } catch {
@@ -1225,17 +1273,6 @@ export async function listManagedPackagesWithUpdates(
   return packages.map((item) => {
     const name = String(item.name || "");
 
-    if (!item.hasGit) {
-      return {
-        ...item,
-        updateState: "no-git",
-        hasUpdates: false,
-        behind: 0,
-        updateError: "NOT_GIT_REPO",
-        updateChecking: false,
-      };
-    }
-
     const cached = getCachedManagedUpdateInfo(target, name);
     if (cached) {
       return {
@@ -1299,6 +1336,9 @@ export async function getManagedPackageDetail(
     } else {
       repositoryUrl = normalizeRepositoryUrl(latest?.repository);
     }
+    // npm 包以包内 repository 字段为准，缺失时回退到 mioku-lab 仓库
+    const packageRepository = normalizeRepositoryUrl(latest?.repository);
+    const finalRepository = packageRepository || repositoryUrl;
 
     // 获取本地已安装版本
     const localPkg =
@@ -1324,7 +1364,7 @@ export async function getManagedPackageDetail(
         hasGit: false,
         isSystemPlugin,
         isSystemService,
-        repository: repositoryUrl,
+        repository: finalRepository,
         originUrl: "",
         homepage: String(latest?.homepage || "").trim(),
         requiredServices: Array.isArray(latest?.mioku?.services)
@@ -1334,7 +1374,7 @@ export async function getManagedPackageDetail(
         help: latest?.mioku?.help || null,
         readme: String(data?.readme || "").trim(),
         readmeFile: "README.md",
-        updateState: "npm",
+        updateState: hasUpdates ? "has-updates" : "up-to-date",
         hasUpdates,
         behind: hasUpdates ? 1 : 0,
         changelog: [],
@@ -1444,19 +1484,24 @@ export async function updateAllManagedPackages(input: {
   const results: Array<Record<string, any>> = [];
 
   for (const item of packages) {
-    const updateInfo = await getManagedPackageUpdateInfo(item.path);
-    if (updateInfo.state === "no-git") {
-      results.push({
-        name: item.name,
-        ok: false,
-        skipped: true,
-        reason: "NOT_GIT_REPO",
-      });
-      continue;
+    const name = String(item.name || "");
+    if (!name) continue;
+
+    // 统一走 npm 更新检查（已不再使用 git 仓库形式）
+    const cached = getCachedManagedUpdateInfo(input.target, name);
+    let updateInfo: ManagedPackageUpdateInfo;
+    if (cached && isManagedUpdateCacheFresh(cached)) {
+      updateInfo = cached.info;
+    } else {
+      updateInfo = await checkNpmManagedUpdate(
+        fullPackageName(input.target, name),
+      );
+      setCachedManagedUpdateInfo(input.target, name, updateInfo);
     }
+
     if (!updateInfo.hasUpdates) {
       results.push({
-        name: item.name,
+        name,
         ok: true,
         skipped: true,
         reason: updateInfo.state === "unknown" ? "CHECK_FAILED" : "UP_TO_DATE",
@@ -1467,19 +1512,19 @@ export async function updateAllManagedPackages(input: {
 
     try {
       const updated = await updateManagedPackage({
-        name: item.name,
+        name,
         target: input.target,
         packageManager: input.packageManager,
       });
       results.push({
-        name: item.name,
+        name,
         ok: true,
         skipped: false,
         ...updated,
       });
     } catch (error: any) {
       results.push({
-        name: item.name,
+        name,
         ok: false,
         skipped: false,
         error: error?.message || "UPDATE_FAILED",
@@ -1827,10 +1872,7 @@ export async function notifyOwnersAuthTokenRefreshed(
         continue;
       }
       try {
-        await bot.sendMessage(
-          { type: "private", user_id: ownerId },
-          message,
-        );
+        await bot.sendMessage({ type: "private", user_id: ownerId }, message);
         logger.info(
           `[webui] 已通过 ${bot.adapter ?? "bot"}/${bot.bot_id ?? "?"} 通知主人 ${ownerId} 密钥更新`,
         );
@@ -1842,9 +1884,7 @@ export async function notifyOwnersAuthTokenRefreshed(
     }
     if (!notified) {
       const msg = formatSendError(lastError);
-      logger.warn(
-        `[webui] 通知主人 ${ownerId} 密钥更新失败: ${msg}`,
-      );
+      logger.warn(`[webui] 通知主人 ${ownerId} 密钥更新失败: ${msg}`);
     }
   }
 }
@@ -2107,14 +2147,6 @@ async function getCpuUsagePercent(): Promise<number> {
   return Number((((totalDelta - idleDelta) / totalDelta) * 100).toFixed(1));
 }
 
-function toHttpBaseUrl(bot: { options?: { protocol?: string; host?: string; port?: number } }): string {
-  const protocol = String(bot.options?.protocol || "ws");
-  const httpProtocol = protocol === "wss" ? "https" : "http";
-  const host = bot.options?.host || "127.0.0.1";
-  const port = bot.options?.port || 3001;
-  return `${httpProtocol}://${host}:${port}`;
-}
-
 async function fetchYiyan(): Promise<{ text: string }> {
   const controller = new AbortController();
   const timer = setTimeout(() => controller.abort(), 4500);
@@ -2142,61 +2174,138 @@ function normalizeVersionSpec(input: string): string {
   return matched?.[0] || cleaned;
 }
 
-async function getBotDetails(bot: import("mioku").Bot): Promise<Record<string, any>> {
+/** 读取已安装适配器包的版本（与 help 状态图里 ctx.getAdapter().version 同源） */
+function readAdapterPackageVersion(name: string): string {
+  const pkg = readPackageJson(
+    path.join(NODE_MODULES_DIR, `mioku-adapter-${name}`),
+  );
+  return pkg?.version || "";
+}
+
+/** 与 help 状态图一致:stdin 使用 help/status 配置的随机头像，未配置时用默认随机图接口 */
+function readStdinAvatar(): string {
+  const statusConfig = readJsonFile<any>(
+    path.join(CONFIG_DIR, "help", "status.json"),
+    null,
+  );
+  const configured = String(statusConfig?.stdinAvatar || "").trim();
+  if (configured) return configured;
+  return "https://uapis.cn/api/v1/random/image?category=bq&type=eciyuan";
+}
+
+async function getBotDetails(bot: Bot): Promise<Record<string, any>> {
   const botAny = bot as unknown as {
     uin?: number | string;
     user_id?: number | string;
     name?: string;
-    options?: { protocol?: string; host?: string; port?: number };
-    app_version?: string;
   };
-  const qq = String(botAny.uin ?? botAny.user_id ?? bot.bot_id);
+  const accountId = String(botAny.uin ?? botAny.user_id ?? bot.bot_id);
+  const isStdin = bot.adapter === "stdin";
   const base = {
     botId: bot.bot_id,
-    qq,
+    accountId,
+    qq: accountId,
     nickname: bot.nickname || botAny.name || "Unknown Bot",
-    avatar: `https://q1.qlogo.cn/g?b=qq&nk=${qq}&s=160`,
+    avatar: isStdin
+      ? readStdinAvatar()
+      : `https://q1.qlogo.cn/g?b=qq&nk=${accountId}&s=160`,
     online: bot.online,
-    napcatVersion: botAny.app_version || "unknown",
-    napcatApiBase: toHttpBaseUrl(botAny),
+    adapter: String(bot.adapter),
+    adapterVersion: readAdapterPackageVersion(String(bot.adapter)),
+    implLabel: "",
+    framework: isStdin ? "stdin" : String(bot.adapter),
+    appVersion: "",
+    protocolVersion: "",
+    platform: "",
+    platformVersion: "",
     groupCount: 0,
     friendCount: 0,
+    send: 0,
+    receive: 0,
     onlineDurationMs: 0,
-    statusText: "online",
+    statusText: bot.online ? "online" : "offline",
   };
 
   try {
-    const [status, versionInfo, groups, friends] = await Promise.all([
-      bot.sendApi<{ stat?: { start_time?: number; online?: boolean }; online?: boolean }>("get_status").catch(() => null),
-      bot.sendApi<{ app_version?: string }>("get_version_info").catch(() => null),
-      bot.getGroupList().catch(() => []),
-      bot.getFriendList().catch(() => []),
-    ]);
+    if (typeof bot.getAvatar === "function" && !isStdin) {
+      const avatar = await bot.getAvatar().catch(() => null);
+      if (avatar) base.avatar = avatar;
+    }
+  } catch {
+    // keep qlogo fallback
+  }
+  return base;
+}
 
-    const stat = status?.stat || null;
-    const startTs = Number(stat?.start_time || 0);
-    const onlineDurationMs =
-      startTs > 0 ? Math.max(0, Date.now() - startTs) : 0;
-    const onlineFromStatus =
-      typeof status?.online === "boolean" ? status.online : true;
+async function getBotOverviewList(): Promise<Record<string, any>[]> {
+  const bots = Array.from(connectedBots.values());
+  if (bots.length === 0) return [];
+  const sorted = [...bots].sort(
+    (a, b) => Number(b.adapter === "stdin") - Number(a.adapter === "stdin"),
+  );
 
-    return {
-      ...base,
-      online: onlineFromStatus,
-      napcatVersion: versionInfo?.app_version || base.napcatVersion,
-      groupCount: Array.isArray(groups) ? groups.length : 0,
-      friendCount: Array.isArray(friends) ? friends.length : 0,
-      onlineDurationMs,
-      statusText: onlineFromStatus ? "online" : "offline",
-    };
-  } catch (error: any) {
-    return {
-      ...base,
-      online: false,
-      statusText: "error",
-      error: error?.message || "NAPCAT_API_ERROR",
-    };
+  const adapters = sorted.map((bot) => ({
+    name: String(bot.adapter),
+    version: readAdapterPackageVersion(String(bot.adapter)),
+  }));
+  const report = await buildAdapterReport({ bots: sorted, adapters }).catch(
+    () => null,
+  );
+  const instances = new Map<string, AdapterInstanceStatus>();
+  const implOf = new Map<
+    string,
+    { name: string; version?: string } | undefined
+  >();
+  for (const entry of report?.adapters ?? []) {
+    implOf.set(entry.name, entry.impl);
+    for (const instance of entry.instances) {
+      instances.set(`${entry.name}:${instance.bot_id}`, instance);
+    }
   }
+
+  return Promise.all(
+    sorted.map(async (bot) => {
+      const detail = await getBotDetails(bot);
+      const uin = String(detail.accountId);
+      const adapterName = String(detail.adapter);
+      const isStdin = adapterName === "stdin";
+      const instance = instances.get(`${adapterName}:${uin}`);
+      const lib = implOf.get(adapterName);
+      const appVersion = instance?.version || lib?.version || "";
+      const implLabel = isStdin
+        ? "stdin"
+        : instance?.impl
+          ? instance.version
+            ? `${instance.impl}/${instance.version}`
+            : String(instance.impl)
+          : lib?.name
+            ? lib.version
+              ? `${lib.name} v${lib.version}`
+              : lib.name
+            : adapterName;
+
+      return {
+        ...detail,
+        implLabel,
+        framework: isStdin ? "stdin" : adapterName,
+        appVersion: isStdin
+          ? String(readAdapterPackageVersion(adapterName))
+          : appVersion,
+        protocolVersion: instance?.protocol ?? "",
+        platform: instance?.platform ?? "",
+        platformVersion: instance?.platformVersion ?? "",
+        online: instance?.online ?? bot.online,
+        groupCount: instance?.stats.groups ?? 0,
+        friendCount: instance?.stats.friends ?? 0,
+        send: instance?.stats.sent ?? 0,
+        receive: instance?.stats.received ?? 0,
+        onlineDurationMs:
+          bot.connected_at != null && bot.online
+            ? Math.max(0, Date.now() - bot.connected_at)
+            : 0,
+      };
+    }),
+  );
 }
 
 export async function getSystemOverview(): Promise<Record<string, any>> {
@@ -2220,9 +2329,10 @@ export async function getSystemOverview(): Promise<Record<string, any>> {
       : 0;
   const siSnapshot = await getSystemInformationSnapshot();
 
-  const botInstances = Array.from(connectedBots.values());
-  const bots = await Promise.all(botInstances.map((bot) => getBotDetails(bot)));
-  const selectedBot = bots[0] || null;
+  const bots = await getBotOverviewList();
+  // 默认展示第一个非 stdin 的 bot（stdin 是终端通道，不是真实账号）
+  const selectedBot =
+    bots.find((bot) => bot.adapter !== "stdin") || bots[0] || null;
 
   return {
     uptimeSeconds: process.uptime(),
@@ -2312,12 +2422,16 @@ export function updateChatConfig(fileName: string, data: any): any {
 export function getAdapterConfigs(adapterName: string): any {
   const rootPkg = readRootPackageJson();
   const adapters = rootPkg?.mioku?.adapters ?? {};
-  const safeName = String(adapterName || "").trim().replace(/[^a-zA-Z0-9_-]/g, "");
+  const safeName = String(adapterName || "")
+    .trim()
+    .replace(/[^a-zA-Z0-9_-]/g, "");
   return adapters[safeName] ?? {};
 }
 
 export function updateAdapterConfig(adapterName: string, data: any): any {
-  const safeName = String(adapterName || "").trim().replace(/[^a-zA-Z0-9_-]/g, "");
+  const safeName = String(adapterName || "")
+    .trim()
+    .replace(/[^a-zA-Z0-9_-]/g, "");
   if (!safeName) throw new Error("适配器名称无效");
   const rootPkg = readRootPackageJson();
   rootPkg.mioku = rootPkg.mioku ?? {};
@@ -2401,11 +2515,11 @@ export function getAvailablePlugins(): string[] {
   const plugins: string[] = [];
   const entries = fs.readdirSync(modulesPath, { withFileTypes: true });
   for (const entry of entries) {
-    if (!entry.name.startsWith("mioku-plugin-")) continue;
+    if (!entry.name.toLowerCase().startsWith("mioku-plugin-")) continue;
     const fullPath = path.join(modulesPath, entry.name);
-    const stat = fs.lstatSync(fullPath);
-    if (!stat.isDirectory() && !stat.isSymbolicLink()) continue;
-    plugins.push(entry.name.replace(/^mioku-plugin-/, ""));
+    // Windows 上 pnpm/bun workspace 会用 NTFS junction，旧 lstat 检查会误判
+    if (!isPackageDir(fullPath)) continue;
+    plugins.push(entry.name.replace(/^mioku-plugin-/i, ""));
   }
   return plugins.sort((a, b) => a.localeCompare(b));
 }

package/utils.ts

@@ -97,6 +97,11 @@ export function normalizePackageManager(): PackageManager {
   return "bun";
 }
 
+export function isPackageDir(fullPath: string | null | undefined): boolean {
+  if (!fullPath) return false;
+  return fs.existsSync(path.join(fullPath, "package.json"));
+}
+
 export function isValidRepoUrl(url: string): boolean {
   const trimmed = url.trim();
   // 拒绝空白字符：堵 `ssh://host -o ProxyCommand=...` 之类参数注入