更新日志¶

这份更新日志面向公开用户，只保留会影响升级判断、接口调用和运行行为的内容。

v1.4.110 · 2026-05-26 — 🔴 架构收敛与交易 / 行情可靠性修复¶

建议所有 v1.4.109 用户升级，尤其是使用真实交易写入、行情订阅 / 摆盘 / 市场状态、REST / MCP / CLI / gRPC 多入口、长跑 daemon 或自动化脚本的用户。

交易写入和读取路径更严格校验后端响应。下单、改单、撤单、复核订单、订单 / 成交刷新、历史订单 / 成交等接口遇到后端缺字段、状态漂移或响应不匹配时，会返回明确错误，不再表现为空成功。
订单 ID、订单 IDEx、改单 / 撤单字段、sim / crypto 账户响应头、最大可交易数量、订单费用和保证金比例等路径继续收口，降低下单后查询、修改或取消不一致的概率。
行情订阅、报价、快照、摆盘、K 线、市场状态和 crypto LV2 等路径按 broker / session / security key 区分 cache 与 push 路由，改善多 broker、多市场和混合订阅下的漏推、旧缓存或摆盘深度差异。
quote-rights / user-info 的展示更接近官方 OpenD GUI：用户信息、额度和行情权限分表展示，香港、美国、A 股、新加坡、日本、加密货币、期货和期权权限项更完整。
futucli quote-rights 和 futucli user-info 在 gateway 未启动、端口错误或连不上时会快速返回结构化错误；json / jsonl 输出可被 agent、CI 和量化脚本稳定解析。
REST / MCP / CLI / Gateway / gRPC 的多个端点开始由共享 surface spec 统一描述参数、scope、默认值和暴露状态，未知字段、非法输入和未开放端点的错误更一致。
used-quota、reconfirm-order、期权链 Greek 过滤和部分账户 / 行情辅助能力在不同入口之间继续归一。
gateway 内部拆分为更清晰的 core / qot / trd 边界，cache、push、broker runtime、重连和启动状态更集中；发版和 pre-push 护栏也补齐了行数、PII、Cargo.lock drift 与 releasegate 检查。
Futu API v10.6.6608 新增接口不包含在本版，将在后续版本单独交付。

v1.4.109 · 2026-05-16 — 🔴 Broker 授权与实盘交易写入修复¶

建议所有 v1.4.108 用户升级，尤其是使用真实交易写入、FTAPI binary 客户端、多券商账户登录或复杂网络环境 broker 授权的用户。

修复实盘下单可能返回旧订单结果的问题。daemon 发往交易后端的请求唯一 ID 现在会按请求重新生成，避免新下单被后端识别为上一笔订单重试。
原生协议客户端的下单、改单、撤单等交易写请求不再因为连接 ID 判定过严而在 daemon 发往后端前被拒绝。
broker 授权恢复为 WebTCP 短连接、服务端下发地址池和 fallback 链路优先，减少普通系统 DNS/HTTPS 路径在部分网络环境下导致的失败。
broker 授权启动时的 rustls provider panic 已修复。
交易写入、订单查询、成交查询和推送路径的订单 ID 处理更一致，降低下单后改单、撤单或查询找不到同一订单的概率。
已结束订单撤单、后端旧订单回声、成功响应缺少关键订单标识等场景会更明确地失败，不再表现为空成功。
真实环境已验证新下单、改单、撤单和对应交易推送 lifecycle。

v1.4.108 · 2026-05-06 — 🔴 行情订阅与账户发现修复¶

建议所有 v1.4.107 用户升级，尤其是使用实时行情订阅、港股期货主连合约、账户列表、App 卡号定位或最大可交易数量接口的用户。

