Stock Copilot Pro

核心功能

Stock Copilot Pro 是一款面向专业投资者的高性能全球股票分析工具，由 QVeris 数据平台驱动。该工具整合了五大核心数据源：实时行情与交易环境、公司基本面指标、技术面信号（RSI/MACD/移动平均线）、新闻情绪分析以及 X（Twitter）平台社媒情绪，生成结构化的分析师级报告。

主要输出内容包括：价值投资评分卡、事件驱动/回调风险时机分类、安全边际估算、基于情景的投资建议，以及可选的完整证据追踪（--evidence模式）。

显著优点

1. 智能工具路由：通过硬编码的 tool-chains.json 实现确定性工具链调度，支持美股/港股/A股的市场感知型符号处理
2. 自适应参数优化：Evolution v2 参数模板记忆机制，减少重复性参数错误，运行时学习状态持久化存储
3. 多源容错架构：具备强大的供应商和市场降级策略，当首选数据源失效时自动切换备用方案
4. 本土化深度支持：A股/港股支持中文公司名称自动解析（如"特变电工"→600089.SH）， sentiment 分析优先接入本土渠道（研报/新闻/微信公众号）
5. 双模输出格式：默认 Markdown 人读报告 + 可选 JSON 机器解析格式

局限性与风险

• 数据源依赖：核心功能完全依赖 QVeris API，存在单点故障风险；历史数据深度与覆盖范围受限于 QVeris 的数据采购能力
• A股数据质量：情绪分析依赖 caidazi 渠道，信息噪声较高；基本面数据依赖 THS（同花顺），财务报表更新时效可能存在滞后
• 情绪分析偏差：X 平台 sentiment 对中概股覆盖不均，可能存在样本偏差；社媒情绪易受短期事件操纵
• 技术信号滞后性：RSI/MACD 等传统指标属于滞后指标，在极端波动市场可能产生假信号

适合人群

• 需要快速生成多维度股票研究报告的主动型投资者
• 管理跨市场（美/港/A股）投资组合的专业人士
• 量化研究者需要结构化数据输入（JSON输出模式）
• 具备基础金融知识、能独立判断信号质量的中高级投资者

常规风险提示

⚠️ 研究用途声明：所有输出仅为数据分析结果，不构成投资建议。用户须自行承担投资决策责任。

⚠️ API 密钥安全：仅需 QVERIS_API_KEY，脚本不会将密钥写入日志或持久化存储，但用户需确保环境变量配置安全。

⚠️ 数据时效性：报告标注的数据时间点可能因 API 延迟而与实际市场存在差异，关键决策前请交叉验证。

⚠️ 情绪化交易风险：情绪分析指标波动剧烈，不建议作为单一决策依据。

核心用法

Stock Copilot Pro 是一款面向全球市场的端到端股票分析 Skill，由 QVeris 数据引擎驱动。用户可通过自然语言或标准化 CLI 指令发起分析请求，支持三种典型场景：

1. 单股深度分析：输入股票代码（如 AAPL、0700.HK）或中文公司名称（如「特变电工」→ 600089.SH），获取涵盖五大维度的综合报告
2. 多股横向对比：同时比较多只股票的估值、技术面与舆情差异
3. 结构化数据输出：默认 Markdown 可读报告，可选 JSON 机器解析格式

核心指令结构：

node scripts/stock_copilot_pro.mjs analyze|compare --symbol(s) <代码> --market <US|HK|CN> --mode comprehensive [--evidence]

---

显著优点

| 维度 | 能力描述 |

|------|---------|

| **多源数据融合** | 实时行情、财务报表、RSI/MACD/MA 技术指标、新闻舆情、X/Twitter 情绪五维合一 |

| **智能市场适配** | 自动识别中美港市场符号规范，中文公司名自动解析，CN/HK 市场优先接入财联社（caidazi）舆情与 THS 财务数据 |

| **确定性工具路由** | 通过 `tool-chains.json` 硬编码市场级工具链，避免 LLM 随机选错工具 |

| **自适应参数进化** | 运行时学习成功调用参数，存储于 `.evolution/tool-evolution.json`，显著降低重复参数错误 |

| **多层容错机制** | 工具链回退、跨源数据校验、超时控制，保障复杂查询的健壮性 |

| **输出标准化** | 价值投资评分卡、安全边际估算、事件驱动/追高风险时机分类、情景化建议 |

---

潜在缺点与局限性

1. 单一供应商依赖：全部数据源自 QVeris API，无备用数据源。若 QVeris 服务中断或 API Key 失效，Skill 完全不可用
2. 离线不可用：无本地缓存机制，每次查询均实时调用外部 API，响应延迟受网络状况影响
3. A 股市场覆盖有限：虽支持中文名解析与 THS 财务报表，但部分中小市值股票或新三板标的可能数据不完整
4. 舆情时效性：X/Twitter 情绪依赖平台 API 采样，非全量数据，极端行情下可能存在滞后
5. 研究性质声明：输出明确标注「非投资建议」，需用户自行决策，不适合作为自动化交易信号源

---

适合人群

• 个人投资者：需快速获取跨市场股票的多维度分析，替代手动查阅多个金融终端
• 研究员与分析师：需结构化数据输出（JSON）进行批量处理或纳入内部研究流程
• 量化爱好者：希望基于技术面 + 舆情信号构建策略原型，利用 --evidence 追溯原始数据
• 跨境投资者：同时关注美股、港股、A 股，需统一分析框架与标准化报告格式

---

常规风险

| 风险类别 | 说明 | 缓释措施 |

|---------|------|---------|

| **API 服务不可用** | QVeris 服务端故障或配额耗尽导致查询失败 | 代码内置超时与错误处理，建议用户监控调用失败率 |

| **数据质量波动** | 跨源数据不一致或财报更新延迟 | 运行时执行「关键字段缺失 / 数据时效性 / 跨源一致性」三重质检 |

| **本地状态膨胀** | `.evolution/tool-evolution.json` 持续写入可能无限增长 | 已实现 `sanitizeEvolutionState` 脱敏，建议定期手动清理 |

| **密钥泄露** | 环境变量配置不当导致 API Key 暴露 | 仅通过 `QVERIS_API_KEY` 读取，日志与进化状态均脱敏处理 |

| **误读输出** | 用户将「研究输出」误作「交易指令」 | 报告头部与尾部均标注免责声明，复合评分卡强调安全边际而非买卖信号 |