@cablate/banini-tracker 2.0.6 → 2.0.8

package/dist/db.d.ts

@@ -0,0 +1,3 @@
+import Database from 'better-sqlite3';
+export declare function getDb(): Database.Database;
+export declare function closeDb(): void;

package/dist/db.js

@@ -0,0 +1,63 @@
+import Database from 'better-sqlite3';
+import { join } from 'path';
+import { mkdirSync } from 'fs';
+import { homedir } from 'os';
+const DATA_DIR = process.env.DATA_DIR || join(homedir(), '.banini-tracker');
+let db = null;
+export function getDb() {
+    if (db)
+        return db;
+    mkdirSync(DATA_DIR, { recursive: true });
+    const dbPath = join(DATA_DIR, 'banini.db');
+    const instance = new Database(dbPath);
+    instance.pragma('journal_mode = WAL');
+    instance.pragma('foreign_keys = ON');
+    migrate(instance);
+    // 只在 migrate 成功後才設值
+    db = instance;
+    return db;
+}
+function migrate(db) {
+    db.exec(`
+    CREATE TABLE IF NOT EXISTS predictions (
+      id INTEGER PRIMARY KEY AUTOINCREMENT,
+      post_id TEXT NOT NULL,
+      post_url TEXT,
+      symbol_name TEXT NOT NULL,
+      symbol_code TEXT,
+      symbol_type TEXT NOT NULL,
+      her_action TEXT NOT NULL,
+      reverse_view TEXT NOT NULL,
+      confidence TEXT NOT NULL,
+      reasoning TEXT,
+      base_price REAL,
+      created_at TEXT NOT NULL,
+      recorded_at TEXT NOT NULL,
+      status TEXT NOT NULL DEFAULT 'tracking',
+      completed_at TEXT,
+      next_prediction_id INTEGER REFERENCES predictions(id),
+      UNIQUE(post_id, symbol_name)
+    );
+
+    CREATE TABLE IF NOT EXISTS price_snapshots (
+      id INTEGER PRIMARY KEY AUTOINCREMENT,
+      prediction_id INTEGER NOT NULL REFERENCES predictions(id),
+      day_number INTEGER NOT NULL,
+      date TEXT NOT NULL,
+      open_price REAL NOT NULL,
+      high_price REAL NOT NULL,
+      low_price REAL NOT NULL,
+      close_price REAL NOT NULL,
+      change_pct_close REAL NOT NULL,
+      change_pct_high REAL NOT NULL,
+      change_pct_low REAL NOT NULL,
+      UNIQUE(prediction_id, date)
+    );
+  `);
+}
+export function closeDb() {
+    if (db) {
+        db.close();
+        db = null;
+    }
+}

package/dist/index.js

@@ -17,6 +17,7 @@ import { sendTelegramMessageWithConfig, formatReport, formatFallbackReport } fro
 import { filterNewPosts as filterNew, markPostsSeen } from './seen.js';
 import { withRetry } from './retry.js';
 import { createTranscriber, transcribeVideoPosts } from './transcribe.js';
+import { recordPredictions, updateTracking } from './tracker.js';
 // ── Config ──────────────────────────────────────────────────
 const FB_PAGE_URL = 'https://www.facebook.com/DieWithoutBang/';
 const DATA_DIR = process.env.DATA_DIR || join(process.cwd(), 'data');
@@ -203,7 +204,23 @@ async function runInner(opts) {
     else {
         console.log('[Telegram] 未設定 TG_BOT_TOKEN / TG_CHANNEL_ID，跳過通知');
     }
-    // 8. 存檔
+    // 8. 預測追蹤記錄
+    if (analysis.hasInvestmentContent && !llmFailed) {
+        try {
+            const postInfos = newPosts.map((p) => ({
+                id: p.id,
+                url: p.url,
+                timestamp: p.timestamp,
+            }));
+            const count = await recordPredictions(analysis, postInfos);
+            if (count > 0)
+                console.log(`[tracker] 已記錄 ${count} 筆預測`);
+        }
+        catch (err) {
+            console.error(`[tracker] 記錄預測失敗: ${err instanceof Error ? err.message : err}`);
+        }
+    }
+    // 9. 存檔
     mkdirSync(DATA_DIR, { recursive: true });
     const outFile = join(DATA_DIR, `report-${new Date().toISOString().slice(0, 19).replace(/:/g, '')}.json`);
     writeFileSync(outFile, JSON.stringify({ timestamp: new Date().toISOString(), posts: newPosts, analysis }, null, 2), 'utf-8');
@@ -221,6 +238,11 @@ if (isCronMode) {
         run({ maxPosts: 1, isDryRun: false, label: '盤中' })
             .catch((err) => console.error('[盤中] 執行失敗:', err));
     }, { timezone: 'Asia/Taipei' });
