Opptrix — 全球多市场 AI 投研工作台

场景切入：一盏台灯下的投资者

深夜 11 点，你盯着电脑屏幕上的 A 股行情——所持仓的宁德时代突然跳水，消息面上却静悄悄。你打开微信群、财经 App、同花顺，来回切换了七八个页面，试图拼凑出这次下跌的原因。ChatGPT 给了你一堆通用废话，行情软件没有上下文记忆，研报要付费。你感到疲惫，却不知道从哪里入手。

现在，有这样一个人：他打开了一个界面，左侧是对话窗口，右侧是持仓股票和自选列表。在对话框里他输入：「分析宁德时代今日下跌原因，结合近期锂电池行业政策和装机数据。」几秒钟后，对话窗口开始流式输出——整合了东方财富新闻、同花顺公告、SNE Research 装机数据和机构最新研报摘要的一段结构化分析。

这个人用的工具，叫做 Opptrix。

Opptrix 主界面

Opptrix 主界面：多会话聊天、Agent 工具与工作流技能、右侧关注/个股面板

背景：从痛点中生长出来的项目

Opptrix 的诞生，源于开发者 Travisun 本人在进行 A 股投研时的切肤之痛。

A股市场有其独特的复杂性：散户与机构信息不对称、数据来源分散（东方财富、同花顺、上交所、深交所、Wind、各券商研报等），且中文金融语料的专业性远高于通用大模型的训练数据分布。一个真实投资者需要的工具，不是简单地「接入一个大模型」，而是需要把多个专业数据源、量化分析工具和 AI 推理能力整合到一个界面中——并且，所有数据必须留在自己的服务器上。

这一需求在 2024 年催生了 Opptrix。它从最初的个人工具，逐渐演变为一个功能完整的开源项目，定位为「开源 · 自托管 · 多市场 AI 投研工作台」，覆盖 A 股、美股、港股、日股、韩股等全球主要股票市场。截至 2025 年，Opptrix 在 GitHub 获得 230+ stars，npm 包 @opptrix/selfhost 正式发布，采用 Apache 2.0 开源协议。

类比：你的私人投研团队

如果说传统行情软件是「菜市场」——信息嘈杂、缺乏加工，那么 Opptrix 更像是「私厨」：你告诉厨师想做什么菜（提出投研问题），他自动挑选食材（调用行情、新闻、公告等工具），按照你的口味（LLM 推理）烹饪，最后端上一盘可以直接入口的分析报告。

它不是一个聊天机器人，而是一个有工具的 AI 协作者。背后的核心技术，是 MCP（Model Context Protocol）协议驱动的 Agent 系统。

核心功能：拆解 Opptrix 的能力矩阵

1. 对话式 Chat Agent（核心交互层）

用户通过自然语言提问，Agent 自动识别意图并挂载相应的工具包（150+ 投研工具）。所有工具调用结果以流式（streaming）方式返回，用户体验接近与真人研究员对话。

工具覆盖范围包括：

行情数据：实时/历史 K 线、涨跌幅、成交量、资金流向
基本面：财务指标、估值、公告、年报
新闻舆情：财经新闻、研报摘要、社交媒体情绪
量化因子：因子筛选、回测框架、信号验证
全球市场：CN · US · HK · JP · KR 的差异化数据接口

2. 170+ 工作流技能（Agent Skills）

预置 170+ 投研工作流，覆盖：

量化投资策略（多因子、趋势跟随、均值回归等）
价值投资分析框架（护城河、DCF 估值、同行对比）
核心投研报告模板（个股分析、行业研究、宏观策略）
定期追踪与计划任务（自动生成持仓周报、季报）

用户也可以导入自定义技能，形成个人知识工作流。

3. 外部聊天 Channels（多平台集成）

通道	能力
Telegram / Slack / 飞书	流式对话 + 阶段编辑 + 终稿
钉钉 / 企业微信 / QQ	终稿应答

这意味着用户可以在微信群里 @ 机器人，实时获取投研分析。

4. 扩展平台（Phase B）：.opx 扩展生态

Opptrix 设计了一套完整的扩展生命周期：

打包 → 验签 → 安装 → 激活 → 卸载
扩展运行在独立宿主子进程 + VM 沙盒隔离中
能力网关（capability gateway）提供 storage / events / data / schedule / LLM / shell 等原子能力，权限 fail-closed
Registry 协议支持本地扩展商店，客户端全链 Ed25519 验签

5. 主题与界面设计

Opptrix 设计语言（桌面工作台风格）与 iOS 设计语言（苹果系统配色/分组卡片）双外观，浅色/深色/跟随系统三档可选。

技术架构：TypeScript monorepo 的工程实践

