chore: 初始化 MCM/ICM Toolkit 仓库骨架
审查并精简 ChatGPT 的建库建议后落地的第一版骨架,只定接口不写实现。 - 建议审查:14 个包 → 7 个;约 250 个函数 → 约 40 个;5 个 Result 类 → 1 个 (docs/01-suggestion-review.md) - docs/:架构、路线图(含永久不做清单)、环境、Git 工作流、函数卡片模板 - src/mcm_toolkit/:core / data / stats / models / solve / decision / viz 共 23 个模块,均为签名 + docstring + NotImplementedError - tests/:9 个文件,其中 test_api_surface.py 已通过(20 passed) - examples/ problems/ notebooks/ figures/ tables/ 骨架 - pyproject.toml(核心依赖 4 个 + 6 组 extras)、environment.yml - scripts/:setup-venv.ps1(ASCII + LF)、setup-conda.ps1、doctor.ps1 - 环境:.venv(system-site-packages)与 conda 环境 mcm-toolkit 均已建好, 数值栈版本与 base 完全对齐(numpy 2.4.6 / scipy 1.18.1 / pandas 3.0.6,MKL 后端)
This commit is contained in:
commit
5319589dfd
76 files changed
+6812
No files matched your search
@@ -0,0 +1,25 @@
|
||||
# 历年真题
|
||||
|
||||
每做一道题,就把"题目 → 思路 → 代码 → 结论"沉淀到这里,
|
||||
并**反向补 1~3 个通用函数进 `src/mcm_toolkit/`**。
|
||||
|
||||
这是这个仓库能长期长大的唯一机制:做的是题,积累的是框架。
|
||||
|
||||
## 目录约定
|
||||
|
||||
```text
|
||||
problems/
|
||||
└── 2025_C/
|
||||
├── README.md 题目摘要 + 思路 + 结论 + 复盘(**必写**)
|
||||
├── data/ 处理后的数据(原始数据不入库,见 .gitignore)
|
||||
├── src/ 这道题的专用代码(不通用、不抽进 toolkit 的部分)
|
||||
├── figures/ 定稿图(png + pdf)
|
||||
└── paper/ 论文片段 / LaTeX
|
||||
```
|
||||
|
||||
## 复盘问题(每道题做完必答)
|
||||
|
||||
1. 这道题用到了 toolkit 里的哪些函数?哪些是**第一次用**?
|
||||
2. 哪些代码是**第二次、第三次写**了?→ 该抽进 toolkit。
|
||||
3. 哪个函数**不够用 / 用起来别扭**?→ 改接口。
|
||||
4. 论文里被评审/队友质疑的地方是什么?→ 对应的函数要补文档或补鲁棒性检验。
|
||||
Reference in new issue
Block a user