FinceptTerminal 是什么？

想象 Bloomberg Terminal 的能力——实时行情、AI 分析、多资产交易、全球数据——但完全免费、开源，而且跑在你自己电脑上。这就是 FinceptTerminal。

技术栈全景：为什么选 C++20 + Qt6？

FinceptTerminal v4 是一个纯原生 C++20 桌面应用。不是 Electron、不是 Web 应用、不是 Python GUI——而是一个编译后的原生二进制文件。这个选择背后有深思熟虑的理由。

数据的旅程：从点击"获取 AAPL 报价"到界面更新

FinceptTerminal 遵循严格的 Screen/Service 分离 模式。来看看数据如何在组件之间流转：

代码翻译：读懂应用程序入口

这是 main.cpp 的核心逻辑。左边是 C++ 原始代码，右边是逐行中文解释：

int main(int argc, char* argv[]) {
  QApplication app(argc, argv);

  app.setApplicationName(
    "FinceptTerminal");
  app.setStyle("Fusion");

  Theme::applyObsidian();

  MainWindow window;
  window.show();

  return app.exec();
}

项目目录结构

FinceptTerminal 的代码库像一个组织严密的金融机构——每个部门（目录）都有明确的职责：

5 分钟从源码到运行

FinceptTerminal 的构建系统使用 CMake Presets——三条命令就能从源码构建出可执行文件：

检验你的理解

Screen/Service 分离：金融终端的"前后端"

FinceptTerminal 中每个功能都遵循一个铁律：Screen 只管 UI，Service 只管数据。就像 Web 开发中的前后端分离——但它们跑在同一个 C++ 进程里，通过 Qt 的 信号/槽 机制通信。

核心基础设施：四个工具让代码更安全

FinceptTerminal 的 src/core/ 目录提供了四个关键工具——它们是整个项目的"基础设施层"，被所有 Screen 和 Service 使用：

代码翻译：Result<T> 让错误无处藏身

传统 C++ 用返回码（-1 表示错误）或异常处理错误。FinceptTerminal 用 Result<T>——灵感来自 Rust 的 Result 类型。来看看它怎么工作：

// Service 层返回 Result
Result<Quote> fetchQuote(
  const QString& symbol) {
  auto reply = http.get(
    "/api/quote/" + symbol);

  if (!reply.ok) {
    return Result<Quote>::err(
      "HTTP " + reply.status);
  }

  auto quote = Quote::fromJson(
    reply.body);
  return Result<Quote>::ok(
    std::move(quote));
}

对话还原：MarketsScreen 和 MarketDataService 的协作

当你点击 Markets 标签页时，Screen 和 Service 之间的"对话"如下。就像餐厅里顾客（Screen）和服务员（Service）的配合：

线程模型：UI 线程只有一个

Qt 有一个严格的规则：UI 操作只能在主线程。FinceptTerminal 如何在保持 UI 流畅的同时做耗时操作？

Bug 挑战：找出代码中的错误

下面这段代码试图在后台线程更新 UI，但它违反了 Qt 的线程规则。找出哪一行有 Bug：

检验你的理解

37 个 AI 智能体：每个都是投资大师的"数字分身"

FinceptTerminal 内置了 37 个 AI 智能体，分为三大类：交易员/投资者（巴菲特、格雷厄姆、林奇等）、经济分析师、地缘政治分析师。每个智能体都有独特的投资框架和分析视角。

智能体架构：从 Python 到 C++ 的桥梁

AI 智能体系统由 Python 编写（在 scripts/agents/finagent_core/），但通过 PythonRunner 桥接到 C++ 界面。来看看核心组件：

代码翻译：投资大师角色的"DNA"

每个智能体都有一个 Persona 定义。来看看巴菲特智能体是怎么被定义的：

{
  "name": "Warren Buffett",
  "category": "trader_investor",
  "framework": "value_investing",
  "system_prompt": """
    You are Warren Buffett.
    Focus on: ROE, debt-to-equity,
    competitive moat, margin of
    safety. Think long-term.
  """,
  "analysis_steps": [
    "assess_business_quality",
    "evaluate_moat",
    "calculate_intrinsic_value",
    "determine_safety_margin"
  ]
}

Alpha Arena：AI 智能体的"角斗场"

