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 后端）

.gitignore

@@ -0,0 +1,63 @@
+# ---- Python ----
+__pycache__/
+*.py[cod]
+*.egg-info/
+*.egg
+build/
+dist/
+.eggs/
+
+# ---- 虚拟环境 ----
+.venv/
+venv/
+env/
+.conda/
+*.conda-env/
+
+# ---- 测试 / 类型检查 ----
+.pytest_cache/
+.ruff_cache/
+.mypy_cache/
+.pyright/
+.coverage
+htmlcov/
+
+# ---- Jupyter ----
+.ipynb_checkpoints/
+*.ipynb.bak
+
+# ---- IDE ----
+.vscode/
+.idea/
+*.swp
+
+# ---- 论文产出（本地生成，不入库）----
+# 图表的中间产物不入库；定稿的成品图请放到 problems/<年份>_<题号>/figures/ 再提交
+figures/*.png
+figures/*.pdf
+!figures/.gitkeep
+tables/*.csv
+!tables/.gitkeep
+
+# ---- 真题原始数据 ----
+# 赛题原始数据文件（体积大、可重新下载）不入库，只提交你写的处理脚本和结论
+problems/**/raw/
+problems/**/*.xlsx
+problems/**/*.csv
+!problems/**/README.md
+
+# ---- 临时文件 ----
+tmp/
+*.log
+*.tmp
+.probe.tmp
+
+# ---- 系统 ----
+Thumbs.db
+desktop.ini
+$RECYCLE.BIN/
+
+# 受限/沙箱环境里 PowerShell 会以当前工作目录为基准生成字面量 "%SystemDrive%"
+# 目录（实际内容是 %SystemDrive%\ProgramData\Microsoft\Windows\Caches，
+# 即 COM 注册表缓存）。正常终端不会出现，删掉也会再生成，所以直接忽略。
+%SystemDrive%/