+    // 追蹤更新：週一到五 15:00（收盤後更新預測追蹤）
+    cron.schedule('0 15 * * 1-5', () => {
+        updateTracking()
+            .catch((err) => console.error('[追蹤更新] 執行失敗:', err));
+    }, { timezone: 'Asia/Taipei' });
     // 盤後：每天晚上 23:00，FB 3 篇
     cron.schedule('3 23 * * *', () => {
         run({ maxPosts: 3, isDryRun: false, label: '盤後' })
@@ -228,6 +250,7 @@ if (isCronMode) {
     }, { timezone: 'Asia/Taipei' });
     console.log('=== 巴逆逆排程已啟動 ===');
     console.log('  盤中：週一~五 09:07/09:37/10:07/.../13:07（FB, 1 篇）');
+    console.log('  追蹤更新：週一~五 15:00（預測追蹤判定）');
     console.log('  盤後：每天 23:03（FB, 3 篇）');
     console.log('  按 Ctrl+C 停止\n');
 }

package/dist/stock-map.d.ts

@@ -0,0 +1,14 @@
+export interface StockInfo {
+    code: string;
+    name: string;
+    market: 'tse' | 'otc';
+}
+export interface ResolvedStock {
+    code: string;
+    market: 'tse' | 'otc';
+}
+/**
+ * 名稱→代碼映射
+ * 匹配順序：完全匹配 → 包含匹配 → 反向包含
+ */
+export declare function resolveStock(name: string): ResolvedStock | null;

package/dist/stock-map.js

@@ -0,0 +1,51 @@
+import { readFileSync } from 'fs';
+import { join, dirname } from 'path';
+import { fileURLToPath } from 'url';
+let stockList = null;
+function loadStockList() {
+    if (stockList)
+        return stockList;
+    // 嘗試從專案 data/ 目錄載入
+    const __dirname = dirname(fileURLToPath(import.meta.url));
+    const candidates = [
+        join(__dirname, '..', 'data', 'tw-stock-list.json'),
+        join(__dirname, 'data', 'tw-stock-list.json'),
+    ];
+    for (const path of candidates) {
+        try {
+            const raw = readFileSync(path, 'utf-8');
+            stockList = JSON.parse(raw);
+            console.log(`[stock-map] 載入 ${stockList.length} 檔股票映射（${path}）`);
+            return stockList;
+        }
+        catch {
+            // 繼續嘗試下一個路徑
+        }
+    }
+    console.warn('[stock-map] 找不到 tw-stock-list.json，名稱映射將無法使用');
+    stockList = [];
+    return stockList;
+}
+/**
+ * 名稱→代碼映射
+ * 匹配順序：完全匹配 → 包含匹配 → 反向包含
+ */
+export function resolveStock(name) {
+    const list = loadStockList();
+    if (list.length === 0)
+        return null;
+    const trimmed = name.trim();
+    // 1. 完全匹配
+    const exact = list.find((s) => s.name === trimmed);
+    if (exact)
+        return { code: exact.code, market: exact.market };
+    // 2. 包含匹配：輸入名稱包含在股票名稱中（如「台光電」→「台光電」）
+    const contains = list.find((s) => s.name.includes(trimmed));
+    if (contains)
+        return { code: contains.code, market: contains.market };
+    // 3. 反向包含：股票名稱包含在輸入中（如「台積電ADR」→「台積電」）
+    const reverse = list.find((s) => trimmed.includes(s.name));
+    if (reverse)
+        return { code: reverse.code, market: reverse.market };
+    return null;
+}

package/dist/stock-price.d.ts

