mioku-plugin-help 2.3.3 → 3.0.0

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.0",
   "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,17 @@
 import * as os from "node:os";
 import * as path from "node:path";
+import systemInfo from "systeminformation";
 import {
   connectedBots,
-  getMiokiStatus,
-  systemInfo,
-  type ExtendedNapCat,
-  type MiokiStatus,
-} from "mioki";
-import type { AIService, MiokiContext } from "mioku";
+  getPluginMetadataList,
+  getService,
+  Services,
+} from "mioku";
+import type { 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,
@@ -185,45 +186,47 @@ 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);
 }
 
-async function collectBotStatuses(
-  bots: ExtendedNapCat[],
-): 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),
-          });
-        }
-      }
-    }
-  } catch {
-    // ignore
+/** 把本地绝对路径 / 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: readonly Bot[],
+  ctx: MiokuContext,
+  stdinAvatar?: string,
+): Promise<BotAccountStatus[]> {
   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`;
+    const uin = String(bot.bot_id);
+    const adapter = String(bot.adapter);
+    const isStdin = adapter === "stdin";
+    const nickname = String(bot.nickname || "Unknown Bot");
+    let framework = isStdin ? adapter : "unknown";
+    const avatarUrl = isStdin
+      ? toImageSrc(stdinAvatar || "")
+      : `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;
@@ -231,9 +234,9 @@ async function collectBotStatuses(
     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.sendApi<OneBotStatusData>("get_status"))).catch(
+          () => null,
+        ),
         withTimeout(Promise.resolve().then(() => bot.getGroupList())).catch(
           () => [],
         ),
@@ -241,16 +244,18 @@ async function collectBotStatuses(
           () => [],
         ),
         withTimeout(
-          Promise.resolve().then(() =>
-            bot.api<OneBotVersionInfoData>("get_version_info"),
-          ),
+          Promise.resolve().then(() => bot.sendApi<OneBotVersionInfoData>("get_version_info")),
         ).catch(() => null),
       ]);
     if (statusResult.status === "fulfilled" && statusResult.value) {
-      online = statusResult.value.online;
+      online = Boolean(statusResult.value.online);
     }
-    if (versionResult.status === "fulfilled" && versionResult.value) {
+    if (isStdin) {
+      // 终端适配器没有 OneBot 版本信息，直接用适配器包版本
+      appVersion = String(ctx.getAdapter(adapter)?.version ?? "unknown");
+    } else if (versionResult.status === "fulfilled" && versionResult.value) {
       const v = versionResult.value;
+      framework = String(v.app_name || "").trim() || framework;
       if (v.app_version && v.app_version.trim()) {
         appVersion = v.app_version.trim();
       }
@@ -271,27 +276,26 @@ async function collectBotStatuses(
       friendCount = friendsResult.value.length;
     }
 
-    const counts = perBotCounts.get(uin) || { send: 0, receive: 0 };
-
     results.push({
       uin,
       nickname,
       avatarUrl,
+      adapter,
       framework,
       appVersion,
       protocolVersion,
       online,
       groupCount,
       friendCount,
-      send: counts.send,
-      receive: counts.receive,
+      send: 0,
+      receive: 0,
     });
   }
   return results;
 }
 
 async function collectFramework(
-  rawBots: ExtendedNapCat[],
+  rawBots: readonly Bot[],
   botStatuses: BotAccountStatus[],
 ): Promise<FrameworkStatus> {
   const adapters = new Set<string>();
@@ -301,28 +305,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 +630,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 +689,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

@@ -134,10 +134,13 @@ function renderHero(
         .map((bot) => {
           const statusText = bot.online ? "在线" : "离线";
           const statusColor = bot.online ? "#10b981" : "#ef4444";
+          // stdin 等本地适配器没有 OneBot 版本信息，统一显示为 `<适配器>@<包版本>`
           const frameworkText =
-            bot.appVersion && bot.appVersion !== "unknown"
-              ? `${bot.framework} ${bot.appVersion} · 协议 ${bot.protocolVersion}`
-              : bot.framework;
+            bot.adapter === "stdin"
+              ? `${bot.adapter}@${bot.appVersion}`
+              : 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 = [

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,9 +7,12 @@
  */
 
 export interface BotAccountStatus {
-  uin: number;
+  /** 平台账号标识。QQ 机器人是数字字符串，stdin 等本地适配器是 "stdin"。 */
+  uin: string;
   nickname: string;
   avatarUrl: string;
+  /** 适配器名，如 "stdin" / "onebotv11" / "icqq"。 */
+  adapter: string;
   /** Underlying bot framework identifier, e.g. "QQBot" / "NapCat" / "LLOneBot". */
   framework: string;
   /** Adapter app version, e.g. "5.0.6" — from OneBot `get_version_info.app_version`. */
@@ -25,7 +28,7 @@ export interface BotAccountStatus {
 
 /**
  * OneBot v11 `get_version_info` payload (already unwrapped from the
- * `{ status, retcode, data, ... }` envelope by napcat-sdk's `bot.api`).
+ * `{ status, retcode, data, ... }` envelope by the adapter's `bot.sendApi`).
  */
 export interface OneBotVersionInfoData {
   app_name: string;

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;