GeekNews OSS 每日简报

该技能每日从 GeekNews（news.hada.io）精选当日最热门的 5 个议题，以开源软件 / GitHub 生态为核心进行内容策展，并通过 Telegram 推送。

1. 数据采集

通过抓取 GeekNews 页面或解析其 RSS 订阅源，获取当日发布的文章。

数据来源（按优先级排序）

1. RSS 订阅源：https://news.hada.io/rss — 最稳定
2. 网页抓取：https://news.hada.io/ 首页 — RSS 失败时的备用方案
3. 专题页面：https://news.hada.io/topics — 补充上下文信息

采集字段

每篇文章中提取以下信息：

• 标题
• 原文链接
• GeekNews 站内链接（hada.io URL）
• 推荐数（points）
• 评论数
• 发布时间
• 摘要文本（如有）

2. 入选标准 — 优先级评分机制

依据以下规则为每条内容计算加权得分，最终选取得分最高的前 5 条。

Tier 1 — 最高优先级（权重 ×3）

• 新开源项目发布或重大版本更新
  • 关键词：“오픈소스”、“open source”、“release”、“v1”、“launch”、“공개”
• GitHub Star 数激增的项目
  • 标题或正文包含 GitHub 链接
  • 若可获取 star 数，则检查其近期增长趋势

Tier 2 — 高优先级（权重 ×2）

• 开发效能 / AI 开发工具 / 基础设施相关话题
  • 关键词：“AI”、“LLM”、“devtools”、“infra”、“Kubernetes”、“database”
• 社区反响强烈的项目
  • 推荐数位于前 10%，或评论数 ≥15 条

Tier 3 — 基础优先级（权重 ×1）

• GeekNews 站内普遍热度指标（基于推荐数、评论数、浏览量等综合排名靠前者）
• 通用科技新闻仅在真正非常热门时才被纳入

去重与合并规则

• 同一主题出现 2 次及以上时，合并为一个代表性议题
• 排除广告性 / 宣传性内容
• 排除超过 3 天的旧闻（防止重复抓取）

3. 摘要撰写规范

针对每条入选议题，需提供以下内容：

4. Telegram 消息格式

按如下格式组织 Telegram 消息，启用 Markdown V2 解析模式。

📰 *今日 GeekNews HOT 5*
{日期} | 聚焦开源与开发者生态

💬 一句话总评：{今日整体趋势一句话概括}

━━━━━━━━━━━━━━━

1️⃣ *{标题}*
→ {为何重要的一句话}
{标签}
{GitHub 信息（如有）}
🔗 {链接}

2️⃣ *{标题}*
→ {为何重要的一句话}
{标签}
🔗 {链接}

...（第 3～5 条结构相同）

━━━━━━━━━━━━━━━

🤖 Curated by geeknews-oss-brief

格式规范

• 全文长度：严格控制在 Telegram 单条消息上限（4096 字符）以内
• Emoji：为提升可读性适度使用，避免过度堆砌
• 链接：必须确保可点击跳转

5. Telegram 发送

发送方式

使用 scripts/send_telegram.py 脚本执行发送。运行前需配置以下环境变量：

• TELEGRAM_BOT_TOKEN — Telegram Bot Token
• TELEGRAM_CHAT_ID — 目标接收频道/群组的 Chat ID

python3 scripts/send_telegram.py --message-file /tmp/geeknews_brief.md

如尚未获取 Bot Token 或 Chat ID，请向用户说明配置方法，详见：references/telegram_setup.md。

6. 自动化执行（Cron）

设置每日上午 8 点（韩国标准时间 KST）自动运行的 Cron 任务：

# 每日上午 8 点（KST = UTC+9 → 对应 UTC 时间为前一天 23:00）
0 23 * * * /path/to/run_geeknews_brief.sh

若服务器已正确配置 KST 时区，亦可直接使用：

0 8 * * * /path/to/run_geeknews_brief.sh

scripts/run_geeknews_brief.sh 将完整执行整个流水线流程：

1. GeekNews 数据采集
2. 内容策展与摘要生成
3. Telegram 消息推送

7. 执行流程概览

[Cron 08:00 KST]
    ↓
[GeekNews RSS / 网页采集]
    ↓
[优先级评分计算 & 前 5 名筛选]
    ↓
[各议题摘要撰写 + GitHub 信息增强]
    ↓
[Telegram 消息格式组装]
    ↓
[Telegram 推送]
    ↓
[记录完成日志]

故障排查

• RSS 解析失败：启用网页抓取作为 fallback 方案
• GitHub API 请求频率限制：未认证状态下限速为每小时 60 次。建议尽可能配置 GITHUB_TOKEN 环境变量以提升限额
• Telegram 推送失败：请重新确认 Bot Token 与 Chat ID 是否正确，且 Bot 已被添加至目标聊天中
• 入选文章不足 5 篇：仅推送实际入选数量，并标注“今日共精选 N 篇”