Travisun/Opptrix: lightweight self-hosted alternative for tinkerers

_{主界面：多会话聊天、Agent 工具与工作流技能、右侧关注/个股面板；桌面与 Web 共用同一套 UI}

💬 技术交流与作者动态

使用问题、功能建议、贡献讨论，欢迎扫码加入 微信技术交流群；也可扫码在 抖音 关注项目作者，获取产品与开发动态：

微信 · Opptrix 技术交流群

抖音 · 关���项目作者动态

微信扫码·成为Opptrix 赞助者

❤️ 欢迎赞助我们

Opptrix 坚持免费、开源。赞助不是购买，而是对理念的认可——你的支持会帮助我们把 Opptrix 发展得更加强大。

前往赞助页 → https://opptrix.org/sponsor

个人赞助者

感谢每一位支持者（与 官网赞助墙 同步）：

WorldWithinDreams

Raven

Remielle

N

叶小莹

月落参横

_{企业赞助席位虚位以待 — 详情见 赞助页}

⚠️ 重要风险提示与用户须知

请在使用前仔细阅读。使用本软件即表示你已理解并同意以下条款。

界面截图、示例对话与演示数据 不代表 真实荐股或实盘推荐，请勿作为实际投资依据。

Opptrix 是一款开源的 全球多市场投研工作台：覆盖 A 股、美股、港股、日股、韩股与加密货币 等市场。用自然语言提问，由大模型按意图挂载 150+ 投研工具，并可激活 170+ 内置工作流技能（量化因子 / 择时 / 价值投资流程等），把结构化数据整理成中文报告或可预览投研页。支持 浏览器 Web 与 Electron 桌面端，共用同一套 React 界面与 Fastify API；设置中可选开启 自进化，让同一模型在投研主路径上更稳、更完整。

🤖 协作者 / Vibe Coding：请先阅读 docs/AGENT-GUIDE.md — 单文件说明项目用途、目录地图、架构约束与设计规范。工作流技能详见 docs/AGENT-SKILLS.md。

项目定位

工作流技能（Agent Skills）

界面称 工作流技能：可发现、可激活的投研步骤说明 + 附件（参考资料 / 可运行脚本）。与「专家人设」「工具包」正交——对话里可以同时有角色偏好、按意图挂载的工具，以及最多若干已激活技能。

内置技能家族（约 170+）

开发者映射与契约：docs/AGENT-SKILLS.md、docs/quants-playbook-skill-map.md、docs/ai-berkshire-skill-map.md。

功能概览

使用方式（最终用户）

方式一���桌面安装包（推荐）

从 GitHub Releases 下载对应平台安装包（标签 desktop-v*）：

安装后首次启动：

1. 打开 设置 → 模型与 API，配置 LLM 提供商与 API Key（对话功能需要）。
2. （可选）设置 → 数据源，配置 Tushare 等行情数据源。
3. （可选）设置 → 新闻订阅 导入 RSS 源。
4. （可选）设置 → 自进化：按需开启，让常用模型逐步更贴合你的投研用法。
5. 在 聊天 中用自然语言提问，或激活工作流技能；在侧栏切换 新闻、行情动态 等视图。

桌面端启动约 10 秒后会 后台检查更新；有新版本时会提示下载，需你点击 重启更新 才会安装（不会静默强制升级）。详见 docs/DESKTOP-RELEASE.md。

未签名/dev 包在 macOS 上若提示「已损坏」，可在终端执行 xattr -cr /Applications/Opptrix.app 或 右键 → 打开 一次。

方式二：浏览器（自托管 Web）

适合在本机或���务器部署后通过浏览器访问：

git clone https://github.com/Travisun/Opptrix.git
cd Opptrix
npm install
cp example/startup/env.example .env   # 填入 LLM_API_KEY
npm run build
npm run serve    # → http://127.0.0.1:5173

在 设置 中同样配置 LLM 与数据源。生产环境请自行做好 HTTPS、访问控制与密钥管理。

方式三：开发模式

见下方 快速开始（开发者） 与 docs/DEVELOPMENT.md。

架构一览

跨市场行情与档案统一经 标的 + 能力 标准查询，多数据源按市场自动回退；Agent 侧为 工具包路由 + 工作流技能 + 工作区脚本，Hub 负责投研 feature 调度。

