fi-pool-server 0.1.0

package/dist/tools/auxiliary.js

@@ -0,0 +1,204 @@
+/**
+ * 辅助类工具（Auxiliary）
+ *
+ * 提供帮助信息、资源列表、状态查询、版本信息、配置管理等功能。
+ * 返回值均为元信息，不涉及业务数据。
+ *
+ * @module tools/auxiliary
+ */
+import { getDatabase } from '../db/index.js';
+import { config as configTable } from '../db/schema.js';
+import { eq } from 'drizzle-orm';
+import { VERSION } from '../index.js';
+import * as poolService from '../services/pool.js';
+import * as stockService from '../services/stock.js';
+/**
+ * 输出所有可用的命令和工具帮助信息。
+ *
+ * @param command - 可选命令名称，不指定则输出所有
+ * @returns 帮助文本
+ */
+export async function help(command) {
+    const lines = [
+        'Fi-Pool-Manager v' + VERSION,
+        '',
+        '可用管理命令：',
+        '  create_pool      创建新的股票池',
+        '  delete_pool      删除指定股池',
+        '  update_pool      修改股池信息',
+        '  add_stocks       向股池添加股票',
+        '  remove_stocks    从股池移除股票',
+        '  set_pool_signal  设置股池信号',
+        '',
+        '可用查询命令：',
+        '  list_pools       列出所有股池',
+        '  get_pool_stocks  查股池中的股票',
+        '  get_stock_info   查股票基本信息',
+        '  get_daily_info   查日行情数据',
+        '  get_analysis_report  查客观分析报告',
+        '  get_final_report     查最终报告',
+        '  get_system_status    查看系统状态',
+        '',
+        '可用执行命令：',
+        '  run_local_analysis    运行本地分析',
+        '  run_full_pipeline     运行完整流水线',
+        '  run_pool_analysis     运行股池本地分析',
+        '  run_pool_full_pipeline 运行股池完整流水线',
+        '  refresh_data          刷新行情数据',
+        '',
+        '可用辅助命令：',
+        '  help             显示帮助',
+        '  list_resources   列出可用资源',
+        '  show_state       查看系统简要状态',
+        '  show_version     输出版本信息',
+        '  get_config       查看配置',
+        '  set_config       设置配置',
+        '',
+        '报告输出命令：',
+        '  output_analysis_report  输出客观分析报告',
+        '  output_final_report     输出最终报告',
+        '  output_pool_report      输出股池报告',
+        '  semantic_search         语义搜索',
+        '  session_manage          管理 LLM 会话',
+    ];
+    if (command) {
+        const filtered = lines.filter((l) => l.toLowerCase().includes(command.toLowerCase()));
+        if (filtered.length > 0) {
+            return ['匹配 "' + command + '" 的帮助信息：', '', ...filtered].join('\n');
+        }
+        return `未找到命令: ${command}`;
+    }
+    return lines.join('\n');
+}
+/**
+ * 列出可用资源。
+ *
+ * @param type - 资源类型 "pools" | "stocks" | "tools"
+ * @returns 资源列表
+ */
+export async function listResources(type) {
+    switch (type) {
+        case 'pools': {
+            const pools = await poolService.listPools();
+            return {
+                items: pools.map((p) => ({
+                    id: String(p.id),
+                    name: p.name,
+                })),
+            };
+        }
+        case 'stocks': {
+            const stocks = await stockService.listAllStocks();
+            return {
+                items: stocks.map((s) => ({
+                    id: s.code,
+                    name: s.name,
+                })),
+            };
+        }
+        case 'tools': {
+            const toolNames = [
+                'create_pool', 'delete_pool', 'update_pool', 'add_stocks', 'remove_stocks', 'set_pool_signal',
+                'list_pools', 'get_pool_stocks', 'get_stock_info', 'get_daily_info', 'get_analysis_report',
+                'get_final_report', 'get_system_status', 'output_analysis_report', 'output_final_report',
+                'output_pool_report', 'semantic_search', 'session_manage', 'run_local_analysis',
+                'run_full_pipeline', 'run_pool_analysis', 'run_pool_full_pipeline', 'refresh_data',
+                'help', 'list_resources', 'show_state', 'show_version', 'get_config', 'set_config',
+            ];
+            return {
+                items: toolNames.map((name) => ({ id: name, name })),
+            };
+        }
+        default:
+            return { items: [] };
+    }
+}
+/**
+ * 查看系统简要运行状态。
+ *
+ * @returns { status: 'running' | 'error', version: string, uptime: number }
+ */
+export async function showState() {
+    return {
+        status: 'running',
+        version: VERSION,
+        uptime: Math.floor(process.uptime()),
+    };
+}
+/**
+ * 输出版本信息。
+ *
+ * @returns 版本字符串
+ */
+export async function showVersion() {
+    return `Fi-Pool-Manager v${VERSION}`;
+}
+/**
+ * 查看指定配置项或所有配置。
+ *
+ * 查询优先级：DB → process.env → null。
+ * DB 中不存在的键会 fallback 到 .env 环境变量。
+ *
+ * @param key - 可选配置键名，不指定则返回所有配置
+ * @returns 配置键值对
+ */
+export async function getConfig(key) {
+    const db = getDatabase();
+    if (key) {
+        // 先查 DB，再 fallback 到 process.env
+        const row = db
+            .select()
+            .from(configTable)
+            .where(eq(configTable.key, key))
+            .get();
+        if (row)
+            return { key: row.key, value: row.value };
+        const envVal = process.env[key];
+        return envVal !== undefined
+            ? { key, value: envVal, source: '.env' }
+            : { key, value: null };
+    }
+    // 返回全部：DB 值 + process.env 补充
+    const allRows = db.select().from(configTable).all();
+    const config = {};
+    for (const row of allRows) {
+        config[row.key] = row.value;
+    }
+    // 补充运行时环境变量中不在 DB 中的配置
+    const envKeys = ['LLM_BASE_URL', 'LLM_MODEL', 'DB_PATH', 'DASHSCOPE_API_KEY', 'DATA_FETCH_INTERVAL_MS'];
+    for (const ek of envKeys) {
+        if (!(ek in config) && process.env[ek]) {
+            config[ek] = process.env[ek];
+        }
+    }
+    return { config };
+}
+/**
+ * 修改配置项。
+ *
+ * 同时更新 DB 和运行时的 process.env，确保对同一进程后续读取生效。
+ *
+ * @param key   - 配置键名
+ * @param value - 配置值
+ * @returns { success: true }
+ */
+export async function setConfig(key, value) {
+    try {
+        const db = getDatabase();
+        db.insert(configTable)
+            .values({ key, value })
+            .onConflictDoUpdate({
+            target: configTable.key,
+            set: { value },
+        })
+            .run();
+        // 同步到运行时环境，确保同一进程后续读取一致
+        process.env[key] = value;
+        return { success: true };
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        return { success: false, error: { code: 'DB_ERROR', message } };
+    }
+}
+//# sourceMappingURL=auxiliary.js.map

