koishi-plugin-stock

一个Koishi插件，当用户发送特定命令时自动获取股票数据并显示结果。支持活跃市值、异动分析、涨停看板、跌停看板和选股功能，并提供指令级黑名单配置和定时广播任务。

功能

- 用户发送"活跃市值"命令时，自动从 indexesAPI获取数据并格式化显示
- 用户发送"异动 [股票代码]"命令时，自动从 analyzeAPI获取指定股票的异动分析数据
- 用户发送"涨停看板"命令时，自动从 limit_upAPI下载图片并显示
- 用户发送"跌停看板"命令时，自动从 limit_downAPI下载图片并显示
- 用户发送"选股 [策略名称]"命令时，自动从 dyq_select API获取选股结果
- 用户发送"骑"命令时，自动返回 images/qi.jpeg 图片
- 支持定时广播任务，可自定义时间发送活跃市值、涨停/跌停看板（仅交易日广播）
- 支持为每个指令单独设置黑名单，可限制特定用户使用特定功能
- 自动格式化数据显示给用户

安装

bash

npm install koishi-plugin-stock





配置



此插件支持以下配置选项：



-

allCommandsBlacklist

: 全部指令黑名单用户ID数组

-

activeMarketCapBlacklist

: 活跃市值指令黑名单用户ID数组

-

stockAlertBlacklist

: 异动指令黑名单用户ID数组

-

limitUpBoardBlacklist

: 涨停看板指令黑名单用户ID数组

-

limitDownBoardBlacklist

: 跌停看板指令黑名单用户ID数组

-

stockSelectionBlacklist

: 选股指令黑名单用户ID数组

-

rideBlacklist

: 骑指令黑名单用户ID数组

-

allCommandsChannelBlacklist

: 全部指令黑名单频道ID数组

-

activeMarketCapChannelBlacklist

: 活跃市值指令黑名单频道ID数组

-

stockAlertChannelBlacklist

: 异动指令黑名单频道ID数组

-

limitUpBoardChannelBlacklist

: 涨停看板指令黑名单频道ID数组

-

limitDownBoardChannelBlacklist

: 跌停看板指令黑名单频道ID数组

-

stockSelectionChannelBlacklist

: 选股指令黑名单频道ID数组

-

rideChannelBlacklist

: 骑指令黑名单频道ID数组

-

broadcastTasks

: 定时广播任务列表，每个任务包含：

  -

times: 触发时间 (逗号分隔的事列，如 09:30,15:00

)

  -

type

: 消息类型 (private/channel)

  -

targetIds

: 目标 ID 列表 (逗号分隔的事列)

  -

content

: 广播内容 (活跃市值/涨停看板/跌停看板)



使用



- 发送"活跃市值"获取最新的市场指数数据

- 发送"异动 [股票代码]"获取指定股票的异动分析，如"异动 000001"

- 发送"涨停看板"获取涨停股票看板图片

- 发送"跌停看板"获取跌停股票看板图片

- 发送"选股 [策略名称或编号]"获取选股结果，支持的策略：N型(1)、填坑(2)、少妇(3)、突破(4)、补票(5)、少妇pro(6)

- 发送"骑"获取图片



配置黑名单可在插件设置中进行，将特定用户ID添加到相应指令的黑名单中即可限制其使用权限。



更新日志



$3

- 优化黑名单处理逻辑：当触发指令的用户或频道处于黑名单时，插件将静默处理（直接不回复），不再发送提示消息。



$3

- 新增定时广播任务失败重试机制：当网络中断导致消息发送失败时，自动开启 3 次重试，每次间隔 1 分钟

- 引入任务时效性检查：重试过程中若达到该任务的下一个执行时间点，则自动取消当前重试，防止消息堆积



$3

- 优化定时任务触发逻辑：改用

Intl

 API 获取确切的上海时区时间，解决部分环境下时区偏移导致的触发失败问题

- 增强时间格式容错：自动处理

9:30 vs 09:30

 以及全角冒号等配置问题

- 完善节假日 API：增加对 Cloudflare 拦截页面的防御逻辑，请求失败时自动回退到基础周末检查，确保任务触发稳定性

- 改进日志输出：在

info

 级别增加关键任务触发和跳过的日志，方便诊断问题



$3

- 使用标准 Koishi 配置注释、每个配置分类上壳有中文注释，更清晰地区分配置组



$3

- 实现 Koishi 业界标准的配置分组，每个配置项打上对应的 role 标签，在插件设置页中形成可折叠的分组



