tickflow-assist 0.2.0

package/dist/tools/fetch-intraday-klines.tool.js

@@ -0,0 +1,58 @@
+import { formatTickflowApiKeyLevel, supportsIntradayKlines, } from "../config/tickflow-access.js";
+import { normalizeSymbol } from "../utils/symbol.js";
+const FETCH_INTRADAY_RETENTION_DAYS = 10;
+function parseInput(rawInput) {
+    if (typeof rawInput === "object" && rawInput !== null) {
+        const obj = rawInput;
+        const symbol = String(obj.symbol ?? "").trim();
+        const period = obj.period == null ? undefined : String(obj.period).trim();
+        const count = obj.count == null ? undefined : Number(obj.count);
+        if (!symbol) {
+            throw new Error("fetch-intraday-klines requires symbol");
+        }
+        return { symbol, period, count };
+    }
+    if (typeof rawInput === "string" && rawInput.trim()) {
+        const parts = rawInput.trim().split(/\s+/);
+        return {
+            symbol: parts[0] ?? "",
+            period: parts[1] || undefined,
+            count: parts[2] ? Number(parts[2]) : undefined,
+        };
+    }
+    throw new Error("invalid fetch-intraday-klines input");
+}
+export function fetchIntradayKlinesTool(tickflowApiKeyLevel, klineService, intradayKlinesRepository, tradingCalendarService) {
+    return {
+        name: "fetch_intraday_klines",
+        description: "Fetch intraday minute K-lines from TickFlow and write them to LanceDB.",
+        async run({ rawInput }) {
+            const input = parseInput(rawInput);
+            const symbol = normalizeSymbol(input.symbol);
+            const period = input.period ?? "1m";
+            if (!supportsIntradayKlines(tickflowApiKeyLevel)) {
+                return `⚠️ 当前 TickFlow API Key Level 为 ${formatTickflowApiKeyLevel(tickflowApiKeyLevel)}，不支持分钟K线接口`;
+            }
+            const rows = await klineService.fetchIntradayKlines(symbol, {
+                period,
+                count: input.count,
+            });
+            if (rows.length === 0) {
+                return `⚠️ 未获取到 ${symbol} 的分钟K线数据（period=${period}）`;
+            }
+            await intradayKlinesRepository.saveAll(symbol, period, rows);
+            const keepTradeDates = await tradingCalendarService.getRecentTradingDays(FETCH_INTRADAY_RETENTION_DAYS, new Date(rows[rows.length - 1].timestamp));
+            await intradayKlinesRepository.pruneToTradeDates(symbol, period, keepTradeDates);
+            const first = rows[0];
+            const last = rows[rows.length - 1];
+            return [
+                `📈 获取 ${symbol} 分钟K线数据完成`,
+                `周期: ${period}`,
+                `数量: ${rows.length} 根`,
+                `区间: ${first.trade_date} ${first.trade_time} ~ ${last.trade_date} ${last.trade_time}`,
+                `最新收盘: ${last.close.toFixed(2)}`,
+                "💾 分钟K线数据已写入数据库表 klines_intraday",
+            ].join("\n");
+        },
+    };
+}

package/dist/tools/fetch-klines.tool.d.ts

@@ -0,0 +1,11 @@
+import { KlineService } from "../services/kline-service.js";
+import { KlinesRepository } from "../storage/repositories/klines-repo.js";
+import { IndicatorService } from "../services/indicator-service.js";
+import { IndicatorsRepository } from "../storage/repositories/indicators-repo.js";
+export declare function fetchKlinesTool(klineService: KlineService, klinesRepository: KlinesRepository, indicatorService: IndicatorService, indicatorsRepository: IndicatorsRepository): {
+    name: string;
+    description: string;
+    run({ rawInput }: {
+        rawInput?: unknown;
+    }): Promise<string>;
+};

package/dist/tools/fetch-klines.tool.js

