a-share-paper-tradinglisted
Install: claude install-skill Serennity007/a-share-skill
# A股模拟盘
独立的模拟盘 skill。交易服务、CLI、账户、撮合与行情适配都在本目录内,不依赖其他 skill 脚本。
## 何时使用
- 启动或检查模拟盘服务
- 创建/重置账户
- 限价买卖、市价买卖、撤单
- 查询账户、持仓、订单、成交
- 验证涨跌停、T+1、收盘过期
- 跑简单回测
## 启动
```bash
SKILL_DIR="<本skill绝对路径>"
python3 "$SKILL_DIR/scripts/paper_trading_service.py" --host 127.0.0.1 --port 18765
```
默认监听 `http://127.0.0.1:18765`,默认数据库不再落在 skill 目录,而是落到用户级数据目录:
- macOS: `~/Library/Application Support/a-share-paper-trading/paper_trading.db`
- Linux: `${XDG_DATA_HOME:-~/.local/share}/a-share-paper-trading/paper_trading.db`
若本机该端口**已有**模拟盘进程在跑,**不要**再启动第二个实例:会报 `Address already in use`,且多进程可能争用同一 SQLite 库文件。启动前可先检查端口是否在监听,例如:
```bash
lsof -iTCP:18765 -sTCP:LISTEN
```
或向 `http://127.0.0.1:18765/accounts` 发 `GET`(CLI 默认 `--base-url` 与此一致)。已有服务时直接用 `paper_trade_cli.py` 即可。
更推荐使用控制脚本常驻运行:
```bash
python3 "$SKILL_DIR/scripts/paper_trading_ctl.py" start
python3 "$SKILL_DIR/scripts/paper_trading_ctl.py" status
python3 "$SKILL_DIR/scripts/paper_trading_ctl.py" stop
```
在 macOS 上,如需持续自启动,可安装 launchd:
```bash
python3 "$SKILL_DIR/scripts/paper_trading_ctl.py" install-launchd
```
服务会:
- 交易时段定时撮合挂单
- 非交易时段停止撮合
- 收盘后让当日未成单过期
- 定时写账户净值快照
可用启动参数:
- `--host`
- `--port`
- `--db-path`
- `--match-interval`
- `--valuation-interval`
- `--idle-valuation-interval`
默认端口与 CLI 基址已改为 `18765`,避免和常见本地开发服务冲突。
## CLI
```bash
python3 "$SKILL_DIR/scripts/paper_trade_cli.py" create-account alpha --cash 500000
python3 "$SKILL_DIR/scripts/paper_trade_cli.py" list-accounts
python3 "$SKILL_DIR/scripts/paper_trade_cli.py"