$3

- 优化插件配置页显示，使用 Koishi 行业标准方式实现配置分类，每个配置项描述前缀形成分类标签



$3

- 优化插件配置页显示，描述中添加配置分类标签（用户黑名单、频道黑名单、定时广播）



$3

- 优化插件设置页配置展示，按功能分类整理配置项（系统设置、用户黑名单、频道黑名单、定时广播）



$3

- 修复时区问题：Node.js 返回 UTC 时间而非本地时间，手动调整 UTC+8 获取中国时间

- 定时任务功能现已正常工作

- 添加

enableDebugLog

 配置选项，调试日志默认关闭，需要时可启用

- 清理历史有问题的旧版本



$3

- 修复时区问题：手动调整 UTC+8 转换为中国本地时间

- 优化交易日检查的时区不一致问题



$3

- 添加调试信息用于时间不匹配问题诊断



$3

- 修复定时任务检查间隔需要重新编译的问题

- 改为 1 秒检查一次，使用 logger.info 输出日志



$3

- 修复定时任务 1 分钟检查一次的问题，改为 1 秒检查一次，确保不会错过任务时间

- 日志级别改为 info，方便查看日志



$3

- 添加详细的执行日志，追踪图片下载、消息发送的全过程

- 添加机器人信息输出，便于调试发送失败



$3

- 修复广播任务配置中

content

 字段不保存的问题

- 添加

