koishi-plugin-stock 2.0.14 → 2.0.15

package/README.md

@@ -11,6 +11,8 @@
 - 用户发送"选股 [策略名称]"命令时，自动从 `dyq_select` API获取选股结果
 - 用户发送"骑"命令时，自动返回 `images/qi.jpeg` 图片
 - 用户发送"心法抽卡"命令时，随机抽取一条交易心法并播放对应音频
+- 用户发送"我要验牌 [序号]"命令时，播放指定序号的心法语音
+- 用户发送"我要验牌 全部"命令时，显示所有心法文本列表
 - 支持定时广播任务，可自定义时间发送活跃市值、涨停/跌停看板（仅交易日广播）
 - 支持为每个指令单独设置黑名单，可限制特定用户使用特定功能
 - 自动格式化数据显示给用户
@@ -56,11 +58,18 @@ npm install koishi-plugin-stock
 - 发送"选股 [策略名称或编号]"获取选股结果，支持的策略：N型(1)、填坑(2)、少妇(3)、突破(4)、补票(5)、少妇pro(6)
 - 发送"骑"获取图片
 - 发送"心法抽卡"随机抽取一条交易心法并播放对应音频
+- 发送"我要验牌 全部"查看所有心法文本列表
+- 发送"我要验牌 <序号>"播放指定序号的心法语音(1-58)
 
 配置黑名单可在插件设置中进行，将特定用户ID添加到相应指令的黑名单中即可限制其使用权限。
 
 ## 更新日志
 
+### v2.0.15 (2026-02-28)
+- 新增"我要验牌"命令：支持查看指定序号的心法语音或查看全部心法文本
+- 新增验牌功能黑白名单配置：支持为验牌功能单独设置用户和频道黑名单
+- 增强用户体验：提供清晰的参数使用说明和错误提示
+
 ### v2.0.14 (2026-02-28)
 - 优化交易日判断：使用stock.svip886.com提供的专业交易日API替代timor.tech节假日接口
 - 改进API调用：直接解析JSON响应，提高判断准确性

package/lib/index.d.ts

@@ -25,6 +25,8 @@ export interface Config {
     enableHeartMethod?: boolean;
     heartMethodBlacklist?: string[];
     heartMethodChannelBlacklist?: string[];
+    verifyCardBlacklist?: string[];
+    verifyCardChannelBlacklist?: string[];
 }
 export declare const Config: Schema<Config>;
 export declare function apply(ctx: Context, config: Config): void;

package/lib/index.js

