Opptrix — 你的A股投研助手

Opptrix 是一款开源的 你的A股投研助手：用自然语言提问，由大模型调用 40+ MCP 投研工具 获取行情、因子、机构观点与策略信号，再生成结构化中文分析。支持 浏览器 Web 与 Electron 桌面端，共用同一套 React 界面与 Fastify API。

💬 技术交流群

使用问题、功能建议、贡献讨论，欢迎扫码加入 Opptrix 技术交流群（微信）：

_{群聊：Opptrix 技术交流群 · 扫码加入后可在群内交流使用与开发问题}

🤖 协作者 / Vibe Coding：请先阅读 docs/AGENT-GUIDE.md — 单文件说明项目用途、目录地图、架构约束与设计规范，供 Cursor / Codex 等 Agent 直接加载。

_{主界面：多会话聊天、Agent 工具链路与右侧关注/个股 K 线面板（桌面与 Web 共用同一套 UI）}

_{特别声明：上图仅为产品功能演示截图，不构成任何投资建议或个股推荐；界面中所示行情、分析与标的均为演示数据，非真实市场数据，请勿作为实际投资决策依据。}

项目定位与学习用途

功能概览

架构一览

┌─────────────────────────────────────────────────────────────┐
│  client-ui (React + Fluent UI + Vite)                       │
│  Chat · 右侧面板 · 设置 · Electron 桌面 chrome               │
└──────────────────────────┬──────────────────────────────────┘
                           │ /api/*  (dev: Vite proxy → :8711)
┌──────────────────────────▼──────────────────────────────────┐
│  apps/server (Fastify)                                      │
│  REST · Chat SSE · 配置 · 静态 SPA                           │
└──────────────────────────┬──────────────────────────────────┘
                           │
        ┌──────────────────┼──────────────────┐
        ▼                  ▼                  ▼
  packages/agent    research-hub      market-data
  LLM + MCP tools   dispatch()        SQLite 本地库
        │                  │                  │
        └──────────────────┼──────────────────┘
                           ▼
              a-stock-layer (AshareEngine)
              14 drivers · TDX · 东财/efinance …
                           │
              stock-eval · institutions · t-strategy · skills

Opptrix/
├── apps/server/          # Fastify API（:8711）
├── apps/desktop/         # Electron 桌面壳 + 打包
├── client-ui/            # React Chat UI（:5173）
└── packages/
    ├── shared/
    ├── a-stock-layer/    # 在线数据源与账本
    ├── market-data/      # 本地 SQLite 因子库
    ├── stock-eval/       # 因子 · 评分卡 · 回测
    ├── institutions/     # 机构综合评级
    ├── t-strategy/       # 策略信号与验证
    ├── skills/           # 市场报告 · 产业透视
    ├── research-hub/     # 统一 feature 调度
    └── agent/            # LLM + MCP 工具注册

详细分层与数据流：docs/ARCHITECTURE.md
桌面端说明：docs/DESKTOP.md

数据源说明

数据经 AshareEngine 按能力在多个 driver 间 自动回退（东财、efinance、TDX、腾讯、新浪、同花顺、Tushare 等，见 packages/a-stock-layer/src/drivers/）。

请勿将本软件数据用于生产交易决策的唯一依据；接入 Tushare 等需自行配置 Token 并遵守其许可。

快速开始

环境要求

• Node.js ≥ 20
• npm（workspaces）
• 可选：macOS/Windows/Linux（桌面打包见 DESKTOP.md）

安装与编译

git clone https://github.com/Travisun/Opptrix.git
cd Opptrix
npm install              # 仅在仓库根目录执行
cp example/startup/env.example .env   # 或 cp .env.example .env；填入 LLM_API_KEY
npm run build            # 编译 packages + client-ui

更多示例配置（数据源、新闻订阅、关注列表）见 example/。

开发模式（Web）

npm run dev              # 同时启动 API + Vite
# → 浏览器打开 http://127.0.0.1:5173
# API 在 :8711，由 Vite 代理 /api，无需直接访问

开发模式（桌面）

npm run dev:desktop      # Electron + API + Vite HMR

生产预览

npm run build
npm run serve            # API + Vite preview → http://127.0.0.1:5173

数据目录：apps/server/data（配置）、~/.opptrix（账本与本地市场数据）。

测试

npm run test             # build:packages + smoke/integration tests
npm run test:ci          # run tests only (after build; same as CI)

配置

环境变量通常 覆盖 本地 json 中的同名字段。

API 入口

完整列表：docs/API.md

文档索引

参与贡献

1. Fork 仓库，从 main 创建分支（feat/、fix/、docs/ …）
2. 让 AI 助手先读 AGENT-GUIDE.md
3. npm run build && npm run test
4. 提交 PR，说明动机与测试方式

细则：docs/CONTRIBUTING.md

风险声明与免责声明

本软件及文档仅供 学习、研究与信息整理，不构成任何形式的投资建议或要约。

• 行情与数据可能延迟、缺失或错误；多源回退不保证准确性与实时性。
• 大模型输出可能存在幻觉；请始终以工具返回的结构化数据为准。
• 策略与因子回测基于历史数据，过往表现不代表未来收益。
• 合规：使用者须自行遵守所在司法辖区的证券法规；开发者不对因使用本软件产生的任何损失负责。
• 第三方服务：东财、Tushare、LLM 提供商等均有独立服务条款与费用政策。

使用本软件即表示你已理解并接受上述限制。

技术栈

Node.js · TypeScript · Fastify · React · Fluent UI v9 · Vite · Electron · SQLite (better-sqlite3) · OpenAI 兼容 LLM API

许可证

本仓库采用 Apache License 2.0 发布（Copyright © 2025 Opptrix contributors）。
在遵守许可证条款的前提下，可自由使用、修改与分发本软件（含商业用途）；再分发时请保留版权声明与许可证全文。

相关链接

• GitHub：Travisun/Opptrix
• Issues：报告问题或提议功能