返回 Bug 清单
BUG-0181project-03中已修复port-conflict
端口 8000 被 ChemIndra 占用
发现：2026-09-30验证：2026-10-27置信度：85%
症状
（[cursor_202606072237.md: Section 52](file://d:/ai_mirror/cursor_202606072237.md)）：
```powershell
.\scripts\smoke-test-api.ps1
==> ai_mirror API smoke @ http://127.0.0.1:8000
FAIL: GET / — 无法连接到远程服务器
```
根因
ChemIndra 项目也使用 FastAPI 默认端口 8000，两台服务同时开发时 8000 端口被 ChemIndra 占用。`start-api-only.ps1` 和 `smoke-test-api.ps1` 硬编码 8000 端口。
修复方案
1. `start-api-only.ps1` 自动检测 8000 端口占用情况，被占用则切换到 8001
2. `verify-stack.ps1` 自动检测 ai_mirror 实际运行端口
3. README 添加 `--port 8001` 说明和「一键启动」小节
4. `start-dev-local.ps1` 添加 Docker 未启动时的 graceful fallback
修复命令
1. `start-api-only.ps1` 自动检测 8000 端口占用情况，被占用则切换到 8001
2. `verify-stack.ps1` 自动检测 ai_mirror 实际运行端口
3. README 添加 `--port 8001` 说明和「一键启动」小节
4. `start-dev-local.ps1` 添加 Docker 未启动时的 graceful fallback错误签名
ChemIndra 项目也使用 FastAPI 默认端口 8000，两台服务同时开发时 8000 端口被 ChemIndra 占用。`start-api-only.ps1` 和 `smoke-test-api.ps1` 硬编码 8000 端口。技术信息
来源项目
project-03
涉及文件
scripts/start-api-only.ps1`（重写）, scripts/start-dev-local.ps1, scripts/verify-stack.ps1 +2
标签
port-conflict, project-03