MCM-ICM_Toolkit

11 Commits 1 Branch 0 Tags

3 Commits

Include renames

Author	SHA1	Message	Date
guzhujushi	49fd84a2df	docs: L0 进度 3/12，记录 zstandard 残骸坑与决策 26/27 - STATUS.md：本次任务拆成「第一阶段已完成 / 第二阶段进行中」； L0 3/12；测试计数改为 39 passed / 44 skipped；下一步里写明 io.py 待修的两处（mkdir 早于校验、缺 Raises） - docs/04-environment.md 坑 6：conda 升级留下的 *.conda_trash 残骸目录会被 Python 当成 namespace package 导入成功（__file__ 为 None）， pandas 3.0 因此抛 ImportError: Can't determine version for zstandard 直接打断 pd.read_csv；含排查方法与「改名禁用」的修法 - docs/dev/personal-pitfalls.md：条目 3（注解与 docstring 打架）复发 +1 - 决策 26：未实现的算法逐条 skip，禁用模块级 pytestmark - 决策 27：zstandard 残骸改名禁用，不删不重装 - CHANGELOG：补 load_table/save_table 与 Fixed 段	2026-10-01 23:11:48 +08:00
guzhujushi	c93810ffb1	fix(core): 补齐 get_rng 类型校验，set_seed 覆盖 numpy 旧全局 get_rng 的"共享单例生成器"设计由用户本人提出，本提交只在其上修 bug。 - random_state 判断从 isinstance(x, int) 放宽到 (int, np.integer)： np.int64 不是 int 的子类，之前会静默退回全局流、种子被无声忽略 - 非预期类型改成抛 TypeError（含 bool / float / str / list），不再静默降级 - get_rng 签名补上 np.integer 与 Generator，与 docstring 的承诺一致 - set_seed 同时调用 np.random.seed：sklearn / statsmodels 走的是 numpy 旧全局状态，不覆盖它们"提交能重跑"就有洞（带 noqa: NPY002 与理由） - 测试：TestRandom 由 4 条增到 7 条（np.integer、非法类型、共享生成器推进） - 新增 docs/dev/personal-pitfalls.md：个人易错点清单，只追加、不通读，首批记录本轮 4 个点；docs/README.md 补上 05 与该文件的索引 - STATUS.md：L0 进度说明更新，决策 24 改写（共享单例）、新增决策 25 （src/ 实现默认由用户本人写）	2026-10-01 19:38:59 +08:00
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

Author

SHA1

Message

Date

guzhujushi

49fd84a2df

docs: L0 进度 3/12，记录 zstandard 残骸坑与决策 26/27

- STATUS.md：本次任务拆成「第一阶段已完成 / 第二阶段进行中」；
  L0 3/12；测试计数改为 39 passed / 44 skipped；
  下一步里写明 io.py 待修的两处（mkdir 早于校验、缺 Raises）
- docs/04-environment.md 坑 6：conda 升级留下的 *.conda_trash 残骸目录会被
  Python 当成 namespace package 导入成功（__file__ 为 None），
  pandas 3.0 因此抛 ImportError: Can't determine version for zstandard
  直接打断 pd.read_csv；含排查方法与「改名禁用」的修法
- docs/dev/personal-pitfalls.md：条目 3（注解与 docstring 打架）复发 +1
- 决策 26：未实现的算法逐条 skip，禁用模块级 pytestmark
- 决策 27：zstandard 残骸改名禁用，不删不重装
- CHANGELOG：补 load_table/save_table 与 Fixed 段

2026-10-01 23:11:48 +08:00

guzhujushi

c93810ffb1

fix(core): 补齐 get_rng 类型校验，set_seed 覆盖 numpy 旧全局

get_rng 的"共享单例生成器"设计由用户本人提出，本提交只在其上修 bug。

- random_state 判断从 isinstance(x, int) 放宽到 (int, np.integer)：
  np.int64 不是 int 的子类，之前会静默退回全局流、种子被无声忽略
- 非预期类型改成抛 TypeError（含 bool / float / str / list），不再静默降级
- get_rng 签名补上 np.integer 与 Generator，与 docstring 的承诺一致
- set_seed 同时调用 np.random.seed：sklearn / statsmodels 走的是 numpy
  旧全局状态，不覆盖它们"提交能重跑"就有洞（带 noqa: NPY002 与理由）
- 测试：TestRandom 由 4 条增到 7 条（np.integer、非法类型、共享生成器推进）
- 新增 docs/dev/personal-pitfalls.md：个人易错点清单，只追加、不通读，
  首批记录本轮 4 个点；docs/README.md 补上 05 与该文件的索引
- STATUS.md：L0 进度说明更新，决策 24 改写（共享单例）、新增决策 25
  （src/ 实现默认由用户本人写）

2026-10-01 19:38:59 +08:00

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