tickflow-assist 0.3.3 → 0.3.5

package/dist/services/pre-market-brief-service.js

@@ -0,0 +1,289 @@
+import { createHash } from "node:crypto";
+import { PRE_MARKET_BRIEF_SYSTEM_PROMPT, buildPreMarketBriefUserPrompt, } from "../prompts/analysis/index.js";
+import { formatChinaDateTime } from "../utils/china-time.js";
+const PRE_MARKET_BRIEF_KEYWORD = "金十数据整理";
+const PRE_MARKET_READY_TIME = "09:20:00";
+const PRE_MARKET_SYNC_MAX_PAGES = 12;
+const OPPORTUNITY_KEYWORDS = [
+    "政策",
+    "订单",
+    "中标",
+    "业绩",
+    "回购",
+    "增持",
+    "涨价",
+    "算力",
+    "并购",
+    "并购重组",
+    "AI",
+    "人工智能",
+    "机器人",
+];
+const RISK_KEYWORDS = [
+    "减持",
+    "监管",
+    "问询",
+    "处罚",
+    "停牌",
+    "复牌",
+    "下调",
+    "风险",
+    "不确定",
+    "制裁",
+    "关税",
+];
+export class PreMarketBriefService {
+    watchlistService;
+    jin10McpService;
+    flashRepository;
+    analysisService;
+    constructor(watchlistService, jin10McpService, flashRepository, analysisService) {
+        this.watchlistService = watchlistService;
+        this.jin10McpService = jin10McpService;
+        this.flashRepository = flashRepository;
+        this.analysisService = analysisService;
+    }
+    async run(now = new Date()) {
+        const watchlist = await this.watchlistService.list();
+        if (watchlist.length === 0) {
+            return {
+                resultType: "skipped",
+                message: "🚫 开盘前资讯简报已跳过：关注列表为空。",
+                sourceCount: 0,
+                matchedWatchlistCount: 0,
+            };
+        }
+        const configError = this.jin10McpService.getConfigurationError();
+        if (configError) {
+            return {
+                resultType: "skipped",
+                message: `🚫 开盘前资讯简报已跳过：${configError}`,
+                sourceCount: 0,
+                matchedWatchlistCount: 0,
+            };
+        }
+        const window = buildPreMarketWindow(now);
+        await this.syncWindow(window);
+        const flashes = (await this.flashRepository.listByPublishedRange(window.startTs, window.endTs))
+            .filter((record) => matchesPreMarketBrief(record));
+        if (flashes.length === 0) {
+            return {
+                resultType: "success",
+                message: [
+                    `**🌅 开盘前资讯简报｜${window.endAt.slice(0, 10)}**`,
+                    `信息窗口: ${window.startAt} ~ ${window.endAt}`,
+                    `整理快讯: 0 条 | 自选: ${watchlist.length} 只`,
+                    "",
+                    `本窗口未检索到标题含“${PRE_MARKET_BRIEF_KEYWORD}”的快讯，今日无新增盘前整理摘要。`,
+                ].join("\n"),
+                sourceCount: 0,
+                matchedWatchlistCount: 0,
+            };
+        }
+        const matchContexts = flashes.map((flash) => ({
+            flash,
+            matchedItems: findMatchedItems(flash, watchlist),
+        }));
+        const matchedWatchlistCount = new Set(matchContexts.flatMap((context) => context.matchedItems.map((item) => item.symbol))).size;
+        const summary = await this.buildSummary(window, watchlist, matchContexts);
+        return {
+            resultType: "success",
+            message: [
+                `**🌅 开盘前资讯简报｜${window.endAt.slice(0, 10)}**`,
+                `信息窗口: ${window.startAt} ~ ${window.endAt}`,
+                `整理快讯: ${flashes.length} 条 | 自选: ${watchlist.length} 只 | 规则命中: ${matchedWatchlistCount} 只`,
+                "",
+                summary.trim(),
+            ].join("\n"),
+            sourceCount: flashes.length,
+            matchedWatchlistCount,
+        };
+    }
+    async syncWindow(window) {
+        let cursor;
+        const collected = [];
+        for (let pageIndex = 0; pageIndex < PRE_MARKET_SYNC_MAX_PAGES; pageIndex += 1) {
+            const page = await this.jin10McpService.listFlash(cursor);
+            const records = page.items
+                .map((item) => toFlashRecord(item))
+                .filter((item) => item != null);
+            if (records.length === 0) {
+                break;
+            }
+            collected.push(...records);
+            const oldestPublishedTs = records[records.length - 1]?.published_ts ?? Number.MAX_SAFE_INTEGER;
+            if (oldestPublishedTs < window.startTs || !page.hasMore || !page.nextCursor) {
+                break;
+            }
+            cursor = page.nextCursor;
+        }
+        if (collected.length > 0) {
+            await this.flashRepository.saveAll(collected);
+        }
+    }
+    async buildSummary(window, watchlist, matchContexts) {
+        const promptInput = {
+            windowStartAt: window.startAt,
+            windowEndAt: window.endAt,
+            watchlist,
+            flashes: matchContexts.map((context) => ({
+                publishedAt: context.flash.published_at,
+                headline: extractHeadlineFromContent(context.flash.content),
+                content: context.flash.content,
+                url: context.flash.url,
+                matchedSymbols: context.matchedItems.map((item) => item.symbol),
+            })),
+        };
+        if (this.analysisService.isConfigured()) {
+            try {
+                return await this.analysisService.generateText(PRE_MARKET_BRIEF_SYSTEM_PROMPT, buildPreMarketBriefUserPrompt(promptInput), {
+                    maxTokens: 1600,
+                    temperature: 0.2,
+                });
+            }
+            catch {
+                // Fall through to deterministic fallback so the scheduled push still lands.
+            }
+        }
+        return buildFallbackSummary(matchContexts);
+    }
+}
+function buildPreMarketWindow(now) {
+    const chinaToday = formatChinaDate(now);
+    const previousDay = formatChinaDate(new Date(toChinaTimestamp(`${chinaToday} ${PRE_MARKET_READY_TIME}`) - 24 * 60 * 60 * 1000));
+    const startAt = `${previousDay} 17:00:00`;
+    const endAt = `${chinaToday} ${PRE_MARKET_READY_TIME}`;
+    return {
+        startAt,
+        endAt,
+        startTs: toChinaTimestamp(startAt),
+        endTs: toChinaTimestamp(endAt),
+    };
+}
+function toChinaTimestamp(value) {
+    return new Date(`${value.replace(" ", "T")}+08:00`).getTime();
+}
+function formatChinaDate(date) {
+    const formatter = new Intl.DateTimeFormat("zh-CN", {
+        timeZone: "Asia/Shanghai",
+        year: "numeric",
+        month: "2-digit",
+        day: "2-digit",
+    });
+    const map = Object.fromEntries(formatter
+        .formatToParts(date)
+        .filter((part) => part.type !== "literal")
+        .map((part) => [part.type, part.value]));
+    return `${map.year}-${map.month}-${map.day}`;
+}
+function matchesPreMarketBrief(record) {
+    return extractHeadlineText(record.content).includes(PRE_MARKET_BRIEF_KEYWORD);
+}
+function findMatchedItems(flash, watchlist) {
+    const normalizedContent = normalizeText(flash.content);
+    return watchlist.filter((item) => {
+        const directKeywords = [item.symbol, item.symbol.slice(0, 6), item.name];
+        const boardKeywords = [item.sector ?? "", ...item.themes]
+            .map((keyword) => keyword.replace(/\s+/g, "").trim())
+            .filter((keyword) => keyword.length >= 2);
+        return [...directKeywords, ...boardKeywords]
+            .map((keyword) => normalizeText(keyword))
+            .some((keyword) => keyword && normalizedContent.includes(keyword));
+    });
+}
+function buildFallbackSummary(matchContexts) {
+    const opportunityContexts = matchContexts.filter((context) => containsAnyKeyword(context.flash.content, OPPORTUNITY_KEYWORDS));
+    const riskContexts = matchContexts.filter((context) => containsAnyKeyword(context.flash.content, RISK_KEYWORDS));
+    return [
+        formatSectionTitle("🧭", "重大要闻"),
+        formatFlashBullets(matchContexts, 5),
+        "",
+        formatSectionTitle("🎯", "自选相关"),
+        formatMatchedBullets(matchContexts, 5),
+        "",
+        formatSectionTitle("💡", "潜在机会"),
+        opportunityContexts.length > 0
+            ? formatFlashBullets(opportunityContexts, 4)
+            : "• 未发现基于当前整理快讯可直接确认的新增机会方向。",
+        "",
+        formatSectionTitle("⚠️", "风险提示"),
+        riskContexts.length > 0
+            ? formatFlashBullets(riskContexts, 4)
+            : "• 当前整理快讯中未发现特别突出的新增风险，但仍需留意开盘后的情绪变化。",
+        "",
+        formatSectionTitle("📌", "开盘前关注清单"),
+        buildFocusBullets(matchContexts),
+    ].join("\n");
+}
+function formatFlashBullets(contexts, limit) {
+    return contexts
+        .slice(0, limit)
+        .map((context) => {
+        const time = context.flash.published_at.slice(11, 16);
+        return `• [${time}] ${extractHeadlineFromContent(context.flash.content)}`;
+    })
+        .join("\n");
+}
+function formatMatchedBullets(contexts, limit) {
+    const matched = contexts.filter((context) => context.matchedItems.length > 0).slice(0, limit);
+    if (matched.length === 0) {
+        return "• 未发现直接命中自选股、行业或题材的盘前整理快讯。";
+    }
+    return matched.map((context) => {
+        const labels = context.matchedItems.map((item) => `${item.name}（${item.symbol}）`).join("、");
+        return `• ${labels}: ${extractHeadlineFromContent(context.flash.content)}`;
+    }).join("\n");
+}
+function buildFocusBullets(contexts) {
+    const bullets = [];
+    const matchedContexts = contexts.filter((context) => context.matchedItems.length > 0);
+    for (const context of matchedContexts.slice(0, 3)) {
+        const labels = context.matchedItems.map((item) => item.name).join("、");
+        bullets.push(`• 关注 ${labels} 开盘后的量价反馈，核实“${extractHeadlineFromContent(context.flash.content)}”是否继续发酵。`);
+    }
+    if (bullets.length < 3) {
+        for (const context of contexts.slice(0, 3 - bullets.length)) {
+            bullets.push(`• 关注“${extractHeadlineFromContent(context.flash.content)}”对应板块是否出现竞价强化或高开分歧。`);
+        }
+    }
+    return bullets.slice(0, 5).join("\n");
+}
+function containsAnyKeyword(content, keywords) {
+    return keywords.some((keyword) => content.includes(keyword));
+}
+function normalizeText(value) {
+    return value.toLowerCase().replace(/\s+/g, "");
+}
+function formatSectionTitle(icon, title) {
+    return `**【${icon} ${title}】**`;
+}
+function extractHeadlineFromContent(content) {
+    const firstLine = extractHeadlineText(content);
+    return firstLine.length > 72 ? `${firstLine.slice(0, 72)}...` : firstLine;
+}
+function extractHeadlineText(content) {
+    return content.split(/[\n。！!]/)[0]?.trim() ?? "";
+}
+function toFlashRecord(item) {
+    const published = new Date(item.time);
+    if (Number.isNaN(published.getTime())) {
+        return null;
+    }
+    return {
+        flash_key: buildFlashKey(item.url, item.time, item.content),
+        published_at: formatChinaDateTime(published),
+        published_ts: published.getTime(),
+        content: item.content.trim(),
+        url: item.url.trim(),
+        ingested_at: formatChinaDateTime(),
+        raw: item.raw,
+    };
+}
+function buildFlashKey(url, time, content) {
+    if (url.trim()) {
+        return url.trim();
+    }
+    return createHash("sha1")
+        .update(`${time}\n${content}`)
+        .digest("hex");
+}

