TrendRadar 日趋势推送工作流

环境路径

• 安装：/home/ubuntu/TrendRadar
• 配置：/home/ubuntu/TrendRadar/config/config.yaml
• 存档脚本：~/.hermes/scripts/trend_archive.py
• GitHub 同步脚本：~/.hermes/scripts/github_sync.py

标准流程（按顺序执行）

Step 1: 触发爬取

必须先触发新的爬取，不能使用旧数据：

mcp_trendradar_trigger_crawl(include_url=true)

返回 {total_news: N, platforms: [...], failed_platforms: [...]} 即成功。

Step 2: 获取新闻

mcp_trendradar_get_latest_news(limit=100, include_url=true)

Step 3: 获取 Telegram 格式规范

mcp_trendradar_get_channel_format_guide(channel="telegram")

Step 4: 分 5 条发送 Telegram 通知

每条 10 条，必须 单独发送，不能合并：

消息	类别	内容来源
1	📊 财经·科技	cls-hot, wallstreetcn-hot 等财经/科技平台
2	🏛️ 政治·社会	ifeng, thepaper, baidu 等政社平台
3	⚽ 体育·电竞	douyin, tieba, weibo 体育相关
4	🌍 国际	ifeng, thepaper 国际新闻
5	🎭 娱乐·其他	bilibili, tieba 娱乐 + 汇总统计

每条消息格式（Telegram HTML）：

• 用 **粗体** 突出关键词（转为 <b>）
• 用 *斜体* 标记平台/来源（转为 <i>）
• 用 `代码` 标记 rank/时间（转为 <code>）
• 用 [文本](URL) 添加链接（转为 <a>）
• 不要用 # 标题、--- 分割线、table（会被剥离）
• 单条消息 ≤ 4096 字符

发送函数：

mcp_trendradar_send_notification(
  channels=["telegram"],
  title="📊 财经·科技 Top 10 | YYYY-MM-DD",
  message="..."
)

Step 5: 存档到 Obsidian

python3 ~/.hermes/scripts/trend_archive.py

输出 saved_to_obsidian: true 即成功。

Step 6: GitHub 同步

python3 ~/.hermes/scripts/github_sync.py

输出 PR 已创建即为成功（自动合并可能需要人工审批，属正常）。

---

⚠️ 已知问题与修复

YAML 配置损坏（config.yaml 缩进错误）

症状：yaml.parser.ParserError: expected <block end>, but found '<block mapping start>' at line 334

原因：config.yaml 中 telegram: 缩进缺失，出现在 channels: 同级而非其下。

检查方法：

cd /home/ubuntu/TrendRadar && python3 -c "import yaml; yaml.safe_load(open('config/config.yaml')); print('YAML OK')"

修复命令：

sed -i '330s/^telegram:/    telegram:/' /home/ubuntu/TrendRadar/config/config.yaml
# 验证
python3 -c "import yaml; yaml.safe_load(open('/home/ubuntu/TrendRadar/config/config.yaml')); print('YAML OK')"

修复后重新触发爬取即可。

📎 详细错误复现和根因分析：见 references/yaml-config-fix.md

爬取成功但获取新闻返回 DATA_NOT_FOUND

原因：获取新闻依赖爬取刚完成的同批次数据，日期为爬取当日。

解决：确认 trigger_crawl 返回 success: true 后再调用 get_latest_news。

GitHub PR 自动合并超时

症状：PR 创建成功但 ⚠️ PR 合并失败 或 ⏳ 等待审批... (6/6) 后超时。

说明：这是预期行为（Auto-merge 需人工审批或特定 CI 条件）。PR 已创建，登录 GitHub 手动合并即可。