# IBKR Telegram 运维 Skill（yaolispeedgoat）

更新时间：2026-04-16
适用项目：`ibkr-trader`

## 目标

当我说“按 yaolispeedgoat 流程处理 / 检查 Telegram 通知”时，按固定 SOP 执行，避免漏检。

## 基线事实（先对齐）

- 通知 bot（单向）：`@SpeedGoatbot`
- 交互 bot（双向，待开发）：`@yaolispeedgoatbot`
- 生效配置文件：`/opt/ibkr-bot/config/system.yaml`
- 目标配置：

```yaml
notifications:
  provider: telegram
```

- 关键代码：`/opt/ibkr-bot/app/services/approval_service.py`
- 关键进程：
  - `app.speedgoat_telegram`
  - `app.main`

> 文档不等于生效；以服务器配置 + 进程状态 + 实测结果为准。

## 标准处理流程（SOP）

1. **确认目标**
   - 本次是“故障排查”还是“开盘前健康检查”。
2. **检查配置**
   - 确认 `/opt/ibkr-bot/config/system.yaml` 的 `notifications.provider` 为 `telegram`。
3. **检查进程**
   - 确认 `app.speedgoat_telegram`、`app.main` 正常运行。
4. **做一次通知验证**
   - 触发测试通知，确认 `@SpeedGoatbot` 能收到。
5. **记录结果**
   - 在 `01_daily/YYYY-MM-DD.md` 记录：检查时间、状态、异常、处理动作。
6. **必要时升级处理**
   - 若异常持续，更新 `02_projects/ibkr-trader/known-issues.md` 并补充临时绕过方案。

## 快速故障分流

- **现象：完全收不到 Telegram 消息**
  1) 先看 `provider` 是否误回退到 `line`
  2) 再看 Telegram bot 进程是否存活
  3) 再做最小化测试通知

- **现象：文档显示已切 Telegram，但线上无效**
  - 优先检查服务器真实配置文件，而不是 Second Brain 文档。

## 回报模板（给我）

```
【yaolispeedgoat 检查结果】
- 时间：
- 目标：故障排查 / 开盘前检查
- 配置：telegram / 非 telegram
- 进程：app.speedgoat_telegram（正常/异常），app.main（正常/异常）
- 测试通知：成功/失败
- 结论：
- 后续动作：
```

## 关联文档

- 参考基线：`05_reference/telegram-yaolispeedgoat.md`
- 项目说明：`02_projects/ibkr-trader/README.md`
- 项目状态：`02_projects/ibkr-trader/status.md`
- 已知问题：`02_projects/ibkr-trader/known-issues.md`