guzhujushi
cfc1be31ca
coefficient_of_variation: - 分母由 mean 改为 |mean|（用户本人改），均值为负时 CV 不再是负值 - docstring 摘要 / Returns / Notes 同步，加一条测试钉住"均值为负时 CV 仍为正" 口径拍板（2026-10-03）: - 决策 37: 非数值列的处置按输出契约分，不按包分 —— describe/zscore 丢掉（吐数值结果表）， detect_outliers 保留列、掩码恒 False（吐与原表同形的掩码），刻意不统一 - 决策 38: CV 用 sigma/|mean| - 决策 39: 工作约定 —— 语义/非法输入口径由用户拍板，Codex 只列选项不代选； ruff / STATUS.md / CHANGELOG.md / tests / docstring 这类与算法无关的工程事务 Codex 顺手补 经验（docs/dev/personal-pitfalls.md，只追加）: - 第 12 条: 三个并列的 if 让后面的静默覆盖前面的（transform.normalize 三种 method 实际只走 max） 第 11 条（上一轮）是 descriptive 的 .loc 对齐失败静默填 NaN —— 两条的共同点是"不抛异常" 验证: pytest 103 passed / 39 skipped；ruff All checks passed；pyright 0 errors。 docs: STATUS.md 决策 37/38/39 + 下一步；CHANGELOG 记录
文档索引
本目录是 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；本目录只放不会频繁变的内容。