tickflow-assist 0.2.18 → 0.3.1

package/README.md

@@ -1,10 +1,10 @@
 # TickFlow Assist
 
-基于 [OpenClaw](https://openclaw.ai) 的 A 股监控与分析插件。它使用 [TickFlow](https://tickflow.org/auth/register?ref=BUJ54JEDGE) 获取行情与财务数据，结合 LLM 生成技术面、基本面、资讯面的综合判断，并把结果持久化到本地 LanceDB。
+基于 [OpenClaw](https://openclaw.ai) 的 A 股监控与分析插件。它使用 [TickFlow](https://tickflow.org/auth/register?ref=BUJ54JEDGE) 获取行情与财务数据，并可选接入 [金十数据 MCP](https://mcp.jin10.com/app/) 快讯流，结合 LLM 生成技术面、基本面、资讯面的综合判断，并把结果持久化到本地 LanceDB。
 
-最近更新：`v0.2.18` 调整 PNG 告警卡的日内时间轴与午间衔接逻辑，修复测试图与 demo 图的时间展示不一致；同时修正社区版配置字段说明，并补强 npm 打包脚本对包页 README 元数据的处理。
+最近更新：`v0.3.1` 修复 GitHub Actions 自动发布 npm 包时的 provenance 仓库元数据校验失败，并将金十数据 MCP 握手里的 `clientInfo` 调整为中性固定值。完整发布记录见 <https://github.com/robinspt/tickflow-assist/blob/main/CHANGELOG.md>。
 
-当前主线按 OpenClaw `v2026.3.31+` 对齐。
+当前主线按 OpenClaw `v2026.3.31+` 对齐，并已验证社区安装在 `v2026.4.1` 上兼容。
 
 ## 安装
 
@@ -81,23 +81,30 @@ plugins.entries["tickflow-assist"].config
 - 核心运行：`tickflowApiKey`、`llmApiKey`、`llmBaseUrl`、`llmModel`
 - 本地数据：`databasePath`、`calendarFile`
 - 告警投递：`alertChannel`、`alertTarget`、`alertAccount`
-- 能力补充：`mxSearchApiKey`
+- 能力补充：`mxSearchApiKey`、`jin10ApiToken`
 
-其中，`mxSearchApiKey` 用于 `mx_search`、`mx_select_stock` 以及非 `Expert` 财务链路的 lite 补充；`alertTarget`、`alertAccount` 建议在准备启用 `test_alert`、实时监控告警和定时通知前一并配好，避免配置不完整导致功能缺失。
+其中，`mxSearchApiKey` 用于 `mx_search`、`mx_select_stock` 以及非 `Expert` 财务链路的 lite 补充；`jin10ApiToken` 用于 24 小时金十数据快讯监控；`alertTarget`、`alertAccount` 建议在准备启用 `test_alert`、实时监控告警、金十数据快讯告警和定时通知前一并配好，避免配置不完整导致功能缺失。
 
 ## 功能
 
 - 自选股管理、日 K / 分钟 K 抓取与指标计算
 - 技术面、财务面、资讯面的综合分析
 - 实时监控、定时日更、收盘后复盘
+- 金十数据 24 小时快讯监控与自选关联提醒
 - 本地 LanceDB 数据留痕与分析结果查看
 
 ## 运行说明
 
 - 插件会在本地 `databasePath` 下持久化 LanceDB 数据。
-- 后台服务会按配置执行定时日更与实时监控。
+- 后台服务会按配置执行定时日更、实时监控与金十数据快讯监控。
 - Python 子模块仅用于技术指标计算，不承担主业务流程。
 
+## 依赖与可选能力
+
+- [TickFlow](https://tickflow.org/auth/register?ref=BUJ54JEDGE)：提供日线、分钟线、实时行情与财务数据接口。
+- [金十数据 MCP](https://mcp.jin10.com/app/)：可选，用于 24 小时快讯流接入、自选关联筛选与事件驱动告警。
+- [东方财富妙想 Skills](https://marketing.dfcfs.com/views/finskillshub/)：可选，用于 `mx_search`、`mx_select_stock` 与非 `Expert` 财务链路的 lite 补充。
+
 ## 仓库
 
 - GitHub: <https://github.com/robinspt/tickflow-assist>

package/dist/analysis/parsers/flash-alert-decision.parser.d.ts

@@ -0,0 +1,8 @@
+export interface FlashAlertDecision {
+    alert: boolean;
+    importance: "high" | "medium" | "low";
+    relevantSymbols: string[];
+    headline: string;
+    reason: string;
+}
+export declare function parseFlashAlertDecision(responseText: string): FlashAlertDecision;

package/dist/analysis/parsers/flash-alert-decision.parser.js

@@ -0,0 +1,34 @@
+import { parseJsonBlock } from "./json-block.parser.js";
+export function parseFlashAlertDecision(responseText) {
+    const parsed = parseJsonBlock(responseText, {
+        requiredKeys: ["alert", "relevant_symbols"],
+    });
+    return {
+        alert: normalizeBoolean(parsed?.alert),
+        importance: normalizeImportance(parsed?.importance),
+        relevantSymbols: normalizeSymbols(parsed?.relevant_symbols),
+        headline: normalizeText(parsed?.headline),
+        reason: normalizeText(parsed?.reason),
+    };
+}
+function normalizeBoolean(value) {
+    return value === true;
+}
+function normalizeImportance(value) {
+    if (value === "high" || value === "low") {
+        return value;
+    }
+    return "medium";
+}
+function normalizeSymbols(value) {
+    if (!Array.isArray(value)) {
+        return [];
+    }
+    return value
+        .map((item) => String(item ?? "").trim())
+        .filter(Boolean)
+        .slice(0, 10);
+}
+function normalizeText(value) {
+    return typeof value === "string" ? value.trim() : "";
+}

package/dist/background/jin10-flash.worker.d.ts

@@ -0,0 +1,8 @@
+import { Jin10FlashMonitorService } from "../services/jin10-flash-monitor-service.js";
+export declare class Jin10FlashWorker {
+    private readonly monitorService;
+    private readonly intervalMs;
+    constructor(monitorService: Jin10FlashMonitorService, intervalMs: number);
+    runOnce(): Promise<number>;
+    runLoop(signal?: AbortSignal, runtimeHost?: "plugin_service" | "fallback_process"): Promise<void>;
+}

package/dist/background/jin10-flash.worker.js

@@ -0,0 +1,24 @@
+import { sleepWithAbort } from "../utils/abortable-sleep.js";
+export class Jin10FlashWorker {
+    monitorService;
+    intervalMs;
+    constructor(monitorService, intervalMs) {
+        this.monitorService = monitorService;
+        this.intervalMs = intervalMs;
+    }
+    async runOnce() {
+        return this.monitorService.runMonitorOnce();
+    }
+    async runLoop(signal, runtimeHost) {
+        while (!signal?.aborted) {
+            await this.monitorService.recordHeartbeat(runtimeHost);
+            try {
+                await this.runOnce();
+            }
+            catch (error) {
+                await this.monitorService.recordLoopError(error);
+            }
+            await sleepWithAbort(this.intervalMs, signal);
+        }
+    }
+}

package/dist/bootstrap.d.ts

@@ -2,11 +2,13 @@ import type { PluginConfig } from "./config/schema.js";
 import { Database } from "./storage/db.js";
 import { WatchlistService } from "./services/watchlist-service.js";
 import { MonitorService } from "./services/monitor-service.js";
+import { Jin10FlashMonitorService } from "./services/jin10-flash-monitor-service.js";
 import { AlertService } from "./services/alert-service.js";
 import { AlertMediaService } from "./services/alert-media-service.js";
 import type { LocalTool, OpenClawPluginConfig, OpenClawPluginRuntime, RegisteredService } from "./runtime/plugin-api.js";
 import { RealtimeMonitorWorker } from "./background/realtime-monitor.worker.js";
 import { DailyUpdateWorker } from "./background/daily-update.worker.js";
+import { Jin10FlashWorker } from "./background/jin10-flash.worker.js";
 import type { WatchlistItem } from "./types/domain.js";
 export interface AppContext {
     config: PluginConfig;
@@ -22,7 +24,9 @@ export interface AppContext {
         alertService: AlertService;
         alertMediaService: AlertMediaService;
         monitorService: MonitorService;
+        jin10FlashMonitorService: Jin10FlashMonitorService;
         realtimeMonitorWorker: RealtimeMonitorWorker;
+        jin10FlashWorker: Jin10FlashWorker;
         dailyUpdateWorker: DailyUpdateWorker;
         watchlistService: WatchlistService;
         database: Database;

package/dist/bootstrap.js

@@ -6,6 +6,7 @@ import { IndicatorService } from "./services/indicator-service.js";
 import { FinancialService } from "./services/financial-service.js";
 import { FinancialLiteService } from "./services/financial-lite-service.js";
 import { MxApiService } from "./services/mx-search-service.js";
+import { Jin10McpService } from "./services/jin10-mcp-service.js";
 import { Database } from "./storage/db.js";
 import { WatchlistRepository } from "./storage/repositories/watchlist-repo.js";
 import { KlinesRepository } from "./storage/repositories/klines-repo.js";
@@ -19,6 +20,8 @@ import { TechnicalAnalysisRepository } from "./storage/repositories/technical-an
 import { FinancialAnalysisRepository } from "./storage/repositories/financial-analysis-repo.js";
 import { NewsAnalysisRepository } from "./storage/repositories/news-analysis-repo.js";
 import { CompositeAnalysisRepository } from "./storage/repositories/composite-analysis-repo.js";
+import { Jin10FlashRepository } from "./storage/repositories/jin10-flash-repo.js";
+import { Jin10FlashDeliveryRepository } from "./storage/repositories/jin10-flash-delivery-repo.js";
 import { WatchlistService } from "./services/watchlist-service.js";
 import { WatchlistProfileService } from "./services/watchlist-profile-service.js";
 import { AnalysisService } from "./services/analysis-service.js";
@@ -26,6 +29,7 @@ import { AnalysisViewService } from "./services/analysis-view-service.js";
 import { QuoteService } from "./services/quote-service.js";
 import { TradingCalendarService } from "./services/trading-calendar-service.js";
 import { MonitorService } from "./services/monitor-service.js";
+import { Jin10FlashMonitorService } from "./services/jin10-flash-monitor-service.js";
 import { AlertService } from "./services/alert-service.js";
 import { AlertMediaService } from "./services/alert-media-service.js";
 import { UpdateService } from "./services/update-service.js";
@@ -47,6 +51,7 @@ import { analyzeTool } from "./tools/analyze.tool.js";
 import { fetchKlinesTool } from "./tools/fetch-klines.tool.js";
 import { fetchIntradayKlinesTool } from "./tools/fetch-intraday-klines.tool.js";
 import { fetchFinancialsTool } from "./tools/fetch-financials.tool.js";
+import { flashMonitorStatusTool } from "./tools/flash-monitor-status.tool.js";
 import { mxSearchTool } from "./tools/mx-search.tool.js";
 import { mxSelectStockTool } from "./tools/mx-select-stock.tool.js";
 import { listWatchlistTool } from "./tools/list-watchlist.tool.js";
@@ -68,6 +73,7 @@ import { createCommandRunner } from "./runtime/command-runner.js";
 import { resolvePreferredOpenClawTmpDir } from "./runtime/openclaw-temp-dir.js";
 import { RealtimeMonitorWorker } from "./background/realtime-monitor.worker.js";
 import { DailyUpdateWorker } from "./background/daily-update.worker.js";
+import { Jin10FlashWorker } from "./background/jin10-flash.worker.js";
 export function createAppContext(config, options = {}) {
     const runtime = {
         configSource: options.configSource ?? "local_config",
@@ -90,11 +96,14 @@ export function createAppContext(config, options = {}) {
     const financialAnalysisRepository = new FinancialAnalysisRepository(database);
     const newsAnalysisRepository = new NewsAnalysisRepository(database);
     const compositeAnalysisRepository = new CompositeAnalysisRepository(database);
+    const jin10FlashRepository = new Jin10FlashRepository(database);
+    const jin10FlashDeliveryRepository = new Jin10FlashDeliveryRepository(database);
     const instrumentService = new InstrumentService(tickflowClient);
     const klineService = new KlineService(tickflowClient);
     const quoteService = new QuoteService(tickflowClient);
     const financialService = new FinancialService(tickflowClient);
     const mxApiService = new MxApiService(config.mxSearchApiUrl, config.mxSearchApiKey);
+    const jin10McpService = new Jin10McpService(config.jin10McpUrl, config.jin10ApiToken);
     const financialLiteService = new FinancialLiteService(mxApiService);
     const analysisService = new AnalysisService(config.llmBaseUrl, config.llmApiKey, config.llmModel, analysisLogRepository);
     const watchlistProfileService = new WatchlistProfileService(mxApiService, analysisService);
@@ -128,9 +137,11 @@ 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 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 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);
     let managedLoopAbortController = null;
     let managedLoopPromise = null;
@@ -143,6 +154,7 @@ export function createAppContext(config, options = {}) {
             dailyUpdateStatusTool(dailyUpdateWorker, runtime.configSource),
             fetchIntradayKlinesTool(config.tickflowApiKeyLevel, klineService, intradayKlinesRepository, tradingCalendarService),
             fetchFinancialsTool(financialService),
+            flashMonitorStatusTool(jin10FlashMonitorService),
             fetchKlinesTool(klineService, klinesRepository, indicatorService, indicatorsRepository),
             listWatchlistTool(watchlistService),
             monitorStatusTool(monitorService),
@@ -175,6 +187,9 @@ export function createAppContext(config, options = {}) {
                         dailyUpdateWorker
                             .runLoop(abortController.signal, "plugin_service", runtime.configSource)
                             .catch(() => { }),
+                        jin10FlashWorker
+                            .runLoop(abortController.signal, "plugin_service")
+                            .catch(() => { }),
                         realtimeMonitorWorker
                             .runLoop(abortController.signal, "plugin_service")
                             .catch(() => { }),
@@ -198,7 +213,9 @@ export function createAppContext(config, options = {}) {
             alertService,
             alertMediaService,
             monitorService,
+            jin10FlashMonitorService,
             realtimeMonitorWorker,
+            jin10FlashWorker,
             dailyUpdateWorker,
             watchlistService,
             database,

package/dist/config/normalize.js

@@ -48,6 +48,10 @@ export function normalizePluginConfig(input) {
         tickflowApiKeyLevel: normalizeTickflowApiKeyLevel(raw.tickflowApiKeyLevel, DEFAULT_PLUGIN_CONFIG.tickflowApiKeyLevel),
         mxSearchApiUrl: normalizeString(raw.mxSearchApiUrl, envMxSearchApiUrl || DEFAULT_PLUGIN_CONFIG.mxSearchApiUrl),
         mxSearchApiKey: normalizeString(raw.mxSearchApiKey, envMxSearchApiKey || DEFAULT_PLUGIN_CONFIG.mxSearchApiKey),
+        jin10McpUrl: normalizeString(raw.jin10McpUrl, DEFAULT_PLUGIN_CONFIG.jin10McpUrl),
+        jin10ApiToken: normalizeString(raw.jin10ApiToken),
+        jin10FlashPollInterval: normalizeInteger(raw.jin10FlashPollInterval, DEFAULT_PLUGIN_CONFIG.jin10FlashPollInterval),
+        jin10FlashRetentionDays: normalizeInteger(raw.jin10FlashRetentionDays, DEFAULT_PLUGIN_CONFIG.jin10FlashRetentionDays),
         llmBaseUrl: normalizeString(raw.llmBaseUrl, DEFAULT_PLUGIN_CONFIG.llmBaseUrl),
         llmApiKey: normalizeString(raw.llmApiKey),
         llmModel: normalizeString(raw.llmModel, DEFAULT_PLUGIN_CONFIG.llmModel),
@@ -74,18 +78,23 @@ export function resolvePluginConfigPaths(config, baseDir) {
 }
 export function validatePluginConfig(config) {
     const errors = [];
-    if (!config.tickflowApiKey) {
-        errors.push("tickflowApiKey is required");
-    }
-    if (!config.llmApiKey) {
-        errors.push("llmApiKey is required");
-    }
+    // Community install scans happen before `configure-openclaw` writes secrets,
+    // so registration-time validation should only flag structurally invalid values.
     if (!config.tickflowApiUrl.startsWith("http://") && !config.tickflowApiUrl.startsWith("https://")) {
         errors.push("tickflowApiUrl must be an absolute http(s) URL");
     }
+    if (config.jin10McpUrl && !config.jin10McpUrl.startsWith("http://") && !config.jin10McpUrl.startsWith("https://")) {
+        errors.push("jin10McpUrl must be an absolute http(s) URL");
+    }
     if (config.requestInterval < 5) {
         errors.push("requestInterval must be at least 5 seconds");
     }
+    if (config.jin10FlashPollInterval < 10) {
+        errors.push("jin10FlashPollInterval must be at least 10 seconds");
+    }
+    if (config.jin10FlashRetentionDays < 1) {
+        errors.push("jin10FlashRetentionDays must be at least 1 day");
+    }
     return errors;
 }
 function resolveConfigPath(value, baseDir) {

package/dist/config/schema.d.ts

@@ -5,6 +5,10 @@ export interface PluginConfig {
     tickflowApiKeyLevel: TickflowApiKeyLevel;
     mxSearchApiUrl: string;
     mxSearchApiKey: string;
+    jin10McpUrl: string;
+    jin10ApiToken: string;
+    jin10FlashPollInterval: number;
+    jin10FlashRetentionDays: number;
     llmBaseUrl: string;
     llmApiKey: string;
     llmModel: string;
@@ -20,4 +24,4 @@ export interface PluginConfig {
     pythonArgs: string[];
     pythonWorkdir: string;
 }
-export declare const DEFAULT_PLUGIN_CONFIG: Omit<PluginConfig, "tickflowApiKey" | "llmApiKey" | "alertTarget">;
+export declare const DEFAULT_PLUGIN_CONFIG: Omit<PluginConfig, "tickflowApiKey" | "jin10ApiToken" | "llmApiKey" | "alertTarget">;

package/dist/config/schema.js

@@ -3,6 +3,9 @@ export const DEFAULT_PLUGIN_CONFIG = {
     tickflowApiKeyLevel: "free",
     mxSearchApiUrl: "https://mkapi2.dfcfs.com/finskillshub/api/claw",
     mxSearchApiKey: "",
+    jin10McpUrl: "https://mcp.jin10.com/mcp",
+    jin10FlashPollInterval: 300,
+    jin10FlashRetentionDays: 7,
     llmBaseUrl: "https://api.openai.com/v1",
     llmModel: "gpt-4o",
     databasePath: "./data/lancedb",

package/dist/dev/run-monitor-loop.js

@@ -6,11 +6,12 @@ async function main() {
     const config = await loadLocalConfig();
     const app = createAppContext(config, { configSource: "local_config" });
     const worker = app.services.realtimeMonitorWorker;
+    const flashWorker = app.services.jin10FlashWorker;
     const alertService = app.services.alertService;
     const monitorService = app.services.monitorService;
     await monitorService.recordHeartbeat("fallback_process");
     await monitorService.setWorkerPid(process.pid);
-    process.stdout.write(`TickFlow monitor loop started, interval=${config.requestInterval}s\n`);
+    process.stdout.write(`TickFlow realtime loop started, price_interval=${config.requestInterval}s, jin10_interval=${config.jin10FlashPollInterval}s\n`);
     const controller = new AbortController();
     const shutdown = async (signal) => {
         controller.abort();
@@ -29,7 +30,10 @@ async function main() {
     process.on("SIGINT", () => void shutdown("SIGINT"));
     process.on("SIGTERM", () => void shutdown("SIGTERM"));
     try {
-        await worker.runLoop(controller.signal, "fallback_process");
+        await Promise.all([
+            worker.runLoop(controller.signal, "fallback_process"),
+            flashWorker.runLoop(controller.signal, "fallback_process"),
+        ]);
     }
     catch (error) {
         const message = error instanceof Error ? error.message : String(error);

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

@@ -13,6 +13,9 @@ const DEFAULTS = {
     tickflowApiKeyLevel: "Free",
     mxSearchApiUrl: "https://mkapi2.dfcfs.com/finskillshub/api/claw",
     mxSearchApiKey: "",
+    jin10McpUrl: "https://mcp.jin10.com/mcp",
+    jin10FlashPollInterval: 300,
+    jin10FlashRetentionDays: 7,
     llmBaseUrl: "https://api.openai.com/v1",
     llmModel: "gpt-4o",
     requestInterval: 30,
@@ -43,6 +46,8 @@ Options:
   --tickflow-api-key <key>
   --tickflow-api-key-level <Free|Start|Pro|Expert>
   --mx-search-api-key <key>
+  --jin10-mcp-url <url>
+  --jin10-api-token <token>
   --llm-base-url <url>
   --llm-api-key <key>
   --llm-model <name>
@@ -135,6 +140,12 @@ function parseArgs(argv) {
             case "--mx-search-api-key":
                 options.overrides.mxSearchApiKey = requireValue(token);
                 break;
+            case "--jin10-mcp-url":
+                options.overrides.jin10McpUrl = requireValue(token);
+                break;
+            case "--jin10-api-token":
+                options.overrides.jin10ApiToken = requireValue(token);
+                break;
             case "--llm-base-url":
                 options.overrides.llmBaseUrl = requireValue(token);
                 break;
@@ -240,6 +251,8 @@ function getExistingPluginConfig(root) {
         ? config.pythonArgs.map((value) => String(value))
         : undefined;
     const requestInterval = Number(config.requestInterval ?? DEFAULTS.requestInterval);
+    const jin10FlashPollInterval = Number(config.jin10FlashPollInterval ?? DEFAULTS.jin10FlashPollInterval);
+    const jin10FlashRetentionDays = Number(config.jin10FlashRetentionDays ?? DEFAULTS.jin10FlashRetentionDays);
     const dailyUpdateNotify = typeof config.dailyUpdateNotify === "boolean"
         ? config.dailyUpdateNotify
         : DEFAULTS.dailyUpdateNotify;
@@ -249,6 +262,14 @@ function getExistingPluginConfig(root) {
         tickflowApiKeyLevel: normalizeApiKeyLevel(stringValue(config.tickflowApiKeyLevel, DEFAULTS.tickflowApiKeyLevel)),
         mxSearchApiUrl: stringValue(config.mxSearchApiUrl, DEFAULTS.mxSearchApiUrl),
         mxSearchApiKey: stringValue(config.mxSearchApiKey, DEFAULTS.mxSearchApiKey),
+        jin10McpUrl: stringValue(config.jin10McpUrl, DEFAULTS.jin10McpUrl),
+        jin10ApiToken: stringValue(config.jin10ApiToken),
+        jin10FlashPollInterval: Number.isFinite(jin10FlashPollInterval)
+            ? Math.max(10, Math.trunc(jin10FlashPollInterval))
+            : DEFAULTS.jin10FlashPollInterval,
+        jin10FlashRetentionDays: Number.isFinite(jin10FlashRetentionDays)
+            ? Math.max(1, Math.trunc(jin10FlashRetentionDays))
+            : DEFAULTS.jin10FlashRetentionDays,
         llmBaseUrl: stringValue(config.llmBaseUrl, DEFAULTS.llmBaseUrl),
         llmApiKey: stringValue(config.llmApiKey),
         llmModel: stringValue(config.llmModel, DEFAULTS.llmModel),
@@ -391,6 +412,10 @@ async function promptForConfig(options, existing, pluginDir, configPath) {
         tickflowApiKeyLevel: DEFAULTS.tickflowApiKeyLevel,
         mxSearchApiUrl: DEFAULTS.mxSearchApiUrl,
         mxSearchApiKey: DEFAULTS.mxSearchApiKey,
+        jin10McpUrl: DEFAULTS.jin10McpUrl,
+        jin10ApiToken: "",
+        jin10FlashPollInterval: DEFAULTS.jin10FlashPollInterval,
+        jin10FlashRetentionDays: DEFAULTS.jin10FlashRetentionDays,
         llmBaseUrl: DEFAULTS.llmBaseUrl,
         llmApiKey: "",
         llmModel: DEFAULTS.llmModel,
@@ -433,6 +458,7 @@ async function promptForConfig(options, existing, pluginDir, configPath) {
             { value: "Expert", label: "Expert" },
         ], 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.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);
@@ -549,6 +575,10 @@ function applyPluginConfig(root, config, target) {
         tickflowApiKeyLevel: config.tickflowApiKeyLevel,
         mxSearchApiUrl: config.mxSearchApiUrl,
         mxSearchApiKey: config.mxSearchApiKey,
+        jin10McpUrl: config.jin10McpUrl,
+        jin10ApiToken: config.jin10ApiToken,
+        jin10FlashPollInterval: config.jin10FlashPollInterval,
+        jin10FlashRetentionDays: config.jin10FlashRetentionDays,
         llmBaseUrl: config.llmBaseUrl,
         llmApiKey: config.llmApiKey,
         llmModel: config.llmModel,
@@ -679,11 +709,26 @@ function getManualMacosFontCommands() {
         "fc-cache -fv",
     ];
 }
+function getManualUvInstallCommands() {
+    if (process.platform === "win32") {
+        return [
+            "powershell -ExecutionPolicy ByPass -c \"irm https://astral.sh/uv/install.ps1 | iex\"",
+        ];
+    }
+    return [
+        "curl -LsSf https://astral.sh/uv/install.sh | sh",
+    ];
+}
 function printNextSteps(options, config) {
     console.log("");
     console.log("接下来的命令需要你手动执行。");
     let step = 1;
     if (options.pythonSetup) {
+        console.log(`${step}. 如未安装 uv，请先安装 uv`);
+        for (const command of getManualUvInstallCommands()) {
+            console.log(`   ${command}`);
+        }
+        step += 1;
         console.log(`${step}. 安装 Python 依赖`);
         console.log(`   cd ${config.pythonWorkdir}`);
         console.log("   uv sync");

package/dist/plugin-commands.js

@@ -81,6 +81,7 @@ export function registerPluginCommands(api, tools, app) {
     const startMonitor = getTool(tools, "start_monitor");
     const stopMonitor = getTool(tools, "stop_monitor");
     const monitorStatus = getTool(tools, "monitor_status");
+    const flashMonitorStatus = getTool(tools, "flash_monitor_status");
     const startDailyUpdate = getTool(tools, "start_daily_update");
     const stopDailyUpdate = getTool(tools, "stop_daily_update");
     const updateAll = getTool(tools, "update_all");
@@ -165,6 +166,12 @@ export function registerPluginCommands(api, tools, app) {
             requireAuth: true,
             handler: async () => runCommandText(() => runToolText(monitorStatus)),
         },
+        {
+            name: "ta_flashstatus",
+            description: "查看 Jin10 快讯监控状态，不经过 AI 对话。",
+            requireAuth: true,
+            handler: async () => runCommandText(() => runToolText(flashMonitorStatus)),
+        },
         {
             name: "ta_startdailyupdate",
             description: "启动定时日更任务，不经过 AI 对话。",

package/dist/prompts/analysis/flash-monitor-alert-prompt.d.ts

@@ -0,0 +1,11 @@
+import type { WatchlistItem } from "../../types/domain.js";
+import type { Jin10FlashRecord } from "../../types/jin10.js";
+export declare const FLASH_MONITOR_ALERT_SYSTEM_PROMPT = "\n\u4F60\u662F\u4E00\u4F4DA\u80A1\u76D8\u4E2D/\u76D8\u540E\u5FEB\u8BAF\u544A\u8B66\u7B5B\u9009\u5668\u3002\u4F60\u7684\u4EFB\u52A1\u662F\u5224\u65AD\u4E00\u6761\u91D1\u5341\u5FEB\u8BAF\uFF0C\u662F\u5426\u503C\u5F97\u5BF9\u5F53\u524D\u5173\u6CE8\u5217\u8868\u53D1\u9001\u4E00\u6B21\u544A\u8B66\u3002\n\n\u5224\u65AD\u89C4\u5219\uFF1A\n1. \u53EA\u6709\u5728\u5FEB\u8BAF\u4E0E\u5173\u6CE8\u80A1\u7968\u672C\u8EAB\uFF0C\u6216\u4E0E\u5176\u884C\u4E1A/\u9898\u6750\u5B58\u5728\u660E\u786E\u3001\u53EF\u6267\u884C\u3001\u77ED\u671F\u53EF\u80FD\u5F71\u54CD\u98CE\u9669\u504F\u597D\u7684\u5173\u8054\u65F6\uFF0C\u624D\u8FD4\u56DE alert=true\u3002\n2. \u76F4\u63A5\u70B9\u540D\u516C\u53F8/\u80A1\u7968\u4EE3\u7801\u7684\u516C\u544A\u3001\u8BA2\u5355\u3001\u4E2D\u6807\u3001\u51CF\u6301\u3001\u589E\u6301\u3001\u4E1A\u7EE9\u9884\u544A\u3001\u91CD\u7EC4\u3001\u76D1\u7BA1\u3001\u505C\u590D\u724C\u3001\u91CD\u5927\u4EA7\u54C1/\u9879\u76EE\u3001\u91CD\u8981\u884C\u4E1A\u653F\u7B56\uFF0C\u4F18\u5148\u7EA7\u6700\u9AD8\u3002\n3. \u7EAF\u6D77\u5916\u5B8F\u89C2\u3001\u5730\u7F18\u3001\u5546\u54C1\u62A5\u4EF7\u3001\u76F4\u64AD\u63A8\u5E7F\u3001\u56FE\u793A\u64AD\u62A5\u3001\u4E0EA\u80A1\u5019\u9009\u6807\u7684\u7F3A\u4E4F\u6E05\u6670\u4F20\u5BFC\u8DEF\u5F84\u7684\u5185\u5BB9\uFF0C\u4E0D\u8981\u89E6\u53D1\u544A\u8B66\u3002\n4. \u884C\u4E1A/\u9898\u6750\u7EA7\u5FEB\u8BAF\u53EA\u6709\u5728\u786E\u5B9E\u4F1A\u5F71\u54CD\u5019\u9009\u677F\u5757\u98CE\u9669\u504F\u597D\u65F6\uFF0C\u624D\u53EF\u89E6\u53D1\uFF1B\u6CDB\u6CDB\u800C\u8C08\u7684\u884C\u4E1A\u65B0\u95FB\u4E0D\u8981\u89E6\u53D1\u3002\n5. \u8F93\u51FA\u5FC5\u987B\u53EA\u6709\u4E00\u4E2A ```json \u4EE3\u7801\u5757\uFF0C\u7ED3\u6784\u5982\u4E0B\uFF1A\n{\n  \"alert\": boolean,\n  \"importance\": \"high\" | \"medium\" | \"low\",\n  \"relevant_symbols\": [\"000001\", \"600519\"],\n  \"headline\": \"\u7B80\u77ED\u544A\u8B66\u6807\u9898\",\n  \"reason\": \"20-50\u5B57\u4E2D\u6587\u7406\u7531\"\n}\n";
+export declare function buildFlashMonitorAlertUserPrompt(params: {
+    flash: Jin10FlashRecord;
+    candidates: Array<{
+        item: WatchlistItem;
+        directKeywords: string[];
+        boardKeywords: string[];
+    }>;
+}): string;

package/dist/prompts/analysis/flash-monitor-alert-prompt.js

@@ -0,0 +1,44 @@
+export const FLASH_MONITOR_ALERT_SYSTEM_PROMPT = `
+你是一位A股盘中/盘后快讯告警筛选器。你的任务是判断一条金十快讯，是否值得对当前关注列表发送一次告警。
+
+判断规则：
+1. 只有在快讯与关注股票本身，或与其行业/题材存在明确、可执行、短期可能影响风险偏好的关联时，才返回 alert=true。
+2. 直接点名公司/股票代码的公告、订单、中标、减持、增持、业绩预告、重组、监管、停复牌、重大产品/项目、重要行业政策，优先级最高。
+3. 纯海外宏观、地缘、商品报价、直播推广、图示播报、与A股候选标的缺乏清晰传导路径的内容，不要触发告警。
+4. 行业/题材级快讯只有在确实会影响候选板块风险偏好时，才可触发；泛泛而谈的行业新闻不要触发。
+5. 输出必须只有一个 \`\`\`json 代码块，结构如下：
+{
+  "alert": boolean,
+  "importance": "high" | "medium" | "low",
+  "relevant_symbols": ["000001", "600519"],
+  "headline": "简短告警标题",
+  "reason": "20-50字中文理由"
+}
+`;
+export function buildFlashMonitorAlertUserPrompt(params) {
+    return [
+        "请判断以下金十快讯是否值得触发一次A股自选告警。",
+        "",
+        "## 快讯",
+        `时间: ${params.flash.published_at}`,
+        `链接: ${params.flash.url}`,
+        `正文: ${params.flash.content}`,
+        "",
+        "## 一阶段候选命中",
+        ...params.candidates.map((candidate, index) => formatCandidate(index + 1, candidate.item, candidate.directKeywords, candidate.boardKeywords)),
+        "",
+        "请特别警惕误报：如果只是宽泛宏观信息、海外事件或商品行情，且没有明确传导到候选股票/行业，就不要发告警。",
+    ].join("\n");
+}
+function formatCandidate(index, item, directKeywords, boardKeywords) {
+    return [
+        `${index}. ${item.name}（${item.symbol}）`,
+        `   直接命中: ${formatKeywords(directKeywords)}`,
+        `   行业/题材命中: ${formatKeywords(boardKeywords)}`,
+        `   行业: ${item.sector ?? "未知"}`,
+        `   题材: ${item.themes.length > 0 ? item.themes.join("、") : "无"}`,
+    ].join("\n");
+}
+function formatKeywords(items) {
+    return items.length > 0 ? items.join("、") : "无";
+}

package/dist/prompts/analysis/index.d.ts

@@ -6,3 +6,4 @@ export { NEWS_ANALYSIS_SYSTEM_PROMPT, buildNewsAnalysisUserPrompt, } from "./new
 export { COMPOSITE_ANALYSIS_SYSTEM_PROMPT, buildCompositeAnalysisUserPrompt, } from "./composite-analysis-user-prompt.js";
 export { POST_CLOSE_REVIEW_SYSTEM_PROMPT, buildPostCloseReviewUserPrompt, } from "./post-close-review-user-prompt.js";
 export { WATCHLIST_PROFILE_EXTRACTION_SYSTEM_PROMPT, buildWatchlistProfileExtractionUserPrompt, } from "./watchlist-profile-extraction-prompt.js";
+export { FLASH_MONITOR_ALERT_SYSTEM_PROMPT, buildFlashMonitorAlertUserPrompt, } from "./flash-monitor-alert-prompt.js";

package/dist/prompts/analysis/index.js

@@ -6,3 +6,4 @@ export { NEWS_ANALYSIS_SYSTEM_PROMPT, buildNewsAnalysisUserPrompt, } from "./new
 export { COMPOSITE_ANALYSIS_SYSTEM_PROMPT, buildCompositeAnalysisUserPrompt, } from "./composite-analysis-user-prompt.js";
 export { POST_CLOSE_REVIEW_SYSTEM_PROMPT, buildPostCloseReviewUserPrompt, } from "./post-close-review-user-prompt.js";
 export { WATCHLIST_PROFILE_EXTRACTION_SYSTEM_PROMPT, buildWatchlistProfileExtractionUserPrompt, } from "./watchlist-profile-extraction-prompt.js";
+export { FLASH_MONITOR_ALERT_SYSTEM_PROMPT, buildFlashMonitorAlertUserPrompt, } from "./flash-monitor-alert-prompt.js";

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

@@ -60,6 +60,7 @@ export declare class AlertService {
     private combineErrors;
     private trySendPayload;
     private trySendViaRuntime;
+    private invokeRuntimeChannelSend;
     private trySendViaCommand;
     private buildCliArgs;
 }

package/dist/services/alert-service.js

@@ -153,20 +153,20 @@ export class AlertService {
         try {
             switch (this.channel) {
                 case "discord":
-                    await runtimeContext.runtime.channel.discord.sendMessageDiscord(this.options.target, payload.message, {
+                    await this.invokeRuntimeChannelSend(runtimeContext.runtime.channel, "discord", "sendMessageDiscord", this.options.target, payload.message, {
                         ...baseOptions,
                         filename: payload.filename,
                     });
                     return null;
                 case "slack":
-                    await runtimeContext.runtime.channel.slack.sendMessageSlack(this.options.target, payload.message, {
+                    await this.invokeRuntimeChannelSend(runtimeContext.runtime.channel, "slack", "sendMessageSlack", this.options.target, payload.message, {
                         ...baseOptions,
                         uploadFileName: payload.filename,
                         uploadTitle: payload.filename,
                     });
                     return null;
                 case "signal":
-                    await runtimeContext.runtime.channel.signal.sendMessageSignal(this.options.target, payload.message, baseOptions);
+                    await this.invokeRuntimeChannelSend(runtimeContext.runtime.channel, "signal", "sendMessageSignal", this.options.target, payload.message, baseOptions);
                     return null;
                 default:
                     // OpenClaw 2026.3.31 narrows the typed runtime channel surface.
@@ -178,6 +178,14 @@ export class AlertService {
             return `runtime delivery failed: ${formatErrorMessage(error)}`;
         }
     }
+    async invokeRuntimeChannelSend(runtimeChannel, channelName, methodName, target, message, options) {
+        const channelApi = getRuntimeChannelApi(runtimeChannel, channelName);
+        const method = channelApi?.[methodName];
+        if (typeof method !== "function") {
+            throw new Error(`runtime channel ${channelName}.${methodName} unavailable`);
+        }
+        await method.call(channelApi, target, message, options);
+    }
     async trySendViaCommand(payload) {
         try {
             const result = await this.runCommandWithTimeout(this.buildCliArgs(payload), { timeoutMs: 15_000 });
@@ -234,6 +242,16 @@ function normalizeSendInput(input) {
         ? { message: input }
         : input;
 }
+function getRuntimeChannelApi(runtimeChannel, channelName) {
+    if (!isRecord(runtimeChannel)) {
+        return null;
+    }
+    const channelApi = runtimeChannel[channelName];
+    return isRecord(channelApi) ? channelApi : null;
+}
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
 function getAlertStyle(ruleCode, fallbackTitle) {
     switch (ruleCode) {
         case "stop_loss_hit":