5.3 KiB
5.3 KiB
TODO
当前待办
- 优化提示词： 推送格式；参考链接去除非官方信息； insights 不够深度
- 日志系统，保存到文件，push和fetch分开，
- 早报内容格式优化：参考appso / xiaohu / ai gap
- 优先级顺序
- 美化排版
- 添加更多信息源，如 TechCrunch、
- 允许fetch链接中的内容对信息进行扩展
- 更多信息源以及信息获取不全： https://www.anthropic.com/research/glasswing-initial-update / github blog
长期待办
- 增加图片/信息图
- 推送到知乎 / 小红书 / 网站
- llm api fallback
技术决策记录
| 决策 | 方案 | 原因 |
|---|---|---|
| 定时调度 | systemd timer（生产）+ croniter（loop 模式） | 进程崩溃/服务器重启可自愈，配置热更新，比内置 asyncio.gather 更稳健 |
| 包管理 | uv | 速度快、单工具管理 venv/pip/lockfile，项目独立 .venv |
| LLM 健康检查 | 仅在 install.sh / loop 启动时校验 |
每次 timer 触发都校验会增加无意义的 LLM API 调用，运行期异常由 notify_llm_errors 兜底 |
| 日志方案 | journald 命名空间 dnews + MaxRetentionSec |
与系统其他服务隔离，按 log.retention_days 自动轮转，无需写文件日志 |
| 数据格式 | JSON | 结构清晰、易处理、支持嵌套 |
| 推送文件 | Markdown+YAML | 人工可读、Frontmatter 元数据 |
| LLM 评分 | 批量 JSON | 减少 API 调用次数 |
| 状态追踪 | 文件时间戳 | 无需外部数据库 |
| RSS延迟防护 | fetch_lookback_minutes | 防止RSS延迟导致漏读 |
| LLM异常通知 | 调用方统一上报 | 避免批次级刷屏，同时保留关键异常通知 |
| 报告 metadata 统一 | 全部从 LLM frontmatter 解析(早报/晚报/即时) | 取代之前的 extract_title_from_content h1 提取+硬编日期标题；个性化标题 + lead 导读 + highlights 列表统一承载 |
开发进度
2026-05-22
- ✅ 推送 metadata 统一改造：晚报与即时消息也走 frontmatter（之前只有早报）
prompts/digest.md增加 frontmatter（title/lead/highlights），删除正文「开头一句话定调」段prompts/insights.mdfrontmatter 增加lead（综合三段的 60-100 字前言）与highlights（2-3 条卡片重点）prompts/immediate_push.md将# 标题迁到 frontmattertitle字段src/llm.py新增parse_digest_with_metadata/parse_immediate_push_with_metadata，统一_parse_frontmatter帮手；移除extract_title_from_contentsrc/sections/rss/section.py返回三元组(body, metadata, err)；早报丢弃 digest metadata，由 insights 段覆盖- 晚报现在拥有个性化标题 + lead + highlights，与早报对齐
2026-05-17
- ✅ 早报扩展板块上线：在 RSS digest 之上叠加 GitHub Trending / Hacker News / 跨板块洞察三段，仅
schedule.morning_cron命中时触发，晚报维持纯 RSS 行为 - 设计与实施详见
docs/extra-sections-design.md与docs/superpowers/plans/2026-05-17-extra-sections.md
2026-05-15
- 优化提示词，修复长时运行下的新闻报告措辞趋同问题
2026-05-14
- 外置定时（已切换到 systemd timer）
- 系统服务一键运行（
scripts/install.sh） - 使用uv进行python项目管理
- 配置变更：
config.json新增log.retention_days字段 - 新增
daily-news系统级包装脚本：装在/usr/local/bin/daily-news，提供start/stop/restart/status/logs等命令，封装 systemctl/journalctl 调用细节
2026-03-08
- 新增 LLM 异常通知：
compose_digest、generate_immediate_push与score_batch的错误会通过现有推送渠道发送简单告警 - 优化批量评分容错：
score_batch在批次返回数量不匹配时会按link回收可用结果，并聚合错误返回给调用方 - 移除
generate_immediate_push的 fallback 内容，生成失败时由调用方告警并跳过本次即时推送 - 新增启动前 LLM 可用性检查：主程序在启动 fetch/push 双循环前先探测 LLM 接口，失败则直接退出
- 修复 pytest 中遗留的旧推送平台命名问题，将
wecom测试更新为当前feishu实现
2026-03-03
- 采用 MIT 许可开源项目，添加 LICENSE 和 NOTICE 文件
- 更新 RSS 源说明，致谢 BestBlogs 项目
2026-03-02
- 修复RSS延迟漏读问题：新增 fetch_lookback_minutes 参数，fetch时读取过去更长一段时间的RSS条目进行去重
- 新增飞书 Webhook 推送支持：使用卡片消息格式，支持 Markdown 渲染
- 新增测试脚本 test_fetch_lookback.py
- 更新 cleanup_old_files 函数支持 notify 文件清理
2026-03-01
- 优化评分系统：通过更新 score 提示词提升评分质量
- 即时推送去重：新增 notify-*.md 文件存储即时推送，LLM 调用时传入近期推送上下文避免重复
- 汇总推送优化：新增 push_context_days 配置，汇总推送时传入近期推送上下文进行去重
- 修复 score 类型问题：确保 LLM 返回的 score 为整数类型
- 完善测试脚本：添加上下文参数和保存功能
2026-02-28
- 初始化项目，MVP 已完成，支持 RSS 抓取、LLM 评分、定时推送、即时推送。