仓库结构#

顶层目录#

目录

定位

mindiesd/

核心 Python 包,包含层算子、编译、缓存、并行、量化等模块

csrc/

C/C++ 源码(AscendC / triton 算子实现)

tests/

测试套件,按模块与 mindiesd/ 层次对应

examples/

模型推理示例(dummy_run、cache、service、wan)

docs/

Sphinx 文档源码(中英双语)

docker/

开发容器与镜像定义

build/

构建产物

benchmarks/

性能基准数据

pre-commit/

Pre-commit 补充配置(pyproject.toml、typos.toml)

mindiesd/ 关键模块#

模块

说明

layers/

对外加速 API(attn、moe、quant 等 layer 实现)

kernel/

昇腾高性能 kernel 封装

cache/

以存代算(Attention Cache、DiT Cache)

parallelism/

多卡并行(CFG、USP、EPLB)

quantization/

量化自动使能

compilation/

torch.compile 自定义融合 pass

tests/ 测试架构#

子目录

测试对象

tests/cache/

缓存模块

tests/compilation/

编译模块(含 pattern 测试)

tests/layers/

Layer 模块(含 flash_attn 测试)

tests/plugin/

自定义 plugin 算子精度

tests/quantization/

量化模块

tests/eplb/

动态专家负载均衡

tests/UT/

CPU 友好单元测试

tests/scripts/

测试辅助脚本(覆盖率检查等)

测试入口详见 test.md

docs/ 文档架构#

路径

说明

docs/zh/

中文文档

docs/en/

英文文档

docs/zh/developer_guide/

开发者指南(本文所在目录)

docs/zh/features/

加速特性说明

docs/zh/community/

社区治理

关键配置文件#

文件

说明

setup.py / pyproject.toml

Python 包构建与分发

version.py

版本号定义

requirements.txt

核心依赖

requirements-test.txt

测试依赖

requirements-lint.txt

Lint 依赖

.pre-commit-config.yaml

Pre-commit hook 配置

.clang-format

C++ 代码格式

.coveragerc

覆盖率配置

.readthedocs.yaml

Read the Docs 构建