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
- 统一使用虚拟环境内的绝对路径解释器执行所有脚本