Skip to content

开发者指南

MolPy 是一个研究软件库，本文档面向有意贡献的开发者。根据你的目标快速定位：

教程附录命名约定里列出了规范字段名和拓扑键。

贡献

日常开发流程：

  • 开发环境搭建 — 仓库克隆、可编辑安装、从源码构建 molrs、跑测试
  • 贡献工作流 — PR 工作流、提交信息规范、pre-commit 钩子
  • 编码风格 — 标识符风格、格式化要求、可变性约定
  • 测试 — pytest 惯例、测试标记、覆盖率要求、本地测试和外部测试的区别
  • 发布流程 — molpy/molrs 共用版本线、变更日志维护、CI 驱动的包发布
  • 第三方归属 — 移植代码和参数数据使用的许可证说明

架构

扩展功能前需要了解的设计背景：

  • 架构概览 — 模块职责、图与表格两层、格式化器层次、可变性约定、构建循环性能模型
  • molrs 后端 — Rust 列存储和计算内核在 Python 中的呈现：盒子、近邻列表、RDF 和其他分析功能

扩展 MolPy

按从外到内的顺序（从插件接口到核心改动）：

Issue 与讨论