# 📈 股票技能使用手册

> 三大股票分析技能完整使用指南  
> 更新时间：2026-03-13  
> 适用市场：A 股（沪深两市）

---

## 📋 技能列表

| 技能名称 | 功能定位 | 适用场景 |
|----------|----------|----------|
| **a-stock-trading-assistant** | A 股实时交易助手 | 查行情、个股分析、买卖点建议 |
| **daily-stock-analysis** | 每日分析报告 | 每日收盘后自动生成分析报告 |
| **stock-monitor-skill** | 智能监控预警 | 7 大预警规则，实时推送提醒 |

---

## 1️⃣ A 股股票交易助手 (a-stock-trading-assistant)

### 🎯 功能定位
专业 A 股交易助手，提供实时行情、个股分析、大盘情绪、热点板块、交易策略等全方位服务。

### 📊 支持市场
| 代码前缀 | 市场 | 示例 |
|----------|------|------|
| 60xxxx | 上交所主板 | 600519 贵州茅台 |
| 00xxxx | 深交所主板 | 000001 平安银行 |
| 30xxxx | 创业板 | 300750 宁德时代 |
| 68xxxx | 科创板 | 688981 中芯国际 |

### 💡 核心功能

#### 1. 实时行情查询
```bash
# 查询单只股票
python3 scripts/fetch_stock.py --code 600519

# 查询大盘指数
python3 scripts/fetch_stock.py --index

# 查询热点板块
python3 scripts/fetch_stock.py --hot-sectors
```

**输出内容：**
- 当前价、涨跌幅、涨跌额
- 成交量、成交额、换手率
- 振幅、52 周高/低
- 分时走势摘要

#### 2. 个股综合分析
- **技术面**：均线系统、趋势判断、支撑/压力位、MACD/KDJ 信号
- **基本面**：PE/PB 估值、近期业绩、行业地位、风险点
- **综合判断**：看多/看空/中性

#### 3. 大盘情绪与风险判断
- 大盘强弱（趋势、量能、板块轮动）
- 市场情绪指数（赚钱效应、涨跌比）
- 风险等级（低/中/高）及应对建议

#### 4. 热点板块与龙头股
- 识别主线板块（连续性强）
- 识别情绪板块（短期热点）
- 列出核心龙头股

#### 5. 交易策略建议
```
【操作建议】XX 股（XXXXXX）
方向：做多/观望/回避
入场区间：XX.XX - XX.XX 元
止损位：XX.XX 元（跌破离场）
止盈位：XX.XX 元（分批减仓）
仓位：XX%（轻/中/重仓）
逻辑：[核心理由 2-3 条]
风险：[主要风险 1-2 条]
```

#### 6. 价格预警监控
- 记录目标价、预警条件到 watchlist.md
- 配合券商 App 实时推送

### 🗣️ 使用示例
```
用户：贵州茅台现在多少钱？
用户：分析一下宁德时代的技术面
用户：今天大盘情绪怎么样？
用户：最近有什么热点板块？
用户：给我看看 600519 的买卖点建议
```

### ⚠️ 注意事项
- 数据标注来源和获取时间（精确到分钟）
- 所有价格建议附风险提示
- 避免绝对化表述（"必涨"/"稳赚"）
- 数字精确到小数点后 2 位

---

## 2️⃣ 每日股票分析 (daily-stock-analysis)

### 🎯 功能定位
每日收盘后自动生成股票分析报告，包含次日收盘价预测、历史预测准确率追踪、自我进化机制。

### 📁 报告存储
- **路径**：`<working_directory>/daily-stock-analysis/reports/`
- **文件名**：`YYYY-MM-DD-<TICKER>-analysis.md`
- **版本控制**：同一天同一只股票自动生成 `-v2`、`-v3` 版本

### 💡 核心功能

#### 1. 预测与回顾
- **pred_close_t1**：预测次日收盘价
- **prev_pred_close_t1**：上次预测的收盘价
- **prev_actual_close_t1**：实际收盘价
- **AE/APE**：预测误差/误差百分比

