# Report Format

The source report mode renders a compact text report from a snapshot.

## Header Line

Use this structure:

```text
知乎热榜报告 <snapshot_id>: 共 <item_count> 条，采集于 <captured_at_ms>
```

## Per-Item Line

Use this structure:

```text
<rank>. <title> | 热度 <heat_text> | 评论指标 <metric_count> 条 | 回复 <reply_total> | 赞同 <upvote_total> | 收藏 <favorite_total> | 红心 <heart_total>
```

## Field Semantics

- `metric_count`: number of collected comment metric records for the item
- `reply_total`: sum of reply counts across collected records
- `upvote_total`: sum of upvote counts across collected records
- `favorite_total`: sum of favorite counts across collected records
- `heart_total`: sum of heart counts across collected records

## Missing-Metric Handling

If an item has no collected comment metrics:

- keep the item in the report
- show metric count as `0`
- explicitly note partial data elsewhere in the result summary if the run was incomplete

## Report Mode Behavior

- If a specific snapshot ID is supplied, report from that snapshot.
- Otherwise, use the latest known snapshot.