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

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

@@ -43,6 +43,7 @@ export interface BoursePending {
     amount: number;
     price: number;
     cost: number;
+    buyCost?: number;
     startTime: Date;
     endTime: Date;
 }
@@ -68,6 +69,10 @@ export type SellFeeTier = {
     minAmount: number;
     feePercent: number;
 };
+export type NewsItem = {
+    text: string;
+    weight: number;
+};
 export interface Config {
     currency: string;
     stockName: string;
@@ -87,6 +92,11 @@ export interface Config {
     biasMax: number;
     dividendIntervalDays: number;
     maxDividendRate: number;
+    dividendBroadcastChannels: string[];
+    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

@@ -252,6 +252,33 @@ function formatKLineTime(date) {
 }
 __name(formatKLineTime, "formatKLineTime");
 
+// src/utils/broadcast.ts
+function parseChannelTarget(input) {
+  if (!input) return null;
+  const trimmed = input.trim();
+  if (!trimmed) return null;
+  const colonIndex = trimmed.indexOf(":");
+  if (colonIndex === -1) {
+    return { channelId: trimmed };
+  }
+  const platform = trimmed.slice(0, colonIndex).trim();
+  const channelId = trimmed.slice(colonIndex + 1).trim();
+  if (!platform || !channelId) return null;
+  return { platform, channelId };
+}
+__name(parseChannelTarget, "parseChannelTarget");
+function chunkLines(header, lines, maxLines) {
+  if (!lines.length) return [];
+  const safeMax = Math.max(1, Math.floor(maxLines));
+  const chunks = [];
+  for (let i = 0; i < lines.length; i += safeMax) {
+    const block = lines.slice(i, i + safeMax);
+    chunks.push([header, ...block].join("\n"));
+  }
+  return chunks;
+}
+__name(chunkLines, "chunkLines");
+
 // src/pattern.ts
 var kLinePatterns = {
   // ==================== 看涨模型 (8种) ====================
@@ -522,7 +549,8 @@ function registerAdminCommands(deps) {
     getDailyOpenPrice,
     setWasMarketOpen,
     isMarketOpen,
-    switchKLinePattern
+    switchKLinePattern,
+    broadcastMacroNews
   } = deps;
   ctx.command(
     "stock.control <price:number> [hours:number]",
@@ -568,6 +596,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}
@@ -623,6 +652,66 @@ function registerAdminCommands(deps) {
 }
 __name(registerAdminCommands, "registerAdminCommands");
 
+// src/utils/holding-summary.ts
+function buildHoldingSummary(input) {
+  const holdingAmount = input.holding?.amount ?? 0;
+  const pendingBuys = input.pending.filter((p) => p.type === "buy");
+  const pendingSells = input.pending.filter((p) => p.type === "sell");
+  const pendingBuyAmount = pendingBuys.reduce((sum, p) => sum + p.amount, 0);
+  const pendingSellAmount = pendingSells.reduce((sum, p) => sum + p.amount, 0);
+  const totalAmount = holdingAmount + pendingBuyAmount + pendingSellAmount;
+  if (totalAmount <= 0) return null;
+  const holdingValue = holdingAmount * input.currentPrice;
+  const pendingBuyValue = pendingBuyAmount * input.currentPrice;
+  const pendingSellValue = pendingSells.reduce(
+    (sum, p) => sum + p.amount * p.price,
+    0
+  );
+  const marketValue = holdingValue + pendingBuyValue + pendingSellValue;
+  let hasCostData = true;
+  let totalCost = 0;
+  if (holdingAmount > 0) {
+    const holdingCost = input.holding?.totalCost ?? null;
+    if (!holdingCost || holdingCost <= 0) {
+      hasCostData = false;
+    } else {
+      totalCost += holdingCost;
+    }
+  }
+  for (const pending of pendingBuys) {
+    if (!pending.cost || pending.cost <= 0) hasCostData = false;
+    else totalCost += pending.cost;
+  }
+  for (const pending of pendingSells) {
+    if (!pending.buyCost || pending.buyCost <= 0) hasCostData = false;
+    else totalCost += pending.buyCost;
+  }
+  if (!hasCostData) {
+    return {
+      amount: totalAmount,
+      marketValue,
+      totalCost: null,
+      avgCost: null,
+      profit: null,
+      profitPercent: null,
+      hasCostData: false
+    };
+  }
+  const avgCost = totalCost / totalAmount;
+  const profit = marketValue - totalCost;
+  const profitPercent = totalCost > 0 ? profit / totalCost * 100 : 0;
+  return {
+    amount: totalAmount,
+    marketValue,
+    totalCost,
+    avgCost,
+    profit,
+    profitPercent,
+    hasCostData: true
+  };
+}
+__name(buildHoldingSummary, "buildHoldingSummary");
+
 // src/commands-stock.ts
 function resolveSellFeePercent(amount, tiers) {
   if (!Array.isArray(tiers) || tiers.length === 0) return 0;
@@ -997,6 +1086,7 @@ function registerStockCommands(deps) {
       amount,
       price: currentPrice,
       cost: netGain,
+      buyCost: soldCost,
       startTime,
       endTime
     });
@@ -1072,23 +1162,27 @@ function registerStockCommands(deps) {
     const pending = await ctx.database.get("bourse_pending", { userId });
     let holdingData = null;
     const currentPrice = getCurrentPrice();
-    if (holdings.length > 0) {
-      const h2 = holdings[0];
-      const marketValue = fmtAmount(h2.amount * currentPrice);
-      const hasCostData = h2.totalCost !== void 0 && h2.totalCost !== null && h2.totalCost > 0;
-      const totalCost = hasCostData ? fmtAmount(h2.totalCost) : 0;
-      const avgCost = hasCostData && h2.amount > 0 ? fmtPrice(totalCost / h2.amount) : 0;
-      const profit = hasCostData ? fmtAmount(marketValue - totalCost) : null;
-      const profitPercent = hasCostData && totalCost > 0 ? Number((profit / totalCost * 100).toFixed(2)) : null;
+    const summary = buildHoldingSummary({
+      currentPrice,
+      holding: holdings.length ? { amount: holdings[0].amount, totalCost: holdings[0].totalCost } : null,
+      pending: pending.map((p) => ({
+        type: p.type,
+        amount: p.amount,
+        price: p.price,
+        cost: p.cost,
+        buyCost: p.buyCost ?? null
+      }))
+    });
+    if (summary) {
       holdingData = {
         stockName: config.stockName,
-        amount: h2.amount,
+        amount: summary.amount,
         currentPrice: fmtPrice(currentPrice),
-        avgCost: hasCostData ? avgCost : null,
-        totalCost: hasCostData ? totalCost : null,
-        marketValue,
-        profit,
-        profitPercent
+        avgCost: summary.hasCostData ? fmtPrice(summary.avgCost) : null,
+        totalCost: summary.hasCostData ? fmtAmount(summary.totalCost) : null,
+        marketValue: fmtAmount(summary.marketValue),
+        profit: summary.hasCostData ? fmtAmount(summary.profit) : null,
+        profitPercent: summary.hasCostData ? Number(summary.profitPercent.toFixed(2)) : null
       };
     }
     const pendingData = pending.map((p) => {
@@ -1292,6 +1386,47 @@ 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({
+    dividendBroadcastChannels: import_koishi2.Schema.array(import_koishi2.Schema.string()).default([]).description("分红播报的频道/群聊 ID 列表（支持 onebot:123 或 123）")
+  }).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("开发者选项")
@@ -1321,6 +1456,7 @@ function apply(ctx, config) {
       amount: "integer",
       price: "double",
       cost: "double",
+      buyCost: "double",
       startTime: "timestamp",
       endTime: "timestamp"
     },
@@ -1673,6 +1809,50 @@ function apply(ctx, config) {
     return { success: true };
   }
   __name(pay, "pay");
+  async function sendBroadcast(channels, message, label) {
+    if (!channels || channels.length === 0) return;
+    for (const raw of channels) {
+      const target = parseChannelTarget(raw);
+      if (!target) {
+        logger.warn(`${label}: 无效频道配置 ${raw}`);
+        continue;
+      }
+      const bot = target.platform ? ctx.bots.find((b) => b.platform === target.platform) : ctx.bots[0];
+      if (!bot) {
+        logger.warn(`${label}: 未找到可用 bot (${raw})`);
+        continue;
+      }
+      try {
+        await bot.sendMessage(target.channelId, message);
+      } catch (err) {
+        logger.warn(`${label}: 发送失败 channel=${raw}`, err);
+      }
+    }
+  }
+  __name(sendBroadcast, "sendBroadcast");
+  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)}%)`
+    );
+    await sendBroadcast(config.broadcastChannels, newsText, "新闻播报");
+  }
+  __name(broadcastMacroNews, "broadcastMacroNews");
   const patternsByCategory = {
     bullish: [],
     bearish: [],
@@ -1821,6 +2001,7 @@ function apply(ctx, config) {
     }, "createAutoState");
     if (needNewState) {
       await createAutoState();
+      await broadcastMacroNews(state.targetPrice, currentPrice);
     }
     const basePrice = state.startPrice;
     const targetPrice = state.targetPrice;
@@ -2024,6 +2205,7 @@ function apply(ctx, config) {
     let totalDividendPaid = 0;
     let successCount = 0;
     let failCount = 0;
+    const successRecords = [];
     for (const holding of allHoldings) {
       const dividendAmount = fmtAmount(
         holding.amount * effectiveDividendRate * currentPrice
@@ -2044,6 +2226,7 @@ function apply(ctx, config) {
       if (success) {
         totalDividendPaid += dividendAmount;
         successCount++;
+        successRecords.push({ userId: holding.userId, amount: dividendAmount });
       } else {
         logger.warn(
           `分红引擎: 用户 ${holding.userId} (uid=${holding.uid}) 分红派发失败`
@@ -2051,6 +2234,25 @@ function apply(ctx, config) {
         failCount++;
       }
     }
+    if (config.dividendBroadcastChannels && config.dividendBroadcastChannels.length > 0 && successCount > 0) {
+      const summary = `【分红播报】参与人数: ${successCount} | 派息率: ${(effectiveDividendRate * 100).toFixed(2)}% | 总派息: ${totalDividendPaid.toFixed(2)} ${config.currency}`;
+      await sendBroadcast(
+        config.dividendBroadcastChannels,
+        summary,
+        "分红播报"
+      );
+      const detailLines = successRecords.map((record) => {
+        const ratio = totalDividendPaid > 0 ? record.amount / totalDividendPaid * 100 : 0;
+        return `- ${record.userId}：占比 ${ratio.toFixed(2)}% | ${record.amount.toFixed(2)} ${config.currency}`;
+      });
+      for (const chunk of chunkLines("【分红明细】", detailLines, 10)) {
+        await sendBroadcast(
+          config.dividendBroadcastChannels,
+          chunk,
+          "分红明细"
+        );
+      }
+    }
     const oldPrice = currentPrice;
     currentPrice = fmtPrice(currentPrice * (1 - priceDropRate));
     if (currentPrice < 1) currentPrice = 1;
@@ -2074,13 +2276,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 +2346,8 @@ function apply(ctx, config) {
     getDailyOpenPrice,
     setWasMarketOpen,
     isMarketOpen,
-    switchKLinePattern
+    switchKLinePattern,
+    broadcastMacroNews
   });
   registerTestCommands({
     ctx,

package/lib/utils/broadcast.d.ts

@@ -0,0 +1,6 @@
+export type ChannelTarget = {
+    platform?: string;
+    channelId: string;
+};
+export declare function parseChannelTarget(input: string): ChannelTarget | null;
+export declare function chunkLines(header: string, lines: string[], maxLines: number): string[];

package/lib/utils/holding-summary.d.ts

@@ -0,0 +1,25 @@
+export type HoldingRecord = {
+    amount: number;
+    totalCost?: number | null;
+};
+export type PendingRecord = {
+    type: "buy" | "sell";
+    amount: number;
+    price: number;
+    cost: number;
+    buyCost?: number | null;
+};
+export type HoldingSummary = {
+    amount: number;
+    marketValue: number;
+    totalCost: number | null;
+    avgCost: number | null;
+    profit: number | null;
+    profitPercent: number | null;
+    hasCostData: boolean;
+};
+export declare function buildHoldingSummary(input: {
+    currentPrice: number;
+    holding: HoldingRecord | null;
+    pending: PendingRecord[];
+}): HoldingSummary | null;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "koishi-plugin-monetary-bourse",
-  "version": "3.0.0-alpha.18",
+  "version": "3.0.0-alpha.20",
   "main": "lib/index.js",
   "typings": "lib/index.d.ts",
   "files": [
@@ -8,7 +8,11 @@
     "dist"
   ],
   "scripts": {
-    "build": "tsc && node -e \"require('fs').cpSync('src/templates', 'lib/templates', {recursive: true})\""
+    "build": "tsc && node -e \"require('fs').cpSync('src/templates', 'lib/templates', {recursive: true})\"",
+    "test": "node --test --import tsx"
+  },
+  "devDependencies": {
+    "tsx": "^4.7.1"
   },
   "koishi": {
     "description": {

package/readme.md

@@ -6,7 +6,7 @@
 
 本插件模拟了一个具备自动宏观调控、25种经典K线形态、智能概率博弈和可视化交割单的深度拟真股票市场。用户可以使用机器人通用的货币（如信用点）进行股票买卖、炒股理财。
 
-> 版本：**3.0.0-alpha.18**
+> 版本：**3.0.0-alpha.20**
 
 ## ✨ 特性
 
@@ -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,47 @@ A: 股价采用 **"智能期望模型"** 驱动，更贴近真实博弈：
 - **fixedUpdateHour**: 固定更新时间（小时，0-23，默认 `9`）。仅在 `fixedUpdateTime` 为 `true` 时生效。
 - **biasMax**: 宏观期望上下偏倚的最大值（默认 `0.45`）。
 
+### 分红机制
+- **dividendIntervalDays**: 分红结算周期（天，默认 `7`）。
+- **maxDividendRate**: 最大分红期望利润率（0-1，默认 `0.15`，超出部分用于除息而非派发）。
+
+### 分红播报
+- **dividendBroadcastChannels**: 分红播报的频道/群聊 ID 列表（支持 `onebot:123` 或 `123`）。
+
+### 新闻播报机制
+- **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)。