91 lines
2.8 KiB
Markdown
91 lines
2.8 KiB
Markdown
# Outputs Layout
|
|
|
|
`outputs/` 按来源和运行批次组织。当前推荐区分生产产物与调试产物。
|
|
|
|
## 生产默认输出
|
|
|
|
对于 FreshRSS 主流水线，默认保留这 4 类文件：
|
|
|
|
- `outputs/freshrss/rerun/<run_id>/raw/freshrss.raw.json`
|
|
- FreshRSS 原始响应快照
|
|
- `outputs/freshrss/rerun/<run_id>/candidates/openclaw-delivery-payload.json`
|
|
- 发给 OpenClaw 的最终批量 payload
|
|
- `outputs/freshrss/rerun/<run_id>/run-report.json`
|
|
- 本次批处理的运行报告
|
|
- `outputs/freshrss/rerun/<run_id>/extracted/item-XX.extracted.json`
|
|
- 单篇文章的正文提取结果（每篇一份）
|
|
|
|
这是当前推荐的生产模式。
|
|
|
|
## 词元统计运行数据
|
|
|
|
词元统计不放在 `outputs/` 下，而放在单独的运行数据目录：
|
|
|
|
- `data/term_index/daily/YYYY-MM-DD.json`
|
|
- 某一天的日报级 `keywords` 聚合结果
|
|
- `data/term_index/term_stats.json`
|
|
- 全局累计词频统计
|
|
|
|
这两类文件属于可重建的本地运行数据，不作为仓库长期跟踪产物。
|
|
|
|
## 调试扩展输出
|
|
|
|
默认正式产物已经包含：
|
|
|
|
- `outputs/freshrss/rerun/<run_id>/extracted/item-XX.extracted.json`
|
|
- 单篇正文提取结果
|
|
|
|
当启用 `debug_artifacts` 时，才会额外写出这些中间文件：
|
|
|
|
- `outputs/freshrss/rerun/<run_id>/items/`
|
|
- 标准化 `item` 中间文件
|
|
- `outputs/freshrss/rerun/<run_id>/summary/`
|
|
- LLM 总结结果及调试尝试文件
|
|
- `outputs/freshrss/rerun/<run_id>/filter/`
|
|
- 规则过滤结果
|
|
- `outputs/freshrss/rerun/<run_id>/candidates/*.article-candidate-record.json`
|
|
- 内部候选记录
|
|
- `outputs/freshrss/rerun/<run_id>/candidates/*.openclaw-candidate-input.json`
|
|
- 单篇 OpenClaw 输入对象
|
|
|
|
主流水线默认不产出批量聚合版 `freshrss.extracted.json`。
|
|
|
|
## 何时启用调试产物
|
|
|
|
只在这些场景启用：
|
|
|
|
- 某一批次有异常，需要定位是提取、总结还是过滤阶段出错
|
|
- 需要核对某条内容为什么被 `keep` / `review` / `drop`
|
|
- 需要为规则调整收集样本
|
|
|
|
平时不要默认开启。
|
|
|
|
## 参考目录
|
|
|
|
- `outputs/prompts/`
|
|
- Prompt 模板
|
|
- `outputs/reference/`
|
|
- 手工样例、固定参考输入输出
|
|
- `outputs/freshrss/`
|
|
- FreshRSS 实跑批次输出
|
|
|
|
## 命名原则
|
|
|
|
- 每次批处理使用独立目录：`outputs/freshrss/rerun/<timestamp>/`
|
|
- 默认优先保留最终产物，不把所有中间文件都当成长期资产
|
|
- 调试文件只在需要时生成
|
|
- `reference/` 只放可复用样例，不放真实生产批次数据
|
|
- `data/term_index/` 只保存本地词元统计运行数据，不纳入 git 跟踪
|
|
|
|
## 当前建议
|
|
|
|
如果目标是交给 OpenClaw 稳定消费，优先依赖：
|
|
|
|
- `openclaw-delivery-payload.json`
|
|
- `run-report.json`
|
|
- `freshrss.raw.json`
|
|
- `data/term_index/daily/YYYY-MM-DD.json`
|
|
- `data/term_index/term_stats.json`
|
|
|
|
其中前 3 个是本次批处理产物，后 2 个是持续累积的词元统计数据。
|