修复新版服务端行情推送帧解码问题，港股期货主连合约和部分实时行情订阅不再在订阅成功后收不到数据。
主连、当月和下月等别名合约的行情推送会路由回用户订阅的 symbol，摆盘、报价和逐笔链路更接近官方 OpenD 行为。
账户发现默认展示更接近 App 可见账户集合，保留 crypto、长期激励等已开通业务账户，同时隐藏 App 不单独展示的内部期货模拟行。
CLI / MCP / REST 对外统一使用用户可见 card_num；JSON 中 acc_id 以字符串返回，避免长账号在 JSON/表格工具中精度损失。
futucli account 按券商与真实/模拟/禁用分段展示，Markets 使用市场名称，降低排障成本。
最大可交易数量接口继续补齐响应投影、Option IM 子请求和部分市场字段差异。
交易、行情和系统 handler 遇到 malformed body 时返回明确错误，不再表现为空成功或无响应。

v1.4.107 · 2026-05-04 — 🔴 资产读取与交易计算修复¶

建议所有 v1.4.106 用户升级，尤其是使用资金、持仓、现金流水、模拟账户、综合账户或交易计算接口的用户。

模拟账户的资金、持仓、订单和成交刷新会走模拟账户路径，不再误触发真实账户查询。
资金和持仓刷新更严格按账户、币种和资产类别区分；后端刷新失败或冷缓存已有同账号请求在途时，会返回明确错误而不是空成功。
现金流水、现金明细、业务分组、保证金信息、账户标志和债券接口统一从已鉴权账户派生后端账号与市场，无法派生时会明确失败。
历史订单、历史成交、订单刷新、成交刷新、订单费用、保证金比例和最大可交易数量接口补齐市场、证券和通道校验，真实账户缺少目标通道时不再回退。
MCP / CLI 的现金流水、现金明细、账户标志和债券输出补齐更多用户可见字段，减少不同入口之间的差异。
解锁交易 cooldown 只统计交易密码错误；gRPC 交易请求支持幂等键 metadata。

从 v1.4.99 之前直接升级注意：综合账户和期货账户调用 /api/funds 时必须显式传 currency（整数 1=HKD / 2=USD / 3=CNH / 4=JPY / 5=SGD / 6=AUD / 7=CAD / 8=MYR），不传会返 MissingCurrency 错误。该行为自 v1.4.106 起生效，旧版（≤ v1.4.99）的"不传也返回数值但币种 tag 错位"是已修复的 bug，请补传 currency 整数迁移。详见 REST API 文档。

v1.4.106 · 2026-05-02 — 🔴 资金查询与账户隔离修复¶

建议所有 v1.4.105 用户升级，尤其是使用资金查询、模拟账户、综合账户或受限 API key 的用户。

修复 /api/funds 的币种校验：单市场账户和模拟账户按账户原生币种返回，综合账户和期货账户继续严格校验请求币种。
修复资金快照缓存维度：同一账户的不同币种和资产类别不会互相覆盖，刷新失败会返回明确错误。
统一 REST / MCP / CLI / SDK 对 cash 的说明：它表示响应币种下的汇总现金，不是跨币种明细求和。
配置账户白名单后，交易写入接口不会通过 card_num 后缀解析泄露其他账户是否存在。
futucli funds 的 --market 变为可选；如请求币种与返回币种不同，会在 stderr 给出提示。

v1.4.105 · 2026-04-30 — 🔴 下单可靠性、资金币种和推送过滤修复¶

建议所有 v1.4.104 用户升级。

下单接口等待交易确认后再向客户端暴露订单，并加入短时间重复提交保护，降低重试导致的误下单风险。
/api/funds 对不支持的币种返回结构化 InvalidCurrency 错误，并列出该账户支持的币种。
多市场综合账户识别更稳健，避免账户元数据漂移时误降级为单币种账户。
/api/static-info 拒绝显式空列表输入，避免误触发大范围查询。
REST WebSocket、原生 TCP、gRPC 和 MCP 的交易推送统一执行账户和市场白名单过滤。
解锁交易、gRPC 权限错误和资金币种错误的客户端提示已脱敏。

