本地开发

npm install -g mintlify

mint --version

mint dev

docs/
├── index.mdx                 # 站点首页
├── docs.json                 # Mintlify 站点配置与导航
├── style.css                 # 自定义主题样式
├── robots.txt                # 搜索引擎与 AI 爬虫指引
├── llms.txt                  # LLM 索引文件
├── AGENTS.md                 # 给 AI Agent 的项目说明
├── images/                   # 图片资源
│   ├── NEC-home.gif
│   ├── qq-group-qrcode.jpg
│   ├── feishu-curc-collection.png
│   └── ...
├── start-here/               # 新手上路（含 learn/ 下的角色与标签说明）
├── modules/                  # 项目模块总览
├── mechanical/               # 机械设计专题
├── vision/                   # 机器视觉专题
├── embedded-software/        # 嵌入式软件专题
├── learn/                    # 学习资源（导航中并入「新手上路」）
├── templates/                # 文档模板
├── wiki/                     # Wiki 知识库
├── ai-tools/                 # AI 工具指南（独立顶部 Tab）
├── competition/              # 竞赛概览
├── curc26/                   # CURC 2026 赛季文档
├── community/                # 社区介绍与治理
├── contributing/             # 贡献指南
└── tools/ci/                 # CI 检查脚本
    └── check_docs.py

---
title: "页面标题"
description: "页面描述"
---

<img src="/images/NEC-home.gif" alt="示例图片" width="400" />

<Card title="标题" icon="icon-name">
  内容描述
</Card>

<CardGroup cols={2}>
  <Card title="卡片1">内容1</Card>
  <Card title="卡片2">内容2</Card>
</CardGroup>

<Steps>
  <Step title="步骤1">说明1</Step>
  <Step title="步骤2">说明2</Step>
</Steps>

python tools/ci/check_docs.py