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

package/assets/fonts/README.md

@@ -0,0 +1,8 @@
+# Fonts
+
+Place Roboto Mono font files here:
+
+- RobotoMono-Regular.ttf
+- RobotoMono-Bold.ttf
+
+Source: https://fonts.google.com/specimen/Roboto+Mono (SIL OPEN FONT LICENSE Version 1.1)

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

@@ -32,12 +32,46 @@ var import_koishi2 = require("koishi");
 // src/render.ts
 var import_koishi = require("koishi");
 var import_path = require("path");
+var import_url = require("url");
 var import_fs = require("fs");
 var templatesDir = (0, import_path.resolve)(__dirname, "templates");
+var assetsDir = (0, import_path.resolve)(__dirname, "..", "assets");
+var assetsBaseUrl = (0, import_url.pathToFileURL)(assetsDir).toString().replace(/\/$/, "");
+function getAssetUrl(relativePath) {
+  return `${assetsBaseUrl}/${relativePath}`;
+}
+__name(getAssetUrl, "getAssetUrl");
+function getFontFaceCss() {
+  const fontRegularUrl = getAssetUrl("fonts/RobotoMono-Regular.ttf");
+  const fontBoldUrl = getAssetUrl("fonts/RobotoMono-Bold.ttf");
+  return `
+    @font-face {
+      font-family: 'Roboto Mono';
+      src: url('${fontRegularUrl}') format('truetype');
+      font-weight: 400;
+      font-style: normal;
+      font-display: swap;
+    }
+
+    @font-face {
+      font-family: 'Roboto Mono';
+      src: url('${fontBoldUrl}') format('truetype');
+      font-weight: 700;
+      font-style: normal;
+      font-display: swap;
+    }
+  `;
+}
+__name(getFontFaceCss, "getFontFaceCss");
+function injectFontFace(template) {
+  return template.replace("{{FONT_FACE}}", getFontFaceCss());
+}
+__name(injectFontFace, "injectFontFace");
 async function renderHoldingImage(ctx, logger2, username, holding, pending, currency) {
   try {
     const templatePath = (0, import_path.resolve)(templatesDir, "holding-card.html");
     let template = await import_fs.promises.readFile(templatePath, "utf-8");
+    template = injectFontFace(template);
     const data = {
       username,
       holding,
@@ -66,6 +100,7 @@ async function renderTradeResultImage(ctx, logger2, tradeType, stockName, amount
   try {
     const templatePath = (0, import_path.resolve)(templatesDir, "trade-result.html");
     let template = await import_fs.promises.readFile(templatePath, "utf-8");
+    template = injectFontFace(template);
     const tradeIndex = priceHistory.length - 1;
     const status = tradeMeta?.status ?? "settled";
     const pendingMinutes = tradeMeta?.pendingMinutes ?? 0;
@@ -127,6 +162,7 @@ async function renderStockImage(ctx, logger2, data, name2, viewLabel, current, h
     }) : [];
     const templatePath = (0, import_path.resolve)(templatesDir, "stock-chart.html");
     let html = await import_fs.promises.readFile(templatePath, "utf-8");
+    html = injectFontFace(html);
     const colorScheme = {
       mainColor: isUp ? "#f23645" : "#089981",
       gradientStart: isUp ? "rgba(242, 54, 69, 0.25)" : "rgba(8, 153, 129, 0.25)",
@@ -252,6 +288,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 +688,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 +1122,7 @@ function registerStockCommands(deps) {
       amount,
       price: currentPrice,
       cost: netGain,
+      buyCost: soldCost,
       startTime,
       endTime
     });
@@ -1074,23 +1198,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 +1422,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 +1492,7 @@ function apply(ctx, config) {
       amount: "integer",
       price: "double",
       cost: "double",
+      buyCost: "double",
       startTime: "timestamp",
       endTime: "timestamp"
     },
@@ -1713,6 +1845,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 +1886,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 +2241,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 +2262,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 +2270,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/templates/holding-card.html

@@ -2,6 +2,8 @@
 
 <head>
   <style>
+    {{FONT_FACE}}
+
     :root {
       /* 统一配色 (From trade-result) */
       --bg-color: #0c0f15;
@@ -544,4 +546,4 @@
   </script>
 </body>
 
-</html>
+</html>

package/lib/templates/stock-chart.html

@@ -1,6 +1,8 @@
 <html>
   <head>
     <style>
+      {{FONT_FACE}}
+
       :root {
         --main-color: {{MAIN_COLOR}};
         --glow-color: {{GLOW_COLOR}};

package/lib/templates/trade-result.html

@@ -4,6 +4,8 @@
 <head>
   <meta charset="utf-8">
   <style>
+    {{FONT_FACE}}
+
     :root {
       --bg-color: #0c0f15;
       --card-bg: #161b22;
@@ -604,4 +606,4 @@
   </script>
 </body>
 
-</html>
+</html>

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,14 +1,19 @@
 {
   "name": "koishi-plugin-monetary-bourse",
-  "version": "3.0.0-alpha.19",
+  "version": "3.0.0",
   "main": "lib/index.js",
   "typings": "lib/index.d.ts",
   "files": [
+    "assets",
     "lib",
     "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

@@ -1,12 +1,28 @@
-# koishi-plugin-monetary-bourse
+<h1 align="center">koishi-plugin-monetary-bourse</h1>
 
-[![npm](https://img.shields.io/npm/v/koishi-plugin-monetary-bourse?style=flat-square)](https://www.npmjs.com/package/koishi-plugin-monetary-bourse) [![GitHub stars](https://img.shields.io/github/stars/BYWled/koishi-plugin-monetary-bourse?style=flat-square&logo=github)](https://github.com/BYWled/koishi-plugin-monetary-bourse) [![Gitee](https://img.shields.io/badge/Gitee-Project-c71d23?style=flat-square&logo=gitee&logoColor=white)](https://gitee.com/BYWled/koishi-plugin-monetary-bourse)
+<p align="center">
+	为 Koishi 提供基于 <code>monetary</code> 通用货币系统的股票交易所功能。
+</p>
 
-为 Koishi 提供基于 `monetary` 通用货币系统的股票交易所功能。
+<p align="center">
+	<a href="https://www.npmjs.com/package/koishi-plugin-monetary-bourse"><img src="https://img.shields.io/npm/v/koishi-plugin-monetary-bourse?style=for-the-badge&logo=npm" alt="npm" /></a>
+	<a href="https://github.com/BYWled/koishi-plugin-monetary-bourse"><img src="https://img.shields.io/github/stars/BYWled/koishi-plugin-monetary-bourse?style=for-the-badge&logo=github" alt="GitHub Stars" /></a>
+</p>
+
+<p align="center">
+	<a href="https://gitee.com/BYWled/koishi-plugin-monetary-bourse"><img src="https://img.shields.io/badge/Gitee-代码镜像-C71D23?style=for-the-badge&logo=gitee&logoColor=white" alt="Gitee Mirror" /></a>
+	<a href="https://gitcode.com/BYWled/koishi-plugin-monetary-bourse"><img src="https://img.shields.io/badge/GitCode-代码镜像-2962FF?style=for-the-badge" alt="GitCode Mirror" /></a>
+</p>
+
+<p align="center">
+	<a href="https://github.com/BYWled/koishi-plugin-monetary-bourse">GitHub</a> ·
+	<a href="https://gitee.com/BYWled/koishi-plugin-monetary-bourse">Gitee</a> ·
+	<a href="https://gitcode.com/BYWled/koishi-plugin-monetary-bourse">GitCode</a>
+</p>
 
 本插件模拟了一个具备自动宏观调控、25种经典K线形态、智能概率博弈和可视化交割单的深度拟真股票市场。用户可以使用机器人通用的货币（如信用点）进行股票买卖、炒股理财。
 
-> 版本：**3.0.0-alpha.19**
+> 版本：**3.0.0**
 
 ## ✨ 特性
 
@@ -17,11 +33,15 @@
 - **🖼️ 全可视化交互**：
   - **专业走势图**：复刻 TradingView 风格的深色玻璃拟态 K 线图，包含动态呼吸灯、渐变填充与详细指标。
   - **持仓资产卡片**：精美渲染个人持仓、成本分析、浮动盈亏比及排队中的挂单详情。
-  - **交易交割单**：**(New)** 买卖成交瞬间生成**交易回单图片**，在 K 线图上精确标记买卖点位，直观展示单笔盈亏与买入成本线。
+  - **交易交割单**：买卖成交瞬间生成**交易回单图片**，在 K 线图上精确标记买卖点位，直观展示单笔盈亏与买入成本线。
+  - **内置字体**：使用 Roboto Mono 字体，确保图表中的数字和文本清晰易读。
 - **❄️ 资金冻结与挂单排队**：
   - 交易采用 T+0 机制，但大额资金/股票会根据金额计算**动态冻结时间**。
   - 挂单采用**串行排队模式**，同一用户的多个挂单需依次读秒，防止通过拆单绕过冻结机制，增加博弈深度。
 - **💸 手续费与精度控制**：支持卖出手续费配置，回单展示净到账金额；可开启整数精度模式，适配不支持小数的货币体系。
+- **📊 分红与新闻系统**：
+  - 定期分红：根据持仓占比和预设利润率进行分红，支持分红播报。
+  - 新闻触发：当价格偏离宏观目标超过设定阈值时，自动从利好/利空新闻库中随机选取并播报，增加市场氛围。
 - **🧭 宏观周期固定刷新**：支持固定时刻刷新宏观目标周期，便于在活动时段塑造更清晰的趋势节奏。
 - **🏦 银行联动**：支持与[ `koishi-plugin-monetary-bank`](https://github.com/BYWled/koishi-plugin-monetary-bank)[![npm](https://img.shields.io/npm/v/koishi-plugin-monetary-bank?style=flat-square)](https://www.npmjs.com/package/koishi-plugin-monetary-bank) 联动，现金不足时自动扣除银行活期存款。
 
@@ -156,6 +176,9 @@ A: 股价采用 **"智能期望模型"** 驱动，更贴近真实博弈：
 - **dividendIntervalDays**: 分红结算周期（天，默认 `7`）。
 - **maxDividendRate**: 最大分红期望利润率（0-1，默认 `0.15`，超出部分用于除息而非派发）。
 
+### 分红播报
+- **dividendBroadcastChannels**: 分红播报的频道/群聊 ID 列表（支持 `onebot:123` 或 `123`）。
+
 ### 新闻播报机制
 - **newsDeviationThreshold**: 触发新闻的偏离度阈值（默认 `0.15`，例如 `0.15` 表示偏离 15% 以上触发）。
 - **broadcastChannels**: 播报新闻的频道/群聊 ID 列表（为空则仅后台日志，不发送群消息）。
@@ -194,6 +217,9 @@ negativeNews:
 
 详细的更新日志请查看 [CHANGELOG.md](./CHANGELOG.md)。
 
+## 🙏 第三方资源/致谢
+- Roboto Mono 字体（SIL OPEN FONT LICENSE Version 1.1）：[字体链接](https://fonts.google.com/specimen/Roboto+Mono)
+
 ---
 
 **开发者**: BYWled