tickflow-assist 0.3.7 → 0.3.8

package/dist/tools/screen-stock-candidates.tool.js

@@ -0,0 +1,477 @@
+import { formatTickflowApiKeyLevel, supportsIntradayKlines, } from "../config/tickflow-access.js";
+import { formatChinaDateTime } from "../utils/china-time.js";
+import { normalizeSymbol } from "../utils/symbol.js";
+import { resolveTickFlowQuoteChangePct } from "../utils/tickflow-quote.js";
+const DEFAULT_CANDIDATE_LIMIT = 3;
+const MAX_CANDIDATE_LIMIT = 8;
+const DEFAULT_DAILY_KLINE_COUNT = 20;
+const MAX_DAILY_KLINE_COUNT = 60;
+const DEFAULT_INTRADAY_COUNT = 20;
+const MAX_INTRADAY_COUNT = 60;
+const MAX_INTRADAY_CANDIDATES = 3;
+const MAX_FINANCIAL_CANDIDATES = 2;
+function parseInput(rawInput) {
+    if (typeof rawInput === "string" && rawInput.trim()) {
+        return buildInput({ keyword: rawInput.trim() });
+    }
+    if (typeof rawInput === "object" && rawInput !== null) {
+        const input = rawInput;
+        const keyword = String(input.keyword ?? input.query ?? input.q ?? "").trim();
+        if (!keyword) {
+            throw new Error("screen_stock_candidates requires keyword");
+        }
+        return buildInput({
+            keyword,
+            limit: input.limit,
+            dailyKlineCount: input.dailyKlineCount ?? input.klineCount,
+            includeDailyKlines: input.includeDailyKlines,
+            includeIntraday: input.includeIntraday,
+            intradayCount: input.intradayCount,
+            includeFinancial: input.includeFinancial,
+            summarize: input.summarize ?? input.llm,
+        });
+    }
+    throw new Error("invalid screen_stock_candidates input");
+}
+function buildInput(input) {
+    return {
+        keyword: input.keyword,
+        limit: parsePositiveInteger(input.limit, DEFAULT_CANDIDATE_LIMIT, MAX_CANDIDATE_LIMIT),
+        dailyKlineCount: parsePositiveInteger(input.dailyKlineCount, DEFAULT_DAILY_KLINE_COUNT, MAX_DAILY_KLINE_COUNT),
+        includeDailyKlines: parseOptionalBoolean(input.includeDailyKlines, true),
+        includeIntraday: parseOptionalBoolean(input.includeIntraday, false),
+        intradayCount: parsePositiveInteger(input.intradayCount, DEFAULT_INTRADAY_COUNT, MAX_INTRADAY_COUNT),
+        includeFinancial: parseOptionalBoolean(input.includeFinancial, false),
+        summarize: parseOptionalBoolean(input.summarize, false),
+    };
+}
+export function screenStockCandidatesTool(tickflowApiKeyLevel, mxApiService, quoteService, klineService, financialService, watchlistService, analysisService) {
+    return {
+        name: "screen_stock_candidates",
+        description: "Build a small enriched stock candidate pool from MX smart screening plus TickFlow quote/daily K-line data, with strict candidate limits by design.",
+        async run({ rawInput }) {
+            let input;
+            try {
+                input = parseInput(rawInput);
+            }
+            catch (error) {
+                return `智能选股联动失败😔 ${formatError(error)}`;
+            }
+            try {
+                const mxResult = await mxApiService.selectStocks({
+                    keyword: input.keyword,
+                    pageNo: 1,
+                    pageSize: Math.max(20, input.limit),
+                });
+                const candidates = extractStockCandidatesFromMxResult(mxResult, input.limit);
+                if (candidates.length === 0) {
+                    return [
+                        `🧭 智能选股候选池: ${input.keyword}`,
+                        renderMxSummary(mxResult),
+                        "⚠️ 未解析到可用于 TickFlow 补数据的股票代码。",
+                    ].join("\n");
+                }
+                const symbols = candidates.map((candidate) => candidate.symbol);
+                const notes = [];
+                const [watchlistSymbols, quotesBySymbol, dailyBySymbol, intradayBySymbol, financialBySymbol] = await Promise.all([
+                    loadWatchlistSymbols(watchlistService, notes),
+                    loadQuotes(quoteService, symbols, notes),
+                    input.includeDailyKlines
+                        ? loadDailyKlines(klineService, candidates, input.dailyKlineCount, notes)
+                        : Promise.resolve(new Map()),
+                    input.includeIntraday && supportsIntradayKlines(tickflowApiKeyLevel)
+                        ? loadIntradayKlines(klineService, candidates.slice(0, MAX_INTRADAY_CANDIDATES), input.intradayCount, notes)
+                        : Promise.resolve(new Map()),
+                    input.includeFinancial && tickflowApiKeyLevel === "expert"
+                        ? loadFinancialMetrics(financialService, candidates.slice(0, MAX_FINANCIAL_CANDIDATES), notes)
+                        : Promise.resolve(new Map()),
+                ]);
+                const deterministicText = renderCandidatePool({
+                    input,
+                    tickflowApiKeyLevel,
+                    mxResult,
+                    candidates,
+                    watchlistSymbols,
+                    quotesBySymbol,
+                    dailyBySymbol,
+                    intradayBySymbol,
+                    financialBySymbol,
+                    notes,
+                });
+                if (!input.summarize) {
+                    return deterministicText;
+                }
+                return appendLlmSummary(deterministicText, analysisService);
+            }
+            catch (error) {
+                return `智能选股联动失败😔 ${formatError(error)}`;
+            }
+        },
+    };
+}
+async function appendLlmSummary(deterministicText, analysisService) {
+    const configError = analysisService.getConfigurationError();
+    if (configError) {
+        return [
+            deterministicText,
+            "",
+            "LLM整理:",
+            `⚠️ ${configError}`,
+        ].join("\n");
+    }
+    try {
+        const summary = await analysisService.generateText([
+            "你是 A 股候选池整理助手。",
+            "只能基于用户提供的候选池文本进行整理，不得引入外部事实、不得改写或臆造数值。",
+            "候选池文本未提供的字段必须写“未提供”或“需另查”，禁止按股票名称推断主营业务、概念归属、产业链位置或公告事件。",
+            "输出中文，简洁，突出优先级、主要看点、风险点和下一步验证动作。",
+            "这不是投资建议，不要给买卖指令。",
+        ].join("\n"), [
+            "请整理下面的智能选股候选池结果。",
+            "要求:",
+            "1. 给出候选优先级排序和理由。",
+            "2. 标出需要排除或谨慎的点。",
+            "3. 给出下一步最多 3 个验证动作。",
+            "4. 不要重复大段原始表格。",
+            "5. 不要提及候选公司主营业务或具体概念归属，除非原文候选明细已提供该字段。",
+            "",
+            deterministicText,
+        ].join("\n"), {
+            maxTokens: 900,
+            temperature: 0.2,
+        });
+        return [
+            deterministicText,
+            "",
+            "LLM整理:",
+            summary,
+        ].join("\n");
+    }
+    catch (error) {
+        return [
+            deterministicText,
+            "",
+            "LLM整理:",
+            `⚠️ LLM整理失败: ${formatError(error)}`,
+        ].join("\n");
+    }
+}
+export function extractStockCandidatesFromMxResult(result, limit) {
+    const columns = result.columns;
+    const keyMap = buildCandidateColumnKeyMap(columns);
+    const candidates = [];
+    const seen = new Set();
+    for (const row of result.dataList) {
+        const code = readCell(row, keyMap.codeKeys);
+        if (!code) {
+            continue;
+        }
+        const market = readCell(row, keyMap.marketKeys);
+        const symbol = normalizeCandidateSymbol(code, market);
+        if (!symbol || seen.has(symbol)) {
+            continue;
+        }
+        seen.add(symbol);
+        candidates.push({
+            rank: candidates.length + 1,
+            symbol,
+            code,
+            market,
+            name: readCell(row, keyMap.nameKeys) ?? symbol,
+            mx: {
+                latestPrice: readCell(row, keyMap.latestPriceKeys),
+                changePct: readCell(row, keyMap.changePctKeys),
+                pe: readCell(row, keyMap.peKeys),
+                pb: readCell(row, keyMap.pbKeys),
+                turnoverRate: readCell(row, keyMap.turnoverRateKeys),
+                volumeRatio: readCell(row, keyMap.volumeRatioKeys),
+                amount: readCell(row, keyMap.amountKeys),
+                marketValue: readCell(row, keyMap.marketValueKeys),
+            },
+        });
+        if (candidates.length >= limit) {
+            break;
+        }
+    }
+    return candidates;
+}
+function renderCandidatePool(input) {
+    const lines = [
+        `🧭 智能选股候选池: ${input.input.keyword}`,
+        `TickFlow等级: ${formatTickflowApiKeyLevel(input.tickflowApiKeyLevel)} | 候选展示: ${input.candidates.length}/${input.input.limit} | 硬上限: ${MAX_CANDIDATE_LIMIT}`,
+        renderMxSummary(input.mxResult),
+        renderCapabilityPolicy(input.input, input.tickflowApiKeyLevel, input.candidates.length),
+    ];
+    const conditionLines = renderConditions(input.mxResult);
+    if (conditionLines.length > 0) {
+        lines.push("", "条件拆解:", ...conditionLines);
+    }
+    lines.push("", "候选明细:");
+    for (const candidate of input.candidates) {
+        const quote = input.quotesBySymbol.get(candidate.symbol) ?? null;
+        const dailyRows = input.dailyBySymbol.get(candidate.symbol) ?? [];
+        const intradayRows = input.intradayBySymbol.get(candidate.symbol) ?? [];
+        const financial = input.financialBySymbol.get(candidate.symbol) ?? null;
+        lines.push(`${candidate.rank}. ${candidate.name}（${candidate.symbol}）${input.watchlistSymbols.has(candidate.symbol) ? " | 已在本地自选" : ""}`);
+        lines.push(`   - 妙想: ${renderMxCandidateMetrics(candidate)}`);
+        lines.push(`   - TickFlow行情: ${renderQuote(quote)}`);
+        lines.push(`   - 日线: ${renderDailySummary(dailyRows)}`);
+        if (input.input.includeIntraday) {
+            lines.push(`   - 分钟K: ${supportsIntradayKlines(input.tickflowApiKeyLevel) ? renderIntradaySummary(intradayRows) : "当前等级不支持，已跳过"}`);
+        }
+        if (input.input.includeFinancial) {
+            lines.push(`   - 财务: ${input.tickflowApiKeyLevel === "expert" ? renderFinancialMetrics(financial) : "当前等级不是 Expert，已跳过 TickFlow 财务"}`);
+        }
+    }
+    lines.push("", "后续联动建议:");
+    lines.push("- 需要加入本地观察时，先确认具体股票，再调用 `add_stock`；本工具不会自动写入自选。");
+    lines.push("- 需要同步到东方财富自选时，先加入本地自选，再调用 `push_eastmoney_watchlist`。");
+    lines.push("- 需要单股深度分析时，对候选中的 1-2 只再调用 `analyze`，避免一次性拉取过多数据。");
+    if (input.notes.length > 0) {
+        lines.push("", "补数据提示:", ...input.notes.map((note) => `- ${note}`));
+    }
+    return lines.join("\n");
+}
+function renderMxSummary(result) {
+    return `妙想选股: 状态 ${result.status ?? "-"} | 业务码 ${result.code ?? "-"} | 总数 ${result.total} | 接口返回 ${result.dataList.length} | 数据来源 ${result.dataSource}`;
+}
+function renderCapabilityPolicy(input, level, candidateCount) {
+    const parts = [
+        "补数据策略: TickFlow行情 1次批量请求",
+        input.includeDailyKlines ? `日K ${candidateCount}只 x ${input.dailyKlineCount}天` : "日K已关闭",
+        input.includeIntraday
+            ? supportsIntradayKlines(level)
+                ? `分钟K最多 ${Math.min(candidateCount, MAX_INTRADAY_CANDIDATES)}只 x ${input.intradayCount}根`
+                : "分钟K需 Pro/Expert，已跳过"
+            : "分钟K默认关闭",
+        input.includeFinancial
+            ? level === "expert"
+                ? `财务最多 ${Math.min(candidateCount, MAX_FINANCIAL_CANDIDATES)}只`
+                : "财务需 Expert，已跳过"
+            : "财务默认关闭",
+    ];
+    return parts.join("；");
+}
+function renderConditions(result) {
+    const lines = [];
+    if (result.totalCondition) {
+        lines.push(`- 组合条件: ${result.totalCondition.describe}（${result.totalCondition.stockCount ?? "-"} 只）`);
+    }
+    for (const condition of result.responseConditionList.slice(0, 5)) {
+        lines.push(`- ${condition.describe}（${condition.stockCount ?? "-"} 只）`);
+    }
+    return lines;
+}
+function renderMxCandidateMetrics(candidate) {
+    return [
+        candidate.mx.latestPrice ? `最新价 ${candidate.mx.latestPrice}` : null,
+        candidate.mx.changePct ? `涨跌幅 ${candidate.mx.changePct}%` : null,
+        candidate.mx.pe ? `PE ${candidate.mx.pe}` : null,
+        candidate.mx.pb ? `PB ${candidate.mx.pb}` : null,
+        candidate.mx.turnoverRate ? `换手 ${candidate.mx.turnoverRate}%` : null,
+        candidate.mx.amount ? `成交额 ${candidate.mx.amount}` : null,
+        candidate.mx.marketValue ? `总市值 ${candidate.mx.marketValue}` : null,
+    ].filter(Boolean).join("；") || "无核心字段";
+}
+async function loadWatchlistSymbols(watchlistService, notes) {
+    try {
+        return new Set((await watchlistService.list()).map((item) => item.symbol));
+    }
+    catch (error) {
+        notes.push(`本地自选状态读取失败: ${formatError(error)}`);
+        return new Set();
+    }
+}
+async function loadQuotes(quoteService, symbols, notes) {
+    try {
+        const quotes = await quoteService.fetchQuotes(symbols);
+        return new Map(quotes.map((quote) => [quote.symbol, quote]));
+    }
+    catch (error) {
+        notes.push(`TickFlow批量行情获取失败: ${formatError(error)}`);
+        return new Map();
+    }
+}
+async function loadDailyKlines(klineService, candidates, count, notes) {
+    const result = new Map();
+    for (const candidate of candidates) {
+        try {
+            result.set(candidate.symbol, await klineService.fetchKlines(candidate.symbol, {
+                count,
+                adjust: "forward",
+            }));
+        }
+        catch (error) {
+            notes.push(`${candidate.symbol} 日K获取失败: ${formatError(error)}`);
+        }
+    }
+    return result;
+}
+async function loadIntradayKlines(klineService, candidates, count, notes) {
+    const result = new Map();
+    for (const candidate of candidates) {
+        try {
+            result.set(candidate.symbol, await klineService.fetchIntradayKlines(candidate.symbol, {
+                period: "1m",
+                count,
+            }));
+        }
+        catch (error) {
+            notes.push(`${candidate.symbol} 分钟K获取失败: ${formatError(error)}`);
+        }
+    }
+    return result;
+}
+async function loadFinancialMetrics(financialService, candidates, notes) {
+    const result = new Map();
+    for (const candidate of candidates) {
+        try {
+            const rows = await financialService.fetchMetrics(candidate.symbol, { latest: true });
+            if (rows[0]) {
+                result.set(candidate.symbol, rows[0]);
+            }
+        }
+        catch (error) {
+            notes.push(`${candidate.symbol} 财务指标获取失败: ${formatError(error)}`);
+        }
+    }
+    return result;
+}
+function renderQuote(quote) {
+    if (!quote) {
+        return "未返回";
+    }
+    const changePct = resolveTickFlowQuoteChangePct(quote);
+    return [
+        `最新 ${formatNumber(quote.last_price)}`,
+        changePct == null ? null : `涨跌幅 ${formatSignedPct(changePct)}`,
+        quote.timestamp ? `时间 ${formatChinaDateTime(new Date(quote.timestamp))}` : null,
+    ].filter(Boolean).join("；");
+}
+function renderDailySummary(rows) {
+    if (rows.length === 0) {
+        return "未返回";
+    }
+    const last = rows[rows.length - 1];
+    const change5 = calculateWindowChange(rows, 5);
+    const change20 = calculateWindowChange(rows, 20);
+    return [
+        `${rows.length}根`,
+        `${last.trade_date} 收盘 ${formatNumber(last.close)}`,
+        change5 == null ? null : `5日 ${formatSignedPct(change5)}`,
+        change20 == null ? null : `20日 ${formatSignedPct(change20)}`,
+    ].filter(Boolean).join("；");
+}
+function renderIntradaySummary(rows) {
+    if (rows.length === 0) {
+        return "未返回";
+    }
+    const last = rows[rows.length - 1];
+    return `${rows.length}根；${last.trade_date} ${last.trade_time} 收盘 ${formatNumber(last.close)}`;
+}
+function renderFinancialMetrics(row) {
+    if (!row) {
+        return "未返回";
+    }
+    return [
+        `期末 ${row.period_end}`,
+        row.roe == null ? null : `ROE ${formatPercentLike(row.roe)}`,
+        row.gross_margin == null ? null : `毛利率 ${formatPercentLike(row.gross_margin)}`,
+        row.net_income_yoy == null ? null : `净利同比 ${formatPercentLike(row.net_income_yoy)}`,
+        row.debt_to_asset_ratio == null ? null : `资产负债率 ${formatPercentLike(row.debt_to_asset_ratio)}`,
+    ].filter(Boolean).join("；");
+}
+function buildCandidateColumnKeyMap(columns) {
+    return {
+        codeKeys: ["SECURITY_CODE", ...findColumnKeys(columns, [/代码/, /security.*code/i])],
+        nameKeys: ["SECURITY_SHORT_NAME", ...findColumnKeys(columns, [/名称/, /简称/, /security.*name/i])],
+        marketKeys: ["MARKET_SHORT_NAME", ...findColumnKeys(columns, [/市场代码简称/, /market/i])],
+        latestPriceKeys: ["NEWEST_PRICE", ...findColumnKeys(columns, [/最新价/])],
+        changePctKeys: ["CHG", ...findColumnKeys(columns, [/涨跌幅/])],
+        peKeys: findColumnKeys(columns, [/市盈率/]),
+        pbKeys: findColumnKeys(columns, [/市净率/]),
+        turnoverRateKeys: findColumnKeys(columns, [/换手率/]),
+        volumeRatioKeys: findColumnKeys(columns, [/量比/]),
+        amountKeys: findColumnKeys(columns, [/成交额/]),
+        marketValueKeys: findColumnKeys(columns, [/总市值/]),
+    };
+}
+function findColumnKeys(columns, patterns) {
+    return columns
+        .filter((column) => {
+        const text = `${column.title}\n${column.key}`;
+        return patterns.some((pattern) => pattern.test(text));
+    })
+        .map((column) => column.key);
+}
+function readCell(row, keys) {
+    for (const key of keys) {
+        const value = row[key];
+        if (value != null && String(value).trim()) {
+            return String(value).trim();
+        }
+    }
+    return null;
+}
+function normalizeCandidateSymbol(code, market) {
+    const digits = code.match(/\d{6}/)?.[0] ?? code.trim();
+    const normalizedMarket = String(market ?? "").trim().toUpperCase();
+    if (/^\d{6}$/.test(digits) && ["SH", "SZ", "BJ"].includes(normalizedMarket)) {
+        return `${digits}.${normalizedMarket}`;
+    }
+    return normalizeSymbol(digits);
+}
+function calculateWindowChange(rows, windowSize) {
+    if (rows.length <= windowSize) {
+        return null;
+    }
+    const latest = rows[rows.length - 1]?.close;
+    const previous = rows[rows.length - 1 - windowSize]?.close;
+    return calculateChangePct(latest, previous);
+}
+function calculateChangePct(current, previous) {
+    if (current == null || previous == null || !Number.isFinite(current) || !Number.isFinite(previous) || previous === 0) {
+        return null;
+    }
+    return ((current - previous) / previous) * 100;
+}
+function parsePositiveInteger(value, fallback, max) {
+    if (value == null || String(value).trim() === "") {
+        return fallback;
+    }
+    const numeric = Number(value);
+    if (!Number.isFinite(numeric) || numeric <= 0) {
+        throw new Error("number must be greater than 0");
+    }
+    return Math.min(Math.trunc(numeric), max);
+}
+function parseOptionalBoolean(value, fallback) {
+    if (typeof value === "boolean") {
+        return value;
+    }
+    if (typeof value === "string") {
+        const normalized = value.trim().toLowerCase();
+        if (["true", "1", "yes", "on"].includes(normalized)) {
+            return true;
+        }
+        if (["false", "0", "no", "off"].includes(normalized)) {
+            return false;
+        }
+    }
+    return fallback;
+}
+function formatNumber(value) {
+    if (!Number.isFinite(value)) {
+        return "-";
+    }
+    return value.toFixed(2);
+}
+function formatSignedPct(value) {
+    return `${value >= 0 ? "+" : ""}${value.toFixed(2)}%`;
+}
+function formatPercentLike(value) {
+    return `${value.toFixed(2)}%`;
+}
+function formatError(error) {
+    return error instanceof Error ? error.message : String(error);
+}

