koishi-plugin-monetary-bourse 3.0.0-alpha.18 → 3.0.0-alpha.19

package/lib/commands-admin.d.ts

@@ -9,6 +9,7 @@ type AdminCommandDeps = {
     setWasMarketOpen: (value: boolean) => void;
     isMarketOpen: () => Promise<boolean>;
     switchKLinePattern: (reason: string, expectedPrice?: number, cycleProgress?: number) => void;
+    broadcastMacroNews: (targetPrice: number, basePrice: number) => Promise<void>;
 };
 export declare function registerAdminCommands(deps: AdminCommandDeps): void;
 export {};

package/lib/index.d.ts

@@ -68,6 +68,10 @@ export type SellFeeTier = {
     minAmount: number;
     feePercent: number;
 };
+export type NewsItem = {
+    text: string;
+    weight: number;
+};
 export interface Config {
     currency: string;
     stockName: string;
@@ -87,6 +91,10 @@ export interface Config {
     biasMax: number;
     dividendIntervalDays: number;
     maxDividendRate: number;
+    newsDeviationThreshold: number;
+    broadcastChannels: string[];
+    positiveNews: NewsItem[];
+    negativeNews: NewsItem[];
 }
 export declare const Config: Schema<Config>;
 export declare function apply(ctx: Context, config: Config): void;

package/lib/index.js

@@ -522,7 +522,8 @@ function registerAdminCommands(deps) {
     getDailyOpenPrice,
     setWasMarketOpen,
     isMarketOpen,
-    switchKLinePattern
+    switchKLinePattern,
+    broadcastMacroNews
   } = deps;
   ctx.command(
     "stock.control <price:number> [hours:number]",
@@ -568,6 +569,7 @@ function registerAdminCommands(deps) {
         updateFields
       );
     }
+    await broadcastMacroNews(targetPriceClamped, currentPrice);
     const hint = targetPriceClamped !== price ? `（已按±50%限幅从${price}调整为${Number(targetPriceClamped.toFixed(2))}）` : "";
     return `宏观调控已设置：
 目标价格：${Number(targetPriceClamped.toFixed(2))}${hint}
@@ -1292,6 +1294,44 @@ var Config = import_koishi2.Schema.intersect([
     dividendIntervalDays: import_koishi2.Schema.number().min(1).step(1).default(7).description("分红结算周期（天）"),
     maxDividendRate: import_koishi2.Schema.number().min(0).max(1).step(0.01).default(0.15).description("最大分红期望利润率（0-1，超出部分用于除息而非派发）")
   }).description("分红机制"),
+  import_koishi2.Schema.object({
+    newsDeviationThreshold: import_koishi2.Schema.number().min(0.05).max(1).step(0.01).default(0.15).description(
+      "触发新闻的偏离度阈值（例如 0.15 表示当新目标价与当前价相差 15% 以上时触发）"
+    ),
+    broadcastChannels: import_koishi2.Schema.array(import_koishi2.Schema.string()).default([]).description(
+      "播报新闻的频道/群聊 ID 列表（为空则只在后台输出日志，不发送群消息）"
+    ),
+    positiveNews: import_koishi2.Schema.array(
+      import_koishi2.Schema.object({
+        text: import_koishi2.Schema.string().description("新闻文本"),
+        weight: import_koishi2.Schema.number().min(1).step(1).default(1).description("权重")
+      })
+    ).role("table").default([
+      {
+        text: "【财经快讯】{stockName} 宣布取得重大技术突破，预期利润大增！",
+        weight: 1
+      },
+      {
+        text: "【市场异动】神秘巨头入局，{stockName} 获大额资本注资！",
+        weight: 1
+      }
+    ]).description("利好新闻列表（可用 {stockName} 作为股票名称的占位符）"),
+    negativeNews: import_koishi2.Schema.array(
+      import_koishi2.Schema.object({
+        text: import_koishi2.Schema.string().description("新闻文本"),
+        weight: import_koishi2.Schema.number().min(1).step(1).default(1).description("权重")
+      })
+    ).role("table").default([
+      {
+        text: "【黑天鹅】{stockName} 遭遇大规模不可抗力打击，市场恐慌情绪蔓延！",
+        weight: 1
+      },
+      {
+        text: "【行业悲报】{stockName} 最新季度财报严重不及预期，高管集体减持！",
+        weight: 1
+      }
+    ]).description("利空新闻列表（可用 {stockName} 作为股票名称的占位符）")
+  }).description("新闻播报机制"),
   import_koishi2.Schema.object({
     enableDebug: import_koishi2.Schema.boolean().default(false).description("启用调试模式（开启后可使用调试指令）")
   }).description("开发者选项")
@@ -1673,6 +1713,35 @@ function apply(ctx, config) {
     return { success: true };
   }
   __name(pay, "pay");
+  async function broadcastMacroNews(targetPrice, basePrice) {
+    const deviation = (targetPrice - basePrice) / basePrice;
+    if (Math.abs(deviation) < config.newsDeviationThreshold) return;
+    const newsPool = deviation > 0 ? config.positiveNews : config.negativeNews;
+    if (!newsPool || newsPool.length === 0) return;
+    const totalWeight = newsPool.reduce((sum, item) => sum + item.weight, 0);
+    if (totalWeight <= 0) return;
+    let roll = Math.random() * totalWeight;
+    let selected = newsPool[newsPool.length - 1];
+    for (const item of newsPool) {
+      roll -= item.weight;
+      if (roll < 0) {
+        selected = item;
+        break;
+      }
+    }
+    const newsText = selected.text.replace(/\{stockName\}/g, config.stockName);
+    logger.info(
+      `触发宏观新闻播报: ${newsText} (偏离度=${(deviation * 100).toFixed(2)}%)`
+    );
+    if (config.broadcastChannels && config.broadcastChannels.length > 0) {
+      try {
+        await ctx.broadcast(config.broadcastChannels, newsText);
+      } catch (err) {
+        logger.warn(`新闻播报广播失败:`, err);
+      }
+    }
+  }
+  __name(broadcastMacroNews, "broadcastMacroNews");
   const patternsByCategory = {
     bullish: [],
     bearish: [],
@@ -1821,6 +1890,7 @@ function apply(ctx, config) {
     }, "createAutoState");
     if (needNewState) {
       await createAutoState();
+      await broadcastMacroNews(state.targetPrice, currentPrice);
     }
     const basePrice = state.startPrice;
     const targetPrice = state.targetPrice;
@@ -2074,13 +2144,17 @@ function apply(ctx, config) {
     } else {
       newEndTime = new Date(now.getTime() + 7 * 24 * 3600 * 1e3);
     }
-    await ctx.database.set("bourse_state", { key: "macro_state" }, {
-      startPrice: currentPrice,
-      targetPrice: fmtPrice(newTargetPrice),
-      lastCycleStart: now,
-      endTime: newEndTime,
-      lastDividendDate: now
-    });
+    await ctx.database.set(
+      "bourse_state",
+      { key: "macro_state" },
+      {
+        startPrice: currentPrice,
+        targetPrice: fmtPrice(newTargetPrice),
+        lastCycleStart: now,
+        endTime: newEndTime,
+        lastDividendDate: now
+      }
+    );
     switchKLinePattern("分红除息");
     logger.info(
       `分红引擎: 执行完毕 | 除息前股价=${oldPrice} -> 除息后=${currentPrice} (${(-priceDropRate * 100).toFixed(2)}%) | 派发成功=${successCount}人 | 失败=${failCount}人 | 合计派发=${totalDividendPaid.toFixed(2)} ${config.currency}`
@@ -2140,7 +2214,8 @@ function apply(ctx, config) {
     getDailyOpenPrice,
     setWasMarketOpen,
     isMarketOpen,
-    switchKLinePattern
+    switchKLinePattern,
+    broadcastMacroNews
   });
   registerTestCommands({
     ctx,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "koishi-plugin-monetary-bourse",
-  "version": "3.0.0-alpha.18",
+  "version": "3.0.0-alpha.19",
   "main": "lib/index.js",
   "typings": "lib/index.d.ts",
   "files": [

package/readme.md

@@ -6,7 +6,7 @@
 
 本插件模拟了一个具备自动宏观调控、25种经典K线形态、智能概率博弈和可视化交割单的深度拟真股票市场。用户可以使用机器人通用的货币（如信用点）进行股票买卖、炒股理财。
 
-> 版本：**3.0.0-alpha.18**
+> 版本：**3.0.0-alpha.19**
 
 ## ✨ 特性
 
@@ -129,6 +129,8 @@ A: 股价采用 **"智能期望模型"** 驱动，更贴近真实博弈：
 ### 交易时间
 - **openHour**: 每日开市时间（小时，0-23，默认 `8` 点）。
 - **closeHour**: 每日休市时间（小时，0-23，默认 `23` 点）。
+
+### 股市开关
 - **marketStatus**: 股市总开关，可选 `open` (强制开启)、`close` (强制关闭)、`auto` (自动按时间)。
 
 ### 冻结机制
@@ -137,7 +139,9 @@ A: 股价采用 **"智能期望模型"** 驱动，更贴近真实博弈：
 - **maxFreezeTime**: 最大冻结时间（分钟，默认 `1440` 即24小时）。
 
 ### 手续费与精度
-- **sellFeePercent**: 卖出手续费百分比（默认 `0`）。
+- **sellFeeTiers**: 卖出手续费分档列表（默认 `[{ minAmount: 1, feePercent: 0 }]`）。
+  - **minAmount**: 起始股数（含）。
+  - **feePercent**: 手续费比例（%）。
 - **precisionInteger**: 是否启用整数精度（默认 `false`）。
 
 ### 开发者选项
@@ -148,6 +152,44 @@ A: 股价采用 **"智能期望模型"** 驱动，更贴近真实博弈：
 - **fixedUpdateHour**: 固定更新时间（小时，0-23，默认 `9`）。仅在 `fixedUpdateTime` 为 `true` 时生效。
 - **biasMax**: 宏观期望上下偏倚的最大值（默认 `0.45`）。
 
+### 分红机制
+- **dividendIntervalDays**: 分红结算周期（天，默认 `7`）。
+- **maxDividendRate**: 最大分红期望利润率（0-1，默认 `0.15`，超出部分用于除息而非派发）。
+
+### 新闻播报机制
+- **newsDeviationThreshold**: 触发新闻的偏离度阈值（默认 `0.15`，例如 `0.15` 表示偏离 15% 以上触发）。
+- **broadcastChannels**: 播报新闻的频道/群聊 ID 列表（为空则仅后台日志，不发送群消息）。
+- **positiveNews**: 利好新闻列表（表格配置）。
+- **negativeNews**: 利空新闻列表（表格配置）。
+  - **text**: 新闻文本，可使用 `{stockName}` 作为股票名称占位符。
+  - **weight**: 权重（整数，最小 `1`，数值越大越容易被选中）。
+
+### 开发者选项
+- **enableDebug**: 是否启用调试模式（默认 `false`）。开启后可使用 `bourse.test.*` 系列调试指令。
+
+### 配置示例
+```yaml
+sellFeeTiers:
+  - minAmount: 1
+    feePercent: 0.6
+  - minAmount: 200
+    feePercent: 0.3
+
+newsDeviationThreshold: 0.15
+broadcastChannels:
+  - "123456789"
+positiveNews:
+  - text: "【财经快讯】{stockName} 宣布取得重大技术突破，预期利润大增！"
+    weight: 3
+  - text: "【市场异动】神秘巨头入局，{stockName} 获大额资本注资！"
+    weight: 1
+negativeNews:
+  - text: "【黑天鹅】{stockName} 遭遇大规模不可抗力打击，市场恐慌情绪蔓延！"
+    weight: 2
+  - text: "【行业悲报】{stockName} 最新季度财报严重不及预期，高管集体减持！"
+    weight: 1
+```
+
 ## 📝 更新日志
 
 详细的更新日志请查看 [CHANGELOG.md](./CHANGELOG.md)。