候鸟 Skills 提示词包

配置好 Rules 知识包之后，这份提示词模板（Skills 包）是您的"快捷菜单"。每个场景都有现成的提示词模板，直接复制进 Cursor 或 Antigravity，填好您自己的参数，AI 就能生成完整可用的脚本。

---

IMPORTANT

候鸟自动化：第一生存法则

1. 两包并存（关键！）：在 Antigravity 或 Cursor 中，您必须 同时加载 Rules 包和 Skills 包。Rules 包提供 API 的底层辞典，Skills 包提供高阶逻辑定义，二者缺一不可。
2. 本地模式建议：在大规模运行时，将客户端切换到 “本地模式” 可提升效率数百倍。
3. 备份提示：请定期备份 MBDATA 业务数据库文件夹。

---

候鸟技能包核心内容

下方内容是针对 Antigravity 设计的高级 Skill 包。请将其完整复制，并保存为项目根目录下的 .agent/skills/houniao-mbbrowser.md。

---
name: houniao-mbbrowser-apiserver-full
description: >
  候鸟浏览器 (MBBrowser) + ApiServer 的完整开发规范、接口细节、CDP 接管方式、错误排查、参数合法值。
  当用户提到候鸟、MBBrowser、ApiServer、指纹浏览器、多账号隔离、环境启动/停止、CDP/Playwright/Selenium/Puppeteer 接管、Session_ID、代理更新、创建环境、错误码 -1/-105 等时，立即加载此 skill。
  严格遵守 Session_ID 类型差异、必须用已有 context、检查 code/status、参数合法值校验。
  优先推荐 Playwright over CDP 连接方式。
---

# 候鸟浏览器 (MBBrowser) + ApiServer 完整规范

**核心提醒**：
- ApiServer 启动需本地模式 + 定期备份 MBDATA
- 所有接口：**POST** + **application/json**
- Base: http://127.0.0.1:8186（端口自定义）
- 成功：code=0；失败：code<0 + message
- 启动后检查 data.listid[0].status == 0
- 用 Public_ip 验证代理生效
- 并发控制：≤20 环境/批

## 接口分类速查

### 环境生命周期（最核心）
- **启动**：POST /api/v1/browser/start  
  Session_ID: **数组** ["id1", "id2"]  
  推荐 args: ["--blink-settings=imagesEnabled=false", "--interval-seconds=2", "--disable-extensions"]  
  isHeadless: false（调试）/true（生产）

- **停止**：POST /api/v1/browser/stop  
  Session_ID: **字符串** "id"

- **强制杀**：POST /api/v1/browser/kill （推荐用于插件驻留，Session_ID: 字符串）

- **状态**：POST /api/v1/browser/status

### 查询接口
- 列表（过滤+分页）：/api/v1/session/listid  
- 详细（含 CDP_Port、webdriver）：/api/v1/session/id_container （type=1 最全，Session_ID: 数组）

### 创建/更新
- 创建：/api/v1/session/create （Automatic_Configure=0 快速）  
- 更新基本/代理/高级指纹：对应 /update、/proxy/update、/adv_setting

### CDP 接管（必须遵守！）
**Playwright Python**：
```python
port = env["browser_CDP_Port"]
ws = f"ws://127.0.0.1:{port}/json/version"
pw = sync_playwright().start()
browser = pw.chromium.connect_over_cdp(ws)
context = browser.contexts[0]  # 必须已有 context！！
page = context.pages[0] if context.pages else context.new_page()
```

---

## 全量错误/参数参考

### 错误码索引
- **CODE 0**: 成功
- **CODE -106**: 时区错误
- **CODE -105**: 代理检测失败
- **Status -7**: 环境已运行
- **Status -22**: 未找到 Session_ID

### 参数字典
- **SystemOS**: Windows, iPhone, Android, MacIntel 等。
- **Resolution**: 1920x1080 等符合标准的分辨率。
- **TimeZone**: 需符合 IANA 标准，如 "Asia/Shanghai +08:000"。

---

使用技巧

让 AI 生成更好代码的秘诀

1. 越具体越好：不要说"帮我写登录脚本"，要说"登录网址是 xxx，账号输入框 selector 是 #username，密码框是 #password，点击 .submit-btn 后等待 URL 变为 /dashboard"

2. 指定错误处理方式：例如"登录失败时截图并记录到日志文件"

3. 指定输出格式：例如"结果写入 result.csv，包含 session_id、状态、耗时"

4. 说明并发要求：例如"并发 10 个，用 ThreadPoolExecutor"

5. 引用文件名：例如"session_id 从 sessions.txt 读取，每行一个"

修改 AI 生成的代码

如果 AI 生成的代码有问题，选中那段代码，输入：

这段代码有问题：[描述问题]，请修改

或者：

在上面代码的基础上，增加以下功能：[描述新需求]

---

TIP

配置完成后，您可以前往下一章 实战演示：口述生成完整脚本 查看如何通过一句话唤醒这些强大的技能。