ai_site/ENV.md

Windows 本地环境说明

更新时间：2026-07-17

已就绪

组件	版本/状态	说明
Go	1.21.13	中台必需，已有
Python	3.13+	AI / 蓝图校验，已有；已装 jsonschema
Node.js	v22	前端预留，已有
Git	2.52	已有
PostgreSQL	16.14	本次安装，服务 postgresql-x64-16 自动启动
Docker Desktop	4.82 / engine 29.x	本次安装（可选；当前项目用本机 Postgres 即可）

不需要 Java。

数据库连接

Host: 127.0.0.1
Port: 5432
User: platform
Password: platform
Database: platform

连接串（已写入 platform/etc/platform.yaml）：

postgres://platform:platform@127.0.0.1:5432/platform?sslmode=disable

超级用户（安装时设置）：postgres / platform

psql 路径已加入用户 PATH：C:\Program Files\PostgreSQL\16\bin
（新开终端后生效）

启动中台

cd E:\project\ai建站\platform
go run . -f etc/platform.yaml
# 另开终端
go run .\scripts\smoke.go

正常日志应出现：postgres engine enabled 且 memoryMode=false。

Docker 注意

Docker Desktop 已安装，首次使用可能需要：

1. 从开始菜单打开 Docker Desktop 完成初始化
2. 若提示启用 WSL2，按向导操作（本机已有 WSL Ubuntu-22.04）
3. 重启后再执行 docker version

国内镜像（已接入）

用途	源
Docker Hub 拉取	DaoCloud / 1ms / 轩辕（scripts\Apply-DockerMirrors.ps1 写入 %USERPROFILE%\.docker\daemon.json）
基础镜像前缀	docker.m.daocloud.io/library（compose / Dockerfile，可用环境变量 DOCKER_BASE_REGISTRY 覆盖）
Go modules	goproxy.cn
pip	清华 pypi.tuna.tsinghua.edu.cn
npm	registry.npmmirror.com（web/.npmrc）

# 仅写入 Docker Desktop 镜像配置（改完后建议重启一次 Docker Desktop）
.\scripts\Apply-DockerMirrors.ps1

# 正常启动会自动 Apply + 优先走国内前缀拉镜像
.\start.ps1

本项目数据库也可用本机 PostgreSQL；Docker 拉不动时会自动回退本机模式。

常用检查

go version
python --version
node --version
psql -U platform -h 127.0.0.1 -d platform -c "SELECT 1"
Get-Service postgresql-x64-16