核心功能
futu-trading-bot 是一个专为港股交易设计的 MCP Skill，基于富途牛牛官方 OpenAPI 开发，提供完整的行情查询、账户管理与自动化交易能力。该技能通过封装富途 SDK 的底层接口，使 AI Agent 能够以自然语言方式执行交易操作，无需直接处理复杂的 API 调用细节。
显著优点
官方 API 背书：直接对接富途官方 OpenAPI，数据来源可靠，交易指令直达券商系统，时效性与准确性有保障。
完整功能闭环：覆盖交易全流程——行情订阅（实时报价、K线、逐笔成交）、账户管理（解锁/锁定交易）、订单操作（限价/市价单、改单、撤单、批量撤单）。
连接生命周期管理：自动管理上下文连接，大多数函数执行后自动释放资源，避免内存泄漏；订阅类功能需显式关闭，设计合理。
沙箱兼容性：针对 OpenClaw/Codex 等受限环境提供 preflight_check 预检机制，支持 host/elevated 模式切换，降低部署门槛。
自然语言策略支持：提供策略脚本模板，支持后台长期运行，可通过系统工具（exec、kill）管理进程，实现真正的自动化交易。
潜在局限
市场准入限制：仅支持港股（HK），A股、美股需额外行情权限，默认示例代码以 HK.00700（腾讯）为主。
本地依赖重：必须预先安装并运行富途 OpenD 终端，且需本地文件系统访问权限（日志目录 ~/.com.futunn.FutuOpenD/Log），纯云端或容器化部署受限。
安全责任边界：技能本身不托管策略逻辑，用户需自行生成并审核策略脚本，SIMULATE（模拟）与 REAL（实盘）环境切换依赖人工确认，存在误操作风险。
密码处理敏感：支持 MD5 密码或明文密码（运行时转 MD5），配置文件需妥善保管，虽有 unlock_trade 的交互式输入选项，但安全实践依赖用户自觉。
适合人群
- 已开通富途港股账户、熟悉基础交易逻辑的个人投资者
- 希望用自然语言快速验证/部署量化策略的算法交易爱好者
- 具备 Python 基础、能在本地维护 OpenD 环境的开发者
常规风险
| 风险类别 | 具体说明 |
|---------|---------|
| **实盘误操作** | `TRD_ENV` 参数误设为 `REAL` 可能导致真实资金损失，策略模板虽默认 `SIMULATE`，但修改后无二次确认机制 |
| **连接中断** | OpenD 异常退出或网络波动会导致行情/交易失败，需依赖 `preflight_check` 前置检测 |
| **策略风险** | 后台策略脚本由用户生成，技能仅提供执行框架，策略逻辑错误（如无限循环、极端价位触发）可能造成亏损 |
| **信息泄露** | `config.json` 包含账户敏感信息，需限制文件权限；`account_info.json` 缓存文件同样需保护 |
| **沙箱逃逸** | 受限沙箱可能因日志目录访问失败，需切换至 `host`/`elevated` 模式，权限提升带来潜在安全隐患 |
使用建议
1. 始终先运行 `preflight_check`，确认 OpenD 连通性与环境就绪
2. 实盘前充分测试：利用 SIMULATE 环境验证策略逻辑，确认无误后再切 REAL
3. 策略脚本代码审查：即使由 Agent 生成，也应人工检查关键参数（价格阈值、数量、标的代码）
4. 定期清理订阅：显式调用 close_quote_service() 与 unsubscribe_all()，避免无效连接占用资源
5. 配置分级管理：生产环境使用 MD5 密码，禁止明文存储；配置文件加入 .gitignore，防止意外提交