package/dist/types/mx-data.d.ts

@@ -0,0 +1,23 @@
+export interface MxDataEntityTag {
+    fullName: string | null;
+    secuCode: string | null;
+    marketChar: string | null;
+    entityTypeName: string | null;
+    className: string | null;
+}
+export interface MxDataTable {
+    title: string;
+    code: string | null;
+    entityName: string | null;
+    rows: Array<Record<string, string>>;
+    fieldnames: string[];
+}
+export interface MxDataResult {
+    status: number | null;
+    message: string | null;
+    questionId: string | null;
+    entityTags: MxDataEntityTag[];
+    conditionParts: string[];
+    tables: MxDataTable[];
+    totalRows: number;
+}

package/dist/types/mx-data.js

@@ -0,0 +1 @@
+export {};

package/dist/types/mx-select-stock.d.ts

@@ -21,6 +21,7 @@ export interface MxSelectStockResult {
     total: number;
     totalRecordCount: number;
     parserText: string | null;
+    dataSource: "dataList" | "partialResults" | "none";
     columns: MxSelectStockColumn[];
     dataList: Array<Record<string, unknown>>;
     responseConditionList: MxSelectStockCondition[];

package/dist/types/mx-self-select.d.ts

@@ -0,0 +1,30 @@
+export interface MxSelfSelectColumn {
+    title: string;
+    key: string;
+}
+export interface MxSelfSelectStock {
+    symbol: string;
+    rawSymbol: string | null;
+    name: string;
+    latestPrice: string | null;
+    changePercent: string | null;
+    changeAmount: string | null;
+    turnoverRate: string | null;
+    volumeRatio: string | null;
+    raw: Record<string, unknown>;
+}
+export interface MxSelfSelectResult {
+    status: number | null;
+    code: string | null;
+    message: string | null;
+    columns: MxSelfSelectColumn[];
+    stocks: MxSelfSelectStock[];
+    raw: unknown;
+}
+export interface MxSelfSelectManageResult {
+    status: number | null;
+    code: string | null;
+    message: string | null;
+    query: string;
+    raw: unknown;
+}

package/dist/types/mx-self-select.js

@@ -0,0 +1 @@
+export {};

package/openclaw.plugin.json

@@ -1,7 +1,7 @@
 {
   "id": "tickflow-assist",
   "name": "TickFlow Assist",
-  "version": "0.3.7",
+  "version": "0.3.8",
   "description": "A-share watchlist analysis, monitoring, and alert delivery powered by TickFlow and OpenClaw.",
   "skills": [
     "skills"
@@ -61,14 +61,14 @@
       "provider": "mx-search",
       "method": "api-key",
       "choiceId": "mx-search-api-key",
-      "choiceLabel": "MX Search API key",
+      "choiceLabel": "MX Skills API key",
       "groupId": "tickflow-assist",
       "groupLabel": "TickFlow Assist",
       "groupHint": "TickFlow, analysis LLM, and optional data-service credentials.",
       "optionKey": "mxSearchApiKey",
       "cliFlag": "--mx-search-api-key",
       "cliOption": "--mx-search-api-key <key>",
-      "cliDescription": "MX Search API key",
+      "cliDescription": "MX Skills API key",
       "assistantVisibility": "manual-only"
     },
     {
@@ -163,12 +163,12 @@
       "mxSearchApiUrl": {
         "type": "string",
         "default": "https://mkapi2.dfcfs.com/finskillshub/api/claw",
-        "description": "MX Search API base URL. Leave empty to use TICKFLOW_ASSIST_MX_SEARCH_API_URL or MX_SEARCH_API_URL."
+        "description": "MX Skills API base URL. Leave empty to use TICKFLOW_ASSIST_MX_SEARCH_API_URL or MX_SEARCH_API_URL."
       },
       "mxSearchApiKey": {
         "type": "string",
         "default": "",
-        "description": "Configure this during setup if you want mx_search, mx_select_stock, and non-Expert financial fallback. Leave empty to use TICKFLOW_ASSIST_MX_SEARCH_API_KEY, MX_SEARCH_API_KEY, or MX_APIKEY."
+        "description": "Configure this during setup if you want mx_search, mx_data, mx_select_stock, Eastmoney self-select sync, and non-Expert financial fallback. Leave empty to use TICKFLOW_ASSIST_MX_SEARCH_API_KEY, MX_SEARCH_API_KEY, or MX_APIKEY."
       },
       "jin10McpUrl": {
         "type": "string",
@@ -282,8 +282,8 @@
       "help": "Set this to your actual TickFlow subscription level, or provide it via TICKFLOW_ASSIST_TICKFLOW_API_KEY_LEVEL / TICKFLOW_API_KEY_LEVEL."
     },
     "mxSearchApiKey": {
-      "label": "MX Search API Key",
-      "help": "Configure this during setup if you want mx_search, mx_select_stock, and lite financial fallback, or use TICKFLOW_ASSIST_MX_SEARCH_API_KEY / MX_SEARCH_API_KEY / MX_APIKEY.",
+      "label": "MX Skills API Key",
+      "help": "Configure this during setup if you want mx_search, mx_data, mx_select_stock, Eastmoney self-select sync, and lite financial fallback, or use TICKFLOW_ASSIST_MX_SEARCH_API_KEY / MX_SEARCH_API_KEY / MX_APIKEY.",
       "sensitive": true
     },
     "jin10McpUrl": {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tickflow-assist",
-  "version": "0.3.7",
+  "version": "0.3.8",
   "description": "面向 A 股投资与盯盘场景的 OpenClaw 智能股票插件，基于 TickFlow API 提供实时监控、收盘后复盘、多维综合分析、关键价位跟踪与告警能力。OpenClaw smart stock plugin for A-share investing and watchlist workflows, powered by TickFlow API for realtime monitoring, post-close review, multi-dimensional analysis, key level tracking, and alerts.",
   "license": "MIT",
   "type": "module",
@@ -37,7 +37,7 @@
     "dev": "tsc -p tsconfig.json --watch",
     "prepack": "npm run build && node ./scripts/prepare-package-assets.mjs",
     "postpack": "node ./scripts/restore-package-assets.mjs",
-    "test": "npm run build && node --test dist/plugin-registration.test.js dist/tools/test-alert.tool.test.js dist/services/jin10-mcp-service.test.js dist/services/jin10-flash-monitor-service.test.js dist/services/pre-market-brief-service.test.js dist/services/monitor-service.test.js",
+    "test": "npm run build && node --test dist/plugin-registration.test.js dist/tools/test-alert.tool.test.js dist/tools/eastmoney-watchlist.tool.test.js dist/tools/screen-stock-candidates.tool.test.js dist/services/mx-search-service.test.js dist/services/jin10-mcp-service.test.js dist/services/jin10-flash-monitor-service.test.js dist/services/pre-market-brief-service.test.js dist/services/monitor-service.test.js",
     "community-setup": "node dist/dev/tickflow-assist-cli.js configure-openclaw",
     "tool": "node dist/dev/run-tool.js",
     "monitor-loop": "node dist/dev/run-monitor-loop.js",
@@ -46,12 +46,12 @@
   },
   "openclaw": {
     "build": {
-      "openclawVersion": "2026.4.14"
+      "openclawVersion": "2026.4.22"
     },
     "compat": {
       "pluginApi": ">=2026.3.31",
       "minGatewayVersion": "2026.3.31",
-      "builtWithOpenClawVersion": "2026.4.14"
+      "builtWithOpenClawVersion": "2026.4.22"
     },
     "install": {
       "npmSpec": "tickflow-assist",
@@ -74,9 +74,9 @@
   },
   "devDependencies": {
     "@types/node": "^22.13.11",
-    "openclaw": "^2026.4.14",
+    "openclaw": "^2026.4.22",
     "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.7` 接入 TickFlow 标的池行业映射与申万三级同业上下文，优化盘前简报提炼与收盘复盘市场信息展示，并对齐 OpenClaw `v2026.4.14` 兼容与社区元数据。完整发布记录见 <https://github.com/robinspt/tickflow-assist/blob/main/CHANGELOG.md>。\n\n当前主线按 OpenClaw `v2026.3.31+` 对齐，并已验证社区安装在 `v2026.4.14` 上兼容。\n\n## 安装前准备\n\n在执行社区安装前，建议先确认你已经准备好以下配置：\n\n- 核心必需：`tickflowApiKey`、`llmApiKey`、`llmBaseUrl`、`llmModel`\n- 告警投递：`alertChannel`、`alertTarget`、`alertAccount`\n- 可选增强：`mxSearchApiKey`、`jin10ApiToken`\n\n其中，`configure-openclaw` 会把上述配置写入 `~/.openclaw/openclaw.json` 的 `plugins.entries[\"tickflow-assist\"].config`，插件启用后会在本地 `databasePath` 下持久化 LanceDB 数据，并运行监控 / 日更等后台服务。\n如果你不想把密钥写进配置文件，运行时也支持环境变量回退，优先级是 `openclaw.json / local.config.json` > 环境变量 > 默认值。\n常用环境变量：`TICKFLOW_ASSIST_TICKFLOW_API_KEY` / `TICKFLOW_API_KEY`、`TICKFLOW_ASSIST_LLM_API_KEY` / `LLM_API_KEY`、`TICKFLOW_ASSIST_LLM_BASE_URL` / `LLM_BASE_URL`、`TICKFLOW_ASSIST_LLM_MODEL` / `LLM_MODEL`、`TICKFLOW_ASSIST_MX_SEARCH_API_KEY` / `MX_SEARCH_API_KEY` / `MX_APIKEY`、`TICKFLOW_ASSIST_JIN10_API_TOKEN` / `JIN10_API_TOKEN`。\n如果你希望尽量避免把密钥落盘，推荐先把这些变量写进 `~/.openclaw/.env`，再运行配置向导补齐非密钥项。\n\n## 安装\n\n社区安装：\n\n```bash\nopenclaw plugins install tickflow-assist\nnode ~/.openclaw/extensions/tickflow-assist/dist/dev/tickflow-assist-cli.js configure-openclaw\ncd ~/.openclaw/extensions/tickflow-assist/python && uv sync\nopenclaw plugins enable tickflow-assist\nopenclaw config validate\nopenclaw gateway restart\n```\n\n- `configure-openclaw` 会把配置写入 `~/.openclaw/openclaw.json` 的 `plugins.entries[\"tickflow-assist\"].config`。\n- 核心必填建议先准备：`tickflowApiKey`、`tickflowApiKeyLevel`、`llmApiKey`、`llmBaseUrl`、`llmModel`；告警场景再补 `alertChannel`、`alertTarget`、`alertAccount`。\n- 如果你不想把密钥落盘，优先把环境变量写进 `~/.openclaw/.env`，再运行配置向导补齐非密钥项；如需 PNG 告警卡正常显示中文，请自行安装 `fontconfig` 与 Noto CJK 字体。\n\n社区安装后的升级方式：\n\n```bash\nopenclaw plugins update tickflow-assist\nopenclaw gateway restart\n```\n\n## 配置\n\n插件正式运行读取：\n\n```text\n~/.openclaw/openclaw.json\n```\n\n配置路径：\n\n```text\nplugins.entries[\"tickflow-assist\"].config\n```\n\n建议按完整功能显式填写以下字段，不要只填 API Key：\n\n- 核心运行：`tickflowApiKey`、`llmApiKey`、`llmBaseUrl`、`llmModel`\n- 本地数据：`databasePath`、`calendarFile`\n- 告警投递：`alertChannel`、`alertTarget`、`alertAccount`\n- 能力补充：`mxSearchApiKey`、`jin10ApiToken`\n\n其中，`mxSearchApiKey` 用于 `mx_search`、`mx_select_stock` 以及非 `Expert` 财务链路的 lite 补充；`jin10ApiToken` 用于 24 小时金十数据快讯监控；`jin10FlashNightAlert` 默认 `false`（开启夜间静默），设为 `true` 可恢复 24 小时快讯告警；`alertTarget`、`alertAccount` 建议在准备启用 `test_alert`、实时监控告警、金十数据快讯告警和定时通知前一并配好，避免配置不完整导致功能缺失。\n如果你使用环境变量，运行时支持以下回退：\n\n- `tickflowApiUrl`：`TICKFLOW_ASSIST_TICKFLOW_API_URL` / `TICKFLOW_API_URL`\n- `tickflowApiKey`：`TICKFLOW_ASSIST_TICKFLOW_API_KEY` / `TICKFLOW_API_KEY`\n- `tickflowApiKeyLevel`：`TICKFLOW_ASSIST_TICKFLOW_API_KEY_LEVEL` / `TICKFLOW_API_KEY_LEVEL`\n- `llmBaseUrl`：`TICKFLOW_ASSIST_LLM_BASE_URL` / `LLM_BASE_URL`\n- `llmApiKey`：`TICKFLOW_ASSIST_LLM_API_KEY` / `LLM_API_KEY`\n- `llmModel`：`TICKFLOW_ASSIST_LLM_MODEL` / `LLM_MODEL`\n- `mxSearchApiUrl`：`TICKFLOW_ASSIST_MX_SEARCH_API_URL` / `MX_SEARCH_API_URL`\n- `mxSearchApiKey`：`TICKFLOW_ASSIST_MX_SEARCH_API_KEY` / `MX_SEARCH_API_KEY` / `MX_APIKEY`\n- `jin10McpUrl`：`TICKFLOW_ASSIST_JIN10_MCP_URL` / `JIN10_MCP_URL`\n- `jin10ApiToken`：`TICKFLOW_ASSIST_JIN10_API_TOKEN` / `JIN10_API_TOKEN`\n\n## 功能\n\n- 自选股管理、日 K / 分钟 K 抓取与指标计算\n- 技术面、财务面、资讯面的综合分析\n- 实时监控、定时日更、收盘后复盘\n- 金十数据 24 小时快讯监控与自选关联提醒\n- 本地 LanceDB 数据留痕与分析结果查看\n\n## 运行说明\n\n- 插件会在本地 `databasePath` 下持久化 LanceDB 数据。\n- 后台服务会按配置执行定时日更、实时监控与金十数据快讯监控。\n- Python 子模块仅用于技术指标计算，不承担主业务流程。\n\n## 依赖与可选能力\n\n- [TickFlow](https://tickflow.org/auth/register?ref=BUJ54JEDGE)：`Free` 可用日线与实时行情；`Starter` 起可用标的池，插件会用来做申万行业映射与申万 3 级同业表现；`Pro` 起可用分钟K；`Expert` 才走 TickFlow 财务数据，非 `Expert` 默认回退妙想 lite。\n- [金十数据 MCP](https://mcp.jin10.com/app/)：可选，用于 24 小时快讯流接入、自选关联筛选与事件驱动告警。独立的金十数据 Skill 详见 [OpenClaw Skill](https://clawhub.ai/robinspt/jin10) / [Hermes Skill](https://github.com/robinspt/hermes-skills)。\n- [东方财富妙想 Skills](https://marketing.dfcfs.com/views/finskillshub/)：可选，用于 `mx_search`、`mx_select_stock` 与非 `Expert` 财务链路的 lite 补充。\n\n## 仓库\n\n- GitHub: [robinspt/tickflow-assist](https://github.com/robinspt/tickflow-assist)\n",
+  "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.8` 接入东方财富自选同步、妙想官方数据/智能选股兼容与小规模候选池联动，新增 `/ta_screenstocks` / `/ta_screenstocks_llm`，并优化盘前简报提炼和监控阶段提醒去重。完整发布记录见 <https://github.com/robinspt/tickflow-assist/blob/main/CHANGELOG.md>。\n\n当前主线按 OpenClaw `v2026.3.31+` 对齐，并已验证社区安装在 `v2026.4.22` 上兼容。\n\n## 安装前准备\n\n在执行社区安装前，建议先确认你已经准备好以下配置：\n\n- 核心必需：`tickflowApiKey`、`llmApiKey`、`llmBaseUrl`、`llmModel`\n- 告警投递：`alertChannel`、`alertTarget`、`alertAccount`\n- 可选增强：`mxSearchApiKey`、`jin10ApiToken`\n\n其中，`configure-openclaw` 会把上述配置写入 `~/.openclaw/openclaw.json` 的 `plugins.entries[\"tickflow-assist\"].config`，插件启用后会在本地 `databasePath` 下持久化 LanceDB 数据，并运行监控 / 日更等后台服务。\n如果你不想把密钥写进配置文件，运行时也支持环境变量回退，优先级是 `openclaw.json / local.config.json` > 环境变量 > 默认值。\n常用环境变量：`TICKFLOW_ASSIST_TICKFLOW_API_KEY` / `TICKFLOW_API_KEY`、`TICKFLOW_ASSIST_LLM_API_KEY` / `LLM_API_KEY`、`TICKFLOW_ASSIST_LLM_BASE_URL` / `LLM_BASE_URL`、`TICKFLOW_ASSIST_LLM_MODEL` / `LLM_MODEL`、`TICKFLOW_ASSIST_MX_SEARCH_API_KEY` / `MX_SEARCH_API_KEY` / `MX_APIKEY`、`TICKFLOW_ASSIST_JIN10_API_TOKEN` / `JIN10_API_TOKEN`。\n如果你希望尽量避免把密钥落盘，推荐先把这些变量写进 `~/.openclaw/.env`，再运行配置向导补齐非密钥项。\n\n## 安装\n\n社区安装：\n\n```bash\nopenclaw plugins install tickflow-assist\nnode ~/.openclaw/extensions/tickflow-assist/dist/dev/tickflow-assist-cli.js configure-openclaw\ncd ~/.openclaw/extensions/tickflow-assist/python && uv sync\nopenclaw plugins enable tickflow-assist\nopenclaw config validate\nopenclaw gateway restart\n```\n\n- `configure-openclaw` 会把配置写入 `~/.openclaw/openclaw.json` 的 `plugins.entries[\"tickflow-assist\"].config`。\n- 核心必填建议先准备：`tickflowApiKey`、`tickflowApiKeyLevel`、`llmApiKey`、`llmBaseUrl`、`llmModel`；告警场景再补 `alertChannel`、`alertTarget`、`alertAccount`。\n- 如果你不想把密钥落盘，优先把环境变量写进 `~/.openclaw/.env`，再运行配置向导补齐非密钥项；如需 PNG 告警卡正常显示中文，请自行安装 `fontconfig` 与 Noto CJK 字体。\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_data`、`mx_select_stock`、东方财富自选同步以及非 `Expert` 财务链路的 lite 补充；东方财富自选管理接口每日额度 200 次；`jin10ApiToken` 用于 24 小时金十数据快讯监控；`jin10FlashNightAlert` 默认 `false`（开启夜间静默），设为 `true` 可恢复 24 小时快讯告警；`alertTarget`、`alertAccount` 建议在准备启用 `test_alert`、实时监控告警、金十数据快讯告警和定时通知前一并配好，避免配置不完整导致功能缺失。\n如果你使用环境变量，运行时支持以下回退：\n\n- `tickflowApiUrl`：`TICKFLOW_ASSIST_TICKFLOW_API_URL` / `TICKFLOW_API_URL`\n- `tickflowApiKey`：`TICKFLOW_ASSIST_TICKFLOW_API_KEY` / `TICKFLOW_API_KEY`\n- `tickflowApiKeyLevel`：`TICKFLOW_ASSIST_TICKFLOW_API_KEY_LEVEL` / `TICKFLOW_API_KEY_LEVEL`\n- `llmBaseUrl`：`TICKFLOW_ASSIST_LLM_BASE_URL` / `LLM_BASE_URL`\n- `llmApiKey`：`TICKFLOW_ASSIST_LLM_API_KEY` / `LLM_API_KEY`\n- `llmModel`：`TICKFLOW_ASSIST_LLM_MODEL` / `LLM_MODEL`\n- `mxSearchApiUrl`：`TICKFLOW_ASSIST_MX_SEARCH_API_URL` / `MX_SEARCH_API_URL`\n- `mxSearchApiKey`：`TICKFLOW_ASSIST_MX_SEARCH_API_KEY` / `MX_SEARCH_API_KEY` / `MX_APIKEY`\n- `jin10McpUrl`：`TICKFLOW_ASSIST_JIN10_MCP_URL` / `JIN10_MCP_URL`\n- `jin10ApiToken`：`TICKFLOW_ASSIST_JIN10_API_TOKEN` / `JIN10_API_TOKEN`\n\n## 功能\n\n- 自选股管理、东方财富自选同步、日 K / 分钟 K 抓取与指标计算\n- 妙想资讯搜索、官方金融数据查询、智能选股，以及限量候选池 + TickFlow 补数据联动\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)：`Free` 可用日线与实时行情；`Starter` 起可用标的池，插件会用来做申万行业映射与申万 3 级同业表现；`Pro` 起可用分钟K；`Expert` 才走 TickFlow 财务数据，非 `Expert` 默认回退妙想 lite。\n- [金十数据 MCP](https://mcp.jin10.com/app/)：可选，用于 24 小时快讯流接入、自选关联筛选与事件驱动告警。独立的金十数据 Skill 详见 [OpenClaw Skill](https://clawhub.ai/robinspt/jin10) / [Hermes Skill](https://github.com/robinspt/hermes-skills)。\n- [东方财富妙想 Skills](https://marketing.dfcfs.com/views/finskillshub/)：可选，用于 `mx_search`、`mx_data`、`mx_select_stock`、东方财富自选同步与非 `Expert` 财务链路的 lite 补充。\n\n## 仓库\n\n- GitHub: [robinspt/tickflow-assist](https://github.com/robinspt/tickflow-assist)\n",
   "readmeFilename": "README.md"
 }