v1.4.104 · 2026-04-29 — 🔴 鉴权入口统一与安全修复¶

所有 v1.4.103 用户都应升级。

配置 API key 后，原生 TCP 监听默认关闭未鉴权访问；需要兼容旧客户端时可显式开启。
修复 allowed_card_nums 未展开时被视为无限制的问题。
解锁交易的 cooldown 覆盖所有券商路径，减少连续失败导致账户被锁的风险。
登录失败会返回更清晰的错误码和提示，同时避免泄露凭据内容。
REST 订阅请求必须显式传入订阅/取消订阅标志，错误 ticker 不再返回空成功。
REST、CLI、MCP 的资金币种警告和常见错误提示更一致。

v1.4.103 · 2026-04-29 — 🔴 重复下单、账户隔离和综合账户币种修复¶

实盘下单、受限 API key 或综合账户用户必须升级。

修复订单状态导致客户端误判失败并重试的重复下单风险。
受限 API key 在 REST、gRPC、MCP 和原生协议入口统一执行账户隔离。
综合账户资金查询支持显式 --currency，返回数据和币种标签保持一致。
card_num 可直接写入 key 配置，便于按账户卡号后缀授权。
MCP HTTP 模式按每次请求的 Bearer token 解析调用者，不再回退到启动默认 key。

v1.4.102 · 2026-04-28 — 🔴 短信、订阅和本地文件权限修复¶

多用户机器、长跑 daemon 和自动化策略用户建议升级。

修复 last_close_price 缩放错误。
/api/subscribe 对无效或空证券代码改为整批拒绝，不再空成功。
长跑 daemon 会复用仍有效的短信凭据，避免重发短信覆盖用户刚输入的验证码。
凭据和设备文件在 Unix 上自动收紧到 0600。
缺少 trd_env、配置文件写错 section、keys 文件解析失败等场景改为明确报错。
/api/unsub-acc-push 现在真正取消订阅。

v1.4.101 · 2026-04-28 — 🟢 期权链和日期边界修复¶

此版本主要修复期权链、到期日和市场时区边界问题。已在 v1.4.100 且不使用相关接口的用户可按需升级。

期权到期日查询支持默认日期区间，并按市场时区处理日期边界。
期权权限、到期日缺失和未知枚举值处理更严格。
时区处理逻辑去重，避免不同接口对同一市场给出不同日期解释。

v1.4.100 · 2026-04-28 — 🟡 期权链和期权行情修复¶

使用期权链、期权快照或期权订阅的用户建议升级。

期权链默认查询、日期去重、期权标的市场识别和希腊值过滤行为修复。
期权快照补齐波动率、Greeks、到期日等字段。
期权订阅 fallback、合约静态信息和 CLI JSON 输出更一致。
多个行情端点对无效输入改为明确拒绝。

v1.4.99 · 2026-04-27 — 🟢 输入校验和输出格式修复¶

ticker-statistic、利率、价差表等接口对错误响应和未知字段处理更严格。
CLI 的 JSONL 输出更稳定，避免表格输出误混入机器读取场景。
对用户行为影响较小，主要提升错误可见性。

v1.4.98 · 2026-04-27 — 🟡 新查询接口和多项反馈修复¶

需要更多行情和账户字段的用户建议升级。

新增或补齐 token 状态、价差表、风险利率和若干行情字段。
修复期权链路由、默认日期范围、CLI JSON 输出和 MCP 状态字段。
REST 对多个行情路径采用更严格的输入校验，避免静默忽略参数。

v1.4.97 · 2026-04-27 — 🟡 账户识别和长跑观测改进¶

加密账户的资金、持仓、成交、订单和现金流水接口不再静默返回空结果。
/api/accounts 增加账户标签，便于区分普通现金账户和加密账户。
长跑 daemon 增加更清晰的重连、冷却和健康观测信息。
若只使用普通股票/期权查询，可按需升级。

v1.4.96 · 2026-04-26 — 🔴 期权链、订单和行情热修复¶

