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.7 KiB
1.7 KiB
更新日志
格式参考 Keep a Changelog， 版本号参考 语义化版本。
[Unreleased]
Added
- 仓库骨架：
src/mcm_toolkit/7 个包（core / data / stats / models / solve / decision / viz） - 顶层
__init__.py只导出 7 个子包 + 8 个快捷函数，__all__即公开 API 清单 core.Result：唯一的结果对象（替代原建议里的 5 个 Result 类）docs/01-suggestion-review.md：对 ChatGPT 建库建议的审查与精简（14 包 → 7 包，~250 函数 → ~40）docs/02-architecture.md：包边界、Result/ RNG /fit-predict-score协议、依赖分层docs/03-roadmap.md：L0/L1/L2 分级 + 永久不做清单docs/04-environment.md：conda / venv 配置与三个已踩的坑docs/dev/function-card-template.md：S 档算法的函数卡片模板.venv（基于 Anaconda base，--system-site-packages）+ 可编辑安装 —— 10.5 MB，离线可用- conda 环境
mcm-toolkit（D:\anaconda\envs\mcm-toolkit）—— Python 3.13.15，含 SALib / pymoo / pyright scripts/setup-conda.ps1/scripts/setup-venv.ps1/scripts/doctor.ps1environment.yml：需联网时的精确复现方案pyproject.toml：核心依赖只 4 个，其余走 extras
Notes
- 所有函数体尚未实现（统一
raise NotImplementedError+TODO(L0/L1/v0.2)标记）。 这是刻意的：先定接口，再按docs/03-roadmap.md的 L0 → L1 顺序填实现。 - 已知缺口：
SALib（Sobol/Morris）、pymoo、pyright未安装（本机离线）。
[0.0.1] - 2026-10-01
Added
- 项目初始化，包结构落盘（实现为空）。