guzhujushi
8ec08ea9ce
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
文档索引
本目录是 MCM/ICM Toolkit 的需求、架构、方案与开发规范的唯一落盘处。
| 文档 | 内容 |
|---|---|
| 01-suggestion-review.md | 对 ChatGPT 建库建议的审查与精简：留什么、砍什么、补什么 |
| 02-architecture.md | 精简后的包结构、边界划分、统一接口约定 |
| 03-roadmap.md | 功能清单分级（L0 / L1 / L2 / 不做）与开发纪律 |
| 04-environment.md | conda / venv 环境配置、镜像、离线约束 |
| dev/function-card-template.md | S 档算法的「函数卡片」模板 |
| 05-git-workflow.md | Git 工作流、Gitea 远程（SSH 走 Tailscale）、行尾策略 |
| dev/personal-pitfalls.md | 个人易错点清单：只追加，追加前不通读 |
阅读顺序
- 先读
01-suggestion-review.md—— 它决定后面所有事。 - 再读
02-architecture.md—— 它决定代码往哪写。 - 开工前读
03-roadmap.md的对应条目 —— 它决定这次做什么、做到什么程度。 - 环境出问题看
04-environment.md。
项目级进度看根目录的
STATUS.md；本目录只放不会频繁变的内容。