@xcanwin/manyoyo 3.0.0 → 3.1.0

package/README.md

@@ -1,103 +1,121 @@
+[English](docs/README_EN.md) | [ [中文](README.md) ]
+
+---
+
 # MANYOYO（慢悠悠）
 
 **MANYOYO** 是一款 AI 智能体提效安全沙箱，安全、高效、省 token，专为 Agent YOLO 模式设计，保障宿主机安全。
 
-预装常见 Agent 与工具，进一步节省 token。循环自由切换 Agent 和 /bin/bash，进一步提效。
+预装常见 Agent 与工具，进一步节省 token。循环自由切换 Agent 和 `/bin/bash`，进一步提效。
 
-MANYOYO provides an isolated Docker/Podman container environment for running AI agent CLIs safely.
+**MANYOYO** 提供隔离的 Docker/Podman 容器环境，用于安全运行 AI 智能体命令行工具。
 
 ## 功能亮点
 
-- **多Agent**：支持 claude code, gemini, codex, opencode
+- **多智能体支持**：支持 claude code, gemini, codex, opencode
 - **安全隔离**：保护宿主机，支持安全容器嵌套（Docker-in-Docker）
-- **高效启动**：快捷开启常见 Agent YOLO / SOLO 模式（例如 claude --dangerously-skip-permissions）
+- **快速启动**：快捷开启常见 Agent YOLO / SOLO 模式（例如 claude --dangerously-skip-permissions）
 - **便捷操作**：快速进入 `/bin/bash`
 - **会话恢复**：安装 Skills Marketplace 可快速恢复会话
-- **自定义灵活**：支持自定义 `BASEURL`、`AUTH_TOKEN` 等变量
+- **灵活自定义**：支持自定义 `BASEURL`、`AUTH_TOKEN` 等变量
 - **配置管理**：快捷导入配置文件
 - **高级模式**：支持危险容器嵌套（mount-docker-socket）、自定义沙箱镜像
 
 # 使用方法
 
