openclaw/fosun-skills

复星财富 OpenAPI 技能集

本目录包含与复星财富 OpenAPI 相关的所有技能，统一管理港股、美股、A 股（港股通）的 SDK 配置与交易操作。

---

子技能一览

1. fosun-sdk-setup — SDK 初始化与凭证管理

路径: fosun-sdk-setup/SKILL.md

用途: 安装、验证和配置 Fosun OpenAPI SDK（fsopenapi），通过 fosun.env 管理 API 凭证。

核心功能:

• SDK 安装: 检测并安装 fsopenapi 到 .venv-fosun 虚拟环境（支持本地源码或 GitHub 下载）
• 开通引导: 首次使用时引导用户生成客户端密钥对、获取出口 IP、申请 API 权限
• 凭证管理: 通过对话交互式收集并写入 fosun.env（含服务端公钥、客户端私钥、API Key）
• 凭证更新: 支持切换账号、更换 API Key、鉴权失败时重新配置

适用场景: 首次设置 SDK、修复安装/导入/鉴权问题、轮换 API Key 或切换账号、其他 fosun-* 技能的前置依赖。

---

2. fosun-trading — 证券交易工具集

路径: fosun-trading/SKILL.md

用途: 通过命令行脚本完成行情查询、资金管理和交易操作。

核心功能:

| 功能 | 脚本 | 说明 | |------|------|------| | 行情查询 | query_price.py | 报价、盘口、K线、分时、逐笔成交、经纪商队列 | | 买卖信息查询 | query_bidask.py | 每手股数(lotSize)、可买/可卖数量、购买力 | | 资金/持仓查询 | query_funds.py | 资金汇总、持仓列表、账户列表 | | 资金流水查询 | query_cashflows.py | 按日期/类型查询资金进出明细 | | 下单 | place_order.py | 限价/增强限价/特别限价/竞价/市价单 | | 订单查询 | list_orders.py | 按状态/日期/方向/市场筛选订单 | | 撤单 | cancel_order.py | 撤销未成交订单 |

适用场景: 查询股票行情、查看账户余额与持仓、查询资金流水、买卖股票、管理订单。

---

支持的市场

| 市场代码 | 说明 | 行情级别 | 币种 | |----------|------|----------|------| | hk | 港股 | L2（含盘口、经纪商队列） | HKD | | us | 美股 | L1（盘前/盘中/盘后） | USD | | sh | 上交所（港股通） | L1 | CNH | | sz | 深交所（港股通） | L1 | CNH |

标的代码格式: 市场代码 + 股票代码，如 hk00700（腾讯）、usAAPL（苹果）、sh600519（茅台）、sz000001（平安银行）。

---

环境要求

• Python 虚拟环境: {workspace_root}/.venv-fosun
• 凭证文件: {workspace_root}/fosun.env
• 禁止擅自创建新虚拟环境或使用系统 Python
• 统一使用虚拟环境内的绝对路径解释器执行所有脚本