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

package/lib/index.d.ts

@@ -43,6 +43,7 @@ export interface BoursePending {
     amount: number;
     price: number;
     cost: number;
+    buyCost?: number;
     startTime: Date;
     endTime: Date;
 }
@@ -91,6 +92,7 @@ export interface Config {
     biasMax: number;
     dividendIntervalDays: number;
     maxDividendRate: number;
+    dividendBroadcastChannels: string[];
     newsDeviationThreshold: number;
     broadcastChannels: string[];
     positiveNews: NewsItem[];

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种) ====================
@@ -625,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;
@@ -999,6 +1086,7 @@ function registerStockCommands(deps) {
       amount,
       price: currentPrice,
       cost: netGain,
+      buyCost: soldCost,
       startTime,
       endTime
     });
@@ -1074,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) => {
@@ -1294,6 +1386,9 @@ 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% 以上时触发）"
@@ -1361,6 +1456,7 @@ function apply(ctx, config) {
       amount: "integer",
       price: "double",
       cost: "double",
+      buyCost: "double",
       startTime: "timestamp",
       endTime: "timestamp"
     },
@@ -1713,6 +1809,27 @@ 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;
@@ -1733,13 +1850,7 @@ function apply(ctx, config) {
     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);
-      }
-    }
+    await sendBroadcast(config.broadcastChannels, newsText, "新闻播报");
   }
   __name(broadcastMacroNews, "broadcastMacroNews");
   const patternsByCategory = {
@@ -2094,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
@@ -2114,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}) 分红派发失败`
@@ -2121,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;

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.19",
+  "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.19**
+> 版本：**3.0.0-alpha.20**
 
 ## ✨ 特性
 
@@ -156,6 +156,9 @@ A: 股价采用 **"智能期望模型"** 驱动，更贴近真实博弈：
 - **dividendIntervalDays**: 分红结算周期（天，默认 `7`）。
 - **maxDividendRate**: 最大分红期望利润率（0-1，默认 `0.15`，超出部分用于除息而非派发）。
 
+### 分红播报
+- **dividendBroadcastChannels**: 分红播报的频道/群聊 ID 列表（支持 `onebot:123` 或 `123`）。
+
 ### 新闻播报机制
 - **newsDeviationThreshold**: 触发新闻的偏离度阈值（默认 `0.15`，例如 `0.15` 表示偏离 15% 以上触发）。
 - **broadcastChannels**: 播报新闻的频道/群聊 ID 列表（为空则仅后台日志，不发送群消息）。