tickflow-assist 0.3.7 → 0.3.9

package/dist/tools/eastmoney-watchlist.tool.js

@@ -0,0 +1,294 @@
+import { normalizeSymbol } from "../utils/symbol.js";
+const MX_ZIXUAN_DAILY_LIMIT = 200;
+const DEFAULT_SYNC_ENRICH_PROFILE = false;
+export function listEastmoneyWatchlistTool(mxApiService) {
+    return {
+        name: "list_eastmoney_watchlist",
+        description: "List Eastmoney account self-selected stocks via MX zixuan. Uses 1 call from the 200/day MX zixuan quota.",
+        async run() {
+            try {
+                const result = await mxApiService.getSelfSelectWatchlist();
+                return renderEastmoneyWatchlist(result.stocks, 1);
+            }
+            catch (error) {
+                return `查询东方财富自选失败😔 ${formatErrorMessage(error)}`;
+            }
+        },
+    };
+}
+export function syncEastmoneyWatchlistTool(mxApiService, watchlistService) {
+    return {
+        name: "sync_eastmoney_watchlist",
+        description: "Import Eastmoney self-selected stocks into the local TickFlow Assist watchlist. Uses 1 call from the 200/day MX zixuan quota.",
+        optional: true,
+        async run({ rawInput }) {
+            let input;
+            try {
+                input = parseSyncInput(rawInput);
+            }
+            catch (error) {
+                return `同步东方财富自选失败😔 ${formatErrorMessage(error)}`;
+            }
+            try {
+                const remote = await mxApiService.getSelfSelectWatchlist();
+                const local = await watchlistService.list();
+                const localSymbols = new Set(local.map((item) => item.symbol));
+                const existingCount = remote.stocks.filter((stock) => localSymbols.has(stock.symbol)).length;
+                const missing = remote.stocks.filter((stock) => !localSymbols.has(stock.symbol));
+                const candidates = missing.slice(0, input.limit ?? undefined);
+                const added = [];
+                const failed = [];
+                for (const stock of candidates) {
+                    try {
+                        const result = await watchlistService.add(stock.symbol, null, {
+                            enrichProfile: input.refreshProfiles,
+                            name: stock.name,
+                        });
+                        added.push(result.item);
+                    }
+                    catch (error) {
+                        failed.push({ stock, error: formatErrorMessage(error) });
+                    }
+                }
+                const limitedOut = missing.length - candidates.length;
+                return [
+                    "🔄 东方财富自选 -> 本地关注列表",
+                    `妙想自选接口调用: 1 次（每日额度 ${MX_ZIXUAN_DAILY_LIMIT} 次）`,
+                    `东方财富自选: ${remote.stocks.length} 只 | 本地已有: ${existingCount} 只 | 待同步: ${missing.length} 只 | 本次新增: ${added.length} 只 | 失败: ${failed.length} 只`,
+                    limitedOut > 0 ? `因 limit 限制未处理: ${limitedOut} 只` : null,
+                    input.refreshProfiles
+                        ? "行业/概念: 本次同步已尝试刷新"
+                        : "行业/概念: 本次同步默认不刷新，可后续调用 refresh_watchlist_profiles",
+                    formatAddedItems(added),
+                    formatSyncFailures(failed),
+                ].filter(Boolean).join("\n");
+            }
+            catch (error) {
+                return `同步东方财富自选失败😔 ${formatErrorMessage(error)}`;
+            }
+        },
+    };
+}
+export function pushEastmoneyWatchlistTool(mxApiService, watchlistService) {
+    return {
+        name: "push_eastmoney_watchlist",
+        description: "Add local TickFlow Assist watchlist symbols to Eastmoney self-select. Uses 1 MX zixuan call per stock from the 200/day quota.",
+        optional: true,
+        async run({ rawInput }) {
+            let input;
+            try {
+                input = parseSymbolListInput(rawInput);
+            }
+            catch (error) {
+                return `推送东方财富自选失败😔 ${formatErrorMessage(error)}`;
+            }
+            const local = await watchlistService.list();
+            const targets = selectLocalTargets(local, input);
+            if (targets.length === 0) {
+                return input.symbols
+                    ? `⚠️ 本地关注列表中未找到指定股票: ${input.symbols.join("、")}`
+                    : "⚠️ 本地关注列表为空，无法推送到东方财富自选。";
+            }
+            if (targets.length > MX_ZIXUAN_DAILY_LIMIT) {
+                return `⚠️ 本次需要 ${targets.length} 次妙想自选调用，超过每日额度 ${MX_ZIXUAN_DAILY_LIMIT} 次，已取消。请缩小 symbols 或 limit。`;
+            }
+            const results = [];
+            for (const item of targets) {
+                try {
+                    const result = await mxApiService.manageSelfSelect(buildEastmoneyAddQuery(item));
+                    results.push({ item, ok: true, message: result.message ?? "已提交" });
+                }
+                catch (error) {
+                    results.push({ item, ok: false, message: formatErrorMessage(error) });
+                }
+            }
+            return renderManageResults("⬆️ 本地关注列表 -> 东方财富自选", targets.length, results);
+        },
+    };
+}
+export function removeEastmoneyWatchlistTool(mxApiService) {
+    return {
+        name: "remove_eastmoney_watchlist",
+        description: "Remove one stock from Eastmoney self-select via MX zixuan. Uses 1 call from the 200/day quota and does not remove the local watchlist item.",
+        optional: true,
+        async run({ rawInput }) {
+            let input;
+            try {
+                input = parseRemoveEastmoneyInput(rawInput);
+            }
+            catch (error) {
+                return `删除东方财富自选失败😔 ${formatErrorMessage(error)}`;
+            }
+            try {
+                const result = await mxApiService.manageSelfSelect(`把${input.target}从我的自选股列表删除`);
+                return [
+                    "🗑️ 东方财富自选删除",
+                    `妙想自选接口调用: 1 次（每日额度 ${MX_ZIXUAN_DAILY_LIMIT} 次）`,
+                    `目标: ${input.target}`,
+                    `结果: ${result.message ?? "已提交"}`,
+                    "说明: 本操作不删除 TickFlow Assist 本地关注列表，如需本地删除请调用 remove_stock。",
+                ].join("\n");
+            }
+            catch (error) {
+                return `删除东方财富自选失败😔 ${formatErrorMessage(error)}`;
+            }
+        },
+    };
+}
+function parseSyncInput(rawInput) {
+    if (typeof rawInput === "object" && rawInput !== null) {
+        const input = rawInput;
+        return {
+            limit: parseOptionalPositiveInteger(input.limit),
+            refreshProfiles: parseOptionalBoolean(input.refreshProfiles, DEFAULT_SYNC_ENRICH_PROFILE),
+        };
+    }
+    return {
+        limit: null,
+        refreshProfiles: DEFAULT_SYNC_ENRICH_PROFILE,
+    };
+}
+function parseSymbolListInput(rawInput) {
+    if (typeof rawInput === "string" && rawInput.trim()) {
+        const text = rawInput.trim();
+        if (["all", "全部", "全量", "所有"].includes(text.toLowerCase())) {
+            return { symbols: null, limit: null };
+        }
+        return { symbols: [normalizeSymbol(text)], limit: null };
+    }
+    if (typeof rawInput === "object" && rawInput !== null) {
+        const input = rawInput;
+        const single = String(input.symbol ?? input.code ?? "").trim();
+        const rawSymbols = Array.isArray(input.symbols)
+            ? input.symbols
+            : single
+                ? [single]
+                : null;
+        return {
+            symbols: rawSymbols ? rawSymbols.map((item) => normalizeSymbol(String(item))).filter(Boolean) : null,
+            limit: parseOptionalPositiveInteger(input.limit),
+        };
+    }
+    return { symbols: null, limit: null };
+}
+function parseRemoveEastmoneyInput(rawInput) {
+    if (typeof rawInput === "string" && rawInput.trim()) {
+        return { target: rawInput.trim() };
+    }
+    if (typeof rawInput === "object" && rawInput !== null) {
+        const input = rawInput;
+        const target = String(input.symbol ?? input.code ?? input.name ?? input.target ?? "").trim();
+        if (target) {
+            return { target };
+        }
+    }
+    throw new Error("remove_eastmoney_watchlist requires symbol/name");
+}
+function parseOptionalPositiveInteger(value) {
+    if (value == null || String(value).trim() === "") {
+        return null;
+    }
+    const numeric = Number(value);
+    if (!Number.isFinite(numeric) || numeric <= 0) {
+        throw new Error("limit must be greater than 0");
+    }
+    return Math.trunc(numeric);
+}
+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 selectLocalTargets(items, input) {
+    const selected = input.symbols
+        ? items.filter((item) => input.symbols.includes(item.symbol))
+        : items;
+    return selected.slice(0, input.limit ?? undefined);
+}
+function buildEastmoneyAddQuery(item) {
+    return `把${item.symbol.slice(0, 6)} ${item.name}添加到我的自选股列表`;
+}
+function renderEastmoneyWatchlist(stocks, callCount) {
+    if (stocks.length === 0) {
+        return [
+            "📊 东方财富自选股列表",
+            `妙想自选接口调用: ${callCount} 次（每日额度 ${MX_ZIXUAN_DAILY_LIMIT} 次）`,
+            "ℹ️ 当前东方财富自选股列表为空。",
+        ].join("\n");
+    }
+    const lines = [
+        "📊 东方财富自选股列表",
+        `妙想自选接口调用: ${callCount} 次（每日额度 ${MX_ZIXUAN_DAILY_LIMIT} 次）`,
+        `共 ${stocks.length} 只`,
+        "",
+    ];
+    for (const stock of stocks) {
+        const marketFields = [
+            stock.latestPrice ? `最新价 ${stock.latestPrice}` : null,
+            stock.changePercent ? `涨跌幅 ${formatPercent(stock.changePercent)}` : null,
+            stock.changeAmount ? `涨跌额 ${stock.changeAmount}` : null,
+            stock.turnoverRate ? `换手率 ${formatPercent(stock.turnoverRate)}` : null,
+            stock.volumeRatio ? `量比 ${stock.volumeRatio}` : null,
+        ].filter(Boolean);
+        lines.push(`• ${stock.name}（${stock.symbol}）${marketFields.length > 0 ? ` | ${marketFields.join(" | ")}` : ""}`);
+    }
+    return lines.join("\n");
+}
+function renderManageResults(title, callCount, results) {
+    const success = results.filter((result) => result.ok);
+    const failed = results.filter((result) => !result.ok);
+    return [
+        title,
+        `妙想自选接口调用: ${callCount} 次（每日额度 ${MX_ZIXUAN_DAILY_LIMIT} 次）`,
+        `成功: ${success.length} 只 | 失败: ${failed.length} 只`,
+        formatOperationSection("成功", success),
+        formatOperationSection("失败", failed),
+    ].filter(Boolean).join("\n");
+}
+function formatOperationSection(title, results) {
+    if (results.length === 0) {
+        return null;
+    }
+    return [
+        `${title}:`,
+        ...results.map((result) => `• ${result.item.name}（${result.item.symbol}）: ${result.message}`),
+    ].join("\n");
+}
+function formatAddedItems(items) {
+    if (items.length === 0) {
+        return null;
+    }
+    return [
+        "新增:",
+        ...items.map((item) => `• ${item.name}（${item.symbol}）`),
+    ].join("\n");
+}
+function formatSyncFailures(failed) {
+    if (failed.length === 0) {
+        return null;
+    }
+    return [
+        "失败:",
+        ...failed.map(({ stock, error }) => `• ${stock.name}（${stock.symbol}）: ${error}`),
+    ].join("\n");
+}
+function formatPercent(value) {
+    const numeric = Number(value);
+    if (!Number.isFinite(numeric)) {
+        return value;
+    }
+    return `${numeric > 0 ? "+" : ""}${value}%`;
+}
+function formatErrorMessage(error) {
+    return error instanceof Error ? error.message : String(error);
+}

