📘 Elite 内容生产 — 分阶段操作手册

版本 2026-05-16 · 对应仓库 cur_project/elite · 正式环境执行（bootstrap_workspace_env + cur_project/.venv）

两种用法并存：① 分阶段 + 按需求 ID 重跑（当前主力，本手册重点）； ② 未来 START→DOCX 一体化编排（规划中，不替代单步重跑）。

1. 快速对照：我想做哪一步？

对运营说人话时，请用右侧阶段代号，避免「跑一下 prefill」「弄下 gate」等含糊说法。

你想做的事	阶段代号	单篇命令要点
从 project_require 同步任务 + 拉 SERP 列表（不含正文）	P0-START	`run_prefill_start.py --project elite --execute`
物料梳理：正文抓取 + 竞品工具 + full_pass/PAA 门禁	P1-MA	`run_prefill_ma.py --project elite --execute` 或按 ID
仅补 SERP/blog 采集循环	P1-MA-LOOP	`run_serp_blog_material_loop.py`
内容类型（五类）+ Brief 结构（UP 第二跳）	P2-TYPE-BRIEF	`run_prefill_generation.py --requirement-id N`
只生成撰写 Prompt（不写文章）	P3-PROMPT	`generate_writing_prompt.py --requirement-id N`
撰写初稿（Gemini）	P4-WRITE	`generate_writing_prompt.py --requirement-id N --gemini-article`
本地化 / 润色 → `*.localized.md`	P5-LOCAL	`run_localization.py --requirement-id N`
终稿：Gate v1 → GPT‑5.5 → Gate v2 → DOCX（主链，无 Kimi QA）	P6-FINAL	`run_final_delivery_pipeline.py --requirement-id N`
只重导 DOCX（不改稿，用已有 final-delivery.md）	P6-DOCX-ONLY	Python 调 `export_final_docx_for_requirement`（见 §8）
重置预填数据后从头来	RESET	`reset_prefill_pipeline_data.py --dry-run` / `--execute`
~~润色后 Kimi 编辑部 QA~~（主链已废弃）	—	勿用 `run_qa.py` 作默认交付

2. 阶段代号总表（标准名称）

代号	中文名	脚本	前置条件	成功后库/文件
P0-START	预填起点 / SERP 入库	`scripts/run_prefill_start.py`	`project_require` 有行	`writing_requirements`、organic/blog/paa 表
P1-MA	物料梳理（原 MA；legacy 路径里曾称 Kimi 校验）	`scripts/run_prefill_ma.py`	START 已跑；建议 full_pass≥2 且 paa≥2 再放行 Type（业务口径，见大脑讨论稿）	blog 正文、竞品 JSON；MA report JSON
P2-TYPE-BRIEF	类型 + Brief（UP）	`scripts/run_prefill_generation.py`	MA 放行；`ELITE_PREFILL_PIPELINE_VARIANT=brief_outline_up`	`prefill_data_status=complete`、`prefill_snapshot`
P3-PROMPT	撰写 Prompt 拼装	`scripts/generate_writing_prompt.py`	P2 完成	`write/{lang}/prompt_*.md`；`status≈prompt_ready`
P4-WRITE	撰写初稿	同上 + `--gemini-article`	P3 或 P2+P3	`write/{lang}/writed_*.md`；`status≈draft_ready`
P5-LOCAL	本地化润色	`scripts/run_localization.py`	P4 有初稿	`local/{lang}/output/*.localized.md`；`localizer_status=localized_ready`
P6-FINAL	终稿交付链	`scripts/run_final_delivery_pipeline.py`	P5 有 localized	Gate 报告、`.final-delivery.md`、`.docx`；`status=completed`

主链终稿子步骤（都在 P6-FINAL 一次脚本内，勿与「Kimi QA」混淆）：
P6a 交付检查 Gate v1（程序化） → P6b GPT‑5.5 终稿升华 → P6c 交付检查 Gate v2 → P6d DOCX 导出 + format report

3. 用哪个 ID？

Elite 流水线（推荐）

writing_requirements.id（整数，如 296、277）— 所有 --requirement-id / --ids 均指它。

看板文章日页流程链接：?flow=296 即 WR id。

Solix / 批采集

content_id — 过滤 project_require 批次（如 --min-content-id N），不是撰写脚本主键。

