docs: refine reader digest flow public/internal rules

This commit is contained in:
root
2026-04-01 16:47:49 +08:00
parent 8aac33bf65
commit 1dc507250d
2 changed files with 71 additions and 3 deletions
+37 -2
View File
@@ -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: