BigFocus · 追踪管家（商品价格·明星动态·行业追踪·自定义指标）| Personal Price, Celebrity & Industry Tracker

🎯 BigFocus · 你的个人追踪管家

🔒 权限声明

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

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

📋 功能概览

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

核心功能：

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

行为规则

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

用户意图自动识别

添加追踪（预览→确认→执行）

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

管理追踪（操作前确认）

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

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

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

被动查询

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

类型识别规则

不确定类型时询问用户。

存储

追踪列表

• 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 

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

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

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

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

# AI搜索后记录结果
python3 scripts/bigfocus.py record  <最后值> <摘要>
  # 更新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  "<结果摘要>" "<详细说明>"
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 配置

安装命令（替换 CHANNEL/TARGET）

# 创建定时扫描（每小时执行）
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

输出约束

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