meta-balena:实践指南
2026-09-12
2026-09-14 0
在项目中评估longbridge-terminal,可以先看清用途边界:AI-native CLI 用于 Longbridge 交易平台,提供实时市场数据、组合和交易...。从市场与研究的使用方式看,数据时效、指标口径和风险解释容易混在一起是采用前必须回答的问题。更实际的做法是用一只熟悉标的回放一段历史区间,同时核对数据来源、计算口径、风险提示和结果可追溯性,不要直接在关键项目上。它更像给需要辅助研究而非自动替代决策的使用者准备的可审查方案,是否长期使用应由试跑数据决定。

长桥码头
AI-native CLI 用于 Longbridge 交易平台 — 实时市场数据、组合和交易。还附带用于交互式坚控的全屏 TUI。
覆盖长桥OpenAPI每一个端点:市场数据的实时行情、深度、、期权、权证;用于组合管理的账户余额、和头寸;以及交易的订单提交、修改、取消和执行历史记录。专为脚本编写、AI-agent 工具调用以及终端的日常交易工作流程而设计。
$ longbridge static TSLA.US NVDA.US
Symbol
Last
Prev Close
Open
High
Low
Volume
Turnover
Status
TSLA.US
395.560
391.200
396.220
403.730
394.420
58068343
23138752546.000
Normal
NVDA.US
183.220
180.250
182.970
188.880
181.410
217307380
40023702698.000
Normal
$ longbridge quote TSLA.US NVDA.US --format json
[
{
"high": "403.730",
"last": "395.560",
"low": "394.420",
"open": "396.220",
"prev_close": "391.200",
"status": "Normal",
"symbol": "TSLA.US",
"turnover": "23138752546.000",
"volume": "58068343"
},
{
"high": "188.880",
"last": "183.220",
"low": "181.410",
"open": "182.970",
"prev_close": "180.250",
"status": "Normal",
"symbol": "NVDA.US",
"turnover": "40023702698.000",
"volume": "217307380"
}
]
安装
自制软件 (macOS / Linux)
brew install --cask longbridge/tap/longbridge-terminal
Windows (独家报道)
scoop install https://github.com/longbridge/longbridge-terminal/raw/refs/heads/main/.scoop/longbridge.json
Windows (PowerShell)
iwr https://github.com/longbridge/longbridge-terminal/raw/main/install.ps1 | iex
安装脚本(macOS / Linux)
curl -sSL https://github.com/longbridge/longbridge-terminal/raw/main/install | sh
将 longbridge 二进制文件安装到 /usr/local/bin (macOS/Linux) 或 %LOCALAPPDATA%\Programs\longbridge (Windows)。
认证
通过 Longbridge SDK 使用 OAuth 2.0 — 无需手动令牌管理。
longbridge auth login # 打开 OAuth 的浏览器并保存令牌(由 SDK 管理)
longbridge auth logout # Clear saved token
longbridge check # Verify token, region, and API endpoint connectivity
代币在 CLI 和 TUI 之间共享。 login之后,所有命令都可以工作,无需重新验证。
CLI 从您的位置选择其 API 接入点:它询问 geotest.lbkrs.com 您位于哪个国家/地区并将答案缓存 6 小时,因此每个会话最多有一个命令等待探测器。中国大陆使用.cn端点;其他地方都使用全局的。
longbridge check # Re-detect the access point, and show both latencies
LONGBRIDGE_REGION=global ... # Pin the access point explicitly (cn or global)
check 从不信任缓存。它会重新检测、测量两个端点,然后重新固定到明显更好的端点 - 位置仅近似于此,并且分割隧道代理可以通过完全不同的路径路由地理探测器和 API。结果被保留,因此后面的命令也会跟随它。
外壳完成
在 shell 中为 longbridge 命令和标志启用制表符补全:
Bash — 添加到 ~/.bashrc 或 ~/.bash_profile:
source <(longbridge completion bash)
Zsh — 添加到 ~/.zshrc:
source <(longbridge completion zsh)
鱼 — 添加到 ~/.config/fish/config.fish:
longbridge completion fish | source
重新加载 shell 后,longbridge 将建议子命令、标志和值。
CLI 用法
longbridge [options]
所有命令都支持 --format json 以实现机器可读的输出。接受 --count 的命令也接受 --limit 作为别名(为了 AI 代理兼容性):
longbridge quote TSLA.US --format json
longbridge positions --format json | jq '.[] | {symbol, quantity}'
诊断
longbridge check # Check token validity, and API connectivity
行情
longbridge quote TSLA.US 700.HK # 一个或多个交易品种的实时报价
longbridge depth TSLA.US # Level 2 order book depth (bid/ask ladder)
longbridge brokers 700.HK # Broker queue at each price level (HK market)
longbridge trades TSLA.US [--count 50] # Recent tick-by-tick trades
longbridge 日内 TSLA.US # 今天的日内每分钟价格和成交量线
长桥 K 线 TSLA.US [--周期日] # OHLCV 烛台(K 线)数据 [--调整无|向前]
longbridge kline History TSLA.US --start 2024-01-01 # 某个日期范围内的历史 OHLCV 烛台数据
longbridge static TSLA.US # 一个或多个符号的静态参考信息
longbridge calc-index TSLA.US --fields pe,pb,eps # Calculated financial indexes (PE, PB, EPS, turnover rate, etc.)
长桥资本 TSLA.US # 资金分布快照(large/medium/small 流入流出)
longbridge Capital TSLA.US --flow # 日内资金流向时间序列(large/medium/small 资金进出)
长桥市场温度 [HK|US|CN|SG] # 市场情绪温度指数(0-100,越高=越看涨)
长桥成分股 .SPX.US [--排序市值] # 指数成分股(US 指数需要一个前导点,e.g..DJI.US,.SPX.US)
长桥成分 IVV.US [--limit 0] # 对于 US ,SEC 的全部持股 N-PORT (--limit 0 = 全部);当SEC数据不可用时,回退到平台资产分配(e.g.SPY)
longbridge 交易时段 # 所有市场的交易时段时间表(open/close 次)
longbridge交易日 HK # 市场的交易日和半交易日
longbridge security-list HK # Full list of securities available in a market
longbridge participants # Market maker (participant) broker IDs and names
longbridge subscriptions # Active real-time WebSocket subscriptions for this session
新闻动态
longbridge news TSLA.US [--count 20] # Latest news articles for a symbol
longbridge news detail # Full Markdown content of a news article
longbridge 备案列表 AAPL.US [--count 20] # 符号的监管备案和公告
longbridge 归档详细信息 AAPL.US # 归档的完整 Markdown 内容; --file-index N 用于多文件归档(e.g.8-K 展示)
longbridge topic list TSLA.US [--count 20] # Community discussion topics for a symbol
longbridge 主题详细信息 # 社区主题的完整详细信息(正文、作者、代码、计数、URL)
longbridge topic replies [--page 1] # Paginated list of replies for a topic (--size 1–50)
longbridge topic mine [--type article] # Topics created by the authenticated user
longbridge topic create --body "…" # Publish a new community discussion topic (--title optional)
longbridge topic create-reply --body "…" # 发布对主题的回复(--reply-to 用于嵌套回复)
期权和认股权证
longbridge option quote AAPL240119C190000 # Real-time quotes for option contracts
longbridge option chain AAPL.US # Option chain: list all expiry dates
longbridge 期权链 AAPL.US --date 2024-01-19 # 期权链:给定到期日的执行价格
longbridge期权成交量AAPL.US #实时期权Call/Put成交量与Put/Call的比例
长桥期权每日成交量 AAPL.US # 每日期权 Call/Put 成交量和持仓量历史记录
longbridge option volume daily AAPL.US --count 60 # Return last 60 trading days
longbridge warrant quote 12345.HK # Real-time quotes for warrant contracts
longbridge warrant 700.HK # Warrants linked to an underlying security
longbridge warrant issuers # Warrant issuer list (HK market)
基础知识
长桥财务报告 AAPL.US [--kind IS|BS|CF]#多期财务报表(收入/资产负债表/现I金流量)
longbridge financial-report AAPL.US --latest # Latest financial report summary
longbridge 财务报告快照 AAPL.US --report qf --year N --period N # 盈利摘要 + 预测与实际 (revenue/EBIT/EPS beat/miss) + 财务比率
长桥财务报表 AAPL.US [--kind IS|BS|CF|ALL] [--报告者|安全b队|qf|cumul] # 详细财务报表(v3 端点)
长桥机构评级 AAPL.US # 分析师评级分布及共识目标价
longbridge机构评级AAPL.US --history #评级和目标价变化历史
longbridge机构评级AAPL.US --industry-rank [--page 1] [--limit 20] #全行业机构评级排名
长桥机构评级 AAPL.US --views # 每月 buy/hold/sell 分布时间表(机构观点)
长桥机构评级详情 AAPL.US # 每月评级趋势和分析师准确度历史记录
longbridge dividend AAPL.US # Historical dividend records
longbridge dividend detail AAPL.US # Dividend allocation plan details
longbridge forecast-eps AAPL.US # Analyst EPS consensus forecast snapshots
长桥共识 AAPL.US # 收入/利润/EPS 与 beat/miss 标记的多周期比较
长桥估值AAPL.US[--指标pe|铅|附注|dvd_yld] # 当前估值快照和同行比较
longbridge估值 AAPL.US --history [--指标pe] [--range 5] # 历史估值时间序列(1/3/5/10年)
longbridgevaluation-rank AAPL.US [--start 20240101] [--end 20241231] # 行业估值百分位数排名(默认:最近30天)
longbridge analyst-estimates AAPL.US # Analyst consensus EPS estimates
longbridge 持有人 AAPL.US [--count 20] # 持有该的和 s
长桥股东 AAPL.US [--range all|公司|dec] [--sort chg] # 具有 QoQ 变更跟踪的机构股东
长桥股东 AAPL.US --top # 前20名大股东(含个人及内部人士,多期)
longbridge股东AAPL.US --object-id #特定股东的持有和交易详细信息(使用--top输出中的ID)
longbridge Compare AAPL.US # 多估值与服务器选择的行业同行的比较
longbridge compare 9988.HK 700.HK 9999.HK [--currency HKD] # Compare specific stocks side by side (price, market cap, PE/PB/PS, ROE, ROA, div yield, and more)
longbridge corp-action 700.HK [--all] # 公司行为(分割、股息、权利等) — 默认 30, --all 获取完整历史记录
长桥业务部门 AAPL.US [--历史记录] [--报告 qf|安全b队|af] [--cate ] # 收入细分(当前快照或历史趋势)
长桥行业排名--市场US|HK|CN|SG [--指标领先者|...|net-profit-growth]#行业排名榜;输出符号输入业界同行
longbridge Industry-peers IN00446.US # 行业索引符号的行业同行组层次结构树(来自行业排名)
longbridge Macrodata [--country US] [--page 1] [--limit 20] # 列出宏观经济指标(20/page);名字后面是--lang
longbridge Macrodata US00175 [--start 2024-01-01] [--end 2024-12-31] # 一项指标的历史发布(实际/预测/历史)
和
longbridge bank-cards # List linked bank cards
longbridge withdrawals [--page 1] [--limit 20] # Withdrawal history
longbridge deposits [--page 1] [--limit 20] [--states 0,1,2] [--currencies HKD,USD] # Deposit history
搜索
长桥搜索TSLA[--tab市场|新闻|帖子|主题标签|帮助|共享列表|用户|机构] # 跨多种内容类型搜索
longbridge search-hot # Hot search keywords
IPO
longbridge ipo subscriptions # IPO stocks currently in filing or subscription stage
长桥 ipo 等待上市 # IPO 处于灰市(等待上市)阶段
longbridge ipo listed [--page 1] [--limit 20] # Recently listed IPO stocks
longbridge ipo calendar # IPO calendar (all upcoming and recent IPOs)
长桥IPO详情 [--市场 HK|US] # IPO 符号的简介、时间表、资格和持有量
longbridge ipo 订单 [--market HK] [--status 0] [--page 1] 当前账户的 # IPO 订单(活跃 + 历史)
longbridge ipo orders detail # Full detail for a single IPO order
长桥IPO盈利-亏损[-期间全部|1米|3m|6m|1y] [--第 1 页] # IPO 损益摘要和项目列表
longbridge ipo us-subscriptions # US IPO stocks currently in subscription stage
longbridge ipo us-wait-listing # US IPO 处于等待上市阶段
longbridge ipo us-listed [--page 1] [--limit 20] # Recently listed US IPO stocks
longbridge ipo Submit TSLA.US --qty 200 --amount 1000 [--method 2] # 提交IPO申购(提示确认)
longbridge ipo withdraw # Withdraw IPO subscription (prompts for confirmation)
市场数据
longbridge rank # List available popularity ranking tab keys
longbridgerank --key ib_hot_all-us [--count 20] # 按综合热度评分排名的(交易活动、媒体、社区、波动性)
长桥顶级推动者 [--market HK|US|CN|SG] [--排序热门|时间|chg] # 价格走势异常的,并附有相关新闻和原因摘要
longbridge exchange-rate # Exchange rates for all markets
longbridge Finance-calendar Financial [--symbol AAPL.US] # 即日起公布盈利指引
longbridge 财务日历报告 [--symbol AAPL.US] # 收益报告发布日期从今天开始
longbridge Finance-calendar股息[--symbol AAPL.US] #从今天开始的股息除息日/支付事件
longbridge Finance-calendar ipo [--market US] # IPO 即日起上市时间表
longbridge Finance-calendar 宏观数据 [--star 3] # 宏观经济事件(--star 1-3 按重要性过滤)
longbridge Finance-calendar 关闭 [--market HK] # 市场假期和缩短的交易日
关注列表
longbridge watchlist # 列出所有监视列表组及其(首先固定显示)
longbridge watchlist show # Show securities in a specific group (pinned marked)
longbridge watchlist create "My Portfolio" # Create a new watchlist group
longbridge watchlist update --add TSLA.US # Add securities in a group
longbridge watchlist update --remove AAPL.US # Remove securities from a group
longbridge watchlist delete # Delete a watchlist group
longbridge 观察列表 pin TSLA.US AAPL.US # 将固定到其组的顶部
longbridge watchlist pin --remove 700.HK # Unpin securities
分享列表
longbridge sharelist # List own and subscribed sharelists
longbridge sharelist [--count 50] # List with custom page size
longbridge sharelist detail # Show full details and constituent stocks
longbridge sharelist create --name "My Picks" [--description "…"] # Create a new sharelist
longbridge sharelist delete # Delete a sharelist
longbridge sharelist add TSLA.US AAPL.US 700.HK # 将添加到列表
longbridge sharelist remove TSLA.US # Remove stocks from a sharelist
longbridge sharelist sort TSLA.US AAPL.US 700.HK # 对列表中的重新排序
longbridge sharelist popular [--count 10] # Get popular (trending) sharelists
AI 代理商
longbridge agent workspaces # List AI workspaces
longbridge agent list [--workspace 33] [--name 选股] # Discover ch@t-capable AI agents (--all includes workflow agents)
longbridge agent ch@t ch@tbot "分析一下 TSLA" # `ch@tbot` (LongbridgeAI) is public — usable by any account
longbridge agent ch@t ch@tbot "分析一下 TSLA" # Chat with an agent (SSE; --stream for live tokens)
longbridge agent ch@t ch@tbot "继续" # Multi-turn follow-up
longbridge agent continue ch@tbot --answer "…" # Resume an interrupted run
longbridge agent continue ch@tbot --answers-json '{…}' # 使用原始答案负载继续
longbridge agent --skill # Print the agent skill doc for AI harnesses
交易
longbridge order # Today's orders, or historical with --history
longbridge order --history [--start 2024-01-01] # Historical orders (use --symbol to filter)
longbridge 订单详细信息 # 单个订单的完整详细信息,包括费用和历史记录
longbridge order executions # Today's trade executions (fills), or historical with --history
longbridge order buy TSLA.US 100 --price 250.00 # 提交买单(提示确认)
longbridge order sell TSLA.US 100 --price 260.00 # 提交卖单(提示确认)
longbridge order cancel # Cancel a pending order (prompts for confirmation)
longbridge order replacement --qty 200 --price 255.00 # 修改挂单数量或价格
longbridge assets [--currency USD] # 资产概览:净资产、现I金、购买力、和每种货币的明细
longbridge cash-flow [--start 2024-01-01] # Cash flow records (deposits, withdrawals, dividends, settlements)
longbridge portfolio # Portfolio overview: total assets, P/L, holdings, and cash breakdown
longbridge portfolio short-margin # Short-selling margin deposit details
longbridge positions # Current stock (equity) positions across all sub-accounts
longbridge Fund-positions # 所有子账户的当前(共同)头寸
longbridge margin-ratio TSLA.US # Margin ratio requirements for a symbol
longbridge max-qty TSLA.US --side buy --price 250 # 根据经常账户余额估计最大买入或卖出数量
利润分析
longbridge profit-analysis # P&L summary with stock breakdown
longbridge profit-analysis detail 700.HK # Stock P&L breakdown + transaction flows
longbridge profit-analysis detail 700.HK --derivative # Show derivative flows
longbridge profit-analysis by-market # Stock P&L by market (paginated)
longbridge profit-analysis by-market --market HK --size 50 # Filter by market
声明
长桥声明列表[--类型日报|每月] # 列出可用的账户报表(每日或每月)
longbridge statements export --file-key --sectionEquity_holdings # 将报表部分导出为 CSV 或 Markdown
longbridge statement export --file-key --all # Export all non-empty sections
内幕交易
longbridge 内幕交易 TSLA.US # 最近的表格 4 内幕交易(仅限 SEC EDGAR、US )
longbridge insider-trades AAPL.US --count 40 # 获取 40 个表格 4 文件,而不是默认的 20 个
longbridge insider-trades NVDA.US --format json # Export as JSON
者
长桥者 # AUM 排名前 50 的主动型经理(实时 SEC 13F 排名;排除被动指数巨头;使用 --top N 更改)
longbridge investors 0001067983 # View 13F holdings for any filer by SEC CIK number
longbridge investors 0001067983 --top 20 # Show top 20 positions only
longbridge investors 0001067983 --format json # Export holdings as JSON
longbridge investors changes 0001067983 # Quarter-over-quarter changes (NEW/ADDED/REDUCED/EXITED)
longbridge investors changes 0001067983 --from 2024-12-31 # Compare latest vs a specific period
经常性
longbridge dca # List all recurring investment plans
longbridge dca --status Active # Filter by status: Active | Suspended | Finished
longbridge dca --symbol TSLA.US # Filter by symbol
longbridge dca create TSLA.US --amount 500 --frequency week --day-of-week mon # 创建每周经常性计划
longbridge DCA create 700.HK --amount 1000 --Frequency Monthly --day-of-month 15 # 每月经常性计划
longbridge dca update --amount 800 # Update plan amount
longbridge dca pause # Pause a recurring investment plan
longbridge dca resume # Resume a paused recurring investment plan
longbridge dca stop # Permanently stop a recurring investment plan
longbridge dca history # Trade history for a plan
longbridge dca stats # Recurring investment statistics summary
longbridge dca calc-date TSLA.US --freight week --day-of-week fri # 计算下一个交易日期
longbridge dca check TSLA.US AAPL.US 700.HK # 检查哪些符号支持经常性
longbridge dca set-reminder 6 # Set reminder hours before trade (1 | 6 | 12)
网格交易
longbridge grid # List grid orders
longbridge grid --symbol 700.HK --status Performing # 按交易品种/状态过滤网格订单
longbridge grid --ids # Query specific grid orders by ID
长桥网格提交 700.HK --货币 HKD --base-price 300 --upper-price 360 --lower-price 240 \
--trigger-type percent --trigger-up 2 --trigger-down 2 --quantity 100 \
--upper-quantity 200 --lower-quantity 100 --order-type GMO --tif gtc # 提交网格策略
longbridge grid Submit 700.HK --base-price 300 ... --dry-run # 验证+打印规则而不提交
longbridge grid detail # Grid order detail (rule, sub-orders, history)
longbridge grid triggers # Grid trigger history
longbridge grid replace --base-price 305 ... # Replace (modify) a grid rule
longbridge grid cancel # Cancel a grid order
longbridge grid suspend # Suspend a grid order
longbridge grid restart # Restart a suspended grid order
longbridge grid info 700.HK # 交易品种的网格交易信息(手数、最后价格、授权、货币)
longbridge grid questionnaire # Submit the strategy risk-disclosure questionnaire
卖空
长桥空头头寸 AAPL.US # US:每两周 FINRA 空头利息(空头利息、、回补天数)
长桥空头头寸 700.HK #HK:每日HKEX披露的空头头寸(未平仓空头份额、余额、成本、费率)
longbridge short-positions TSLA.US --count 50 # Return last 50 records
长桥做空交易 AAPL.US # 每日卖空交易量(US 为 FINRA/NASDAQ;HK 为 HKEX)
longbridge 空头交易 700.HK [--count 50] # HK: 金额、余额、总金额、回了、每个交易日收盘价
筛选器
longbridge screener strategies # List recommended stock-selection strategies
longbridge screener strategies --all # List all platform strategies
longbridge screener strategies --mine # List user-created strategies
longbridge screener strategies --id # Show groups and indicators for a specific strategy
longbridge screener search --strategy-id # 运行保存的策略并返回匹配的
longbridge screener search --market HK --filter filter_marketcap:100:1000 --filter filter_divyld:3: # 自定义过滤器(key:min:max,省略绑定保持打开状态)
longbridge 筛选器指标 # 列出所有可用的筛选器指标,包括 IDs、键和默认值范围
嵌入另一个应用程序
longbridge 在 stdin/stdout 上提供 # JSON-RPC 2.0 API 端点,并提供实时报价推送
符号格式
. e.g. TSLA.US 700.HK 600519.SH
市场:HK(香港)·US(美国)·CN / SH / SZ(中国A股)·SG(新加坡)
技能
安装技能以使您的 AI 工具全面了解所有 longbridge CLI 命令:
npx skills add longbridge/developers
更多关于长桥技能请访问:https://open.longbridge.com/skill/
安装后,Claude 可以直接从 AI 工作流程查询市场数据、运行技术分析和管理交易。
claude> Show me TSLA and NVDA performance over the last 5 days
● Bash(长桥k线TSLA.US --周期日--计数5 & 长桥k线 NVDA.US --周期日--计数5 & 等待)
● Here's the 5-day performance for both:
TSLA.US — Last 5 Days
┌────────┬────────┬────────┬────────┬────────┬──────────┐
│ Date │ Open │ High │ Low │ Close │ Change │
├────────┼────────┼────────┼────────┼────────┼──────────┤
│ Mar 10 │ 402.22 │ 406.59 │ 398.19 │ 399.24 │ — │
├────────┼────────┼────────┼────────┼────────┼──────────┤
│ Mar 11 │ 402.28 │ 416.38 │ 402.15 │ 407.82 │ ▲ +2.15% │
├────────┼────────┼────────┼────────┼────────┼──────────┤
│ Mar 12 │ 405.18 │ 406.50 │ 394.65 │ 395.01 │ ▼ -3.14% │
├────────┼────────┼────────┼────────┼────────┼──────────┤
│ Mar 13 │ 399.17 │ 400.20 │ 389.95 │ 391.20 │ ▼ -0.96% │
├────────┼────────┼────────┼────────┼────────┼──────────┤
│ Mar 16 │ 396.22 │ 403.73 │ 394.42 │ 395.56 │ ▲ +1.11% │
└────────┴────────┴────────┴────────┴────────┴──────────┘
5-day return: -0.92% | Range: $389.95 – $416.38
NVDA.US — Last 5 Days
┌────────┬────────┬────────┬────────┬────────┬──────────┐
│ Date │ Open │ High │ Low │ Close │ Change │
├────────┼────────┼────────┼────────┼────────┼──────────┤
│ Mar 10 │ 112.34 │ 115.20 │ 111.80 │ 114.50 │ — │
├────────┼────────┼────────┼────────┼────────┼──────────┤
│ Mar 11 │ 114.80 │ 117.60 │ 114.20 │ 116.90 │ ▲ +2.10% │
├────────┼────────┼────────┼────────┼────────┼──────────┤
│ Mar 12 │ 116.50 │ 118.30 │ 115.40 │ 115.80 │ ▼ -0.94% │
├────────┼────────┼────────┼────────┼────────┼──────────┤
│ Mar 13 │ 115.20 │ 116.80 │ 113.90 │ 114.60 │ ▼ -1.04% │
├────────┼────────┼────────┼────────┼────────┼──────────┤
│ Mar 16 │ 114.90 │ 117.50 │ 114.30 │ 116.80 │ ▲ +1.92% │
└────────┴────────┴────────┴────────┴────────┴──────────┘
5-day return: +2.01% | Range: $111.80 – $118.30
TUI
longbridge tui
功能:实时观察列表、蜡烛图、组合视图、搜索、响应式布局(当有空间容纳两者时将新闻列表停靠在报价面板旁边)、类似 Vim 的键绑定和鼠标支持 - 单击选项卡、快捷方式提示、标题或 Portfolio/Orders 行以打开其详细信息面板。按 ? 查看完整按键列表。
LongbridgeAI 聊天
由 LongbridgeAI 支持的全屏聊天 TUI:
longbridge ai [--agent ]
功能:以 Markdown 形式呈现的流答案,包含图表、表格、语法突出显示的代码和实时报价卡;单击答案提到的任何(或 /quote 700.HK)以获取浮动实时报价,会话中的及其报价会显示在旋转标题栏上; / 命令调色板 (/new /retry /copy /export /quote /resume /settings /agent /login /logout /exit /help);也可打开已注销状态,并已完成登录;会话并在 /settings 下签名 in/out,以及首选项(工具调用详细信息、完成通知、报价卡、标题栏代码、up/down 颜色);服务器同步对话 (/v1/ai/ch@ts) 使用 /resume 重新打开并可就地搜索;在打开的成绩单中搜索 Ctrl+F(输入/↑↓ 走遍比赛);拖动选择副本 (OSC 52),滚动以跨页扩展,以及 /export 到 Markdown;使用 undo/redo (Ctrl+Z/Y) 进行多行输入,将大粘贴折叠成紧凑的芯片,并提示历史记录在会话中持续存在(↑/↓ 或 Ctrl+P/N)。 /agent 切换代理以进行新对话,/agent reset 返回默认值。输入 exit 或按 Ctrl+C 两次退出。
ACP代哩服务務器
通过 stdio 将主 LongbridgeAI 代理 (ch@tbot) 公开给 ACP 客户端:
longbridge acp
Zed 可以将其注册为自定义外部代理:
{
"agent_servers": {
"longbridge-ai": {
"type": "custom",
"command": "longbridge",
"args": ["acp"],
"env": {}
}
}
}
嵌入另一个应用程序
第三方客户端——桌面小部件、栏插件、仪表板——可以驱动 CLI 作为 长期存在的数据源而不是轮询一次性命令:
longbridge serve
进程认证并开市一次WebSocket,然后说话 以换行符分隔的 JSON-RPC 2.0 on stdin/stdout — 每行一个紧凑的 JSON 对象。这是相同的基础协议 LSP、MCP 和 ACP 构建 上,所以客户端只需要一个JSON解析器和一个行分割器,不需要协议库。
→ {"jsonrpc":"2.0","id":1,"method":"quote.quote","params":{"symbols":["700.HK"]}}
← {"jsonrpc":"2.0","id":1,"result":[{"symbol":"700.HK","last_done":"445.600", ...}]}
→ {"jsonrpc":"2.0","id":2,"method":"quote.subscribe","params":{"symbols":["700.HK"]}}
← {"jsonrpc":"2.0","id":2,"result":{"subscribed":[{"symbol":"700.HK","fields":["quote"]}],"quotes":[…]}}
← {"jsonrpc":"2.0","method":"quote.updated","params":{"symbol":"700.HK","last_done":"446.000", ...}}
每行一个请求:不接受批次(JSON 数组),如 LSP 和 MCP 中。
故意的原始有效负载
serve 返回原始 Longbridge OpenAPI 有效负载 - 而不是 CLI 打印的 JSON。
CLI的--format json重塑了AI消耗的数据,并且可以自由改变;
serve 是其他人软件的 API 合约,因此它跟踪上游形状
相反。
方法面
serve 位于 CLI 命令下方,在 API 接缝处,它们全部共享,因此它涵盖了
没有并行实现的整个命令面:
| 命名空间 | 封面 |
|---|---|
quote.* |
每个 QuoteApi 调用 - quote.quote、quote.depth、quote.candlesticks、quote.watchlist、quote.option_chain_info_by_date,... |
trade.* |
每个 TradeApi 调用 - trade.stock_positions、trade.account_balance、trade.today_orders、trade.submit_order,... |
api.get / api.post |
到任何 REST 端点的原始直通,e.g。 {"path":"/v1/quote/dividends","query":{"symbol":"AAPL.US"}}。这就是基本面、筛选器、IPO 和新闻命令获取数据的方式。 |
quote.subscribe / quote.unsubscribe |
现场直播; fields 是 quote、depth、brokers、trades 中的任意一个(默认为 quote)。 subscribe 还返回一个 quotes 快照来绘制第一个屏幕。没有一次性 CLI 等效项。 |
initialize / shutdown |
会话控制。 initialize 返回完整的方法列表,因此客户端可以发现表面而不是对其进行硬编码。 |
longbridge serve -h 打印协议、完整方法列表和有效交换 —
从路由表中生成,因此帮助无法通告不属于该路由表的方法
那里。对于同一调用,参数和结果遵循 Longbridge OpenAPI 形状,因此请查看
其字段以其自己的名称命名为 https://open.longbridge.com/docs 的方法。
服务器通知:quote.updated、quote.depth、quote.brokers、quote.trades。
quote.updated 是一个勾号而不是完整的报价,并且是一个领先的推动
subscribe 的快照仍然可以是两个中较旧的,因此保留 timestamp 中的哪个
较新。
测试断言每个 QuoteApi/TradeApi 方法都可以通过 RPC 访问,因此添加一个
如果不暴露它,构建就会失败——serve 不能落后于 CLI。
CLI 在本地计算的派生视图(例如,portfolio,它合并余额,
头寸和 FX 回了)故意不是方法:客户将它们组成
trade.account_balance、trade.stock_positions 和 quote.quote 而不是依赖于
我们的算术。
请求同时得到答复——缓慢的 trade.stock_positions 永远不会停止报价
feed——因此响应可能会乱序到达;通过 id 将它们关联起来。最多 8 个上游运行
一次,其余队列,因此突发是有节奏的,而不是被丢弃。错误代码显示
重试是否有帮助:-32602 命名有错误的参数,并且会以同样的方式失败
再说一次,-32000 来自长桥,可能不是。当 stdin 关闭时进程退出,所以
它不能比生成它的客户端寿命更长。
输出格式
--format table # Human-readable ASCII table (default)
--format json # Machine-readable JSON, suitable for AI agents and piping
速率限制
Longbridge OpenAPI:每秒最多调用 10 次。 SDK 自动刷新 OAuth 令牌。
要求
使用数据
官方发布构建了向Longbridge报告使用数据,这样我们就可以看到哪些
命令的使用情况以及失败的地方。当您签署报告时
您的会员 ID,因此他们不是匿名的。您自己制作的构建(cargo build, cargo run) 根本没有报告任何内容。
每次运行发送的内容:
quote,alert add) - 没有它的参数,所以没有符号,
帐号或订单详细信息~/.longbridge/openapi/device-id 中没有收集任何其他信息:没有争论,没有您查看的市场数据,没有
持仓,无订单。代码位于 src/analytics/ —
事件有效负载组装在一处并且可以完整读取。
文档