昇腾产品案例研发实训项目

项目定位

本项目构建一套面向学生学习的产品案例研发实训体系，覆盖 9 个实训（L01-L09），运行于鲲鹏 920B（aarch64）、昇腾 AI 卡（CANN 7.0+）、RK3588、SG2044、Hi3863 等多硬件平台，采用「智能体辅助研发」方式组织教学与交付。

2026 年 8 月 3 日至 8 月 31 日执行第一阶段冲刺，形成 v0.1 基线。

9 个实训

实训	主题	关键链路
L01	鲲鹏上架检测	硬件验收检测主链路
L02	openEuler 与 RAID	系统安装 + RAID 配置
L03	算力切片与容器	资源配置 + Docker Compose
L04	CANN 部署	MindSpore→AIR→OM→AscendCL
L05	RKNN 部署	MindSpore→ONNX→RKNN
L06	CI/CD	lint/test/build/package/deploy-dry-run
L07	边云协同运维	MQTT + Ansible
L08	RAG 应用	Chroma + CLI/SDK + 评测
L09	边缘 AI 应用	Ascend/RKNN 适配层 + MQTT 桥接

目录导航

ascend-ai-engineering/
├── AGENTS.md                     # 智能体入口地图（行为原则/权限/审批点）
├── README.md                     # 本文件
├── EXECUTION-PLAN.md             # 第一阶段冲刺执行计划
├── QUALITY.md                    # 质量要求（G1-G7 门禁 + 11 项指标）
├── GOVERNANCE.md                 # 权限分级 / 审批规则 / 异常升级
├── CHANGELOG.md                  # 变更记录
├── CONTRIBUTING.md               # 贡献指南
├── CODE_OF_CONDUCT.md            # 行为准则
├── LICENSE                       # 开源许可（CC BY-SA 4.0）
├── .gitignore                    # 忽略规则（含本地隐藏目录）
├── pyproject.toml                # Python 工程配置（ruff/pytest 基线）
│
├── 01-baseline/                  # 基线定义（版本/接口/公共库规范）
│   ├── version-matrix.md         # 版本矩阵
│   ├── interface.md              # 接口基线
│   ├── common-libs.md            # 公共库基线
│   ├── project.md                # 项目基线
│   ├── 01-acceptance/            # 验收基线
│   ├── 02-changes/               # 变更记录（active/archive）
│   └── 03-decisions/             # 决策记录
│
├── 02-docs/                      # 文档规范（架构/指南/PM）
│   ├── 01-architecture/          # 架构设计（框架/设计规格/开发指南）
│   ├── 02-guides/                # 规范指南（命名/代码编写/改写策略/开发规范）
│   ├── 03-pm/                    # PM 归档（评估/风险/评审）
│   ├── 04-reports/               # 会议纪要/报告
│   ├── 05-superpowers/           # 流程计划
│   └── 06-assets/                # 文档资源（images/）
│
├── 03-configs/                   # 配置文件（环境/CI）
│
├── 04-common/                    # 公共库（被实训复用的通用能力）
│   ├── 01-ascend/                # 昇腾适配层
│   ├── 02-rknn/                  # RKNN 适配层
│   ├── 03-mqtt/                  # MQTT 客户端 + schema/
│   ├── 04-kb/                    # 知识库工具
│   ├── 05-logging/               # 日志
│   └── 06-testing/               # 测试工具
│
├── 05-scripts/                   # 脚本工具（KB/CoT/初始化）
│   ├── common.py                 # 公共函数
│   ├── init_lab.py               # 实训初始化
│   ├── kb_slicer.py              # KB 四类切片
│   ├── kb_ingest.py              # 知识库摄入
│   ├── kb_ingest_ref.py          # 参考语料入库
│   ├── kb_multihop.py            # 多跳检索路由
│   ├── cot_extractor.py          # CoT 提取
│   ├── cot_enhance.py            # CoT 增强
│   └── run_eval.py               # 检索评测
│
├── 06-kb/                        # 知识库（语料/评测）
│   ├── 01-evals/                 # 评测集（retrieval-test-set.json）
│   └── 02-reference/             # 参考语料
│
├── 07-colab/                     # 课程素材（提纲/讲义/代码）
│   ├── 01-introduction/          # 课程介绍
│   ├── 02-syllabus/              # 实训大纲（L01-L09 + 课程总目录 00-course-outline.md）
│   ├── 03-lectures/              # 讲义
│   ├── 04-handbooks/             # 手册
│   ├── 05-notebooks/             # Notebook
│   ├── 06-src/                   # 示例源码
│   ├── 07-assessments/           # 评测
│   ├── 08-samples/               # Sample 讲义（L01-L09）
│   └── 09-assets/                # 资源
│
├── 08-tests/                     # 测试用例
│   ├── test_kb_slicer.py         # KB 切片测试
│   ├── test_kb_multihop.py       # 多跳检索测试
│   └── test_cot_extractor.py     # CoT 提取测试
│
└── 09-evidence/                  # 证据回执（评测/评审/验证）

说明：本地工作区的隐藏目录（.planning/、.agents/、.loops/、.harness/、.pytest_cache/、.obsidian/、.worktrees/）为智能体辅助研发的本地产物，已纳入 .gitignore，不随仓库分发。

许可声明

文档（讲义、大纲、指南、报告等 Markdown 文档）：采用知识共享署名-相同方式共享 4.0 国际许可协议 (CC BY-SA 4.0) 进行许可。
源代码（Python 脚本、公共库、测试用例等）：采用 MIT License 进行许可。
AI 生成内容声明：本项目部分内容（包括但不限于代码片段、文档草稿）由 AI 辅助生成，经人工审核与校验后纳入。最终内容由项目维护者负责。