-## 1. 安装 podman
-
-- 安装 [podman](https://podman.io/docs/installation)
+## 1. 安装 manyoyo
 
-## 2. 编译镜像
+### 全局安装（推荐）
 
-```
-podman pull ubuntu:24.04
-iv=1.4.0-all && podman build -t localhost/xcanwin/manyoyo:$iv -f docker/manyoyo.Dockerfile . --build-arg EXT=all --no-cache
-podman image prune -f
+```bash
+npm install -g @xcanwin/manyoyo
 ```
 
-## 3. 安装 manyoyo（选一种）
-
-### Global Installation (Recommended)
+### 本地开发
 
 ```bash
-npm install -g @xcanwin/manyoyo
+npm install -g .
 ```
 
-### Local Development
+## 2. 安装 podman
+
+- 安装 [podman](https://podman.io/docs/installation)
+
+## 3. 编译镜像
+
+安装 manyoyo 后，可以使用内置命令构建镜像：
 
 ```bash
-npm install -g .
+# 拉取基础镜像
+podman pull ubuntu:24.04
+
+# 使用 manyoyo 构建镜像（推荐）
+manyoyo --ib all                     # 构建 all 版本（包含所有工具）
+manyoyo --ib common                  # 构建 common 版本（基础版本）
+manyoyo --ib go,codex,java,gemini    # 构建 go 版本（包含 go,codex,java,gemini 工具）
+
+# 自定义镜像名称和版本
+manyoyo --ib all --in myimage --iv 2.0.0
+# 构建：myimage:2.0.0-all
+
+# 或手动构建（不推荐）
+iv=1.4.0 && podman build -t localhost/xcanwin/manyoyo:$iv-all -f docker/manyoyo.Dockerfile . --build-arg EXT=all --no-cache
+podman image prune -f
 ```
 
 ## 4. 使用方法
 
-### Basic Commands
+### 基础命令
 
 ```bash
-# Show help
+# 显示帮助
 manyoyo -h
 
-# Show version
+# 显示版本
 manyoyo -V
 
-# List all containers
+# 列出所有容器
 manyoyo -l
 
-# Create new container with environment file
+# 创建新容器并使用环境文件
 manyoyo -n test --ef .env -y c
 
-# Resume existing session
+# 恢复现有会话
 manyoyo -n test -- -c
 
-# Execute command in interactive shell
+# 在交互式 shell 中执行命令
 manyoyo -n test -x /bin/bash
 
-# Execute custom command
+# 执行自定义命令
 manyoyo -n test -x echo "hello world"
 
-# Remove container
+# 删除容器
 manyoyo -n test --rm
 ```
 
-### Environment Variables
+### 环境变量
 
-#### String Format
+#### 字符串格式
 
 ```bash
-# Direct
+# 直接传递
 manyoyo -e "VAR=value" -x env
 
-# Multiple
+# 多个变量
 manyoyo -e "A=1" -e "B=2" -x env
 ```
 
-#### File Format
+#### 文件格式
 
 ```bash
-# From file
+# 从文件加载
 manyoyo --ef .env -x env
 ```
 
-Environment files (`.env`) support the following formats:
+环境文件（`.env`）支持以下格式：
 
 ```bash
-# With export statement
+# 使用 export 语句
 export ANTHROPIC_BASE_URL="https://api.anthropic.com"
 # export CLAUDE_CODE_OAUTH_TOKEN="sk-xxxxxxxx"
 export ANTHROPIC_AUTH_TOKEN="sk-xxxxxxxx"
@@ -108,107 +126,108 @@ 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"
 
-# Simple key=value
+# 简单的键值对
 API_KEY=your-api-key-here
 
-# Quoted values (quotes will be stripped)
+# 带引号的值（引号会被移除）
 MESSAGE="Hello World"
 PATH='/usr/local/bin'
 ```
 
-### AI CLI Shortcuts (skip permissions)
+### AI CLI 快捷方式（跳过权限确认）
 
 ```bash
 # Claude Code
-manyoyo -y c          # or: claude, cc
+manyoyo -y c          # 或: claude, cc
 
 # Gemini
-manyoyo -y gm         # or: gemini, g
+manyoyo -y gm         # 或: gemini, g
 
 # Codex
-manyoyo -y cx         # or: codex
+manyoyo -y cx         # 或: codex
 
 # OpenCode
-manyoyo -y oc         # or: opencode
+manyoyo -y oc         # 或: opencode
 ```
 
-### Interactive Session Management
+### 交互式会话管理
 
-After exiting a container session, you'll be prompted with options:
+退出容器会话后，系统将提示您选择操作：
 
-- `y` - Keep container running in background (default)
-- `n` - Delete the container
-- `1` - Re-enter with the original command
-- `s` - Execute a new command
-- `i` - Enter interactive shell
+- `y` - 保持容器在后台运行（默认）
+- `n` - 删除容器
+- `1` - 使用首次命令重新进入
+- `x` - 执行新命令
+- `i` - 进入交互式 shell
 
-### Container Modes
+### 容器模式
 
-#### Docker-in-Docker Development
+#### Docker-in-Docker 开发
 
 ```bash
-# Docker-in-Docker (safe nested containers)
-# Create a container with Docker-in-Docker support
+# Docker-in-Docker（安全的嵌套容器）
+# 创建支持 Docker-in-Docker 的容器
 manyoyo -n docker-dev -m dind -x /bin/bash
 
-# Inside the container, start dockerd
+# 在容器内启动 dockerd
 nohup dockerd &
 
-# Now you can use docker commands inside the container
+# 现在可以在容器内使用 docker 命令
 docker run hello-world
 ```
 
-#### Mount Docker socket Development
+#### 挂载 Docker Socket 开发
 
 ```bash
-# Mount Docker socket (dangerous - container can access host)
+# 挂载 Docker Socket（危险 - 容器可以访问宿主机）
 manyoyo -n socket-dev -m mdsock -x docker ps
 ```
 
-### Command-Line Options
-
-| Option | Aliases | Description |
-|--------|---------|-------------|
-| `-l` | `--ls`, `--list` | List all manyoyo containers |
-| `--hp PATH` | `--host-path` | Set host working directory (default: current path) |
-| `-n NAME` | `--cn`, `--cont-name` | Set container name |
-| `--cp PATH` | `--cont-path` | Set container working directory |
-| `--in NAME` | `--image-name` | Specify image name |
-| `--iv VERSION` | `--image-ver` | Specify image version |
-| `-e STRING` | `--env` | Set environment variable |
-| `--ef FILE` | `--env-file` | Load environment variables from file |
-| `-v STRING` | `--volume` | Bind mount volume |
-| `--rm` | `--rmc`, `--remove-cont` | Remove container |
-| `--sp CMD` | `--shell-prefix` | Temporary environment variable (prefix for -s) |
-| `-s CMD` | `--shell` | Specify command to execute |
-| `--` | `--ss`, `--shell-suffix` | Command arguments (suffix for -s) |
-| `-x CMD` | `--sf`, `--shell-full` | Full command (replaces --sp, -s, and --) |
-| `-y CLI` | `--yolo` | Run AI agent without confirmation |
-| `-m MODE` | `--cm`, `--cont-mode` | Set container mode (common, dind, mdsock) |
-| `--install NAME` | | Install manyoyo command |
-| `-V` | `--version` | Show version |
-| `-h` | `--help` | Show help |
+### 命令行选项
+
+| 选项 | 别名 | 描述 |
+|------|------|------|
+| `-l` | `--ls`, `--list` | 列出所有 manyoyo 容器 |
+| `--hp PATH` | `--host-path` | 设置宿主机工作目录（默认：当前路径） |
+| `-n NAME` | `--cn`, `--cont-name` | 设置容器名称 |
+| `--cp PATH` | `--cont-path` | 设置容器工作目录 |
+| `--in NAME` | `--image-name` | 指定镜像名称 |
+| `--iv VERSION` | `--image-ver` | 指定镜像版本 |
+| `-e STRING` | `--env` | 设置环境变量 |
+| `--ef FILE` | `--env-file` | 从文件加载环境变量 |
+| `-v STRING` | `--volume` | 绑定挂载卷 |
+| `--rm` | `--rmc`, `--remove-cont` | 删除容器 |
+| `--sp CMD` | `--shell-prefix` | 临时环境变量（作为 -s 的前缀） |
+| `-s CMD` | `--shell` | 指定要执行的命令 |
+| `--` | `--ss`, `--shell-suffix` | 命令参数（作为 -s 的后缀） |
+| `-x CMD` | `--sf`, `--shell-full` | 完整命令（替代 --sp, -s 和 --） |
+| `-y CLI` | `--yolo` | 无需确认运行 AI 智能体 |
+| `-m MODE` | `--cm`, `--cont-mode` | 设置容器模式（common, dind, mdsock） |
+| `--ib EXT` | `--image-build` | 构建镜像，EXT 为镜像变体（all, go, common） |
+| `--install NAME` | | 安装 manyoyo 命令 |
+| `-V` | `--version` | 显示版本 |
+| `-h` | `--help` | 显示帮助 |
 
 ## 其他说明
 
-### Default Configuration
+### 默认配置
 
-- **Container Name**: `myy-{MMDD-HHMM}` (auto-generated based on current time)
-- **Host Path**: Current working directory
-- **Container Path**: Same as host path
-- **Image**: `localhost/xcanwin/manyoyo:xxx`
+- **容器名称**：`myy-{月日-时分}`（基于当前时间自动生成）
+- **宿主机路径**：当前工作目录
+- **容器路径**：与宿主机路径相同
+- **镜像**：`localhost/xcanwin/manyoyo:xxx`
 
-### Requirements
+### 系统要求
 
-- Node.js >= 14.0.0
-- Docker or Podman
+- Node.js >= 24.0.0
+- Docker 或 Podman
 
-### Remove
+### 卸载
 
 ```bash
 npm uninstall -g @xcanwin/manyoyo
 ```
 
-## License
+## 许可证
 
 MIT

package/bin/manyoyo.js

@@ -8,7 +8,7 @@ const { execSync, spawnSync } = require('child_process');
 const fs = require('fs');
 const path = require('path');
 const readline = require('readline');
-const { version: BIN_VERSION } = require('../package.json');
+const { version: BIN_VERSION, imageVersion: IMAGE_VERSION_BASE } = require('../package.json');
 
 // Helper function to format date like bash $(date +%m%d-%H%M)
 function formatDate() {
@@ -25,12 +25,14 @@ let CONTAINER_NAME = `myy-${formatDate()}`;
 let HOST_PATH = process.cwd();
 let CONTAINER_PATH = HOST_PATH;
 let IMAGE_NAME = "localhost/xcanwin/manyoyo";
-let IMAGE_VERSION = "1.4.0-all";
+let IMAGE_VERSION = `${IMAGE_VERSION_BASE}-all`;
 let EXEC_COMMAND = "";
 let EXEC_COMMAND_PREFIX = "";
 let EXEC_COMMAND_SUFFIX = "";
 let ENV_FILE = "";
 let SHOULD_REMOVE = false;
+let SHOULD_BUILD_IMAGE = false;
+let BUILD_IMAGE_EXT = "";
 let CONTAINER_ENVS = [];
 let CONTAINER_VOLUMES = [];
 let MANYOYO_NAME = "manyoyo";
@@ -83,12 +85,15 @@ function showHelp() {
     console.log("                                 例如 claude / c, gemini / gm, codex / cx, opencode / oc");
     console.log("  -m|--cm|--cont-mode STRING     设置容器嵌套容器模式");
     console.log("                                 例如 common, dind, mdsock");
+    console.log("  --ib|--image-build EXT         构建镜像，EXT 为镜像变体，逗号分割");
+    console.log("                                 例如 \"common\" (默认值), \"all\", \"go,codex,java,gemini\" ...");
     console.log("  --install NAME                 安装manyoyo命令");
     console.log("                                 例如 docker-cli-plugin");
     console.log("  -V|--version                   显示版本");
     console.log("  -h|--help                      显示帮助");
     console.log("");
     console.log(`${BLUE}Example:${NC}`);
+    console.log(`  ${MANYOYO_NAME} --ib all                            构建 all 版本镜像`);
     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                         指定命令执行`);
