cjw
79441a8a87
D4 文档/规划/历史混放收口：
- docs/TECH_DEBT.md §2 由'按批次回顾'精简为'按主题摘要'，
与§3重复内容（批次0-4详细展开）整体迁入
docs/archive/2026-09_governance_batches.md
- docs/STATUS.md 顶部 2026-09-17 之前条目迁入
docs/archive/2026-09_status_history.md，仅保留指针
- D2 历史口径补齐为 2026-09-18 批次4后续专项清偿
- D4 标已清偿
- AGENTS.md / docs/archive/README.md 同步导航
D13 锁文件流程固化（镜像引入主体已清偿，仅剩锁文件落盘）：
- 新增 deploy/generate_lockfiles.{sh,bat}：在 moldinsight conda
环境（仅项目依赖）执行 pip freeze --exclude pythonocc-core，
产出 deploy/requirements-{base,moldinsight}.lock.txt
- deploy/Dockerfile.moldinsight 注释改为指向生成脚本
- docs/OPERATIONS.md §2.1 增加完整流程说明
- tests/test_lockfile_generation.py 加锁文件存在性+体积契约；
tests/conftest.py 注册 --run-lockfile-check 选项，
默认 skip（仓库单测不阻塞），CI 镜像构建 job 显式启用 fail-fast
遗留：锁文件本身尚未落盘（本机Miniforge跨项目开发栈混装，
污染严重不能直接 pip freeze）；待 CI / 生产首次构建时按流程落锁。
测试基线：126 passed, 9 skipped（默认4原有skip + D13新增5skip；
启用 --run-lockfile-check 时严格断言2项锁文件契约）
Co-Authored-By: Claude Code <noreply@anthropic.com>
51 lines
2.2 KiB
Bash
51 lines
2.2 KiB
Bash
#!/usr/bin/env bash
|
||
# ============================================================
|
||
# geMoldInsight pip 锁文件生成脚本（TECH_DEBT D13）
|
||
# ============================================================
|
||
#
|
||
# 设计要点：
|
||
# - 锁文件必须在构建产出的 conda/minimal 环境里生成（只有 geMoldInsight 依赖 + 基础库），
|
||
# 本机开发环境的 `pip freeze` 会污染（全开发栈混装），不能直接落锁。
|
||
# - 仅在带 moldinsight 的 conda 环境内运行 `pip freeze > deploy/requirements-<x>.lock.txt`
|
||
# 才有意义。
|
||
# - 锁文件落盘后即可被 CI / 离线构建 / 复现部署直接 `pip install -r` 锁定版本，
|
||
# 而不再依赖 >= 下限解析。
|
||
#
|
||
# 用法（必须在 `gemold` conda 环境内执行）：
|
||
# bash deploy/generate_lockfiles.sh
|
||
#
|
||
# 产物：
|
||
# deploy/requirements-base.lock.txt
|
||
# deploy/requirements-moldinsight.lock.txt
|
||
# ============================================================
|
||
|
||
set -euo pipefail
|
||
|
||
cd "$(dirname "$0")/.."
|
||
|
||
if ! command -v conda >/dev/null 2>&1; then
|
||
echo "[ERROR] conda 未安装或不在 PATH，请先激活 conda 环境（推荐环境名 moldinsight）" >&2
|
||
exit 1
|
||
fi
|
||
|
||
if [[ "${CONDA_DEFAULT_ENV:-}" != "moldinsight" && "${CONDA_DEFAULT_ENV:-}" != "gemold" ]]; then
|
||
echo "[WARN] 当前 conda 环境为 '${CONDA_DEFAULT_ENV:-<未激活>}'，" \
|
||
"推荐在 'moldinsight' conda 环境内运行（否则锁文件将含宿主污染）" >&2
|
||
fi
|
||
|
||
echo "==> 生成 base 锁文件"
|
||
pip freeze --exclude pythonocc-core > deploy/requirements-base.lock.txt
|
||
|
||
echo "==> 生成 moldinsight 锁文件"
|
||
pip freeze --exclude pythonocc-core > deploy/requirements-moldinsight.lock.txt
|
||
|
||
echo
|
||
echo "已生成："
|
||
echo " deploy/requirements-base.lock.txt ($(wc -l < deploy/requirements-base.lock.txt) 行)"
|
||
echo " deploy/requirements-moldinsight.lock.txt ($(wc -l < deploy/requirements-moldinsight.lock.txt) 行)"
|
||
echo
|
||
echo "下一步："
|
||
echo " 1. 提交这两个 lock.txt（仅含项目直接依赖 + conda-minimal 环境产出）"
|
||
echo " 2. 同步更新 deploy/requirements-base.txt / requirements-moldinsight.txt 的版本下限" \
|
||
"为 lock 中的实际版本（或保留 >=，按团队策略）"
|