koishi-plugin-monetary-bourse 3.0.0-alpha.12 → 3.0.0-alpha.14

package/lib/index.d.ts

@@ -61,6 +61,7 @@ export interface BourseState {
     endTime: Date;
     marketOpenStatus?: "open" | "close" | "auto";
 }
+export declare const usage = "\n<div style=\"max-width: 800px; font-family: sans-serif; line-height: 1.6;\">\n  <div style=\"margin-bottom: 24px;\">\n    <h1 style=\"border-bottom: none; margin-bottom: 8px; font-size: 28px;\">\uD83D\uDCC8 monetary-bourse</h1>\n    <p style=\"opacity: 0.8; font-size: 14px;\">\u57FA\u4E8E\u8D27\u5E01\u7CFB\u7EDF\u7684\u53EF\u89C6\u5316\u80A1\u7968\u4EA4\u6613\u6240\u63D2\u4EF6\uFF0C\u652F\u6301\u81EA\u52A8\u5B8F\u89C2\u8C03\u63A7\u4E0E\u62DF\u771F K \u7EBF\u5F62\u6001\u3002</p>\n  </div>\n\n  <h3>\u2699\uFE0F \u914D\u7F6E\u9879</h3>\n  <ul style=\"margin-top: 8px; margin-bottom: 20px;\">\n    <li><b>\u57FA\u7840\u8BBE\u7F6E</b>\uFF1A\u81EA\u5B9A\u4E49\u8D27\u5E01\u5355\u4F4D\uFF08\u9700\u4E0E monetary \u7CFB\u7EDF\u4E00\u81F4\uFF09\u3001\u80A1\u7968\u540D\u79F0\u3001\u521D\u59CB\u4EF7\u683C\uFF0C\u4EE5\u53CA\u5355\u4EBA\u6700\u5927\u6301\u4ED3\u9650\u989D\u3002</li>\n    <li><b>\u80A1\u5E02\u5F00\u5173\u4E0E\u65F6\u95F4</b>\uFF1A\u63A7\u5236\u80A1\u5E02\u542F\u52A8\u72B6\u6001\uFF0C\u652F\u6301\u8BBE\u5B9A\u6BCF\u65E5\u5F00\u5E02 <code>openHour</code> \u4E0E\u4F11\u5E02 <code>closeHour</code> \u5B9E\u73B0\u81EA\u52A8\u542F\u505C\u3002</li>\n    <li><b>\u9632\u5237\u51BB\u7ED3\u673A\u5236</b>\uFF1A\u9632\u6B62\u7528\u6237\u4F4E\u4E70\u9AD8\u5356\u9AD8\u9891\u5237\u5355\u3002\u901A\u8FC7 <code>freezeCostPerMinute</code> \u8C03\u6574\u8D44\u91D1\u4E0E\u6392\u961F\u65F6\u95F4\u6BD4\u4F8B\uFF1B\u8BBE\u5B9A <code>minFreezeTime</code> \u4E0E <code>maxFreezeTime</code> \u9632\u6B62\u8FC7\u957F\u6216\u8FC7\u77ED\u6392\u961F\u3002\u53EF\u5C06\u6700\u5C0F\u65F6\u95F4\u8BBE\u4E3A 0 \u4F7F\u5C0F\u989D\u4EA4\u6613\u79D2\u6210\u3002</li>\n    <li><b>\u624B\u7EED\u8D39\u4E0E\u7CBE\u5EA6</b>\uFF1A\u53EF\u914D\u7F6E\u5356\u51FA\u624B\u7EED\u8D39 <code>sellFeePercent</code> \u63D0\u5347\u535A\u5F08\u6210\u672C\uFF1B\u82E5\u4F60\u4F7F\u7528\u7684\u901A\u8D27\u4E0D\u652F\u6301\u5C0F\u6570\uFF0C\u8BF7\u5F00\u542F <code>precisionInteger</code>\u3002</li>\n    <li><b>\u5B8F\u89C2\u8C03\u63A7\u5F15\u64CE</b>\uFF1A\u8C03\u6574 <code>biasMax</code> \u9650\u5236\u671F\u671B\u504F\u501A\u7684\u6781\u7AEF\u503C\u3002\u6B64\u5916\uFF0C\u53EF\u4EE5\u56FA\u5B9A\u6BCF\u65E5\u5B9A\u671F\u5237\u65B0\u5B8F\u89C2\u76EE\u6807\u7684\u65F6\u523B\uFF0C\u4EE5\u4FBF\u5728\u4EBA\u6D41\u9AD8\u5CF0\u671F\u5236\u9020\u884C\u60C5\u7684\u660E\u786E\u8F6C\u6298\u3002</li>\n  </ul>\n\n  <h3>\uD83D\uDCD6 \u5F00\u53D1\u8005\u5EFA\u8BAE</h3>\n  <p style=\"font-size: 14px; opacity: 0.85;\">\n    \u90E8\u7F72\u521D\u671F\uFF0C\u5EFA\u8BAE\u5728\u4E0B\u65B9\u5F00\u542F <code>enableDebug</code>\uFF0C\u901A\u8FC7 <code>bourse.test.price</code> \u6216 <code>bourse.test.run</code> \u6307\u4EE4\u751F\u6210\u672A\u6765\u4E00\u6BB5\u65F6\u95F4\u7684\u6A21\u62DF\u91CF\u4EF7\u5207\u7247\uFF0C\u4EE5\u6B64\u9A8C\u8BC1\u5F53\u524D\u7684\u53C2\u6570\u914D\u7F6E\u662F\u5426\u7B26\u5408\u8D35\u7FA4\u7684\u5E02\u573A\u8282\u594F\u548C\u8D2D\u4E70\u529B\u6C34\u5E73\u3002\u8C03\u6574\u6700\u4F73\u540E\u518D\u5173\u95ED\u8C03\u8BD5\u9009\u9879\u3002\n  </p>\n</div>\n";
 export interface Config {
     currency: string;
     stockName: string;
@@ -73,6 +74,11 @@ export interface Config {
     maxFreezeTime: number;
     marketStatus: "open" | "close" | "auto";
     enableDebug: boolean;
+    sellFeePercent: number;
+    precisionInteger: boolean;
+    fixedUpdateTime: boolean;
+    fixedUpdateHour: number;
+    biasMax: number;
 }
 export declare const Config: Schema<Config>;
 export declare function apply(ctx: Context, config: Config): void;

package/lib/index.js

@@ -23,7 +23,8 @@ __export(src_exports, {
   Config: () => Config,
   apply: () => apply,
   inject: () => inject,
-  name: () => name
+  name: () => name,
+  usage: () => usage
 });
 module.exports = __toCommonJS(src_exports);
 var import_koishi = require("koishi");
@@ -35,6 +36,28 @@ var inject = {
   optional: ["monetary"]
 };
 var logger = new import_koishi.Logger("bourse");
+var usage = `
+<div style="max-width: 800px; font-family: sans-serif; line-height: 1.6;">
+  <div style="margin-bottom: 24px;">
+    <h1 style="border-bottom: none; margin-bottom: 8px; font-size: 28px;">📈 monetary-bourse</h1>
+    <p style="opacity: 0.8; font-size: 14px;">基于货币系统的可视化股票交易所插件，支持自动宏观调控与拟真 K 线形态。</p>
+  </div>
+
+  <h3>⚙️ 配置项</h3>
+  <ul style="margin-top: 8px; margin-bottom: 20px;">
+    <li><b>基础设置</b>：自定义货币单位（需与 monetary 系统一致）、股票名称、初始价格，以及单人最大持仓限额。</li>
+    <li><b>股市开关与时间</b>：控制股市启动状态，支持设定每日开市 <code>openHour</code> 与休市 <code>closeHour</code> 实现自动启停。</li>
+    <li><b>防刷冻结机制</b>：防止用户低买高卖高频刷单。通过 <code>freezeCostPerMinute</code> 调整资金与排队时间比例；设定 <code>minFreezeTime</code> 与 <code>maxFreezeTime</code> 防止过长或过短排队。可将最小时间设为 0 使小额交易秒成。</li>
+    <li><b>手续费与精度</b>：可配置卖出手续费 <code>sellFeePercent</code> 提升博弈成本；若你使用的通货不支持小数，请开启 <code>precisionInteger</code>。</li>
+    <li><b>宏观调控引擎</b>：调整 <code>biasMax</code> 限制期望偏倚的极端值。此外，可以固定每日定期刷新宏观目标的时刻，以便在人流高峰期制造行情的明确转折。</li>
+  </ul>
+
+  <h3>📖 开发者建议</h3>
+  <p style="font-size: 14px; opacity: 0.85;">
+    部署初期，建议在下方开启 <code>enableDebug</code>，通过 <code>bourse.test.price</code> 或 <code>bourse.test.run</code> 指令生成未来一段时间的模拟量价切片，以此验证当前的参数配置是否符合贵群的市场节奏和购买力水平。调整最佳后再关闭调试选项。
+  </p>
+</div>
+`;
 var Config = import_koishi.Schema.intersect([
   import_koishi.Schema.object({
     currency: import_koishi.Schema.string().default("信用点").description("货币单位名称"),
@@ -56,6 +79,15 @@ var Config = import_koishi.Schema.intersect([
     minFreezeTime: import_koishi.Schema.number().min(0).default(10).description("最小冻结时间(分钟)"),
     maxFreezeTime: import_koishi.Schema.number().min(0).default(1440).description("最大交易冻结时间(分钟)")
   }).description("冻结机制"),
+  import_koishi.Schema.object({
+    sellFeePercent: import_koishi.Schema.number().min(0).max(100).step(0.01).default(0).description("卖出手续费（%）"),
+    precisionInteger: import_koishi.Schema.boolean().default(false).description("是否将所有计数精度设置为整数")
+  }).description("手续费与精度"),
+  import_koishi.Schema.object({
+    fixedUpdateTime: import_koishi.Schema.boolean().default(false).description("是否固定宏观目标的更新时间"),
+    fixedUpdateHour: import_koishi.Schema.number().min(0).max(23).step(1).default(9).description("固定更新时间（小时，仅 fixedUpdateTime 为 true 时生效）"),
+    biasMax: import_koishi.Schema.number().min(0.1).max(0.9).step(0.01).default(0.45).description("宏观期望上下偏倚的最大值")
+  }).description("宏观调控高级设置"),
   import_koishi.Schema.object({
     enableDebug: import_koishi.Schema.boolean().default(false).description("启用调试模式（开启后可使用调试指令）")
   }).description("开发者选项")
@@ -115,6 +147,14 @@ function apply(ctx, config) {
   );
   const stockId = "MAIN";
   let currentPrice = Number(config.initialPrice.toFixed(2));
+  function fmtPrice(value) {
+    return config.precisionInteger ? Math.round(value) : Number(value.toFixed(2));
+  }
+  __name(fmtPrice, "fmtPrice");
+  function fmtAmount(value) {
+    return config.precisionInteger ? Math.round(value) : Number(value.toFixed(2));
+  }
+  __name(fmtAmount, "fmtAmount");
   ctx.on("ready", async () => {
     const history = await ctx.database.get(
       "bourse_history",
@@ -122,7 +162,7 @@ function apply(ctx, config) {
       { limit: 1, sort: { time: "desc" } }
     );
     if (history.length > 0) {
-      currentPrice = Number(history[0].price.toFixed(2));
+      currentPrice = fmtPrice(history[0].price);
     } else {
       await ctx.database.create("bourse_history", {
         stockId,
@@ -219,7 +259,7 @@ function apply(ctx, config) {
         }
       }
       const current = Number(records[0].value || 0);
-      const newValue = Number((current + delta).toFixed(2));
+      const newValue = fmtAmount(current + delta);
       if (newValue < 0) {
         logger.warn(
           `changeCashBalance: 余额不足 current=${current}, delta=${delta}`
@@ -279,14 +319,14 @@ function apply(ctx, config) {
       const tables = ctx.database.tables;
       if (!tables || !("monetary_bank_int" in tables)) return false;
       const demandRecords = await ctx.database.select("monetary_bank_int").where({ uid, currency, type: "demand" }).orderBy("settlementDate", "asc").execute();
-      let remaining = Number(amount.toFixed(2));
+      let remaining = fmtAmount(amount);
       for (const record of demandRecords) {
         if (remaining <= 0) break;
         if (record.amount <= remaining) {
-          remaining = Number((remaining - record.amount).toFixed(2));
+          remaining = fmtAmount(remaining - record.amount);
           await ctx.database.remove("monetary_bank_int", { id: record.id });
         } else {
-          const newAmount = Number((record.amount - remaining).toFixed(2));
+          const newAmount = fmtAmount(record.amount - remaining);
           await ctx.database.set(
             "monetary_bank_int",
             { id: record.id },
@@ -315,15 +355,15 @@ function apply(ctx, config) {
       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));
+    let remainingCost = fmtAmount(cost);
+    const cashDeduct = fmtAmount(Math.min(cash, remainingCost));
     if (cashDeduct > 0) {
       const success = await changeCashBalance(uid, currency, -cashDeduct);
       if (!success) {
         logger.error(`pay 失败: 扣除现金失败 uid=${uid}, cost=${cashDeduct}`);
         return { success: false, msg: "扣除现金失败，请重试" };
       }
-      remainingCost = Number((remainingCost - cashDeduct).toFixed(2));
+      remainingCost = fmtAmount(remainingCost - cashDeduct);
     }
     if (remainingCost > 0) {
       const success = await deductBankDemand(uid, currency, remainingCost);
@@ -617,7 +657,7 @@ function apply(ctx, config) {
     const deviationThreshold = 0.05;
     if (Math.abs(deviation) > deviationThreshold) {
       const adjustmentStrength = Math.min(Math.abs(deviation) / 0.3, 1);
-      const maxBias = 0.45;
+      const maxBias = config.biasMax;
       if (deviation > 0) {
         bullishProb = 0.33 + adjustmentStrength * maxBias;
         bearishProb = 0.33 - adjustmentStrength * maxBias * 0.7;
@@ -703,7 +743,17 @@ function apply(ctx, config) {
       if (now > endTime) needNewState = true;
     }
     const createAutoState = /* @__PURE__ */ __name(async () => {
-      const durationHours = 7 * 24;
+      let endTime;
+      if (config.fixedUpdateTime) {
+        endTime = new Date(now);
+        endTime.setHours(config.fixedUpdateHour, 0, 0, 0);
+        if (endTime <= now) {
+          endTime.setDate(endTime.getDate() + 1);
+        }
+      } else {
+        const durationHours = 7 * 24;
+        endTime = new Date(now.getTime() + durationHours * 3600 * 1e3);
+      }
       const fluctuation = 0.25;
       const targetRatio = 1 + (Math.random() * 2 - 1) * fluctuation;
       let targetPrice2 = currentPrice * targetRatio;
@@ -711,7 +761,6 @@ function apply(ctx, config) {
         currentPrice * 0.5,
         Math.min(currentPrice * 1.5, targetPrice2)
       );
-      const endTime = new Date(now.getTime() + durationHours * 3600 * 1e3);
       const newState = {
         key: "macro_state",
         lastCycleStart: now,
@@ -801,7 +850,7 @@ function apply(ctx, config) {
     }
     newPrice = Math.max(lowerLimit, Math.min(upperLimit, newPrice));
     if (newPrice < 1) newPrice = 1;
-    newPrice = Number(newPrice.toFixed(2));
+    newPrice = fmtPrice(newPrice);
     currentPrice = newPrice;
     await ctx.database.create("bourse_history", {
       stockId,
@@ -826,17 +875,17 @@ function apply(ctx, config) {
             userId: txn.userId,
             stockId,
             amount: txn.amount,
-            totalCost: Number(txn.cost.toFixed(2))
+            totalCost: fmtAmount(txn.cost)
           });
         } else {
           let existingCost = holding[0].totalCost;
           if (!existingCost || existingCost <= 0) {
-            existingCost = Number((holding[0].amount * txn.price).toFixed(2));
+            existingCost = fmtAmount(holding[0].amount * txn.price);
             logger.info(
               `processPendingTransactions: 旧持仓无成本记录，使用交易价格估算: ${holding[0].amount}股 * ${txn.price} = ${existingCost}`
             );
           }
-          const newTotalCost = Number((existingCost + txn.cost).toFixed(2));
+          const newTotalCost = fmtAmount(existingCost + txn.cost);
           await ctx.database.set(
             "bourse_holding",
             { userId: txn.userId, stockId },
@@ -848,7 +897,7 @@ function apply(ctx, config) {
         }
       } else if (txn.type === "sell") {
         if (txn.uid !== void 0 && txn.uid !== null && typeof txn.uid === "number" && !Number.isNaN(txn.uid)) {
-          const amount = Number(txn.cost.toFixed(2));
+          const amount = fmtAmount(txn.cost);
           const success = await changeCashBalance(
             txn.uid,
             config.currency,
@@ -901,23 +950,22 @@ function apply(ctx, config) {
     let history;
     const now = /* @__PURE__ */ new Date();
     if (interval === "day") {
-      const startTime = new Date(now.getTime() - 24 * 3600 * 1e3);
+      const todayOpen = new Date(now);
+      todayOpen.setHours(config.openHour, 0, 0, 0);
+      const dayAgo = new Date(now.getTime() - 24 * 3600 * 1e3);
+      let startTime = todayOpen > dayAgo ? todayOpen : dayAgo;
+      if (startTime > now) startTime = dayAgo;
       history = await ctx.database.get(
         "bourse_history",
-        {
-          stockId,
-          time: { $gte: startTime }
-        },
+        { stockId, time: { $gte: startTime } },
         { sort: { time: "asc" } }
       );
     } else if (interval === "week") {
-      const startTime = new Date(now.getTime() - 7 * 24 * 3600 * 1e3);
+      const weekAgo = new Date(now.getTime() - 7 * 24 * 3600 * 1e3);
+      weekAgo.setHours(config.openHour, 0, 0, 0);
       history = await ctx.database.get(
         "bourse_history",
-        {
-          stockId,
-          time: { $gte: startTime }
-        },
+        { stockId, time: { $gte: weekAgo } },
         { sort: { time: "asc" } }
       );
     } else {
@@ -1004,7 +1052,7 @@ function apply(ctx, config) {
       );
       return "无法获取用户ID，请稍后重试。";
     }
-    const cost = Number((currentPrice * amount).toFixed(2));
+    const cost = fmtAmount(currentPrice * amount);
     const payResult = await pay(uid, cost, config.currency);
     if (!payResult.success) {
       logger.warn(
@@ -1132,17 +1180,15 @@ function apply(ctx, config) {
     const currentHolding = holding[0];
     let existingTotalCost = currentHolding.totalCost;
     if (!existingTotalCost || existingTotalCost <= 0) {
-      existingTotalCost = Number(
-        (currentHolding.amount * currentPrice).toFixed(2)
-      );
+      existingTotalCost = fmtAmount(currentHolding.amount * currentPrice);
       logger.info(
         `stock.sell: 旧持仓无成本记录，使用当前市价估算: ${currentHolding.amount}股 * ${currentPrice} = ${existingTotalCost}`
       );
     }
-    const avgCostPerShare = Number(
-      (existingTotalCost / currentHolding.amount).toFixed(2)
+    const avgCostPerShare = fmtPrice(
+      existingTotalCost / currentHolding.amount
     );
-    const soldCost = Number((avgCostPerShare * amount).toFixed(2));
+    const soldCost = fmtAmount(avgCostPerShare * amount);
     const newAmount = currentHolding.amount - amount;
     if (newAmount === 0) {
       await ctx.database.remove("bourse_holding", {
@@ -1150,7 +1196,7 @@ function apply(ctx, config) {
         stockId
       });
     } else {
-      const newTotalCost = Number((existingTotalCost - soldCost).toFixed(2));
+      const newTotalCost = fmtAmount(existingTotalCost - soldCost);
       await ctx.database.set(
         "bourse_holding",
         { userId: visibleUserId, stockId },
@@ -1161,10 +1207,13 @@ function apply(ctx, config) {
         }
       );
     }
-    const gain = Number((currentPrice * amount).toFixed(2));
+    const gain = fmtAmount(currentPrice * amount);
+    const feePercent = config.sellFeePercent;
+    const fee = feePercent > 0 ? fmtAmount(gain * feePercent / 100) : 0;
+    const netGain = fmtAmount(gain - fee);
     let freezeMinutes = 0;
     if (config.maxFreezeTime > 0) {
-      freezeMinutes = gain / config.freezeCostPerMinute;
+      freezeMinutes = netGain / config.freezeCostPerMinute;
       if (freezeMinutes > config.maxFreezeTime)
         freezeMinutes = config.maxFreezeTime;
       if (freezeMinutes < config.minFreezeTime)
@@ -1191,12 +1240,12 @@ function apply(ctx, config) {
       type: "sell",
       amount,
       price: currentPrice,
-      cost: gain,
+      cost: netGain,
       startTime,
       endTime
     });
     const hasCostRecord = existingTotalCost > 0;
-    const profit = hasCostRecord ? Number((gain - soldCost).toFixed(2)) : null;
+    const profit = hasCostRecord ? fmtAmount(netGain - soldCost) : null;
     const profitPercent = hasCostRecord && soldCost > 0 ? Number((profit / soldCost * 100).toFixed(2)) : null;
     const tradeMeta = freezeMinutes === 0 ? {
       status: "settled",
@@ -1223,7 +1272,9 @@ function apply(ctx, config) {
           avgBuyPrice: hasCostRecord ? avgCostPerShare : null,
           buyCost: hasCostRecord ? soldCost : null,
           profit,
-          profitPercent
+          profitPercent,
+          fee: fee > 0 ? fee : null,
+          feePercent: feePercent > 0 ? feePercent : null
         },
         void 0,
         tradeMeta
@@ -1243,7 +1294,9 @@ function apply(ctx, config) {
         avgBuyPrice: hasCostRecord ? avgCostPerShare : null,
         buyCost: hasCostRecord ? soldCost : null,
         profit,
-        profitPercent
+        profitPercent,
+        fee: fee > 0 ? fee : null,
+        feePercent: feePercent > 0 ? feePercent : null
       },
       void 0,
       tradeMeta
@@ -1262,16 +1315,16 @@ function apply(ctx, config) {
     let holdingData = null;
     if (holdings.length > 0) {
       const h2 = holdings[0];
-      const marketValue = Number((h2.amount * currentPrice).toFixed(2));
+      const marketValue = fmtAmount(h2.amount * currentPrice);
       const hasCostData = h2.totalCost !== void 0 && h2.totalCost !== null && h2.totalCost > 0;
-      const totalCost = hasCostData ? Number(h2.totalCost.toFixed(2)) : 0;
-      const avgCost = hasCostData && h2.amount > 0 ? Number((totalCost / h2.amount).toFixed(2)) : 0;
-      const profit = hasCostData ? Number((marketValue - totalCost).toFixed(2)) : null;
+      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;
       holdingData = {
         stockName: config.stockName,
         amount: h2.amount,
-        currentPrice: Number(currentPrice.toFixed(2)),
+        currentPrice: fmtPrice(currentPrice),
         avgCost: hasCostData ? avgCost : null,
         // null 表示无成本记录
         totalCost: hasCostData ? totalCost : null,
@@ -1291,8 +1344,8 @@ function apply(ctx, config) {
         type: p.type === "buy" ? "买入" : "卖出",
         typeClass: p.type,
         amount: p.amount,
-        price: Number(p.price.toFixed(2)),
-        cost: Number(p.cost.toFixed(2)),
+        price: fmtPrice(p.price),
+        cost: fmtAmount(p.cost),
         timeLeft: `${minutes}分${seconds}秒`
       };
     });
@@ -1541,6 +1594,8 @@ function apply(ctx, config) {
         buyCost: sellInfo?.buyCost ?? null,
         profit: sellInfo?.profit ?? null,
         profitPercent: sellInfo?.profitPercent ?? null,
+        fee: sellInfo?.fee ?? null,
+        feePercent: sellInfo?.feePercent ?? null,
         // 买入后持仓
         newHolding: newHolding ?? amount,
         status,
@@ -1577,6 +1632,17 @@ function apply(ctx, config) {
       const klineData = chartType === "kline" ? buildKLineData(data, klineBucketMs ?? 2 * 3600 * 1e3) : [];
       const templatePath = (0, import_path.resolve)(__dirname, "templates", "stock-chart.html");
       let html = await import_fs.promises.readFile(templatePath, "utf-8");
+      const g2Path = (0, import_path.resolve)(__dirname, "templates", "g2.min.js");
+      let g2Script = "";
+      try {
+        g2Script = await import_fs.promises.readFile(g2Path, "utf-8");
+        g2Script = g2Script.replace(/<\/script>/g, "<\\/script>");
+      } catch (err) {
+        logger.warn(
+          `renderStockImage: failed to read local G2 script: ${g2Path}`,
+          err
+        );
+      }
       const colorScheme = {
         mainColor: isUp ? "#f23645" : "#089981",
         gradientStart: isUp ? "rgba(242, 54, 69, 0.25)" : "rgba(8, 153, 129, 0.25)",
@@ -1615,10 +1681,11 @@ function apply(ctx, config) {
         "{{PRICES}}": JSON.stringify(data.map((d) => d.price)),
         "{{TIMES}}": JSON.stringify(data.map((d) => d.time)),
         "{{TIMESTAMPS}}": JSON.stringify(data.map((d) => d.timestamp)),
-        "{{KLINE_DATA}}": JSON.stringify(klineData)
+        "{{KLINE_DATA}}": JSON.stringify(klineData),
+        "{{G2_SCRIPT}}": g2Script
       };
       for (const [key, value] of Object.entries(replacements)) {
-        html = html.replace(new RegExp(key, "g"), value);
+        html = html.replace(new RegExp(key, "g"), () => value);
       }
       const page = await ctx2.puppeteer.page();
       try {
@@ -1698,5 +1765,6 @@ __name(apply, "apply");
   Config,
   apply,
   inject,
-  name
+  name,
+  usage
 });

package/lib/templates/holding-card.html

@@ -202,6 +202,10 @@
       border-top: 1px solid var(--border-color);
     }
 
+    .profit-section.up { background: var(--profit-up-bg); }
+    .profit-section.down { background: var(--profit-down-bg); }
+    .profit-section.no-data { background: rgba(255, 255, 255, 0.03); }
+
     .profit-label {
       font-size: 13px;
       font-weight: 600;
@@ -214,6 +218,10 @@
       font-family: 'Roboto Mono';
     }
 
+    .profit-value.up { color: var(--profit-up); }
+    .profit-value.down { color: var(--profit-down); }
+    .profit-value.no-data { color: #8b919e; }
+
     .profit-percent {
       font-size: 13px;
       font-weight: 600;
@@ -413,13 +421,6 @@
     // 从 JSON 标签中读取数据
     const DATA = JSON.parse(document.getElementById('data-source').textContent);
 
-    // 统一字体：数字和金额统一使用与其他页面一致的等宽字体
-    const monoTargets = document.querySelectorAll('.stat-value, .profit-value, .pending-amount, .pending-price, .pending-cost, .pending-type, .stock-amount')
-    monoTargets.forEach(el => {
-      el.style.fontFamily = "'Roboto Mono','Trebuchet MS','Inter',-apple-system,BlinkMacSystemFont,'Segoe UI',Roboto,sans-serif"
-      el.style.letterSpacing = '-0.2px'
-    })
-
     // 渲染用户信息
     document.getElementById('avatar').textContent = DATA.username.charAt(0).toUpperCase();
     document.getElementById('username').textContent = DATA.username;
@@ -431,26 +432,16 @@
       const h = DATA.holding;
       const hasCostData = h.totalCost !== null;
       const isProfit = hasCostData ? h.profit >= 0 : true;
-
-      // 适配深色模式的颜色
-      const profitColor = isProfit ? '#f87171' : '#4ade80';
       const profitSign = isProfit ? '+' : '';
-      const profitBgColor = isProfit ? 'rgba(248, 113, 113, 0.1)' : 'rgba(74, 222, 128, 0.1)';
+      const profitClass = hasCostData ? (isProfit ? 'up' : 'down') : 'no-data';
 
-      const profitSection = hasCostData ? `
-        <div class="profit-section" style="background: ${profitBgColor}">
-          <div class="profit-label">盈亏</div>
-          <div class="profit-value" style="color: ${profitColor}">
-            ${profitSign}${h.profit.toFixed(2)} ${DATA.currency}
-            <span class="profit-percent">(${profitSign}${h.profitPercent.toFixed(2)}%)</span>
-          </div>
-        </div>
-      ` : `
-        <div class="profit-section no-data" style="background: rgba(255, 255, 255, 0.03)">
+      const profitSection = `
+        <div class="profit-section ${profitClass}">
           <div class="profit-label">盈亏</div>
-          <div class="profit-value" style="color: #8b919e">
-            暂无成本记录
-            <span class="profit-hint">（新交易后将自动记录）</span>
+          <div class="profit-value ${profitClass}">
+            ${hasCostData ? `${profitSign}${h.profit.toFixed(2)} ${DATA.currency}
+            <span class="profit-percent">(${profitSign}${h.profitPercent.toFixed(2)}%)</span>` : `暂无成本记录
+            <span class="profit-hint">（新交易后将自动记录）</span>`}
           </div>
         </div>
       `;

package/lib/templates/stock-chart.html

@@ -8,6 +8,8 @@
         --icon-gradient-end: {{ICON_GRADIENT_END}};
         --icon-shadow: {{ICON_SHADOW}};
         --change-badge-bg: {{CHANGE_BADGE_BG}};
+        --rise-color: #f23645;
+        --fall-color: #089981;
 
         --bg-color: #0c0f15;
         --card-bg: #161b22;
@@ -256,14 +258,16 @@
       <div class="update-time">Updated {{UPDATE_TIME}}</div>
     </div>
 
+    <script>{{G2_SCRIPT}}</script>
     <script>
       const chartType = "{{CHART_TYPE}}";
-      const klineData = JSON.parse("{{KLINE_DATA}}");
-      const prices = JSON.parse("{{PRICES}}");
-      const times = JSON.parse("{{TIMES}}");
-      const timestamps = JSON.parse("{{TIMESTAMPS}}");
-      const riseColor = "#f23645";
-      const fallColor = "#089981";
+      const klineData = {{KLINE_DATA}};
+      const prices = {{PRICES}};
+      const times = {{TIMES}};
+      const timestamps = {{TIMESTAMPS}};
+      const rootStyle = getComputedStyle(document.documentElement);
+      const riseColor = rootStyle.getPropertyValue("--rise-color").trim();
+      const fallColor = rootStyle.getPropertyValue("--fall-color").trim();
 
       function markReady(className) {
         document.body.classList.add(className || "chart-ready");

package/lib/templates/trade-result.html

@@ -240,11 +240,15 @@
       /* 增加高度以容纳更大的字体 */
     }
 
+    .stats-grid.sell-grid {
+      grid-template-columns: 1fr 1fr 1fr 1fr;
+    }
+
     .stat-item {
       background: var(--item-bg);
       border: 1px solid var(--border-color);
       border-radius: 12px;
-      padding: 20px 28px;
+      padding: 16px 20px;
       display: flex;
       flex-direction: column;
       justify-content: center;
@@ -369,26 +373,6 @@
   </script>
 
   <script>
-    // 模拟数据用于测试
-    /*
-    const TEST_DATA = {
-      tradeType: 'buy',
-      stockName: 'NVDA · NVIDIA Corp',
-      status: 'pending',
-      pendingMinutes: 5.5,
-      pendingEndTime: '14:35',
-      tradePrice: 485.20,
-      amount: 10,
-      totalCost: 4852.00,
-      tradeTime: '2023-10-27 10:30:05',
-      newHolding: 150,
-      currency: 'USD',
-      prices: [480, 482, 481, 483, 485, 484, 486, 485.2, 487, 488, 486],
-      timestamps: [1000, 2000, 3000, 4000, 5000, 6000, 7000, 8000, 9000, 10000, 11000],
-      tradeIndex: 7
-    };
-    */
-
     let DATA;
     try {
       DATA = JSON.parse(document.getElementById('data-source').textContent);
@@ -400,16 +384,7 @@
     const status = DATA.status || 'settled';
     const isPending = status === 'pending';
 
-    const colors = {
-      buy: '#f87171',
-      sell: '#4ade80',
-      pending: '#eab308',
-      grid: '#30363d',
-      text: '#f0f3f5',
-      textDim: '#8b949e'
-    };
-
-    const mainColor = isBuy ? colors.buy : colors.sell;
+    const mainColor = isBuy ? '#f87171' : '#4ade80';
 
     // --- 1. 渲染顶部基本信息 ---
     document.getElementById('stock-name').textContent = DATA.stockName || 'Unknown Stock';
@@ -465,7 +440,9 @@
       const isProfit = profit >= 0;
       const profitClass = isProfit ? 'profit' : 'loss';
       const profitSign = isProfit ? '+' : '';
+      const hasFee = DATA.fee !== null && DATA.fee > 0;
 
+      statsGrid.classList.add('sell-grid');
       statsGrid.innerHTML = `
         <div class="stat-item highlight">
           <div class="stat-label">Revenue 卖出金额</div>
@@ -473,9 +450,14 @@
           <div class="stat-sub">${DATA.currency}</div>
         </div>
         <div class="stat-item">
-          <div class="stat-label">Cost Basis 买入成本</div>
-          <div class="stat-value">${DATA.avgBuyPrice ? DATA.avgBuyPrice.toFixed(2) : '--'}</div>
-          <div class="stat-sub">每股</div>
+          <div class="stat-label">Fee 手续费</div>
+          <div class="stat-value">${hasFee ? DATA.fee.toFixed(2) : '--'}</div>
+          <div class="stat-sub">${DATA.currency}${hasFee ? ` (${DATA.feePercent}%)` : ''}</div>
+        </div>
+        <div class="stat-item">
+          <div class="stat-label">Net 到账</div>
+          <div class="stat-value">${(DATA.totalCost - (DATA.fee || 0)).toFixed(2)}</div>
+          <div class="stat-sub">${DATA.currency}</div>
         </div>
         <div class="stat-item ${profitClass}">
           <div class="stat-label">P/L 盈亏</div>
@@ -530,7 +512,7 @@
 
         // 价格标签 (字体也同步调整为 Roboto Mono 且加大)
         const val = yMin + (i / gridLines) * yRange;
-        ctx.fillStyle = colors.textDim;
+        ctx.fillStyle = '#8b949e';
         // 修改 1 & 2: 增大字号到 14px 并使用 Roboto Mono
         ctx.font = '500 14px "Roboto Mono", monospace';
         ctx.textAlign = 'left';

package/package.json

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

package/readme.md

@@ -6,8 +6,7 @@
 
 本插件模拟了一个具备自动宏观调控、25种经典K线形态、智能概率博弈和可视化交割单的深度拟真股票市场。用户可以使用机器人通用的货币（如信用点）进行股票买卖、炒股理财。
 
-> 版本：**2.1.1**
-
+> 版本：**3.0.0-alpha.14**
 ## ✨ 特性
 
 - **📈 拟真 K 线引擎**：
@@ -21,6 +20,8 @@
 - **❄️ 资金冻结与挂单排队**：
   - 交易采用 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) 联动，现金不足时自动扣除银行活期存款。
 
 ## 📦 依赖
@@ -133,11 +134,17 @@ A: 股价采用 **"智能期望模型"** 驱动，更贴近真实博弈：
 - **minFreezeTime**: 最小冻结时间（分钟，默认 `10`）。
 - **maxFreezeTime**: 最大冻结时间（分钟，默认 `1440` 即24小时）。
 
+### 手续费与精度
+- **sellFeePercent**: 卖出手续费百分比（默认 `0`）。
+- **precisionInteger**: 是否启用整数精度（默认 `false`）。
+
 ### 开发者选项
 - **enableDebug**: 是否启用调试模式（默认 `false`）。开启后可使用 `bourse.test.*` 系列调试指令。
 
-### 宏观调控
-- 已移除配置项中的手动宏观调控字段；请使用管理员指令进行宏观调控。
+### 宏观调控高级设置
+- **fixedUpdateTime**: 是否固定宏观目标的更新时间（默认 `false`）。
+- **fixedUpdateHour**: 固定更新时间（小时，0-23，默认 `9`）。仅在 `fixedUpdateTime` 为 `true` 时生效。
+- **biasMax**: 宏观期望上下偏倚的最大值（默认 `0.45`）。
 
 ## 📝 更新日志