完善文档

docs/infrastructure/README.md

@@ -0,0 +1,3 @@
+# Infrastructure
+
+基础设施文档目录。

docs/infrastructure/deployment.md

@@ -0,0 +1,7 @@
+# Deployment
+
+采用渐进式部署：
+
+`Docker Compose -> Container Platform -> Kubernetes`
+
+是否进入 Kubernetes 由服务数量、可用性、扩缩容和团队运维能力决定，而不是技术偏好。

docs/infrastructure/development.md

@@ -0,0 +1,12 @@
+# Development Environment
+
+推荐：
+
+- Docker Compose
+- PostgreSQL
+- Redis
+- MinIO
+- VectorStore
+- GraphStore
+
+Python 使用 uv；Node 使用 pnpm；Rust 使用 Cargo；Go 使用 Go Modules。

docs/infrastructure/docker.md

@@ -0,0 +1,10 @@
+# Docker
+
+Docker Compose 用于本地多服务编排。
+
+原则：
+
+- 服务配置环境化。
+- Secret 不提交 Git。
+- 数据卷用于开发持久化。
+- 每个服务保持单一职责。

docs/infrastructure/observability.md

@@ -0,0 +1,13 @@
+# Observability
+
+统一采用 OpenTelemetry 思路。
+
+三类信号：
+
+- Logs
+- Metrics
+- Traces
+
+Agent 特有 Trace：
+
+`Run -> Plan -> Model -> Memory -> Tool -> Observation -> Reflection`

docs/infrastructure/scaling.md

@@ -0,0 +1,13 @@
+# Scaling
+
+扩展顺序优先：
+
+1. 优化单体 Agent Runtime。
+2. 异步化长任务。
+3. 分离高并发 I/O。
+4. 增加缓存。
+5. 数据库读写优化。
+6. 按瓶颈拆分服务。
+7. 最后引入更复杂的分布式基础设施。
+
+避免过早微服务化。