npm - @xcanwin/manyoyo - Versions diffs - 3.8.3 → 3.8.4 - Mend

@xcanwin/manyoyo 3.8.3 → 3.8.4

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (5) hide show

package/README.md CHANGED Viewed

@@ -1,3 +1,7 @@
+<p align="center">
+  <img src="./assets/manyoyo-logo-09-cyberpunk-terminal.svg" alt="MANYOYO logo" width="560" />
+</p>
 # <p align="center"><a href="https://github.com/xcanwin/manyoyo">MANYOYO（慢悠悠）</a></p>
 <p align="center">一款AI智能体安全沙箱，保障PC安全，可以随心所欲运行YOLO/SOLO模式。</p>
 <p align="center">
@@ -8,29 +12,15 @@
 <p align="center">
   <a href="README.md"><b>中文</b></a> |
-  <a href="docs/README_EN.md">English</a>
+  <a href="https://xcanwin.github.io/manyoyo/en/">English</a>
+</p>
+<p align="center">
+  📚 在线文档：<a href="https://xcanwin.github.io/manyoyo/">https://xcanwin.github.io/manyoyo/</a>
 </p>
 ---
-## 2 分钟快速开始
-**Docker 用户：**
-```bash
-npm install -g @xcanwin/manyoyo    # 安装
-manyoyo --ib --iv 1.7.0            # 构建镜像
-manyoyo -y c                        # 运行 Claude Code YOLO 模式
-```
-**Podman 用户：**
-```bash
-npm install -g @xcanwin/manyoyo    # 安装
-podman pull ubuntu:24.04           # 拉取基础镜像
-manyoyo --ib --iv 1.7.0            # 构建镜像
-manyoyo -y c                        # 运行 Claude Code YOLO 模式
-```
----
+## 项目简介
 **MANYOYO** 是一款 AI 智能体提效安全沙箱，安全、高效、省 token，专为 Agent YOLO 模式设计，保障宿主机安全。
@@ -45,426 +35,119 @@ manyoyo -y c                        # 运行 Claude Code YOLO 模式
 - **快速启动**：快捷开启常见 Agent YOLO / SOLO 模式（例如 claude --dangerously-skip-permissions）
 - **便捷操作**：快速进入 `/bin/bash`
 - **会话恢复**：安装 Skills Marketplace 可快速恢复会话
-- **灵活自定义**：支持自定义 `BASEURL`、`AUTH_TOKEN` 等变量
+- **灵活自定义**：支持配置各 CLI 的 `*_BASE_URL` / `*_AUTH_TOKEN` / `*_API_KEY` 等变量
 - **配置管理**：快捷导入配置文件
 - **高级模式**：支持危险容器嵌套（mount-docker-socket）、自定义沙箱镜像
