FinceptTerminal 是一款基于 C++20 和 Qt6 构建的现代金融研究终端，原生支持 Windows、Linux 和 macOS。它将机构级的金融分析、AI 代理和量化工具集成到一个本机桌面应用中，数据通过嵌入式 Python 3.11 引擎和 100+ 个数据连接器获取。本教程将指导你完成其开源版本 (AGPL-3.0) 的安装。

核心概念与架构

  • 原生性能：采用 C++20 和 Qt6 构建，提供流畅的桌面体验，不依赖 Electron 或浏览器内核。
  • 数据与 AI 融合：内置了 37 个 AI 代理（需自行配置 API 密钥），支持通过自然语言交互进行分析；同时集成了 QuantLib 等 18 个量化分析模块和 100+ 个金融数据连接器（如 FRED、Yahoo Finance、AKShare）。
  • 两种发行版：
    • 开源版 (本仓库)：遵循 AGPL-3.0 强互惠许可证，适合个人学习、学术研究或非商业用途。每月发布一个稳定版本。
    • 企业版 (Enterprise)：闭源、付费版本，提供私有数据、实时交易、多代理研究、SSO 审计等功能，适合机构和商业团队。

安装方式

根据你的操作系统，选择对应的预编译包或从源码构建。

预编译包安装 (推荐)

  1. 访问 Releases 页面：前往项目的 Releases 页面 下载最新版本 (如 v4.5.0)。
  2. 选择对应的安装包：
    • Windows x64：下载 .exe 安装程序，双击运行并按提示安装。
    • Linux x64：
      • AppImage：下载 .run 文件，执行 chmod +x FinceptTerminal-Linux-x64.run 赋予执行权限，然后运行它。
      • Debian/Ubuntu：下载 .deb 包，使用 sudo apt install ./FinceptTerminal-*.deb 安装。
      • Fedora/RHEL：下载 .rpm 包，使用 sudo dnf install ./FinceptTerminal-*.rpm 安装。
    • macOS Apple Silicon：下载 .dmg 文件，打开后将 FinceptTerminal.app 拖拽到 Applications 文件夹。

从源码构建 (Linux/macOS)

如果你想尝试最新代码或进行二次开发，可以自行编译。

  1. 克隆仓库与准备：

    1
    2
    git clone https://github.com/Fincept-Corporation/FinceptTerminal.git
    cd FinceptTerminal

  2. 运行构建脚本：

    1
    ./setup.sh

    脚本会自动检查并安装所需的依赖（如 CMake、Qt6、Python 等），然后开始编译。注意：项目对工具链版本有严格要求 (CMake 3.27.7, Qt 6.8.3, Python 3.11.9)，使用其他版本可能导致构建失败。详细构建指南请参考 docs/GETTING_STARTED.md。

初始配置与使用

  1. 启动应用：安装完成后，从系统应用菜单或终端启动 FinceptTerminal。
  2. 配置数据源：应用中的大部分功能依赖外部数据。你需要在 设置 (Settings) 中配置所需数据源的 API 密钥。最常用的是：
    • Yahoo Finance：通常无需密钥，可直接使用。
    • FRED (美联储经济数据)：可免费在 fred.stlouisfed.org 注册获取 API 密钥。
    • AKShare：A股数据源，通常无需密钥。
  3. 配置 AI 代理 (可选)：若要使用内置的 37 个 AI 代理，你需要在设置中配置你选择的 LLM 提供商（如 OpenAI、Anthropic、DeepSeek 等）的 API 密钥。
  4. 探索功能：通过顶部菜单栏或侧边栏，可以访问 Equity Research (股票研究)、Portfolio (投资组合)、News (新闻)、Node Editor (节点编辑器) 等核心模块。

故障排查与注意事项

  • Linux 下 AppImage 无法运行：请确保已赋予执行权限 (chmod +x)。如果提示缺少 FUSE 库，可以尝试使用 --appimage-extract 解压后运行内部的可执行文件。
  • macOS 提示“无法验证开发者”：由于应用未签名，你需要在“系统偏好设置 -> 安全性与隐私”中，点击“仍要打开”来运行它。
  • 缺少数据或 AI 功能失效：请检查是否已在设置中正确配置了相应的 API 密钥。开源版的数据覆盖度和历史深度有限，部分高级功能可能不可用。
  • 许可证合规：请务必阅读并理解 AGPL-3.0 许可证。如果你对应用进行了修改并分发，或将其作为网络服务运行，你需要将修改后的源代码以相同许可证公开。对于商业或内部团队使用，建议考虑 企业版 (Enterprise)。

FinceptTerminal 开源版为金融研究爱好者提供了一个功能强大的原生桌面工具。你可以从下载预编译包开始，然后逐步配置数据源和 AI 密钥，探索其丰富的分析模块。如果遇到问题，优先查阅项目的 docs/ 目录和官方 GitHub Issues。对于团队或商业用途，请务必评估 AGPL 许可证的影响，并考虑其企业版。