FinceptTerminal 有一个独特的功能——Alpha Arena。它让多个 AI 智能体在真实市场数据上竞争，tick by tick，用加密审计保证可回放。

QuantLib 量化套件：18 个专业分析模块

FinceptTerminal 内置了 18 个量化分析模块，覆盖金融工程的四大领域：

动手练习：将投资大师匹配到他们的核心理念

把左侧的投资大师拖拽到右侧对应的核心理念上：

检验你的理解

交易引擎：一个 BrokerInterface，16+ 券商接入

FinceptTerminal 的交易系统采用 插件模式——一个 IBroker 抽象接口，每个券商一个实现类。目前支持 16+ 个券商，覆盖印度、美国、欧洲市场。

代码翻译：IBroker——所有券商的"合同"

所有券商都必须实现 IBroker 接口——这是它们和交易引擎的"合同"。来看看这份合同规定了什么：

class IBroker {
public:
  virtual ~IBroker() = default;

  virtual BrokerId id()
    const = 0;
  virtual const char* name()
    const = 0;
  virtual const char* base_url()
    const = 0;

  virtual BrokerProfile
    profile() const = 0;

  virtual void placeOrder(
    const Order&) = 0;
  virtual void cancelOrder(
    const QString&) = 0;
  virtual void getPositions()
    = 0;
};

Paper Trading：零风险的"战场演习"

不想用真金白银？Paper Trading 引擎让你在真实市场数据上测试策略，零资金风险。

数据中枢：100+ 连接器如何喂饱金融终端

金融终端的核心价值在于数据。FinceptTerminal 通过 100+ 个 Python 脚本连接全球数据源——每个脚本遵循统一的模式：CLI 参数 → JSON 输出。

代码翻译：数据获取脚本的"模板"

每个数据获取脚本都遵循同一个模式。以 yfinance_data.py 为例：

import sys, json, yfinance

def quote(symbol):
  ticker = yfinance.Ticker(symbol)
  info = ticker.info
  result = {
    "symbol": symbol,
    "price": info["regularMarketPrice"],
    "change": info["regularMarketChangePercent"],
    "volume": info["regularMarketVolume"]
  }
  return result

if __name__ == "__main__":
  cmd = sys.argv[1]
  if cmd == "quote":
    data = quote(sys.argv[2])
  print(json.dumps(data))

存储层：13 个 Repository 和加密凭据存储

FinceptTerminal 使用 SQLite 作为本地存储引擎，通过 13 个 Repository 类提供数据访问。

检验你的理解

MCP：让 AI "操控" 金融终端

MCP（Model Context Protocol） 是 FinceptTerminal 最强大的 AI 集成机制。它让 AI 不只是"建议你做什么"，而是直接操作终端——获取数据、分析图表、甚至下单。

MCP 架构：AI 请求如何变成终端操作

当你对 AI 说"分析一下我的 AAPL 持仓"时，MCP 系统内部发生了什么？来看看数据流：

节点编辑器：用可视化管道构建自动化工作流

FinceptTerminal 有一个强大的 节点编辑器——让你通过拖拽连接数据管道，不需要写一行代码就能构建自动化工作流。

安全架构：金融终端的"保险库"

处理金融数据的终端必须把安全放在第一位。FinceptTerminal 从四个层面保护你的数据和资金：

如何为 FinceptTerminal 贡献代码

FinceptTerminal 是开源项目（AGPL-3.0），欢迎社区贡献。根据你的技能和时间，有四条路径：

代码翻译：如何新增一个 MCP 工具

新增 MCP 工具需要两个文件：一个 .h 头文件声明工具，一个 .cpp 文件实现工具逻辑。来看看 MarketsTools 的核心结构：

// MarketsTools.h
class MarketsTools : public QObject {
  Q_OBJECT
public:
  static void registerTools(
    McpManager& mgr) {

    mgr.registerTool(
      "market_quote",
      // Schema: 参数定义
      {"symbol", "string",
       "Stock symbol"},
      // Handler: 执行逻辑
      [](QJsonObject args) {
        auto s = service();
        return s.getQuote(
          args["symbol"]
            .toString());
      });
  }
};

最终检验：FinceptTerminal 全课程回顾

课程总结：你的 FinceptTerminal 知识地图

恭喜你完成了 FinceptTerminal 的完整学习旅程！来回顾一下你掌握的核心知识：