add docs

Author: ide-coder

AGENTS.md

@@ -36,11 +36,12 @@ ide-code-server/
 # 构建镜像
 docker build -t ide-code-server .
 
-# 本地运行
+# 本地运行（最小配置）
 docker run -d \
   --name ide-code-server \
   -p 8080:8080 \
-  -v $(pwd)/data:/home/coder \
+  -v $(pwd)/project:/home/coder/project \
+  -v $(pwd)/code-server:/home/coder/.local/share/code-server \
   -e PASSWORD=yourpassword \
   ide-code-server:latest
 ```
@@ -97,15 +98,51 @@ Dockerfile 采用精心设计的分层结构以优化缓存效率：
 ```
 /home/coder/
 ├── project/                              # 工作区（主要挂载点）
-├── .local/share/code-server/             # VS Code 扩展目录
-├── .m2/settings.xml                      # Maven 配置
+├── .local/share/code-server/             # VS Code 扩展和用户数据
+├── .local/share/pnpm/                    # pnpm 包存储
+├── .m2/
+│   ├── settings.xml                      # Maven 配置
+│   └── repository/                       # Maven 本地仓库
+├── .npm/                                 # npm 缓存
 ├── .npmrc                                # npm 配置
 ├── .gemrc                                # gem 配置
 ├── .config/pip/pip.conf                  # pip 配置
-├── go/                                   # Go GOPATH
+├── .cache/
+│   ├── uv/                               # uv 缓存
+│   └── pip/                              # pip 缓存
+├── go/                                   # Go GOPATH（用户安装的包）
 └── .rbenv/                               # Ruby 版本管理
 ```
 
+## 外部挂载支持
+
+为提升开发体验，以下目录支持外部挂载以实现数据持久化：
+
+| 容器路径 | 用途 | 挂载优势 |
+|----------|------|----------|
+| `/home/coder/project` | 工作区 | 代码持久化 |
+| `/home/coder/.local/share/code-server` | VS Code 数据 | 扩展和设置持久化 |
+| `/home/coder/.npm` | npm 缓存 | 避免重复下载 |
+| `/home/coder/.local/share/pnpm` | pnpm 存储 | 共享包存储 |
+| `/home/coder/go` | Go 包 | 持久化 go install 的包 |
+| `/home/coder/.cache/uv` | uv 缓存 | Python 包缓存 |
+| `/home/coder/.cache/pip` | pip 缓存 | pip 包缓存 |
+| `/home/coder/.m2/repository` | Maven 仓库 | Java 依赖缓存 |
+
+### 推荐挂载配置
+
+```bash
+docker run -d \
+  --name ide-code-server \
+  -p 8080:8080 \
+  -v $(pwd)/project:/home/coder/project \
+  -v $(pwd)/code-server:/home/coder/.local/share/code-server \
+  -v $(pwd)/npm:/home/coder/.npm \
+  -v $(pwd)/go:/home/coder/go \
+  -e PASSWORD=yourpassword \
+  ghcr.io/fjiayang/ide-code-server:latest
+```
+
 ## 开发约定
 
 ### Dockerfile 编写规范

README.md

@@ -15,7 +15,7 @@ A comprehensive development environment Docker image based on code-server, pre-c
 docker run -d \
   --name ide-code-server \
   -p 8080:8080 \
-  -v $(pwd)/data:/home/coder \
+  -v $(pwd)/project:/home/coder/project \
   -e PASSWORD=yourpassword \
   ghcr.io/your-username/ide-code-server:latest
 ```
@@ -24,35 +24,122 @@ Access at http://localhost:8080
 
 ## Volume Mounts
 
