---
title: 开发机环境与 dev.py 四进程联调
type: fact
permalink: main/projects/d5a7f581-c442-4554-87b9-ee723b8b0258/开发机环境与-dev.py-四进程联调
stable_id: 71c1d6e8-7c2a-4d51-bf6d-3080ee24a441
scope: project
memory_type: fact
project_id: d5a7f581-c442-4554-87b9-ee723b8b0258
usage_profile_id: 7aee455b-24cc-4008-bdaf-443721e6f939
status: active
revision: 1
request_id: metrix-mig-f3
created_at: '2026-08-12T17:33:53.764927+00:00'
updated_at: '2026-08-12T17:33:53.764927+00:00'
tags:
- environment
- dev
- windows
---

开发机 Windows + PowerShell（不能用 && 串联，用 ;；读写文件用工具不用 cat/sed）。Python：系统解释器用 uv 的 cpython `D:\Program Files\uv\python\cpython-3.14.3-windows-x86_64-none\python.exe`（C:\Users\Administrator\.local\bin\python.exe 是坏的 uv shim 别用）；Metrix 后端 venv 在 .venv（Glob 默认跳过点目录，用 Test-Path 确认）。Node v24/npm 11。GitHub 访问需 git 代理 http://127.0.0.1:7897（已配 http.https://github.com/.proxy）；现在远端已迁至 git.asio.asia 一般直连。联调入口 `python dev.py` 四进程：[backend] Metrix API :8000（uvicorn reload）、[web] Metrix 前端 :5173（Vite，代理 /api、/openapi.json → 8000）、[capa-api] CapacityReport API :9081、[capa-web] 其前端 :5174；CapacityReport 可选，缺失/崩溃不影响 Metrix；Windows 子进程用 CREATE_NEW_PROCESS_GROUP|CREATE_NO_WINDOW 避免 reload 时误关整套联调；Ctrl+C 一并退出。开发时访问 http://127.0.0.1:5173，初始化走 /install。