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 后端）
算法卡片
S 档（自己实现的招牌算法）的函数卡片放这里，模板见
../dev/function-card-template.md。
计划要写的卡片（见 ../03-roadmap.md §3.1，约 15 张）：
| 卡片 | 对应函数 | 状态 |
|---|---|---|
detect_outliers.md |
data.detect_outliers |
⬜ |
bootstrap_ci.md |
stats.bootstrap_ci |
⬜ |
monte_carlo.md |
solve.monte_carlo |
⬜ |
monte_carlo_probability.md |
solve.monte_carlo_probability |
⬜ |
monte_carlo_integral.md |
solve.monte_carlo_integral |
⬜ |
dynamic_programming.md |
solve.dynamic_programming |
⬜ |
knapsack_dp.md |
solve.knapsack_dp |
⬜ |
simulated_annealing.md |
solve.simulated_annealing |
⬜ |
local_sensitivity.md |
solve.local_sensitivity |
⬜ |
sobol_analyze.md |
solve.sobol_analyze |
⬜ |
entropy_weights.md |
decision.entropy_weights |
⬜ |
topsis.md |
decision.topsis |
⬜ |
ahp_weights.md |
decision.ahp_weights |
⬜ |
gm11_fit_predict.md |
decision.gm11_fit_predict |
⬜ |
卡片是写给自己半年后看的，不是给评审看的。 如果一张卡片最后只复述了 docstring，说明这个函数其实是 A 档，应该降档删卡片。