package/dist/tools/auxiliary.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"auxiliary.js","sourceRoot":"","sources":["../../src/tools/auxiliary.ts"],"names":[],"mappings":"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"}

package/dist/tools/command.d.ts

@@ -0,0 +1,193 @@
+/**
+ * 命令类工具（Command）
+ *
+ * 封装报告输出、语义搜索和会话管理等功能。
+ * 返回值均为复合结构，包含完整或摘要的内容。
+ *
+ * @module tools/command
+ */
+import * as embeddingService from '../services/embedding.js';
+/**
+ * 输出指定股票指定日期的客观分析报告。
+ *
+ * @param code - 股票代码
+ * @param date - 报告日期 'yyyy-MM-dd'
+ * @param mode - 输出模式：
+ *   - 'overview'：仅返回 code、date、summary 摘要字段
+ *   - 'full'（默认）：返回完整报告（含 indicators、signals JSON）
+ * @returns 包含 code、date、summary 的报告对象，不存在时返回 null
+ *
+ * @example
+ * const report = await outputAnalysisReport('600519', '2024-06-01', 'full');
+ * if (report) console.log(report.summary);
+ */
+export declare function outputAnalysisReport(code: string, date: string, mode?: 'overview' | 'full'): Promise<{
+    code: string;
+    date: string;
+    summary: string;
+    createdAt: string;
+} | {
+    id: number;
+    indicators: string;
+    signals: string;
+    code: string;
+    date: string;
+    summary: string;
+    createdAt: string;
+} | null>;
+/**
+ * 输出指定股票指定日期的最终报告。
+ *
+ * @param code - 股票代码
+ * @param date - 报告日期 'yyyy-MM-dd'
+ * @param mode - 输出模式：
+ *   - 'overview'：仅返回 code、date、summary、pipelineId 摘要字段
+ *   - 'full'（默认）：返回完整报告（含 fullReport、roleSummary）
+ * @returns 包含 code、date 的报告对象，不存在时返回 null
+ *
+ * @example
+ * const report = await outputFinalReport('600519', '2024-06-01', 'overview');
+ */
+export declare function outputFinalReport(code: string, date: string, mode?: 'overview' | 'full'): Promise<{
+    code: string;
+    date: string;
+    summary: string;
+    pipelineId: string;
+    createdAt: string;
+} | {
+    id: number;
+    fullReport: string;
+    roleSummary: string | {
+        role: string;
+        keyPoint: string;
+    }[];
+    code: string;
+    date: string;
+    summary: string;
+    pipelineId: string;
+    createdAt: string;
+} | null>;
+/**
+ * 输出指定股池的综合分析报告。
+ *
+ * @param poolId - 股池 ID
+ * @param mode - 输出模式：
+ *   - 'overview'：仅输出股池摘要信息和股票列表
+ *   - 'full'（默认）：输出完整报告（含每只股票的最新分析摘要）
+ * @returns 包含 poolId、name 的股池报告对象，股池不存在时返回 null
+ *
+ * @example
+ * const r = await outputPoolReport(1, 'overview');
+ */
+export declare function outputPoolReport(poolId: number, mode?: 'overview' | 'full'): Promise<{
+    poolId: number;
+    poolName: string;
+    poolDesc: string;
+    poolSignal: number;
+    stockCount: number;
+    stocks: {
+        code: string;
+        name: string;
+        currentPrice: number;
+        signal: number;
+        latestAnalysisDate: string | null;
+        summary: string | null;
+    }[];
+} | {
+    summary: string;
+    poolId: number;
+    poolName: string;
+    poolDesc: string;
+    poolSignal: number;
+    stockCount: number;
+    stocks: {
+        code: string;
+        name: string;
+        currentPrice: number;
+        signal: number;
+        latestAnalysisDate: string | null;
+        summary: string | null;
+    }[];
+} | null>;
+/**
+ * 基于语义相似度搜索历史分析报告。
+ *
+ * 通过向量嵌入技术，搜索与查询文本语义相似的分析报告或最终报告。
+ *
+ * @param query - 搜索查询文本
+ * @param limit - 最多返回结果数，默认 10
+ * @param type - 搜索范围：
+ *   - 'analysis'：仅搜索客观分析报告
+ *   - 'final'：仅搜索最终报告
+ *   - 'all'（默认）：搜索全部类型
+ * @returns 搜索结果数组，按相关性降序排列
+ *
+ * @example
+ * const results = await semanticSearch('贵州茅台', 5, 'final');
+ * results.forEach(r => console.log(r.code, r.date, r.relevance));
+ */
+export declare function semanticSearch(query: string, limit?: number, type?: 'analysis' | 'final' | 'all'): Promise<embeddingService.SearchResult[]>;
+/**
+ * 管理 LLM 会话。
+ *
+ * 支持新建、切换、列出全部和查看当前会话四种操作。
+ *
+ * @param action - 操作类型：
+ *   - 'new'：创建新会话
+ *   - 'switch'：切换到指定会话（不存在时自动创建）
+ *   - 'list'：列出所有会话
+ *   - 'current'：查看当前会话信息
+ * @param sessionId - 切换到指定会话时的 ID（action 为 'switch' 时必填）
+ * @returns 会话操作结果对象
+ *
+ * @example
+ * // 创建新会话
+ * const s1 = await sessionManage('new');
+ * // 切换到已有会话
+ * const s2 = await sessionManage('switch', 'a1b2c3d4');
+ * // 列出所有会话
+ * const list = await sessionManage('list');
+ * // 查看当前会话
+ * const cur = await sessionManage('current');
+ */
+export declare function sessionManage(action: 'new' | 'switch' | 'list' | 'current', sessionId?: string): Promise<{
+    action: "new";
+    sessionId: string;
+    createdAt: string;
+    previousId?: undefined;
+    count?: undefined;
+    sessions?: undefined;
+    session?: undefined;
+} | {
+    action: "switch";
+    sessionId: string;
+    previousId: string | undefined;
+    createdAt?: undefined;
+    count?: undefined;
+    sessions?: undefined;
+    session?: undefined;
+} | {
+    action: "list";
+    count: number;
+    sessions: {
+        id: string;
+        createdAt: string;
+    }[];
+    sessionId?: undefined;
+    createdAt?: undefined;
+    previousId?: undefined;
+    session?: undefined;
+} | {
+    action: "current";
+    session: {
+        id: string;
+        createdAt: string;
+        messageCount: number;
+    } | null;
+    sessionId?: undefined;
+    createdAt?: undefined;
+    previousId?: undefined;
+    count?: undefined;
+    sessions?: undefined;
+}>;
+//# sourceMappingURL=command.d.ts.map

