proxybaby

name	proxybaby
description	通过 `proxybaby` CLI 控制本机 ProxyBaby 抓包 app（启动/关闭、代理开关、录制开关、规则 CRUD、插件启停）。用于让 AI 自主管理抓包会话、注入 mock 规则、改写请求响应、验证接口行为等。

ProxyBaby AI Skill

允许 AI 通过 shell 命令 proxybaby 控制运行在本机的 ProxyBaby 抓包 app。

前置条件

• app 至少启动过一次（会自动生成 ~/.proxybaby/cli-token）。
• app 未运行时可 proxybaby app open 启动。

命令速查

# 状态
proxybaby status

# app 生命周期
proxybaby app open        # 启动（已运行则前置窗口）
proxybaby app quit

# 系统代理
proxybaby proxy on
proxybaby proxy off

# 记录
proxybaby record on
proxybaby record off
proxybaby record clear    # 清空已抓包列表

# 规则（whistle 兼容语法）
proxybaby rule list
proxybaby rule show <id>
proxybaby rule add <name> --file <path>          # 从文件读入规则文本
proxybaby rule add <name> --text "<inline>"      # 内联规则文本
proxybaby rule add <name> --file rules.txt --disabled
proxybaby rule update <id> --name <n> --file <p> [--enabled|--disabled]
proxybaby rule remove <id>
proxybaby rule enable <id>
proxybaby rule disable <id>

# 插件
proxybaby plugin list
proxybaby plugin enable <id>
proxybaby plugin disable <id>

规则语法（whistle 兼容子集）

每行一条规则：<pattern> <op1>[://value] [op2 ...]

• pattern：URL 前缀（https://api.example.com/foo）/ host 前缀（example.com/api）/ 通配（*.example.com/*）/ 正则（/foo\/(\d+)/）
• operator 常用：
  • statusCode://500
  • redirect://https://other.example.com
  • abort
  • reqHeaders://{"X-Foo":"bar"} / resHeaders://{"X-Foo":"bar"}
  • reqBody://hello（替换请求体）
  • resBody://{"code":0}（替换响应体）
  • host://127.0.0.1:8080（改上游）
  • file:///abs/path/mock.json（用本地文件作为响应体）
  • mock://{"ok":true}（直接以 JSON 短路响应）
  • reqDelay://1000 / resDelay://500
  • ua://custom-agent / referer://https://ref
  • log

常见任务示例

1. Mock 一个 API 返回

创建一条规则，让 https://api.example.com/user 直接返回本地 JSON：

proxybaby rule add mock-user --text 'api.example.com/user file:///tmp/user.json'

2. 短路返回内联 JSON

proxybaby rule add fake-login --text 'api.example.com/login mock://{"token":"xxx","ok":true}'

3. 拦截并改 header

proxybaby rule add force-auth --text '*.internal.com/* reqHeaders://{"Authorization":"Bearer test"}'

4. 把线上流量重定向到本地

proxybaby rule add local-dev --text 'api.example.com host://127.0.0.1:3000'

5. 模拟 500 错误

proxybaby rule add flaky --text 'api.example.com/checkout statusCode://500'

6. 停止抓包并清理

proxybaby record off
proxybaby record clear

7. 从多规则文件加载

cat > /tmp/rules.txt <<'EOF'
# 拦截并返回 mock
api.example.com/user  file:///tmp/user.json
api.example.com/list  mock://{"items":[]}

# 把域名劫持到本地
*.internal.com  host://127.0.0.1:3000  reqHeaders://{"X-Env":"dev"}
EOF
proxybaby rule add dev-suite --file /tmp/rules.txt

8. 排查真实请求 / 响应

proxybaby app open                # 打开 UI 查看列表
proxybaby record on
# 用户操作触发请求后
proxybaby status                  # 查看当前状态摘要

输出格式

• 大部分命令返回 JSON，可用 jq 继续处理。
• rule list / plugin list 返回精简列表；● 启用 / ○ 停用。

边界

• 目前仅 macOS 支持完整功能（系统代理设置依赖 networksetup）。
• 首次启动 app 会请求管理员密码（安装 CA 到系统钥匙串），CLI 无法代替此步骤。
• CLI token 位于 ~/.proxybaby/cli-token，泄露即可控制 app，注意保护。