[chore] 评估并分级当前工程卫生问题

[liujuanjuan1984]

背景

当前需要基于最新 main，对仓库的工程卫生状况进行一次系统性评估，并按严重程度输出问题清单，作为后续治理工作的输入。

复现步骤

1. 切换到最新 main。
2. 检查仓库结构、配置、测试、依赖、CI、文档与开发流程相关文件。
3. 运行必要的静态检查与测试命令，识别失败项、缺失项与高风险薄弱点。
4. 按严重程度从高到低整理工程卫生问题。

期望结果

仓库具备基本且可验证的工程卫生保障，包括但不限于：依赖与环境可复现、核心检查可稳定执行、测试与静态检查覆盖关键路径、文档与自动化流程一致。

实际结果

当前尚未完成系统评估，工程卫生问题清单与严重程度排序尚未沉淀，后续治理优先级不清晰。

验收标准

• 输出当前工程卫生问题清单。
• 每个问题包含影响说明与严重程度判断。
• 清单按严重程度从高到低排序。
• 结论基于仓库当前主干快照给出，并注明未验证项。

快照

• git rev-parse HEAD: e1ca009

[liujuanjuan1984]

完成基于当前 main 快照的首轮工程卫生评估，当前高优先级问题如下：

1. 发布包运行时依赖大多仅设置了下界，没有上界约束，已发布包的实际安装组合不具备稳定可复现性，存在“CI 通过但用户新装依赖后运行漂移”的风险。
2. 发布 workflow 只做构建、版本校验与 smoke test，没有重新执行完整回归基线，tag 发布门禁弱于主干质量门禁。
3. scripts/smoke_test_built_cli.sh 直接从 dist/ 里取最新时间戳 wheel，容易受到本地残留产物污染；同时脚本固定使用 Python 3.13，未覆盖声明支持的 3.11/3.12 打包安装路径。
4. 测试覆盖率只控制总量阈值，多个核心大文件仍有明显低覆盖热点，维护与回归成本偏高。
5. 版本兜底值仍硬编码为 0.1.0，在缺失包元数据的场景下会返回明显过时版本号。

补充说明：

• 本地执行 uv run pre-commit run --all-files、uv run pytest、bash ./scripts/dependency_health.sh、bash -n scripts/*.sh 均通过。
• bash ./scripts/smoke_test_built_cli.sh 在当前 HEAD 产物上可通过，但首次运行会先命中 dist/ 中的旧 wheel，说明脚本存在本地环境敏感性。