@@ -295,6 +300,46 @@ function getContList() {
     }
 }
 
+async function buildImage(ext, imageName, imageVersion) {
+    // Use package.json imageVersion if not specified
+    const version = imageVersion || IMAGE_VERSION_BASE;
+    const fullImageTag = `${imageName}:${version}-${ext}`;
+
+    console.log(`${CYAN}🔨 正在构建镜像: ${YELLOW}${fullImageTag}${NC}`);
+    console.log(`${BLUE}构建参数: EXT=${ext}${NC}\n`);
+
+    // Find Dockerfile path
+    const dockerfilePath = path.join(__dirname, '../docker/manyoyo.Dockerfile');
+    if (!fs.existsSync(dockerfilePath)) {
+        console.error(`${RED}错误: 找不到 Dockerfile: ${dockerfilePath}${NC}`);
+        process.exit(1);
+    }
+
+    // Build command
+    const buildCmd = `${DOCKER_CMD} build -t "${fullImageTag}" -f "${dockerfilePath}" "${path.join(__dirname, '..')}" --build-arg EXT=${ext} --no-cache`;
+
+    console.log(`${BLUE}准备执行命令:${NC}`);
+    console.log(`${buildCmd}\n`);
+
+    const reply = await askQuestion(`❔ 是否继续构建? [ 直接回车=继续, ctrl+c=取消 ]: `);
+    console.log("");
+
+    try {
+        execSync(buildCmd, { stdio: 'inherit' });
+        console.log(`\n${GREEN}✅ 镜像构建成功: ${fullImageTag}${NC}`);
+        console.log(`${BLUE}使用镜像:${NC}`);
+        console.log(`  manyoyo -n test --in ${imageName} --iv ${version}-${ext} -y c`);
+
+        // Prune dangling images
+        console.log(`\n${YELLOW}清理悬空镜像...${NC}`);
+        execSync(`${DOCKER_CMD} image prune -f`, { stdio: 'inherit' });
+        console.log(`${GREEN}✅ 清理完成${NC}`);
+    } catch (e) {
+        console.error(`${RED}错误: 镜像构建失败${NC}`);
+        process.exit(1);
+    }
+}
+
 // ==============================================================================
 // Main Function Helpers
 // ==============================================================================