操作习惯：批处理用 content_id；单篇重跑用 WR id。

4. 标准顺序（UP 主链）

P0-START → P1-MA → P2-TYPE-BRIEF → P3-PROMPT → P4-WRITE → P5-LOCAL → P6-FINAL
   │            │            │                 │              │            │            └─ DOCX + completed
   │            │            │                 │              │            └─ *.localized.md
   │            │            │                 │              └─ writed_*.md (Gemini)
   │            │            │                 └─ prompt_*.md
   │            │            └─ prefill_data_status=complete
   │            └─ SERP 正文 + 竞品工具（物料梳理）
   └─ WR 同步 + SERP 表

分阶段重跑：只需从出问题的那一段重跑，并保证其输入产物仍有效（例如只重跑 P6 需已有 localized 或 final-delivery 源）。

一体化（规划）：未来单命令跑全链；不会取消按 ID 单步重跑能力。

5. 命令模板（服务器上执行）

工作目录与解释器（每条命令前执行一次）：

cd /home/ubuntu/cur_project/elite
source /home/ubuntu/cur_project/.venv/bin/activate
export PYTHONPATH=.

P0-START — 项目级

export ELITE_PREFILL_PIPELINE_VARIANT=brief_outline_up
python3 scripts/run_prefill_start.py --project elite --execute

P1-MA — 项目级或按 ID

python3 scripts/run_prefill_ma.py --project elite --execute
# 或单篇/多篇（若脚本支持 --ids）：
# python3 scripts/run_prefill_ma.py --ids 296,297

P2-TYPE-BRIEF

export ELITE_PREFILL_PIPELINE_VARIANT=brief_outline_up
python3 scripts/run_prefill_generation.py --requirement-id 296

P3-PROMPT + P4-WRITE

# 仅 Prompt：
python3 scripts/generate_writing_prompt.py --requirement-id 296
# Prompt + Gemini 初稿（撰写模型见 .env.shared ELITE_GEMINI_ARTICLE_MODEL）：
python3 scripts/generate_writing_prompt.py --requirement-id 296 --gemini-article

P5-LOCAL

python3 scripts/run_localization.py --requirement-id 296
# 或多篇：
python3 scripts/run_localization.py --ids 296,297,293,319

P6-FINAL

python3 scripts/run_final_delivery_pipeline.py --requirement-id 296

调试导出 MA+Type+Brief 物料包

python3 scripts/export_pipeline_ma_type_brief_bundle.py --requirement-id 296

6. 库字段：怎么判断卡在哪？

字段	含义	典型值
`prefill_data_status`	预填是否完成	`complete` 才能 P3+
`status`	主生命周期	`pending` → `prompt_ready` → `draft_ready` → `completed`
`localizer_status`	润色是否完成	`localized_ready` 后才能 P6
`prefill_snapshot.pipeline_variant`	流程变体	UP 主链：`brief_outline_up`

（规划中的 pipeline_stage / ma_pending 尚未入库时，以 status + 上表为准。）

7. 常用组合包（口语 → 代号）

口语	执行阶段序列
「从预填到 Brief」	P2-TYPE-BRIEF
「从 Brief 到初稿」	P3-PROMPT + P4-WRITE（可一条命令 --gemini-article）
「从初稿到润色」	P5-LOCAL
「从润色到交 DOCX」	P6-FINAL
「新词全流程（已有 SERP）」	P1-MA → P2 → P3 → P4 → P5 → P6
「只修 DOCX 格式」	P6-DOCX-ONLY（需已有 final-delivery 或 localized 作源）

8. DOCX 交付合格标准

*.docx.format-report.md → Result: DELIVERED_OK
无 python-docx not installed；Conclusion 为单独一行 + 总结段（FR: **Conclusion**，DE: **Fazit**）
有序列表有 Word 原生编号（非满屏 1. 1. 1.）
路径：{lang}/{date}/article{id}_{slug}/article{id}_{slug}.docx

看板入口：文章下载 / 按日浏览 · 单篇流程调试：/materials/elite/de/day/YYYY-MM-DD?flow={id}

相关文档（仓库内）：elite/cursor-interactions/elite/2026-05-16-workflow-adjustment-proposals-for-brain.md · elite/docs/ELITE_PIPELINE_PRODUCT_DESIGN.md · 代码主链：elite_pipeline/final_delivery_pipeline.py