tickflow-assist 0.2.19 → 0.3.2

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.19` 调整社区版 OpenClaw 兼容声明，改为按范围声明 `pluginApi` 最低兼容版本并对齐 `builtWithOpenClawVersion` 到 `2026.4.1`，修复 `openclaw plugins update tickflow-assist` 在 `v2026.4.1` 上被精确版本校验拦截的问题。
+最近更新：`v0.3.2` 为金十快讯新增夜间静默配置并将默认值改为“开启静默”，同时把个股关联快讯与市场概览快讯接入收盘复盘上下文。完整发布记录见 <https://github.com/robinspt/tickflow-assist/blob/main/CHANGELOG.md>。
 
-当前主线按 OpenClaw `v2026.3.31+` 对齐，并已验证社区安装在 `v2026.4.1` 上兼容。
+当前主线按 OpenClaw `v2026.3.31+` 对齐，并已验证社区安装在 `v2026.4.5` 上兼容。
 
 ## 安装
 
@@ -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 小时金十数据快讯监控；`jin10FlashNightAlert` 默认 `false`（开启夜间静默），设为 `true` 可恢复 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/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/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, 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);
     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,11 @@ 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),
+        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),
@@ -74,18 +79,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,11 @@ export interface PluginConfig {
     tickflowApiKeyLevel: TickflowApiKeyLevel;
     mxSearchApiUrl: string;
     mxSearchApiKey: string;
+    jin10McpUrl: string;
+    jin10ApiToken: string;
+    jin10FlashPollInterval: number;
+    jin10FlashRetentionDays: number;
+    jin10FlashNightAlert: boolean;
     llmBaseUrl: string;
     llmApiKey: string;
     llmModel: string;
@@ -20,4 +25,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,10 @@ 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,
+    jin10FlashNightAlert: false,
     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,10 @@ const DEFAULTS = {
     tickflowApiKeyLevel: "Free",
     mxSearchApiUrl: "https://mkapi2.dfcfs.com/finskillshub/api/claw",
     mxSearchApiKey: "",
+    jin10McpUrl: "https://mcp.jin10.com/mcp",
+    jin10FlashPollInterval: 300,
+    jin10FlashRetentionDays: 7,
+    jin10FlashNightAlert: false,
     llmBaseUrl: "https://api.openai.com/v1",
     llmModel: "gpt-4o",
     requestInterval: 30,
@@ -43,6 +47,11 @@ 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>
+  --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>
@@ -135,6 +144,21 @@ 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 "--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;
@@ -240,6 +264,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 +275,17 @@ 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,
+        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),
@@ -391,6 +428,11 @@ 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,
+        jin10FlashNightAlert: DEFAULTS.jin10FlashNightAlert,
         llmBaseUrl: DEFAULTS.llmBaseUrl,
         llmApiKey: "",
         llmModel: DEFAULTS.llmModel,
@@ -433,6 +475,14 @@ 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.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);
@@ -549,6 +599,11 @@ 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,
+        jin10FlashNightAlert: config.jin10FlashNightAlert,
         llmBaseUrl: config.llmBaseUrl,
         llmApiKey: config.llmApiKey,
         llmModel: config.llmModel,
@@ -679,11 +734,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/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");
+}