-# 使用方法
-## 1. 安装 manyoyo
-### 全局安装（推荐）
-```bash
-npm install -g @xcanwin/manyoyo
-```
-### 本地开发
-```bash
-npm install -g .
-```
-## 2. 安装 podman
-2.1 安装 [podman](https://podman.io/docs/installation)
-2.2 拉取基础镜像
-```bash
-podman pull ubuntu:24.04
-```
-## 3. 编译镜像
-以下命令只需执行一条：
-```bash
-# 使用 manyoyo 构建镜像（推荐，自动使用缓存加速）
-manyoyo --ib --iv 1.7.0                          # 默认构建 full 版本（推荐，建议指定版本号）
-manyoyo --ib --iba TOOL=common                   # 构建常见组件版本（python,nodejs,claude）
-manyoyo --ib --iba TOOL=go,codex,java,gemini     # 构建自定义组件版本
-manyoyo --ib --iba GIT_SSL_NO_VERIFY=true        # 构建 full 版本且跳过git的ssl验证
-manyoyo --ib --in myimage --iv 2.0.0             # 自定义镜像名称和版本，得到 myimage:2.0.0-full
-# 工作原理：
-# - 首次构建：自动下载 Node.js、JDT LSP、gopls 等到 docker/cache/
-# - 2天内再次构建：直接使用本地缓存，速度提升约 5 倍
-# - 缓存过期后：自动重新下载最新版本
-# 或手动构建（不推荐）
-iv=1.0.0 && podman build -t localhost/xcanwin/manyoyo:$iv-full -f docker/manyoyo.Dockerfile . --build-arg TOOL=full --no-cache
-```
-## 4. 使用方法
-### 基础命令
-```bash
-# 显示帮助
-manyoyo -h
-# 显示版本
-manyoyo -V
-# 列出所有容器
-manyoyo -l
-# 创建新容器并使用环境文件
-manyoyo -n test --ef .env -y c
-# 恢复现有会话
-manyoyo -n test -- -c                 # Claude Code
-manyoyo -n test -- resume --last      # Codex
-manyoyo -n test -- -r                 # Gemini
-manyoyo -n test -- -c                 # OpenCode
-# 在交互式 shell 中执行命令
-manyoyo -n test -x /bin/bash
-# 执行自定义命令
-manyoyo -n test -x echo "hello world"
-# 删除容器
-manyoyo -n test --crm
-# 清理悬空镜像和 <none> 镜像
-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 "ANTHROPIC_BASE_URL=https://xxxx" -e "ANTHROPIC_AUTH_TOKEN=your-key" -x claude
-```
-#### 文件形式
-环境文件使用 `.env` 格式，支持注释（以 `#` 开头的行）：
-```bash
-export ANTHROPIC_BASE_URL="https://xxxx"
-AUTH_TOANTHROPIC_AUTH_TOKEN=your-key
-# MESSAGE="Hello World"  # 注释会被忽略
-TESTPATH='/usr/local/bin'
-```
-**环境文件路径规则**：
-- `manyoyo --ef myconfig` → 加载 `~/.manyoyo/env/myconfig.env`
-- `manyoyo --ef ./myconfig.env` → 加载当前目录的 `myconfig.env`
-#### 常用样例-Claude Code
-```bash
-# 创建环境文件目录
-mkdir -p ~/.manyoyo/env/
-# 示例：创建 Claude 环境文件
-cat > ~/.manyoyo/env/anthropic_[claudecode]_claudecode.env << 'EOF'
-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"
-EOF
-# 在任意目录下使用环境文件
-manyoyo --ef anthropic_[claudecode]_claudecode -x claude
-```
+---
-#### 常用样例-Codex
+## 快速开始
 ```bash
-# 创建环境文件目录
-mkdir -p ~/.manyoyo/env/
-# 示例：创建 Codex 环境文件
-cat > ~/.manyoyo/env/openai_[gpt]_codex.env << 'EOF'
-export OPENAI_BASE_URL=https://chatgpt.com/backend-api/codex
-export OTEL_SDK_DISABLED=true
-EOF
-# 在任意目录下使用环境文件
-manyoyo --ef openai_[gpt]_codex -x codex
+npm install -g @xcanwin/manyoyo    # 安装
+podman pull ubuntu:24.04           # 仅 Podman 需要
+manyoyo --ib --iv 1.7.0            # 构建镜像
+manyoyo -y c                       # 运行 Claude Code YOLO 模式
 ```
-### 配置文件
-简化MANYOYO命令行操作。配置文件使用 **JSON5 格式**，支持注释、尾随逗号等特性。
-#### 配置文件路径规则
+注意：YOLO/SOLO 会跳过权限确认，请确保在可控环境中使用。
-- `manyoyo -r myconfig` → 加载 `~/.manyoyo/run/myconfig.json`
-- `manyoyo -r ./myconfig.json` → 加载当前目录的 `myconfig.json`
-- `manyoyo [任何选项]` → 始终会加载全局配置 `~/.manyoyo/manyoyo.json`
-#### 配置选项
-参考 `config.example.json` 文件查看所有可配置项：
-```json5
-{
-    // 容器基础配置
-    "containerName": "myy-dev",          // 默认容器名称
-    "hostPath": "/path/to/project",      // 默认宿主机工作目录
-    "containerPath": "/path/to/project", // 默认容器工作目录
-    "imageName": "localhost/xcanwin/manyoyo",  // 默认镜像名称
-    "imageVersion": "1.7.0-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": []                 // 默认镜像构建参数
-}
-```
-#### 优先级
+---
-- **覆盖型参数**：命令行 > 运行配置 > 全局配置 > 默认值
-- **合并型参数**：全局配置 + 运行配置 + 命令行（按顺序累加）
+## 安全提示
-#### 配置合并规则表
+- **YOLO/SOLO 模式**：跳过权限确认，存在误删或执行危险命令风险。详见：[AI 智能体](https://xcanwin.github.io/manyoyo/zh/reference/agents)
+- **sock 容器模式**：挂载宿主机 Docker socket，容器可完全控制宿主机容器。详见：[容器模式](https://xcanwin.github.io/manyoyo/zh/reference/container-modes)
-| 参数类型 | 参数名 | 合并行为 | 示例 |
-|---------|--------|---------|------|
-| 覆盖型 | `containerName` | 取最高优先级的值 | CLI `-n test` 覆盖配置文件中的值 |
-| 覆盖型 | `hostPath` | 取最高优先级的值 | 默认为当前目录 |
-| 覆盖型 | `containerPath` | 取最高优先级的值 | 默认与 hostPath 相同 |
-| 覆盖型 | `imageName` | 取最高优先级的值 | 默认 `localhost/xcanwin/manyoyo` |
-| 覆盖型 | `imageVersion` | 取最高优先级的值 | 如 `1.7.0-full` |
-| 覆盖型 | `containerMode` | 取最高优先级的值 | `common`, `dind`, `sock` |
-| 覆盖型 | `yolo` | 取最高优先级的值 | `c`, `gm`, `cx`, `oc` |
-| 合并型 | `env` | 数组累加合并 | 全局 + 运行配置 + CLI 的所有值 |
-| 合并型 | `envFile` | 数组累加合并 | 所有环境文件依次加载 |
-| 合并型 | `volumes` | 数组累加合并 | 所有挂载卷生效 |
-| 合并型 | `imageBuildArgs` | 数组累加合并 | 所有构建参数生效 |
+## 安装
-#### 常用样例-全局
+### 全局安装（推荐）
 ```bash
-mkdir -p ~/.manyoyo/
-cat > ~/.manyoyo/manyoyo.json << 'EOF'
-{
-    "imageName": "localhost/xcanwin/manyoyo",
-    "imageVersion": "1.7.0-full"
-}
-EOF
+npm install -g @xcanwin/manyoyo
 ```
-#### 常用样例-Claude Code
+### 系统要求
-```bash
-mkdir -p ~/.manyoyo/run/
-cat > ~/.manyoyo/run/claude.json << 'EOF'
-{
-    "envFile": [
-        "anthropic_[claudecode]_claudecode"  // 自动加载 ~/.manyoyo/env/claude.env
-    ],
-    "yolo": "c"
-}
-EOF
-# 在任意目录下使用运行配置
-manyoyo -r claude
-```
+- Node.js >= 22.0.0
+- Podman（推荐） 或 Docker
-#### 常用样例-Codex
+详细安装指南请参考：[安装详解](https://xcanwin.github.io/manyoyo/zh/guide/installation)
-```bash
-mkdir -p ~/.manyoyo/run/
-cat > ~/.manyoyo/run/codex.json << 'EOF'
-{
-    "envFile": [
-        "openai_[gpt]_codex"
-    ],
-    "volumes": [
-        "/Users/pc_user/.codex/auth.json:/root/.codex/auth.json"
-    ],
-    "yolo": "cx"
-}
-EOF
-# 在任意目录下使用运行配置
-manyoyo -r codex
-```
-### AI CLI 快捷方式（跳过权限确认）
+## 构建镜像
 ```bash
-# Claude Code
-manyoyo -y c          # 或: claude, cc
+# 构建完整版本（推荐）
+manyoyo --ib --iv 1.7.0
-# Gemini
-manyoyo -y gm         # 或: gemini, g
+# 构建精简版本
+manyoyo --ib --iba TOOL=common
-# Codex
-manyoyo -y cx         # 或: codex
-# OpenCode
-manyoyo -y oc         # 或: opencode
+# 构建自定义版本
+manyoyo --ib --iba TOOL=go,codex,java,gemini
 ```
-### 交互式会话管理
-退出容器会话后，系统将提示您选择操作：
+- 首次构建会自动下载依赖到 `docker/cache/`，2天内再次构建会使用缓存，速度提升约 **5 倍**
-- `y` - 保持容器在后台运行（默认）
-- `n` - 删除容器
-- `1` - 使用首次命令重新进入
-- `x` - 执行新命令
-- `i` - 进入交互式 shell
-### 容器模式
-#### Docker-in-Docker 开发
+## 常用命令
 ```bash
-# Docker-in-Docker（安全的嵌套容器）
-# 创建支持 Docker-in-Docker 的容器
-manyoyo -n docker-dev -m dind -x /bin/bash
+# 启动常见智能体
+manyoyo -y c          # Claude Code（或 claude / cc）
+manyoyo -y gm         # Gemini（或 gemini / g）
+manyoyo -y cx         # Codex（或 codex）
+manyoyo -y oc         # OpenCode（或 opencode）
-podman ps -a             # 现在可以在容器内使用 podman 命令
+# 容器管理
+manyoyo -l
+manyoyo -n myy-dev -x /bin/bash
+manyoyo -n myy-dev --crm
-nohup dockerd &          # 在容器内启动 dockerd
-docker ps -a             # 现在可以在容器内使用 docker 命令
+# 调试配置与命令拼装
+manyoyo --show-config
+manyoyo --show-command
 ```
-#### 挂载 Docker Socket 开发
+## 配置
-```bash
-# 挂载 Docker Socket（危险的！！！容器可以访问和执行宿主机的一切）
-# 创建挂载 /var/run/docker.sock 的容器
-manyoyo -n socket-dev -m sock -x /bin/bash
+配置优先级：命令行参数 > 运行配置 > 全局配置 > 默认值
+详细说明请参考：
+- [配置系统概览](https://xcanwin.github.io/manyoyo/zh/configuration/)
+- [环境变量详解](https://xcanwin.github.io/manyoyo/zh/configuration/environment)
+- [配置文件详解](https://xcanwin.github.io/manyoyo/zh/configuration/config-files)
-podman ps -a             # 现在可以在容器内使用 podman 命令
+## 📚 完整文档
-docker ps -a             # 现在可以在容器内使用 docker 命令
-```
-### 命令行选项
-| 选项 | 别名 | 描述 |
-|------|------|------|
-| `--hp PATH` | `--host-path` | 设置宿主机工作目录（默认：当前路径） |
-| `-n NAME` | `--cont-name` | 设置容器名称 |
-| `--cp PATH` | `--cont-path` | 设置容器工作目录 |
-| `-l` | `--cont-list` | 列出所有 manyoyo 容器 |
-| `--crm` | `--cont-remove` | 删除容器 |
-| `-m MODE` | `--cont-mode` | 设置容器模式（common, dind, sock） |
-| `--in NAME` | `--image-name` | 指定镜像名称 |
-| `--iv VERSION` | `--image-ver` | 指定镜像版本 |
-| `--ib` | `--image-build` | 构建镜像 |
-| `--iba XXX=YYY` | `--image-build-arg` | 构建镜像时传参给dockerfile |
-| `--irm` | `--image-remove` | 清理悬空镜像和 `<none>` 镜像 |
-| `-e STRING` | `--env` | 设置环境变量 |
-| `--ef FILE` | `--env-file` | 从文件加载环境变量（支持 `name` 或 `./path.env`） |
-| `-v STRING` | `--volume` | 绑定挂载卷 |
-| `--sp CMD` | `--shell-prefix` | 临时环境变量（作为 -s 的前缀） |
-| `-s CMD` | `--shell` | 指定要执行的命令 |
-| `--` | `--ss`, `--shell-suffix` | 命令参数（作为 -s 的后缀） |
-| `-x CMD` | `--sf`, `--shell-full` | 完整命令（替代 --sp, -s 和 --） |
-| `-y CLI` | `--yolo` | 无需确认运行 AI 智能体 |
-| `--show-config` | | 显示最终生效配置并退出 |
-| `--show-command` | | 显示将执行的命令并退出（存在容器时为 docker exec，不存在时为 docker run） |
-| `--yes` | | 所有提示自动确认（用于CI/脚本） |
-| `--rm-on-exit` | | 退出后自动删除容器（一次性模式） |
-| `--install NAME` | | 安装 manyoyo 命令 |
-| `-q LIST` | `--quiet` | 静默显示 |
-| `-r NAME` | `--run` | 加载运行配置（支持 `name` 或 `./path.json`） |
-| `-V` | `--version` | 显示版本 |
-| `-h` | `--help` | 显示帮助 |
-## 其他说明
-### 默认配置
-- **容器名称**：`myy-{月日-时分}`（基于当前时间自动生成）
-- **宿主机路径**：当前工作目录
-- **容器路径**：与宿主机路径相同
-- **镜像**：`localhost/xcanwin/manyoyo:xxx`
+在线文档：**https://xcanwin.github.io/manyoyo/**
-### 系统要求
+**中文文档：**
+- [快速开始](https://xcanwin.github.io/manyoyo/zh/guide/quick-start)
+- [安装详解](https://xcanwin.github.io/manyoyo/zh/guide/installation)
+- [配置系统](https://xcanwin.github.io/manyoyo/zh/configuration/)
+- [故障排查](https://xcanwin.github.io/manyoyo/zh/troubleshooting/)
-- Node.js >= 22.0.0
-- Podman 或 Docker
+**English Documentation:**
+- [Quick Start](https://xcanwin.github.io/manyoyo/en/guide/quick-start)
+- [Installation](https://xcanwin.github.io/manyoyo/en/guide/installation)
+- [Configuration](https://xcanwin.github.io/manyoyo/en/configuration/)
+- [Troubleshooting](https://xcanwin.github.io/manyoyo/en/troubleshooting/)
-### 卸载
+## 卸载
 ```bash
+# 卸载全局安装
 npm uninstall -g @xcanwin/manyoyo
-```
-## 故障排查 FAQ
-### 镜像构建失败
-**问题**：执行 `manyoyo --ib` 时报错
-**解决方案**：
-1. 检查网络连接：`curl -I https://mirrors.tencent.com`
-2. 检查磁盘空间：`df -h`（需要至少 10GB 可用空间）
-3. 使用 `--yes` 跳过确认：`manyoyo --ib --iv 1.7.0 --yes`
-4. 如果在国外，可能需要修改镜像源（配置文件中设置 `nodeMirror`）
-### 镜像拉取失败
-**问题**：提示 `pinging container registry localhost failed`
-**解决方案**：
-1. 本地镜像需要先构建：`manyoyo --ib --iv 1.7.0`
-2. 或修改配置文件 `~/.manyoyo/manyoyo.json` 中的 `imageVersion`
-### 容器启动失败
-**问题**：容器无法启动或立即退出
-**解决方案**：
-1. 查看容器日志：`docker logs <容器名>`
-2. 检查端口冲突：`docker ps -a`
-3. 检查权限问题：确保当前用户有 Docker/Podman 权限
-### 权限不足
-**问题**：提示 `permission denied` 或无法访问 Docker
-**解决方案**：
-1. 将用户添加到 docker 组：`sudo usermod -aG docker $USER`
-2. 重新登录或运行：`newgrp docker`
-3. 或使用 `sudo` 运行命令
+# 清理配置（可选）
+rm -rf ~/.manyoyo/
+```
-### 环境变量未生效
+## 许可证
-**问题**：容器内无法读取设置的环境变量
+MIT
-**解决方案**：
-1. 检查环境文件格式（支持 `KEY=VALUE` 或 `export KEY=VALUE`）
-2. 确认文件路径正确（`--ef name` 对应 `~/.manyoyo/env/name.env`）
-3. 使用 `--show-config` 查看最终生效的配置
+## 贡献
-## 许可证
+欢迎提交 Issue 和 Pull Request！
-MIT
+访问 [GitHub Issues](https://github.com/xcanwin/manyoyo/issues) 报告问题或提出建议。

package/bin/manyoyo.js CHANGED Viewed

@@ -70,7 +70,7 @@ const NC = '\x1b[0m'; // No Color
 let DOCKER_CMD = 'docker';
 // ==============================================================================
-// Utility Functions
+// SECTION: Utility Functions
 // ==============================================================================
 function sleep(ms) {
@@ -133,7 +133,7 @@ function sanitizeSensitiveData(obj) {
 }
 // ==============================================================================
-// Configuration File Functions
+// SECTION: Configuration Management
 // ==============================================================================
 /**
@@ -204,10 +204,9 @@ function loadRunConfig(name) {
 }
 // ==============================================================================
-// UI Functions
+// SECTION: UI Functions
 // ==============================================================================
 function getHelloTip(containerName, defaultCommand) {
     if ( !(QUIET.tip || QUIET.full) ) {
         console.log("");
@@ -259,6 +258,10 @@ function validateName(label, value, pattern) {
     }
 }
+// ==============================================================================
+// SECTION: Environment Variables and Volume Handling
+// ==============================================================================
 async function askQuestion(prompt) {
     const rl = readline.createInterface({
         input: process.stdin,
@@ -352,6 +355,10 @@ function addVolume(volume) {
     CONTAINER_VOLUMES.push("--volume", volume);
 }
+// ==============================================================================
+// SECTION: YOLO Mode and Container Mode Configuration
+// ==============================================================================
 function setYolo(cli) {
     switch (cli) {
         case 'claude':
@@ -479,7 +486,7 @@ function removeContainer(name) {
 }
 // ==============================================================================
-// Docker Operations
+// SECTION: Docker Operations
 // ==============================================================================
 function ensureDocker() {
@@ -549,6 +556,10 @@ function pruneDanglingImages() {
     console.log(`${GREEN}✅ 清理完成${NC}`);
 }
+// ==============================================================================
+// SECTION: Image Build System
+// ==============================================================================
 /**
  * 准备构建缓存（Node.js、JDT LSP、gopls）
  * @param {string} imageTool - 构建工具类型
@@ -806,7 +817,7 @@ async function buildImage(IMAGE_BUILD_ARGS, imageName, imageVersion) {
 }
 // ==============================================================================
-// Main Function Helpers
+// SECTION: Command Line Interface
 // ==============================================================================
 function setupCommander() {
@@ -1078,6 +1089,10 @@ async function waitForContainerReady(containerName) {
     process.exit(1);
 }
+// ==============================================================================
+// SECTION: Container Lifecycle Management
+// ==============================================================================
 /**
  * 创建新容器
  * @returns {Promise<string>} 默认命令

package/config.example.json CHANGED Viewed

@@ -6,7 +6,7 @@
     "hostPath": "/path/to/your/project",
     "containerPath": "/path/to/your/project",
     "imageName": "localhost/xcanwin/manyoyo",
-    "imageVersion": "1.6.4-full",
+    "imageVersion": "1.7.0-full",
     "containerMode": "common",
     "shellPrefix": "",
     "shell": "",

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
     "name": "@xcanwin/manyoyo",
-    "version": "3.8.3",
+    "version": "3.8.4",
     "imageVersion": "1.7.0",
     "description": "AI Agent CLI Security Sandbox",
     "keywords": [
@@ -22,7 +22,10 @@
         "install-link": "npm link",
         "test": "jest --coverage",
         "test:unit": "jest test/",
-        "lint": "echo 'Lint check passed'"
+        "lint": "echo 'Lint check passed'",
+        "docs:dev": "vitepress dev docs --host --port 5173",
+        "docs:build": "vitepress build docs",
+        "docs:preview": "vitepress preview docs --host --port 4173"
     },
     "homepage": "https://github.com/xcanwin/manyoyo",
     "engines": {
@@ -31,7 +34,6 @@
     "files": [
         "bin/manyoyo.js",
         "README.md",
-        "docs/README_EN.md",
         "LICENSE",
         "docker/manyoyo.Dockerfile",
         "config.example.json"
@@ -41,7 +43,8 @@
         "json5": "^2.2.3"
     },
     "devDependencies": {
-        "jest": "^29.7.0"
+        "jest": "^29.7.0",
+        "vitepress": "^1.6.4"
     },
     "jest": {
         "testMatch": ["**/test/**/*.test.js"],

package/docs/README_EN.md DELETED Viewed

@@ -1,470 +0,0 @@
-# <p align="center"><a href="https://github.com/xcanwin/manyoyo">MANYOYO (Man-Yo-Yo)</a></p>
-<p align="center">AI Agent CLI Security Sandbox.</p>
-<p align="center">
-  <a href="https://www.npmjs.com/package/@xcanwin/manyoyo"><img alt="npm" src="https://img.shields.io/npm/v/@xcanwin/manyoyo?style=flat-square" /></a>
-  <a href="https://github.com/xcanwin/manyoyo/actions/workflows/npm-publish.yml"><img alt="Build status" src="https://img.shields.io/github/actions/workflow/status/xcanwin/manyoyo/npm-publish.yml?style=flat-square" /></a>
-  <a href="https://github.com/xcanwin/manyoyo/blob/main/LICENSE"><img alt="license" src="https://img.shields.io/badge/License-MIT-yellow.svg" /></a>
-</p>
-<p align="center">
-  <a href="../README.md">中文</a> |
-  <a href="README_EN.md"><b>English</b></a>
-</p>
----
-## 2-Minute Quick Start
-**Docker users:**
-```bash
-npm install -g @xcanwin/manyoyo    # Install
-manyoyo --ib --iv 1.7.0            # Build image
-manyoyo -y c                        # Run Claude Code YOLO mode
-```
-**Podman users:**
-```bash
-npm install -g @xcanwin/manyoyo    # Install
-podman pull ubuntu:24.04           # Pull base image
-manyoyo --ib --iv 1.7.0            # Build image
-manyoyo -y c                        # Run Claude Code YOLO mode
-```
----
-**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
-2.1 Install [podman](https://podman.io/docs/installation)
-2.2 Pull base image
-```bash
-podman pull ubuntu:24.04
-```
-## 3. Build Image
-Only one of the following commands needs to be executed:
-```bash
-# Build using manyoyo (Recommended, auto-cache enabled)
-manyoyo --ib --iv 1.7.0                          # Build full version by default (Recommended, specify version)
-manyoyo --ib --iba TOOL=common                   # Build common version (python,nodejs,claude)
-manyoyo --ib --iba TOOL=go,codex,java,gemini     # Build custom combination
-manyoyo --ib --iba GIT_SSL_NO_VERIFY=true        # Build the full version and skip Git SSL verification
-manyoyo --ib --in myimage --iv 2.0.0             # Customize the image name and version to produce myimage:2.0.0-full
-# How it works:
-# - First build: Auto-downloads Node.js, JDT LSP, gopls etc. to docker/cache/
-# - Rebuild within 2 days: Uses local cache, ~5x faster
-# - After cache expires: Auto-downloads latest versions
-# Or build manually (Not recommended)
-iv=1.0.0 && podman build -t localhost/xcanwin/manyoyo:$iv-full -f docker/manyoyo.Dockerfile . --build-arg TOOL=full --no-cache
-```
-## 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                 # Claude Code
-manyoyo -n test -- resume --last      # Codex
-manyoyo -n test -- -r                 # Gemini
-manyoyo -n test -- -c                 # OpenCode
-# 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 --crm
-# Clean dangling images and <none> images
-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
-Send BASE_URL, TOKEN, etc. to the CLI in the container.
-#### String Format
-```bash
-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
-export ANTHROPIC_BASE_URL="https://xxxx"
-ANTHROPIC_AUTH_TOKEN=your-key
-# MESSAGE="Hello World"  # Comments will be ignored
-TESTPATH='/usr/local/bin'
-```
-**Environment file path rules**:
-- `manyoyo --ef myconfig` → loads `~/.manyoyo/env/myconfig.env`
-- `manyoyo --ef ./myconfig.env` → loads `myconfig.env` from current directory
-#### Common Examples-Claude Code
-```bash
-# Create environment file directory
-mkdir -p ~/.manyoyo/env/
-# Example: Create Claude environment file
-cat > ~/.manyoyo/env/anthropic_[claudecode]_claudecode.env << 'EOF'
-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"
-EOF
-# Use environment file from any directory
-manyoyo --ef anthropic_[claudecode]_claudecode -x claude
-```
-#### Common Examples-Codex
-```bash
-# Create environment file directory
-mkdir -p ~/.manyoyo/env/
-# Example: Create Codex environment file
-cat > ~/.manyoyo/env/openai_[gpt]_codex.env << 'EOF'
-export OPENAI_BASE_URL=https://chatgpt.com/backend-api/codex
-export OTEL_SDK_DISABLED=true
-EOF
-# Use environment file from any directory
-manyoyo --ef openai_[gpt]_codex -x codex
-```
-### 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`
-#### Configuration Options
-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.7.0-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)
-#### Configuration Merge Rules
-| Type | Parameter | Behavior | Example |
-|------|-----------|----------|---------|
-| Override | `containerName` | Use highest priority value | CLI `-n test` overrides config file |
-| Override | `hostPath` | Use highest priority value | Defaults to current directory |
-| Override | `containerPath` | Use highest priority value | Defaults to same as hostPath |
-| Override | `imageName` | Use highest priority value | Default `localhost/xcanwin/manyoyo` |
-| Override | `imageVersion` | Use highest priority value | e.g., `1.7.0-full` |
-| Override | `containerMode` | Use highest priority value | `common`, `dind`, `sock` |
-| Override | `yolo` | Use highest priority value | `c`, `gm`, `cx`, `oc` |
-| Merge | `env` | Array concatenation | All values from global + run + CLI |
-| Merge | `envFile` | Array concatenation | All env files loaded in order |
-| Merge | `volumes` | Array concatenation | All volume mounts apply |
-| Merge | `imageBuildArgs` | Array concatenation | All build args apply |
-#### Common Examples-Global
-```bash
-mkdir -p ~/.manyoyo/
-cat > ~/.manyoyo/manyoyo.json << 'EOF'
-{
-    "imageName": "localhost/xcanwin/manyoyo",
-    "imageVersion": "1.7.0-full"
-}
-EOF
-```
-#### Common Examples-Claude Code
-```bash
-mkdir -p ~/.manyoyo/run/
-cat > ~/.manyoyo/run/c.json << 'EOF'
-{
-    "envFile": [
-        "anthropic_[claudecode]_claudecode"  // Automatically loads ~/.manyoyo/env/claude.env
-    ],
-    "yolo": "c"
-}
-EOF
-# Use run configuration from any directory
-manyoyo -r claude
-```
-#### Common Examples-Codex
-```bash
-mkdir -p ~/.manyoyo/run/
-cat > ~/.manyoyo/run/codex.json << 'EOF'
-{
-    "envFile": [
-        "openai_[gpt]_codex"
-    ],
-    "volumes": [
-        "/Users/pc_user/.codex/auth.json:/root/.codex/auth.json"
-    ],
-    "yolo": "cx"
-}
-EOF
-# Use run configuration from any directory
-manyoyo -r codex
-```
-### 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
-podman ps -a             # Now you can use podman commands inside the container
-nohup dockerd &          # Inside the container, start dockerd
-docker ps -a             # Now you can use docker commands inside the container
-```
-#### Mount Docker socket Development
-```bash
-# Mount Docker socket (dangerous!!! containers can access and execute everything on the host)
-# Create a container mounting /var/run/docker.sock
-manyoyo -n socket-dev -m sock -x /bin/bash
-podman ps -a             # Now you can use podman commands inside the container
-docker ps -a             # Now you can use docker commands inside the container
-```
-### Command-Line Options
-| Option | Aliases | Description |
-|--------|---------|-------------|
-| `--hp PATH` | `--host-path` | Set host working directory (default: current path) |
-| `-n NAME` | `--cont-name` | Set container name |
-| `--cp PATH` | `--cont-path` | Set container working directory |
-| `-l` | `--cont-list` | List all manyoyo containers |
-| `--crm` | `--cont-remove` | Remove container |
-| `-m MODE` | `--cont-mode` | Set container mode (common, dind, sock) |
-| `--in NAME` | `--image-name` | Specify image name |
-| `--iv VERSION` | `--image-ver` | Specify image version |
-| `--ib` | `--image-build` | Build image |
-| `--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 (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 |
-| `--` | `--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 |
-| `--show-config` | | Print final effective config and exit |
-| `--show-command` | | Print the command to be executed and exit (docker exec if container exists, otherwise docker run) |
-| `--yes` | | Auto-confirm all prompts (for CI/scripts) |
-| `--rm-on-exit` | | Auto-remove container on exit (one-time mode) |
-| `--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 |
-## 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 >= 22.0.0
-- Podman or Docker
-### Uninstall
-```bash
-npm uninstall -g @xcanwin/manyoyo
-```
-## Troubleshooting FAQ
-### Image Build Failed
-**Problem**: Error when running `manyoyo --ib`
-**Solutions**:
-1. Check network connection: `curl -I https://mirrors.tencent.com`
-2. Check disk space: `df -h` (need at least 10GB free space)
-3. Use `--yes` to skip confirmation: `manyoyo --ib --iv 1.7.0 --yes`
-4. If outside China, you may need to change mirror source (set `nodeMirror` in config file)
-### Image Pull Failed
-**Problem**: Error `pinging container registry localhost failed`
-**Solutions**:
-1. Local images need to be built first: `manyoyo --ib --iv 1.7.0`
-2. Or modify `imageVersion` in config file `~/.manyoyo/manyoyo.json`
-### Container Startup Failed
-**Problem**: Container won't start or exits immediately
-**Solutions**:
-1. View container logs: `docker logs <container-name>`
-2. Check port conflicts: `docker ps -a`
-3. Check permission issues: Ensure current user has Docker/Podman permissions
-### Permission Denied
-**Problem**: Error `permission denied` or cannot access Docker
-**Solutions**:
-1. Add user to docker group: `sudo usermod -aG docker $USER`
-2. Re-login or run: `newgrp docker`
-3. Or run commands with `sudo`
-### Environment Variables Not Working
-**Problem**: Container cannot read configured environment variables
-**Solutions**:
-1. Check env file format (supports `KEY=VALUE` or `export KEY=VALUE`)
-2. Verify file path is correct (`--ef name` corresponds to `~/.manyoyo/env/name.env`)
-3. Use `--show-config` to view final effective configuration
-## License
-MIT