koishi-plugin-monetary-bourse 3.0.0-alpha.15 → 3.0.0-alpha.17

package/lib/index.d.ts

@@ -29,6 +29,7 @@ declare module "koishi" {
 export interface BourseHolding {
     id: number;
     userId: string;
+    uid: number;
     stockId: string;
     amount: number;
     totalCost: number;
@@ -60,8 +61,13 @@ export interface BourseState {
     mode: "auto" | "manual";
     endTime: Date;
     marketOpenStatus?: "open" | "close" | "auto";
+    lastDividendDate?: Date;
 }
-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 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\u5206\u6863\u5356\u51FA\u624B\u7EED\u8D39 <code>sellFeeTiers</code>\uFF08\u80A1\u6570\u8D8A\u5927\u8D39\u7387\u8D8A\u4F4E\uFF09\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 type SellFeeTier = {
+    minAmount: number;
+    feePercent: number;
+};
 export interface Config {
     currency: string;
     stockName: string;
@@ -74,11 +80,13 @@ export interface Config {
     maxFreezeTime: number;
     marketStatus: "open" | "close" | "auto";
     enableDebug: boolean;
-    sellFeePercent: number;
+    sellFeeTiers: SellFeeTier[];
     precisionInteger: boolean;
     fixedUpdateTime: boolean;
     fixedUpdateHour: number;
     biasMax: number;
+    dividendIntervalDays: number;
+    maxDividendRate: number;
 }
 export declare const Config: Schema<Config>;
 export declare function apply(ctx: Context, config: Config): void;

package/lib/index.js

@@ -33,12 +33,7 @@ var import_koishi2 = require("koishi");
 var import_koishi = require("koishi");
 var import_path = require("path");
 var import_fs = require("fs");
-var import_url = require("url");
-var import_meta = {};
-var templatesDir = (0, import_path.resolve)(
-  (0, import_url.fileURLToPath)(new URL(".", import_meta.url)),
-  "templates"
-);
+var templatesDir = (0, import_path.resolve)(__dirname, "templates");
 async function renderHoldingImage(ctx, logger2, username, holding, pending, currency) {
   try {
     const templatePath = (0, import_path.resolve)(templatesDir, "holding-card.html");
@@ -132,14 +127,6 @@ 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");
-    const g2Path = (0, import_path.resolve)(templatesDir, "g2.min.js");
-    let g2Script = "";
-    try {
-      g2Script = await import_fs.promises.readFile(g2Path, "utf-8");
-      g2Script = g2Script.replace(/<\/script>/g, "<\\/script>");
-    } catch (err) {
-      logger2.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)",
@@ -179,7 +166,7 @@ async function renderStockImage(ctx, logger2, data, name2, viewLabel, current, h
       "{{TIMES}}": JSON.stringify(data.map((d) => d.time)),
       "{{TIMESTAMPS}}": JSON.stringify(data.map((d) => d.timestamp)),
       "{{KLINE_DATA}}": JSON.stringify(klineData),
-      "{{G2_SCRIPT}}": g2Script
+      "{{G2_SCRIPT}}": ""
     };
     for (const [key, value] of Object.entries(replacements)) {
       html = html.replace(new RegExp(key, "g"), () => value);
@@ -637,6 +624,15 @@ function registerAdminCommands(deps) {
 __name(registerAdminCommands, "registerAdminCommands");
 
 // src/commands-stock.ts
+function resolveSellFeePercent(amount, tiers) {
+  if (!Array.isArray(tiers) || tiers.length === 0) return 0;
+  const sorted = [...tiers].sort((a, b) => b.minAmount - a.minAmount);
+  const matched = sorted.find((tier) => amount >= tier.minAmount);
+  if (!matched) return 0;
+  const percent = Number.isFinite(matched.feePercent) ? matched.feePercent : 0;
+  return Math.min(100, Math.max(0, percent));
+}
+__name(resolveSellFeePercent, "resolveSellFeePercent");
 function registerStockCommands(deps) {
   const {
     ctx,
@@ -968,7 +964,7 @@ function registerStockCommands(deps) {
       );
     }
     const gain = fmtAmount(currentPrice * amount);
-    const feePercent = config.sellFeePercent;
+    const feePercent = resolveSellFeePercent(amount, config.sellFeeTiers);
     const fee = feePercent > 0 ? fmtAmount(gain * feePercent / 100) : 0;
     const netGain = fmtAmount(gain - fee);
     let freezeMinutes = 0;
@@ -1247,7 +1243,7 @@ var usage = `
     <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>sellFeeTiers</code>（股数越大费率越低）；若你使用的通货不支持小数，请开启 <code>precisionInteger</code>。</li>
     <li><b>宏观调控引擎</b>：调整 <code>biasMax</code> 限制期望偏倚的极端值。此外，可以固定每日定期刷新宏观目标的时刻，以便在人流高峰期制造行情的明确转折。</li>
   </ul>
 
@@ -1279,7 +1275,12 @@ var Config = import_koishi2.Schema.intersect([
     maxFreezeTime: import_koishi2.Schema.number().min(0).default(1440).description("最大交易冻结时间(分钟)")
   }).description("冻结机制"),
   import_koishi2.Schema.object({
-    sellFeePercent: import_koishi2.Schema.number().min(0).max(100).step(0.01).default(0).description("卖出手续费（%）"),
+    sellFeeTiers: import_koishi2.Schema.array(
+      import_koishi2.Schema.object({
+        minAmount: import_koishi2.Schema.number().min(1).step(1).description("起始股数（含）"),
+        feePercent: import_koishi2.Schema.number().min(0).max(100).step(0.01).description("手续费比例（%）")
+      })
+    ).role("table").default([{ minAmount: 1, feePercent: 0 }]).description("卖出手续费分档（按股数越大费率越低匹配）"),
     precisionInteger: import_koishi2.Schema.boolean().default(false).description("是否将所有计数精度设置为整数")
   }).description("手续费与精度"),
   import_koishi2.Schema.object({
@@ -1287,6 +1288,10 @@ var Config = import_koishi2.Schema.intersect([
     fixedUpdateHour: import_koishi2.Schema.number().min(0).max(23).step(1).default(9).description("固定更新时间（小时，仅 fixedUpdateTime 为 true 时生效）"),
     biasMax: import_koishi2.Schema.number().min(0.1).max(0.9).step(0.01).default(0.45).description("宏观期望上下偏倚的最大值")
   }).description("宏观调控高级设置"),
+  import_koishi2.Schema.object({
+    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({
     enableDebug: import_koishi2.Schema.boolean().default(false).description("启用调试模式（开启后可使用调试指令）")
   }).description("开发者选项")
@@ -1297,6 +1302,7 @@ function apply(ctx, config) {
     {
       id: "unsigned",
       userId: "string",
+      uid: "unsigned",
       stockId: "string",
       amount: "integer",
       totalCost: "double"
@@ -1340,7 +1346,8 @@ function apply(ctx, config) {
       trendFactor: "double",
       mode: "string",
       endTime: "timestamp",
-      marketOpenStatus: "string"
+      marketOpenStatus: "string",
+      lastDividendDate: "timestamp"
     },
     { primary: "key" }
   );
@@ -1369,6 +1376,94 @@ function apply(ctx, config) {
         time: /* @__PURE__ */ new Date()
       });
     }
+    const allHoldings = await ctx.database.get("bourse_holding", {});
+    const withoutUid = allHoldings.filter((h2) => !h2.uid);
+    if (withoutUid.length > 0) {
+      logger.info(
+        `迁移: 发现 ${withoutUid.length} 条持仓记录缺少 uid，开始修复...`
+      );
+      const allPending = await ctx.database.get("bourse_pending", {});
+      const uidMap = /* @__PURE__ */ new Map();
+      for (const p of allPending) {
+        if (p.userId && p.uid && !uidMap.has(p.userId)) {
+          uidMap.set(p.userId, p.uid);
+        }
+      }
+      const userTableUidMap = /* @__PURE__ */ new Map();
+      try {
+        const userTable = ctx.database.tables;
+        if (userTable && "user" in userTable) {
+          const allUsers = await ctx.database.get("user", {});
+          for (const u of allUsers) {
+            if (u.id !== void 0 && u.id !== null) {
+              const strId = String(u.id);
+              if (!userTableUidMap.has(strId)) {
+                userTableUidMap.set(strId, Number(u.id));
+              }
+            }
+          }
+        }
+      } catch {
+      }
+      let fixed = 0;
+      for (const h2 of withoutUid) {
+        const pendingUid = uidMap.get(h2.userId);
+        if (pendingUid) {
+          await ctx.database.set(
+            "bourse_holding",
+            { userId: h2.userId, stockId },
+            { uid: pendingUid }
+          );
+          fixed++;
+          continue;
+        }
+        let userUid = userTableUidMap.get(h2.userId);
+        if (!userUid) {
+          const numMatch = h2.userId.match(/(\d+)$/);
+          if (numMatch) {
+            userUid = userTableUidMap.get(numMatch[1]);
+          }
+        }
+        if (userUid) {
+          await ctx.database.set(
+            "bourse_holding",
+            { userId: h2.userId, stockId },
+            { uid: userUid }
+          );
+          fixed++;
+          continue;
+        }
+        const numericMatch = h2.userId.match(/(\d+)$/);
+        const candidateUid = numericMatch ? Number(numericMatch[1]) : null;
+        if (candidateUid && candidateUid > 0) {
+          try {
+            const monRecords = await ctx.database.get("monetary", {
+              uid: candidateUid,
+              currency: config.currency
+            });
+            if (monRecords.length > 0) {
+              await ctx.database.set(
+                "bourse_holding",
+                { userId: h2.userId, stockId },
+                { uid: candidateUid }
+              );
+              fixed++;
+              logger.info(
+                `迁移: 通过 userId 尾部数字推断 uid=${candidateUid} -> userId=${h2.userId}`
+              );
+              continue;
+            }
+          } catch {
+          }
+        }
+        logger.warn(
+          `迁移: 无法为用户 ${h2.userId} 解析 uid，将在首次买入时自动修复`
+        );
+      }
+      if (fixed > 0) {
+        logger.info(`迁移: 成功修复 ${fixed}/${withoutUid.length} 条记录`);
+      }
+    }
   });
   let wasMarketOpen = false;
   let dailyOpenPrice = null;
@@ -1383,6 +1478,7 @@ function apply(ctx, config) {
       if (!isOpen) return;
       await updatePrice();
       await processPendingTransactions();
+      await checkAndExecuteDividend();
       const oneMonthAgo = new Date(Date.now() - 30 * 24 * 3600 * 1e3);
       await ctx.database.remove("bourse_history", {
         time: { $lt: oneMonthAgo }
@@ -1814,6 +1910,7 @@ function apply(ctx, config) {
         if (holding.length === 0) {
           await ctx.database.create("bourse_holding", {
             userId: txn.userId,
+            uid: txn.uid,
             stockId,
             amount: txn.amount,
             totalCost: fmtAmount(txn.cost)
@@ -1832,7 +1929,9 @@ function apply(ctx, config) {
             { userId: txn.userId, stockId },
             {
               amount: holding[0].amount + txn.amount,
-              totalCost: newTotalCost
+              totalCost: newTotalCost,
+              uid: txn.uid
+              // 确保 uid 始终是最新的
             }
           );
         }
@@ -1859,6 +1958,135 @@ function apply(ctx, config) {
     }
   }
   __name(processPendingTransactions, "processPendingTransactions");
+  async function checkAndExecuteDividend() {
+    const now = __testNow ?? /* @__PURE__ */ new Date();
+    let state = (await ctx.database.get("bourse_state", { key: "macro_state" }))[0];
+    if (state && state.lastDividendDate) {
+      const lastDate = new Date(state.lastDividendDate);
+      const elapsed = now.getTime() - lastDate.getTime();
+      const intervalMs = config.dividendIntervalDays * 24 * 3600 * 1e3;
+      if (elapsed < intervalMs) return;
+    } else {
+      if (!state) {
+        await ctx.database.create("bourse_state", {
+          key: "macro_state",
+          lastCycleStart: new Date(Date.now() - 7 * 24 * 3600 * 1e3),
+          startPrice: currentPrice,
+          targetPrice: currentPrice,
+          trendFactor: 0,
+          mode: "auto",
+          endTime: new Date(Date.now() + 7 * 24 * 3600 * 1e3),
+          lastDividendDate: now
+        });
+      } else {
+        await ctx.database.set(
+          "bourse_state",
+          { key: "macro_state" },
+          { lastDividendDate: now }
+        );
+      }
+      logger.info("分红引擎: 首次初始化，将在下个周期执行首次分红");
+      return;
+    }
+    const allHoldings = await ctx.database.get("bourse_holding", {});
+    const totalHoldings = allHoldings.reduce((sum, h2) => sum + h2.amount, 0);
+    if (allHoldings.length === 0 || totalHoldings === 0) {
+      await ctx.database.set(
+        "bourse_state",
+        { key: "macro_state" },
+        { lastDividendDate: now }
+      );
+      logger.info("分红引擎: 无持仓记录，跳过本次分红");
+      return;
+    }
+    const totalMarketValue = fmtAmount(totalHoldings * currentPrice);
+    const totalCost = fmtAmount(
+      allHoldings.reduce((sum, h2) => sum + (h2.totalCost || 0), 0)
+    );
+    const totalProfit = fmtAmount(totalMarketValue - totalCost);
+    const edpr = totalMarketValue > 0 ? totalProfit / totalMarketValue : 0;
+    if (edpr <= 0) {
+      await ctx.database.set(
+        "bourse_state",
+        { key: "macro_state" },
+        { lastDividendDate: now }
+      );
+      logger.info(
+        `分红引擎: 大盘亏损（EDPR=${(edpr * 100).toFixed(2)}%），跳过本次分红`
+      );
+      return;
+    }
+    const priceDropRate = edpr;
+    const effectiveDividendRate = Math.min(edpr, config.maxDividendRate);
+    logger.info(
+      `分红引擎: 开始执行分红 | EDPR=${(edpr * 100).toFixed(2)}% | 除息跌幅=${(priceDropRate * 100).toFixed(2)}% | 实际派息率=${(effectiveDividendRate * 100).toFixed(2)}% | 持仓人数=${allHoldings.length} | 总股数=${totalHoldings}`
+    );
+    let totalDividendPaid = 0;
+    let successCount = 0;
+    let failCount = 0;
+    for (const holding of allHoldings) {
+      const dividendAmount = fmtAmount(
+        holding.amount * effectiveDividendRate * currentPrice
+      );
+      if (dividendAmount <= 0) continue;
+      if (!holding.uid) {
+        logger.warn(
+          `分红引擎: 用户 ${holding.userId} 缺少 uid，无法派发分红 ${dividendAmount.toFixed(2)}`
+        );
+        failCount++;
+        continue;
+      }
+      const success = await changeCashBalance(
+        holding.uid,
+        config.currency,
+        dividendAmount
+      );
+      if (success) {
+        totalDividendPaid += dividendAmount;
+        successCount++;
+      } else {
+        logger.warn(
+          `分红引擎: 用户 ${holding.userId} (uid=${holding.uid}) 分红派发失败`
+        );
+        failCount++;
+      }
+    }
+    const oldPrice = currentPrice;
+    currentPrice = fmtPrice(currentPrice * (1 - priceDropRate));
+    if (currentPrice < 1) currentPrice = 1;
+    await ctx.database.create("bourse_history", {
+      stockId,
+      price: currentPrice,
+      time: now
+    });
+    const fluctuation = 0.25;
+    const targetRatio = 1 + (Math.random() * 2 - 1) * fluctuation;
+    let newTargetPrice = currentPrice * targetRatio;
+    newTargetPrice = Math.max(
+      currentPrice * 0.5,
+      Math.min(currentPrice * 1.5, newTargetPrice)
+    );
+    let newEndTime;
+    if (config.fixedUpdateTime) {
+      newEndTime = new Date(now);
+      newEndTime.setHours(config.fixedUpdateHour, 0, 0, 0);
+      if (newEndTime <= now) newEndTime.setDate(newEndTime.getDate() + 1);
+    } 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
+    });
+    switchKLinePattern("分红除息");
+    logger.info(
+      `分红引擎: 执行完毕 | 除息前股价=${oldPrice} -> 除息后=${currentPrice} (${(-priceDropRate * 100).toFixed(2)}%) | 派发成功=${successCount}人 | 失败=${failCount}人 | 合计派发=${totalDividendPaid.toFixed(2)} ${config.currency}`
+    );
+  }
+  __name(checkAndExecuteDividend, "checkAndExecuteDividend");
   async function getPriceHistory(limit = 100) {
     const historyData = await ctx.database.get(
       "bourse_history",

package/package.json

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