guzhujushi
5319589dfd
审查并精简 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 后端）
1.1 KiB
1.1 KiB
历年真题
每做一道题，就把"题目 → 思路 → 代码 → 结论"沉淀到这里，
并反向补 1～3 个通用函数进 src/mcm_toolkit/。
这是这个仓库能长期长大的唯一机制：做的是题，积累的是框架。
目录约定
problems/
└── 2025_C/
├── README.md 题目摘要 + 思路 + 结论 + 复盘（**必写**）
├── data/ 处理后的数据（原始数据不入库，见 .gitignore）
├── src/ 这道题的专用代码（不通用、不抽进 toolkit 的部分）
├── figures/ 定稿图（png + pdf）
└── paper/ 论文片段 / LaTeX
复盘问题（每道题做完必答）
- 这道题用到了 toolkit 里的哪些函数？哪些是第一次用？
- 哪些代码是第二次、第三次写了？→ 该抽进 toolkit。
- 哪个函数不够用 / 用起来别扭？→ 改接口。
- 论文里被评审/队友质疑的地方是什么？→ 对应的函数要补文档或补鲁棒性检验。