hotspot/README.md
yumoqing 4a8f2c22be refactor: extract Python package hotspot/ from .dspy files
- hotspot/parsers.py: 11 builtin parsers + 4 extractors (json_path/css/regex/rss)
- hotspot/engine.py: fetch + extract orchestration
- hotspot/analysis.py: 5-dim scoring + 7-day half-life status classifier
- hotspot/db.py: DB helpers (save_items, write_fetch_log, get_stats)
- hotspot/__init__.py: public API (run_fetch, run_analysis, get_stats)
- .dspy files reduced to 1-line wrappers
2026-08-01 12:13:00 +08:00

36 lines
1.2 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# 热点雷达 (Hotspot Radar)
Sage 框架模块 — 指定来源的热点聚合分析平台。
- 11 个内置平台解析器(微博/知乎/百度/头条/B站/抖音/36氪/GitHub/HN/V2EX/RSSHub
- 4 种可配置提取器json_path / css / regex / rss
- 每条来源自带 parser_config同类型不同来源可用不同提取规则
- 五维分析 + 7 天半衰期自动状态分类
## 目录
```
hotspot/
├── hotspot/ # Python 包(放入 Sage 根目录)
│ ├── __init__.py
│ ├── engine.py # 抓取引擎
│ ├── analysis.py # 五维分析引擎
│ ├── parsers.py # 11 内置解析器 + 通用提取器
│ └── db.py # 数据库操作
├── json/ # 表定义(放入 Sage json/ 目录)
├── wwwroot/hotspot/ # UI + 端点(放入 Sage wwwroot/hotspot/
├── ddl/mysql.sql # 建表 SQL
└── install/ # 安装片段
```
## 安装
```bash
SAGE_ROOT=/path/to/sage
cp -r hotspot $SAGE_ROOT/ # Python 包
cp json/hotspot_*.json $SAGE_ROOT/json/
cp -r wwwroot/hotspot $SAGE_ROOT/wwwroot/
```
建表、注册权限、加菜单 → 见 README 原文。