中文正文  |  English summary  |  上游多语言版（EN / 日本語 / 한국어 / العربية）

把 Vibe Trading 装进一个双击即用的桌面应用 —— 免装 Python、免装 Node，macOS / Windows 原生运行

介绍  ·  特性  ·  快速开始  ·  构建  ·  上游关系  ·  文档  ·  安全

Vibe Trading Desktop is a community fork of HKUDS/Vibe-Trading — the natural-language finance-research AI agent with backtesting — repackaged as a double-click desktop app for macOS and Windows via a Tauri 2.x shell with an embedded Python 3.12 runtime. No Python, no Node, no terminal: download the .dmg / .exe, install, and run. The full Vibe Trading stack (70+ finance skills, LangGraph ReAct agent, backtesting engine, multi-agent swarm, shadow account) runs locally, bound to 127.0.0.1 only, with API keys stored on your own machine. This fork adds 160+ desktop-focused commits on top of upstream and tracks upstream closely. The rest of this README is in Chinese — see the upstream repo for the full feature tour in English / 日本語 / 한국어 / العربية.

Vibe Trading Desktop = HKUDS/Vibe-Trading（自然语言金融研究 AI agent + 回测引擎）+ Tauri 2.x 桌面外壳，把原本需要 Python 环境 + 命令行运行的 Web 服务，封装成 macOS / Windows 上双击即用的原生应用。

三层架构：

fork 身份：本仓库 fork 自 HKUDS/Vibe-Trading，在其基础上新增 160+ 个桌面化 commit（Tauri 外壳、DMG / NSIS 打包流水线、sidecar 稳定性、tag-driven release CI，外加影子账户 PDF 导出、A ���数据源等增强），并定期同步上游。

• 🖱 双击即用 —— 内嵌完整 Python 3.12 运行时，用户无需安装 Python / Node / 任何命令��工具链，下载安装即跑
• 🧠 完整的 Vibe Trading 能力 —— 70+ 金融技能、LangGraph ReAct agent、多市场回测（A 股 / 美股 / 港股 / 加密 / 期货 / 外汇）、多 agent swarm、影子账户（paper trading）
• 🔒 数据本地化 —— 后端仅绑定 127.0.0.1，外部网络不可达；API 密钥存储在本地 ~/.vibe-trading/.env，不随应用打包、不上传任何服务器
• 🔄 紧跟上游 —— 定期 sync HKUDS/Vibe-Trading，桌面化改动以最小侵入方式叠加在上游核心之上

根据你的角色，三选一：

1. 前往 Releases 下载对应平台安装包：
   • macOS：Vibe Trading_*.dmg（Apple Silicon 原生）
   • Windows：Vibe Trading_*_x64-setup.exe（NSIS）
2. 安装后启动。macOS 首次打开若提示"已损坏"，在终端执行（仅清除本应用的下载隔离标记，不修改系统设置、不影响其他应用）：

   xattr -cr "/Applications/Vibe Trading.app"

3. 首次启动会在 ~/.vibe-trading/.env 自动创建配置文件，填入你的 LLM / 数据源 API 密钥即可开始。

完整安装步骤、系统要求、已知限制（未签名、体积 ~800MB、PDF 报告降级 HTML 等）见 docs/desktop/README.md。

# 后端（API on :8899）
pip install -e ".[dev]"
vibe-trading serve

# 前端（dev server on :5899，代理 API 到 :8899）
cd frontend
npm install
npm run dev

docker compose up vibe-trading                  # 仅 API，:8899
docker compose --profile frontend up            # API + Vite 前端，:5899

桌面应用把三件制品 —— 嵌入式 Python 3.12 运行时、agent 代码、frontend/dist —— 打包进 Tauri resource bundle。流水线脚本位于 scripts/desktop/：

# macOS 端到端（校验工具链 → 重建前端 → cargo tauri build → 冒烟检查 .app/.dmg）
bash scripts/desktop/build-dmg.sh

# Windows 端到端（fetch-runtime → install-deps → assemble → cargo tauri build）
./scripts/desktop/build-windows.ps1

# 版本同步（pyproject.toml / tauri.conf.json / 前端对齐）
node scripts/desktop/sync-version.mjs <vX.Y.Z>

发布走 tag-driven CI（.github/workflows/desktop-build.yml）；代码签名与公证（需 Apple Developer 账号）见 scripts/desktop/sign-and-notarize.sh。

详细构建流程、内嵌运行时、relocatability 验证见 docs/desktop/ 与 CLAUDE.md。

Vibe-Trading-Desktop/
├── agent/              # Python 后端：FastAPI + LangGraph agent + 70+ 技能 + 回测引擎
│   ├── api_server.py   #   REST API + SSE（:8899）
│   ├── src/            #   agent / skills / swarm / live / providers / shadow_account
│   └── backtest/       #   回测 runner / metrics / engines / loaders
├── frontend/           # React 19 + Vite + TS 单页应用（:5899）
├── src-tauri/          # ★ 本 fork 独有：Tauri 2.x Rust 外壳 + 嵌入式 Python 运行时管理
├── scripts/desktop/    # ★ 桌面打包流水线（fetch-runtime / install-deps / assemble / build-dmg / build-windows）
├── docs/desktop/       # 桌面应用文档
└── .github/workflows/  # tag-driven release CI

• 回环绑定 —— 桌面应用后端仅监听 127.0.0.1，外部网络不可达
• 密钥本地化 —— API 密钥存储在 ~/.vibe-trading/.env，不与应用打包、不上传任何服务器
• 进程隔离 —— 应用退出时终止所有 Python sidecar 子进程，无残留
• 实盘交易高危面 —— 订单闸门、mandate 强制、kill switch、审计账本等安全关键路径，详见 AGENT_CONTRIBUTOR_GUIDE.md

MIT License — Copyright (c) 2026 Vibe-Trading Contributors。本 fork 遵循上游 HKUDS/Vibe-Trading 的 MIT 许可证。

桌面应用内嵌的 python-build-standalone 运行时遵循其各自许可。