guzhujushi
9cb295a362
用户第三轮改了 5 处口径：非负校验带容差、initial 收 np.integer、paths 赋值挪进 try、
metrics 换成 terminal_distribution、mm1 放开 lambda=0 并收 numpy 标量。三处算法本体仍正确
（探针复测：终点分布 {0: 0.6644, 1: 0.3356}、lambda=0 给 L=Lq=Wq=0 且 W=1/mu、data is metrics 已为 False）。
Changed（Codex 只做同步，未改口径）
- docstring：markov_simulate 的 Returns 与"遗留"段、markov_steady_state 的 Raises
（TypeError / ValueError 分工）、mm1_metrics 的 Parameters / Returns / Raises。
- tests/test_solve.py：同步 5 条受影响的测试，新增 2 条（terminal_distribution 只列出现过的状态、
lambda=0 的空系统）。test_solve.py 64 条。
- ruff：B905（zip 缺 strict）+ 2 条空白 -> 0；rng 之后的双空行 -> 1。
- STATUS.md：决策 56 / 57 / 58 更新到"只剩 5 条小口径"；「下一步」第八轮；
新增「第八轮备忘：models 与 decision 各是干什么的」（函数清单 / 使用顺序 / 建议开工顺序）。
- CHANGELOG 与 docs/dev/personal-pitfalls.md 易错点 30（口径一改，docstring / 测试 / STATUS 同时过期）。
校验：pytest 204 passed / 28 skipped（232 收集）；ruff 0；pyright 0
文档索引
本目录是 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；本目录只放不会频繁变的内容。