a-fund-monitor · diff
git:20260331.3101f5c to v2.0.0
63 added, 43 removed. Audit A to A.
---
name: a-fund-monitor
- description: 监控 A 股基金实时估值与盘后净值，自动判断交易日并生成提醒或分析。
+ description: "A股基金净值监控：盘中实时估值 + 盘后实际净值，定时推送到 Telegram 群。"
+ version: 2.0.0
+ triggers:
+ - A股 基金 监控 预测 净值 估值
+ - fund monitor A-share NAV estimate
+ - 东方财富 基金 API
---
- # A股基金监控 Skill
+ # A股基金监控
- A股基金净值监控，支持实时估值和盘后净值，自动判断交易日/节假日。
+ A股基金净值监控，支持盘中实时估值和盘后实际净值，推送到 Telegram。
- ## 用法
+ ## 架构
- ### 快速监控（命令行）
- ```bash
- # 默认配置，输出到控制台
- bash ~/clawd/skills/a-fund-monitor/scripts/monitor.sh
+ ```
+ fund_monitor.py (纯 Python，无外部依赖)
+ ├── estimate 模式 → fundgz.1234567.com.cn (盘中实时估值)
+ └── nav 模式 → api.fund.eastmoney.com/f10/lsjz (收盘净值)
- # 推送到群（使用--push参数）
- bash ~/clawd/skills/a-fund-monitor/scripts/monitor.sh --push
+ Cron wrapper scripts:
+ fund_estimate.sh → python3 fund_monitor.py estimate
+ fund_nav.sh → python3 fund_monitor.py nav
- # 监控指定基金
- bash ~/clawd/skills/a-fund-monitor/scripts/monitor.sh --codes "000979 002943"
+ Hermes cron (no_agent=true) → stdout 直接投递到 Telegram 群
```
- ### Agent调用
- ```
- 执行A股基金监控任务。
+ **关键路径**: `~/.hermes/profiles/cfo/scripts/`
- 1. 读取配置文件： ~/clawd/skills/a-fund-monitor/config.json
- 2. 获取实时净值数据
- 3. 非交易日自动切换为简短报告
+ ## 手动执行
- 配置文件格式：
- {
- "funds": [
- {"code": "000979", "name": "景顺长城沪港深精选股票A"},
- {"code": "002943", "name": "广发多因子混合"}
- ],
- "push": {
- "enabled": true,
- "chatId": -1003824568687
- }
- }
- ```
+ ```bash
+ # 盘中估值（控制台输出）
+ python3 ~/.hermes/profiles/cfo/scripts/fund_monitor.py estimate
- 运行命令：
- bash ~/clawd/skills/a-fund-monitor/scripts/monitor.sh [--push] [--codes "代码1 代码2"]
+ # 收盘净值（控制台输出）
+ python3 ~/.hermes/profiles/cfo/scripts/fund_monitor.py nav
```
- ## 功能特性
+ ## Cron 定时任务
- - ✅ 清代理（减少网络波动）
- - ✅ 交易日判断（周末 + 节假日）
- - ✅ 盘中实时估值 / 盘后实际净值自动切换
- - ✅ 非交易日简短报告（不推送详细数据）
- - ✅ 重试机制（网络失败自动重试）
- - ✅ 日期检查（显示净值日期）
+ Hermes cron 使用 **本地时区**（北京时间），不需要 UTC 转换。
- ## 配置
+ | 北京时间 | Cron 表达式 | 类型 | 数据源 |
+ |---------|------------|------|--------|
+ | 10:30 | `30 10 * * 1-5` | 盘中实时估值 | fundgz 接口 |
+ | 12:30 | `30 12 * * 1-5` | 盘中实时估值 | 同上 |
+ | 14:30 | `30 14 * * 1-5` | 盘中实时估值 | 同上 |
+ | 20:30 | `30 20 * * 1-5` | 收盘实际净值 | lsjz 接口 |
- 编辑 `config.json` 修改要监控的基金列表。
+ Cron job IDs（2026-05-22 重建）：
+ - `7bc48122678e` — 10:30 盘中估值
+ - `1a66e04aa9c9` — 12:30 盘中估值
+ - `909352d70c37` — 14:30 盘中估值
+ - `ac49f4b01fd6` — 20:30 收盘净值
- ## 节假日更新
+ **投递目标**: `telegram:-1003824568687`（NewsRobot 群）
- 每年需要更新 `scripts/holidays.txt` 中的节假日列表（格式：YYYY-MM-DD，每行一个）。
+ ## 添加/删除基金
+
+ 编辑 `fund_monitor.py` 中的 `FUNDS` 列表：
+
+ ```python
+ FUNDS = [
+ ("003304", "前海开源核心资源A"),
+ # ... 添加 ("代码", "简称")
+ ]
+ ```
+
+ ## API 参考
+
+ 详见 `references/eastmoney-api.md`。
+
+ ## Pitfalls
+
+ - **Hermes cron 时区**：cron schedule 使用服务器本地时区（北京时间），不需要 UTC 转换。旧版本错误使用 UTC（`30 2 * * 1-5` = 北京 10:30），已修正。
+ - **NAV 涨跌幅字段**：东方财富 lsjz API 的涨跌幅字段是 `JZZZL`（净值增长率），不是 `NAVCHGRT`。
+ - **估值 API 返回 JSONP**：`fundgz.1234567.com.cn` 返回 `jsonpgz({...});` 格式，需正则提取 JSON。
+ - **HTTP 请求头**：两个 API 都需要 `Referer: https://fund.eastmoney.com/` 和 `User-Agent`，否则可能 403。
+ - **20:30 净值可能未更新**：部分基金净值延迟到 22:00 后才更新，QDII 基金（如广发纳斯达克100）更晚。
+ - **QDII 基金估值时间**：广发纳斯达克100联接的估值时间显示为 04:00（美股收盘时间），非 A 股 15:00。
+ - **周末/节假日**：cron `1-5` 仅排除周末，中国法定节假日仍会触发（产出的是上一交易日数据）。
+ - **Cron 脚本路径**：必须是 `~/.hermes/profiles/<profile>/scripts/` 下的相对文件名，不能是绝对路径。