mioku-plugin-help 2.3.3 → 3.0.1

package/config.md

@@ -8,6 +8,12 @@ fields:
     description: 最基础的单行文本输入。
     placeholder: 输入任意文本
 
+  - key: status.stdinAvatar
+    label: stdin 头像
+    type: text
+    description: stdin 适配器在状态图中使用的头像，支持 http(s):// 或 file:// URL，也支持本地绝对路径（自动转 file://）。默认使用 uapis.cn 随机表情接口。
+    placeholder: https://uapis.cn/api/v1/random/image?category=bq&type=eciyuan
+
   - key: demo.secretValue
     label: secret 密文输入
     type: secret
@@ -192,4 +198,16 @@ config: demo
 
 用法：`mioku-file` 会直接把某个配置文件完整显示为 JSON 编辑器，适合调试或保底兜底。
 
+## 7. `status` 状态图配置
+
+```mioku-field
+key: status.stdinAvatar
+```
+
+`status` 配置文件（`config/help/status.json`）目前支持：
+
+| 字段 | 类型 | 默认值 | 说明 |
+| --- | --- | --- | --- |
+| `stdinAvatar` | string | `https://uapis.cn/api/v1/random/image?category=bq&type=eciyuan` | stdin 适配器在状态图中的头像，支持 http(s):// / file:// URL 或本地绝对路径（自动转 file://） |
+
 ---

package/help/html-generator.ts

@@ -12,7 +12,7 @@
  */
 
 import type { CommandRole, PluginHelp } from "mioku";
-import { botConfig } from "mioki";
+import { botConfig } from "mioku";
 import { escapeHtml } from "../utils";
 import { getHelpTheme, HELP_BACKGROUND_IMAGE_URL } from "../theme";
 import { getRenderableEntries } from "./intent";

package/help/image.ts

