koishi-plugin-monetary-bourse 2.0.1 → 2.0.3-Alpha.11

package/lib/index.js

@@ -242,18 +242,24 @@ function apply(ctx, config) {
     const bankDemand = await getBankDemandBalance(uid, currency);
     logger.info(`pay: 现金=${cash}, 活期=${bankDemand}, 需要=${cost}`);
     if (cash + bankDemand < cost) {
-      return { success: false, msg: `资金不足！需要 ${cost.toFixed(2)}，当前现金 ${cash.toFixed(2)} + 活期 ${bankDemand.toFixed(2)}` };
+      const msg = `资金不足！需要 ${cost.toFixed(2)}，当前现金 ${cash.toFixed(2)} + 活期 ${bankDemand.toFixed(2)}`;
+      logger.warn(`pay 失败: ${msg}, uid=${uid}`);
+      return { success: false, msg };
     }
     let remainingCost = Number(cost.toFixed(2));
     const cashDeduct = Number(Math.min(cash, remainingCost).toFixed(2));
     if (cashDeduct > 0) {
       const success = await changeCashBalance(uid, currency, -cashDeduct);
-      if (!success) return { success: false, msg: "扣除现金失败，请重试" };
+      if (!success) {
+        logger.error(`pay 失败: 扣除现金失败 uid=${uid}, cost=${cashDeduct}`);
+        return { success: false, msg: "扣除现金失败，请重试" };
+      }
       remainingCost = Number((remainingCost - cashDeduct).toFixed(2));
     }
     if (remainingCost > 0) {
       const success = await deductBankDemand(uid, currency, remainingCost);
       if (!success) {
+        logger.error(`pay 失败: 银行活期扣款失败 uid=${uid}, cost=${remainingCost}`);
         if (cashDeduct > 0) await changeCashBalance(uid, currency, cashDeduct);
         return { success: false, msg: "银行活期扣款失败" };
       }
@@ -670,7 +676,7 @@ function apply(ctx, config) {
     const morningVol = Math.exp(-8 * dayProgress);
     const afternoonVol = Math.exp(-8 * (1 - dayProgress));
     const volatility = 0.3 + morningVol * 0.5 + afternoonVol * 0.4;
-    const randomReturn = normalRandom * 35e-4 * volatility;
+    const randomReturn = normalRandom * 65e-4 * volatility;
     const totalReturn = patternReturn + reversionReturn + randomReturn;
     let newPrice = currentPrice * (1 + totalReturn);
     const dayBase = dailyOpenPrice ?? basePrice;
@@ -723,9 +729,12 @@ function apply(ctx, config) {
       } else if (txn.type === "sell") {
         if (txn.uid && typeof txn.uid === "number") {
           const amount = Number(txn.cost.toFixed(2));
-          await changeCashBalance(txn.uid, config.currency, amount);
+          const success = await changeCashBalance(txn.uid, config.currency, amount);
+          if (!success) {
+            logger.error(`processPendingTransactions 失败: 卖出结算充值失败 txn.id=${txn.id}, uid=${txn.uid}, amount=${amount}`);
+          }
         } else {
-          logger.warn(`processPendingTransactions: 卖出订单缺少有效uid, txn.id=${txn.id}`);
+          logger.warn(`processPendingTransactions 警告: 卖出订单缺少有效uid, txn.id=${txn.id}`);
         }
       }
       await ctx.database.remove("bourse_pending", { id: txn.id });
@@ -774,7 +783,10 @@ function apply(ctx, config) {
       });
       history = history.reverse();
     }
-    if (history.length === 0) return "暂无行情数据。";
+    if (history.length === 0) {
+      logger.warn(`stock: 数据库中未找到 ${stockId} 的行情数据`);
+      return "暂无行情数据。";
+    }
     if (history.length > 300) {
       const step = Math.ceil(history.length / 300);
       history = history.filter((_, index) => index % step === 0);
@@ -798,16 +810,25 @@ function apply(ctx, config) {
     return img;
   });
   ctx.command("stock.buy <amount:number>", "买入股票").userFields(["id"]).action(async ({ session }, amount) => {
-    if (!amount || amount <= 0 || !Number.isInteger(amount)) return "请输入有效的购买股数（整数）。";
+    if (!amount || amount <= 0 || !Number.isInteger(amount)) {
+      logger.warn(`stock.buy: 非法买入数量 user=${session.userId}, amount=${amount}`);
+      return "请输入有效的购买股数（整数）。";
+    }
     if (!await isMarketOpen()) return "休市中，无法交易。";
-    const uid = session.user?.id;
+    let uid = session.user?.id;
     const visibleUserId = session.userId;
     if (!uid || typeof uid !== "number") {
-      return "无法获取用户ID，请稍后重试。";
+      const parsedUid = Number(uid);
+      if (isNaN(parsedUid)) {
+        logger.error(`stock.buy: 无法获取数字UID user=${session.userId}`);
+        return "无法获取用户ID，请稍后重试。";
+      }
+      uid = parsedUid;
     }
     const cost = Number((currentPrice * amount).toFixed(2));
     const payResult = await pay(uid, cost, config.currency);
     if (!payResult.success) {
+      logger.warn(`stock.buy: 支付失败 user=${session.userId}, amount=${amount}, cost=${cost}, reason=${payResult.msg}`);
       return payResult.msg;
     }
     let freezeMinutes = 0;
@@ -875,16 +896,26 @@ function apply(ctx, config) {
     );
   });
   ctx.command("stock.sell <amount:number>", "卖出股票").userFields(["id"]).action(async ({ session }, amount) => {
-    if (!amount || amount <= 0 || !Number.isInteger(amount)) return "请输入有效的卖出股数。";
+    if (!amount || amount <= 0 || !Number.isInteger(amount)) {
+      logger.warn(`stock.sell: 非法卖出数量 user=${session.userId}, amount=${amount}`);
+      return "请输入有效的卖出股数。";
+    }
     if (!await isMarketOpen()) return "休市中，无法交易。";
-    const uid = session.user?.id;
+    let uid = session.user?.id;
     const visibleUserId = session.userId;
     if (!uid || typeof uid !== "number") {
-      return "无法获取用户ID，请稍后重试。";
+      const parsedUid = Number(uid);
+      if (isNaN(parsedUid)) {
+        logger.error(`stock.sell: 无法获取数字UID user=${session.userId}`);
+        return "无法获取用户ID，请稍后重试。";
+      }
+      uid = parsedUid;
     }
     const holding = await ctx.database.get("bourse_holding", { userId: visibleUserId, stockId });
     if (holding.length === 0 || holding[0].amount < amount) {
-      return `持仓不足！当前持有: ${holding.length ? holding[0].amount : 0} 股。`;
+      const currentAmount = holding.length ? holding[0].amount : 0;
+      logger.warn(`stock.sell: 持仓不足 user=${session.userId}, amount=${amount}, current=${currentAmount}`);
+      return `持仓不足！当前持有: ${currentAmount} 股。`;
     }
     const currentHolding = holding[0];
     let existingTotalCost = currentHolding.totalCost;
@@ -1021,7 +1052,10 @@ function apply(ctx, config) {
     return img;
   });
   ctx.command("stock.control <price:number> [hours:number]", "管理员：设置宏观调控目标", { authority: 3 }).action(async ({ session }, price, hours) => {
-    if (!price || price <= 0) return "请输入有效的目标价格。";
+    if (!price || price <= 0) {
+      logger.warn(`stock.control: 非法目标价格 user=${session.userId}, price=${price}`);
+      return "请输入有效的目标价格。";
+    }
     const duration = hours || 24;
     const now = /* @__PURE__ */ new Date();
     const endTime = new Date(now.getTime() + duration * 3600 * 1e3);
@@ -1058,7 +1092,10 @@ function apply(ctx, config) {
 到期后将自动切回随机调控。`;
   });
   ctx.command("bourse.admin.market <status>", "设置股市开关状态 (open/close/auto)", { authority: 3 }).action(async ({ session }, status) => {
-    if (!["open", "close", "auto"].includes(status)) return "无效状态，请使用 open, close, 或 auto";
+    if (!["open", "close", "auto"].includes(status)) {
+      logger.warn(`bourse.admin.market: 非法状态 user=${session.userId}, status=${status}`);
+      return "无效状态，请使用 open, close, 或 auto";
+    }
     const wasOpen = await isMarketOpen();
     const key = "macro_state";
     const existing = await ctx.database.get("bourse_state", { key });
@@ -1162,118 +1199,144 @@ function apply(ctx, config) {
 是否继续波动：${moved ? "是" : "否（需检查）"}`;
   });
   async function renderHoldingImage(ctx2, username, holding, pending, currency) {
-    const fs2 = require("fs");
-    const path = require("path");
-    const templatePath = path.join(__dirname, "templates", "holding-card.html");
-    let template = fs2.readFileSync(templatePath, "utf-8");
-    const data = {
-      username,
-      holding,
-      pending,
-      currency,
-      updateTime: (/* @__PURE__ */ new Date()).toLocaleString("zh-CN")
-    };
-    template = template.replace("{{DATA}}", JSON.stringify(data));
-    const page = await ctx2.puppeteer.page();
-    await page.setContent(template);
-    const element = await page.$(".card");
-    const imgBuf = await element?.screenshot({ encoding: "binary" });
-    await page.close();
-    return import_koishi.h.image(imgBuf, "image/png");
+    try {
+      const templatePath = (0, import_path.resolve)(__dirname, "templates", "holding-card.html");
+      let template = await import_fs.promises.readFile(templatePath, "utf-8");
+      const data = {
+        username,
+        holding,
+        pending,
+        currency,
+        updateTime: (/* @__PURE__ */ new Date()).toLocaleString("zh-CN")
+      };
+      template = template.replace("{{DATA}}", JSON.stringify(data));
+      const page = await ctx2.puppeteer.page();
+      try {
+        await page.setContent(template);
+        const element = await page.$(".card");
+        if (!element) throw new Error("找不到 .card 元素");
+        const imgBuf = await element.screenshot({ encoding: "binary" });
+        return import_koishi.h.image(imgBuf, "image/png");
+      } finally {
+        await page.close();
+      }
+    } catch (err) {
+      logger.error("renderHoldingImage 失败:", err);
+      return `[错误] 生成图片失败: ${err.message}`;
+    }
   }
   __name(renderHoldingImage, "renderHoldingImage");
   async function renderTradeResultImage(ctx2, tradeType, stockName, amount, tradePrice, totalCost, currency, priceHistory, sellInfo, newHolding, tradeMeta) {
-    const fs2 = require("fs");
-    const path = require("path");
-    const templatePath = path.join(__dirname, "templates", "trade-result.html");
-    let template = fs2.readFileSync(templatePath, "utf-8");
-    const tradeIndex = priceHistory.length - 1;
-    const status = tradeMeta?.status ?? "settled";
-    const pendingMinutes = tradeMeta?.pendingMinutes ?? 0;
-    const pendingEndTime = tradeMeta?.pendingEndTime ?? null;
-    const data = {
-      tradeType,
-      stockName,
-      amount,
-      tradePrice,
-      totalCost,
-      currency,
-      tradeTime: (/* @__PURE__ */ new Date()).toLocaleString("zh-CN"),
-      prices: priceHistory.map((d) => d.price),
-      timestamps: priceHistory.map((d) => d.timestamp),
-      tradeIndex,
-      // 卖出额外信息
-      avgBuyPrice: sellInfo?.avgBuyPrice ?? null,
-      buyCost: sellInfo?.buyCost ?? null,
-      profit: sellInfo?.profit ?? null,
-      profitPercent: sellInfo?.profitPercent ?? null,
-      // 买入后持仓
-      newHolding: newHolding ?? amount,
-      status,
-      pendingMinutes,
-      pendingEndTime
-    };
-    template = template.replace("{{DATA}}", JSON.stringify(data));
-    const page = await ctx2.puppeteer.page();
-    await page.setContent(template);
-    const element = await page.$(".card");
-    const imgBuf = await element?.screenshot({ encoding: "binary" });
-    await page.close();
-    return import_koishi.h.image(imgBuf, "image/png");
+    try {
+      const templatePath = (0, import_path.resolve)(__dirname, "templates", "trade-result.html");
+      let template = await import_fs.promises.readFile(templatePath, "utf-8");
+      const tradeIndex = priceHistory.length - 1;
+      const status = tradeMeta?.status ?? "settled";
+      const pendingMinutes = tradeMeta?.pendingMinutes ?? 0;
+      const pendingEndTime = tradeMeta?.pendingEndTime ?? null;
+      const data = {
+        tradeType,
+        stockName,
+        amount,
+        tradePrice,
+        totalCost,
+        currency,
+        tradeTime: (/* @__PURE__ */ new Date()).toLocaleString("zh-CN"),
+        prices: priceHistory.map((d) => d.price),
+        timestamps: priceHistory.map((d) => d.timestamp),
+        tradeIndex,
+        // 卖出额外信息
+        avgBuyPrice: sellInfo?.avgBuyPrice ?? null,
+        buyCost: sellInfo?.buyCost ?? null,
+        profit: sellInfo?.profit ?? null,
+        profitPercent: sellInfo?.profitPercent ?? null,
+        // 买入后持仓
+        newHolding: newHolding ?? amount,
+        status,
+        pendingMinutes,
+        pendingEndTime
+      };
+      template = template.replace("{{DATA}}", JSON.stringify(data));
+      const page = await ctx2.puppeteer.page();
+      try {
+        await page.setContent(template);
+        const element = await page.$(".card");
+        if (!element) throw new Error("找不到 .card 元素");
+        const imgBuf = await element.screenshot({ encoding: "binary" });
+        return import_koishi.h.image(imgBuf, "image/png");
+      } finally {
+        await page.close();
+      }
+    } catch (err) {
+      logger.error("renderTradeResultImage 失败:", err);
+      return `[错误] 生成交易确认单失败: ${err.message}`;
+    }
   }
   __name(renderTradeResultImage, "renderTradeResultImage");
   async function renderStockImage(ctx2, data, name2, viewLabel, current, high, low) {
-    if (data.length < 2) return "数据不足，无法绘制走势图。";
-    const startPrice = data[0].price;
-    const change = current - startPrice;
-    const changePercent = change / startPrice * 100;
-    const isUp = change >= 0;
-    const templatePath = (0, import_path.resolve)(__dirname, "templates", "stock-chart.html");
-    let html = await import_fs.promises.readFile(templatePath, "utf-8");
-    const colorScheme = {
-      mainColor: isUp ? "#f23645" : "#089981",
-      gradientStart: isUp ? "rgba(242, 54, 69, 0.25)" : "rgba(8, 153, 129, 0.25)",
-      gradientEnd: "rgba(255, 255, 255, 0)",
-      glowColor: isUp ? "rgba(242, 54, 69, 0.4)" : "rgba(8, 153, 129, 0.4)",
-      iconGradientStart: isUp ? "#f23645" : "#089981",
-      iconGradientEnd: isUp ? "#ff7e87" : "#40c2aa",
-      iconShadow: isUp ? "rgba(242, 54, 69, 0.3)" : "rgba(8, 153, 129, 0.3)",
-      changeBadgeBg: isUp ? "rgba(242, 54, 69, 0.12)" : "rgba(8, 153, 129, 0.12)"
-    };
-    const replacements = {
-      "{{MAIN_COLOR}}": colorScheme.mainColor,
-      "{{GRADIENT_START}}": colorScheme.gradientStart,
-      "{{GRADIENT_END}}": colorScheme.gradientEnd,
-      "{{GLOW_COLOR}}": colorScheme.glowColor,
-      "{{ICON_GRADIENT_START}}": colorScheme.iconGradientStart,
-      "{{ICON_GRADIENT_END}}": colorScheme.iconGradientEnd,
-      "{{ICON_SHADOW}}": colorScheme.iconShadow,
-      "{{CHANGE_BADGE_BG}}": colorScheme.changeBadgeBg,
-      "{{STOCK_NAME}}": name2,
-      "{{VIEW_LABEL}}": viewLabel,
-      "{{CURRENT_TIME}}": (/* @__PURE__ */ new Date()).toLocaleTimeString("zh-CN", { hour: "2-digit", minute: "2-digit" }),
-      "{{CURRENT_PRICE}}": current.toFixed(2),
-      "{{CHANGE_VALUE}}": `${change >= 0 ? "+" : ""}${change.toFixed(2)}`,
-      "{{CHANGE_ICON}}": change >= 0 ? "↑" : "↓",
-      "{{CHANGE_PERCENT}}": Math.abs(changePercent).toFixed(2),
-      "{{HIGH_PRICE}}": high.toFixed(2),
-      "{{LOW_PRICE}}": low.toFixed(2),
-      "{{AMPLITUDE}}": ((high - low) / startPrice * 100).toFixed(2),
-      "{{START_PRICE}}": startPrice.toFixed(2),
-      "{{UPDATE_TIME}}": (/* @__PURE__ */ new Date()).toLocaleString("zh-CN"),
-      "{{PRICES}}": JSON.stringify(data.map((d) => d.price)),
-      "{{TIMES}}": JSON.stringify(data.map((d) => d.time)),
-      "{{TIMESTAMPS}}": JSON.stringify(data.map((d) => d.timestamp))
-    };
-    for (const [key, value] of Object.entries(replacements)) {
-      html = html.replace(new RegExp(key, "g"), value);
+    if (data.length < 2) {
+      logger.warn(`renderStockImage: 数据点不足(${data.length})，无法绘制图表`);
+      return "数据不足，无法绘制走势图。";
+    }
+    try {
+      const startPrice = data[0].price;
+      const change = current - startPrice;
+      const changePercent = change / startPrice * 100;
+      const isUp = change >= 0;
+      const templatePath = (0, import_path.resolve)(__dirname, "templates", "stock-chart.html");
+      let html = await import_fs.promises.readFile(templatePath, "utf-8");
+      const colorScheme = {
+        mainColor: isUp ? "#f23645" : "#089981",
+        gradientStart: isUp ? "rgba(242, 54, 69, 0.25)" : "rgba(8, 153, 129, 0.25)",
+        gradientEnd: "rgba(255, 255, 255, 0)",
+        glowColor: isUp ? "rgba(242, 54, 69, 0.4)" : "rgba(8, 153, 129, 0.4)",
+        iconGradientStart: isUp ? "#f23645" : "#089981",
+        iconGradientEnd: isUp ? "#ff7e87" : "#40c2aa",
+        iconShadow: isUp ? "rgba(242, 54, 69, 0.3)" : "rgba(8, 153, 129, 0.3)",
+        changeBadgeBg: isUp ? "rgba(242, 54, 69, 0.12)" : "rgba(8, 153, 129, 0.12)"
+      };
+      const replacements = {
+        "{{MAIN_COLOR}}": colorScheme.mainColor,
+        "{{GRADIENT_START}}": colorScheme.gradientStart,
+        "{{GRADIENT_END}}": colorScheme.gradientEnd,
+        "{{GLOW_COLOR}}": colorScheme.glowColor,
+        "{{ICON_GRADIENT_START}}": colorScheme.iconGradientStart,
+        "{{ICON_GRADIENT_END}}": colorScheme.iconGradientEnd,
+        "{{ICON_SHADOW}}": colorScheme.iconShadow,
+        "{{CHANGE_BADGE_BG}}": colorScheme.changeBadgeBg,
+        "{{STOCK_NAME}}": name2,
+        "{{VIEW_LABEL}}": viewLabel,
+        "{{CURRENT_TIME}}": (/* @__PURE__ */ new Date()).toLocaleTimeString("zh-CN", { hour: "2-digit", minute: "2-digit" }),
+        "{{CURRENT_PRICE}}": current.toFixed(2),
+        "{{CHANGE_VALUE}}": `${change >= 0 ? "+" : ""}${change.toFixed(2)}`,
+        "{{CHANGE_ICON}}": change >= 0 ? "↑" : "↓",
+        "{{CHANGE_PERCENT}}": Math.abs(changePercent).toFixed(2),
+        "{{HIGH_PRICE}}": high.toFixed(2),
+        "{{LOW_PRICE}}": low.toFixed(2),
+        "{{AMPLITUDE}}": ((high - low) / startPrice * 100).toFixed(2),
+        "{{START_PRICE}}": startPrice.toFixed(2),
+        "{{UPDATE_TIME}}": (/* @__PURE__ */ new Date()).toLocaleString("zh-CN"),
+        "{{PRICES}}": JSON.stringify(data.map((d) => d.price)),
+        "{{TIMES}}": JSON.stringify(data.map((d) => d.time)),
+        "{{TIMESTAMPS}}": JSON.stringify(data.map((d) => d.timestamp))
+      };
+      for (const [key, value] of Object.entries(replacements)) {
+        html = html.replace(new RegExp(key, "g"), value);
+      }
+      const page = await ctx2.puppeteer.page();
+      try {
+        await page.setContent(html);
+        const element = await page.$(".card");
+        if (!element) throw new Error("找不到 .card 元素");
+        const imgBuf = await element.screenshot({ encoding: "binary" });
+        return import_koishi.h.image(imgBuf, "image/png");
+      } finally {
+        await page.close();
+      }
+    } catch (err) {
+      logger.error("renderStockImage 失败:", err);
+      return `[错误] 生成行情图失败: ${err.message}`;
     }
-    const page = await ctx2.puppeteer.page();
-    await page.setContent(html);
-    const element = await page.$(".card");
-    const imgBuf = await element?.screenshot({ encoding: "binary" });
-    await page.close();
-    return import_koishi.h.image(imgBuf, "image/png");
   }
   __name(renderStockImage, "renderStockImage");
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "koishi-plugin-monetary-bourse",
-  "version": "2.0.1",
+  "version": "2.0.3-Alpha.11",
   "main": "lib/index.js",
   "typings": "lib/index.d.ts",
   "files": [

package/readme.md

@@ -1,12 +1,12 @@
-# koishi-plugin-monetary-bourse · v2.0.0
+# koishi-plugin-monetary-bourse
 
-[![npm](https://img.shields.io/npm/v/koishi-plugin-monetary-bourse?style=flat-square)](https://www.npmjs.com/package/koishi-plugin-monetary-bourse)
+[![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)
 
 为 Koishi 提供基于 `monetary` 通用货币系统的股票交易所功能。
 
 本插件模拟了一个具备自动宏观调控、25种经典K线形态、智能概率博弈和可视化交割单的深度拟真股票市场。用户可以使用机器人通用的货币（如信用点）进行股票买卖、炒股理财。
 
-> 版本：**2.0.1**
+> 版本：**2.0.2**
 
 ## ✨ 特性
 
@@ -89,9 +89,9 @@
 
 **Q：Alpha版本有什么区别？**
 
-A：本插件在发布一个稳定版之前会进行测试，但是股票的走向和时间有关，即使通过开发调试，也难以测试出稳定的结果。因此，在新版本开发出来后（尤其是算法上的更新），我不确定是否存在非致命但影响体验的漏洞。
+A：本插件在发布一个稳定版之前会进行测试，但是股票的走向和时间有关，即使通过开发调试，也难以测试出稳定的结果。因此，在新版本开发出来后（尤其是*算法*上的更新），我不确定是否存在非致命但影响体验的漏洞。
 
-Alpha版本就是在新版本稳定之前的**过渡版**，它们具备了一些没有验证的新功能、更新，但与之一同的是未知的bug。如需使用Alpha版本，请备份数据库和配置文件，防止以外发生。
+Alpha版本就是在新版本稳定之前的**过渡版**，它们具备了一些没有验证的新功能等更新，但与之一同的是未知的bug。如需使用Alpha版本，请备份数据库和配置文件，防止以外发生。
 
 ---
 
@@ -141,53 +141,64 @@ A: 股价采用 **"智能期望模型"** 驱动，更贴近真实博弈：
 
 ## 更新记录
 
-- **2.0.1**
-  - **fix(build)**: 将静态 HTML 打包进 `lib`，修复构建未更新静态页面的问题
+### Alpha.11
 
-- **2.0.0**
-  - **perf/alg**: 提升随机噪声强度，实时曲线更具呼吸感，减少单调走势。
-  - **ui/layout**: 重构交易详情页布局，分离股票信息与价格展示区域，底部改为 Grid 布局，并将页面外间距增至 64px 以提升视觉呼吸感。
-  - **feat(ui/display)**: 优化状态徽标逻辑，支持「交易方向」与「挂单中」状态同时并列显示，并为 Pending 状态增加呼吸动画。
-  - **ui/typography**: 显著增大详情页关键数值与标签字号，回滚并强制使用 Roboto Mono 等宽字体，确保金融数据对齐与专业感。
-  - **fix(ui/trade)**: 交易结果回单在存在冻结时间时也会即时弹出；修正时间戳位置，将其强制固定于页面右下角。
-  
-- **Alpha.10**
-  - **feat(core)**: 引入 **25 种** 全新 K 线形态库；新增 `selectPatternByExpectation` 智能调度算法，按价格偏离度动态调整形态概率以实现“估值修复”。
-  - **feat(ui)**: 新增交易交割单（成交结算图），并将 HTML 模板模板化重构，支持高分辨率渲染与更友好的样式复用。
-  - **perf**: 优化持仓成本计算、挂单排队体验与兼容旧数据的处理逻辑。
+- **perf/alg**: 提升随机噪声强度。
+- **fix**: 修复末尾渲染部分语法错误。
+- **feat(logging)**: 在支付逻辑、交易处理、指令校验和图片渲染函数中添加详细的日志记录，包括警告和错误级别输出。
+
+### 2.0.2
+
+- **doc**: 更新同步更新Gitee和Github链接至`README`
+
+### 2.0.1
+- **fix(build)**: 将静态 HTML 打包进 `lib`，修复构建未更新静态页面的问题
+
+### 2.0.0
+- **perf/alg**: 提升随机噪声强度，实时曲线更具呼吸感，减少单调走势。
+- **ui/layout**: 重构交易详情页布局，分离股票信息与价格展示区域，底部改为 Grid 布局，并将页面外间距增至 64px 以提升视觉呼吸感。
+- **feat(ui/display)**: 优化状态徽标逻辑，支持「交易方向」与「挂单中」状态同时并列显示，并为 Pending 状态增加呼吸动画。
+- **ui/typography**: 显著增大详情页关键数值与标签字号，回滚并强制使用 Roboto Mono 等宽字体，确保金融数据对齐与专业感。
+- **fix(ui/trade)**: 交易结果回单在存在冻结时间时也会即时弹出；修正时间戳位置，将其强制固定于页面右下角。
+
+### Alpha.10
+- **feat(core)**: 引入 **25 种** 全新 K 线形态库；新增 `selectPatternByExpectation` 智能调度算法，按价格偏离度动态调整形态概率以实现“估值修复”。
+- **feat(ui)**: 新增交易交割单（成交结算图），并将 HTML 模板模板化重构，支持高分辨率渲染与更友好的样式复用。
+- **perf**: 优化持仓成本计算、挂单排队体验与兼容旧数据的处理逻辑。
+
+### Alpha.9
+- **fix(build)**: 将静态 HTML 打包进 `lib`，修复构建遗漏导致的插件无法加载问题。
 
-- **Alpha.9**
-  - **fix(build)**: 将静态 HTML 打包进 `lib`，修复构建遗漏导致的插件无法加载问题。
+### Alpha.8
+- **feat(ui)**: 提取并模板化走势图（`src/templates/stock-chart.html`），全面视觉优化（深色玻璃拟态、坐标轴与字体改进、增强可读性）。
+- **feat(queue)**: 将挂单改为用户串行排队，防止拆单规避冻结时长（T+0 防绕过）。
+- **perf/alg**: 提升基础波动率与形态影响力，改进周波浪与均值回归；新增 `enableDebug` 调试开关以便开发验证。
 
-- **Alpha.8**
-  - **feat(ui)**: 提取并模板化走势图（`src/templates/stock-chart.html`），全面视觉优化（深色玻璃拟态、坐标轴与字体改进、增强可读性）。
-  - **feat(queue)**: 将挂单改为用户串行排队，防止拆单规避冻结时长（T+0 防绕过）。
-  - **perf/alg**: 提升基础波动率与形态影响力，改进周波浪与均值回归；新增 `enableDebug` 调试开关以便开发验证。
+### Alpha.7
+- **feat(model)**: 引入几何布朗运动 + 均值回归，添加正态分布噪声与软着陆限幅，改善日内波动特性以提高拟真度。
 
-- **Alpha.7**
-  - **feat(model)**: 引入几何布朗运动 + 均值回归，添加正态分布噪声与软着陆限幅，改善日内波动特性以提高拟真度。
+### Alpha.6
+- **refactor**: 采用百分比波动合成模型，解决长期振幅失控并提升稳定性。
+- **fix**: 修正手动宏观调控在部分场景下重置基准价的问题。
 
-- **Alpha.6**
-  - **refactor**: 采用百分比波动合成模型，解决长期振幅失控并提升稳定性。
-  - **fix**: 修正手动宏观调控在部分场景下重置基准价的问题。
+### Alpha.5
+- **refactor**: 重写走势引擎为绝对价格合成（基准价 + 趋势 + 日内波动 + 周波浪 + 噪声），修复长期运行抖动并强化 ±50% 涨跌幅限幅。
 
-- **Alpha.5**
-  - **refactor**: 重写走势引擎为绝对价格合成（基准价 + 趋势 + 日内波动 + 周波浪 + 噪声），修复长期运行抖动并强化 ±50% 涨跌幅限幅。
+### 1.1.1 (Alpha.4)
+- **feat**: 引入硬性 ±50% 涨跌幅上限并随机刷新宏观目标以增强稳定性和随机性。
+- **fix**: 避免在更新负载中修改主键；移除过时的手动控制配置；新增调试命令以便验证逻辑。
 
-- **1.1.1 (Alpha.4)**
-  - **feat**: 引入硬性 ±50% 涨跌幅上限并随机刷新宏观目标以增强稳定性和随机性。
-  - **fix**: 避免在更新负载中修改主键；移除过时的手动控制配置；新增调试命令以便验证逻辑。
+### 1.1.0 (Alpha.3)
+- **feat**: 新增持仓盈亏与成本追踪（`totalCost`）及持仓卡片渲染（Puppeteer），提升展示与交互体验。
+- **fix**: 统一金额与价格为两位小数以保证精度与兼容性；当 `maxFreezeTime = 0` 时即时完成交易处理。
 
-- **1.1.0 (Alpha.3)**
-  - **feat**: 新增持仓盈亏与成本追踪（`totalCost`）及持仓卡片渲染（Puppeteer），提升展示与交互体验。
-  - **fix**: 统一金额与价格为两位小数以保证精度与兼容性；当 `maxFreezeTime = 0` 时即时完成交易处理。
+### 1.0.0
+- **fix**: 修复因更新负载包含主键而导致的 `TypeError: cannot modify primary key`，提高数据库兼容性。
 
-- **1.0.0**
-  - **fix**: 修复因更新负载包含主键而导致的 `TypeError: cannot modify primary key`，提高数据库兼容性。
+### Alpha.2
+- **feat**: 扩展日内走势剧本并叠加周级波浪，改进 Puppeteer 渲染以减少横轴标签重叠与视觉冲突。
+- **note**: 历史版本曾存在主键相关问题，后续版本已逐步修复。
 
-- **Alpha.2**
-  - **feat**: 扩展日内走势剧本并叠加周级波浪，改进 Puppeteer 渲染以减少横轴标签重叠与视觉冲突。
-  - **note**: 历史版本曾存在主键相关问题，后续版本已逐步修复。
+### Alpha.1
+- **feat**: 初始发布：实现买卖、挂单、资金冻结、历史行情存储及 `stock` 系列基础指令，支持与 `monetary` / `monetary-bank` 的基础联动。
 
-- **Alpha.1**
-  - **feat**: 初始发布：实现买卖、挂单、资金冻结、历史行情存储及 `stock` 系列基础指令，支持与 `monetary` / `monetary-bank` 的基础联动。