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