npm - botrun-horse - Versions diffs - 2.29.2 → 2.30.0 - Mend

botrun-horse 2.29.2 → 2.30.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (574) hide show

package/botrun-c/admin/botrun-timeseries-074xGzIKWyfKTBt1NMIj9lxi5mO2-1765235323090.html ADDED Viewed

@@ -0,0 +1,161 @@
+<!DOCTYPE html>
+<html lang="zh-TW">
+<head>
+  <meta charset="UTF-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1.0">
+  <title>時間序列分析 - baby.ff.74@gmail.com</title>
+  <script src="https://cdn.jsdelivr.net/npm/chart.js"></script>
+  <style>
+    * { margin: 0; padding: 0; box-sizing: border-box; }
+    body {
+      font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto;
+      background: #f5f7fa;
+      padding: 20px;
+    }
+    .container {
+      max-width: 1200px;
+      margin: 0 auto;
+      background: white;
+      border-radius: 12px;
+      padding: 30px;
+      box-shadow: 0 4px 12px rgba(0,0,0,0.1);
+    }
+    h1 {
+      color: #333;
+      margin-bottom: 10px;
+    }
+    .subtitle {
+      color: #666;
+      margin-bottom: 30px;
+    }
+    .stats {
+      display: grid;
+      grid-template-columns: repeat(auto-fit, minmax(200px, 1fr));
+      gap: 20px;
+      margin-bottom: 40px;
+    }
+    .stat-box {
+      background: linear-gradient(135deg, #667eea 0%, #764ba2 100%);
+      color: white;
+      padding: 20px;
+      border-radius: 8px;
+      text-align: center;
+    }
+    .stat-label {
+      font-size: 0.9em;
+      opacity: 0.9;
+      margin-bottom: 8px;
+    }
+    .stat-value {
+      font-size: 2em;
+      font-weight: bold;
+    }
+    .charts {
+      display: grid;
+      grid-template-columns: repeat(auto-fit, minmax(500px, 1fr));
+      gap: 30px;
+    }
+    .chart-container {
+      border: 1px solid #eee;
+      padding: 20px;
+      border-radius: 8px;
+    }
+    .chart-title {
+      font-weight: bold;
+      margin-bottom: 15px;
+      color: #333;
+    }
+    .chart-wrapper {
+      position: relative;
+      height: 300px;
+    }
+  </style>
+</head>
+<body>
+  <div class="container">
+    <h1>📊 時間序列分析</h1>
+    <p class="subtitle">使用者: baby.ff.74@gmail.com (074xGzIKWyfKTBt1NMIj9lxi5mO2)</p>
+    <div class="stats">
+      <div class="stat-box">
+        <div class="stat-label">總 Token 數</div>
+        <div class="stat-value">0.00M</div>
+      </div>
+      <div class="stat-box">
+        <div class="stat-label">總請求數</div>
+        <div class="stat-value">0</div>
+      </div>
+      <div class="stat-box">
+        <div class="stat-label">分析期間</div>
+        <div class="stat-value">7 天</div>
+      </div>
+      <div class="stat-box">
+        <div class="stat-label">峰值時段</div>
+        <div class="stat-value">0:00</div>
+      </div>
+    </div>
+    <div class="charts">
+      <div class="chart-container">
+        <div class="chart-title">⏰ 按小時分佈</div>
+        <div class="chart-wrapper">
+          <canvas id="hourlyChart"></canvas>
+        </div>
+      </div>
+      <div class="chart-container">
+        <div class="chart-title">📅 最近 7 天日均使用量</div>
+        <div class="chart-wrapper">
+          <canvas id="dailyChart"></canvas>
+        </div>
+      </div>
+    </div>
+  </div>
+  <script>
+    const ctx1 = document.getElementById('hourlyChart').getContext('2d');
+    new Chart(ctx1, {
+      type: 'bar',
+      data: {
+        labels: ["0:00","1:00","2:00","3:00","4:00","5:00","6:00","7:00","8:00","9:00","10:00","11:00","12:00","13:00","14:00","15:00","16:00","17:00","18:00","19:00","20:00","21:00","22:00","23:00"],
+        datasets: [{
+          label: 'Token 數',
+          data: [0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0],
+          backgroundColor: 'rgba(102, 126, 234, 0.8)',
+          borderColor: 'rgba(102, 126, 234, 1)',
+          borderWidth: 1
+        }]
+      },
+      options: {
+        responsive: true,
+        maintainAspectRatio: false,
+        plugins: { legend: { display: false } },
+        scales: { y: { beginAtZero: true } }
+      }
+    });
+    const ctx2 = document.getElementById('dailyChart').getContext('2d');
+    new Chart(ctx2, {
+      type: 'line',
+      data: {
+        labels: ["2025-12-02","2025-12-03","2025-12-04","2025-12-05","2025-12-06","2025-12-07","2025-12-08"],
+        datasets: [{
+          label: 'Token 數',
+          data: [0,0,0,0,0,0,0],
+          borderColor: 'rgba(54, 162, 235, 1)',
+          backgroundColor: 'rgba(54, 162, 235, 0.1)',
+          tension: 0.4,
+          fill: true,
+          borderWidth: 2
+        }]
+      },
+      options: {
+        responsive: true,
+        maintainAspectRatio: false,
+        plugins: { legend: { display: false } },
+        scales: { y: { beginAtZero: true } }
+      }
+    });
+  </script>
+</body>
+</html>

package/botrun-c/admin/check-billing.ts ADDED Viewed

@@ -0,0 +1,48 @@
+#!/usr/bin/env tsx
+/**
+ * 檢查 billing-records collection 的真實數據
+ */
+import { initializeFirebase, getFirestore } from './lib/firebase.js';
+initializeFirebase();
+const db = getFirestore();
+async function checkBilling() {
+  // 檢查 billing-records 有多少筆記錄
+  const snapshot = await db.collection('billing-records').limit(10).get();
+  console.log('\n📊 billing-records collection 狀態:');
+  console.log('   找到 ' + snapshot.size + ' 筆記錄（限制 10 筆）\n');
+  if (snapshot.size > 0) {
+    console.log('📋 前 10 筆記錄結構:');
+    snapshot.forEach(doc => {
+      const data = doc.data();
+      const userId = data.userId ? data.userId.substring(0, 15) + '...' : 'N/A';
+      console.log('   - userId: ' + userId);
+      console.log('     totalTokens: ' + data.totalTokens + ', inputTokens: ' + data.inputTokens + ', outputTokens: ' + data.outputTokens);
+      console.log('     costUSD: ' + data.costUSD + ', model: ' + data.model);
+      const ts = data.timestamp && data.timestamp.toDate ? data.timestamp.toDate() : 'N/A';
+      console.log('     timestamp: ' + ts);
+      console.log('');
+    });
+  }
+  // 計算總量
+  const allDocs = await db.collection('billing-records').get();
+  console.log('📈 billing-records 總計: ' + allDocs.size + ' 筆記錄');
+  let totalTokens = 0;
+  let totalCost = 0;
+  allDocs.forEach(doc => {
+    const data = doc.data();
+    totalTokens += data.totalTokens || 0;
+    totalCost += data.costUSD || 0;
+  });
+  console.log('   總 Token 數: ' + (totalTokens / 1000000).toFixed(2) + 'M (' + totalTokens.toLocaleString() + ')');
+  console.log('   總成本 (API 記錄): $' + totalCost.toFixed(4));
+  console.log('   基於 1M=$5 計算成本: $' + ((totalTokens / 1000000) * 5).toFixed(2) + '\n');
+}
+checkBilling().catch(console.error);

package/botrun-c/admin/count-all-users.ts ADDED Viewed

@@ -0,0 +1,65 @@
+#!/usr/bin/env tsx
+/**
+ * 查詢真實資料庫中的所有使用者
+ */
+import { initializeFirebase, getAuth, getFirestore } from './lib/firebase.js';
+async function countAllUsers() {
+  initializeFirebase();
+  const auth = getAuth();
+  const db = getFirestore();
+  console.log('📊 查詢真實 Firebase 資料庫中的所有使用者...\n');
+  let totalUsers = 0;
+  let pageToken = undefined;
+  const users = [];
+  do {
+    const result = await auth.listUsers(1000, pageToken);
+    totalUsers += result.users.length;
+    users.push(...result.users);
+    console.log(`⏳ 已載入 ${totalUsers} 位使用者...`);
+    pageToken = result.pageToken;
+  } while (pageToken);
+  console.log(`\n✅ Firebase Auth 中總共有 ${totalUsers} 位使用者\n`);
+  // 查詢 Firestore users collection
+  console.log('📋 查詢 Firestore users collection...');
+  const usersSnapshot = await db.collection('users').get();
+  console.log(`✅ Firestore users: ${usersSnapshot.size} 筆\n`);
+  // 查詢訂閱資訊
+  console.log('📋 查詢 Firestore user_subscriptions...');
+  const subsSnapshot = await db.collection('user_subscriptions').get();
+  console.log(`✅ Firestore subscriptions: ${subsSnapshot.size} 筆\n`);
+  // 查詢 Rate Limit
+  console.log('📋 查詢 rate_limit_counters...');
+  const countersSnapshot = await db.collection('rate_limit_counters').get();
+  console.log(`✅ rate_limit_counters: ${countersSnapshot.size} 筆\n`);
+  // 列出所有使用者（前 20 個）
+  console.log('👥 前 20 位使用者：');
+  console.log('─'.repeat(80));
+  for (let i = 0; i < Math.min(20, users.length); i++) {
+    const user = users[i];
+    const subDoc = await db.collection('user_subscriptions').doc(user.uid).get();
+    const plan = subDoc.exists ? (subDoc.data()?.plan || 'Lite') : 'N/A';
+    console.log(`${i + 1}. ${user.email || '(無 email)'} [${plan}]`);
+  }
+  console.log('─'.repeat(80));
+  console.log(`\n📊 資料庫統計摘要：`);
+  console.log(`   Firebase Auth 使用者: ${totalUsers}`);
+  console.log(`   Firestore users: ${usersSnapshot.size}`);
+  console.log(`   訂閱記錄: ${subsSnapshot.size}`);
+  console.log(`   Rate Limit 計數器: ${countersSnapshot.size}\n`);
+}
+countAllUsers().catch(error => {
+  console.error('❌ 錯誤：', error.message);
+  process.exit(1);
+});

package/botrun-c/admin/generate-analytics-report.ts ADDED Viewed

@@ -0,0 +1,188 @@
+#!/usr/bin/env tsx
+/**
+ * 完整分析報告生成工具
+ * 生成過去 N 天的完整使用報告（CSV + HTML）
+ */
+import { initializeFirebase, getFirestore, getAuth } from './lib/firebase.js';
+import { TimeSeriesAnalyzer } from './lib/analyzers/TimeSeriesAnalyzer.js';
+import { BillingAnalyticsService } from './lib/analyzers/BillingAnalyticsService.js';
+import { CsvExporter } from './lib/analyzers/CsvExporter.js';
+import { HtmlChartGenerator } from './lib/analyzers/HtmlChartGenerator.js';
+import { writeFileSync, execSync } from 'fs';
+import { join } from 'path';
+async function generateAnalyticsReport(days: number = 7) {
+  console.log('🚀 開始生成過去 ' + days + ' 天的完整分析報告...\n');
+  try {
+    // 初始化 Firebase
+    initializeFirebase();
+    const db = getFirestore();
+    const auth = getAuth();
+    // 查詢所有使用者（分頁查詢）
+    console.log('📋 查詢所有使用者...');
+    const allUsers = [];
+    let pageToken = undefined;
+    do {
+      const result = await auth.listUsers(1000, pageToken);
+      allUsers.push(...result.users);
+      console.log(`⏳ 已載入 ${allUsers.length} 位使用者...`);
+      pageToken = result.pageToken;
+    } while (pageToken);
+    if (allUsers.length === 0) {
+      console.log('❌ 沒有找到任何使用者');
+      return;
+    }
+    console.log(`\n✅ 找到 ${allUsers.length} 位使用者\n`);
+    const users = allUsers;
+    // 查詢使用者的訂閱資訊
+    console.log('📊 查詢使用者訂閱資訊...');
+    const userDataList = [];
+    for (const user of users) {
+      try {
+        const userDoc = await db.collection('users').doc(user.uid).get();
+        const subDoc = await db.collection('user_subscriptions').doc(user.uid).get();
+        userDataList.push({
+          id: user.uid,
+          email: user.email || 'Unknown',
+          plan: subDoc.exists ? (subDoc.data()?.plan || 'Lite') : 'Lite'
+        });
+      } catch (error) {
+        console.warn(`⚠️  無法查詢使用者 ${user.uid} 的資訊`);
+      }
+    }
+    console.log(`✅ 查詢完成\n`);
+    // 生成時間序列分析
+    console.log('⏱️  生成時間序列分析...');
+    const timeSeriesAnalyzer = new TimeSeriesAnalyzer();
+    const analyses = await timeSeriesAnalyzer.analyzeMultipleUsers(
+      userDataList,
+      days
+    );
+    console.log(`✅ 分析完成：${analyses.length} 位使用者\n`);
+    // 生成成本分析報告
+    console.log('💰 生成成本分析報告...');
+    const billingService = new BillingAnalyticsService();
+    const billingReport = await billingService.generateBillingReport(userDataList, days);
+    console.log(`✅ 成本分析完成\n`);
+    // 生成 CSV 報告
+    console.log('📄 生成 CSV 報告...');
+    const csvExporter = new CsvExporter();
+    const billingCsv = csvExporter.exportBillingReport(billingReport);
+    const billingCsvPath = join(process.cwd(), `botrun-billing-report-${Date.now()}.csv`);
+    writeFileSync(billingCsvPath, billingCsv);
+    console.log(`✅ CSV 報告已儲存：${billingCsvPath}\n`);
+    // 生成 HTML 儀表板
+    console.log('🎨 生成 HTML 儀表板...');
+    const htmlGenerator = new HtmlChartGenerator();
+    const dashboardHtml = htmlGenerator.generateBillingDashboard(billingReport);
+    const dashboardPath = join(process.cwd(), `botrun-dashboard-${Date.now()}.html`);
+    writeFileSync(dashboardPath, dashboardHtml);
+    console.log(`✅ HTML 儀表板已儲存：${dashboardPath}\n`);
+    // 生成時間序列 HTML（第一個使用者）
+    if (analyses.length > 0) {
+      console.log('📊 生成時間序列 HTML 頁面...');
+      const timeSeriesHtml = htmlGenerator.generateTimeSeriesPage(analyses[0]);
+      const timeSeriesPath = join(process.cwd(), `botrun-timeseries-${analyses[0].userId}-${Date.now()}.html`);
+      writeFileSync(timeSeriesPath, timeSeriesHtml);
+      console.log(`✅ 時間序列頁面已儲存：${timeSeriesPath}\n`);
+    }
+    // 列印摘要資訊
+    console.log('\n════════════════════════════════════════════════════════════');
+    console.log('📈 分析報告摘要');
+    console.log('════════════════════════════════════════════════════════════\n');
+    console.log('📊 成本分析報告：');
+    console.log(`   總使用者數: ${billingReport.totalUsers}`);
+    console.log(`   總 Token 數: ${(billingReport.totalTokensAcrossUsers / 1000000).toFixed(2)}M`);
+    console.log(`   總成本: $${billingReport.totalCostAcrossUsers.toFixed(2)}`);
+    console.log(`   平均每使用者成本: $${(billingReport.totalCostAcrossUsers / billingReport.totalUsers).toFixed(2)}\n`);
+    console.log('🏆 成本最高的 5 位使用者：');
+    billingReport.topSpenders.slice(0, 5).forEach((user, index) => {
+      console.log(`   ${index + 1}. ${user.email}: $${user.estimatedMonthlyCost.toFixed(2)}/月`);
+    });
+    console.log('');
+    console.log('📦 按方案分佈：');
+    billingReport.costBreakdown.forEach(breakdown => {
+      console.log(`   ${breakdown.plan}: ${breakdown.userCount} 位使用者, $${breakdown.totalCost.toFixed(2)} (${breakdown.percentage.toFixed(1)}%)`);
+    });
+    console.log('');
+    if (analyses.length > 0) {
+      const firstAnalysis = analyses[0];
+      console.log(`📅 時間序列分析（${firstAnalysis.email}）：`);
+      console.log(`   總 Token 數: ${(firstAnalysis.totalTokens / 1000000).toFixed(2)}M`);
+      console.log(`   總請求數: ${firstAnalysis.totalRequests}`);
+      console.log(`   峰值時段: ${firstAnalysis.peakHour}:00`);
+      console.log(`   峰值日期: ${firstAnalysis.peakDay}\n`);
+      console.log('⏰ 按小時使用量統計（前 5 個高峰）：');
+      const topHours = firstAnalysis.hourly.sort((a, b) => b.tokens - a.tokens).slice(0, 5);
+      if (topHours.length > 0) {
+        topHours.forEach((hour, index) => {
+          console.log(`   ${index + 1}. ${hour.hour}:00 - ${(hour.tokens / 1000000).toFixed(4)}M Token (${hour.percentage}%)`);
+        });
+      } else {
+        console.log('   ⚠️  沒有可用的小時統計資料');
+      }
+      console.log('');
+    }
+    console.log('════════════════════════════════════════════════════════════');
+    console.log('\n✅ 報告生成完成！');
+    console.log(`📂 檔案位置：`);
+    console.log(`   • CSV 報告: ${billingCsvPath}`);
+    console.log(`   • 儀表板: ${dashboardPath}`);
+    if (analyses.length > 0) {
+      console.log(`   • 時間序列頁面: botrun-timeseries-*.html`);
+    }
+    console.log('\n💡 提示：使用 open 命令開啟 HTML 檔案查看視覺化報告');
+  } catch (error: any) {
+    console.error('❌ 錯誤：', error.message);
+    if (error.code === 'PERMISSION_DENIED') {
+      console.error('\n⚠️  Firebase 認證失敗');
+      console.error('   請確保設定了 GOOGLE_APPLICATION_CREDENTIALS 環境變數');
+      console.error('   或使用 firebase login 進行登入');
+    }
+    console.error(error.stack);
+    process.exit(1);
+  }
+}
+// 解析命令列參數
+const days = parseInt(process.argv[2] || '7', 10);
+if (isNaN(days) || days < 1) {
+  console.error('❌ 無效的天數參數');
+  console.error('用法: tsx generate-analytics-report.ts [days]');
+  console.error('示例: tsx generate-analytics-report.ts 7');
+  process.exit(1);
+}
+// 執行
+generateAnalyticsReport(days).catch(error => {
+  console.error('❌ 未捕獲的錯誤：', error);
+  process.exit(1);
+});

package/botrun-c/admin/jest.config.ts ADDED Viewed

@@ -0,0 +1,43 @@
+import type { Config } from 'jest';
+const config: Config = {
+  displayName: 'admin',
+  preset: 'ts-jest',
+  testEnvironment: 'node',
+  rootDir: '.',
+  testMatch: ['**/__tests__/**/*.test.ts'],
+  moduleNameMapper: {
+    '^(\\.{1,2}/.*)\\.js$': '$1',
+  },
+  // 允許匯入 API 層的檔案（monorepo 跨目錄）
+  testPathIgnorePatterns: ['/node_modules/', '/dist/'],
+  transform: {
+    '^.+\\.tsx?$': [
+      'ts-jest',
+      {
+        useESM: true,
+        tsconfig: {
+          module: 'esnext',
+          target: 'es2020',
+        },
+      },
+    ],
+  },
+  extensionsToTreatAsEsm: ['.ts'],
+  collectCoverageFrom: [
+    'lib/**/*.ts',
+    '!lib/**/*.test.ts',
+    '!lib/**/__tests__/**',
+    '!lib/**/index.ts',
+  ],
+  coverageThreshold: {
+    global: {
+      branches: 0,
+      functions: 0,
+      lines: 0,
+      statements: 0,
+    },
+  },
+};
+export default config;