guzhujushi/MCM-ICM_Toolkit
1
0 Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
36 Commits 1 Branch 0 Tags
dd9bd638b8f74449740ff9635847b028648cc4d7
Commit Graph
10 Commits
Author SHA1 Message Date
guzhujushi dd9bd638b8 feat(solve): 审查 markov_simulate：工程侧收口 + 9 条测试 
用户实现的第一版 markov_simulate 算法本体经探针实测正确（终点频率 [0.657, 0.343]
对照平稳分布 [2/3, 1/3]，同种子可复现），本次只动工程侧，未改任何算法行：

- ruff 8 条全清（I001 导入排序 + 5 处 W293 / 2 处 W291）
- docstring 从一行补全为 Parameters / Returns / Raises / Notes / Examples
- 文案：马尔科夫→马尔可夫（3 处）、initail→initial、半角逗号→全角、paths[:,0]→paths[:, 0]
- arr, kind = as_array(...) 的 kind 全程未用 → arr, _
- tests/test_solve.py 新增 9 条 markov_simulate 测试（此前 0 条）
- STATUS.md 新增决策 56（initial 语义待用户拍板，A/B/C 三选项）与 5 条待办
- CHANGELOG 与 docs/dev/personal-pitfalls.md 易错点 27（入口分流后两条分支口径矛盾）

校验：pytest 188 passed / 31 skipped（219 收集）；ruff 0；pyright 0
 2026-10-05 23:11:04 +08:00
guzhujushi 9368dd91cb feat(solve): random_walk 的 step_sampler 契约改成"整数 size + 一维返回"（方案 B） 
用户拍板方案 B（决策 55），Codex 代改。

- size 由 (n_paths, n_steps) 改成整数 n_paths * n_steps，必须返回一维；
  内部 reshape(n_paths, n_steps)（行主序）；二维返回一律判失败
- 动因：方阵时转置 (n_steps, n_paths) 与目标形状相同，形状校验天生分不出来（易错点 25）
- 关键：不用 .ravel() 救场（会把转置摊平，歧义原样回来）
- 红利：与 monte_carlo 的 sampler 契约（决策 48 的 size=n）统一，采样器可直接复用（实测）
- docstring：step_sampler 契约与 Notes 同步（一维 / 行主序 / 二维必失败）
- tests：转置那条改成 rejects_2d_step_sampler（含方阵），新增"整数 size + 行主序"契约测试；solve 段 43 条
- 验证：210 收集 / 179 passed / 31 skipped / 0 xfail，ruff 0，pyright 0
- docs：STATUS 决策 55 + random_walk 待办全部办结；CHANGELOG
 2026-10-05 18:06:55 +08:00
guzhujushi cd6f613568 fix(solve): random_walk 的 start 校验恢复后收尾（文案/空格/测试） 
两条口径由用户第二轮改定，Codex 顺手补工程侧。

- 用户：恢复 start 的入口类型校验；n_steps/n_paths 注解放宽为 int | np.integer
- Codex：start 报错文案"必须是整数" -> "必须是数值"（这条校验本来就收 float，原文案自相矛盾），
  类型名统一 type(x).__name__；n_paths 默认值补空格；docstring 的 start 说明与 Raises 同步
- tests：start="a" 恢复断言 TypeError；补回 np.int64 的 n_steps/n_paths；solve 段 42 条
- 验证：209 收集 / 178 passed / 31 skipped / 0 xfail，ruff 0，pyright 0
- docs：STATUS 决策 55（方阵歧义两条路）+ 验证计数；CHANGELOG
 2026-10-05 18:01:40 +08:00
guzhujushi 6fca82e3fc fix(solve): random_walk 失败路径的 UnboundLocalError；第二轮口径收口 
口径由用户第二轮改定；Codex 修一处真 bug + 工程侧。