使用期权、订单查询或 K 线接口的用户应升级。

期权链默认查询不再返回空结果，缺失日期时会使用安全默认范围。
订单、改单、撤单和订单查询的多账户场景更可靠。
美股、港股和期货相关行情状态、K 线日期和错误提示修复。
CLI kline --count 默认结束时间改为当前时间。

v1.4.95 · 2026-04-26 — 🟡 新增账户、保证金和债券查询¶

需要高级账户信息或债券查询的用户建议升级。

新增保证金信息、账户标志、债券总资产、单只债券资产、债券持仓、问卷状态和交易提醒等查询能力。
REST、MCP、CLI 和 gRPC 对新增接口保持一致命名和错误处理。
新接口在服务端不支持时会明确报错，不做静默 fallback。

v1.4.94 · 2026-04-26 — 🟡 登录保持和移动端能力补齐¶

长跑 daemon 的登录保活、签名刷新和凭据保存更稳健。
资金流水、持仓成本、期权 Greeks 和行情权限字段更完整。
新增的主动刷新能力默认关闭，用户可按环境变量 opt in。

v1.4.93 · 2026-04-26 — 🔴 交易、行情和长跑稳定性修复¶

建议所有使用 v1.4.90-v1.4.92 的用户升级。

修复订单可见性、历史订单覆盖、行情状态和 K 线订阅等多项问题。
长跑 broker 授权过期后可自动重取授权，减少必须手动重启的情况。
历史成交和空数据错误提示更准确。
新增多版本回归检查，降低旧接口再次漂移的风险。

v1.4.92 · 2026-04-25 — 🟡 自动重连和回归检查¶

daemon 检测行情登录失效后可触发进程内重连，减少长跑中断。
增加多版本行为检查，帮助发现已发布版本之间的兼容漂移。
清理旧文档索引，降低用户查阅时的噪声。

v1.4.91 · 2026-04-25 — 🟡 重连链路补齐和错误提示优化¶

补齐行情重连触发链路，长期运行时更容易自动恢复。
市场状态、历史 K 线和交易查询错误提示更准确。
维护版，API 形状基本不变。

v1.4.90 · 2026-04-25 — 🔴 v1.4.86-v1.4.89 回归热修复¶

建议使用 v1.4.86-v1.4.89 的用户升级。

修复订单缓存、K 线订阅、行情市场识别和交易查询多处回归。
账户级错误冷却避免单个失败账户持续刷屏。
REST 与原生协议路径在历史 K 线和行情市场选择上更一致。

v1.4.89 · 2026-04-25 — 🟢 市场识别和测试覆盖提升¶

市场 ID 识别改为优先使用缓存中的服务端枚举，减少对代码前缀的猜测。
新增大量接口级测试和基准，降低行情/交易路由漂移风险。
用户可见变化较少，已在 v1.4.88 的用户可按需升级。

v1.4.88 · 2026-04-25 — 🟢 代码质量维护版¶

补充 API 注释、错误提示和测试覆盖。
支持 /api/history-kline 的单值证券代码简写。
无重大用户行为变化。

v1.4.87 · 2026-04-25 — 🟢 审计日志和时区参数改进¶

审计日志文件权限默认收紧。
CLI 新增 --tz，方便按指定时区查看时间。
在临时目录写日志时会提示用户改用更合适的位置。

v1.4.86 · 2026-04-24 — 🟡 REST legacy 写接口收紧¶

使用 REST 写交易接口且未配置 API key 的用户需要注意。

未配置 keys 文件时，REST 下单、改单、撤单、解锁等写接口默认拒绝。
只读行情和账户查询不受影响。
新增更明确的错误提示，引导用户配置 key 后再开放写接口。

v1.4.85 · 2026-04-24 — 🟢 公开 API 文档完善¶

REST、gRPC 和 MCP 参考文档补齐并统一示例。
下载页、快速开始和常用指南更新。
纯文档版本，已在 v1.4.84 的用户可跳过。