-| Container Path | Purpose |
-|----------------|---------|
-| `/home/coder` | User home directory (configs, caches) |
-| `/home/coder/project` | Workspace |
-| `/home/coder/.local/share/code-server` | VS Code extensions |
+### Recommended External Mounts
+
+For better persistence and performance, mount these directories externally:
+
+| Container Path | Purpose | Description |
+|----------------|---------|-------------|
+| `/home/coder/project` | Workspace | Main workspace directory |
+| `/home/coder/.local/share/code-server` | VS Code Data | Extensions, settings, and user data |
+| `/home/coder/.npm` | npm Cache | npm global cache |
+| `/home/coder/.local/share/pnpm` | pnpm Store | pnpm package store |
+| `/home/coder/go` | Go Packages | GOPATH for user-installed Go packages |
+| `/home/coder/.cache/uv` | uv Cache | uv Python package cache |
+| `/home/coder/.cache/pip` | pip Cache | pip package cache |
+| `/home/coder/.m2/repository` | Maven Repo | Maven local repository |
+
+### Minimal Setup
+
+```bash
+docker run -d \
+  --name ide-code-server \
+  -p 8080:8080 \
+  -v $(pwd)/project:/home/coder/project \
+  -v $(pwd)/code-server:/home/coder/.local/share/code-server \
+  -e PASSWORD=yourpassword \
+  ghcr.io/your-username/ide-code-server:latest
+```
+
+### Full Setup with All Mounts
+
+```bash
+docker run -d \
+  --name ide-code-server \
+  -p 8080:8080 \
+  -v $(pwd)/project:/home/coder/project \
+  -v $(pwd)/code-server:/home/coder/.local/share/code-server \
+  -v $(pwd)/npm:/home/coder/.npm \
+  -v $(pwd)/pnpm:/home/coder/.local/share/pnpm \
+  -v $(pwd)/go:/home/coder/go \
+  -v $(pwd)/cache/uv:/home/coder/.cache/uv \
+  -v $(pwd)/cache/pip:/home/coder/.cache/pip \
+  -v $(pwd)/m2:/home/coder/.m2/repository \
+  -e PASSWORD=yourpassword \
+  ghcr.io/your-username/ide-code-server:latest
+```
 
 ## Docker Compose
 
+### Minimal Configuration
+
 ```yaml
 services:
   ide-code-server:
     image: ghcr.io/your-username/ide-code-server:latest
     volumes:
-      - ./data:/home/coder
+      - ./project:/home/coder/project
+      - ./code-server:/home/coder/.local/share/code-server
     ports:
       - "8080:8080"
     environment:
       - PASSWORD=yourpassword
     restart: unless-stopped
 ```
 
+### Full Configuration with All Mounts
+
+```yaml
+services:
+  ide-code-server:
+    image: ghcr.io/your-username/ide-code-server:latest
+    volumes:
+      # Workspace
+      - ./project:/home/coder/project
+      # VS Code extensions and settings
+      - ./code-server:/home/coder/.local/share/code-server
+      # Node.js package caches
+      - ./npm:/home/coder/.npm
+      - ./pnpm:/home/coder/.local/share/pnpm
+      # Go packages (GOPATH)
+      - ./go:/home/coder/go
+      # Python package caches
+      - ./cache/uv:/home/coder/.cache/uv
+      - ./cache/pip:/home/coder/.cache/pip
+      # Maven local repository
+      - ./m2:/home/coder/.m2/repository
+    ports:
+      - "8080:8080"
+    environment:
+      - PASSWORD=yourpassword
+    restart: unless-stopped
+```
+
+## Benefits of External Mounts
+
+1. **VS Code Extensions** (`/home/coder/.local/share/code-server`)
+   - Extensions persist across container rebuilds
+   - Share extensions between containers
+   - Faster startup after rebuild
+
+2. **Package Caches** (`/home/coder/.npm`, `/home/coder/.local/share/pnpm`, etc.)
+   - Avoid re-downloading packages
+   - Share caches between containers
+   - Faster dependency installation
+
+3. **Language Packages** (`/home/coder/go`, `/home/coder/.m2/repository`)
+   - Persist globally installed packages
+   - Go tools installed via `go install`
+   - Maven dependencies cached locally
+
 ## Installed Languages
 
 | Language | Version | Tools | Mirror |
 |----------|---------|-------|--------|
 | Go | 1.24.0 | gopls, delve, golangci-lint | goproxy.cn |
 | Python | 3.13 | uv, conda | pypi.tuna.tsinghua.edu.cn |
 | Node.js | 22 LTS | npm, pnpm, yarn | npmmirror |
-| JDK | 21 | Maven 3.9.9 | Aliyun |
+| JDK | 21 | Maven 3.9.11 | Aliyun |
 | Ruby | 3.4.1 | Rails, Bundler | Ruby China |
 
 ## Build
@@ -63,4 +150,4 @@ docker build -t ide-code-server .
 
 ## License
 
-MIT
+MIT