Signal Scanner 是一个定时扫描器，用于在 TAM 公司（total addressable market）与关注名单人物中检测购买信号，将结果写入 signals 表，并据此设置下游触达激活。它适用于 TAM Builder 已填充公司与人物之后，作为每日或每周的周期性扫描，将静态名单转变为基于意向的触达。
前置条件包括：.env 中配置 SUPABASE_URL 与 SUPABASE_SERVICE_ROLE_KEY；.env 中配置 APIFY_TOKEN（用于第二阶段信号）；ANTHROPIC_API_KEY（可选，用于 LLM 内容分析）；已通过 tam-builder 填充 TAM 公司；已为 Tier 1-2 公司创建关注名单人物。
信号类型分优先级：P0 包括 90 天内员工数增长超过 10%、技术栈变化、融资轮次，均为公司级、来自数据差异、免费；相关岗位招聘信息为公司级、来自 Apify linkedin-job-search、约 $0.001/条。P1 包括高管职位变动、LinkedIn 内容分析、LinkedIn 资料更新，均为人物级，分别使用 Apify linkedin-profile-scraper（约 $3/1k）、linkedin-profile-posts + LLM（约 $2/1k + LLM）、linkedin-profile-scraper（约 $3/1k）。P2 为新任 C 级高管招聘，公司级、由人物扫描推导、免费。
配置见 configs/example.json，关键字段有 client_name、signals.*（启用/禁用各信号类型及阈值）、scan_scope（按 tier、status、lead_status 过滤）。
关键写库政策：未经用户明确批准，绝不写入信号或更新线索状态。写库影响下游触达时机，错误信号会导致过早触达。必需流程：先运行 --dry-run 检测信号而不写库；向用户展示结果（信号数量、类型、重点信号、受影响公司/人物）；获得明确批准后再运行实际扫描并写库。Agent 首次运行绝不能传 --yes，该标志仅用于用户已验证检测逻辑的预先批准定时扫描。
使用方式：
先干跑（务必）：
python skills/capabilities/signal-scanner/scripts/signal_scanner.py
--config skills/capabilities/signal-scanner/configs/my-client.json --dry-run
完整扫描（仅在用户审核干跑结果并批准后）：
python skills/capabilities/signal-scanner/scripts/signal_scanner.py
--config skills/capabilities/signal-scanner/configs/my-client.json
测试模式（最多 5 家公司）：
python skills/capabilities/signal-scanner/scripts/signal_scanner.py
--config configs/example.json --test --dry-run
仅免费信号：在配置中把所有 Apify 信号设为 enabled: false。
标志：--config PATH 为配置 JSON 路径（必需）；--test 限制 5 家公司、3 个人物；--yes 自动确认 Apify 成本提示，仅用于预先批准的定时扫描；--dry-run 检测但不写库，务必先运行；--max-runs N 覆盖 Apify 运行上限（默认 50）。
输出：signals 表写入，每条含 client_name、company_id、person_id、signal_level、signal_type、signal_source、strength、signal_data（JSON）、activation_score、detected_at、acted_on、run_id。其他写库包括：当 activation_score 达到阈值时，人物 lead_status 更新为 signal_detected；公司 metadata._signal_snapshot 与人物 raw_data._signal_snapshot 为下一轮差异更新；enrichment_log 记录 tool='apify'、action='search' 或 'enrich' 及 credits_used。控制台输出摘要统计。
激活分数公式：activation_score = strength * recency_multiplier * account_fit。时效乘数：<24h 为 1.5，1-3d 为 1.2，3-7d 为 1.0，1-2w 为 0.8，2-4w 为 0.5。账户匹配：Tier 1 为 1.3，Tier 2 为 1.0，Tier 3 为 0.7。
上下游：上游为 tam-builder（提供公司与人物），下游为 cold-email-outreach（根据信号行动）。
文件结构：signal-scanner/ 含 SKILL.md、configs/example.json、scripts/signal_scanner.py。
限制：依赖外部服务与密钥；付费信号产生 Apify 成本；写库需明确批准，否则可能级联影响未来扫描与触达时机。