DeFiLlama 协议看门狗
监控 DeFi 协议的 TVL 下跌、资金轮动、安全风险和市场机会。
何时使用
- 用户想要监控或跟踪特定协议（例如：“盯住 Aave”、“如果 Uniswap 下跌提醒我”）
- 用户请求安全审计、风险检查或全面简报
- 用户想要轮动提醒或情绪更新（资金流向分析）
- 用户想检查协议是否被黑客攻击（投资组合安全）
不要用于一次性查询，例如“Aave 的 TVL 是多少？”——这类问题直接回答。
可用命令
所有命令从技能根目录运行。添加 --json 以获取结构化输出。
| 命令 | 用途 | 输出信号 |
|---|---|---|
python3 scripts/watchdog.py | 检查 TVL 下跌 | ALERT: 或 HEARTBEAT_OK |
python3 scripts/capital_flow.py | 资金轮动与情绪 | ROTATION:、SENTIMENT: 或 HEARTBEAT_OK |
python3 scripts/bridge_monitor.py | 跨链桥交易量激增 | BRIDGE_SURGE: 或 HEARTBEAT_OK |
python3 scripts/metrics_guard.py | 投资组合与近期黑客事件对比 | EMERGENCY: 或 HEARTBEAT_OK |
python3 scripts/true_growth.py | 聪明钱（TVL 降，资金流入升） | BULLISH_DIVERGENCE: 或 HEARTBEAT_OK |
python3 scripts/unlocks_monitor.py | 代币解锁风险 | DUMP_RISK: 或 HEARTBEAT_OK |
python3 scripts/revenue_guard.py | 收入/费用增长 | VALUE: 或 HEARTBEAT_OK |
python3 scripts/full_briefing.py | 运行所有检查 | 所有信号组合 |
如何响应
当用户请求检查时
- 运行相应的脚本
- 解析输出信号：
HEARTBEAT_OK= 一切正常ALERT:= TVL 跌幅超过阈值EMERGENCY:= 投资组合中的协议被黑客攻击ROTATION:= 资金在链间流动SENTIMENT:= 风险偏好/风险规避信号BRIDGE_SURGE:= 跨链桥交易量激增（热门链）BULLISH_DIVERGENCE:= TVL 下降但资金流入上升DUMP_RISK:= 即将发生大规模解锁VALUE:= 收入增长快于价格增长
- 综合结果，用 2-5 句话解释发生了什么以及为什么重要
警报响应模式
当检测到风险信号时：
- 以关键发现开头（TVL 下跌、黑客攻击、轮动）
- 结合其他信号增加上下文：
- 如果出现
ALERT:→ 运行capital_flow.py检查是轮动还是协议特定问题 - 如果存在投资组合 → 运行
metrics_guard.py检查黑客风险 - 可选运行其他检查以获取深度信息（解锁、资金流入、收入）
- 如果出现
- 给出明确的结论（用户应该做什么？）
示例总结
差：“ALERT: AAVE V3 TVL 下跌 12.3%。ROTATION: 以太坊上稳定币供应量减少 1.5%。”
好：“Aave V3 TVL 在过去周期下跌了 12.3%。这似乎与更广泛的资金轮动有关——以太坊上稳定币供应量下降，而 Solana 正在增长。并非协议特定风险，但需关注持续资金外流。”
常见用户请求
“如果 [协议] 下跌超过 X% 请提醒我”
- 确保
config.json中的watch_list（使用 DefiLlama 的 slug）和threshold设置正确 - 解释看门狗会按计划运行，并在阈值被突破时发出警报
“运行安全审计”/“全面简报”/“风险检查”
- 运行
python3 scripts/full_briefing.py - 将所有输出信号综合成一个叙述
“有资金轮动吗？”/“情绪更新？”
- 运行
python3 scripts/capital_flow.py - 报告
ROTATION:和SENTIMENT:信号，如果没有重大变化则说明“无明显变动”
“我的协议中有被黑客攻击的吗？”
- 运行
python3 scripts/metrics_guard.py - 需要
assets/portfolio.json（DefiLlama 协议 ID） - 如果发现
EMERGENCY:信号立即报告
“现在手动检查”
- 运行
python3 scripts/watchdog.py - 报告结果或确认“一切在阈值范围内”
配置
**文件：**技能根目录下的 config.json
关键设置：
watch_list：DefiLlama 协议 slug 数组（例如["aave-v3", "uniswap", "lido"]）threshold：警报阈值小数（例如0.10= 下跌 10%）risk_level："high"（5%）、"standard"（10%）、"low"（15%）- 功能开关：
capital_flow.enabled、metrics_guard.enabled、bridge.enabled等
**投资组合跟踪：**创建 assets/portfolio.json，其中包含 DefiLlama 协议 ID，用于黑客攻击和解锁警报。
**高级功能：**某些功能（资金流入、解锁）需要环境变量 DEFILLAMA_PRO_API_KEY。大多数功能无需任何 API 密钥即可工作。
重要说明
- 协议 slug 必须与 DefiLlama 完全匹配（请查看 defillama.com/protocols）
- 脚本将状态存储在
assets/目录中（TVL 历史数据、跨链桥数据等） - 所有脚本以退出码 0 退出并将结果打印到标准输出——请解析信号行
- 延迟：警报在 DefiLlama 更新后（约 5-15 分钟）加上下一次检查周期到达
- 无需 API 密钥：TVL、资金流向、黑客攻击、跨链桥、收入
- 需要 Pro API 密钥：资金流入（true_growth）、解锁（unlocks_monitor）
输出风格
- 保持简洁： 2-5 句总结
- 以行动开头：“Aave 下跌 12%”而非“系统检测到……”
- **提供上下文：**解释是轮动、黑客风险还是协议特定问题
- **无变化时不报告：**除非用户询问状态，否则不报告
HEARTBEAT_OK - **优雅处理错误：**如果脚本失败，告知用户手动运行