---
name: bigfocus
description: 🎯 BigFocus · 追踪管家。追踪商品价格/明星动态/行业信息/自定义指标，变动时自动汇报。包含定时推送与全渠道分段推送能力。
triggers:
  - 帮我盯着
  - bigfocus
  - BigFocus
  - 我的追踪
  - 追踪列表
  - 添加追踪
  - 删除追踪
  - 暂停追踪
  - 恢复追踪
  - 添加跟踪
  - 跟踪列表
  - 价格追踪
  - 降价通知
---

# 🎯 BigFocus · 你的个人追踪管家

## 🔒 权限声明

BigFocus 需要以下权限才能正常工作：

| 权限 | 用途 | 范围 |
|------|------|------|
| file_read | 读取追踪列表和原始数据缓存 | workspace/memory/bigfocus-*.md/json |
| file_write | 写入追踪列表更新和新数据 | workspace/memory/bigfocus-*.md/json |
| network | 自动采集商品价格和指标数据（京东/CoinGecko等） | 仅向公开 API/网页发起 GET 请求 |
| web_search | AI 搜索人物动态、行业信息 | 仅用户追踪项对应的搜索 |
| cron | 定时扫描到期追踪项 | 仅 bigfocus-scan 一个定时任务 |

**不收集个人信息，不调第三方 API 存储数据，不联网发送用户数据。**

## 📋 功能概览

BigFocus 是一款 **个人追踪管家工具**，让你能自定义追踪任何想持续关注的人/事/物，系统按你设定的间隔自动检查，**有变化才汇报**。

**核心功能：**
- **💰 商品价格追踪** — 追踪京东/淘宝等商品价格，降价自动通知
- **🌟 人物动态追踪** — 盯着马斯克/特朗普/你的偶像，有动态告诉你
- **🏭 行业信息追踪** — 持续关注某个行业的最新消息和趋势
- **📊 自定义指标追踪** — 比特币价格、纳斯达克指数、天气等任何数值指标
- **⏰ 自定义间隔** — 每项可单独设置 1h/2h/3h/6h/12h/24h 检查频率
- **🔄 单 cron 内部调度** — 每小时触发一次，脚本自动筛选到期项
- **💬 确认添加机制** — 用户添加追踪需先预览确认，不会被随意添加

## 行为规则

**安全触发策略：** 检测到触发词后，读操作（查看/列表/信息）直接执行；写操作（添加/删除/修改/暂停/恢复）必须输出预览 + 等待用户确认后才执行。

### 用户意图自动识别

#### 添加追踪（预览→确认→执行）
```
用户说"帮我盯着 XXX" / "帮我追踪 YYY"
→ 自动识别类型（商品/人物/行业/指标）
→ 输出「添加确认模板」（不写入，仅预览）
→ 用户说"确认" 才调 add 写入
→ 用户说"取消" 则静默忽略
```

#### 管理追踪（操作前确认）
```
"删除 #3" / "暂停 #2" / "恢复 #1"
→ 输出「操作确认模板」（\「确定要删除 #3 xxx？\」）
→ 用户确认后执行

"间隔 #1 6h"
→ 输出「修改确认模板」（「确定改为 6h？」）
→ 用户确认后执行

"列表" / "我的追踪" / "信息 #3" / "详情 #4"
→ 读操作，直接执行并展示
```

#### 被动查询
```
用户没明说但提到已有追踪项的关键词
→ 展示对应追踪项的最新状态
```

## 类型识别规则

| 用户说 | 匹配类型 | 判断依据 |
|--------|---------|---------|
| "帮我盯着 iPhone 价格" | 💰 商品 | 包含价格/降价/京东/淘宝/商品的字眼 |
| "帮我盯着马斯克" | 🌟 人物 | 人名/明星/网红/KOL |
| "帮我盯着 AI 芯片" | 🏭 行业 | 行业名词/技术名词 |
| "帮我盯着比特币" | 📊 指标 | 指标/指数/价格带货币符号 |
| "帮我盯着某电商链接" | 💰 商品 | URL以 jd.com/taobao.com 开头 |

不确定类型时询问用户。

## 存储

### 追踪列表
- `memory/bigfocus-tracker.md` — 所有追踪项的列表和状态
- 格式：Markdown 表格（# / 名称 / 类型 / 目标/描述 / 间隔(h) / 下次检查 / 最后更新 / 最后值 / 状态）

### 原始数据缓存
- `memory/bigfocus-raw-data.json` — 每次检查的原始数据 + 历史记录
- 仅 AI 和脚本操作，用户不直接编辑

## 本地脚本

`scripts/bigfocus.py` — 核心操作脚本

```
# 添加（输出JSON，供AI读取确认）
python3 scripts/bigfocus.py add "<名称>" "<类型>" "<目标>" [间隔(h)]

# 删除（标记inactive）
python3 scripts/bigfocus.py remove <ID>

# 更新（修改任意字段）
python3 scripts/bigfocus.py update <ID> <字段> <值>

# 列表
python3 scripts/bigfocus.py list              # 文本格式（用户友好）
python3 scripts/bigfocus.py list --json       # JSON格式（程序处理）

# 单条详情
python3 scripts/bigfocus.py info <ID>

# 扫描到期项（供cron使用）
python3 scripts/bigfocus.py scan              # 输出JSON
  # 返回: expired(到期清单) + auto_updated(自动采集) + need_ai(需要AI搜索)

# AI搜索后记录结果
python3 scripts/bigfocus.py record <ID> <最后值> <摘要>
  # 更新tracker + raw-data，返回变化信息
```