@@ -28,6 +28,7 @@ exports.Config = koishi_1.Schema.object({
     stockSelectionBlacklist: koishi_1.Schema.array(String).description('选股指令黑名单用户ID'),
     rideBlacklist: koishi_1.Schema.array(String).description('骑指令黑名单用户ID'),
     heartMethodBlacklist: koishi_1.Schema.array(String).description('心法抽卡指令黑名单用户ID'),
+    verifyCardBlacklist: koishi_1.Schema.array(String).description('验牌指令黑名单用户ID'),
     // --- 频道黑名单 ---
     allCommandsChannelBlacklist: koishi_1.Schema.array(String).description('全部指令黑名单频道ID'),
     activeMarketCapChannelBlacklist: koishi_1.Schema.array(String).description('活跃市值指令黑名单频道ID'),
@@ -37,6 +38,7 @@ exports.Config = koishi_1.Schema.object({
     stockSelectionChannelBlacklist: koishi_1.Schema.array(String).description('选股指令黑名单频道ID'),
     rideChannelBlacklist: koishi_1.Schema.array(String).description('骑指令黑名单频道ID'),
     heartMethodChannelBlacklist: koishi_1.Schema.array(String).description('心法抽卡指令黑名单频道ID'),
+    verifyCardChannelBlacklist: koishi_1.Schema.array(String).description('验牌指令黑名单频道ID'),
     // --- 定时广播 ---
     broadcastTasks: koishi_1.Schema.array(BroadcastTask).description('定时广播任务列表'),
     // --- 心法抽卡 ---
@@ -347,6 +349,11 @@ function apply(ctx, config) {
                     return true;
                 }
                 break;
+            case '验牌':
+                if (config.verifyCardBlacklist?.includes(userId)) {
+                    return true;
+                }
+                break;
         }
         // 检查特定指令的频道黑名单
         switch (commandName) {
@@ -385,6 +392,11 @@ function apply(ctx, config) {
                     return true;
                 }
                 break;
+            case '验牌':
+                if (config.verifyCardChannelBlacklist?.includes(channelId)) {
+                    return true;
+                }
+                break;
         }
         // 检查全局用户黑名单
         if (config.allCommandsBlacklist?.includes(userId)) {
@@ -595,6 +607,62 @@ function apply(ctx, config) {
             return '心法抽卡失败，请稍后重试';
         }
     });
+    // 我要验牌命令
+    ctx.command('我要验牌 [param:text]', '验牌功能：查看指定序号的心法或查看全部心法')
+        .action(async ({ session }, param) => {
+        // 检查黑名单
+        if (isUserInSpecificBlacklist(session, '验牌')) {
+            return;
+        }
+        // 检查是否有心法数据
+        if (heartMethods.length === 0) {
+            return '暂无心法数据';
+        }
+        try {
+            // 处理"全部"参数
+            if (param && param.trim() === '全部') {
+                logger.info(`[验牌] 用户 ${session?.userId || '未知'} 请求查看全部心法`);
+                // 生成带序号的完整列表
+                let result = '🃏 全部心法列表：\n\n';
+                heartMethods.forEach((method, index) => {
+                    result += `${index + 1}. ${method.text}\n`;
+                });
+                logger.info(`[验牌] 成功生成全部心法列表，共 ${heartMethods.length} 条`);
+                return result;
+            }
+            // 处理数字序号参数
+            if (param && /^\d+$/.test(param.trim())) {
+                const index = parseInt(param.trim()) - 1; // 转换为0基索引
+                if (index < 0 || index >= heartMethods.length) {
+                    return `序号超出范围，请输入 1-${heartMethods.length} 之间的数字`;
+                }
+                const selectedMethod = heartMethods[index];
+                logger.info(`[验牌] 用户 ${session?.userId || '未知'} 查看序号 ${index + 1}: ${selectedMethod.code}`);
+                // 读取对应的音频文件
+                const fs = require('fs');
+                const path = require('path');
+                const audioPath = path.resolve(__dirname, `../audio/${selectedMethod.file}`);
+                if (!fs.existsSync(audioPath)) {
+                    // 音频文件不存在，只返回文本
+                    return `🃏 验牌结果 #${index + 1}\n\n${selectedMethod.text}\n\n(音频文件缺失: ${selectedMethod.file})`;
+                }
+                // 读取音频文件并转换为base64
+                const audioData = fs.readFileSync(audioPath);
+                const base64Audio = audioData.toString('base64');
+                // 返回音频消息
+                const response = `<audio src="data:audio/mp3;base64,${base64Audio}" />#${index + 1} ${selectedMethod.text}`;
+                logger.info(`[验牌] 成功生成序号 ${index + 1} 的响应`);
+                return response;
+            }
+            // 参数格式错误
+            return '参数格式错误。请使用：\n"我要验牌 全部" - 查看所有心法\n"我要验牌 <序号>" - 查看指定序号的心法(1-58)';
+        }
+        catch (error) {
+            logger.error('[验牌] 执行失败:', error);
+            logger.error('[验牌] 错误详情:', error.stack);
+            return '验牌失败，请稍后重试';
+        }
+    });
     // 使用中间件方式监听特定关键词（作为备用方案）
     ctx.middleware(async (session, next) => {
         const content = session.content?.trim();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "koishi-plugin-stock",
-  "version": "2.0.14",
+  "version": "2.0.15",
   "description": "A Koishi plugin that fetches stock data and provides market analysis, including active market cap, stock alerts, limit-up board, stock selection features, and heart method card drawing with configurable blacklists for each command.",
   "main": "lib/index.js",
   "typings": "lib/index.d.ts",