Skip to content

贡献与变更

Terminal window
pnpm install
pnpm dev

提交前执行:

Terminal window
pnpm verify

运行该命令可一次性校验代码格式、TypeScript 类型、静态构建、文档内部链接、色彩对比度、SVG/PNG 资产一致性以及核心页面无障碍表现。

  • 调整 Logo 图案:修改 assets/logo/source 后,运行 pnpm assets:build 以重新生成导出物。
  • 变更颜色、间距与主题样式:集中修改 apps/docs/src/styles/custom.css,并检查亮暗主题。
  • 完善规范条目:编辑对应页面内容时,需在 CHANGELOG.md 中同步追加更新记录。
  • 严禁直接编辑生成的 PNG 图片或规范网站中的下载副本。
  • Patch:错别字、说明补充、不改变用法的资产修正。
  • Minor:新增模板或向后兼容的规范。
  • Major:改变 Logo 构成或修改既有规范语义。

对于破坏性变更,必须提供详细的迁移指南,并保留至少一个次要(Minor)版本的废弃过渡期。

Logo、品牌名称、主色和授权边界由组织维护者批准。评审需要包含动机、受影响资产、小尺寸和单色预览、亮暗背景测试以及无障碍影响。

制定的规则应描述为可度量、可验证的行为,避免采用“现代、简洁、舒适”等无法客观执行的形容词。编写的示例数据严禁包含真实的学生信息、账号、访问令牌或未经授权的学校内部机密资料。