feat: 新增 Agent 记忆服务部署、重命名容器、整理 env 配置

- 新增 agent-memory 服务与 .env.AMS.sample
- easyai-pgvector 共用 PostgreSQL，独立库 easyai_memory
- 新增 docker/postgres/init-pgvector.sql 初始化
- 容器名: comfyAI-web→easyai-web, comfy-server→easyai-server
- easyai-asg-pg→easyai-pgvector
- 记忆服务端口配置移至 .env（comfy-server 调用用）
- 整理 .env.sample 结构，新增 /ams-api/ Nginx 代理

Made-with: Cursor

README.md

@@ -21,10 +21,84 @@ git clone https://git.51easyai.com/wangbo/easyai.git; cd easyai; powershell -Exe
 
 ## 重要更新记录：
 
+### 2026.3.20
+
+1. **新增 Agent 记忆服务（AMS）模块**：新增 `agent-memory`（Agent 长期记忆）容器，复用 `easyai-pgvector` 数据库（需 pgvector 扩展），用于支持 Agent 对话记忆、向量召回与反馈能力。
+2. **新增环境变量文件**：新增 `.env.AMS.sample` 文件，包含记忆服务所需的全部环境变量。
+3. 主服务 `comfy-server` 新增 `MEMORY_TCP_HOST` 和 `MEMORY_TCP_PORT` 环境变量，用于内部 TCP 微服务通信。
+4. **Nginx 代理**：`easyai-proxy.conf.sample` 中新增 `/ams-api/` 路径代理（可选）。
+
+#### 升级步骤
+
+**步骤一：更新文件**
+
+将以下文件更新到最新版本：
+- `docker-compose.yml`
+- `easyai-proxy.conf.sample`
+- `docker/postgres/init-pgvector.sql`（PostgreSQL 首次启动时创建 vector 扩展）
+
+新增文件复制到部署目录：
+- `.env.AMS.sample` → 复制为 `.env.AMS` 并根据实际环境修改
+
+**步骤二：配置 `.env.AMS`**
+
+```bash
+cp .env.AMS.sample .env.AMS
+```
+
+根据实际环境修改 `.env.AMS` 中的关键配置：
+```dotenv
+# PostgreSQL 连接（独立库 easyai_memory，与 .env.ASG 中账号密码一致）
+MEMORY_DATABASE_URL=postgresql://easyai:easyai2025@easyai-pgvector:5432/easyai_memory?schema=public
+
+# 主服务 API 地址（用于 Embedding 与对话压缩）
+MEMORY_AI_BASE_URL=http://comfy-server:3001
+
+# Embedding 模型与维度（需与主服务一致）
+MEMORY_EMBEDDING_DIMENSION=1024
+MEMORY_EMBEDDING_MODEL=text-embedding-v4
+```
+
+**步骤三：启动服务**
+
+记忆服务使用 Docker Compose Profile，需显式启用：
+
+```bash
+cd ~/easyai
+# 启动全部服务（含记忆服务）
+docker compose --profile memory up -d
+
+# 或仅启动基础服务（不含记忆）
+docker compose up -d
+```
+
+新增容器：`agent-memory`（Agent 记忆服务），复用 `easyai-pgvector`，使用独立库 `easyai_memory`。初始化流程与 ASG 一致：
+- **PostgreSQL 首次启动**：`docker/postgres/init-pgvector.sql` 创建 `vector`、`pgcrypto` 扩展
+- **easyai-asg 启动**：entrypoint 执行 `prisma migrate deploy`，创建治理相关表
+- **agent-memory 启动**：entrypoint 执行 `prisma migrate deploy`，创建 `memory_records` 等表
+
+**注意**：`easyai-pgvector` 使用 `registry.cn-shanghai.aliyuncs.com/easyaigc/pgvector:0.8.2-pg18-trixie`（含 pgvector 扩展）。若此前使用其他镜像且已有数据，升级前请备份 `asg_postgres_data` 卷。
+
+**步骤四：验证**
+
+```bash
+# 检查容器状态
+docker compose ps agent-memory
+
+# 检查记忆服务健康状态
+curl http://127.0.0.1:3004/health
+
+# 通过 Nginx 代理访问（配置 Nginx 后）
+curl https://<你的域名>/ams-api/health
+```
+
+> **注意**：记忆服务默认不启动，使用 `docker compose --profile memory up -d` 显式启用。若不需要 Agent 记忆功能，保持 `docker compose up -d` 即可，主服务会正常运行（记忆相关能力不可用）。
+
+---
 
 ### 2026.3.2
 
-1. **新增 Agent 服务治理（ASG）模块**：新增 `easyai-asg`（Agent 服务治理）容器和独立的 `easyai-asg-pg`（PostgreSQL 18）数据库容器，用于支持 Agent 自动化治理能力。
+1. **新增 Agent 服务治理（ASG）模块**：新增 `easyai-asg`（Agent 服务治理）容器和独立的 `easyai-pgvector`（PostgreSQL 18）数据库容器，用于支持 Agent 自动化治理能力。
 2. **新增 Nginx 反向代理**：在 `easyai-proxy.conf.sample` 中新增 `/asg-api/` 路径代理，用于暴露 ASG 服务的 REST API。
 3. **新增环境变量文件**：新增 `.env.ASG.sample` 文件，包含 ASG 服务所需的全部环境变量。
 4. 主服务 `comfy-server` 新增 `ASG_TCP_HOST` 和 `ASG_TCP_PORT` 环境变量，用于内部 TCP 微服务通信。
@@ -61,7 +135,7 @@ cp .env.ASG.sample .env.ASG
 根据实际环境修改 `.env.ASG` 中的关键配置：
 ```dotenv
 # PostgreSQL 连接（默认使用容器内网地址，一般无需修改）
-ASG_DATABASE_URL=postgresql://easyai:easyai2025@easyai-asg-pg:5432/agent_governance?schema=public
+ASG_DATABASE_URL=postgresql://easyai:easyai2025@easyai-pgvector:5432/agent_governance?schema=public
 ASG_POSTGRES_USER=easyai
 ASG_POSTGRES_PASSWORD=easyai2025
 
@@ -105,13 +179,13 @@ cd ~/easyai
 docker compose up -d
 ```
 
-新增容器：`easyai-asg-pg`（PostgreSQL）和 `easyai-asg`（Agent 服务治理），数据库会在首次启动时自动完成初始化和迁移。
+新增容器：`easyai-pgvector`（PostgreSQL）和 `easyai-asg`（Agent 服务治理），数据库会在首次启动时自动完成初始化和迁移。
 
 **步骤五：验证**
 
 ```bash
 # 检查容器状态
-docker compose ps easyai-asg-pg easyai-asg
+docker compose ps easyai-pgvector easyai-asg
 
 # 检查 ASG 服务健康状态
 curl http://127.0.0.1:3003/health