@@ -439,6 +484,13 @@ function parseArguments(argv) {
                 i += 2;
                 break;
 
+            case '--ib':
+            case '--image-build':
+                SHOULD_BUILD_IMAGE = true;
+                BUILD_IMAGE_EXT = args[i + 1];
+                i += 2;
+                break;
+
             case '--install':
                 installManyoyo(args[i + 1]);
                 process.exit(0);
@@ -589,7 +641,7 @@ async function handlePostExit(defaultCommand) {
     console.log("");
     getHelloTip(CONTAINER_NAME, defaultCommand);
 
-    const reply = await askQuestion(`❔ 会话已结束。是否保留此后台容器 ${CONTAINER_NAME}? [ y=默认保留, n=删除, 1=首次命令进入, s=执行命令, i=交互式SHELL ]: `);
+    const reply = await askQuestion(`❔ 会话已结束。是否保留此后台容器 ${CONTAINER_NAME}? [ y=默认保留, n=删除, 1=首次命令进入, x=执行命令, i=交互式SHELL ]: `);
     console.log("");
 
     const firstChar = reply.trim().toLowerCase()[0];
@@ -605,7 +657,7 @@ async function handlePostExit(defaultCommand) {
         const newArgs = ['-n', CONTAINER_NAME];
         process.argv = [process.argv[0], process.argv[1], ...newArgs];
         await main();
-    } else if (firstChar === 's') {
+    } else if (firstChar === 'x') {
         const command = await askQuestion('❔ 输入要执行的命令: ');
         console.log(`${GREEN}✅ 离开当前连接，执行命令。${NC}`);
         const newArgs = ['-n', CONTAINER_NAME, '-x', command];
@@ -633,19 +685,25 @@ async function main() {
         // 2. Parse command-line arguments
         parseArguments(process.argv);
 
-        // 3. Handle remove container operation
+        // 3. Handle image build operation
+        if (SHOULD_BUILD_IMAGE) {
+            await buildImage(BUILD_IMAGE_EXT, IMAGE_NAME, IMAGE_VERSION.split('-')[0]);
+            process.exit(0);
+        }
+
+        // 4. Handle remove container operation
         handleRemoveContainer();
 
-        // 4. Validate host path safety
+        // 5. Validate host path safety
         validateHostPath();
 
-        // 5. Setup container (create or connect)
+        // 6. Setup container (create or connect)
         const defaultCommand = await setupContainer();
 
-        // 6. Execute command in container
+        // 7. Execute command in container
         executeInContainer(defaultCommand);
 
-        // 7. Handle post-exit interactions
+        // 8. Handle post-exit interactions
         await handlePostExit(defaultCommand);
 
     } catch (e) {

package/docker/manyoyo.Dockerfile

@@ -2,7 +2,7 @@ FROM ubuntu:24.04
 
 ARG TARGETARCH
 ARG NODE_VERSION=24
-ARG EXT=""
+ARG EXT="common"
 
 RUN <<EOX
     # 部署 system

package/docs/README_EN.md

@@ -0,0 +1,233 @@
+[ [English](README_EN.md) ] | [中文](../README.md)
+
+---
+
+# MANYOYO (Man-Yo-Yo)
+
+**MANYOYO** is an AI agent security sandbox that is safe, efficient, and token-saving. Designed specifically for Agent YOLO mode to protect the host machine.
+
+Pre-installed with common agents and tools to further save tokens. Freely switch between agents and `/bin/bash` in a loop for enhanced efficiency.
+
+**MANYOYO** provides an isolated Docker/Podman container environment for running AI agent CLIs safely.
+
+## Key Features
+
+- **Multi-Agent Support**: Supports claude code, gemini, codex, opencode
+- **Security Isolation**: Protects host machine, supports safe nested containers (Docker-in-Docker)
+- **Quick Launch**: Quickly enable common Agent YOLO / SOLO mode (e.g., claude --dangerously-skip-permissions)
+- **Convenient Operations**: Quick access to `/bin/bash`
+- **Session Recovery**: Install Skills Marketplace to quickly resume sessions
+- **Flexible Customization**: Support custom `BASEURL`, `AUTH_TOKEN`, and other variables
+- **Configuration Management**: Quick import of configuration files
+- **Advanced Mode**: Supports dangerous nested containers (mount-docker-socket), custom sandbox images
+
+# Usage
+
+## 1. Install manyoyo
+
+### Global Installation (Recommended)
+
+```bash
+npm install -g @xcanwin/manyoyo
+```
+
+### Local Development
+
+```bash
+npm install -g .
+```
+
+## 2. Install podman
+
+- Install [podman](https://podman.io/docs/installation)
+
+## 3. Build Image
+
+After installing manyoyo, use the built-in command to build images:
+
+```bash
+# Pull base image
+podman pull ubuntu:24.04
+
+# Build using manyoyo (Recommended)
+manyoyo --ib all                     # Build all version (includes all tools)
+manyoyo --ib common                  # Build common version (basic version)
+manyoyo --ib go,codex,java,gemini    # Build go version (includes go,codex,java,gemini tools)
+
+# Custom image name and version
+manyoyo --ib all --in myimage --iv 2.0.0
+# Builds: myimage:2.0.0-all
+
+# Or build manually (Not recommended)
+iv=1.4.0 && podman build -t localhost/xcanwin/manyoyo:$iv-all -f docker/manyoyo.Dockerfile . --build-arg EXT=all --no-cache
+podman image prune -f
+```
+
+## 4. Usage
+
+### Basic Commands
+
+```bash
+# Show help
+manyoyo -h
+
+# Show version
+manyoyo -V
+
+# List all containers
+manyoyo -l
+
+# Create new container with environment file
+manyoyo -n test --ef .env -y c
+
+# Resume existing session
+manyoyo -n test -- -c
+
+# Execute command in interactive shell
+manyoyo -n test -x /bin/bash
+
+# Execute custom command
+manyoyo -n test -x echo "hello world"
+
+# Remove container
+manyoyo -n test --rm
+```
+
+### Environment Variables
+
+#### String Format
+
+```bash
+# Direct
+manyoyo -e "VAR=value" -x env
+
+# Multiple
+manyoyo -e "A=1" -e "B=2" -x env
+```
+
+#### File Format
+
+```bash
+# From file
+manyoyo --ef .env -x env
+```
+
+Environment files (`.env`) support the following formats:
+
+```bash
+# With export statement
+export ANTHROPIC_BASE_URL="https://api.anthropic.com"
+# export CLAUDE_CODE_OAUTH_TOKEN="sk-xxxxxxxx"
+export ANTHROPIC_AUTH_TOKEN="sk-xxxxxxxx"
+export API_TIMEOUT_MS=3000000
+export ANTHROPIC_MODEL="claude-sonnet-4-5"
+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"
+
+# Simple key=value
+API_KEY=your-api-key-here
+
+# Quoted values (quotes will be stripped)
+MESSAGE="Hello World"
+PATH='/usr/local/bin'
+```
+
+### AI CLI Shortcuts (skip permissions)
+
+```bash
+# Claude Code
+manyoyo -y c          # or: claude, cc
+
+# Gemini
+manyoyo -y gm         # or: gemini, g
+
+# Codex
+manyoyo -y cx         # or: codex
+
+# OpenCode
+manyoyo -y oc         # or: opencode
+```
+
+### Interactive Session Management
+
+After exiting a container session, you'll be prompted with options:
+
+- `y` - Keep container running in background (default)
+- `n` - Delete the container
+- `1` - Re-enter with the original command
+- `x` - Execute a new command
+- `i` - Enter interactive shell
+
+### Container Modes
+
+#### Docker-in-Docker Development
+
+```bash
+# Docker-in-Docker (safe nested containers)
+# Create a container with Docker-in-Docker support
+manyoyo -n docker-dev -m dind -x /bin/bash
+
+# Inside the container, start dockerd
+nohup dockerd &
+
+# Now you can use docker commands inside the container
+docker run hello-world
+```
+
+#### Mount Docker socket Development
+
+```bash
+# Mount Docker socket (dangerous - container can access host)
+manyoyo -n socket-dev -m mdsock -x docker ps
+```
+
+### Command-Line Options
+
+| Option | Aliases | Description |
+|--------|---------|-------------|
+| `-l` | `--ls`, `--list` | List all manyoyo containers |
+| `--hp PATH` | `--host-path` | Set host working directory (default: current path) |
+| `-n NAME` | `--cn`, `--cont-name` | Set container name |
+| `--cp PATH` | `--cont-path` | Set container working directory |
+| `--in NAME` | `--image-name` | Specify image name |
+| `--iv VERSION` | `--image-ver` | Specify image version |
+| `-e STRING` | `--env` | Set environment variable |
+| `--ef FILE` | `--env-file` | Load environment variables from file |
+| `-v STRING` | `--volume` | Bind mount volume |
+| `--rm` | `--rmc`, `--remove-cont` | Remove container |
+| `--sp CMD` | `--shell-prefix` | Temporary environment variable (prefix for -s) |
+| `-s CMD` | `--shell` | Specify command to execute |
+| `--` | `--ss`, `--shell-suffix` | Command arguments (suffix for -s) |
+| `-x CMD` | `--sf`, `--shell-full` | Full command (replaces --sp, -s, and --) |
+| `-y CLI` | `--yolo` | Run AI agent without confirmation |
+| `-m MODE` | `--cm`, `--cont-mode` | Set container mode (common, dind, mdsock) |
+| `--ib EXT` | `--image-build` | Build image, EXT is image variant (all, go, common) |
+| `--install NAME` | | Install manyoyo command |
+| `-V` | `--version` | Show version |
+| `-h` | `--help` | Show help |
+
+## Additional Information
+
+### Default Configuration
+
+- **Container Name**: `myy-{MMDD-HHMM}` (auto-generated based on current time)
+- **Host Path**: Current working directory
+- **Container Path**: Same as host path
+- **Image**: `localhost/xcanwin/manyoyo:xxx`
+
+### Requirements
+
+- Node.js >= 24.0.0
+- Docker or Podman
+
+### Uninstall
+
+```bash
+npm uninstall -g @xcanwin/manyoyo
+```
+
+## License
+
+MIT

package/package.json

@@ -1,6 +1,7 @@
 {
   "name": "@xcanwin/manyoyo",
-  "version": "3.0.0",
+  "version": "3.1.0",
+  "imageVersion": "1.5.0",
   "description": "AI Agent CLI Security Sandbox",
   "keywords": [
     "ai", "agent", "sandbox", "docker", "cli", "container", "development"
@@ -26,8 +27,9 @@
     "node": ">=14.0.0"
   },
   "files": [
-    "manyoyo.js",
+    "bin/manyoyo.js",
     "README.md",
+    "docs/README_EN.md",
     "LICENSE",
     "docker/manyoyo.Dockerfile"
   ]