koishi-plugin-noah 2.3.8 → 2.4.1

package/lib/fun/poke/commands/poke.d.ts

@@ -0,0 +1,6 @@
+import { Context } from 'koishi';
+/**
+ * 注册 poke 命令：主动戳一戳目标用户
+ * @param ctx - koishi 上下文
+ */
+export declare function registerPokeCommand(ctx: Context): void;

package/lib/fun/poke/commands/stamp.d.ts

@@ -0,0 +1,6 @@
+import { Context } from 'koishi';
+/**
+ * 注册 stamp 命令：手动发送随机贴纸
+ * @param ctx - koishi 上下文
+ */
+export declare function registerStampCommand(ctx: Context): void;

package/lib/fun/poke/constants.d.ts

@@ -0,0 +1,10 @@
+/** 支持的图片扩展名 */
+export declare const IMAGE_EXTENSIONS: readonly [".png", ".jpg", ".jpeg", ".gif", ".webp"];
+/** 扩展名到 MIME 类型的映射 */
+export declare const MIME_MAP: Record<string, string>;
+/** MIME 类型兜底值 */
+export declare const DEFAULT_MIME = "image/png";
+/** tip 缺省语言（用户无匹配偏好时使用） */
+export declare const DEFAULT_LOCALE = "zh-CN";
+/** 被戳时 text 类型随机抽取的提示池（按语言区分） */
+export declare const TIP_POOL: Record<string, string[]>;

package/lib/fun/poke/events/notice.d.ts

@@ -0,0 +1,9 @@
+import { Context } from 'koishi';
+import { PokeConfig } from '../../../types/config';
+/**
+ * 注册被戳事件处理：命中冷却发警告，否则按权重分发文本/贴纸
+ * @param ctx - koishi 上下文
+ * @param config - 戳一戳配置
+ * @param cache - 用户 -> 上次触发时间戳的冷却缓存
+ */
+export declare function registerPokeNotice(ctx: Context, config: PokeConfig, cache: Map<string, number>): void;

package/lib/fun/poke/index.d.ts

@@ -1,4 +1,5 @@
-import { Context } from 'koishi';
+import { Context, Logger } from 'koishi';
 import { AppConfig } from '../../types/config';
 export declare const name = "Noah-Poke";
+export declare const logger: Logger;
 export declare function apply(ctx: Context, config: AppConfig): void;

package/lib/fun/poke/types.d.ts

@@ -6,7 +6,12 @@ declare module 'koishi' {
         targetId: string;
     }
 }
+export type MessageReplyType = 'text' | 'noah' | 'chat';
 export interface MessageReply {
+    type: MessageReplyType;
+    weight: number;
+}
+export interface PromptReply {
     content: string;
     weight: number;
 }

package/lib/fun/poke/utils/file.d.ts

@@ -0,0 +1,18 @@
+/**
+ * 判断文件是否为图片
+ * @param filename - 文件名
+ * @returns 是否为支持的图片格式
+ */
+export declare function isImageFile(filename: string): boolean;
+/**
+ * 根据文件名获取 MIME 类型
+ * @param filename - 文件名
+ * @returns MIME 类型，未匹配时返回兜底值
+ */
+export declare function getMimeType(filename: string): string;
+/**
+ * 查找贴纸图片对应的语音文件
+ * @param imagePath - 贴纸图片完整路径（如 .../stamp_0384_01.png）
+ * @returns 匹配的音频文件路径（如 .../xxx-1.mp3），未找到返回 null
+ */
+export declare function findMatchingAudio(imagePath: string): string | null;

package/lib/fun/poke/utils/random.d.ts

@@ -0,0 +1,14 @@
+/**
+ * 按权重随机选取一项
+ * @param items - 带 weight 字段的数组
+ * @returns 命中的元素，空数组时返回 undefined
+ */
+export declare function randomMessage<T extends {
+    weight: number;
+}>(items: T[]): T | undefined;
+/**
+ * 从数组中等概率随机取一项
+ * @param items - 任意数组
+ * @returns 随机元素，空数组时返回 undefined
+ */
+export declare function pickRandom<T>(items: T[]): T | undefined;

package/lib/fun/poke/utils/stamp.d.ts

@@ -0,0 +1,14 @@
+import { Context, h, Session } from 'koishi';
+/**
+ * 随机发送一个 noah 贴纸（文件夹形式，可附带语音）
+ * @param ctx - koishi 上下文
+ * @param session - 当前会话
+ * @param voiceOnly - 是否仅选取带语音的贴纸
+ */
+export declare function sendRandomNoahStamp(ctx: Context, session: Session, voiceOnly?: boolean): Promise<void>;
+/**
+ * 随机选取一个 chat 贴纸（直接图片形式）
+ * @param ctx - koishi 上下文
+ * @returns 图片消息元素，失败时返回错误文本
+ */
+export declare function getRandomChatStamp(ctx: Context): h | string;

package/lib/fun/poke/utils/tip.d.ts

@@ -0,0 +1,10 @@
+import { Session } from 'koishi';
+/**
+ * 根据用户偏好语言随机选取一条 tip
+ *
+ * 按用户的 locales（偏好语言顺序）依次匹配 TIP_POOL，
+ * 命中首个有内容的语言；都不匹配时回退到默认语言。
+ * @param session - 当前会话
+ * @returns 随机 tip 文本，无可用 tip 时返回 undefined
+ */
+export declare function pickTip(session: Session): Promise<string | undefined>;