diff --git a/AGENTS.md b/AGENTS.md index 8dc47d8..8187391 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -58,8 +58,8 @@ Phase 0(地基)已完成。Wagtail 7.4.2 + Django 6.0.6 项目已初始化 ## 验证 ```bash -.venv/bin/python3.12 manage.py check -.venv/bin/python3.12 manage.py test +.venv/bin/python3.12.exe manage.py check +.venv/bin/python3.12.exe manage.py test ``` `init.sh` 是标准启动与验证入口(`init.ps1` 为 Windows 辅助脚本)。 diff --git a/docs/00-ai-start-here.md b/docs/00-ai-start-here.md index ce5c4d8..1224621 100644 --- a/docs/00-ai-start-here.md +++ b/docs/00-ai-start-here.md @@ -40,9 +40,9 @@ MVP 功能范围以 [`02-requirements.md`](02-requirements.md) 为唯一权威 ## 验证命令 ```bash -.venv/bin/python3.12 manage.py check -.venv/bin/python3.12 manage.py test -.venv/bin/python3.12 manage.py runserver +.venv/bin/python3.12.exe manage.py check +.venv/bin/python3.12.exe manage.py test +.venv/bin/python3.12.exe manage.py runserver ``` `init.sh` 为标准启动与验证入口。 diff --git a/docs/03-tech-stack.md b/docs/03-tech-stack.md index b3ecc20..0cc859a 100644 --- a/docs/03-tech-stack.md +++ b/docs/03-tech-stack.md @@ -37,11 +37,11 @@ | 用途 | 命令 | | --- | --- | | 创建虚拟环境 | `python3.12 -m venv .venv` | -| 安装依赖 | `.venv/bin/pip install -r requirements.txt` | -| 数据库迁移 | `.venv/bin/python manage.py migrate` | -| 创建管理员 | `.venv/bin/python manage.py createsuperuser` | -| 本地开发 | `.venv/bin/python manage.py runserver` | -| 测试 | `.venv/bin/python manage.py test` | +| 安装依赖 | `.venv/bin/pip3.12.exe install -r requirements.txt` | +| 数据库迁移 | `.venv/bin/python3.12.exe manage.py migrate` | +| 创建管理员 | `.venv/bin/python3.12.exe manage.py createsuperuser` | +| 本地开发 | `.venv/bin/python3.12.exe manage.py runserver` | +| 测试 | `.venv/bin/python3.12.exe manage.py test` | > 开发环境使用系统已安装的 **Python 3.12.12**(命令 `python3.12`),不依赖 `python3` 别名。 diff --git a/docs/05-coding-rules.md b/docs/05-coding-rules.md index 4f722f1..b64a706 100644 --- a/docs/05-coding-rules.md +++ b/docs/05-coding-rules.md @@ -58,8 +58,8 @@ ## 7. 测试与验证 ```bash -.venv/bin/python manage.py check -.venv/bin/python manage.py test +.venv/bin/python3.12.exe manage.py check +.venv/bin/python3.12.exe manage.py test ``` 完成前至少检查: diff --git a/docs/current-state.md b/docs/current-state.md index bc21dcb..26b793b 100644 --- a/docs/current-state.md +++ b/docs/current-state.md @@ -19,7 +19,7 @@ - 测试:`home/tests.py` 含 5 个测试(含 smoke 测试 `test_homepage_returns_200`),全部通过;`manage.py test` 可运行 - 数据:已创建 superuser `admin`;尚未建立 seed 数据 - 标准启动路径:`init.sh` 已配置 `pip install` / `manage.py check` / `manage.py runserver` 命令 -- 标准验证路径:`.venv/bin/python3.12 manage.py check` 通过(3 个 treebeard 兼容警告非阻塞) +- 标准验证路径:`.venv/bin/python3.12.exe manage.py check` 通过(3 个 treebeard 兼容警告非阻塞) - 当前 blocker:无;下一步执行 `T-101` ## 当前目录要点 @@ -51,10 +51,10 @@ ## 当前可运行内容 ```bash -# 标准开发命令(在 bash 中运行) -.venv/bin/python3.12 manage.py check -.venv/bin/python3.12 manage.py test -.venv/bin/python3.12 manage.py runserver +# 标准开发命令 +.venv/bin/python3.12.exe manage.py check +.venv/bin/python3.12.exe manage.py test +.venv/bin/python3.12.exe manage.py runserver ``` ## 开始编码前检查 diff --git a/progress.md b/progress.md index 01a62a1..eeb1154 100644 --- a/progress.md +++ b/progress.md @@ -190,3 +190,11 @@ - 决策:因 WSL2 不可用,环境决策正式转向 MSYS2/MinGW + bash;`init.sh` 同时兼容 Linux 原生 venv(无 `.exe` 后缀)和 MSYS2 venv(有 `.exe` 后缀),未来迁移 WSL2 时无需修改脚本。 - 下一步:T-101 建立场景、语言、框架、数据库、功能标签模型。 +## 2026-07-06 Phase 0 评审第三次修复(文档命令不可运行) + +- 状态:DONE +- 变更:`AGENTS.md`、`00-ai-start-here.md`、`03-tech-stack.md`、`05-coding-rules.md`、`current-state.md` 中所有 `.venv/bin/python` / `.venv/bin/python3.12` 裸命令统一加 `.exe` 后缀(MSYS2 venv 实际文件名);版本号规范化(`python`→`python3.12`,`pip`→`pip3.12`)。 +- 验证:`.venv/bin/python3.12.exe manage.py check`(0 errors);`.venv/bin/python3.12.exe manage.py test`(OK);`.venv/bin/pip3.12.exe --version`(正常)。 +- 阻塞:无。 +- 下一步:T-101 建立场景、语言、框架、数据库、功能标签模型。 +