@cuebot/skill 1.0.5

package/src/api/cuecueClient.js

@@ -0,0 +1,851 @@
+/**
+ * CueCue API 客户端
+ * 基于官方 SDK 的流式 API 实现
+ */
+
+import https from 'https';
+import { randomUUID } from 'crypto';
+import { createLogger } from '../core/logger.js';
+
+const logger = createLogger('CueCueClient');
+
+const BASE_URL = 'https://cuecue.cn';
+
+/**
+ * 角色模式配置
+ */
+const MODE_CONFIGS = {
+  trader: {
+    role: '短线交易分析师',
+    focus: '资金流向、席位动向、市场情绪、技术形态、游资博弈',
+    framework: '市场微观结构与资金流向分析框架（Timeline Reconstruction）',
+    method: '追踪龙虎榜席位动向，分析大单资金流向，识别市场情绪拐点，研判技术形态支撑压力位',
+    sources: '交易所龙虎榜、Level-2 行情数据、东方财富/同花顺资金数据、游资席位追踪、实时财经快讯'
+  },
+  'fund-manager': {
+    role: '基金经理',
+    focus: '估值模型、财务分析、投资决策、风险收益比',
+    framework: '基本面分析与估值模型框架',
+    method: '深度分析财务报表，构建估值模型（DCF/PE/PB 等），评估内在价值与市场价格偏离度',
+    sources: '上市公司财报、交易所公告、Wind/同花顺数据、券商深度研报、管理层访谈纪要'
+  },
+  researcher: {
+    role: '行业研究员',
+    focus: '产业链分析、竞争格局、技术趋势、市场空间',
+    framework: '产业链拆解与竞争力评估框架（Peer Benchmarking）',
+    method: '梳理上下游产业链结构，对比主要竞争对手的核心能力，研判技术演进趋势',
+    sources: '上市公司公告、券商研报、行业协会数据、专利数据库、技术白皮书'
+  },
+  advisor: {
+    role: '资深理财顾问',
+    focus: '投资建议、资产配置、风险控制、收益预期',
+    framework: '资产配置与风险收益评估框架',
+    method: '根据用户财务状况，提供个性化的投资组合建议，分析各类资产的风险收益特征',
+    sources: '公募基金报告、保险产品说明书、银行理财公告、权威财经媒体'
+  }
+};
+
+/**
+ * 构建 rewritten_mandate 格式的提示词
+ * @param {string} topic - 研究主题
+ * @param {string} mode - 研究模式
+ * @returns {string}
+ */
+export function buildPrompt(topic, mode = 'default') {
+  // 输入验证
+  if (!topic || typeof topic !== 'string' || topic.trim().length === 0) {
+    throw new Error('Invalid topic: must be non-empty string');
+  }
+  
+  const config = MODE_CONFIGS[mode];
+  
+  if (!config) {
+    logger.warn(`Unknown mode: ${mode}, using default researcher`);
+  }
+  
+  const safeTopic = topic.trim().slice(0, 500); // 限制长度防止过大
+  
+  return `**【调研目标】**
+以${config.role}的专业视角，针对"${safeTopic}"进行全网深度信息搜集与分析，旨在回答该主题下的核心投资/交易问题。
+
+**【信息搜集与整合框架】**
+1. **${config.framework}**：${config.method}。
+2. **关键证据锚定**：针对核心争议点或关键数据，查找并引用权威信源（如官方公告、交易所数据、权威研报）的原始信息。
+3. **多维视角交叉**：汇总不同利益相关方（如买方机构、卖方分析师、产业从业者）的观点差异与共识。
+
+**【信源与边界】**
+- 优先信源：${config.sources}。
+- 时间窗口：结合当前日期，优先近 6 个月内的最新动态与数据。
+- 排除信源：无明确来源的小道消息、未经证实的社交媒体传言。
+
+**【核心关注】**
+${config.focus}`;
+}
+
+/**
+ * 自动检测研究模式
+ * @param {string} topic - 研究主题
+ * @returns {string}
+ */
+export function autoDetectMode(topic) {
+  // 输入验证
+  if (!topic || typeof topic !== 'string') {
+    return 'researcher';
+  }
+  
+  const topicLower = topic.toLowerCase().slice(0, 200); // 限制长度防止正则爆炸
+  
+  // 短线交易
+  if (/龙虎榜|涨停|游资|资金流向|短线|打板|连板|换手率|主力资金/.test(topicLower)) {
+    return 'trader';
+  }
+  
+  // 基金经理
+  if (/财报|估值|业绩|年报|季报|投资|财务|ROE|PE|PB|现金流|盈利/.test(topicLower)) {
+    return 'fund-manager';
+  }
+  
+  // 研究员
+  if (/产业链|竞争格局|技术路线|市场格局|行业分析|市场份额|供应链|上下游/.test(topicLower)) {
+    return 'researcher';
+  }
+  
+  // 理财顾问
+  if (/投资建议|资产配置|风险控制|适合买|怎么买|定投|组合/.test(topicLower)) {
+    return 'advisor';
+  }
+  
+  // 默认研究员
+  return 'researcher';
+}
+
+/**
+ * 启动深度研究（流式 API）
+ * @param {Object} options - 选项
+ * @param {string} options.topic - 研究主题
+ * @param {string} options.mode - 研究模式
+ * @param {string} options.chatId - 聊天 ID
+ * @param {string} options.apiKey - API Key
+ * @param {Function} options.onProgress - 进度回调
+ * @returns {Promise<Object>}
+ */
+export async function startResearch({ topic, mode, chatId, apiKey, userProfile, onProgress }) {
+  const conversationId = `conv_${randomUUID().replace(/-/g, '')}`;
+  const messageId = `msg_${randomUUID().replace(/-/g, '')}`;
+  const reportUrl = `${BASE_URL}/c/${conversationId}`;
+  
+  // 自动检测模式
+  if (!mode || mode === 'default') {
+    mode = autoDetectMode(topic);
+  }
+  
+  // 构建提示词
+  const prompt = buildPromptLayered(topic, { mode, userProfile });
+  
+  logger.info(`Starting research: ${topic} (mode: ${mode})`);
+  
+  // 发送进度更新
+  if (onProgress) {
+    onProgress({
+      stage: 'start',
+      message: `🔬 开始深度研究：${topic}`,
+      reportUrl
+    });
+  }
+  
+  try {
+    // 使用流式 API
+    const result = await makeStreamRequest({
+      conversationId,
+      messageId,
+      prompt,
+      chatId,
+      apiKey,
+      onProgress
+    });
+    
+    return {
+      conversationId,
+      chatId,
+      reportUrl,
+      topic,
+      mode,
+      ...result
+    };
+  } catch (error) {
+    logger.error('Failed to start research', error);
+    throw error;
+  }
+}
+
+/**
+ * 发送流式 HTTPS 请求
+ * @param {Object} options - 选项
+ * @returns {Promise<Object>}
+ */
+function makeStreamRequest({ conversationId, messageId, prompt, chatId, apiKey, onProgress }) {
+  return new Promise((resolve, reject) => {
+    const url = new URL('/api/chat/stream', BASE_URL);
+    
+    const requestData = {
+      messages: [
+        {
+          role: 'user',
+          content: prompt,
+          id: messageId,
+          type: 'text'
+        }
+      ],
+      chat_id: chatId,
+      conversation_id: conversationId,
+      need_confirm: false,
+      need_analysis: false,
+      need_underlying: false,
+      need_recommend: false
+    };
+    
+    const body = JSON.stringify(requestData);
+    
+    const options = {
+      hostname: url.hostname,
+      port: 443,
+      path: url.pathname + url.search,
+      method: 'POST',
+      headers: {
+        'Content-Type': 'application/json',
+        'Content-Length': Buffer.byteLength(body),
+        'Authorization': `Bearer ${apiKey}`
+      },
+      timeout: 3600000 // 1小时超时
+    };
+    
+    const req = https.request(options, (res) => {
+      // 解析 SSE 流
+      parseSSEStream(res, { conversationId, onProgress }, resolve, reject);
+    });
+    
+    req.on('error', (error) => {
+      reject(error);
+    });
+    
+    req.on('timeout', () => {
+      req.destroy();
+      reject(new Error('Request timeout'));
+    });
+    
+    req.write(body);
+    req.end();
+  });
+}
+
+/**
+ * 解析 SSE 流
+ * @param {Object} res - HTTP 响应
+ * @param {Object} params - 参数
+ * @param {Function} resolve - Promise resolve
+ * @param {Function} reject - Promise reject
+ */
+function parseSSEStream(res, params, resolve, reject) {
+  const { conversationId, onProgress } = params;
+  
+  let buffer = '';
+  let currentEvent = {
+    type: 'message',
+    data: null,
+    id: null
+  };
+  
+  const result = {
+    conversationId,
+    tasks: [],
+    report: ''
+  };
+  
+  const state = {
+    isReporter: false,
+    currentAgent: null
+  };
+  
+  const reportContent = [];
+  
+  res.on('data', (chunk) => {
+    buffer += chunk.toString('utf-8');
+    const lines = buffer.split('\n');
+    buffer = lines.pop() || '';
+    
+    for (const line of lines) {
+      processSSELine(line, currentEvent, result, reportContent, state, onProgress);
+      
+      if (line === '') {
+        currentEvent = { type: 'message', data: null, id: null };
+      }
+    }
+  });
+  
+  res.on('end', () => {
+    // 处理剩余数据
+    if (buffer) {
+      const lines = buffer.split('\n');
+      for (const line of lines) {
+        processSSELine(line, currentEvent, result, reportContent, state, onProgress);
+      }
+    }
+    
+    // 确保报告内容设置
+    if (!result.report && reportContent.length > 0) {
+      result.report = reportContent.join('');
+    }
+    
+    logger.info(`Research stream completed: ${conversationId}`);
+    resolve(result);
+  });
+  
+  res.on('error', reject);
+}
+
+/**
+ * 处理单条 SSE 行
+ * @param {string} line - SSE 行
+ * @param {Object} currentEvent - 当前事件
+ * @param {Object} result - 结果对象
+ * @param {Array} reportContent - 报告内容数组
+ * @param {Object} state - 状态
+ * @param {Function} onProgress - 进度回调
+ */
+function processSSELine(line, currentEvent, result, reportContent, state, onProgress) {
+  if (line.startsWith('id: ')) {
+    currentEvent.id = line.slice(4);
+  } else if (line.startsWith('event: ')) {
+    currentEvent.type = line.slice(7);
+  } else if (line.startsWith('data: ')) {
+    try {
+      currentEvent.data = JSON.parse(line.slice(6));
+    } catch (e) {
+      logger.warn(`Failed to parse SSE data: ${e}`);
+    }
+  } else if (line === '' && currentEvent.data !== null) {
+    handleSSEEvent(currentEvent, result, reportContent, state, onProgress);
+  }
+}
+
+/**
+ * 处理完整的 SSE 事件
+ * @param {Object} event - SSE 事件
+ * @param {Object} result - 结果对象
+ * @param {Array} reportContent - 报告内容数组
+ * @param {Object} state - 状态
+ * @param {Function} onProgress - 进度回调
+ */
+function handleSSEEvent(event, result, reportContent, state, onProgress) {
+  const eventType = event.type;
+  const eventData = event.data;
+  
+  if (!eventData) return;
+  
+  const agentName = eventData.agent_name;
+  
+  if (eventType === 'start_of_agent') {
+    state.currentAgent = agentName;
+    
+    if (agentName === 'coordinator') {
+      logger.info('Research started by coordinator');
+      if (onProgress) {
+        onProgress({ stage: 'coordinator', message: '🔍 正在分配研究任务...' });
+      }
+    } else if (agentName === 'supervisor') {
+      const taskRequirement = eventData.task_requirement;
+      if (taskRequirement) {
+        result.tasks.push(taskRequirement);
+        logger.info(`Task assigned: ${taskRequirement}`);
+        if (onProgress) {
+          onProgress({ stage: 'task', message: `📋 ${taskRequirement}` });
+        }
+      }
+    } else if (agentName === 'reporter') {
+      state.isReporter = true;
+      logger.info('Reporter agent started');
+      if (onProgress) {
+        onProgress({ stage: 'report', message: '📝 正在生成报告...' });
+      }
+    }
+  } else if (eventType === 'end_of_agent') {
+    if (agentName === 'reporter') {
+      state.isReporter = false;
+      result.report = reportContent.join('');
+      logger.info('Reporter agent completed');
+      if (onProgress) {
+        onProgress({ stage: 'complete', message: '✅ 报告生成完成' });
+      }
+    }
+    state.currentAgent = null;
+  } else if (eventType === 'message' && state.isReporter) {
+    const delta = eventData.delta;
+    if (delta && delta.content) {
+      const content = delta.content;
+      // 移除引用标记如 【4-4】
+      const cleanedContent = content.replace(/【\d+-\d+】/g, '');
+      reportContent.push(cleanedContent);
+    }
+  } else if (eventType === 'final_session_state') {
+    logger.info('Research session completed');
+    if (onProgress) {
+      onProgress({ stage: 'final', message: '✨ 研究完成' });
+    }
+  }
+}
+
+/**
+ * 获取报告内容（备用方法）
+ * @param {string} conversationId - 对话 ID
+ * @param {string} apiKey - API Key
+ * @returns {Promise<Object>}
+ */
+export async function getReportContent(conversationId, apiKey) {
+  return new Promise((resolve, reject) => {
+    const url = new URL(`/api/v1/conversations/${conversationId}`, BASE_URL);
+    
+    const options = {
+      hostname: url.hostname,
+      port: 443,
+      path: url.pathname + url.search,
+      method: 'GET',
+      headers: {
+        'Authorization': `Bearer ${apiKey}`,
+        'Content-Type': 'application/json'
+      }
+    };
+    
+    const req = https.request(options, (res) => {
+      let responseData = '';
+      
+      res.on('data', (chunk) => {
+        responseData += chunk;
+      });
+      
+      res.on('end', () => {
+        try {
+          const result = JSON.parse(responseData);
+          resolve(result);
+        } catch (error) {
+          reject(new Error(`Failed to parse response: ${error.message}`));
+        }
+      });
+    });
+    
+    req.on('error', (error) => {
+      reject(error);
+    });
+    
+    req.end();
+  });
+}
+
+/**
+ * 提取报告核心结论
+ * @param {Object} report - 报告数据
+ * @returns {Object}
+ */
+export function extractReportInsights(report) {
+  const messages = report.messages || [];
+  const assistantMessages = messages.filter(m => m.role === 'assistant');
+  
+  if (assistantMessages.length === 0) {
+    return {
+      summary: '暂无报告内容',
+      keyPoints: [],
+      recommendations: []
+    };
+  }
+  
+  const lastMessage = assistantMessages[assistantMessages.length - 1];
+  const content = lastMessage.content || '';
+  
+  // 提取摘要（前500字符）
+  const summary = content.slice(0, 500) + (content.length > 500 ? '...' : '');
+  
+  // 提取关键点
+  const keyPoints = content
+    .split('\n')
+    .filter(line => line.match(/^[-•*]\s+/))
+    .map(line => line.replace(/^[-•*]\s+/, ''))
+    .slice(0, 5);
+  
+  // 提取监控建议关键词
+  const recommendationKeywords = [
+    '建议关注', '值得监控', '需要跟踪', '风险提示', '机会',
+    'recommend', 'monitor', 'track', 'risk', 'opportunity'
+  ];
+  
+  const recommendations = [];
+  const lines = content.split('\n');
+  
+  for (const line of lines) {
+    for (const keyword of recommendationKeywords) {
+      if (line.toLowerCase().includes(keyword.toLowerCase())) {
+        recommendations.push(line.trim());
+        break;
+      }
+    }
+  }
+  
+  return {
+    summary,
+    keyPoints,
+    recommendations: recommendations.slice(0, 5),
+    fullContent: content
+  };
+}
+
+/**
+ * 生成监控建议
+ * @param {Object} insights - 报告洞察
+ * @param {string} topic - 研究主题
+ * @returns {Array}
+ */
+/**
+ * 从文本中提取股票代码/名称
+ * @param {string} text - 文本内容
+ * @returns {Array} - 标的列表
+ */
+function extractAssets(text) {
+  const assets = new Set();
+  
+  // A股代码匹配 (如 600519, 300750)
+  const aStockMatch = text.match(/[36]\d{5}/g);
+  if (aStockMatch) {
+    aStockMatch.forEach(code => {
+      if (!['300000', '600000', '000000'].includes(code)) {
+        assets.add(code);
+      }
+    });
+  }
+  
+  // 股票名称匹配 (如 宁德时代, 茅台, 比亚迪)
+  const names = text.match(/[\u4e00-\u9fa5]{2,6}(时代|股份|集团|科技|实业|控股|能源|电力|汽车|电池|银行|保险|证券)/g);
+  if (names) {
+    names.forEach(name => assets.add(name));
+  }
+  
+  return Array.from(assets).slice(0, 5);
+}
+
+/**
+ * 判断监控分类
+ * @param {string} text - 文本内容
+ * @returns {string} - 分类
+ */
+function detectCategory(text) {
+  const lower = text.toLowerCase();
+  
+  if (/财报|业绩|利润|营收|PE|PB|ROE|分红|增发|回购/.test(lower)) return 'Data';
+  if (/公告|发布会|签约|合作|诉讼|处罚|减持|增持/.test(lower)) return 'Event';
+  if (/政策|监管|新规|试点|补贴|关税|制裁/.test(lower)) return 'Policy';
+  if (/情绪|舆论|机构|评级|目标价|外资/.test(lower)) return 'Sentiment';
+  
+  return 'Data';
+}
+
+/**
+ * 判断显著性
+ * @param {string} text - 文本内容
+ * @returns {string} - 显著性
+ */
+function detectSignificance(text) {
+  const lower = text.toLowerCase();
+  
+  if (/风险|利空|减持|诉讼|处罚|警告|亏损|违约/.test(lower)) return 'Risk';
+  if (/利好|突破|增长|获批|合作|增持|订单|回购/.test(lower)) return 'Opportunity';
+  
+  return 'Structural';
+}
+
+export function generateMonitorSuggestions(insights, topic) {
+  const suggestions = [];
+  const fullContent = insights?.fullContent || insights?.summary || '';
+  
+  // 提取标的
+  const assets = extractAssets(fullContent + topic);
+  
+  // 基于关键点生成监控
+  for (const point of (insights.keyPoints || [])) {
+    if (point.length > 10) {
+      const category = detectCategory(point);
+      const significance = detectSignificance(point);
+      
+      suggestions.push({
+        title: `${topic} - ${category === 'Data' ? '数据更新' : category === 'Event' ? '事件驱动' : category === 'Policy' ? '政策变化' : '市场情绪'}`,
+        related_asset_symbol: assets[0] || null,
+        asset_name: assets[0] || topic,
+        category,
+        significance,
+        description: point.slice(0, 100),
+        trigger_keywords: point.split(/\s+/).slice(0, 5),
+        frequency_cron: category === 'Data' ? '0 9 * * 1-5' : '0 9,15 * * *',
+        start_date: calcSmartStartDate(category, point).date,
+        semantic_trigger: point
+      });
+    }
+  }
+  
+  // 基于推荐生成监控
+  for (const rec of (insights.recommendations || [])) {
+    if (rec.length > 10) {
+      const category = detectCategory(rec);
+      const significance = detectSignificance(rec);
+      
+      suggestions.push({
+        title: `${topic} - 推荐关注`,
+        related_asset_symbol: assets[0] || null,
+        asset_name: assets[0] || topic,
+        category,
+        significance,
+        description: rec.slice(0, 100),
+        trigger_keywords: ['建议', '推荐', '关注'],
+        frequency_cron: '0 9 * * 1-5',
+        start_date: calcSmartStartDate(category, point).date,
+        semantic_trigger: rec
+      });
+    }
+  }
+  
+  // 如果太少，添加通用监控
+  if (suggestions.length < 2) {
+    suggestions.push({
+      title: `${topic} - 最新动态`,
+      related_asset_symbol: assets[0] || null,
+      asset_name: assets[0] || topic,
+      category: 'Data',
+      significance: 'Structural',
+      description: `跟踪${topic}的最新发展和市场反应`,
+      trigger_keywords: [topic, '最新', '动态'],
+      frequency_cron: '0 9 * * 1-5',
+      start_date: calcSmartStartDate("Data", topic).date,
+      semantic_trigger: `${topic}相关的重大新闻和公告`
+    });
+  }
+  
+  return suggestions.slice(0, 5);
+}
+
+/**
+ * 使用专业模板生成监控建议（信号架构师版本）
+ * @param {Object} options - 选项
+ * @param {string} options.reportContent - 报告内容
+ * @param {string} options.topic - 研究主题
+ * @param {string} options.userProfile - 用户画像
+ * @param {Array} options.assetWhitelist - 标的清单
+ * @param {string} options.apiKey - API Key
+ * @returns {Promise<Array>}
+ */
+export async function generateProfessionalMonitorSuggestions({ reportContent, topic, userProfile = '投资者', assetWhitelist = [], apiKey }) {
+  const template = `你是一位世界级的**战略情报与信号架构师**。
+你的核心任务是将一份非结构化的"深度研究报告"，提取出**高价值，可量化、第一性信源**的可监控信号。
+
+请根据以下信息生成监控建议：
+
+**User Profile**: ${userProfile}
+**Asset Whitelist**: ${assetWhitelist.join(', ') || '无特定标的'}
+**Report Content**: ${reportContent.slice(0, 5000)}
+
+请严格按以下JSON格式输出：
+{
+  "monitoring_suggestions": [
+    {
+      "title": "简明扼要的监控标题",
+      "related_asset_symbol": "从Whitelist中选择，如无则填null",
+      "asset_name": "标的名称",
+      "category": "Data | Event | Policy | Sentiment",
+      "significance": "Opportunity | Risk | Structural",
+      "target_source": "具体的信源",
+      "frequency_cron": "Cron表达式",
+      "start_date": "YYYY-MM-DD",
+      "start_date_reason": "解释为什么从这个日期开始",
+      "semantic_trigger": "详细描述触发条件逻辑",
+      "reason_for_user": "一句话告诉用户为什么需要关注"
+    }
+  ]
+}
+
+请只输出JSON，不要有其他文字。`;
+
+  try {
+    // 调用 CueCue API 生成专业建议
+    const result = await makeRequest('/api/v1/chat/completions', {
+      messages: [{ role: 'user', content: template, id: 'monitor_' + Date.now() }],
+      temperature: 0.3
+    }, apiKey);
+    
+    // 解析 JSON 响应
+    const content = result.choices?.[0]?.message?.content || '';
+    const jsonMatch = content.match(/\{[\s\S]*\}/);
+    
+    if (jsonMatch) {
+      const parsed = JSON.parse(jsonMatch[0]);
+      return parsed.monitoring_suggestions || [];
+    }
+    
+    return [];
+  } catch (error) {
+    logger.error('Failed to generate professional monitor suggestions', error);
+    return [];
+  }
+}
+
+/**
+ * 统一的监控建议生成入口
+ * 根据配置选择使用本地实现或 API 调用
+ * 
+ * @param {Object} options - 选项
+ * @param {Object} options.insights - 报告洞察（用于本地模式）
+ * @param {string} options.topic - 研究主题
+ * @param {string} options.reportContent - 报告内容（用于 API 模式）
+ * @param {string} options.userProfile - 用户画像
+ * @param {Array} options.assetWhitelist - 标的清单
+ * @param {string} options.apiKey - API Key
+ * @param {boolean} options.useProfessionalApi - 是否使用专业 API（预留）
+ * @returns {Promise<Array>}
+ */
+export async function createMonitorSuggestions(options) {
+  const { insights, topic, reportContent, userProfile, assetWhitelist, apiKey, useProfessionalApi = false } = options;
+  
+  // 预留：未来可以通过配置启用专业 API
+  if (useProfessionalApi && apiKey) {
+    logger.info('Using professional API for monitor suggestions');
+    return generateProfessionalMonitorSuggestions({
+      reportContent: reportContent || insights?.fullContent || '',
+      topic,
+      userProfile: userProfile || '投资者',
+      assetWhitelist: assetWhitelist || [],
+      apiKey
+    });
+  }
+  
+  // 当前：使用本地简单实现
+  logger.info('Using local simple implementation for monitor suggestions');
+  return generateMonitorSuggestions(insights, topic);
+}
+
+/**
+ * 根据监控类型智能计算开始日期
+ */
+function calcSmartStartDate(category, title) {
+  const titleLower = title.toLowerCase();
+  let days = 7;
+  let reason = '7天静默期后开始';
+  
+  if (/财报|业绩|年报|季报|半年报/.test(titleLower)) {
+    days = 30; reason = '等待财报季';
+  } else if (/政策|监管|新规/.test(titleLower)) {
+    days = 0; reason = '政策立即跟踪';
+  } else if (/公告|发布会|签约/.test(titleLower)) {
+    days = 3; reason = '等公告发布';
+  } else if (category === 'Data') {
+    days = 1; reason = '下一交易日';
+  }
+  
+  const date = new Date(Date.now() + days * 24 * 60 * 60 * 1000);
+  return { date: date.toISOString().slice(0, 10), reason };
+}
+
+/**
+ * 构建带用户画像的提示词
+ * @param {string} topic - 研究主题
+ * @param {string} mode - 研究模式
+ * @param {Object} userProfile - 用户画像
+ * @returns {string}
+ */
+export function buildPromptWithProfile(topic, mode, userProfile) {
+  let prompt = buildPrompt(topic, mode);
+  
+  if (!userProfile) return prompt;
+  
+  // 构建用户画像部分
+  const parts = [];
+  if (userProfile.investmentStyle) parts.push(`投资风格：${userProfile.investmentStyle}`);
+  if (userProfile.riskPreference) parts.push(`风险偏好：${userProfile.riskPreference}`);
+  if (userProfile.focusAreas?.length) parts.push(`关注领域：${userProfile.focusAreas.join('、')}`);
+  if (userProfile.holdings?.length) parts.push(`持仓标的：${userProfile.holdings.join('、')}`);
+  
+  if (parts.length === 0) return prompt;
+  
+  // 插入用户画像
+  const profileSection = `\n\n**【用户画像】**\n${parts.join('\n')}\n`;
+  
+  return prompt.replace('**【调研目标】**', '**【调研目标】**' + profileSection);
+}
+
+/**
+ * 构建带分层的提示词（意图优先策略）
+ * @param {string} topic - 研究主题
+ * @param {Object} options - 选项
+ * @returns {string}
+ */
+export function buildPromptLayered(topic, options = {}) {
+  const { 
+    explicitMode = null,      // 显式指定的模式
+    userProfile = null,      // 用户画像
+    autoDetectedMode = null  // 自动检测的模式
+  } = options;
+  
+  // 1. 显式模式优先
+  let mode = explicitMode || autoDetectedMode || 'researcher';
+  
+  // 2. 构建提示词
+  let prompt = buildPrompt(topic, mode);
+  
+  // 3. 画像作为背景参考（不覆盖显式意图）
+  if (userProfile) {
+    const parts = [];
+    if (userProfile.investmentStyle) parts.push(`投资风格：${userProfile.investmentStyle}`);
+    if (userProfile.riskPreference) parts.push(`风险偏好：${userProfile.riskPreference}`);
+    if (userProfile.focusAreas?.length) parts.push(`关注领域：${userProfile.focusAreas.join('、')}`);
+    if (userProfile.holdings?.length) parts.push(`持仓标的：${userProfile.holdings.join('、')}`);
+    
+    if (parts.length > 0) {
+      const profileSection = `\n\n**【用户背景参考】**\n${parts.join('\n')}\n（此信息仅作参考，系统会根据您的具体问题调整分析重点）`;
+      prompt = prompt.replace('**【调研目标】**', '**【调研目标】**' + profileSection);
+    }
+  }
+  
+  return prompt;
+}
+
+/**
+ * 记录用户模式偏好（用于自动学习）
+ * @param {string} chatId - 用户ID
+ * @param {string} mode - 使用的模式
+ */
+export function recordUserPreference(chatId, mode) {
+  try {
+    const profileDir = path.join(process.env.HOME || '/root', '.cuecue', chatId);
+    const prefFile = path.join(profileDir, 'preferences.json');
+    
+    let prefs = { modeHistory: [], lastUpdated: null };
+    if (fs.existsSync(prefFile)) {
+      prefs = JSON.parse(fs.readFileSync(prefFile, 'utf-8'));
+    }
+    
+    // 添加历史记录
+    prefs.modeHistory.push({ mode, timestamp: Date.now() });
+    
+    // 只保留最近10条
+    if (prefs.modeHistory.length > 10) {
+      prefs.modeHistory = prefs.modeHistory.slice(-10);
+    }
+    
+    // 检查是否需要更新画像
+    const recentModes = prefs.modeHistory.slice(-3).map(p => p.mode);
+    const allSame = recentModes.every(m => m === recentModes[0]);
+    
+    if (allSame && recentModes.length >= 3) {
+      prefs.suggestedMode = recentModes[0];
+      prefs.lastUpdated = Date.now();
+    }
+    
+    fs.ensureDirSync(profileDir);
+    fs.writeFileSync(prefFile, JSON.stringify(prefs, null, 2));
+    
+  } catch (e) {
+    logger.warn('Failed to record preference:', e.message);
+  }
+}