## 工作流程

### 添加追踪（用户触发）

```
用户: "帮我盯着 iPhone 16 的价格"
AI:
  1. 识别类型 = 商品
  2. **不执行 add，仅构造预览**（本地生成确认内容）
  3. 输出「添加确认模板」：
     （模板中包含：名称、类型、目标、建议间隔、当前追踪列表）
     （**注意：此时不写入 tracker，等待用户确认**）
  4. 用户说 "确认" → 调 python3 bigfocus.py add 执行写入
     用户说 "确认 3h" → 调 bigfocus.py add ... 3 执行
     用户说 "取消" → 静默不做任何操作
     ┌─────────────────────────────────┐
     │ 🎯 BigFocus · 添加确认           │
     │                                  │
     **您想追踪的是：**
       📊 名称: iPhone 16 价格
       💰 类型: 商品
       🎯 目标: https://item.jd.com/xxx.html
       🕐 间隔: 建议 6h
     │                                  │
     **📋 当前追踪列表**
     │ (显示所有活跃项)                   │
     │                                  │
     │ 确认添加？回复「确认」「确认 3h」或「取消」│
     └─────────────────────────────────┘
  4. 用户说 "确认" → 已添加（add已执行）
     用户说 "确认 3h" → python3 bigfocus.py update 新ID interval 3
     用户说 "取消" → python3 bigfocus.py remove 新ID
```

### 定时扫描（cron 每整点触发）

```
1. 调 python3 bigfocus.py scan
2. 解析 JSON：
   - expired_count = 0 → 不推送
   - auto_updated 有内容 → 对变化项加入推送
   - need_ai 有内容 → 做 web_search 搜索每项
     ├── 商品 → 搜 "xxx 价格"
     ├── 人物 → 搜 "xxx 最新动态"
     ├── 行业 → 搜 "xxx 最新消息"
     └── 指标 → 搜 "xxx 当前价格/数值"
     对每个搜索结果 → python3 bigfocus.py record <ID> "<结果摘要>" "<详细说明>"
3. 组合变化信息，按推送模板输出
4. **无变化不推送**（安静跳过）
```

### 用户主动查询

```
用户: "列表" / "我的追踪"
AI:
  1. python3 bigfocus.py list
  2. 直接输出结果
```

## 推送格式

### 定时汇报模板（有变化时）

```
🎯 BigFocus · 追踪汇报

**📢 有变化的追踪项**

**[变化项1 名称]**
  变化: xxx → xxx
  来源: web_search / 自动采集
  详情: (简要说明)

**[变化项2 名称]**
  ...

---

**📋 当前追踪列表**

| # | 名称 | 类型 | 间隔 | 下次检查 | 状态 |
|---|------|------|------|---------|------|
| 1 | xxx | 💰商品 | 6h | 16:00 | active |
| 2 | xxx | 🌟人物 | 12h | 20:00 | active |

💡 回复「添加追踪」「删除 #N」「间隔 #N 6h」「暂停 #N」「恢复 #N」管理追踪项
```

### 添加确认模板

```
🎯 BigFocus · 添加确认

**您想追踪的是：**
  📊 名称: xxx
  💰 类型: 商品
  🎯 目标: xxx
  🕐 间隔: 建议 6h (可选 1h/2h/3h/6h/12h/24h)

**📋 当前追踪列表**
| # | 名称 | 类型 | 间隔 | 状态 |
|---|------|------|------|------|
| ... | ... | ... | ... | active |

确认添加？回复「确认」「确认 3h」或「取消」
```

## 时间窗口

| 场景 | 频率 |
|------|------|
| 定时扫描 | 每整点（由 cron 触发） |
| 用户添加 | 立即确认后写入 |
| 用户查询 | 立即展示 |

## cron 配置

### 安装命令（替换 CHANNEL/TARGET）

```bash
# 创建定时扫描（每小时执行）
openclaw cron add \
  --name bigfocus-scan \
  --cron "0 * * * *" \
  --tz "Asia/Shanghai" \
  --message "🎯 BigFocus 定时扫描。
按 bigfocus SKILL.md 中「定时扫描」流程执行。

要点：
1. 调 bigfocus.py scan 获取到期项
2. 对 need_ai 项做 web_search
3. 调 bigfocus.py record 记录结果
4. 有变化则按「定时汇报模板」推送（openclaw message send）
5. 无变化不推送，不输出任何内容
6. 严禁输出思考过程和调试信息" \
  --timeout-seconds 300 \
  --channel CHANNEL \
  --to TARGET \
  --session isolated \
  --no-deliver
```

## 输出约束

- 严格按推送模板格式输出
- 无变化时**彻底安静**（不输出任何内容）
- 添加确认模板必须包含当前追踪列表
- 所有追踪列表必须标记类型图标（💰/🌟/🏭/📊）
- 严禁输出思考过程、中间步骤、调试信息