package/dist/services/trading-calendar-service.d.ts

@@ -13,6 +13,10 @@ export declare class TradingCalendarService {
         ok: boolean;
         reason: string;
     }>;
+    canRunPreMarketBrief(date?: Date): Promise<{
+        ok: boolean;
+        reason: string;
+    }>;
     getRecentTradingDays(limit: number, endDate?: Date): Promise<string[]>;
     private loadDays;
     private toChinaDate;

package/dist/services/trading-calendar-service.js

@@ -51,6 +51,17 @@ export class TradingCalendarService {
         }
         return { ok: true, reason: "交易日已完成收盘且达到复盘时间" };
     }
+    async canRunPreMarketBrief(date = new Date()) {
+        if (!(await this.isTradingDay(date))) {
+            return { ok: false, reason: `${this.toChinaDate(date)} 非交易日` };
+        }
+        const china = this.toChinaParts(date);
+        const hhmm = `${china.hour}:${china.minute}`;
+        if (hhmm < "09:20") {
+            return { ok: false, reason: `当前 ${hhmm}，须等到 09:20 后执行盘前资讯简报` };
+        }
+        return { ok: true, reason: "交易日且达到盘前资讯简报时间" };
+    }
     async getRecentTradingDays(limit, endDate = new Date()) {
         if (!Number.isInteger(limit) || limit <= 0) {
             throw new Error(`limit must be a positive integer, got ${limit}`);

package/dist/storage/repositories/jin10-flash-repo.d.ts

@@ -10,6 +10,7 @@ export declare class Jin10FlashRepository {
     }>;
     getLatest(): Promise<Jin10FlashRecord | null>;
     countSincePublishedTs(publishedTs: number): Promise<number>;
+    listByPublishedRange(startPublishedTs: number, endPublishedTs: number): Promise<Jin10FlashRecord[]>;
     searchByContentKeywords(keywords: string[], datePrefix: string): Promise<Jin10FlashRecord[]>;
     pruneOlderThanPublishedTs(publishedTs: number): Promise<void>;
     private listExistingKeys;

package/dist/storage/repositories/jin10-flash-repo.js

@@ -45,7 +45,16 @@ export class Jin10FlashRepository {
         if (rows.length === 0) {
             return null;
         }
-        return fromFlashRow(rows[rows.length - 1]);
+        let latestRow = rows[0];
+        let latestTs = Number(rows[0]?.published_ts ?? 0);
+        for (const row of rows.slice(1)) {
+            const publishedTs = Number(row.published_ts ?? 0);
+            if (publishedTs >= latestTs) {
+                latestRow = row;
+                latestTs = publishedTs;
+            }
+        }
+        return latestRow ? fromFlashRow(latestRow) : null;
     }
     async countSincePublishedTs(publishedTs) {
         if (!(await this.db.hasTable(JIN10_FLASH_TABLE))) {
@@ -54,6 +63,19 @@ export class Jin10FlashRepository {
         const table = await this.db.openTable(JIN10_FLASH_TABLE);
         return table.countRows(`published_ts >= ${Math.trunc(publishedTs)}`);
     }
+    async listByPublishedRange(startPublishedTs, endPublishedTs) {
+        if (!(await this.db.hasTable(JIN10_FLASH_TABLE))) {
+            return [];
+        }
+        const table = await this.db.openTable(JIN10_FLASH_TABLE);
+        const rows = (await table
+            .query()
+            .where(`published_ts >= ${Math.trunc(startPublishedTs)} AND published_ts <= ${Math.trunc(endPublishedTs)}`)
+            .toArray());
+        return rows
+            .map((row) => fromFlashRow(row))
+            .sort((left, right) => left.published_ts - right.published_ts);
+    }
     async searchByContentKeywords(keywords, datePrefix) {
         if (keywords.length === 0 || !(await this.db.hasTable(JIN10_FLASH_TABLE))) {
             return [];

package/dist/types/daily-update.d.ts

@@ -23,4 +23,11 @@ export interface DailyUpdateState {
     lastReviewResultType: DailyUpdateResultType | null;
     lastReviewResultSummary: string | null;
     reviewConsecutiveFailures: number;
+    lastPreMarketAttemptAt: string | null;
+    lastPreMarketAttemptDate: string | null;
+    lastPreMarketSuccessAt: string | null;
+    lastPreMarketSuccessDate: string | null;
+    lastPreMarketResultType: DailyUpdateResultType | null;
+    lastPreMarketResultSummary: string | null;
+    preMarketConsecutiveFailures: number;
 }

package/openclaw.plugin.json

@@ -1,11 +1,39 @@
 {
   "id": "tickflow-assist",
   "name": "TickFlow Assist",
-  "version": "0.3.3",
+  "version": "0.3.5",
   "description": "A-share watchlist analysis, monitoring, and alert delivery powered by TickFlow and OpenClaw.",
   "skills": [
     "skills"
   ],
+  "activation": {
+    "onCapabilities": ["tool", "hook"]
+  },
+  "setup": {
+    "requiresRuntime": true
+  },
+  "configContracts": {
+    "secretInputs": {
+      "paths": [
+        {
+          "path": "tickflowApiKey",
+          "expected": "string"
+        },
+        {
+          "path": "llmApiKey",
+          "expected": "string"
+        },
+        {
+          "path": "mxSearchApiKey",
+          "expected": "string"
+        },
+        {
+          "path": "jin10ApiToken",
+          "expected": "string"
+        }
+      ]
+    }
+  },
   "configSchema": {
     "type": "object",
     "additionalProperties": false,
@@ -13,38 +41,38 @@
       "tickflowApiUrl": {
         "type": "string",
         "default": "https://api.tickflow.org",
-        "description": "TickFlow API base URL."
+        "description": "TickFlow API base URL. Leave empty to use TICKFLOW_ASSIST_TICKFLOW_API_URL or TICKFLOW_API_URL."
       },
       "tickflowApiKey": {
         "type": "string",
         "minLength": 1,
-        "description": "TickFlow API key used for market and financial data. Required before using the plugin."
+        "description": "TickFlow API key used for market and financial data. Leave empty to use TICKFLOW_ASSIST_TICKFLOW_API_KEY or TICKFLOW_API_KEY."
       },
       "tickflowApiKeyLevel": {
         "type": "string",
         "enum": ["Free", "Start", "Pro", "Expert"],
         "default": "Free",
-        "description": "TickFlow subscription level. Pro and Expert enable intraday K-line fetching."
+        "description": "TickFlow subscription level. Pro and Expert enable intraday K-line fetching. Can also come from TICKFLOW_ASSIST_TICKFLOW_API_KEY_LEVEL or TICKFLOW_API_KEY_LEVEL."
       },
       "mxSearchApiUrl": {
         "type": "string",
         "default": "https://mkapi2.dfcfs.com/finskillshub/api/claw",
-        "description": "MX Search API base URL."
+        "description": "MX Search API base URL. Leave empty to use TICKFLOW_ASSIST_MX_SEARCH_API_URL or MX_SEARCH_API_URL."
       },
       "mxSearchApiKey": {
         "type": "string",
         "default": "",
-        "description": "Optional. Enables mx_search, mx_select_stock, and non-Expert financial fallback."
+        "description": "Configure this during setup if you want mx_search, mx_select_stock, and non-Expert financial fallback. Leave empty to use TICKFLOW_ASSIST_MX_SEARCH_API_KEY, MX_SEARCH_API_KEY, or MX_APIKEY."
       },
       "jin10McpUrl": {
         "type": "string",
         "default": "https://mcp.jin10.com/mcp",
-        "description": "Jin10 MCP server URL used for realtime flash monitoring."
+        "description": "Jin10 MCP server URL used for realtime flash monitoring. Leave empty to use TICKFLOW_ASSIST_JIN10_MCP_URL or JIN10_MCP_URL."
       },
       "jin10ApiToken": {
         "type": "string",
         "default": "",
-        "description": "Optional. Enables 24/7 Jin10 realtime flash monitoring when configured."
+        "description": "Configure this during setup to keep the managed Jin10 realtime flash monitor fully available. Leave empty to use TICKFLOW_ASSIST_JIN10_API_TOKEN or JIN10_API_TOKEN."
       },
       "jin10FlashPollInterval": {
         "type": "integer",
@@ -66,17 +94,17 @@
       "llmBaseUrl": {
         "type": "string",
         "default": "https://api.openai.com/v1",
-        "description": "OpenAI-compatible LLM API base URL."
+        "description": "OpenAI-compatible LLM API base URL. Leave empty to use TICKFLOW_ASSIST_LLM_BASE_URL or LLM_BASE_URL."
       },
       "llmApiKey": {
         "type": "string",
         "minLength": 1,
-        "description": "API key for the analysis model endpoint configured in llmBaseUrl. Required before using analysis features."
+        "description": "API key for the analysis model endpoint configured in llmBaseUrl. Leave empty to use TICKFLOW_ASSIST_LLM_API_KEY or LLM_API_KEY."
       },
       "llmModel": {
         "type": "string",
         "default": "gpt-4o",
-        "description": "Model name used for analysis."
+        "description": "Model name used for analysis. Leave empty to use TICKFLOW_ASSIST_LLM_MODEL or LLM_MODEL."
       },
       "databasePath": {
         "type": "string",
@@ -101,7 +129,7 @@
       },
       "alertChannel": {
         "type": "string",
-        "description": "Alert delivery channel, e.g. telegram, qqbot, wecom",
+        "description": "Configure this during setup for alert delivery, e.g. telegram, qqbot, wecom.",
         "default": "telegram"
       },
       "openclawCliBin": {
@@ -114,7 +142,7 @@
       },
       "alertTarget": {
         "type": "string",
-        "description": "Optional. Channel target for test_alert, monitoring alerts, and scheduled notifications.",
+        "description": "Configure this during setup for test_alert, monitoring alerts, and scheduled notifications.",
         "default": ""
       },
       "pythonBin": {
@@ -140,26 +168,26 @@
   "uiHints": {
     "tickflowApiKey": {
       "label": "TickFlow API Key",
-      "help": "Required before using TickFlow market and financial data.",
+      "help": "Used for TickFlow market and financial data. Leave empty to use TICKFLOW_ASSIST_TICKFLOW_API_KEY or TICKFLOW_API_KEY.",
       "sensitive": true
     },
     "tickflowApiKeyLevel": {
       "label": "TickFlow API Key Level",
-      "help": "Set this to your actual TickFlow subscription level."
+      "help": "Set this to your actual TickFlow subscription level, or provide it via TICKFLOW_ASSIST_TICKFLOW_API_KEY_LEVEL / TICKFLOW_API_KEY_LEVEL."
     },
     "mxSearchApiKey": {
       "label": "MX Search API Key",
-      "help": "Optional. Enables mx_search, mx_select_stock, and lite financial fallback.",
+      "help": "Configure this during setup if you want mx_search, mx_select_stock, and lite financial fallback, or use TICKFLOW_ASSIST_MX_SEARCH_API_KEY / MX_SEARCH_API_KEY / MX_APIKEY.",
       "sensitive": true
     },
     "jin10McpUrl": {
       "label": "Jin10 MCP URL",
-      "help": "Optional. MCP endpoint used by the 24/7 Jin10 flash monitor.",
+      "help": "Configure this together with the Jin10 token for the managed flash monitor, or use TICKFLOW_ASSIST_JIN10_MCP_URL / JIN10_MCP_URL.",
       "advanced": true
     },
     "jin10ApiToken": {
       "label": "Jin10 API Token",
-      "help": "Optional. Enables Jin10 realtime flash monitoring.",
+      "help": "Configure this during setup to keep the managed Jin10 flash monitor fully available, or use TICKFLOW_ASSIST_JIN10_API_TOKEN / JIN10_API_TOKEN.",
       "sensitive": true
     },
     "jin10FlashPollInterval": {
@@ -179,24 +207,24 @@
     },
     "llmBaseUrl": {
       "label": "LLM Base URL",
-      "help": "OpenAI-compatible analysis endpoint."
+      "help": "OpenAI-compatible analysis endpoint. Leave empty to use TICKFLOW_ASSIST_LLM_BASE_URL or LLM_BASE_URL."
     },
     "llmApiKey": {
       "label": "LLM API Key",
-      "help": "Required before using analysis model requests.",
+      "help": "Used for analysis model requests. Leave empty to use TICKFLOW_ASSIST_LLM_API_KEY or LLM_API_KEY.",
       "sensitive": true
     },
     "llmModel": {
       "label": "LLM Model",
-      "help": "Model name used for stock analysis."
+      "help": "Model name used for stock analysis. Leave empty to use TICKFLOW_ASSIST_LLM_MODEL or LLM_MODEL."
     },
     "alertChannel": {
       "label": "Alert Channel",
-      "help": "Default delivery channel for alert messages."
+      "help": "Configure this during setup before enabling alert delivery."
     },
     "alertTarget": {
       "label": "Alert Target",
-      "help": "Optional. Configure this if you want test_alert, monitoring alerts, or scheduled notifications."
+      "help": "Configure this during setup for test_alert, monitoring alerts, and scheduled notifications."
     },
     "databasePath": {
       "label": "Database Path",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tickflow-assist",
-  "version": "0.3.3",
+  "version": "0.3.5",
   "description": "面向 A 股投资与盯盘场景的 OpenClaw 智能股票插件，基于 TickFlow API 提供实时监控、收盘后复盘、多维综合分析、关键价位跟踪与告警能力。OpenClaw smart stock plugin for A-share investing and watchlist workflows, powered by TickFlow API for realtime monitoring, post-close review, multi-dimensional analysis, key level tracking, and alerts.",
   "license": "MIT",
   "type": "module",
@@ -37,7 +37,7 @@
     "dev": "tsc -p tsconfig.json --watch",
     "prepack": "npm run build && node ./scripts/prepare-package-assets.mjs",
     "postpack": "node ./scripts/restore-package-assets.mjs",
-    "test": "npm run build && node --test dist/plugin-registration.test.js dist/tools/test-alert.tool.test.js dist/services/jin10-mcp-service.test.js dist/services/monitor-service.test.js",
+    "test": "npm run build && node --test dist/plugin-registration.test.js dist/tools/test-alert.tool.test.js dist/services/jin10-mcp-service.test.js dist/services/jin10-flash-monitor-service.test.js dist/services/pre-market-brief-service.test.js dist/services/monitor-service.test.js",
     "community-setup": "node dist/dev/tickflow-assist-cli.js configure-openclaw",
     "tool": "node dist/dev/run-tool.js",
     "monitor-loop": "node dist/dev/run-monitor-loop.js",
@@ -46,12 +46,12 @@
   },
   "openclaw": {
     "build": {
-      "openclawVersion": "2026.4.5"
+      "openclawVersion": "2026.4.11"
     },
     "compat": {
       "pluginApi": ">=2026.3.31",
       "minGatewayVersion": "2026.3.31",
-      "builtWithOpenClawVersion": "2026.4.5"
+      "builtWithOpenClawVersion": "2026.4.11"
     },
     "extensions": [
       "dist/plugin.js"
@@ -69,9 +69,9 @@
   },
   "devDependencies": {
     "@types/node": "^22.13.11",
-    "openclaw": "^2026.4.5",
+    "openclaw": "^2026.4.11",
     "typescript": "^5.8.2"
   },
-  "readme": "# TickFlow Assist\n\n基于 [OpenClaw](https://openclaw.ai) 的 A 股监控与分析插件。它使用 [TickFlow](https://tickflow.org/auth/register?ref=BUJ54JEDGE) 获取行情与财务数据，并可选接入 [金十数据 MCP](https://mcp.jin10.com/app/) 快讯流，结合 LLM 生成技术面、基本面、资讯面的综合判断，并把结果持久化到本地 LanceDB。\n\n最近更新：`v0.3.3` 修复监控告警图片在去重前高频生成与重复告警风险，并收敛价格告警触发噪声。完整发布记录见 <https://github.com/robinspt/tickflow-assist/blob/main/CHANGELOG.md>。\n\n当前主线按 OpenClaw `v2026.3.31+` 对齐，并已验证社区安装在 `v2026.4.5` 上兼容。\n\n## 安装\n\n社区安装：\n\n```bash\nopenclaw plugins install tickflow-assist\nnpx -y tickflow-assist configure-openclaw\ncd ~/.openclaw/extensions/tickflow-assist/python && uv sync\nopenclaw plugins enable tickflow-assist\nopenclaw config validate\nopenclaw gateway restart\n```\n\n安装阶段允许先落插件，再通过第二条命令写入 `tickflowApiKey`、`llmApiKey` 等正式配置。\n`configure-openclaw` 会写入 `~/.openclaw/openclaw.json` 中的 `plugins.entries[\"tickflow-assist\"].config`，并打印后续建议执行的命令；它不再自动执行 `openclaw`、`uv` 或系统包安装命令。\n如果检测到 `plugins.installs[\"tickflow-assist\"]` 来自 `clawhub`，向导还会把被旧版本钉死的 `spec` 归一化为 `clawhub:tickflow-assist`，避免后续升级继续锁在旧版本。\n\n如果你希望先审阅配置，再只打印最少的后续步骤，可使用：\n\n```bash\nnpx -y tickflow-assist configure-openclaw --no-enable --no-restart\n```\n\n如果你在 Linux 或 macOS 上需要 PNG 告警卡正常显示中文，请额外手动安装 `fontconfig` 与 Noto CJK 一类中文字体，例如：\n\n```bash\n# Debian / Ubuntu\nsudo apt-get update\nsudo apt-get install -y fontconfig fonts-noto-cjk\nfc-cache -fv\n\n# RHEL / Fedora / Rocky / AlmaLinux\nsudo dnf install -y fontconfig google-noto-sans-cjk-ttc-fonts\nfc-cache -fv\n\n# Arch / Manjaro\nsudo pacman -Sy --noconfirm fontconfig noto-fonts-cjk\nfc-cache -fv\n\n# Alpine\nsudo apk add fontconfig font-noto-cjk\nfc-cache -fv\n\n# macOS (Homebrew)\nbrew install fontconfig\nbrew install --cask font-noto-sans-cjk\nfc-cache -fv\n```\n\n社区安装后的升级方式：\n\n```bash\nopenclaw plugins update tickflow-assist\nopenclaw gateway restart\n```\n\n## 配置\n\n插件正式运行读取：\n\n```text\n~/.openclaw/openclaw.json\n```\n\n配置路径：\n\n```text\nplugins.entries[\"tickflow-assist\"].config\n```\n\n建议按完整功能显式填写以下字段，不要只填 API Key：\n\n- 核心运行：`tickflowApiKey`、`llmApiKey`、`llmBaseUrl`、`llmModel`\n- 本地数据：`databasePath`、`calendarFile`\n- 告警投递：`alertChannel`、`alertTarget`、`alertAccount`\n- 能力补充：`mxSearchApiKey`、`jin10ApiToken`\n\n其中，`mxSearchApiKey` 用于 `mx_search`、`mx_select_stock` 以及非 `Expert` 财务链路的 lite 补充；`jin10ApiToken` 用于 24 小时金十数据快讯监控；`jin10FlashNightAlert` 默认 `false`（开启夜间静默），设为 `true` 可恢复 24 小时快讯告警；`alertTarget`、`alertAccount` 建议在准备启用 `test_alert`、实时监控告警、金十数据快讯告警和定时通知前一并配好，避免配置不完整导致功能缺失。\n\n## 功能\n\n- 自选股管理、日 K / 分钟 K 抓取与指标计算\n- 技术面、财务面、资讯面的综合分析\n- 实时监控、定时日更、收盘后复盘\n- 金十数据 24 小时快讯监控与自选关联提醒\n- 本地 LanceDB 数据留痕与分析结果查看\n\n## 运行说明\n\n- 插件会在本地 `databasePath` 下持久化 LanceDB 数据。\n- 后台服务会按配置执行定时日更、实时监控与金十数据快讯监控。\n- Python 子模块仅用于技术指标计算，不承担主业务流程。\n\n## 依赖与可选能力\n\n- [TickFlow](https://tickflow.org/auth/register?ref=BUJ54JEDGE)：提供日线、分钟线、实时行情与财务数据接口。\n- [金十数据 MCP](https://mcp.jin10.com/app/)：可选，用于 24 小时快讯流接入、自选关联筛选与事件驱动告警。\n- [东方财富妙想 Skills](https://marketing.dfcfs.com/views/finskillshub/)：可选，用于 `mx_search`、`mx_select_stock` 与非 `Expert` 财务链路的 lite 补充。\n\n## 仓库\n\n- GitHub: <https://github.com/robinspt/tickflow-assist>\n",
+  "readme": "# TickFlow Assist\n\n基于 [OpenClaw](https://openclaw.ai) 的 A 股监控与分析插件。它使用 [TickFlow](https://tickflow.org/auth/register?ref=BUJ54JEDGE) 获取行情与财务数据，并可选接入 [金十数据 MCP](https://mcp.jin10.com/app/) 快讯流，结合 LLM 生成技术面、基本面、资讯面的综合判断，并把结果持久化到本地 LanceDB。\n\n最近更新：`v0.3.5` 对齐 OpenClaw `2026.4.11` metadata 与社区安装提示，修复源码升级时本地链接扫描 `node_modules` 失败的问题，并支持通过环境变量回退 TickFlow / LLM / MX / Jin10 配置。完整发布记录见 <https://github.com/robinspt/tickflow-assist/blob/main/CHANGELOG.md>。\n\n当前主线按 OpenClaw `v2026.3.31+` 对齐，并已验证社区安装在 `v2026.4.11` 上兼容。\n\n## 安装前准备\n\n在执行社区安装前，建议先确认你已经准备好以下配置：\n\n- 核心必需：`tickflowApiKey`、`llmApiKey`、`llmBaseUrl`、`llmModel`\n- 告警投递：`alertChannel`、`alertTarget`、`alertAccount`\n- 可选增强：`mxSearchApiKey`、`jin10ApiToken`\n\n其中，`configure-openclaw` 会把上述配置写入 `~/.openclaw/openclaw.json` 的 `plugins.entries[\"tickflow-assist\"].config`，插件启用后会在本地 `databasePath` 下持久化 LanceDB 数据，并运行监控 / 日更等后台服务。\n如果你不想把密钥写进配置文件，运行时也支持环境变量回退，优先级是 `openclaw.json / local.config.json` > 环境变量 > 默认值。\n常用环境变量：`TICKFLOW_ASSIST_TICKFLOW_API_KEY` / `TICKFLOW_API_KEY`、`TICKFLOW_ASSIST_LLM_API_KEY` / `LLM_API_KEY`、`TICKFLOW_ASSIST_LLM_BASE_URL` / `LLM_BASE_URL`、`TICKFLOW_ASSIST_LLM_MODEL` / `LLM_MODEL`、`TICKFLOW_ASSIST_MX_SEARCH_API_KEY` / `MX_SEARCH_API_KEY` / `MX_APIKEY`、`TICKFLOW_ASSIST_JIN10_API_TOKEN` / `JIN10_API_TOKEN`。\n\n## 安装\n\n社区安装：\n\n```bash\nopenclaw plugins install tickflow-assist\nnpx -y tickflow-assist configure-openclaw\ncd ~/.openclaw/extensions/tickflow-assist/python && uv sync\nopenclaw plugins enable tickflow-assist\nopenclaw config validate\nopenclaw gateway restart\n```\n\n安装阶段允许先落插件，再通过第二条命令写入 `tickflowApiKey`、`llmApiKey`、`llmBaseUrl`、`llmModel` 等正式配置。\n`configure-openclaw` 会写入 `~/.openclaw/openclaw.json` 中的 `plugins.entries[\"tickflow-assist\"].config`，并打印后续建议执行的命令；它不再自动执行 `openclaw`、`uv` 或系统包安装命令，也不会重新执行插件安装；如果你已经设置了环境变量，密钥项可留空，输入 `-` 可主动清空已有配置并切回环境变量。\n如果检测到 `plugins.installs[\"tickflow-assist\"]` 来自 `clawhub`，向导还会把被旧版本钉死的 `spec` 归一化为 `clawhub:tickflow-assist`，避免后续升级继续锁在旧版本。\n\n如果你希望先审阅配置，再只打印最少的后续步骤，可使用：\n\n```bash\nnpx -y tickflow-assist configure-openclaw --no-enable --no-restart\n```\n\n如果你在 Linux 或 macOS 上需要 PNG 告警卡正常显示中文，请额外手动安装 `fontconfig` 与 Noto CJK 一类中文字体，例如：\n\n```bash\n# Debian / Ubuntu\nsudo apt-get update\nsudo apt-get install -y fontconfig fonts-noto-cjk\nfc-cache -fv\n\n# RHEL / Fedora / Rocky / AlmaLinux\nsudo dnf install -y fontconfig google-noto-sans-cjk-ttc-fonts\nfc-cache -fv\n\n# Arch / Manjaro\nsudo pacman -Sy --noconfirm fontconfig noto-fonts-cjk\nfc-cache -fv\n\n# Alpine\nsudo apk add fontconfig font-noto-cjk\nfc-cache -fv\n\n# macOS (Homebrew)\nbrew install fontconfig\nbrew install --cask font-noto-sans-cjk\nfc-cache -fv\n```\n\n社区安装后的升级方式：\n\n```bash\nopenclaw plugins update tickflow-assist\nopenclaw gateway restart\n```\n\n## 配置\n\n插件正式运行读取：\n\n```text\n~/.openclaw/openclaw.json\n```\n\n配置路径：\n\n```text\nplugins.entries[\"tickflow-assist\"].config\n```\n\n建议按完整功能显式填写以下字段，不要只填 API Key：\n\n- 核心运行：`tickflowApiKey`、`llmApiKey`、`llmBaseUrl`、`llmModel`\n- 本地数据：`databasePath`、`calendarFile`\n- 告警投递：`alertChannel`、`alertTarget`、`alertAccount`\n- 能力补充：`mxSearchApiKey`、`jin10ApiToken`\n\n其中，`mxSearchApiKey` 用于 `mx_search`、`mx_select_stock` 以及非 `Expert` 财务链路的 lite 补充；`jin10ApiToken` 用于 24 小时金十数据快讯监控；`jin10FlashNightAlert` 默认 `false`（开启夜间静默），设为 `true` 可恢复 24 小时快讯告警；`alertTarget`、`alertAccount` 建议在准备启用 `test_alert`、实时监控告警、金十数据快讯告警和定时通知前一并配好，避免配置不完整导致功能缺失。\n如果你使用环境变量，运行时支持以下回退：\n\n- `tickflowApiUrl`：`TICKFLOW_ASSIST_TICKFLOW_API_URL` / `TICKFLOW_API_URL`\n- `tickflowApiKey`：`TICKFLOW_ASSIST_TICKFLOW_API_KEY` / `TICKFLOW_API_KEY`\n- `tickflowApiKeyLevel`：`TICKFLOW_ASSIST_TICKFLOW_API_KEY_LEVEL` / `TICKFLOW_API_KEY_LEVEL`\n- `llmBaseUrl`：`TICKFLOW_ASSIST_LLM_BASE_URL` / `LLM_BASE_URL`\n- `llmApiKey`：`TICKFLOW_ASSIST_LLM_API_KEY` / `LLM_API_KEY`\n- `llmModel`：`TICKFLOW_ASSIST_LLM_MODEL` / `LLM_MODEL`\n- `mxSearchApiUrl`：`TICKFLOW_ASSIST_MX_SEARCH_API_URL` / `MX_SEARCH_API_URL`\n- `mxSearchApiKey`：`TICKFLOW_ASSIST_MX_SEARCH_API_KEY` / `MX_SEARCH_API_KEY` / `MX_APIKEY`\n- `jin10McpUrl`：`TICKFLOW_ASSIST_JIN10_MCP_URL` / `JIN10_MCP_URL`\n- `jin10ApiToken`：`TICKFLOW_ASSIST_JIN10_API_TOKEN` / `JIN10_API_TOKEN`\n\n## 功能\n\n- 自选股管理、日 K / 分钟 K 抓取与指标计算\n- 技术面、财务面、资讯面的综合分析\n- 实时监控、定时日更、收盘后复盘\n- 金十数据 24 小时快讯监控与自选关联提醒\n- 本地 LanceDB 数据留痕与分析结果查看\n\n## 运行说明\n\n- 插件会在本地 `databasePath` 下持久化 LanceDB 数据。\n- 后台服务会按配置执行定时日更、实时监控与金十数据快讯监控。\n- Python 子模块仅用于技术指标计算，不承担主业务流程。\n\n## 依赖与可选能力\n\n- [TickFlow](https://tickflow.org/auth/register?ref=BUJ54JEDGE)：提供日线、分钟线、实时行情与财务数据接口。\n- [金十数据 MCP](https://mcp.jin10.com/app/)：可选，用于 24 小时快讯流接入、自选关联筛选与事件驱动告警。\n- [东方财富妙想 Skills](https://marketing.dfcfs.com/views/finskillshub/)：可选，用于 `mx_search`、`mx_select_stock` 与非 `Expert` 财务链路的 lite 补充。\n\n## 仓库\n\n- GitHub: [robinspt/tickflow-assist](https://github.com/robinspt/tickflow-assist)\n",
   "readmeFilename": "README.md"
 }