v1.4.84 · 2026-04-24 — 🔴 安全修复和兼容迁移¶

建议所有 v1.4.83 用户升级。

REST 写接口在未配置 key 时默认拒绝，避免本机其他进程误触发交易写入。
MCP 参数别名和响应结构兼容性补齐。
配额、错误枚举和监控指标更完整。
提供迁移说明，帮助用户从旧 key 配置平滑升级。

v1.4.83 · 2026-04-24 — 🟡 查询修复和推送自愈¶

持仓、资金和 K 线接口在边界输入下更稳。
交易推送链路缺少数据时会主动刷新相关缓存。
CLI 与 MCP 的参数别名更一致。

v1.4.82 · 2026-04-24 — 🔴 订阅和下单缓存修复¶

REST 订阅请求对缺失字段和无效参数改为明确报错。
下单后的订单缓存不会被之后的空响应覆盖。
多个历史查询接口对错误参数不再静默成功。

v1.4.81 · 2026-04-24 — 🔴 首次短信登录修复¶

首次登录或重新授权需要短信验证的用户应升级。

首次短信验证后的登录状态可正确保存。
重启后不再因为未保存的授权状态反复触发短信。
凭据保存和加载路径在空状态下更稳健。

v1.4.80 · 2026-04-24 — 🔄 结构维护版¶

推送解析、handler 依赖注入和协议转换器继续模块化。
无用户可见 API 变化，已在 v1.4.79 的用户可跳过。

v1.4.79 · 2026-04-24 — 🔄 架构维护版¶

交易和行情 handler 继续拆分，降低之后改动的风险。
持久化 schema 迁移链路更清晰。
无用户可见 API 变化。

v1.4.78 · 2026-04-24 — 🔄 解析器和大文件拆分¶

推送解析器补充更多异常输入处理。
大文件继续拆分，减少维护风险。
用户可见行为基本不变。

v1.4.77 · 2026-04-23 — 🔄 依赖注入和 pre-push 检查¶

交易 handler 继续瘦身，更多逻辑迁入独立模块。
本地检查脚本更严格，减少发版前遗漏。
无用户可见 API 变化。

v1.4.76 · 2026-04-23 — 🟢 短信时序提示和账户流水审计¶

短信验证相关提示更清晰。
账户现金流水在部分边界条件下的错误提示更准确。
维护版，普通用户可按需升级。

v1.4.75 · 2026-04-23 — 🟡 首次短信登录改进¶

改进首次登录后授权状态保存，减少重复短信验证。
凭据缺失或损坏时返回更清楚的提示。
建议仍遇到短信循环的用户升级。

v1.4.74 · 2026-04-23 — 🟡 账户和历史查询收尾修复¶

加密账户、历史订单、历史成交和 K 线日期等场景的错误处理更准确。
REST 扁平参数和 SDK 风格字段兼容性增强。
对已有 v1.4.73 用户属于推荐升级。

v1.4.73 · 2026-04-23 — 🔴 多项交易和凭据修复¶

建议所有 v1.4.72 用户升级。

修复 trade unlock、条件单、改单、历史查询和凭据保存的多个严重问题。
历史订单/成交的分页和筛选更稳。
市场状态和期货相关查询更准确。

v1.4.72 · 2026-04-23 — 🔴 历史查询和 REST 兼容修复¶

历史 K 线、历史订单和成交查询支持更多 SDK 风格输入。
日期和时区处理按市场本地时间返回。
REST 错误提示更具体，避免误导用户补不存在的字段。

v1.4.71 · 2026-04-23 — 🔴 港股期货状态、订单状态和 TLS 修复¶

港股期货市场状态和订单状态映射修复。
历史订单/成交日期转换按市场时区处理。
HTTPS 客户端配置收紧，避免不安全证书设置进入生产路径。

