From dfbafd5ad44b178c993ada85d4f4ed4f7362bd96 Mon Sep 17 00:00:00 2001
From: Justin Gu <97915@qq.com>
Date: Mon, 6 Jul 2026 01:49:49 +0800
Subject: [PATCH] =?UTF-8?q?docs(readme):=20=E8=A1=A5=E5=85=85=E6=8B=BC?=
 =?UTF-8?q?=E9=9F=B3=E5=A3=B0=E6=AF=8D=E6=90=9C=E7=B4=A2=E7=9A=84=E5=8D=87?=
 =?UTF-8?q?=E7=BA=A7=E6=8F=90=E7=A4=BA=EF=BC=88v1.19.0=20=E9=9C=80?=
 =?UTF-8?q?=E9=87=8D=E8=A3=85=20[web]=20extra=EF=BC=89?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- 前置条件代码块注释加 pypinyin
- 新增 ⚠️ 升级注意：旧版本升级必须重跑 pip install -e ".[web]" 否则搜索端点 500
- 单标的回测取行情描述补上拼音声母搜索能力说明
---
 README.md | 6 ++++--
 1 file changed, 4 insertions(+), 2 deletions(-)

diff --git a/README.md b/README.md
index 914b135..5f3c660 100644
--- a/README.md
+++ b/README.md
@@ -451,13 +451,15 @@ easy-tdx portfolio --stocks SZ:000001,SH:600519 \
 **前置条件：**
 
 ```bash
-# 后端需安装 web 可选依赖（FastAPI + Uvicorn）
+# 后端需安装 web 可选依赖（FastAPI + Uvicorn + pypinyin）
 pip install -e ".[web]"
 
 # 前端需 Node.js 18+（首次运行需装依赖）
 cd web-ui && npm install
 ```
 
+> ⚠️ **升级注意（v1.19.0+）**：股票代码输入框的**拼音声母搜索**（如输 `zjxc` 命中中际旭创）依赖 `pypinyin`，已包含在 `[web]` extra 里。**从旧版本升级时必须重新运行 `pip install -e ".[web]"`**，否则搜索端点会报 500（其他功能不受影响，只是代码输入框退化为只能输 6 位数字）。
+
 **启动（两个终端）：**
 
 ```bash
@@ -477,7 +479,7 @@ cd web-ui && npm run dev
 
 左侧配置面板从上到下填写，右侧自动出图：
 
-- **取行情**：选市场（深/沪/北），填 6 位代码，选周期（日线/周线/分钟线），设日期范围（默认最近 3 年），点「取行情」。超过 800 根会自动翻页拼接
+- **取行情**：填 6 位代码，选周期（日线/周线/分钟线），设日期范围（默认最近 3 年），点「取行情」。超过 800 根会自动翻页拼接。代码输入框支持**拼音声母搜索**（v1.19.0+）：输 `zjxc` 命中中际旭创、输 `gzmt` 命中贵州茅台、输中文名片段也行，下拉联想 + 键盘 ↑↓/Enter 选择
 - **选策略**：下拉选 18 个内置策略之一（双均线交叉、MACD、布林带、RSI、KDJ、唐安奇通道、CCI 等），选中后参数表单自动出现，按推荐范围调参
 - **资金与成本**：初始资金、佣金率、滑点、成交模式（默认 next_open 下一根开盘成交）
 - 点「开始回测」，右侧依次出：K 线主图（红三角=买入、绿钉=卖出）、净值曲线与回撤双轴图、19 项绩效指标表（总收益/夏普/最大回撤/胜率/盈亏比等）、成交记录明细