- 真 bug：call_params 写在 try 里、却在 except 被引用，5 种失败输入 5 个全炸 UnboundLocalError
  （本该返回 success=False 的 Result，变成把异常抛给调用方）。按原意前移到 try 之前，未改口径；
  失败时照样带上 n_steps / n_paths / start / random_state
- 用户口径：n_steps/n_paths 拆 TypeError/ValueError；加 steps 形状与 NaN 两条校验；
  默认步长改 rng.choice([-1.0, 1.0])；params 补 random_state；metrics 改 mean_terminal/std_terminal
- 工程：docstring 同步（Returns 的 metrics、Raises 的分工、去掉已删的 start 校验）；+3 条测试
  （失败也必须返回带 params 的 Result、NaN 判失败、终点 std ~= sqrt(t)），solve 段 41 条
- 验证：208 收集 / 177 passed / 31 skipped / 0 xfail，ruff 0，pyright 0
- docs：STATUS 决策 54 + 3 条新口径；CHANGELOG；易错点 26
 2026-10-05 17:24:23 +08:00
guzhujushi 8ec08ea9ce feat(solve): random_walk 落地；修默认采样器真 bug（integers 不收 float） 
random_walk 由用户本人写；Codex 改一处真 bug + 工程侧。

- 真 bug：默认采样器 rng.integers(0, 2, size=size, dtype=float) 被 numpy 拒掉
  （Unsupported dtype dtype(float64) for integers），默认路径 100% success=False、
  data=None，连 docstring 的 Examples 都跑不通。改成 integers(size=size) * 2 - 1，
  由后面的 np.asarray(..., dtype=float) 转 float；实测 (5,101)、步长恒 ±1、同种子可复现
- 工程：ruff W293 x2；docstring 补全（n_steps/n_paths/start/random_state + Returns /
  Raises / Notes，写清 step_sampler 收二维 size=(n_paths, n_steps)）
- tests：random_walk 首次有测试，新增 6 条（形状 + start、步长恒 ±1、可复现、自定义
  高斯采样器、3 类非法入参、docstring Example）
- monte_carlo_integral：用户第二轮已收 ndarray + 把三行提出 if/else（决策 52）
- 验证：205 收集 / 174 passed / 31 skipped / 0 xfail，ruff 0，pyright 0
- docs：STATUS 决策 53 + random_walk 4 条待办；CHANGELOG；易错点 24/25，第 18 条复发 +1
 2026-10-05 17:04:52 +08:00
guzhujushi dcda080be4 fix(solve): monte_carlo_integral 入口收口 + 失败 message 不再被覆盖 
三项待办由用户本人改定；Codex 只补 ruff / docstring / tests / 文档。

- bounds 形状校验：`[0, 1]` 从裸 IndexError 变成可读 ValueError（带形状提示）；
  空 / 非 list-tuple / 参差不齐一并收口
- 失败 message：改成 if result.success / else 两支，success=False 时不再出现"成功"文案
- n 注解放宽为 int | np.integer；event 注解 Callable[..., bool] -> Callable[..., Any]
  （决策 50 的遗留清零；pyright 复测不再拒绝向量化事件函数）
- 工程侧：清掉 2 行 ruff W293；docstring 的 bounds / Raises 同步；
  非法 bounds 测试 1 类扩到 4 类，新增失败 message 语义与 np.int64 两条
- 验证：199 收集 / 168 passed / 31 skipped / 0 xfail，ruff 0，pyright 0
- docs：决策 52 + 2 条新口径（bounds 收不收 ndarray、if/else 三行重复）；CHANGELOG
 2026-10-05 16:04:39 +08:00
guzhujushi ed1f9f0c53 feat(solve): monte_carlo_integral 落地，修掉体积符号真 bug 
实现由用户本人写；Codex 只碰工程侧 + 一处纯 bug（决策 31）。

