Files
Hermes-Skills/longbridge-cli/references/longport-http-module.md
T
mike b660debd06 v2026-07-21: 实战教训汇总 (push 11 文件)
新增 8 reference:
  - dividend-stability-score: A 股 5 维评分 (派息年数/CAGR/波动/最近/连续) → 0-100 分 + 5 星
  - dividend-yield-rate-sort: 按股息率% 倒序 (用户偏好 2026-07-13)
  - longport-http-module: longport_http.py 公共模块 (替代 SDK WSS)
  - leverage-pass-through-bug: process_signal.py 丢失 leverage 字段 (5x 实际 10x)
  - follow-trading-iron-laws: 跟单铁律 (用户原话 5+ 次 2026-07-21)
  - forced-skill-entry-okx-trade: okx_trade.sh 强制入口 (替代 ccxt 裸调)
  - mihomo-clash-node-supplier-dns: Clash 节点供应商 DNS 失败处理
  - mihomo-ssl-reconnect-pattern: mihomo 反复 SSL/Timeout 模式
  - v4.5.44-mu-add-to-75pct-cap: MU 加仓 75% 单币种 cap 标准流程

改 2 SKILL.md:
  - dividend-investing: 加 5 维评分 + 长桥 http 模块
  - longbridge-cli: 标注 '不要写 openapi.QuoteContext' + 迁移说明
2026-07-22 13:22:45 +08:00

4.5 KiB

longport_http.py 公共模块 (2026-07-21 新建)

背景

长桥 Python SDK (openapi.QuoteContext / openapi.TradeContext) 走 WSS (WebSocket),而国内 VPS + Clash 代理下 WSS 经常超时 (error sending request for url (https://openapi.longbridge.com/v1/socket/token): client error (Connect))。多次观察到:

  • 长桥 quote 公共 API (HTTP) 走 mihomo 代理能通
  • 长桥 SDK WSS 走 mihomo 代理必败
  • 长桥 CLI 走 mihomo 代理能通 (HTTP 协议)

结论:长桥 SDK 不可用,长桥 CLI 完全够用

公共模块: ~/.hermes/scripts/longport_http.py

把长桥 CLI 封装成 Python SDK 风格的函数,所有脚本统一用这个模块(替代 openapi.QuoteContext / openapi.TradeContext)。

提供函数

函数 替代 说明
get_quote(symbol) ctx.quote([symbol]) 拿 1 只票实时报价, fallback candlesticks day
get_quotes(symbols) ctx.quote(batch) 批量,失败的 symbol 不会出现在结果里
get_positions() trade_ctx.stock_positions() 查持仓
submit_order(...) trade_ctx.submit_order(...) 下单 (limit)

内部实现

def _run(*args) -> str:
    cmd = [PROXYCHAINS, "-f", PROXYCHAINS_CONF, LONGBRIDGE_BIN,
           "--profile", PROFILE, *args]
    r = subprocess.run(cmd, capture_output=True, text=True, timeout=TIMEOUT)
    return r.stdout if r.returncode == 0 else ""

所有调用走 proxychains4 + longbridge CLI,避开 WSS。

A 股 / 长 symbol 截断问题

longbridge quote 600519.SH 表格列宽限制,symbol 显示成 600519…,价格也截断成 1308.0…

fallback:get_quote 失败时调 candlesticks day --count 1 取日线收盘价(完整数字, 不是实时但可用)。

if out:
    symbol_trunc = symbol[:7] + "…"
    for cand in [symbol, symbol_trunc]:
        m = re.search(r"│\s*" + re.escape(cand) + ... , out)
        if m:
            price_str = m.group(1)
            if "…" in price_str or len(price_str) < 4:
                break  # 截断, 走 candlesticks fallback
            ...

# fallback
cs_out = _run("candlesticks", symbol, "day", "--count", "1")

性能 (实测 2026-07-21)

标的数 平均耗时 5 次连续成功率
3 (DCA US) 4-5s 5/5
10 (dividend 港+美+A) 21-26s 3/3
1 (cron 每 15min) 4s 5/5

已迁移的脚本

  • ~/.hermes/scripts/dividend_alert.py
  • ~/.hermes/scripts/dca_monitor.py (独立 module 写法, 待统一)
  • 其他待迁移 (见 "推广" 章节)

待迁移 (Phase 2)

脚本 当前 推广后
~/.hermes/scripts/stock_t.py 直接调 ccxt from longport_http import get_quote, get_positions
~/.hermes/scripts/hk_intraday_monitor.py (cron e3667cb07aff, paused) 走 SDK 改 longport_http
~/.hermes/scripts/us_intraday_monitor.py (cron bcdf70392251, paused) 走 SDK 改 longport_http
~/.hermes/scripts/hk_intraday_close.py 走 SDK 改 longport_http
~/.hermes/scripts/us_intraday_close.py 走 SDK 改 longport_http
~/.hermes/scripts/daily_t_analysis.py (cron cb187ab5f9fc, running) 走 SDK 改 longport_http
~/.hermes/scripts/dca_scanner.py 走 SDK 改 longport_http
~/.hermes/scripts/rgti_alert.py 走 SDK 改 longport_http
~/.hermes/scripts/dividend_alert.py 已用 -
~/.hermes/scripts/dca_monitor.py 已用 -

风险: 14+ 个脚本都改,全部需要回归测试

推广原则

  1. 改一个测试一个 — 不要一次改多个
  2. 5 次连续跑验证稳定 — 因为 mihomo 节点抽风可能
  3. 保留原 SDK 代码注释 — 以防回退
  4. 不删 SDK import — 让模块兼容两种调用(但默认走 longport_http)

实战铁律 (2026-07-21)

  • LONGPORT_* env vars 在 cron 不生效 — 必须走 proxychains + longbridge CLI 走 mihomo
  • get_quote 返回 None 不抛异常 — 让调用方自己判断
  • 失败不重试 — 一次拿不到, 下一分钟 cron 会再跑
  • 不要 fallback 到 SDK — SDK 永远不通, 走了更糟

关联 reference

  • okx-auto-position/references/forced-skill-entry-okx-trade-2026-07-21.md - 强制 skill 路径入口
  • longbridge-cli/SKILL.md - 长桥 CLI 主文档
  • strategy-management/references/longbridge-cli-pitfalls-2026-07-16.md - CLI 实战踩坑
  • ~/.hermes/scripts/okx_trade.sh - 类似的 OKX 标准入口 (对比参考)