算子性能建模工具开发指南¶
1. 预备知识¶
请参考 《TileSim 工程架构文档》 学习代码框架及核心流程介绍。
2. 开发环境准备¶
2.1 环境要求¶
- Python ≥ 3.10
- Git
- pip ≥ 23.0
2.2 克隆代码仓库¶
2.3 创建并激活虚拟环境（可选）¶
Linux / macOS：
Windows：
2.4 安装开发依赖¶
[!NOTE] 说明
-e参数以可编辑模式安装，修改源码后无需重新安装即可生效。.[dev]同时安装测试、构建等开发额外依赖。
3. 编译打包¶
构建成功后，wheel 包生成至 dist/ 目录：
4. 执行UT测试¶
输出类似如下，测试通过数与运行数相同即表示成功：
============================== test session starts ==============================
...
========================= 42 passed in 3.21s =================================
如需单独执行某个测试文件：
python -m pytest src/tilesim/tests/ut/core/backend/backend_entity/test_backend_entity_ssa_expand.py -v
5. 项目结构说明¶
msopmodeling/
├── src/
│ ├── main.py # CLI 入口
│ ├── app/ # 应用层（CLI解析、配置加载、结果输出）
│ └── tilesim/ # 核心引擎
│ ├── api/ # 对外 API 接口
│ │ ├── operator_api/ # 算子级 API（主接口）
│ │ ├── tile_op_api/ # Tile Op 级 API
│ │ └── pto_isa_api/ # PTO ISA 级 API
│ ├── core/ # 核心实现
│ │ ├── frontend/ # 前端：DSL 解析与 IR 构建
│ │ ├── backend/ # 后端：性能建模与评估
│ │ ├── pipeline/ # 流水线：端到端处理流程
│ │ ├── common/ # 公共定义（枚举、注册中心）
│ │ └── config/ # 芯片配置文件（arc_config/）
│ ├── ops/ # 算子模型实现
│ │ ├── engineering_model/ # 工程模式算子
│ │ └── theoretical_model/ # 理论模式算子
│ ├── tests/ # 测试
│ │ ├── ut/ # 单元测试
│ │ └── st/ # 系统测试
│ └── docs/ # 内部设计文档
├── tests/ # 根目录测试占位（当前为空）
├── docs/ # 用户文档
├── build.py # 构建脚本
├── download_dependencies.py # 依赖下载脚本
├── dependencies.json # 依赖声明
└── pyproject.toml # 项目配置
6. FAQ¶
6.1 执行测试时报 ModuleNotFoundError: No module named 'core'¶
原因： src/tilesim 内部使用裸路径导入（from core.xxx、from api.xxx），需要 src/tilesim/ 在 sys.path 中。根目录 pyproject.toml 的 [tool.pytest.ini_options] 声明了 pythonpath，pytest 会自动完成注入。
解决方案： 确认从项目根目录运行 pytest，不要 cd 进子目录后运行，否则 pytest 不会读取根目录的配置：
6.2 python build.py 提示 hatch 未安装¶
解决方案： 手动安装 hatch：
6.3 Windows 下激活虚拟环境失败¶
解决方案： 以管理员权限运行 PowerShell，先设置执行策略：