v1.4.70 · 2026-04-23 — 🔴 凭据回归和历史成交状态修复¶

修复凭据保存/加载回归。
历史成交状态字段更准确。
建议已升级 v1.4.68 或 v1.4.69 的用户升级。

v1.4.69 · 2026-04-23 — 🔄 代码重构¶

结构调整，用户可见行为基本不变。
已在 v1.4.68 的用户可跳过。

v1.4.68 · 2026-04-23 — 🔴 资金币种和多市场时区修复¶

单市场账户资金查询返回账户原生币种，避免误标为请求币种。
美股、日股、澳股和加拿大市场的历史查询时区修复。
期货和期权的市场识别更准确。

v1.4.67 · 2026-04-23 — 🔴 历史查询和市场识别修复¶

历史订单、历史成交和 K 线在多市场账户下更可靠。
期货市场 ID 和交易市场推断更准确。
相关用户建议升级。

v1.4.66 · 2026-04-23 — 🔴 历史订单筛选修复¶

/api/history-orders 和 /api/history-order-fills 的市场筛选修复。
解决部分账户查询不到历史数据的问题。

v1.4.65 · 2026-04-23 — 🔄 测试基础设施维护版¶

增强 gateway 集成测试基础设施。
无用户可见行为变化，已在 v1.4.64 的用户可跳过。

v1.4.64 · 2026-04-22 — 🔴 2FA 账户查询修复¶

2FA 账户的资金、持仓和现金流水查询改用正确账户路由。
相关接口不再因路由不完整返回空结果或错误。

v1.4.63 · 2026-04-22 — 🔄 维护重构¶

完成一批 handler 模块化和依赖整理。
无用户可见 API 变化。

v1.4.62 · 2026-04-22 — 🔄 行情 handler 拆分¶

行情相关 handler 开始模块化拆分。
无用户可见 API 变化。

v1.4.61 · 2026-04-22 — 🔄 交易 handler 拆分¶

交易 handler 继续模块化。
无用户可见 API 变化。

v1.4.60 · 2026-04-22 — 🔄 handler 模块化启动¶

大型 handler 文件开始拆分。
无用户可见 API 变化。

v1.4.59 · 2026-04-22 — 🔄 市场路由精度提升¶

市场路由优先使用账户缓存中的市场信息，减少新代码前缀带来的误判。
用户可见变化较少，已在 v1.4.58 的用户可按需升级。

v1.4.58 · 2026-04-22 — ✨ MCP 推送、幂等和错误语义统一¶

MCP 支持订单/成交实时推送，减少轮询。
REST、CLI 和 MCP 写交易接口支持幂等键，降低网络重试导致重复提交的风险。
MCP 错误响应语义统一，客户端更容易区分业务错误和工具错误。

v1.4.57 · 2026-04-22 — 🔴 多项账户、行情和交易修复¶

修复多账户、多券商和部分行情查询中的路由问题。
SMS 验证可通过一次性 callback 提供，适合自动化环境。
订单、资金、持仓、现金流水和历史查询的错误提示更清晰。

v1.4.56 · 2026-04-21 — 🔴 美股期货路由修复¶

美股期货下单和查询路由修复。
建议使用期货相关功能的用户升级。

v1.4.55 · 2026-04-21 — 🔴 期货市场和成交修复¶

期货 exchange_str、市场状态和多市场查询修复。
港股和美股期货相关用户建议升级。

v1.4.54 · 2026-04-21 — 🔴 港股期货下单修复¶

港股期货下单路由修复。
使用港股期货交易的用户应升级。

v1.4.53 · 2026-04-21 — 🟡 模拟交易、条件单和期权代码转换¶

模拟账户的持仓、资金和最大可交易数量查询修复。
新增条件单能力。
期权代码支持 Futu 和 OCC 格式互转。

v1.4.52 · 2026-04-21 — 🟡 验收问题收尾和检查脚本增强¶