package/dist/tools/mx-data.tool.d.ts

@@ -0,0 +1,8 @@
+import { MxApiService } from "../services/mx-search-service.js";
+export declare function mxDataTool(mxApiService: MxApiService): {
+    name: string;
+    description: string;
+    run({ rawInput }: {
+        rawInput?: unknown;
+    }): Promise<string>;
+};

package/dist/tools/mx-data.tool.js

@@ -0,0 +1,94 @@
+const DEFAULT_LIMIT = 20;
+const MAX_LIMIT = 100;
+const MAX_TABLES = 5;
+function parseInput(rawInput) {
+    if (typeof rawInput === "string" && rawInput.trim()) {
+        return {
+            query: rawInput.trim(),
+            limit: DEFAULT_LIMIT,
+        };
+    }
+    if (typeof rawInput === "object" && rawInput !== null) {
+        const obj = rawInput;
+        const query = String(obj.query ?? obj.toolQuery ?? obj.keyword ?? obj.q ?? "").trim();
+        const limit = obj.limit == null ? DEFAULT_LIMIT : Number(obj.limit);
+        if (!query) {
+            throw new Error("mx_data requires query");
+        }
+        if (!Number.isFinite(limit) || limit <= 0) {
+            throw new Error("mx_data limit must be > 0");
+        }
+        return {
+            query,
+            limit: Math.min(Math.trunc(limit), MAX_LIMIT),
+        };
+    }
+    throw new Error("invalid mx_data input");
+}
+export function mxDataTool(mxApiService) {
+    return {
+        name: "mx_data",
+        description: "Query official Eastmoney MX financial data by natural language, including quotes, financial metrics, capital flow, company profile, shareholders, and relationships.",
+        async run({ rawInput }) {
+            const input = parseInput(rawInput);
+            const result = await mxApiService.queryData(input.query);
+            const lines = [
+                `📊 妙想数据: ${input.query}`,
+                `状态: ${result.status ?? "-"} | 消息: ${result.message ?? "-"}`,
+                `结果: ${result.tables.length} 个表 | 总行数: ${result.totalRows}`,
+            ];
+            if (result.questionId) {
+                lines.push(`查询ID: ${result.questionId}`);
+            }
+            if (result.entityTags.length > 0) {
+                lines.push("", "查询证券:");
+                for (const entity of result.entityTags) {
+                    const main = [entity.fullName, entity.secuCode].filter(Boolean).join(" ");
+                    const extra = [entity.marketChar, entity.entityTypeName, entity.className].filter(Boolean).join(" / ");
+                    lines.push(`- ${extra ? `${main} (${extra})` : main}`);
+                }
+            }
+            if (result.conditionParts.length > 0) {
+                lines.push("", "查询条件:");
+                lines.push(...result.conditionParts.slice(0, 3));
+            }
+            if (result.tables.length === 0) {
+                lines.push("", "⚠️ 未解析到有效数据表");
+                return lines.join("\n");
+            }
+            const tables = result.tables.slice(0, MAX_TABLES);
+            lines.push("", `表格预览: 展示 ${tables.length}/${result.tables.length} 个表，每表最多 ${input.limit} 行`);
+            for (const table of tables) {
+                lines.push("", formatTableHeader(table));
+                lines.push(renderCsv(table, input.limit));
+                if (table.rows.length > input.limit) {
+                    lines.push(`... 仅展示前 ${input.limit} 行，共 ${table.rows.length} 行`);
+                }
+            }
+            if (result.tables.length > MAX_TABLES) {
+                lines.push(`\n... 另有 ${result.tables.length - MAX_TABLES} 个表未展示`);
+            }
+            return lines.join("\n");
+        },
+    };
+}
+function formatTableHeader(table) {
+    const identity = [table.entityName, table.code].filter(Boolean).join(" ");
+    return `### ${table.title}${identity ? ` (${identity})` : ""}`;
+}
+function renderCsv(table, limit) {
+    if (table.fieldnames.length === 0) {
+        return "";
+    }
+    const csvLines = [table.fieldnames.map(escapeCsv).join(",")];
+    for (const row of table.rows.slice(0, limit)) {
+        csvLines.push(table.fieldnames.map((fieldname) => escapeCsv(row[fieldname] ?? "")).join(","));
+    }
+    return csvLines.join("\n");
+}
+function escapeCsv(value) {
+    if (/[",\n]/.test(value)) {
+        return `"${value.replace(/"/g, "\"\"")}"`;
+    }
+    return value;
+}

package/dist/tools/mx-select-stock.tool.js

@@ -43,11 +43,12 @@ export function mxSelectStockTool(mxApiService) {
     };
 }
 function renderMxSelectStockResult(input, result) {
+    const visibleRows = result.dataList.slice(0, input.pageSize);
     const lines = [
         `🧠 妙想选股: ${input.keyword}`,
         `状态: ${result.status ?? "-"} | 业务码: ${result.code ?? "-"} | 消息: ${result.msg ?? result.message ?? "-"}`,
         `结果类型: ${result.resultType ?? "-"} | 总数: ${result.total} | 总记录: ${result.totalRecordCount}`,
-        `页码: ${input.pageNo} | 页大小: ${input.pageSize} | 本页返回: ${result.dataList.length}`,
+        `页码: ${input.pageNo} | 页大小: ${input.pageSize} | 接口返回: ${result.dataList.length} | 展示: ${visibleRows.length} | 数据来源: ${result.dataSource}`,
     ];
     if (result.parserText) {
         lines.push(`解析: ${result.parserText}`);
@@ -73,7 +74,10 @@ function renderMxSelectStockResult(input, result) {
     }
     lines.push("");
     lines.push("CSV:");
-    lines.push(renderCsv(result.columns, result.dataList));
+    lines.push(renderCsv(result.columns, visibleRows));
+    if (result.dataList.length > visibleRows.length) {
+        lines.push(`... 仅展示前 ${visibleRows.length} 行，接口本次返回 ${result.dataList.length} 行`);
+    }
     return lines.join("\n");
 }
 function formatColumnMeta(column) {

package/dist/tools/screen-stock-candidates.tool.d.ts

@@ -0,0 +1,34 @@
+import { type TickflowApiKeyLevel } from "../config/tickflow-access.js";
+import { FinancialService } from "../services/financial-service.js";
+import { AnalysisService } from "../services/analysis-service.js";
+import { KlineService } from "../services/kline-service.js";
+import { MxApiService } from "../services/mx-search-service.js";
+import { QuoteService } from "../services/quote-service.js";
+import { WatchlistService } from "../services/watchlist-service.js";
+import type { MxSelectStockResult } from "../types/mx-select-stock.js";
+interface StockCandidate {
+    rank: number;
+    symbol: string;
+    code: string;
+    market: string | null;
+    name: string;
+    mx: {
+        latestPrice: string | null;
+        changePct: string | null;
+        pe: string | null;
+        pb: string | null;
+        turnoverRate: string | null;
+        volumeRatio: string | null;
+        amount: string | null;
+        marketValue: string | null;
+    };
+}
+export declare function screenStockCandidatesTool(tickflowApiKeyLevel: TickflowApiKeyLevel, mxApiService: MxApiService, quoteService: QuoteService, klineService: KlineService, financialService: FinancialService, watchlistService: WatchlistService, analysisService: AnalysisService): {
+    name: string;
+    description: string;
+    run({ rawInput }: {
+        rawInput?: unknown;
+    }): Promise<string>;
+};
+export declare function extractStockCandidatesFromMxResult(result: MxSelectStockResult, limit: number): StockCandidate[];
+export {};