Grid_Trading/README.md

Grid Trading

本项目是一个本地运行的 Python GUI 网格交易管理工具，第一阶段聚焦 A股/ETF 的账户、标的、手工成交、持仓成本、网格收益和回本价计算。

第一阶段功能

• 创建/编辑本地账户和初始资金。
• 添加 A股/ETF 标的，维护交易单位。
• 配置默认网格策略模板。
• 手动录入、编辑、删除买入/卖出成交。
• 自动计算持仓数量、T+1 可用数量、持仓成本、已实现盈亏、累计网格利润、持仓回本价、账户回本价。
• 点击“刷新行情”从腾讯接口获取实时价格，并用实时价更新持仓市值和账户摘要。
• 根据刷新后的现价和默认网格策略，生成选中标的的网格档位建议。
• 使用 SQLite 本地保存数据，默认路径为 data/grid_trading.db。

行情说明

行情刷新使用腾讯接口：

http://qt.gtimg.cn/q=<symbol>

例如 000001 会自动转换为 sz000001，600000 会自动转换为 sh600000。

实时行情只保存在当前程序内存中，用于显示现价、持仓市值、浮动盈亏、总资产和资金使用率；不会写入 SQLite。成交录入里的价格只作为成交价保存，不会作为现价兜底。关闭软件后再次打开，需要重新点击“刷新行情”。

网格档位说明

选中标的后，底部“网格档位”表会根据腾讯现价和默认策略模板生成建议：

• 买入价按 现价 * (1 - 网格间距) 逐档向下递减。
• 卖出价按 买入价 * (1 + 网格间距) 计算。
• 建议买入股数按标的交易单位向下取整。
• 预计单轮毛利润不扣手续费，生成结果只用于展示，不会写入成交记录或 SQLite。

待卖网格说明

底部“待卖网格”表会展示尚未被网格卖出抵消的网格买入批次，包括买入价、剩余股数、建议卖出价、预计毛利润、当前价和状态。网格卖出按时间顺序 FIFO 抵消最早的网格买入；建议卖出价按 买入价 * (1 + 网格间距) 计算。

开发环境

python -m venv .venv
.\.venv\Scripts\Activate.ps1
python -m pip install -e ".[dev]"
pytest

启动

python -m grid_trading.app

也可以指定数据库路径：

python -m grid_trading.app --db data/dev.db

验证

pytest -v
python -m grid_trading.app --help

如果只想确认 GUI 能构造起来，不打开真实窗口，可以运行测试里的 offscreen smoke：

pytest tests/test_ui.py -v