修复模拟账户、REST 错误提示和部分输入校验问题。
发布前检查脚本更严格。
已在 v1.4.51 且不受这些问题影响的用户可按需升级。

v1.4.51 · 2026-04-21 — 🔴 `US.AAPL` 格式下单修复¶

从官方 SDK 迁移或使用 MCP agent 下单的用户应升级。

REST、CLI、MCP 和原生入口接受带市场前缀的证券代码下单。
无效 trd_env、不存在账户和空列表等输入返回更明确的错误。

v1.4.50 · 2026-04-21 — 🔄 市场 ID 覆盖和检查增强¶

扩展市场 ID 覆盖范围。
增加本地检查，避免未来新增市场遗漏。
用户可见行为基本不变。

v1.4.49 · 2026-04-21 — 🔄 架构债清理¶

清理不再使用的交易解锁兼容代码。
发布流程自动化增强。
已在 v1.4.48 的用户可跳过。

v1.4.48 · 2026-04-21 — 🔴 券商路由修复¶

交易查询和写入路由改为按账户所属券商选择。
修复多券商账户在跨市场交易时可能选错路径的问题。

v1.4.47 · 2026-04-21 — 🔴 券商路由和全局状态修复¶

修复多券商账户交易路由问题。
/api/global-state 的市场状态更准确。
多账户、多市场用户建议升级。

v1.4.46 · 2026-04-20 — 🟢 查询防御和期权字段补齐¶

缓存读取接口对非法输入返回错误，不再把非法输入伪装成空数据。
期权快照补齐更多字段。

v1.4.45 · 2026-04-20 — 🔴 REST 字段名兼容修复¶

REST 请求兼容官方 SDK 风格的 camelCase 字段名。
历史订单和历史成交接口不再因字段名不匹配静默使用默认值。

v1.4.44 · 2026-04-20 — 🔴 协议字段完整性修复¶

多个订单、持仓、资金、成交和行情响应补齐字段。
客户端看到的响应结构更接近官方 SDK。
建议依赖完整字段的用户升级。

v1.4.43 · 2026-04-20 — 🔴 历史订单和历史成交修复¶

多市场授权账户的历史订单/成交查询带上正确市场筛选。
严格权限账户不再返回空历史数据。

v1.4.42 · 2026-04-20 — 🟢 期权持仓字段和小修¶

期权持仓增加 DTE 字段。
补齐若干历史反馈中的非阻断问题。

v1.4.41 · 2026-04-20 — 🔴 全量回归修复¶

修复下单、条件单、账户隔离、历史查询和行情提示中的多项问题。
建议 v1.4.39-v1.4.40 用户升级。

v1.4.40 · 2026-04-20 — 🟡 指数别名和二次确认接口¶

港股指数 ticker 别名可用于行情查询。
新增 /api/reconfirm-order。
市场参数和错误提示更清晰。

v1.4.39 · 2026-04-20 — 🔴 期权和历史查询热修复¶

期权链、历史订单、历史成交和最大可交易数量查询修复。
CLI 和 MCP 写交易接口补齐幂等参数。

v1.4.38 · 2026-04-20 — 🔴 期权能力、幂等和实时推送¶

期权链、期权快照和历史查询能力可用于 2FA 账户。
REST、CLI、MCP 和原生入口支持订单幂等保护。
MCP 增加订单/成交实时推送。

v1.4.37 · 2026-04-19 — 🟢 UX polish¶

CLI、文档和错误提示小幅优化。
零风险维护版，已在 v1.4.36 的用户可跳过。

v1.4.36 · 2026-04-19 — 🛠 白名单和非交易时段提示修复¶

账户白名单拒绝返回 403，避免被客户端误判为限流。
非交易时段提示按实际市场生成。
修复资金查询白名单绕过问题。

v1.4.35 · 2026-04-19 — 🏷️ 市场关闭提示和 API key 账户白名单¶

futucli gen-key 支持限制 key 可访问的账户、市场和证券。
下单失败时增加更清晰的市场关闭提示。
适合多 agent 或共享 daemon 场景。

