docs: refine reader digest flow public/internal rules
This commit is contained in:
@@ -36,6 +36,7 @@ In the `reader` project, run the FreshRSS pipeline and obtain a real payload.
|
||||
Minimum expected artifacts:
|
||||
|
||||
- `outputs/freshrss/rerun/<run-id>/candidates/openclaw-delivery-payload.json`
|
||||
- `outputs/freshrss/rerun/<run-id>/candidates/digest-brief.json`(public digest 优先读取的轻量输入,仅包含 `keep` 候选)
|
||||
- `outputs/freshrss/rerun/<run-id>/run-report.json`
|
||||
- extracted article data, such as:
|
||||
- `outputs/freshrss/extracted/freshrss.extracted.json`
|
||||
@@ -44,10 +45,13 @@ If the pipeline fails, stop and report the exact failure point.
|
||||
|
||||
### Phase 2: Generate daily digest markdown
|
||||
|
||||
Read the real payload and generate digest markdown for the day.
|
||||
Read the real run outputs and generate digest markdown for the day.
|
||||
If there is no real payload, stop instead of writing a fake or example digest.
|
||||
|
||||
Produce two output views from the same payload:
|
||||
For **public digest**, prefer `candidates/digest-brief.json` when present; fall back to `candidates/openclaw-delivery-payload.json` only if the brief file is missing.
|
||||
For **internal review digest**, continue reading the full `candidates/openclaw-delivery-payload.json`.
|
||||
|
||||
Produce two output views from the same run, preferably in **one generation step**:
|
||||
|
||||
1. **Public digest** — for Hugo / public browsing
|
||||
2. **Internal review digest** — for chat reporting and operator decisions
|
||||
@@ -67,6 +71,15 @@ Recommended **public digest** structure:
|
||||
- `延伸阅读`
|
||||
- `信息来源`
|
||||
|
||||
Public digest writing rules:
|
||||
|
||||
- Use `digest-brief.json` as the default source when available.
|
||||
- Treat it as a public-only view that already excludes non-keep items.
|
||||
- Keep the tone suitable for public browsing and Hugo publishing.
|
||||
- Do **not** expose internal workflow labels or operator language such as `待确认`, `建议沉淀到 IMA`, `keep/review/drop`, or `selection_decision`.
|
||||
- Prefer concise but information-dense writing.
|
||||
- For each item under `今日重点`, include not only summary and highlights, but also one short editor-style value sentence, for example: `这篇内容更值得关注的原因在于……`.
|
||||
|
||||
Recommended **internal review digest** structure:
|
||||
|
||||
- `今日候选概况`
|
||||
@@ -75,6 +88,28 @@ Recommended **internal review digest** structure:
|
||||
- `建议沉淀到 IMA`
|
||||
- `原始候选清单`
|
||||
|
||||
Internal review digest writing rules:
|
||||
|
||||
- Use the full `openclaw-delivery-payload.json`.
|
||||
- Keep this as a human-readable review draft rather than a raw machine dump.
|
||||
- Do **not** display `rank` values.
|
||||
- Convert machine states to Chinese operator-facing labels:
|
||||
- `keep` → `已入选`
|
||||
- `review` → `待确认`
|
||||
- `drop` → `暂不纳入`
|
||||
- For every item under `已入选重点`, include:
|
||||
- title + source
|
||||
- status
|
||||
- a fuller summary paragraph
|
||||
- a short judgment paragraph explaining why it matters in today's digest
|
||||
- For every item under `待你确认`, include:
|
||||
- title + source
|
||||
- status
|
||||
- a fuller summary paragraph
|
||||
- reason
|
||||
- recommendation
|
||||
- In `原始候选清单`, also use Chinese status labels instead of raw machine values.
|
||||
|
||||
### Phase 3: Publish to Hugo
|
||||
|
||||
Publish only the public digest to Hugo and verify:
|
||||
|
||||
Reference in New Issue
Block a user