From 6e73e90f99b7b436785038a96a1dc416ff90cb41 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E7=8E=8B=E9=B9=8F?= <wangpengv@yonyou.com>
Date: Wed, 8 Jul 2026 17:34:29 +0800
Subject: [PATCH] docs: add phase one usage guide

---
 README.md | 28 ++++++++++++++++++++++++++++
 1 file changed, 28 insertions(+)

diff --git a/README.md b/README.md
index 49c6255..4d43c5b 100644
--- a/README.md
+++ b/README.md
@@ -2,6 +2,15 @@
 
 本项目是一个本地运行的 Python GUI 网格交易管理工具，第一阶段聚焦 A股/ETF 的账户、标的、手工成交、持仓成本、网格收益和回本价计算。
 
+## 第一阶段功能
+
+- 创建/编辑本地账户和初始资金。
+- 添加 A股/ETF 标的，维护交易单位和手动估值价格。
+- 配置默认网格策略模板。
+- 手动录入、编辑、删除买入/卖出成交。
+- 自动计算持仓数量、T+1 可用数量、持仓成本、已实现盈亏、累计网格利润、持仓回本价、账户回本价。
+- 使用 SQLite 本地保存数据，默认路径为 `data/grid_trading.db`。
+
 ## 开发环境
 
 ```powershell
@@ -16,3 +25,22 @@ 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
+```