📊 Portfolio Monitor

股票监控工作台 — 美股 + A股实时行情，多档位目标价告警（Telegram 推送），持仓 & 交易记录管理。

✨ 功能特性

• 📈 实时行情 — 美股 + A股，自动刷新（盘中 30s / 盘外 5min）
• 🔔 多档位告警 — 每只股票支持主档 + 多个子档（买入 / 卖出 / 止损），Telegram 即时推送
• 💰 持仓管理 — 自动计算成本、盈亏、收益率，按市场分组，ECharts 图表可视化
• 📝 交易记录 — 增删查改、筛选、CSV 导出
• 💵 现金账户 — USD / CNY 现金管理，交易自动联动
• 🎨 双主题 — 暗色 / 明色主题，跟随系统设置，一键切换
• 📱 响应式 — 桌面端 & 移动端完美适配

📸 界面预览

暗色主题

明色主题

移动端

🚀 快速部署（Docker）

推荐使用 Docker 一键部署，3 步搞定：

# 1. 复制配置文件
cp config.example.yaml config.yaml

# 2. 编辑配置，填入你的 Telegram Bot Token 和 Chat ID
vim config.yaml

# 3. 启动！
docker compose up -d

打开浏览器访问 http://localhost:8802 🎉

常用命令

docker compose logs -f          # 查看日志
docker compose restart           # 重启
docker compose down              # 停止
docker compose up -d --build     # 重新构建并启动

🛠️ 本地开发

# 后端
python3 -m venv venv
source venv/bin/activate
pip install -r backend/requirements.txt

# 前端
cd frontend
npm install
npm run build
cd ..

# 启动
bash start.sh      # 前台运行（开发调试）
bash run.sh        # 后台运行
bash stop.sh       # 停止后台进程

前端开发模式（热更新）：

cd frontend
npm run dev        # Vite dev server → localhost:5173
                   # 自动代理 /api 到后端

⚙️ 配置说明

配置文件为 config.yaml，参考 config.example.yaml：

📡 API 文档

后端基于 FastAPI，自带交互式 API 文档：

• Swagger UI：http://localhost:8802/docs
• ReDoc：http://localhost:8802/redoc

主要端点

🏗️ 技术栈

📁 项目结构

portfolio-monitor/
├── backend/
│   ├── app/
│   │   ├── main.py              # FastAPI 入口 + 后台调度
│   │   ├── models.py            # ORM 模型 + Pydantic Schema
│   │   ├── database.py          # SQLite 连接
│   │   ├── services/            # 业务逻辑
│   │   └── routers/             # API 路由
│   └── requirements.txt
├── frontend/
│   ├── src/                     # Vue 源码
│   ├── package.json
│   └── vite.config.js
├── skill/                       # OpenClaw AI Agent skill
│   ├── SKILL.md                 # Skill 描述与安装
│   ├── portfolio                # CLI 可执行文件
│   ├── skill.json               # Skill 元数据
│   └── README.md                # 详细文档
├── screenshots/                 # 界面截图
├── data/                        # 运行时数据（.gitignore）
├── config.example.yaml          # 配置模板
├── docker-compose.yml           # Docker 编排
├── Dockerfile                   # 多阶段构建
├── start.sh / run.sh / stop.sh  # 启动脚本
├── CONTRIBUTING.md              # 贡献指南
└── LICENSE                      # MIT License

🤖 AI Agent 集成

本项目附带 OpenClaw Agent Skill，让 AI 助手可以直接查询持仓、记录交易。

安装 skill：

cp -rp skill/ ~/.openclaw/skills/stock-portfolio/
chmod +x ~/.openclaw/skills/stock-portfolio/portfolio

AI 可执行的操作：

portfolio summary      # 资产总览
portfolio holdings     # 持仓及盈亏
portfolio buy TME 500 15.50   # 记录买入
portfolio sell BABA 50 200.00 # 记录卖出
portfolio cash         # 现金余额

详见 skill/SKILL.md。

📄 License

MIT License © kdp