v1.4.34 · 2026-04-19 — 🔴 2FA 下单修复¶

修复 2FA 账户解锁后仍无法下单的问题。
改善 moomoo token 和解锁失败提示。
REST、CLI、gRPC 和 MCP 的错误码展示更一致。

v1.4.33 · 2026-04-19 — 按券商解锁交易¶

unlock-trade 可按券商过滤，只解锁目标市场账户。
隐藏或异常子账户不再阻塞其他券商账户。

v1.4.32 · 2026-04-18 — daemon 管理命令¶

新增状态、重载和关闭相关管理命令。
管理端点在安全模式下给出明确提醒。

v1.4.31 · 2026-04-18 — 🔴 交易解锁重构¶

交易解锁改为按券商分组并行执行。
单个失败子账户不再拖垮其他账户。
解锁响应返回每个账户的成功/失败原因。

v1.4.30 · 2026-04-18 — 🎯 官方 Python SDK 能力覆盖¶

REST、CLI 和 MCP 补齐官方 Python SDK 的主要用户向接口。
新增现金流水、资金流向、K 线、期权链、最大可交易数量等查询能力。
文档和示例同步更新。

v1.4.29 · 2026-04-18¶

修复模拟账户资金查询。
增加 /readyz 健康检查。
启动日志更安静。

v1.4.28 · 2026-04-18¶

进一步修复模拟账户和交易错误提示。
更新运行时依赖和文档。

v1.4.27 · 2026-04-18¶

账户列表、持仓和订单查询改为更稳定的账户路由。
CLI 账户表格展示更多关键信息。
MCP 增加若干行情和交易工具。

v1.4.26 · 2026-04-17¶

修复 broker 连接地址选择导致的账户列表缺失问题。
broker 地址改为优先使用服务端下发配置。
多平台账户登录和账户查询更稳定。

v1.4.25 · 2026-04-17¶

broker 列表变化时自动刷新有效列表。
setup-only 模式更快。
服务端时间校正和连接配置处理更稳。

v1.4.24 · 2026-04-17¶

修复海外账户连接识别问题。
登录配置可兼容更多返回格式。
错误提示更清楚。

v1.4.23 · 2026-04-17¶

动态连接配置优先级提升。
一次性密码和登录签名处理更稳。
启动连接成功率提升。

v1.4.22 · 2026-04-17¶

平台连接地址支持域名解析 fallback。
CLI 支持安全保存登录密码。
登录命令的错误提示优化。

v1.4.21 · 2026-04-17¶

设备 ID 生命周期重构。
登录失败后的恢复路径更可靠。
适合需要长期运行的 daemon 用户。

v1.4.20 · 2026-04-17¶

登录链路补齐多项边界处理。
连接重试和错误提示更稳。

v1.4.19 · 2026-04-17¶

继续修复登录、连接和账户发现问题。
用户可见 API 基本不变。

v1.4.18 · 2026-04-17¶

CLI 和配置示例更新。
登录与启动体验小幅优化。

v1.4.17 · 2026-04-17¶

登录稳定性继续增强。
适合遇到短信或设备验证问题的用户升级。

v1.4.11-v1.4.16 · 2026-04-17（登录稳定性专项）¶

连续修复登录管线、平台选择、设备标识、短信验证和连接重试问题。
新增 --platform <futunn|moomoo> 以区分同一手机号在不同平台下的账户。
海外账户不再误连不合适的连接池。

v1.4.10 · 2026-04-16¶

账户列表、持仓和订单查询走更稳定的账户通道。
登录后账户数据更完整。

v1.4.8-v1.4.9 · 2026-04-16¶

早期登录和连接稳定性修复。
为之后的账户、行情和交易接口补齐打基础。

v1.0-v1.4.7¶

这些版本主要是维护重构和协议对齐。若从早期版本升级，建议直接使用最新版。