@@ -0,0 +1,61 @@
+import { normalizeSymbol } from "../utils/symbol.js";
+function parseInput(rawInput) {
+    if (typeof rawInput === "object" && rawInput !== null) {
+        const obj = rawInput;
+        const symbol = String(obj.symbol ?? "").trim();
+        const count = obj.count == null ? undefined : Number(obj.count);
+        const adjust = obj.adjust == null ? undefined : String(obj.adjust);
+        if (!symbol) {
+            throw new Error("fetch-klines requires symbol");
+        }
+        return { symbol, count, adjust };
+    }
+    if (typeof rawInput === "string" && rawInput.trim()) {
+        const parts = rawInput.trim().split(/\s+/);
+        return {
+            symbol: parts[0],
+            count: parts[1] ? Number(parts[1]) : undefined,
+        };
+    }
+    throw new Error("invalid fetch-klines input");
+}
+export function fetchKlinesTool(klineService, klinesRepository, indicatorService, indicatorsRepository) {
+    return {
+        name: "fetch_klines",
+        description: "Fetch daily K-lines from TickFlow and return a normalized summary.",
+        async run({ rawInput }) {
+            const input = parseInput(rawInput);
+            const symbol = normalizeSymbol(input.symbol);
+            const rows = await klineService.fetchKlines(symbol, {
+                count: input.count ?? 90,
+                adjust: input.adjust ?? "forward",
+            });
+            if (rows.length === 0) {
+                return `⚠️ 未获取到 ${symbol} 的日K线数据`;
+            }
+            await klinesRepository.saveAll(symbol, rows);
+            const indicators = await indicatorService.calculate(rows);
+            await indicatorsRepository.saveAll(symbol, indicators);
+            const first = rows[0];
+            const last = rows[rows.length - 1];
+            const latestIndicator = indicators[indicators.length - 1];
+            return [
+                `📊 获取 ${symbol} 日K线数据完成`,
+                `数量: ${rows.length} 根`,
+                `区间: ${first.trade_date} ~ ${last.trade_date}`,
+                `最新收盘: ${last.close.toFixed(2)}`,
+                `💾 K线数据已写入数据库`,
+                `🔧 技术指标已计算并写入数据库`,
+                latestIndicator
+                    ? `最新指标: MA5 ${formatIndicator(latestIndicator.ma5)} | MA10 ${formatIndicator(latestIndicator.ma10)} | RSI6 ${formatIndicator(latestIndicator.rsi_6)}`
+                    : `最新指标: 暂无`,
+            ].join("\n");
+        },
+    };
+}
+function formatIndicator(value) {
+    if (value == null || Number.isNaN(value)) {
+        return "-";
+    }
+    return value.toFixed(2);
+}

package/dist/tools/list-watchlist.tool.d.ts

@@ -0,0 +1,6 @@
+import { WatchlistService } from "../services/watchlist-service.js";
+export declare function listWatchlistTool(watchlistService: WatchlistService): {
+    name: string;
+    description: string;
+    run(): Promise<string>;
+};

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

@@ -0,0 +1,22 @@
+import { formatCostPrice } from "../utils/cost-price.js";
+export function listWatchlistTool(watchlistService) {
+    return {
+        name: "list_watchlist",
+        description: "List current watchlist symbols with names, optional cost price, and industry/concept metadata.",
+        async run() {
+            const items = await watchlistService.list();
+            if (items.length === 0) {
+                return "📋 关注列表为空";
+            }
+            const lines = [`📋 当前关注列表 (${items.length} 只):`];
+            for (const item of items) {
+                const tags = [
+                    item.sector ? `行业分类 ${item.sector}` : null,
+                    item.themes.length > 0 ? `概念板块 ${item.themes.join("、")}` : null,
+                ].filter(Boolean);
+                lines.push(`• ${item.name}（${item.symbol}） 成本: ${formatCostPrice(item.costPrice)}${tags.length > 0 ? ` | ${tags.join(" | ")}` : ""}`);
+            }
+            return lines.join("\n");
+        },
+    };
+}

