Phase 0 评审三次修复:文档命令统一加 .exe 后缀(MSYS2 venv 实际文件名)
This commit is contained in:
@@ -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 辅助脚本)。
|
||||
|
||||
@@ -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` 为标准启动与验证入口。
|
||||
|
||||
@@ -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` 别名。
|
||||
|
||||
|
||||
@@ -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
|
||||
```
|
||||
|
||||
完成前至少检查:
|
||||
|
||||
@@ -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
|
||||
```
|
||||
|
||||
## 开始编码前检查
|
||||
|
||||
@@ -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 建立场景、语言、框架、数据库、功能标签模型。
|
||||
|
||||
|
||||
Reference in New Issue
Block a user