 guzhujushi
|
97a2f95066
|
fix(env): 钉死 pyright 的分析目标，修掉"无法解析导入 numpy/pandas"
现象：编辑器 / pyright 满屏 reportMissingImports，但 .venv 与 conda 环境里
import numpy, pandas 都正常，pytest 也全过。
根因两层：
1. pyright 没配 venvPath / pythonPath 时会去 PATH 上找 python。本机 PATH 上
唯一的 python 是 agent-tools 的 shim（Codex 运行时，Python 3.14），没有科学栈。
pyright --verbose 显示它选了 3.14.6，Search paths 里一个 Anaconda 路径都没有。
注意持久化的 User/Machine PATH 并没有这一项，是 Codex 进程临时注入的——所以
"我的终端没问题"和"工具有问题"可以同时成立。
2. .venv 是 --system-site-packages 建的，三方包在 D:\anaconda\Lib\site-packages，
而 pyright / Pylance 不认 pyvenv.cfg 的 include-system-site-packages，
只去 .venv\Lib\site-packages 找（那里只有 pip）。
pyright 不读 pyvenv.cfg，但**认 .pth**。
改动：
- pyproject.toml [tool.pyright]：venvPath = "." / venv = ".venv" /
pythonVersion = "3.13"，并注释了为什么必须写
- scripts/setup-venv.ps1：新增第 [2/4] 步，自动往 .venv 写
_mcm_base_site_packages.pth 指向该机 base 的 site-packages，换机重建即可
- tests/test_data.py：3 处 isna().all() 断言外面套 bool()（它的类型是
Series | bool，直接当条件 pyright 报"条件操作数无效"）；
2 处故意传错类型的用例加 type: ignore[arg-type]
结果：pyright 17 errors -> 0 errors / 0 warnings；pytest 两套环境均
40 passed, 44 skipped；ruff All checks passed；setup-venv.ps1 通过 AST 解析
（纯 ASCII + LF）。
文档：docs/04-environment.md 新增坑 7（含 pyright --verbose 诊断口诀与
VS Code / PyCharm 的操作步骤）、STATUS 决策 29、CHANGELOG。
|
2026-10-02 13:36:16 +08:00 |
|
|
guzhujushi
|
6758e81c9d
|
fix(data): 校验早于副作用，补空行；经验写入 pitfalls
save_table 的两处收尾（用户授权代改）：
- 后缀校验原先藏在 if/else 分支的 else 里，排在 path.parent.mkdir(...) 之后，
传 sub/x.txt 会先把 sub\ 建出来再抛 ValueError。改成守卫子句，集中在 mkdir 之前，
校验段结束后才产生副作用；此时 else 分支自然消失，用回 if/else 两路分派
- __all__ 与下一个 def 之间补回第二个空行（PEP 8 / E302）
测试：
- 新增 test_save_table_validates_before_touching_disk，
断言参数非法时 tmp_path 下一个条目都不留（ValueError 与 TypeError 两条路径）
- 40 passed / 44 skipped，两套环境一致；ruff All checks passed
文档：
- docs/dev/personal-pitfalls.md 追加条目 5（参数校验排在副作用之后）
与条目 6（把 lint 的"没报错"当成"没问题"），索引表同步加行
- STATUS：io.py 收尾，L0 第 3 项完成；测试计数 40
- CHANGELOG：Fixed 段补两条
|
2026-10-01 23:26:47 +08:00 |
|
|
guzhujushi
|
3cdbba4cfb
|
test(data): 拆掉模块级 skip，给 load_table/save_table 补 8 条行为测试
原来 tests/test_data.py 顶上一条 pytestmark 把整个文件跳过了，
连已经写好的 load_table 也一起跳——等于零覆盖。
- 改成逐条 @pytest.mark.skip，只标 5 个未实现的算法
- load_table 补：UTF-8 不被误读成 GBK、NA/-/#N/A 归 NaN、
显式 encoding 优先、未知后缀抛 ValueError、缺文件抛带路径的报错
- save_table 补：往返读写返回 Path、非 DataFrame 抛 TypeError
- 测试数 31 passed / 45 skipped -> 39 passed / 44 skipped
|
2026-10-01 23:11:47 +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 |
|