用途
sustainability-summary 用于从 RSS 元数据 SQLite 数据库中检索指定时间窗口内标记为相关的可持续发展证据，并可选地关联来自独立全文数据库中按 DOI 索引的增强内容，构建紧凑的 RAG 上下文，供智能体合成最终的摘要文本。
主要能力
- 仅读取 RSS 数据库中 is_relevant=1 的相关记录。
- 基于 DOI 索引的条目构建紧凑的 RAG 上下文。
- 在可用时，从独立全文数据库的 entry_content 表引入可选的增强内容。
- 让智能体合成带证据锚点的最终摘要文本。
- 支持每日、每周、每月及自定义日期范围的时间窗口模式。
触发条件
- 收到每日、每周或每月的可持续发展摘要请求。
- 收到自定义日期范围的摘要请求。
- 需要基于已标记 RSS 条目和增强内容的证据支撑输出。
输入要求
- 必需表：feeds、entries（来自 sustainability-rss-fetch）。
- entries 必须按 DOI 索引并带有相关性标记。
- 可选全文数据库表：entry_content（来自 sustainability-fulltext-fetch）。
- RSS 数据库与全文数据库必须是不同的文件。
使用方式
设置环境变量并运行脚本：
export SUSTAIN_RSS_DB_PATH="/absolute/path/to/workspace-rss-bot/sustainability_rss.db" export SUSTAIN_FULLTEXT_DB_PATH="/absolute/path/to/workspace-rss-bot/sustainability_fulltext.db"
python3 scripts/time_report.py
--rss-db "$SUSTAIN_RSS_DB_PATH"
--content-db "$SUSTAIN_FULLTEXT_DB_PATH"
--period weekly
--date 2026-02-10
--max-records 120
--max-per-feed 20
--summary-chars 8192
--fulltext-chars 8192
--pretty
--output /tmp/sustainability-weekly-context.json
工作流程：
- 按时间窗口构建检索上下文。
- 从返回的记录和聚合结果生成最终摘要。
- 使用 DOI + URL 为关键论断引用证据。
时间窗口模式：
- --period daily --date YYYY-MM-DD
- --period weekly --date YYYY-MM-DD
- --period monthly --date YYYY-MM-DD
- --period custom --start ... --end ...
默认字段：
doi,timestamp_utc,timestamp_source,feed_title,feed_url,title,url,summary,fulltext_status,fulltext_length,fulltext_excerpt
可配置参数：
--rss-db、--content-db、SUSTAIN_RSS_DB_PATH、SUSTAIN_FULLTEXT_DB_PATH、--period、--date、--start、--end、--max-records、--max-per-feed、--summary-chars、--fulltext-chars、--top-feeds、--top-keywords、--fields、--output、--pretty、--fail-on-empty
错误处理
- 缺少必需的基于 DOI 的表：快速失败并给出设置指引。
- RSS 数据库与全文数据库路径冲突：快速失败并要求使用不同文件。
- 无效的日期/时间/字段列表：返回解析错误。
- 缺少 entry_content：以仅元数据模式继续。
- 相关集合为空：返回空上下文；可通过 --fail-on-empty 选择失败。
参考与资源
- references/time-window-rules.md
- references/report-format.md
- assets/config.example.json
- scripts/time_report.py
适用场景
适用于需要基于 RSS 证据生成可持续发展主题每日、每周、每月或自定义时间段摘要的场景，尤其适合需要引用 DOI 和 URL 作为证据锚点的报告生成。
限制
- 依赖 sustainability-rss-fetch 生成的 feeds 和 entries 表，且 entries 必须按 DOI 索引并带有相关性标记。
- 全文增强内容依赖 sustainability-fulltext-fetch 生成的 entry_content 表，且 RSS 数据库与全文数据库必须为不同文件。
- 缺少 entry_content 时仅能以元数据模式运行。
- 其他功能、收费、价格、平台或效果信息暂未提供。