package/dist/tools/monitor-status.tool.d.ts

@@ -0,0 +1,6 @@
+import { MonitorService } from "../services/monitor-service.js";
+export declare function monitorStatusTool(monitorService: MonitorService): {
+    name: string;
+    description: string;
+    run(): Promise<string>;
+};

package/dist/tools/monitor-status.tool.js

@@ -0,0 +1,9 @@
+export function monitorStatusTool(monitorService) {
+    return {
+        name: "monitor_status",
+        description: "Show current monitor state, watchlist snapshot, latest quotes, and alert summary.",
+        async run() {
+            return monitorService.getStatusReport();
+        },
+    };
+}

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

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

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

@@ -0,0 +1,77 @@
+const DEFAULT_LIMIT = 5;
+const MAX_LIMIT = 10;
+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.keyword ?? obj.q ?? "").trim();
+        const limit = obj.limit == null ? DEFAULT_LIMIT : Number(obj.limit);
+        if (!query) {
+            throw new Error("mx_search requires query");
+        }
+        if (!Number.isFinite(limit) || limit <= 0) {
+            throw new Error("mx_search limit must be > 0");
+        }
+        return {
+            query,
+            limit: Math.min(Math.trunc(limit), MAX_LIMIT),
+        };
+    }
+    throw new Error("invalid mx_search input");
+}
+export function mxSearchTool(mxSearchService) {
+    return {
+        name: "mx_search",
+        description: "Search timely market information such as news, announcements, reports, policy, and event interpretation.",
+        async run({ rawInput }) {
+            const input = parseInput(rawInput);
+            const documents = await mxSearchService.search(input.query);
+            const selected = documents.slice(0, input.limit);
+            if (selected.length === 0) {
+                return [
+                    `🔎 妙想搜索: ${input.query}`,
+                    "结果数: 0",
+                    "⚠️ 未检索到匹配资讯",
+                ].join("\n");
+            }
+            const lines = [
+                `🔎 妙想搜索: ${input.query}`,
+                `结果数: ${documents.length}`,
+                `展示: ${selected.length}`,
+                "",
+            ];
+            selected.forEach((item, index) => {
+                lines.push(`${index + 1}. ${item.title}`);
+                if (item.publishedAt) {
+                    lines.push(`时间: ${item.publishedAt}`);
+                }
+                if (item.source) {
+                    lines.push(`来源: ${item.source}`);
+                }
+                if (item.secuList.length > 0) {
+                    lines.push(`关联标的: ${formatSecurities(item.secuList)}`);
+                }
+                lines.push("正文:");
+                lines.push(item.trunk || "无正文");
+                if (index < selected.length - 1) {
+                    lines.push("");
+                }
+            });
+            return lines.join("\n");
+        },
+    };
+}
+function formatSecurities(securities) {
+    return securities
+        .map((item) => {
+        const main = [item.secuName, item.secuCode].filter(Boolean).join(" ");
+        return item.secuType ? `${main} (${item.secuType})` : main;
+    })
+        .filter(Boolean)
+        .join("；");
+}

package/dist/tools/mx-select-stock.tool.d.ts

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

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

