审查并精简 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 后端)
26 lines
1.1 KiB
Markdown
26 lines
1.1 KiB
Markdown
# 历年真题
|
||
|
||
每做一道题,就把"题目 → 思路 → 代码 → 结论"沉淀到这里,
|
||
并**反向补 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. 论文里被评审/队友质疑的地方是什么?→ 对应的函数要补文档或补鲁棒性检验。
|