@@ -0,0 +1,31 @@
+/**
+ * 股價查詢模組
+ * - TWSE 即時報價（盤中）
+ * - FinMind OHLC（盤後歷史資料）
+ */
+export interface OHLCData {
+    date: string;
+    open: number;
+    high: number;
+    low: number;
+    close: number;
+}
+/**
+ * 判斷台股是否在交易時間（週一到五 09:00-13:30 台北時間）
+ */
+export declare function isMarketOpen(now?: Date): boolean;
+/**
+ * TWSE 即時報價（盤中使用）
+ * 回傳最新成交價
+ */
+export declare function getRealtimePrice(code: string, market: 'tse' | 'otc'): Promise<number | null>;
+/**
+ * FinMind API 取得歷史 OHLC 資料
+ */
+export declare function getDailyOHLC(code: string, startDate: string, endDate?: string): Promise<OHLCData[]>;
+/**
+ * 取得基準價格（以貼文時間為準）
+ * 貼文當天 + 盤中 → TWSE 即時報價
+ * 其他情況 → FinMind 貼文當日收盤價
+ */
+export declare function getBasePrice(code: string, market: 'tse' | 'otc', postTimestamp?: string): Promise<number | null>;

package/dist/stock-price.js

@@ -0,0 +1,121 @@
+/**
+ * 股價查詢模組
+ * - TWSE 即時報價（盤中）
+ * - FinMind OHLC（盤後歷史資料）
+ */
+const FINMIND_TOKEN = process.env.FINMIND_TOKEN || '';
+const FINMIND_BASE = 'https://api.finmindtrade.com/api/v4/data';
+const TWSE_REALTIME = 'https://mis.twse.com.tw/stock/api/getStockInfo.jsp';
+/**
+ * 判斷台股是否在交易時間（週一到五 09:00-13:30 台北時間）
+ */
+export function isMarketOpen(now) {
+    const taipei = new Date((now ?? new Date()).toLocaleString('en-US', { timeZone: 'Asia/Taipei' }));
+    const day = taipei.getDay();
+    if (day === 0 || day === 6)
+        return false;
+    const hours = taipei.getHours();
+    const minutes = taipei.getMinutes();
+    const timeMinutes = hours * 60 + minutes;
+    return timeMinutes >= 540 && timeMinutes <= 810; // 09:00 ~ 13:30
+}
+/**
+ * TWSE 即時報價（盤中使用）
+ * 回傳最新成交價
+ */
+export async function getRealtimePrice(code, market) {
+    try {
+        const prefix = market === 'tse' ? 'tse' : 'otc';
+        const url = `${TWSE_REALTIME}?ex_ch=${prefix}_${code}.tw&json=1&delay=0`;
+        const res = await fetch(url, {
+            headers: { 'User-Agent': 'Mozilla/5.0' },
+            signal: AbortSignal.timeout(10000),
+        });
+        if (!res.ok)
+            return null;
+        const data = await res.json();
+        const info = data?.msgArray?.[0];
+        if (!info)
+            return null;
+        // z = 最新成交價，y = 昨收
+        const price = parseFloat(info.z);
+        if (!isNaN(price) && price > 0)
+            return price;
+        // 尚未成交，用昨收
+        const yesterday = parseFloat(info.y);
+        if (!isNaN(yesterday) && yesterday > 0)
+            return yesterday;
+        return null;
+    }
+    catch (err) {
+        console.warn(`[stock-price] TWSE 即時報價失敗 (${code}): ${err instanceof Error ? err.message : err}`);
+        return null;
+    }
+}
+/**
+ * FinMind API 取得歷史 OHLC 資料
+ */
+export async function getDailyOHLC(code, startDate, endDate) {
+    const end = endDate ?? startDate;
+    const params = new URLSearchParams({
+        dataset: 'TaiwanStockPrice',
+        data_id: code,
+        start_date: startDate,
+        end_date: end,
+    });
+    if (FINMIND_TOKEN)
+        params.set('token', FINMIND_TOKEN);
+    const url = `${FINMIND_BASE}?${params}`;
+    try {
+        const res = await fetch(url, { signal: AbortSignal.timeout(15000) });
+        if (!res.ok) {
+            console.warn(`[stock-price] FinMind API 回應 ${res.status}`);
+            return [];
+        }
+        const json = await res.json();
+        if (json.status !== 200 || !Array.isArray(json.data)) {
+            console.warn(`[stock-price] FinMind API 錯誤: ${json.msg ?? 'unknown'}`);
+            return [];
+        }
+        return json.data.map((d) => ({
+            date: d.date,
+            open: d.open,
+            high: d.max,
+            low: d.min,
+            close: d.close,
+        }));
+    }
+    catch (err) {
+        console.warn(`[stock-price] FinMind API 失敗 (${code}): ${err instanceof Error ? err.message : err}`);
+        return [];
+    }
+}
+/**
+ * 取得基準價格（以貼文時間為準）
+ * 貼文當天 + 盤中 → TWSE 即時報價
+ * 其他情況 → FinMind 貼文當日收盤價
+ */
+export async function getBasePrice(code, market, postTimestamp) {
+    const now = new Date();
+    const postDate = postTimestamp ? new Date(postTimestamp) : now;
+    const postDateStr = postDate.toLocaleDateString('en-CA', { timeZone: 'Asia/Taipei' });
+    const todayStr = now.toLocaleDateString('en-CA', { timeZone: 'Asia/Taipei' });
+    // 貼文是今天 + 現在盤中 → 即時報價（最接近發文時的價格）
+    if (postDateStr === todayStr && isMarketOpen()) {
+        const price = await getRealtimePrice(code, market);
+        if (price)
+            return price;
+    }
+    // 查貼文當日收盤價
+    const ohlc = await getDailyOHLC(code, postDateStr);
+    if (ohlc.length > 0)
+        return ohlc[0].close;
+    // fallback：貼文日期往前查 5 天（處理週末/假日）
+    const fallbackStart = new Date(postDate);
+    fallbackStart.setDate(fallbackStart.getDate() - 5);
+    const startStr = fallbackStart.toLocaleDateString('en-CA', { timeZone: 'Asia/Taipei' });
+    const recent = await getDailyOHLC(code, startStr, postDateStr);
+    if (recent.length > 0)
+        return recent[recent.length - 1].close;
+    return null;
+}

