命令参考

常用命令

场景	命令
查看帮助	manyoyo -h
查看版本	manyoyo -v
从本机 Agent 初始化配置	manyoyo init all
列出容器	manyoyo ps
列出镜像	manyoyo images
创建容器并启动 Claude Code	manyoyo run -n test --ef /abs/path/.env -y c
进入 shell	manyoyo run -n test -x /bin/bash
执行自定义命令	manyoyo run -n test -x echo "hello world"
删除容器	manyoyo rm test
清理悬空镜像	manyoyo prune
查看 Playwright 插件场景	manyoyo playwright ls
启动 Playwright 插件场景	manyoyo playwright up all
启动时追加浏览器扩展	manyoyo playwright up host-headless --ext-path /abs/path/extA --ext-name adguard
下载 Playwright 扩展到本地目录	manyoyo playwright ext-download
通过命名空间启动	manyoyo plugin playwright up host-headless
输出 MCP 接入命令	manyoyo playwright mcp-add --host localhost

常见参数速查

参数	说明
run -n, --cont-name	容器名称
run -y	快速进入 Agent 模式
run -x	在容器内执行命令
run -e	直接传入环境变量
run -p	直接传入端口映射（等价 --publish）
run --ef	读取环境变量文件（仅支持绝对路径）
run -r	读取 ~/.manyoyo/manyoyo.json 的 runs.<name>
build	构建沙箱镜像
run/build --iv	指定镜像版本标签（格式：x.y.z-后缀，如 1.8.0-common）
build --iba	传递镜像构建参数（如 TOOL=common）
update	更新 MANYOYO；若检测为本地 file 安装（npm install -g ./npm link）则跳过，否则执行 npm update -g @xcanwin/manyoyo
init [agents]	从本机 Agent 配置初始化 ~/.manyoyo
serve [port]	启动网页交互服务（默认 127.0.0.1:3000，支持 <port> 或 <host:port>）
playwright ls	列出 Playwright 插件启用场景
playwright up/down/status/health/logs [scene]	管理 Playwright 场景（scene 默认 host-headless；up 支持 --ext-path <path> 与 --ext-name <name> 多次追加扩展）
playwright ext-download [--prodversion]	下载并解压内置扩展到 ~/.manyoyo/plugin/playwright/extensions/（临时目录自动清理）
playwright mcp-add [--host]	输出 Claude/Codex 的 MCP 接入命令
plugin ls	列出当前插件及场景摘要
plugin playwright ...	通过 plugin 命名空间调用 Playwright 插件
-u <username>	网页服务登录用户名
-P <password>	网页服务登录密码（未设置时自动生成随机密码）
-q	静默输出（可多次使用）

配置文件规则

• manyoyo run -r claude 会读取 ~/.manyoyo/manyoyo.json 的 runs.claude
• manyoyo run --ef /abs/path/my.env 仅支持绝对路径环境文件
• 任何命令都会优先加载全局配置 ~/.manyoyo/manyoyo.json

网页服务认证说明

• serve 支持 3000 或 0.0.0.0:3000 两种写法
• 网页认证参数优先级：命令行参数 > runs.<name> > 全局配置 > 环境变量 > 默认值
• 环境变量键名：MANYOYO_SERVER_USER、MANYOYO_SERVER_PASS
• 建议参考 网页服务认证与安全实践 了解登录与安全基线

完整参数请以 README.md 为准。