Opptrix 采用了大型 TypeScript monorepo 架构，技术栈如下：

层次	技术选型
Monorepo 管理	npm workspaces
前端	React + Vite + Fluent UI
后端	Fastify（高性能 Node.js Web 框架）
桌面交付	Electron（已停止独立打包，转为 Web PWA 模式）
数据库	SQLite（本地轻量存储）+ DuckDB（分析查询）
AI/ML	MCP 协议、LLM API（支持 OpenAI/Anthropic/国内模型）、本地推理（可选）
多媒体	FFmpeg（音视频处理）、Playwright（浏览器自动化）
容器化	多阶段 Dockerfile + docker-compose
CLI	Node.js 自研 `@opptrix/selfhost`

Monorepo 包结构（部分）

packages/agent/、agent-browser/、agent-skills/、agent-workspace/、market-data-core/、a-stock-layer/、stock-eval/、t-strategy/、research-hub/、local-inference/、selfhost/、doc-library/、schedule/、user-store/ 等 30+ 个内部包。

apps/server/ 为 Fastify 服务端，client-ui/ 为 React 前端。

AI/ML 组件分析

MCP 协议：作为 AI Agent 与外部工具（行情、新闻等）之间的通信标准，实现工具的插件化注册与调用
多 LLM 支持：通过 Provider SDK 抽象层，支持接入 OpenAI GPT、Anthropic Claude 及国内主流模型（如硅基流动等）
本地推理（可选）：通过 local-inference 包提供，支持在本地运行轻量模型，保护数据隐私
embedding 模型：使用 multilingual-e5-small（向量检索）和 RapidOCR（OCR 识别）

上手门槛：两种路径

路径一：Docker 一键部署（推荐，最简单）

# 安装 opptrix CLI
npm i -g @opptrix/selfhost

# 初始化 + 启动（自动拉取预构建镜像）
opptrix init
opptrix up

# 打开浏览器
# https://127.0.0.1:8712  （自签名 HTTPS，首次需信任证书）

国内网络环境，CLI 自动切换至 Gitee + 国内 GHCR 镜像站，绕过 Docker Hub / GitHub 超时。最低硬件要求：1GB+ 内存，5GB+ 磁盘。

路径二：从零 Linux 脚本

curl -fsSL https://raw.githubusercontent.com/Travisun/Opptrix/main/scripts/bootstrap/linux.sh | bash

该脚本自动安装 Docker、Node.js 24+ 和 opptrix CLI，适合全新服务器。

注意：Opptrix 依赖 LLM API Key（如 OpenAI / Claude / 硅基流动等），自备。默认关闭 HTTP 端口，仅暴露 HTTPS 8712。

争议与局限：不回避的问题

1. 数据质量依赖第三方 Provider

Opptrix 本身不提供行情数据源，而是通过 Provider 封装东方财富、Tushare、Yahoo Finance 等第三方接口。一旦第三方接口变更、限流或收费调整，工具行为可能受影响。

2. AI 幻觉风险

项目在 README 中明确声明：「大模型可能产生错误、遗漏或『幻觉』；请以工具返回的结构化数据为准，勿单独依据自然语言结论做决策。」对于投资决策，这是一个不可忽视的风险。

3. 资源占用

多阶段 Dockerfile 包含 native 模块编译，镜像体积较大，对网络和磁盘有一定要求。

4. 暂不支持自动交易

Opptrix 明确表示不是证券交易软件，不支持自动下单或实盘交易。定位是「信息整理与投研辅助」。

行业意义：开源如何改变个人投资者的未来

在中国，机构研报动辄数百元一份，普通投资者难以负担。Opptrix 通过整合公开数据源、研报摘要和 AI 推理，让个人投资者拥有了一个「AI 研究员」。Docker 自托管方案让用户完全掌控自己的数据，这是它在隐私敏感型用户中受欢迎的重要原因。Opptrix 深度使用 MCP 协议，随着 MCP 生态的壮大，有望成为个人投资者的「AI 工作台」标准。

总结

Opptrix 是一个面向中文个人投资者的开源 AI 投研工作台，通过 MCP 协议驱动的 Agent 系统，整合全球多市场行情、新闻舆情、量化因子和研报摘要，为用户提供对话式投研分析体验。其 TypeScript monorepo 架构工程实践扎实，Docker 一键部署门槛低，数据自托管保障隐私，适合对投资研究有深度需求、且重视数据安全的个人投资者和独立研究员使用。

核心优势：多市场覆盖（CN/US/HK/JP/KR）+ 170+ 投研技能 + 扩展平台生态。局限：依赖第三方数据源、AI 推理存在幻觉风险、暂不支持自动交易。