tickflow-assist 0.3.1 → 0.3.3

package/README.md

@@ -2,9 +2,9 @@
 
 基于 [OpenClaw](https://openclaw.ai) 的 A 股监控与分析插件。它使用 [TickFlow](https://tickflow.org/auth/register?ref=BUJ54JEDGE) 获取行情与财务数据，并可选接入 [金十数据 MCP](https://mcp.jin10.com/app/) 快讯流，结合 LLM 生成技术面、基本面、资讯面的综合判断，并把结果持久化到本地 LanceDB。
 
-最近更新：`v0.3.1` 修复 GitHub Actions 自动发布 npm 包时的 provenance 仓库元数据校验失败，并将金十数据 MCP 握手里的 `clientInfo` 调整为中性固定值。完整发布记录见 <https://github.com/robinspt/tickflow-assist/blob/main/CHANGELOG.md>。
+最近更新：`v0.3.3` 修复监控告警图片在去重前高频生成与重复告警风险，并收敛价格告警触发噪声。完整发布记录见 <https://github.com/robinspt/tickflow-assist/blob/main/CHANGELOG.md>。
 
-当前主线按 OpenClaw `v2026.3.31+` 对齐，并已验证社区安装在 `v2026.4.1` 上兼容。
+当前主线按 OpenClaw `v2026.3.31+` 对齐，并已验证社区安装在 `v2026.4.5` 上兼容。
 
 ## 安装
 
@@ -83,7 +83,7 @@ plugins.entries["tickflow-assist"].config
 - 告警投递：`alertChannel`、`alertTarget`、`alertAccount`
 - 能力补充：`mxSearchApiKey`、`jin10ApiToken`
 
-其中，`mxSearchApiKey` 用于 `mx_search`、`mx_select_stock` 以及非 `Expert` 财务链路的 lite 补充；`jin10ApiToken` 用于 24 小时金十数据快讯监控；`alertTarget`、`alertAccount` 建议在准备启用 `test_alert`、实时监控告警、金十数据快讯告警和定时通知前一并配好，避免配置不完整导致功能缺失。
+其中，`mxSearchApiKey` 用于 `mx_search`、`mx_select_stock` 以及非 `Expert` 财务链路的 lite 补充；`jin10ApiToken` 用于 24 小时金十数据快讯监控；`jin10FlashNightAlert` 默认 `false`（开启夜间静默），设为 `true` 可恢复 24 小时快讯告警；`alertTarget`、`alertAccount` 建议在准备启用 `test_alert`、实时监控告警、金十数据快讯告警和定时通知前一并配好，避免配置不完整导致功能缺失。
 
 ## 功能
 

package/dist/analysis/types/composite-analysis.d.ts

@@ -104,9 +104,20 @@ export interface PriorKeyLevelValidationContext {
     summary: string;
     lines: string[];
 }
+export interface FlashNewsItem {
+    publishedAt: string;
+    content: string;
+    headline: string;
+    source: "stock_alert" | "market_overview";
+}
+export interface FlashNewsContext {
+    stockAlerts: FlashNewsItem[];
+    marketOverviewFlashes: FlashNewsItem[];
+}
 export interface PostCloseReviewInput extends CompositeAnalysisInput {
     compositeResult: CompositeAnalysisResult;
     validation: PriorKeyLevelValidationContext;
+    flashContext: FlashNewsContext;
 }
 export interface PostCloseReviewResult {
     analysisText: string;

package/dist/bootstrap.js

@@ -137,9 +137,9 @@ export function createAppContext(config, options = {}) {
     const compositeStockAnalysisTask = new CompositeStockAnalysisTask(keyLevelsRepository, analysisLogRepository);
     const compositeAnalysisOrchestrator = new CompositeAnalysisOrchestrator(analysisService, marketAnalysisProvider, financialAnalysisProvider, newsAnalysisProvider, klineTechnicalSignalTask, financialFundamentalTask, financialFundamentalLiteTask, newsCatalystTask, compositeStockAnalysisTask, technicalAnalysisRepository, financialAnalysisRepository, newsAnalysisRepository, compositeAnalysisRepository);
     const monitorService = new MonitorService(config.databasePath, config.requestInterval, config.alertChannel, watchlistService, quoteService, tradingCalendarService, keyLevelsRepository, alertLogRepository, klinesRepository, intradayKlinesRepository, klineService, alertService, alertMediaService);
-    const jin10FlashMonitorService = new Jin10FlashMonitorService(config.databasePath, config.jin10FlashPollInterval, config.jin10FlashRetentionDays, watchlistService, jin10McpService, analysisService, alertService, jin10FlashRepository, jin10FlashDeliveryRepository);
+    const jin10FlashMonitorService = new Jin10FlashMonitorService(config.databasePath, config.jin10FlashPollInterval, config.jin10FlashRetentionDays, config.jin10FlashNightAlert, watchlistService, jin10McpService, analysisService, alertService, jin10FlashRepository, jin10FlashDeliveryRepository);
     const updateService = new UpdateService(klineService, config.tickflowApiKeyLevel, indicatorService, klinesRepository, indicatorsRepository, intradayKlinesRepository, watchlistService, tradingCalendarService);
-    const postCloseReviewService = new PostCloseReviewService(watchlistService, compositeAnalysisOrchestrator, analysisService, postCloseReviewTask, keyLevelsRepository, keyLevelsHistoryRepository, klinesRepository, intradayKlinesRepository);
+    const postCloseReviewService = new PostCloseReviewService(watchlistService, compositeAnalysisOrchestrator, analysisService, postCloseReviewTask, keyLevelsRepository, keyLevelsHistoryRepository, klinesRepository, intradayKlinesRepository, jin10FlashDeliveryRepository, jin10FlashRepository);
     const realtimeMonitorWorker = new RealtimeMonitorWorker(monitorService, config.requestInterval * 1000);
     const jin10FlashWorker = new Jin10FlashWorker(jin10FlashMonitorService, config.jin10FlashPollInterval * 1000);
     const dailyUpdateWorker = new DailyUpdateWorker(updateService, postCloseReviewService, tradingCalendarService, config.databasePath, alertService, config.dailyUpdateNotify, runtime.configSource);

package/dist/config/normalize.js

@@ -52,6 +52,7 @@ export function normalizePluginConfig(input) {
         jin10ApiToken: normalizeString(raw.jin10ApiToken),
         jin10FlashPollInterval: normalizeInteger(raw.jin10FlashPollInterval, DEFAULT_PLUGIN_CONFIG.jin10FlashPollInterval),
         jin10FlashRetentionDays: normalizeInteger(raw.jin10FlashRetentionDays, DEFAULT_PLUGIN_CONFIG.jin10FlashRetentionDays),
+        jin10FlashNightAlert: normalizeBoolean(raw.jin10FlashNightAlert, DEFAULT_PLUGIN_CONFIG.jin10FlashNightAlert),
         llmBaseUrl: normalizeString(raw.llmBaseUrl, DEFAULT_PLUGIN_CONFIG.llmBaseUrl),
         llmApiKey: normalizeString(raw.llmApiKey),
         llmModel: normalizeString(raw.llmModel, DEFAULT_PLUGIN_CONFIG.llmModel),

package/dist/config/schema.d.ts

@@ -9,6 +9,7 @@ export interface PluginConfig {
     jin10ApiToken: string;
     jin10FlashPollInterval: number;
     jin10FlashRetentionDays: number;
+    jin10FlashNightAlert: boolean;
     llmBaseUrl: string;
     llmApiKey: string;
     llmModel: string;

package/dist/config/schema.js

@@ -6,6 +6,7 @@ export const DEFAULT_PLUGIN_CONFIG = {
     jin10McpUrl: "https://mcp.jin10.com/mcp",
     jin10FlashPollInterval: 300,
     jin10FlashRetentionDays: 7,
+    jin10FlashNightAlert: false,
     llmBaseUrl: "https://api.openai.com/v1",
     llmModel: "gpt-4o",
     databasePath: "./data/lancedb",

package/dist/dev/tickflow-assist-cli.js

@@ -16,6 +16,7 @@ const DEFAULTS = {
     jin10McpUrl: "https://mcp.jin10.com/mcp",
     jin10FlashPollInterval: 300,
     jin10FlashRetentionDays: 7,
+    jin10FlashNightAlert: false,
     llmBaseUrl: "https://api.openai.com/v1",
     llmModel: "gpt-4o",
     requestInterval: 30,
@@ -48,6 +49,9 @@ Options:
   --mx-search-api-key <key>
   --jin10-mcp-url <url>
   --jin10-api-token <token>
+  --jin10-flash-poll-interval <seconds>
+  --jin10-flash-retention-days <days>
+  --jin10-flash-night-alert <true|false>
   --llm-base-url <url>
   --llm-api-key <key>
   --llm-model <name>
@@ -146,6 +150,15 @@ function parseArgs(argv) {
             case "--jin10-api-token":
                 options.overrides.jin10ApiToken = requireValue(token);
                 break;
+            case "--jin10-flash-poll-interval":
+                options.overrides.jin10FlashPollInterval = Number(requireValue(token));
+                break;
+            case "--jin10-flash-retention-days":
+                options.overrides.jin10FlashRetentionDays = Number(requireValue(token));
+                break;
+            case "--jin10-flash-night-alert":
+                options.overrides.jin10FlashNightAlert = requireValue(token).toLowerCase() === "true";
+                break;
             case "--llm-base-url":
                 options.overrides.llmBaseUrl = requireValue(token);
                 break;
@@ -270,6 +283,9 @@ function getExistingPluginConfig(root) {
         jin10FlashRetentionDays: Number.isFinite(jin10FlashRetentionDays)
             ? Math.max(1, Math.trunc(jin10FlashRetentionDays))
             : DEFAULTS.jin10FlashRetentionDays,
+        jin10FlashNightAlert: typeof config.jin10FlashNightAlert === "boolean"
+            ? config.jin10FlashNightAlert
+            : DEFAULTS.jin10FlashNightAlert,
         llmBaseUrl: stringValue(config.llmBaseUrl, DEFAULTS.llmBaseUrl),
         llmApiKey: stringValue(config.llmApiKey),
         llmModel: stringValue(config.llmModel, DEFAULTS.llmModel),
@@ -416,6 +432,7 @@ async function promptForConfig(options, existing, pluginDir, configPath) {
         jin10ApiToken: "",
         jin10FlashPollInterval: DEFAULTS.jin10FlashPollInterval,
         jin10FlashRetentionDays: DEFAULTS.jin10FlashRetentionDays,
+        jin10FlashNightAlert: DEFAULTS.jin10FlashNightAlert,
         llmBaseUrl: DEFAULTS.llmBaseUrl,
         llmApiKey: "",
         llmModel: DEFAULTS.llmModel,
@@ -459,6 +476,13 @@ async function promptForConfig(options, existing, pluginDir, configPath) {
         ], seed.tickflowApiKeyLevel));
         seed.mxSearchApiKey = await promptString(rl, "MX Search API Key (可留空)", seed.mxSearchApiKey, false);
         seed.jin10ApiToken = await promptString(rl, "Jin10 API Token (可留空)", seed.jin10ApiToken, false);
+        seed.jin10FlashPollInterval = await promptInteger(rl, "Jin10 快讯轮询间隔（秒）", seed.jin10FlashPollInterval, 10);
+        seed.jin10FlashRetentionDays = await promptInteger(rl, "Jin10 快讯保留天数", seed.jin10FlashRetentionDays, 1);
+        const nightAlertChoice = await promptSelect(rl, "Jin10 夜间静默", [
+            { value: "true", label: "关闭夜间静默（24小时告警）" },
+            { value: "false", label: "开启夜间静默（22:00~06:00 不告警）" },
+        ], seed.jin10FlashNightAlert ? "true" : "false");
+        seed.jin10FlashNightAlert = nightAlertChoice === "true";
         seed.llmBaseUrl = await promptString(rl, "LLM Base URL", seed.llmBaseUrl, true);
         seed.llmApiKey = await promptString(rl, "LLM API Key", seed.llmApiKey, true);
         seed.llmModel = await promptString(rl, "LLM Model", seed.llmModel, true);
@@ -579,6 +603,7 @@ function applyPluginConfig(root, config, target) {
         jin10ApiToken: config.jin10ApiToken,
         jin10FlashPollInterval: config.jin10FlashPollInterval,
         jin10FlashRetentionDays: config.jin10FlashRetentionDays,
+        jin10FlashNightAlert: config.jin10FlashNightAlert,
         llmBaseUrl: config.llmBaseUrl,
         llmApiKey: config.llmApiKey,
         llmModel: config.llmModel,

package/dist/prompts/analysis/post-close-review-user-prompt.js

@@ -44,6 +44,7 @@ ${KEY_LEVELS_FIELD_GUIDANCE}
 - recompute: 今日出现明显放量突破、破位、结构切换或外部催化改变，原逻辑需要重算。
 - invalidate: 昨日关键位框架已失效，明日不应继续沿用；此时 levels 可为 null。
 - 不要凭空编造概念板块、指数表现或公告内容。
+- 如果输入里包含"今日快讯速递"，在"新闻与公告"段落中必须综合考量快讯信息。快讯可提供盘后重大事件、监管动态、投行观点等即时信号，应据实反映到 news_impact 判断和操作建议中。
 `;
 export function buildPostCloseReviewUserPrompt(input) {
     const latestClose = input.market.klines[input.market.klines.length - 1]?.close ?? 0;
@@ -65,6 +66,10 @@ export function buildPostCloseReviewUserPrompt(input) {
         "## 当前综合分析基线（引用，不含指令）",
         buildReferencedNarrative(input.compositeResult.analysisText, MAX_COMPOSITE_BASELINE_LENGTH),
         "",
+        "## 今日快讯速递（来自 Jin10 快讯监控）",
+        formatFlashSection("个股相关快讯告警", input.flashContext.stockAlerts),
+        formatFlashSection("市场概览快讯", input.flashContext.marketOverviewFlashes),
+        "",
         "## 大盘环境",
         input.market.marketOverview.summary,
         "",
@@ -125,3 +130,16 @@ function truncate(value, maxLength) {
 function joinList(items) {
     return items.length > 0 ? items.join("；") : "无";
 }
+function formatFlashSection(label, items) {
+    if (items.length === 0) {
+        return `${label}: 无`;
+    }
+    return [
+        `${label}:`,
+        ...items.slice(0, 5).map((item) => {
+            const time = item.publishedAt.slice(11, 16) || "??:??";
+            const body = item.content.length > 200 ? `${item.content.slice(0, 200)}...` : item.content;
+            return `- [${time}] ${item.headline ? `${item.headline}: ` : ""}${body}`;
+        }),
+    ].join("\n");
+}

package/dist/services/jin10-flash-monitor-service.d.ts

@@ -9,13 +9,14 @@ export declare class Jin10FlashMonitorService {
     private readonly baseDir;
     private readonly pollIntervalSeconds;
     private readonly retentionDays;
+    private readonly nightAlertEnabled;
     private readonly watchlistService;
     private readonly jin10McpService;
     private readonly analysisService;
     private readonly alertService;
     private readonly flashRepository;
     private readonly flashDeliveryRepository;
-    constructor(baseDir: string, pollIntervalSeconds: number, retentionDays: number, watchlistService: WatchlistService, jin10McpService: Jin10McpService, analysisService: AnalysisService, alertService: AlertService, flashRepository: Jin10FlashRepository, flashDeliveryRepository: Jin10FlashDeliveryRepository);
+    constructor(baseDir: string, pollIntervalSeconds: number, retentionDays: number, nightAlertEnabled: boolean, watchlistService: WatchlistService, jin10McpService: Jin10McpService, analysisService: AnalysisService, alertService: AlertService, flashRepository: Jin10FlashRepository, flashDeliveryRepository: Jin10FlashDeliveryRepository);
     runMonitorOnce(): Promise<number>;
     getStatusReport(): Promise<string>;
     getState(): Promise<FlashMonitorState>;

package/dist/services/jin10-flash-monitor-service.js

@@ -3,7 +3,7 @@ import { mkdir, readFile, writeFile } from "node:fs/promises";
 import path from "node:path";
 import { parseFlashAlertDecision } from "../analysis/parsers/flash-alert-decision.parser.js";
 import { FLASH_MONITOR_ALERT_SYSTEM_PROMPT, buildFlashMonitorAlertUserPrompt, } from "../prompts/analysis/index.js";
-import { chinaToday, formatChinaDateTime } from "../utils/china-time.js";
+import { chinaHour, chinaToday, formatChinaDateTime } from "../utils/china-time.js";
 const DEFAULT_STATE = {
     initialized: false,
     lastSeenKey: null,
@@ -48,16 +48,18 @@ export class Jin10FlashMonitorService {
     baseDir;
     pollIntervalSeconds;
     retentionDays;
+    nightAlertEnabled;
     watchlistService;
     jin10McpService;
     analysisService;
     alertService;
     flashRepository;
     flashDeliveryRepository;
-    constructor(baseDir, pollIntervalSeconds, retentionDays, watchlistService, jin10McpService, analysisService, alertService, flashRepository, flashDeliveryRepository) {
+    constructor(baseDir, pollIntervalSeconds, retentionDays, nightAlertEnabled, watchlistService, jin10McpService, analysisService, alertService, flashRepository, flashDeliveryRepository) {
         this.baseDir = baseDir;
         this.pollIntervalSeconds = pollIntervalSeconds;
         this.retentionDays = retentionDays;
+        this.nightAlertEnabled = nightAlertEnabled;
         this.watchlistService = watchlistService;
         this.jin10McpService = jin10McpService;
         this.analysisService = analysisService;
@@ -205,6 +207,9 @@ export class Jin10FlashMonitorService {
         if (await this.flashDeliveryRepository.hasDelivered(candidate.flash.flash_key)) {
             return 0;
         }
+        if (!this.nightAlertEnabled && isNightQuietHour()) {
+            return 0;
+        }
         const decision = await this.decideAlert(candidate);
         if (!decision.alert) {
             return 0;
@@ -576,3 +581,7 @@ function parseChinaTime(value) {
 function toChinaTimeTimestamp(value) {
     return parseChinaTime(value)?.getTime() ?? Date.now();
 }
+function isNightQuietHour() {
+    const hour = chinaHour();
+    return hour >= 22 || hour < 6;
+}

package/dist/services/monitor-service.d.ts

@@ -45,8 +45,15 @@ export declare class MonitorService {
     setExpectedStop(expectedStop: boolean): Promise<void>;
     recordHeartbeat(runtimeHost?: "plugin_service" | "fallback_process"): Promise<void>;
     recordLoopError(error: unknown): Promise<void>;
+    private tryAcquireRunLease;
+    private removeStaleRunLock;
     private trySendAlert;
+    private trySendCandidate;
     private buildAlertDelivery;
     private loadIntradayRows;
     private buildVolumeAlert;
+    private hasSentAlert;
+    private sendAlertAndCleanupMedia;
+    private cleanupAlertMedia;
+    private getRunLockFilePath;
 }

package/dist/services/monitor-service.js

@@ -1,4 +1,4 @@
-import { mkdir, readFile, writeFile } from "node:fs/promises";
+import { mkdir, readFile, rm, stat, writeFile } from "node:fs/promises";
 import path from "node:path";
 import { formatChinaDateTime } from "../utils/china-time.js";
 import { calculateProfitPct, formatCostPrice } from "../utils/cost-price.js";
@@ -20,6 +20,7 @@ const DEFAULT_STATE = {
     sessionNotificationsSent: [],
 };
 const INTRADAY_PERIOD = "1m";
+const MONITOR_RUN_LOCK_MIN_STALE_MS = 90_000;
 export class MonitorService {
     baseDir;
     requestInterval;
@@ -178,50 +179,60 @@ export class MonitorService {
         return lines.join("\n");
     }
     async runMonitorOnce() {
-        await this.alertMediaService.maybeCleanupExpired();
-        const phase = await this.tradingCalendarService.getTradingPhase();
-        let alertCount = await this.maybeSendSessionNotification(phase);
-        if (phase !== "trading") {
-            return alertCount;
-        }
-        const watchlist = await this.watchlistService.list();
-        if (watchlist.length === 0) {
-            return alertCount;
+        const runLease = await this.tryAcquireRunLease();
+        if (!runLease) {
+            return 0;
         }
-        const quotes = await this.quoteService.fetchQuotes(watchlist.map((item) => item.symbol));
-        const quoteMap = new Map(quotes.map((quote) => [quote.symbol, quote]));
-        for (const item of watchlist) {
-            const quote = quoteMap.get(item.symbol);
-            if (!quote || !(Number(quote.last_price) > 0)) {
-                continue;
+        try {
+            await this.alertMediaService.maybeCleanupExpired();
+            const phase = await this.tradingCalendarService.getTradingPhase();
+            let alertCount = await this.maybeSendSessionNotification(phase);
+            if (phase !== "trading") {
+                return alertCount;
             }
-            const levels = await this.keyLevelsRepository.getBySymbol(item.symbol);
-            let intradayRowsPromise = null;
-            const getIntradayRows = () => {
-                intradayRowsPromise ??= this.loadIntradayRows(item.symbol);
-                return intradayRowsPromise;
-            };
-            if (levels) {
-                for (const candidate of buildPriceAlerts(item, quote, levels, this.alertService)) {
-                    const delivery = await this.buildAlertDelivery(item, quote, candidate, levels, getIntradayRows);
-                    if (await this.trySendAlert(item.symbol, candidate.ruleName, delivery)) {
+            const watchlist = await this.watchlistService.list();
+            if (watchlist.length === 0) {
+                return alertCount;
+            }
+            const quotes = await this.quoteService.fetchQuotes(watchlist.map((item) => item.symbol));
+            const quoteMap = new Map(quotes.map((quote) => [quote.symbol, quote]));
+            for (const item of watchlist) {
+                const quote = quoteMap.get(item.symbol);
+                if (!quote || !(Number(quote.last_price) > 0)) {
+                    continue;
+                }
+                const levels = await this.keyLevelsRepository.getBySymbol(item.symbol);
+                let intradayRowsPromise = null;
+                const getIntradayRows = () => {
+                    intradayRowsPromise ??= this.loadIntradayRows(item.symbol);
+                    return intradayRowsPromise;
+                };
+                const priceAlert = levels
+                    ? selectPrimaryAlertCandidate(buildPriceAlerts(item, quote, levels, this.alertService))
+                    : null;
+                if (priceAlert) {
+                    if (await this.trySendCandidate(item, quote, priceAlert, levels, getIntradayRows)) {
                         alertCount += 1;
                     }
+                    continue;
                 }
-            }
-            const changeAlert = buildChangeAlert(item, quote, levels, this.alertService);
-            if (changeAlert) {
-                const delivery = await this.buildAlertDelivery(item, quote, changeAlert, levels, getIntradayRows);
-                if (await this.trySendAlert(item.symbol, changeAlert.ruleName, delivery)) {
+                const changeAlert = buildChangeAlert(item, quote, levels, this.alertService);
+                if (changeAlert) {
+                    if (await this.trySendCandidate(item, quote, changeAlert, levels, getIntradayRows)) {
+                        alertCount += 1;
+                    }
+                    continue;
+                }
+                const volumeAlert = await this.buildVolumeAlert(item, quote, levels);
+                if (volumeAlert && (await this.trySendAlert(item.symbol, volumeAlert.ruleName, volumeAlert.message))) {
                     alertCount += 1;
                 }
             }
-            const volumeAlert = await this.buildVolumeAlert(item, quote, levels);
-            if (volumeAlert && (await this.trySendAlert(item.symbol, volumeAlert.ruleName, volumeAlert.message))) {
-                alertCount += 1;
-            }
+            return alertCount;
+        }
+        finally {
+            await runLease.release();
         }
-        return alertCount;
     }
     async maybeSendSessionNotification(phase) {
         const now = formatChinaDateTime();
@@ -357,18 +368,61 @@ export class MonitorService {
             lastLoopErrorAt: formatChinaDateTime(),
         });
     }
+    async tryAcquireRunLease() {
+        const lockPath = this.getRunLockFilePath();
+        await mkdir(path.dirname(lockPath), { recursive: true });
+        for (let attempt = 0; attempt < 2; attempt += 1) {
+            try {
+                await writeFile(lockPath, JSON.stringify({
+                    pid: process.pid,
+                    acquiredAt: formatChinaDateTime(),
+                }), { flag: "wx" });
+                return {
+                    release: async () => {
+                        await rm(lockPath, { force: true });
+                    },
+                };
+            }
+            catch (error) {
+                const code = error.code;
+                if (code !== "EEXIST") {
+                    throw error;
+                }
+                const cleared = await this.removeStaleRunLock(lockPath);
+                if (!cleared) {
+                    return null;
+                }
+            }
+        }
+        return null;
+    }
+    async removeStaleRunLock(lockPath) {
+        try {
+            const lockStat = await stat(lockPath);
+            const staleMs = Math.max(this.requestInterval * 4 * 1000, MONITOR_RUN_LOCK_MIN_STALE_MS);
+            if (Date.now() - lockStat.mtimeMs <= staleMs) {
+                return false;
+            }
+            await rm(lockPath, { force: true });
+            return true;
+        }
+        catch (error) {
+            if (error.code === "ENOENT") {
+                return true;
+            }
+            throw error;
+        }
+    }
     async trySendAlert(symbol, ruleName, input) {
         const sessionKey = getSessionKey();
         if (await this.alertLogRepository.isSentThisSession(symbol, ruleName, sessionKey)) {
+            await this.cleanupAlertMedia(input);
             return false;
         }
-        const result = await this.alertService.sendWithResult(input);
+        const result = await this.sendAlertAndCleanupMedia(input);
         if (!result.ok) {
             return false;
         }
-        if (typeof input !== "string" && input.mediaPath && result.mediaDelivered) {
-            await this.alertMediaService.removeFile(input.mediaPath);
-        }
         const message = typeof input === "string" ? input : input.message;
         await this.alertLogRepository.append({
             symbol,
@@ -379,6 +433,13 @@ export class MonitorService {
         });
         return true;
     }
+    async trySendCandidate(item, quote, candidate, levels, getIntradayRows) {
+        if (await this.hasSentAlert(item.symbol, candidate.ruleName)) {
+            return false;
+        }
+        const delivery = await this.buildAlertDelivery(item, quote, candidate, levels, getIntradayRows);
+        return this.trySendAlert(item.symbol, candidate.ruleName, delivery);
+    }
     async buildAlertDelivery(item, quote, candidate, levels, getIntradayRows) {
         if (!candidate.image || !levels) {
             return candidate.message;
@@ -473,6 +534,26 @@ export class MonitorService {
             }),
         };
     }
+    async hasSentAlert(symbol, ruleName) {
+        return this.alertLogRepository.isSentThisSession(symbol, ruleName, getSessionKey());
+    }
+    async sendAlertAndCleanupMedia(input) {
+        try {
+            return await this.alertService.sendWithResult(input);
+        }
+        finally {
+            await this.cleanupAlertMedia(input);
+        }
+    }
+    async cleanupAlertMedia(input) {
+        if (typeof input === "string" || !input.mediaPath) {
+            return;
+        }
+        await this.alertMediaService.removeFile(input.mediaPath).catch(() => { });
+    }
+    getRunLockFilePath() {
+        return path.join(this.baseDir, "monitor-run.lock");
+    }
 }
 function formatRunningState(state, requestInterval) {
     const heartbeat = getHeartbeatStatus(state, requestInterval);
@@ -658,23 +739,58 @@ function buildPriceAlerts(item, quote, levels, alertService) {
     if (levels.stop_loss && currentPrice <= levels.stop_loss) {
         push("stop_loss_hit", "⛔ 触及止损", "价格已触及止损位，建议立即执行止损", levels.stop_loss);
     }
-    else if (levels.stop_loss && currentPrice <= levels.stop_loss * (1 + buffer)) {
+    else if (levels.stop_loss
+        && currentPrice > levels.stop_loss
+        && isWithinPriceBuffer(currentPrice, levels.stop_loss, buffer)) {
         push("stop_loss_near", "⚠️ 接近止损", "价格接近止损位，请保持警惕", levels.stop_loss);
     }
+    if (levels.take_profit && currentPrice >= levels.take_profit) {
+        push("take_profit_hit", "💰 触及止盈", "价格已达止盈位，建议分批止盈", levels.take_profit);
+    }
     if (levels.breakthrough && currentPrice >= levels.breakthrough) {
         push("breakthrough_hit", "🚀 突破", "价格已突破关键压力位，可能开启新行情", levels.breakthrough);
     }
-    if (levels.support && currentPrice <= levels.support * (1 + buffer)) {
+    if (levels.support && isWithinPriceBuffer(currentPrice, levels.support, buffer)) {
         push("support_near", "📉 触及支撑", "价格接近支撑位，关注是否企稳", levels.support);
     }
-    if (levels.resistance && currentPrice >= levels.resistance * (1 - buffer)) {
+    if (levels.resistance && isWithinPriceBuffer(currentPrice, levels.resistance, buffer)) {
         push("resistance_near", "📈 接近压力", "价格接近压力位，关注能否突破", levels.resistance);
     }
-    if (levels.take_profit && currentPrice >= levels.take_profit) {
-        push("take_profit_hit", "💰 触及止盈", "价格已达止盈位，建议分批止盈", levels.take_profit);
-    }
     return alerts;
 }
+function selectPrimaryAlertCandidate(candidates) {
+    let best = null;
+    let bestPriority = Number.NEGATIVE_INFINITY;
+    for (const candidate of candidates) {
+        const priority = getAlertPriority(candidate.ruleName);
+        if (priority > bestPriority) {
+            best = candidate;
+            bestPriority = priority;
+        }
+    }
+    return best;
+}
+function getAlertPriority(ruleName) {
+    switch (ruleName) {
+        case "stop_loss_hit":
+            return 600;
+        case "take_profit_hit":
+            return 500;
+        case "breakthrough_hit":
+            return 400;
+        case "stop_loss_near":
+            return 300;
+        case "support_near":
+            return 200;
+        case "resistance_near":
+            return 100;
+        default:
+            return 0;
+    }
+}
+function isWithinPriceBuffer(currentPrice, levelPrice, buffer) {
+    return currentPrice >= levelPrice * (1 - buffer) && currentPrice <= levelPrice * (1 + buffer);
+}
 function buildChangeAlert(item, quote, levels, alertService) {
     const currentPrice = Number(quote.last_price);
     const prevClose = Number(quote.prev_close ?? 0);

package/dist/services/post-close-review-service.d.ts

@@ -8,6 +8,8 @@ import { KeyLevelsRepository } from "../storage/repositories/key-levels-repo.js"
 import { KeyLevelsHistoryRepository } from "../storage/repositories/key-levels-history-repo.js";
 import { KlinesRepository } from "../storage/repositories/klines-repo.js";
 import { IntradayKlinesRepository } from "../storage/repositories/intraday-klines-repo.js";
+import { Jin10FlashDeliveryRepository } from "../storage/repositories/jin10-flash-delivery-repo.js";
+import { Jin10FlashRepository } from "../storage/repositories/jin10-flash-repo.js";
 export interface PostCloseReviewRunResult {
     overviewMessage: string;
     detailMessages: string[];
@@ -22,11 +24,14 @@ export declare class PostCloseReviewService {
     private readonly keyLevelsHistoryRepository;
     private readonly klinesRepository;
     private readonly intradayKlinesRepository;
-    constructor(watchlistService: WatchlistService, compositeAnalysisOrchestrator: CompositeAnalysisOrchestrator, analysisService: AnalysisService, postCloseReviewTask: PostCloseReviewTask, keyLevelsRepository: KeyLevelsRepository, keyLevelsHistoryRepository: KeyLevelsHistoryRepository, klinesRepository: KlinesRepository, intradayKlinesRepository: IntradayKlinesRepository);
+    private readonly flashDeliveryRepository;
+    private readonly flashRepository;
+    constructor(watchlistService: WatchlistService, compositeAnalysisOrchestrator: CompositeAnalysisOrchestrator, analysisService: AnalysisService, postCloseReviewTask: PostCloseReviewTask, keyLevelsRepository: KeyLevelsRepository, keyLevelsHistoryRepository: KeyLevelsHistoryRepository, klinesRepository: KlinesRepository, intradayKlinesRepository: IntradayKlinesRepository, flashDeliveryRepository: Jin10FlashDeliveryRepository, flashRepository: Jin10FlashRepository);
     run(): Promise<PostCloseReviewRunResult>;
     private persistReview;
     private persistFallbackCompositeReview;
     private buildValidationContext;
+    private buildFlashContext;
     private formatOverviewMessage;
     private formatDetailMessage;
     private formatFailureMessage;

package/dist/services/post-close-review-service.js

@@ -1,6 +1,11 @@
 import { formatChinaDateTime } from "../utils/china-time.js";
 const LEVEL_BUFFER = 0.005;
 const INTRADAY_PERIOD = "1m";
+const MARKET_OVERVIEW_FLASH_KEYWORDS = [
+    "港股收评",
+    "金十数据整理：每日投行/机构观点梳理",
+    "金十数据整理：A股每日市场要闻回顾",
+];
 export class PostCloseReviewService {
     watchlistService;
     compositeAnalysisOrchestrator;
@@ -10,7 +15,9 @@ export class PostCloseReviewService {
     keyLevelsHistoryRepository;
     klinesRepository;
     intradayKlinesRepository;
-    constructor(watchlistService, compositeAnalysisOrchestrator, analysisService, postCloseReviewTask, keyLevelsRepository, keyLevelsHistoryRepository, klinesRepository, intradayKlinesRepository) {
+    flashDeliveryRepository;
+    flashRepository;
+    constructor(watchlistService, compositeAnalysisOrchestrator, analysisService, postCloseReviewTask, keyLevelsRepository, keyLevelsHistoryRepository, klinesRepository, intradayKlinesRepository, flashDeliveryRepository, flashRepository) {
         this.watchlistService = watchlistService;
         this.compositeAnalysisOrchestrator = compositeAnalysisOrchestrator;
         this.analysisService = analysisService;
@@ -19,6 +26,8 @@ export class PostCloseReviewService {
         this.keyLevelsHistoryRepository = keyLevelsHistoryRepository;
         this.klinesRepository = klinesRepository;
         this.intradayKlinesRepository = intradayKlinesRepository;
+        this.flashDeliveryRepository = flashDeliveryRepository;
+        this.flashRepository = flashRepository;
     }
     async run() {
         const watchlist = await this.watchlistService.list();
@@ -41,10 +50,12 @@ export class PostCloseReviewService {
                 const tradeDate = input.market.klines[input.market.klines.length - 1]?.trade_date ?? formatChinaDateTime().slice(0, 10);
                 const validation = await this.buildValidationContext(item.symbol, tradeDate);
                 compositeResult = await this.compositeAnalysisOrchestrator.analyzeInput(input);
+                const flashContext = await this.buildFlashContext(item.symbol, tradeDate);
                 const review = await this.analysisService.runTask(this.postCloseReviewTask, {
                     ...input,
                     compositeResult,
                     validation,
+                    flashContext,
                 });
                 const message = this.formatDetailMessage(item, validation, review);
                 await this.persistReview(item.symbol, message, review);
@@ -154,6 +165,25 @@ export class PostCloseReviewService {
             lines,
         };
     }
+    async buildFlashContext(symbol, datePrefix) {
+        const [deliveries, overviewFlashes] = await Promise.all([
+            this.flashDeliveryRepository.listBySymbolsAndDate([symbol], datePrefix),
+            this.flashRepository.searchByContentKeywords(MARKET_OVERVIEW_FLASH_KEYWORDS, datePrefix),
+        ]);
+        const stockAlerts = deliveries.map((entry) => ({
+            publishedAt: entry.published_at,
+            content: entry.reason,
+            headline: entry.headline,
+            source: "stock_alert",
+        }));
+        const marketOverviewFlashes = overviewFlashes.map((record) => ({
+            publishedAt: record.published_at,
+            content: record.content,
+            headline: extractHeadlineFromContent(record.content),
+            source: "market_overview",
+        }));
+        return { stockAlerts, marketOverviewFlashes };
+    }
     formatOverviewMessage(marketOverview, entries) {
         const successEntries = entries.filter((entry) => entry.ok);
         const failureCount = entries.length - successEntries.length;
@@ -496,3 +526,7 @@ function formatPriceRail(markers) {
         .map((entry) => `${entry.parts.join("/")} ${entry.value.toFixed(2)}`)
         .join(" → ");
 }
+function extractHeadlineFromContent(content) {
+    const firstLine = content.split(/[\n。！!]/)[0]?.trim() ?? "";
+    return firstLine.length > 60 ? `${firstLine.slice(0, 60)}...` : firstLine;
+}

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

@@ -6,5 +6,6 @@ export declare class Jin10FlashDeliveryRepository {
     append(entry: Jin10FlashDeliveryEntry): Promise<void>;
     hasDelivered(flashKey: string): Promise<boolean>;
     countSinceDeliveredAt(deliveredAt: string): Promise<number>;
+    listBySymbolsAndDate(symbols: string[], datePrefix: string): Promise<Jin10FlashDeliveryEntry[]>;
     pruneOlderThanDeliveredAt(deliveredAt: string): Promise<void>;
 }

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

@@ -32,6 +32,20 @@ export class Jin10FlashDeliveryRepository {
         const table = await this.db.openTable(JIN10_FLASH_DELIVERY_TABLE);
         return table.countRows(`delivered_at >= '${escapeSqlString(deliveredAt)}'`);
     }
+    async listBySymbolsAndDate(symbols, datePrefix) {
+        if (symbols.length === 0 || !(await this.db.hasTable(JIN10_FLASH_DELIVERY_TABLE))) {
+            return [];
+        }
+        const table = await this.db.openTable(JIN10_FLASH_DELIVERY_TABLE);
+        const rows = (await table
+            .query()
+            .where(`delivered_at >= '${escapeSqlString(datePrefix)} 00:00:00'`)
+            .toArray());
+        const symbolSet = new Set(symbols);
+        return rows
+            .map((row) => fromDeliveryRow(row))
+            .filter((entry) => entry.symbols.some((s) => symbolSet.has(s)));
+    }
     async pruneOlderThanDeliveredAt(deliveredAt) {
         if (!(await this.db.hasTable(JIN10_FLASH_DELIVERY_TABLE))) {
             return;
@@ -52,6 +66,28 @@ function toDeliveryRow(entry) {
         delivered_at: entry.delivered_at,
     };
 }
+function fromDeliveryRow(row) {
+    let symbols = [];
+    try {
+        const parsed = JSON.parse(String(row.symbols_json ?? "[]"));
+        if (Array.isArray(parsed)) {
+            symbols = parsed.map((v) => String(v));
+        }
+    }
+    catch {
+        // ignore
+    }
+    return {
+        flash_key: String(row.flash_key ?? ""),
+        published_at: String(row.published_at ?? ""),
+        symbols,
+        headline: String(row.headline ?? ""),
+        reason: String(row.reason ?? ""),
+        importance: String(row.importance ?? "medium"),
+        message: String(row.message ?? ""),
+        delivered_at: String(row.delivered_at ?? ""),
+    };
+}
 function escapeSqlString(value) {
     return value.replace(/'/g, "''");
 }

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>;
+    searchByContentKeywords(keywords: string[], datePrefix: string): Promise<Jin10FlashRecord[]>;
     pruneOlderThanPublishedTs(publishedTs: number): Promise<void>;
     private listExistingKeys;
 }

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

@@ -54,6 +54,24 @@ export class Jin10FlashRepository {
         const table = await this.db.openTable(JIN10_FLASH_TABLE);
         return table.countRows(`published_ts >= ${Math.trunc(publishedTs)}`);
     }
+    async searchByContentKeywords(keywords, datePrefix) {
+        if (keywords.length === 0 || !(await this.db.hasTable(JIN10_FLASH_TABLE))) {
+            return [];
+        }
+        const dayStart = `${datePrefix} 00:00:00`;
+        const dayStartTs = new Date(`${dayStart.replace(" ", "T")}+08:00`).getTime();
+        if (Number.isNaN(dayStartTs)) {
+            return [];
+        }
+        const table = await this.db.openTable(JIN10_FLASH_TABLE);
+        const rows = (await table
+            .query()
+            .where(`published_ts >= ${Math.trunc(dayStartTs)}`)
+            .toArray());
+        return rows
+            .map((row) => fromFlashRow(row))
+            .filter((record) => keywords.some((kw) => record.content.includes(kw)));
+    }
     async pruneOlderThanPublishedTs(publishedTs) {
         if (!(await this.db.hasTable(JIN10_FLASH_TABLE))) {
             return;

package/dist/utils/china-time.d.ts

@@ -1,3 +1,4 @@
 export declare function chinaNow(): Date;
 export declare function formatChinaDateTime(date?: Date): string;
 export declare function chinaToday(date?: Date): string;
+export declare function chinaHour(date?: Date): number;

package/dist/utils/china-time.js

@@ -16,3 +16,8 @@ export function formatChinaDateTime(date = chinaNow()) {
 export function chinaToday(date = chinaNow()) {
     return formatChinaDateTime(date).slice(0, 10);
 }
+export function chinaHour(date = chinaNow()) {
+    const utcMs = date.getTime() + date.getTimezoneOffset() * 60_000;
+    const chinaDate = new Date(utcMs + CHINA_OFFSET_HOURS * 60 * 60 * 1000);
+    return chinaDate.getUTCHours();
+}

package/openclaw.plugin.json

@@ -1,7 +1,7 @@
 {
   "id": "tickflow-assist",
   "name": "TickFlow Assist",
-  "version": "0.3.1",
+  "version": "0.3.3",
   "description": "A-share watchlist analysis, monitoring, and alert delivery powered by TickFlow and OpenClaw.",
   "skills": [
     "skills"
@@ -58,6 +58,11 @@
         "default": 7,
         "description": "How many days of raw Jin10 flash data to retain locally."
       },
+      "jin10FlashNightAlert": {
+        "type": "boolean",
+        "default": false,
+        "description": "When true, flash alerts fire 24/7. When false, suppress alerts between 22:00 and 06:00 Beijing time."
+      },
       "llmBaseUrl": {
         "type": "string",
         "default": "https://api.openai.com/v1",
@@ -167,6 +172,11 @@
       "help": "How many days of Jin10 raw flash data to keep locally.",
       "advanced": true
     },
+    "jin10FlashNightAlert": {
+      "label": "Jin10 Night Alert",
+      "help": "Set to false to suppress flash alerts between 22:00-06:00 Beijing time.",
+      "advanced": true
+    },
     "llmBaseUrl": {
       "label": "LLM Base URL",
       "help": "OpenAI-compatible analysis endpoint."

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tickflow-assist",
-  "version": "0.3.1",
+  "version": "0.3.3",
   "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",
+    "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",
     "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.1"
+      "openclawVersion": "2026.4.5"
     },
     "compat": {
       "pluginApi": ">=2026.3.31",
       "minGatewayVersion": "2026.3.31",
-      "builtWithOpenClawVersion": "2026.4.1"
+      "builtWithOpenClawVersion": "2026.4.5"
     },
     "extensions": [
       "dist/plugin.js"
@@ -69,9 +69,9 @@
   },
   "devDependencies": {
     "@types/node": "^22.13.11",
-    "openclaw": "^2026.4.1",
+    "openclaw": "^2026.4.5",
     "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.1` 修复 GitHub Actions 自动发布 npm 包时的 provenance 仓库元数据校验失败，并将金十数据 MCP 握手里的 `clientInfo` 调整为中性固定值。完整发布记录见 <https://github.com/robinspt/tickflow-assist/blob/main/CHANGELOG.md>。\n\n当前主线按 OpenClaw `v2026.3.31+` 对齐，并已验证社区安装在 `v2026.4.1` 上兼容。\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 小时金十数据快讯监控；`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.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",
   "readmeFilename": "README.md"
 }