[{"data":1,"prerenderedAt":4},["ShallowReactive",2],{"doc-\u002Fzh-Hans\u002Fshouzha\u002Fdev-guide\u002FDEV-001-documentation-layout-and-frontmatter\u002F":3},"\u003Ch1 id=\"dev-001%3A-%E6%96%87%E6%A1%A3%E5%B8%83%E5%B1%80%E4%B8%8E-frontmatter-%E8%A6%81%E6%B1%82\" tabindex=\"-1\">\u003Ca class=\"header-anchor\" href=\"#dev-001%3A-%E6%96%87%E6%A1%A3%E5%B8%83%E5%B1%80%E4%B8%8E-frontmatter-%E8%A6%81%E6%B1%82\">#\u003C\u002Fa> DEV-001: 文档布局与 Frontmatter 要求\u003C\u002Fh1>\n\u003Ch2 id=\"1.-%E6%96%87%E6%A1%A3%E4%BD%8D%E7%BD%AE%E6%A6%82%E8%A7%88\" tabindex=\"-1\">\u003Ca class=\"header-anchor\" href=\"#1.-%E6%96%87%E6%A1%A3%E4%BD%8D%E7%BD%AE%E6%A6%82%E8%A7%88\">#\u003C\u002Fa> 1. 文档位置概览\u003C\u002Fh2>\n\u003Cp>所有公开文档集中在 \u003Ccode>docs\u002Fi18n\u002F{lang}\u002F\u003C\u002Fcode> 下。\u003C\u002Fp>\n\u003Cpre data-lang=\"bash\" class=\"shiki github-light\" style=\"background-color:#fff;color:#24292e\" tabindex=\"0\">\u003Ccode>\u003Cspan class=\"line\">\u003Cspan style=\"color:#6A737D\"># 有英文版时 symlink 到英文版（GitHub 默认显示）\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#6F42C1\">packages\u002Fvue-app\u002FREADME.md\u003C\u002Fspan>\u003Cspan style=\"color:#032F62\"> →\u003C\u002Fspan>\u003Cspan style=\"color:#032F62\"> ..\u002F..\u002Fdocs\u002Fi18n\u002Fen\u002FREADME.md\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#6A737D\"># 无英文版时 symlink 到中文版\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#6F42C1\">packages\u002Ffastapi-server\u002FREADME.md\u003C\u002Fspan>\u003Cspan style=\"color:#032F62\"> →\u003C\u002Fspan>\u003Cspan style=\"color:#032F62\"> ..\u002F..\u002Fdocs\u002Fi18n\u002Fzh-Hans\u002FREADME.md\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003C\u002Fspan>\u003C\u002Fcode>\u003C\u002Fpre>\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>位置\u003C\u002Fth>\n\u003Cth>文件类型\u003C\u002Fth>\n\u003Cth>lang 值\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\n\u003Ctr>\n\u003Ctd>\u003Ccode>docs\u002Fi18n\u002F{lang}\u002F*.md\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>DEV-NNN, CFG-NNN, USER-NNN, REF-NNN（根文档）\u003C\u002Ftd>\n\u003Ctd>zh-Hans \u002F en\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>docs\u002Fi18n\u002F{lang}\u002F{pkg}\u002F*.md\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>包子文档（README, INDEX）\u003C\u002Ftd>\n\u003Ctd>zh-Hans \u002F en\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\n\u003C\u002Ftable>\n\u003Cp>\u003Cstrong>非公开目录\u003C\u002Fstrong>（不纳入 frontmatter 标准化）：\u003C\u002Fp>\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>目录\u003C\u002Fth>\n\u003Cth>原因\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\n\u003Ctr>\n\u003Ctd>\u003Ccode>plans\u002F\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>计划文档，有自身 PLAN metadata 规范\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>SPRINTS\u002F\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>Sprint 文档\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>.github\u002F\u003C\u002Fcode>、\u003Ccode>.kilo\u002F\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>Agent 配置\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>AGENTS.md\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>AI Agent 指引\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>CHANGELOG.md\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>变更日志，有自身格式\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>.changeset\u002F\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>Changeset 文件\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>docs\u002F基于Python的自动部署方案设计.md\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>历史设计记录\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\n\u003C\u002Ftable>\n\u003Ch2 id=\"2.-%E7%BB%9F%E4%B8%80-frontmatter-schema\" tabindex=\"-1\">\u003Ca class=\"header-anchor\" href=\"#2.-%E7%BB%9F%E4%B8%80-frontmatter-schema\">#\u003C\u002Fa> 2. 统一 Frontmatter Schema\u003C\u002Fh2>\n\u003Cp>所有公开文档必须使用以下统一的 frontmatter schema：\u003C\u002Fp>\n\u003Cpre data-lang=\"yaml\" class=\"shiki github-light\" style=\"background-color:#fff;color:#24292e\" tabindex=\"0\">\u003Ccode>\u003Cspan class=\"line\">\u003Cspan style=\"color:#6F42C1\">---\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#22863A\">title\u003C\u002Fspan>\u003Cspan style=\"color:#24292E\">: \u003C\u002Fspan>\u003Cspan style=\"color:#032F62\">\"文档标题\"\u003C\u002Fspan>\u003Cspan style=\"color:#6A737D\">              # text, 必填。文档显示标题\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#22863A\">category\u003C\u002Fspan>\u003Cspan style=\"color:#24292E\">: \u003C\u002Fspan>\u003Cspan style=\"color:#032F62\">user-guide\u003C\u002Fspan>\u003Cspan style=\"color:#6A737D\">            # text, 必填。枚举值见下方\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#22863A\">sidebar_order\u003C\u002Fspan>\u003Cspan style=\"color:#24292E\">: \u003C\u002Fspan>\u003Cspan style=\"color:#005CC5\">1\u003C\u002Fspan>\u003Cspan style=\"color:#6A737D\">                 # number, 可选。同 category 内排序\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#22863A\">lang\u003C\u002Fspan>\u003Cspan style=\"color:#24292E\">: \u003C\u002Fspan>\u003Cspan style=\"color:#032F62\">zh-Hans\u003C\u002Fspan>\u003Cspan style=\"color:#6A737D\">                    # text, 必填。BCP 47 语言标签\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#22863A\">sidebar_group\u003C\u002Fspan>\u003Cspan style=\"color:#24292E\">: \u003C\u002Fspan>\u003Cspan style=\"color:#032F62\">\"开发指南\"\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#22863A\">tags\u003C\u002Fspan>\u003Cspan style=\"color:#24292E\">:                            \u003C\u002Fspan>\u003Cspan style=\"color:#6A737D\"># list, 可选。标签列表\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#24292E\">    - \u003C\u002Fspan>\u003Cspan style=\"color:#032F62\">indexeddb\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#24292E\">    - \u003C\u002Fspan>\u003Cspan style=\"color:#032F62\">sync\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#22863A\">status\u003C\u002Fspan>\u003Cspan style=\"color:#24292E\">: \u003C\u002Fspan>\u003Cspan style=\"color:#032F62\">active\u003C\u002Fspan>\u003Cspan style=\"color:#6A737D\">                   # text, 可选。active | deprecated | draft\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#22863A\">created\u003C\u002Fspan>\u003Cspan style=\"color:#24292E\">: \u003C\u002Fspan>\u003Cspan style=\"color:#005CC5\">2026-05-20\u003C\u002Fspan>\u003Cspan style=\"color:#6A737D\">              # date, 可选。ISO 8601，创建日期\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#22863A\">updated\u003C\u002Fspan>\u003Cspan style=\"color:#24292E\">: \u003C\u002Fspan>\u003Cspan style=\"color:#005CC5\">2026-06-06\u003C\u002Fspan>\u003Cspan style=\"color:#6A737D\">              # date, 可选。ISO 8601，最后更新日期\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#22863A\">version\u003C\u002Fspan>\u003Cspan style=\"color:#24292E\">: \u003C\u002Fspan>\u003Cspan style=\"color:#005CC5\">1.0\u003C\u002Fspan>\u003Cspan style=\"color:#6A737D\">                     # text, 可选。语义化版本号\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#6F42C1\">---\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003C\u002Fspan>\u003C\u002Fcode>\u003C\u002Fpre>\u003Ch3 id=\"2.1.-category-%E6%9E%9A%E4%B8%BE%E5%80%BC\" tabindex=\"-1\">\u003Ca class=\"header-anchor\" href=\"#2.1.-category-%E6%9E%9A%E4%B8%BE%E5%80%BC\">#\u003C\u002Fa> 2.1. category 枚举值\u003C\u002Fh3>\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>值\u003C\u002Fth>\n\u003Cth>适用范围\u003C\u002Fth>\n\u003Cth>LYJ sidebar 分区\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\n\u003Ctr>\n\u003Ctd>\u003Ccode>user-guide\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>USER-* 用户指南、\u003Ca href=\"http:\u002F\u002FREADME.md\">README.md\u003C\u002Fa> 包介绍\u003C\u002Ftd>\n\u003Ctd>用户手册\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>dev-guide\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>DEV-\u003Cem>、REF-\u003C\u002Fem> 开发者文档、CFG-* 配置参考\u003C\u002Ftd>\n\u003Ctd>开发手册\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\n\u003C\u002Ftable>\n\u003Cblockquote>\n\u003Cp>\u003Ccode>config\u003C\u002Fcode>、\u003Ccode>api\u003C\u002Fcode>、\u003Ccode>adr\u003C\u002Fcode> 等 category 在 LYJ 中暂未渲染。如需新增分区，需同步更新 \u003Ccode>LingYiJu\u002Fpackages\u002Fproject\u002Fgenerate-config.ts\u003C\u002Fcode> 的 \u003Ccode>catOrder\u003C\u002Fcode>。\u003C\u002Fp>\n\u003C\u002Fblockquote>\n\u003Ch3 id=\"2.2.-lang-%E5%AD%97%E6%AE%B5\" tabindex=\"-1\">\u003Ca class=\"header-anchor\" href=\"#2.2.-lang-%E5%AD%97%E6%AE%B5\">#\u003C\u002Fa> 2.2. lang 字段\u003C\u002Fh3>\n\u003Cp>BCP 47 语言标签，使用 script-based 而非 region-based：\u003C\u002Fp>\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>标签\u003C\u002Fth>\n\u003Cth>含义\u003C\u002Fth>\n\u003Cth>适用场景\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\n\u003Ctr>\n\u003Ctd>\u003Ccode>zh-Hans\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>简体中文（书写系统）\u003C\u002Ftd>\n\u003Ctd>默认语言，地域中立\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>en\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>英语\u003C\u002Ftd>\n\u003Ctd>英文翻译\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\n\u003C\u002Ftable>\n\u003Ch3 id=\"2.3.-%E8%A2%AB-lyj-%E7%AB%99%E7%82%B9%E8%B7%B3%E8%BF%87%E6%B8%B2%E6%9F%93%E7%9A%84%E6%96%87%E6%A1%A3\" tabindex=\"-1\">\u003Ca class=\"header-anchor\" href=\"#2.3.-%E8%A2%AB-lyj-%E7%AB%99%E7%82%B9%E8%B7%B3%E8%BF%87%E6%B8%B2%E6%9F%93%E7%9A%84%E6%96%87%E6%A1%A3\">#\u003C\u002Fa> 2.3. 被 LYJ 站点跳过渲染的文档\u003C\u002Fh3>\n\u003Cp>以下文件会被 LYJ 自动排除，不需要特殊标记：\u003C\u002Fp>\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>排除规则\u003C\u002Fth>\n\u003Cth>效果\u003C\u002Fth>\n\u003Cth>依据\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\n\u003Ctr>\n\u003Ctd>\u003Ccode>**\u002FINDEX.md\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>所有 \u003Ca href=\"http:\u002F\u002FINDEX.md\">INDEX.md\u003C\u002Fa> 不生成页面\u003C\u002Ftd>\n\u003Ctd>LYJ \u003Ccode>DocSource.excludePatterns\u003C\u002Fcode>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>无 frontmatter\u003C\u002Ftd>\n\u003Ctd>跳过渲染\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>scan()\u003C\u002Fcode> 检测\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>category 不在 \u003Ccode>catOrder\u003C\u002Fcode> 中\u003C\u002Ftd>\n\u003Ctd>跳过渲染\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>scan()\u003C\u002Fcode> 检测\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\n\u003C\u002Ftable>\n\u003Cp>\u003Ccode>skip_doc_render\u003C\u002Fcode> 字段仍然有效，但仅作为\u003Cstrong>每文件覆盖开关\u003C\u002Fstrong>——正常情况下不需要在 frontmatter 中设置它。\u003C\u002Fp>\n\u003Ch3 id=\"2.4.-%E5%90%84%E4%BD%8D%E7%BD%AE%E5%AD%97%E6%AE%B5%E8%A6%81%E6%B1%82\" tabindex=\"-1\">\u003Ca class=\"header-anchor\" href=\"#2.4.-%E5%90%84%E4%BD%8D%E7%BD%AE%E5%AD%97%E6%AE%B5%E8%A6%81%E6%B1%82\">#\u003C\u002Fa> 2.4. 各位置字段要求\u003C\u002Fh3>\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>位置\u003C\u002Fth>\n\u003Cth>必填字段\u003C\u002Fth>\n\u003Cth>可选字段\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\n\u003Ctr>\n\u003Ctd>\u003Ccode>docs\u002Fi18n\u002F{lang}\u002F*.md\u003C\u002Fcode> (根文档)\u003C\u002Ftd>\n\u003Ctd>title, category, lang\u003C\u002Ftd>\n\u003Ctd>sidebar_order, tags, status, created, updated, version\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>docs\u002Fi18n\u002F{lang}\u002Fpackages\u002F{pkg}\u002FREADME.md\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>title, category, lang\u003C\u002Ftd>\n\u003Ctd>sidebar_order\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\n\u003C\u002Ftable>\n\u003Cblockquote>\n\u003Cp>\u003Ca href=\"http:\u002F\u002FINDEX.md\">INDEX.md\u003C\u002Fa> 由 LYJ 端排除，无需 frontmatter 约束。\u003Ca href=\"http:\u002F\u002FREADME.md\">README.md\u003C\u002Fa> 如需在 LYJ 站点显示，需有 title + category；仅在 GitHub 展示则省略 frontmatter 即可。\u003C\u002Fp>\n\u003C\u002Fblockquote>\n\u003Ch3 id=\"2.5.-sidebar_order-%E5%88%86%E9%85%8D%E7%AD%96%E7%95%A5\" tabindex=\"-1\">\u003Ca class=\"header-anchor\" href=\"#2.5.-sidebar_order-%E5%88%86%E9%85%8D%E7%AD%96%E7%95%A5\">#\u003C\u002Fa> 2.5. sidebar_order 分配策略\u003C\u002Fh3>\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>文件模式\u003C\u002Fth>\n\u003Cth>策略\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\n\u003Ctr>\n\u003Ctd>\u003Ccode>docs\u002Fi18n\u002F{lang}\u002FDEV-NNN\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>按编号：DEV-001=1, …, DEV-010=10\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>docs\u002Fi18n\u002F{lang}\u002FUSER-NNN\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>按编号\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>docs\u002Fi18n\u002F{lang}\u002FREF-NNN\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>按编号\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>docs\u002Fi18n\u002F{lang}\u002FCFG-NNN\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>=1\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>docs\u002Fi18n\u002F{lang}\u002Fknown-issues\u002F*\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>=99\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>docs\u002Fi18n\u002F{lang}\u002Fpackages\u002F*\u002FREADME.md\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>README=1\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\n\u003C\u002Ftable>\n\u003Ch2 id=\"3.-%E6%96%87%E6%A1%A3%E7%BC%96%E5%8F%B7%E7%BA%A6%E5%AE%9A\" tabindex=\"-1\">\u003Ca class=\"header-anchor\" href=\"#3.-%E6%96%87%E6%A1%A3%E7%BC%96%E5%8F%B7%E7%BA%A6%E5%AE%9A\">#\u003C\u002Fa> 3. 文档编号约定\u003C\u002Fh2>\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>前缀\u003C\u002Fth>\n\u003Cth>范围\u003C\u002Fth>\n\u003Cth>说明\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\n\u003Ctr>\n\u003Ctd>DEV-NNN\u003C\u002Ftd>\n\u003Ctd>开发指南\u003C\u002Ftd>\n\u003Ctd>架构、设计、环境搭建、集成等\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>USER-NNN\u003C\u002Ftd>\n\u003Ctd>用户手册\u003C\u002Ftd>\n\u003Ctd>功能指南、操作说明\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>REF-NNN\u003C\u002Ftd>\n\u003Ctd>参考\u003C\u002Ftd>\n\u003Ctd>迁移策略、演变历史、深度主题\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>CFG-NNN\u003C\u002Ftd>\n\u003Ctd>配置参考\u003C\u002Ftd>\n\u003Ctd>环境变量、配置文件说明\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\n\u003C\u002Ftable>\n\u003Cp>\u003Ccode>adr\u002F\u003C\u002Fcode> 目录下的 ADR 文档使用独立编号体系（\u003Ccode>ADR-NNN-title.md\u003C\u002Fcode>）。\u003C\u002Fp>\n\u003Ch2 id=\"4.-%E6%96%B0%E5%A2%9E%E6%96%87%E6%A1%A3%E6%A3%80%E6%9F%A5%E6%B8%85%E5%8D%95\" tabindex=\"-1\">\u003Ca class=\"header-anchor\" href=\"#4.-%E6%96%B0%E5%A2%9E%E6%96%87%E6%A1%A3%E6%A3%80%E6%9F%A5%E6%B8%85%E5%8D%95\">#\u003C\u002Fa> 4. 新增文档检查清单\u003C\u002Fh2>\n\u003Cp>新增公开文档时，请确保：\u003C\u002Fp>\n\u003Col>\n\u003Cli>[ ] 文件位于 \u003Ccode>docs\u002Fi18n\u002F{lang}\u002F\u003C\u002Fcode> 下对应的子目录\u003C\u002Fli>\n\u003Cli>[ ] 包含统一 frontmatter：\u003Ccode>title\u003C\u002Fcode>、\u003Ccode>category\u003C\u002Fcode>、\u003Ccode>lang\u003C\u002Fcode> 必填\u003C\u002Fli>\n\u003Cli>[ ] \u003Ccode>sidebar_order\u003C\u002Fcode> 不与该 category 内现有文档冲突\u003C\u002Fli>\n\u003Cli>[ ] 仅 GitHub 展示的文档（如根 README）省略 frontmatter，无需 doc site 渲染\u003C\u002Fli>\n\u003Cli>[ ] 想被 doc site 渲染的文件必须有 frontmatter 且 \u003Ccode>category\u003C\u002Fcode> 在允许值中\u003C\u002Fli>\n\u003Cli>[ ] \u003Ccode>lang\u003C\u002Fcode> 值必须与所在目录的语言一致\u003C\u002Fli>\n\u003Cli>[ ] 文件命名符合 \u003Ccode>[PREFIX-]NNN-name.md\u003C\u002Fcode> 格式（如 \u003Ccode>DEV-003-cmtx-integration.md\u003C\u002Fcode>）\u003C\u002Fli>\n\u003C\u002Fol>\n\u003Cp>\u003Ca href=\"http:\u002F\u002FINDEX.md\">INDEX.md\u003C\u002Fa> 等纯导航文件不需要特殊设置——LYJ 端自动排除。\u003C\u002Fp>\n\u003Ch2 id=\"5.-%E5%8F%82%E8%80%83\" tabindex=\"-1\">\u003Ca class=\"header-anchor\" href=\"#5.-%E5%8F%82%E8%80%83\">#\u003C\u002Fa> 5. 参考\u003C\u002Fh2>\n\u003Cul>\n\u003Cli>\u003Ccode>CMTX docs\u002Fi18n\u002Fzh-Hans\u002FDEV-010-documentation-layout-and-frontmatter.md\u003C\u002Fcode> — CMTX 原始规范（含完整调研背景）\u003C\u002Fli>\n\u003Cli>\u003Ccode>LingYiJu\u002Fpackages\u002Fproject\u002Fgenerate-config.ts\u003C\u002Fcode> — LYJ 端扫描和排除逻辑\u003C\u002Fli>\n\u003C\u002Ful>\n",1786290225434]