From 441f14b5f7bb7c1ea773b2fca33e9a0331e0d3ce Mon Sep 17 00:00:00 2001 From: mesalogo Date: Wed, 16 Sep 2026 16:35:44 +0800 Subject: [PATCH] docs: organize PR articles by date and version tag --- docs/pr-articles/README.md | 21 ++++++++++++++++++--- 1 file changed, 18 insertions(+), 3 deletions(-) diff --git a/docs/pr-articles/README.md b/docs/pr-articles/README.md index dae1c4b0..eee2cc57 100644 --- a/docs/pr-articles/README.md +++ b/docs/pr-articles/README.md @@ -87,17 +87,28 @@ tag 与当前 HEAD；明确记录基线 tag、目标提交和检查日期。Agen ## 交付与发布核对 -用户指定位置时按指定位置交付，否则将本轮材料放在 -`docs/pr-articles/drafts/<日期>-<主题>/`。目录只包含本轮文章与必要素材，不改产品代码。 +文章及草稿统一归档在工作流所在目录下，使用 +`docs/pr-articles/YYYY-MM-DD-<版本tag>/`，例如 `docs/pr-articles/2026-09-16-v0.13.6/`。 +日期采用本轮材料首次建立的日期；版本 tag 指文章介绍的目标版本，不是比较区间的起点。 +Agent 专题使用对应的 `agent-v…` tag。 + +草稿与正式稿沿用同一目录，不再单设 `drafts/`；发布时更新正文和状态，保留图片相对路径， +方便整目录交付与传播。目录名不表示版本已经发布，实际状态记录在 `review.md`。 +目标版本尚未确定时暂用 `YYYY-MM-DD-unreleased/`，确定后改为目标 tag 并更新文档链接， +不能自行推测下一版本号。同一版本同一天有多篇文章时，在该目录内按主题建立子目录。 +目录只包含本轮文章与必要素材，不改产品代码。 最小交付： - `article.md`：文章标题、正文、相对路径配图和图注。 - `assets/`：实际取得的图片；如有处理，保留可区分的原图。 -- `review.md`：比较区间、选题理由、事实来源、截图环境与步骤、验证范围和待补事项。 +- `review.md`：草稿／待发布／已发布状态、目标 tag 与提交、比较区间、选题理由、事实来源、 + 截图环境与步骤、验证范围和待补事项；外部发布后补充发布日期与链接。 没有图片时不建空目录。文章草稿中的素材占位必须醒目标注；发布用正文不得留下占位文字。 内部验证细节和编辑备注放在 `review.md`，不混入面向用户的宣传正文。 +新增文章目录时，在本页末尾的文章索引登记日期、目标 tag、标题、状态及正文链接； +正式发布后同步更新状态和外部链接。对外传播正文与所需图片，不附内部核查记录。 交付前检查图片可读、相对路径存在、文章与图片一致、标题没有超出功能事实。 发布前再次确认对应版本可下载、下载链接有效、升级说明准确，且最终版本没有改变演示行为。 @@ -105,3 +116,7 @@ tag 与当前 HEAD；明确记录基线 tag、目标提交和检查日期。Agen 最终回复提供文章和素材位置，概括推荐主题、实际截图情况及剩余阻碍。 只有得到明确发布指令后，才通过可用平台能力执行外部发布；准备文章不等于授权发布。 + +## 文章索引 + +尚无归档文章。创建首篇草稿后，以日期、版本 tag、标题、状态、正文链接和发布链接建立索引表。