┌──────────────────────────────────────────────────────────────────┐
│  client-ui (React + Fluent UI + Vite)                             │
│  聊天 · 技能 · 新闻 · 行情动态 · 右侧面板 · 设置 · Electron chrome │
└────────────────────────────┬─────────────────────────────────────┘
                             │ /api/*  (dev: Vite proxy → :8711)
┌────────────────────────────▼─────────────────────────────────────┐
│  apps/server (Fastify)                                            │
│  REST · Chat SSE · 配置 · 会话 · 静态 SPA                          │
└────────────────────────────┬─────────────────────────────────────┘
                             │
     ┌───────────────────────┼───────────────────────┐
     ▼                       ▼                       ▼
 packages/agent      research-hub / search-hub   user-store
 LLM + 150+ 工具      dispatch / instrument_*     SQLite 用户数据
 Tool Pack 路由              │                       │
 agent-skills 激活           │                       │
 agent-workspace             │                       │
     └───────────────────────┼───────────────────────┘
                             ▼
              a-stock-layer (MarketDataEngine)
              queryInstrumentData · Provider Registry · 多市场
                             │
        ┌────────────────────┼────────────────────┐
        ▼                    ▼                    ▼
  market-data/          stock-eval · institutions   news-feed
  多市场数据包同步        t-strategy                  article-enrichment

Opptrix/
├── apps/
│   ├── server/                 # Fastify API（:8711）
│   └── desktop/                # Electron 壳 + sidecar + 打包
├── client-ui/                  # React SPA（:5173）
└── packages/
    ├── shared/                 # InstrumentRef、市场注册表、类型
    ├── a-stock-layer/          # 在线数据 Engine、Provider、TDX
    ├── market-data-core/       # 数据层核心抽象
    ├── market-data/            # 多市场本地数据包（.opmd）与同步
    ├── market-data-providers-{cn,us,crypto}/
    ├── provider-sdk/           # Provider 开发 SDK
    ├── stock-eval/             # 因子 · 评分卡 · 回测
    ├── institutions/           # 机构综合评级
    ├── t-strategy/             # 策略信号与验证
    ├── agent-skills/           # 工作流技能（builtin 170+）
    ├── research-hub/           # Hub feature 调度
    ├── search-hub/             # 标的搜索
    ├── news-feed/              # RSS 新闻
    ├── article-enrichment/     # 文章抓取与增强
    ├── canvas-kit/ · doc-library/
    ├── local-inference/        # 本地翻译/推理（桌面）
    ├── schedule/               # 计划任务（应用内 + OS tick）
    ├── agent-workspace/        # 文件 / Shell / Python / 密钥保险箱
    ├── agent-browser/          # 网页浏览后端
    ├── user-store/             # 用户配置与会话持久化
    └── agent/                  # LLM · 工具 · Tool Pack · 子 Agent

延伸阅读

数据源说明

数据经 MarketDataEngine 按 InstrumentRef（市场 + 标的类型 + 代码）+ Capability 在多个 Provider 间 按市场优先级回退（A 股：东��、Tushare、TDX 等；美股/港股/日股/韩股：Yahoo 等；加密货币：专用 Provider）。

请勿 将本软件作为生产交易决策的 唯一 依据。

快速开始（开发者）

环境要求

• Node.js ≥ 24（Active LTS）
• npm（workspaces，仅在仓库根目录 npm install）
• 可选：macOS / Windows / Linux（桌面打包见 DESKTOP.md）

安装与编译

git clone https://github.com/Travisun/Opptrix.git
cd Opptrix
npm install
cp example/startup/env.example .env   # 填入 LLM_API_KEY
npm run build            # 编译 packages + client-ui

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

开发模式

# Web：API + Vite 热更新
npm run dev
# → 浏览器 http://127.0.0.1:5173（API 在 :8711，由 Vite 代理 /api）

# 桌面：Electron + API + Vite HMR
npm run dev:desktop

生产预览

npm run build
npm run serve            # API :8711 + Vite preview :5173

测试

npm run test             # build:packages + 冒烟/集成测试
npm run test:ci          # 仅跑测试（CI 在 build 之后）

数据目录

配置

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

技术栈

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

许可证

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

参考项目

Opptrix 的 Agent 工作流、投研协作与量化/价值投资技能设计，受益于下列开源项目（排名不分先后）：

相关链接

• GitHub：Travisun/Opptrix
• Releases：桌面安装包下载
• Issues：报告问题或提议功能