74 lines
2.5 KiB
Markdown
74 lines
2.5 KiB
Markdown
# Grid Trading
|
||
|
||
本项目是一个本地运行的 Python GUI 网格交易管理工具，第一阶段聚焦 A股/ETF 的账户、标的、手工成交、持仓成本、网格收益和回本价计算。
|
||
|
||
## 第一阶段功能
|
||
|
||
- 创建/编辑本地账户和初始资金。
|
||
- 添加 A股/ETF 标的，维护交易单位。
|
||
- 配置默认网格策略模板。
|
||
- 手动录入、编辑、删除买入/卖出成交。
|
||
- 自动计算持仓数量、T+1 可用数量、持仓成本、已实现盈亏、累计网格利润、持仓回本价、账户回本价。
|
||
- 点击“刷新行情”从腾讯接口获取实时价格，并用实时价更新持仓市值和账户摘要。
|
||
- 根据刷新后的现价和默认网格策略，生成选中标的的网格档位建议。
|
||
- 使用 SQLite 本地保存数据，默认路径为 `data/grid_trading.db`。
|
||
|
||
## 行情说明
|
||
|
||
行情刷新使用腾讯接口：
|
||
|
||
```text
|
||
http://qt.gtimg.cn/q=<symbol>
|
||
```
|
||
|
||
例如 `000001` 会自动转换为 `sz000001`，`600000` 会自动转换为 `sh600000`。
|
||
|
||
实时行情只保存在当前程序内存中，用于显示现价、持仓市值、浮动盈亏、总资产和资金使用率；不会写入 SQLite。成交录入里的价格只作为成交价保存，不会作为现价兜底。关闭软件后再次打开，需要重新点击“刷新行情”。
|
||
|
||
## 网格档位说明
|
||
|
||
选中标的后，底部“网格档位”表会根据腾讯现价和默认策略模板生成建议：
|
||
|
||
- 买入价按 `现价 * (1 - 网格间距)` 逐档向下递减。
|
||
- 卖出价按 `买入价 * (1 + 网格间距)` 计算。
|
||
- 建议买入股数按标的交易单位向下取整。
|
||
- 预计单轮毛利润不扣手续费，生成结果只用于展示，不会写入成交记录或 SQLite。
|
||
|
||
## 待卖网格说明
|
||
|
||
底部“待卖网格”表会展示尚未被网格卖出抵消的网格买入批次，包括买入价、剩余股数、建议卖出价、预计毛利润、当前价和状态。网格卖出按时间顺序 FIFO 抵消最早的网格买入；建议卖出价按 `买入价 * (1 + 网格间距)` 计算。
|
||
|
||
## 开发环境
|
||
|
||
```powershell
|
||
python -m venv .venv
|
||
.\.venv\Scripts\Activate.ps1
|
||
python -m pip install -e ".[dev]"
|
||
pytest
|
||
```
|
||
|
||
## 启动
|
||
|
||
```powershell
|
||
python -m grid_trading.app
|
||
```
|
||
|
||
也可以指定数据库路径：
|
||
|
||
```powershell
|
||
python -m grid_trading.app --db data/dev.db
|
||
```
|
||
|
||
## 验证
|
||
|
||
```powershell
|
||
pytest -v
|
||
python -m grid_trading.app --help
|
||
```
|
||
|
||
如果只想确认 GUI 能构造起来，不打开真实窗口，可以运行测试里的 offscreen smoke：
|
||
|
||
```powershell
|
||
pytest tests/test_ui.py -v
|
||
```
|