longbridge-terminal

Longbridge Terminal：AI 时代的命令行证券交易终端

一个交易日早晨的场景

假设你是一名日内交易者，早上刚打开电脑，不需要启动臃肿的桌面客户端，只需在终端敲几行命令，就能看到特斯拉、英伟达的实时行情；切换到持仓视图，盈亏数字一目了然；输入一行指令，最新一单港股IPO的认购就提交完成了。这不是设想，而是 Longbridge Terminal 正在提供的能力——一个用 Rust 编写的高速 CLI/TUI 工具，直接对接 Longbridge 港美股交易 API。

图1：Longbridge 官方组织标识

项目背景：从券商开放平台到终端工具链

Longbridge（长桥证券）是一家主打 API 交易的港美股券商，于 2021 年起向开发者开放 OpenAPI，允许第三方程序直接接入行情与交易通道。Longbridge Terminal 由该组织官方维护，定位为 "AI 原生"（AI-native）的命令行界面——强调不仅人能使用，还能被 AI Agent 作为工具调用（Tool-calling），接入 LangChain、AutoGPT 等 AI 编程框架。

项目采用 Rust 语言开发，于 GitHub 公开仓库持续迭代，最新版本 0.23.2。截至分析时已获得约 890 颗 Stars，72 个 Forks，在金融科技类开源 CLI 工具中处于较高关注度水平。

核心功能：三大模块覆盖交易全链路

Longbridge Terminal 的命令体系按功能可划分为三大模块：

1. 市场数据（Quote）模块

这是工具最常用的功能。通过 longbridge static 或 longbridge quote 查询实时行情，返回股票的最新价、开盘价、最高/最低价、成交量、成交额等字段。longbridge watch 命令支持自定义自选列表监控，longbridge rank 提供热度排行，longbridge candlestick 生成 ASCII 风格的 K 线图。技术实现上，行情数据通过 Longbridge SDK 的 WebSocket 通道推送，CLI 输出默认格式为 ASCII 表格，可通过 --format json 切换为机器可读格式，便于 AI 管道处理。

2. 投资研究（Analysis）模块

这一模块面向基本面分析需求，涵盖：分析师一致预期（analyst-estimates）、机构持仓变化（fund-holder、shareholder）、同行业对比（compare、industry-rank）、公司经营分拆（business-segments）、股权结构等。longbridge sec2md 子命令可将券商研报转换为 Markdown 格式，供 AI 阅读摘要。对于 IPO 参与者，工具还内置了认购（ipo submit）、撤回（ipo withdraw）、历史盈亏（ipo profit-loss）等完整生命周期管理。

3. 交易执行（Trading）模块

通过 OAuth 2.0 完成身份认证（longbridge auth login），全程无需手动管理 token。订单操作包括市价单、限价单的提交、修改与取消，支持订单状态查询与成交历史回溯。存取款记录、银行卡管理也在覆盖范围内。

技术架构：Rust + Ratatui TUI + tokio 异步运行时

从 Cargo.toml 可以清晰看到项目的技术选型：

• CLI 框架：clap v4（带 derive 宏），命令行参数解析与子命令体系
• TUI 渲染：ratatui v0.30 + crossterm，实现全屏交互式终端界面，Vim 风格键绑
• 异步运行时：tokio（多线程 runtime），所有网络 I/O 均为 async/await 模式
• HTTP 客户端：reqwest（rustls-tls，无 OpenSSL 依赖），接入 Longbridge OpenAPI
• Protocol Buffers：prost 编解码 gRPC 协议，Longbridge API 底层使用 gRPC 传输
• 数据表格：tabled v0.20 渲染 ASCII 表格，cli-candlestick-chart 自定义 K 线组件
• 国际化：rust-i18n 支持多语言界面，locales/ 目录存放翻译文件

项目采用 Rust Workspace 结构，主 binary 在 src/main.rs，两个可复用子 crate 放在 crates/ 下：cli-candlestick-chart（K 线图渲染）和 sec2md（研报格式转换）。Workspace 统一管理依赖版本，避免版本碎片化。

代码质量方面，项目启用 clippy pedantic + deny all lints，[lints.clippy] 配置段展示了较高的代码规范要求。dev-dependencies 中引入 mockall 做单元测试模拟，serial_test 确保部分测试顺序执行。

部署体验：零门槛安装，多平台覆盖

Longbridge Terminal 本身是编译好的单一可执行文件，不依赖运行时，官方提供三种安装路径：

安装后首次运行 longbridge auth login 会自动打开浏览器完成 OAuth 登录，后续所有命令免认证。安装脚本将二进制写入 /usr/local/bin（macOS/Linux）或 %LOCALAPPDATA%\Programs\longbridge（Windows），整个过程不超过 2 分钟，磁盘占用约 50MB，内存需求极低（<128MB）。

局限性与注意事项

• 无 Docker 部署：项目未提供 Dockerfile，对于已在容器内运行 AI Agent 的用户（如 AutoGPT、Dify 等），需要额外处理宿主机二进制安装
• OAuth 依赖浏览器：首次登录必须打开浏览器，不支持纯命令行 Token 注入，在无头（headless）服务器环境存在障碍
• API 限速：Longbridge OpenAPI 限制 10 次/秒，高频量化策略需自行实现请求节流
• 非通用金融数据：数据源仅限于 Longbridge 覆盖的港股、美股、新加坡股，无法查询 A 股、加密货币等

行业意义：CLI 工具的"AI 化"趋势代表

Longbridge Terminal 体现了当前开源领域一个值得关注的趋势：传统命令行工具的 AI Agent 化。项目 README 明确将其定位为"AI-native"，强调 --format json 输出格式、Machine-readable 设计、以及 AI Agent 工具调用场景。这与年初火爆的 "MCP（Model Context Protocol）工具生态"一脉相承——未来 AI 不仅需要理解代码，还需要直接操作交易、研究、监控工具。

随着 AI 编程助手（Cursor、Copilot 等）深入金融场景，此类 CLI 工具将成为 AI Agent 执行真实交易任务的桥梁。Longbridge Terminal 的代码结构、模块化设计、以及 JSON-first 的输出理念，都为后续接入 MCP 协议或 LangChain Tool 生态做好了技术铺垫。

本报告基于 GitHub 公开信息生成，分析时间：2026-06-16。