05 · 标准
总览
本层定位
05 · 标准是 Xisound 跨中心的公共契约——所有中心(A/B/C/D/E/F)在撰写文档、设计 UI、命名产品、发布材料时都必须遵守的通用规范。 区别于各中心内部的专业规范(如软件开发规范、硬件开发规范),本区是强约束的跨中心契约。
🌟 6 份核心规范（强约束 · 所有人必读）
-
:material-file-document-edit: MD 写作规范 v2.0 ⭐⭐
Markdown 格式契约:Frontmatter / 标题 / 表格 / 代码块 / Mermaid / 9 条视觉组件(.xy-quote / .xy-glossary / .xy-stack / .xy-gantt 等)
受众:所有文档作者 状态:published(v2.0 · 2026-05-11)
-
:material-palette: 3+1 品牌色彩系统 v1.2 ⭐⭐
玫瑰金 / 曦紫 / 极光青 + 夜蓝背景的三色品牌配色;新增产品 6 色 L0-L5 + Admonition 6 组语义配色
受众:Web 前端、UI/UX 设计师、主题维护者 状态:published(v1.2 · 2026-05-11)
-
:material-format-list-bulleted-square: 目录显示规范 v1.0 🆕
mkdocs.yml: theme.features/ nav 顺序 / extra_css/js 加载顺序 / status 徽章 / KaTeX 动态加载受众:文档管理员智能体、主题维护者 状态:published(v1.0 · 2026-05-11)
-
:material-folder-tree: 目录文件夹结构规范 v1.0(IA v3) 🆕
9 个一级目录权威定义 + 二级命名约定 +
_dev/99-archive/特殊目录规则 + 13 稳态产品结构受众:文档管理员智能体、所有作者 状态:published(v1.0 · 2026-05-11)
-
:material-history: 格式变更日志 v1.0(9 条决议) 🆕
2026-05-11 v0.3 视觉对标定稿的 9 条改进决议 · 为 5 份下游规范提供视觉来源依据 · CSS / HTML / JS 完整片段
受众:所有规范的「为何这么改」追溯 状态:published(v1.0 · 2026-05-11)
-
:material-rocket-launch: 迁移计划 2026Q2 v1.0 🆕
4 阶段(P0 基础设施 / P1 高优 / P2 业务架构 / P3 全量收尾)· 12 周完成 332 篇 .md 全量重构 · 执行级蓝图
受众:文档管理员智能体(执行主体)+ 各部门作者(配合方) 状态:published(v1.0 · 2026-05-11)
📚 5 份配套规范（参考性约束）
-
:material-numeric: 文档编号与命名规范
数字段稳态 + 类型前缀过程的命名规范方案 4 + frontmatter 字段全集
-
:material-clipboard-check: PR 自查清单
提交文档 PR 前的必做自查项
-
:material-share-variant: 跨部门交付索引
Web / 硬件 / 测试 / 产品 / 设计 各部门该读哪些规范
-
:material-cube-outline: 技术文档体系总览
全站文档体系的整体框架与规划
-
:material-format-list-checks: 未完成文档清单(TODO)
按 V1.0 规划的进度看板
🚀 快速入口
我是新员工，刚入职 Xisound
按以下顺序通读：MD 写作规范 → 品牌色彩系统，覆盖日常写作 80% 场景。
我是文档管理员 / 主题维护者
- 站点级配置 →
nav-display-spec.md - IA v3 物理结构 →
folder-structure-spec.md - 9 条视觉决议来源 →
format-spec-changelog.md - 阶段执行蓝图 →
migration-plan-2026Q2.md
我是 Web 前端 / UI 设计师
按以下顺序：格式变更日志（决议溯源）→ 品牌色彩系统 v1.2（色板 + Admonition 6 组）。
我提交 PR 前需要自查
→ checklist.md（PR 自查清单 · 强约束）
🎯 6 份核心规范的层级关系
flowchart TD
CL["格式变更日志<br/>9 条视觉决议来源"] -->|引用| BC["品牌色彩系统<br/>色板 + Admonition 6 组"]
CL -->|引用| MD["MD 写作规范<br/>作者唯一契约"]
CL -->|引用| ND["目录显示规范<br/>站点级配置"]
BC --> MD
FS["目录结构规范<br/>IA v3 物理结构"] --> ND
FS -->|frontmatter doc_id| MD
MP["迁移计划 2026Q2<br/>4 阶段执行蓝图"] -->|目标态依据| FS
MP -->|配置目标| ND
MP -->|frontmatter 模板| MD
MP -->|决议落地清单| CL
MP -->|color 变量补齐| BC
classDef xySource fill:#0B1C2E,stroke:#D4A574,color:#fff
classDef xyCore fill:#6B3FA0,stroke:#D4A574,color:#fff
classDef xyConfig fill:#1E3A52,stroke:#D4A574,color:#fff
classDef xyStruct fill:#A83F88,stroke:#D4A574,color:#fff
classDef xyPlan fill:#DFA66D,stroke:#DFA66D,color:#0B1C2E
class CL xySource
class BC,MD xyCore
class ND xyConfig
class FS xyStruct
class MP xyPlan📌 历史追溯
本目录原 D 系列编号为 D0-company/05-standards（legacy_doc_id D0-company/05-standards/index.md），P2 阶段 IA-v3 重构后晋升为一级目录 05 · 标准。
v1.2（2026-05-11）新增 4 份正式规范 + 1 份格式变更日志 + 1 份阶段迁移计划，完整覆盖"目录显示 / 文件夹结构 / 文档色调 / MD 规范 / 视觉决议 / 阶段迁移" 6 大维度。
| 版本 | 日期 | 关键变更 |
|---|---|---|
| v2.0 | 2026-05-13 | IA-v3 frontmatter 统一（status: published 保留 · doc_id 升级到 [L1].[L2].[SEQ]） |
| v1.2 | 2026-05-11 | 新增 4 份正式规范 + 升级 MD 写作 v2.0 + 升级品牌色 v1.2 |
| v1.1 | 2026-05-05 | 拆分色彩规范为独立文件 · Mermaid 引入 L0-L5 classDef |
| v1.0 | 2026-04-XX | 首版发布 |
Xisound 05 · 标准 · v2.0 · 2026-05-13