@@ -115,11 +115,9 @@ export function resolveHelpBotProfile(
   const fallbackNickname = "Mioku Bot";
   const selfId = event?.self_id;
   const bot =
-    (selfId && typeof ctx?.pickBot === "function"
-      ? ctx.pickBot(selfId)
-      : null) ||
+    event?.bot ??
     (ctx?.bots instanceof Map ? Array.from(ctx.bots.values())[0] : null);
-  const botId = selfId || bot?.uin || bot?.user_id || bot?.self_id;
+  const botId = selfId || bot?.bot_id;
   const botNickname = bot?.nickname || bot?.name || fallbackNickname;
   const botAvatarUrl = botId
     ? `https://q1.qlogo.cn/g?b=qq&nk=${botId}&s=640`
@@ -160,8 +158,8 @@ export async function replyWithImage(
 }
 
 /**
- * Send an image from inside an AI skill handler. Picks the right bot via
- * `ctx.pickBot(selfId)`, supports an optional quote-reply, and falls
+ * Send an image from inside an AI skill handler. Uses the event-bound bot
+ * (`event.bot`), supports an optional quote-reply, and falls
  * back to base64 when the adapter refuses a raw path.
  */
 export async function sendImageFromSkillContext(options: {
@@ -171,28 +169,20 @@ export async function sendImageFromSkillContext(options: {
   quoteReply?: boolean;
 }): Promise<void> {
   const { ctx, event, imagePath, quoteReply = false } = options;
-  const selfId = event?.self_id != null ? Number(event.self_id) : undefined;
-  const bot =
-    selfId != null && typeof ctx?.pickBot === "function"
-      ? ctx.pickBot(selfId)
-      : undefined;
+  const bot = event?.bot;
 
   if (!bot) {
     throw new Error("当前上下文不支持发送图片");
   }
 
   const buildImageSegment = (file: string) => {
-    const normalizedFile = normalizeImageSource(file);
-    if (ctx?.segment?.image) {
-      return ctx.segment.image(normalizedFile);
-    }
-    return { type: "image", file: normalizedFile };
+    return ctx.segment.image(normalizeImageSource(file));
   };
 
   const sendPayload = async (file: string) => {
     const payload: any[] = [];
     if (quoteReply && event?.message_id != null) {
-      payload.push({ type: "reply", id: String(event.message_id) });
+      payload.push(ctx.segment.reply(event.message_id));
     }
     payload.push(buildImageSegment(file));
 

package/help/intent.ts

@@ -24,7 +24,7 @@ function sanitizeKeyword(value: string): string {
   return String(value || "")
     .trim()
     .replace(/^[#/\s]+/, "")
-    .replace(/[。.!！?？,，:：；;]+$/g, "");
+    .replace(/[。.!！?？,，:：；);]+$/g, "");
 }
 
 /** Lowercase + strip everything that isn't a-z, 0-9, or CJK. */

package/help/role.ts

@@ -66,15 +66,10 @@ export async function resolveViewerRole(
     }
 
     if (event?.group_id != null && event?.user_id != null) {
-      const selfId =
-        event?.self_id != null ? Number(event.self_id) : undefined;
-      const bot =
-        selfId != null && typeof ctx?.pickBot === "function"
-          ? ctx.pickBot(selfId)
-          : undefined;
-      if (bot && typeof bot.getGroupMemberInfo === "function") {
+      const bot = event?.bot;
+      if (bot) {
         try {
-          const info = await bot.getGroupMemberInfo(
+          const info = await bot.getMemberInfo(
             event.group_id,
             event.user_id,
           );

package/index.ts

@@ -1,7 +1,8 @@
-import { definePlugin, type MiokiContext } from "mioki";
+import { definePlugin, type MiokuContext } from "mioku";
 import { getService, Services } from "mioku";
 import * as path from "path";
 import { HELP_DEMO_CONFIG } from "./demo-config";
+import { HELP_STATUS_DEFAULT_CONFIG } from "./status/config";
 import {
   generateHelpImage,
   replyWithImage,
@@ -23,7 +24,7 @@ const helpPlugin = definePlugin({
   version: "2.1.0",
   description: "帮助插件，生成帮助图片，并提供 #状态 指令",
 
-  async setup(ctx: MiokiContext) {
+  async setup(ctx: MiokuContext) {
     // 启动后台采样器
     networkSampler.start();
     perfMonitor.start();
@@ -48,6 +49,11 @@ const helpPlugin = definePlugin({
 
     if (configService) {
       await configService.registerConfig("help", "demo", HELP_DEMO_CONFIG.demo);
+      await configService.registerConfig(
+        "help",
+        "status",
+        HELP_STATUS_DEFAULT_CONFIG,
+      );
     }
 
     // 注册 help manifest，让 `#help 状态` 能命中

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mioku-plugin-help",
-  "version": "2.3.3",
+  "version": "3.0.1",
   "description": "帮助插件，使用截图服务生成美观的帮助图片，并提供 #状态 指令",
   "main": "index.ts",
   "type": "module",
@@ -32,11 +32,12 @@
     ]
   },
   "peerDependencies": {
-    "mioku": "^0.8.0",
-    "mioki": "^0.16.0"
+    "mioku": "^1.0.0"
+  },
+  "dependencies": {
+    "systeminformation": "^5.31.6"
   },
   "devDependencies": {
-    "mioku": "workspace:*",
-    "mioki": "^0.16.0"
+    "mioku": "workspace:*"
   }
 }

package/status/config.ts

@@ -0,0 +1,17 @@
+/**
+ * help 插件状态图配置（config-service 注册名为 "help/status"）。
+ * 配置文件位于 `<项目>/config/help/status.json`，可热重载。
+ */
+export interface HelpStatusConfig {
+  /**
+   * stdin 适配器在状态图中使用的头像。
+   * 支持 http(s):// 或 file:// URL，也支持本地绝对路径（自动转换为 file://）。
+   * 默认使用 uapis.cn 的随机表情接口。
+   */
+  stdinAvatar?: string;
+}
+
+export const HELP_STATUS_DEFAULT_CONFIG: HelpStatusConfig = {
+  // 默认使用 uapis.cn 的二次元表情随机接口（每次刷新头像都不同）
+  stdinAvatar: "https://uapis.cn/api/v1/random/image?category=bq&type=eciyuan",
+};

package/status/data-collector.ts

@@ -1,16 +1,23 @@
 import * as os from "node:os";
 import * as path from "node:path";
+import systemInfo from "systeminformation";
 import {
+  buildAdapterReport,
   connectedBots,
-  getMiokiStatus,
-  systemInfo,
-  type ExtendedNapCat,
-  type MiokiStatus,
-} from "mioki";
-import type { AIService, MiokiContext } from "mioku";
+  getPluginMetadataList,
+  getService,
+  Services,
+} from "mioku";
+import type {
+  AdapterInstanceStatus,
+  AIService,
+  Bot,
+  MiokuContext,
+} from "mioku";
 import { getRenderVersions } from "../utils";
 import { perfMonitor } from "./performance-monitor";
 import { networkSampler } from "./network-sampler";
+import type { HelpStatusConfig } from "./config";
 import type {
   AIUsageStatsLite,
   AIUsageSummary,
@@ -25,8 +32,6 @@ import type {
   MemoryStick,
   NetworkStatus,
   NodeRuntimeStatus,
-  OneBotStatusData,
-  OneBotVersionInfoData,
   ResourceStatus,
   StatusSnapshot,
   SystemInfo,
@@ -185,113 +190,89 @@ function formatDuration(ms: number): string {
   return `${minutes}分${String(seconds).padStart(2, "0")}秒`;
 }
 
-async function collectBots(): Promise<BotAccountStatus[]> {
+async function collectBots(
+  ctx: MiokuContext,
+  stdinAvatar?: string,
+): Promise<BotAccountStatus[]> {
   const bots = Array.from(connectedBots.values());
   if (bots.length === 0) {
     return [];
   }
-  return collectBotStatuses(bots);
+  // stdin 适配器恒排第一位（终端是本机主人通道，优先展示）
+  const sorted = [...bots].sort(
+    (a, b) =>
+      Number(b.adapter === "stdin") - Number(a.adapter === "stdin"),
+  );
+  return collectBotStatuses(sorted, ctx, stdinAvatar);
+}
+
+/** 把本地绝对路径 / http(s) / file:// 统一成可被截图服务加载的图片地址 */
+function toImageSrc(value: string): string {
+  if (/^(https?:|file:|data:)/i.test(value)) return value;
+  if (value.startsWith("/") || /^[A-Za-z]:[\\/]/.test(value)) {
+    return `file://${value}`;
+  }
+  return value;
 }
 
 async function collectBotStatuses(
-  bots: ExtendedNapCat[],
+  bots: readonly Bot[],
+  ctx: MiokuContext,
+  stdinAvatar?: string,
 ): Promise<BotAccountStatus[]> {
-  let perBotCounts = new Map<number, { send: number; receive: number }>();
-  try {
-    const miokiStatus = await withTimeout(
-      Promise.resolve().then(() => getMiokiStatus(bots)),
-    );
-    if (Array.isArray(miokiStatus?.bots)) {
-      for (const b of miokiStatus.bots) {
-        const u = safeNumber(b?.uin);
-        if (u > 0) {
-          perBotCounts.set(u, {
-            send: safeNumber(b?.send),
-            receive: safeNumber(b?.receive),
-          });
-        }
-      }
+  // 统一走框架的适配器上报，不再按 OneBot 的 get_version_info / get_status 猜
+  const adapters = ctx.adapters.map((adapter) => ({
+    name: adapter.name,
+    version: adapter.version,
+    impl: adapter.impl,
+  }));
+  const report = await withTimeout(buildAdapterReport({ bots, 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);
     }
-  } catch {
-    // ignore
   }
 
-  const results: BotAccountStatus[] = [];
-  for (const bot of bots) {
-    const uin = safeNumber(bot?.bot_id || bot?.uin || bot?.user_id);
-    const nickname = String(bot?.nickname || "Unknown Bot");
-    const framework = String(bot?.app_name || "unknown");
-    const avatarUrl = `https://q1.qlogo.cn/g?b=qq&nk=${uin}&s=160`;
-
-    // 并行拿 OneBot API 的 status / group / friend / version
-    let online = true;
-    let groupCount = 0;
-    let friendCount = 0;
-    let appVersion = "unknown";
-    let protocolVersion = "unknown";
-    const [statusResult, groupsResult, friendsResult, versionResult] =
-      await Promise.allSettled([
-        withTimeout(
-          Promise.resolve().then(() => bot.api<OneBotStatusData>("get_status")),
-        ).catch(() => null),
-        withTimeout(Promise.resolve().then(() => bot.getGroupList())).catch(
-          () => [],
-        ),
-        withTimeout(Promise.resolve().then(() => bot.getFriendList())).catch(
-          () => [],
-        ),
-        withTimeout(
-          Promise.resolve().then(() =>
-            bot.api<OneBotVersionInfoData>("get_version_info"),
-          ),
-        ).catch(() => null),
-      ]);
-    if (statusResult.status === "fulfilled" && statusResult.value) {
-      online = statusResult.value.online;
-    }
-    if (versionResult.status === "fulfilled" && versionResult.value) {
-      const v = versionResult.value;
-      if (v.app_version && v.app_version.trim()) {
-        appVersion = v.app_version.trim();
-      }
-      if (v.protocol_version && v.protocol_version.trim()) {
-        protocolVersion = v.protocol_version.trim();
-      }
-    }
-    if (
-      groupsResult.status === "fulfilled" &&
-      Array.isArray(groupsResult.value)
-    ) {
-      groupCount = groupsResult.value.length;
-    }
-    if (
-      friendsResult.status === "fulfilled" &&
-      Array.isArray(friendsResult.value)
-    ) {
-      friendCount = friendsResult.value.length;
-    }
-
-    const counts = perBotCounts.get(uin) || { send: 0, receive: 0 };
+  return bots.map((bot) => {
+    const uin = String(bot.bot_id);
+    const adapter = String(bot.adapter);
+    const isStdin = adapter === "stdin";
+    const instance = instances.get(`${adapter}:${uin}`);
+    const lib = implOf.get(adapter);
+    // 实现端优先用平台自报的（NapCat / LLOneBot），否则退回适配器的底层库（ICQQ）
+    const framework = instance?.impl || lib?.name || adapter;
+    const appVersion = instance?.version || lib?.version || "";
 
-    results.push({
+    return {
       uin,
-      nickname,
-      avatarUrl,
-      framework,
-      appVersion,
-      protocolVersion,
-      online,
-      groupCount,
-      friendCount,
-      send: counts.send,
-      receive: counts.receive,
-    });
-  }
-  return results;
+      nickname: String(bot.nickname || "Unknown Bot"),
+      avatarUrl: isStdin
+        ? toImageSrc(stdinAvatar || "")
+        : `https://q1.qlogo.cn/g?b=qq&nk=${uin}&s=160`,
+      adapter,
+      framework: isStdin ? adapter : framework,
+      appVersion: isStdin
+        ? String(ctx.getAdapter(adapter)?.version ?? "")
+        : appVersion,
+      protocolVersion: instance?.protocol ?? "",
+      platform: instance?.platform ?? "",
+      platformVersion: instance?.platformVersion ?? "",
+      online: bot.online,
+      groupCount: instance?.stats.groups ?? 0,
+      friendCount: instance?.stats.friends ?? 0,
+      send: instance?.stats.sent ?? 0,
+      receive: instance?.stats.received ?? 0,
+    };
+  });
 }
 
 async function collectFramework(
-  rawBots: ExtendedNapCat[],
+  rawBots: readonly Bot[],
   botStatuses: BotAccountStatus[],
 ): Promise<FrameworkStatus> {
   const adapters = new Set<string>();
@@ -301,28 +282,22 @@ async function collectFramework(
     }
   }
 
-  // 从 mioki 内部服务读 plugins / versions
-  let miokiStatus: MiokiStatus | null = null;
-  try {
-    miokiStatus = await withTimeout(
-      Promise.resolve().then(() => getMiokiStatus(rawBots)),
-    );
-  } catch {
-    // ignore
-  }
-
   const runtime = detectRuntime();
   // Read both versions from the same `getRenderVersions` helper that the
-  // help panel uses, so the status footer and the help footer agree even
-  // when `mioki` is only installed under `mioku/node_modules`.
+  // help panel uses.
   const { miokiVersion, miokuVersion } = await getRenderVersions();
+  const pluginCount = getPluginMetadataList().length;
+  // 优先取第一个非 stdin 的 bot 作为平台框架版本（stdin 是本地终端，无 NapCat）
+  const primaryFramework =
+    botStatuses.find((b) => b.adapter !== "stdin")?.framework ??
+    botStatuses[0]?.framework ??
+    "unknown";
   return {
     miokuVersion,
     miokiVersion,
-    napcatVersion:
-      miokiStatus?.versions?.napcat ?? botStatuses[0]?.framework ?? "unknown",
-    pluginCount: safeNumber(miokiStatus?.plugins?.total),
-    pluginEnabled: safeNumber(miokiStatus?.plugins?.enabled),
+    napcatVersion: primaryFramework,
+    pluginCount,
+    pluginEnabled: pluginCount,
     adapterCount: adapters.size,
     onlineBotCount: botStatuses.filter((b) => b.online).length,
     uptimeMs: safeNumber(process.uptime()) * 1000,
@@ -632,7 +607,7 @@ async function collectSystem(): Promise<SystemInfo> {
   };
 }
 
-async function collectAI(ctx: MiokiContext): Promise<AIUsageStatsLite> {
+async function collectAI(ctx: MiokuContext): Promise<AIUsageStatsLite> {
   const ai = ctx?.services?.ai as AIService | undefined;
   if (!ai || typeof ai.getUsageSummary !== "function") {
     return {
@@ -691,16 +666,29 @@ async function collectAI(ctx: MiokiContext): Promise<AIUsageStatsLite> {
 }
 
 export async function collectSnapshot(
-  ctx: MiokiContext,
+  ctx: MiokuContext,
   options: { isNightMode: boolean } = { isNightMode: false },
 ): Promise<StatusSnapshot> {
   if (cache && Date.now() - cache.at < TTL_MS) {
     return { ...cache.snapshot, isNightMode: options.isNightMode };
   }
 
+  // 读取 help/status 配置（stdin 头像等），失败时回退到默认值
+  let statusConfig: HelpStatusConfig = {};
+  try {
+    const configService = getService(ctx, Services.Config);
+    statusConfig =
+      ((await configService?.getConfig("help", "status")) as
+        | HelpStatusConfig
+        | null
+        | undefined) ?? {};
+  } catch {
+    statusConfig = {};
+  }
+
   const rawBots = Array.from(connectedBots.values());
   const [bots, disk, system, ai, resources] = await Promise.all([
-    collectBots(),
+    collectBots(ctx, statusConfig.stdinAvatar),
     collectDisk(),
     collectSystem(),
     collectAI(ctx),

package/status/html-generator.ts

@@ -1,10 +1,5 @@
-import {
-  escapeHtml,
-} from "../utils";
-import {
-  getHelpTheme,
-  HELP_BACKGROUND_IMAGE_URL,
-} from "../theme";
+import { escapeHtml } from "../utils";
+import { getHelpTheme, HELP_BACKGROUND_IMAGE_URL } from "../theme";
 import type {
   AIUsageStatsLite,
   BotAccountStatus,
@@ -76,7 +71,10 @@ function progressBar(percent: number, color: string): string {
   return `<div class="status-bar"><div class="status-bar__fill" style="width:${clamped}%;background:${color};"></div></div>`;
 }
 
-function progressColor(percent: number, theme: ReturnType<typeof getHelpTheme>): string {
+function progressColor(
+  percent: number,
+  theme: ReturnType<typeof getHelpTheme>,
+): string {
   if (percent >= 85) {
     return "linear-gradient(90deg, #ef4444, #f97316)";
   }
@@ -86,7 +84,10 @@ function progressColor(percent: number, theme: ReturnType<typeof getHelpTheme>):
   return `linear-gradient(90deg, ${theme.eyebrow}, ${theme.commandTitle})`;
 }
 
-function pieColor(percent: number, theme: ReturnType<typeof getHelpTheme>): string {
+function pieColor(
+  percent: number,
+  theme: ReturnType<typeof getHelpTheme>,
+): string {
   if (percent >= 85) {
     return "#ef4444";
   }
@@ -96,7 +97,10 @@ function pieColor(percent: number, theme: ReturnType<typeof getHelpTheme>): stri
   return theme.eyebrow;
 }
 
-function renderPieChart(percent: number, theme: ReturnType<typeof getHelpTheme>): string {
+function renderPieChart(
+  percent: number,
+  theme: ReturnType<typeof getHelpTheme>,
+): string {
   const clamped = Math.max(0, Math.min(100, percent));
   const filled = (clamped / 100) * PIE_CIRCUMFERENCE;
   const rest = PIE_CIRCUMFERENCE - filled;
@@ -128,33 +132,41 @@ function renderHero(
 ): string {
   const bots = snapshot.bots;
 
-  const accountRows = bots.length === 0
-    ? `<div class="status-hero__empty">当前没有在线账号</div>`
-    : bots
-        .map((bot) => {
-          const statusText = bot.online ? "在线" : "离线";
-          const statusColor = bot.online ? "#10b981" : "#ef4444";
-          const frameworkText =
-            bot.appVersion && bot.appVersion !== "unknown"
-              ? `${bot.framework} ${bot.appVersion} · 协议 ${bot.protocolVersion}`
-              : bot.framework;
-          // Nickname is rendered as a bold large heading above the avatar
-          // row (not as a chip). Chips below only carry the metadata.
-          const tags = [
-            { text: String(bot.uin || "—"), kind: "data" },
-            { text: statusText, kind: bot.online ? "ok" : "danger" },
-            { text: `好友 ${fmtNumber(bot.friendCount)}`, kind: "data" },
-            { text: `群聊 ${fmtNumber(bot.groupCount)}`, kind: "data" },
-            { text: `收 ${fmtNumber(bot.receive)}`, kind: "data" },
-            { text: `发 ${fmtNumber(bot.send)}`, kind: "data" },
-            { text: frameworkText, kind: "data" },
-          ];
-          const tagsHtml = tags
-            .map(
-              (t) => `<span class="status-chip status-chip--${t.kind}">${escapeHtml(t.text)}</span>`,
-            )
-            .join("");
-          return `
+  const accountRows =
+    bots.length === 0
+      ? `<div class="status-hero__empty">当前没有在线账号</div>`
+      : bots
+          .map((bot) => {
+            const statusText = bot.online ? "在线" : "离线";
+            const statusColor = bot.online ? "#10b981" : "#ef4444";
+            const implText =
+              bot.adapter === "stdin"
+                ? `${bot.adapter}@${bot.appVersion}`
+                : bot.appVersion
+                  ? `${bot.framework} ${bot.appVersion}${bot.protocolVersion ? ` · 协议 ${bot.protocolVersion}` : ""}`
+                  : bot.framework;
+            const platformText = bot.platform
+              ? `${bot.platform}${bot.platformVersion ? ` v${bot.platformVersion}` : ""}`
+              : "";
+            // Nickname is rendered as a bold large heading above the avatar
+            // row (not as a chip). Chips below only carry the metadata.
+            const tags = [
+              { text: String(bot.uin || "—"), kind: "data" },
+              { text: statusText, kind: bot.online ? "ok" : "danger" },
+              { text: `好友 ${fmtNumber(bot.friendCount)}`, kind: "data" },
+              { text: `群聊 ${fmtNumber(bot.groupCount)}`, kind: "data" },
+              { text: `收 ${fmtNumber(bot.receive)}`, kind: "data" },
+              { text: `发 ${fmtNumber(bot.send)}`, kind: "data" },
+              { text: implText, kind: "data" },
+              ...(platformText ? [{ text: platformText, kind: "data" }] : []),
+            ];
+            const tagsHtml = tags
+              .map(
+                (t) =>
+                  `<span class="status-chip status-chip--${t.kind}">${escapeHtml(t.text)}</span>`,
+              )
+              .join("");
+            return `
             <div class="status-hero__account">
               <div class="status-hero__account-name">${escapeHtml(bot.nickname)}</div>
               <div class="status-hero__account-body">
@@ -166,8 +178,8 @@ function renderHero(
               </div>
             </div>
           `;
-        })
-        .join("");
+          })
+          .join("");
 
   return `
     <header class="status-hero">
@@ -187,8 +199,7 @@ function renderResourceCard(
 ): string {
   const linesHtml = lines
     .map(
-      (line) =>
-        `<div class="status-pie-card__line">${escapeHtml(line)}</div>`,
+      (line) => `<div class="status-pie-card__line">${escapeHtml(line)}</div>`,
     )
     .join("");
   return `
@@ -228,7 +239,10 @@ function renderResourcesSection(
       "SWAP",
       hasSwap ? r.swapPercent : 0,
       hasSwap
-        ? [`${r.swapUsedGB} / ${r.swapTotalGB} GB`, `可用 ${Math.max(0, r.swapTotalGB - r.swapUsedGB).toFixed(2)} GB`]
+        ? [
+            `${r.swapUsedGB} / ${r.swapTotalGB} GB`,
+            `可用 ${Math.max(0, r.swapTotalGB - r.swapUsedGB).toFixed(2)} GB`,
+          ]
         : ["未配置", ""],
       theme,
     ),
@@ -296,10 +310,10 @@ function buildSmoothPath(points: Array<{ x: number; y: number }>): string {
     const p1 = points[i];
     const p2 = points[i + 1];
     const p3 = points[Math.min(points.length - 1, i + 2)];
-    const cp1x = p1.x + (p2.x - p0.x) * tension / 3;
-    const cp1y = p1.y + (p2.y - p0.y) * tension / 3;
-    const cp2x = p2.x - (p3.x - p1.x) * tension / 3;
-    const cp2y = p2.y - (p3.y - p1.y) * tension / 3;
+    const cp1x = p1.x + ((p2.x - p0.x) * tension) / 3;
+    const cp1y = p1.y + ((p2.y - p0.y) * tension) / 3;
+    const cp2x = p2.x - ((p3.x - p1.x) * tension) / 3;
+    const cp2y = p2.y - ((p3.y - p1.y) * tension) / 3;
     d += ` C ${cp1x.toFixed(2)} ${cp1y.toFixed(2)}, ${cp2x.toFixed(2)} ${cp2y.toFixed(2)}, ${p2.x.toFixed(2)} ${p2.y.toFixed(2)}`;
   }
   return d;
@@ -319,10 +333,7 @@ function renderNetworkChart(history: NetworkSample[]): string {
     return `<svg viewBox="0 0 ${w} ${h}" class="status-chart"><text x="${w / 2}" y="${h / 2}" text-anchor="middle" fill="#94a3b8" font-size="11">数据采集中…</text></svg>`;
   }
 
-  const maxVal = Math.max(
-    1,
-    ...history.map((s) => Math.max(s.rxBps, s.txBps)),
-  );
+  const maxVal = Math.max(1, ...history.map((s) => Math.max(s.rxBps, s.txBps)));
   const yMax = maxVal * 1.2;
   const t0 = history[0].ts;
   const t1 = history[history.length - 1].ts;
@@ -484,9 +495,7 @@ function renderSystemSection(
   } else {
     s.memSticks.forEach((m, i) => {
       const size =
-        m.sizeGB >= 1
-          ? `${m.sizeGB} GB`
-          : `${(m.sizeGB * 1024).toFixed(0)} MB`;
+        m.sizeGB >= 1 ? `${m.sizeGB} GB` : `${(m.sizeGB * 1024).toFixed(0)} MB`;
       const speed = m.speedMTs > 0 ? ` · ${m.speedMTs} MT/s` : "";
       const manu =
         m.manufacturer && m.manufacturer !== "Manufacturer"
@@ -524,7 +533,10 @@ function renderSystemSection(
           : `${d.sizeGB} GB`;
       const vendor = d.vendor && d.vendor !== d.name ? `${d.vendor} ` : "";
       const name = d.name || d.type || "Unknown";
-      const iface = d.interfaceType && d.interfaceType !== "Unknown" ? ` · ${d.interfaceType}` : "";
+      const iface =
+        d.interfaceType && d.interfaceType !== "Unknown"
+          ? ` · ${d.interfaceType}`
+          : "";
       items.push({
         label: `硬盘 ${i + 1}`,
         value: `${vendor}${name} · ${sizeLabel}${iface}`.trim(),

package/status/image.ts

@@ -1,4 +1,4 @@
-import type { MiokiContext, ScreenshotService } from "mioku";
+import type { MiokuContext, ScreenshotService } from "mioku";
 import { checkNightMode } from "../utils";
 import { collectSnapshot } from "./data-collector";
 import { renderStatusHtml } from "./html-generator";
@@ -28,7 +28,7 @@ function withTimeout<T>(p: PromiseLike<T>, ms: number): Promise<T> {
 }
 
 export interface GenerateStatusImageOptions {
-  ctx: MiokiContext;
+  ctx: MiokuContext;
   event?: any;
   intent: StatusIntent;
   botNickname?: string;

package/status/intent.ts

@@ -15,7 +15,7 @@ function stripStopword(input: string): string {
   return String(input || "")
     .trim()
     .replace(/^[#/\s]+/, "")
-    .replace(/[。.!！?？,，:：；;]+$/g, "");
+    .replace(/[。.!！?？,，:：；);]+$/g, "");
 }
 
 function normalize(value: string): string {

package/status/network-sampler.ts

@@ -1,4 +1,4 @@
-import { systemInfo } from "mioki";
+import systemInfo from "systeminformation";
 import type { NetworkSample } from "./types";
 
 /**

package/status/types.ts

@@ -7,15 +7,22 @@
  */
 
 export interface BotAccountStatus {
-  uin: number;
+  /** 平台账号标识。QQ 机器人是数字字符串，stdin 等本地适配器是 "stdin"。 */
+  uin: string;
   nickname: string;
   avatarUrl: string;
-  /** Underlying bot framework identifier, e.g. "QQBot" / "NapCat" / "LLOneBot". */
+  /** 适配器名，如 "stdin" / "onebotv11" / "icqq"。 */
+  adapter: string;
+  /** 实现端名称，如 "NapCat" / "LLOneBot" / "ICQQ"，取不到时为空串 */
   framework: string;
-  /** Adapter app version, e.g. "5.0.6" — from OneBot `get_version_info.app_version`. */
+  /** 实现端版本，如 "5.0.6"*/
   appVersion: string;
-  /** OneBot protocol version, e.g. "v11" — from OneBot `get_version_info.protocol_version`. */
+  /** 协议版本，如 OneBot 的 "v11"，没有则为空串 */
   protocolVersion: string;
+  /** 登录设备，如 icqq 的 "aPad"，没有则为空串 */
+  platform: string;
+  /** 登录设备对应的客户端版本，如 "9.3.50.40225"，没有则为空串 */
+  platformVersion: string;
   online: boolean;
   groupCount: number;
   friendCount: number;
@@ -23,27 +30,6 @@ export interface BotAccountStatus {
   receive: number;
 }
 
-/**
- * OneBot v11 `get_version_info` payload (already unwrapped from the
- * `{ status, retcode, data, ... }` envelope by napcat-sdk's `bot.api`).
- */
-export interface OneBotVersionInfoData {
-  app_name: string;
-  protocol_version: string;
-  app_version: string;
-}
-
-/**
- * OneBot v11 `get_status` payload (already unwrapped by napcat-sdk).
- * Per napcat 官方文档: `{ online, good, stat }` —— `stat` 是空对象，
- * 不包含 `start_time` 或任何统计字段。本接口只声明文档承诺的字段。
- */
-export interface OneBotStatusData {
-  online: boolean;
-  good: boolean;
-  stat: Record<string, never>;
-}
-
 /** Subset of mioku's `AIService.getUsageSummary` payload that we actually render. */
 export interface AIUsageSummary {
   totals?: {
@@ -123,13 +109,11 @@ export interface NodeRuntimeStatus {
   arrayBuffersMB: number;
   eventLoopDelayMs: { mean: number; p99: number };
   /** null when `--expose-gc` is not enabled. */
-  gc:
-    | {
-        available: boolean;
-        count: number;
-        lastDurationMs?: number;
-      }
-    | null;
+  gc: {
+    available: boolean;
+    count: number;
+    lastDurationMs?: number;
+  } | null;
 }
 
 export interface NetworkSample {

package/utils.ts

@@ -96,9 +96,9 @@ export async function getRenderVersions(): Promise<{
 
   const miokiCandidates = [
     // Nested under mioku (the typical workspace case).
-    path.join(process.cwd(), "node_modules", "mioku", "node_modules", "mioki", "package.json"),
+    path.join(process.cwd(), "node_modules", "mioku", "node_modules", "mioku", "package.json"),
     // Hoisted top-level (a single-package install).
-    path.join(process.cwd(), "node_modules", "mioki", "package.json"),
+    path.join(process.cwd(), "node_modules", "mioku", "package.json"),
   ];
   const miokuCandidates = [
     path.join(process.cwd(), "node_modules", "mioku", "package.json"),
@@ -107,7 +107,7 @@ export async function getRenderVersions(): Promise<{
 
   let miokiVersion = "unknown";
   for (const candidate of miokiCandidates) {
-    const v = await readNamedPackageVersion(candidate, "mioki");
+    const v = await readNamedPackageVersion(candidate, "mioku");
     if (v !== "unknown") {
       miokiVersion = v;
       break;