News Sentry

News Sentry 是什么?

为什么需要 News Sentry?

采集 → 过滤 → 研判 → 输出 → 复核 → canonical graph → research artifact

核心能力

快速开始

# 1. 克隆
git clone https://github.com/XucroYuri/NewsSentry.git
cd NewsSentry
# 2. 安装
python3 -m venv .venv
source .venv/bin/activate
pip install -e ".[api,proxy]"
# 3. 配置 AI Provider Key(至少一个)
cp .env.example .env
# 编辑 .env 填入 GEMINI_API_KEY / DEEPSEEK_API_KEY / GROQ_API_KEY
# 4. 健康检查
./run.sh doctor --target italy
# 5. 运行全链路
./run.sh run --target italy --stage all
# 6. 启动 Web 管理面板(可选)
./run.sh serve --target italy
# 打开浏览器访问 http://localhost:8000/admin/

安装

前置要求

手动安装

python3 -m venv .venv
source .venv/bin/activate
pip install -e ".[dev]" # 开发
pip install -e . # 生产
pip install -e ".[proxy]" # SOCKS5 代理支持
pip install -e ".[api]" # FastAPI REST API 网关

Public Site SEO / GEO

系统架构

┌───────────────────────────────────────────────────────────────┐
│ CLI / API 入口 │
│ python -m news_sentry.cli FastAPI /api/v1 │
└─────────────────────┬─────────────────────────┬───────────────┘
 │ │
┌─────────────────────▼─────────────────────────▼───────────────┐
│ bounded_run 运行时 │
│ ConfigLoader + RunLog + Memory │
└─────────┬───────────────────────────────────────┬─────────────┘
 │ │
 ┌────────▼────────┐ ┌─────────▼──────────┐
 │ COLLECT 采集 │ │ FILTER 过滤 │
 │ RSS · API · │──────────────────→ │ 100+ 关键词评分 │
 │ Reddit · HN │ │ L0-L3 四层分类 │
 │ 零 Token 消耗 │ └─────────┬──────────┘
 └─────────────────┘ │
 ┌─────────▼──────────┐
 │ JUDGE 研判 │
 │ RulesJudge │
 │ 规则 → AI 升级 │
 └─────────┬──────────┘
 │
 ┌───────────────────────┐ ┌─────────▼──────────┐
 │ 告警推送 │◀─────────────│ OUTPUT 输出 │
 │ 飞书 · 邮件 · TG │ │ Markdown 报告生成 │
 └───────────────────────┘ └─────────┬──────────┘
 │
 ┌──────────▼─────────┐
 │ FEEDBACK 反馈 │
 │ 人工标注 → 规则优化 │
 └────────────────────┘

四个阶段

数据目录

data/{target}/
├── raw/ # 采集事件(Markdown + YAML frontmatter)
├── evaluated/ # 过滤 + 研判后的事件
├── drafts/ # 输出报告(v1 不自动发布)
├── reviewed/ # 人工审阅候选
├── published/ # 已批准归档
├── archive/ # 拒绝 / 重复 / 低价值
├── memory/ # 已知 ID / 信源健康 / 游标 / 规则优化状态
└── logs/ # 运行日志 + 心跳

配置管理

已配置的监控目标

cp config/targets/_template.yaml config/targets/{country}.yaml
mkdir -p config/sources/{country}/rss config/filters/{country}
./run.sh run --target {country} --stage all

使用

CLI 命令

# 单阶段运行
python -m news_sentry.cli run --target italy --stage collect # 仅采集
python -m news_sentry.cli run --target italy --stage filter # 仅过滤
python -m news_sentry.cli run --target italy --stage judge # 仅研判
python -m news_sentry.cli run --target italy --stage output # 仅输出
# 全链路
python -m news_sentry.cli run --target italy --stage all
# 其他 target
python -m news_sentry.cli run --target japan --stage all
python -m news_sentry.cli run --target germany --stage all
# 干运行(验证配置,不写文件)
python -m news_sentry.cli run --target italy --stage all --dry-run
# 生产 profile
python -m news_sentry.cli run --target italy --stage all --profile cloud-vps
# 后台常驻服务
news-sentry serve # 默认配置, localhost:8000, 全管道
news-sentry serve --target italy # 单 target
news-sentry serve --stage collect # 仅采集(不研判,零 token)
news-sentry serve --port 8080 --interval 30 # 自定义端口和采集间隔
news-sentry serve --foreground # 前台调试 (Ctrl+C 退出)
news-sentry serve --no-browser # 不自动打开浏览器
news-sentry stop # 停止后台服务
# 系统诊断
python -m news_sentry.cli doctor --target italy

./run.sh 快捷命令

./run.sh doctor --target italy # 系统诊断
./run.sh run --target italy --stage all # 全链路
./run.sh run --target italy --stage collect # 仅采集
./run.sh serve --target italy # 后台常驻服务
./run.sh --help # 查看所有命令

环境变量

部署

Docker Compose(推荐)

# 设置环境变量
export GEMINI_API_KEY=xxx
export DEEPSEEK_API_KEY=sk-xxx
# 启动
docker compose up -d
# 健康检查
curl http://localhost:8000/api/v1/health

API Server

pip install -e ".[api,proxy]"
./run.sh serve --target italy
# 健康检查
curl http://localhost:8000/api/v1/health

Cloudflare 生产发布

Cron(开发/测试)

*/15 * * * * cd /path/to/NewsSentry && .venv/bin/python -m news_sentry.cli run --target italy --stage all --profile cloud-vps

技术栈

开发

python -m ruff check # lint
python -m mypy src/news_sentry/ # type check
python -m pytest tests/ -q # 运行测试
python -m ruff format # 自动修复代码风格
python tools/scan_sensitive_data.py # 扫描敏感数据

典型使用场景

路线图

参与贡献

文档导航

免责声明与风险提示

外部资源与第三方服务

使用合规要求

┌──────────────────────────────────────────────────────────────┐
│ ⚠️ 使用前必须了解 │
├──────────────────────────────────────────────────────────────┤
│ │
│ 1. 遵守当地法律 │
│ → 各国对新闻采集、数据存储、个人信息处理有不同法规 │
│ → 使用前请确认您的用途符合所在司法管辖区的法律要求 │
│ │
│ 2. 尊重信源权利 │
│ → RSS/API 采集应遵守源站的 robots.txt 和服务条款 │
│ → 不得用于大规模爬取、内容抄袭或侵犯版权 │
│ │
│ 3. AI 研判不可替代人工决策 │
│ → AI 评分仅作参考,重要判断必须由人工复核 │
│ → 不可将 AI 研判结果作为唯一依据做出发布或传播决策 │
│ │
│ 4. 禁止非法用途 │
│ → 不得用于传播虚假信息、操纵舆论、监控个人或非法情报活动 │
│ → 不得用于任何违反人权、隐私权或数据保护法规的目的 │
│ │
└──────────────────────────────────────────────────────────────┘

许可证

Star History