# Outputs Layout

`outputs/` 按“来源 + 阶段”分层，避免所有中间产物堆在根目录。

## 目录约定

- `outputs/prompts/`
  - prompt 模板与调试输入
- `outputs/reference/`
  - 手工样例、固定参考输入、通用演示产物
- `outputs/reference/extracted/`
  - 参考提取结果
- `outputs/reference/summary/`
  - 通用摘要结果与 loop 调试产物
- `outputs/reference/filter/`
  - 通用过滤结果与上下文样例
- `outputs/reference/candidates/`
  - 通用 `article_candidate` 样例
- `outputs/freshrss/`
  - FreshRSS 实跑产物
- `outputs/freshrss/raw/`
  - greader 原始响应
- `outputs/freshrss/items/`
  - entry -> `item` 映射结果
- `outputs/freshrss/extracted/`
  - FreshRSS 文章提取结果
- `outputs/freshrss/summary/`
  - FreshRSS 摘要 loop 结果与调试文件
- `outputs/freshrss/filter/`
  - FreshRSS 过滤结果
- `outputs/freshrss/candidates/`
  - FreshRSS `article_candidate` 结果

## 命名原则

- 默认脚本输出应优先写入对应子目录，不再直接写 `outputs/` 根目录。
- 同一条链路的调试文件放在同一阶段目录里，例如 `result.loop.json` 与 `result.loop.attempt-*.json`。
- `reference/` 只放可复用的稳定样例，真实运行数据优先放 `freshrss/`。