koishi-plugin-monetary-bourse 1.0.0-alpha.2 → 1.1.0-alpha.3

package/lib/index.d.ts

@@ -31,6 +31,7 @@ export interface BourseHolding {
     userId: string;
     stockId: string;
     amount: number;
+    totalCost: number;
 }
 export interface BoursePending {
     id: number;

package/lib/index.js

@@ -63,7 +63,9 @@ function apply(ctx, config) {
     id: "unsigned",
     userId: "string",
     stockId: "string",
-    amount: "integer"
+    amount: "integer",
+    totalCost: "double"
+    // 买入总成本
   }, { primary: ["userId", "stockId"] });
   ctx.model.extend("bourse_pending", {
     id: "unsigned",
@@ -94,11 +96,11 @@ function apply(ctx, config) {
     marketOpenStatus: "string"
   }, { primary: "key" });
   const stockId = "MAIN";
-  let currentPrice = config.initialPrice;
+  let currentPrice = Number(config.initialPrice.toFixed(2));
   ctx.on("ready", async () => {
     const history = await ctx.database.get("bourse_history", { stockId }, { limit: 1, sort: { time: "desc" } });
     if (history.length > 0) {
-      currentPrice = history[0].price;
+      currentPrice = Number(history[0].price.toFixed(2));
     } else {
       await ctx.database.create("bourse_history", { stockId, price: currentPrice, time: /* @__PURE__ */ new Date() });
     }
@@ -171,7 +173,7 @@ function apply(ctx, config) {
         }
       }
       const current = Number(records[0].value || 0);
-      const newValue = current + delta;
+      const newValue = Number((current + delta).toFixed(2));
       if (newValue < 0) {
         logger.warn(`changeCashBalance: 余额不足 current=${current}, delta=${delta}`);
         return false;
@@ -212,14 +214,15 @@ 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 = amount;
+      let remaining = Number(amount.toFixed(2));
       for (const record of demandRecords) {
         if (remaining <= 0) break;
         if (record.amount <= remaining) {
-          remaining -= record.amount;
+          remaining = Number((remaining - record.amount).toFixed(2));
           await ctx.database.remove("monetary_bank_int", { id: record.id });
         } else {
-          await ctx.database.set("monetary_bank_int", { id: record.id }, { amount: record.amount - remaining });
+          const newAmount = Number((record.amount - remaining).toFixed(2));
+          await ctx.database.set("monetary_bank_int", { id: record.id }, { amount: newAmount });
           remaining = 0;
         }
       }
@@ -237,14 +240,14 @@ 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} + 活期 ${bankDemand}` };
+      return { success: false, msg: `资金不足！需要 ${cost.toFixed(2)}，当前现金 ${cash.toFixed(2)} + 活期 ${bankDemand.toFixed(2)}` };
     }
-    let remainingCost = cost;
-    const cashDeduct = Math.min(cash, remainingCost);
+    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: "扣除现金失败，请重试" };
-      remainingCost -= cashDeduct;
+      remainingCost = Number((remainingCost - cashDeduct).toFixed(2));
     }
     if (remainingCost > 0) {
       const success = await deductBankDemand(uid, currency, remainingCost);
@@ -380,7 +383,10 @@ function apply(ctx, config) {
           endTime
         };
         if (!state) await ctx.database.create("bourse_state", newState);
-        else await ctx.database.set("bourse_state", "macro_state", newState);
+        else {
+          const { key, ...updateFields } = newState;
+          await ctx.database.set("bourse_state", { key: "macro_state" }, updateFields);
+        }
         state = newState;
       }
     }
@@ -414,7 +420,8 @@ function apply(ctx, config) {
         if (!state) {
           await ctx.database.create("bourse_state", newState);
         } else {
-          await ctx.database.set("bourse_state", "macro_state", newState);
+          const { key, ...updateFields } = newState;
+          await ctx.database.set("bourse_state", { key: "macro_state" }, updateFields);
         }
         state = newState;
       }
@@ -449,6 +456,7 @@ function apply(ctx, config) {
     const waveDelta = getWaveValue(elapsed) - getWaveValue(prevElapsed);
     let newPrice = currentPrice + trend + volatility + patternDelta + waveDelta;
     if (newPrice < 1) newPrice = 1;
+    newPrice = Number(newPrice.toFixed(2));
     currentPrice = newPrice;
     await ctx.database.create("bourse_history", { stockId, price: newPrice, time: /* @__PURE__ */ new Date() });
   }
@@ -460,9 +468,23 @@ function apply(ctx, config) {
       if (txn.type === "buy") {
         const holding = await ctx.database.get("bourse_holding", { userId: txn.userId, stockId });
         if (holding.length === 0) {
-          await ctx.database.create("bourse_holding", { userId: txn.userId, stockId, amount: txn.amount });
+          await ctx.database.create("bourse_holding", {
+            userId: txn.userId,
+            stockId,
+            amount: txn.amount,
+            totalCost: Number(txn.cost.toFixed(2))
+          });
         } else {
-          await ctx.database.set("bourse_holding", { userId: txn.userId, stockId }, { amount: holding[0].amount + txn.amount });
+          let existingCost = holding[0].totalCost;
+          if (!existingCost || existingCost <= 0) {
+            existingCost = Number((holding[0].amount * txn.price).toFixed(2));
+            logger.info(`processPendingTransactions: 旧持仓无成本记录，使用交易价格估算: ${holding[0].amount}股 * ${txn.price} = ${existingCost}`);
+          }
+          const newTotalCost = Number((existingCost + txn.cost).toFixed(2));
+          await ctx.database.set("bourse_holding", { userId: txn.userId, stockId }, {
+            amount: holding[0].amount + txn.amount,
+            totalCost: newTotalCost
+          });
         }
       } else if (txn.type === "sell") {
         if (txn.uid && typeof txn.uid === "number") {
@@ -540,9 +562,12 @@ function apply(ctx, config) {
     if (!payResult.success) {
       return payResult.msg;
     }
-    let freezeMinutes = cost / config.freezeCostPerMinute;
-    if (freezeMinutes < config.minFreezeTime) freezeMinutes = config.minFreezeTime;
-    if (freezeMinutes > config.maxFreezeTime) freezeMinutes = config.maxFreezeTime;
+    let freezeMinutes = 0;
+    if (config.maxFreezeTime > 0) {
+      freezeMinutes = cost / config.freezeCostPerMinute;
+      if (freezeMinutes > config.maxFreezeTime) freezeMinutes = config.maxFreezeTime;
+      if (freezeMinutes < config.minFreezeTime) freezeMinutes = config.minFreezeTime;
+    }
     const freezeMs = freezeMinutes * 60 * 1e3;
     const endTime = new Date(Date.now() + freezeMs);
     await ctx.database.create("bourse_pending", {
@@ -556,6 +581,12 @@ function apply(ctx, config) {
       startTime: /* @__PURE__ */ new Date(),
       endTime
     });
+    if (freezeMinutes === 0) {
+      await processPendingTransactions();
+      return `交易已完成！
+花费: ${cost.toFixed(2)} ${config.currency}
+股票已到账。`;
+    }
     return `交易申请已提交！
 花费: ${cost.toFixed(2)} ${config.currency}
 冻结时间: ${freezeMinutes.toFixed(1)}分钟
@@ -573,16 +604,32 @@ function apply(ctx, config) {
     if (holding.length === 0 || holding[0].amount < amount) {
       return `持仓不足！当前持有: ${holding.length ? holding[0].amount : 0} 股。`;
     }
-    const newAmount = holding[0].amount - amount;
+    const currentHolding = holding[0];
+    let existingTotalCost = currentHolding.totalCost;
+    if (!existingTotalCost || existingTotalCost <= 0) {
+      existingTotalCost = Number((currentHolding.amount * currentPrice).toFixed(2));
+      logger.info(`stock.sell: 旧持仓无成本记录，使用当前市价估算: ${currentHolding.amount}股 * ${currentPrice} = ${existingTotalCost}`);
+    }
+    const avgCostPerShare = Number((existingTotalCost / currentHolding.amount).toFixed(2));
+    const soldCost = Number((avgCostPerShare * amount).toFixed(2));
+    const newAmount = currentHolding.amount - amount;
     if (newAmount === 0) {
       await ctx.database.remove("bourse_holding", { userId: visibleUserId, stockId });
     } else {
-      await ctx.database.set("bourse_holding", { userId: visibleUserId, stockId }, { amount: newAmount });
+      const newTotalCost = Number((existingTotalCost - soldCost).toFixed(2));
+      await ctx.database.set("bourse_holding", { userId: visibleUserId, stockId }, {
+        amount: newAmount,
+        totalCost: Math.max(0, newTotalCost)
+        // 确保不为负数
+      });
     }
     const gain = Number((currentPrice * amount).toFixed(2));
-    let freezeMinutes = gain / config.freezeCostPerMinute;
-    if (freezeMinutes < config.minFreezeTime) freezeMinutes = config.minFreezeTime;
-    if (freezeMinutes > config.maxFreezeTime) freezeMinutes = config.maxFreezeTime;
+    let freezeMinutes = 0;
+    if (config.maxFreezeTime > 0) {
+      freezeMinutes = gain / config.freezeCostPerMinute;
+      if (freezeMinutes > config.maxFreezeTime) freezeMinutes = config.maxFreezeTime;
+      if (freezeMinutes < config.minFreezeTime) freezeMinutes = config.minFreezeTime;
+    }
     const freezeMs = freezeMinutes * 60 * 1e3;
     const endTime = new Date(Date.now() + freezeMs);
     await ctx.database.create("bourse_pending", {
@@ -596,6 +643,12 @@ function apply(ctx, config) {
       startTime: /* @__PURE__ */ new Date(),
       endTime
     });
+    if (freezeMinutes === 0) {
+      await processPendingTransactions();
+      return `卖出已完成！
+收益: ${gain.toFixed(2)} ${config.currency}
+资金已到账。`;
+    }
     return `卖出挂单已提交！
 预计收益: ${gain.toFixed(2)} ${config.currency}
 资金冻结: ${freezeMinutes.toFixed(1)}分钟
@@ -605,31 +658,42 @@ function apply(ctx, config) {
     const userId = session.userId;
     const holdings = await ctx.database.get("bourse_holding", { userId });
     const pending = await ctx.database.get("bourse_pending", { userId });
-    let msg = `=== ${session.username} 的股票账户 ===
-`;
+    let holdingData = null;
     if (holdings.length > 0) {
       const h2 = holdings[0];
-      const value = h2.amount * currentPrice;
-      msg += `持仓: ${config.stockName} x${h2.amount} 股
-`;
-      msg += `当前市值: ${value.toFixed(2)} ${config.currency}
-`;
-    } else {
-      msg += `持仓: 无
-`;
-    }
-    if (pending.length > 0) {
-      msg += `
---- 进行中的交易 ---
-`;
-      for (const p of pending) {
-        const timeLeft = Math.max(0, Math.ceil((p.endTime.getTime() - Date.now()) / 1e3));
-        const typeStr = p.type === "buy" ? "买入" : "卖出";
-        msg += `[${typeStr}] ${p.amount}股 | 剩余冻结: ${timeLeft}秒
-`;
-      }
+      const marketValue = Number((h2.amount * currentPrice).toFixed(2));
+      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 profitPercent = hasCostData && totalCost > 0 ? Number((profit / totalCost * 100).toFixed(2)) : null;
+      holdingData = {
+        stockName: config.stockName,
+        amount: h2.amount,
+        currentPrice: Number(currentPrice.toFixed(2)),
+        avgCost: hasCostData ? avgCost : null,
+        // null 表示无成本记录
+        totalCost: hasCostData ? totalCost : null,
+        marketValue,
+        profit,
+        profitPercent
+      };
     }
-    return msg;
+    const pendingData = pending.map((p) => {
+      const timeLeft = Math.max(0, Math.ceil((p.endTime.getTime() - Date.now()) / 1e3));
+      const minutes = Math.floor(timeLeft / 60);
+      const seconds = timeLeft % 60;
+      return {
+        type: p.type === "buy" ? "买入" : "卖出",
+        typeClass: p.type,
+        amount: p.amount,
+        price: Number(p.price.toFixed(2)),
+        cost: Number(p.cost.toFixed(2)),
+        timeLeft: `${minutes}分${seconds}秒`
+      };
+    });
+    const img = await renderHoldingImage(ctx, session.username, holdingData, pendingData, config.currency);
+    return img;
   });
   ctx.command("stock.control <price:number> [hours:number]", "管理员：设置宏观调控目标", { authority: 3 }).action(async ({ session }, price, hours) => {
     if (!price || price <= 0) return "请输入有效的目标价格。";
@@ -691,6 +755,348 @@ function apply(ctx, config) {
     switchKLinePattern("管理员手动");
     return "已切换K线模型。";
   });
+  async function renderHoldingImage(ctx2, username, holding, pending, currency) {
+    const hasCostData = holding && holding.totalCost !== null;
+    const isProfit = hasCostData ? holding.profit >= 0 : true;
+    const profitColor = isProfit ? "#d93025" : "#188038";
+    const profitSign = isProfit ? "+" : "";
+    const profitSectionHtml = hasCostData ? `
+          <div class="profit-section" style="background: ${isProfit ? "rgba(217, 48, 37, 0.08)" : "rgba(24, 128, 56, 0.08)"}">
+            <div class="profit-label">盈亏</div>
+            <div class="profit-value" style="color: ${profitColor}">
+              ${profitSign}${holding.profit.toFixed(2)} ${currency}
+              <span class="profit-percent">(${profitSign}${holding.profitPercent.toFixed(2)}%)</span>
+            </div>
+          </div>
+    ` : `
+          <div class="profit-section no-data" style="background: rgba(128, 128, 128, 0.08)">
+            <div class="profit-label">盈亏</div>
+            <div class="profit-value" style="color: #888">
+              暂无成本记录
+              <span class="profit-hint">（新交易后将自动记录）</span>
+            </div>
+          </div>
+    `;
+    const holdingHtml = holding ? `
+      <div class="section">
+        <div class="section-title">📈 持仓详情</div>
+        <div class="stock-card">
+          <div class="stock-header">
+            <div class="stock-name">${holding.stockName}</div>
+            <div class="stock-amount">${holding.amount} 股</div>
+          </div>
+          <div class="stock-body">
+            <div class="stat-row">
+              <div class="stat-item">
+                <div class="stat-label">现价</div>
+                <div class="stat-value">${holding.currentPrice.toFixed(2)}</div>
+              </div>
+              <div class="stat-item">
+                <div class="stat-label">成本价</div>
+                <div class="stat-value">${hasCostData ? holding.avgCost.toFixed(2) : "--"}</div>
+              </div>
+            </div>
+            <div class="stat-row">
+              <div class="stat-item">
+                <div class="stat-label">持仓成本</div>
+                <div class="stat-value">${hasCostData ? holding.totalCost.toFixed(2) : "--"}</div>
+              </div>
+              <div class="stat-item">
+                <div class="stat-label">市值</div>
+                <div class="stat-value highlight">${holding.marketValue.toFixed(2)}</div>
+              </div>
+            </div>
+          </div>
+          ${profitSectionHtml}
+        </div>
+      </div>
+    ` : `
+      <div class="section">
+        <div class="section-title">📈 持仓详情</div>
+        <div class="empty-state">
+          <div class="empty-icon">📭</div>
+          <div class="empty-text">暂无持仓</div>
+        </div>
+      </div>
+    `;
+    const pendingHtml = pending.length > 0 ? `
+      <div class="section">
+        <div class="section-title">⏳ 进行中的交易</div>
+        ${pending.map((p) => `
+          <div class="pending-item ${p.typeClass}">
+            <div class="pending-left">
+              <span class="pending-type ${p.typeClass}">${p.type}</span>
+              <span class="pending-amount">${p.amount} 股</span>
+            </div>
+            <div class="pending-center">
+              <span class="pending-price">单价 ${p.price.toFixed(2)}</span>
+              <span class="pending-cost">总额 ${p.cost.toFixed(2)}</span>
+            </div>
+            <div class="pending-right">
+              <span class="pending-time">⏱ ${p.timeLeft}</span>
+            </div>
+          </div>
+        `).join("")}
+      </div>
+    ` : "";
+    const html = `
+    <html>
+    <head>
+      <style>
+        body { 
+          margin: 0; 
+          padding: 20px; 
+          font-family: 'Segoe UI', 'Microsoft YaHei', Roboto, sans-serif; 
+          background: linear-gradient(135deg, #667eea 0%, #764ba2 100%); 
+          width: 450px; 
+          box-sizing: border-box; 
+        }
+        .card { 
+          background: white; 
+          padding: 25px; 
+          border-radius: 20px; 
+          box-shadow: 0 20px 40px rgba(0,0,0,0.15); 
+        }
+        .header { 
+          display: flex; 
+          align-items: center; 
+          gap: 12px;
+          margin-bottom: 20px; 
+          padding-bottom: 15px;
+          border-bottom: 2px solid #f0f2f5;
+        }
+        .avatar {
+          width: 48px;
+          height: 48px;
+          background: linear-gradient(135deg, #667eea 0%, #764ba2 100%);
+          border-radius: 50%;
+          display: flex;
+          align-items: center;
+          justify-content: center;
+          color: white;
+          font-size: 20px;
+          font-weight: bold;
+        }
+        .user-info {
+          flex: 1;
+        }
+        .username { 
+          font-size: 22px; 
+          font-weight: 700; 
+          color: #1a1a1a; 
+        }
+        .account-label {
+          font-size: 13px;
+          color: #888;
+          margin-top: 2px;
+        }
+        .section {
+          margin-bottom: 20px;
+        }
+        .section:last-child {
+          margin-bottom: 0;
+        }
+        .section-title {
+          font-size: 14px;
+          font-weight: 600;
+          color: #666;
+          margin-bottom: 12px;
+          text-transform: uppercase;
+          letter-spacing: 0.5px;
+        }
+        .stock-card {
+          background: #f8f9fc;
+          border-radius: 16px;
+          overflow: hidden;
+        }
+        .stock-header {
+          display: flex;
+          justify-content: space-between;
+          align-items: center;
+          padding: 16px 20px;
+          background: linear-gradient(135deg, #2c3e50 0%, #34495e 100%);
+          color: white;
+        }
+        .stock-name {
+          font-size: 18px;
+          font-weight: 700;
+        }
+        .stock-amount {
+          font-size: 16px;
+          font-weight: 600;
+          background: rgba(255,255,255,0.2);
+          padding: 4px 12px;
+          border-radius: 20px;
+        }
+        .stock-body {
+          padding: 16px 20px;
+        }
+        .stat-row {
+          display: flex;
+          justify-content: space-between;
+          margin-bottom: 12px;
+        }
+        .stat-row:last-child {
+          margin-bottom: 0;
+        }
+        .stat-item {
+          text-align: center;
+          flex: 1;
+        }
+        .stat-label {
+          font-size: 12px;
+          color: #888;
+          margin-bottom: 4px;
+        }
+        .stat-value {
+          font-size: 18px;
+          font-weight: 700;
+          color: #333;
+        }
+        .stat-value.highlight {
+          color: #667eea;
+        }
+        .profit-section {
+          display: flex;
+          justify-content: space-between;
+          align-items: center;
+          padding: 16px 20px;
+          border-top: 1px solid #eee;
+        }
+        .profit-label {
+          font-size: 14px;
+          font-weight: 600;
+          color: #666;
+        }
+        .profit-value {
+          font-size: 22px;
+          font-weight: 800;
+        }
+        .profit-percent {
+          font-size: 14px;
+          font-weight: 600;
+          margin-left: 6px;
+        }
+        .profit-hint {
+          font-size: 12px;
+          font-weight: 400;
+          display: block;
+          margin-top: 4px;
+        }
+        .profit-section.no-data .profit-value {
+          font-size: 16px;
+          font-weight: 600;
+        }
+        .empty-state {
+          background: #f8f9fc;
+          border-radius: 16px;
+          padding: 40px 20px;
+          text-align: center;
+        }
+        .empty-icon {
+          font-size: 48px;
+          margin-bottom: 12px;
+        }
+        .empty-text {
+          font-size: 16px;
+          color: #888;
+        }
+        .pending-item {
+          display: flex;
+          justify-content: space-between;
+          align-items: center;
+          background: #f8f9fc;
+          border-radius: 12px;
+          padding: 14px 16px;
+          margin-bottom: 10px;
+          border-left: 4px solid #ccc;
+        }
+        .pending-item.buy {
+          border-left-color: #d93025;
+        }
+        .pending-item.sell {
+          border-left-color: #188038;
+        }
+        .pending-item:last-child {
+          margin-bottom: 0;
+        }
+        .pending-left {
+          display: flex;
+          align-items: center;
+          gap: 10px;
+        }
+        .pending-type {
+          font-size: 12px;
+          font-weight: 700;
+          padding: 3px 8px;
+          border-radius: 6px;
+          color: white;
+        }
+        .pending-type.buy {
+          background: #d93025;
+        }
+        .pending-type.sell {
+          background: #188038;
+        }
+        .pending-amount {
+          font-size: 15px;
+          font-weight: 600;
+          color: #333;
+        }
+        .pending-center {
+          display: flex;
+          flex-direction: column;
+          align-items: center;
+          gap: 2px;
+        }
+        .pending-price, .pending-cost {
+          font-size: 12px;
+          color: #666;
+        }
+        .pending-right {
+          text-align: right;
+        }
+        .pending-time {
+          font-size: 13px;
+          font-weight: 600;
+          color: #f39c12;
+        }
+        .footer {
+          margin-top: 20px;
+          padding-top: 15px;
+          border-top: 1px solid #f0f2f5;
+          text-align: center;
+          font-size: 11px;
+          color: #bbb;
+        }
+      </style>
+    </head>
+    <body>
+      <div class="card">
+        <div class="header">
+          <div class="avatar">${username.charAt(0).toUpperCase()}</div>
+          <div class="user-info">
+            <div class="username">${username}</div>
+            <div class="account-label">股票账户</div>
+          </div>
+        </div>
+        ${holdingHtml}
+        ${pendingHtml}
+        <div class="footer">
+          数据更新于 ${(/* @__PURE__ */ new Date()).toLocaleString("zh-CN")}
+        </div>
+      </div>
+    </body>
+    </html>
+    `;
+    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(renderHoldingImage, "renderHoldingImage");
   async function renderStockImage(ctx2, data, name2, current, high, low) {
     if (data.length < 2) return "数据不足，无法绘制走势图。";
     const startPrice = data[0].price;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "koishi-plugin-monetary-bourse",
-  "version": "1.0.0-alpha.2",
+  "version": "1.1.0-alpha.3",
   "main": "lib/index.js",
   "typings": "lib/index.d.ts",
   "files": [

package/readme.md

@@ -4,23 +4,49 @@
 
 为 Koishi 提供基于 `monetary` 通用货币系统的股票交易所功能。
 
-本插件模拟了一个具备自动宏观调控、周期性波动和资金冻结机制的简易股票市场。用户可以使用机器人通用的货币（如信用点）进行股票买卖、炒股理财。
+本插件模拟了一个具备**自动宏观调控**、**丰富日内走势形态**和**资金冻结机制**的拟真股票市场。用户可以使用机器人通用的货币（如信用点）进行股票买卖、炒股理财。
 
 ## ✨ 特性
 
-- **拟真股市算法**：包含长期趋势、随机波动和周期性波浪算法，模拟真实的股价走势。
-- **可视化K线图**：使用 Puppeteer 渲染精美的实时、日线、周线走势图。
-- **资金冻结机制**：交易并非即时到账，根据交易金额计算冻结时间，增加博弈乐趣。
-- **宏观调控**：管理员可以手动干预股价走势，设定目标价格，系统将平滑过渡到目标价。
-- **银行联动**：支持与 `koishi-plugin-monetary-bank` 联动，若现金不足可自动扣除银行活期存款（需安装对应插件）。
-- **休市机制**：支持设置每日开市/休市时间，周末自动休市。
+- **📈 拟真 K 线引擎**：
+  - 内置 **12 种日内走势形态**（如：早盘冲高回落、V型反转、尾盘拉升、M顶/W底等）。
+  - 走势不再是单纯的随机波动，每天自动或随机切换不同的操盘剧本，大幅提升观察乐趣。
+  - 结合 **周级波浪** 与 **宏观趋势**，模拟真实市场的多周期叠加效应。
+- **📊 精美 K 线渲染**：使用 Puppeteer 渲染实时/日/周线图，Alpha 2 版本优化了坐标轴标签算法，防止文字重叠，观感更佳。
+- **❄️ 资金冻结机制**：交易采用 T+0 但资金/股票非即时到账模式（根据金额计算冻结时间），增加博弈深度。
+- **🏦 银行联动**：支持与 `koishi-plugin-monetary-bank` 联动，现金不足时自动扣除银行活期存款。
+- **🕹️ 宏观调控**：管理员可手动干预股价目标，或强制切换当天的 K 线剧本。
+
+## 更新记录
+
+- **Alpha.3**：
+  - 新增：持仓盈亏计算与持仓成本追踪（`totalCost` 字段），在 `stock.my` 中展示成本价、持仓成本、当前市值、盈亏金额与盈亏百分比。
+  - 新增：持仓信息 HTML 渲染（`renderHoldingImage`），使用 Puppeteer 输出美观的持仓卡片图像，包含进行中的挂单列表和盈亏高亮显示。
+  - 修复：统一所有金额与价格的显示与存储为保留两位小数，避免浮点精度累积导致的计算偏差（涉及 `currentPrice`、历史记录、支付、扣款、银行活期处理等）。
+  - 修复：兼容旧版持仓数据（旧记录没有 `totalCost`）——合并新旧持仓时使用合理估算策略以避免成本被稀释：
+    - 若旧持仓无成本记录，新买入时以交易单价对旧持仓进行估算（保证合并后平均成本合理）；
+    - 卖出时若无成本记录则使用当前市价估算以避免错误盈亏展示。
+  - 修复：当 `maxFreezeTime = 0`（表示无冻结）时，交易将立即完成并触发即时处理（不再长期挂起）。
+  - 修复：支付、现金变更及银行活期扣除流程中均使用两位小数保留，避免因浮点运算导致余额不一致。
+
+- **1.0.0**：
+  - 修复：解决长期运行时触发的 `TypeError: cannot modify primary key`（更新 `bourse_state` 时排除主键字段，仅按条件写入非主键字段），提高数据库兼容性与稳定性。
+
+- **Alpha.2**：
+  - 在 Alpha.1 的基础上，扩展并完善了 K 线引擎，新增 12 种日内走势剧本、周级波浪叠加以及坐标轴标签冲突修复等视觉与体验改进。
+  - 该版本引入了更丰富的日内走势（例如早盘冲高回落、V 型反转、尾盘拉升、M 顶/W 底等），并改进了 Puppeteer 渲染逻辑以减少横轴标签重叠。
+  - 致命问题说明：长期运行时可能触发 `TypeError: cannot modify primary key`（根因：更新持久化 `bourse_state` 时不小心将主键字段包含在更新负载中，某些数据库实现会拒绝修改主键），该问题在后续修复版本中已处理，请在生产环境中尽量升级至稳定版本。
+
+- **Alpha.1**：
+  - 发布基础功能：买卖、资金冻结、挂单、历史行情存储以及 `stock` 家族指令（`stock` / `stock.buy` / `stock.sell` / `stock.my`）。
+  - 支持与 `monetary` 与 `monetary-bank` 的基本联动，提供最小可用的股票交易所模拟能力。
 
 ## 📦 依赖
 
 本插件需要以下服务：
 - `database`: 用于存储持仓、历史行情和挂单记录。
 - `puppeteer`: 用于渲染股市行情图。
-- `monetary`: (可选) 用于获取用户货币余额，实际上本插件直接操作 `monetary` 数据库表。
+- `monetary`: (可选) 用于获取用户货币余额（本插件直接操作数据库表，monetary 插件需安装以建立表结构）。
 
 ## 🔧 配置项
 
@@ -38,7 +64,6 @@
 - **marketStatus**: 股市总开关，可选 `open` (强制开启)、`close` (强制关闭)、`auto` (自动按时间)。
 
 ### 冻结机制
-为了防止高频刷钱，交易后资金/股票需要冻结一段时间。
 - **freezeCostPerMinute**: 每多少货币金额计为1分钟冻结时间（默认 `100`）。
 - **minFreezeTime**: 最小冻结时间（分钟，默认 `10`）。
 - **maxFreezeTime**: 最大冻结时间（分钟，默认 `1440` 即24小时）。
@@ -60,7 +85,7 @@
 - **`stock.buy <amount>`**
   - 买入股票。
   - 参数 `amount`: 购买股数（整数）。
-  - 说明：扣除现金（或银行活期），股票将在冻结时间结束后到账。
+  - 说明：扣除现金（优先）或银行活期，股票将在冻结时间结束后到账。
 
 - **`stock.sell <amount>`**
   - 卖出股票。
@@ -78,14 +103,23 @@
   - 说明：强行引导股价在指定时间内向目标价格移动。
   - 示例：`stock.control 5000 12` (在12小时内让股价涨/跌到5000)。
 
+- **`stock.pattern`** *(Alpha 2 新增)*
+  - 强制切换 K 线模型。
+  - 说明：手动随机切换当前使用的日内走势剧本（如从“单边下跌”切换为“尾盘拉升”）。
+
 - **`bourse.admin.market <status>`**
   - 设置股市开关状态。
   - 参数 `status`: `open` (开启), `close` (关闭), `auto` (自动)。
+  - 说明：手动开市时会自动重置并切换一个新的日内 K 线形态。
 
 ## 💡 常见问题
 
 **Q: 为什么买了股票没有立刻到账？**
-A: 本插件设计了 T+N 机制（基于金额的动态冻结）。使用 `stock.buy` 后，股票会进入“冻结中”状态，使用 `stock.my` 可以看到剩余解冻时间。卖出股票同理，资金需等待解冻。
+A: 本插件设计了基于交易金额的动态冻结机制。交易额越大，冻结时间越长（可配置）。请使用 `stock.my` 查看剩余解冻时间。
 
 **Q: 股价是如何波动的？**
-A: 股价由三部分组成：长期趋势（宏观调控决定）、随机波动（模拟市场噪音）和正弦波浪（模拟周期性涨跌）。
+A: 股价由四部分叠加而成：
+1. **宏观趋势**：根据自动或手动的目标价格计算的线性趋势。
+2. **周级波浪**：7天为一个大周期的正弦复合波浪。
+3. **日内形态**：每天随机从 12 种剧本中选择多种（如 V 型、倒 V 型、阶梯上涨等）。
+4. **随机噪音**：微小的随机波动。