Files
MCM-ICM_Toolkit/problems/README.md
T
guzhujushi 5319589dfd 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 后端)
2026-10-01 17:43:48 +08:00

26 lines
1.1 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 历年真题
每做一道题,就把"题目 → 思路 → 代码 → 结论"沉淀到这里,
并**反向补 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. 论文里被评审/队友质疑的地方是什么?→ 对应的函数要补文档或补鲁棒性检验。