stock-monitor-skill

# Stock Monitor Skill - 股票自动监控技能

自动监控股票价格，突破阈值时自动发送语音提醒！

## 🎯 功能特点

- ✅ **实时监控**：支持 A 股/港股/美股
- ✅ **语音提醒**：突破阈值自动发飞书语音条
- ✅ **多股票支持**：同时监控多只股票
- ✅ **自定义阈值**：每只股票独立设置涨跌阈值
- ✅ **交易时间判断**：自动跳过非交易时间
- ✅ **智能防打扰**：午休时间不提醒

## 📋 使用场景

- 📈 短线交易：监控关键价位突破
- 💼 上班族：没空看盘，自动提醒
- 🎯 止盈止损：到达目标价自动通知
- 🔔 异动提醒：大涨大跌不错过

## 🔧 前置要求

### 1. Feishu 应用配置

同 Feishu Voice Skill

### 2. 股票数据源

使用新浪财经免费 API（无需 key）

### 3. 系统依赖

```bash
# 安装 jq（JSON 处理）
yum install -y jq  # CentOS/OpenCloudOS
apt-get install -y jq  # Ubuntu/Debian
```

## 🚀 快速开始

### 步骤 1：配置环境变量

```bash
export FEISHU_APP_ID="cli_xxx"
export FEISHU_APP_SECRET="xxx"
export FEISHU_CHAT_ID="oc_xxx"
export NOIZ_API_KEY="xxx"
```

### 步骤 2：添加监控股票

编辑 `stocks.conf`：

```bash
# 格式：股票代码，股票名称，涨阈值%，跌阈值%
sh600519,贵州茅台，3,3
sz000858,五粮液，4,4
sh601318,中国平安，5,5
```

### 步骤 3：运行监控

```bash
# 手动运行一次
bash scripts/monitor.sh

# 加入定时任务（每 5 分钟检查一次）
crontab -e
*/5 9-11,13-15 * * 1-5 bash /path/to/monitor.sh  # 交易日交易时间
```

## 📖 命令参数

```bash
bash scripts/monitor.sh [选项]

选项:
  -c, --config <file>     配置文件路径（默认：stocks.conf）
  -o, --once              只运行一次，不监控
  -v, --verbose           详细输出
  -h, --help              显示帮助
```

## 💡 使用示例

### 1. 监控贵州茅台

```bash
# 添加股票
echo "sh600519，贵州茅台，3,3" >> stocks.conf

# 运行监控
bash scripts/monitor.sh
```

### 2. 设置止盈止损

```bash
# 涨 5% 止盈提醒，跌 3% 止损提醒
echo "sz000858，五粮液，5,3" >> stocks.conf
```

### 3. 多股票监控

```bash
# 批量添加
cat >> stocks.conf << EOF
sh600519，贵州茅台，3,3
sz000858，五粮液，4,4
sh601318，中国平安，5,5
sz002415，海康威视，4,4
EOF

bash scripts/monitor.sh
```

## 📊 提醒内容

当股票突破阈值时...

# 📊 Stock Monitor Skill - 股票自动监控

自动监控股票价格，突破阈值时自动发送飞书语音提醒！

## ✨ 功能特点

- ✅ **实时监控**：支持 A 股/港股/美股
- ✅ **语音提醒**：突破阈值自动发飞书语音条
- ✅ **多股票支持**：同时监控多只股票
- ✅ **自定义阈值**：每只股票独立设置
- ✅ **交易时间判断**：自动跳过非交易时间

## 🚀 快速开始

### 1. 安装依赖

```bash
# 安装 jq 和 bc
yum install -y jq bc  # CentOS/OpenCloudOS
apt-get install -y jq bc  # Ubuntu/Debian
```

### 2. 配置环境变量

```bash
export FEISHU_APP_ID="cli_xxx"
export FEISHU_APP_SECRET="xxx"
export FEISHU_CHAT_ID="oc_xxx"
export NOIZ_API_KEY="xxx"
```

### 3. 添加监控股票

编辑 `stocks.conf`：

```
sh600519，贵州茅台，3,3
sz000858，五粮液，4,4
```

### 4. 运行监控

```bash
bash scripts/monitor.sh
```

### 5. 设置定时任务

```bash
crontab -e
*/5 9-11,13-15 * * 1-5 bash /path/to/monitor.sh
```

## 💡 使用场景

- 📈 短线交易：监控关键价位突破
- 💼 上班族：没空看盘，自动提醒
- 🎯 止盈止损：到达目标价自动通知
- 🔔 异动提醒：大涨大跌不错过

## 📖 详细文档

查看 [SKILL.md](SKILL.md) 获取完整使用说明。

## 💰 商业授权

- **个人使用**：免费
- **商业使用**：请联系作者获取授权

---

**Made with ❤️ by 司幼 (SiYou)**