Merge branch 'development' into claude/agent-proactive-chat-UYHu9

api/docker-compose.dev.yml

@@ -1,5 +1,9 @@
 # 开发环境 Docker Compose
 # 使用方法: docker compose -f docker-compose.dev.yml up -d
+#
+# 宿主端口为项目约定的固定高位端口（避免与本机常用 5432/6379 冲突），与本仓库 .env.example 对齐：
+#   PostgreSQL  127.0.0.1:48291 → 容器 5432
+#   Redis       127.0.0.1:48307 → 容器 6379
 
 services:
   # PostgreSQL 数据库（pg17 + pgvector，memory 模块需要 vector 类型）