@xcanwin/manyoyo 3.5.7 → 3.7.0

package/README.md

@@ -40,6 +40,7 @@ npm install -g .
 ## 2. 安装 podman
 
 2.1 安装 [podman](https://podman.io/docs/installation)
+
 2.2 拉取基础镜像
 
 ```bash
@@ -100,31 +101,40 @@ manyoyo --irm
 
 # 静默显示执行命令
 manyoyo -q full -x echo "hello world"
+manyoyo -q tip -q cmd -x echo "hello world"  # 多次使用静默选项
 ```
 
 ### 环境变量
 
-#### 字符串格式
+给容器内CLI传递BASE_URL和TOKEN等。
 
-```bash
-# 直接传递
-manyoyo -e "VAR=value" -x env
+#### 字符串形式
 
-# 多个变量
-manyoyo -e "A=1" -e "B=2" -x env
+```bash
+manyoyo -e "ANTHROPIC_BASE_URL=https://xxxx" -e "ANTHROPIC_AUTH_TOKEN=your-key" -x claude
 ```
 
-#### 文件格式
+#### 文件形式
+
+环境文件使用 `.env` 格式，支持注释（以 `#` 开头的行）：
 
 ```bash
-# 从文件加载
-manyoyo --ef .env -x env
+export ANTHROPIC_BASE_URL="https://xxxx"
+AUTH_TOANTHROPIC_AUTH_TOKENKEN=your-key
+# MESSAGE="Hello World"  # 注释会被忽略
+TESTPATH='/usr/local/bin'
 ```
 
-环境文件（`.env`）支持以下格式：
+**环境文件路径规则**：
+- `manyoyo --ef myconfig` → 加载 `~/.manyoyo/env/myconfig.env`
+- `manyoyo --ef ./myconfig.env` → 加载当前目录的 `myconfig.env`
 
 ```bash
-# 使用 export 语句
+# 创建环境文件目录
+mkdir -p ~/.manyoyo/env/
+
+# 示例：创建 Claude 环境文件
+cat > ~/.manyoyo/env/claude.env << 'EOF'
 export ANTHROPIC_BASE_URL="https://api.anthropic.com"
 # export CLAUDE_CODE_OAUTH_TOKEN="sk-xxxxxxxx"
 export ANTHROPIC_AUTH_TOKEN="sk-xxxxxxxx"
@@ -134,13 +144,82 @@ export ANTHROPIC_DEFAULT_OPUS_MODEL="claude-opus-4-5"
 export ANTHROPIC_DEFAULT_SONNET_MODEL="claude-sonnet-4-5"
 export ANTHROPIC_DEFAULT_HAIKU_MODEL="claude-haiku-4-5"
 export CLAUDE_CODE_SUBAGENT_MODEL="claude-sonnet-4-5"
+EOF
+
+# 在任意目录下使用环境文件
+manyoyo --ef claude -x claude
+```
+
+### 配置文件
+
+简化MANYOYO命令行操作。配置文件使用 **JSON5 格式**，支持注释、尾随逗号等特性。
+
+#### 配置文件路径规则
+
+- `manyoyo -r myconfig` → 加载 `~/.manyoyo/run/myconfig.json`
+- `manyoyo -r ./myconfig.json` → 加载当前目录的 `myconfig.json`
+- `manyoyo [任何选项]` → 始终会加载全局配置 `~/.manyoyo/manyoyo.json`
 
-# 简单的键值对
-API_KEY=your-api-key-here
+#### 配置选项
 
-# 带引号的值（引号会被移除）
-MESSAGE="Hello World"
-PATH='/usr/local/bin'
+参考 `config.example.json` 文件查看所有可配置项：
+
+```json5
+{
+  // 容器基础配置
+  "containerName": "myy-dev",          // 默认容器名称
+  "hostPath": "/path/to/project",      // 默认宿主机工作目录
+  "containerPath": "/path/to/project", // 默认容器工作目录
+  "imageName": "localhost/xcanwin/manyoyo",  // 默认镜像名称
+  "imageVersion": "1.6.3-full",        // 默认镜像版本
+  "containerMode": "common",           // 容器嵌套模式 (common, dind, sock)
+
+  // 环境变量配置
+  "envFile": [
+    "claude"  // 对应 ~/.manyoyo/env/claude.env
+  ],
+  "env": [],                           // 默认环境变量数组
+
+  // 其他配置
+  "volumes": [],                       // 默认挂载卷数组
+  "shellPrefix": "",                   // 默认命令前缀
+  "shell": "",                         // 默认执行命令
+  "yolo": "",                          // 默认 YOLO 模式 (c, gm, cx, oc)
+  "quiet": [],                           // 默认静默选项数组 (支持 ["tip", "cmd"] 格式)
+  "imageBuildArgs": []                 // 默认镜像构建参数
+}
+```
+
+#### 优先级
+
+- **覆盖型参数**：命令行 > 运行配置 > 全局配置 > 默认值
+- **合并型参数**：全局配置 + 运行配置 + 命令行（按顺序累加）
+
+覆盖型参数包括：`containerName`, `hostPath`, `containerPath`, `imageName`, `imageVersion`, `containerMode`, `shellPrefix`, `shell`, `yolo`, `quiet`
+
+合并型参数包括：`envFile`, `env`, `volumes`, `imageBuildArgs`
+
+#### 常用样例
+
+```bash
+# 创建运行配置目录
+mkdir -p ~/.manyoyo/run/
+
+# 创建 Claude 运行配置
+cat > ~/.manyoyo/run/c.json << 'EOF'
+{
+  // Claude Code 快捷配置
+  "imageName": "localhost/xcanwin/manyoyo",
+  "imageVersion": "1.6.3-full",
+  "envFile": [
+    "claude"  // 自动加载 ~/.manyoyo/env/claude.env
+  ],
+  "yolo": "c"
+}
+EOF
+
+# 在任意目录下使用运行配置
+manyoyo -r c
 ```
 
 ### AI CLI 快捷方式（跳过权限确认）
@@ -212,7 +291,7 @@ docker ps -a             # 现在可以在容器内使用 docker 命令
 | `--iba XXX=YYY` | `--image-build-arg` | 构建镜像时传参给dockerfile |
 | `--irm` | `--image-remove` | 清理悬空镜像和 `<none>` 镜像 |
 | `-e STRING` | `--env` | 设置环境变量 |
-| `--ef FILE` | `--env-file` | 从文件加载环境变量 |
+| `--ef FILE` | `--env-file` | 从文件加载环境变量（支持 `name` 或 `./path.env`） |
 | `-v STRING` | `--volume` | 绑定挂载卷 |
 | `--sp CMD` | `--shell-prefix` | 临时环境变量（作为 -s 的前缀） |
 | `-s CMD` | `--shell` | 指定要执行的命令 |
@@ -221,6 +300,7 @@ docker ps -a             # 现在可以在容器内使用 docker 命令
 | `-y CLI` | `--yolo` | 无需确认运行 AI 智能体 |
 | `--install NAME` | | 安装 manyoyo 命令 |
 | `-q LIST` | `--quiet` | 静默显示 |
+| `-r NAME` | `--run` | 加载运行配置（支持 `name` 或 `./path.json`） |
 | `-V` | `--version` | 显示版本 |
 | `-h` | `--help` | 显示帮助 |
 

package/bin/manyoyo.js

@@ -7,7 +7,10 @@
 const { execSync, spawnSync } = require('child_process');
 const fs = require('fs');
 const path = require('path');
+const os = require('os');
 const readline = require('readline');
+const { Command } = require('commander');
+const JSON5 = require('json5');
 const { version: BIN_VERSION, imageVersion: IMAGE_VERSION_BASE } = require('../package.json');
 
 // Helper function to format date like bash $(date +%m%d-%H%M)
@@ -59,59 +62,61 @@ function sleep(ms) {
 }
 
 // ==============================================================================
-// UI Functions
+// Configuration File Functions
 // ==============================================================================
 
-function showHelp() {
-    console.log(`MANYOYO   -   AI Agent CLI Sandbox`);
-    console.log(`https://github.com/xcanwin/manyoyo`);
-    console.log("");
-    console.log(`${BLUE}Usage:${NC}`);
-    console.log(`  ${MANYOYO_NAME} [OPTIONS]`);
-    console.log(`  ${MANYOYO_NAME} [--hp HOST_PATH] [-n CONTAINER_NAME] [--cp CONTAINER_PATH] [--ef ENV_FILE] [--sp COMMAND] [-s COMMAND] [-- COMMAND]`);
-    console.log("");
-    console.log(`${BLUE}Options:${NC}`);
-    console.log("  --hp|--host-path PATH            设置宿主机工作目录 (默认当前路径)");
-    console.log("  -n|--cn|--cont-name NAME         设置容器名称");
-    console.log("  --cp|--cont-path PATH            设置容器工作目录");
-    console.log("  -l|--cl|--cont-list              列举容器");
-    console.log("  --crm|--cont-remove              删除-n指定容器");
-    console.log("  -m|--cm|--cont-mode STRING       设置容器嵌套容器模式");
-    console.log("                                   例如 common, dind, sock");
-    console.log("  --in|--image-name NAME           指定镜像名称");
-    console.log("  --iv|--image-ver VERSION         指定镜像版本");
-    console.log("  --ib|--image-build               构建镜像");
-    console.log("  --iba|--image-build-arg XXX=YYY  构建镜像时传参给dockerfile");
-    console.log("  --irm|--image-remove             清理悬空镜像和 <none> 镜像");
-    console.log("  -e|--env XXX=YYY                 设置环境变量");
-    console.log("  --ef|--env-file ENV_FILE         设置环境变量通过文件");
-    console.log("  -v|--volume XXX:YYY              绑定挂载卷");
-    console.log("  --sp|--shell-prefix COMMAND      临时环境变量 (作为-s前缀)");
-    console.log("  -s|--shell COMMAND               指定命令执行");
-    console.log("  --|--shell-suffix COMMAND        指定命令参数, --后面全部直传 (作为-s后缀)");
-    console.log("  -x|--shell-full COMMAND          指定完整命令执行, -x后面全部直传 (代替--sp和-s和--命令)");
-    console.log("  -y|--yolo CLI                    使AGENT无需确认 (代替-s命令)");
-    console.log("                                   例如 claude / c, gemini / gm, codex / cx, opencode / oc");
-    console.log("  --install NAME                   安装manyoyo命令");
-    console.log("                                   例如 docker-cli-plugin");
-    console.log("  -q|--quiet LIST                  静默显示");
-    console.log("                                   例如 cnew,crm,tip,cmd,full");
-    console.log("  -V|--version                     显示版本");
-    console.log("  -h|--help                        显示帮助");
-    console.log("");
-    console.log(`${BLUE}Example:${NC}`);
-    console.log(`  ${MANYOYO_NAME} --ib                                构建镜像`);
-    console.log(`  ${MANYOYO_NAME} -n test --ef ./xxx.env -y c         设置环境变量并运行无需确认的AGENT`);
-    console.log(`  ${MANYOYO_NAME} -n test -- -c                       恢复之前会话`);
-    console.log(`  ${MANYOYO_NAME} -x echo 123                         指定命令执行`);
-    console.log(`  ${MANYOYO_NAME} -n test --ef ./xxx.env -x claude    设置环境变量并运行`);
-    console.log(`  ${MANYOYO_NAME} -n test -x claude -c                恢复之前会话`);
+function loadConfig() {
+    const configPath = path.join(os.homedir(), '.manyoyo', 'manyoyo.json');
+    if (fs.existsSync(configPath)) {
+        try {
+            const config = JSON5.parse(fs.readFileSync(configPath, 'utf-8'));
+            return config;
+        } catch (e) {
+            console.error(`${YELLOW}⚠️  配置文件格式错误: ${configPath}${NC}`);
+            return {};
+        }
+    }
+    return {};
 }
 
-function showVersion() {
-    console.log(`manyoyo by xcanwin, ${BIN_VERSION}`);
+function loadRunConfig(name) {
+    // Check if name is a file path (contains path separator or extension)
+    const isFilePath = name.includes('/') || name.includes('\\') || path.extname(name);
+
+    if (isFilePath) {
+        // If it's a file path, only check that exact path
+        if (fs.existsSync(name)) {
+            try {
+                const config = JSON5.parse(fs.readFileSync(name, 'utf-8'));
+                return config;
+            } catch (e) {
+                console.error(`${YELLOW}⚠️  运行配置文件格式错误: ${name}${NC}`);
+                return {};
+            }
+        }
+    } else {
+        // If it's just a name, only check ~/.manyoyo/run/name.json
+        const configPath = path.join(os.homedir(), '.manyoyo', 'run', `${name}.json`);
+        if (fs.existsSync(configPath)) {
+            try {
+                const config = JSON5.parse(fs.readFileSync(configPath, 'utf-8'));
+                return config;
+            } catch (e) {
+                console.error(`${YELLOW}⚠️  运行配置文件格式错误: ${configPath}${NC}`);
+                return {};
+            }
+        }
+    }
+
+    console.error(`${RED}⚠️  未找到运行配置: ${name}${NC}`);
+    return {};
 }
 
+// ==============================================================================
+// UI Functions
+// ==============================================================================
+
+
 function getHelloTip(containerName, defaultCommand) {
     if ( !(QUIET.tip || QUIET.full) ) {
         console.log("");
@@ -126,8 +131,12 @@ function getHelloTip(containerName, defaultCommand) {
     }
 }
 
-function setQuiet(action) {
-    action.split(',').forEach(ac => {
+function setQuiet(actions) {
+    // Support both string and array input
+    const actionArray = Array.isArray(actions) ? actions : [actions];
+    actionArray.forEach(action => {
+        // Remove comma splitting - each action should be a single quiet option
+        const ac = action.trim();
         switch (ac) {
             case 'cnew':
                 QUIET.cnew = 1;
@@ -149,7 +158,6 @@ function setQuiet(action) {
                 break;
         }
     });
-    // process.exit(0);
 }
 
 async function askQuestion(prompt) {
@@ -175,9 +183,21 @@ function addEnv(env) {
 }
 
 function addEnvFile(envFile) {
-    ENV_FILE = envFile;
-    if (ENV_FILE && fs.existsSync(ENV_FILE)) {
-        const content = fs.readFileSync(ENV_FILE, 'utf-8');
+    // Check if envFile is a file path (contains path separator)
+    const isFilePath = envFile.includes('/') || envFile.includes('\\');
+
+    let filePath;
+    if (isFilePath) {
+        // If it's a file path, only check that exact path
+        filePath = envFile;
+    } else {
+        // If it's just a name, only check ~/.manyoyo/env/name.env
+        filePath = path.join(os.homedir(), '.manyoyo', 'env', `${envFile}.env`);
+    }
+
+    ENV_FILE = filePath;
+    if (fs.existsSync(filePath)) {
+        const content = fs.readFileSync(filePath, 'utf-8');
         const lines = content.split('\n');
 
         for (let line of lines) {
@@ -203,7 +223,10 @@ function addEnvFile(envFile) {
                 }
             }
         }
+        return {};
     }
+    console.error(`${RED}⚠️  未找到环境文件: ${envFile}${NC}`);
+    return {};
 }
 
 function addVolume(volume) {
@@ -231,7 +254,7 @@ function setYolo(cli) {
             EXEC_COMMAND = "opencode";
             break;
         default:
-            console.log(`${RED}⚠️ 未知LLM CLI: ${cli}${NC}`);
+            console.log(`${RED}⚠️  未知LLM CLI: ${cli}${NC}`);
             process.exit(0);
     }
 }
@@ -251,10 +274,10 @@ function setContMode(mode) {
         case 'sock':
         case 's':
             CONT_MODE = "--privileged --volume /var/run/docker.sock:/var/run/docker.sock --env DOCKER_HOST=unix:///var/run/docker.sock --env CONTAINER_HOST=unix:///var/run/docker.sock";
-            console.log(`${RED}⚠️ 开启危险的容器嵌套容器模式, 危害: 容器可访问宿主机文件${NC}`);
+            console.log(`${RED}⚠️  开启危险的容器嵌套容器模式, 危害: 容器可访问宿主机文件${NC}`);
             break;
         default:
-            console.log(`${RED}⚠️ 未知模式: ${mode}${NC}`);
+            console.log(`${RED}⚠️  未知模式: ${mode}${NC}`);
             process.exit(0);
     }
 }
@@ -565,188 +588,157 @@ async function buildImage(IMAGE_BUILD_ARGS, imageName, imageVersion) {
 // Main Function Helpers
 // ==============================================================================
 
-function validateAndInitialize() {
-    // Check if no arguments provided
-    if (process.argv.length <= 2) {
-        showHelp();
-        process.exit(1);
-    }
-
-    // Ensure docker/podman is available
-    ensureDocker();
-
-    // Docker CLI plugin metadata
+function setupCommander() {
+    // Load config file
+    const config = loadConfig();
+
+    const program = new Command();
+
+    program
+        .name(MANYOYO_NAME)
+        .version(BIN_VERSION, '-V, --version', '显示版本')
+        .description('MANYOYO - AI Agent CLI Sandbox\nhttps://github.com/xcanwin/manyoyo')
+        .addHelpText('after', `
+配置文件:
+  ~/.manyoyo/manyoyo.json    全局配置文件 (JSON5格式，支持注释)
+  ~/.manyoyo/run/c.json      运行配置示例
+
+路径规则:
+  -r name       → ~/.manyoyo/run/name.json
+  -r ./file.json → 当前目录的 file.json
+  --ef name     → ~/.manyoyo/env/name.env
+  --ef ./file.env → 当前目录的 file.env
+
+示例:
+  ${MANYOYO_NAME} --ib                                构建镜像
+  ${MANYOYO_NAME} -r c                                使用 ~/.manyoyo/run/c.json 配置
+  ${MANYOYO_NAME} -r ./myconfig.json                  使用当前目录 ./myconfig.json 配置
+  ${MANYOYO_NAME} -n test --ef claude -y c            使用 ~/.manyoyo/env/claude.env 环境变量文件
+  ${MANYOYO_NAME} -n test --ef ./myenv.env -y c       使用当前目录 ./myenv.env 环境变量文件
+  ${MANYOYO_NAME} -n test -- -c                       恢复之前会话
+  ${MANYOYO_NAME} -x echo 123                         指定命令执行
+  ${MANYOYO_NAME} -n test -q tip -q cmd               多次使用静默选项
+        `);
+
+    // Options
+    program
+        .option('-r, --run <name>', '加载运行配置 (name → ~/.manyoyo/run/name.json, ./file.json → 当前目录文件)')
+        .option('--hp, --host-path <path>', '设置宿主机工作目录 (默认当前路径)')
+        .option('-n, --cont-name <name>', '设置容器名称')
+        .option('--cp, --cont-path <path>', '设置容器工作目录')
+        .option('-l, --cont-list', '列举容器')
+        .option('--crm, --cont-remove', '删除-n指定容器')
+        .option('-m, --cont-mode <mode>', '设置容器嵌套容器模式 (common, dind, sock)')
+        .option('--in, --image-name <name>', '指定镜像名称')
+        .option('--iv, --image-ver <version>', '指定镜像版本')
+        .option('--ib, --image-build', '构建镜像')
+        .option('--iba, --image-build-arg <arg>', '构建镜像时传参给dockerfile (可多次使用)', (value, previous) => [...(previous || []), value], [])
+        .option('--irm, --image-remove', '清理悬空镜像和 <none> 镜像')
+        .option('-e, --env <env>', '设置环境变量 XXX=YYY (可多次使用)', (value, previous) => [...(previous || []), value], [])
+        .option('--ef, --env-file <file>', '设置环境变量通过文件 (name → ~/.manyoyo/env/name.env, ./file.env → 当前目录文件)', (value, previous) => [...(previous || []), value], [])
+        .option('-v, --volume <volume>', '绑定挂载卷 XXX:YYY (可多次使用)', (value, previous) => [...(previous || []), value], [])
+        .option('--sp, --shell-prefix <command>', '临时环境变量 (作为-s前缀)')
+        .option('-s, --shell <command>', '指定命令执行')
+        .option('-x, --shell-full <command...>', '指定完整命令执行 (代替--sp和-s和--命令)')
+        .option('-y, --yolo <cli>', '使AGENT无需确认 (claude/c, gemini/gm, codex/cx, opencode/oc)')
+        .option('--install <name>', '安装manyoyo命令 (docker-cli-plugin)')
+        .option('-q, --quiet <item>', '静默显示 (可多次使用: cnew,crm,tip,cmd,full)', (value, previous) => [...(previous || []), value], []);
+
+    // Docker CLI plugin metadata check
     if (process.argv[2] === 'docker-cli-plugin-metadata') {
-        const metadata = {
+        console.log(JSON.stringify({
             "SchemaVersion": "0.1.0",
             "Vendor": "xcanwin",
             "Version": "v1.0.0",
             "Description": "AI Agent CLI Sandbox"
-        };
-        console.log(JSON.stringify(metadata, null, 2));
+        }, null, 2));
         process.exit(0);
     }
-}
-
-function parseArguments(argv) {
-    // Parse arguments
-    let args = argv.slice(2);
 
     // Docker CLI plugin mode - remove first arg if running as plugin
     const dockerPluginPath = path.join(process.env.HOME || '', '.docker/cli-plugins/docker-manyoyo');
-    if (argv[1] === dockerPluginPath && args[0] === 'manyoyo') {
-        args.shift();
+    if (process.argv[1] === dockerPluginPath && process.argv[2] === 'manyoyo') {
+        process.argv.splice(2, 1);
     }
 
-    // Parse command-line arguments
-    let i = 0;
-    while (i < args.length) {
-        const arg = args[i];
-
-        switch (arg) {
-            case '-q':
-            case '--quiet':
-                setQuiet(args[i + 1]);
-                i += 2;
-                break;
-
-            case '--hp':
-            case '--host-path':
-                HOST_PATH = args[i + 1];
-                i += 2;
-                break;
-
-            case '-n':
-            case '--cn':
-            case '--cont-name':
-                CONTAINER_NAME = args[i + 1];
-                i += 2;
-                break;
-
-            case '--cp':
-            case '--cont-path':
-                CONTAINER_PATH = args[i + 1];
-                i += 2;
-                break;
-
-            case '-l':
-            case '--cl':
-            case '--cont-list':
-                getContList();
-                process.exit(0);
-
-            case '--crm':
-            case '--cont-remove':
-                SHOULD_REMOVE = true;
-                i += 1;
-                break;
-
-            case '--in':
-            case '--image-name':
-                IMAGE_NAME = args[i + 1];
-                i += 2;
-                break;
-
-            case '--iv':
-            case '--image-ver':
-                IMAGE_VERSION = args[i + 1];
-                i += 2;
-                break;
-
-            case '-e':
-            case '--env':
-                addEnv(args[i + 1]);
-                i += 2;
-                break;
-
-            case '--ef':
-            case '--env-file':
-                addEnvFile(args[i + 1]);
-                i += 2;
-                break;
+    // Ensure docker/podman is available
+    ensureDocker();
 
-            case '-v':
-            case '--volume':
-                addVolume(args[i + 1]);
-                i += 2;
-                break;
+    // Parse arguments
+    program.allowUnknownOption(false);
+    program.parse(process.argv);
 
-            case '--sp':
-            case '--shell-prefix':
-                EXEC_COMMAND_PREFIX = args[i + 1] + " ";
-                i += 2;
-                break;
+    const options = program.opts();
 
-            case '-s':
-            case '--shell':
-                EXEC_COMMAND = args[i + 1];
-                i += 2;
-                break;
+    // Load run config if specified
+    const runConfig = options.run ? loadRunConfig(options.run) : {};
 
-            case '--':
-            case '--ss':
-            case '--shell-suffix':
-                EXEC_COMMAND_SUFFIX = " " + args.slice(i + 1).join(' ');
-                i = args.length;
-                break;
+    // Merge configs: command line > run config > global config > defaults
+    // Override mode (scalar values): use first defined value
+    HOST_PATH = options.hostPath || runConfig.hostPath || config.hostPath || HOST_PATH;
+    if (options.contName || runConfig.containerName || config.containerName) {
+        CONTAINER_NAME = options.contName || runConfig.containerName || config.containerName;
+    }
+    if (options.contPath || runConfig.containerPath || config.containerPath) {
+        CONTAINER_PATH = options.contPath || runConfig.containerPath || config.containerPath;
+    }
+    IMAGE_NAME = options.imageName || runConfig.imageName || config.imageName || IMAGE_NAME;
+    if (options.imageVer || runConfig.imageVersion || config.imageVersion) {
+        IMAGE_VERSION = options.imageVer || runConfig.imageVersion || config.imageVersion;
+    }
+    if (options.shellPrefix || runConfig.shellPrefix || config.shellPrefix) {
+        EXEC_COMMAND_PREFIX = (options.shellPrefix || runConfig.shellPrefix || config.shellPrefix) + " ";
+    }
+    if (options.shell || runConfig.shell || config.shell) {
+        EXEC_COMMAND = options.shell || runConfig.shell || config.shell;
+    }
 
-            case '-x':
-            case '--sf':
-            case '--shell-full':
-                EXEC_COMMAND = args.slice(i + 1).join(' ');
-                i = args.length;
-                break;
+    // Merge mode (array values): concatenate all sources
+    const toArray = (val) => Array.isArray(val) ? val : (val ? [val] : []);
+    const envFileList = [
+        ...toArray(config.envFile),
+        ...toArray(runConfig.envFile),
+        ...(options.envFile || [])
+    ].filter(Boolean);
+    envFileList.forEach(ef => addEnvFile(ef));
 
-            case '-y':
-            case '--yolo':
-                setYolo(args[i + 1]);
-                i += 2;
-                break;
+    const envList = [...(config.env || []), ...(runConfig.env || []), ...(options.env || [])];
+    envList.forEach(e => addEnv(e));
 
-            case '-m':
-            case '--cm':
-            case '--cont-mode':
-                setContMode(args[i + 1]);
-                i += 2;
-                break;
+    const volumeList = [...(config.volumes || []), ...(runConfig.volumes || []), ...(options.volume || [])];
+    volumeList.forEach(v => addVolume(v));
 
-            case '--ib':
-            case '--image-build':
-                IMAGE_BUILD_NEED = true;
-                i += 1;
-                break;
+    const buildArgList = [...(config.imageBuildArgs || []), ...(runConfig.imageBuildArgs || []), ...(options.imageBuildArg || [])];
+    buildArgList.forEach(arg => addImageBuildArg(arg));
 
-            case '--iba':
-            case '--image-build-arg':
-                addImageBuildArg(args[i + 1]);
-                i += 2;
-                break;
+    // Override mode for special options
+    const yoloValue = options.yolo || runConfig.yolo || config.yolo;
+    if (yoloValue) setYolo(yoloValue);
 
-            case '--irm':
-            case '--image-remove':
-                pruneDanglingImages();
-                process.exit(0);
+    const contModeValue = options.contMode || runConfig.containerMode || config.containerMode;
+    if (contModeValue) setContMode(contModeValue);
 
-            case '--install':
-                installManyoyo(args[i + 1]);
-                process.exit(0);
+    const quietValue = options.quiet || runConfig.quiet || config.quiet;
+    if (quietValue) setQuiet(quietValue);
 
-            case '-V':
-            case '--version':
-                showVersion();
-                process.exit(0);
+    if (options.contList) { getContList(); process.exit(0); }
+    if (options.contRemove) SHOULD_REMOVE = true;
+    if (options.imageBuild) IMAGE_BUILD_NEED = true;
+    if (options.imageRemove) { pruneDanglingImages(); process.exit(0); }
+    if (options.install) { installManyoyo(options.install); process.exit(0); }
 
-            case '-h':
-            case '--help':
-                showHelp();
-                process.exit(0);
+    // Handle shell-full (variadic arguments)
+    if (options.shellFull) {
+        EXEC_COMMAND = options.shellFull.join(' ');
+    }
 
-            default:
-                console.log(`${RED}⚠️ 未知参数: ${arg}${NC}`);
-                showHelp();
-                process.exit(1);
-        }
+    // Handle -- suffix arguments
+    const doubleDashIndex = process.argv.indexOf('--');
+    if (doubleDashIndex !== -1 && doubleDashIndex < process.argv.length - 1) {
+        EXEC_COMMAND_SUFFIX = " " + process.argv.slice(doubleDashIndex + 1).join(' ');
     }
+
+    return program;
 }
 
 function handleRemoveContainer() {
@@ -755,10 +747,10 @@ function handleRemoveContainer() {
             if (containerExists(CONTAINER_NAME)) {
                 removeContainer(CONTAINER_NAME);
             } else {
-                console.log(`${RED}⚠️ 错误: 未找到名为 ${CONTAINER_NAME} 的容器。${NC}`);
+                console.log(`${RED}⚠️  错误: 未找到名为 ${CONTAINER_NAME} 的容器。${NC}`);
             }
         } catch (e) {
-            console.log(`${RED}⚠️ 错误: 未找到名为 ${CONTAINER_NAME} 的容器。${NC}`);
+            console.log(`${RED}⚠️  错误: 未找到名为 ${CONTAINER_NAME} 的容器。${NC}`);
         }
         process.exit(0);
     }
@@ -768,7 +760,7 @@ function validateHostPath() {
     const realHostPath = fs.realpathSync(HOST_PATH);
     const homeDir = process.env.HOME || '/home';
     if (realHostPath === '/' || realHostPath === '/home' || realHostPath === homeDir) {
-        console.log(`${RED}⚠️ 错误: 不允许挂载根目录或home目录。${NC}`);
+        console.log(`${RED}⚠️  错误: 不允许挂载根目录或home目录。${NC}`);
         process.exit(1);
     }
 }
@@ -785,7 +777,7 @@ async function waitForContainerReady(containerName) {
             }
 
             if (status === 'exited') {
-                console.log(`${RED}⚠️ 错误: 容器启动后立即退出。${NC}`);
+                console.log(`${RED}⚠️  错误: 容器启动后立即退出。${NC}`);
                 dockerExec(`${DOCKER_CMD} logs "${containerName}"`, { stdio: 'inherit' });
                 process.exit(1);
             }
@@ -794,7 +786,7 @@ async function waitForContainerReady(containerName) {
             count++;
 
             if (count >= MAX_RETRIES) {
-                console.log(`${RED}⚠️ 错误: 容器启动超时（当前状态: ${status}）。${NC}`);
+                console.log(`${RED}⚠️  错误: 容器启动超时（当前状态: ${status}）。${NC}`);
                 dockerExec(`${DOCKER_CMD} logs "${containerName}"`, { stdio: 'inherit' });
                 process.exit(1);
             }
@@ -802,7 +794,7 @@ async function waitForContainerReady(containerName) {
             await sleep(100);
             count++;
             if (count >= MAX_RETRIES) {
-                console.log(`${RED}⚠️ 错误: 容器启动超时。${NC}`);
+                console.log(`${RED}⚠️  错误: 容器启动超时。${NC}`);
                 process.exit(1);
             }
         }
@@ -917,31 +909,28 @@ async function handlePostExit(defaultCommand) {
 
 async function main() {
     try {
-        // 1. Validate and initialize
-        validateAndInitialize();
-
-        // 2. Parse command-line arguments
-        parseArguments(process.argv);
+        // 1. Setup commander and parse arguments
+        setupCommander();
 
-        // 3. Handle image build operation
+        // 2. Handle image build operation
         if (IMAGE_BUILD_NEED) {
             await buildImage(IMAGE_BUILD_ARGS, IMAGE_NAME, IMAGE_VERSION.split('-')[0]);
             process.exit(0);
         }
 
-        // 4. Handle remove container operation
+        // 3. Handle remove container operation
         handleRemoveContainer();
 
-        // 5. Validate host path safety
+        // 4. Validate host path safety
         validateHostPath();
 
-        // 6. Setup container (create or connect)
+        // 5. Setup container (create or connect)
         const defaultCommand = await setupContainer();
 
-        // 7. Execute command in container
+        // 6. Execute command in container
         executeInContainer(defaultCommand);
 
-        // 8. Handle post-exit interactions
+        // 7. Handle post-exit interactions
         await handlePostExit(defaultCommand);
 
     } catch (e) {

package/config.example.json

@@ -0,0 +1,21 @@
+{
+  // MANYOYO 全局配置文件，保存到 ~/.manyoyo/manyoyo.json
+
+  // 覆盖型参数（命令行 > 运行配置 > 全局配置）
+  "containerName": "myy-dev",
+  "hostPath": "/path/to/your/project",
+  "containerPath": "/path/to/your/project",
+  "imageName": "localhost/xcanwin/manyoyo",
+  "imageVersion": "1.6.4-full",
+  "containerMode": "common",
+  "shellPrefix": "",
+  "shell": "",
+  "yolo": "",
+
+  // 合并型参数（配置文件和命令行会累加）
+  "env": ["IS_SANDBOX=1"],
+  "envFile": [],
+  "volumes": [],
+  "imageBuildArgs": [],
+  "quiet": ["tip", "cmd"]
+}

package/docker/manyoyo.Dockerfile

@@ -192,7 +192,7 @@ EOF
         mkdir -p ~/.config/opencode/
         cat > ~/.config/opencode/opencode.json <<EOF
 {
-  "$schema": "https://opencode.ai/config.json",
+  "\$schema": "https://opencode.ai/config.json",
   "autoupdate": false,
   "permission": "allow",
   "model": "myprovider/{env:ANTHROPIC_MODEL}",

package/docs/README_EN.md

@@ -40,6 +40,7 @@ npm install -g .
 ## 2. Install podman
 
 2.1 Install [podman](https://podman.io/docs/installation)
+
 2.2 Pull base image
 
 ```bash
@@ -100,31 +101,40 @@ manyoyo --irm
 
 # Execute custom command with quiet output
 manyoyo -q full -x echo "hello world"
+manyoyo -q tip -q cmd -x echo "hello world"  # Multiple quiet options
 ```
 
 ### Environment Variables
 
+给容器内CLI传递BASE_URL和TOKEN等。
+
 #### String Format
 
 ```bash
-# Direct
-manyoyo -e "VAR=value" -x env
-
-# Multiple
-manyoyo -e "A=1" -e "B=2" -x env
+manyoyo -e "ANTHROPIC_BASE_URL=https://xxxx" -e "ANTHROPIC_AUTH_TOKEN=your-key" -x claude
 ```
 
 #### File Format
 
+Environment files use `.env` format and support comments (lines starting with `#`):
+
 ```bash
-# From file
-manyoyo --ef .env -x env
+export ANTHROPIC_BASE_URL="https://xxxx"
+ANTHROPIC_AUTH_TOKEN=your-key
+# MESSAGE="Hello World"  # Comments will be ignored
+TESTPATH='/usr/local/bin'
 ```
 
-Environment files (`.env`) support the following formats:
+**Environment file path rules**:
+- `manyoyo --ef myconfig` → loads `~/.manyoyo/env/myconfig.env`
+- `manyoyo --ef ./myconfig.env` → loads `myconfig.env` from current directory
 
 ```bash
-# With export statement
+# Create environment file directory
+mkdir -p ~/.manyoyo/env/
+
+# Example: Create Claude environment file
+cat > ~/.manyoyo/env/claude.env << 'EOF'
 export ANTHROPIC_BASE_URL="https://api.anthropic.com"
 # export CLAUDE_CODE_OAUTH_TOKEN="sk-xxxxxxxx"
 export ANTHROPIC_AUTH_TOKEN="sk-xxxxxxxx"
@@ -134,13 +144,82 @@ export ANTHROPIC_DEFAULT_OPUS_MODEL="claude-opus-4-5"
 export ANTHROPIC_DEFAULT_SONNET_MODEL="claude-sonnet-4-5"
 export ANTHROPIC_DEFAULT_HAIKU_MODEL="claude-haiku-4-5"
 export CLAUDE_CODE_SUBAGENT_MODEL="claude-sonnet-4-5"
+EOF
+
+# Use environment file from any directory
+manyoyo --ef claude -x claude
+```
+
+### Configuration Files
+
+Simplify MANYOYO command-line operations. Configuration files use **JSON5 format**, which supports comments, trailing commas, and other features.
+
+#### Configuration file path rules
+
+- `manyoyo -r myconfig` → loads `~/.manyoyo/run/myconfig.json`
+- `manyoyo -r ./myconfig.json` → loads `myconfig.json` from current directory
+- `manyoyo [any option]` → always loads global configuration `~/.manyoyo/manyoyo.json`
 
-# Simple key=value
-API_KEY=your-api-key-here
+#### Configuration Options
 
-# Quoted values (quotes will be stripped)
-MESSAGE="Hello World"
-PATH='/usr/local/bin'
+Refer to `config.example.json` for all available options:
+
+```json5
+{
+  // Container basic configuration
+  "containerName": "myy-dev",          // Default container name
+  "hostPath": "/path/to/project",      // Default host working directory
+  "containerPath": "/path/to/project", // Default container working directory
+  "imageName": "localhost/xcanwin/manyoyo",  // Default image name
+  "imageVersion": "1.6.3-full",        // Default image version
+  "containerMode": "common",           // Container nesting mode (common, dind, sock)
+
+  // Environment variable configuration
+  "envFile": [
+    "claude"  // Corresponds to ~/.manyoyo/env/claude.env
+  ],
+  "env": [],                           // Default environment variables array
+
+  // Other configuration
+  "volumes": [],                       // Default volume mounts array
+  "shellPrefix": "",                   // Default command prefix
+  "shell": "",                         // Default execute command
+  "yolo": "",                          // Default YOLO mode (c, gm, cx, oc)
+  "quiet": [],                           // Default quiet options array (supports ["tip", "cmd"] format)
+  "imageBuildArgs": []                 // Default image build arguments
+}
+```
+
+#### Priority
+
+- **Override parameters**: Command line > Run config > Global config > Defaults
+- **Merge parameters**: Global config + Run config + Command line (concatenated in order)
+
+Override parameters include: `containerName`, `hostPath`, `containerPath`, `imageName`, `imageVersion`, `containerMode`, `shellPrefix`, `shell`, `yolo`, `quiet`
+
+Merge parameters include: `envFile`, `env`, `volumes`, `imageBuildArgs`
+
+#### Common Examples
+
+```bash
+# Create run configuration directory
+mkdir -p ~/.manyoyo/run/
+
+# Create Claude run configuration
+cat > ~/.manyoyo/run/c.json << 'EOF'
+{
+  // Claude Code quick configuration
+  "imageName": "localhost/xcanwin/manyoyo",
+  "imageVersion": "1.6.3-full",
+  "envFile": [
+    "claude"  // Automatically loads ~/.manyoyo/env/claude.env
+  ],
+  "yolo": "c"
+}
+EOF
+
+# Use run configuration from any directory
+manyoyo -r c
 ```
 
 ### AI CLI Shortcuts (skip permissions)
@@ -212,7 +291,7 @@ docker ps -a             # Now you can use docker commands inside the container
 | `--iba` | `--image-build-arg` | Pass arguments to a Dockerfile during image build |
 | `--irm` | `--image-remove` | Clean dangling images and `<none>` images |
 | `-e STRING` | `--env` | Set environment variable |
-| `--ef FILE` | `--env-file` | Load environment variables from file |
+| `--ef FILE` | `--env-file` | Load environment variables from file (supports `name` or `./path.env`) |
 | `-v STRING` | `--volume` | Bind mount volume |
 | `--sp CMD` | `--shell-prefix` | Temporary environment variable (prefix for -s) |
 | `-s CMD` | `--shell` | Specify command to execute |
@@ -221,6 +300,7 @@ docker ps -a             # Now you can use docker commands inside the container
 | `-y CLI` | `--yolo` | Run AI agent without confirmation |
 | `--install NAME` | | Install manyoyo command |
 | `-q LIST` | `--quiet` | Quiet output |
+| `-r NAME` | `--run` | Load run configuration (supports `name` or `./path.json`) |
 | `-V` | `--version` | Show version |
 | `-h` | `--help` | Show help |
 

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@xcanwin/manyoyo",
-  "version": "3.5.7",
-  "imageVersion": "1.6.3",
+  "version": "3.7.0",
+  "imageVersion": "1.6.4",
   "description": "AI Agent CLI Security Sandbox",
   "keywords": [
     "ai", "agent", "sandbox", "docker", "cli", "container", "development"
@@ -31,6 +31,11 @@
     "README.md",
     "docs/README_EN.md",
     "LICENSE",
-    "docker/manyoyo.Dockerfile"
-  ]
+    "docker/manyoyo.Dockerfile",
+    "config.example.json"
+  ],
+  "dependencies": {
+    "commander": "^12.0.0",
+    "json5": "^2.2.3"
+  }
 }