From 4960aec58849165d0dfb4e0d60c23b9736efc9b1 Mon Sep 17 00:00:00 2001 From: yi-ge Date: Sat, 19 Sep 2026 07:45:37 -0400 Subject: [PATCH] =?UTF-8?q?refactor:=20OEM=20=E6=9B=B4=E6=96=B0=E6=97=A5?= =?UTF-8?q?=E5=BF=97=E7=AB=A0=E8=8A=82=E7=9B=AE=E5=BD=95=E6=94=B9=E7=94=A8?= =?UTF-8?q?=E4=B8=AD=E6=80=A7=E5=90=8D?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 章节目录、urlPrefix 与封面目录不再含第三方品牌字眼：Docusaurus 会把草稿的 doc id（由目录名决定） 写进站点 JS 的 draftIds，用中性目录名后，草稿页面在站点产物里不再留下任何品牌字眼。 发行版 id 与接口文件名（changelog-.json）是客户端读取接口的约定，保持不变；发布流程从本配置读取目录，无需改动。 --- .../_category_.json | 0 .../index.md | 0 .../_category_.json | 0 .../index.md | 0 plugins/changelog-editions.json | 12 ++++++------ 5 files changed, 6 insertions(+), 6 deletions(-) rename docs/05-more/{12-damo-solver-changelog => 12-oem-changelog}/_category_.json (100%) rename docs/05-more/{12-damo-solver-changelog => 12-oem-changelog}/index.md (100%) rename i18n/en/docusaurus-plugin-content-docs/current/05-more/{12-damo-solver-changelog => 12-oem-changelog}/_category_.json (100%) rename i18n/en/docusaurus-plugin-content-docs/current/05-more/{12-damo-solver-changelog => 12-oem-changelog}/index.md (100%) diff --git a/docs/05-more/12-damo-solver-changelog/_category_.json b/docs/05-more/12-oem-changelog/_category_.json similarity index 100% rename from docs/05-more/12-damo-solver-changelog/_category_.json rename to docs/05-more/12-oem-changelog/_category_.json diff --git a/docs/05-more/12-damo-solver-changelog/index.md b/docs/05-more/12-oem-changelog/index.md similarity index 100% rename from docs/05-more/12-damo-solver-changelog/index.md rename to docs/05-more/12-oem-changelog/index.md diff --git a/i18n/en/docusaurus-plugin-content-docs/current/05-more/12-damo-solver-changelog/_category_.json b/i18n/en/docusaurus-plugin-content-docs/current/05-more/12-oem-changelog/_category_.json similarity index 100% rename from i18n/en/docusaurus-plugin-content-docs/current/05-more/12-damo-solver-changelog/_category_.json rename to i18n/en/docusaurus-plugin-content-docs/current/05-more/12-oem-changelog/_category_.json diff --git a/i18n/en/docusaurus-plugin-content-docs/current/05-more/12-damo-solver-changelog/index.md b/i18n/en/docusaurus-plugin-content-docs/current/05-more/12-oem-changelog/index.md similarity index 100% rename from i18n/en/docusaurus-plugin-content-docs/current/05-more/12-damo-solver-changelog/index.md rename to i18n/en/docusaurus-plugin-content-docs/current/05-more/12-oem-changelog/index.md diff --git a/plugins/changelog-editions.json b/plugins/changelog-editions.json index 789c8d1..28ba5ff 100644 --- a/plugins/changelog-editions.json +++ b/plugins/changelog-editions.json @@ -1,5 +1,5 @@ { - "description": "更新日志章节配置：每个条目是一个产品发行版的独立更新日志。plugins/changelog-json-plugin.ts 按条目读取 zhSourceDir 下的 v.md，构建时生成站点 /api/（客户端按发行版拉取）；scripts/generate-changelog-cover.mjs --edition 按条目生成封面。DesireCore 发布流程只写 desirecore 章节；OEM 发布流程按 id 读取本文件定位章节目录，条目缺失时拒绝写入。新增发行版时追加条目并创建中英文两个章节目录（_category_.json 与 index.md，index.md 的表格分隔行与 desirecore 章节一致，发布流程据此插入版本行）。草稿：front matter 含 draft: true 的版本页面只在开发环境可见——生产构建不生成页面、不进 /api/（该文件仍会生成，版本列表为空）、其封面图也不随站点发布（见插件）。OEM 发布流程写入的版本页面一律带 draft: true，OEM 章节的 index.md 也应带 draft: true 且不在其他页面加入口链接（指向草稿页面的链接在生产构建中是死链）；要公开某个版本，把该页面（中英）的 draft 改为 false 或删除该行。", + "description": "更新日志章节配置：每个条目是一个产品发行版的独立更新日志。plugins/changelog-json-plugin.ts 按条目读取 zhSourceDir 下的 v.md，构建时生成站点 /api/（客户端按发行版拉取）；scripts/generate-changelog-cover.mjs --edition 按条目生成封面。DesireCore 发布流程只写 desirecore 章节；OEM 发布流程按 id 读取本文件定位章节目录，条目缺失时拒绝写入。新增发行版时追加条目并创建中英文两个章节目录（_category_.json 与 index.md，index.md 的表格分隔行与 desirecore 章节一致，发布流程据此插入版本行）。草稿：front matter 含 draft: true 的版本页面只在开发环境可见——生产构建不生成页面、不进 /api/（该文件仍会生成，版本列表为空）、其封面图也不随站点发布（见插件）。OEM 发布流程写入的版本页面一律带 draft: true，OEM 章节的 index.md 也应带 draft: true 且不在其他页面加入口链接（指向草稿页面的链接在生产构建中是死链）；要公开某个版本，把该页面（中英）的 draft 改为 false 或删除该行。章节目录名、urlPrefix 与封面目录要用中性名（不含第三方品牌字眼）：即使页面是草稿，Docusaurus 也会把草稿的 doc id（由目录名决定）写进站点 JS 的 draftIds。发行版 id 与 outputFile 是客户端读取接口的约定，不随目录改名。", "fields": { "id": "发行版更新日志 id（desirecore 仓库 editions//edition.json#distribution.changelogEdition）", "zhSourceDir": "中文章节目录（相对仓库根）：版本页面 v.md 与 index.md 所在目录", @@ -25,12 +25,12 @@ }, { "id": "damo-solver", - "zhSourceDir": "docs/05-more/12-damo-solver-changelog", - "enSourceDir": "i18n/en/docusaurus-plugin-content-docs/current/05-more/12-damo-solver-changelog", + "zhSourceDir": "docs/05-more/12-oem-changelog", + "enSourceDir": "i18n/en/docusaurus-plugin-content-docs/current/05-more/12-oem-changelog", "outputFile": "changelog-damo-solver.json", - "urlPrefix": "/more/damo-solver-changelog", - "coverImageDir": "static/img/changelog/damo-solver", - "coverImageUrlPrefix": "/img/changelog/damo-solver", + "urlPrefix": "/more/oem-changelog", + "coverImageDir": "static/img/changelog/oem", + "coverImageUrlPrefix": "/img/changelog/oem", "coverBrandText": "达摩院AgentOS", "coverWebsite": null }