#### 2. 滚动准确率追踪
```bash
# 计算滚动准确率
python3 scripts/calc_accuracy.py \
  --workdir <working_directory> \
  --ticker <TICKER> \
  --windows 1,3,7,30 \
  --history-limit 60
```

#### 3. 自我进化机制
每次分析包含 1-3 个 `improvement_actions`，从近期预测失误中学习，用于下一次分析。

### 🗓️ 调度建议
设置为**工作日每天 10:00** 运行，保持预测 - 回顾窗口连续。

### 📄 报告模板
```markdown
# <TICKER> 每日分析 - YYYY-MM-DD

## 推荐建议
recommendation: 买入/持有/卖出

## 价格预测
pred_close_t1: XX.XX 元

## 历史预测回顾
prev_pred_close_t1: XX.XX 元
prev_actual_close_t1: XX.XX 元
AE: X.XX | APE: X.XX%

## 滚动准确率
1 日准确率：XX%
7 日准确率：XX%

## 改进措施
1. [具体改进行动]
2. [具体改进行动]
```

### ⚠️ 合规声明
每份报告必须附加：
> "本内容仅供研究和参考，不构成投资建议或收益保证。市场有风险，投资需谨慎。"

---

## 3️⃣ 股票监控预警 (stock-monitor-skill)

### 🎯 功能定位
全功能智能股票监控预警系统，7 大预警规则，实时推送提醒，符合中国投资者习惯（红涨绿跌）。

### 🚨 七大预警规则

| 规则 | 触发条件 | 权重 |
|------|----------|------|
| **成本百分比** | 盈利 +15% / 亏损 -12% | ⭐⭐⭐ |
| **日内涨跌幅** | 个股±4% / ETF±2% / 黄金±2.5% | ⭐⭐ |
| **成交量异动** | 放量>2 倍均量 / 缩量<0.5 倍 | ⭐⭐ |
| **均线金叉/死叉** | MA5 上穿/下穿 MA10 | ⭐⭐⭐ |
| **RSI 超买超卖** | RSI>70 超买 / RSI<30 超卖 | ⭐⭐ |
| **跳空缺口** | 向上/向下跳空>1% | ⭐⭐ |
| **动态止盈** | 盈利 10%+ 后回撤 5%/10% | ⭐⭐⭐ |

### 📊 分级预警系统
- **🚨 紧急级**：多条件共振（如：放量 + 均线金叉 + 突破成本）
- **⚠️ 警告级**：2 个条件触发（如：RSI 超卖 + 放量）
- **📢 提醒级**：单一条件触发

### 🚀 运行方式

#### 后台常驻进程
```bash
cd ~/workspace/skills/stock-monitor/scripts
./control.sh start    # 启动
./control.sh status   # 查看状态
./control.sh log      # 查看日志
./control.sh stop     # 停止
```

### ⚡ 智能监控频率（北京时间）

| 时间段 | 频率 | 监控标的 |
|--------|------|----------|
| 交易时间 9:30-15:00 | 每 5 分钟 | 全部 + 技术指标 |
| 午休 11:30-13:00 | 每 10 分钟 | 全部 |
| 收盘后 15:00-24:00 | 每 30 分钟 | 全部（日线数据） |
| 凌晨 0:00-9:30 | 每 1 小时 | 仅伦敦金 |
| 周末 | 每 1 小时 | 仅伦敦金 |

### 📋 监控配置示例

```python
{
    "code": "600362",
    "name": "江西铜业",
    "type": "individual",  # 个股
    "market": "sh",
    "cost": 57.00,          # 持仓成本
    "alerts": {
        # 1. 成本百分比
        "cost_pct_above": 15.0,    # 盈利 15% 提醒
        "cost_pct_below": -12.0,   # 亏损 12% 提醒
        
        # 2. 日内涨跌幅
        "change_pct_above": 4.0,
        "change_pct_below": -4.0,
        
        # 3. 成交量异动
        "volume_surge": 2.0,       # 放量>2 倍
        
        # 4-7. 技术指标
        "ma_monitor": True,        # 均线金叉死叉
        "rsi_monitor": True,       # RSI 超买超卖
        "gap_monitor": True,       # 跳空缺口
        "trailing_stop": True      # 动态止盈
    }
}
```