- 真 bug：体积写成 lows - highs，奇数维为负（1D x^2 于 [0,1] 得 -0.3324、3D 得 -0.5005）；
  2D 因两个负号相乘"看着对"（+0.2499），把 bug 藏住。改成 widths = highs - lows 后
  复测 0.3324 / 0.5005 / 1.9971（[0,2]）全部正确
- docstring：补 func / n / random_state 与 Raises；写清 metrics["mean"] 才是积分估计值、
  data 是 n 个样本各自的贡献（决策 51）；修掉跑不通的 Examples（data 是数组，bool(数组) 会抛）
- tests/test_solve.py：摘 1 条 skip + 新增 4 条（3D 奇数维 / [0,2] 宽度 / 2D+params / 非法 bounds）
- 验证：197 收集 / 166 passed / 31 skipped / 0 xfail，ruff 0，pyright 0
- docs：STATUS 决策 51 + 3 条待办 + 下一站 random_walk；CHANGELOG；易错点 22/23，第 3 条复发 +1
 2026-10-05 15:55:12 +08:00
guzhujushi b0c4b4a413 feat(solve): monte_carlo 系列两个函数落地（L0 11/12、L1）+ Wilson 区间；修 z_score^2 异或 bug 
用户实现：
- solve.monte_carlo（L0 第 11 项，S 档）：向量化采样→仿真→汇总，8 个指标；
  批量大小由实现传 sampler(rng, size=n)；结果含 NaN 判失败；std 用 ddof=0。
- solve.monte_carlo_probability（L1，S 档）：event(batch)->bool，Wilson score 区间夹 [0,1]，
  confidence 记进 params，小概率改成 message 警告。

Codex 只碰工程侧（算法未动，唯一例外见下）：
- 真 bug：z_score^2 是异或不是乘方（np.float64 ^ 2 抛 TypeError，被 except 吞成 success=False，
  函数实际不可用）-> 改 z_score**2。新增经验第 21 条。
- docstring：补齐 Parameters / Raises，修掉两处跑不通的 Examples，Wald -> Wilson 同步。
- 入口校验按 §4.7 收严 n（bool / np.integer / TypeError 与 ValueError 分工）—— 决策 49 后此类归用户，已记档。
- ruff 九条（I001 / F541 x3 / SIM300 / W291 x2 / W293 x2 等）、格式与文案。
- 测试：摘掉 2 条已实现却仍挂着的 skip（易错点 9），新增 14 条（含 vectorization、
  Wilson 对 statsmodels 的对照、NaN / 布尔 / 长度等边界），solve 段共 25 条。

校验：193 收集 / 161 passed / 32 skipped / 0 xfail；ruff 0；pyright 0。
文档：STATUS.md 决策 47-50；docs/dev/personal-pitfalls.md 第 18-21 条；CHANGELOG.md。
 2026-10-05 11:26:54 +08:00
guzhujushi 58f2236703 docs(status): 记入分工硬规矩（决策 47）+「明天从这里开始」；test_solve 改逐条 skip 
- STATUS.md：新增决策 47 —— 算法一律由用户本人写（即便用户改口也不代写），
  工程事务（入口/校验、tests/、lint、docstring、卡片、STATUS/CHANGELOG）由 Codex 写；
  L0 计数 9/12 -> 10/12；skip 说明 37 -> 34 条。
- STATUS.md：新增「⭐ 明天从这里开始」区块 —— 第一个要写的文件是
  src/mcm_toolkit/solve/simulate.py 的 monte_carlo（L0 11/12，S 档），
  含参考契约、向量化要求、get_rng 口径、三条测试建议、卡片路径与一个待拍板口径。
- tests/test_solve.py：模块级 pytestmark 拆成 9 条逐条 skip（决策 26、易错点 9）。
- CHANGELOG.md：同步记录。

校验：pytest 177 收集 / 143 passed / 34 skipped / 0 xfail；ruff 0；pyright 0。
 2026-10-03 20:12:46 +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