@@ -0,0 +1,118 @@
+const DEFAULT_PAGE_NO = 1;
+const DEFAULT_PAGE_SIZE = 20;
+const MAX_PAGE_SIZE = 100;
+function parseInput(rawInput) {
+    if (typeof rawInput === "string" && rawInput.trim()) {
+        return {
+            keyword: rawInput.trim(),
+            pageNo: DEFAULT_PAGE_NO,
+            pageSize: DEFAULT_PAGE_SIZE,
+        };
+    }
+    if (typeof rawInput === "object" && rawInput !== null) {
+        const obj = rawInput;
+        const keyword = String(obj.keyword ?? obj.query ?? obj.q ?? "").trim();
+        const pageNo = obj.pageNo == null ? DEFAULT_PAGE_NO : Number(obj.pageNo);
+        const pageSize = obj.pageSize == null ? DEFAULT_PAGE_SIZE : Number(obj.pageSize);
+        if (!keyword) {
+            throw new Error("mx_select_stock requires keyword");
+        }
+        if (!Number.isFinite(pageNo) || pageNo <= 0) {
+            throw new Error("mx_select_stock pageNo must be > 0");
+        }
+        if (!Number.isFinite(pageSize) || pageSize <= 0) {
+            throw new Error("mx_select_stock pageSize must be > 0");
+        }
+        return {
+            keyword,
+            pageNo: Math.trunc(pageNo),
+            pageSize: Math.min(Math.trunc(pageSize), MAX_PAGE_SIZE),
+        };
+    }
+    throw new Error("invalid mx_select_stock input");
+}
+export function mxSelectStockTool(mxApiService) {
+    return {
+        name: "mx_select_stock",
+        description: "Screen stocks by natural-language conditions using MX smart stock screening.",
+        async run({ rawInput }) {
+            const input = parseInput(rawInput);
+            const result = await mxApiService.selectStocks(input);
+            return renderMxSelectStockResult(input, result);
+        },
+    };
+}
+function renderMxSelectStockResult(input, result) {
+    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}`,
+    ];
+    if (result.parserText) {
+        lines.push(`解析: ${result.parserText}`);
+    }
+    if (result.totalCondition) {
+        lines.push(`组合条件: ${result.totalCondition.describe}（${result.totalCondition.stockCount ?? "-"} 只）`);
+    }
+    if (result.responseConditionList.length > 0) {
+        lines.push("", "条件拆解:");
+        for (const condition of result.responseConditionList) {
+            lines.push(`- ${condition.describe}（${condition.stockCount ?? "-"} 只）`);
+        }
+    }
+    lines.push("");
+    lines.push("字段说明:");
+    if (result.columns.length === 0) {
+        lines.push("- 无字段定义");
+    }
+    else {
+        for (const column of result.columns) {
+            lines.push(`- ${column.title} <- ${column.key}${formatColumnMeta(column)}`);
+        }
+    }
+    lines.push("");
+    lines.push("CSV:");
+    lines.push(renderCsv(result.columns, result.dataList));
+    return lines.join("\n");
+}
+function formatColumnMeta(column) {
+    const parts = [];
+    if (column.unit) {
+        parts.push(`单位=${column.unit}`);
+    }
+    if (column.dataType) {
+        parts.push(`类型=${column.dataType}`);
+    }
+    if (column.dateMsg) {
+        parts.push(`日期=${column.dateMsg}`);
+    }
+    return parts.length > 0 ? ` (${parts.join(", ")})` : "";
+}
+function renderCsv(columns, rows) {
+    if (columns.length === 0) {
+        return "";
+    }
+    const headerLabels = columns.map((column) => escapeCsv(column.title));
+    const csvLines = [headerLabels.join(",")];
+    for (const row of rows) {
+        const values = columns.map((column) => escapeCsv(formatCell(row[column.key])));
+        csvLines.push(values.join(","));
+    }
+    return csvLines.join("\n");
+}
+function formatCell(value) {
+    if (value == null) {
+        return "";
+    }
+    if (typeof value === "object") {
+        return JSON.stringify(value);
+    }
+    return String(value);
+}
+function escapeCsv(value) {
+    if (/[",\n]/.test(value)) {
+        return `"${value.replace(/"/g, "\"\"")}"`;
+    }
+    return value;
+}

package/dist/tools/query-database.tool.d.ts

@@ -0,0 +1,8 @@
+import { Database } from "../storage/db.js";
+export declare function queryDatabaseTool(database: Database): {
+    name: string;
+    description: string;
+    run({ rawInput }: {
+        rawInput?: unknown;
+    }): Promise<string>;
+};