chore: initial commit of ai site platform
Co-authored-by: Cursor <cursoragent@cursor.com>
This commit is contained in:
86
ENV.md
Normal file
86
ENV.md
Normal file
@@ -0,0 +1,86 @@
|
||||
# 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。**
|
||||
|
||||
## 数据库连接
|
||||
|
||||
```text
|
||||
Host: 127.0.0.1
|
||||
Port: 5432
|
||||
User: platform
|
||||
Password: platform
|
||||
Database: platform
|
||||
```
|
||||
|
||||
连接串(已写入 `platform/etc/platform.yaml`):
|
||||
|
||||
```text
|
||||
postgres://platform:platform@127.0.0.1:5432/platform?sslmode=disable
|
||||
```
|
||||
|
||||
超级用户(安装时设置):`postgres` / `platform`
|
||||
|
||||
`psql` 路径已加入用户 PATH:`C:\Program Files\PostgreSQL\16\bin`
|
||||
(新开终端后生效)
|
||||
|
||||
## 启动中台
|
||||
|
||||
```powershell
|
||||
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`) |
|
||||
|
||||
```powershell
|
||||
# 仅写入 Docker Desktop 镜像配置(改完后建议重启一次 Docker Desktop)
|
||||
.\scripts\Apply-DockerMirrors.ps1
|
||||
|
||||
# 正常启动会自动 Apply + 优先走国内前缀拉镜像
|
||||
.\start.ps1
|
||||
```
|
||||
|
||||
本项目数据库也可用本机 PostgreSQL;Docker 拉不动时会自动回退本机模式。
|
||||
|
||||
## 常用检查
|
||||
|
||||
```powershell
|
||||
go version
|
||||
python --version
|
||||
node --version
|
||||
psql -U platform -h 127.0.0.1 -d platform -c "SELECT 1"
|
||||
Get-Service postgresql-x64-16
|
||||
```
|
||||
Reference in New Issue
Block a user