refactor: improve docker executor and constants

1. Fix DockerExecutor configuration: Update NewDockerExecutor to use DockerConfig struct, fix configuration in server and exec commands

2. Refactor Docker constants: Move magic strings to constants, apply minimum exposure principle, only expose necessary public constants

3. Code improvements: Better error handling, improved code readability, enhanced maintainability

Author: kuhahalong

cmd/runshell/cmd/exec.go

@@ -28,7 +28,9 @@ var execCmd = &cobra.Command{
 		// 创建执行器
 		var exec types.Executor
 		if execDockerImage != "" {
-			exec = executor.NewDockerExecutor(execDockerImage)
+			exec = executor.NewDockerExecutor(executor.DockerConfig{
+				Image: execDockerImage,
+			})
 		} else {
 			exec = executor.NewLocalExecutor()
 		}

cmd/runshell/cmd/server.go

@@ -28,7 +28,9 @@ var serverCmd = &cobra.Command{
 		// 创建执行器
 		var exec types.Executor
 		if dockerImage != "" {
-			exec = executor.NewDockerExecutor(dockerImage)
+			exec = executor.NewDockerExecutor(executor.DockerConfig{
+				Image: dockerImage,
+			})
 		} else {
 			exec = executor.NewLocalExecutor()
 		}

examples/README.md

@@ -1,52 +1,63 @@
-# RunShell Pipeline Examples
+# RunShell Examples
 
-这个目录包含了 RunShell 的使用示例。
+本目录包含了 RunShell 的使用示例。
 
-## Pipeline 示例
+## 目录结构
 
-`pipeline.go` 展示了如何使用 RunShell 的管道功能。这个示例包含了以下几种管道使用场景：
+```
+examples/
+├── pipeline/       # 管道执行示例
+│   └── pipeline.go # 演示如何使用管道执行命令
+│
+├── session_dev/    # 会话开发示例
+│   ├── session_dev.go  # 使用会话进行开发的示例代码
+│   └── session_dev.md  # 示例说明文档
+│
+└── README.md       # 本文件
+```
+
+## 示例说明
 
-1. 简单管道：`echo "hello world" | grep "world"`
-2. 多重管道：`ls -l | grep go | wc -l`
-3. 带环境变量的管道：`env | grep PATH`
-4. 复杂管道：`ps aux | grep go | sort -k2 | head -n 3`
-5. 文件处理管道：`cat go.mod | grep require | sort | uniq -c`
+### 1. Pipeline Example
 
-### 运行示例
+`pipeline/pipeline.go` 展示了如何使用 RunShell 的管道功能：
+- 简单管道命令
+- 多重管道命令
+- 带环境变量的管道
+- 复杂的管道处理
+- 文件处理管道
 
+运行方式：
 ```bash
-# 编译并运行示例
+cd pipeline
 go run pipeline.go
-
-# 或者先编译后运行
-go build pipeline.go
-./pipeline
 ```
 
-### 示例输出说明
+### 2. Session Development Example
 
-1. 简单管道示例
-   - 输出 "hello world" 并通过 grep 过滤出包含 "world" 的行
-   - 展示了基本的管道功能
+`session_dev/session_dev.go` 展示了如何使用 RunShell 的会话功能进行开发：
+- Docker 容器环境
+- 会话生命周期管理
+- 完整开发工作流程
+- 自动化构建和测试
 
-2. 多重管道示例
-   - 列出当前目录文件，过滤出包含 "go" 的行，并计算行数
-   - 展示了多个命令的串联
+运行方式：
+```bash
+# 终端 1：启动服务器
+go run ../cmd/runshell/main.go server --addr :8080
 
-3. 环境变量管道示例
-   - 显示环境变量并过滤出包含 PATH 的行
-   - 展示了如何在管道中使用环境变量
+# 终端 2：运行示例
+cd session_dev
+go run session_dev.go
+```
 
-4. 复杂管道示例
-   - 显示进程信息，过滤包含 "go" ��行，排序后显示前三行
-   - 展示了复杂的管道命令组合
+## 注意事项
 
-5. 文件处理管道示例
-   - 读取 go.mod 文件，过滤出 require 行，排序并统计重复行
-   - 展示了文件处理相关的管道操作
+1. 运行示例前请确保：
+   - Docker daemon 正在运行
+   - 相关端口未被占用
+   - 已安装所需依赖
 
-### 注意事项
+2. 每个示例都有自己的 README 或文档，请参考具体说明。
 
-1. 确保系统中安装了相关命令（grep, sort, wc 等）
-2. 示例中的某些命令可能需要根据你的系统环境进行调整
-3. 管道命令的执行结果可能因系统环境不同而有所不同
+3. 示例代码主要用于演示目的，生产环境使用时请注意安全性和错误处理。

examples/pipeline/README.md

@@ -0,0 +1,120 @@
+# Pipeline Example
+
+本示例展示了如何使用 RunShell 的管道功能执行命令链。
+
+## 功能特点
+
+1. 命令链支持
+   - 支持标准 Unix 管道操作
+   - 多级命令链执行
+   - 环境变量传递
+   - 错误处理和状态报告
+
+2. 执行器特性
+   - 标准 Unix 命令支持（ls, grep, wc 等）
+   - 输入输出流管理
+   - 执行状态跟踪
+   - 优雅的错误处理
+
+## 示例说明
+
+### 1. 简单管道命令
+```bash
+ls -la | grep go
+```
+列出当前目录内容并过滤包含 "go" 的行。这个示例展示了基本的管道功能。
+
+### 2. 多重管道命令
+```bash
+ls -la | grep go | wc -l
+```
+统计当前目录中包含 "go" 的文件数量。展示了多级管道的使用。
+
+### 3. 带环境变量的管道命令
+```bash
+env | grep PATH
+```
+显示系统路径信息，并支持添加自定义环境变量。展示了环境变量的处理。
+
+### 4. 复杂的管道命令
+```bash
+ps aux | grep go | sort -k2 | head -n 3
+```
+查找并排序 Go 相关进程，显示前三个。展示了复杂命令链的处理能力。
+
+### 5. 文件处理管道命令
+```bash
+cat ../go.mod | grep require | sort | uniq -c
+```
+分析 go.mod 文件中的依赖项。展示了文件内容处理能力。
+
+## 使用方法
+
+1. 直接运行示例：
+```bash
+go run pipeline.go
+```
+
+2. 在代码中使用：
+```go
+// 创建执行器
+localExec := executor.NewLocalExecutor()
+pipeExec := executor.NewPipelineExecutor(localExec)
+
+// 执行管道命令
+err := runPipeline(pipeExec, "ls -la | grep go", nil)
+if err != nil {
+    log.Printf("Pipeline failed: %v\n", err)
+}
+```
+
+3. 带环境变量的执行：
+```go
+env := map[string]string{
+    "CUSTOM_PATH": "/custom/path",
+}
+err := runPipeline(pipeExec, "env | grep PATH", env)
+```
+
+## 注意事项
+
+1. 命令执行
+   - 确保所需命令在系统中可用
+   - 注意命令的执行权限
+   - 考虑命令的执行时间
+
+2. 错误处理
+   - 检查每个命令的返回值
+   - 处理管道中断的情况
+   - 注意错误信息的传递
+
+3. 资源管理
+   - 及时关闭不需要的管道
+   - 注意内存使用（特别是大文件处理）
+   - 避免管道死锁
+
+## 扩展建议
+
+1. 功能增强
+   - 添加超时控制
+   - 实现并行管道
+   - 支持命令重试
+   - 添加管道缓冲控制
+
+2. 使用场景
+   - 日志处理和分析
+   - 文件批处理
+   - 系统监控
+   - 数据转换
+
+3. 最佳实践
+   - 使用适当的缓冲区大小
+   - 实现优雅的错误处理
+   - 添加详细的日志记录
+   - 考虑资源限制
+
+## 相关文档
+
+- [RunShell 文档](../../README.md)
+- [执行器文档](../../pkg/executor/doc.go)
+- [类型定义](../../pkg/types/doc.go) 

examples/pipeline.go examples/pipeline/pipeline.goexamples/pipeline.go renamed to examples/pipeline/pipeline.go

@@ -1,3 +1,23 @@
+// Package main demonstrates the pipeline functionality of RunShell.
+//
+// This example shows how to use the pipeline executor to run command chains,
+// similar to Unix-style pipes. It demonstrates various pipeline patterns:
+//   - Simple command piping
+//   - Multi-stage pipelines
+//   - Environment variable handling
+//   - Process filtering and sorting
+//   - File content processing
+//
+// The pipeline executor supports:
+//   - Standard Unix commands (ls, grep, wc, etc.)
+//   - Environment variable propagation
+//   - Error handling and status reporting
+//   - Input/Output stream management
+//
+// Example usage:
+//
+//	pipeExec := executor.NewPipelineExecutor(localExec)
+//	err := runPipeline(pipeExec, "ls -la | grep go | wc -l", nil)
 package main
 
 import (
@@ -10,6 +30,23 @@ import (
 	"github.com/iamlongalong/runshell/pkg/types"
 )
 
+// runPipeline executes a pipeline of commands and handles the results.
+//
+// Parameters:
+//   - pipeExec: The pipeline executor instance
+//   - cmdStr: The command string containing one or more piped commands
+//   - env: Optional environment variables for the pipeline
+//
+// The function:
+//  1. Parses the command string into a pipeline
+//  2. Sets up the execution context and options
+//  3. Executes the pipeline and captures the result
+//  4. Reports any errors that occur
+//
+// Example:
+//
+//	runPipeline(pipeExec, "ls -la | grep go", nil)
+//	runPipeline(pipeExec, "cat file.txt | grep pattern | wc -l", env)
 func runPipeline(pipeExec *executor.PipelineExecutor, cmdStr string, env map[string]string) error {
 	fmt.Printf("\nExecuting: %s\n", cmdStr)
 
@@ -42,20 +79,23 @@ func main() {
 	pipeExec := executor.NewPipelineExecutor(localExec)
 
 	// 示例 1: 简单的管道命令
+	// 列出当前目录内容并过滤包含 "go" 的行
 	fmt.Println("\n=== Example 1: Simple Pipeline ===")
-	err := runPipeline(pipeExec, "echo hello world | grep world", nil)
+	err := runPipeline(pipeExec, "ls -la | grep go", nil)
 	if err != nil {
 		log.Printf("Example 1 failed: %v\n", err)
 	}
 
 	// 示例 2: 多重管道命令
+	// 统计当前目录中包含 "go" 的文件数量
 	fmt.Println("\n=== Example 2: Multiple Pipes ===")
 	err = runPipeline(pipeExec, "ls -la | grep go | wc -l", nil)
 	if err != nil {
 		log.Printf("Example 2 failed: %v\n", err)
 	}
 
 	// 示例 3: 带环境变量的管道命令
+	// 显示系统路径信息，并添加自定义路径
 	fmt.Println("\n=== Example 3: Pipeline with Environment Variables ===")
 	err = runPipeline(pipeExec, "env | grep PATH", map[string]string{
 		"CUSTOM_PATH": "/custom/path",
@@ -65,13 +105,15 @@ func main() {
 	}
 
 	// 示例 4: 复杂的管道命令
+	// 查找并排序 Go 相关进程，显示前三个
 	fmt.Println("\n=== Example 4: Complex Pipeline ===")
 	err = runPipeline(pipeExec, "ps aux | grep go | sort -k2 | head -n 3", nil)
 	if err != nil {
 		log.Printf("Example 4 failed: %v\n", err)
 	}
 
 	// 示例 5: 文件处理管道命令
+	// 分析 go.mod 文件中的依赖项
 	fmt.Println("\n=== Example 5: File Processing Pipeline ===")
 	err = runPipeline(pipeExec, "cat ../go.mod | grep require | sort | uniq -c", nil)
 	if err != nil {