返回 Bug 清单
BUG-0082project-09中需关注docker-dependency
Docker Desktop 未运行阻断基础设施
发现：2026-09-30验证：2026-10-27置信度：85%
症状
（[cursor_202606072236.md:346](file://d:/chemindra/cursor_202606072236.md#L346)）：
```powershell
cd D:\chemindra\docker
docker compose up -d postgres redis
unable to get image 'postgres:16-alpine': error during connect: Get "http://%2F%2F.%2Fpipe%2FdockerDesktopLinuxEngine/v1.51/...": open //./pipe/dockerDesktopLinuxEngine: The system cannot find the file specified.
```
根因
Windows 上 Docker Desktop 未启动时 Docker Engine pipe 不存在，项目基础设施（PostgreSQL、Redis）硬依赖 Docker。新开发者在首次 clone 后直接按照 README 执行 `docker compose up -d` 必然失败。
修复方案
（`commit 1d6a90d`）：
1. 新增 `scripts/setup_local_db.ps1` — 一键检测本机 PostgreSQL 18 服务状态、建库、写入 `.env`
2. 新增 `docs/LOCAL_DEV_WINDOWS.md` — Windows 本地开发排错完整指南
3. 更新 `.env.example` — 默认 `DATABASE_URL` 指向本机 PostgreSQL（免 Docker 模式）
4. 更新 `README.md` — 增加"方式 A：本机 PostgreSQL"和"方式 B：Docker"双路径说明
修复命令
（`commit 1d6a90d`）：
1. 新增 `scripts/setup_local_db.ps1` — 一键检测本机 PostgreSQL 18 服务状态、建库、写入 `.env`
2. 新增 `docs/LOCAL_DEV_WINDOWS.md` — Windows 本地开发排错完整指南
3. 更新 `.env.example` — 默认 `DATABASE_URL` 指向本机 PostgreSQL（免 Docker 模式）
4. 更新 `README.md` — 增加"方式 A：本机 PostgreSQL"和"方式 B：Docker"双路径说明错误签名
unable to get image 'postgres:16-alpine': error during connect: Get "http://%2F%2F.%2Fpipe%2FdockerDesktopLinuxEngine/v1.51/...": open //./pipe/dockerDesktopLinuxEngine: The system cannot find the file specified.技术信息
来源项目
project-09
涉及文件
scripts/setup_local_db.ps1`（新增）, docs/LOCAL_DEV_WINDOWS.md, .env.example
标签
docker-dependency, project-09