content` 字段的默认值：活跃市值

$3

- 添加插件启动日志，方便确认插件是否正常加载
- 添加定时任务运行状态日志，方便调试

$3

- 修复定时广播任务不发送的问题
- 优化配置验证逻辑，添加了详细的错误日志
- 改进了 API 调用的错误处理，单个API失败不会中断整个任务执行

$3

- 改进定时广播配置，支持一个任务配置多个触发时间
- 支持指定多个目标 ID，支持一次广播给多个用户/群组
- 优化了广播发送逻辑，增强了错误处理能力

$3

- 新增定时广播任务功能，支持自定义时间发送指数和看板数据
- 自动识别中国交易日（排除周末及法定节假日）

$3

- 添加了"跌停看板"指令，可获取跌停股票看板图片

$3

- 添加了频道/群聊黑名单功能，支持按频道ID限制指令使用

$3

- 修复了"骑"指令，使用本地图片路径并返回base64编码的图片

$3

- 添加了"骑"指令，可返回本地图片

$3

- 添加了指令级黑名单功能，可为每个指令单独设置黑名单

$3

- 修复了一些小问题

$3

- 优化了部分功能

$3

- 添加了选股功能的数字编号支持

$3

- 添加了选股功能的数字编号（1-6对应不同策略）

$3

- 添加了选股功能，支持多种选股策略

$3

- 添加了涨停看板功能

$3

- 初始版本，包含活跃市值和异动分析功能

koishi-plugin-stock

功能

安装

bash

npm install koishi-plugin-stock





配置



此插件支持以下配置选项：



-

allCommandsBlacklist

: 全部指令黑名单用户ID数组

-

activeMarketCapBlacklist

: 活跃市值指令黑名单用户ID数组

-

stockAlertBlacklist

: 异动指令黑名单用户ID数组

-

limitUpBoardBlacklist

: 涨停看板指令黑名单用户ID数组

-

limitDownBoardBlacklist

: 跌停看板指令黑名单用户ID数组

-

stockSelectionBlacklist

: 选股指令黑名单用户ID数组

-

rideBlacklist

: 骑指令黑名单用户ID数组

-

allCommandsChannelBlacklist

: 全部指令黑名单频道ID数组

-

activeMarketCapChannelBlacklist

: 活跃市值指令黑名单频道ID数组

-

stockAlertChannelBlacklist

: 异动指令黑名单频道ID数组

-

limitUpBoardChannelBlacklist

: 涨停看板指令黑名单频道ID数组

-

limitDownBoardChannelBlacklist

: 跌停看板指令黑名单频道ID数组

-

stockSelectionChannelBlacklist

: 选股指令黑名单频道ID数组

-

rideChannelBlacklist

: 骑指令黑名单频道ID数组

-

broadcastTasks

: 定时广播任务列表，每个任务包含：

  -

times: 触发时间 (逗号分隔的事列，如 09:30,15:00

)

  -

type

: 消息类型 (private/channel)

  -

targetIds

: 目标 ID 列表 (逗号分隔的事列)

  -

content

: 广播内容 (活跃市值/涨停看板/跌停看板)



使用



- 发送"活跃市值"获取最新的市场指数数据

- 发送"异动 [股票代码]"获取指定股票的异动分析，如"异动 000001"

- 发送"涨停看板"获取涨停股票看板图片

- 发送"跌停看板"获取跌停股票看板图片

- 发送"选股 [策略名称或编号]"获取选股结果，支持的策略：N型(1)、填坑(2)、少妇(3)、突破(4)、补票(5)、少妇pro(6)

- 发送"骑"获取图片



配置黑名单可在插件设置中进行，将特定用户ID添加到相应指令的黑名单中即可限制其使用权限。



更新日志



$3

- 优化黑名单处理逻辑：当触发指令的用户或频道处于黑名单时，插件将静默处理（直接不回复），不再发送提示消息。



$3

- 新增定时广播任务失败重试机制：当网络中断导致消息发送失败时，自动开启 3 次重试，每次间隔 1 分钟

- 引入任务时效性检查：重试过程中若达到该任务的下一个执行时间点，则自动取消当前重试，防止消息堆积



$3

- 优化定时任务触发逻辑：改用

Intl

 API 获取确切的上海时区时间，解决部分环境下时区偏移导致的触发失败问题

- 增强时间格式容错：自动处理

9:30 vs 09:30

 以及全角冒号等配置问题

- 完善节假日 API：增加对 Cloudflare 拦截页面的防御逻辑，请求失败时自动回退到基础周末检查，确保任务触发稳定性

- 改进日志输出：在

info

 级别增加关键任务触发和跳过的日志，方便诊断问题



$3

- 使用标准 Koishi 配置注释、每个配置分类上壳有中文注释，更清晰地区分配置组



$3

- 实现 Koishi 业界标准的配置分组，每个配置项打上对应的 role 标签，在插件设置页中形成可折叠的分组



$3

- 优化插件配置页显示，使用 Koishi 行业标准方式实现配置分类，每个配置项描述前缀形成分类标签



$3

- 优化插件配置页显示，描述中添加配置分类标签（用户黑名单、频道黑名单、定时广播）



$3

- 优化插件设置页配置展示，按功能分类整理配置项（系统设置、用户黑名单、频道黑名单、定时广播）



$3

- 修复时区问题：Node.js 返回 UTC 时间而非本地时间，手动调整 UTC+8 获取中国时间

- 定时任务功能现已正常工作

- 添加

enableDebugLog

 配置选项，调试日志默认关闭，需要时可启用

- 清理历史有问题的旧版本



$3

- 修复时区问题：手动调整 UTC+8 转换为中国本地时间

- 优化交易日检查的时区不一致问题



$3

- 添加调试信息用于时间不匹配问题诊断



$3

- 修复定时任务检查间隔需要重新编译的问题

- 改为 1 秒检查一次，使用 logger.info 输出日志



$3

- 修复定时任务 1 分钟检查一次的问题，改为 1 秒检查一次，确保不会错过任务时间

- 日志级别改为 info，方便查看日志



$3

- 添加详细的执行日志，追踪图片下载、消息发送的全过程

- 添加机器人信息输出，便于调试发送失败



$3

- 修复广播任务配置中

content

 字段不保存的问题

- 添加

content` 字段的默认值：活跃市值

$3

- 添加插件启动日志，方便确认插件是否正常加载
- 添加定时任务运行状态日志，方便调试

$3

- 修复定时广播任务不发送的问题
- 优化配置验证逻辑，添加了详细的错误日志
- 改进了 API 调用的错误处理，单个API失败不会中断整个任务执行

$3

- 新增定时广播任务功能，支持自定义时间发送指数和看板数据
- 自动识别中国交易日（排除周末及法定节假日）

$3

- 添加了"跌停看板"指令，可获取跌停股票看板图片

$3

- 添加了频道/群聊黑名单功能，支持按频道ID限制指令使用

$3

- 修复了"骑"指令，使用本地图片路径并返回base64编码的图片

$3

- 添加了"骑"指令，可返回本地图片

$3

- 添加了指令级黑名单功能，可为每个指令单独设置黑名单

$3

- 修复了一些小问题

$3

- 优化了部分功能

$3

- 添加了选股功能的数字编号支持

$3

- 添加了选股功能的数字编号（1-6对应不同策略）

$3

- 添加了选股功能，支持多种选股策略

$3

- 添加了涨停看板功能

$3

- 初始版本，包含活跃市值和异动分析功能