### 🔔 预警消息示例

#### 🚨 紧急级（多条件共振）
```
🚨【紧急】🔴 江西铜业 (600362)
━━━━━━━━━━━━━━━━━━━━
💰 当前价格：¥65.50 (+15.0%)
📊 持仓成本：¥57.00 | 盈亏：🔴+14.9%

🎯 触发预警 (3 项):
  • 🎯 盈利 15% (目标价 ¥65.55)
  • 🌟 均线金叉 (MA5¥63.2 上穿 MA10¥62.8)
  • 📊 放量 2.5 倍 (5 日均量)

💡 建议：多条件共振，趋势强劲，可考虑继续持有或分批减仓。
```

#### ⚠️ 警告级
```
⚠️【警告】🟢 恒生医疗 (159892)
━━━━━━━━━━━━━━━━━━━━
💰 当前价格：¥0.72 (-10.0%)

🎯 触发预警 (2 项):
  • 📉 日内大跌 -10.0%
  • ❄️ RSI 超卖 (28.5)，可能反弹

💡 建议：短期超跌严重，RSI 进入超卖区，关注反弹机会但勿急于抄底。
```

### 🛠️ 自定义配置

#### 修改成本价
```python
"cost": 55.50,  # 改成你的实际成本
```

#### 调整预警阈值
```python
"cost_pct_above": 20.0,     # 盈利 20% 提醒
"cost_pct_below": -15.0,    # 亏损 15% 提醒
"change_pct_above": 5.0,    # 日内异动±5%
"volume_surge": 3.0,        # 放量 3 倍提醒
```

#### 开关技术指标
```python
"ma_monitor": False,     # 关闭均线
"rsi_monitor": True,     # 开启 RSI
"gap_monitor": True,     # 开启跳空
```

### ⚠️ 使用提示
1. **技术指标有滞后性**：均线、MACD 等用于确认趋势而非预测
2. **避免过度交易**：预警只是参考，不要每个信号都操作
3. **多条件共振更可靠**：单一指标容易假信号
4. **动态止盈要灵活**：回撤 5% 减仓、10% 清仓是建议，根据市场调整

---

## 🔧 技能安装与管理

### 安装技能
```bash
clawhub install a-stock-trading-assistant
clawhub install daily-stock-analysis
clawhub install stock-monitor-skill
```

### 查看已安装技能
```bash
ls ~/.openclaw/workspace/skills/ | grep stock
```

### 更新技能
```bash
clawhub update a-stock-trading-assistant
clawhub update daily-stock-analysis
clawhub update stock-monitor-skill
```

---

## 📞 常见问题

### Q1: 数据源从哪里来？
- **a-stock-trading-assistant**：东方财富、新浪财经、同花顺、雪球
- **daily-stock-analysis**：Yahoo Finance + 官方披露
- **stock-monitor-skill**：实时行情 API

### Q2: 支持港股和美股吗？
- **a-stock-trading-assistant**：仅支持 A 股
- **daily-stock-analysis**：支持全球股市
- **stock-monitor-skill**：主要支持 A 股，可配置港股/美股

### Q3: 预警怎么推送？
- 后台常驻进程运行 `monitor_daemon.py`
- 可配置微信、钉钉、飞书等推送渠道
- 建议配合券商 App 使用

### Q4: 预测准确率怎么样？
- 运行 `calc_accuracy.py` 查看滚动准确率
- 1 日/3 日/7 日/30 日准确率分别统计
- 自我进化机制持续提升

---

## 📝 更新日志

| 日期 | 更新内容 |
|------|----------|
| 2026-03-13 | 三大技能使用手册首次整理 |

---

*文档由皮皮虾整理 🦐 | 投资有风险，入市需谨慎*
