feat: bootstrap personal stock agent

README.md

@@ -0,0 +1,46 @@
+# Personal Stock Agent
+
+统一个人股票监控 MVP，支持 A股、港股、美股自选股，按日生成监控报告。数据接口固定使用 IPADS Responses API，密钥从 `.env` 的 `IPADS_API_KEY` 读取。
+
+## Run
+
+```bash
+npm install
+npm run dev
+```
+
+Frontend: http://127.0.0.1:5173
+
+Backend: http://127.0.0.1:8787
+
+## IPADS API
+
+配置文件：
+
+```env
+IPADS_API_KEY=your_api_key
+```
+
+固定服务端配置：
+
+```text
+base_url = "http://tianx.ipads-lab.se.sjtu.edu.cn:8319/v1"
+wire_api = "responses"
+env_key = "IPADS_API_KEY"
+```
+
+The backend calls:
+
+```text
+POST http://tianx.ipads-lab.se.sjtu.edu.cn:8319/v1/responses
+Authorization: Bearer ${IPADS_API_KEY}
+```
+
+The response output text must be JSON matching the stock snapshot schema used by the agent. If `IPADS_API_KEY` is blank, the app uses deterministic demo data so the dashboard remains usable.
+
+## Features
+
+- Add/remove watchlist symbols such as `600519`, `000001.SZ`, `00700.HK`, `AAPL`, `MSFT.US`.
+- Normalize symbols into A股、港股、美股 markets.
+- Generate a daily report with earnings timing, peer stocks, valuation discount/premium, related news, and buy-watch/hold/avoid recommendations.
+- Refreshes the cached daily report every 24 hours while the backend process is running.