package/dist/tracker.d.ts

@@ -0,0 +1,26 @@
+import type { BaniniAnalysis } from './analyze.js';
+interface PostInfo {
+    id: string;
+    url: string;
+    timestamp: string;
+}
+/**
+ * 記錄 LLM 分析出的預測
+ * 同股票有 tracking 中的舊預測 → supersede 舊的
+ */
+export declare function recordPredictions(analysis: BaniniAnalysis, posts: PostInfo[]): Promise<number>;
+/**
+ * 每日更新追蹤中的預測（建議 15:00 後執行）
+ * 一律追蹤 5 個交易日，不提前終止。
+ */
+export declare function updateTracking(): Promise<void>;
+/**
+ * 取得追蹤統計（基本概覽）
+ */
+export declare function getStats(): {
+    total: number;
+    completed: number;
+    tracking: number;
+    superseded: number;
+};
+export {};

package/dist/tracker.js

@@ -0,0 +1,209 @@
+/**
+ * 預測追蹤主邏輯
+ * - recordPredictions：LLM 分析後記錄預測
+ * - updateTracking：每日更新追蹤中的預測（15:00 排程）
+ *
+ * 設計原則：資料記錄與勝敗判定分離
+ * 系統只負責忠實記錄 5 個交易日的 OHLC，勝敗在查詢時決定。
+ */
+import { getDb } from './db.js';
+import { resolveStock } from './stock-map.js';
+import { getBasePrice, getDailyOHLC } from './stock-price.js';
+/**
+ * 記錄 LLM 分析出的預測
+ * 同股票有 tracking 中的舊預測 → supersede 舊的
+ */
+export async function recordPredictions(analysis, posts) {
+    if (!analysis.hasInvestmentContent || !analysis.mentionedTargets?.length) {
+        return 0;
+    }
+    const db = getDb();
+    const insert = db.prepare(`
+    INSERT OR IGNORE INTO predictions
+      (post_id, post_url, symbol_name, symbol_code, symbol_type,
+       her_action, reverse_view, confidence, reasoning,
+       base_price, created_at, recorded_at, status)
+    VALUES
+      (@post_id, @post_url, @symbol_name, @symbol_code, @symbol_type,
+       @her_action, @reverse_view, @confidence, @reasoning,
+       @base_price, @created_at, @recorded_at, @status)
+  `);
+    const findTracking = db.prepare(`
+    SELECT id FROM predictions
+    WHERE symbol_code = ? AND status = 'tracking'
+    ORDER BY id DESC LIMIT 1
+  `);
+    const supersede = db.prepare(`
+    UPDATE predictions
+    SET status = 'superseded', next_prediction_id = ?
+    WHERE id = ?
+  `);
+    const latestPost = posts[0];
+    const now = new Date().toISOString();
+    let recorded = 0;
+    for (const target of analysis.mentionedTargets) {
+        if (target.type !== '個股' && target.type !== 'ETF') {
+            continue;
+        }
+        const stock = resolveStock(target.name);
+        let basePrice = null;
+        let status = 'tracking';
+        if (stock) {
+            basePrice = await getBasePrice(stock.code, stock.market, latestPost.timestamp);
+        }
+        else {
+            status = 'unmappable';
+            console.warn(`[tracker] 無法映射股票名稱: ${target.name}`);
+        }
+        const result = insert.run({
+            post_id: latestPost.id,
+            post_url: latestPost.url,
+            symbol_name: target.name,
+            symbol_code: stock?.code ?? null,
+            symbol_type: target.type,
+            her_action: target.herAction,
+            reverse_view: target.reverseView,
+            confidence: target.confidence,
+            reasoning: target.reasoning ?? null,
+            base_price: basePrice,
+            created_at: latestPost.timestamp,
+            recorded_at: now,
+            status,
+        });
+        if (result.changes > 0) {
+            const newId = result.lastInsertRowid;
+            // 同股票有追蹤中的舊預測 → supersede
+            if (stock && status === 'tracking') {
+                const existing = findTracking.get(stock.code);
+                if (existing && existing.id !== newId) {
+                    supersede.run(newId, existing.id);
+                    console.log(`[tracker] 覆蓋舊預測 #${existing.id} → #${newId}（${target.name}）`);
+                }
+            }
+            recorded++;
+            const priceStr = basePrice ? `$${basePrice}` : '無報價';
+            console.log(`[tracker] 記錄預測: ${target.name}（${stock?.code ?? '?'}）${target.reverseView} [${priceStr}]`);
+        }
+    }
+    return recorded;
+}
+/**
+ * 每日更新追蹤中的預測（建議 15:00 後執行）
+ * 一律追蹤 5 個交易日，不提前終止。
+ */
+export async function updateTracking() {
+    let db;
+    try {
+        db = getDb();
+    }
+    catch (err) {
+        console.error(`[tracker] 無法開啟資料庫: ${err instanceof Error ? err.message : err}`);
+        return;
+    }
+    const predictions = db.prepare(`
+    SELECT id, symbol_code, symbol_name, base_price
+    FROM predictions
+    WHERE status = 'tracking' AND symbol_code IS NOT NULL AND base_price IS NOT NULL
+  `).all();
+    if (predictions.length === 0) {
+        console.log('[tracker] 沒有追蹤中的預測');
+        return;
+    }
+    console.log(`[tracker] 更新 ${predictions.length} 筆追蹤中的預測...`);
+    // 去重 symbol_code，避免重複查詢
+    const uniqueCodes = [...new Set(predictions.map((p) => p.symbol_code))];
+    const today = new Date().toLocaleDateString('en-CA', { timeZone: 'Asia/Taipei' });
+    // 批次查詢今日 OHLC
+    const ohlcMap = new Map();
+    for (const code of uniqueCodes) {
+        try {
+            const data = await getDailyOHLC(code, today);
+            if (data.length > 0) {
+                ohlcMap.set(code, data[0]);
+            }
+        }
+        catch (err) {
+            console.warn(`[tracker] 查詢 ${code} OHLC 失敗，跳過: ${err instanceof Error ? err.message : err}`);
+        }
+    }
+    if (ohlcMap.size === 0) {
+        console.warn('[tracker] 今日無任何 OHLC 資料，跳過更新');
+        return;
+    }
+    const countSnapshots = db.prepare(`
+    SELECT COUNT(*) as cnt FROM price_snapshots WHERE prediction_id = ?
+  `);
+    const insertSnapshot = db.prepare(`
+    INSERT OR IGNORE INTO price_snapshots
+      (prediction_id, day_number, date, open_price, high_price, low_price, close_price,
+       change_pct_close, change_pct_high, change_pct_low)
+    VALUES (@prediction_id, @day_number, @date, @open_price, @high_price, @low_price, @close_price,
+            @change_pct_close, @change_pct_high, @change_pct_low)
+  `);
+    const markCompleted = db.prepare(`
+    UPDATE predictions SET status = 'completed', completed_at = ? WHERE id = ?
+  `);
+    const updateInTransaction = db.transaction(() => {
+        for (const pred of predictions) {
+            const ohlc = ohlcMap.get(pred.symbol_code);
+            if (!ohlc)
+                continue;
+            // day_number = 已有的 snapshot 數 + 1
+            const currentCount = countSnapshots.get(pred.id).cnt;
+            const dayNumber = currentCount + 1;
+            // 計算漲跌幅（兩個方向都記錄）
+            const changePctClose = ((ohlc.close - pred.base_price) / pred.base_price) * 100;
+            const changePctHigh = ((ohlc.high - pred.base_price) / pred.base_price) * 100;
+            const changePctLow = ((ohlc.low - pred.base_price) / pred.base_price) * 100;
+            insertSnapshot.run({
+                prediction_id: pred.id,
+                day_number: dayNumber,
+                date: today,
+                open_price: ohlc.open,
+                high_price: ohlc.high,
+                low_price: ohlc.low,
+                close_price: ohlc.close,
+                change_pct_close: Math.round(changePctClose * 100) / 100,
+                change_pct_high: Math.round(changePctHigh * 100) / 100,
+                change_pct_low: Math.round(changePctLow * 100) / 100,
+            });
+            // 5 個交易日 → completed
+            if (dayNumber >= 5) {
+                markCompleted.run(today, pred.id);
+                console.log(`[tracker] 完成追蹤: ${pred.symbol_name}（${pred.symbol_code}）5 天結束`);
+            }
+            else {
+                const pctStr = changePctClose >= 0 ? `+${changePctClose.toFixed(2)}` : changePctClose.toFixed(2);
+                console.log(`[tracker] ${pred.symbol_name}（${pred.symbol_code}）day ${dayNumber}: ${pctStr}%`);
+            }
+        }
+    });
+    try {
+        updateInTransaction();
+        console.log('[tracker] 追蹤更新完成');
+    }
+    catch (err) {
+        console.error(`[tracker] 寫入快照失敗: ${err instanceof Error ? err.message : err}`);
+    }
+}
+/**
+ * 取得追蹤統計（基本概覽）
+ */
+export function getStats() {
+    const db = getDb();
+    const stats = db.prepare(`
+    SELECT
+      COUNT(*) as total,
+      SUM(CASE WHEN status = 'completed' THEN 1 ELSE 0 END) as completed,
+      SUM(CASE WHEN status = 'tracking' THEN 1 ELSE 0 END) as tracking,
+      SUM(CASE WHEN status = 'superseded' THEN 1 ELSE 0 END) as superseded
+    FROM predictions
+    WHERE status != 'unmappable'
+  `).get();
+    return {
+        total: stats.total,
+        completed: stats.completed,
+        tracking: stats.tracking,
+        superseded: stats.superseded,
+    };
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cablate/banini-tracker",
-  "version": "2.0.6",
+  "version": "2.0.8",
   "description": "巴逆逆反指標追蹤器 — 常駐排程 + CLI 雙模式",
   "type": "module",
   "bin": {
@@ -28,6 +28,7 @@
   "author": "cablate",
   "license": "MIT",
   "dependencies": {
+    "better-sqlite3": "^12.8.0",
     "commander": "^13.0.0",
     "dotenv": "^16.4.0",
     "groq-sdk": "^1.1.2",
@@ -35,6 +36,7 @@
     "openai": "^4.0.0"
   },
   "devDependencies": {
+    "@types/better-sqlite3": "^7.6.13",
     "@types/node": "^20.0.0",
     "@types/node-cron": "^3.0.11",
     "tsx": "^4.0.0",