内容
# 🥩 Meatloaf — AI 智能代理沙盒运行时
[](https://www.npmjs.com/package/meatloaf-cli)
[](https://www.npmjs.com/package/meatloaf-cli)
[](https://github.com/Atum246/meatloaf/blob/main/LICENSE)
**构建。运行。测试。部署。** 🚀
> 📦 **从 npm 安装:** `npm install -g meatloaf-cli`
>
> 🔗 **npm:** https://www.npmjs.com/package/meatloaf-cli
>
> 🔗 **GitHub:** https://github.com/Atum246/meatloaf
Meatloaf 是一个开源的 CLI 工具，它赋予 AI 智能代理不仅可以编写代码，还可以**构建、运行、测试和部署**应用程序的能力。它弥合了“生成代码”和“交付可运行软件”之间的差距。
## 🤔 为什么选择 Meatloaf？
AI 智能代理可以编写数千行代码，但它们无法：
- 🖥️ 启动和交互运行的服务
- 👁️ 查看应用程序的实际外观
- 🧪 测试端点和验证行为
- 🐛 实时调试问题
- 🔄 迭代构建→测试→修复循环
**Meatloaf 改变了这一点。** 它为 AI 智能代理提供了一个与数字世界交互的载体。
## ⚡ 快速入门
```bash
# 安装
npm install -g meatloaf-cli
# 创建沙盒
meatloaf create --image node:20-alpine
# 运行命令
meatloaf exec sandbox-abc123 "npm init -y && npm install express"
# 测试端点
meatloaf test --url http://localhost:3000
# 截图
meatloaf screenshot http://localhost:3000
# 完整生命周期
meatloaf up ./my-project
```
## 🎯 命令
### 沙盒管理
| 命令 | 描述 |
|---------|-------------|
| `meatloaf create` | 🆕 创建新的沙盒 |
| `meatloaf destroy <id>` | 💀 销毁沙盒 |
| `meatloaf list` | 📋 列出所有沙盒 |
| `meatloaf inspect <id>` | 🔍 检查沙盒详情 |
| `meatloaf stop <id>` | ⏹️ 停止沙盒 |
| `meatloaf start <id>` | 🟢 启动沙盒 |
| `meatloaf cleanup` | 🧹 删除孤立的沙盒 |
### 执行
| 命令 | 描述 |
|---------|-------------|
| `meatloaf exec <id> <cmd>` | ▶️ 运行命令 |
| `meatloaf script <id> <file>` | 📜 运行脚本文件 |
| `meatloaf upload <id> <file>` | ⬆️ 上传文件到沙盒 |
| `meatloaf download <id> <path>` | ⬇️ 从沙盒下载文件 |
| `meatloaf shell <id>` | 🐚 交互式 Shell |
### HTTP 测试
| 命令 | 描述 |
|---------|-------------|
| `meatloaf test [url]` | 🌐 HTTP 请求测试器 |
| `meatloaf batch <file>` | 🧪 运行批量测试 |
| `meatloaf wait <id>` | ⏳ 等待端点准备就绪 |
| `meatloaf bench <url>` | ⚡ 负载测试，附延迟百分比 |
### 观察
| 命令 | 描述 |
|---------|-------------|
| `meatloaf screenshot <url>` | 📸 捕获截图 |
| `meatloaf html <url>` | 📄 获取 HTML 快照 |
| `meatloaf logs <id>` | 📋 查看/流式传输日志 |
| `meatloaf stats <id>` | 📊 资源使用情况 |
| `meatloaf monitor` | 📊 实时终端仪表盘 |
### 网络管理
| 命令 | 描述 |
|---------|-------------|
| `meatloaf network create/list/remove` | 🌐 Docker 网络 |
| `meatloaf network connect/disconnect` | 🌐 连接沙盒 |
### 卷管理
| 命令 | 描述 |
|---------|-------------|
| `meatloaf volume create/list/remove/prune` | 💾 持久存储 |
### 镜像管理
| 命令 | 描述 |
|---------|-------------|
| `meatloaf image list/pull/remove/build` | 🖼️ Docker 镜像 |
| `meatloaf image inspect/history/tag/prune` | 🖼️ 镜像操作 |
### 多容器编排
| 命令 | 描述 |
|---------|-------------|
| `meatloaf compose up/down/ps/logs` | 🎼 Docker Compose 风格 |
### 进程管理
| 命令 | 描述 |
|---------|-------------|
| `meatloaf ps list/kill/top/tree` | 🔄 进程控制 |
### 文件系统操作
| 命令 | 描述 |
|---------|-------------|
| `meatloaf fs ls/cat/find/write` | 📁 文件操作 |
| `meatloaf fs mkdir/rm/du/grep` | 📁 目录操作 |
### 快照
| 命令 | 描述 |
|---------|-------------|
| `meatloaf snapshot save/restore/list` | 📸 状态管理 |
| `meatloaf snapshot export/import` | 📸 Tar 导出/导入 |
### 健康和监控
| 命令 | 描述 |
|---------|-------------|
| `meatloaf health check/watch/system` | 🏥 健康检查 |
### 端口管理
| 命令 | 描述 |
|---------|-------------|
| `meatloaf port scan/check/find/map` | 🔌 端口操作 |
### 机密管理
| 命令 | 描述 |
|---------|-------------|
| `meatloaf secrets set/get/list/remove` | 🔐 加密机密 |
| `meatloaf secrets inject/export/import` | 🔐 机密注入 |
### 环境配置文件
| 命令 | 描述 |
|---------|-------------|
| `meatloaf env create/show/list/delete` | 📋 配置文件管理 |
| `meatloaf env set/unset/inject/merge/diff` | 📋 变量操作 |
### Git 操作
| 命令 | 描述 |
|---------|-------------|
| `meatloaf git clone/status/commit/push` | 📁 沙盒中的 Git |
| `meatloaf git diff/log` | 📁 Git 历史记录 |
### 文件同步
| 命令 | 描述 |
|---------|-------------|
| `meatloaf sync up/down/watch` | 🔄 同步文件 |
### 代理和隧道
| 命令 | 描述 |
|---------|-------------|
| `meatloaf proxy start/forward/tunnel` | 🔀 端口转发 |
### 调度任务
| 命令 | 描述 |
|---------|-------------|
| `meatloaf cron add/list/remove/clear` | ⏰ Cron 作业 |
### 差异和比较
| 命令 | 描述 |
|---------|-------------|
| `meatloaf diff files/sb/changes` | 🔀 比较文件 |
### 监视模式
| 命令 | 描述 |
|---------|-------------|
| `meatloaf watch <id>` | 👁️ 自动同步更改 |
### 资源配额
| 命令 | 描述 |
|---------|-------------|
| `meatloaf quota set/get/limits` | 📊 资源限制 |
### 服务发现
| 命令 | 描述 |
|---------|-------------|
| `meatloaf discover resolve/lookup/register` | 🌐 DNS 解析 |
### 审计日志
| 命令 | 描述 |
|---------|-------------|
| `meatloaf audit log/stats/clear/export` | 📋 审计跟踪 |
### 系统
| 命令 | 描述 |
|---------|-------------|
| `meatloaf system --prune --info` | 🧹 系统操作 |
## 🤖 AI 智能代理集成
Meatloaf 与以下智能代理无缝集成：
### OpenClaw
```bash
# Meatloaf 与 OpenClaw 代理开箱即用
meatloaf create --image node:20-alpine
meatloaf exec sandbox-id "npm start"
meatloaf test --url http://localhost:3000
```
### Claude Code / Cursor / VS Code
```bash
# 从任何基于终端的 AI 智能代理使用 meatloaf
meatloaf up ./my-project --json # 用于解析的 JSON 输出
```
### 任意 AI 智能代理
```bash
# 检测环境
meatloaf agent --detect
# JSON 输出模式
meatloaf create --image python:3.12-slim --json
```
## 📁 模板
```bash
meatloaf templates # 列出所有模板
meatloaf init -t node-express
meatloaf init -t python-flask
meatloaf init -t static-site
meatloaf init -t go-gin
meatloaf init -t postgres
meatloaf init -t redis
```
## 🔥 完整生命周期示例
```bash
# 一条命令搞定所有
meatloaf up ./my-app
# 这将：
# 1. 创建沙盒
# 2. 上传项目文件
# 3. 运行设置命令（npm install 等）
# 4. 启动应用程序
# 5. 等待端点准备就绪
# 6. 报告成功
```
## 🧪 批量测试
创建 `tests.json`：
```json
[
{ "name": "首页", "url": "http://localhost:3000", "method": "GET" },
{ "name": "健康检查", "url": "http://localhost:3000/health", "method": "GET" },
{ "name": "创建", "url": "http://localhost:3000/api/items", "method": "POST", "body": {"name": "test"} }
]
```
运行：
```bash
meatloaf batch tests.json
```
## ⚙️ 配置
Meatloaf 将配置存储在 `~/.meatloaf/config.json` 中：
```json
{
"defaultImage": "node:20-alpine",
"sandboxTTL": 3600000,
"maxSandboxes": 10,
"screenshot": {
"width": 1280,
"height": 720
}
}
```
## 🏗️ 架构
```
meatloaf/
├── bin/meatloaf.js # 入口点
├── src/
│ ├── index.js # CLI 定义
│ ├── commands/
│ │ ├── sandbox.js # 沙盒生命周期
│ │ ├── exec.js # 命令执行
│ │ ├── http.js # HTTP 测试
│ │ ├── screenshot.js # 截图捕获
│ │ ├── logs.js # 日志管理
│ │ └── init.js # 项目模板
│ ├── lib/
│ │ ├── docker.js # Docker 引擎
│ │ ├── http.js # HTTP 客户端
│ │ └── screenshot.js # 截图引擎
│ └── utils/
│ ├── logger.js # CLI 输出
│ ├── config.js # 配置
│ └── helpers.js # 实用工具
└── tests/
└── integration.test.js # 测试套件
```
## 📄 许可证
MIT — 使用它，fork 它，让它成为你自己的。 🥩
---
**为无处不在的 AI 智能代理而构建** 🤖
连接信息
猜你喜欢
暂无推荐服务器