package/dist/tools/command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"command.d.ts","sourceRoot":"","sources":["../../src/tools/command.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AASH,OAAO,KAAK,gBAAgB,MAAM,0BAA0B,CAAC;AAG7D;;;;;;;;;;;;;GAaG;AACH,wBAAsB,oBAAoB,CACxC,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,IAAI,GAAE,UAAU,GAAG,MAAe;;;;;;;;;;;;;UA+BnC;AAED;;;;;;;;;;;;GAYG;AACH,wBAAsB,iBAAiB,CACrC,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,IAAI,GAAE,UAAU,GAAG,MAAe;;;;;;;;;;cA2BA,MAAM;kBAAY,MAAM;;;;;;;UAa3D;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,GAAE,UAAU,GAAG,MAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;UA8DxF;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAsB,cAAc,CAClC,KAAK,EAAE,MAAM,EACb,KAAK,GAAE,MAAW,EAClB,IAAI,GAAE,UAAU,GAAG,OAAO,GAAG,KAAa,4CAQ3C;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAsB,aAAa,CACjC,MAAM,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,SAAS,EAC7C,SAAS,CAAC,EAAE,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkDnB"}

package/dist/tools/command.js

@@ -0,0 +1,263 @@
+/**
+ * 命令类工具（Command）
+ *
+ * 封装报告输出、语义搜索和会话管理等功能。
+ * 返回值均为复合结构，包含完整或摘要的内容。
+ *
+ * @module tools/command
+ */
+import { getDatabase } from '../db/index.js';
+import { dailyAnalysisReport, finalReport, } from '../db/schema.js';
+import { eq, and, desc } from 'drizzle-orm';
+import * as poolService from '../services/pool.js';
+import * as embeddingService from '../services/embedding.js';
+import * as sessionService from '../services/session.js';
+/**
+ * 输出指定股票指定日期的客观分析报告。
+ *
+ * @param code - 股票代码
+ * @param date - 报告日期 'yyyy-MM-dd'
+ * @param mode - 输出模式：
+ *   - 'overview'：仅返回 code、date、summary 摘要字段
+ *   - 'full'（默认）：返回完整报告（含 indicators、signals JSON）
+ * @returns 包含 code、date、summary 的报告对象，不存在时返回 null
+ *
+ * @example
+ * const report = await outputAnalysisReport('600519', '2024-06-01', 'full');
+ * if (report) console.log(report.summary);
+ */
+export async function outputAnalysisReport(code, date, mode = 'full') {
+    const db = getDatabase();
+    const row = db
+        .select()
+        .from(dailyAnalysisReport)
+        .where(and(eq(dailyAnalysisReport.code, code), eq(dailyAnalysisReport.date, date)))
+        .get();
+    if (!row)
+        return null;
+    const base = {
+        code: row.code,
+        date: row.date,
+        summary: row.summary,
+        createdAt: row.createdAt,
+    };
+    if (mode === 'overview')
+        return base;
+    return {
+        ...base,
+        id: row.id,
+        indicators: row.indicators,
+        signals: row.signals,
+    };
+}
+/**
+ * 输出指定股票指定日期的最终报告。
+ *
+ * @param code - 股票代码
+ * @param date - 报告日期 'yyyy-MM-dd'
+ * @param mode - 输出模式：
+ *   - 'overview'：仅返回 code、date、summary、pipelineId 摘要字段
+ *   - 'full'（默认）：返回完整报告（含 fullReport、roleSummary）
+ * @returns 包含 code、date 的报告对象，不存在时返回 null
+ *
+ * @example
+ * const report = await outputFinalReport('600519', '2024-06-01', 'overview');
+ */
+export async function outputFinalReport(code, date, mode = 'full') {
+    const db = getDatabase();
+    const row = db
+        .select()
+        .from(finalReport)
+        .where(and(eq(finalReport.code, code), eq(finalReport.date, date)))
+        .get();
+    if (!row)
+        return null;
+    const base = {
+        code: row.code,
+        date: row.date,
+        summary: row.summary,
+        pipelineId: row.pipelineId,
+        createdAt: row.createdAt,
+    };
+    if (mode === 'overview')
+        return base;
+    // 尝试解析 roleSummary JSON，失败则返回原始字符串
+    let roleSummary = row.roleSummary;
+    try {
+        roleSummary = JSON.parse(row.roleSummary);
+    }
+    catch {
+        // 保持原始字符串
+    }
+    return {
+        ...base,
+        id: row.id,
+        fullReport: row.fullReport,
+        roleSummary,
+    };
+}
+/**
+ * 输出指定股池的综合分析报告。
+ *
+ * @param poolId - 股池 ID
+ * @param mode - 输出模式：
+ *   - 'overview'：仅输出股池摘要信息和股票列表
+ *   - 'full'（默认）：输出完整报告（含每只股票的最新分析摘要）
+ * @returns 包含 poolId、name 的股池报告对象，股池不存在时返回 null
+ *
+ * @example
+ * const r = await outputPoolReport(1, 'overview');
+ */
+export async function outputPoolReport(poolId, mode = 'full') {
+    const poolInfo = await poolService.getPoolById(poolId);
+    if (!poolInfo)
+        return null;
+    const stocksInPool = await poolService.getPoolStocks(poolId);
+    const db = getDatabase();
+    const stockSummaries = await Promise.all(stocksInPool.map(async (s) => {
+        const latestAnalysis = db
+            .select({
+            date: dailyAnalysisReport.date,
+            summary: dailyAnalysisReport.summary,
+            signals: dailyAnalysisReport.signals,
+        })
+            .from(dailyAnalysisReport)
+            .where(eq(dailyAnalysisReport.code, s.code))
+            .orderBy(desc(dailyAnalysisReport.date))
+            .limit(1)
+            .get();
+        let signal = 0;
+        if (latestAnalysis?.signals) {
+            try {
+                const parsed = JSON.parse(latestAnalysis.signals);
+                if (parsed.goldenCross)
+                    signal = 1;
+                else if (parsed.deadCross)
+                    signal = -1;
+            }
+            catch {
+                // ignore
+            }
+        }
+        return {
+            code: s.code,
+            name: s.name,
+            currentPrice: s.currentPrice,
+            signal,
+            latestAnalysisDate: latestAnalysis?.date || null,
+            summary: latestAnalysis?.summary?.slice(0, 200) || null,
+        };
+    }));
+    const base = {
+        poolId: poolInfo.id,
+        poolName: poolInfo.name,
+        poolDesc: poolInfo.desc,
+        poolSignal: poolInfo.poolSignal,
+        stockCount: stockSummaries.length,
+        stocks: stockSummaries,
+    };
+    if (mode === 'overview') {
+        const bullish = stockSummaries.filter((s) => s.signal === 1).length;
+        const bearish = stockSummaries.filter((s) => s.signal === -1).length;
+        return {
+            ...base,
+            summary: `股池共 ${base.stockCount} 只股票，看多 ${bullish} 只，看空 ${bearish} 只，中性 ${base.stockCount - bullish - bearish} 只。`,
+        };
+    }
+    return base;
+}
+/**
+ * 基于语义相似度搜索历史分析报告。
+ *
+ * 通过向量嵌入技术，搜索与查询文本语义相似的分析报告或最终报告。
+ *
+ * @param query - 搜索查询文本
+ * @param limit - 最多返回结果数，默认 10
+ * @param type - 搜索范围：
+ *   - 'analysis'：仅搜索客观分析报告
+ *   - 'final'：仅搜索最终报告
+ *   - 'all'（默认）：搜索全部类型
+ * @returns 搜索结果数组，按相关性降序排列
+ *
+ * @example
+ * const results = await semanticSearch('贵州茅台', 5, 'final');
+ * results.forEach(r => console.log(r.code, r.date, r.relevance));
+ */
+export async function semanticSearch(query, limit = 10, type = 'all') {
+    const searchType = type === 'all' ? undefined : type;
+    return embeddingService.searchSimilar({
+        query,
+        type: searchType,
+        limit,
+    });
+}
+/**
+ * 管理 LLM 会话。
+ *
+ * 支持新建、切换、列出全部和查看当前会话四种操作。
+ *
+ * @param action - 操作类型：
+ *   - 'new'：创建新会话
+ *   - 'switch'：切换到指定会话（不存在时自动创建）
+ *   - 'list'：列出所有会话
+ *   - 'current'：查看当前会话信息
+ * @param sessionId - 切换到指定会话时的 ID（action 为 'switch' 时必填）
+ * @returns 会话操作结果对象
+ *
+ * @example
+ * // 创建新会话
+ * const s1 = await sessionManage('new');
+ * // 切换到已有会话
+ * const s2 = await sessionManage('switch', 'a1b2c3d4');
+ * // 列出所有会话
+ * const list = await sessionManage('list');
+ * // 查看当前会话
+ * const cur = await sessionManage('current');
+ */
+export async function sessionManage(action, sessionId) {
+    switch (action) {
+        case 'new': {
+            const id = sessionService.createSession();
+            return {
+                action: 'new',
+                sessionId: id,
+                createdAt: new Date().toISOString(),
+            };
+        }
+        case 'switch': {
+            if (!sessionId) {
+                throw new Error('switch 操作需要提供 sessionId 参数');
+            }
+            const result = sessionService.switchSession(sessionId);
+            return {
+                action: 'switch',
+                sessionId: result.sessionId,
+                previousId: result.previousId,
+            };
+        }
+        case 'list': {
+            const sessions = sessionService.listSessions();
+            return {
+                action: 'list',
+                count: sessions.length,
+                sessions,
+            };
+        }
+        case 'current': {
+            const current = sessionService.getCurrentSession();
+            return {
+                action: 'current',
+                session: current
+                    ? {
+                        id: current.id,
+                        createdAt: current.createdAt,
+                        messageCount: current.messages.length,
+                    }
+                    : null,
+            };
+        }
+        default:
+            throw new Error(`未知的会话操作: ${action}`);
+    }
+}
+//# sourceMappingURL=command.js.map

package/dist/tools/command.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"command.js","sourceRoot":"","sources":["../../src/tools/command.ts"],"names":[],"mappings":"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"}